@ng-prism/core 22.0.0-beta.3 → 22.0.0-beta.4

package/dist/builder/shared/prism-pipeline.d.ts

@@ -5,7 +5,7 @@ export interface PrismPipelineOptions {
     libraryImportPath: string;
     prismProject: string;
     configFile: string;
-    /** Absolute path. If omitted, defaults to `<workspaceRoot>/.ng-prism/<prismProject>`. */
+    /** Absolute path. If omitted, defaults to `<workspaceRoot>/ng-prism-cache/<prismProject>`. */
     cacheDir?: string;
 }
 export interface PrismPipelineResult {

package/dist/builder/shared/prism-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prism-pipeline.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/prism-pipeline.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAYpE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,oGAAoG;IACpG,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAyE9B"}
+{"version":3,"file":"prism-pipeline.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/prism-pipeline.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAYpE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,oGAAoG;IACpG,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAyE9B"}

package/dist/builder/shared/prism-pipeline.js

@@ -1,5 +1,5 @@
 import { join, dirname } from 'path';
-import { writeFileSync, readFileSync, mkdirSync, statSync, renameSync, existsSync, unlinkSync, } from 'fs';
+import { writeFileSync, readFileSync, mkdirSync, statSync, existsSync, } from 'fs';
 import ts from 'typescript';
 import { createScanner } from '../scanner/scanner.js';
 import { discoverSecondaryEntryPoints } from '../scanner/entry-point-discovery.js';
@@ -45,7 +45,8 @@ export async function runPrismPipeline(options, context, state) {
         pages: manifest.pages,
         meta: manifest.meta,
     });
-    const cacheDir = options.cacheDir ?? join(workspaceRoot, '.ng-prism', options.prismProject);
+    const cacheRoot = options.cacheDir ?? join(workspaceRoot, 'ng-prism-cache');
+    const cacheDir = join(cacheRoot, options.prismProject);
     const manifestPath = join(cacheDir, 'prism-manifest.ts');
     mkdirSync(cacheDir, { recursive: true });
     const written = writeManifestIfChanged(manifestPath, source);
@@ -69,22 +70,17 @@ function writeManifestIfChanged(manifestPath, newContent) {
             return false;
         }
     }
-    const tempPath = manifestPath + '.tmp';
-    writeFileSync(tempPath, newContent, 'utf-8');
-    try {
-        renameSync(tempPath, manifestPath);
-    }
-    catch (err) {
-        if (existsSync(tempPath)) {
-            try {
-                unlinkSync(tempPath);
-            }
-            catch {
-                /* best-effort cleanup */
-            }
-        }
-        throw err;
-    }
+    // In-place write (truncate + write to the existing inode). The previous
+    // implementation used a temp file + atomic rename, which produces a fresh
+    // inode on every write. That breaks file watchers — most importantly Vite's
+    // — when the manifest lives in a cache dir outside the prism project's
+    // source root: Vite watches the file by path/inode, loses the handle on
+    // rename, and never picks up subsequent rewrites. The result for the user
+    // is that @Showcase changes never trigger an HMR / reload. The window
+    // between truncate and write is small (single syscall for kilobyte-sized
+    // manifests), so the risk of a bundler observing a partial file is
+    // negligible in practice.
+    writeFileSync(manifestPath, newContent, 'utf-8');
     return true;
 }
 function isDirectory(path) {

package/dist/schematics/migrations/v21-13-manifest-cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/schematics/migrations/v21-13-manifest-cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,MAAM,4BAA4B,CAAC;AAsK/E,wBAAgB,OAAO,IAAI,IAAI,CAiB9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/schematics/migrations/v21-13-manifest-cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,MAAM,4BAA4B,CAAC;AAiM/E,wBAAgB,OAAO,IAAI,IAAI,CAiB9B"}

package/dist/schematics/migrations/v21-13-manifest-cache/index.js

@@ -1,8 +1,18 @@
 import { addTsConfigPath } from '../../utils/tsconfig-paths.js';
 const OLD_IMPORT = /^import\s+\{\s*PRISM_RUNTIME_MANIFEST\s*\}\s+from\s+['"](?:\.\/prism-manifest|prism-manifest)['"]\s*;?$/m;
+/**
+ * Matches a Vite HMR accept call whose dependency target is the legacy
+ * `./prism-manifest` module specifier. Captures everything after the dep
+ * argument so the rewrite preserves the original callback and trailing
+ * code verbatim.
+ */
+const OLD_HMR_ACCEPT = /\.accept\s*\(\s*(['"])\.\/prism-manifest\1\s*(,)/g;
 function buildNewImport(prismProject) {
     return `import { PRISM_RUNTIME_MANIFEST } from 'prism-manifest/${prismProject}';`;
 }
+function buildNewHmrAcceptTarget(prismProject) {
+    return `.accept('prism-manifest/${prismProject}',`;
+}
 function readWorkspace(tree) {
     const buffer = tree.read('angular.json');
     if (!buffer)
@@ -34,24 +44,36 @@ function rewriteMainTs(tree, context, workspace, prismProject) {
     if (!buffer)
         return;
     const newImport = buildNewImport(prismProject);
+    const newHmrTarget = buildNewHmrAcceptTarget(prismProject);
     const content = buffer.toString('utf-8');
-    if (content.includes(newImport))
+    const importMatches = OLD_IMPORT.test(content);
+    const hmrMatches = OLD_HMR_ACCEPT.test(content);
+    OLD_HMR_ACCEPT.lastIndex = 0;
+    if (content.includes(newImport) && !hmrMatches)
         return;
-    if (!OLD_IMPORT.test(content)) {
+    let next = content;
+    if (importMatches) {
+        next = next.replace(OLD_IMPORT, newImport);
+    }
+    else if (!next.includes(newImport)) {
         context.logger.warn(`ng-prism migration: could not find PRISM_RUNTIME_MANIFEST import in ${mainPath}. ` +
             `Update it manually to: ${newImport}`);
-        return;
     }
-    tree.overwrite(mainPath, content.replace(OLD_IMPORT, newImport));
+    if (hmrMatches) {
+        next = next.replace(OLD_HMR_ACCEPT, newHmrTarget);
+    }
+    if (next !== content) {
+        tree.overwrite(mainPath, next);
+    }
 }
 function addTsConfigMapping(tree) {
     addTsConfigPath(tree, 'tsconfig.json', 'prism-manifest/*', [
-        './.ng-prism/*/prism-manifest.ts',
+        './ng-prism-cache/*/prism-manifest.ts',
     ]);
 }
 function ensureNgPrismGitignoreEntry(tree) {
     const path = '.gitignore';
-    const entry = '.ng-prism/';
+    const entry = 'ng-prism-cache/';
     const buffer = tree.read(path);
     if (!buffer) {
         tree.create(path, entry + '\n');
@@ -88,7 +110,7 @@ function addCacheIncludeToTsconfigApp(tree, workspace, prismProject) {
     const include = Array.isArray(parsed.include)
         ? parsed.include
         : [];
-    const includeEntry = `../../.ng-prism/${prismProject}/**/*.ts`;
+    const includeEntry = `../../ng-prism-cache/${prismProject}/**/*.ts`;
     const includeChanged = !include.includes(includeEntry);
     const nextInclude = includeChanged ? [...include, includeEntry] : include;
     const compilerOptions = { ...(parsed.compilerOptions ?? {}) };

package/dist/schematics/migrations/v22-0-cache-dir-rename/index.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '@angular-devkit/schematics';
+export declare function migrate(): Rule;
+//# sourceMappingURL=index.d.ts.map

package/dist/schematics/migrations/v22-0-cache-dir-rename/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/schematics/migrations/v22-0-cache-dir-rename/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,MAAM,4BAA4B,CAAC;AAmJ/E,wBAAgB,OAAO,IAAI,IAAI,CAsB9B"}

package/dist/schematics/migrations/v22-0-cache-dir-rename/index.js

@@ -0,0 +1,138 @@
+import { addTsConfigPath } from '../../utils/tsconfig-paths.js';
+const OLD_DIR = '.ng-prism';
+const NEW_DIR = 'ng-prism-cache';
+const OLD_GITIGNORE_ENTRY = '.ng-prism/';
+const NEW_GITIGNORE_ENTRY = 'ng-prism-cache/';
+const OLD_PATH_MAPPING = './.ng-prism/*/prism-manifest.ts';
+const NEW_PATH_MAPPING = './ng-prism-cache/*/prism-manifest.ts';
+function readWorkspace(tree) {
+    const buffer = tree.read('angular.json');
+    if (!buffer)
+        return undefined;
+    return JSON.parse(buffer.toString('utf-8'));
+}
+function findPrismProjects(workspace) {
+    const projects = workspace.projects ?? {};
+    const result = [];
+    for (const [, project] of Object.entries(projects)) {
+        const architect = project.architect ?? {};
+        for (const target of Object.values(architect)) {
+            if (target.builder === '@ng-prism/core:serve') {
+                const prismProject = target.options?.['prismProject'];
+                if (typeof prismProject === 'string' &&
+                    !result.includes(prismProject)) {
+                    result.push(prismProject);
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Replace the `prism-manifest/*` path mapping if it still points at the old
+ * `.ng-prism/` location, while preserving any user customisation that already
+ * uses a different target.
+ */
+function updateTsConfigMapping(tree, context) {
+    const buffer = tree.read('tsconfig.json');
+    if (!buffer)
+        return;
+    let parsed;
+    try {
+        parsed = JSON.parse(buffer.toString('utf-8'));
+    }
+    catch {
+        context.logger.warn('ng-prism migration: tsconfig.json could not be parsed; skipping path-mapping update. Update "prism-manifest/*" to ' +
+            `["${NEW_PATH_MAPPING}"] manually.`);
+        return;
+    }
+    const existing = parsed.compilerOptions?.paths?.['prism-manifest/*'];
+    if (!existing) {
+        // No existing mapping — fall through to addTsConfigPath which inserts the new default.
+        addTsConfigPath(tree, 'tsconfig.json', 'prism-manifest/*', [
+            NEW_PATH_MAPPING,
+        ]);
+        return;
+    }
+    // Replace any entries that still reference the legacy dot-dir; leave the rest alone.
+    const updated = existing.map((entry) => entry === OLD_PATH_MAPPING ? NEW_PATH_MAPPING : entry);
+    if (updated.every((entry, i) => entry === existing[i]))
+        return;
+    parsed.compilerOptions.paths['prism-manifest/*'] = updated;
+    tree.overwrite('tsconfig.json', JSON.stringify(parsed, null, 2) + '\n');
+}
+function updateTsConfigAppInclude(tree, workspace, prismProject) {
+    const project = workspace.projects?.[prismProject];
+    const projectRoot = project?.root ?? `projects/${prismProject}`;
+    const path = `${projectRoot}/tsconfig.app.json`;
+    const buffer = tree.read(path);
+    if (!buffer)
+        return;
+    const sourceText = buffer.toString('utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(sourceText);
+    }
+    catch {
+        return;
+    }
+    if (!Array.isArray(parsed.include))
+        return;
+    const oldEntry = `../../${OLD_DIR}/${prismProject}/**/*.ts`;
+    const newEntry = `../../${NEW_DIR}/${prismProject}/**/*.ts`;
+    const include = parsed.include;
+    const oldIndex = include.indexOf(oldEntry);
+    if (oldIndex === -1 && include.includes(newEntry))
+        return;
+    if (oldIndex === -1)
+        return;
+    const next = [...include];
+    next[oldIndex] = newEntry;
+    // Avoid duplicates if user already had both entries for some reason.
+    const deduped = Array.from(new Set(next));
+    const updated = { ...parsed, include: deduped };
+    tree.overwrite(path, JSON.stringify(updated, null, 2) + '\n');
+}
+function renameGitignoreEntry(tree) {
+    const path = '.gitignore';
+    const buffer = tree.read(path);
+    if (!buffer)
+        return;
+    const content = buffer.toString('utf-8');
+    const lines = content.split('\n');
+    let changed = false;
+    const next = lines.map((line) => {
+        if (line.trim() === OLD_GITIGNORE_ENTRY) {
+            changed = true;
+            return line.replace(OLD_GITIGNORE_ENTRY, NEW_GITIGNORE_ENTRY);
+        }
+        return line;
+    });
+    if (!changed) {
+        // Ensure the new entry exists even if the old one was already missing.
+        if (next.some((line) => line.trim() === NEW_GITIGNORE_ENTRY))
+            return;
+        tree.overwrite(path, content.trimEnd() + '\n' + NEW_GITIGNORE_ENTRY + '\n');
+        return;
+    }
+    tree.overwrite(path, next.join('\n'));
+}
+export function migrate() {
+    return (tree, context) => {
+        const workspace = readWorkspace(tree);
+        if (!workspace)
+            return tree;
+        const prismProjects = findPrismProjects(workspace);
+        if (prismProjects.length === 0)
+            return tree;
+        updateTsConfigMapping(tree, context);
+        for (const prismProject of prismProjects) {
+            updateTsConfigAppInclude(tree, workspace, prismProject);
+        }
+        renameGitignoreEntry(tree);
+        context.logger.info('ng-prism migration: cache directory renamed from .ng-prism/ to ng-prism-cache/. ' +
+            'You can safely delete the old .ng-prism/ directory from your workspace — ' +
+            'the builder will regenerate the manifest on next serve/build run.');
+        return tree;
+    };
+}

package/dist/schematics/ng-add/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schematics/ng-add/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAIV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAqWtD,wBAAgB,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAWvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schematics/ng-add/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAIV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkXtD,wBAAgB,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAWvD"}

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

@@ -22,31 +22,43 @@ function addPrismAppProject(options) {
         const prismRoot = `projects/${prismProjectName}`;
         const prismSrc = `${prismRoot}/src`;
         const zoneless = options.zoneless === true;
+        const hotConst = "const hot = (import.meta as ImportMeta & { hot?: { accept(dep: string, cb: (mod: { PRISM_RUNTIME_MANIFEST: typeof PRISM_RUNTIME_MANIFEST } | undefined) => void): void } }).hot;";
+        const hmrThen = [
+            '.then((appRef) => {',
+            `  hot?.accept('prism-manifest/${prismProjectName}', (mod) => {`,
+            '    if (mod) enablePrismHmr(appRef, mod.PRISM_RUNTIME_MANIFEST);',
+            '  });',
+            '});',
+        ].join('\n');
         const mainTs = zoneless
             ? [
                 "import { provideZonelessChangeDetection } from '@angular/core';",
                 "import { bootstrapApplication } from '@angular/platform-browser';",
-                "import { PrismShellComponent, providePrism } from '@ng-prism/core';",
+                "import { enablePrismHmr, PrismShellComponent, providePrism } from '@ng-prism/core';",
                 `import { PRISM_RUNTIME_MANIFEST } from 'prism-manifest/${prismProjectName}';`,
                 "import config from 'ng-prism.config';",
                 '',
+                hotConst,
+                '',
                 'bootstrapApplication(PrismShellComponent, {',
                 '  providers: [',
                 '    provideZonelessChangeDetection(),',
                 '    providePrism(PRISM_RUNTIME_MANIFEST, config),',
                 '  ],',
-                '});',
+                '})' + hmrThen,
                 '',
             ].join('\n')
             : [
                 "import { bootstrapApplication } from '@angular/platform-browser';",
-                "import { PrismShellComponent, providePrism } from '@ng-prism/core';",
+                "import { enablePrismHmr, PrismShellComponent, providePrism } from '@ng-prism/core';",
                 `import { PRISM_RUNTIME_MANIFEST } from 'prism-manifest/${prismProjectName}';`,
                 "import config from 'ng-prism.config';",
                 '',
+                hotConst,
+                '',
                 'bootstrapApplication(PrismShellComponent, {',
                 '  providers: [providePrism(PRISM_RUNTIME_MANIFEST, config)],',
-                '});',
+                '})' + hmrThen,
                 '',
             ].join('\n');
         if (!tree.exists(`${prismSrc}/main.ts`)) {
@@ -83,7 +95,7 @@ function addPrismAppProject(options) {
                 files: ['src/main.ts'],
                 include: [
                     'src/**/*.d.ts',
-                    `../../.ng-prism/${prismProjectName}/**/*.ts`,
+                    `../../ng-prism-cache/${prismProjectName}/**/*.ts`,
                 ],
             };
             tree.create(tsconfigAppPath, JSON.stringify(tsconfigApp, null, 2) + '\n');
@@ -196,7 +208,7 @@ function addTsConfigPaths(options) {
             `./${sourceRoot}/public-api.ts`,
         ]);
         addTsConfigPath(tree, tsConfigPath, 'prism-manifest/*', [
-            './.ng-prism/*/prism-manifest.ts',
+            './ng-prism-cache/*/prism-manifest.ts',
         ]);
         return tree;
     };
@@ -260,7 +272,7 @@ function logSetupSummary(options) {
 }
 function addNgPrismGitignoreEntry() {
     return (tree) => {
-        const entry = '.ng-prism/';
+        const entry = 'ng-prism-cache/';
         const gitignorePath = '.gitignore';
         const buffer = tree.read(gitignorePath);
         if (buffer) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-prism/core",
-  "version": "22.0.0-beta.3",
+  "version": "22.0.0-beta.4",
   "description": "ng-prism — the Angular-native Storybook alternative. Lightweight component showcase with @Showcase decorator, no story files needed.",
   "keywords": [
     "ng-prism",

package/schematics/migrations.json

@@ -3,8 +3,13 @@
   "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.",
+      "description": "Move generated prism-manifest.ts into <workspaceRoot>/ng-prism-cache/<prismProject>/ and resolve it via a wildcard tsconfig path mapping.",
       "factory": "../dist/schematics/migrations/v21-13-manifest-cache/index#migrate"
+    },
+    "migration-v22-cache-dir-rename": {
+      "version": "22.0.0-beta.4",
+      "description": "Rename the manifest cache directory from .ng-prism/ to ng-prism-cache/. The dot-prefixed name was silently excluded from @angular/build's watcher (hardcoded **/.*/** ignore pattern), so @Showcase decorator edits never triggered an HMR / reload.",
+      "factory": "../dist/schematics/migrations/v22-0-cache-dir-rename/index#migrate"
     }
   }
 }