@yahoo/uds-create-loader 4.46.1 → 4.47.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-create-loader",
-  "version": "4.46.1",
+  "version": "4.47.0",
   "type": "module",
   "private": false,
   "files": [
@@ -38,7 +38,7 @@
     "test:update": "bun test src/ --update-snapshots"
   },
   "dependencies": {
-    "@yahoo/uds-create-config": "4.46.1",
+    "@yahoo/uds-create-config": "4.47.0",
     "@babel/parser": "^7.29.0",
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",
@@ -63,5 +63,5 @@
       "optional": true
     }
   },
-  "udsSchemaVersion": 20260929161433
+  "udsSchemaVersion": 20260930153059
 }

package/src/loader.test.ts

@@ -88,6 +88,41 @@ export function Demo() {
     expect(output).not.toContain("from '@/uds/components/box'");
   });
 
+  it("runs a linked system's source import as the module the build emitted for it", () => {
+    const source = `
+import { Avatar } from '@/uds/registry/yos/avatar';
+import { useTone } from "@/uds/registry/yahoo-os-v3-bridge/hooks/use-tone";
+
+export function Demo() {
+  return <Avatar tone={useTone()} />;
+}
+`;
+    const output = runLoader(source, makeEmptyConfig());
+
+    expect(output).toContain("from '#uds/components/_linked/yos/avatar'");
+    expect(output).toContain(
+      'from "#uds/components/_linked/yahoo-os-v3-bridge/hooks/use-tone"',
+    );
+    expect(output).not.toContain('@/uds/registry/');
+  });
+
+  it('follows the aliases the system declares', () => {
+    const config = new System()
+      .register({
+        settings: { build: { sourceAlias: '~/ds', outputAlias: '#ds' } },
+      })
+      .toJSON() as SerializedConfig;
+    const source = `
+import { Avatar } from '~/ds/registry/yos/avatar';
+import { Stale } from '@/uds/registry/yos/stale';
+`;
+    const output = runLoader(source, config);
+
+    expect(output).toContain("from '#ds/components/_linked/yos/avatar'");
+    // Not this system's alias, so not this loader's to rewrite.
+    expect(output).toContain("from '@/uds/registry/yos/stale'");
+  });
+
   it('does not rewrite relative imports', () => {
     const config = makeBoxConfig();
     const source = `

package/src/loader.ts

@@ -1,6 +1,10 @@
 import { parse } from '@babel/parser';
 import _traverse from '@babel/traverse';
-import { resolveRegistryDir } from '@yahoo/uds-create-config';
+import {
+  resolveOutputAlias,
+  resolveRegistryDir,
+  resolveSourceAlias,
+} from '@yahoo/uds-create-config';
 import type { LoaderDefinitionFunction } from 'webpack';
 import {
   getLoaderProjection,
@@ -72,17 +76,23 @@ const transformLoader: LoaderDefinitionFunction = function (source) {
 
   // Configurable registry location (`build.registryDir`) — same skip rationale as above. The
   // settings are one item of the `settings` kind in a serialized config, keyed by the kind.
-  const registryRel = resolveRegistryDir(
-    (
-      config as {
-        items?: {
+  const build = (
+    config as {
+      items?: {
+        settings?: {
           settings?: {
-            settings?: { build?: Parameters<typeof resolveRegistryDir>[0] };
+            build?: Parameters<typeof resolveRegistryDir>[0] &
+              Parameters<typeof resolveSourceAlias>[0];
           };
         };
-      }
-    ).items?.settings?.settings?.build,
-  );
+      };
+    }
+  ).items?.settings?.settings?.build;
+  const registryRel = resolveRegistryDir(build);
+  // The prefixes the system declares: its sources' (`@/uds`) and its build output's (`#uds`). A linked
+  // system's source is imported beneath the first, `<sourceAlias>/registry/<slug>/…`.
+  const outputAlias = resolveOutputAlias(build);
+  const linkedAlias = `${resolveSourceAlias(build)}/registry/`;
   if (resourcePath.replace(/\\/g, '/').includes(`/${registryRel}/`)) {
     return source;
   }
@@ -92,7 +102,7 @@ const transformLoader: LoaderDefinitionFunction = function (source) {
   // Cheap pre-filter: only parse files that look like they import or
   // reference a UDS component. Avoids babel overhead on the bulk of
   // application files.
-  let hasComponentReference = false;
+  let hasComponentReference = source.includes(linkedAlias);
   for (const name of projection.componentNames) {
     if (source.includes(name)) {
       hasComponentReference = true;
@@ -142,6 +152,25 @@ const transformLoader: LoaderDefinitionFunction = function (source) {
       const importSource: string | undefined = nodePath.node.source?.value;
       if (!importSource) return;
 
+      // A linked system's source, imported by its alias for the types (`@/uds/registry/yos/avatar`),
+      // runs as the module the build emitted from it — the same path under `components/_linked/`.
+      if (importSource.startsWith(linkedAlias)) {
+        const sourceNode = nodePath.node.source;
+        if (
+          typeof sourceNode.start !== 'number' ||
+          typeof sourceNode.end !== 'number'
+        ) {
+          return;
+        }
+        const quote = source[sourceNode.start] ?? "'";
+        edits.push({
+          start: sourceNode.start,
+          end: sourceNode.end,
+          value: `${quote}${outputAlias}/components/_linked/${importSource.slice(linkedAlias.length)}${quote}`,
+        });
+        return;
+      }
+
       // Only rewrite alias-prefixed local imports (e.g.
       // `@/uds/components/<name>`, `~/uds/components/<name>`).
       // Relative imports (`./text`, `../box`) belong to the authoring
@@ -213,7 +242,7 @@ const transformLoader: LoaderDefinitionFunction = function (source) {
         edits.push({
           start: sourceNode.start,
           end: sourceNode.end,
-          value: `${quote}#uds/components/${segmentMatch[1]}${quote}`,
+          value: `${quote}${outputAlias}/components/${segmentMatch[1]}${quote}`,
         });
       }
     },

package/src/next.test.ts

@@ -6,7 +6,8 @@ import { withUds } from './next';
 // Repo rule: test artifacts under the package's dist/.test-tmp.
 const TMP = path.join(import.meta.dir, '../dist/.test-tmp/next-registry-deps');
 
-const REGISTRY_REL = '.uds-registry';
+// The default registry, beside the conventional components root.
+const REGISTRY_REL = 'src/uds/registry';
 
 function writeFixture(args: {
   registryDeps?: Record<string, string>;