@cogenta/render 0.1.0

package/dist/skin/color.js

@@ -0,0 +1,176 @@
+/**
+ * Colour parsing and WCAG contrast, written by hand.
+ *
+ * Why no dependency: a colour library is a supply-chain surface, and the whole
+ * point of the skin validator is that a skin generated by a model in L9 is safe
+ * *by construction*. The rules it enforces must be auditable in one file, not
+ * inherited from a package that may change its rounding next minor version.
+ */
+/** WCAG 2.2 AA thresholds. Large text is >=18.66px bold or >=24px regular. */
+export const AA_NORMAL_TEXT = 4.5;
+export const AA_LARGE_TEXT = 3;
+export function aaThreshold(size) {
+    return size === 'large' ? AA_LARGE_TEXT : AA_NORMAL_TEXT;
+}
+const HEX = /^#([0-9a-f]{3,8})$/i;
+const FUNCTIONAL = /^(rgb|rgba|hsl|hsla)\(([^()]*)\)$/i;
+/**
+ * Parses a CSS colour. The accepted set is deliberately closed to hex, `rgb()`
+ * and `hsl()`: named colours, `color()` and `oklch()` would each need their own
+ * conversion path before a contrast ratio could be computed, and a colour whose
+ * luminance cannot be computed cannot be validated — so it must not be accepted.
+ *
+ * Returns `null` rather than throwing: the caller owns the error, because only
+ * the caller knows which token the value came from.
+ */
+export function parseColor(value) {
+    const input = value.trim();
+    const hex = HEX.exec(input);
+    if (hex !== null) {
+        return parseHex(hex[1] ?? '');
+    }
+    const fn = FUNCTIONAL.exec(input);
+    if (fn !== null) {
+        const name = (fn[1] ?? '').toLowerCase();
+        const parts = splitArguments(fn[2] ?? '');
+        if (parts === null) {
+            return null;
+        }
+        return name.startsWith('rgb') ? parseRgbArgs(parts) : parseHslArgs(parts);
+    }
+    return null;
+}
+function parseHex(digits) {
+    const expand = (pair) => Number.parseInt(pair, 16);
+    if (digits.length === 3 || digits.length === 4) {
+        const channels = [...digits].map((c) => expand(c + c));
+        return toRgba(channels);
+    }
+    if (digits.length === 6 || digits.length === 8) {
+        const channels = [];
+        for (let i = 0; i < digits.length; i += 2) {
+            channels.push(expand(digits.slice(i, i + 2)));
+        }
+        return toRgba(channels);
+    }
+    return null;
+}
+function toRgba(channels) {
+    const [r, g, b, a] = channels;
+    if (r === undefined || g === undefined || b === undefined) {
+        return null;
+    }
+    if (![r, g, b].every(Number.isFinite)) {
+        return null;
+    }
+    return { r, g, b, a: a === undefined ? 1 : a / 255 };
+}
+/** Accepts both the legacy comma syntax and the modern `r g b / a` syntax. */
+function splitArguments(raw) {
+    const [head, ...rest] = raw.split('/');
+    if (rest.length > 1 || head === undefined) {
+        return null;
+    }
+    const first = head.trim();
+    const values = first.includes(',')
+        ? first.split(',').map((p) => p.trim())
+        : first.split(/\s+/).filter((p) => p !== '');
+    if (rest.length === 1) {
+        values.push((rest[0] ?? '').trim());
+    }
+    return values.length === 3 || values.length === 4 ? values : null;
+}
+function parseNumber(raw, percentBasis) {
+    const text = raw.trim();
+    if (text === '') {
+        return null;
+    }
+    const isPercent = text.endsWith('%');
+    const parsed = Number(isPercent ? text.slice(0, -1) : text);
+    if (!Number.isFinite(parsed)) {
+        return null;
+    }
+    return isPercent ? (parsed / 100) * percentBasis : parsed;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function parseAlpha(raw) {
+    if (raw === undefined) {
+        return 1;
+    }
+    const value = parseNumber(raw, 1);
+    return value === null ? null : clamp(value, 0, 1);
+}
+function parseRgbArgs(parts) {
+    const alpha = parseAlpha(parts[3]);
+    const r = parseNumber(parts[0] ?? '', 255);
+    const g = parseNumber(parts[1] ?? '', 255);
+    const b = parseNumber(parts[2] ?? '', 255);
+    if (alpha === null || r === null || g === null || b === null) {
+        return null;
+    }
+    return { r: clamp(r, 0, 255), g: clamp(g, 0, 255), b: clamp(b, 0, 255), a: alpha };
+}
+function parseHslArgs(parts) {
+    const rawHue = parts[0] ?? '';
+    const hue = Number(rawHue.replace(/deg$/i, ''));
+    const saturation = parseNumber(parts[1] ?? '', 1);
+    const lightness = parseNumber(parts[2] ?? '', 1);
+    const alpha = parseAlpha(parts[3]);
+    if (!Number.isFinite(hue) || saturation === null || lightness === null || alpha === null) {
+        return null;
+    }
+    return { ...hslToRgb(hue, clamp(saturation, 0, 1), clamp(lightness, 0, 1)), a: alpha };
+}
+function hslToRgb(hue, s, l) {
+    // CSS Color 4 reference implementation, kept literal so it stays checkable.
+    const h = ((hue % 360) + 360) % 360;
+    const channel = (n) => {
+        const k = (n + h / 30) % 12;
+        const a = s * Math.min(l, 1 - l);
+        return l - a * Math.max(-1, Math.min(k - 3, 9 - k, 1));
+    };
+    return { r: channel(0) * 255, g: channel(8) * 255, b: channel(4) * 255 };
+}
+/** WCAG 2.2 relative luminance. */
+export function relativeLuminance(color) {
+    const linear = (channel) => {
+        const c = clamp(channel, 0, 255) / 255;
+        return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+    };
+    return 0.2126 * linear(color.r) + 0.7152 * linear(color.g) + 0.0722 * linear(color.b);
+}
+/** WCAG 2.2 contrast ratio, between 1 and 21. */
+export function contrastRatio(a, b) {
+    const la = relativeLuminance(a);
+    const lb = relativeLuminance(b);
+    const lighter = Math.max(la, lb);
+    const darker = Math.min(la, lb);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * Composites a translucent foreground over an opaque background. A contrast
+ * ratio computed on the raw foreground of a translucent colour is wrong — and
+ * wrong in the optimistic direction — so it is composited first.
+ */
+export function compositeOver(foreground, background) {
+    const a = clamp(foreground.a, 0, 1);
+    return {
+        r: foreground.r * a + background.r * (1 - a),
+        g: foreground.g * a + background.g * (1 - a),
+        b: foreground.b * a + background.b * (1 - a),
+    };
+}
+/**
+ * No epsilon on purpose. A pair at 4.4999:1 is below AA; rounding it up to
+ * "4.50" is exactly the kind of leniency that makes the guarantee a lie.
+ */
+export function meetsContrastAa(ratio, size) {
+    return ratio >= aaThreshold(size);
+}
+/** Two decimals, the precision every WCAG reporting tool uses. */
+export function formatRatio(ratio) {
+    return `${(Math.floor(ratio * 100) / 100).toFixed(2)}:1`;
+}
+//# sourceMappingURL=color.js.map

package/dist/skin/color.js.map

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

package/dist/skin/css.d.ts

@@ -0,0 +1,19 @@
+import type { SkinTokens } from './tokens.js';
+/**
+ * Renders a validated skin as one stylesheet of custom properties.
+ *
+ * One sheet, no build step: this file *is* the skin. Swapping a skin rewrites
+ * it, and nothing downstream has to be recompiled — which is what makes hot
+ * swap possible at all (contract D, "changement de skin = réécriture de ce
+ * fichier, sans build").
+ */
+export declare const CSS_VARIABLE_PREFIX = "--cogenta";
+/** `accentFg` → `accent-fg`. The variable name is part of the theme API. */
+export declare function kebab(name: string): string;
+export declare function cssVariableName(group: string, name: string): string;
+export interface RenderSkinCssOptions {
+    /** Selector the variables are attached to. `:root` unless a preview scopes it. */
+    readonly selector?: string;
+}
+export declare function renderSkinCss(tokens: SkinTokens, options?: RenderSkinCssOptions): string;
+//# sourceMappingURL=css.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/skin/css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,aAAa,CAAA;AAItD;;;;;;;GAOG;AAEH,eAAO,MAAM,mBAAmB,cAAc,CAAA;AAE9C,4EAA4E;AAC5E,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAiBD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAyC5F"}

package/dist/skin/css.js

@@ -0,0 +1,69 @@
+import { TOKEN_SPECS } from './tokens.js';
+import { computeTypeScale } from './validate.js';
+/**
+ * Renders a validated skin as one stylesheet of custom properties.
+ *
+ * One sheet, no build step: this file *is* the skin. Swapping a skin rewrites
+ * it, and nothing downstream has to be recompiled — which is what makes hot
+ * swap possible at all (contract D, "changement de skin = réécriture de ce
+ * fichier, sans build").
+ */
+export const CSS_VARIABLE_PREFIX = '--cogenta';
+/** `accentFg` → `accent-fg`. The variable name is part of the theme API. */
+export function kebab(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+}
+export function cssVariableName(group, name) {
+    return `${CSS_VARIABLE_PREFIX}-${group}-${kebab(name)}`;
+}
+/**
+ * Density is a word, and a word cannot be multiplied by a spacing unit. The
+ * multiplier is what a theme can actually compute with; the word is kept too,
+ * for container queries and debugging.
+ */
+const DENSITY_SCALE = {
+    compact: '0.75',
+    comfortable: '1',
+    spacious: '1.25',
+};
+function declaration(name, value) {
+    return `  ${name}: ${value};`;
+}
+export function renderSkinCss(tokens, options = {}) {
+    const selector = options.selector ?? ':root';
+    const lines = [];
+    // TOKEN_SPECS drives the order, so the output is byte-stable for a given
+    // skin: a stable sheet means a stable ETag, and a cache that behaves.
+    for (const spec of TOKEN_SPECS) {
+        // The group types are object type aliases on purpose: they carry an
+        // implicit index signature, so a token can be read by name without a cast.
+        const group = tokens[spec.group];
+        lines.push(declaration(cssVariableName(spec.group, spec.name), String(group[spec.name])));
+    }
+    lines.push(declaration(`${CSS_VARIABLE_PREFIX}-space-scale`, DENSITY_SCALE[tokens.space.density]));
+    const scale = computeTypeScale(tokens);
+    for (const [step, size] of Object.entries(scale)) {
+        lines.push(declaration(`${CSS_VARIABLE_PREFIX}-font-size-${step}`, size));
+    }
+    const reducedMotion = [
+        '@media (prefers-reduced-motion: reduce) {',
+        `  ${selector} {`,
+        `  ${declaration(`${CSS_VARIABLE_PREFIX}-motion-duration`, '0ms')}`,
+        `  ${declaration(`${CSS_VARIABLE_PREFIX}-motion-easing`, 'linear')}`,
+        '  }',
+        '}',
+    ].join('\n');
+    return [
+        '/* Generated by @cogenta/render — skin tokens. Do not edit by hand. */',
+        `${selector} {`,
+        ...lines,
+        '}',
+        '',
+        // The declared `motion.reduced` is worth nothing unless the sheet acts on
+        // it, so the media query is emitted from the same source as the tokens
+        // and cannot drift away from them.
+        reducedMotion,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=css.js.map

package/dist/skin/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/skin/css.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAE9C,4EAA4E;AAC5E,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,IAAY;IACzD,OAAO,GAAG,mBAAmB,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,aAAa,GAA4B;IAC7C,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,MAAM;CACjB,CAAA;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,OAAO,KAAK,IAAI,KAAK,KAAK,GAAG,CAAA;AAC/B,CAAC;AAOD,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,OAAO,GAAyB,EAAE;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAA;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,yEAAyE;IACzE,sEAAsE;IACtE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,oEAAoE;QACpE,2EAA2E;QAC3E,MAAM,KAAK,GAAwD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrF,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3F,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,mBAAmB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAElG,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,mBAAmB,cAAc,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,aAAa,GAAG;QACpB,2CAA2C;QAC3C,KAAK,QAAQ,IAAI;QACjB,KAAK,WAAW,CAAC,GAAG,mBAAmB,kBAAkB,EAAE,KAAK,CAAC,EAAE;QACnE,KAAK,WAAW,CAAC,GAAG,mBAAmB,gBAAgB,EAAE,QAAQ,CAAC,EAAE;QACpE,KAAK;QACL,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,OAAO;QACL,wEAAwE;QACxE,GAAG,QAAQ,IAAI;QACf,GAAG,KAAK;QACR,GAAG;QACH,EAAE;QACF,0EAA0E;QAC1E,uEAAuE;QACvE,mCAAmC;QACnC,aAAa;QACb,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/skin/errors.d.ts

@@ -0,0 +1,22 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Every refusal here names what failed and by how much. "Skin invalid" is
+ * useless to whoever must fix it — and in L9 the author is a model, which can
+ * only correct what the message actually measures.
+ */
+export interface ContrastFailure {
+    readonly foreground: string;
+    readonly background: string;
+    readonly foregroundValue: string;
+    readonly backgroundValue: string;
+    readonly ratio: number;
+    readonly required: number;
+}
+export declare function missingTokens(paths: readonly string[]): CogentaError;
+export declare function unknownTokens(paths: readonly string[]): CogentaError;
+export declare function invalidTokens(issues: readonly string[]): CogentaError;
+/** Names each failing pair, its measured ratio, and the shortfall. */
+export declare function insufficientContrast(failures: readonly ContrastFailure[]): CogentaError;
+export declare function nonMonotonicScale(sizes: readonly number[], scale: number): CogentaError;
+export declare function motionNotReduced(): CogentaError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/skin/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAOpE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAOpE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAOrE;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,YAAY,CAiBvF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAOvF;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAO/C"}

package/dist/skin/errors.js

@@ -0,0 +1,59 @@
+import { CogentaError } from '@cogenta/core';
+import { formatRatio } from './color.js';
+export function missingTokens(paths) {
+    return new CogentaError({
+        code: 'SKIN_TOKEN_MISSING',
+        message: `Skin is missing ${paths.length} token${paths.length === 1 ? '' : 's'}: ${paths.join(', ')}`,
+        hint: 'The skin token set of contract D is closed: every token must be present. Copy the missing entries from the theme default tokens.json and give them a value.',
+        details: { tokens: paths },
+    });
+}
+export function unknownTokens(paths) {
+    return new CogentaError({
+        code: 'SKIN_TOKEN_UNKNOWN',
+        message: `Skin declares ${paths.length} token${paths.length === 1 ? '' : 's'} that contract D does not define: ${paths.join(', ')}`,
+        hint: 'A skin may only set the frozen token set. Presentation that is not a token belongs to the theme, not to the skin.',
+        details: { tokens: paths },
+    });
+}
+export function invalidTokens(issues) {
+    return new CogentaError({
+        code: 'SKIN_TOKEN_INVALID',
+        message: `Skin has ${issues.length} invalid token value${issues.length === 1 ? '' : 's'}:\n${issues.map((i) => `  ${i}`).join('\n')}`,
+        hint: 'Colours must be hex, rgb() or hsl(); lengths and durations must carry a unit; no token value may contain CSS syntax such as ; { } or url().',
+        details: { issues },
+    });
+}
+/** Names each failing pair, its measured ratio, and the shortfall. */
+export function insufficientContrast(failures) {
+    const lines = failures.map((f) => `  color.${f.foreground} (${f.foregroundValue}) on color.${f.background} (${f.backgroundValue}) is ${formatRatio(f.ratio)}, needs ${f.required.toFixed(1)}:1 — short by ${(f.required - f.ratio).toFixed(2)}`);
+    return new CogentaError({
+        code: 'SKIN_CONTRAST_INSUFFICIENT',
+        message: `Skin fails WCAG 2.2 AA contrast on ${failures.length} pair${failures.length === 1 ? '' : 's'}:\n${lines.join('\n')}`,
+        hint: 'Darken the foreground or lighten the background until the ratio reaches the required value. Contrast is checked at registration precisely so an unreadable skin never reaches a visitor.',
+        details: {
+            failures: failures.map((f) => ({
+                pair: `${f.foreground}/${f.background}`,
+                ratio: Number(f.ratio.toFixed(4)),
+                required: f.required,
+            })),
+        },
+    });
+}
+export function nonMonotonicScale(sizes, scale) {
+    return new CogentaError({
+        code: 'SKIN_SCALE_NOT_MONOTONIC',
+        message: `Typographic scale of ratio ${scale} is not strictly increasing: computed steps are ${sizes.join(', ')}`,
+        hint: 'font.scale must be greater than 1 so that each step is larger than the previous one. A ratio of 1 or below collapses the heading hierarchy.',
+        details: { scale, sizes },
+    });
+}
+export function motionNotReduced() {
+    return new CogentaError({
+        code: 'SKIN_MOTION_NOT_REDUCED',
+        message: 'Skin declares motion.reduced = false.',
+        hint: 'motion.reduced must be true: honouring prefers-reduced-motion is an accessibility requirement, not a skin preference. The generated stylesheet zeroes the motion duration under that media query.',
+        details: { token: 'motion.reduced' },
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/skin/errors.js.map

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

package/dist/skin/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Skin system: a closed set of design tokens, validated in hard-refusal mode,
+ * rendered to one stylesheet of CSS custom properties and swappable without a
+ * build (contract D, `theme@1.0`).
+ */
+export type { Rgb, Rgba, TextSize } from './color.js';
+export { AA_LARGE_TEXT, AA_NORMAL_TEXT, aaThreshold, compositeOver, contrastRatio, formatRatio, meetsContrastAa, parseColor, relativeLuminance, } from './color.js';
+export type { RenderSkinCssOptions } from './css.js';
+export { CSS_VARIABLE_PREFIX, cssVariableName, renderSkinCss } from './css.js';
+export type { SkinSheet, SkinStore, SkinStoreOptions } from './sheet.js';
+export { createSkinStore, renderSkin } from './sheet.js';
+export type { ColorTokens, ContrastPair, Density, FontTokens, MotionTokens, RadiusTokens, ShadowTokens, SkinTokens, SpaceTokens, TokenKind, TokenSpec, TypeScaleStep, } from './tokens.js';
+export { CONTRAST_PAIRS, DENSITIES, TOKEN_GROUPS, TOKEN_SPECS, TYPE_SCALE_STEPS, } from './tokens.js';
+export { computeTypeScale, validateSkin } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC9E,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACxD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,OAAO,EACP,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/skin/index.js

@@ -0,0 +1,11 @@
+/**
+ * Skin system: a closed set of design tokens, validated in hard-refusal mode,
+ * rendered to one stylesheet of CSS custom properties and swappable without a
+ * build (contract D, `theme@1.0`).
+ */
+export { AA_LARGE_TEXT, AA_NORMAL_TEXT, aaThreshold, compositeOver, contrastRatio, formatRatio, meetsContrastAa, parseColor, relativeLuminance, } from './color.js';
+export { CSS_VARIABLE_PREFIX, cssVariableName, renderSkinCss } from './css.js';
+export { createSkinStore, renderSkin } from './sheet.js';
+export { CONTRAST_PAIRS, DENSITIES, TOKEN_GROUPS, TOKEN_SPECS, TYPE_SCALE_STEPS, } from './tokens.js';
+export { computeTypeScale, validateSkin } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/skin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE9E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAexD,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/skin/sheet.d.ts

@@ -0,0 +1,42 @@
+import type { RenderSkinCssOptions } from './css.js';
+import type { SkinTokens } from './tokens.js';
+/**
+ * Hot skin swap.
+ *
+ * A skin change validates the tokens and rewrites one stylesheet in memory.
+ * There is no compilation, no bundler, and no filesystem work on the critical
+ * path — persistence, when a deployment needs it, is an injected callback that
+ * runs after the new sheet is already live. That is what keeps the acceptance
+ * criterion ("changing a skin triggers no build and takes under a second")
+ * true by construction rather than by measurement.
+ */
+export interface SkinSheet {
+    readonly tokens: SkinTokens;
+    readonly css: string;
+    /** Content hash of the CSS. Stable for identical tokens. */
+    readonly etag: string;
+    /** Milliseconds spent validating and rendering. */
+    readonly renderedIn: number;
+}
+/** Validates a skin and renders its sheet. Throws if the skin is refused. */
+export declare function renderSkin(input: unknown, options?: RenderSkinCssOptions): SkinSheet;
+export interface SkinStore {
+    /** The sheet currently served. */
+    current(): SkinSheet;
+    /**
+     * Swaps the active skin. The current sheet is replaced only once the new one
+     * has been validated and rendered, so a refused skin leaves the live site on
+     * the previous skin instead of on no skin at all.
+     */
+    apply(input: unknown): SkinSheet;
+}
+export interface SkinStoreOptions extends RenderSkinCssOptions {
+    /**
+     * Called after the swap, with the new sheet. Write it to disk, push it to a
+     * CDN, or ignore it. Failures here are the caller's to handle: the sheet is
+     * already live in memory by the time this runs.
+     */
+    readonly onSwap?: (sheet: SkinSheet) => void;
+}
+export declare function createSkinStore(initial: unknown, options?: SkinStoreOptions): SkinStore;
+//# sourceMappingURL=sheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../src/skin/sheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;;;;;;;;GASG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAgBD,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,oBAAyB,GAAG,SAAS,CAKxF;AAED,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,OAAO,IAAI,SAAS,CAAA;IACpB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;CAC7C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAc3F"}

package/dist/skin/sheet.js

@@ -0,0 +1,36 @@
+import { renderSkinCss } from './css.js';
+import { validateSkin } from './validate.js';
+/**
+ * FNV-1a, 32-bit. Deliberately not `node:crypto`: this code also runs on the
+ * edge target, where the Node crypto module may not exist. The hash is a cache
+ * key, never a security boundary.
+ */
+function hash(input) {
+    let value = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        value ^= input.charCodeAt(i);
+        value = Math.imul(value, 0x01000193) >>> 0;
+    }
+    return value.toString(16).padStart(8, '0');
+}
+/** Validates a skin and renders its sheet. Throws if the skin is refused. */
+export function renderSkin(input, options = {}) {
+    const start = performance.now();
+    const tokens = validateSkin(input);
+    const css = renderSkinCss(tokens, options);
+    return { tokens, css, etag: `"${hash(css)}"`, renderedIn: performance.now() - start };
+}
+export function createSkinStore(initial, options = {}) {
+    const cssOptions = options.selector === undefined ? {} : { selector: options.selector };
+    let sheet = renderSkin(initial, cssOptions);
+    return {
+        current: () => sheet,
+        apply: (input) => {
+            const next = renderSkin(input, cssOptions);
+            sheet = next;
+            options.onSwap?.(next);
+            return next;
+        },
+    };
+}
+//# sourceMappingURL=sheet.js.map

package/dist/skin/sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.js","sourceRoot":"","sources":["../../src/skin/sheet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAsB5C;;;;GAIG;AACH,SAAS,IAAI,CAAC,KAAa;IACzB,IAAI,KAAK,GAAG,UAAU,CAAA;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC5B,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,OAAO,GAAyB,EAAE;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;AACvF,CAAC;AAsBD,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAAO,GAAqB,EAAE;IAC9E,MAAM,UAAU,GACd,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAA;IACtE,IAAI,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAE3C,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;QACpB,KAAK,EAAE,CAAC,KAAc,EAAa,EAAE;YACnC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;YAC1C,KAAK,GAAG,IAAI,CAAA;YACZ,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;YACtB,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/skin/tokens.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 declare const DENSITIES: readonly ['compact', 'comfortable', 'spacious'];
+export type Density = (typeof DENSITIES)[number];
+export type ColorTokens = {
+    readonly bg: string;
+    readonly fg: string;
+    readonly accent: string;
+    readonly accentFg: string;
+    readonly muted: string;
+    readonly mutedFg: string;
+    readonly border: string;
+};
+export type FontTokens = {
+    readonly sans: string;
+    readonly serif: string;
+    readonly mono: string;
+    /** Ratio between two consecutive steps of the typographic scale. */
+    readonly scale: number;
+    readonly baseSize: string;
+};
+export type SpaceTokens = {
+    readonly unit: string;
+    readonly density: Density;
+};
+export type RadiusTokens = {
+    readonly sm: string;
+    readonly md: string;
+    readonly lg: string;
+};
+export type MotionTokens = {
+    readonly duration: string;
+    readonly easing: string;
+    /** Declares that the skin honours `prefers-reduced-motion`. Must be true. */
+    readonly reduced: boolean;
+};
+export type ShadowTokens = {
+    readonly sm: string;
+    readonly md: string;
+};
+export interface SkinTokens {
+    readonly color: ColorTokens;
+    readonly font: FontTokens;
+    readonly space: SpaceTokens;
+    readonly radius: RadiusTokens;
+    readonly motion: MotionTokens;
+    readonly shadow: ShadowTokens;
+}
+/** Kinds drive both the structural check and the CSS emitted for a token. */
+export type TokenKind = 'color' | 'length' | 'duration' | 'ratio' | 'text' | 'boolean' | 'density';
+export interface TokenSpec {
+    readonly group: keyof SkinTokens;
+    readonly name: string;
+    readonly kind: TokenKind;
+}
+/**
+ * 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 declare const TOKEN_SPECS: readonly TokenSpec[];
+export declare const TOKEN_GROUPS: readonly (keyof SkinTokens)[];
+/**
+ * The contrast pairs contract D declares, with the text size each one carries.
+ *
+ * All three are checked at the *normal text* threshold, not the large-text one.
+ * `accentFg` on `accent` is the label of a button, `mutedFg` on `muted` is the
+ * body of a callout: both routinely carry body-sized text. Declaring them
+ * "large" would double the accepted colour space and quietly break real pages.
+ * The 3:1 threshold stays available through `meetsContrastAa` for tokens that
+ * genuinely only ever carry large text — there are none in `theme@1.0`.
+ */
+export interface ContrastPair {
+    readonly foreground: keyof ColorTokens;
+    readonly background: keyof ColorTokens;
+    readonly size: 'normal' | 'large';
+}
+export declare const CONTRAST_PAIRS: readonly ContrastPair[];
+/** Steps of the generated typographic scale, from smallest to largest. */
+export declare const TYPE_SCALE_STEPS: readonly ['xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl'];
+export type TypeScaleStep = (typeof TYPE_SCALE_STEPS)[number];
+/** `md` is the base size; steps below it divide by the ratio, above multiply. */
+export declare const TYPE_SCALE_BASE_INDEX = 2;
+//# sourceMappingURL=tokens.d.ts.map

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

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