@yahoo/uds-create-config 1.1.1

package/dist/entity-utils.js

@@ -0,0 +1,105 @@
+import { cssClassName, cssVar } from "./brands.js";
+//#region src/entity-utils.ts
+/**
+* Shared helpers used by entity `.derived` getters.
+*/
+/**
+* Kebab-case a single identifier. Inserts a hyphen at each upper-case
+* boundary and lower-cases the result. Single-segment only — for slashed
+* `'namespace/name'` paths, kebab each segment separately.
+*/
+function kebabCase(value) {
+	return value.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
+}
+/**
+* Kebab-case + sanitize a single identifier for use inside a CSS custom
+* property name or class name. Dots become `_` and slashes become `-`
+* (so `1.5` → `1_5`, `1/2` → `1-2`, `ui5/emphasized` → `ui5-emphasized`).
+* Mirrors the `safeTokenName` transform used by the runtime styler in
+* `@yahoo/uds-create-utils`, so codegen-declared identifiers and runtime-referenced
+* identifiers stay in lockstep.
+*/
+function cssSafeSegment(value) {
+	return kebabCase(value).replace(/\./g, "_").replace(/\//g, "-");
+}
+/**
+* Build a CSS variable name from a prefix + namespace + token name.
+* Each segment is kebab-cased; dots in the token name are mapped to
+* `_` and slashes to `-` since CSS custom-property identifiers reject
+* both `.` and `/` (so a `1.5` spacing token emits
+* `--<prefix>-spacing-1_5`, and a subpath token `1/2` or
+* `always/white` emits `--<prefix>-position-1-2` /
+* `--<prefix>-global-always-white` — both valid).
+*/
+function buildCssVar(prefix, namespace, name) {
+	return cssVar(`--${prefix}-${kebabCase(namespace)}-${cssSafeSegment(name)}`);
+}
+/**
+* Build a `tokenRef → 'var(--<prefix>-<ns>-<name>)'` resolver — the callback
+* `resolveColorExpression` consumes to turn `token('ns/name')` refs into CSS var
+* references. Splits a ref on its FIRST slash into namespace + name; a ref with
+* no usable slash passes through unchanged (already a literal).
+*
+* The single source of truth shared by the config render-spec bake and codegen
+* (`tokenValue.ts`, `prepareCss.ts`), so config-baked and codegen-emitted CSS
+* stay byte-identical. The name segment uses the `@yahoo/uds-create-utils` `safeTokenName`
+* transform (dots→`_`, slashes→`-`) — NOT `cssSafeSegment` (which also
+* kebab-cases) — so multi-segment paths like `spectrum/carbon/0` resolve to a
+* valid `--<prefix>-spectrum-carbon-0`.
+*/
+function makeTokenRefToCss(prefix) {
+	return (ref) => {
+		const slashIdx = ref.indexOf("/");
+		if (slashIdx <= 0 || slashIdx >= ref.length - 1) return ref;
+		const namespace = kebabCase(ref.slice(0, slashIdx));
+		const name = ref.slice(slashIdx + 1).replace(/\./g, "_").replace(/\//g, "-");
+		return prefix ? `var(--${prefix}-${namespace}-${name})` : `var(--${namespace}-${name})`;
+	};
+}
+/**
+* Build a composite style's CSS class name: `<prefix>-<name>-<variant>`.
+* Both name/variant segments are sanitized so subpath variants like
+* `ui5/emphasized` emit `.yos-text-variant-ui5-emphasized` instead of an
+* invalid `.text-variant-ui5/emphasized` (which the browser splits at `/`).
+*
+* The `prefix` namespaces the class the same way it namespaces CSS
+* variables and component classes (`componentClassNames`) — an empty
+* prefix yields the bare, unprefixed form.
+*/
+function buildCompositeClassName(prefix, name, variant) {
+	const body = `${cssSafeSegment(name)}-${cssSafeSegment(variant)}`;
+	return cssClassName(prefix ? `${prefix}-${body}` : body);
+}
+/**
+* Build the marker custom-property name a composite group writes (and
+* its container style queries read): `--<prefix>-composite-<kebab-name>`.
+* Single source of truth — the setter emission and `@container style(...)`
+* query both consume this so they stay in lockstep.
+*/
+function buildCompositeMarkerVarName(prefix, name) {
+	return cssVar(`--${prefix}-composite-${kebabCase(name)}`);
+}
+/**
+* Token names that aren't valid CSS identifiers (`2xl`, `3xs`) get an
+* underscore prefix so they survive in CSS contexts. Dots are mapped
+* to `_` and slashes to `-` — `1.5` would otherwise produce a class
+* string the browser splits at the dot (`class="text-1.5"` parses as
+* `.text-1` and `.5`), and a subpath token like `1/2` would emit
+* `text-1/2` which the browser treats as `.text-1` followed by
+* `/2`. Mirrors `safeTokenName` from `@yahoo/uds-create-utils`.
+*/
+function toCssSafeName(name) {
+	return cssClassName(cssSafeSegment(/^[0-9]/.test(name) ? `_${name}` : name));
+}
+/**
+* Filter undefined fields out of a partial object literal so optional
+* authored properties don't show up as `key: undefined` in `toJSON()`
+* output. Mirrors the pattern used by `@yahoo/uds-create-config` `defineX` builders.
+*/
+function compact(input) {
+	const out = {};
+	for (const [key, value] of Object.entries(input)) if (value !== void 0) out[key] = value;
+	return out;
+}
+//#endregion
+export { buildCompositeClassName, buildCompositeMarkerVarName, buildCssVar, compact, cssSafeSegment, kebabCase, makeTokenRefToCss, toCssSafeName };