@ojiepermana/angular 21.1.9 → 21.1.11

package/generator/api/README.md

@@ -18,6 +18,9 @@ bun run gen:sdk:init
 
 # 3. Edit sdk.config.json, then generate
 bun run gen:sdk
+
+# 4. Run the split-by-domain regression checks
+bun run test:gen:sdk
 ```
 
 ## Consumer usage after publish
@@ -174,17 +177,21 @@ client primitives land in `shared/`.
 
 Every domain folder contains `services/`, `fn/`, `models/`, `permissions/`,
 and its own `public-api.ts` (which re-exports `shared/public-api` for
-convenience). The root `public-api.ts` aggregates `shared` plus every domain,
-so consumers can still do `import { UserService } from './sdk'` regardless of
-layout.
+convenience). The root still owns the aggregate metadata barrel:
+`metadata.ts`, `openapi-helpers.ts`, and `permissions/index.ts` stay at the SDK
+root so `shared/` never depends on sibling domains. The root `public-api.ts`
+aggregates `shared`, root metadata helpers, and every domain, so consumers can
+still do `import { UserService } from './sdk'` regardless of layout.
 
 Model ownership rule (per-domain mode):
 
 - A model used by exactly one domain → emitted inside that domain's `models/`.
 - A model shared across two or more domains → emitted inside `shared/models/`.
 - Client primitives (`ApiConfiguration`, `BaseService`, `RequestBuilder`,
-  `StrictHttpResponse`, `Api`), metadata, validators, and the top-level
-  `permissions/index.ts` always live under `shared/`.
+  `StrictHttpResponse`, `Api`), shared metadata types, validators, and
+  navigation always live under `shared/`.
+- Aggregate metadata helpers (`metadata.ts`, `openapi-helpers.ts`) and the
+  top-level `permissions/index.ts` stay at the SDK root.
 
 Example consumption when using `mode: 'library'` with `splitByDomain: true`:
 
@@ -197,11 +204,11 @@ import { GCSService } from '@my-scope/sdk/storage/gcs'; // splitDepth: 'tag'
 
 ## Output modes
 
-| Mode                   | What it emits                                                                             | Use when…                                                                              |
-| ---------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| `standalone`           | A plain folder (no `ng-package.json`).                                                    | You consume the SDK via path alias / `tsconfig.paths` inside the same app.             |
-| `library`              | Standalone output **plus** `ng-package.json`, `package.json` (peerDeps), and `README.md`. | You want to build it with ng-packagr and publish to npm.                               |
-| `secondary-entrypoint` | Standalone output **plus** a minimal `ng-package.json` pointing at `public-api.ts`.       | You drop the folder inside an existing library so ng-packagr picks it up as a subpath. |
+| Mode                   | What it emits                                                                                                                                                       | Use when…                                                                              |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `standalone`           | A plain folder (no `ng-package.json`).                                                                                                                              | You consume the SDK via path alias / `tsconfig.paths` inside the same app.             |
+| `library`              | Standalone output **plus** `ng-package.json`, `package.json` (peerDeps), `README.md`, and nested `ng-package.json` files for split-by-domain secondary entrypoints. | You want to build it with ng-packagr and publish to npm.                               |
+| `secondary-entrypoint` | Standalone output **plus** a minimal `ng-package.json` pointing at `public-api.ts`, plus nested `ng-package.json` files for split-by-domain secondary entrypoints.  | You drop the folder inside an existing library so ng-packagr picks it up as a subpath. |
 
 ## Feature flags
 

package/generator/api/bin/schematics/sdk/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdk = sdk;
+exports.writeResult = writeResult;
 const node_path_1 = require("node:path");
 const loader_1 = require("../../src/config/loader");
 const engine_1 = require("../../src/engine");
@@ -39,6 +40,7 @@ function writeResult(tree, workspaceRoot, result, context) {
     context.logger.info(`[sdk] ${result.target.mode} → ${relOutput} ` +
         `(schemas=${result.stats.schemas}, operations=${result.stats.operations}, ` +
         `tags=${result.stats.tags}, files=${result.stats.files})`);
+    removeStaleFiles(tree, workspaceRoot, result);
     for (const file of result.files) {
         const absolute = (0, node_path_1.resolve)(result.outputDir, file.path);
         const treePath = normalizeTreePath(workspaceRoot, absolute);
@@ -51,6 +53,22 @@ function writeResult(tree, workspaceRoot, result, context) {
         }
     }
 }
+function removeStaleFiles(tree, workspaceRoot, result) {
+    const outputRoot = normalizeTreePath(workspaceRoot, result.outputDir);
+    if (outputRoot === '/') {
+        return;
+    }
+    const nextFiles = new Set(result.files.map((file) => normalizeTreePath(workspaceRoot, (0, node_path_1.resolve)(result.outputDir, file.path))));
+    const staleFiles = [];
+    tree.getDir(outputRoot).visit((path) => {
+        if (!nextFiles.has(path)) {
+            staleFiles.push(path);
+        }
+    });
+    for (const staleFile of staleFiles) {
+        tree.delete(staleFile);
+    }
+}
 function normalizeTreePath(workspaceRoot, absolute) {
     const rel = (0, node_path_1.relative)(workspaceRoot, absolute);
     const posix = rel.split(/\\+/).join('/');

package/generator/api/bin/src/layout/per-domain.js

@@ -7,7 +7,10 @@ exports.relayoutPerDomain = relayoutPerDomain;
  *
  * ```
  *   <outputDir>/
- *     shared/                 client primitives, shared models, metadata, validators
+ *     shared/                 client primitives, shared models, metadata types, validators
+ *     metadata.ts             aggregate metadata barrel (root only)
+ *     openapi-helpers.ts      metadata helpers (root only)
+ *     permissions/index.ts    aggregate operation rules (root only)
  *     <domain>/               one folder per OpenAPI tag (kebab-cased)
  *       models/               models only referenced by this domain
  *       fn/                   tree-shakeable operation functions for this domain
@@ -191,12 +194,13 @@ function computeNewPath(oldPath, ctx) {
         'strict-http-response.ts',
         'api.ts',
         'api.navigation.ts',
-        'metadata.ts',
         'metadata-types.ts',
-        'openapi-helpers.ts',
     ]);
     if (rootShared.has(oldPath))
         return `${SHARED}/${oldPath}`;
+    if (oldPath === 'metadata.ts' || oldPath === 'openapi-helpers.ts') {
+        return oldPath;
+    }
     if (oldPath.startsWith('models/')) {
         const kebab = oldPath.slice('models/'.length).replace(/\.ts$/, '');
         const name = ctx.kebabToSchema.get(kebab);
@@ -220,7 +224,7 @@ function computeNewPath(oldPath, ctx) {
         return `${domain}/services/${fileName}`;
     }
     if (oldPath === 'permissions/index.ts')
-        return `${SHARED}/permissions/index.ts`;
+        return oldPath;
     if (oldPath.startsWith('permissions/')) {
         const fileName = oldPath.slice('permissions/'.length);
         const tagKebab = fileName.replace(/\.ts$/, '');
@@ -269,7 +273,7 @@ function rewriteImports(content, oldPath, newPath, oldToNew) {
 function emitPublicApis(ir, target, mapping) {
     const out = [];
     const schemaNames = ir.schemas.map((s) => s.name);
-    // shared/public-api.ts — client primitives + shared models + metadata.
+    // shared/public-api.ts — shared primitives + shared models only.
     const sharedLines = [target.banner, ''];
     if (target.features.client) {
         sharedLines.push(`export { ApiConfiguration, provideApiConfiguration } from './api-configuration';`);
@@ -288,8 +292,8 @@ function emitPublicApis(ir, target, mapping) {
             sharedLines.push('');
     }
     if (target.features.metadata) {
-        sharedLines.push(`export * from './metadata';`);
-        sharedLines.push(`export * from './openapi-helpers';`);
+        sharedLines.push(`export * from './metadata-types';`);
+        sharedLines.push(`export * from './validators';`);
         sharedLines.push('');
     }
     if (target.features.navigation) {
@@ -338,6 +342,10 @@ function emitPublicApis(ir, target, mapping) {
     // Root public-api.ts aggregates everything.
     const rootLines = [target.banner, ''];
     rootLines.push(`export * from './${SHARED}/public-api';`);
+    if (target.features.metadata) {
+        rootLines.push(`export * from './metadata';`);
+        rootLines.push(`export * from './openapi-helpers';`);
+    }
     for (const domain of mapping.domains) {
         rootLines.push(`export * from './${domain}/public-api';`);
     }

package/generator/api/bin/src/writer/index.js

@@ -35,10 +35,8 @@ function writeLibrary(files, ir, target) {
     };
     return [
         ...files,
-        {
-            path: 'ng-package.json',
-            content: (0, template_1.finalize)(JSON.stringify(ngPackage, null, 2)),
-        },
+        createNgPackageFile('ng-package.json', ngPackage),
+        ...createNestedEntrypointNgPackages(files),
         {
             path: 'package.json',
             content: (0, template_1.finalize)(JSON.stringify(pkg, null, 2)),
@@ -59,11 +57,26 @@ function writeSecondaryEntrypoint(files, _ir, _target) {
     const ngPackage = {
         lib: { entryFile: 'public-api.ts' },
     };
-    return [
-        ...files,
-        {
-            path: 'ng-package.json',
-            content: (0, template_1.finalize)(JSON.stringify(ngPackage, null, 2)),
-        },
-    ];
+    return [...files, createNgPackageFile('ng-package.json', ngPackage), ...createNestedEntrypointNgPackages(files)];
+}
+function createNestedEntrypointNgPackages(files) {
+    return collectSecondaryEntrypointDirs(files).map((dir) => createNgPackageFile(`${dir}/ng-package.json`, {
+        lib: { entryFile: 'public-api.ts' },
+    }));
+}
+function collectSecondaryEntrypointDirs(files) {
+    const dirs = new Set();
+    for (const file of files) {
+        if (!file.path.endsWith('/public-api.ts')) {
+            continue;
+        }
+        dirs.add(file.path.slice(0, -'/public-api.ts'.length));
+    }
+    return [...dirs].sort();
+}
+function createNgPackageFile(path, content) {
+    return {
+        path,
+        content: (0, template_1.finalize)(JSON.stringify(content, null, 2)),
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ojiepermana/angular",
-  "version": "21.1.9",
+  "version": "21.1.11",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ojiepermana/angular.git"