@aihu/css-engine 0.1.0

package/crates/aihu-css-core/tests/snapshots/scoped_snapshot__standard_variants.snap

@@ -0,0 +1,33 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/scoped_snapshot.rs
+expression: "compile_sfc_scoped(&sfc(\"hover:bg-primary focus:text-accent dark:bg-surface md:p-8 [&>div]:text-primary md:hover:bg-primary\"))"
+---
+:host {
+  --color-accent: #c8543a;
+  --color-accent-foreground: #faf8f4;
+  --color-background: #faf8f4;
+  --color-border: #ddd9d2;
+  --color-destructive: #a8432b;
+  --color-destructive-foreground: #faf8f4;
+  --color-foreground: #1a1d24;
+  --color-muted: #5a5a55;
+  --color-muted-foreground: #8a8880;
+  --color-primary: #1a1d24;
+  --color-primary-foreground: #faf8f4;
+  --color-ring: #c8543a;
+  --color-secondary: #5a5a55;
+  --color-secondary-foreground: #faf8f4;
+  --color-surface: #faf8f4;
+  --color-surface-foreground: #1a1d24;
+}
+.\[&>div\]\:text-primary>div { color: var(--color-primary); }
+/* dark cascade (Firefox-safe; see decision-firefox-host-context-workaround) */
+:host([data-theme="dark"]) .dark\:bg-surface, :root.dark .dark\:bg-surface { background-color: var(--color-surface); }
+.focus\:text-accent:focus { color: var(--color-accent); }
+.hover\:bg-primary:hover { background-color: var(--color-primary); }
+@media (min-width: 48rem) {
+.md\:hover\:bg-primary:hover { background-color: var(--color-primary); }
+}
+@media (min-width: 48rem) {
+.md\:p-8 { padding: 2rem; }
+}

package/crates/aihu-css-core/tests/snapshots/scoped_snapshot__theme_default_vs_override.snap

@@ -0,0 +1,45 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/scoped_snapshot.rs
+expression: "format!(\"--- default ---\\n{default}\\n--- override ---\\n{overridden}\")"
+---
+--- default ---
+:host {
+  --color-accent: #c8543a;
+  --color-accent-foreground: #faf8f4;
+  --color-background: #faf8f4;
+  --color-border: #ddd9d2;
+  --color-destructive: #a8432b;
+  --color-destructive-foreground: #faf8f4;
+  --color-foreground: #1a1d24;
+  --color-muted: #5a5a55;
+  --color-muted-foreground: #8a8880;
+  --color-primary: #1a1d24;
+  --color-primary-foreground: #faf8f4;
+  --color-ring: #c8543a;
+  --color-secondary: #5a5a55;
+  --color-secondary-foreground: #faf8f4;
+  --color-surface: #faf8f4;
+  --color-surface-foreground: #1a1d24;
+}
+.bg-primary { background-color: var(--color-primary); }
+
+--- override ---
+:host {
+  --color-accent: #c8543a;
+  --color-accent-foreground: #faf8f4;
+  --color-background: #faf8f4;
+  --color-border: #ddd9d2;
+  --color-destructive: #a8432b;
+  --color-destructive-foreground: #faf8f4;
+  --color-foreground: #1a1d24;
+  --color-muted: #5a5a55;
+  --color-muted-foreground: #8a8880;
+  --color-primary: oklch(0.55 0.18 28);
+  --color-primary-foreground: #faf8f4;
+  --color-ring: #c8543a;
+  --color-secondary: #5a5a55;
+  --color-secondary-foreground: #faf8f4;
+  --color-surface: #faf8f4;
+  --color-surface-foreground: #1a1d24;
+}
+.bg-primary { background-color: var(--color-primary); }

package/crates/aihu-css-core/tests/snapshots/scoped_snapshot__wc_native_variants.snap

@@ -0,0 +1,28 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/scoped_snapshot.rs
+expression: "compile_sfc_scoped(&sfc(\"host:bg-primary slotted:p-4 slotted-img:rounded-lg part-thumb:bg-accent host-context-dark:bg-surface\"))"
+---
+:host {
+  --color-accent: #c8543a;
+  --color-accent-foreground: #faf8f4;
+  --color-background: #faf8f4;
+  --color-border: #ddd9d2;
+  --color-destructive: #a8432b;
+  --color-destructive-foreground: #faf8f4;
+  --color-foreground: #1a1d24;
+  --color-muted: #5a5a55;
+  --color-muted-foreground: #8a8880;
+  --color-primary: #1a1d24;
+  --color-primary-foreground: #faf8f4;
+  --color-ring: #c8543a;
+  --color-secondary: #5a5a55;
+  --color-secondary-foreground: #faf8f4;
+  --color-surface: #faf8f4;
+  --color-surface-foreground: #1a1d24;
+}
+/* dark cascade (Firefox-safe; see decision-firefox-host-context-workaround) */
+:host([data-theme="dark"]) .host-context-dark\:bg-surface, :root.dark .host-context-dark\:bg-surface { background-color: var(--color-surface); }
+:host(.host\:bg-primary) { background-color: var(--color-primary); }
+::part(thumb) { background-color: var(--color-accent); }
+::slotted(img.slotted-img\:rounded-lg) { border-radius: 0.5rem; }
+::slotted(.slotted\:p-4) { padding: 1rem; }

package/crates/aihu-css-core/tests/snapshots/snapshot__compiles_basic_class.snap

@@ -0,0 +1,5 @@
+---
+source: tests/snapshot.rs
+expression: output
+---
+.bg-primary { background-color: var(--color-primary); }

package/crates/aihu-css-core/tests/snapshots/snapshot__compiles_multiple_classes.snap

@@ -0,0 +1,8 @@
+---
+source: tests/snapshot.rs
+expression: output
+---
+.bg-primary { background-color: var(--color-primary); }
+.text-primary-foreground { color: var(--color-primary-foreground); }
+.rounded-md { border-radius: 0.375rem; }
+.p-4 { padding: 1rem; }

package/crates/aihu-css-core/tests/snapshots/tokens__arbitrary_values.snap

@@ -0,0 +1,9 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"bg-[#1a1d24]\", \"w-[34ch]\", \"text-[14px]\", \"p-[2.5rem]\",\n\"leading-[1.4]\",])"
+---
+.bg-[#1a1d24] { background-color: #1a1d24; }
+.w-[34ch] { width: 34ch; }
+.text-[14px] { color: 14px; }
+.p-[2.5rem] { padding: 2.5rem; }
+.leading-[1.4] { line-height: 1.4; }

package/crates/aihu-css-core/tests/snapshots/tokens__category_borders.snap

@@ -0,0 +1,8 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"border\", \"rounded\", \"rounded-lg\", \"rounded-full\",])"
+---
+.border { border-width: 1px; }
+.rounded { border-radius: 0.25rem; }
+.rounded-lg { border-radius: 0.5rem; }
+.rounded-full { border-radius: 9999px; }

package/crates/aihu-css-core/tests/snapshots/tokens__category_colors.snap

@@ -0,0 +1,10 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"bg-primary\", \"text-accent\", \"border-muted\", \"bg-red-500\",\n\"text-slate-700\", \"bg-white\",])"
+---
+.bg-primary { background-color: var(--color-primary); }
+.text-accent { color: var(--color-accent); }
+.border-muted { border-color: var(--color-muted); }
+.bg-red-500 { background-color: var(--color-red-500); }
+.text-slate-700 { color: var(--color-slate-700); }
+.bg-white { background-color: #fff; }

package/crates/aihu-css-core/tests/snapshots/tokens__category_effects.snap

@@ -0,0 +1,8 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"shadow\", \"shadow-lg\", \"shadow-none\", \"opacity-50\"])"
+---
+.shadow { box-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1); }
+.shadow-lg { box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1); }
+.shadow-none { box-shadow: none; }
+.opacity-50 { opacity: 0.5; }

package/crates/aihu-css-core/tests/snapshots/tokens__category_layout.snap

@@ -0,0 +1,12 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"flex\", \"grid\", \"hidden\", \"items-center\", \"justify-between\", \"absolute\",\n\"w-full\", \"w-1/2\",])"
+---
+.flex { display: flex; }
+.grid { display: grid; }
+.hidden { display: none; }
+.items-center { align-items: center; }
+.justify-between { justify-content: space-between; }
+.absolute { position: absolute; }
+.w-full { width: 100%; }
+.w-1/2 { width: 50%; }

package/crates/aihu-css-core/tests/snapshots/tokens__category_spacing.snap

@@ -0,0 +1,11 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"p-4\", \"px-2\", \"py-8\", \"m-0\", \"mt-1\", \"gap-2\", \"p-0.5\"])"
+---
+.p-4 { padding: 1rem; }
+.px-2 { padding-inline: 0.5rem; }
+.py-8 { padding-block: 2rem; }
+.m-0 { margin: 0; }
+.mt-1 { margin-top: 0.25rem; }
+.gap-2 { gap: 0.5rem; }
+.p-0.5 { padding: 0.125rem; }

package/crates/aihu-css-core/tests/snapshots/tokens__category_typography.snap

@@ -0,0 +1,11 @@
+---
+source: packages/css-engine/crates/aihu-css-core/tests/tokens.rs
+expression: "css(&[\"text-lg\", \"text-center\", \"font-bold\", \"italic\", \"underline\",\n\"uppercase\", \"truncate\",])"
+---
+.text-lg { font-size: 1.125rem; line-height: 1.75rem; }
+.text-center { text-align: center; }
+.font-bold { font-weight: 700; }
+.italic { font-style: italic; }
+.underline { text-decoration-line: underline; }
+.uppercase { text-transform: uppercase; }
+.truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

package/crates/aihu-css-core/tests/tokens.rs

@@ -0,0 +1,79 @@
+//! Tailwind v4 utility-table coverage — one snapshot per category plus
+//! arbitrary-value bracket syntax. Proves the table compiles all six
+//! categories (Plan 2 Task 3).
+
+use aihu_css_core::compile_classes;
+
+fn css(classes: &[&str]) -> String {
+    compile_classes(&classes.iter().map(|s| s.to_string()).collect::<Vec<_>>())
+}
+
+#[test]
+fn category_colors() {
+    insta::assert_snapshot!(css(&[
+        "bg-primary",
+        "text-accent",
+        "border-muted",
+        "bg-red-500",
+        "text-slate-700",
+        "bg-white",
+    ]));
+}
+
+#[test]
+fn category_spacing() {
+    insta::assert_snapshot!(css(&["p-4", "px-2", "py-8", "m-0", "mt-1", "gap-2", "p-0.5"]));
+}
+
+#[test]
+fn category_layout() {
+    insta::assert_snapshot!(css(&[
+        "flex",
+        "grid",
+        "hidden",
+        "items-center",
+        "justify-between",
+        "absolute",
+        "w-full",
+        "w-1/2",
+    ]));
+}
+
+#[test]
+fn category_typography() {
+    insta::assert_snapshot!(css(&[
+        "text-lg",
+        "text-center",
+        "font-bold",
+        "italic",
+        "underline",
+        "uppercase",
+        "truncate",
+    ]));
+}
+
+#[test]
+fn category_borders() {
+    insta::assert_snapshot!(css(&[
+        "border",
+        "rounded",
+        "rounded-lg",
+        "rounded-full",
+    ]));
+}
+
+#[test]
+fn category_effects() {
+    insta::assert_snapshot!(css(&["shadow", "shadow-lg", "shadow-none", "opacity-50"]));
+}
+
+#[test]
+fn arbitrary_values() {
+    insta::assert_snapshot!(css(&[
+        "bg-[#1a1d24]",
+        "w-[34ch]",
+        "text-[14px]",
+        "p-[2.5rem]",
+        "leading-[1.4]",
+    ]));
+}

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+//#region src/define-style-pack.d.ts
+/**
+ * `defineStylePack()` — the export hook for external orgs (Plan 3 Task 10).
+ *
+ * Lets an external org declare its own token bundle against the SAME token-name
+ * contract as the built-in `aihu-default` / `aihu-graphite` packs (see
+ * `styles/*.css`), so a custom pack slots into the engine exactly like the
+ * built-ins. Returns a `StylePack` descriptor the engine can register and emit
+ * as `:root` / `.dark` token blocks.
+ *
+ * The built-in packs are expressible through this same API — `defineStylePack`
+ * is just the typed, programmatic form of the shipped CSS bundles.
+ */
+/** A design-token map: `name` → CSS value. Names omit the leading `--`. */
+type TokenMap = Record<string, string>;
+/** Input to {@link defineStylePack}. */
+interface StylePackInput {
+  /** Pack name, e.g. `'acme'` (used for registration / debugging). */
+  name: string;
+  /** Light-theme tokens (the `:root` block). Names without the `--` prefix. */
+  tokens: TokenMap;
+  /** Optional dark-theme overrides (the `.dark` block). */
+  dark?: TokenMap;
+}
+/** A registered, validated style-pack descriptor. */
+interface StylePack {
+  readonly name: string;
+  readonly tokens: TokenMap;
+  readonly dark: TokenMap;
+  /**
+   * Serialize the pack to a `:root { … }` (+ `.dark { … }`) CSS string — the
+   * same shape as the shipped `styles/*.css` bundles.
+   */
+  toCss(): string;
+}
+/**
+ * Define a style pack from a token map.
+ *
+ * @example
+ * const acme = defineStylePack({
+ *   name: 'acme',
+ *   tokens: { 'color-primary': '#0a7', 'radius-md': '6px' },
+ *   dark: { 'color-primary': '#3fc' },
+ * })
+ * acme.toCss() // => ":root { --color-primary: #0a7; … } .dark { … }"
+ */
+declare function defineStylePack(input: StylePackInput): StylePack;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Compile a list of utility class names to CSS.
+ *
+ * Plan 1 bootstrap — supports a hardcoded subset; see crates/aihu-css-core/src/tokens.rs.
+ * Plan 2 wires the AST scanner so callers pass `.aihu` SFC ASTs instead of raw class lists.
+ *
+ * @param classes - utility class names like `['bg-primary', 'p-4']`
+ * @returns CSS string with one rule per known class
+ */
+declare function compile(classes: string[]): string;
+/**
+ * Compile a `.aihu` SFC source string to scoped, shadow-DOM-embedded CSS.
+ *
+ * Pipeline (Plan 2 Task 9): `compileToAst(source)` (from `@aihu/compiler`)
+ * → AST JSON → `aihu-css-compile --ast-json` → scoped CSS. The output is the
+ * per-SFC stylesheet the compiler folds into the component's shadow `<style>`:
+ * `:host`-level theme tokens, variant-resolved utility rules, and the folded
+ * authored `@style` block. There is NO global utility stylesheet.
+ *
+ * @param source - the `.aihu` SFC source text
+ * @param id - optional file path/id (used to derive the tag stem + `@route` checks)
+ * @returns the scoped CSS string for the SFC
+ */
+declare function compileSfc(source: string, id?: string): string;
+//#endregion
+export { type StylePack, type StylePackInput, type TokenMap, compile, compileSfc, defineStylePack };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/define-style-pack.ts","../src/index.ts"],"mappings":";;AAcA;;;;;AAGA;;;;;;;KAHY,QAAA,GAAW,MAAA;;UAGN,cAAA;EAMA;EAJf,IAAA;EAQwB;EANxB,MAAA,EAAQ,QAAA;EASe;EAPvB,IAAA,GAAO,QAAA;AAAA;;UAIQ,SAAA;EAAA,SACN,IAAA;EAAA,SACA,MAAA,EAAQ,QAAA;EAAA,SACR,IAAA,EAAM,QAAA;EAKV;AA0BP;;;EA1BE,KAAA;AAAA;;;;;;;;ACUF;;;;iBDgBgB,eAAA,CAAgB,KAAA,EAAO,cAAA,GAAiB,SAAA;;;AA/CxD;;;;;AAGA;;;;AAHA,iBC+BgB,OAAA,CAAQ,OAAA;;;;;;;ADlBxB;;;;;;;iBC4CgB,UAAA,CAAW,MAAA,UAAgB,EAAA"}

package/dist/index.js

@@ -0,0 +1,120 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region ../compiler/dist/index.js
+const a = process.platform === `win32` ? `.exe` : ``, o = process.env.SCRIBE_COMPILE_BIN ?? resolve(dirname(fileURLToPath(import.meta.url)), `../bin/aihu-compile${a}`);
+function m(n, r) {
+	let i = [
+		`--stdin`,
+		`--tag`,
+		r ? basename(r, `.aihu`) : `Component`,
+		`--ast-json`
+	];
+	r && i.push(`--path`, r);
+	let a = execFileSync(o, i, {
+		input: n,
+		encoding: `utf8`
+	});
+	return JSON.parse(a);
+}
+//#endregion
+//#region src/define-style-pack.ts
+/** Normalize a token name to its `--`-prefixed custom-property form. */
+function asCustomProp(name) {
+	return name.startsWith("--") ? name : `--${name}`;
+}
+function emitBlock(selector, tokens) {
+	return `${selector} {\n${Object.entries(tokens).map(([name, value]) => `  ${asCustomProp(name)}: ${value};`).join("\n")}\n}\n`;
+}
+/**
+* Define a style pack from a token map.
+*
+* @example
+* const acme = defineStylePack({
+*   name: 'acme',
+*   tokens: { 'color-primary': '#0a7', 'radius-md': '6px' },
+*   dark: { 'color-primary': '#3fc' },
+* })
+* acme.toCss() // => ":root { --color-primary: #0a7; … } .dark { … }"
+*/
+function defineStylePack(input) {
+	if (!input.name) throw new Error("defineStylePack: `name` is required");
+	if (!input.tokens || Object.keys(input.tokens).length === 0) throw new Error(`defineStylePack("${input.name}"): tokens must be a non-empty map`);
+	const tokens = { ...input.tokens };
+	const dark = { ...input.dark ?? {} };
+	return {
+		name: input.name,
+		tokens,
+		dark,
+		toCss() {
+			let css = emitBlock(":root", tokens);
+			if (Object.keys(dark).length > 0) css += emitBlock(".dark", dark);
+			return css;
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+* Resolve the path to the `aihu-css-compile` binary.
+* Looks for it relative to the package, then in the workspace target/release.
+* Plan 4 will replace this with a prebuilt binary shipped with the package.
+*/
+function resolveBinary() {
+	const ext = process.platform === "win32" ? ".exe" : "";
+	const candidates = [resolve(__dirname, "../../../target/release", `aihu-css-compile${ext}`), resolve(__dirname, "../../../target/debug", `aihu-css-compile${ext}`)];
+	for (const c of candidates) if (existsSync(c)) return c;
+	throw new Error(`aihu-css-compile binary not found. Run \`cargo build --release -p aihu-css-core\` from the repo root first. Checked: ${candidates.join(", ")}`);
+}
+/**
+* Compile a list of utility class names to CSS.
+*
+* Plan 1 bootstrap — supports a hardcoded subset; see crates/aihu-css-core/src/tokens.rs.
+* Plan 2 wires the AST scanner so callers pass `.aihu` SFC ASTs instead of raw class lists.
+*
+* @param classes - utility class names like `['bg-primary', 'p-4']`
+* @returns CSS string with one rule per known class
+*/
+function compile(classes) {
+	if (classes.length === 0) return "";
+	return execFileSync(resolveBinary(), [], {
+		input: classes.join("\n"),
+		encoding: "utf-8",
+		stdio: [
+			"pipe",
+			"pipe",
+			"inherit"
+		]
+	});
+}
+/**
+* Compile a `.aihu` SFC source string to scoped, shadow-DOM-embedded CSS.
+*
+* Pipeline (Plan 2 Task 9): `compileToAst(source)` (from `@aihu/compiler`)
+* → AST JSON → `aihu-css-compile --ast-json` → scoped CSS. The output is the
+* per-SFC stylesheet the compiler folds into the component's shadow `<style>`:
+* `:host`-level theme tokens, variant-resolved utility rules, and the folded
+* authored `@style` block. There is NO global utility stylesheet.
+*
+* @param source - the `.aihu` SFC source text
+* @param id - optional file path/id (used to derive the tag stem + `@route` checks)
+* @returns the scoped CSS string for the SFC
+*/
+function compileSfc(source, id) {
+	const ast = m(source, id);
+	return execFileSync(resolveBinary(), ["--ast-json"], {
+		input: JSON.stringify(ast),
+		encoding: "utf-8",
+		stdio: [
+			"pipe",
+			"pipe",
+			"inherit"
+		]
+	});
+}
+//#endregion
+export { compile, compileSfc, defineStylePack };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["r","n","i","t","e","compileToAst"],"sources":["../../compiler/dist/index.js","../src/define-style-pack.ts","../src/index.ts"],"sourcesContent":["import{execFileSync as e}from\"node:child_process\";import{basename as t,dirname as n,resolve as r}from\"node:path\";import{fileURLToPath as i}from\"node:url\";const a=process.platform===`win32`?`.exe`:``,o=process.env.SCRIBE_COMPILE_BIN??r(n(i(import.meta.url)),`../bin/aihu-compile${a}`);function s(e,t){return e.replace(/(defineElement\\(\\s*['\"][^'\"]+['\"]\\s*,\\s*defineComponent\\([^]*\\))\\s*\\)/,(e,n)=>`${n}, { shadowMode: '${t}' })`)}function c(e){return/\\b(?:signal|computed|effect|setSignal|onMount|onCleanup)\\s*\\(/.test(e)?`interactive`:`static`}function l(e){let t=/defineElement\\(\\s*['\"]([^'\"]+)['\"]/m.exec(e);return t?t[1]??null:null}function u(e,t){let n=e.replace(/import\\s*\\{([^}]*)\\}\\s*from\\s*'@aihu\\/runtime'/,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(Boolean);return n.includes(`_hmrReplace`)||n.push(`_hmrReplace`),`import { ${n.join(`, `)} } from '@aihu/runtime'`}).replace(/\\bdefineComponent\\(/,`defineComponent(__aihu_setup__ = `),r=`\nexport { __aihu_setup__ as default }\n\nif (typeof __DEV__ !== 'undefined' && __DEV__ && import.meta.hot) {\n  import.meta.hot.accept((newModule) => {\n    if (!newModule) return\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const newSetup = (newModule as any)['default']\n    if (typeof newSetup !== 'function') return\n    document.querySelectorAll(${JSON.stringify(t)}).forEach((el) => {\n      _hmrReplace(el as HTMLElement, newSetup)\n    })\n  })\n}\n`;return`let __aihu_setup__: ((ctx: any) => any) | undefined\n`+n+r}function d(e,t){let n=e.replace(/import\\s*\\{([^}]*)\\}\\s*from\\s*'@aihu\\/runtime'/,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(Boolean);return n.includes(`_hydrateOnVisible`)||n.push(`_hydrateOnVisible`),`import { ${n.join(`, `)} } from '@aihu/runtime'`}),r=n.replace(/defineElement\\(\\s*('[^']+'|\"[^\"]+\")\\s*,\\s*defineComponent\\(/,(e,t)=>`defineElement(${t}, __aihu_wrap_defer__(defineComponent(`);if(r===n)return e;let i=r.replace(/\\)\\s*\\)\\s*\\nexport\\s/,`)))\nexport `);return i===r&&(i=r.replace(/\\)\\s*\\)\\s*$/,`)))\n`)),i===r?e:`\n// Plan 3.3 (Islands) — defer attribute support. Wraps the constructor\n// returned by defineComponent so instances bearing the \\`defer\\` attribute\n// hydrate lazily via IntersectionObserver. Bare instances retain the\n// eager Plan 3.2 hydration path.\nfunction __aihu_wrap_defer__<T extends typeof HTMLElement>(Ctor: T): T {\n  const orig = (Ctor.prototype as unknown as { connectedCallback?: () => void }).connectedCallback\n  if (typeof orig !== 'function') return Ctor\n  ;(Ctor.prototype as unknown as { connectedCallback: () => void }).connectedCallback = function (this: HTMLElement) {\n    if (this.hasAttribute('defer')) {\n      _hydrateOnVisible(this, () => orig.call(this))\n    } else {\n      orig.call(this)\n    }\n  }\n  return Ctor\n}\n`+i}function f(e,t){if(!/defineElement\\(\\s*['\"][^'\"]+['\"]\\s*,\\s*defineComponent\\(/.test(e))return e;let n=e.replace(/^\\s*import\\s*\\{[^}]*\\}\\s*from\\s*'@aihu\\/runtime'\\s*;?\\s*$/m,``).replace(/import\\s*\\{([^}]*)\\}\\s*from\\s*'@aihu\\/arbor'/,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(Boolean);return n.includes(`mount`)||n.push(`mount`),`import { ${n.join(`, `)} } from '@aihu/arbor'`}),r=JSON.stringify(t);return`// SCRIBE_STATIC_ISLAND — zero @aihu/runtime references\\n${n.replace(/defineElement\\(\\s*['\"][^'\"]+['\"]\\s*,\\s*defineComponent\\(/,`customElements.define(${r}, class extends HTMLElement {\\n  connectedCallback() {\\n    const root = this.attachShadow({ mode: 'open' })\\n    const __aihu_setup__ = (`).replace(/\\)\\s*\\)\\s*$/,`)\n    mount(__aihu_setup__({ host: root, element: this }), root)\n  }\n})\n`)}`}function p(n,r,i){let a=[`--stdin`,`--tag`,t(r,`.aihu`),`--path`,r];return i?.sidecarOut&&a.push(`--sidecar-out`,i.sidecarOut),{code:e(o,a,{input:n,encoding:`utf8`}),map:null}}function m(n,r){let i=[`--stdin`,`--tag`,r?t(r,`.aihu`):`Component`,`--ast-json`];r&&i.push(`--path`,r);let a=e(o,i,{input:n,encoding:`utf8`});return JSON.parse(a)}function h(e){let t;t=e.includes(`from '@aihu/arbor'`)?e.replace(/import\\s*\\{([^}]*)\\}\\s*from\\s*'@aihu\\/arbor'/,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(Boolean);return n.includes(`mount`)||n.push(`mount`),`import { ${n.join(`, `)} } from '@aihu/arbor'`}):`import { mount } from '@aihu/arbor'\\n${e}`,/import\\s+\\{[^}]*\\}\\s+from\\s+'@aihu\\/signals'/.test(t)?t=t.replace(/import\\s*\\{([^}]*)\\}\\s*from\\s*'@aihu\\/signals'/,(e,t)=>{if(e.startsWith(`import type`))return e;let n=t.split(`,`).map(e=>e.trim()).filter(Boolean);return n.includes(`signal`)||n.push(`signal`),`import { ${n.join(`, `)} } from '@aihu/signals'`}):/import.*from\\s*'@aihu\\/signals'/.test(t)?/import\\s+type\\s+\\{[^}]*\\}\\s+from\\s+'@aihu\\/signals'/.test(t)&&!t.match(/import\\s+\\{[^}]*\\}\\s+from\\s+'@aihu\\/signals'/)&&(t=t.replace(/(import\\s+type\\s+\\{[^}]*\\}\\s+from\\s+'@aihu\\/signals')/,(e,t)=>`${t}\\nimport { signal } from '@aihu/signals'`)):t=t.replace(/import\\s*\\{[^}]*\\}\\s*from\\s*'@aihu\\/arbor'/,e=>`${e}\\nimport { signal } from '@aihu/signals'`),t=t.replace(/import\\s*\\{([^}]*)\\}\\s*from\\s*'@aihu\\/runtime'/,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(Boolean);return n.includes(`_setMount`)||n.push(`_setMount`),n.includes(`_setSignal`)||n.push(`_setSignal`),`import { ${n.join(`, `)} } from '@aihu/runtime'`});let n=t.split(`\n`),r=-1;for(let e=n.length-1;e>=0;e--){let t=(n[e]??``).trim();if(t.startsWith(`import `)||t.startsWith(`import{`)){r=e;break}}return r!==-1&&(n.splice(r+1,0,`_setMount(mount)`,`_setSignal(signal)`,``),t=n.join(`\n`)),t}function g(e){let t=e?.islands!==!1,n=e?.shadowMode;return{name:`aihu-compiler`,enforce:`pre`,transform(e,r){let i=r.split(`?`)[0];if(i.endsWith(`.aihu`))return(async()=>{let r=p(e,i,{sidecarOut:`${i}.ts`}),a=n==null?r.code:s(r.code,n),o=l(a),m;t&&o!==null&&c(a)===`static`?m=f(a,o):o===null?(m=a,m=h(m)):(m=u(a,o),m=d(m,o),m=h(m));try{let e=await import(`vite`);return`transformWithEsbuild`in e&&typeof e.transformWithEsbuild==`function`?{code:(await e.transformWithEsbuild(m,`component.ts`,{target:`esnext`,sourcemap:!1})).code,map:null}:{code:m,moduleType:`ts`,map:null}}catch{return{code:m,map:null}}})()}}}export{d as _buildDeferredHydration,f as _buildStaticIsland,c as _classifyIsland,h as _injectAutoWiring,s as _injectShadowMode,g as aihuCompilerPlugin,m as compileToAst,p as transform};\n//# sourceMappingURL=index.js.map","/**\n * `defineStylePack()` — the export hook for external orgs (Plan 3 Task 10).\n *\n * Lets an external org declare its own token bundle against the SAME token-name\n * contract as the built-in `aihu-default` / `aihu-graphite` packs (see\n * `styles/*.css`), so a custom pack slots into the engine exactly like the\n * built-ins. Returns a `StylePack` descriptor the engine can register and emit\n * as `:root` / `.dark` token blocks.\n *\n * The built-in packs are expressible through this same API — `defineStylePack`\n * is just the typed, programmatic form of the shipped CSS bundles.\n */\n\n/** A design-token map: `name` → CSS value. Names omit the leading `--`. */\nexport type TokenMap = Record<string, string>\n\n/** Input to {@link defineStylePack}. */\nexport interface StylePackInput {\n  /** Pack name, e.g. `'acme'` (used for registration / debugging). */\n  name: string\n  /** Light-theme tokens (the `:root` block). Names without the `--` prefix. */\n  tokens: TokenMap\n  /** Optional dark-theme overrides (the `.dark` block). */\n  dark?: TokenMap\n}\n\n/** A registered, validated style-pack descriptor. */\nexport interface StylePack {\n  readonly name: string\n  readonly tokens: TokenMap\n  readonly dark: TokenMap\n  /**\n   * Serialize the pack to a `:root { … }` (+ `.dark { … }`) CSS string — the\n   * same shape as the shipped `styles/*.css` bundles.\n   */\n  toCss(): string\n}\n\n/** Normalize a token name to its `--`-prefixed custom-property form. */\nfunction asCustomProp(name: string): string {\n  return name.startsWith('--') ? name : `--${name}`\n}\n\nfunction emitBlock(selector: string, tokens: TokenMap): string {\n  const decls = Object.entries(tokens)\n    .map(([name, value]) => `  ${asCustomProp(name)}: ${value};`)\n    .join('\\n')\n  return `${selector} {\\n${decls}\\n}\\n`\n}\n\n/**\n * Define a style pack from a token map.\n *\n * @example\n * const acme = defineStylePack({\n *   name: 'acme',\n *   tokens: { 'color-primary': '#0a7', 'radius-md': '6px' },\n *   dark: { 'color-primary': '#3fc' },\n * })\n * acme.toCss() // => \":root { --color-primary: #0a7; … } .dark { … }\"\n */\nexport function defineStylePack(input: StylePackInput): StylePack {\n  if (!input.name) {\n    throw new Error('defineStylePack: `name` is required')\n  }\n  if (!input.tokens || Object.keys(input.tokens).length === 0) {\n    throw new Error(`defineStylePack(\"${input.name}\"): tokens must be a non-empty map`)\n  }\n\n  const tokens = { ...input.tokens }\n  const dark = { ...(input.dark ?? {}) }\n\n  return {\n    name: input.name,\n    tokens,\n    dark,\n    toCss(): string {\n      let css = emitBlock(':root', tokens)\n      if (Object.keys(dark).length > 0) {\n        css += emitBlock('.dark', dark)\n      }\n      return css\n    },\n  }\n}\n","import { execFileSync } from 'node:child_process'\nimport { existsSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { compileToAst } from '@aihu/compiler'\n\nexport {\n  defineStylePack,\n  type StylePack,\n  type StylePackInput,\n  type TokenMap,\n} from './define-style-pack.ts'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\n/**\n * Resolve the path to the `aihu-css-compile` binary.\n * Looks for it relative to the package, then in the workspace target/release.\n * Plan 4 will replace this with a prebuilt binary shipped with the package.\n */\nfunction resolveBinary(): string {\n  const ext = process.platform === 'win32' ? '.exe' : ''\n  const candidates = [\n    // dev: workspace target/release (most common during development)\n    resolve(__dirname, '../../../target/release', `aihu-css-compile${ext}`),\n    // ci: same with debug\n    resolve(__dirname, '../../../target/debug', `aihu-css-compile${ext}`),\n  ]\n  for (const c of candidates) {\n    if (existsSync(c)) return c\n  }\n  throw new Error(\n    `aihu-css-compile binary not found. Run \\`cargo build --release -p aihu-css-core\\` from the repo root first. Checked: ${candidates.join(', ')}`,\n  )\n}\n\n/**\n * Compile a list of utility class names to CSS.\n *\n * Plan 1 bootstrap — supports a hardcoded subset; see crates/aihu-css-core/src/tokens.rs.\n * Plan 2 wires the AST scanner so callers pass `.aihu` SFC ASTs instead of raw class lists.\n *\n * @param classes - utility class names like `['bg-primary', 'p-4']`\n * @returns CSS string with one rule per known class\n */\nexport function compile(classes: string[]): string {\n  if (classes.length === 0) return ''\n\n  const bin = resolveBinary()\n  const input = classes.join('\\n')\n  const result = execFileSync(bin, [], {\n    input,\n    encoding: 'utf-8',\n    stdio: ['pipe', 'pipe', 'inherit'],\n  })\n  return result\n}\n\n/**\n * Compile a `.aihu` SFC source string to scoped, shadow-DOM-embedded CSS.\n *\n * Pipeline (Plan 2 Task 9): `compileToAst(source)` (from `@aihu/compiler`)\n * → AST JSON → `aihu-css-compile --ast-json` → scoped CSS. The output is the\n * per-SFC stylesheet the compiler folds into the component's shadow `<style>`:\n * `:host`-level theme tokens, variant-resolved utility rules, and the folded\n * authored `@style` block. There is NO global utility stylesheet.\n *\n * @param source - the `.aihu` SFC source text\n * @param id - optional file path/id (used to derive the tag stem + `@route` checks)\n * @returns the scoped CSS string for the SFC\n */\nexport function compileSfc(source: string, id?: string): string {\n  const ast = compileToAst(source, id)\n  const bin = resolveBinary()\n  return execFileSync(bin, ['--ast-json'], {\n    input: JSON.stringify(ast),\n    encoding: 'utf-8',\n    stdio: ['pipe', 'pipe', 'inherit'],\n  })\n}\n"],"mappings":";;;;;AAA0J,MAAM,IAAE,QAAQ,aAAW,UAAQ,SAAO,IAAG,IAAE,QAAQ,IAAI,sBAAoBA,QAAEC,QAAEC,cAAE,OAAO,KAAK,IAAI,CAAC,EAAC,sBAAsB,IAAI;AAsCtG,SAAS,EAAE,GAAE,GAAE;CAAC,IAAI,IAAE;EAAC;EAAU;EAAQ,IAAEC,SAAE,GAAE,QAAQ,GAAC;EAAY;EAAa;CAAC,KAAG,EAAE,KAAK,UAAS,EAAE;CAAC,IAAI,IAAEC,aAAE,GAAE,GAAE;EAAC,OAAM;EAAE,UAAS;EAAO,CAAC;CAAC,OAAO,KAAK,MAAM,EAAE;;;;;ACCxV,SAAS,aAAa,MAAsB;CAC1C,OAAO,KAAK,WAAW,KAAK,GAAG,OAAO,KAAK;;AAG7C,SAAS,UAAU,UAAkB,QAA0B;CAI7D,OAAO,GAAG,SAAS,MAHL,OAAO,QAAQ,OAAO,CACjC,KAAK,CAAC,MAAM,WAAW,KAAK,aAAa,KAAK,CAAC,IAAI,MAAM,GAAG,CAC5D,KAAK,KACsB,CAAC;;;;;;;;;;;;;AAcjC,SAAgB,gBAAgB,OAAkC;CAChE,IAAI,CAAC,MAAM,MACT,MAAM,IAAI,MAAM,sCAAsC;CAExD,IAAI,CAAC,MAAM,UAAU,OAAO,KAAK,MAAM,OAAO,CAAC,WAAW,GACxD,MAAM,IAAI,MAAM,oBAAoB,MAAM,KAAK,oCAAoC;CAGrF,MAAM,SAAS,EAAE,GAAG,MAAM,QAAQ;CAClC,MAAM,OAAO,EAAE,GAAI,MAAM,QAAQ,EAAE,EAAG;CAEtC,OAAO;EACL,MAAM,MAAM;EACZ;EACA;EACA,QAAgB;GACd,IAAI,MAAM,UAAU,SAAS,OAAO;GACpC,IAAI,OAAO,KAAK,KAAK,CAAC,SAAS,GAC7B,OAAO,UAAU,SAAS,KAAK;GAEjC,OAAO;;EAEV;;;;ACtEH,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;;;;;;AAOzD,SAAS,gBAAwB;CAC/B,MAAM,MAAM,QAAQ,aAAa,UAAU,SAAS;CACpD,MAAM,aAAa,CAEjB,QAAQ,WAAW,2BAA2B,mBAAmB,MAAM,EAEvE,QAAQ,WAAW,yBAAyB,mBAAmB,MAAM,CACtE;CACD,KAAK,MAAM,KAAK,YACd,IAAI,WAAW,EAAE,EAAE,OAAO;CAE5B,MAAM,IAAI,MACR,wHAAwH,WAAW,KAAK,KAAK,GAC9I;;;;;;;;;;;AAYH,SAAgB,QAAQ,SAA2B;CACjD,IAAI,QAAQ,WAAW,GAAG,OAAO;CASjC,OALe,aAFH,eAEmB,EAAE,EAAE,EAAE;EACnC,OAFY,QAAQ,KAAK,KAEpB;EACL,UAAU;EACV,OAAO;GAAC;GAAQ;GAAQ;GAAU;EACnC,CACY;;;;;;;;;;;;;;;AAgBf,SAAgB,WAAW,QAAgB,IAAqB;CAC9D,MAAM,MAAMC,EAAa,QAAQ,GAAG;CAEpC,OAAO,aADK,eACW,EAAE,CAAC,aAAa,EAAE;EACvC,OAAO,KAAK,UAAU,IAAI;EAC1B,UAAU;EACV,OAAO;GAAC;GAAQ;GAAQ;GAAU;EACnC,CAAC"}

package/dist/runtime/cn.d.ts

@@ -0,0 +1,14 @@
+//#region src/runtime/cn.d.ts
+/** A class value: string, falsy (dropped), or a nested array of the same. */
+type ClassValue = string | number | null | undefined | false | ClassValue[];
+/**
+ * Merge class values, resolving last-wins conflicts per property group.
+ *
+ * @example cn('p-2', 'p-4')                  // 'p-4'
+ * @example cn('a', false && 'b', ['c'])      // 'a c'
+ * @example cn('bg-red-500', 'bg-blue-500')   // 'bg-blue-500'
+ */
+declare function cn(...inputs: ClassValue[]): string;
+//#endregion
+export { ClassValue, cn };
+//# sourceMappingURL=cn.d.ts.map

package/dist/runtime/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","names":[],"sources":["../../src/runtime/cn.ts"],"mappings":";;KAoBY,UAAA,gDAA0D,UAAA;;;;;AAyCtE;;;iBAAgB,EAAA,CAAA,GAAM,MAAA,EAAQ,UAAA"}

package/dist/runtime/cn.js

@@ -0,0 +1,107 @@
+//#region src/runtime/cn-conflict-map.generated.ts
+/** Prefix → conflict-group key, sorted longest-prefix-first. */
+const CONFLICT_GROUPS = {
+	outline: "outline-color",
+	opacity: "opacity",
+	rounded: "border-radius",
+	border: "border-color",
+	stroke: "stroke",
+	shadow: "box-shadow",
+	"gap-x": "column-gap",
+	"gap-y": "row-gap",
+	"min-w": "min-width",
+	"max-w": "max-width",
+	"min-h": "min-height",
+	"max-h": "max-height",
+	text: "color",
+	fill: "fill",
+	ring: "--tw-ring-color",
+	font: "font-weight",
+	gap: "gap",
+	px: "padding-inline",
+	py: "padding-block",
+	pt: "padding-top",
+	pr: "padding-right",
+	pb: "padding-bottom",
+	pl: "padding-left",
+	mx: "margin-inline",
+	my: "margin-block",
+	mt: "margin-top",
+	mr: "margin-right",
+	mb: "margin-bottom",
+	ml: "margin-left",
+	bg: "background-color",
+	p: "padding",
+	m: "margin",
+	w: "width",
+	h: "height",
+	z: "z-index"
+};
+//#endregion
+//#region src/runtime/cn.ts
+/**
+* `@aihu/css-engine/runtime/cn` — the class-merge runtime helper (Plan 3 Task 9).
+*
+* `cn(...inputs)` merges class strings / arrays / conditionals into a single
+* deduplicated class string, resolving Tailwind-style conflicts last-wins per
+* property group (`cn('p-2', 'p-4')` → `'p-4'`).
+*
+* The conflict map (`CONFLICT_GROUPS`) is GENERATED at engine build time from
+* the utility registry (`scripts/gen-cn-conflict-map.ts` → Rust
+* `tokens::conflict_groups()`), NOT hand-maintained — so it never drifts from
+* the utility table. Separate < 1 KB gz sub-export from `runtime/progressive`
+* (Risk #4 size-split).
+*
+* This is the runtime-merge helper for consumer-provided overrides (spec §9.3):
+* recipes use static utility strings at compile time; `cn()` is only for the
+* runtime override case.
+*/
+/** Flatten the (possibly nested / conditional) inputs into a token list. */
+function tokens(inputs, out) {
+	for (const input of inputs) {
+		if (!input) continue;
+		if (Array.isArray(input)) tokens(input, out);
+		else for (const t of String(input).split(" ")) if (t) out.push(t);
+	}
+}
+/**
+* The conflict-group key for a class, or the class itself when it belongs to no
+* known group (so unrelated classes always coexist). Strips variant prefixes
+* (`md:`, `hover:`, …) so `hover:p-2` and `hover:p-4` still conflict, while
+* `p-2` and `hover:p-4` do not (different variant scope).
+*/
+function groupKey(cls) {
+	const colon = cls.lastIndexOf(":");
+	const variant = colon === -1 ? "" : cls.slice(0, colon + 1);
+	const base = colon === -1 ? cls : cls.slice(colon + 1);
+	const dash = base.indexOf("-");
+	const group = CONFLICT_GROUPS[dash === -1 ? base : base.slice(0, dash)];
+	return group ? `${variant}${group}` : cls;
+}
+/**
+* Merge class values, resolving last-wins conflicts per property group.
+*
+* @example cn('p-2', 'p-4')                  // 'p-4'
+* @example cn('a', false && 'b', ['c'])      // 'a c'
+* @example cn('bg-red-500', 'bg-blue-500')   // 'bg-blue-500'
+*/
+function cn(...inputs) {
+	const flat = [];
+	tokens(inputs, flat);
+	const winner = /* @__PURE__ */ new Map();
+	for (const t of flat) winner.set(groupKey(t), t);
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const t of flat) {
+		const key = groupKey(t);
+		if (winner.get(key) === t && !seen.has(t)) {
+			seen.add(t);
+			result.push(t);
+		}
+	}
+	return result.join(" ");
+}
+//#endregion
+export { cn };
+
+//# sourceMappingURL=cn.js.map