@motion-proto/live-tokens 0.52.1 → 0.53.0

package/dist-plugin/{themeTypes-Dky03HL9.d.cts → 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;
@@ -146,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;
@@ -170,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`.
@@ -186,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;
@@ -212,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`.
@@ -220,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-Dky03HL9.d.ts → 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;
@@ -146,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;
@@ -170,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`.
@@ -186,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;
@@ -212,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`.
@@ -220,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 };