@yahoo/uds-v5-wip 1.61.0 → 1.62.0

package/dist/loader/dist/loader/lower-new-api-primitive.js

@@ -1,252 +0,0 @@
-//#region ../loader/dist/loader/lower-new-api-primitive.js
-/**
-* Convert a token name to its class-name-safe form. Mirrors
-* `safeTokenName` from `@uds/utils`: `.` → `_`, `/` → `-`. Inlined
-* here so the loader stays free of cross-package runtime imports 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 className a binding emits for a given value. Mirrors the
-* codegen convention in `packages/codegen/src/css/prepareCss.ts`:
-*
-*  - `classPrefix === ''` → value IS the class.
-*  - Bracketed arbitrary values (`'[#abc]'`) → preserved verbatim
-*    (`bg-[#abc]`).
-*  - Boolean `true` (passed in as the string `'true'`) → bare
-*    `classPrefix` (`<Box border>` / `<Box border={true}>` →
-*    `'border'`, not `'border-true'`).
-*  - Blessed token / literal / alias (in `binding.blessedValues`) →
-*    `${classPrefix}-${value}`.
-*  - Otherwise, if the prop accepts arbitrary values
-*    (`binding.acceptsArbitrary`) → `${classPrefix}-[value]`
-*    (auto-bracket so the consumer can write `fontSize="0.8125rem"`
-*    instead of `fontSize="[0.8125rem]"`).
-*  - Otherwise (when blessed/arbitrary metadata is absent — test
-*    fixtures) fall back to `${classPrefix}-${value}`.
-*
-* Returns `undefined` when no class should be emitted — caller drops
-* the contribution. Boolean `false` lands here.
-*/
-function buildClassName(binding, value) {
-	if (value === "false") return void 0;
-	if (value === "true") return binding.classPrefix || void 0;
-	const isNoPrefix = binding.classPrefix === "";
-	if (value.startsWith("[") && value.endsWith("]")) {
-		if (isNoPrefix) return value.slice(1, -1);
-		return `${binding.classPrefix}-${value}`;
-	}
-	if (isNoPrefix) return value;
-	if (!(binding.blessedValues !== void 0 || binding.acceptsArbitrary !== void 0)) return `${binding.classPrefix}-${toSafeTokenName(value)}`;
-	if (binding.blessedValues?.includes(value)) return `${binding.classPrefix}-${toSafeTokenName(value)}`;
-	if (binding.acceptsArbitrary) return `${binding.classPrefix}-[${value}]`;
-}
-/**
-* Read a JS expression node as a literal string when statically
-* resolvable. Mirrors `readStaticString` but operates on a bare
-* expression (used by the branch-compiler below to drill into
-* ternary / `&&` branches that aren't wrapped in JSX containers).
-*
-* Returns `undefined` for any non-literal form.
-*/
-function readStaticStringFromExpression(expr) {
-	if (!expr) return void 0;
-	if (expr.type === "StringLiteral") return expr.value;
-	if (expr.type === "NumericLiteral") return String(expr.value);
-	if (expr.type === "BooleanLiteral") return String(expr.value);
-	if (expr.type === "TemplateLiteral" && expr.expressions.length === 0 && expr.quasis.length === 1) return expr.quasis[0].value.cooked ?? expr.quasis[0].value.raw;
-	if (expr.type === "Identifier" && expr.name === "undefined") return "";
-	if (expr.type === "NullLiteral") return "";
-}
-/**
-* Try to compile a dynamic JSX expression into a className expression
-* with pre-resolved per-branch class names. Mirrors the legacy
-* `tryCompileStaticBranchExpression` in `style-transform.ts` so the
-* new-API lowering matches existing behavior for the common ternary /
-* `&&` patterns:
-*
-*     bg={isActive ? 'primary' : undefined}
-*     → isActive ? 'bg-primary' : ''
-*
-*     color={isActive && 'on-primary'}
-*     → isActive && 'color-on-primary'
-*
-* Returns `null` when the expression isn't a statically-resolvable
-* branch shape — caller bails on lowering for that prop. (Variables,
-* function calls, member access of dynamic values: those need runtime
-* resolution.)
-*/
-function tryCompileBranchClassExpression(expr, binding, t) {
-	if (expr.type === "ConditionalExpression") {
-		const consequentValue = readStaticStringFromExpression(expr.consequent);
-		const alternateValue = readStaticStringFromExpression(expr.alternate);
-		const compileLeafValue = (value) => value === "" ? "" : buildClassName(binding, value) ?? "";
-		const compiledConsequent = consequentValue !== void 0 ? t.stringLiteral(compileLeafValue(consequentValue)) : tryCompileBranchClassExpression(expr.consequent, binding, t);
-		const compiledAlternate = alternateValue !== void 0 ? t.stringLiteral(compileLeafValue(alternateValue)) : tryCompileBranchClassExpression(expr.alternate, binding, t);
-		if (compiledConsequent && compiledAlternate) return t.conditionalExpression(t.cloneNode(expr.test), compiledConsequent, compiledAlternate);
-		return null;
-	}
-	if (expr.type === "LogicalExpression" && expr.operator === "&&") {
-		const rightValue = readStaticStringFromExpression(expr.right);
-		if (rightValue !== void 0) {
-			const className = buildClassName(binding, rightValue) ?? "";
-			return t.logicalExpression("&&", t.cloneNode(expr.left), t.stringLiteral(className));
-		}
-		return null;
-	}
-	return null;
-}
-/**
-* Read a JSX attribute value as a literal string when statically
-* resolvable. Handles:
-*
-*  - `attr="x"`  → `"x"`
-*  - `attr={"x"}` / `attr={\`x\`}` (no interpolations) → `"x"`
-*  - `attr={2}` (numeric literal) → `"2"`
-*  - `attr={true}` / `attr={false}` (boolean literal) → `"true"` / `"false"`
-*  - `attr` with no value (boolean prop shorthand) → `"true"`
-*
-* Returns `undefined` for any dynamic form so the caller can bail.
-*/
-function readStaticString(value) {
-	if (!value) return "true";
-	if (value.type === "StringLiteral") return value.value;
-	if (value.type === "JSXExpressionContainer") {
-		const expr = value.expression;
-		if (expr.type === "StringLiteral") return expr.value;
-		if (expr.type === "NumericLiteral") return String(expr.value);
-		if (expr.type === "BooleanLiteral") return String(expr.value);
-		if (expr.type === "TemplateLiteral" && expr.expressions.length === 0 && expr.quasis.length === 1) return expr.quasis[0].value.cooked ?? expr.quasis[0].value.raw;
-	}
-}
-/**
-* Lower a JSX element of a new-API primitive component. Returns `true`
-* when the AST was mutated (lowered); `false` when the call site can't
-* be statically lowered and the runtime path should take over.
-*
-* `t` is the `@babel/types` namespace — passed in so the helper stays
-* free of direct import dependencies on Babel internals (the loader
-* already imports them and threads them through).
-*
-* `openingElement` and (optional) `closingElement` are mutated in
-* place on success.
-*/
-function lowerNewApiPrimitiveJsx(openingElement, closingElement, entry, t) {
-	let tag = entry.tag;
-	const classNames = [...entry.defaultClassNames];
-	const dynamicClassExprs = [];
-	const passthroughAttrs = [];
-	let existingClassName = null;
-	for (const attr of openingElement.attributes ?? []) {
-		if (attr.type === "JSXSpreadAttribute") return false;
-		const attrName = attr.name?.type === "JSXIdentifier" ? attr.name.name : void 0;
-		if (!attrName) return false;
-		if (attrName === "as") {
-			const tagValue = readStaticString(attr.value);
-			if (tagValue === void 0) return false;
-			tag = tagValue;
-			continue;
-		}
-		if (attrName === "className") {
-			existingClassName = attr.value;
-			continue;
-		}
-		const binding = entry.propBindings[attrName];
-		if (binding) {
-			const staticValue = readStaticString(attr.value);
-			if (staticValue !== void 0) {
-				const className = buildClassName(binding, staticValue);
-				if (className !== void 0) classNames.push(className);
-				continue;
-			}
-			if (attr.value?.type === "JSXExpressionContainer") {
-				const compiled = tryCompileBranchClassExpression(attr.value.expression, binding, t);
-				if (compiled) {
-					dynamicClassExprs.push(compiled);
-					continue;
-				}
-			}
-			return false;
-		}
-		if (attrName.startsWith("_")) {
-			const variantPrefix = entry.modifiersTwMap?.[attrName];
-			if (!variantPrefix) continue;
-			const objectExpr = attr.value?.type === "JSXExpressionContainer" ? attr.value.expression : void 0;
-			if (!objectExpr || objectExpr.type !== "ObjectExpression") return false;
-			let bailed = false;
-			for (const property of objectExpr.properties) {
-				if (property.type !== "ObjectProperty" || property.computed) {
-					bailed = true;
-					break;
-				}
-				const key = property.key?.type === "Identifier" ? property.key.name : property.key?.type === "StringLiteral" ? property.key.value : void 0;
-				if (!key) {
-					bailed = true;
-					break;
-				}
-				const value = readStaticString(property.value);
-				if (value === void 0) {
-					bailed = true;
-					break;
-				}
-				const innerBinding = entry.propBindings[key];
-				if (!innerBinding) {
-					bailed = true;
-					break;
-				}
-				const innerClass = buildClassName(innerBinding, value);
-				if (innerClass !== void 0) classNames.push(`${variantPrefix}${innerClass}`);
-			}
-			if (bailed) return false;
-			continue;
-		}
-		passthroughAttrs.push(attr);
-	}
-	const boundClassName = classNames.join(" ");
-	let classNameAttr = null;
-	if (dynamicClassExprs.length > 0) {
-		const parts = [];
-		if (boundClassName.length > 0) parts.push(t.stringLiteral(boundClassName));
-		for (const expr of dynamicClassExprs) parts.push(expr);
-		if (existingClassName !== null) {
-			if (existingClassName.type === "StringLiteral") parts.push(t.stringLiteral(existingClassName.value));
-			else if (existingClassName.type === "JSXExpressionContainer") parts.push(t.cloneNode(existingClassName.expression));
-		}
-		const joinExpr = t.callExpression(t.memberExpression(t.callExpression(t.memberExpression(t.arrayExpression(parts), t.identifier("filter")), [t.identifier("Boolean")]), t.identifier("join")), [t.stringLiteral(" ")]);
-		classNameAttr = t.jsxAttribute(t.jsxIdentifier("className"), t.jsxExpressionContainer(joinExpr));
-	} else if (existingClassName === null && boundClassName.length > 0) classNameAttr = t.jsxAttribute(t.jsxIdentifier("className"), t.stringLiteral(boundClassName));
-	else if (existingClassName !== null) if (existingClassName.type === "StringLiteral") {
-		const merged = boundClassName ? `${existingClassName.value} ${boundClassName}` : existingClassName.value;
-		classNameAttr = t.jsxAttribute(t.jsxIdentifier("className"), t.stringLiteral(merged));
-	} else if (existingClassName.type === "JSXExpressionContainer" && existingClassName.expression.type === "StringLiteral") {
-		const merged = boundClassName ? `${existingClassName.expression.value} ${boundClassName}` : existingClassName.expression.value;
-		classNameAttr = t.jsxAttribute(t.jsxIdentifier("className"), t.stringLiteral(merged));
-	} else if (existingClassName.type === "JSXExpressionContainer") {
-		const expr = existingClassName.expression;
-		const finalExpr = boundClassName ? t.binaryExpression("+", t.binaryExpression("+", expr, t.stringLiteral(" ")), t.stringLiteral(boundClassName)) : expr;
-		classNameAttr = t.jsxAttribute(t.jsxIdentifier("className"), t.jsxExpressionContainer(finalExpr));
-	} else return false;
-	const anatomyAttrs = [];
-	if (entry.componentName) {
-		const alreadyHasSlot = passthroughAttrs.some((a) => a.type === "JSXAttribute" && a.name?.name === "data-uds-slot");
-		const alreadyHasComponent = passthroughAttrs.some((a) => a.type === "JSXAttribute" && a.name?.name === "data-uds-component");
-		if (!alreadyHasSlot) anatomyAttrs.push(t.jsxAttribute(t.jsxIdentifier("data-uds-slot"), t.stringLiteral("root")));
-		if (!alreadyHasComponent) anatomyAttrs.push(t.jsxAttribute(t.jsxIdentifier("data-uds-component"), t.stringLiteral(entry.componentName)));
-	}
-	openingElement.name = t.jsxIdentifier(tag);
-	openingElement.attributes = [
-		...classNameAttr ? [classNameAttr] : [],
-		...passthroughAttrs,
-		...anatomyAttrs
-	];
-	if (closingElement) closingElement.name = t.jsxIdentifier(tag);
-	return true;
-}
-//#endregion
-export { lowerNewApiPrimitiveJsx };