@animus-ui/system 0.1.0-next.21 → 0.1.0-next.30

package/dist/types/theme.d.ts

@@ -1,23 +1,16 @@
 import type { LiteralPaths } from '../theme/flattenScale';
 export type { CSSObject } from './shared';
-export interface Breakpoints<T = number> {
-    xs: T;
-    sm: T;
-    md: T;
-    lg: T;
-    xl: T;
-}
 export interface BaseTheme {
-    breakpoints: Breakpoints;
 }
 export interface AbstractTheme extends BaseTheme {
+    breakpoints: Record<string, number>;
     readonly [key: string]: any;
 }
 /**
- * Filter internal ThemeBuilder keys from T so they don't appear as valid scales.
- * _variables, _tokens, mode, _getColorValue are implementation details.
+ * Filter non-scale keys from T so only user-defined scales appear.
+ * breakpoints, modes, mode are structural — not token scales.
  */
-export type TokenScales<T> = Omit<T, '_variables' | '_tokens' | 'mode' | '_getColorValue' | 'breakpoints' | 'modes'>;
+export type TokenScales<T> = Omit<T, 'breakpoints' | 'modes' | 'mode'>;
 /**
  * Augmentable Theme interface. Consumers extend this via module augmentation
  * to get type-safe scale lookups in .styles(), .variant(), and .states():
@@ -31,6 +24,10 @@ export type TokenScales<T> = Omit<T, '_variables' | '_tokens' | 'mode' | '_getCo
  * When augmented, CSS object values like `fontSize` become constrained to
  * the theme's scale keys (e.g. `11 | 12 | 13 | 14 | 16 | ...`).
  * When NOT augmented, values fall back to standard CSS property types.
+ *
+ * BaseTheme uses an open index signature so that module augmentation can
+ * provide a concrete breakpoints type (e.g. `{ sm: number; lg: number }`)
+ * without conflicting with a fixed Breakpoints interface.
  */
 export interface Theme extends BaseTheme {
 }
@@ -41,17 +38,15 @@ export interface Theme extends BaseTheme {
  */
 export type CSSColorValue = `#${string}` | `rgb(${string})` | `rgba(${string})` | `hsl(${string})` | `hsla(${string})` | `oklch(${string})` | `oklab(${string})` | `lch(${string})` | `lab(${string})` | `color-mix(${string})` | `color(${string})` | 'transparent' | 'currentColor' | (string & {});
 /**
- * Extract scale names from a built theme whose values are CSS variable references.
- * These are scales that were emitted via `addScale({ emit: true })` or `addColors()`.
+ * Extract scale names from a built theme that were emitted with CSS variables.
+ * With nested storage, emitted scales are tracked by the builder's Emitted type param.
+ * This heuristic checks for 'colors' (always emitted) and scales with var() values
+ * for backward compatibility with augmented Theme interfaces.
  *
- * Use with `TokenScales<T>` to pick emitted vs non-emitted subsets:
- * ```ts
- * type Emitted = Pick<TokenScales<T>, EmittedScales<T>>;
- * type Static = Omit<TokenScales<T>, EmittedScales<T>>;
- * ```
+ * TODO: Thread Emitted type param through the built theme type for precise detection.
  */
 export type EmittedScales<T> = {
-    [K in keyof TokenScales<T>]: TokenScales<T>[K] extends Record<string, `var(--${string})`> ? K : never;
+    [K in keyof TokenScales<T>]: K extends 'colors' ? K : TokenScales<T>[K] extends Record<string, `var(--${string})`> ? K : never;
 }[keyof TokenScales<T>];
 /**
  * All valid token ref paths for emitted scales in a theme.
@@ -68,6 +63,28 @@ export type EmittedTokenPaths<T> = keyof LiteralPaths<Pick<TokenScales<T>, Emitt
  * Constrains the scale name portion of `{scale.key}` to only emitted scales.
  */
 export type ScaleTokenRef<E extends string> = `${string}{${E}.${string}}${string}`;
+/**
+ * Token ref union for color-scale values, computed from the augmented Theme.
+ * Accepts `{colors.key}` and `{colors.key/alpha}` patterns.
+ *
+ * ```ts
+ * const ref: ColorTokenRef = '{colors.primary/50}'; // ✓
+ * ```
+ */
+export type ColorTokenRef = Theme extends {
+    colors: infer C;
+} ? C extends Record<string, unknown> ? `{colors.${Extract<keyof C, string>}}` | `{colors.${Extract<keyof C, string>}/${number}}` : never : never;
+/** Pipeline-ready JSON strings returned by `.serialize()` on a built theme. */
+export interface SerializedTheme {
+    /** Flattened token map as JSON: { "space.8": "0.5rem", "breakpoints.sm": "768" } */
+    scalesJson: string;
+    /** Token path → CSS variable name as JSON: { "colors.primary": "--colors-primary" } */
+    variableMapJson: string;
+    /** Pre-built CSS string with :root and [data-color-mode] blocks */
+    variableCss: string;
+    /** Contextual vars registry as JSON: { "colors": ["background-current"] } */
+    contextualVarsJson: string;
+}
 /** Structured manifest emitted by ThemeBuilder.build() for plugin consumption. */
 export interface ThemeManifest {
     /** Flat token key → raw value (e.g. 'space.8' → '0.5rem', 'colors.ember' → '#FF2800') */
@@ -78,5 +95,7 @@ export interface ThemeManifest {
     modes: Record<string, Record<string, string>>;
     /** Pre-built CSS string with :root and [data-color-mode] blocks */
     variableCss: string;
+    /** Contextual vars registry: scale_name → [var_name] for --current-{name} side-effects */
+    contextualVars?: Record<string, string[]>;
 }
 //# sourceMappingURL=theme.d.ts.map

package/dist/types/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,EAAE,EAAE,CAAC,CAAC;IACN,EAAE,EAAE,CAAC,CAAC;IACN,EAAE,EAAE,CAAC,CAAC;IACN,EAAE,EAAE,CAAC,CAAC;IACN,EAAE,EAAE,CAAC,CAAC;CACP;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,IAAI,CAC/B,CAAC,EACD,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAC/E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,KAAM,SAAQ,SAAS;CAAG;AAE3C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,IAAI,MAAM,EAAE,GACZ,OAAO,MAAM,GAAG,GAChB,QAAQ,MAAM,GAAG,GACjB,OAAO,MAAM,GAAG,GAChB,QAAQ,MAAM,GAAG,GACjB,SAAS,MAAM,GAAG,GAClB,SAAS,MAAM,GAAG,GAClB,OAAO,MAAM,GAAG,GAChB,OAAO,MAAM,GAAG,GAChB,aAAa,MAAM,GAAG,GACtB,SAAS,MAAM,GAAG,GAClB,aAAa,GACb,cAAc,GACd,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAC3D,MAAM,EACN,SAAS,MAAM,GAAG,CACnB,GACG,CAAC,GACD,KAAK;CACV,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,MAAM,YAAY,CACnD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EACtC,GAAG,CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IACxC,GAAG,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvC,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uGAAuG;IACvG,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"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"}

package/dist/utils/deepMerge.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Deep merge utility — replaces lodash.merge for variant accumulation.
+ */
+export declare function deepMerge<A extends Record<string, any>, B extends Record<string, any>>(target: A, source: B): A & B;
+//# sourceMappingURL=deepMerge.d.ts.map

package/dist/utils/deepMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/utils/deepMerge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAiB7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/system",
-  "version": "0.1.0-next.21",
+  "version": "0.1.0-next.30",
   "description": "Animus design system builder — tokens, prop groups, global styles",
   "author": "codecaaron <airrobb@gmail.com>",
   "license": "MIT",
@@ -16,6 +16,11 @@
     "./groups": {
       "types": "./dist/groups/index.d.ts",
       "import": "./dist/groups/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime-entry.d.ts",
+      "import": "./dist/runtime-entry.js",
+      "default": "./dist/runtime-entry.js"
     }
   },
   "files": [

package/dist/PropertyBuilder.d.ts

@@ -1,11 +0,0 @@
-import { Prop } from './types/config';
-export declare class PropertyBuilder<PropReg extends Record<string, Prop> = {}, GroupReg extends Record<string, (keyof PropReg)[]> = {}> {
-    #private;
-    constructor(props?: PropReg, groups?: GroupReg);
-    addGroup<Name extends string, Conf extends Record<string, Prop>, PropNames extends keyof Conf>(name: Name, config: Conf): PropertyBuilder<PropReg & Conf, GroupReg & Record<Name, PropNames[]>>;
-    build(): {
-        propRegistry: { [K in keyof PropReg]: PropReg[K]; };
-        groupRegistry: { [K in keyof GroupReg]: GroupReg[K]; };
-    };
-}
-//# sourceMappingURL=PropertyBuilder.d.ts.map

package/dist/PropertyBuilder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PropertyBuilder.d.ts","sourceRoot":"","sources":["../src/PropertyBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,qBAAa,eAAe,CAC1B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EACzC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE;;gBAK3C,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,QAAQ;IAK9C,QAAQ,CACN,IAAI,SAAS,MAAM,EACnB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EACjC,SAAS,SAAS,MAAM,IAAI,EAC5B,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI;IAW1B,KAAK;sBAE4B,GAAG,CAAC,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAE;uBAClC,GAAG,CAAC,IAAI,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAE;;CAG1E"}