@csszyx/runtime 0.10.4 → 0.10.6

package/dist/index.cjs

@@ -334,6 +334,7 @@ function transform(szProp) {
 function _sz(...classes) {
   return szJoin(classes, 0);
 }
+const szr = _sz;
 function szJoin(classes, depth) {
   if (depth >= browser.MAX_SZ_DEPTH) {
     throw new browser.SzDepthError();
@@ -1332,7 +1333,12 @@ const AMBIGUOUS_PREFIXES = /* @__PURE__ */ new Set([
 function decodeToken(token) {
   const decode = globalThis.__csszyx?.decode;
   if (typeof decode === "function") {
-    return decode(token) ?? token;
+    try {
+      const decoded = decode(token);
+      return typeof decoded === "string" ? decoded : token;
+    } catch {
+      return token;
+    }
   }
   return token;
 }
@@ -1672,6 +1678,7 @@ exports.splitBoxSz = splitBoxSz;
 exports.startHydration = startHydration;
 exports.stripSzProps = stripSzProps;
 exports.szcn = szcn;
+exports.szr = szr;
 exports.szv = szv;
 exports.validateHydrationClass = validateHydrationClass;
 exports.verifyAllTokens = verifyAllTokens;

package/dist/index.d.cts

@@ -43,6 +43,30 @@ type SzInput = string | SzObject | SzInput[] | null | undefined | false;
  * ```
  */
 declare function _sz(...classes: SzInput[]): string;
+/**
+ * Resolve sz object(s) and/or class strings into a single className string,
+ * mangle-aware. This is the PUBLIC, hand-written name for the otherwise
+ * compiler-injected `_sz` helper (the `_` prefix marks compiler-generated code
+ * you should not hand-author; `szr` is the one you call by hand).
+ *
+ * Reach for `szr` when you build a className from `szv` factory output or sz
+ * objects — e.g. a split/layered design system that declares variants in a
+ * module and resolves them at the leaf:
+ *
+ * ```ts
+ * import { szr, szv } from '@csszyx/runtime';
+ * const cardSz = szv({ variants: { pad: { lg: { p: 8 } } } });
+ * const cls = szr(cardSz({ pad: 'lg' }), isWide && stackSz({ gap: 'xl' }));
+ * ```
+ *
+ * Falsy inputs are skipped (clsx-style). `szr` CONCATENATES (keeps every class);
+ * to combine with last-wins OVERRIDE on a same-utility conflict, use `szcn`.
+ * `szr` accepts sz OBJECTS; `szcn` accepts className STRINGS.
+ *
+ * @param classes - sz objects, class strings, or falsy values (skipped).
+ * @returns The resolved className string (mangled in a production build).
+ */
+declare const szr: (...classes: SzInput[]) => string;
 /**
  * Merges className strings, removing duplicates.
  *
@@ -961,5 +985,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, szcn, 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, szr, 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

@@ -43,6 +43,30 @@ type SzInput = string | SzObject | SzInput[] | null | undefined | false;
  * ```
  */
 declare function _sz(...classes: SzInput[]): string;
+/**
+ * Resolve sz object(s) and/or class strings into a single className string,
+ * mangle-aware. This is the PUBLIC, hand-written name for the otherwise
+ * compiler-injected `_sz` helper (the `_` prefix marks compiler-generated code
+ * you should not hand-author; `szr` is the one you call by hand).
+ *
+ * Reach for `szr` when you build a className from `szv` factory output or sz
+ * objects — e.g. a split/layered design system that declares variants in a
+ * module and resolves them at the leaf:
+ *
+ * ```ts
+ * import { szr, szv } from '@csszyx/runtime';
+ * const cardSz = szv({ variants: { pad: { lg: { p: 8 } } } });
+ * const cls = szr(cardSz({ pad: 'lg' }), isWide && stackSz({ gap: 'xl' }));
+ * ```
+ *
+ * Falsy inputs are skipped (clsx-style). `szr` CONCATENATES (keeps every class);
+ * to combine with last-wins OVERRIDE on a same-utility conflict, use `szcn`.
+ * `szr` accepts sz OBJECTS; `szcn` accepts className STRINGS.
+ *
+ * @param classes - sz objects, class strings, or falsy values (skipped).
+ * @returns The resolved className string (mangled in a production build).
+ */
+declare const szr: (...classes: SzInput[]) => string;
 /**
  * Merges className strings, removing duplicates.
  *
@@ -961,5 +985,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, szcn, 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, szr, 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

@@ -332,6 +332,7 @@ function transform(szProp) {
 function _sz(...classes) {
   return szJoin(classes, 0);
 }
+const szr = _sz;
 function szJoin(classes, depth) {
   if (depth >= MAX_SZ_DEPTH) {
     throw new SzDepthError();
@@ -1330,7 +1331,12 @@ const AMBIGUOUS_PREFIXES = /* @__PURE__ */ new Set([
 function decodeToken(token) {
   const decode = globalThis.__csszyx?.decode;
   if (typeof decode === "function") {
-    return decode(token) ?? token;
+    try {
+      const decoded = decode(token);
+      return typeof decoded === "string" ? decoded : token;
+    } catch {
+      return token;
+    }
   }
   return token;
 }
@@ -1625,4 +1631,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, szcn, 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, szr, szv, validateHydrationClass, verifyAllTokens, verifyMangleChecksum, verifyMangleChecksumAsync, verifyMangleMapIntegrity, verifyRecoveryToken };

package/package.json

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