@yahoo/uds-v5-wip 1.59.0 → 1.61.0

package/dist/config/dist/className.js

@@ -0,0 +1,77 @@
+//#region ../config/dist/className.js
+/**
+* **NEW-API ONLY** — shared utility-class derivation for
+* `defineComponent`-authored components.
+*
+* Single source of truth for `(prop, value, styleProp) → class`.
+* Consumed by:
+*
+*   - `bindRender.ts` (runtime) — emits the per-layer className
+*     bundle as JSX renders.
+*   - `getStylesForConfig.ts` (build-time) — derives the same
+*     className list for the CSS scanner's safelist so the purger
+*     keeps every class the runtime can produce.
+*
+* Both paths MUST agree on the className shape. Centralising the
+* derivation here is the contract: any change to the convention
+* (e.g. boolean-alias handling) updates one place and both paths
+* stay in lockstep.
+*
+* Does NOT touch the legacy `@uds/core`'s `getStyles` /
+* `propMappings` — that's the legacy `createComponent` factory's
+* world and lives in a different package.
+*/
+/**
+* Convert a token name to its class-name-safe form. Mirrors
+* `safeTokenName` from `@uds/utils`: `.` → `_`, `/` → `-`. Inlined
+* to keep `@uds/config` free of a cross-package import for a one-line
+* transform.
+*
+*     toSafeTokenName('1.5')          // → '1_5'
+*     toSafeTokenName('always/black') // → 'always-black'
+*     toSafeTokenName('brand')        // → 'brand'
+*/
+function toSafeTokenName(value) {
+	return value.replace(/\./g, "_").replace(/\//g, "-");
+}
+/**
+* Build the utility-class name a style prop emits for a given
+* JSX-level value. Mirrors the codegen convention in
+* `prepareCss.ts`'s @utility emission:
+*
+*   - `classPrefix === ''` — the value IS the class (e.g.
+*     `<Box display="block">` → `.block`).
+*   - Boolean `true` — the class IS the bare `classPrefix`
+*     (`<Box border>` / `<Box border={true}>` → `.border`, never
+*     `.border-true`). Falsy (`undefined` / `null` / `false`) →
+*     `undefined`, so the caller omits the class entirely. The "no
+*     border" state is the default; adding a class to undo one that
+*     was never applied is pointless.
+*   - Bracketed arbitrary values (`'[#abc]'`, `'[100px]'`) keep
+*     their brackets verbatim: `bg-[#abc]`, `w-[100px]`.
+*   - Otherwise: `${classPrefix}-${safeTokenName(value)}`. Authors
+*     write the original token name (`'1.5'`); the @utility block
+*     is keyed by the class-name-safe form (`'1_5'`), so apply the
+*     conversion at emit time. Bracketed arbitrary values are left
+*     alone — Tailwind's wildcard utility expansion expects them
+*     verbatim.
+*
+* Returns `undefined` when no class should be emitted — callers
+* skip the contribution rather than push a malformed token.
+*/
+function buildStylePropClassName(styleProp, value) {
+	if (value === void 0 || value === null || value === false) return void 0;
+	if (value === true) return styleProp.classPrefix || void 0;
+	let stringValue = String(value);
+	if (stringValue.startsWith("{") && stringValue.endsWith("}")) {
+		const inner = stringValue.slice(1, -1);
+		const slash = inner.lastIndexOf("/");
+		stringValue = slash >= 0 ? inner.slice(slash + 1) : inner;
+	}
+	const isNoPrefix = styleProp.classPrefix === "";
+	const safeValue = stringValue.startsWith("[") && stringValue.endsWith("]") ? stringValue : toSafeTokenName(stringValue);
+	if (isNoPrefix) return safeValue;
+	return `${styleProp.classPrefix}-${safeValue}`;
+}
+//#endregion
+export { buildStylePropClassName };