@ng-prism/core 21.12.0 → 22.0.0-beta.1

package/dist/schematics/ng-add/index.js

@@ -1,6 +1,6 @@
 import { chain, SchematicsException, } from '@angular-devkit/schematics';
 import { NodePackageInstallTask } from '@angular-devkit/schematics/tasks';
-import { parse as parseJsonc, modify as modifyJsonc, applyEdits as applyJsoncEdits, } from 'jsonc-parser';
+import { addTsConfigPath } from '../utils/tsconfig-paths.js';
 function readWorkspace(tree) {
     const buffer = tree.read('angular.json');
     if (!buffer) {
@@ -27,7 +27,7 @@ function addPrismAppProject(options) {
                 "import { provideZonelessChangeDetection } from '@angular/core';",
                 "import { bootstrapApplication } from '@angular/platform-browser';",
                 "import { PrismShellComponent, providePrism } from '@ng-prism/core';",
-                "import { PRISM_RUNTIME_MANIFEST } from './prism-manifest';",
+                `import { PRISM_RUNTIME_MANIFEST } from 'prism-manifest/${prismProjectName}';`,
                 "import config from 'ng-prism.config';",
                 '',
                 'bootstrapApplication(PrismShellComponent, {',
@@ -41,7 +41,7 @@ function addPrismAppProject(options) {
             : [
                 "import { bootstrapApplication } from '@angular/platform-browser';",
                 "import { PrismShellComponent, providePrism } from '@ng-prism/core';",
-                "import { PRISM_RUNTIME_MANIFEST } from './prism-manifest';",
+                `import { PRISM_RUNTIME_MANIFEST } from 'prism-manifest/${prismProjectName}';`,
                 "import config from 'ng-prism.config';",
                 '',
                 'bootstrapApplication(PrismShellComponent, {',
@@ -77,10 +77,14 @@ function addPrismAppProject(options) {
                 extends: '../../tsconfig.json',
                 compilerOptions: {
                     outDir: '../../out-tsc/app',
+                    rootDir: '../..',
                     types: [],
                 },
                 files: ['src/main.ts'],
-                include: ['src/**/*.d.ts'],
+                include: [
+                    'src/**/*.d.ts',
+                    `../../.ng-prism/${prismProjectName}/**/*.ts`,
+                ],
             };
             tree.create(tsconfigAppPath, JSON.stringify(tsconfigApp, null, 2) + '\n');
         }
@@ -180,32 +184,20 @@ function addBuilderTargets(options) {
 function addTsConfigPaths(options) {
     return (tree, _context) => {
         const tsConfigPath = 'tsconfig.json';
-        const buffer = tree.read(tsConfigPath);
-        if (!buffer) {
+        if (!tree.read(tsConfigPath))
             return tree;
-        }
-        const sourceText = buffer.toString('utf-8');
-        const tsConfig = parseJsonc(sourceText);
-        const existingPaths = tsConfig.compilerOptions?.paths ?? {};
         const workspace = readWorkspace(tree);
         const project = workspace.projects[options.project];
         const sourceRoot = project.sourceRoot ?? `${project.root}/src`;
-        const formattingOptions = { tabSize: 2, insertSpaces: true };
-        let nextText = sourceText;
-        let changed = false;
-        if (!existingPaths['ng-prism.config']) {
-            const edits = modifyJsonc(nextText, ['compilerOptions', 'paths', 'ng-prism.config'], ['ng-prism.config.ts'], { formattingOptions });
-            nextText = applyJsoncEdits(nextText, edits);
-            changed = true;
-        }
-        if (!existingPaths[options.project]) {
-            const edits = modifyJsonc(nextText, ['compilerOptions', 'paths', options.project], [`${sourceRoot}/public-api.ts`], { formattingOptions });
-            nextText = applyJsoncEdits(nextText, edits);
-            changed = true;
-        }
-        if (changed) {
-            tree.overwrite(tsConfigPath, nextText);
-        }
+        addTsConfigPath(tree, tsConfigPath, 'ng-prism.config', [
+            './ng-prism.config.ts',
+        ]);
+        addTsConfigPath(tree, tsConfigPath, options.project, [
+            `./${sourceRoot}/public-api.ts`,
+        ]);
+        addTsConfigPath(tree, tsConfigPath, 'prism-manifest/*', [
+            './.ng-prism/*/prism-manifest.ts',
+        ]);
         return tree;
     };
 }
@@ -225,24 +217,6 @@ function createConfigFile() {
         return tree;
     };
 }
-function addGitignoreEntry(options) {
-    return (tree) => {
-        const prismProjectName = `${options.project}-prism`;
-        const entry = `projects/${prismProjectName}/src/prism-manifest.ts`;
-        const gitignorePath = '.gitignore';
-        const buffer = tree.read(gitignorePath);
-        if (buffer) {
-            const content = buffer.toString('utf-8');
-            if (content.includes(entry))
-                return tree;
-            tree.overwrite(gitignorePath, content.trimEnd() + '\n' + entry + '\n');
-        }
-        else {
-            tree.create(gitignorePath, entry + '\n');
-        }
-        return tree;
-    };
-}
 const RUNTIME_PEER_DEPS = {
     'highlight.js': '^11.0.0',
     'ngx-highlightjs': '^14.0.0',
@@ -284,6 +258,23 @@ function logSetupSummary(options) {
         context.logger.info('');
     };
 }
+function addNgPrismGitignoreEntry() {
+    return (tree) => {
+        const entry = '.ng-prism/';
+        const gitignorePath = '.gitignore';
+        const buffer = tree.read(gitignorePath);
+        if (buffer) {
+            const content = buffer.toString('utf-8');
+            if (content.split('\n').some((line) => line.trim() === entry))
+                return tree;
+            tree.overwrite(gitignorePath, content.trimEnd() + '\n' + entry + '\n');
+        }
+        else {
+            tree.create(gitignorePath, entry + '\n');
+        }
+        return tree;
+    };
+}
 function addStripShowcaseScript(options) {
     return (tree) => {
         const pkgPath = 'package.json';
@@ -306,9 +297,9 @@ export function ngAdd(options) {
         addPrismAppProject(options),
         addBuilderTargets(options),
         addTsConfigPaths(options),
+        addNgPrismGitignoreEntry(),
         createConfigFile(),
         addStripShowcaseScript(options),
-        addGitignoreEntry(options),
         addRuntimePeerDeps(),
         logSetupSummary(options),
     ]);

package/dist/schematics/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './config-ast.js';
+export { addTsConfigPath } from './tsconfig-paths.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/schematics/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schematics/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schematics/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/schematics/utils/index.js

@@ -1 +1,2 @@
 export * from './config-ast.js';
+export { addTsConfigPath } from './tsconfig-paths.js';

package/dist/schematics/utils/tsconfig-paths.d.ts

@@ -0,0 +1,8 @@
+import type { Tree } from '@angular-devkit/schematics';
+/**
+ * Adds `compilerOptions.paths[<key>] = <value>` to a tsconfig.json (JSONC-safe).
+ * Idempotent: does not overwrite an existing entry.
+ * Returns true when an entry was added, false otherwise (already present or file missing).
+ */
+export declare function addTsConfigPath(tree: Tree, tsConfigPath: string, key: string, value: string[]): boolean;
+//# sourceMappingURL=tsconfig-paths.d.ts.map

package/dist/schematics/utils/tsconfig-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-paths.d.ts","sourceRoot":"","sources":["../../../src/schematics/utils/tsconfig-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAevD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAkBT"}

package/dist/schematics/utils/tsconfig-paths.js

@@ -0,0 +1,20 @@
+import { parse as parseJsonc, modify as modifyJsonc, applyEdits as applyJsoncEdits, } from 'jsonc-parser';
+/**
+ * Adds `compilerOptions.paths[<key>] = <value>` to a tsconfig.json (JSONC-safe).
+ * Idempotent: does not overwrite an existing entry.
+ * Returns true when an entry was added, false otherwise (already present or file missing).
+ */
+export function addTsConfigPath(tree, tsConfigPath, key, value) {
+    const buffer = tree.read(tsConfigPath);
+    if (!buffer)
+        return false;
+    const sourceText = buffer.toString('utf-8');
+    const parsed = parseJsonc(sourceText);
+    const existing = parsed.compilerOptions?.paths ?? {};
+    if (existing[key])
+        return false;
+    const edits = modifyJsonc(sourceText, ['compilerOptions', 'paths', key], value, { formattingOptions: { tabSize: 2, insertSpaces: true } });
+    const nextText = applyJsoncEdits(sourceText, edits);
+    tree.overwrite(tsConfigPath, nextText);
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-prism/core",
-  "version": "21.12.0",
+  "version": "22.0.0-beta.1",
   "description": "ng-prism — the Angular-native Storybook alternative. Lightweight component showcase with @Showcase decorator, no story files needed.",
   "keywords": [
     "ng-prism",
@@ -60,6 +60,9 @@
   "ng-add": {
     "save": "devDependencies"
   },
+  "ng-update": {
+    "migrations": "./schematics/migrations.json"
+  },
   "schematics": "./schematics/collection.json",
   "builders": "./builders.json",
   "files": [
@@ -71,11 +74,11 @@
     "!**/*.tsbuildinfo"
   ],
   "peerDependencies": {
-    "@angular/core": ">=21.0.0",
-    "@angular/common": ">=21.0.0",
-    "@angular-devkit/architect": ">=0.2100.0",
-    "@angular-devkit/core": ">=21.0.0",
-    "@angular-devkit/schematics": ">=21.0.0",
+    "@angular/core": ">=20.0.0",
+    "@angular/common": ">=20.0.0",
+    "@angular-devkit/architect": ">=0.2000.0",
+    "@angular-devkit/core": ">=20.0.0",
+    "@angular-devkit/schematics": ">=20.0.0",
     "typescript": ">=5.5.0",
     "highlight.js": ">=11.0.0",
     "ngx-highlightjs": ">=14.0.0"

package/schematics/migrations.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "migration-v22-manifest-cache": {
+      "version": "22.0.0-beta.0",
+      "description": "Move generated prism-manifest.ts into <workspaceRoot>/.ng-prism/<prismProject>/ and resolve it via a wildcard tsconfig path mapping.",
+      "factory": "../dist/schematics/migrations/v21-13-manifest-cache/index#migrate"
+    }
+  }
+}

package/src/builder/build/schema.json

@@ -28,6 +28,10 @@
       "type": "string",
       "default": "ng-prism.config.ts",
       "description": "Path to the ng-prism config file"
+    },
+    "cacheDir": {
+      "type": "string",
+      "description": "Override directory for the generated prism-manifest.ts. Default: <workspaceRoot>/.ng-prism/<prismProject>/. Relative paths resolve against workspaceRoot."
     }
   },
   "required": ["entryPoint", "prismProject"],

package/src/builder/serve/schema.json

@@ -29,6 +29,10 @@
       "type": "string",
       "default": "ng-prism.config.ts",
       "description": "Path to the ng-prism config file"
+    },
+    "cacheDir": {
+      "type": "string",
+      "description": "Override directory for the generated prism-manifest.ts. Default: <workspaceRoot>/.ng-prism/<prismProject>/. Relative paths resolve against workspaceRoot."
     }
   },
   "required": ["entryPoint", "prismProject"],