@csszyx/runtime 0.10.7 → 0.10.9

package/dist/index.cjs

@@ -3,6 +3,10 @@
 const browser = require('@csszyx/compiler/browser');
 const colorVar = require('@csszyx/compiler/color-var');
 
+function sortStrings(values) {
+  return [...values].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+}
+
 function verifyRecoveryToken(element, manifest) {
   const token = element.getAttribute("data-sz-recovery-token");
   if (!token) {
@@ -145,7 +149,7 @@ function verifyMangleChecksum(expectedChecksum) {
   return actualChecksum === expectedChecksum;
 }
 async function computeMangleChecksumAsync(map) {
-  const canonical = Object.keys(map).sort().map((key) => `${key}:${map[key]}`).join("|");
+  const canonical = sortStrings(Object.keys(map)).map((key) => `${key}:${map[key]}`).join("|");
   const bytes = new TextEncoder().encode(canonical);
   const digest = await crypto.subtle.digest("SHA-256", bytes);
   let hex = "";
@@ -298,7 +302,7 @@ function getSSRContext() {
   };
 }
 function validateHydrationClass(className, expectedClassName) {
-  const normalize = (s) => s.split(/\s+/).filter(Boolean).sort().join(" ");
+  const normalize = (s) => sortStrings(s.split(/\s+/).filter(Boolean)).join(" ");
   return normalize(className) === normalize(expectedClassName);
 }
 function startHydration() {

package/dist/index.d.cts

@@ -11,11 +11,18 @@ export { __szColorVar } from '@csszyx/compiler/color-var';
  *
  * @module @csszyx/runtime/concatenate
  */
-
 /**
- * Type for sz input - can be a pre-compiled string, SzObject, or recursive array.
+ * Type for sz input — a pre-compiled class string, an sz object, a recursive
+ * array of those, or a falsy guard (skipped).
+ *
+ * The object member is the broad `object` rather than `SzObject` so that a
+ * precise `SzProps` / `SzPropValue` value (the type the JSX augmentation gives
+ * `sz` on a host element) forwards into the runtime helpers without a cast: a
+ * named type with specific keys is assignable to `object`, but not to
+ * `SzObject`'s `{ [k: string]: SzValue }` index signature. The runtime lowers the
+ * keys it recognizes and ignores the rest, so the looser input type is sound.
  */
-type SzInput = string | SzObject | SzInput[] | null | undefined | false;
+type SzInput = string | object | SzInput[] | null | undefined | false;
 /**
  * Zero-overhead className passthrough/concatenation helper.
  *

package/dist/index.d.mts

@@ -11,11 +11,18 @@ export { __szColorVar } from '@csszyx/compiler/color-var';
  *
  * @module @csszyx/runtime/concatenate
  */
-
 /**
- * Type for sz input - can be a pre-compiled string, SzObject, or recursive array.
+ * Type for sz input — a pre-compiled class string, an sz object, a recursive
+ * array of those, or a falsy guard (skipped).
+ *
+ * The object member is the broad `object` rather than `SzObject` so that a
+ * precise `SzProps` / `SzPropValue` value (the type the JSX augmentation gives
+ * `sz` on a host element) forwards into the runtime helpers without a cast: a
+ * named type with specific keys is assignable to `object`, but not to
+ * `SzObject`'s `{ [k: string]: SzValue }` index signature. The runtime lowers the
+ * keys it recognizes and ignores the rest, so the looser input type is sound.
  */
-type SzInput = string | SzObject | SzInput[] | null | undefined | false;
+type SzInput = string | object | SzInput[] | null | undefined | false;
 /**
  * Zero-overhead className passthrough/concatenation helper.
  *

package/dist/index.mjs

@@ -1,6 +1,10 @@
 import { MAX_SZ_DEPTH, SzDepthError, transform as transform$1, isForbiddenSzKey } from '@csszyx/compiler/browser';
 export { __szColorVar } from '@csszyx/compiler/color-var';
 
+function sortStrings(values) {
+  return [...values].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+}
+
 function verifyRecoveryToken(element, manifest) {
   const token = element.getAttribute("data-sz-recovery-token");
   if (!token) {
@@ -143,7 +147,7 @@ function verifyMangleChecksum(expectedChecksum) {
   return actualChecksum === expectedChecksum;
 }
 async function computeMangleChecksumAsync(map) {
-  const canonical = Object.keys(map).sort().map((key) => `${key}:${map[key]}`).join("|");
+  const canonical = sortStrings(Object.keys(map)).map((key) => `${key}:${map[key]}`).join("|");
   const bytes = new TextEncoder().encode(canonical);
   const digest = await crypto.subtle.digest("SHA-256", bytes);
   let hex = "";
@@ -296,7 +300,7 @@ function getSSRContext() {
   };
 }
 function validateHydrationClass(className, expectedClassName) {
-  const normalize = (s) => s.split(/\s+/).filter(Boolean).sort().join(" ");
+  const normalize = (s) => sortStrings(s.split(/\s+/).filter(Boolean)).join(" ");
   return normalize(className) === normalize(expectedClassName);
 }
 function startHydration() {

package/dist/lite.d.cts

@@ -16,13 +16,22 @@ export { __szColorVar } from '@csszyx/compiler/color-var';
  */
 
 /**
- * Type for sz input - string-only (objects are pre-compiled at build time).
+ * Input to the lite runtime helpers: a pre-compiled class string or a falsy
+ * guard (skipped). The lite path has no compiler, so it never accepts objects —
+ * unlike the full `SzInput` from `@csszyx/runtime`, which also takes sz objects.
+ * Named distinctly so the two do not look interchangeable.
  */
-type SzInput = string | null | undefined | false;
+type SzStringInput = string | null | undefined | false;
+/**
+ * @deprecated Renamed to {@link SzStringInput} — the lite helpers accept only
+ * pre-compiled class strings, and the bare name collided with the object-accepting
+ * `SzInput` from `@csszyx/runtime`. This alias is kept for back-compat.
+ */
+type SzInput = SzStringInput;
 /**
  * Zero-overhead className passthrough/concatenation.
  *
- * @param {...SzInput[]} classes - Class names to concatenate
+ * @param {...SzStringInput[]} classes - Class names to concatenate
  * @returns {string} Combined className string
  *
  * @example
@@ -31,7 +40,7 @@ type SzInput = string | null | undefined | false;
  * _sz('base', isActive && 'active') // conditional
  * ```
  */
-declare function _sz(...classes: SzInput[]): string;
+declare function _sz(...classes: SzStringInput[]): string;
 /**
  * Merges className strings from compiled array sz props, deduplicating tokens.
  *
@@ -39,10 +48,10 @@ declare function _sz(...classes: SzInput[]): string;
  * element is a runtime conditional. All arguments must be pre-compiled strings
  * (the compiler resolves each element to a string before passing it here).
  *
- * @param {...SzInput[]} classes - Pre-compiled class strings to merge
+ * @param {...SzStringInput[]} classes - Pre-compiled class strings to merge
  * @returns {string} Merged className string with duplicate tokens removed
  */
-declare function _szMerge(...classes: SzInput[]): string;
+declare function _szMerge(...classes: SzStringInput[]): string;
 /**
  * Two-argument optimized concatenation.
  * @param a - first class string
@@ -52,4 +61,4 @@ declare function _szMerge(...classes: SzInput[]): string;
 declare function _sz2(a: string, b: string): string;
 
 export { _sz, _sz2, _szMerge };
-export type { SzInput };
+export type { SzInput, SzStringInput };

package/dist/lite.d.mts

@@ -16,13 +16,22 @@ export { __szColorVar } from '@csszyx/compiler/color-var';
  */
 
 /**
- * Type for sz input - string-only (objects are pre-compiled at build time).
+ * Input to the lite runtime helpers: a pre-compiled class string or a falsy
+ * guard (skipped). The lite path has no compiler, so it never accepts objects —
+ * unlike the full `SzInput` from `@csszyx/runtime`, which also takes sz objects.
+ * Named distinctly so the two do not look interchangeable.
  */
-type SzInput = string | null | undefined | false;
+type SzStringInput = string | null | undefined | false;
+/**
+ * @deprecated Renamed to {@link SzStringInput} — the lite helpers accept only
+ * pre-compiled class strings, and the bare name collided with the object-accepting
+ * `SzInput` from `@csszyx/runtime`. This alias is kept for back-compat.
+ */
+type SzInput = SzStringInput;
 /**
  * Zero-overhead className passthrough/concatenation.
  *
- * @param {...SzInput[]} classes - Class names to concatenate
+ * @param {...SzStringInput[]} classes - Class names to concatenate
  * @returns {string} Combined className string
  *
  * @example
@@ -31,7 +40,7 @@ type SzInput = string | null | undefined | false;
  * _sz('base', isActive && 'active') // conditional
  * ```
  */
-declare function _sz(...classes: SzInput[]): string;
+declare function _sz(...classes: SzStringInput[]): string;
 /**
  * Merges className strings from compiled array sz props, deduplicating tokens.
  *
@@ -39,10 +48,10 @@ declare function _sz(...classes: SzInput[]): string;
  * element is a runtime conditional. All arguments must be pre-compiled strings
  * (the compiler resolves each element to a string before passing it here).
  *
- * @param {...SzInput[]} classes - Pre-compiled class strings to merge
+ * @param {...SzStringInput[]} classes - Pre-compiled class strings to merge
  * @returns {string} Merged className string with duplicate tokens removed
  */
-declare function _szMerge(...classes: SzInput[]): string;
+declare function _szMerge(...classes: SzStringInput[]): string;
 /**
  * Two-argument optimized concatenation.
  * @param a - first class string
@@ -52,4 +61,4 @@ declare function _szMerge(...classes: SzInput[]): string;
 declare function _sz2(a: string, b: string): string;
 
 export { _sz, _sz2, _szMerge };
-export type { SzInput };
+export type { SzInput, SzStringInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/runtime",
-  "version": "0.10.7",
+  "version": "0.10.9",
   "description": "Runtime helpers and hydration guards for csszyx",
   "keywords": [
     "csszyx",
@@ -49,15 +49,15 @@
     "dist"
   ],
   "dependencies": {
-    "@csszyx/compiler": "0.10.7",
-    "@csszyx/core": "0.10.7"
+    "@csszyx/compiler": "0.10.9",
+    "@csszyx/core": "0.10.9"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
     "jsdom": "^23.0.0",
     "typescript": "^6.0.3",
     "vite-plugin-wasm": "^3.3.0",
-    "vitest": "^4.1.6",
+    "vitest": "^4.1.9",
     "unbuild": "^3.6.1"
   },
   "optionalDependencies": {