@motion-proto/live-tokens 0.47.1 → 0.48.0

package/dist-plugin/generateColorsAndType/index.d.cts

@@ -0,0 +1,81 @@
+import { F as FontSource, b as FontStack, G as GradientDiskToken, O as Oklch, H as HarmonyMode, C as ColorsAndType } from '../themeTypes-DMHZOnUn.cjs';
+export { r as readLiveTokensConfig, a as resolveDataDirs } from '../dataPaths-DBN0RPuT.cjs';
+
+/**
+ * Pure palette → CSS-variable derivation.
+ *
+ * Mirrors the logic that previously lived only inside `PaletteEditor.svelte`'s
+ * reactive emission, but as standalone functions so the editor store can emit
+ * palette-derived vars at boot without requiring any editor component to be
+ * mounted. Without this module the disabled-state preview (and any other
+ * `var(--surface-neutral)` consumer) reads a stale value on reload until the
+ * user opens the LiveEditorOverlay and mounts the PaletteEditors.
+ *
+ * The PaletteEditor still owns *editing* preview (draft hex picked but not
+ * yet committed to overrides). Once committed via the store, this module
+ * derives the same CSS vars from the persisted config.
+ */
+
+type SchemeDirection = 'light' | 'dark';
+
+/**
+ * Brief → generator: a full ColorsAndType from 10 OKLCH seeds + a scheme, with
+ * AA floors enforced on derived text tokens. Seed *selection* lives in the
+ * live-tokens-generate-theme skill; the CLI reaches this via
+ * `dist-plugin/generateColorsAndType`, so keep this module Node-safe (no DOM).
+ */
+
+interface ColorsAndTypeBrief {
+    name: string;
+    scheme: SchemeDirection;
+    /** One seed per palette label (all 10 required); hex string or numeric OKLCH. */
+    seeds: Record<string, Oklch | string>;
+    /** Advisory record of the harmony reasoning; seeds stay ground truth. */
+    harmony?: {
+        mode: HarmonyMode;
+    };
+    /** Page-background sky. Off by default; the skill turns it on only when the
+     *  mood brief evokes atmosphere. The engine derives the stops itself, on the
+     *  scheme's safe side of the Canvas anchor. */
+    canvasGradient?: boolean;
+}
+/** Non-color content carried forward from the currently active colors and type
+ *  so gradients, shadows, component aliases, and fonts survive regeneration. */
+interface CarryForward {
+    cssVariables?: Record<string, string>;
+    fontSources?: FontSource[];
+    fontStacks?: FontStack[];
+    gradients?: GradientDiskToken[];
+}
+interface ContrastCheck {
+    textVar: string;
+    floor: number;
+    /** Worst (lowest-ratio) surface this text was checked against. */
+    against: string;
+    ratio: number;
+    pass: boolean;
+    corrected: boolean;
+}
+interface GenerateColorsAndTypeReport {
+    scheme: SchemeDirection;
+    checks: ContrastCheck[];
+    failures: string[];
+    /** 'recipes' when the engine replaced absent/stock swatch gradients with the
+     *  family-relative recipes; 'carried' when user-tuned ones rode through. */
+    gradients: 'recipes' | 'carried';
+    /** Present when the brief opted into the page-background sky: either
+     *  'on, <sky> → <anchor>' or a 'skipped — …' explanation when the Canvas
+     *  anchors at the ramp edge and leaves no room. */
+    canvasGradient?: string;
+}
+interface GenerateColorsAndTypeResult {
+    colorsAndType: ColorsAndType;
+    slug: string;
+    report: GenerateColorsAndTypeReport;
+}
+declare function buildColorsAndTypeFromSeeds(brief: ColorsAndTypeBrief, carry?: CarryForward, now?: string): GenerateColorsAndTypeResult;
+
+/** Sanitize a display name to a safe file name. Pure — no DOM, no fs. */
+declare function sanitizeFileName(name: string): string;
+
+export { type CarryForward, type ColorsAndTypeBrief, type ContrastCheck, type GenerateColorsAndTypeReport, type GenerateColorsAndTypeResult, buildColorsAndTypeFromSeeds, sanitizeFileName };

package/dist-plugin/generateColorsAndType/index.d.ts

@@ -0,0 +1,81 @@
+import { F as FontSource, b as FontStack, G as GradientDiskToken, O as Oklch, H as HarmonyMode, C as ColorsAndType } from '../themeTypes-DMHZOnUn.js';
+export { r as readLiveTokensConfig, a as resolveDataDirs } from '../dataPaths-DBN0RPuT.js';
+
+/**
+ * Pure palette → CSS-variable derivation.
+ *
+ * Mirrors the logic that previously lived only inside `PaletteEditor.svelte`'s
+ * reactive emission, but as standalone functions so the editor store can emit
+ * palette-derived vars at boot without requiring any editor component to be
+ * mounted. Without this module the disabled-state preview (and any other
+ * `var(--surface-neutral)` consumer) reads a stale value on reload until the
+ * user opens the LiveEditorOverlay and mounts the PaletteEditors.
+ *
+ * The PaletteEditor still owns *editing* preview (draft hex picked but not
+ * yet committed to overrides). Once committed via the store, this module
+ * derives the same CSS vars from the persisted config.
+ */
+
+type SchemeDirection = 'light' | 'dark';
+
+/**
+ * Brief → generator: a full ColorsAndType from 10 OKLCH seeds + a scheme, with
+ * AA floors enforced on derived text tokens. Seed *selection* lives in the
+ * live-tokens-generate-theme skill; the CLI reaches this via
+ * `dist-plugin/generateColorsAndType`, so keep this module Node-safe (no DOM).
+ */
+
+interface ColorsAndTypeBrief {
+    name: string;
+    scheme: SchemeDirection;
+    /** One seed per palette label (all 10 required); hex string or numeric OKLCH. */
+    seeds: Record<string, Oklch | string>;
+    /** Advisory record of the harmony reasoning; seeds stay ground truth. */
+    harmony?: {
+        mode: HarmonyMode;
+    };
+    /** Page-background sky. Off by default; the skill turns it on only when the
+     *  mood brief evokes atmosphere. The engine derives the stops itself, on the
+     *  scheme's safe side of the Canvas anchor. */
+    canvasGradient?: boolean;
+}
+/** Non-color content carried forward from the currently active colors and type
+ *  so gradients, shadows, component aliases, and fonts survive regeneration. */
+interface CarryForward {
+    cssVariables?: Record<string, string>;
+    fontSources?: FontSource[];
+    fontStacks?: FontStack[];
+    gradients?: GradientDiskToken[];
+}
+interface ContrastCheck {
+    textVar: string;
+    floor: number;
+    /** Worst (lowest-ratio) surface this text was checked against. */
+    against: string;
+    ratio: number;
+    pass: boolean;
+    corrected: boolean;
+}
+interface GenerateColorsAndTypeReport {
+    scheme: SchemeDirection;
+    checks: ContrastCheck[];
+    failures: string[];
+    /** 'recipes' when the engine replaced absent/stock swatch gradients with the
+     *  family-relative recipes; 'carried' when user-tuned ones rode through. */
+    gradients: 'recipes' | 'carried';
+    /** Present when the brief opted into the page-background sky: either
+     *  'on, <sky> → <anchor>' or a 'skipped — …' explanation when the Canvas
+     *  anchors at the ramp edge and leaves no room. */
+    canvasGradient?: string;
+}
+interface GenerateColorsAndTypeResult {
+    colorsAndType: ColorsAndType;
+    slug: string;
+    report: GenerateColorsAndTypeReport;
+}
+declare function buildColorsAndTypeFromSeeds(brief: ColorsAndTypeBrief, carry?: CarryForward, now?: string): GenerateColorsAndTypeResult;
+
+/** Sanitize a display name to a safe file name. Pure — no DOM, no fs. */
+declare function sanitizeFileName(name: string): string;
+
+export { type CarryForward, type ColorsAndTypeBrief, type ContrastCheck, type GenerateColorsAndTypeReport, type GenerateColorsAndTypeResult, buildColorsAndTypeFromSeeds, sanitizeFileName };