@yahoo/uds-v5-wip 1.60.0 → 1.61.0

package/dist/loader/dist/loader.js

@@ -1,43 +1,41 @@
-import { componentSlotClass } from "../../utils/dist/string-utils/componentClassName.js";
-import "../../utils/dist/index.js";
-import { loadManifest, loadTransformData } from "./loader/artifacts.js";
-import { isCompiledJsxCallee } from "./loader/babel-utils.js";
-import { canInlineSimpleLoweredComponent, resolveLoweredCreateComponentData } from "./loader/create-component-data.js";
-import { applySlotMotionToElement, clearHoistedMotionStates, componentHasExitMotion, getCustomSlotMotion, getHoistedMotionStates, handleMotionOnElement, wrapCustomComponentWithAnimatePresence, wrapParentConditionalWithAnimatePresence } from "./loader/motion-transform.js";
-import { findClassesParamName, findSlotFromClassNameAttr, findSlotFromPropsSpreadAttr, findSlotPropsParamName, handleCompiledJsxDataAttrs, injectInternalUdsProps } from "./loader/data-attr-transform.js";
-import { buildInlineSimpleLoweredCreateComponentRenderFn, buildInlineSimplePrimitiveCreateComponentRenderFn, buildLoweredCreateComponentConfigExpression, extractOwnPropKeys, inferCreateComponentNameFromAssignment, isCreateComponentRenderFnNode, remapOnPressToOnClickInJsxAttributes } from "./loader/create-component-lowering.js";
+import { loadManifest } from "./loader/artifacts.js";
+import { injectInternalUdsProps } from "./loader/internal-meta.js";
 import { lowerNewApiPrimitiveJsx } from "./loader/lower-new-api-primitive.js";
-import { createStyleTransformRuntime } from "./loader/style-transform.js";
-import * as t from "@babel/types";
 import path from "node:path";
-import _traverse from "@babel/traverse";
+import * as t from "@babel/types";
 import _generate from "@babel/generator";
 import { parse } from "@babel/parser";
+import _traverse from "@babel/traverse";
 //#region ../loader/dist/loader.js
 const traverse = _traverse.default ?? _traverse;
 const generate = _generate.default ?? _generate;
-/** Build a custom component set from the manifest (used for motion transform). */
-function getCustomComponents(manifest) {
-	if (!manifest) return null;
-	const custom = /* @__PURE__ */ new Set();
-	for (const [name, entry] of Object.entries(manifest.components)) if (entry.type === "custom") custom.add(name);
-	return custom.size > 0 ? custom : null;
-}
-function isUdsImportSource(importSource) {
-	return importSource.startsWith("uds/") || importSource.startsWith("@uds/") || importSource === "uds";
-}
-function isUdsComponentReference(nodePath, componentName, allUdsComponents, udsImportedNames, createComponentDefinedNames, customComponents) {
-	if (!allUdsComponents.has(componentName)) return false;
-	const binding = nodePath.scope?.getBinding?.(componentName);
-	if (!binding?.path) return udsImportedNames.has(componentName) || createComponentDefinedNames.has(componentName);
-	const bindingNode = binding.path.node;
-	if (bindingNode?.type === "ImportSpecifier" || bindingNode?.type === "ImportDefaultSpecifier" || bindingNode?.type === "ImportNamespaceSpecifier") {
-		const parentNode = binding.path.parent;
-		if (!t.isImportDeclaration(parentNode)) return false;
-		return isUdsImportSource(parentNode.source.value) || customComponents?.has(componentName) === true;
-	}
-	return createComponentDefinedNames.has(componentName);
-}
+/**
+* The UDS loader's only build-time job. Three responsibilities, one
+* Babel pass:
+*
+*  1. **Import rewrite** — when the source imports a registered
+*     component from an aliased local path (e.g.
+*     `@/uds/components/box`), rewrite the import source to
+*     `'#uds/components'` so it resolves to the codegen-emitted
+*     `.uds/components.tsx` barrel. The authoring file
+*     (`apps/<app>/src/uds/components/<name>.tsx`) is only read by
+*     codegen — production renders the downleveled FC.
+*
+*  2. **Static primitive JSX lowering** — when a JSX site references a
+*     registered primitive (`type: 'primitive'` + non-empty
+*     `propBindings` in the manifest), try `lowerNewApiPrimitiveJsx`
+*     to bake a literal `className="bg-primary"` into the output.
+*     Skips the codegen FC's runtime className concatenation entirely
+*     in the all-static case. Falls through to the runtime FC when
+*     lowering bails.
+*
+*  3. **Dev-mode metadata** — inject `data-uds-id` + `data-uds-source`
+*     attrs onto every UDS JSX site so devtools can map elements
+*     back to source positions. Off in production.
+*
+* Anything else (motion wiring, composite expansion, slot resolution,
+* styler tracking) is owned by codegen and intentionally absent here.
+*/
 const transformLoader = function(source) {
 	const loaderContext = this ?? void 0;
 	if (!loaderContext?.getOptions) return source;
@@ -51,15 +49,8 @@ const transformLoader = function(source) {
 		loaderContext.addDependency?.(transformDataPath);
 	}
 	const manifest = loadManifest(manifestPath, isDev);
-	const transformData = loadTransformData(transformDataPath, isDev);
-	const styleRuntime = createStyleTransformRuntime(transformData, manifest);
-	const allUdsComponents = styleRuntime.allComponents;
-	const primitiveUdsComponents = styleRuntime.primitiveComponents;
-	const componentTagPatterns = styleRuntime.componentTagPatterns;
-	const hasAnyComponent = source.includes("from 'uds/") || source.includes("from \"@uds/") || source.includes("from 'uds'") || source.includes("from \"uds/") || source.includes("from '@uds/") || source.includes("from \"uds\"") || componentTagPatterns.length > 0 && componentTagPatterns.some((pattern) => source.includes(pattern));
-	const hasCreateComponent = source.includes("createComponent") || source.includes("createComponentStyler");
-	if (!hasAnyComponent && !hasCreateComponent) return source;
-	const customComponents = getCustomComponents(manifest);
+	if (!manifest) return source;
+	if (!Object.keys(manifest.components).some((name) => source.includes(name))) return source;
 	const isTS = resourcePath?.endsWith(".ts") || resourcePath?.endsWith(".tsx");
 	const isJSX = resourcePath?.endsWith(".tsx") || resourcePath?.endsWith(".jsx");
 	const parserPlugins = [];
@@ -75,291 +66,62 @@ const transformLoader = function(source) {
 		return source;
 	}
 	let transformed = false;
-	const importsToAdd = /* @__PURE__ */ new Map();
-	let hasMotionImport = false;
-	let needsMotionImport = false;
-	let hasAnimatePresenceImport = false;
-	let needsAnimatePresenceImport = false;
-	let needsResolveMotionStateImport = false;
-	let needsProcessStylePropsImport = false;
-	clearHoistedMotionStates();
-	const stylerToComponent = /* @__PURE__ */ new Map();
-	const classesVarToComponent = /* @__PURE__ */ new Map();
-	const slotPropsVarToComponent = /* @__PURE__ */ new Map();
 	const udsImportedNames = /* @__PURE__ */ new Set();
-	const createComponentImportNames = /* @__PURE__ */ new Set();
-	const createVariantsImportNames = /* @__PURE__ */ new Set();
-	const createVariantsClassMaps = /* @__PURE__ */ new Map();
-	const hoistedVariantClassMapNames = /* @__PURE__ */ new Map();
-	const hoistedVariantClassMaps = /* @__PURE__ */ new Map();
-	const createComponentDefinedNames = /* @__PURE__ */ new Set();
-	let needsCreateComponentImportCleanup = false;
 	traverse(ast, {
-		JSXOpeningElement(nodePath) {
-			const jsxName = nodePath.node.name;
-			const jsxTagName = jsxName?.type === "JSXIdentifier" ? jsxName.name : void 0;
-			if (jsxTagName) {
-				const componentEntry = manifest?.components?.[jsxTagName];
-				if (componentEntry?.propBindings && udsImportedNames.has(jsxTagName)) {
-					const closingElement = (nodePath.parentPath?.node)?.closingElement ?? null;
-					if (lowerNewApiPrimitiveJsx(nodePath.node, closingElement, {
-						tag: componentEntry.element,
-						propBindings: componentEntry.propBindings,
-						defaultClassNames: componentEntry.defaultClassNames ?? []
-					}, t)) transformed = true;
-					return;
-				}
-			}
-			if (jsxTagName && !allUdsComponents.has(jsxTagName) && udsImportedNames.has(jsxTagName)) {
-				allUdsComponents.add(jsxTagName);
-				if (!primitiveUdsComponents.has(jsxTagName)) {
-					const manifestEntry = manifest?.components[jsxTagName];
-					if (manifestEntry?.type === "primitive" && manifestEntry.element || transformData?.primitiveElementMap?.[jsxTagName]) primitiveUdsComponents.add(jsxTagName);
-				}
-			}
-			const isUdsJsxTag = jsxTagName && isUdsComponentReference(nodePath, jsxTagName, allUdsComponents, udsImportedNames, createComponentDefinedNames, customComponents);
-			if (isDev && jsxTagName && isUdsJsxTag) {
-				injectInternalUdsProps(nodePath, resourcePath, projectRoot, {
-					componentName: jsxTagName,
-					slotName: "root"
-				});
-				transformed = true;
-			}
-			if (jsxTagName && isUdsJsxTag && remapOnPressToOnClickInJsxAttributes(nodePath.node.attributes)) transformed = true;
-			let motionTransformed = false;
-			if (isUdsJsxTag && handleMotionOnElement(nodePath, manifest, customComponents, primitiveUdsComponents, importsToAdd)) {
-				transformed = true;
-				motionTransformed = true;
-			}
-			if (jsxTagName && customComponents?.has(jsxTagName) && componentHasExitMotion(manifest, jsxTagName)) {
-				if (wrapCustomComponentWithAnimatePresence(nodePath)) {
-					needsAnimatePresenceImport = true;
-					transformed = true;
-				}
-			}
-			if (isUdsJsxTag && styleRuntime.transformUdsComponentStyleProps(nodePath, createVariantsClassMaps, hoistedVariantClassMapNames, hoistedVariantClassMaps)) transformed = true;
-			if (!motionTransformed && jsxTagName && isUdsJsxTag && primitiveUdsComponents.has(jsxTagName)) {
-				const baseElement = (manifest?.components[jsxTagName])?.element ?? transformData?.primitiveElementMap?.[jsxTagName];
-				if (baseElement) {
-					let resolvedElement = baseElement;
-					const asAttrIndex = nodePath.node.attributes.findIndex((attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === "as");
-					if (asAttrIndex >= 0) {
-						const asAttr = nodePath.node.attributes[asAttrIndex];
-						if (t.isStringLiteral(asAttr.value)) {
-							resolvedElement = asAttr.value.value;
-							nodePath.node.attributes.splice(asAttrIndex, 1);
-						} else if (t.isJSXExpressionContainer(asAttr.value) && t.isStringLiteral(asAttr.value.expression)) {
-							resolvedElement = asAttr.value.expression.value;
-							nodePath.node.attributes.splice(asAttrIndex, 1);
-						}
-					}
-					const slotClassName = transformData?.componentClassData?.[jsxTagName]?.slotClassNames?.root ?? componentSlotClass(jsxTagName, "root");
-					nodePath.node.name = t.jsxIdentifier(resolvedElement);
-					const existingClassAttr = nodePath.node.attributes.find((attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === "className");
-					if (existingClassAttr && t.isJSXAttribute(existingClassAttr)) {
-						if (t.isStringLiteral(existingClassAttr.value)) existingClassAttr.value = t.stringLiteral(`${slotClassName} ${existingClassAttr.value.value}`);
-						else if (t.isJSXExpressionContainer(existingClassAttr.value) && !t.isJSXEmptyExpression(existingClassAttr.value.expression)) if (t.isStringLiteral(existingClassAttr.value.expression)) existingClassAttr.value = t.jsxExpressionContainer(t.stringLiteral(`${slotClassName} ${existingClassAttr.value.expression.value}`));
-						else existingClassAttr.value = t.jsxExpressionContainer(t.templateLiteral([t.templateElement({
-							raw: `${slotClassName} `,
-							cooked: `${slotClassName} `
-						}, false), t.templateElement({
-							raw: "",
-							cooked: ""
-						}, true)], [existingClassAttr.value.expression]));
-					} else nodePath.node.attributes.push(t.jsxAttribute(t.jsxIdentifier("className"), t.stringLiteral(slotClassName)));
-					const parent = nodePath.parent;
-					if (parent?.type === "JSXElement" && parent.closingElement?.name?.type === "JSXIdentifier") parent.closingElement.name = t.jsxIdentifier(resolvedElement);
-					transformed = true;
-				}
-			}
-			const classNameSlotInfo = findSlotFromClassNameAttr(nodePath.node.attributes, classesVarToComponent, stylerToComponent, slotPropsVarToComponent);
-			const slotInfo = findSlotFromPropsSpreadAttr(nodePath.node.attributes, slotPropsVarToComponent) ?? classNameSlotInfo;
-			if (!slotInfo) return;
-			const slotMotion = getCustomSlotMotion(manifest, slotInfo);
-			if (slotMotion) {
-				const motionResult = applySlotMotionToElement(nodePath, slotMotion);
-				if (motionResult.transformed) {
-					transformed = true;
-					needsMotionImport = true;
-				}
-				if (motionResult.needsResolveMotionStateImport) needsResolveMotionStateImport = true;
-				if (motionResult.transformed && slotMotion.exit) {
-					if (wrapParentConditionalWithAnimatePresence(nodePath)) needsAnimatePresenceImport = true;
-				}
-			}
-			if (nodePath.node.attributes.some((attr) => attr.type === "JSXAttribute" && attr.name?.name === "data-uds-slot")) return;
-			nodePath.node.attributes.push(t.jsxAttribute(t.jsxIdentifier("data-uds-slot"), t.stringLiteral(slotInfo.slotName)), t.jsxAttribute(t.jsxIdentifier("data-uds-component"), t.stringLiteral(slotInfo.componentName)));
-			transformed = true;
-		},
 		ImportDeclaration(nodePath) {
 			const importSource = nodePath.node.source?.value;
 			if (!importSource) return;
-			if (importSource === "motion/react") {
-				for (const specifier of nodePath.node.specifiers) if (specifier.type === "ImportSpecifier" && specifier.imported?.type === "Identifier") {
-					if (specifier.imported.name === "motion") hasMotionImport = true;
-					if (specifier.imported.name === "AnimatePresence") hasAnimatePresenceImport = true;
-				}
-			}
-			if (!isUdsImportSource(importSource)) return;
-			for (const specifier of nodePath.node.specifiers) {
-				const localName = specifier.local?.name;
-				if (localName) udsImportedNames.add(localName);
-			}
+			if (!(!importSource.startsWith(".") && !importSource.startsWith("/"))) return;
+			let shouldRewriteSource = false;
 			for (const specifier of nodePath.node.specifiers) {
 				if (specifier.type !== "ImportSpecifier") continue;
-				const importedName = specifier.imported?.type === "Identifier" ? specifier.imported.name : specifier.imported?.value;
-				if (!importedName) continue;
-				const match = importedName.match(/^get(\w+)Styles$/);
-				if (match) {
-					const localName = specifier.local?.name ?? importedName;
-					stylerToComponent.set(localName, match[1]);
-				}
-				if (importedName === "createVariants") {
-					const localName = specifier.local?.name ?? importedName;
-					createVariantsImportNames.add(localName);
-					continue;
-				}
-				if (importedName === "createComponent") {
-					const localName = specifier.local?.name ?? importedName;
-					createComponentImportNames.add(localName);
+				const importedName = specifier.imported?.type === "Identifier" ? specifier.imported.name : void 0;
+				const localName = specifier.local?.name;
+				if (!importedName || !localName) continue;
+				if (Object.hasOwn(manifest.components, importedName)) {
+					udsImportedNames.add(localName);
+					shouldRewriteSource = true;
 				}
 			}
-		},
-		VariableDeclarator(nodePath) {
-			const init = nodePath.node.init;
-			if (!init) return;
-			const id = nodePath.node.id;
-			if (init.type === "CallExpression" && init.callee?.type === "Identifier" && createVariantsImportNames.has(init.callee.name) && id?.type === "Identifier") {
-				const variantClassMap = styleRuntime.extractVariantClassMapFromCreateVariantsCall(init);
-				if (variantClassMap) createVariantsClassMaps.set(id.name, variantClassMap);
-				return;
-			}
-			if (init.type === "CallExpression" && init.callee?.type === "Identifier" && init.callee.name === "createComponentStyler" && init.arguments[0]?.type === "StringLiteral" && id?.type === "Identifier") {
-				stylerToComponent.set(id.name, init.arguments[0].value);
-				return;
-			}
-			if (init.type === "CallExpression" && init.callee?.type === "Identifier" && id?.type === "Identifier") {
-				const componentName = stylerToComponent.get(init.callee.name);
-				if (componentName) classesVarToComponent.set(id.name, componentName);
-				return;
-			}
-			if (init.type === "CallExpression" && init.callee?.type === "MemberExpression" && init.callee.property?.name === "resolve" && init.callee.object?.type === "Identifier" && id?.type === "ObjectPattern") {
-				const componentName = stylerToComponent.get(init.callee.object.name);
-				if (componentName) {
-					for (const prop of id.properties) if (prop.type === "ObjectProperty" && prop.key?.type === "Identifier" && prop.key.name === "classes") {
-						const valueName = prop.value?.type === "Identifier" ? prop.value.name : "classes";
-						classesVarToComponent.set(valueName, componentName);
-						break;
-					}
+			if (!shouldRewriteSource && /\/uds\/components\/[^/]+$/.test(importSource)) {
+				const tail = importSource.split("/").pop();
+				if (tail) {
+					const pascal = tail.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+					if (Object.hasOwn(manifest.components, pascal)) shouldRewriteSource = true;
 				}
 			}
-		},
-		CallExpression(nodePath) {
-			const callee = nodePath.node.callee;
-			if (callee.type !== "Identifier") return;
-			if (isCompiledJsxCallee(callee)) {
-				const firstArg = nodePath.node.arguments[0];
-				if (t.isIdentifier(firstArg) && isUdsComponentReference(nodePath, firstArg.name, allUdsComponents, udsImportedNames, createComponentDefinedNames, customComponents) && styleRuntime.transformCompiledJsxStyleProps(nodePath.node, hoistedVariantClassMapNames, hoistedVariantClassMaps)) transformed = true;
-				const compiledResult = handleCompiledJsxDataAttrs(nodePath.node, classesVarToComponent, stylerToComponent, slotPropsVarToComponent, manifest);
-				if (compiledResult.transformed) transformed = true;
-				if (compiledResult.needsMotionImport) needsMotionImport = true;
-				if (compiledResult.needsResolveMotionStateImport) needsResolveMotionStateImport = true;
-				return;
-			}
-			const isCreateComponentCall = createComponentImportNames.has(callee.name) || createComponentImportNames.size === 0 && callee.name === "createComponent";
-			if (!isCreateComponentCall) return;
-			const args = nodePath.node.arguments;
-			const componentName = inferCreateComponentNameFromAssignment(nodePath);
-			if (!componentName) return;
-			createComponentDefinedNames.add(componentName);
-			let renderFn = null;
-			if (isCreateComponentCall) {
-				if (args.length >= 2 && args[0]?.type === "StringLiteral" && isCreateComponentRenderFnNode(args[1])) throw nodePath.buildCodeFrameError("createComponent(\"Name\", renderFn) is no longer supported. Use createComponent(renderFn).");
-				const isPrimitiveCreateComponentCall = args.length === 1 && t.isStringLiteral(args[0]);
-				if (!(args.length === 1 && isCreateComponentRenderFnNode(args[0])) && !isPrimitiveCreateComponentCall) return;
-				if (isCreateComponentRenderFnNode(args[0])) renderFn = args[0];
-			}
-			if (renderFn) {
-				const classesParam = findClassesParamName(renderFn);
-				if (classesParam) classesVarToComponent.set(classesParam, componentName);
-				const slotPropsParam = findSlotPropsParamName(renderFn);
-				if (slotPropsParam) slotPropsVarToComponent.set(slotPropsParam, componentName);
-			}
-			const loweredData = resolveLoweredCreateComponentData(componentName, renderFn ? extractOwnPropKeys(renderFn) : [], manifest, transformData);
-			if (args.length === 1 && t.isStringLiteral(args[0])) {
-				loweredData.rootElement = args[0].value;
-				if (canInlineSimpleLoweredComponent(loweredData)) {
-					const primitiveResult = buildInlineSimplePrimitiveCreateComponentRenderFn(loweredData);
-					nodePath.replaceWith(primitiveResult.expression);
-					if (primitiveResult.needsProcessStylePropsImport) needsProcessStylePropsImport = true;
-					needsCreateComponentImportCleanup = true;
-					transformed = true;
-					return;
-				}
-				nodePath.replaceWith(t.callExpression(t.cloneNode(callee), [buildLoweredCreateComponentConfigExpression(loweredData), t.cloneNode(args[0], true)]));
+			if (shouldRewriteSource) {
+				nodePath.node.source.value = "#uds/components";
 				transformed = true;
-				return;
 			}
-			if (canInlineSimpleLoweredComponent(loweredData)) {
-				const inlineResult = buildInlineSimpleLoweredCreateComponentRenderFn(loweredData, renderFn);
-				nodePath.replaceWith(inlineResult.expression);
-				if (inlineResult.needsMotionImport) needsMotionImport = true;
-				if (inlineResult.needsAnimatePresenceImport) needsAnimatePresenceImport = true;
-				if (inlineResult.needsResolveMotionStateImport) needsResolveMotionStateImport = true;
-				needsCreateComponentImportCleanup = true;
+		},
+		JSXOpeningElement(nodePath) {
+			const jsxName = nodePath.node.name;
+			const jsxTagName = jsxName?.type === "JSXIdentifier" ? jsxName.name : void 0;
+			if (!jsxTagName) return;
+			if (!udsImportedNames.has(jsxTagName)) return;
+			const componentEntry = manifest.components[jsxTagName];
+			if (!componentEntry) return;
+			if (isDev) {
+				injectInternalUdsProps(nodePath, resourcePath, projectRoot, {
+					componentName: jsxTagName,
+					slotName: "root"
+				});
 				transformed = true;
-				return;
 			}
-			if (!renderFn) return;
-			nodePath.replaceWith(t.callExpression(t.cloneNode(callee), [buildLoweredCreateComponentConfigExpression(loweredData), t.cloneNode(renderFn, true)]));
-			transformed = true;
+			if (!componentEntry.propBindings) return;
+			if (componentEntry.type !== "primitive") return;
+			if (nodePath.node.attributes.some((attr) => attr.type === "JSXAttribute" && attr.name?.type === "JSXIdentifier" && attr.name.name === "motion")) return;
+			const closingElement = (nodePath.parentPath?.node)?.closingElement ?? null;
+			if (lowerNewApiPrimitiveJsx(nodePath.node, closingElement, {
+				tag: componentEntry.element,
+				propBindings: componentEntry.propBindings,
+				defaultClassNames: componentEntry.defaultClassNames ?? [],
+				componentName: jsxTagName
+			}, t)) transformed = true;
 		}
 	});
-	if (needsCreateComponentImportCleanup) traverse(ast, { ImportDeclaration(nodePath) {
-		const importSource = nodePath.node.source?.value;
-		if (!importSource) return;
-		if (!isUdsImportSource(importSource)) return;
-		const nextSpecifiers = nodePath.node.specifiers.filter((specifier) => {
-			if (specifier.type !== "ImportSpecifier") return true;
-			const importedName = specifier.imported?.type === "Identifier" ? specifier.imported.name : specifier.imported?.value;
-			if (importedName !== "createComponent") return true;
-			const localName = specifier.local?.name ?? importedName;
-			nodePath.scope.crawl();
-			const binding = nodePath.scope.getBinding(localName);
-			return Boolean(binding?.referenced);
-		});
-		if (nextSpecifiers.length === nodePath.node.specifiers.length) return;
-		if (nextSpecifiers.length === 0) {
-			nodePath.remove();
-			return;
-		}
-		nodePath.node.specifiers = nextSpecifiers;
-	} });
 	if (!transformed) return source;
-	const sourceDir = path.dirname(resourcePath || projectRoot);
-	for (const [componentName, importPath] of importsToAdd) {
-		const absoluteImport = path.resolve(projectRoot, importPath);
-		let resolvedPath = path.relative(sourceDir, absoluteImport);
-		if (!resolvedPath.startsWith(".")) resolvedPath = `./${resolvedPath}`;
-		ast.program.body.unshift(t.importDeclaration([t.importSpecifier(t.identifier(componentName), t.identifier(componentName))], t.stringLiteral(resolvedPath)));
-	}
-	const motionImportSpecifiers = [];
-	if (needsMotionImport && !hasMotionImport) motionImportSpecifiers.push(t.importSpecifier(t.identifier("motion"), t.identifier("motion")));
-	if (needsAnimatePresenceImport && !hasAnimatePresenceImport) motionImportSpecifiers.push(t.importSpecifier(t.identifier("AnimatePresence"), t.identifier("AnimatePresence")));
-	if (motionImportSpecifiers.length > 0) ast.program.body.unshift(t.importDeclaration(motionImportSpecifiers, t.stringLiteral("motion/react")));
-	if (needsProcessStylePropsImport) {
-		if (!ast.program.body.some((node) => t.isImportDeclaration(node) && node.specifiers.some((s) => t.isImportSpecifier(s) && (t.isIdentifier(s.imported) && s.imported.name === "processStyleProps" || t.isStringLiteral(s.imported) && s.imported.value === "processStyleProps")))) ast.program.body.unshift(t.importDeclaration([t.importSpecifier(t.identifier("processStyleProps"), t.identifier("processStyleProps"))], t.stringLiteral("@uds/core")));
-	}
-	if (needsResolveMotionStateImport) ast.program.body.unshift(t.importDeclaration([t.importSpecifier(t.identifier("__rms"), t.identifier("resolveMotionState"))], t.stringLiteral("@uds/core")));
-	const motionStatesMap = getHoistedMotionStates();
-	if (motionStatesMap.size > 0) for (const [varName, statesConfig] of motionStatesMap) ast.program.body.unshift(t.variableDeclaration("const", [t.variableDeclarator(t.identifier(varName), t.valueToNode(statesConfig))]));
-	if (hoistedVariantClassMaps.size > 0) {
-		const declarations = [];
-		for (const [lookupName, classMap] of hoistedVariantClassMaps) declarations.push(t.variableDeclaration("const", [t.variableDeclarator(t.identifier(lookupName), t.objectExpression(Object.entries(classMap).map(([variantName, className]) => t.objectProperty(t.stringLiteral(variantName), t.stringLiteral(className)))))]));
-		const firstNonImportIndex = ast.program.body.findIndex((node) => node.type !== "ImportDeclaration");
-		if (firstNonImportIndex === -1) ast.program.body.push(...declarations);
-		else ast.program.body.splice(firstNonImportIndex, 0, ...declarations);
-	}
 	return generate(ast, {
 		retainLines: true,
 		sourceMaps: false

package/dist/loader/dist/next.d.ts

@@ -1,6 +1,7 @@
 import { NextConfig } from "next";
 
 //#region ../loader/dist/next.d.ts
+//#region src/next.d.ts
 interface WithUdsOptions {
   /** Output directory for generated files (default: '.uds') */
   outputDir?: string;
@@ -11,6 +12,6 @@ interface WithUdsOptions {
 type NextConfigFn = (phase: string, ctx: {
   defaultConfig: NextConfig;
 }) => NextConfig | Promise<NextConfig>;
-declare function withUds(nextConfigOrFn: NextConfig | NextConfigFn, options?: WithUdsOptions): NextConfig | NextConfigFn;
+declare function withUds(nextConfigOrFn: NextConfig | NextConfigFn, options?: WithUdsOptions): NextConfig | NextConfigFn; //#endregion
 //#endregion
 export { WithUdsOptions, withUds };

package/dist/loader/dist/transform-runner.js

@@ -0,0 +1,14 @@
+import "../../config/dist/index.js";
+import "./loader/artifacts.js";
+import "./loader.js";
+import "./loader/babel-utils.js";
+import "../../codegen/dist/loader/getLoaderArtifacts.js";
+import "node:path";
+import "@babel/types";
+import "@babel/parser";
+import "node:zlib";
+//#region ../loader/dist/transform-runner.js
+const VIRTUAL_ARTIFACTS_DIR = "/virtual/uds-loader-artifacts";
+`${VIRTUAL_ARTIFACTS_DIR}`;
+`${VIRTUAL_ARTIFACTS_DIR}`;
+//#endregion

package/dist/loader/dist/unplugin.d.ts

@@ -0,0 +1,27 @@
+import * as _$unplugin from "unplugin";
+
+//#region ../loader/dist/unplugin.d.ts
+//#region src/unplugin.d.ts
+interface UdsPluginOptions {
+  /**
+   * Path to `.uds/meta-loader.json` (default: `<cwd>/.uds/meta-loader.json`)
+   */
+  manifestPath?: string;
+  /**
+   * Enable development-only metadata transforms.
+   * Defaults to `process.env.NODE_ENV !== 'production'`.
+   */
+  isDev?: boolean;
+  /**
+   * Include filters for files to transform.
+   * Defaults to JS/TS module extensions.
+   */
+  include?: RegExp | RegExp[];
+  /**
+   * Exclude filters for files to skip.
+   */
+  exclude?: RegExp | RegExp[];
+}
+declare const udsPlugin: _$unplugin.UnpluginInstance<UdsPluginOptions, boolean>; //#endregion
+//#endregion
+export { UdsPluginOptions, udsPlugin };

package/dist/loader/dist/unplugin.js

@@ -0,0 +1,52 @@
+import { transformLoader } from "./loader.js";
+import path from "node:path";
+import { createUnplugin } from "unplugin";
+//#region ../loader/dist/unplugin.js
+const DEFAULT_INCLUDE = /\.[cm]?[jt]sx?$/;
+function toArray(value) {
+	if (!value) return [];
+	return Array.isArray(value) ? value : [value];
+}
+function sanitizeId(id) {
+	const queryStart = id.indexOf("?");
+	const hashStart = id.indexOf("#");
+	const cutIndex = queryStart === -1 ? hashStart : hashStart === -1 ? queryStart : Math.min(queryStart, hashStart);
+	return cutIndex === -1 ? id : id.slice(0, cutIndex);
+}
+function matchesFilters(id, includes, excludes) {
+	if (excludes.some((pattern) => pattern.test(id))) return false;
+	if (includes.length === 0) return true;
+	return includes.some((pattern) => pattern.test(id));
+}
+const udsPlugin = createUnplugin((options = {}) => {
+	const includePatterns = toArray(options.include ?? DEFAULT_INCLUDE);
+	const excludePatterns = toArray(options.exclude);
+	const manifestPath = path.resolve(process.cwd(), options.manifestPath ?? ".uds/meta-loader.json");
+	const isDev = options.isDev ?? true;
+	return {
+		name: "uds-unplugin",
+		enforce: "pre",
+		transformInclude(id) {
+			return matchesFilters(sanitizeId(id), includePatterns, excludePatterns);
+		},
+		transform(code, id) {
+			const resourcePath = sanitizeId(id);
+			if (!matchesFilters(resourcePath, includePatterns, excludePatterns)) return null;
+			const transformedCode = transformLoader.call({
+				getOptions: () => ({
+					manifestPath,
+					isDev
+				}),
+				addDependency: () => {},
+				resourcePath
+			}, code);
+			if (transformedCode === code) return null;
+			return {
+				code: transformedCode,
+				map: null
+			};
+		}
+	};
+});
+//#endregion
+export { udsPlugin };

package/dist/plugin.d.ts

@@ -1,2 +1,2 @@
-import { WithUdsOptions, withUds } from "./loader/dist/next.js";
-export { type WithUdsOptions, withUds };
+import { UdsPluginOptions, udsPlugin } from "./loader/dist/unplugin.js";
+export { type UdsPluginOptions, udsPlugin };

package/dist/plugin.js

@@ -1,2 +1,3 @@
-import { withUds } from "./loader/dist/next.js";
-export { withUds };
+import { udsPlugin } from "./loader/dist/unplugin.js";
+import "./loader/dist/index.js";
+export { udsPlugin };