@csszyx/runtime 0.10.7 → 0.10.8

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/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.8",
   "description": "Runtime helpers and hydration guards for csszyx",
   "keywords": [
     "csszyx",
@@ -49,8 +49,8 @@
     "dist"
   ],
   "dependencies": {
-    "@csszyx/compiler": "0.10.7",
-    "@csszyx/core": "0.10.7"
+    "@csszyx/compiler": "0.10.8",
+    "@csszyx/core": "0.10.8"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",