@bendyline/squisq 1.2.2 → 1.4.0

package/dist/schemas/colorUtils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Color Utilities
+ *
+ * Pure-JS color math used by theme compilation and contrast checks.
+ * No dependencies. Operates on `#rrggbb` hex strings.
+ *
+ * Internally uses OKLCh — perceptually uniform, so lightening by 0.1
+ * looks like the same change at any starting point. Out-of-gamut
+ * results are clamped to sRGB.
+ */
+/** Test whether a string is a valid `#rgb` or `#rrggbb` hex color. */
+export declare function isHex(value: string): boolean;
+/**
+ * Lighten a color by `amount` (0..1) in OKLCh L space.
+ * Falls back to the input on parse failure.
+ */
+export declare function oklchLighten(hex: string, amount: number): string;
+/**
+ * Darken a color by `amount` (0..1) in OKLCh L space.
+ * Falls back to the input on parse failure.
+ */
+export declare function oklchDarken(hex: string, amount: number): string;
+/**
+ * Adjust the OKLCh chroma of a color by a multiplier (e.g. 0.7 to mute).
+ */
+export declare function oklchSetChroma(hex: string, multiplier: number): string;
+/**
+ * WCAG relative luminance of a hex color, returned as 0..1.
+ */
+export declare function relativeLuminance(hex: string): number;
+/**
+ * WCAG contrast ratio between two hex colors. Returns 1..21.
+ */
+export declare function contrastRatio(a: string, b: string): number;
+/**
+ * Pick a near-white or near-black text color that contrasts well against `bg`.
+ */
+export declare function pickContrastingText(bg: string, light?: string, dark?: string): string;
+/**
+ * Derive a 5-step lighter→darker scale from a seed color.
+ * Stops are evenly spaced in OKLCh L space around the seed.
+ * `spread` controls amplitude (0.05 = subtle, 0.15 = balanced, 0.22 = high).
+ */
+export declare function deriveScale(seedHex: string, spread?: number): {
+    lighter2: string;
+    lighter1: string;
+    base: string;
+    darker1: string;
+    darker2: string;
+};
+//# sourceMappingURL=colorUtils.d.ts.map

package/dist/schemas/colorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorUtils.d.ts","sourceRoot":"","sources":["../../src/schemas/colorUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5C;AAwFD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAY,EAAE,IAAI,SAAY,GAAG,MAAM,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,SAAO,GACZ;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAQA"}

package/dist/schemas/colorUtils.js

@@ -0,0 +1,154 @@
+/**
+ * Color Utilities
+ *
+ * Pure-JS color math used by theme compilation and contrast checks.
+ * No dependencies. Operates on `#rrggbb` hex strings.
+ *
+ * Internally uses OKLCh — perceptually uniform, so lightening by 0.1
+ * looks like the same change at any starting point. Out-of-gamut
+ * results are clamped to sRGB.
+ */
+const HEX_RE = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+/** Test whether a string is a valid `#rgb` or `#rrggbb` hex color. */
+export function isHex(value) {
+    return HEX_RE.test(value);
+}
+/** Parse `#rgb` or `#rrggbb` into 0..1 sRGB triplet. Returns null on failure. */
+function parseHex(hex) {
+    if (!HEX_RE.test(hex))
+        return null;
+    let body = hex.slice(1);
+    if (body.length === 3)
+        body = body
+            .split('')
+            .map((c) => c + c)
+            .join('');
+    return [
+        parseInt(body.slice(0, 2), 16) / 255,
+        parseInt(body.slice(2, 4), 16) / 255,
+        parseInt(body.slice(4, 6), 16) / 255,
+    ];
+}
+function toHex(rgb) {
+    const ch = (v) => {
+        const c = Math.max(0, Math.min(255, Math.round(v * 255)));
+        return c.toString(16).padStart(2, '0');
+    };
+    return '#' + ch(rgb[0]) + ch(rgb[1]) + ch(rgb[2]);
+}
+function srgbToLinear(c) {
+    return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+function linearToSrgb(c) {
+    return c <= 0.0031308 ? c * 12.92 : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
+}
+function rgbToOklch(rgb) {
+    const [sr, sg, sb] = rgb;
+    const r = srgbToLinear(sr);
+    const g = srgbToLinear(sg);
+    const b = srgbToLinear(sb);
+    const l = 0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b;
+    const m = 0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b;
+    const s = 0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b;
+    const l_ = Math.cbrt(l);
+    const m_ = Math.cbrt(m);
+    const s_ = Math.cbrt(s);
+    const L = 0.2104542553 * l_ + 0.793617785 * m_ - 0.0040720468 * s_;
+    const a = 1.9779984951 * l_ - 2.428592205 * m_ + 0.4505937099 * s_;
+    const bb = 0.0259040371 * l_ + 0.7827717662 * m_ - 0.808675766 * s_;
+    const C = Math.sqrt(a * a + bb * bb);
+    let h = (Math.atan2(bb, a) * 180) / Math.PI;
+    if (h < 0)
+        h += 360;
+    return { L, C, h };
+}
+function oklchToRgb({ L, C, h }) {
+    const hr = (h * Math.PI) / 180;
+    const a = C * Math.cos(hr);
+    const bb = C * Math.sin(hr);
+    const l_ = L + 0.3963377774 * a + 0.2158037573 * bb;
+    const m_ = L - 0.1055613458 * a - 0.0638541728 * bb;
+    const s_ = L - 0.0894841775 * a - 1.291485548 * bb;
+    const l = l_ * l_ * l_;
+    const m = m_ * m_ * m_;
+    const s = s_ * s_ * s_;
+    const r = +4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s;
+    const g = -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s;
+    const b = -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s;
+    return [
+        Math.max(0, Math.min(1, linearToSrgb(r))),
+        Math.max(0, Math.min(1, linearToSrgb(g))),
+        Math.max(0, Math.min(1, linearToSrgb(b))),
+    ];
+}
+/**
+ * Lighten a color by `amount` (0..1) in OKLCh L space.
+ * Falls back to the input on parse failure.
+ */
+export function oklchLighten(hex, amount) {
+    const rgb = parseHex(hex);
+    if (!rgb)
+        return hex;
+    const lch = rgbToOklch(rgb);
+    lch.L = Math.max(0, Math.min(1, lch.L + amount));
+    return toHex(oklchToRgb(lch));
+}
+/**
+ * Darken a color by `amount` (0..1) in OKLCh L space.
+ * Falls back to the input on parse failure.
+ */
+export function oklchDarken(hex, amount) {
+    return oklchLighten(hex, -amount);
+}
+/**
+ * Adjust the OKLCh chroma of a color by a multiplier (e.g. 0.7 to mute).
+ */
+export function oklchSetChroma(hex, multiplier) {
+    const rgb = parseHex(hex);
+    if (!rgb)
+        return hex;
+    const lch = rgbToOklch(rgb);
+    lch.C = Math.max(0, lch.C * multiplier);
+    return toHex(oklchToRgb(lch));
+}
+/**
+ * WCAG relative luminance of a hex color, returned as 0..1.
+ */
+export function relativeLuminance(hex) {
+    const rgb = parseHex(hex);
+    if (!rgb)
+        return 0;
+    const [r, g, b] = rgb.map(srgbToLinear);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+/**
+ * WCAG contrast ratio between two hex colors. Returns 1..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);
+}
+/**
+ * Pick a near-white or near-black text color that contrasts well against `bg`.
+ */
+export function pickContrastingText(bg, light = '#f7fafc', dark = '#1a202c') {
+    return contrastRatio(bg, dark) >= contrastRatio(bg, light) ? dark : light;
+}
+/**
+ * Derive a 5-step lighter→darker scale from a seed color.
+ * Stops are evenly spaced in OKLCh L space around the seed.
+ * `spread` controls amplitude (0.05 = subtle, 0.15 = balanced, 0.22 = high).
+ */
+export function deriveScale(seedHex, spread = 0.15) {
+    return {
+        lighter2: oklchLighten(seedHex, spread),
+        lighter1: oklchLighten(seedHex, spread / 2),
+        base: seedHex,
+        darker1: oklchDarken(seedHex, spread / 2),
+        darker2: oklchDarken(seedHex, spread),
+    };
+}
+//# sourceMappingURL=colorUtils.js.map

package/dist/schemas/colorUtils.js.map

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

package/dist/schemas/fontStacks.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Font Stacks
+ *
+ * Curated registry of font families used by built-in themes and offered in
+ * the theme customizer. Each stack has a stable `id` (referenced by JSON
+ * theme files via `{ stackId }`) and a CSS `family` string that resolves
+ * to the actual font when rendered.
+ *
+ * Themes never carry raw CSS font strings — they reference a `stackId` or
+ * specify a `{ custom: { name, fallback } }` form, both of which resolve
+ * here at render time.
+ */
+import type { FontFamily, FontFamilyKind } from './Theme.js';
+export interface FontStack {
+    /** Stable identifier referenced by Theme JSON. */
+    id: string;
+    /** Display label for pickers. */
+    label: string;
+    /** Full CSS font-family string with safe fallbacks. */
+    family: string;
+    /** Categorical bucket for the picker UI. */
+    kind: FontFamilyKind;
+    /**
+     * Google Fonts family name, when this stack is served by Google Fonts.
+     * Used by exports that bundle a `<link>` to fonts.googleapis.com so the
+     * face renders correctly even when the host page doesn't preload it.
+     * Omit (or set to undefined) for purely system stacks.
+     */
+    googleFontFamily?: string;
+}
+/** All curated stacks, in the order they should appear in pickers. */
+export declare const AVAILABLE_FONT_STACKS: FontStack[];
+/** Look up a stack by id. Returns undefined if not registered. */
+export declare function getFontStack(id: string): FontStack | undefined;
+/**
+ * Resolve a `FontFamily` reference (or legacy raw string) to a CSS family string.
+ * Used by `getThemeFont` at render time. Never returns an empty string —
+ * unrecognized stackIds fall back to the requested role's default.
+ */
+export declare function resolveFontFamily(family: FontFamily | string | undefined, roleFallback: string): string;
+/** Convenience: quick `{ stackId }` factory for code that constructs themes. */
+export declare function fontStack(id: string): FontFamily;
+/**
+ * Build a `https://fonts.googleapis.com/css2?...` URL that loads the
+ * subset of supplied `FontFamily` references that are served by Google
+ * Fonts. Returns `null` when nothing in the list needs Google hosting
+ * (system stacks, custom fonts, or unknown stack ids) — callers can use
+ * that to skip emitting a `<link>` entirely.
+ *
+ * The URL requests regular + bold (400/700) for each family, which is
+ * what the templates use. `display=swap` keeps the fallback visible
+ * while the web font streams in.
+ */
+export declare function buildGoogleFontsUrl(families: Array<FontFamily | undefined>): string | null;
+/** Default fallback families exposed for tools that need them. */
+export declare const FONT_FALLBACKS: Record<FontFamilyKind, string>;
+//# sourceMappingURL=fontStacks.d.ts.map

package/dist/schemas/fontStacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontStacks.d.ts","sourceRoot":"","sources":["../../src/schemas/fontStacks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,EAAE,SAAS,EAyI5C,CAAC;AAMF,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE9D;AAUD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,EACvC,YAAY,EAAE,MAAM,GACnB,MAAM,CAqBR;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,CAgB1F;AAED,kEAAkE;AAClE,eAAO,MAAM,cAAc,gCAAmB,CAAC"}

package/dist/schemas/fontStacks.js

@@ -0,0 +1,227 @@
+/**
+ * Font Stacks
+ *
+ * Curated registry of font families used by built-in themes and offered in
+ * the theme customizer. Each stack has a stable `id` (referenced by JSON
+ * theme files via `{ stackId }`) and a CSS `family` string that resolves
+ * to the actual font when rendered.
+ *
+ * Themes never carry raw CSS font strings — they reference a `stackId` or
+ * specify a `{ custom: { name, fallback } }` form, both of which resolve
+ * here at render time.
+ */
+/** All curated stacks, in the order they should appear in pickers. */
+export const AVAILABLE_FONT_STACKS = [
+    // System defaults
+    {
+        id: 'system-sans',
+        label: 'System Sans',
+        family: 'system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+        kind: 'sans',
+    },
+    {
+        id: 'system-serif',
+        label: 'System Serif',
+        family: 'Georgia, "Times New Roman", serif',
+        kind: 'serif',
+    },
+    {
+        id: 'system-mono',
+        label: 'System Mono',
+        family: 'Consolas, "Courier New", monospace',
+        kind: 'mono',
+    },
+    // Curated Google Fonts. `googleFontFamily` is the canonical family
+    // name Google serves the face under (used by exports that emit a
+    // `<link rel="stylesheet" href="https://fonts.googleapis.com/...">`
+    // so the face renders even when the host doesn't preload it).
+    {
+        id: 'inter',
+        label: 'Inter',
+        family: '"Inter", "Segoe UI", Roboto, sans-serif',
+        kind: 'sans',
+        googleFontFamily: 'Inter',
+    },
+    {
+        id: 'ibm-plex-sans',
+        label: 'IBM Plex Sans',
+        family: '"IBM Plex Sans", "Segoe UI", Roboto, sans-serif',
+        kind: 'sans',
+        googleFontFamily: 'IBM Plex Sans',
+    },
+    {
+        id: 'roboto',
+        label: 'Roboto',
+        family: '"Roboto", "Segoe UI", Arial, sans-serif',
+        kind: 'sans',
+        googleFontFamily: 'Roboto',
+    },
+    {
+        id: 'dm-sans',
+        label: 'DM Sans',
+        family: '"DM Sans", "Segoe UI", Roboto, sans-serif',
+        kind: 'sans',
+        googleFontFamily: 'DM Sans',
+    },
+    {
+        id: 'oswald',
+        label: 'Oswald',
+        family: '"Oswald", Impact, "Arial Black", sans-serif',
+        kind: 'display',
+        googleFontFamily: 'Oswald',
+    },
+    {
+        id: 'playfair',
+        label: 'Playfair Display',
+        family: '"Playfair Display", Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'Playfair Display',
+    },
+    {
+        id: 'source-serif',
+        label: 'Source Serif',
+        family: '"Source Serif 4", "PT Serif", Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'Source Serif 4',
+    },
+    {
+        id: 'merriweather',
+        label: 'Merriweather',
+        family: '"Merriweather", Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'Merriweather',
+    },
+    {
+        id: 'lora',
+        label: 'Lora',
+        family: '"Lora", "Merriweather", Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'Lora',
+    },
+    {
+        id: 'pt-serif',
+        label: 'PT Serif',
+        family: '"PT Serif", Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'PT Serif',
+    },
+    {
+        id: 'crimson',
+        label: 'Crimson Text',
+        family: '"Crimson Text", Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'Crimson Text',
+    },
+    {
+        id: 'cormorant',
+        label: 'Cormorant Garamond',
+        family: '"Cormorant Garamond", Garamond, Georgia, serif',
+        kind: 'serif',
+        googleFontFamily: 'Cormorant Garamond',
+    },
+    {
+        id: 'dm-serif',
+        label: 'DM Serif Display',
+        family: '"DM Serif Display", Georgia, serif',
+        kind: 'display',
+        googleFontFamily: 'DM Serif Display',
+    },
+    {
+        id: 'jetbrains-mono',
+        label: 'JetBrains Mono',
+        family: '"JetBrains Mono", "Fira Code", Consolas, monospace',
+        kind: 'mono',
+        googleFontFamily: 'JetBrains Mono',
+    },
+    // Themed system stacks with emoji fallbacks (used by gezellig)
+    {
+        id: 'system-sans-emoji',
+        label: 'System Sans + Emoji',
+        family: 'system-ui, -apple-system, "Segoe UI", Roboto, "OpenMoji Color", "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", sans-serif',
+        kind: 'sans',
+    },
+    {
+        id: 'system-serif-emoji',
+        label: 'System Serif + Emoji',
+        family: 'Georgia, "Times New Roman", "OpenMoji Color", "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", serif',
+        kind: 'serif',
+    },
+];
+const STACKS_BY_ID = Object.fromEntries(AVAILABLE_FONT_STACKS.map((s) => [s.id, s]));
+/** Look up a stack by id. Returns undefined if not registered. */
+export function getFontStack(id) {
+    return STACKS_BY_ID[id];
+}
+/** Default fallback CSS family per kind, used when a custom font has no fallback specified. */
+const FALLBACK_BY_KIND = {
+    sans: 'system-ui, sans-serif',
+    serif: 'Georgia, serif',
+    mono: 'Consolas, monospace',
+    display: 'Impact, Arial, sans-serif',
+};
+/**
+ * Resolve a `FontFamily` reference (or legacy raw string) to a CSS family string.
+ * Used by `getThemeFont` at render time. Never returns an empty string —
+ * unrecognized stackIds fall back to the requested role's default.
+ */
+export function resolveFontFamily(family, roleFallback) {
+    if (!family)
+        return roleFallback;
+    if (typeof family === 'string')
+        return family;
+    if ('stackId' in family) {
+        const stack = STACKS_BY_ID[family.stackId];
+        return stack ? stack.family : roleFallback;
+    }
+    if ('custom' in family) {
+        const { name, fallback } = family.custom;
+        const fb = fallback === 'system-ui'
+            ? 'system-ui, sans-serif'
+            : fallback === 'serif'
+                ? 'Georgia, serif'
+                : fallback === 'monospace'
+                    ? 'Consolas, monospace'
+                    : 'system-ui, sans-serif';
+        const safeName = name.includes(' ') || name.includes(',') ? `"${name}"` : name;
+        return `${safeName}, ${fb}`;
+    }
+    return roleFallback;
+}
+/** Convenience: quick `{ stackId }` factory for code that constructs themes. */
+export function fontStack(id) {
+    return { stackId: id };
+}
+/**
+ * Build a `https://fonts.googleapis.com/css2?...` URL that loads the
+ * subset of supplied `FontFamily` references that are served by Google
+ * Fonts. Returns `null` when nothing in the list needs Google hosting
+ * (system stacks, custom fonts, or unknown stack ids) — callers can use
+ * that to skip emitting a `<link>` entirely.
+ *
+ * The URL requests regular + bold (400/700) for each family, which is
+ * what the templates use. `display=swap` keeps the fallback visible
+ * while the web font streams in.
+ */
+export function buildGoogleFontsUrl(families) {
+    const names = new Set();
+    for (const f of families) {
+        if (!f || typeof f === 'string')
+            continue;
+        if ('stackId' in f) {
+            const stack = STACKS_BY_ID[f.stackId];
+            if (stack?.googleFontFamily)
+                names.add(stack.googleFontFamily);
+        }
+    }
+    if (names.size === 0)
+        return null;
+    // css2 syntax: ?family=Name+With+Spaces:wght@400;700&family=Other:wght@400;700&display=swap
+    const params = Array.from(names)
+        .sort()
+        .map((name) => `family=${encodeURIComponent(name).replace(/%20/g, '+')}:wght@400;700`)
+        .join('&');
+    return `https://fonts.googleapis.com/css2?${params}&display=swap`;
+}
+/** Default fallback families exposed for tools that need them. */
+export const FONT_FALLBACKS = FALLBACK_BY_KIND;
+//# sourceMappingURL=fontStacks.js.map

package/dist/schemas/fontStacks.js.map

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

package/dist/schemas/index.d.ts

@@ -3,8 +3,13 @@ export * from './Doc.js';
 export * from './BlockTemplates.js';
 export * from './Theme.js';
 export * from './themeLibrary.js';
+export * from './themeValidator.js';
+export * from './themeCompile.js';
+export * from './fontStacks.js';
+export * from './colorUtils.js';
 export * from './Viewport.js';
 export { getLayoutHints, getTwoColumnPositions, getSafeTextBounds, scaledFontSize as layoutScaledFontSize, } from './LayoutStrategy.js';
 export type { LayoutHints } from './LayoutStrategy.js';
 export type { MediaProvider, MediaEntry } from './MediaProvider.js';
+export type { ImageEditDoc, ImageEditLayer, ImageEditLayerKind, ImageEditCanvas, ImageEditMeta, EditorLayerMeta, } from './ImageEditDoc.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/schemas/index.js

@@ -3,6 +3,10 @@ export * from './Doc.js';
 export * from './BlockTemplates.js';
 export * from './Theme.js';
 export * from './themeLibrary.js';
+export * from './themeValidator.js';
+export * from './themeCompile.js';
+export * from './fontStacks.js';
+export * from './colorUtils.js';
 export * from './Viewport.js';
 export { getLayoutHints, getTwoColumnPositions, getSafeTextBounds, scaledFontSize as layoutScaledFontSize, } from './LayoutStrategy.js';
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,qBAAqB,CAAC"}

package/dist/schemas/themeCompile.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Theme Compilation
+ *
+ * Turns a partial Theme (typically authored by the customizer panel from
+ * a few seed colors and preset choices) into a complete, validated Theme
+ * by:
+ *
+ *   1. Filling unspecified fields from a hardcoded `STARTER_THEME`.
+ *   2. Deriving missing color slots from `seedColors` via OKLCh math.
+ *   3. Validating the result.
+ *
+ * Built-in themes ship as fully-specified Theme JSON and skip this step.
+ */
+import type { Theme, DeepPartial, ThemeColorPalette, ThemeSeedColors } from './Theme.js';
+export declare const STARTER_THEME: Theme;
+/**
+ * Derive a full `ThemeColorPalette` from `seedColors`, with any explicit
+ * `partialColors` taking precedence over derived values. Background and
+ * text are guessed from luminance when the user gave only a primary.
+ */
+export declare function deriveColorPalette(seeds: ThemeSeedColors, partialColors?: Partial<ThemeColorPalette>, opts?: {
+    contrast?: 'subtle' | 'balanced' | 'high';
+}): ThemeColorPalette;
+/** Map a contrast preset to numeric spread used by `deriveColorPalette`. */
+export type ContrastPreset = 'subtle' | 'balanced' | 'high';
+export interface CompileOptions {
+    /** Contrast level for OKLCh derivation (default 'balanced'). */
+    contrast?: ContrastPreset;
+}
+/**
+ * Compile a partial Theme into a complete one. Fills missing fields from
+ * `STARTER_THEME`, derives missing color slots from `seedColors` (when
+ * present), and validates the result.
+ */
+export declare function compileTheme(partial: DeepPartial<Theme>, opts?: CompileOptions): Theme;
+/**
+ * Parse a JSON string into a validated Theme. Throws on invalid input.
+ */
+export declare function parseTheme(json: string): Theme;
+/**
+ * Serialize a Theme to a stable, pretty-printed JSON string. Round-trips
+ * cleanly through `parseTheme`.
+ */
+export declare function serializeTheme(theme: Theme): string;
+//# sourceMappingURL=themeCompile.d.ts.map

package/dist/schemas/themeCompile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeCompile.d.ts","sourceRoot":"","sources":["../../src/schemas/themeCompile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,iBAAiB,EAEjB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAyBpB,eAAO,MAAM,aAAa,EAAE,KAmC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,aAAa,GAAE,OAAO,CAAC,iBAAiB,CAAM,EAC9C,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;CAAO,GACvD,iBAAiB,CA0CnB;AAED,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,GAAE,cAAmB,GAAG,KAAK,CA+B1F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAS9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEnD"}