@ng-prism/core 21.7.2 → 21.8.0

package/dist/app/services/prism-persistence.service.js

@@ -0,0 +1,139 @@
+import { effect, inject, Injectable, Injector } from '@angular/core';
+import { PRISM_CONFIG } from '../tokens/prism-tokens.js';
+import { A11yPanelStateService } from '../panels/a11y/a11y-panel-state.service.js';
+import { A11yPerspectiveService } from '../panels/a11y/a11y-perspective.service.js';
+import { PrismNavigationService } from './prism-navigation.service.js';
+import { PrismRendererService } from './prism-renderer.service.js';
+import * as i0 from "@angular/core";
+const STORAGE_KEY = 'ng-prism:state';
+const SCHEMA_VERSION = 1;
+const DEBOUNCE_MS = 200;
+export class PrismPersistenceService {
+    config = inject(PRISM_CONFIG, { optional: true }) ?? {};
+    navigationService = inject(PrismNavigationService);
+    rendererService = inject(PrismRendererService);
+    a11yPanelState = inject(A11yPanelStateService);
+    a11yPerspective = inject(A11yPerspectiveService);
+    injector = inject(Injector);
+    suppressSync = false;
+    writeTimer = null;
+    lastSerialized = null;
+    init() {
+        if (this.config.persistState === false)
+            return;
+        const { raw } = this.restoreFromStorage();
+        if (raw !== null)
+            this.lastSerialized = raw;
+        this.setupSyncEffect();
+    }
+    restoreFromStorage() {
+        let parsed = null;
+        let raw = null;
+        try {
+            raw = sessionStorage.getItem(STORAGE_KEY);
+            if (raw)
+                parsed = JSON.parse(raw);
+        }
+        catch {
+            parsed = null;
+            raw = null;
+        }
+        if (!parsed || parsed.version !== SCHEMA_VERSION)
+            return { raw: null };
+        this.suppressSync = true;
+        try {
+            const a11yTabs = ['violations', 'keyboard', 'tree', 'sr'];
+            if (parsed.a11y?.activeTab && a11yTabs.includes(parsed.a11y.activeTab)) {
+                this.a11yPanelState.activeTab.set(parsed.a11y.activeTab);
+            }
+            if (parsed.a11y?.perspective === 'visual' || parsed.a11y?.perspective === 'screen-reader') {
+                this.a11yPerspective.mode.set(parsed.a11y.perspective);
+            }
+            const activeComp = this.navigationService.activeComponent();
+            if (activeComp && parsed.inputs) {
+                const bucket = parsed.inputs[activeComp.meta.className];
+                if (bucket && bucket.variantIndex === this.rendererService.activeVariantIndex()) {
+                    const validKeys = new Set(activeComp.meta.inputs.map((i) => i.name));
+                    const filtered = {};
+                    for (const [k, v] of Object.entries(bucket.values)) {
+                        if (validKeys.has(k) || k === '__prismContent__')
+                            filtered[k] = v;
+                    }
+                    if (Object.keys(filtered).length > 0) {
+                        this.rendererService.inputValues.set({
+                            ...this.rendererService.inputValues(),
+                            ...filtered,
+                        });
+                    }
+                }
+            }
+        }
+        finally {
+            this.suppressSync = false;
+        }
+        return { raw };
+    }
+    setupSyncEffect() {
+        effect(() => {
+            this.navigationService.activeComponent();
+            this.rendererService.activeVariantIndex();
+            this.rendererService.inputValues();
+            this.a11yPanelState.activeTab();
+            this.a11yPerspective.mode();
+            if (this.suppressSync)
+                return;
+            this.writeDebounced();
+        }, { injector: this.injector });
+    }
+    writeDebounced() {
+        if (this.writeTimer)
+            clearTimeout(this.writeTimer);
+        this.writeTimer = setTimeout(() => {
+            this.writeTimer = null;
+            const state = this.serialize();
+            const next = JSON.stringify(state);
+            if (next === this.lastSerialized)
+                return;
+            try {
+                sessionStorage.setItem(STORAGE_KEY, next);
+                this.lastSerialized = next;
+            }
+            catch (err) {
+                console.warn('[ng-prism] Failed to persist state:', err);
+            }
+        }, DEBOUNCE_MS);
+    }
+    serialize() {
+        const activeComp = this.navigationService.activeComponent();
+        const variantIndex = this.rendererService.activeVariantIndex();
+        const values = this.rendererService.inputValues();
+        let inputs = {};
+        if (this.lastSerialized) {
+            try {
+                const prev = JSON.parse(this.lastSerialized);
+                if (prev.version === SCHEMA_VERSION)
+                    inputs = { ...prev.inputs };
+            }
+            catch {
+                inputs = {};
+            }
+        }
+        if (activeComp) {
+            inputs[activeComp.meta.className] = { variantIndex, values: { ...values } };
+        }
+        return {
+            version: SCHEMA_VERSION,
+            inputs,
+            a11y: {
+                activeTab: this.a11yPanelState.activeTab(),
+                perspective: this.a11yPerspective.mode(),
+            },
+        };
+    }
+    static ɵfac = function PrismPersistenceService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || PrismPersistenceService)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: PrismPersistenceService, factory: PrismPersistenceService.ɵfac, providedIn: 'root' });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(PrismPersistenceService, [{
+        type: Injectable,
+        args: [{ providedIn: 'root' }]
+    }], null, null); })();

package/dist/app/services/prism-renderer.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prism-renderer.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-renderer.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;;AAGrE,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE,QAAQ,CAAC,kBAAkB,iDAAa;IACxC,QAAQ,CAAC,WAAW,kEAAuC;IAC3D,QAAQ,CAAC,aAAa,sFAAkE;IACxF,QAAQ,CAAC,eAAe,yDAAgC;IAExD,OAAO,CAAC,cAAc,CAAuB;IAE7C,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAM/C,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAoCnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,OAAO,CAAC,YAAY;yCA9DT,oBAAoB;6CAApB,oBAAoB;CAuGhC"}
+{"version":3,"file":"prism-renderer.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-renderer.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;;AAGrE,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE,QAAQ,CAAC,kBAAkB,iDAAa;IACxC,QAAQ,CAAC,WAAW,kEAAuC;IAC3D,QAAQ,CAAC,aAAa,sFAAkE;IACxF,QAAQ,CAAC,eAAe,yDAAgC;IAExD,OAAO,CAAC,cAAc,CAAuB;IAE7C,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAM/C,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IA2CnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,OAAO,CAAC,YAAY;yCArET,oBAAoB;6CAApB,oBAAoB;CA8GhC"}

package/dist/app/services/prism-renderer.service.js

@@ -16,7 +16,7 @@ export class PrismRendererService {
     reconcileForComponent(comp) {
         const prev = this._lastClassName;
         this._lastClassName = comp.meta.className;
-        if (prev !== comp.meta.className) {
+        if (prev !== null && prev !== comp.meta.className) {
             this.activeVariantIndex.set(0);
             this.applyVariant(0, comp);
             return;
@@ -25,6 +25,12 @@ export class PrismRendererService {
         const maxIndex = Math.max(0, variants.length - 1);
         const preservedIndex = Math.min(this.activeVariantIndex(), maxIndex);
         this.activeVariantIndex.set(preservedIndex);
+        const defaults = {};
+        for (const input of comp.meta.inputs) {
+            if (input.defaultValue !== undefined) {
+                defaults[input.name] = input.defaultValue;
+            }
+        }
         const validKeys = new Set(comp.meta.inputs.map((i) => i.name));
         const currentValues = this.inputValues();
         const preserved = {};
@@ -35,7 +41,7 @@ export class PrismRendererService {
         }
         const variant = variants[preservedIndex];
         const variantInputs = variant?.inputs ?? {};
-        const merged = { ...variantInputs, ...preserved };
+        const merged = { ...defaults, ...variantInputs, ...preserved };
         if (comp.meta.componentMeta.isDirective && variant?.content && preserved['__prismContent__'] === undefined) {
             merged['__prismContent__'] = typeof variant.content === 'string' ? variant.content : '';
         }

package/dist/app/services/prism-url-state.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prism-url-state.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-url-state.service.ts"],"names":[],"mappings":";AAcA,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,IAAI,IAAI;IAiBZ,OAAO,CAAC,cAAc;IAsCtB,OAAO,CAAC,UAAU;yCAjEP,oBAAoB;6CAApB,oBAAoB;CAsGhC"}
+{"version":3,"file":"prism-url-state.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-url-state.service.ts"],"names":[],"mappings":";AAgBA,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,IAAI,IAAI;IAkBZ,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,UAAU;yCAtEP,oBAAoB;6CAApB,oBAAoB;CA+GhC"}

package/dist/app/services/prism-url-state.service.js

@@ -10,6 +10,8 @@ const PARAM_PAGE = 'page';
 const PARAM_VARIANT = 'variant';
 const PARAM_VIEW = 'view';
 const DEFAULT_VIEW = 'renderer';
+const PARAM_PANEL = 'panel';
+const DEFAULT_PANEL = 'controls';
 export class PrismUrlStateService {
     manifestService = inject(PrismManifestService);
     navigationService = inject(PrismNavigationService);
@@ -26,9 +28,10 @@ export class PrismUrlStateService {
             const item = this.navigationService.activeItem();
             const variantIndex = this.rendererService.activeVariantIndex();
             const viewId = this.panelService.activeViewId();
+            const panelId = this.panelService.activePanelId();
             if (this.suppressSync)
                 return;
-            this.writeToUrl(item, variantIndex, viewId);
+            this.writeToUrl(item, variantIndex, viewId, panelId);
         }, { injector: this.injector });
         window.addEventListener('popstate', () => this.restoreFromUrl());
     }
@@ -38,6 +41,7 @@ export class PrismUrlStateService {
         const pageTitle = params.get(PARAM_PAGE);
         const variantParam = params.get(PARAM_VARIANT);
         const viewId = params.get(PARAM_VIEW);
+        const panelId = params.get(PARAM_PANEL);
         this.suppressSync = true;
         try {
             if (componentClassName) {
@@ -64,12 +68,15 @@ export class PrismUrlStateService {
             if (viewId) {
                 this.panelService.activeViewId.set(viewId);
             }
+            if (panelId) {
+                this.panelService.activePanelId.set(panelId);
+            }
         }
         finally {
             this.suppressSync = false;
         }
     }
-    writeToUrl(item, variantIndex, viewId) {
+    writeToUrl(item, variantIndex, viewId, panelId) {
         const params = new URLSearchParams();
         if (item?.kind === 'component') {
             params.set(PARAM_COMPONENT, item.data.meta.className);
@@ -83,6 +90,9 @@ export class PrismUrlStateService {
         if (viewId && viewId !== DEFAULT_VIEW) {
             params.set(PARAM_VIEW, viewId);
         }
+        if (panelId && panelId !== DEFAULT_PANEL) {
+            params.set(PARAM_PANEL, panelId);
+        }
         const queryString = params.toString();
         const newUrl = queryString
             ? `${window.location.pathname}?${queryString}`

package/dist/app/shell/prism-shell.component.d.ts

@@ -10,6 +10,7 @@ export declare class PrismShellComponent {
     protected readonly panelService: PrismPanelService;
     private readonly pluginService;
     private readonly urlStateService;
+    private readonly persistenceService;
     protected readonly viewPanels: import("@angular/core").Signal<import("../../plugin/plugin.types.js").PanelDefinition[]>;
     protected readonly showPanel: import("@angular/core").Signal<boolean>;
     protected readonly shellStyle: import("@angular/core").Signal<string>;

package/dist/app/shell/prism-shell.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prism-shell.component.d.ts","sourceRoot":"","sources":["../../../src/app/shell/prism-shell.component.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;;AAiBvE,qBA2Pa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,SAAS,CAAC,QAAQ,CAAC,iBAAiB,yBAAkC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,SAAS,CAAC,QAAQ,CAAC,MAAM,qBAA8B;IACvD,SAAS,CAAC,QAAQ,CAAC,YAAY,oBAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAEhE,SAAS,CAAC,QAAQ,CAAC,UAAU,2FAG1B;IAEH,SAAS,CAAC,QAAQ,CAAC,SAAS,0CAK1B;IAEF,SAAS,CAAC,QAAQ,CAAC,UAAU,yCAG1B;;IAgCH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;yCAxDhC,mBAAmB;2CAAnB,mBAAmB;CAyE/B"}
+{"version":3,"file":"prism-shell.component.d.ts","sourceRoot":"","sources":["../../../src/app/shell/prism-shell.component.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;;AAkBvE,qBA2Pa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,SAAS,CAAC,QAAQ,CAAC,iBAAiB,yBAAkC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,SAAS,CAAC,QAAQ,CAAC,MAAM,qBAA8B;IACvD,SAAS,CAAC,QAAQ,CAAC,YAAY,oBAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAmC;IAEtE,SAAS,CAAC,QAAQ,CAAC,UAAU,2FAG1B;IAEH,SAAS,CAAC,QAAQ,CAAC,SAAS,0CAK1B;IAEF,SAAS,CAAC,QAAQ,CAAC,UAAU,yCAG1B;;IAiCH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;yCA1DhC,mBAAmB;2CAAnB,mBAAmB;CA2E/B"}

package/dist/app/shell/prism-shell.component.js

@@ -14,6 +14,7 @@ import { PrismSidebarComponent } from '../sidebar/prism-sidebar.component.js';
 import { PrismPageRendererComponent } from '../page-renderer/prism-page-renderer.component.js';
 import { BUILTIN_PANELS } from '../panels/builtin-panels.js';
 import { PrismUrlStateService } from '../services/prism-url-state.service.js';
+import { PrismPersistenceService } from '../services/prism-persistence.service.js';
 import { PrismViewTabBarComponent } from '../view-tab-bar/prism-view-tab-bar.component.js';
 import { PrismViewPanelHostComponent } from '../view-tab-bar/prism-view-panel-host.component.js';
 import { PrismResizerDirective } from '../directives/prism-resizer.directive.js';
@@ -105,6 +106,7 @@ export class PrismShellComponent {
     panelService = inject(PrismPanelService);
     pluginService = inject(PrismPluginService);
     urlStateService = inject(PrismUrlStateService);
+    persistenceService = inject(PrismPersistenceService);
     viewPanels = computed(() => [
         ...BUILTIN_PANELS.filter((p) => p.placement === 'view'),
         ...this.pluginService.viewPanels(),
@@ -120,6 +122,7 @@ export class PrismShellComponent {
         this.themeService.applyConfigOverrides(this.config);
         this.navigationService.selectFirst();
         this.urlStateService.init();
+        this.persistenceService.init();
         let lastItemKey = null;
         effect(() => {
             const item = this.navigationService.activeItem();
@@ -309,4 +312,4 @@ export class PrismShellComponent {
             type: HostListener,
             args: ['document:keydown', ['$event']]
         }] }); })();
-(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(PrismShellComponent, { className: "PrismShellComponent", filePath: "app/shell/prism-shell.component.ts", lineNumber: 283 }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(PrismShellComponent, { className: "PrismShellComponent", filePath: "app/shell/prism-shell.component.ts", lineNumber: 284 }); })();

package/dist/builder/config-loader/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/builder/config-loader/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAsB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BrF"}
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/builder/config-loader/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAsB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAsCrF"}

package/dist/builder/config-loader/config-loader.js

@@ -1,12 +1,17 @@
 import '@angular/compiler';
 import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
-import { join } from 'path';
+import { resolve, sep } from 'path';
 import { pathToFileURL } from 'url';
 import ts from 'typescript';
 const DEFAULT_CONFIG_FILE = 'ng-prism.config.ts';
 export async function loadConfig(options) {
     const configFileName = options.configFileName ?? DEFAULT_CONFIG_FILE;
-    const configPath = join(options.workspaceRoot, configFileName);
+    const workspaceRoot = resolve(options.workspaceRoot);
+    const configPath = resolve(workspaceRoot, configFileName);
+    if (configPath !== workspaceRoot && !configPath.startsWith(workspaceRoot + sep)) {
+        throw new Error(`ng-prism: configFile "${configFileName}" resolves outside workspace root (${workspaceRoot}). ` +
+            `Provide a path relative to the workspace.`);
+    }
     if (!existsSync(configPath)) {
         return {};
     }
@@ -19,7 +24,8 @@ export async function loadConfig(options) {
             esModuleInterop: true,
         },
     });
-    const tempPath = configPath.replace(/\.ts$/, '.tmp.mjs');
+    const uniqueSuffix = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const tempPath = configPath.replace(/\.ts$/, `.${uniqueSuffix}.tmp.mjs`);
     try {
         writeFileSync(tempPath, transpiled.outputText, 'utf-8');
         const module = await import(pathToFileURL(tempPath).href);

package/dist/builder/plugin-runner/plugin-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-runner.d.ts","sourceRoot":"","sources":["../../../src/builder/plugin-runner/plugin-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAoB,MAAM,8BAA8B,CAAC;AAGnG,wBAAsB,cAAc,CAClC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC,aAAa,CAAC,CA2CxB"}
+{"version":3,"file":"plugin-runner.d.ts","sourceRoot":"","sources":["../../../src/builder/plugin-runner/plugin-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAoB,MAAM,8BAA8B,CAAC;AAmBnG,wBAAsB,cAAc,CAClC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC,aAAa,CAAC,CAuDxB"}

package/dist/builder/plugin-runner/plugin-runner.js

@@ -1,25 +1,46 @@
+function pluginLabel(plugin) {
+    return plugin.name ? `"${plugin.name}"` : '<unnamed>';
+}
+function wrapPluginError(plugin, hook, target, err) {
+    const cause = err instanceof Error ? err.message : String(err);
+    const wrapped = new Error(`ng-prism: plugin ${pluginLabel(plugin)} failed in ${hook} for ${target} — ${cause}`, err instanceof Error ? { cause: err } : undefined);
+    if (err instanceof Error && err.stack) {
+        wrapped.stack = `${wrapped.message}\nCaused by: ${err.stack}`;
+    }
+    return wrapped;
+}
 export async function runPluginHooks(manifest, plugins) {
-    let components = [...manifest.components];
-    for (const comp of components) {
-        let current = comp;
+    const components = [...manifest.components];
+    for (let i = 0; i < components.length; i++) {
+        let current = components[i];
         for (const plugin of plugins) {
             if (plugin.onComponentScanned) {
-                const result = await plugin.onComponentScanned(current);
-                if (result) {
-                    current = result;
+                try {
+                    const result = await plugin.onComponentScanned(current);
+                    if (result) {
+                        current = result;
+                    }
+                }
+                catch (err) {
+                    throw wrapPluginError(plugin, 'onComponentScanned', `component "${current.className}"`, err);
                 }
             }
         }
-        components[components.indexOf(comp)] = current;
+        components[i] = current;
     }
-    let pages = [...(manifest.pages ?? [])];
+    const pages = [...(manifest.pages ?? [])];
     for (let i = 0; i < pages.length; i++) {
         let current = pages[i];
         for (const plugin of plugins) {
             if (plugin.onPageScanned) {
-                const result = await plugin.onPageScanned(current);
-                if (result) {
-                    current = result;
+                try {
+                    const result = await plugin.onPageScanned(current);
+                    if (result) {
+                        current = result;
+                    }
+                }
+                catch (err) {
+                    throw wrapPluginError(plugin, 'onPageScanned', `page "${current.title}"`, err);
                 }
             }
         }
@@ -28,9 +49,14 @@ export async function runPluginHooks(manifest, plugins) {
     let result = { components, pages };
     for (const plugin of plugins) {
         if (plugin.onManifestReady) {
-            const updated = await plugin.onManifestReady(result);
-            if (updated) {
-                result = updated;
+            try {
+                const updated = await plugin.onManifestReady(result);
+                if (updated) {
+                    result = updated;
+                }
+            }
+            catch (err) {
+                throw wrapPluginError(plugin, 'onManifestReady', 'manifest', err);
             }
         }
     }

package/dist/builder/scanner/component.scanner.js

@@ -16,14 +16,14 @@ export function scanComponents(exports, checker) {
         const showcaseDecorator = findDecorator(classDecl, 'Showcase');
         if (!showcaseDecorator)
             continue;
-        const showcaseConfig = extractShowcaseConfig(showcaseDecorator);
+        const className = classDecl.name?.text ?? 'Anonymous';
+        const showcaseConfig = extractShowcaseConfig(showcaseDecorator, className);
         if (!showcaseConfig)
             continue;
         const componentMeta = extractComponentMeta(classDecl);
         const inputs = extractInputs(classDecl, checker);
         const outputs = extractOutputs(classDecl, checker);
         const filePath = classDecl.getSourceFile().fileName;
-        const className = classDecl.name?.text ?? 'Anonymous';
         if (hasDecoratorInputs(classDecl)) {
             console.warn(`⚠ ng-prism: ${className} uses @Input() decorators which are not fully supported. ` +
                 `Migrate to input() signals for full ng-prism support.`);
@@ -48,13 +48,18 @@ function hasDecoratorInputs(classDecl) {
     }
     return false;
 }
-function extractShowcaseConfig(decorator) {
+function extractShowcaseConfig(decorator, className) {
     const arg = getDecoratorArgument(decorator);
     if (!arg)
         return undefined;
     const raw = evaluateExpression(arg);
-    if (!raw || typeof raw !== 'object' || !('title' in raw))
+    if (!raw || typeof raw !== 'object')
         return undefined;
+    if (!('title' in raw)) {
+        console.warn(`⚠ ng-prism: ${className} has @Showcase without a "title" field — skipping. ` +
+            `Add a title so it can appear in the styleguide.`);
+        return undefined;
+    }
     const obj = raw;
     const config = {
         title: obj['title'],

package/dist/builder/scanner/entry-point-discovery.js

@@ -6,6 +6,24 @@ export function discoverSecondaryEntryPoints(libraryRoot, baseImportPath) {
     return entryPoints;
 }
 function findNgPackageJsons(dir, libraryRoot, baseImportPath, result) {
+    const isLibraryRoot = dir === libraryRoot;
+    const ngPackagePath = join(dir, 'ng-package.json');
+    if (existsSync(ngPackagePath)) {
+        const ngPackage = JSON.parse(readFileSync(ngPackagePath, 'utf-8'));
+        if (!ngPackage.dest) {
+            const entryFile = ngPackage.lib?.entryFile ?? 'public-api.ts';
+            const entryFilePath = join(dir, entryFile);
+            if (existsSync(entryFilePath)) {
+                const relDir = relative(libraryRoot, dir);
+                const importPath = relDir === ''
+                    ? baseImportPath
+                    : posix.join(baseImportPath, relDir.split('\\').join('/'));
+                result.push({ entryFile: entryFilePath, importPath });
+            }
+            if (!isLibraryRoot)
+                return;
+        }
+    }
     let entries;
     try {
         entries = readdirSync(dir);
@@ -17,22 +35,13 @@ function findNgPackageJsons(dir, libraryRoot, baseImportPath, result) {
         if (entry === 'node_modules' || entry === '.git')
             continue;
         const fullPath = join(dir, entry);
-        if (!statSync(fullPath).isDirectory())
-            continue;
-        const ngPackagePath = join(fullPath, 'ng-package.json');
-        if (!existsSync(ngPackagePath)) {
-            findNgPackageJsons(fullPath, libraryRoot, baseImportPath, result);
-            continue;
+        try {
+            if (!statSync(fullPath).isDirectory())
+                continue;
         }
-        const ngPackage = JSON.parse(readFileSync(ngPackagePath, 'utf-8'));
-        if (ngPackage.dest)
+        catch {
             continue;
-        const entryFile = ngPackage.lib?.entryFile ?? 'public-api.ts';
-        const entryFilePath = join(fullPath, entryFile);
-        if (!existsSync(entryFilePath))
-            continue;
-        const relDir = relative(libraryRoot, fullPath);
-        const importPath = posix.join(baseImportPath, relDir.split('\\').join('/'));
-        result.push({ entryFile: entryFilePath, importPath });
+        }
+        findNgPackageJsons(fullPath, libraryRoot, baseImportPath, result);
     }
 }

package/dist/builder/serve/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAA2C,MAAM,2BAA2B,CAAC;AACjH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA0DtD,QAAA,MAAM,OAAO,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAyD,CAAC;AACrH,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAA2C,MAAM,2BAA2B,CAAC;AACjH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA+DtD,QAAA,MAAM,OAAO,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAyD,CAAC;AACrH,eAAe,OAAO,CAAC"}

package/dist/builder/serve/index.js

@@ -24,8 +24,8 @@ async function createServeBuilder(options, context) {
             await runPrismPipeline(pipelineOptions, context, state);
         },
         logger: {
-            info: (msg) => console.log(msg),
-            error: (msg) => console.error(msg),
+            info: (msg) => context.logger.info(msg),
+            error: (msg) => context.logger.error(msg),
         },
     });
     const run = await context.scheduleTarget({ project: options.prismProject, target: 'serve', configuration: '' }, { port: options.port ?? 4400 });
@@ -33,14 +33,18 @@ async function createServeBuilder(options, context) {
         watcher.close();
         run.stop();
     };
+    const cleanupSignals = () => {
+        process.off('SIGINT', shutdown);
+        process.off('SIGTERM', shutdown);
+    };
     process.once('SIGINT', shutdown);
     process.once('SIGTERM', shutdown);
     return new Promise((resolve, reject) => {
         let lastOutput;
         run.output.subscribe({
             next: (output) => { lastOutput = output; },
-            error: (err) => { shutdown(); reject(err); },
-            complete: () => { watcher.close(); resolve(lastOutput ?? { success: false }); },
+            error: (err) => { cleanupSignals(); shutdown(); reject(err); },
+            complete: () => { cleanupSignals(); watcher.close(); resolve(lastOutput ?? { success: false }); },
         });
     });
 }

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

@@ -55,10 +55,18 @@ function writeManifestIfChanged(manifestPath, newContent) {
     }
     const tempPath = manifestPath + '.tmp';
     writeFileSync(tempPath, newContent, 'utf-8');
-    if (existsSync(manifestPath)) {
-        unlinkSync(manifestPath);
+    try {
+        renameSync(tempPath, manifestPath);
+    }
+    catch (err) {
+        if (existsSync(tempPath)) {
+            try {
+                unlinkSync(tempPath);
+            }
+            catch { /* best-effort cleanup */ }
+        }
+        throw err;
     }
-    renameSync(tempPath, manifestPath);
     return true;
 }
 function isDirectory(path) {

package/dist/builder/watcher/prism-watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prism-watcher.d.ts","sourceRoot":"","sources":["../../../src/builder/watcher/prism-watcher.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0ChF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAkCxE"}
+{"version":3,"file":"prism-watcher.d.ts","sourceRoot":"","sources":["../../../src/builder/watcher/prism-watcher.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqDhF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAkCxE"}

package/dist/builder/watcher/prism-watcher.js

@@ -5,7 +5,37 @@ export function createChangeHandler(options) {
     const { onRebuild, logger, debounceMs = 300 } = options;
     let timer = null;
     let isRebuilding = false;
+    let pendingChange = false;
     let disposed = false;
+    async function triggerRebuild() {
+        if (disposed)
+            return;
+        if (isRebuilding) {
+            pendingChange = true;
+            return;
+        }
+        isRebuilding = true;
+        pendingChange = false;
+        logger.info('ng-prism: Change detected, re-scanning...');
+        try {
+            await onRebuild();
+            if (!disposed) {
+                logger.info('ng-prism: Re-scan complete.');
+            }
+        }
+        catch (err) {
+            if (!disposed) {
+                logger.error(`ng-prism: Re-scan failed — ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        finally {
+            isRebuilding = false;
+            if (!disposed && pendingChange) {
+                pendingChange = false;
+                void triggerRebuild();
+            }
+        }
+    }
     function handleChange(filename) {
         if (disposed)
             return;
@@ -13,26 +43,7 @@ export function createChangeHandler(options) {
             return;
         if (timer)
             clearTimeout(timer);
-        timer = setTimeout(async () => {
-            if (disposed || isRebuilding)
-                return;
-            isRebuilding = true;
-            logger.info('ng-prism: Change detected, re-scanning...');
-            try {
-                await onRebuild();
-                if (!disposed) {
-                    logger.info('ng-prism: Re-scan complete.');
-                }
-            }
-            catch (err) {
-                if (!disposed) {
-                    logger.error(`ng-prism: Re-scan failed — ${err instanceof Error ? err.message : String(err)}`);
-                }
-            }
-            finally {
-                isRebuilding = false;
-            }
-        }, debounceMs);
+        timer = setTimeout(triggerRebuild, debounceMs);
     }
     function dispose() {
         disposed = true;

package/dist/config/index.d.ts

@@ -1,6 +1,6 @@
 export { defineConfig } from '../plugin/define-config.js';
 export { customPage, componentPage } from '../plugin/page-helpers.js';
-export type { ComponentPageOptions } from '../plugin/page-helpers.js';
+export type { ComponentPageOptions, CustomPageOptions } from '../plugin/page-helpers.js';
 export type { NgPrismConfig, NgPrismPlugin } from '../plugin/plugin.types.js';
 export type { StyleguidePage, CustomPage, ComponentPage } from '../plugin/page.types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/plugin/define-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/plugin/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEjE"}
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/plugin/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAGjE"}