@motion-proto/live-tokens 0.50.0 → 0.53.0

package/dist-plugin/{themeTypes-DSwKq-bj.d.ts → index-DpTIRZ2H.d.cts}

@@ -7,6 +7,31 @@ interface CurveAnchor {
     outDy: number;
 }
 
+interface GradientStop$1 {
+    /** 0–100 percentage along the gradient axis. */
+    position: number;
+    /** A design-token name (`--surface-neutral-low`) or a raw CSS colour. */
+    color: string;
+    /** 0–100 alpha. Absent means 100. */
+    opacity?: number;
+    /** `false` marks the stop an explicit off-palette override: the stop picker
+     *  opens to any colour rather than the current family, and a family-swap
+     *  rewrite skips the stop so its colour survives. Absent means `true`.
+     *  It has no CSS form, so `parseGradientValue` never produces it and
+     *  `formatGradientValue` ignores it. It lives on the shared stop because
+     *  the persisted stop carries it. */
+    monochrome?: boolean;
+}
+interface GradientValue {
+    type: 'linear' | 'radial' | 'solid' | 'none';
+    angle: number;
+    radius?: number;
+    centerX?: number;
+    aspectX?: number;
+    aspectY?: number;
+    stops: GradientStop$1[];
+}
+
 interface Oklch {
     l: number;
     c: number;
@@ -33,11 +58,21 @@ interface PaletteConfig {
     baseColor: Oklch;
     lightnessCurve: CurveAnchor[];
     saturationCurve: CurveAnchor[];
+    /** Signed hue offset in degrees per step, applied on top of the base hue.
+     *  Absent means flat zero: the palette holds one hue, which is what every
+     *  theme saved before this field did. */
+    hueCurve?: CurveAnchor[];
     scaleCurves: Record<string, {
         lightness: CurveAnchor[];
         saturation: CurveAnchor[];
+        hue?: CurveAnchor[];
     }>;
     curveOffset: Record<string, number>;
+    /** Per curve key: are the tangents derived from the points, or held by hand?
+     *  Only an explicit switch-off is recorded. A missing key means the curve's own
+     *  shape answers (`isAutoSmoothCurve`), which is what every theme saved before
+     *  the flag existed relies on. */
+    curveAutoSmooth?: Record<string, boolean>;
     overrides: Record<string, Oklch>;
     snappedScales: string[];
     emptyMode?: 'solid' | 'gradient';
@@ -50,11 +85,12 @@ interface PaletteConfig {
     /**
      * Where the base color sits in the ramp while `anchorToBase` is on: the
      * PALETTE_STEPS index whose curve anchors are pinned to the base color
-     * (lightness = base L, saturation = multiplier 100). `displacedL` /
-     * `displacedS` remember the y of a pre-existing anchor (endpoint or
-     * user-authored) the placement overwrote at that x, so moving the
-     * placement or toggling off restores it instead of deleting it.
-     * `priorLightnessEndpoints` / `priorSaturationEndpoints` remember the two
+     * (lightness = base L, saturation = multiplier 100, hue delta = 0 when a
+     * hue curve exists). `displacedL` / `displacedS` / `displacedH` remember
+     * the y of a pre-existing anchor (endpoint or user-authored) the placement
+     * overwrote at that x, so moving the placement or toggling off restores it
+     * instead of deleting it. `priorLightnessEndpoints` /
+     * `priorSaturationEndpoints` / `priorHueEndpoints` remember the two
      * endpoints exactly as they stood before the curve's first-ever placement
      * (a smoothed reshape, not algebraically invertible the way a later
      * scaled-handle re-placement is), so a clear can still restore the true
@@ -64,8 +100,10 @@ interface PaletteConfig {
         step: number;
         displacedL?: number;
         displacedS?: number;
+        displacedH?: number;
         priorLightnessEndpoints?: [CurveAnchor, CurveAnchor];
         priorSaturationEndpoints?: [CurveAnchor, CurveAnchor];
+        priorHueEndpoints?: [CurveAnchor, CurveAnchor];
     };
     /**
      * Set to true by importers when they overlay `cssVariables[--color-{ns}-*]`
@@ -133,11 +171,21 @@ interface GradientDiskToken {
     }[];
 }
 /**
- * Where a live read resolved from: the unsaved `_working` buffer, the open
- * theme's embedded copy, or the shipped default. A `working` source is an
- * unsaved delta from the active theme.
+ * Where a live component config resolved from: the unsaved `_working`
+ * buffer, or the open theme's embedded copy. Every theme carries every
+ * component complete, so `working` is the only genuine divergence —
+ * anything else is what the open document itself resolves to.
+ */
+type LiveSource = 'working' | 'theme';
+/**
+ * Where a live colors-and-type read resolved from. Unlike `LiveSource`, this
+ * keeps a third value: colors-and-type resolution is unchanged by the theme
+ * completeness work (docs/plans/theme-completeness.md Wave 4), so `default`
+ * still answers the one case completeness can't reach — the open theme's
+ * file itself is unreadable (a stale pointer, or deleted mid-session), so
+ * there is no document to resolve `working` or `theme` against.
  */
-type LiveSource = 'working' | 'theme' | 'default';
+type ColorsAndTypeSource = 'working' | 'theme' | 'default';
 interface ColorsAndType {
     name: string;
     createdAt: string;
@@ -157,8 +205,8 @@ interface ColorsAndType {
      * handlers; read by `themeInit` to seed `openThemeSlug`. Not persisted.
      */
     _fileName?: string;
-    /** Server-attached marker: which of the three live layers answered. */
-    _source?: LiveSource;
+    /** Server-attached marker: which live layer answered. See `ColorsAndTypeSource`. */
+    _source?: ColorsAndTypeSource;
     /**
      * Migration stamp. Absent on legacy files, treated as 0; the loader runs
      * any registered theme migrations whose `fromVersion >= file.schemaVersion`.
@@ -173,19 +221,7 @@ interface ColorsAndType {
  *  gradients that can't compress to a single string. */
 type AliasDiskValue = string | {
     kind: 'gradient';
-    value: {
-        type: 'linear' | 'radial' | 'solid' | 'none';
-        angle: number;
-        radius?: number;
-        centerX?: number;
-        aspectX?: number;
-        aspectY?: number;
-        stops: {
-            position: number;
-            color: string;
-            opacity?: number;
-        }[];
-    };
+    value: GradientValue;
 };
 interface ComponentConfig {
     name: string;
@@ -199,7 +235,10 @@ interface ComponentConfig {
      * theme, not a config file. Set by the component-configs GET handlers.
      */
     _fileName?: string;
-    /** Server-attached marker: which of the three live layers answered. */
+    /** Server-attached marker: which live layer answered — `working` the
+     *  buffer, `theme` the open document's embedded copy. No third value:
+     *  every theme carries every component, so there is no shipped-default
+     *  layer left to report (unlike `ColorsAndTypeSource`). */
     _source?: LiveSource;
     /**
      * Migration stamp. Absent on legacy files, treated as 0. See `ColorsAndType.schemaVersion`.
@@ -207,4 +246,6 @@ interface ComponentConfig {
     schemaVersion?: number;
 }
 
-export type { AliasDiskValue as A, ColorsAndType as C, FontSource as F, GradientDiskToken as G, HarmonyMode as H, Oklch as O, ComponentConfig as a, FontStack as b };
+declare const CURRENT_COMPONENT_SCHEMA_VERSION: number;
+
+export { type AliasDiskValue as A, CURRENT_COMPONENT_SCHEMA_VERSION as C, type FontSource as F, type GradientDiskToken as G, type HarmonyMode as H, type Oklch as O, type ColorsAndType as a, type ComponentConfig as b, type FontStack as c };

package/dist-plugin/{themeTypes-DSwKq-bj.d.cts → index-DpTIRZ2H.d.ts}

@@ -7,6 +7,31 @@ interface CurveAnchor {
     outDy: number;
 }
 
+interface GradientStop$1 {
+    /** 0–100 percentage along the gradient axis. */
+    position: number;
+    /** A design-token name (`--surface-neutral-low`) or a raw CSS colour. */
+    color: string;
+    /** 0–100 alpha. Absent means 100. */
+    opacity?: number;
+    /** `false` marks the stop an explicit off-palette override: the stop picker
+     *  opens to any colour rather than the current family, and a family-swap
+     *  rewrite skips the stop so its colour survives. Absent means `true`.
+     *  It has no CSS form, so `parseGradientValue` never produces it and
+     *  `formatGradientValue` ignores it. It lives on the shared stop because
+     *  the persisted stop carries it. */
+    monochrome?: boolean;
+}
+interface GradientValue {
+    type: 'linear' | 'radial' | 'solid' | 'none';
+    angle: number;
+    radius?: number;
+    centerX?: number;
+    aspectX?: number;
+    aspectY?: number;
+    stops: GradientStop$1[];
+}
+
 interface Oklch {
     l: number;
     c: number;
@@ -33,11 +58,21 @@ interface PaletteConfig {
     baseColor: Oklch;
     lightnessCurve: CurveAnchor[];
     saturationCurve: CurveAnchor[];
+    /** Signed hue offset in degrees per step, applied on top of the base hue.
+     *  Absent means flat zero: the palette holds one hue, which is what every
+     *  theme saved before this field did. */
+    hueCurve?: CurveAnchor[];
     scaleCurves: Record<string, {
         lightness: CurveAnchor[];
         saturation: CurveAnchor[];
+        hue?: CurveAnchor[];
     }>;
     curveOffset: Record<string, number>;
+    /** Per curve key: are the tangents derived from the points, or held by hand?
+     *  Only an explicit switch-off is recorded. A missing key means the curve's own
+     *  shape answers (`isAutoSmoothCurve`), which is what every theme saved before
+     *  the flag existed relies on. */
+    curveAutoSmooth?: Record<string, boolean>;
     overrides: Record<string, Oklch>;
     snappedScales: string[];
     emptyMode?: 'solid' | 'gradient';
@@ -50,11 +85,12 @@ interface PaletteConfig {
     /**
      * Where the base color sits in the ramp while `anchorToBase` is on: the
      * PALETTE_STEPS index whose curve anchors are pinned to the base color
-     * (lightness = base L, saturation = multiplier 100). `displacedL` /
-     * `displacedS` remember the y of a pre-existing anchor (endpoint or
-     * user-authored) the placement overwrote at that x, so moving the
-     * placement or toggling off restores it instead of deleting it.
-     * `priorLightnessEndpoints` / `priorSaturationEndpoints` remember the two
+     * (lightness = base L, saturation = multiplier 100, hue delta = 0 when a
+     * hue curve exists). `displacedL` / `displacedS` / `displacedH` remember
+     * the y of a pre-existing anchor (endpoint or user-authored) the placement
+     * overwrote at that x, so moving the placement or toggling off restores it
+     * instead of deleting it. `priorLightnessEndpoints` /
+     * `priorSaturationEndpoints` / `priorHueEndpoints` remember the two
      * endpoints exactly as they stood before the curve's first-ever placement
      * (a smoothed reshape, not algebraically invertible the way a later
      * scaled-handle re-placement is), so a clear can still restore the true
@@ -64,8 +100,10 @@ interface PaletteConfig {
         step: number;
         displacedL?: number;
         displacedS?: number;
+        displacedH?: number;
         priorLightnessEndpoints?: [CurveAnchor, CurveAnchor];
         priorSaturationEndpoints?: [CurveAnchor, CurveAnchor];
+        priorHueEndpoints?: [CurveAnchor, CurveAnchor];
     };
     /**
      * Set to true by importers when they overlay `cssVariables[--color-{ns}-*]`
@@ -133,11 +171,21 @@ interface GradientDiskToken {
     }[];
 }
 /**
- * Where a live read resolved from: the unsaved `_working` buffer, the open
- * theme's embedded copy, or the shipped default. A `working` source is an
- * unsaved delta from the active theme.
+ * Where a live component config resolved from: the unsaved `_working`
+ * buffer, or the open theme's embedded copy. Every theme carries every
+ * component complete, so `working` is the only genuine divergence —
+ * anything else is what the open document itself resolves to.
+ */
+type LiveSource = 'working' | 'theme';
+/**
+ * Where a live colors-and-type read resolved from. Unlike `LiveSource`, this
+ * keeps a third value: colors-and-type resolution is unchanged by the theme
+ * completeness work (docs/plans/theme-completeness.md Wave 4), so `default`
+ * still answers the one case completeness can't reach — the open theme's
+ * file itself is unreadable (a stale pointer, or deleted mid-session), so
+ * there is no document to resolve `working` or `theme` against.
  */
-type LiveSource = 'working' | 'theme' | 'default';
+type ColorsAndTypeSource = 'working' | 'theme' | 'default';
 interface ColorsAndType {
     name: string;
     createdAt: string;
@@ -157,8 +205,8 @@ interface ColorsAndType {
      * handlers; read by `themeInit` to seed `openThemeSlug`. Not persisted.
      */
     _fileName?: string;
-    /** Server-attached marker: which of the three live layers answered. */
-    _source?: LiveSource;
+    /** Server-attached marker: which live layer answered. See `ColorsAndTypeSource`. */
+    _source?: ColorsAndTypeSource;
     /**
      * Migration stamp. Absent on legacy files, treated as 0; the loader runs
      * any registered theme migrations whose `fromVersion >= file.schemaVersion`.
@@ -173,19 +221,7 @@ interface ColorsAndType {
  *  gradients that can't compress to a single string. */
 type AliasDiskValue = string | {
     kind: 'gradient';
-    value: {
-        type: 'linear' | 'radial' | 'solid' | 'none';
-        angle: number;
-        radius?: number;
-        centerX?: number;
-        aspectX?: number;
-        aspectY?: number;
-        stops: {
-            position: number;
-            color: string;
-            opacity?: number;
-        }[];
-    };
+    value: GradientValue;
 };
 interface ComponentConfig {
     name: string;
@@ -199,7 +235,10 @@ interface ComponentConfig {
      * theme, not a config file. Set by the component-configs GET handlers.
      */
     _fileName?: string;
-    /** Server-attached marker: which of the three live layers answered. */
+    /** Server-attached marker: which live layer answered — `working` the
+     *  buffer, `theme` the open document's embedded copy. No third value:
+     *  every theme carries every component, so there is no shipped-default
+     *  layer left to report (unlike `ColorsAndTypeSource`). */
     _source?: LiveSource;
     /**
      * Migration stamp. Absent on legacy files, treated as 0. See `ColorsAndType.schemaVersion`.
@@ -207,4 +246,6 @@ interface ComponentConfig {
     schemaVersion?: number;
 }
 
-export type { AliasDiskValue as A, ColorsAndType as C, FontSource as F, GradientDiskToken as G, HarmonyMode as H, Oklch as O, ComponentConfig as a, FontStack as b };
+declare const CURRENT_COMPONENT_SCHEMA_VERSION: number;
+
+export { type AliasDiskValue as A, CURRENT_COMPONENT_SCHEMA_VERSION as C, type FontSource as F, type GradientDiskToken as G, type HarmonyMode as H, type Oklch as O, type ColorsAndType as a, type ComponentConfig as b, type FontStack as c };