@cogenta/render 0.1.0

package/dist/skin/tokens.js

@@ -0,0 +1,56 @@
+/**
+ * The skin token set of contract D (`theme@1.0`).
+ *
+ * The set is *closed*: a skin that omits a token is refused, and a skin that
+ * adds one is refused too. Both halves matter. Omission would leave a variable
+ * undefined at render time; addition would let a skin smuggle in presentation
+ * the theme never declared, which is the door rule R3 closes on blocks and this
+ * closes on skins.
+ */
+export const DENSITIES = ['compact', 'comfortable', 'spacious'];
+/**
+ * The single source of truth. Validation, CSS rendering and the error messages
+ * all read this list, so a token can never exist in one and not the others.
+ */
+export const TOKEN_SPECS = [
+    { group: 'color', name: 'bg', kind: 'color' },
+    { group: 'color', name: 'fg', kind: 'color' },
+    { group: 'color', name: 'accent', kind: 'color' },
+    { group: 'color', name: 'accentFg', kind: 'color' },
+    { group: 'color', name: 'muted', kind: 'color' },
+    { group: 'color', name: 'mutedFg', kind: 'color' },
+    { group: 'color', name: 'border', kind: 'color' },
+    { group: 'font', name: 'sans', kind: 'text' },
+    { group: 'font', name: 'serif', kind: 'text' },
+    { group: 'font', name: 'mono', kind: 'text' },
+    { group: 'font', name: 'scale', kind: 'ratio' },
+    { group: 'font', name: 'baseSize', kind: 'length' },
+    { group: 'space', name: 'unit', kind: 'length' },
+    { group: 'space', name: 'density', kind: 'density' },
+    { group: 'radius', name: 'sm', kind: 'length' },
+    { group: 'radius', name: 'md', kind: 'length' },
+    { group: 'radius', name: 'lg', kind: 'length' },
+    { group: 'motion', name: 'duration', kind: 'duration' },
+    { group: 'motion', name: 'easing', kind: 'text' },
+    { group: 'motion', name: 'reduced', kind: 'boolean' },
+    { group: 'shadow', name: 'sm', kind: 'text' },
+    { group: 'shadow', name: 'md', kind: 'text' },
+];
+export const TOKEN_GROUPS = [
+    'color',
+    'font',
+    'space',
+    'radius',
+    'motion',
+    'shadow',
+];
+export const CONTRAST_PAIRS = [
+    { foreground: 'fg', background: 'bg', size: 'normal' },
+    { foreground: 'accentFg', background: 'accent', size: 'normal' },
+    { foreground: 'mutedFg', background: 'muted', size: 'normal' },
+];
+/** Steps of the generated typographic scale, from smallest to largest. */
+export const TYPE_SCALE_STEPS = ['xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl'];
+/** `md` is the base size; steps below it divide by the ratio, above multiply. */
+export const TYPE_SCALE_BASE_INDEX = 2;
+//# sourceMappingURL=tokens.js.map

package/dist/skin/tokens.js.map

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

package/dist/skin/validate.d.ts

@@ -0,0 +1,14 @@
+import type { SkinTokens } from './tokens.js';
+/**
+ * The typographic scale a skin actually produces. Validation runs on this
+ * computed array rather than on `font.scale` alone: what must be monotone is
+ * the ladder the theme renders, and checking the ladder catches a bad ratio,
+ * a non-finite one, and any future change to how steps are derived.
+ */
+export declare function computeTypeScale(tokens: SkinTokens): Record<string, string>;
+/**
+ * Validates a skin and returns it typed. Throws a `CogentaError` on the first
+ * failing category, listing every failure in that category.
+ */
+export declare function validateSkin(input: unknown): SkinTokens;
+//# sourceMappingURL=validate.d.ts.map

package/dist/skin/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/skin/validate.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,aAAa,CAAA;AAkLnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ3E;AA2CD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAgCvD"}

package/dist/skin/validate.js

@@ -0,0 +1,272 @@
+import { aaThreshold, compositeOver, contrastRatio, meetsContrastAa, parseColor } from './color.js';
+import { insufficientContrast, invalidTokens, missingTokens, motionNotReduced, nonMonotonicScale, unknownTokens, } from './errors.js';
+import { CONTRAST_PAIRS, DENSITIES, TOKEN_GROUPS, TOKEN_SPECS, TYPE_SCALE_BASE_INDEX, TYPE_SCALE_STEPS, } from './tokens.js';
+/**
+ * Skin validation, in hard-refusal mode.
+ *
+ * The order of the checks is the order in which a failure makes the following
+ * checks meaningless: a missing token cannot be measured for contrast, and a
+ * malformed colour cannot be given a luminance. Within one check, *all*
+ * failures are reported at once — fixing a skin one error per run is exactly
+ * the loop an agent should not be put through in L9.
+ */
+const LENGTH = /^-?(\d+\.?\d*|\.\d+)(px|rem|em|ch|ex|vw|vh|vmin|vmax|%|pt)$/;
+const DURATION = /^(\d+\.?\d*|\.\d+)(ms|s)$/;
+/**
+ * Token values are interpolated into a stylesheet. Anything that could close a
+ * declaration, open a comment, start a request or hide behind a CSS escape is
+ * refused — a skin is a shareable JSON file, and it must stay data.
+ */
+const CSS_UNSAFE = /[;{}<>@\\]|\/\*|\*\/|url\s*\(|expression\s*\(|image-set\s*\(/i;
+const MAX_VALUE_LENGTH = 200;
+/** Colours used as a background: their alpha cannot be resolved, so it must be 1. */
+const BACKGROUND_ROLES = new Set(CONTRAST_PAIRS.map((pair) => pair.background));
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function path(spec) {
+    return `${spec.group}.${spec.name}`;
+}
+function checkValue(spec, value) {
+    const at = path(spec);
+    if (spec.kind === 'boolean') {
+        return { issue: typeof value === 'boolean' ? null : `${at}: expected true or false` };
+    }
+    if (spec.kind === 'ratio') {
+        return {
+            issue: typeof value === 'number' && Number.isFinite(value) && value > 0
+                ? null
+                : `${at}: expected a finite number greater than 0`,
+        };
+    }
+    if (typeof value !== 'string') {
+        return { issue: `${at}: expected a string` };
+    }
+    if (value.trim() === '') {
+        return { issue: `${at}: must not be empty` };
+    }
+    if (value.length > MAX_VALUE_LENGTH) {
+        return { issue: `${at}: must be at most ${MAX_VALUE_LENGTH} characters` };
+    }
+    if (CSS_UNSAFE.test(value)) {
+        return { issue: `${at}: contains CSS syntax that is not allowed in a token value` };
+    }
+    return { issue: checkStringKind(spec.kind, at, value) };
+}
+function checkStringKind(kind, at, value) {
+    switch (kind) {
+        case 'length':
+            return LENGTH.test(value.trim()) || value.trim() === '0'
+                ? null
+                : `${at}: expected a CSS length with a unit, such as 0.25rem`;
+        case 'duration':
+            return DURATION.test(value.trim())
+                ? null
+                : `${at}: expected a CSS duration with a unit, such as 200ms`;
+        case 'density':
+            return DENSITIES.some((d) => d === value)
+                ? null
+                : `${at}: expected one of ${DENSITIES.join(', ')}`;
+        case 'color':
+            return checkColor(at, value);
+        default:
+            return null;
+    }
+}
+function checkColor(at, value) {
+    const parsed = parseColor(value);
+    if (parsed === null) {
+        return `${at}: expected a hex, rgb() or hsl() colour`;
+    }
+    const name = at.slice('color.'.length);
+    if (BACKGROUND_ROLES.has(name) && parsed.a < 1) {
+        return `${at}: must be fully opaque, because contrast against an unknown backdrop cannot be measured`;
+    }
+    return null;
+}
+function readStructure(input) {
+    const missing = [];
+    const unknown = [];
+    const issues = [];
+    const values = new Map();
+    const root = asRecord(input);
+    if (root === null) {
+        return {
+            missing: [],
+            unknown: [],
+            issues: ['(root): expected a JSON object of tokens'],
+            values,
+        };
+    }
+    for (const key of Object.keys(root)) {
+        if (!TOKEN_GROUPS.some((group) => group === key)) {
+            unknown.push(key);
+        }
+    }
+    for (const group of TOKEN_GROUPS) {
+        const specs = TOKEN_SPECS.filter((spec) => spec.group === group);
+        const raw = asRecord(root[group]);
+        if (raw === null) {
+            // A missing or malformed group is reported token by token: the author
+            // needs the list of what to write, not the name of the container.
+            for (const spec of specs) {
+                missing.push(path(spec));
+            }
+            continue;
+        }
+        const known = new Set(specs.map((spec) => spec.name));
+        for (const key of Object.keys(raw)) {
+            if (!known.has(key)) {
+                unknown.push(`${group}.${key}`);
+            }
+        }
+        for (const spec of specs) {
+            const value = raw[spec.name];
+            if (value === undefined || value === null) {
+                missing.push(path(spec));
+                continue;
+            }
+            const { issue } = checkValue(spec, value);
+            if (issue !== null) {
+                issues.push(issue);
+                continue;
+            }
+            values.set(path(spec), value);
+        }
+    }
+    return { missing, unknown, issues, values };
+}
+/** Numeric part of a validated CSS length. The unit is carried separately. */
+function lengthValue(raw) {
+    const match = /^(-?(?:\d+\.?\d*|\.\d+))(.*)$/.exec(raw.trim());
+    return { amount: Number(match?.[1] ?? '0'), unit: (match?.[2] ?? '').trim() };
+}
+/**
+ * The typographic scale a skin actually produces. Validation runs on this
+ * computed array rather than on `font.scale` alone: what must be monotone is
+ * the ladder the theme renders, and checking the ladder catches a bad ratio,
+ * a non-finite one, and any future change to how steps are derived.
+ */
+export function computeTypeScale(tokens) {
+    const { amount, unit } = lengthValue(tokens.font.baseSize);
+    const sizes = {};
+    TYPE_SCALE_STEPS.forEach((step, index) => {
+        const size = amount * tokens.font.scale ** (index - TYPE_SCALE_BASE_INDEX);
+        sizes[step] = `${round(size)}${unit}`;
+    });
+    return sizes;
+}
+function round(value) {
+    return Math.round(value * 10000) / 10000;
+}
+function typeScaleSizes(tokens) {
+    const { amount } = lengthValue(tokens.font.baseSize);
+    return TYPE_SCALE_STEPS.map((_, index) => round(amount * tokens.font.scale ** (index - TYPE_SCALE_BASE_INDEX)));
+}
+function checkContrast(tokens) {
+    const failures = [];
+    for (const pair of CONTRAST_PAIRS) {
+        const fgValue = tokens.color[pair.foreground];
+        const bgValue = tokens.color[pair.background];
+        const fg = parseColor(fgValue);
+        const bg = parseColor(bgValue);
+        if (fg === null || bg === null) {
+            continue;
+        }
+        const ratio = contrastRatio(resolve(fg, bg), bg);
+        const required = aaThreshold(pair.size);
+        if (!meetsContrastAa(ratio, pair.size)) {
+            failures.push({
+                foreground: pair.foreground,
+                background: pair.background,
+                foregroundValue: fgValue,
+                backgroundValue: bgValue,
+                ratio,
+                required,
+            });
+        }
+    }
+    return failures;
+}
+function resolve(foreground, background) {
+    return foreground.a >= 1 ? foreground : compositeOver(foreground, background);
+}
+/**
+ * Validates a skin and returns it typed. Throws a `CogentaError` on the first
+ * failing category, listing every failure in that category.
+ */
+export function validateSkin(input) {
+    const { missing, unknown, issues, values } = readStructure(input);
+    if (missing.length > 0) {
+        throw missingTokens(missing);
+    }
+    if (unknown.length > 0) {
+        throw unknownTokens(unknown);
+    }
+    if (issues.length > 0) {
+        throw invalidTokens(issues);
+    }
+    // Every token is present and well-formed, so the shape is now known.
+    const tokens = buildTokens(values);
+    const failures = checkContrast(tokens);
+    if (failures.length > 0) {
+        throw insufficientContrast(failures);
+    }
+    const sizes = typeScaleSizes(tokens);
+    const monotone = sizes.every((size, index) => index === 0 || size > (sizes[index - 1] ?? 0));
+    if (!monotone) {
+        throw nonMonotonicScale(sizes, tokens.font.scale);
+    }
+    if (!tokens.motion.reduced) {
+        throw motionNotReduced();
+    }
+    return tokens;
+}
+function text(values, at) {
+    const value = values.get(at);
+    return typeof value === 'string' ? value : '';
+}
+function buildTokens(values) {
+    const scale = values.get('font.scale');
+    const reduced = values.get('motion.reduced');
+    const density = text(values, 'space.density');
+    return {
+        color: {
+            bg: text(values, 'color.bg'),
+            fg: text(values, 'color.fg'),
+            accent: text(values, 'color.accent'),
+            accentFg: text(values, 'color.accentFg'),
+            muted: text(values, 'color.muted'),
+            mutedFg: text(values, 'color.mutedFg'),
+            border: text(values, 'color.border'),
+        },
+        font: {
+            sans: text(values, 'font.sans'),
+            serif: text(values, 'font.serif'),
+            mono: text(values, 'font.mono'),
+            scale: typeof scale === 'number' ? scale : Number.NaN,
+            baseSize: text(values, 'font.baseSize'),
+        },
+        space: {
+            unit: text(values, 'space.unit'),
+            density: DENSITIES.find((d) => d === density) ?? 'comfortable',
+        },
+        radius: {
+            sm: text(values, 'radius.sm'),
+            md: text(values, 'radius.md'),
+            lg: text(values, 'radius.lg'),
+        },
+        motion: {
+            duration: text(values, 'motion.duration'),
+            easing: text(values, 'motion.easing'),
+            reduced: reduced === true,
+        },
+        shadow: {
+            sm: text(values, 'shadow.sm'),
+            md: text(values, 'shadow.md'),
+        },
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/skin/validate.js.map

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

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

@@ -0,0 +1,37 @@
+import type { ThemeConfig } from '../config.js';
+import { type ThemeManifest } from './manifest.js';
+import { type ThemeInspection } from './verify/verify-theme.js';
+/**
+ * Loading the active theme named by the configuration.
+ *
+ * The manifest is a file the site owner installed from somewhere else, so it
+ * is parsed and validated, never spread into the render context as-is.
+ */
+export interface LoadedTheme {
+    readonly manifest: ThemeManifest;
+    /** Absolute path to the theme root. */
+    readonly root: string;
+    /** Present only when the installation check ran. */
+    readonly inspection?: ThemeInspection | undefined;
+}
+export interface LoadThemeOptions {
+    readonly theme: ThemeConfig;
+    /** Directory the theme is resolved from. `process.cwd()` by default. */
+    readonly cwd?: string | undefined;
+    /**
+     * Reads the manifest module out of a theme root.
+     *
+     * Injectable because the host owns module loading: Astro loads
+     * `theme.config.ts` through Vite, a Node CLI loads the built `.js`, and a
+     * test loads a fixture. The default covers the last two.
+     */
+    readonly importManifest?: ((root: string) => Promise<unknown>) | undefined;
+    /**
+     * Run the installation check (contract D). Off by default: this is what
+     * `cogenta theme install` does once, not what booting a site does on every
+     * start.
+     */
+    readonly verify?: boolean | undefined;
+}
+export declare function loadTheme(options: LoadThemeOptions): Promise<LoadedTheme>;
+//# sourceMappingURL=load-theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-theme.d.ts","sourceRoot":"","sources":["../../src/theme/load-theme.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,KAAK,eAAe,EAAe,MAAM,0BAA0B,CAAA;AAE5E;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC;AAQD,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAc/E"}

package/dist/theme/load-theme.js

@@ -0,0 +1,102 @@
+import { stat } from 'node:fs/promises';
+import { isAbsolute, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { CogentaError } from '@cogenta/core';
+import { parseThemeManifest } from './manifest.js';
+import { verifyTheme } from './verify/verify-theme.js';
+/** Manifest file names, in the order they are tried. */
+const MANIFEST_FILES = ['theme.config.js', 'theme.config.mjs', 'theme.config.ts'];
+/** Where a theme is looked for when the configuration gives no explicit root. */
+const THEME_DIRECTORIES = ['node_modules', 'themes', 'packages', '.'];
+export async function loadTheme(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const root = await resolveThemeRoot(options.theme, cwd);
+    const load = options.importManifest ?? importManifestFile;
+    const module = await load(root);
+    // The manifest's `name` is not checked against `theme.name`: the
+    // configuration names a package or a directory, the manifest names the
+    // theme, and they are two namespaces. `canonical-theme` shipping a theme
+    // called `canonical` is ordinary, not a mistake to refuse.
+    const manifest = parseThemeManifest(exportedManifest(module, root), root);
+    if (options.verify !== true)
+        return { manifest, root };
+    return { manifest, root, inspection: await verifyTheme({ root, manifest }) };
+}
+/** The manifest a theme module exports, under either accepted name. */
+function exportedManifest(module, root) {
+    if (typeof module !== 'object' || module === null) {
+        throw new CogentaError({
+            code: 'THEME_INVALID',
+            message: `The theme manifest in ${root} exports nothing usable.`,
+            hint: 'A theme.config file exports its manifest as `theme`, or as the default export.',
+            details: { root },
+        });
+    }
+    const record = module;
+    return record.theme ?? record.default ?? record;
+}
+async function resolveThemeRoot(theme, cwd) {
+    if (theme.root !== undefined) {
+        const root = isAbsolute(theme.root) ? theme.root : resolve(cwd, theme.root);
+        if (await isDirectory(root))
+            return root;
+        throw new CogentaError({
+            code: 'THEME_NOT_FOUND',
+            message: `The theme root "${theme.root}" does not exist.`,
+            hint: `Resolved from ${cwd}. Point theme.root at the directory holding theme.config, or drop it to resolve the theme as a package.`,
+            details: { theme: theme.name, root, cwd },
+        });
+    }
+    const tried = [];
+    for (const directory of THEME_DIRECTORIES) {
+        const candidate = join(cwd, directory, theme.name);
+        tried.push(candidate);
+        if (await isDirectory(candidate))
+            return candidate;
+    }
+    throw new CogentaError({
+        code: 'THEME_NOT_FOUND',
+        message: `No theme named "${theme.name}" was found.`,
+        hint: `Install it, or set theme.root to its directory. Looked in: ${tried.join(', ')}.`,
+        details: { theme: theme.name, tried, cwd },
+    });
+}
+async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function importManifestFile(root) {
+    for (const file of MANIFEST_FILES) {
+        const path = join(root, file);
+        try {
+            if (!(await stat(path)).isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        try {
+            return await import(pathToFileURL(path).href);
+        }
+        catch (error) {
+            throw new CogentaError({
+                code: 'THEME_INVALID',
+                message: `The theme manifest ${path} could not be loaded.`,
+                hint: 'A manifest loaded outside a bundler must be plain JavaScript, or TypeScript on a Node that strips types. Ship a built theme.config.js, or load the theme through Astro.',
+                cause: error,
+                details: { root, file },
+            });
+        }
+    }
+    throw new CogentaError({
+        code: 'THEME_NOT_FOUND',
+        message: `No theme manifest was found in ${root}.`,
+        hint: `A theme root holds one of: ${MANIFEST_FILES.join(', ')}.`,
+        details: { root, looked: MANIFEST_FILES },
+    });
+}
+//# sourceMappingURL=load-theme.js.map

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/manifest.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/**
+ * Contract D, "Manifeste", frozen at `theme@1.0`.
+ *
+ * The manifest is third-party input: it arrives from a theme package the site
+ * owner installed, so it is parsed and refused, never trusted.
+ */
+export type ThemeRuntime = 'static' | 'server' | 'edge';
+export interface ThemeManifest {
+    readonly name: string;
+    readonly version: string;
+    /** Version of the theme contract this theme was written against. */
+    readonly engine: string;
+    /** Version of the block vocabulary this theme supports. */
+    readonly blocks: string;
+    readonly implements: readonly string[];
+    /** Collections the theme expects, or `'*'` for "whatever the site has". */
+    readonly collections: readonly string[] | '*';
+    readonly runtime: ThemeRuntime;
+    /** Path to the default skin, relative to the theme root. */
+    readonly tokens: string;
+    readonly a11y?: {
+        readonly verified: string;
+    } | undefined;
+}
+declare const manifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    engine: z.ZodString;
+    blocks: z.ZodString;
+    implements: z.ZodArray<z.ZodString>;
+    collections: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodString>]>;
+    runtime: z.ZodEnum<{
+        edge: "edge";
+        server: "server";
+        static: "static";
+    }>;
+    tokens: z.ZodString;
+    a11y: z.ZodOptional<z.ZodObject<{
+        verified: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ThemeManifestInput = z.input<typeof manifestSchema>;
+/** Declares a theme. The same validation runs on install, on a manifest that was never typed. */
+export declare function defineTheme(input: ThemeManifestInput): ThemeManifest;
+export declare function parseThemeManifest(input: unknown, source?: string): ThemeManifest;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/theme/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAA;IAC7C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC1D;AAKD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;iBAUlB,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE/D,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAEpE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAgBjF"}

package/dist/theme/manifest.js

@@ -0,0 +1,36 @@
+import { CogentaError } from '@cogenta/core';
+import { z } from 'zod';
+const SEMVER_RANGE = /^[\^~]?\d+\.\d+(\.\d+)?(-[0-9A-Za-z.-]+)?$/u;
+const SEMVER = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/u;
+const manifestSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().regex(SEMVER, 'must be an exact semver version, such as 1.0.0'),
+    engine: z.string().regex(SEMVER_RANGE, 'must be a semver range, such as ^1.0.0'),
+    blocks: z.string().regex(SEMVER_RANGE, 'must be a semver range, such as ^1.0.0'),
+    implements: z.array(z.string().min(1)),
+    collections: z.union([z.literal('*'), z.array(z.string().min(1))]),
+    runtime: z.enum(['static', 'server', 'edge']),
+    tokens: z.string().min(1),
+    a11y: z.object({ verified: z.string().min(1) }).optional(),
+});
+/** Declares a theme. The same validation runs on install, on a manifest that was never typed. */
+export function defineTheme(input) {
+    return parseThemeManifest(input);
+}
+export function parseThemeManifest(input, source) {
+    const result = manifestSchema.safeParse(input);
+    if (!result.success) {
+        const problems = result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+        throw new CogentaError({
+            code: 'THEME_INVALID',
+            message: `${source === undefined ? 'This theme manifest' : `The theme manifest in ${source}`} is not valid: ${problems.join('; ')}.`,
+            hint: 'A manifest declares name, version, engine, blocks, implements, collections, runtime and tokens. See contract D.',
+            details: source === undefined ? { problems } : { source, problems },
+        });
+    }
+    // `exactOptionalPropertyTypes` makes `a11y: undefined` and an absent `a11y`
+    // two different types, so the key is only set when there is something in it.
+    const { a11y, ...rest } = result.data;
+    return a11y === undefined ? rest : { ...rest, a11y };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/theme/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/theme/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA2BvB,MAAM,YAAY,GAAG,6CAA6C,CAAA;AAClE,MAAM,MAAM,GAAG,oCAAoC,CAAA;AAEnD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,gDAAgD,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,wCAAwC,CAAC;IAChF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,wCAAwC,CAAC;IAChF,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAAC,CAAA;AAIF,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,MAAe;IAChE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAChG,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,yBAAyB,MAAM,EAAE,kBAAkB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACpI,IAAI,EAAE,iHAAiH;YACvH,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE;SACpE,CAAC,CAAA;IACJ,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAA;IACrC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAA;AACtD,CAAC"}