@ws-test-realm/admin-kit 0.6.5-ng20 → 0.6.7-ng20

package/lib/deploy-remotes.js

@@ -72,6 +72,50 @@ function deployExt({ workspaceDir, id, modulesDir, extDir, stagedDir }) {
   return { extDir, copiedFiles: fileCount };
 }
 
+// Publish the LIB output (`dist/<id>/`) to the fiddle's
+// `<adminDir>/.federation/<id>/`. Cross-workspace consumers' ng-packagr
+// reads this directory (via the symlink `node_modules/<id>` → here) to
+// resolve TypeScript imports. Without an up-to-date publish, consumers
+// compile against stale typings — references to renamed/removed classes
+// silently resolve against the old names, baking obsolete identifiers
+// into the consumer's fesm. At runtime the consumer's chunk then imports
+// a name the deployed remote no longer exports → `undefined.ɵcmp`.
+//
+// Both jar and ext targets need this. (The jar's META-INF/federation/<id>/
+// only carries the RUNTIME bundle, not the LIB output.)
+//
+// Idempotent: wipes the destination first so removed files (e.g. classes
+// renamed out of existence) don't linger.
+function publishLibTypings({ workspaceDir, id, adminDir }) {
+  if (!adminDir) return null;
+  const libDir = path.join(workspaceDir, "dist", id);
+  if (!fs.existsSync(libDir)) return null;
+  // Only publish if it looks like an ng-packagr lib output (has package.json
+  // + index.d.ts). Skip otherwise to avoid clobbering with a weird tree.
+  if (
+    !fs.existsSync(path.join(libDir, "package.json")) ||
+    !fs.existsSync(path.join(libDir, "index.d.ts"))
+  ) {
+    return null;
+  }
+  const federationDir = path.join(adminDir, ".federation", id);
+  if (fs.existsSync(federationDir)) {
+    fs.rmSync(federationDir, { recursive: true, force: true });
+  }
+  fs.mkdirSync(federationDir, { recursive: true });
+  fs.cpSync(libDir, federationDir, { recursive: true });
+  let fileCount = 0;
+  const walk = (d) => {
+    for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+      const p = path.join(d, e.name);
+      if (e.isDirectory()) walk(p);
+      else fileCount += 1;
+    }
+  };
+  walk(federationDir);
+  return { federationDir, fileCount };
+}
+
 function deployOne({
   workspaceDir,
   id,
@@ -97,6 +141,8 @@ function deployOne({
     modulesFolder,
   });
 
+  const typings = publishLibTypings({ workspaceDir, id, adminDir });
+
   if (target.kind === "jar") {
     const packResult = packIntoJar({
       jarPath: target.jarPath,
@@ -108,6 +154,7 @@ function deployOne({
       jarPath: target.jarPath,
       pomPath: target.pomPath,
       artifactId: target.artifactId,
+      typings,
       ...packResult,
     };
   }
@@ -119,7 +166,7 @@ function deployOne({
     extDir: target.extDir,
     stagedDir,
   });
-  return { kind: "ext", ...extResult };
+  return { kind: "ext", typings, ...extResult };
 }
 
 function deployRemotes({ workspaceDir, restrictTo = [], withDeps = false }) {
@@ -164,6 +211,9 @@ function deployRemotes({ workspaceDir, restrictTo = [], withDeps = false }) {
       console.log(`  ext dir:       ${r.extDir}`);
       console.log(`  copied files:  ${r.copiedFiles}`);
     }
+    if (r.typings) {
+      console.log(`  typings:       ${r.typings.federationDir} (${r.typings.fileCount} files)`);
+    }
     results.push({ id, ...r });
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ws-test-realm/admin-kit",
-  "version": "0.6.5-ng20",
+  "version": "0.6.7-ng20",
   "description": "Workflow CLI + scaffolding for Wiresphere admin-modules workspaces (Angular 20 + native-federation line). Ships `ws-init-workspace`, `ws-modules` (build+deploy driver), `ws-generate-module`/`ws-drop-module`, `ws-wire-host`, `ws-wire-pom`, `ws-sync-paths`, and `ws-purge`. Depends on @ws-test-realm/devkit (toolchain BOM) + @ws-test-realm/shared (runtime BOM + native-federation share map).",
   "license": "Artistic-2.0",
   "publishConfig": {
@@ -28,7 +28,7 @@
   "dependencies": {
     "@angular-architects/native-federation": "^20.0.0",
     "@ws-test-realm/devkit": "^0.8.0-ng20",
-    "@ws-test-realm/shared": "^0.8.1-ng20",
+    "@ws-test-realm/shared": "^0.8.2-ng20",
     "adm-zip": "^0.5.10",
     "fast-xml-parser": "^4.3.0"
   }

package/template-module/federation.config.js

@@ -1,37 +1,39 @@
 const { withNativeFederation, share } = require('@angular-architects/native-federation/config');
-const { sharedDescriptors, WORKSPACE_LIBS } = require('@ws-test-realm/shared');
+const { remoteShared, remoteExternals } = require('@ws-test-realm/shared');
+
+// Consume-only federation. A new module bundles ONLY its own code by
+// default. Everything else (BOM @angular/* etc., sibling remotes,
+// contribution-owners' packages like tinymce or angular-jwt) is
+// externalized — esbuild emits bare imports; the runtime federation
+// import map (populated by host's initFederation before any module
+// evaluates) resolves to the singleton chunk provided by host /
+// contribution-owner. Missing share at runtime crashes explicitly.
+// See PINNED.md "no module duplication".
+//
+// If THIS module brings in a peer dep that no other remote provides
+// (e.g. db-login owns `@auth0/angular-jwt`), add it to `own` so this
+// module becomes the contribution-owner — it gets bundled here and
+// listed in remoteEntry.json as a share, then other remotes can
+// externalize it.
+const OWN = []; // e.g. ['@some/special-dep']
 
 module.exports = withNativeFederation({
 	name: '__camelName__Module',
 	exposes: {
 		// Thin re-export shim so the exposed chunk delegates to the singleton
-		// shared chunk for this package (declared in `shared` below). Without
-		// the shim, esbuild would inline the whole library here and decorator
-		// side effects would fire a second time on remote load.
+		// shared chunk for this package. Without the shim, esbuild would
+		// inline the whole library here and decorator side effects would
+		// fire a second time on remote load.
 		'./Module': './projects/__name__/src/exposed-module.ts',
 	},
-	// share() expands includeSecondaries against each package's exports field.
-	// withNativeFederation's own share() invocation is commented out upstream.
-	//
-	// Three flavors of entries below the share() spread:
-	//
-	//   1. Self-share `'__name__': WORKSPACE_LIBS` — emits a chunk + import-map
-	//      entry for THIS module so siblings consuming it via bare specifiers
-	//      get the same instance at runtime.
-	//
-	//   2. Cross-workspace siblings (e.g. `'ws-framework': WORKSPACE_LIBS`) —
-	//      add when this module imports from another admin module that lives
-	//      in a different workspace. admin-kit symlinks `node_modules/<name>`
-	//      to the fiddle's `.federation/<name>/` so esbuild can resolve.
-	//
-	//   3. Module-carried federation contributions — runtime libs THIS module
-	//      introduces for the federation, that aren't in `sharedDescriptors()`'s
-	//      default slice. Example: db-login carries `@auth0/angular-jwt`. The
-	//      module's project package.json should list these as
-	//      `peerDependencies` (not `dependencies`); ng-packagr leaves them as
-	//      bare imports, native-federation emits the chunk + share entry, and
-	//      the runtime singleton mechanism dedupes if other consumers ever
-	//      import them.
-	shared: { ...share(sharedDescriptors()), '__name__': WORKSPACE_LIBS },
-	skip: ['rxjs/ajax', 'rxjs/fetch', 'rxjs/testing', 'rxjs/webSocket'],
+	shared: share(remoteShared({ self: '__name__', own: OWN })),
+	externals: remoteExternals({ self: '__name__', own: OWN }),
+	skip: [
+		'rxjs/ajax',
+		'rxjs/fetch',
+		'rxjs/testing',
+		'rxjs/webSocket',
+		'@angular/cdk/testing',
+		'@angular/material/testing',
+	],
 });