@csszyx/runtime 0.10.2 → 0.10.3

package/dist/index.cjs

@@ -1313,6 +1313,75 @@ function omitSz(sz, selector) {
   return filterSz(flattenSz(sz, 0), selector, false, 0);
 }
 
+const AMBIGUOUS_PREFIXES = /* @__PURE__ */ new Set([
+  "flex",
+  // flex-1 (flex shorthand) vs flex-row (flex-direction)
+  "text",
+  // text-sm (font-size) vs text-red-500 (color)
+  "bg",
+  // bg-red-500 (color) vs bg-cover (size) vs bg-center (position)
+  "border",
+  // border-2 (width) vs border-red-500 (color) vs border-solid (style)
+  "divide",
+  // divide-x (width) vs divide-red-500 (color)
+  "ring",
+  // ring-2 (width) vs ring-red-500 (color)
+  "outline"
+  // outline-2 (width) vs outline-red-500 (color)
+]);
+function decodeToken(token) {
+  const decode = globalThis.__csszyx?.decode;
+  if (typeof decode === "function") {
+    return decode(token) ?? token;
+  }
+  return token;
+}
+function conflictKey(token) {
+  const base = stripVariant(token);
+  const variant = token.slice(0, token.length - base.length);
+  const norm = normalizeBase(base);
+  if (!norm) {
+    return null;
+  }
+  if (BOX_ROLE_TOKENS.has(norm)) {
+    return null;
+  }
+  for (const [prefix] of BOX_ROLE_PREFIXES) {
+    if (norm === prefix || norm.startsWith(`${prefix}-`)) {
+      if (AMBIGUOUS_PREFIXES.has(prefix)) {
+        return null;
+      }
+      return `${variant}\0${prefix}`;
+    }
+  }
+  return null;
+}
+function szcn(...inputs) {
+  const order = [];
+  const byKey = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    if (!input || typeof input !== "string") {
+      continue;
+    }
+    for (const token of input.split(/\s+/)) {
+      if (!token) {
+        continue;
+      }
+      const original = decodeToken(token);
+      const key = conflictKey(original) ?? `
${original}`;
+      if (byKey.has(key)) {
+        const at = order.indexOf(key);
+        if (at !== -1) {
+          order.splice(at, 1);
+        }
+      }
+      byKey.set(key, token);
+      order.push(key);
+    }
+  }
+  return order.map((key) => byKey.get(key)).join(" ");
+}
+
 const warned$1 = /* @__PURE__ */ new Set();
 const RAW_SZ_WARNING = '[csszyx] A raw `sz` object reached the runtime and was dropped before it could leak to the DOM as sz="[object Object]".\nThis means the file was not compiled \u2014 its `sz` produces no CSS. If it lives in a workspace package, add that package to `compilePackages`; otherwise check that the bundler is not skipping the file.';
 function warnRawSz() {
@@ -1567,6 +1636,7 @@ exports.splitBox = splitBox;
 exports.splitBoxSz = splitBoxSz;
 exports.startHydration = startHydration;
 exports.stripSzProps = stripSzProps;
+exports.szcn = szcn;
 exports.szv = szv;
 exports.validateHydrationClass = validateHydrationClass;
 exports.verifyAllTokens = verifyAllTokens;

package/dist/index.d.cts

@@ -598,6 +598,20 @@ declare function startHydration(): void;
  */
 declare function endHydration(): void;
 
+/**
+ * Merge className strings with last-wins override per utility, mangle-aware.
+ *
+ * Intended for the single resolution point in a layered design-system component
+ * (typically at the leaf Box): combine the component's default classes with the
+ * forwarded override so the override wins on a same-utility collision, while
+ * keeping production mangling intact (unlike npm tailwind-merge).
+ *
+ * @param inputs - Class strings; falsy inputs (`false`/`null`/`undefined`/`''`) are skipped.
+ * @returns The merged className string.
+ * @example szcn('gap-2 p-4', 'gap-8') // → 'p-4 gap-8'  (gap-8 overrides gap-2)
+ */
+declare function szcn(...inputs: (string | false | null | undefined)[]): string;
+
 /** Which side of the CSS box-model border a property acts on. */
 type BoxRole = 'outer' | 'inner';
 
@@ -947,5 +961,5 @@ declare function isRuntimeInitialized(): boolean;
  */
 declare function resetRuntime(): void;
 
-export { DEFAULT_RUNTIME_CONFIG, VERSION, _sz, _sz2, _sz3, _szMerge, abortHydration, attemptCSRRecovery, classify, classifySzKey, clearHydrationErrors, computeMangleChecksumAsync, disableCSRRecovery, enableCSRRecovery, endHydration, getAbortedSubtreeCount, getHydrationErrors, getRecoveryMode, getRuntimeConfig, getSSRContext, guardHydration, has, hasRecoveryToken, hasSz, initRuntime, isCSRRecoveryAllowed, isHydrating, isHydrationAborted, isRuntimeInitialized, isSSREnvironment, isValidMangleMap, isValidManifest, loadMangleMapFromDOM, loadManifestFromDOM, omit, omitSz, pick, pickSz, resetRuntime, splitBox, splitBoxSz, startHydration, stripSzProps, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };
+export { DEFAULT_RUNTIME_CONFIG, VERSION, _sz, _sz2, _sz3, _szMerge, abortHydration, attemptCSRRecovery, classify, classifySzKey, clearHydrationErrors, computeMangleChecksumAsync, disableCSRRecovery, enableCSRRecovery, endHydration, getAbortedSubtreeCount, getHydrationErrors, getRecoveryMode, getRuntimeConfig, getSSRContext, guardHydration, has, hasRecoveryToken, hasSz, initRuntime, isCSRRecoveryAllowed, isHydrating, isHydrationAborted, isRuntimeInitialized, isSSREnvironment, isValidMangleMap, isValidManifest, loadMangleMapFromDOM, loadManifestFromDOM, omit, omitSz, pick, pickSz, resetRuntime, splitBox, splitBoxSz, startHydration, stripSzProps, szcn, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };
 export type { BoxRole, BoxSelector, Classification, HydrationError, HydrationErrorType, MangleMap, RecoveryManifest, RecoveryMode, RuntimeConfig, SSRContext, SplitBoxOptions, SplitBoxResult, SplitBoxSzOptions, SplitBoxSzResult, SzInput, TokenData, VerificationResult };

package/dist/index.d.mts

@@ -598,6 +598,20 @@ declare function startHydration(): void;
  */
 declare function endHydration(): void;
 
+/**
+ * Merge className strings with last-wins override per utility, mangle-aware.
+ *
+ * Intended for the single resolution point in a layered design-system component
+ * (typically at the leaf Box): combine the component's default classes with the
+ * forwarded override so the override wins on a same-utility collision, while
+ * keeping production mangling intact (unlike npm tailwind-merge).
+ *
+ * @param inputs - Class strings; falsy inputs (`false`/`null`/`undefined`/`''`) are skipped.
+ * @returns The merged className string.
+ * @example szcn('gap-2 p-4', 'gap-8') // → 'p-4 gap-8'  (gap-8 overrides gap-2)
+ */
+declare function szcn(...inputs: (string | false | null | undefined)[]): string;
+
 /** Which side of the CSS box-model border a property acts on. */
 type BoxRole = 'outer' | 'inner';
 
@@ -947,5 +961,5 @@ declare function isRuntimeInitialized(): boolean;
  */
 declare function resetRuntime(): void;
 
-export { DEFAULT_RUNTIME_CONFIG, VERSION, _sz, _sz2, _sz3, _szMerge, abortHydration, attemptCSRRecovery, classify, classifySzKey, clearHydrationErrors, computeMangleChecksumAsync, disableCSRRecovery, enableCSRRecovery, endHydration, getAbortedSubtreeCount, getHydrationErrors, getRecoveryMode, getRuntimeConfig, getSSRContext, guardHydration, has, hasRecoveryToken, hasSz, initRuntime, isCSRRecoveryAllowed, isHydrating, isHydrationAborted, isRuntimeInitialized, isSSREnvironment, isValidMangleMap, isValidManifest, loadMangleMapFromDOM, loadManifestFromDOM, omit, omitSz, pick, pickSz, resetRuntime, splitBox, splitBoxSz, startHydration, stripSzProps, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };
+export { DEFAULT_RUNTIME_CONFIG, VERSION, _sz, _sz2, _sz3, _szMerge, abortHydration, attemptCSRRecovery, classify, classifySzKey, clearHydrationErrors, computeMangleChecksumAsync, disableCSRRecovery, enableCSRRecovery, endHydration, getAbortedSubtreeCount, getHydrationErrors, getRecoveryMode, getRuntimeConfig, getSSRContext, guardHydration, has, hasRecoveryToken, hasSz, initRuntime, isCSRRecoveryAllowed, isHydrating, isHydrationAborted, isRuntimeInitialized, isSSREnvironment, isValidMangleMap, isValidManifest, loadMangleMapFromDOM, loadManifestFromDOM, omit, omitSz, pick, pickSz, resetRuntime, splitBox, splitBoxSz, startHydration, stripSzProps, szcn, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };
 export type { BoxRole, BoxSelector, Classification, HydrationError, HydrationErrorType, MangleMap, RecoveryManifest, RecoveryMode, RuntimeConfig, SSRContext, SplitBoxOptions, SplitBoxResult, SplitBoxSzOptions, SplitBoxSzResult, SzInput, TokenData, VerificationResult };

package/dist/index.mjs

@@ -1311,6 +1311,75 @@ function omitSz(sz, selector) {
   return filterSz(flattenSz(sz, 0), selector, false, 0);
 }
 
+const AMBIGUOUS_PREFIXES = /* @__PURE__ */ new Set([
+  "flex",
+  // flex-1 (flex shorthand) vs flex-row (flex-direction)
+  "text",
+  // text-sm (font-size) vs text-red-500 (color)
+  "bg",
+  // bg-red-500 (color) vs bg-cover (size) vs bg-center (position)
+  "border",
+  // border-2 (width) vs border-red-500 (color) vs border-solid (style)
+  "divide",
+  // divide-x (width) vs divide-red-500 (color)
+  "ring",
+  // ring-2 (width) vs ring-red-500 (color)
+  "outline"
+  // outline-2 (width) vs outline-red-500 (color)
+]);
+function decodeToken(token) {
+  const decode = globalThis.__csszyx?.decode;
+  if (typeof decode === "function") {
+    return decode(token) ?? token;
+  }
+  return token;
+}
+function conflictKey(token) {
+  const base = stripVariant(token);
+  const variant = token.slice(0, token.length - base.length);
+  const norm = normalizeBase(base);
+  if (!norm) {
+    return null;
+  }
+  if (BOX_ROLE_TOKENS.has(norm)) {
+    return null;
+  }
+  for (const [prefix] of BOX_ROLE_PREFIXES) {
+    if (norm === prefix || norm.startsWith(`${prefix}-`)) {
+      if (AMBIGUOUS_PREFIXES.has(prefix)) {
+        return null;
+      }
+      return `${variant}\0${prefix}`;
+    }
+  }
+  return null;
+}
+function szcn(...inputs) {
+  const order = [];
+  const byKey = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    if (!input || typeof input !== "string") {
+      continue;
+    }
+    for (const token of input.split(/\s+/)) {
+      if (!token) {
+        continue;
+      }
+      const original = decodeToken(token);
+      const key = conflictKey(original) ?? `
${original}`;
+      if (byKey.has(key)) {
+        const at = order.indexOf(key);
+        if (at !== -1) {
+          order.splice(at, 1);
+        }
+      }
+      byKey.set(key, token);
+      order.push(key);
+    }
+  }
+  return order.map((key) => byKey.get(key)).join(" ");
+}
+
 const warned$1 = /* @__PURE__ */ new Set();
 const RAW_SZ_WARNING = '[csszyx] A raw `sz` object reached the runtime and was dropped before it could leak to the DOM as sz="[object Object]".\nThis means the file was not compiled \u2014 its `sz` produces no CSS. If it lives in a workspace package, add that package to `compilePackages`; otherwise check that the bundler is not skipping the file.';
 function warnRawSz() {
@@ -1521,4 +1590,4 @@ function resetRuntime() {
   runtimeState.initialized = false;
 }
 
-export { DEFAULT_RUNTIME_CONFIG, VERSION, _sz, _sz2, _sz3, _szMerge, abortHydration, attemptCSRRecovery, classify, classifySzKey, clearHydrationErrors, computeMangleChecksumAsync, disableCSRRecovery, enableCSRRecovery, endHydration, getAbortedSubtreeCount, getHydrationErrors, getRecoveryMode, getRuntimeConfig, getSSRContext, guardHydration, has, hasRecoveryToken, hasSz, initRuntime, isCSRRecoveryAllowed, isHydrating, isHydrationAborted, isRuntimeInitialized, isSSREnvironment, isValidMangleMap, isValidManifest, loadMangleMapFromDOM, loadManifestFromDOM, omit, omitSz, pick, pickSz, resetRuntime, splitBox, splitBoxSz, startHydration, stripSzProps, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };
+export { DEFAULT_RUNTIME_CONFIG, VERSION, _sz, _sz2, _sz3, _szMerge, abortHydration, attemptCSRRecovery, classify, classifySzKey, clearHydrationErrors, computeMangleChecksumAsync, disableCSRRecovery, enableCSRRecovery, endHydration, getAbortedSubtreeCount, getHydrationErrors, getRecoveryMode, getRuntimeConfig, getSSRContext, guardHydration, has, hasRecoveryToken, hasSz, initRuntime, isCSRRecoveryAllowed, isHydrating, isHydrationAborted, isRuntimeInitialized, isSSREnvironment, isValidMangleMap, isValidManifest, loadMangleMapFromDOM, loadManifestFromDOM, omit, omitSz, pick, pickSz, resetRuntime, splitBox, splitBoxSz, startHydration, stripSzProps, szcn, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/runtime",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Runtime helpers and hydration guards for csszyx",
   "keywords": [
     "csszyx",
@@ -49,8 +49,8 @@
     "dist"
   ],
   "dependencies": {
-    "@csszyx/compiler": "0.10.2",
-    "@csszyx/core": "0.10.2"
+    "@csszyx/compiler": "0.10.3",
+    "@csszyx/core": "0.10.3"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",