@animus-ui/system 0.1.0-next.v7 → 0.1.1-beta.2

package/dist/types/theme.d.ts

@@ -1,18 +1,16 @@
-export interface Breakpoints<T = number> {
-    xs: T;
-    sm: T;
-    md: T;
-    lg: T;
-    xl: T;
-}
+import type { LiteralPaths } from '../theme/flattenScale';
+export type { CSSObject } from './shared';
 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():
@@ -26,7 +24,75 @@ 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 {
 }
+/**
+ * CSS <color> value type constraint for addColors().
+ * Template literal arms provide autocomplete for common formats.
+ * (string & {}) escape hatch allows future CSS color functions without blocking.
+ */
+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 that were emitted with CSS variables.
+ * Primary path: reads the __emitted phantom tuple from BuiltTheme.
+ * Fallback: 'colors' hardcoded as always-emitted (for augmented Theme interfaces without phantom).
+ */
+export type EmittedScales<T> = T extends {
+    __emitted: [infer E extends string];
+} ? E & keyof TokenScales<T> : 'colors' extends keyof TokenScales<T> ? 'colors' : never;
+/**
+ * All valid token ref paths for emitted scales in a theme.
+ * Uses LiteralPaths to enumerate `scale.key` paths from emitted scale entries.
+ *
+ * ```ts
+ * type Refs = EmittedTokenPaths<typeof tokens>;
+ * // → 'colors.primary' | 'colors.bg' | 'sizes.navHeight' | ...
+ * ```
+ */
+export type EmittedTokenPaths<T> = keyof LiteralPaths<Pick<TokenScales<T>, EmittedScales<T>>, '.'>;
+/**
+ * Token ref pattern type for referencing emitted scales.
+ * 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') */
+    tokenMap: Record<string, string>;
+    /** Flat token key → CSS variable name without var() wrapper (e.g. 'colors.ember' → '--color-ember') */
+    variableMap: Record<string, string>;
+    /** Mode name → flat key → resolved raw value (e.g. { dark: { 'colors.primary': '#FF2800' } }) */
+    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,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;;;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"}
+{"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,10 +1,33 @@
 {
   "name": "@animus-ui/system",
-  "version": "0.1.0-next.v7",
+  "version": "0.1.1-beta.2",
   "description": "Animus design system builder — tokens, prop groups, global styles",
-  "author": "codecaaron <airrobb@gmail.com>",
+  "keywords": [
+    "css",
+    "css-in-js",
+    "design-system",
+    "react",
+    "styled",
+    "styled-components",
+    "theming",
+    "tokens",
+    "typescript",
+    "variants",
+    "zero-runtime"
+  ],
+  "homepage": "https://github.com/codecaaron/animus/tree/main/packages/system#readme",
   "license": "MIT",
+  "author": "codecaaron <airrobb@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codecaaron/animus",
+    "directory": "packages/system"
+  },
+  "files": [
+    "dist"
+  ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,31 +39,37 @@
     "./groups": {
       "types": "./dist/groups/index.d.ts",
       "import": "./dist/groups/index.js"
+    },
+    "./compose": {
+      "types": "./dist/compose.d.ts",
+      "import": "./dist/compose.js"
+    },
+    "./compose-with-context": {
+      "types": "./dist/composeWithContext.d.ts",
+      "import": "./dist/composeWithContext.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime-entry.d.ts",
+      "import": "./dist/runtime-entry.js",
+      "default": "./dist/runtime-entry.js"
     }
   },
-  "files": [
-    "dist"
-  ],
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/codecaaron/animus"
-  },
   "scripts": {
-    "build": "tsdown && tsc -p tsconfig.build.json",
-    "compile": "tsc --noEmit"
+    "build": "bun run build:ts",
+    "build:ts": "tsdown && tsgo -p tsconfig.build.json",
+    "compile": "tsgo --noEmit"
   },
   "dependencies": {
-    "@animus-ui/runtime": "0.1.0-next.v7",
-    "@animus-ui/theming": "0.1.0-next.v7"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0"
+    "@animus-ui/properties": "0.1.1-beta.2",
+    "csstype": "^3.1.3"
   },
   "devDependencies": {
-    "csstype": "^3.1.3",
     "react": "^18.2.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
   }
 }

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"}

package/dist/size-Dge_rsuz.js

@@ -1,70 +0,0 @@
-//#region src/scales/createScale.ts
-const createScale = () => [];
-const numericScale = [];
-const stringScale = [];
-const numericOrStringScale = [];
-//#endregion
-//#region src/transforms/createTransform.ts
-function createTransform(name, fn) {
-	const wrapper = (value, property, props) => fn(value, property, props);
-	Object.defineProperty(wrapper, "name", { value: name });
-	return Object.assign(wrapper, { transformName: name });
-}
-//#endregion
-//#region src/transforms/utils.ts
-const numberToTemplate = (val, template) => typeof val === "number" ? template(val) : val;
-//#endregion
-//#region src/transforms/border.ts
-const borderShorthand = createTransform("borderShorthand", (val) => numberToTemplate(val, (width) => `${width}px solid currentColor`));
-//#endregion
-//#region src/transforms/grid.ts
-const gridItemMap = {
-	max: "max-content",
-	min: "min-content"
-};
-const unitlessNumber = /* @__PURE__ */ new RegExp(/^[0-9]*$/);
-const isUnitlessNumber = (val) => unitlessNumber.test(val);
-const gridItem = createTransform("gridItem", (item) => {
-	const strItem = String(item);
-	return `minmax(0, ${isUnitlessNumber(strItem) ? `${strItem}fr` : gridItemMap[strItem] ?? strItem})`;
-});
-const repeatGridItem = (item, count) => {
-	const template = gridItem(item);
-	return count > 1 ? `repeat(${count}, ${template})` : template;
-};
-const parseGridRatio = (val) => {
-	const items = val.split(":");
-	let repeated = ["", 0];
-	let gridStyle = "";
-	for (let i = 0; i < items.length + 1; i += 1) {
-		const delimiter = gridStyle.length > 0 ? " " : "";
-		const curr = items[i];
-		if (repeated?.[0] !== curr) {
-			if (repeated[0].length) gridStyle += delimiter + repeatGridItem(...repeated);
-			if (curr) repeated = [curr, 1];
-		} else repeated[1] += 1;
-	}
-	return gridStyle;
-};
-const gridItemRatio = createTransform("gridItemRatio", (val) => {
-	return typeof val === "number" ? repeatGridItem("1", val) : parseGridRatio(val);
-});
-//#endregion
-//#region src/transforms/size.ts
-const percentageOrAbsolute = (coordinate) => {
-	if (coordinate === 0) return coordinate;
-	if (coordinate <= 1 && coordinate >= -1) return `${coordinate * 100}%`;
-	return `${coordinate}px`;
-};
-const valueWithUnit = /(-?\d*\.?\d+)(%|\w*)/;
-const size = createTransform("size", (value) => {
-	if (typeof value === "number") return percentageOrAbsolute(value);
-	const strValue = value;
-	if (strValue.includes("calc")) return strValue;
-	const [match, number, unit] = valueWithUnit.exec(strValue) || [];
-	if (match === void 0) return strValue;
-	const numericValue = parseFloat(number);
-	return !unit ? percentageOrAbsolute(numericValue) : `${numericValue}${unit}`;
-});
-//#endregion
-export { borderShorthand as a, numericOrStringScale as c, gridItemRatio as i, numericScale as l, size as n, createTransform as o, gridItem as r, createScale as s, percentageOrAbsolute as t, stringScale as u };

package/dist/transforms/utils.d.ts

@@ -1,3 +0,0 @@
-export declare const numberToTemplate: (val: string | number, template: (val: number) => string) => string;
-export declare const numberToPx: (val: string | number) => string;
-//# sourceMappingURL=utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/transforms/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAC3B,KAAK,MAAM,GAAG,MAAM,EACpB,UAAU,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,WACiB,CAAC;AAErD,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,GAAG,MAAM,WAE9C,CAAC"}