@bestagentkits/render 0.1.0

package/dist/theme/load-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-theme.js","sourceRoot":"","sources":["../../src/theme/load-theme.ts"],"names":[],"mappings":"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"}

package/dist/theme/presets.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Built-in theme presets.
+ *
+ * The presets carry over the curated visual language that the legacy HTML
+ * references owned in prose (see `docs/adr/0001-page-spec-compiler-boundary.md`
+ * and `html-design-guidelines.md`), now as validated token data.
+ *
+ * Fonts are system stacks only: the offline contract forbids a network fetch, so
+ * nothing here can reference a webfont, and therefore nothing here needs a font
+ * licence.
+ */
+import type { Tokens } from './tokens.js';
+export interface PresetDefinition {
+    name: string;
+    description: string;
+    light: Tokens;
+    dark: Tokens;
+}
+/**
+ * Palette notes, kept next to the data so a reviewer can check the intent:
+ * every preset pairs a warm/cool background with a matching accent family, uses
+ * a tinted hairline border rather than a neutral grey, and keeps body text at a
+ * contrast ratio above 7:1 against its background.
+ */
+export declare const PRESETS: Readonly<Record<string, PresetDefinition>>;
+/** Default preset used when a spec does not name one. */
+export declare const DEFAULT_PRESET = "editorial";
+export declare function presetNames(): string[];
+/**
+ * A preset in its declarative, catalog-friendly form.
+ *
+ * Built-in presets are complete token sets; a file-authored preset typically
+ * declares `extends` plus overrides. Both are the same shape, so resolution has
+ * one code path.
+ */
+export interface PresetEntry {
+    name: string;
+    version: number;
+    description: string;
+    extends?: string;
+    /** Light-scheme token values. */
+    tokens: Record<string, string>;
+    /** Dark-scheme token values. */
+    dark: Record<string, string>;
+    origin: 'built-in' | 'user' | 'project' | 'file';
+    file?: string;
+}
+/** Built-in presets expressed as catalog entries. */
+export declare function builtinPresetEntries(): Record<string, PresetEntry>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/theme/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/theme/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAkDD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyO9D,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAalE"}

package/dist/theme/presets.js

@@ -0,0 +1,304 @@
+/**
+ * Built-in theme presets.
+ *
+ * The presets carry over the curated visual language that the legacy HTML
+ * references owned in prose (see `docs/adr/0001-page-spec-compiler-boundary.md`
+ * and `html-design-guidelines.md`), now as validated token data.
+ *
+ * Fonts are system stacks only: the offline contract forbids a network fetch, so
+ * nothing here can reference a webfont, and therefore nothing here needs a font
+ * licence.
+ */
+/** Structural defaults shared by every preset; each preset overrides colours and voice. */
+const STRUCTURAL = {
+    'font-size-base': '16px',
+    'font-scale': '1.25',
+    'line-height': '1.65',
+    measure: '72ch',
+    'space-unit': '8px',
+    density: 'comfortable',
+    'radius-small': '4px',
+    'radius-medium': '8px',
+    'radius-large': '16px',
+    'border-width': '1px',
+    'elevation-card': 'subtle',
+    'elevation-popover': 'medium',
+    'motion-duration': '160ms',
+    'motion-easing': 'ease',
+    'motion-policy': 'full',
+};
+const SYSTEM_SANS = 'ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif';
+const SYSTEM_SERIF = 'ui-serif, Georgia, Times New Roman, serif';
+const SYSTEM_MONO = 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace';
+function preset(input) {
+    const shared = {
+        ...STRUCTURAL,
+        'font-heading': SYSTEM_SANS,
+        'font-body': SYSTEM_SANS,
+        'font-mono': SYSTEM_MONO,
+        ...input.typing,
+        ...input.structure,
+    };
+    return {
+        name: input.name,
+        description: input.description,
+        light: { ...shared, ...input.colors.light },
+        dark: { ...shared, ...input.colors.dark },
+    };
+}
+/**
+ * Palette notes, kept next to the data so a reviewer can check the intent:
+ * every preset pairs a warm/cool background with a matching accent family, uses
+ * a tinted hairline border rather than a neutral grey, and keeps body text at a
+ * contrast ratio above 7:1 against its background.
+ */
+export const PRESETS = {
+    blueprint: preset({
+        name: 'blueprint',
+        description: 'Technical drawing: cool slate surfaces, precise borders, monospace labels.',
+        typing: { 'font-heading': SYSTEM_SANS, 'font-mono': SYSTEM_MONO },
+        colors: {
+            light: {
+                'color-background': '#f0f4f8',
+                'color-surface': '#ffffff',
+                'color-surface-raised': '#e8eef4',
+                'color-border': '#c2d2e2',
+                'color-text': '#122334',
+                'color-text-muted': '#4b6480',
+                'color-accent': '#1a5fa8',
+                'color-accent-contrast': '#ffffff',
+                'color-info': '#1a5fa8',
+                'color-success': '#1d6f4a',
+                'color-warning': '#8a5a00',
+                'color-danger': '#a32a1f',
+            },
+            dark: {
+                'color-background': '#0d1421',
+                'color-surface': '#111d2e',
+                'color-surface-raised': '#162438',
+                'color-border': '#2b4360',
+                'color-text': '#dbe7f3',
+                'color-text-muted': '#93a9c0',
+                'color-accent': '#6aa9e9',
+                'color-accent-contrast': '#08111c',
+                'color-info': '#6aa9e9',
+                'color-success': '#63c194',
+                'color-warning': '#e0b055',
+                'color-danger': '#ef8a7d',
+            },
+        },
+    }),
+    editorial: preset({
+        name: 'editorial',
+        description: 'Serif headlines, generous whitespace, deep navy with gold accents.',
+        typing: { 'font-heading': SYSTEM_SERIF, 'font-body': SYSTEM_SERIF, 'line-height': '1.7' },
+        structure: { 'font-size-base': '17px', 'font-scale': '1.333', measure: '68ch' },
+        colors: {
+            light: {
+                'color-background': '#faf8f2',
+                'color-surface': '#ffffff',
+                'color-surface-raised': '#f5f0e6',
+                'color-border': '#e0d9c8',
+                'color-text': '#1a1814',
+                'color-text-muted': '#6b6558',
+                'color-accent': '#8a6100',
+                'color-accent-contrast': '#ffffff',
+                'color-info': '#1f4e79',
+                'color-success': '#2f6b46',
+                'color-warning': '#8a6100',
+                'color-danger': '#9c2c25',
+            },
+            dark: {
+                'color-background': '#0f1729',
+                'color-surface': '#162040',
+                'color-surface-raised': '#1d2b52',
+                'color-border': '#35446b',
+                'color-text': '#f0ece0',
+                'color-text-muted': '#b0a890',
+                'color-accent': '#e2c069',
+                'color-accent-contrast': '#1a1814',
+                'color-info': '#8fb8e0',
+                'color-success': '#88c9a1',
+                'color-warning': '#e2c069',
+                'color-danger': '#eb9a90',
+            },
+        },
+    }),
+    'paper-ink': preset({
+        name: 'paper-ink',
+        description: 'Warm cream paper with terracotta and sage; informal and readable.',
+        typing: { 'font-heading': SYSTEM_SANS, 'font-body': SYSTEM_SANS },
+        colors: {
+            light: {
+                'color-background': '#faf6f0',
+                'color-surface': '#ffffff',
+                'color-surface-raised': '#fffdf5',
+                'color-border': '#e5dccd',
+                'color-text': '#2c2a25',
+                'color-text-muted': '#6f675c',
+                'color-accent': '#a83a10',
+                'color-accent-contrast': '#ffffff',
+                'color-info': '#2f5f7a',
+                'color-success': '#42703a',
+                'color-warning': '#8a5a12',
+                'color-danger': '#9c2f21',
+            },
+            dark: {
+                'color-background': '#1c1916',
+                'color-surface': '#262220',
+                'color-surface-raised': '#332d29',
+                'color-border': '#4a423b',
+                'color-text': '#f2eae0',
+                'color-text-muted': '#b3a89a',
+                'color-accent': '#e8865c',
+                'color-accent-contrast': '#1c1916',
+                'color-info': '#8dbdd8',
+                'color-success': '#96c288',
+                'color-warning': '#e0b273',
+                'color-danger': '#ef9c90',
+            },
+        },
+    }),
+    'terminal-mono': preset({
+        name: 'terminal-mono',
+        description: 'Near-black terminal with green and amber, monospace throughout.',
+        typing: { 'font-heading': SYSTEM_MONO, 'font-body': SYSTEM_MONO },
+        structure: {
+            'radius-small': '2px',
+            'radius-medium': '3px',
+            'radius-large': '6px',
+            density: 'compact',
+        },
+        colors: {
+            light: {
+                'color-background': '#f4f4ef',
+                'color-surface': '#ffffff',
+                'color-surface-raised': '#eaeae2',
+                'color-border': '#cfcfc2',
+                'color-text': '#16180f',
+                'color-text-muted': '#565a45',
+                'color-accent': '#1f6b3a',
+                'color-accent-contrast': '#ffffff',
+                'color-info': '#1f4e79',
+                'color-success': '#1f6b3a',
+                'color-warning': '#7a5200',
+                'color-danger': '#952c22',
+            },
+            dark: {
+                'color-background': '#05070c',
+                'color-surface': '#0b1017',
+                'color-surface-raised': '#131a23',
+                'color-border': '#2a3440',
+                'color-text': '#d3e4d3',
+                'color-text-muted': '#84997f',
+                'color-accent': '#5fd08a',
+                'color-accent-contrast': '#05070c',
+                'color-info': '#7fb6e8',
+                'color-success': '#5fd08a',
+                'color-warning': '#e8c15f',
+                'color-danger': '#ef8b7f',
+            },
+        },
+    }),
+    'swiss-clean': preset({
+        name: 'swiss-clean',
+        description: 'Neutral high-contrast grid: one red accent, no decoration.',
+        typing: { 'font-heading': SYSTEM_SANS, 'font-body': SYSTEM_SANS },
+        structure: {
+            'radius-small': '0px',
+            'radius-medium': '0px',
+            'radius-large': '0px',
+            'elevation-card': 'none',
+            'elevation-popover': 'subtle',
+            'font-scale': '1.2',
+            measure: '76ch',
+        },
+        colors: {
+            light: {
+                'color-background': '#ffffff',
+                'color-surface': '#ffffff',
+                'color-surface-raised': '#f4f4f4',
+                'color-border': '#d4d4d4',
+                'color-text': '#111111',
+                'color-text-muted': '#5a5a5a',
+                'color-accent': '#c02418',
+                'color-accent-contrast': '#ffffff',
+                'color-info': '#1a4f8a',
+                'color-success': '#1c6b3f',
+                'color-warning': '#8a5a00',
+                'color-danger': '#c02418',
+            },
+            dark: {
+                'color-background': '#101010',
+                'color-surface': '#181818',
+                'color-surface-raised': '#232323',
+                'color-border': '#3a3a3a',
+                'color-text': '#f5f5f5',
+                'color-text-muted': '#b0b0b0',
+                'color-accent': '#ff6a5c',
+                'color-accent-contrast': '#101010',
+                'color-info': '#8ab6ea',
+                'color-success': '#7fd0a1',
+                'color-warning': '#e6bb63',
+                'color-danger': '#ff6a5c',
+            },
+        },
+    }),
+    'warm-signal': preset({
+        name: 'warm-signal',
+        description: 'Warm neutral surfaces signalling with amber and emerald, data-friendly.',
+        typing: { 'font-heading': SYSTEM_SANS, 'font-body': SYSTEM_SANS },
+        structure: { density: 'spacious', 'radius-medium': '12px', 'radius-large': '20px' },
+        colors: {
+            light: {
+                'color-background': '#fbf7f1',
+                'color-surface': '#ffffff',
+                'color-surface-raised': '#f6efe3',
+                'color-border': '#e6dbc8',
+                'color-text': '#2a2620',
+                'color-text-muted': '#6e6558',
+                'color-accent': '#8a5a00',
+                'color-accent-contrast': '#ffffff',
+                'color-info': '#2a5f86',
+                'color-success': '#2c6b3f',
+                'color-warning': '#8a5a00',
+                'color-danger': '#9a2f22',
+            },
+            dark: {
+                'color-background': '#181410',
+                'color-surface': '#221d17',
+                'color-surface-raised': '#2e2820',
+                'color-border': '#453b2f',
+                'color-text': '#f3ece1',
+                'color-text-muted': '#b5a894',
+                'color-accent': '#e5b567',
+                'color-accent-contrast': '#181410',
+                'color-info': '#8ec0e2',
+                'color-success': '#8fc79c',
+                'color-warning': '#e5b567',
+                'color-danger': '#eda091',
+            },
+        },
+    }),
+};
+/** Default preset used when a spec does not name one. */
+export const DEFAULT_PRESET = 'editorial';
+export function presetNames() {
+    return Object.keys(PRESETS).sort();
+}
+/** Built-in presets expressed as catalog entries. */
+export function builtinPresetEntries() {
+    const entries = {};
+    for (const definition of Object.values(PRESETS)) {
+        entries[definition.name] = {
+            name: definition.name,
+            version: 1,
+            description: definition.description,
+            tokens: { ...definition.light },
+            dark: { ...definition.dark },
+            origin: 'built-in',
+        };
+    }
+    return entries;
+}
+//# sourceMappingURL=presets.js.map

package/dist/theme/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/theme/presets.ts"],"names":[],"mappings":"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"}

package/dist/theme/theme-catalog.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Theme catalog: built-in presets plus presets authored as files.
+ *
+ * A preset file is data with a fixed shape. It can extend another preset and
+ * override declared tokens; it cannot introduce a token, a selector, or a
+ * declaration, so a shared team preset is exactly as constrained as a built-in
+ * one. Precedence is explicit: built-in < user < project < explicitly named
+ * files, which is what makes a project-level override predictable.
+ */
+import { builtinPresetEntries, type PresetEntry } from './presets.js';
+export declare const PRESET_NAME_PATTERN: RegExp;
+export declare const THEME_DIRECTORIES: readonly [".ak-render/themes", ".config/ak-render/themes"];
+export interface PresetSource {
+    name: string;
+    origin: PresetEntry['origin'];
+    file?: string;
+}
+export interface ThemeCatalog {
+    entries: Record<string, PresetEntry>;
+    sources: PresetSource[];
+    /** Problems found while discovering presets; surfaced, never silently skipped. */
+    problems: {
+        path: string;
+        message: string;
+    }[];
+}
+/** Built-in-only catalog. */
+export declare function builtinThemeCatalog(): ThemeCatalog;
+/**
+ * Validate a preset document.
+ *
+ * Unknown keys and unknown tokens are errors: a preset that silently ignores a
+ * misspelled token would produce a page with a silently wrong theme.
+ */
+export declare function parsePresetDocument(value: unknown, options?: {
+    file?: string;
+    origin?: PresetEntry['origin'];
+    name?: string;
+}): PresetEntry;
+/** Load and validate one preset file. Throws a `RenderError` when it is invalid. */
+export declare function loadPresetFile(file: string, origin?: PresetEntry['origin']): PresetEntry;
+/** Directories searched for presets, in increasing precedence. */
+export declare function themeSearchDirectories(options?: {
+    cwd?: string;
+    home?: string;
+}): {
+    user: string[];
+    project: string[];
+};
+export interface ThemeCatalogOptions {
+    cwd?: string;
+    home?: string;
+    /** Explicit preset files; highest precedence. */
+    files?: string[];
+    /** Set false to use built-ins only. */
+    discovery?: boolean;
+}
+/**
+ * Build a catalog from built-ins, discovered project and user presets, and any
+ * explicitly named files. A malformed file becomes a recorded problem rather
+ * than a crash, so one bad team preset does not make unrelated pages
+ * uncompilable.
+ */
+export declare function buildThemeCatalog(options?: ThemeCatalogOptions): ThemeCatalog;
+/** Preset names in a catalog, sorted. */
+export declare function catalogPresetNames(catalog: ThemeCatalog): string[];
+export { builtinPresetEntries };
+//# sourceMappingURL=theme-catalog.d.ts.map

package/dist/theme/theme-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-catalog.d.ts","sourceRoot":"","sources":["../../src/theme/theme-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGtE,eAAO,MAAM,mBAAmB,QAA8B,CAAC;AAC/D,eAAO,MAAM,iBAAiB,4DAA6D,CAAC;AAW5F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,kFAAkF;IAClF,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED,6BAA6B;AAC7B,wBAAgB,mBAAmB,IAAI,YAAY,CAOlD;AAaD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7E,WAAW,CA2Eb;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,WAAW,CAAC,QAAQ,CAAU,GAAG,WAAW,CAShG;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG;IACrF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAOA;AAUD,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAgCjF;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAElE;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/theme/theme-catalog.js

@@ -0,0 +1,198 @@
+/**
+ * Theme catalog: built-in presets plus presets authored as files.
+ *
+ * A preset file is data with a fixed shape. It can extend another preset and
+ * override declared tokens; it cannot introduce a token, a selector, or a
+ * declaration, so a shared team preset is exactly as constrained as a built-in
+ * one. Precedence is explicit: built-in < user < project < explicitly named
+ * files, which is what makes a project-level override predictable.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, extname, join } from 'node:path';
+import { RenderError } from '../errors.js';
+import { isPlainObject } from '../json.js';
+import { parseSpec } from '../spec/parse.js';
+import { builtinPresetEntries } from './presets.js';
+import { TOKEN_SPECS, validateTokenValue } from './tokens.js';
+export const PRESET_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+export const THEME_DIRECTORIES = ['.ak-render/themes', '.config/ak-render/themes'];
+const PRESET_FILE_EXTENSIONS = ['.yaml', '.yml', '.json'];
+const ALLOWED_PRESET_KEYS = [
+    'name',
+    'version',
+    'description',
+    'extends',
+    'tokens',
+    'dark',
+];
+/** Built-in-only catalog. */
+export function builtinThemeCatalog() {
+    const entries = builtinPresetEntries();
+    return {
+        entries,
+        sources: Object.values(entries).map((entry) => ({ name: entry.name, origin: entry.origin })),
+        problems: [],
+    };
+}
+function presetNameFromFile(file) {
+    return basename(file, extname(file));
+}
+function fail(message, path, details) {
+    throw new RenderError('SPEC_VALIDATION_ERROR', message, {
+        path,
+        ...(details === undefined ? {} : { details }),
+    });
+}
+/**
+ * Validate a preset document.
+ *
+ * Unknown keys and unknown tokens are errors: a preset that silently ignores a
+ * misspelled token would produce a page with a silently wrong theme.
+ */
+export function parsePresetDocument(value, options = {}) {
+    const origin = options.origin ?? 'file';
+    const path = options.file ?? '<theme>';
+    if (!isPlainObject(value)) {
+        fail('a preset must be an object', path);
+    }
+    for (const key of Object.keys(value)) {
+        if (!ALLOWED_PRESET_KEYS.includes(key)) {
+            fail(`unknown preset field "${key}"`, `${path}#${key}`, {
+                allowed: [...ALLOWED_PRESET_KEYS],
+            });
+        }
+    }
+    const declaredName = value.name;
+    const name = typeof declaredName === 'string' ? declaredName : (options.name ?? presetNameFromFile(path));
+    if (!PRESET_NAME_PATTERN.test(name)) {
+        fail(`"${name}" is not a valid preset name`, `${path}#name`);
+    }
+    const extendsValue = value.extends;
+    if (extendsValue !== undefined) {
+        if (typeof extendsValue !== 'string' || !PRESET_NAME_PATTERN.test(extendsValue)) {
+            fail(`"${String(extendsValue)}" is not a valid preset name to extend`, `${path}#extends`);
+        }
+    }
+    const version = value.version;
+    if (version !== undefined &&
+        (typeof version !== 'number' || !Number.isInteger(version) || version < 1)) {
+        fail('preset version must be a positive integer', `${path}#version`);
+    }
+    const description = value.description;
+    if (description !== undefined && typeof description !== 'string') {
+        fail('preset description must be a string', `${path}#description`);
+    }
+    const readTokens = (key) => {
+        const raw = value[key];
+        if (raw === undefined)
+            return {};
+        if (!isPlainObject(raw))
+            fail(`${key} must be an object of token values`, `${path}#${key}`);
+        const tokens = {};
+        for (const [token, tokenValue] of Object.entries(raw)) {
+            if (TOKEN_SPECS[token] === undefined) {
+                fail(`unknown theme token "${token}"`, `${path}#${key}.${token}`, {
+                    known: Object.keys(TOKEN_SPECS).sort(),
+                });
+            }
+            const problem = validateTokenValue(token, tokenValue);
+            if (problem !== undefined) {
+                throw new RenderError('POLICY_VIOLATION', `theme token "${token}": ${problem.message}`, {
+                    path: `${path}#${key}.${token}`,
+                    details: { token },
+                });
+            }
+            tokens[token] = String(tokenValue);
+        }
+        return tokens;
+    };
+    const entry = {
+        name,
+        version: typeof version === 'number' ? version : 1,
+        description: typeof description === 'string' ? description : 'Custom theme preset.',
+        tokens: readTokens('tokens'),
+        dark: readTokens('dark'),
+        origin,
+    };
+    if (options.file !== undefined)
+        entry.file = options.file;
+    if (typeof extendsValue === 'string')
+        entry.extends = extendsValue;
+    return entry;
+}
+/** Load and validate one preset file. Throws a `RenderError` when it is invalid. */
+export function loadPresetFile(file, origin = 'file') {
+    if (!existsSync(file)) {
+        throw new RenderError('SPEC_VALIDATION_ERROR', `preset file not found: ${file}`, {
+            path: file,
+        });
+    }
+    const text = readFileSync(file, 'utf8');
+    const document = parseSpec(text, { source: file });
+    return parsePresetDocument(document, { file, origin, name: presetNameFromFile(file) });
+}
+/** Directories searched for presets, in increasing precedence. */
+export function themeSearchDirectories(options = {}) {
+    const home = options.home ?? homedir();
+    const cwd = options.cwd ?? process.cwd();
+    return {
+        user: THEME_DIRECTORIES.map((directory) => join(home, directory)),
+        project: THEME_DIRECTORIES.map((directory) => join(cwd, directory)),
+    };
+}
+function discoverIn(directory) {
+    if (!existsSync(directory) || !statSync(directory).isDirectory())
+        return [];
+    return readdirSync(directory)
+        .filter((name) => PRESET_FILE_EXTENSIONS.includes(extname(name)))
+        .sort()
+        .map((name) => join(directory, name));
+}
+/**
+ * Build a catalog from built-ins, discovered project and user presets, and any
+ * explicitly named files. A malformed file becomes a recorded problem rather
+ * than a crash, so one bad team preset does not make unrelated pages
+ * uncompilable.
+ */
+export function buildThemeCatalog(options = {}) {
+    const catalog = builtinThemeCatalog();
+    if (options.discovery === false)
+        return catalog;
+    const directories = themeSearchDirectories(options);
+    const sources = [];
+    for (const directory of directories.user) {
+        for (const file of discoverIn(directory))
+            sources.push({ file, origin: 'user' });
+    }
+    for (const directory of directories.project) {
+        for (const file of discoverIn(directory))
+            sources.push({ file, origin: 'project' });
+    }
+    for (const file of options.files ?? [])
+        sources.push({ file, origin: 'file' });
+    for (const source of sources) {
+        try {
+            const entry = loadPresetFile(source.file, source.origin);
+            catalog.entries[entry.name] = entry;
+            catalog.sources.push({
+                name: entry.name,
+                origin: source.origin,
+                file: source.file,
+            });
+        }
+        catch (error) {
+            catalog.problems.push({
+                path: source.file,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return catalog;
+}
+/** Preset names in a catalog, sorted. */
+export function catalogPresetNames(catalog) {
+    return Object.keys(catalog.entries).sort();
+}
+export { builtinPresetEntries };
+//# sourceMappingURL=theme-catalog.js.map