@aihu/css-engine 0.3.0 → 0.4.0

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

@@ -0,0 +1,257 @@
+//! Structured `@style`-rule parser tests (T2, R-SHARED-PARSER).
+//!
+//! This parser is the SINGLE source reused by `@apply` (T3) and variant
+//! validation (PR-3), so the tests pin the public API both consumers depend on:
+//! the rule tree, per-rule `@apply` directives, and each rule's selector
+//! context. Codex flagged a naive string scanner as a trap, so the tests
+//! deliberately stress comments, strings, arbitrary-value utilities, `;`-in-
+//! values, and brace nesting.
+
+use aihu_css_core::style_parser::{parse_style, StyleNode, StyleParseError};
+
+/// Find the first top-level rule, asserting there is one.
+fn first_rule(sheet: &aihu_css_core::StyleSheet) -> &aihu_css_core::StyleRule {
+    sheet
+        .nodes
+        .iter()
+        .find_map(|n| match n {
+            StyleNode::Rule(r) => Some(r),
+            _ => None,
+        })
+        .expect("expected at least one top-level rule")
+}
+
+#[test]
+fn parses_a_simple_rule_with_declarations() {
+    let sheet = parse_style(".box { color: red; padding: 4px; }").unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.selector, ".box");
+    assert_eq!(rule.declarations.len(), 2);
+    assert_eq!(rule.declarations[0].prop, "color");
+    assert_eq!(rule.declarations[0].value, "red");
+    assert_eq!(rule.declarations[1].prop, "padding");
+    assert_eq!(rule.declarations[1].value, "4px");
+    assert!(rule.applies.is_empty());
+}
+
+#[test]
+fn parses_multiple_top_level_rules() {
+    let sheet = parse_style(".a { color: red; } .b, .c { color: blue; }").unwrap();
+    let rules: Vec<_> = sheet
+        .nodes
+        .iter()
+        .filter_map(|n| match n {
+            StyleNode::Rule(r) => Some(r),
+            _ => None,
+        })
+        .collect();
+    assert_eq!(rules.len(), 2);
+    assert_eq!(rules[0].selector, ".a");
+    // Selector list preserved verbatim (validation/PR-3 needs the raw context).
+    assert_eq!(rules[1].selector, ".b, .c");
+}
+
+#[test]
+fn captures_apply_directives_per_rule() {
+    let sheet = parse_style(".btn { @apply bg-primary p-4; color: red; @apply hover:bg-accent; }")
+        .unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.applies.len(), 2);
+    assert_eq!(rule.applies[0].tokens, vec!["bg-primary", "p-4"]);
+    assert_eq!(rule.applies[1].tokens, vec!["hover:bg-accent"]);
+    // The interleaved declaration is still captured.
+    assert_eq!(rule.declarations.len(), 1);
+    assert_eq!(rule.declarations[0].prop, "color");
+}
+
+#[test]
+fn apply_keyword_is_not_confused_with_prefix() {
+    // `@applyfoo` is NOT an `@apply` directive — it stays an at-statement, not a
+    // parsed apply.
+    let sheet = parse_style(".x { @applyfoo bar; }").unwrap();
+    let rule = first_rule(&sheet);
+    assert!(rule.applies.is_empty(), "@applyfoo must not parse as @apply");
+}
+
+#[test]
+fn is_comment_aware() {
+    // Braces, semicolons, and `@apply`-looking text inside comments must be
+    // ignored entirely.
+    let css = r#"
+        /* a comment with { braces } and ; and @apply fake; */
+        .a {
+            /* inner comment ; { } */
+            color: red; /* trailing */
+        }
+    "#;
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.selector, ".a");
+    assert_eq!(rule.declarations.len(), 1);
+    assert_eq!(rule.declarations[0].prop, "color");
+    assert_eq!(rule.declarations[0].value, "red");
+    // The fake @apply inside the comment was NOT captured.
+    assert!(rule.applies.is_empty());
+}
+
+#[test]
+fn is_string_aware_for_braces_and_semicolons() {
+    // `;` and `}` inside a quoted string must not terminate the declaration or
+    // rule.
+    let css = r#".q { content: "a; b } c"; color: red; }"#;
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.declarations.len(), 2);
+    assert_eq!(rule.declarations[0].prop, "content");
+    assert_eq!(rule.declarations[0].value, r#""a; b } c""#);
+    assert_eq!(rule.declarations[1].prop, "color");
+}
+
+#[test]
+fn semicolon_inside_url_value_does_not_split() {
+    // A `;` (and `:`) inside `url(...)` / data URI must stay in the value.
+    let css = r#".bg { background: url("data:image/svg+xml;base64,AAAA") center; }"#;
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.declarations.len(), 1);
+    assert_eq!(rule.declarations[0].prop, "background");
+    assert_eq!(
+        rule.declarations[0].value,
+        r#"url("data:image/svg+xml;base64,AAAA") center"#
+    );
+}
+
+#[test]
+fn arbitrary_value_apply_tokens_survive() {
+    // `bg-[#fff]` and `w-[calc(100%-1rem)]` must round-trip as single tokens.
+    let sheet = parse_style(".c { @apply bg-[#fff] w-[calc(100%-1rem)] p-4; }").unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(
+        rule.applies[0].tokens,
+        vec!["bg-[#fff]", "w-[calc(100%-1rem)]", "p-4"]
+    );
+}
+
+#[test]
+fn parses_nested_media_at_rule() {
+    let css = ".a { color: red; @media (min-width: 600px) { &:hover { color: blue; } } }";
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.declarations.len(), 1);
+    assert_eq!(rule.nested.len(), 1);
+    match &rule.nested[0] {
+        StyleNode::AtRule(at) => {
+            assert_eq!(at.name, "@media");
+            assert_eq!(at.prelude, "(min-width: 600px)");
+            // The body has one nested rule.
+            match &at.body[0] {
+                StyleNode::Rule(inner) => {
+                    assert_eq!(inner.selector, "&:hover");
+                    assert_eq!(inner.declarations[0].prop, "color");
+                }
+                other => panic!("expected nested rule, got {other:?}"),
+            }
+        }
+        other => panic!("expected @media at-rule, got {other:?}"),
+    }
+}
+
+#[test]
+fn parses_top_level_supports_and_container() {
+    let css = "@supports (display: grid) { .g { display: grid; } } \
+               @container (min-width: 20rem) { .c { color: red; } }";
+    let sheet = parse_style(css).unwrap();
+    let names: Vec<&str> = sheet
+        .nodes
+        .iter()
+        .filter_map(|n| match n {
+            StyleNode::AtRule(at) => Some(at.name.as_str()),
+            _ => None,
+        })
+        .collect();
+    assert_eq!(names, vec!["@supports", "@container"]);
+}
+
+#[test]
+fn parses_nested_style_rule() {
+    // Native CSS nesting: a rule inside a rule (with `&`).
+    let css = ".card { color: red; &:hover { color: blue; } }";
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.declarations.len(), 1);
+    assert_eq!(rule.nested.len(), 1);
+    match &rule.nested[0] {
+        StyleNode::Rule(inner) => assert_eq!(inner.selector, "&:hover"),
+        other => panic!("expected nested rule, got {other:?}"),
+    }
+}
+
+#[test]
+fn data_attribute_selector_context_is_preserved() {
+    // PR-3 validation needs the raw selector to spot `[data-variant="x"]`.
+    let css = r#".btn[data-variant="primary"] { color: red; }"#;
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.selector, r#".btn[data-variant="primary"]"#);
+}
+
+#[test]
+fn colon_in_selector_is_not_a_declaration_split() {
+    // `:hover` / `:is(...)` in a selector must not be mistaken for a decl `:`.
+    let css = ":is(.a, .b):hover { color: red; }";
+    let sheet = parse_style(css).unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.selector, ":is(.a, .b):hover");
+    assert_eq!(rule.declarations[0].prop, "color");
+}
+
+#[test]
+fn unchanged_block_round_trips_equivalently() {
+    // Parse → to_css → re-parse must yield the same rule tree (semantic round-
+    // trip; formatting is normalized by `to_css`).
+    let css = r#"
+        .a { color: red; padding: 4px; }
+        .b:hover { color: blue; @apply bg-primary p-4; }
+        @media (min-width: 600px) {
+            .a { color: green; }
+        }
+    "#;
+    let first = parse_style(css).unwrap();
+    let rendered = first.to_css();
+    let second = parse_style(&rendered).unwrap();
+    assert_eq!(
+        first, second,
+        "round-trip changed the tree:\n{rendered}"
+    );
+}
+
+#[test]
+fn unbalanced_braces_error() {
+    let err = parse_style(".a { color: red; ").unwrap_err();
+    assert_eq!(err, StyleParseError::UnbalancedBraces);
+}
+
+#[test]
+fn unterminated_comment_error() {
+    let err = parse_style(".a { /* never closed ").unwrap_err();
+    assert_eq!(err, StyleParseError::UnterminatedComment);
+}
+
+#[test]
+fn unterminated_string_error() {
+    let err = parse_style(r#".a { content: "oops; }"#).unwrap_err();
+    assert_eq!(err, StyleParseError::UnterminatedString);
+}
+
+#[test]
+fn empty_input_is_empty_sheet() {
+    let sheet = parse_style("   \n  ").unwrap();
+    assert!(sheet.nodes.is_empty());
+}
+
+#[test]
+fn stray_semicolons_are_ignored() {
+    let sheet = parse_style(";; .a { color: red; };").unwrap();
+    let rule = first_rule(&sheet);
+    assert_eq!(rule.selector, ".a");
+}

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

@@ -544,3 +544,55 @@ fn named_container_marker_emits_type_and_name() {
         ".@container/sidebar { container-type: inline-size; container-name: sidebar; }\n"
     );
 }
+
+// ── Issue #280: dictionary misses, grid arbitrary, opacity modifiers ─────────
+
+#[test]
+fn font_family_utilities_emit() {
+    assert_eq!(css(&["font-mono"]), ".font-mono { font-family: var(--font-mono); }\n");
+    assert_eq!(css(&["font-sans"]), ".font-sans { font-family: var(--font-sans); }\n");
+}
+
+#[test]
+fn bare_directional_borders_emit_1px() {
+    assert_eq!(css(&["border-t"]), ".border-t { border-top-width: 1px; }\n");
+    assert_eq!(css(&["border-r"]), ".border-r { border-right-width: 1px; }\n");
+    assert_eq!(css(&["border-b"]), ".border-b { border-bottom-width: 1px; }\n");
+    assert_eq!(css(&["border-l"]), ".border-l { border-left-width: 1px; }\n");
+    assert_eq!(css(&["border-x"]), ".border-x { border-inline-width: 1px; }\n");
+    assert_eq!(css(&["border-y"]), ".border-y { border-block-width: 1px; }\n");
+}
+
+#[test]
+fn grid_arbitrary_template_columns_emits() {
+    assert_eq!(
+        css(&["grid-cols-[2fr_1fr_1fr_1.5fr_1.5fr]"]),
+        ".grid-cols-[2fr_1fr_1fr_1.5fr_1.5fr] { grid-template-columns: 2fr 1fr 1fr 1.5fr 1.5fr; }\n"
+    );
+    assert_eq!(
+        css(&["grid-rows-[auto_1fr]"]),
+        ".grid-rows-[auto_1fr] { grid-template-rows: auto 1fr; }\n"
+    );
+}
+
+#[test]
+fn color_opacity_modifier_emits_color_mix() {
+    assert_eq!(
+        css(&["bg-accent/15"]),
+        ".bg-accent/15 { background-color: color-mix(in oklab, var(--color-accent) 15%, transparent); }\n"
+    );
+    assert_eq!(
+        css(&["bg-primary/50"]),
+        ".bg-primary/50 { background-color: color-mix(in oklab, var(--color-primary) 50%, transparent); }\n"
+    );
+    assert_eq!(
+        css(&["text-red-500/30"]),
+        ".text-red-500/30 { color: color-mix(in oklab, var(--color-red-500) 30%, transparent); }\n"
+    );
+}
+
+#[test]
+fn sizing_fraction_not_treated_as_opacity() {
+    // `w-1/2` is a width fraction, not a color opacity — must stay 50%.
+    assert_eq!(css(&["w-1/2"]), ".w-1/2 { width: 50%; }\n");
+}

package/dist/index.d.ts

@@ -21,15 +21,6 @@ import { i as defineStylePack, n as StylePackInput, r as TokenMap, t as StylePac
  * still rejects a zero-byte placeholder.
  */
 declare function isUsableExecutable(candidate: string): boolean;
-/**
- * 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.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;AA8FA;;;;;AAgHA;;;;;AA0BA;;;;;;;iBA1IgB,kBAAA,CAAmB,SAAA;;;;;;;;;;iBAgHnB,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;iBA0BR,UAAA,CAAW,MAAA,UAAgB,EAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;AA8FA;;;;;AA2IA;;;;;AAqBA;;;;;;;iBAhKgB,kBAAA,CAAmB,SAAA;AAAA,iBA2InB,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;iBAqBR,UAAA,CAAW,MAAA,UAAgB,EAAA"}

package/dist/index.js

@@ -114,17 +114,33 @@ function buildMissingBinaryError(descriptor, devCandidates) {
 * @param classes - utility class names like `['bg-primary', 'p-4']`
 * @returns CSS string with one rule per known class
 */
+/**
+* Spawn the native compiler, returning stdout on success. On a non-zero exit
+* (the binary's R-RESULT error path) throw an `Error` carrying the binary's
+* stderr message rather than letting `execFileSync`'s opaque status error
+* surface. stderr is PIPED (not inherited) so the message lands in the thrown
+* error instead of the parent's console.
+*/
+function runBinary(bin, args, input) {
+	try {
+		return execFileSync(bin, args, {
+			input,
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (err) {
+		const e = err;
+		const detail = (typeof e.stderr === "string" ? e.stderr : e.stderr instanceof Buffer ? e.stderr.toString("utf-8") : "").trim() || e.message || "unknown error";
+		throw new Error(`[@aihu/css-engine] CSS compile failed: ${detail}`);
+	}
+}
 function compile(classes) {
 	if (classes.length === 0) return "";
-	return execFileSync(resolveBinary(), [], {
-		input: classes.join("\n"),
-		encoding: "utf-8",
-		stdio: [
-			"pipe",
-			"pipe",
-			"inherit"
-		]
-	});
+	return runBinary(resolveBinary(), [], classes.join("\n"));
 }
 /**
 * Compile a `.aihu` SFC source string to scoped, shadow-DOM-embedded CSS.
@@ -141,15 +157,7 @@ function compile(classes) {
 */
 function compileSfc(source, id) {
 	const ast = compileToAst(source, id);
-	return execFileSync(resolveBinary(), ["--ast-json"], {
-		input: JSON.stringify(ast),
-		encoding: "utf-8",
-		stdio: [
-			"pipe",
-			"pipe",
-			"inherit"
-		]
-	});
+	return runBinary(resolveBinary(), ["--ast-json"], JSON.stringify(ast));
 }
 //#endregion
 export { compile, compileSfc, defineStylePack, isUsableExecutable };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { execFileSync } from 'node:child_process'\nimport { accessSync, constants, existsSync, statSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, join, 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// Platform support matrix\n// ---------------------------------------------------------------------------\n//\n// Maps process.platform + process.arch to the per-platform npm package that\n// ships the prebuilt `aihu-css-compile` executable, plus the binary's filename\n// inside that package. Mirrors @aihu/server/src/native.ts detectPlatform() and\n// the package directory names under packages/css-engine/npm/<platform>/.\n//\n// Unlike @aihu/server (a napi `.node` addon loaded via require), the css engine\n// invokes `aihu-css-compile` as a CLI SUBPROCESS (execFileSync against the\n// executable on disk). So the platform package exposes a raw executable file,\n// and we resolve its absolute PATH — we never `require()` the binary itself.\n\ninterface PlatformDescriptor {\n  readonly platformId: string\n  readonly packageName: string\n  /** Executable filename inside the platform package. */\n  readonly binFile: string\n}\n\nfunction detectPlatform(): PlatformDescriptor | null {\n  if (typeof process === 'undefined' || !process.platform || !process.arch) {\n    return null\n  }\n  const key = `${process.platform}-${process.arch}`\n  switch (key) {\n    case 'darwin-arm64':\n      return {\n        platformId: 'darwin-arm64',\n        packageName: '@aihu/css-engine-darwin-arm64',\n        binFile: 'aihu-css-compile',\n      }\n    case 'darwin-x64':\n      return {\n        platformId: 'darwin-x64',\n        packageName: '@aihu/css-engine-darwin-x64',\n        binFile: 'aihu-css-compile',\n      }\n    case 'linux-x64':\n      // We only ship glibc; musl users fall through to the dev/source path.\n      return {\n        platformId: 'linux-x64-gnu',\n        packageName: '@aihu/css-engine-linux-x64-gnu',\n        binFile: 'aihu-css-compile',\n      }\n    case 'win32-x64':\n      return {\n        platformId: 'win32-x64-msvc',\n        packageName: '@aihu/css-engine-win32-x64-msvc',\n        binFile: 'aihu-css-compile.exe',\n      }\n    default:\n      return null\n  }\n}\n\nlet _binPath: string | null = null\n\n/**\n * Whether `candidate` is a usable `aihu-css-compile` executable — NOT merely a\n * present file.\n *\n * The per-platform packages (`@aihu/css-engine-<platform>`) carry a placeholder\n * `aihu-css-compile` in source; the real prebuilt binary is only injected by\n * the release CI. Once those packages become resolvable in the workspace (e.g.\n * after a `bun.lock` refresh that pins them as optionalDependencies), a bare\n * `existsSync` would happily return the non-executable placeholder, which then\n * blows up with EACCES inside `spawnSync`/`execFileSync`. So we must verify the\n * candidate is actually runnable before accepting it.\n *\n * POSIX: require the execute bit (X_OK). A zero-byte/text placeholder without\n * +x fails here and we fall through to the dev `target/` fallback.\n *\n * Windows: there is no execute bit — `accessSync(_, X_OK)` is effectively\n * always true — so we additionally require a non-empty regular file, which\n * still rejects a zero-byte placeholder.\n */\nexport function isUsableExecutable(candidate: string): boolean {\n  try {\n    const st = statSync(candidate)\n    if (!st.isFile() || st.size === 0) return false\n    accessSync(candidate, constants.X_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Resolve the absolute path to the `aihu-css-compile` executable.\n *\n * Resolution order:\n *   1. The per-platform optionalDependency package\n *      (`@aihu/css-engine-<platform>`) shipped to npm consumers — resolved via\n *      `createRequire(...).resolve('<pkg>/package.json')` so it works in both\n *      ESM and CJS and respects the consumer's node_modules layout.\n *   2. Dev fallback: the monorepo workspace `target/release|debug/` — only\n *      present in a dev clone with a Rust toolchain (`cargo build --release -p\n *      aihu-css-core`). Kept so in-repo builds + tests work without publishing.\n *\n * If the current platform is SUPPORTED but neither path yields a binary, throws\n * a structured error pointing at the missing optionalDependency (mirrors\n * @aihu/server's failure-loud contract). If the platform is UNSUPPORTED, the\n * error lists the dev fallback so source builds still have a clear remedy.\n */\nfunction resolveBinary(): string {\n  if (_binPath !== null) return _binPath\n\n  const descriptor = detectPlatform()\n\n  // 1. Per-platform optionalDependency package (the published-consumer path).\n  //\n  // Accept the candidate ONLY if it is a usable executable. A present-but-\n  // non-executable placeholder (the in-source stub that becomes resolvable once\n  // the per-platform packages are pinned in the lockfile) must NOT be returned —\n  // doing so spawns a non-executable file and fails with EACCES. In that case we\n  // deliberately fall THROUGH to the dev `target/` fallback below.\n  if (descriptor) {\n    const requireFn = createRequire(import.meta.url)\n    try {\n      const pkgJson = requireFn.resolve(`${descriptor.packageName}/package.json`)\n      const candidate = join(dirname(pkgJson), descriptor.binFile)\n      if (isUsableExecutable(candidate)) {\n        _binPath = candidate\n        return _binPath\n      }\n    } catch {\n      // Package not installed (optionalDependency skipped for this platform, or\n      // a partial install). Fall through to the dev/source path, then error.\n    }\n  }\n\n  // 2. Dev fallback: monorepo workspace target/. Only exists in a dev clone.\n  const ext = process.platform === 'win32' ? '.exe' : ''\n  const devCandidates = [\n    resolve(__dirname, '../../../target/release', `aihu-css-compile${ext}`),\n    resolve(__dirname, '../../../target/debug', `aihu-css-compile${ext}`),\n  ]\n  for (const c of devCandidates) {\n    if (existsSync(c)) {\n      _binPath = c\n      return _binPath\n    }\n  }\n\n  throw buildMissingBinaryError(descriptor, devCandidates)\n}\n\nfunction buildMissingBinaryError(\n  descriptor: PlatformDescriptor | null,\n  devCandidates: string[],\n): Error {\n  if (descriptor === null) {\n    return new Error(\n      `[@aihu/css-engine] No prebuilt aihu-css-compile binary for this platform.\\n\\n` +\n        `  Platform:        ${typeof process !== 'undefined' ? `${process.platform}-${process.arch}` : 'unknown'}\\n\\n` +\n        `  @aihu/css-engine ships prebuilt binaries for darwin-arm64, darwin-x64,\\n` +\n        `  linux-x64-gnu (glibc) and win32-x64-msvc. Your platform is not in that set.\\n\\n` +\n        `  To build from source you need a Rust toolchain, then run from the repo root:\\n` +\n        `    cargo build --release -p aihu-css-core\\n\\n` +\n        `  Checked dev fallback paths: ${devCandidates.join(', ')}`,\n    )\n  }\n  return new Error(\n    `[@aihu/css-engine] Native CSS compiler binary not found for this platform.\\n\\n` +\n      `  Platform:         ${descriptor.platformId}\\n` +\n      `  Expected package: ${descriptor.packageName}\\n` +\n      `  Expected file:    ${descriptor.packageName}/${descriptor.binFile}\\n\\n` +\n      `  This binary is distributed as an optionalDependency of @aihu/css-engine.\\n` +\n      `  Your package manager may have skipped it (optionalDependencies are\\n` +\n      `  silently dropped on install failure).\\n\\n` +\n      `  To reinstall:\\n` +\n      `    npm install @aihu/css-engine\\n` +\n      `    # or: pnpm install   or: bun install\\n\\n` +\n      `  If you are working in the aihu monorepo, build from source instead:\\n` +\n      `    cargo build --release -p aihu-css-core\\n` +\n      `  Checked dev fallback paths: ${devCandidates.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":";;;;;;;;AAcA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAuBzD,SAAS,iBAA4C;CACnD,IAAI,OAAO,YAAY,eAAe,CAAC,QAAQ,YAAY,CAAC,QAAQ,MAClE,OAAO;CAGT,QAAQ,GADO,QAAQ,SAAS,GAAG,QAAQ,QAC3C;EACE,KAAK,gBACH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,KAAK,cACH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,KAAK,aAEH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,KAAK,aACH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,SACE,OAAO;;;AAIb,IAAI,WAA0B;;;;;;;;;;;;;;;;;;;;AAqB9B,SAAgB,mBAAmB,WAA4B;CAC7D,IAAI;EACF,MAAM,KAAK,SAAS,UAAU;EAC9B,IAAI,CAAC,GAAG,QAAQ,IAAI,GAAG,SAAS,GAAG,OAAO;EAC1C,WAAW,WAAW,UAAU,KAAK;EACrC,OAAO;SACD;EACN,OAAO;;;;;;;;;;;;;;;;;;;;AAqBX,SAAS,gBAAwB;CAC/B,IAAI,aAAa,MAAM,OAAO;CAE9B,MAAM,aAAa,gBAAgB;CASnC,IAAI,YAAY;EACd,MAAM,YAAY,cAAc,OAAO,KAAK,IAAI;EAChD,IAAI;GAEF,MAAM,YAAY,KAAK,QADP,UAAU,QAAQ,GAAG,WAAW,YAAY,eACtB,CAAC,EAAE,WAAW,QAAQ;GAC5D,IAAI,mBAAmB,UAAU,EAAE;IACjC,WAAW;IACX,OAAO;;UAEH;;CAOV,MAAM,MAAM,QAAQ,aAAa,UAAU,SAAS;CACpD,MAAM,gBAAgB,CACpB,QAAQ,WAAW,2BAA2B,mBAAmB,MAAM,EACvE,QAAQ,WAAW,yBAAyB,mBAAmB,MAAM,CACtE;CACD,KAAK,MAAM,KAAK,eACd,IAAI,WAAW,EAAE,EAAE;EACjB,WAAW;EACX,OAAO;;CAIX,MAAM,wBAAwB,YAAY,cAAc;;AAG1D,SAAS,wBACP,YACA,eACO;CACP,IAAI,eAAe,MACjB,uBAAO,IAAI,MACT,mGACwB,OAAO,YAAY,cAAc,GAAG,QAAQ,SAAS,GAAG,QAAQ,SAAS,UAAU,6TAKxE,cAAc,KAAK,KAAK,GAC5D;CAEH,uBAAO,IAAI,MACT,qGACyB,WAAW,WAAW,wBACtB,WAAW,YAAY,wBACvB,WAAW,YAAY,GAAG,WAAW,QAAQ,mbASnC,cAAc,KAAK,KAAK,GAC5D;;;;;;;;;;;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,MAAM,aAAa,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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { execFileSync } from 'node:child_process'\nimport { accessSync, constants, existsSync, statSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, join, 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// Platform support matrix\n// ---------------------------------------------------------------------------\n//\n// Maps process.platform + process.arch to the per-platform npm package that\n// ships the prebuilt `aihu-css-compile` executable, plus the binary's filename\n// inside that package. Mirrors @aihu/server/src/native.ts detectPlatform() and\n// the package directory names under packages/css-engine/npm/<platform>/.\n//\n// Unlike @aihu/server (a napi `.node` addon loaded via require), the css engine\n// invokes `aihu-css-compile` as a CLI SUBPROCESS (execFileSync against the\n// executable on disk). So the platform package exposes a raw executable file,\n// and we resolve its absolute PATH — we never `require()` the binary itself.\n\ninterface PlatformDescriptor {\n  readonly platformId: string\n  readonly packageName: string\n  /** Executable filename inside the platform package. */\n  readonly binFile: string\n}\n\nfunction detectPlatform(): PlatformDescriptor | null {\n  if (typeof process === 'undefined' || !process.platform || !process.arch) {\n    return null\n  }\n  const key = `${process.platform}-${process.arch}`\n  switch (key) {\n    case 'darwin-arm64':\n      return {\n        platformId: 'darwin-arm64',\n        packageName: '@aihu/css-engine-darwin-arm64',\n        binFile: 'aihu-css-compile',\n      }\n    case 'darwin-x64':\n      return {\n        platformId: 'darwin-x64',\n        packageName: '@aihu/css-engine-darwin-x64',\n        binFile: 'aihu-css-compile',\n      }\n    case 'linux-x64':\n      // We only ship glibc; musl users fall through to the dev/source path.\n      return {\n        platformId: 'linux-x64-gnu',\n        packageName: '@aihu/css-engine-linux-x64-gnu',\n        binFile: 'aihu-css-compile',\n      }\n    case 'win32-x64':\n      return {\n        platformId: 'win32-x64-msvc',\n        packageName: '@aihu/css-engine-win32-x64-msvc',\n        binFile: 'aihu-css-compile.exe',\n      }\n    default:\n      return null\n  }\n}\n\nlet _binPath: string | null = null\n\n/**\n * Whether `candidate` is a usable `aihu-css-compile` executable — NOT merely a\n * present file.\n *\n * The per-platform packages (`@aihu/css-engine-<platform>`) carry a placeholder\n * `aihu-css-compile` in source; the real prebuilt binary is only injected by\n * the release CI. Once those packages become resolvable in the workspace (e.g.\n * after a `bun.lock` refresh that pins them as optionalDependencies), a bare\n * `existsSync` would happily return the non-executable placeholder, which then\n * blows up with EACCES inside `spawnSync`/`execFileSync`. So we must verify the\n * candidate is actually runnable before accepting it.\n *\n * POSIX: require the execute bit (X_OK). A zero-byte/text placeholder without\n * +x fails here and we fall through to the dev `target/` fallback.\n *\n * Windows: there is no execute bit — `accessSync(_, X_OK)` is effectively\n * always true — so we additionally require a non-empty regular file, which\n * still rejects a zero-byte placeholder.\n */\nexport function isUsableExecutable(candidate: string): boolean {\n  try {\n    const st = statSync(candidate)\n    if (!st.isFile() || st.size === 0) return false\n    accessSync(candidate, constants.X_OK)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Resolve the absolute path to the `aihu-css-compile` executable.\n *\n * Resolution order:\n *   1. The per-platform optionalDependency package\n *      (`@aihu/css-engine-<platform>`) shipped to npm consumers — resolved via\n *      `createRequire(...).resolve('<pkg>/package.json')` so it works in both\n *      ESM and CJS and respects the consumer's node_modules layout.\n *   2. Dev fallback: the monorepo workspace `target/release|debug/` — only\n *      present in a dev clone with a Rust toolchain (`cargo build --release -p\n *      aihu-css-core`). Kept so in-repo builds + tests work without publishing.\n *\n * If the current platform is SUPPORTED but neither path yields a binary, throws\n * a structured error pointing at the missing optionalDependency (mirrors\n * @aihu/server's failure-loud contract). If the platform is UNSUPPORTED, the\n * error lists the dev fallback so source builds still have a clear remedy.\n */\nfunction resolveBinary(): string {\n  if (_binPath !== null) return _binPath\n\n  const descriptor = detectPlatform()\n\n  // 1. Per-platform optionalDependency package (the published-consumer path).\n  //\n  // Accept the candidate ONLY if it is a usable executable. A present-but-\n  // non-executable placeholder (the in-source stub that becomes resolvable once\n  // the per-platform packages are pinned in the lockfile) must NOT be returned —\n  // doing so spawns a non-executable file and fails with EACCES. In that case we\n  // deliberately fall THROUGH to the dev `target/` fallback below.\n  if (descriptor) {\n    const requireFn = createRequire(import.meta.url)\n    try {\n      const pkgJson = requireFn.resolve(`${descriptor.packageName}/package.json`)\n      const candidate = join(dirname(pkgJson), descriptor.binFile)\n      if (isUsableExecutable(candidate)) {\n        _binPath = candidate\n        return _binPath\n      }\n    } catch {\n      // Package not installed (optionalDependency skipped for this platform, or\n      // a partial install). Fall through to the dev/source path, then error.\n    }\n  }\n\n  // 2. Dev fallback: monorepo workspace target/. Only exists in a dev clone.\n  const ext = process.platform === 'win32' ? '.exe' : ''\n  const devCandidates = [\n    resolve(__dirname, '../../../target/release', `aihu-css-compile${ext}`),\n    resolve(__dirname, '../../../target/debug', `aihu-css-compile${ext}`),\n  ]\n  for (const c of devCandidates) {\n    if (existsSync(c)) {\n      _binPath = c\n      return _binPath\n    }\n  }\n\n  throw buildMissingBinaryError(descriptor, devCandidates)\n}\n\nfunction buildMissingBinaryError(\n  descriptor: PlatformDescriptor | null,\n  devCandidates: string[],\n): Error {\n  if (descriptor === null) {\n    return new Error(\n      `[@aihu/css-engine] No prebuilt aihu-css-compile binary for this platform.\\n\\n` +\n        `  Platform:        ${typeof process !== 'undefined' ? `${process.platform}-${process.arch}` : 'unknown'}\\n\\n` +\n        `  @aihu/css-engine ships prebuilt binaries for darwin-arm64, darwin-x64,\\n` +\n        `  linux-x64-gnu (glibc) and win32-x64-msvc. Your platform is not in that set.\\n\\n` +\n        `  To build from source you need a Rust toolchain, then run from the repo root:\\n` +\n        `    cargo build --release -p aihu-css-core\\n\\n` +\n        `  Checked dev fallback paths: ${devCandidates.join(', ')}`,\n    )\n  }\n  return new Error(\n    `[@aihu/css-engine] Native CSS compiler binary not found for this platform.\\n\\n` +\n      `  Platform:         ${descriptor.platformId}\\n` +\n      `  Expected package: ${descriptor.packageName}\\n` +\n      `  Expected file:    ${descriptor.packageName}/${descriptor.binFile}\\n\\n` +\n      `  This binary is distributed as an optionalDependency of @aihu/css-engine.\\n` +\n      `  Your package manager may have skipped it (optionalDependencies are\\n` +\n      `  silently dropped on install failure).\\n\\n` +\n      `  To reinstall:\\n` +\n      `    npm install @aihu/css-engine\\n` +\n      `    # or: pnpm install   or: bun install\\n\\n` +\n      `  If you are working in the aihu monorepo, build from source instead:\\n` +\n      `    cargo build --release -p aihu-css-core\\n` +\n      `  Checked dev fallback paths: ${devCandidates.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 */\n/**\n * Spawn the native compiler, returning stdout on success. On a non-zero exit\n * (the binary's R-RESULT error path) throw an `Error` carrying the binary's\n * stderr message rather than letting `execFileSync`'s opaque status error\n * surface. stderr is PIPED (not inherited) so the message lands in the thrown\n * error instead of the parent's console.\n */\nfunction runBinary(bin: string, args: string[], input: string): string {\n  try {\n    return execFileSync(bin, args, {\n      input,\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    })\n  } catch (err) {\n    const e = err as { stderr?: Buffer | string; message?: string }\n    const stderr =\n      typeof e.stderr === 'string'\n        ? e.stderr\n        : e.stderr instanceof Buffer\n          ? e.stderr.toString('utf-8')\n          : ''\n    const detail = stderr.trim() || e.message || 'unknown error'\n    throw new Error(`[@aihu/css-engine] CSS compile failed: ${detail}`)\n  }\n}\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  return runBinary(bin, [], input)\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 runBinary(bin, ['--ast-json'], JSON.stringify(ast))\n}\n"],"mappings":";;;;;;;;AAcA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAuBzD,SAAS,iBAA4C;CACnD,IAAI,OAAO,YAAY,eAAe,CAAC,QAAQ,YAAY,CAAC,QAAQ,MAClE,OAAO;CAGT,QAAQ,GADO,QAAQ,SAAS,GAAG,QAAQ,QAC3C;EACE,KAAK,gBACH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,KAAK,cACH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,KAAK,aAEH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,KAAK,aACH,OAAO;GACL,YAAY;GACZ,aAAa;GACb,SAAS;GACV;EACH,SACE,OAAO;;;AAIb,IAAI,WAA0B;;;;;;;;;;;;;;;;;;;;AAqB9B,SAAgB,mBAAmB,WAA4B;CAC7D,IAAI;EACF,MAAM,KAAK,SAAS,UAAU;EAC9B,IAAI,CAAC,GAAG,QAAQ,IAAI,GAAG,SAAS,GAAG,OAAO;EAC1C,WAAW,WAAW,UAAU,KAAK;EACrC,OAAO;SACD;EACN,OAAO;;;;;;;;;;;;;;;;;;;;AAqBX,SAAS,gBAAwB;CAC/B,IAAI,aAAa,MAAM,OAAO;CAE9B,MAAM,aAAa,gBAAgB;CASnC,IAAI,YAAY;EACd,MAAM,YAAY,cAAc,OAAO,KAAK,IAAI;EAChD,IAAI;GAEF,MAAM,YAAY,KAAK,QADP,UAAU,QAAQ,GAAG,WAAW,YAAY,eACtB,CAAC,EAAE,WAAW,QAAQ;GAC5D,IAAI,mBAAmB,UAAU,EAAE;IACjC,WAAW;IACX,OAAO;;UAEH;;CAOV,MAAM,MAAM,QAAQ,aAAa,UAAU,SAAS;CACpD,MAAM,gBAAgB,CACpB,QAAQ,WAAW,2BAA2B,mBAAmB,MAAM,EACvE,QAAQ,WAAW,yBAAyB,mBAAmB,MAAM,CACtE;CACD,KAAK,MAAM,KAAK,eACd,IAAI,WAAW,EAAE,EAAE;EACjB,WAAW;EACX,OAAO;;CAIX,MAAM,wBAAwB,YAAY,cAAc;;AAG1D,SAAS,wBACP,YACA,eACO;CACP,IAAI,eAAe,MACjB,uBAAO,IAAI,MACT,mGACwB,OAAO,YAAY,cAAc,GAAG,QAAQ,SAAS,GAAG,QAAQ,SAAS,UAAU,6TAKxE,cAAc,KAAK,KAAK,GAC5D;CAEH,uBAAO,IAAI,MACT,qGACyB,WAAW,WAAW,wBACtB,WAAW,YAAY,wBACvB,WAAW,YAAY,GAAG,WAAW,QAAQ,mbASnC,cAAc,KAAK,KAAK,GAC5D;;;;;;;;;;;;;;;;;;AAmBH,SAAS,UAAU,KAAa,MAAgB,OAAuB;CACrE,IAAI;EACF,OAAO,aAAa,KAAK,MAAM;GAC7B;GACA,UAAU;GACV,OAAO;IAAC;IAAQ;IAAQ;IAAO;GAChC,CAAC;UACK,KAAK;EACZ,MAAM,IAAI;EAOV,MAAM,UALJ,OAAO,EAAE,WAAW,WAChB,EAAE,SACF,EAAE,kBAAkB,SAClB,EAAE,OAAO,SAAS,QAAQ,GAC1B,IACc,MAAM,IAAI,EAAE,WAAW;EAC7C,MAAM,IAAI,MAAM,0CAA0C,SAAS;;;AAIvE,SAAgB,QAAQ,SAA2B;CACjD,IAAI,QAAQ,WAAW,GAAG,OAAO;CAIjC,OAAO,UAFK,eAEQ,EAAE,EAAE,EADV,QAAQ,KAAK,KACI,CAAC;;;;;;;;;;;;;;;AAgBlC,SAAgB,WAAW,QAAgB,IAAqB;CAC9D,MAAM,MAAM,aAAa,QAAQ,GAAG;CAEpC,OAAO,UADK,eACQ,EAAE,CAAC,aAAa,EAAE,KAAK,UAAU,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aihu/css-engine",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,13 +37,13 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@aihu/compiler": "^0.5.4"
+    "@aihu/compiler": "^0.6.0"
   },
   "optionalDependencies": {
-    "@aihu/css-engine-darwin-arm64": "0.1.2",
-    "@aihu/css-engine-darwin-x64": "0.1.2",
-    "@aihu/css-engine-linux-x64-gnu": "0.1.2",
-    "@aihu/css-engine-win32-x64-msvc": "0.1.2"
+    "@aihu/css-engine-darwin-arm64": "0.1.3",
+    "@aihu/css-engine-darwin-x64": "0.1.3",
+    "@aihu/css-engine-linux-x64-gnu": "0.1.3",
+    "@aihu/css-engine-win32-x64-msvc": "0.1.3"
   },
   "scripts": {
     "build": "bun run gen:style-packs && rolldown -c",