@yahoo/uds-create-loader 2.21.2 → 2.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-create-loader",
-  "version": "2.21.2",
+  "version": "2.23.0",
   "type": "module",
   "private": false,
   "files": [
@@ -38,7 +38,7 @@
     "test:update": "bun test src/ --update-snapshots"
   },
   "dependencies": {
-    "@yahoo/uds-create-config": "2.21.2",
+    "@yahoo/uds-create-config": "2.23.0",
     "@babel/parser": "^7.29.0",
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",

package/src/loader.test.ts

@@ -241,6 +241,74 @@ export function Demo() {
     expect(output).toBe(source);
   });
 
+  it('returns source unchanged for files inside `.uds-registry/` (linked systems)', () => {
+    const config = makeBoxConfig();
+    // A linked node's sealed source: same shape as consumer code, but its
+    // alias imports must never rewrite to the CONSUMER's #uds/ downleveled
+    // modules — that would render a linked component with the consumer's
+    // implementation (cross-system wiring). Linked components render through
+    // the node-scoped modules generated under .uds/components/_linked/.
+    const source = `
+import { Box } from '@/uds/components/box';
+
+export function Demo() {
+  return <Box bg="brand">hi</Box>;
+}
+`;
+    const output = runLoader(source, config, {
+      resourcePath: path.join(
+        process.cwd(),
+        '.uds-registry/aaaaaaaa-1111-4111-8111-111111111111@1.0.0/src/uds/components/demo.tsx',
+      ),
+    });
+
+    expect(output).toBe(source);
+  });
+
+  it('skips the default registry location under componentsDir', () => {
+    const config = {
+      ...makeBoxConfig(),
+      buildOptions: { componentsDir: 'src/uds' },
+    };
+    const source = `
+import { Box } from '@/uds/components/box';
+
+export function Demo() {
+  return <Box bg="brand">hi</Box>;
+}
+`;
+    const output = runLoader(source, config, {
+      resourcePath: path.join(
+        process.cwd(),
+        'src/uds/registry/aaaaaaaa-1111-4111-8111-111111111111@1.0.0/src/uds/components/demo.tsx',
+      ),
+    });
+
+    expect(output).toBe(source);
+  });
+
+  it('skips an explicit buildOptions.registryDir', () => {
+    const config = {
+      ...makeBoxConfig(),
+      buildOptions: { registryDir: 'vendor/linked' },
+    };
+    const source = `
+import { Box } from '@/uds/components/box';
+
+export function Demo() {
+  return <Box bg="brand">hi</Box>;
+}
+`;
+    const output = runLoader(source, config, {
+      resourcePath: path.join(
+        process.cwd(),
+        'vendor/linked/aaaaaaaa-1111-4111-8111-111111111111@1.0.0/demo.tsx',
+      ),
+    });
+
+    expect(output).toBe(source);
+  });
+
   it('returns source unchanged when no manifest component is referenced', () => {
     const config = makeBoxConfig();
     const source = `

package/src/loader.ts

@@ -1,5 +1,6 @@
 import { parse } from '@babel/parser';
 import _traverse from '@babel/traverse';
+import { resolveRegistryDir } from '@yahoo/uds-create-config';
 import type { LoaderDefinitionFunction } from 'webpack';
 import {
   getLoaderProjection,
@@ -47,6 +48,16 @@ const transformLoader: LoaderDefinitionFunction = function (source) {
     return source;
   }
 
+  // Skip materialized linked-system sources (legacy project-root layout):
+  // their alias imports must never rewrite to the CONSUMER's
+  // `#uds/components/*` downleveled modules — that would render a linked
+  // component with the consumer's implementation. Linked components render
+  // through the node-scoped modules the consumer build generates under
+  // `.uds/components/_linked/` (see linked-system isolation, UDS-2771).
+  if (resourcePath.includes('.uds-registry/')) {
+    return source;
+  }
+
   // Tell webpack to watch generated uds artifacts for changes.
   // Skipped when the host app has its own reload mechanism (Studio
   // WebSocket) to avoid full-page reloads on artifact regeneration.
@@ -58,6 +69,14 @@ const transformLoader: LoaderDefinitionFunction = function (source) {
   // belong to UDS. Returning early keeps non-UDS files untouched.
   const config = loadUdsConfig(dataPath, isDev);
   if (!config) return source;
+
+  // Configurable registry location (`buildOptions.registryDir`, defaulting
+  // to `<componentsDir>/registry`) — same skip rationale as above.
+  const registryRel = resolveRegistryDir(config.buildOptions);
+  if (resourcePath.replace(/\\/g, '/').includes(`/${registryRel}/`)) {
+    return source;
+  }
+
   const projection = getLoaderProjection(config);
 
   // Cheap pre-filter: only parse files that look like they import or