# theme.ts **[Source](https://github.com/ubugeeei-prod/ox-content/blob/main/npm/vite-plugin-ox-content/src/theme.ts)** > 31 documented symbols. Read the signatures first, then expand each item for parameters, return types, and examples.
31 symbols 7 functions 20 interfaces 2 types 1 variables 1 modules 8 parameters 118 members 7 returns 2 examples
## Reference
fndeepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): TDeep merge two objects.2 paramsreturns T

Deep merge two objects.

Signature

function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T

View source

Parameters

  • target T
  • source Partial<T>

Returns

T
variableconst defaultTheme: ThemeConfigDefault theme configuration. Based on the current ox-content SSG styles.

Default theme configuration. Based on the current ox-content SSG styles.

Signature

export const defaultTheme: ThemeConfig

View source

fndefineTheme(config: ThemeConfig): ThemeConfigDefines a theme configuration with type checking.1 paramreturns ThemeConfig1 example

Defines a theme configuration with type checking.

Signature

export function defineTheme(config: ThemeConfig): ThemeConfig

View source

Parameters

Returns

ThemeConfig

Examples

Example 1
const myTheme = defineTheme({
  extends: defaultTheme,
  colors: {
    primary: '#3498db',
  },
  footer: {
    copyright: '2025 My Company',
  },
});
fnexpandExtendsChain(config: ThemeConfig): ThemeConfig[]Flattens one layer's extends chain into base-first order. The seen guard keeps…1 paramreturns ThemeConfig[]

Flattens one layer's extends chain into base-first order.

The seen guard keeps a theme that accidentally extends itself (or forms a cycle through two packages) from hanging the build.

Signature

function expandExtendsChain(config: ThemeConfig): ThemeConfig[]

View source

Parameters

Returns

ThemeConfig[]
interfaceLegacySocialLinksLegacy social links configuration.3 members

Legacy social links configuration.

Signature

export interface LegacySocialLinks

View source

Members

Properties
NameTypeDescription
fnmergeThemes(...themes: (ThemeConfig | ThemeConfig[])[]): ThemeConfigMerges multiple theme configurations. Later themes override earlier ones. Objec…1 paramreturns ThemeConfig1 example

Merges multiple theme configurations. Later themes override earlier ones.

Object fields (colors, tokens, layout, …) merge key-by-key, but css and js concatenate in layer order — overwriting them would throw away one half of a [skin, colorScheme] stack. Identical fragments are joined once, so a layer reached through both an array and an extends chain does not emit its stylesheet twice.

Signature

export function mergeThemes(...themes: (ThemeConfig | ThemeConfig[])[]): ThemeConfig

View source

Parameters

Returns

ThemeConfig

Examples

Example 1
const merged = mergeThemes(defaultTheme, pixelSkin, tokyoNight, overrides);
interfaceNapiSocialLinksNAPI-compatible social links type.4 members

NAPI-compatible social links type.

Signature

export interface NapiSocialLinks

View source

Members

Properties
NameTypeDescription
interfaceNapiThemeColorsNAPI-compatible theme colors type.10 members

NAPI-compatible theme colors type.

Signature

export interface NapiThemeColors

View source

Members

Properties
NameTypeDescription
backgroundoptional string
backgroundAltoptional string
borderoptional string
codeBackgroundoptional string
codeBackgroundTopoptional string
codeTextoptional string
primaryoptional string
primaryHoveroptional string
textoptional string
textMutedoptional string
interfaceNapiThemeConfigNAPI-compatible theme configuration type.11 members

NAPI-compatible theme configuration type.

Signature

export interface NapiThemeConfig

View source

Members

Properties
NameTypeDescription
colorsoptional NapiThemeColors
cssoptional string
darkColorsoptional NapiThemeColors
embedoptional NapiThemeEmbed
entryPageoptional NapiThemeEntryPage
fontsoptional NapiThemeFonts
headeroptional NapiThemeHeader
jsoptional string
layoutoptional NapiThemeLayout
interfaceNapiThemeEmbedNAPI-compatible theme embed type.9 members

NAPI-compatible theme embed type.

Signature

export interface NapiThemeEmbed

View source

Members

Properties
NameTypeDescription
contentAfteroptional string
contentBeforeoptional string
footerBeforeoptional string
headoptional string
headerAfteroptional string
headerBeforeoptional string
sidebarAfteroptional string
sidebarBeforeoptional string
interfaceNapiThemeEntryPageNAPI-compatible entry page theme type.1 member

NAPI-compatible entry page theme type.

Signature

export interface NapiThemeEntryPage

View source

Members

Properties
NameTypeDescription
modeoptional "default" | "subtle"
interfaceNapiThemeFontsNAPI-compatible theme fonts type.2 members

NAPI-compatible theme fonts type.

Signature

export interface NapiThemeFonts

View source

Members

Properties
NameTypeDescription
monooptional string
sansoptional string
interfaceNapiThemeFooterNAPI-compatible theme footer type.2 members

NAPI-compatible theme footer type.

Signature

export interface NapiThemeFooter

View source

Members

Properties
NameTypeDescription
messageoptional string
interfaceNapiThemeHeaderNAPI-compatible theme header type.6 members

NAPI-compatible theme header type.

Signature

export interface NapiThemeHeader

View source

Members

Properties
NameTypeDescription
logoDarkoptional string
logoHeightoptional number
logoLightoptional string
logoWidthoptional number
showSiteNameTextoptional boolean
interfaceNapiThemeLayoutNAPI-compatible theme layout type.3 members

NAPI-compatible theme layout type.

Signature

export interface NapiThemeLayout

View source

Members

Properties
NameTypeDescription
headerHeightoptional string
maxContentWidthoptional string
sidebarWidthoptional string
interfaceResolvedThemeConfigResolved theme configuration (after merging with defaults).15 members

Resolved theme configuration (after merging with defaults).

Signature

export interface ResolvedThemeConfig

View source

Members

Properties
NameTypeDescription
colors ThemeColors
css string
darkColors ThemeColors
darkTokens ThemeTokens
embed ThemeEmbed
entryPage ThemeEntryPage
fonts ThemeFonts
header ThemeHeader
js string
layout ThemeLayout
name string
sidebar SidebarItem[]
tokens ThemeTokens
fnresolveTheme(config?: ThemeConfig | ThemeConfig[]): ResolvedThemeConfigResolves a theme configuration by merging with its extends chain and defaults.…1 paramreturns ResolvedThemeConfig

Resolves a theme configuration by merging with its extends chain and defaults.

An array composes independent layers left to right, which is how a skin package and a color package are stacked:

resolveTheme([pixelSkin, tokyoNight, { footer: { copyright: "2026" } }]);

Signature

export function resolveTheme(config?: ThemeConfig | ThemeConfig[]): ResolvedThemeConfig

View source

Parameters

Returns

ResolvedThemeConfig
interfaceSocialLinkCustom social link.3 members

Custom social link.

Signature

export interface SocialLink

View source

Members

Properties
NameTypeDescription
typeSocialLinkIcon = string | { svg: string }Custom social link icon.

Custom social link icon.

Signature

export type SocialLinkIcon = string | { svg: string }

View source

typeSocialLinks = LegacySocialLinks | SocialLink[]Social links configuration.

Social links configuration.

Signature

export type SocialLinks = LegacySocialLinks | SocialLink[]

View source

modulethemeTheme API for ox-content SSG Provides VitePress-like theming with default theme + customization.

Theme API for ox-content SSG

Provides VitePress-like theming with default theme + customization.

View source

interfaceThemeColorsTheme color configuration.10 members

Theme color configuration.

Signature

export interface ThemeColors

View source

Members

Properties
NameTypeDescription
backgroundoptional string
Background color
backgroundAltoptional string
Alternative background color (sidebar, code blocks)
borderoptional string
Border color
codeBackgroundoptional string
Code block background color
codeBackgroundTopoptional string
Code block gradient color at the top; defaults to codeBackground when customized
codeTextoptional string
Code block text color
primaryoptional string
Primary accent color
primaryHoveroptional string
Primary color on hover
textoptional string
Main text color
textMutedoptional string
Muted/secondary text color
interfaceThemeConfigComplete theme configuration.16 members

Complete theme configuration.

Signature

export interface ThemeConfig

View source

Members

Properties
NameTypeDescription
colorsoptional ThemeColors
Light mode colors (maps to CSS variables)
cssoptional string
Additional custom CSS. Composed layers concatenate this rather than
overwrite, so stacking a skin and a color scheme keeps both stylesheets.
darkColorsoptional ThemeColors
Dark mode colors (maps to CSS variables)
darkTokensoptional ThemeTokens
Extra --octc-* custom properties for dark mode.
embedoptional ThemeEmbed
Embedded HTML content at specific positions
entryPageoptional ThemeEntryPage
Entry page configuration
extendsoptional ThemeConfig
Base theme to extend
fontsoptional ThemeFonts
Font configuration (maps to CSS variables)
headeroptional ThemeHeader
Header configuration
jsoptional string
Additional custom JavaScript. Concatenated across composed layers.
layoutoptional ThemeLayout
Layout configuration (maps to CSS variables)
nameoptional string
Theme name for identification
sidebaroptional SidebarItem[]
tokensoptional ThemeTokens
Extra --octc-* custom properties for light mode, keyed without the
prefix. Merged key-by-key across composed layers, so a later layer can
restyle one token without redeclaring the rest.
fnthemeCss(theme: ResolvedThemeConfig): stringToken blocks come first so a theme's own css stays the final word, and both lan…1 paramreturns string

Token blocks come first so a theme's own css stays the final word, and both land after the typed color variables the Rust renderer emits.

Signature

function themeCss(theme: ResolvedThemeConfig): string

View source

Parameters

Returns

string
interfaceThemeEmbedEmbedded HTML content for specific positions in the page layout.9 members

Embedded HTML content for specific positions in the page layout.

Signature

export interface ThemeEmbed

View source

Members

Properties
NameTypeDescription
contentAfteroptional string
Content after main content
contentBeforeoptional string
Content before main content
footerBeforeoptional string
Content before footer
headoptional string
Content to embed into <head>
headerAfteroptional string
Content after header
headerBeforeoptional string
Content before header
sidebarAfteroptional string
Content after sidebar navigation
sidebarBeforeoptional string
Content before sidebar navigation
interfaceThemeEntryPageEntry page theme configuration.1 member

Entry page theme configuration.

Signature

export interface ThemeEntryPage

View source

Members

Properties
NameTypeDescription
modeoptional "default" | "subtle"
Landing page presentation mode
interfaceThemeFontsTheme font configuration.2 members

Theme font configuration.

Signature

export interface ThemeFonts

View source

Members

Properties
NameTypeDescription
monooptional string
Monospace font stack
sansoptional string
Sans-serif font stack
interfaceThemeFooterTheme footer configuration.2 members

Theme footer configuration.

Signature

export interface ThemeFooter

View source

Members

Properties
NameTypeDescription
messageoptional string
Footer message (supports HTML)
interfaceThemeHeaderTheme header configuration.6 members

Theme header configuration.

Signature

export interface ThemeHeader

View source

Members

Properties
NameTypeDescription
logoDarkoptional string
Dark mode logo image URL
logoHeightoptional number
Logo height in pixels
logoLightoptional string
Light mode logo image URL
logoWidthoptional number
Logo width in pixels
showSiteNameTextoptional boolean
Whether to render the site name text next to the logo
interfaceThemeLayoutTheme layout configuration.3 members

Theme layout configuration.

Signature

export interface ThemeLayout

View source

Members

Properties
NameTypeDescription
headerHeightoptional string
Header height (CSS value, e.g., "60px")
maxContentWidthoptional string
Maximum content width (CSS value, e.g., "960px")
sidebarWidthoptional string
Sidebar width (CSS value, e.g., "260px")
fnthemeToNapi(theme: ResolvedThemeConfig): NapiThemeConfigConverts resolved theme to the format expected by Rust NAPI.1 paramreturns NapiThemeConfig

Converts resolved theme to the format expected by Rust NAPI.

Signature

export function themeToNapi(theme: ResolvedThemeConfig): NapiThemeConfig

View source

Parameters

Returns

NapiThemeConfig