@csszyx/compiler 0.10.6 → 0.10.8

package/dist/color-var.cjs

@@ -1,6 +1,9 @@
 'use strict';
 
 function __szColorVar(v) {
+  if (typeof v !== "string" || v === "") {
+    return void 0;
+  }
   if (v.startsWith("#") || v.startsWith("rgb") || v.startsWith("hsl") || v.startsWith("oklch")) {
     return v;
   }

package/dist/color-var.d.cts

@@ -6,13 +6,14 @@
  * The runtime/lite inlines this implementation at build time (zero runtime dep).
  *
  * Resolution rules (Tailwind v4 conventions):
+ *   - undefined/null/empty/non-string → undefined ("no colour", omit the CSS var)
  *   - Raw CSS values (#hex, rgb, hsl, oklch) → pass through unchanged
  *   - CSS custom properties (--*) → wrapped in var()
  *   - Tailwind color names (blue-500, etc.) → var(--color-<name>)
  *
  * @param v - Color value: Tailwind name, hex, rgb/hsl/oklch, or CSS variable
- * @returns CSS-compatible color string
+ * @returns CSS-compatible color string, or undefined when there is no colour
  */
-declare function __szColorVar(v: string): string;
+declare function __szColorVar(v: string | null | undefined): string | undefined;
 
 export { __szColorVar };

package/dist/color-var.d.mts

@@ -6,13 +6,14 @@
  * The runtime/lite inlines this implementation at build time (zero runtime dep).
  *
  * Resolution rules (Tailwind v4 conventions):
+ *   - undefined/null/empty/non-string → undefined ("no colour", omit the CSS var)
  *   - Raw CSS values (#hex, rgb, hsl, oklch) → pass through unchanged
  *   - CSS custom properties (--*) → wrapped in var()
  *   - Tailwind color names (blue-500, etc.) → var(--color-<name>)
  *
  * @param v - Color value: Tailwind name, hex, rgb/hsl/oklch, or CSS variable
- * @returns CSS-compatible color string
+ * @returns CSS-compatible color string, or undefined when there is no colour
  */
-declare function __szColorVar(v: string): string;
+declare function __szColorVar(v: string | null | undefined): string | undefined;
 
 export { __szColorVar };

package/dist/color-var.mjs

@@ -1,4 +1,7 @@
 function __szColorVar(v) {
+  if (typeof v !== "string" || v === "") {
+    return void 0;
+  }
   if (v.startsWith("#") || v.startsWith("rgb") || v.startsWith("hsl") || v.startsWith("oklch")) {
     return v;
   }

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 const core = require('@csszyx/core');
-const transformCore = require('./shared/compiler.BCOOXYBh.cjs');
+const transformCore = require('./shared/compiler.mibv6qPF.cjs');
 const oxcParser = require('oxc-parser');
 const t = require('@babel/types');
 const node_crypto = require('node:crypto');
@@ -117,6 +117,7 @@ function transformSourceCode(source, filename, options) {
           // before any sz transform work begins, and doesn't
           // interfere with the JSXAttribute handler below.
           pre(file) {
+            transformCore.setSzWarnLocation(void 0);
             let nodeCount = 0;
             babel__namespace.traverse(file.ast, {
               enter() {
@@ -131,6 +132,11 @@ function transformSourceCode(source, filename, options) {
               }
             });
           },
+          // Drop the warn location after the file's visitor pass so it
+          // never leaks to an unrelated later transform or the runtime path.
+          post() {
+            transformCore.setSzWarnLocation(void 0);
+          },
           visitor: {
             JSXAttribute(path) {
               const attrName = t__namespace.isJSXIdentifier(path.node.name) ? path.node.name.name : "";
@@ -197,6 +203,13 @@ function transformSourceCode(source, filename, options) {
               if (attrName !== "sz") {
                 return;
               }
+              transformCore.setSzWarnLocation(
+                transformCore.formatSzWarnLocation(
+                  filename ?? "file.tsx",
+                  path.node.loc?.start.line,
+                  options?.rootDir
+                )
+              );
               const value = path.node.value;
               let existingClassNameNode = null;
               let existingClassExpr = null;
@@ -232,6 +245,9 @@ function transformSourceCode(source, filename, options) {
               }
               const createMergedClassNameValue = (szExpr) => {
                 if (!existingClassExpr) {
+                  if (t__namespace.isStringLiteral(szExpr) && szExpr.value === "") {
+                    return t__namespace.jsxExpressionContainer(t__namespace.identifier("undefined"));
+                  }
                   return t__namespace.isStringLiteral(szExpr) ? szExpr : t__namespace.jsxExpressionContainer(szExpr);
                 }
                 if (existingClassNameNode && path.parentPath?.isJSXOpeningElement()) {
@@ -813,6 +829,9 @@ function parseStyleStringToObjectExpr(styleStr) {
   }
   return t__namespace.objectExpression(objProps);
 }
+function emptyClassToUndefined(node) {
+  return t__namespace.isStringLiteral(node) && node.value === "" ? t__namespace.identifier("undefined") : node;
+}
 function tryStaticTransformNode(node, getBinding) {
   if (t__namespace.isTSAsExpression(node) || t__namespace.isTSSatisfiesExpression(node)) {
     return tryStaticTransformNode(node.expression, getBinding);
@@ -849,7 +868,11 @@ function tryStaticTransformNode(node, getBinding) {
     const consequent = tryStaticTransformNode(node.consequent, getBinding);
     const alternate = tryStaticTransformNode(node.alternate, getBinding);
     if (consequent !== null && alternate !== null) {
-      return t__namespace.conditionalExpression(node.test, consequent, alternate);
+      return t__namespace.conditionalExpression(
+        node.test,
+        emptyClassToUndefined(consequent),
+        emptyClassToUndefined(alternate)
+      );
     }
     return null;
   }
@@ -886,7 +909,11 @@ function tryHoistConditionalSpread(node, getBinding) {
   if (!t__namespace.isStringLiteral(resolvedA) || !t__namespace.isStringLiteral(resolvedB)) {
     return null;
   }
-  return t__namespace.conditionalExpression(conditionalExpr.test, resolvedA, resolvedB);
+  return t__namespace.conditionalExpression(
+    conditionalExpr.test,
+    emptyClassToUndefined(resolvedA),
+    emptyClassToUndefined(resolvedB)
+  );
 }
 function readStaticConfigObject(configExpr, key, scope) {
   for (const prop of configExpr.properties) {
@@ -1016,20 +1043,20 @@ function buildConditionalClassExpr(baseClasses, conditionalClasses) {
   if (conditionalClasses.length === 0) {
     return t__namespace.stringLiteral(baseClasses);
   }
-  const makeCondExpr = (cc) => t__namespace.conditionalExpression(
+  const makeCondExpr = (cc, bare) => t__namespace.conditionalExpression(
     cc.test,
-    t__namespace.stringLiteral(cc.consequent),
-    t__namespace.stringLiteral(cc.alternate)
+    bare && cc.consequent === "" ? t__namespace.identifier("undefined") : t__namespace.stringLiteral(cc.consequent),
+    bare && cc.alternate === "" ? t__namespace.identifier("undefined") : t__namespace.stringLiteral(cc.alternate)
   );
   if (conditionalClasses.length === 1 && !baseClasses) {
-    return makeCondExpr(conditionalClasses[0]);
+    return makeCondExpr(conditionalClasses[0], true);
   }
   const quasis = [];
   const exprs = [];
   for (let i = 0; i < conditionalClasses.length; i++) {
     const prefix = i === 0 ? baseClasses ? `${baseClasses} ` : "" : " ";
     quasis.push(t__namespace.templateElement({ raw: prefix, cooked: prefix }, false));
-    exprs.push(makeCondExpr(conditionalClasses[i]));
+    exprs.push(makeCondExpr(conditionalClasses[i], false));
   }
   quasis.push(t__namespace.templateElement({ raw: "", cooked: "" }, true));
   return t__namespace.templateLiteral(quasis, exprs);
@@ -2288,6 +2315,7 @@ function transformOxc(source, filename, options) {
     };
   }
   const effectiveFilename = filename ?? "file.tsx";
+  transformCore.setSzWarnLocation(void 0);
   const astBudget = options?.astBudget ?? AST_BUDGET;
   const parsed = oxcParser.parseSync(effectiveFilename, source);
   if (parsed.errors.length > 0) {
@@ -2428,6 +2456,10 @@ function transformOxc(source, filename, options) {
     let runtimeFallbackExpr = null;
     let runtimeFallbackAttr = null;
     for (const szAttr of szAttrs) {
+      const { line: szWarnLine } = offsetToLineColumn(source, szAttr.start);
+      transformCore.setSzWarnLocation(
+        transformCore.formatSzWarnLocation(effectiveFilename, szWarnLine, options?.rootDir)
+      );
       const value = szAttr.value;
       if (!value) {
         throw new OxcNotImplementedError(
@@ -2704,6 +2736,7 @@ function transformOxc(source, filename, options) {
         }
       }
     }
+    transformCore.setSzWarnLocation(void 0);
     if (runtimeFallbackExpr && runtimeFallbackAttr) {
       if (classNameAttr) {
         throw new OxcNotImplementedError(
@@ -2750,7 +2783,7 @@ function transformOxc(source, filename, options) {
       ...existingRaw ? existingRaw.split(/\s+/).filter(Boolean) : [],
       ...szDerived
     ];
-    const mergedAttr = `className="${mergedClasses.join(" ")}"`;
+    const mergedAttr = mergedClasses.length === 0 ? "className={undefined}" : `className="${mergedClasses.join(" ")}"`;
     if (classNameAttr) {
       edits.overwrite(classNameAttr.start, classNameAttr.end, mergedAttr);
       for (const szAttr of szAttrs) {
@@ -3362,7 +3395,8 @@ function buildConditionalSpreadClassExpression(node, filename, bindings, source,
     }
   }
   const testSource = source.slice(conditionalSpread.test.start, conditionalSpread.test.end);
-  return `${testSource} ? ${JSON.stringify(consequent)} : ${JSON.stringify(alternate)}`;
+  const branch = (cls) => cls === "" ? "undefined" : JSON.stringify(cls);
+  return `${testSource} ? ${branch(consequent)} : ${branch(alternate)}`;
 }
 function compileConditionalSpreadBranch(branch, otherProps, sourceNode, filename, bindings, globalVarAliases, cssVariableMap) {
   const branchObject = resolveObjectExpression(branch, bindings);
@@ -3425,7 +3459,11 @@ function buildPartialObjectTransform(node, filename, bindings, source, options,
     classParts.push(entry.consequent, entry.alternate);
   }
   const className = classParts.filter(Boolean).join(" ");
-  const classNameAttr = partial.conditionalClasses.length > 0 ? `className={${buildConditionalClassSource(classParts, partial.conditionalClasses, source)}}` : `className="${className}"`;
+  const classNameAttr = partial.conditionalClasses.length > 0 ? `className={${buildConditionalClassSource(classParts, partial.conditionalClasses, source)}}` : className === "" ? (
+    // An sz that lowers to zero classes emits `className={undefined}` so the
+    // DOM has no `class` attribute, instead of the noisy `class=""`.
+    "className={undefined}"
+  ) : `className="${className}"`;
   const styleProps = [...partial.dynamicProps.entries()].filter(([id]) => !hoistedNames?.has(id)).map(
     ([, info]) => `${JSON.stringify(info.varName)}: ${generateStyleValueSource(info, source)}`
   );
@@ -3999,9 +4037,11 @@ function buildCSSVarClassName(info) {
 function buildConditionalClassSource(classParts, conditionals, source) {
   if (conditionals.length === 1) {
     const [entry] = conditionals;
-    const ternary = `${source.slice(entry.test.start, entry.test.end)} ? ${JSON.stringify(entry.consequent)} : ${JSON.stringify(entry.alternate)}`;
     const staticParts = classParts.slice(0, -2).filter(Boolean);
-    if (staticParts.length === 0) {
+    const bare = staticParts.length === 0;
+    const branch = (cls) => bare && cls === "" ? "undefined" : JSON.stringify(cls);
+    const ternary = `${source.slice(entry.test.start, entry.test.end)} ? ${branch(entry.consequent)} : ${branch(entry.alternate)}`;
+    if (bare) {
       return ternary;
     }
     return `\`${staticParts.join(" ")} \${${ternary}}\``;
@@ -4053,7 +4093,8 @@ function buildStaticConditionalClassExpression(node, filename, bindings, source,
     }
   }
   const testSource = source.slice(node.test.start, node.test.end);
-  return `${testSource} ? ${JSON.stringify(consequent)} : ${JSON.stringify(alternate)}`;
+  const branch = (cls) => cls === "" ? "undefined" : JSON.stringify(cls);
+  return `${testSource} ? ${branch(consequent)} : ${branch(alternate)}`;
 }
 function resolveStaticClassString(node, filename, bindings, globalVarAliases, cssVariableMap) {
   const unwrapped = unwrapExpression(node);
@@ -4283,7 +4324,8 @@ function transformRustBatch(files, options) {
       {
         mangleVars: options?.mangleVars === true,
         mangleVarHoistMaxDepth: options?.mangleVarHoistMaxDepth,
-        globalVarAliases: normalizeGlobalVarAliases(options?.globalVarAliases)
+        globalVarAliases: normalizeGlobalVarAliases(options?.globalVarAliases),
+        rootDir: options?.rootDir
       }
     ).map(fromNativeResult);
   } catch (err) {

package/dist/index.d.cts

@@ -329,6 +329,12 @@ interface TransformSourceCodeOptions {
      * token names to aliases, for example `--brand-primary` -> `---gz`.
      */
     globalVarAliases?: GlobalVarAliasTableInput;
+    /**
+     * Project root used only to render diagnostic file paths relative to it (so a
+     * dev-mode "Unknown property" warning reads `src/Foo.tsx:12`, not an absolute
+     * path). When omitted, diagnostics fall back to the filename as given.
+     */
+    rootDir?: string;
 }
 /**
  * Accepted input shapes for global CSS custom-property alias tables.

package/dist/index.d.mts

@@ -329,6 +329,12 @@ interface TransformSourceCodeOptions {
      * token names to aliases, for example `--brand-primary` -> `---gz`.
      */
     globalVarAliases?: GlobalVarAliasTableInput;
+    /**
+     * Project root used only to render diagnostic file paths relative to it (so a
+     * dev-mode "Unknown property" warning reads `src/Foo.tsx:12`, not an absolute
+     * path). When omitted, diagnostics fall back to the filename as given.
+     */
+    rootDir?: string;
 }
 /**
  * Accepted input shapes for global CSS custom-property alias tables.

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { init, version, transform_sz, encode } from '@csszyx/core';
-import { t as transform, C as COLOR_PROPERTIES, P as PROPERTY_MAP, g as getCSSVariableName, a as PropertyCategory, K as KNOWN_VARIANTS, b as getVariantPrefix, c as getPropertyCategory, s as stripInvalidColorStrings } from './shared/compiler.DGInsDP8.mjs';
-export { B as BOOLEAN_SHORTHANDS, d as PROPERTY_CATEGORY_MAP, R as REMOVED_BOOLEAN_SUGAR, S as SPECIAL_VARIANTS, e as SUGGESTION_MAP, i as isValidSzProp, n as normalizeClassName } from './shared/compiler.DGInsDP8.mjs';
+import { t as transform, s as setSzWarnLocation, f as formatSzWarnLocation, C as COLOR_PROPERTIES, P as PROPERTY_MAP, g as getCSSVariableName, a as PropertyCategory, K as KNOWN_VARIANTS, b as getVariantPrefix, c as getPropertyCategory, d as stripInvalidColorStrings } from './shared/compiler.CghwJ6p5.mjs';
+export { B as BOOLEAN_SHORTHANDS, e as PROPERTY_CATEGORY_MAP, R as REMOVED_BOOLEAN_SUGAR, S as SPECIAL_VARIANTS, h as SUGGESTION_MAP, i as isValidSzProp, n as normalizeClassName } from './shared/compiler.CghwJ6p5.mjs';
 import { parseSync } from 'oxc-parser';
 import * as t from '@babel/types';
 import { createHash } from 'node:crypto';
@@ -98,6 +98,7 @@ function transformSourceCode(source, filename, options) {
           // before any sz transform work begins, and doesn't
           // interfere with the JSXAttribute handler below.
           pre(file) {
+            setSzWarnLocation(void 0);
             let nodeCount = 0;
             babel.traverse(file.ast, {
               enter() {
@@ -112,6 +113,11 @@ function transformSourceCode(source, filename, options) {
               }
             });
           },
+          // Drop the warn location after the file's visitor pass so it
+          // never leaks to an unrelated later transform or the runtime path.
+          post() {
+            setSzWarnLocation(void 0);
+          },
           visitor: {
             JSXAttribute(path) {
               const attrName = t.isJSXIdentifier(path.node.name) ? path.node.name.name : "";
@@ -178,6 +184,13 @@ function transformSourceCode(source, filename, options) {
               if (attrName !== "sz") {
                 return;
               }
+              setSzWarnLocation(
+                formatSzWarnLocation(
+                  filename ?? "file.tsx",
+                  path.node.loc?.start.line,
+                  options?.rootDir
+                )
+              );
               const value = path.node.value;
               let existingClassNameNode = null;
               let existingClassExpr = null;
@@ -213,6 +226,9 @@ function transformSourceCode(source, filename, options) {
               }
               const createMergedClassNameValue = (szExpr) => {
                 if (!existingClassExpr) {
+                  if (t.isStringLiteral(szExpr) && szExpr.value === "") {
+                    return t.jsxExpressionContainer(t.identifier("undefined"));
+                  }
                   return t.isStringLiteral(szExpr) ? szExpr : t.jsxExpressionContainer(szExpr);
                 }
                 if (existingClassNameNode && path.parentPath?.isJSXOpeningElement()) {
@@ -794,6 +810,9 @@ function parseStyleStringToObjectExpr(styleStr) {
   }
   return t.objectExpression(objProps);
 }
+function emptyClassToUndefined(node) {
+  return t.isStringLiteral(node) && node.value === "" ? t.identifier("undefined") : node;
+}
 function tryStaticTransformNode(node, getBinding) {
   if (t.isTSAsExpression(node) || t.isTSSatisfiesExpression(node)) {
     return tryStaticTransformNode(node.expression, getBinding);
@@ -830,7 +849,11 @@ function tryStaticTransformNode(node, getBinding) {
     const consequent = tryStaticTransformNode(node.consequent, getBinding);
     const alternate = tryStaticTransformNode(node.alternate, getBinding);
     if (consequent !== null && alternate !== null) {
-      return t.conditionalExpression(node.test, consequent, alternate);
+      return t.conditionalExpression(
+        node.test,
+        emptyClassToUndefined(consequent),
+        emptyClassToUndefined(alternate)
+      );
     }
     return null;
   }
@@ -867,7 +890,11 @@ function tryHoistConditionalSpread(node, getBinding) {
   if (!t.isStringLiteral(resolvedA) || !t.isStringLiteral(resolvedB)) {
     return null;
   }
-  return t.conditionalExpression(conditionalExpr.test, resolvedA, resolvedB);
+  return t.conditionalExpression(
+    conditionalExpr.test,
+    emptyClassToUndefined(resolvedA),
+    emptyClassToUndefined(resolvedB)
+  );
 }
 function readStaticConfigObject(configExpr, key, scope) {
   for (const prop of configExpr.properties) {
@@ -997,20 +1024,20 @@ function buildConditionalClassExpr(baseClasses, conditionalClasses) {
   if (conditionalClasses.length === 0) {
     return t.stringLiteral(baseClasses);
   }
-  const makeCondExpr = (cc) => t.conditionalExpression(
+  const makeCondExpr = (cc, bare) => t.conditionalExpression(
     cc.test,
-    t.stringLiteral(cc.consequent),
-    t.stringLiteral(cc.alternate)
+    bare && cc.consequent === "" ? t.identifier("undefined") : t.stringLiteral(cc.consequent),
+    bare && cc.alternate === "" ? t.identifier("undefined") : t.stringLiteral(cc.alternate)
   );
   if (conditionalClasses.length === 1 && !baseClasses) {
-    return makeCondExpr(conditionalClasses[0]);
+    return makeCondExpr(conditionalClasses[0], true);
   }
   const quasis = [];
   const exprs = [];
   for (let i = 0; i < conditionalClasses.length; i++) {
     const prefix = i === 0 ? baseClasses ? `${baseClasses} ` : "" : " ";
     quasis.push(t.templateElement({ raw: prefix, cooked: prefix }, false));
-    exprs.push(makeCondExpr(conditionalClasses[i]));
+    exprs.push(makeCondExpr(conditionalClasses[i], false));
   }
   quasis.push(t.templateElement({ raw: "", cooked: "" }, true));
   return t.templateLiteral(quasis, exprs);
@@ -2269,6 +2296,7 @@ function transformOxc(source, filename, options) {
     };
   }
   const effectiveFilename = filename ?? "file.tsx";
+  setSzWarnLocation(void 0);
   const astBudget = options?.astBudget ?? AST_BUDGET;
   const parsed = parseSync(effectiveFilename, source);
   if (parsed.errors.length > 0) {
@@ -2409,6 +2437,10 @@ function transformOxc(source, filename, options) {
     let runtimeFallbackExpr = null;
     let runtimeFallbackAttr = null;
     for (const szAttr of szAttrs) {
+      const { line: szWarnLine } = offsetToLineColumn(source, szAttr.start);
+      setSzWarnLocation(
+        formatSzWarnLocation(effectiveFilename, szWarnLine, options?.rootDir)
+      );
       const value = szAttr.value;
       if (!value) {
         throw new OxcNotImplementedError(
@@ -2685,6 +2717,7 @@ function transformOxc(source, filename, options) {
         }
       }
     }
+    setSzWarnLocation(void 0);
     if (runtimeFallbackExpr && runtimeFallbackAttr) {
       if (classNameAttr) {
         throw new OxcNotImplementedError(
@@ -2731,7 +2764,7 @@ function transformOxc(source, filename, options) {
       ...existingRaw ? existingRaw.split(/\s+/).filter(Boolean) : [],
       ...szDerived
     ];
-    const mergedAttr = `className="${mergedClasses.join(" ")}"`;
+    const mergedAttr = mergedClasses.length === 0 ? "className={undefined}" : `className="${mergedClasses.join(" ")}"`;
     if (classNameAttr) {
       edits.overwrite(classNameAttr.start, classNameAttr.end, mergedAttr);
       for (const szAttr of szAttrs) {
@@ -3343,7 +3376,8 @@ function buildConditionalSpreadClassExpression(node, filename, bindings, source,
     }
   }
   const testSource = source.slice(conditionalSpread.test.start, conditionalSpread.test.end);
-  return `${testSource} ? ${JSON.stringify(consequent)} : ${JSON.stringify(alternate)}`;
+  const branch = (cls) => cls === "" ? "undefined" : JSON.stringify(cls);
+  return `${testSource} ? ${branch(consequent)} : ${branch(alternate)}`;
 }
 function compileConditionalSpreadBranch(branch, otherProps, sourceNode, filename, bindings, globalVarAliases, cssVariableMap) {
   const branchObject = resolveObjectExpression(branch, bindings);
@@ -3406,7 +3440,11 @@ function buildPartialObjectTransform(node, filename, bindings, source, options,
     classParts.push(entry.consequent, entry.alternate);
   }
   const className = classParts.filter(Boolean).join(" ");
-  const classNameAttr = partial.conditionalClasses.length > 0 ? `className={${buildConditionalClassSource(classParts, partial.conditionalClasses, source)}}` : `className="${className}"`;
+  const classNameAttr = partial.conditionalClasses.length > 0 ? `className={${buildConditionalClassSource(classParts, partial.conditionalClasses, source)}}` : className === "" ? (
+    // An sz that lowers to zero classes emits `className={undefined}` so the
+    // DOM has no `class` attribute, instead of the noisy `class=""`.
+    "className={undefined}"
+  ) : `className="${className}"`;
   const styleProps = [...partial.dynamicProps.entries()].filter(([id]) => !hoistedNames?.has(id)).map(
     ([, info]) => `${JSON.stringify(info.varName)}: ${generateStyleValueSource(info, source)}`
   );
@@ -3980,9 +4018,11 @@ function buildCSSVarClassName(info) {
 function buildConditionalClassSource(classParts, conditionals, source) {
   if (conditionals.length === 1) {
     const [entry] = conditionals;
-    const ternary = `${source.slice(entry.test.start, entry.test.end)} ? ${JSON.stringify(entry.consequent)} : ${JSON.stringify(entry.alternate)}`;
     const staticParts = classParts.slice(0, -2).filter(Boolean);
-    if (staticParts.length === 0) {
+    const bare = staticParts.length === 0;
+    const branch = (cls) => bare && cls === "" ? "undefined" : JSON.stringify(cls);
+    const ternary = `${source.slice(entry.test.start, entry.test.end)} ? ${branch(entry.consequent)} : ${branch(entry.alternate)}`;
+    if (bare) {
       return ternary;
     }
     return `\`${staticParts.join(" ")} \${${ternary}}\``;
@@ -4034,7 +4074,8 @@ function buildStaticConditionalClassExpression(node, filename, bindings, source,
     }
   }
   const testSource = source.slice(node.test.start, node.test.end);
-  return `${testSource} ? ${JSON.stringify(consequent)} : ${JSON.stringify(alternate)}`;
+  const branch = (cls) => cls === "" ? "undefined" : JSON.stringify(cls);
+  return `${testSource} ? ${branch(consequent)} : ${branch(alternate)}`;
 }
 function resolveStaticClassString(node, filename, bindings, globalVarAliases, cssVariableMap) {
   const unwrapped = unwrapExpression(node);
@@ -4264,7 +4305,8 @@ function transformRustBatch(files, options) {
       {
         mangleVars: options?.mangleVars === true,
         mangleVarHoistMaxDepth: options?.mangleVarHoistMaxDepth,
-        globalVarAliases: normalizeGlobalVarAliases(options?.globalVarAliases)
+        globalVarAliases: normalizeGlobalVarAliases(options?.globalVarAliases),
+        rootDir: options?.rootDir
       }
     ).map(fromNativeResult);
   } catch (err) {

package/dist/shared/{compiler.DGInsDP8.mjs → compiler.CghwJ6p5.mjs}

@@ -1495,6 +1495,36 @@ function handleSupports(supportsObj, prefix) {
   return classes;
 }
 let szTransformDepth = 0;
+let szWarnLocation;
+let szHintedProjectScan = false;
+function hintProjectScanOnce(location) {
+  if (szHintedProjectScan || !location || process.env.CSSZYX_NO_PROJECT_SCAN_HINT === "1") {
+    return;
+  }
+  szHintedProjectScan = true;
+  console.warn(
+    "[csszyx] Tip: run `npx @csszyx/cli check` to scan every file for sz key issues at once (dev warnings only surface files as you open them)."
+  );
+}
+function setSzWarnLocation(location) {
+  szWarnLocation = location;
+}
+function formatSzWarnLocation(file, line, rootDir) {
+  let rel = file;
+  if (rootDir) {
+    let end = rootDir.length;
+    while (end > 0 && (rootDir[end - 1] === "/" || rootDir[end - 1] === "\\")) {
+      end--;
+    }
+    const root = rootDir.slice(0, end);
+    if (file === root) {
+      rel = file;
+    } else if (file.startsWith(`${root}/`) || file.startsWith(`${root}\\`)) {
+      rel = file.slice(root.length + 1);
+    }
+  }
+  return line === void 0 ? rel : `${rel}:${line}`;
+}
 function transform(szProp, prefix = "", mangleMap) {
   if (!szProp || typeof szProp !== "object") {
     return { className: "", attributes: {} };
@@ -2339,16 +2369,18 @@ function transformImpl(szProp, prefix, mangleMap) {
       KNOWN_VARIANTS.has(rawKey) || // Parametric/scope variants (group, peer, has, not, data, aria, supports)
       SPECIAL_VARIANTS.has(rawKey) || rawKey === "min" || rawKey === "max";
       if (!isKnown) {
+        const at = szWarnLocation ? ` at ${szWarnLocation}` : "";
         const suggestion = SUGGESTION_MAP[rawKey];
         if (suggestion) {
           console.warn(
-            `[csszyx] Use the canonical key "${suggestion}" instead of "${rawKey}".`
+            `[csszyx] Use the canonical key "${suggestion}" instead of "${rawKey}"${at}.`
           );
         } else {
           console.warn(
-            `[csszyx] Unknown property "${rawKey}" in sz prop. This will be ignored. Check for typos.`
+            `[csszyx] Unknown property "${rawKey}" in sz prop${at}. This will be ignored. Check for typos.`
           );
         }
+        hintProjectScanOnce(szWarnLocation);
       }
     }
     if (value === true) {
@@ -2465,4 +2497,4 @@ function normalizeClassName(className) {
   return className.split(/\s+/).filter(Boolean).join(" ");
 }
 
-export { BOOLEAN_SHORTHANDS as B, COLOR_PROPERTIES as C, KNOWN_VARIANTS as K, MAX_SZ_DEPTH as M, PROPERTY_MAP as P, REMOVED_BOOLEAN_SUGAR as R, SPECIAL_VARIANTS as S, VARIANT_MAP as V, PropertyCategory as a, getVariantPrefix as b, getPropertyCategory as c, PROPERTY_CATEGORY_MAP as d, SUGGESTION_MAP as e, SzDepthError as f, getCSSVariableName as g, isForbiddenSzKey as h, isValidSzProp as i, normalizeArbitraryValue as j, normalizeArbitraryVariant as k, normalizeClassName as n, stripInvalidColorStrings as s, transform as t };
+export { BOOLEAN_SHORTHANDS as B, COLOR_PROPERTIES as C, KNOWN_VARIANTS as K, MAX_SZ_DEPTH as M, PROPERTY_MAP as P, REMOVED_BOOLEAN_SUGAR as R, SPECIAL_VARIANTS as S, VARIANT_MAP as V, PropertyCategory as a, getVariantPrefix as b, getPropertyCategory as c, stripInvalidColorStrings as d, PROPERTY_CATEGORY_MAP as e, formatSzWarnLocation as f, getCSSVariableName as g, SUGGESTION_MAP as h, isValidSzProp as i, SzDepthError as j, isForbiddenSzKey as k, normalizeArbitraryValue as l, normalizeArbitraryVariant as m, normalizeClassName as n, setSzWarnLocation as s, transform as t };

package/dist/shared/{compiler.BCOOXYBh.cjs → compiler.mibv6qPF.cjs}

@@ -1497,6 +1497,36 @@ function handleSupports(supportsObj, prefix) {
   return classes;
 }
 let szTransformDepth = 0;
+let szWarnLocation;
+let szHintedProjectScan = false;
+function hintProjectScanOnce(location) {
+  if (szHintedProjectScan || !location || process.env.CSSZYX_NO_PROJECT_SCAN_HINT === "1") {
+    return;
+  }
+  szHintedProjectScan = true;
+  console.warn(
+    "[csszyx] Tip: run `npx @csszyx/cli check` to scan every file for sz key issues at once (dev warnings only surface files as you open them)."
+  );
+}
+function setSzWarnLocation(location) {
+  szWarnLocation = location;
+}
+function formatSzWarnLocation(file, line, rootDir) {
+  let rel = file;
+  if (rootDir) {
+    let end = rootDir.length;
+    while (end > 0 && (rootDir[end - 1] === "/" || rootDir[end - 1] === "\\")) {
+      end--;
+    }
+    const root = rootDir.slice(0, end);
+    if (file === root) {
+      rel = file;
+    } else if (file.startsWith(`${root}/`) || file.startsWith(`${root}\\`)) {
+      rel = file.slice(root.length + 1);
+    }
+  }
+  return line === void 0 ? rel : `${rel}:${line}`;
+}
 function transform(szProp, prefix = "", mangleMap) {
   if (!szProp || typeof szProp !== "object") {
     return { className: "", attributes: {} };
@@ -2341,16 +2371,18 @@ function transformImpl(szProp, prefix, mangleMap) {
       KNOWN_VARIANTS.has(rawKey) || // Parametric/scope variants (group, peer, has, not, data, aria, supports)
       SPECIAL_VARIANTS.has(rawKey) || rawKey === "min" || rawKey === "max";
       if (!isKnown) {
+        const at = szWarnLocation ? ` at ${szWarnLocation}` : "";
         const suggestion = SUGGESTION_MAP[rawKey];
         if (suggestion) {
           console.warn(
-            `[csszyx] Use the canonical key "${suggestion}" instead of "${rawKey}".`
+            `[csszyx] Use the canonical key "${suggestion}" instead of "${rawKey}"${at}.`
           );
         } else {
           console.warn(
-            `[csszyx] Unknown property "${rawKey}" in sz prop. This will be ignored. Check for typos.`
+            `[csszyx] Unknown property "${rawKey}" in sz prop${at}. This will be ignored. Check for typos.`
           );
         }
+        hintProjectScanOnce(szWarnLocation);
       }
     }
     if (value === true) {
@@ -2479,6 +2511,7 @@ exports.SPECIAL_VARIANTS = SPECIAL_VARIANTS;
 exports.SUGGESTION_MAP = SUGGESTION_MAP;
 exports.SzDepthError = SzDepthError;
 exports.VARIANT_MAP = VARIANT_MAP;
+exports.formatSzWarnLocation = formatSzWarnLocation;
 exports.getCSSVariableName = getCSSVariableName;
 exports.getPropertyCategory = getPropertyCategory;
 exports.getVariantPrefix = getVariantPrefix;
@@ -2487,5 +2520,6 @@ exports.isValidSzProp = isValidSzProp;
 exports.normalizeArbitraryValue = normalizeArbitraryValue;
 exports.normalizeArbitraryVariant = normalizeArbitraryVariant;
 exports.normalizeClassName = normalizeClassName;
+exports.setSzWarnLocation = setSzWarnLocation;
 exports.stripInvalidColorStrings = stripInvalidColorStrings;
 exports.transform = transform;

package/dist/transform-core.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const transformCore = require('./shared/compiler.BCOOXYBh.cjs');
+const transformCore = require('./shared/compiler.mibv6qPF.cjs');
 
 
 
@@ -13,10 +13,12 @@ exports.SPECIAL_VARIANTS = transformCore.SPECIAL_VARIANTS;
 exports.SUGGESTION_MAP = transformCore.SUGGESTION_MAP;
 exports.SzDepthError = transformCore.SzDepthError;
 exports.VARIANT_MAP = transformCore.VARIANT_MAP;
+exports.formatSzWarnLocation = transformCore.formatSzWarnLocation;
 exports.getVariantPrefix = transformCore.getVariantPrefix;
 exports.isForbiddenSzKey = transformCore.isForbiddenSzKey;
 exports.isValidSzProp = transformCore.isValidSzProp;
 exports.normalizeArbitraryValue = transformCore.normalizeArbitraryValue;
 exports.normalizeArbitraryVariant = transformCore.normalizeArbitraryVariant;
 exports.normalizeClassName = transformCore.normalizeClassName;
+exports.setSzWarnLocation = transformCore.setSzWarnLocation;
 exports.transform = transformCore.transform;

package/dist/transform-core.d.cts

@@ -104,6 +104,28 @@ declare function normalizeArbitraryValue(value: string): string;
  * @returns the mapped or kebab-cased variant prefix
  */
 declare function getVariantPrefix(key: string): string;
+/**
+ * Set (or clear, with `undefined`) the source location appended to the dev-mode
+ * unknown-property warning. Called by the build engines (oxc/babel) around each
+ * sz attribute; a balanced clear MUST follow so the location never leaks to an
+ * unrelated later transform.
+ *
+ * @param location - `relativePath:line` (or `relativePath`) to attribute the
+ *   warning to, or `undefined` to clear.
+ */
+declare function setSzWarnLocation(location: string | undefined): void;
+/**
+ * Render a `relativePath:line` location string for the unknown-property warning,
+ * relative to the project root when one is known. Avoids a `node:path` dependency
+ * (this module is also browser-bundled) with a plain prefix strip — good enough
+ * for a human-facing diagnostic.
+ *
+ * @param file - the source filename (typically absolute, as the bundler gives it).
+ * @param line - 1-based line of the sz prop, or undefined to omit it.
+ * @param rootDir - project root to relativize against, or undefined to keep `file`.
+ * @returns `relativePath:line`, `relativePath`, or the raw filename.
+ */
+declare function formatSzWarnLocation(file: string, line: number | undefined, rootDir: string | undefined): string;
 /**
  * Transform an sz object into a className string plus any attributes, bounding
  * recursion depth via {@link szTransformDepth}.
@@ -129,5 +151,5 @@ declare function isValidSzProp(szProp: unknown): szProp is SzObject;
  */
 declare function normalizeClassName(className: string): string;
 
-export { BOOLEAN_SHORTHANDS, KNOWN_VARIANTS, MAX_SZ_DEPTH, PROPERTY_MAP, REMOVED_BOOLEAN_SUGAR, SPECIAL_VARIANTS, SUGGESTION_MAP, SzDepthError, VARIANT_MAP, getVariantPrefix, isForbiddenSzKey, isValidSzProp, normalizeArbitraryValue, normalizeArbitraryVariant, normalizeClassName, transform };
+export { BOOLEAN_SHORTHANDS, KNOWN_VARIANTS, MAX_SZ_DEPTH, PROPERTY_MAP, REMOVED_BOOLEAN_SUGAR, SPECIAL_VARIANTS, SUGGESTION_MAP, SzDepthError, VARIANT_MAP, formatSzWarnLocation, getVariantPrefix, isForbiddenSzKey, isValidSzProp, normalizeArbitraryValue, normalizeArbitraryVariant, normalizeClassName, setSzWarnLocation, transform };
 export type { ReadonlySzObject, ReadonlySzValue, SzObject, SzValue, TransformResult };

package/dist/transform-core.d.mts

@@ -104,6 +104,28 @@ declare function normalizeArbitraryValue(value: string): string;
  * @returns the mapped or kebab-cased variant prefix
  */
 declare function getVariantPrefix(key: string): string;
+/**
+ * Set (or clear, with `undefined`) the source location appended to the dev-mode
+ * unknown-property warning. Called by the build engines (oxc/babel) around each
+ * sz attribute; a balanced clear MUST follow so the location never leaks to an
+ * unrelated later transform.
+ *
+ * @param location - `relativePath:line` (or `relativePath`) to attribute the
+ *   warning to, or `undefined` to clear.
+ */
+declare function setSzWarnLocation(location: string | undefined): void;
+/**
+ * Render a `relativePath:line` location string for the unknown-property warning,
+ * relative to the project root when one is known. Avoids a `node:path` dependency
+ * (this module is also browser-bundled) with a plain prefix strip — good enough
+ * for a human-facing diagnostic.
+ *
+ * @param file - the source filename (typically absolute, as the bundler gives it).
+ * @param line - 1-based line of the sz prop, or undefined to omit it.
+ * @param rootDir - project root to relativize against, or undefined to keep `file`.
+ * @returns `relativePath:line`, `relativePath`, or the raw filename.
+ */
+declare function formatSzWarnLocation(file: string, line: number | undefined, rootDir: string | undefined): string;
 /**
  * Transform an sz object into a className string plus any attributes, bounding
  * recursion depth via {@link szTransformDepth}.
@@ -129,5 +151,5 @@ declare function isValidSzProp(szProp: unknown): szProp is SzObject;
  */
 declare function normalizeClassName(className: string): string;
 
-export { BOOLEAN_SHORTHANDS, KNOWN_VARIANTS, MAX_SZ_DEPTH, PROPERTY_MAP, REMOVED_BOOLEAN_SUGAR, SPECIAL_VARIANTS, SUGGESTION_MAP, SzDepthError, VARIANT_MAP, getVariantPrefix, isForbiddenSzKey, isValidSzProp, normalizeArbitraryValue, normalizeArbitraryVariant, normalizeClassName, transform };
+export { BOOLEAN_SHORTHANDS, KNOWN_VARIANTS, MAX_SZ_DEPTH, PROPERTY_MAP, REMOVED_BOOLEAN_SUGAR, SPECIAL_VARIANTS, SUGGESTION_MAP, SzDepthError, VARIANT_MAP, formatSzWarnLocation, getVariantPrefix, isForbiddenSzKey, isValidSzProp, normalizeArbitraryValue, normalizeArbitraryVariant, normalizeClassName, setSzWarnLocation, transform };
 export type { ReadonlySzObject, ReadonlySzValue, SzObject, SzValue, TransformResult };

package/dist/transform-core.mjs

@@ -1 +1 @@
-export { B as BOOLEAN_SHORTHANDS, K as KNOWN_VARIANTS, M as MAX_SZ_DEPTH, P as PROPERTY_MAP, R as REMOVED_BOOLEAN_SUGAR, S as SPECIAL_VARIANTS, e as SUGGESTION_MAP, f as SzDepthError, V as VARIANT_MAP, b as getVariantPrefix, h as isForbiddenSzKey, i as isValidSzProp, j as normalizeArbitraryValue, k as normalizeArbitraryVariant, n as normalizeClassName, t as transform } from './shared/compiler.DGInsDP8.mjs';
+export { B as BOOLEAN_SHORTHANDS, K as KNOWN_VARIANTS, M as MAX_SZ_DEPTH, P as PROPERTY_MAP, R as REMOVED_BOOLEAN_SUGAR, S as SPECIAL_VARIANTS, h as SUGGESTION_MAP, j as SzDepthError, V as VARIANT_MAP, f as formatSzWarnLocation, b as getVariantPrefix, k as isForbiddenSzKey, i as isValidSzProp, l as normalizeArbitraryValue, m as normalizeArbitraryVariant, n as normalizeClassName, s as setSzWarnLocation, t as transform } from './shared/compiler.CghwJ6p5.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/compiler",
-  "version": "0.10.6",
+  "version": "0.10.8",
   "description": "Core compiler and transformation logic for csszyx",
   "keywords": [
     "csszyx",
@@ -65,7 +65,7 @@
     "@babel/types": "^7.23.6",
     "magic-string": "0.30.21",
     "oxc-parser": "0.131.0",
-    "@csszyx/core": "0.10.6"
+    "@csszyx/core": "0.10.8"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",