@ng-prism/core 22.2.1 → 22.4.0

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

@@ -1,12 +1,12 @@
-import { join, dirname } from 'path';
-import { writeFileSync, readFileSync, mkdirSync, statSync, existsSync, } from 'fs';
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
 import ts from 'typescript';
-import { createScanner } from '../scanner/scanner.js';
-import { discoverSecondaryEntryPoints } from '../scanner/entry-point-discovery.js';
+import { checkA11yThresholds, DEFAULT_A11Y_REPORT_PATH, readA11yForComponents, readA11yMeta } from '../a11y/a11y-report-reader.js';
 import { loadConfig } from '../config-loader/config-loader.js';
-import { runPluginHooks } from '../plugin-runner/plugin-runner.js';
 import { generateRuntimeManifest } from '../manifest/runtime-manifest.generator.js';
-import { DEFAULT_A11Y_REPORT_PATH, checkA11yThresholds, readA11yForComponents, readA11yMeta, } from '../a11y/a11y-report-reader.js';
+import { runPluginHooks } from '../plugin-runner/plugin-runner.js';
+import { discoverSecondaryEntryPoints } from '../scanner/entry-point-discovery.js';
+import { createScanner } from '../scanner/scanner.js';
 export function createPipelineState() {
     return { scanner: undefined, lastEntrySetKey: undefined };
 }
@@ -15,24 +15,24 @@ export async function runPrismPipeline(options, context, state) {
     context.reportStatus('Loading ng-prism config...');
     const config = await loadConfig({
         workspaceRoot,
-        configFileName: options.configFile,
+        configFileName: options.configFile
     });
     context.reportStatus('Scanning components...');
-    const scanResult = scanEntryPoints(workspaceRoot, options, state);
+    const { components, diagnostics } = scanEntryPoints(workspaceRoot, options, state);
+    if (config.strictShowcase && diagnostics.length > 0) {
+        throw new Error(`ng-prism: strictShowcase is enabled and ${diagnostics.length} @Showcase value(s) were dropped; see the warnings above.`);
+    }
     const pages = config.pages ? [...config.pages] : [];
     context.reportStatus('Running plugin hooks...');
-    let manifest = await runPluginHooks({ ...scanResult, pages }, config.plugins ?? []);
+    let manifest = await runPluginHooks({ components, pages }, config.plugins ?? []);
     const a11yReportPath = config.a11y?.reportPath ?? DEFAULT_A11Y_REPORT_PATH;
     const a11yReportPathAbs = join(workspaceRoot, a11yReportPath);
     const a11yMeta = readA11yMeta(a11yReportPathAbs, config.a11y?.thresholds);
     if (a11yMeta) {
         const violations = checkA11yThresholds(a11yMeta);
         if (violations.length > 0) {
-            const summary = violations
-                .map((v) => `${v.metric}: ${v.actual} (threshold ${v.threshold})`)
-                .join(', ');
-            throw new Error(`ng-prism: a11y thresholds violated — ${summary}. ` +
-                `Update components or relax thresholds via config.a11y.thresholds.`);
+            const summary = violations.map((v) => `${v.metric}: ${v.actual} (threshold ${v.threshold})`).join(', ');
+            throw new Error(`ng-prism: a11y thresholds violated: ${summary}. ` + `Update components or relax thresholds via config.a11y.thresholds.`);
         }
         // Read once, not once per component: the reader re-stats the file on every
         // call even when its cache hits, so a per-component lookup scales the
@@ -48,11 +48,11 @@ export async function runPrismPipeline(options, context, state) {
                     ...component,
                     showcaseConfig: {
                         ...component.showcaseConfig,
-                        meta: { ...component.showcaseConfig.meta, a11y },
-                    },
+                        meta: { ...component.showcaseConfig.meta, a11y }
+                    }
                 };
             }),
-            meta: { ...manifest.meta, a11y: a11yMeta },
+            meta: { ...manifest.meta, a11y: a11yMeta }
         };
     }
     context.reportStatus('Generating runtime manifest...');
@@ -60,7 +60,7 @@ export async function runPrismPipeline(options, context, state) {
         components: manifest.components,
         libraryImportPath: options.libraryImportPath,
         pages: manifest.pages,
-        meta: manifest.meta,
+        meta: manifest.meta
     });
     const cacheRoot = options.cacheDir ?? join(workspaceRoot, 'ng-prism-cache');
     const cacheDir = join(cacheRoot, options.prismProject);
@@ -72,12 +72,12 @@ export async function runPrismPipeline(options, context, state) {
     context.logger.info(`ng-prism: ${written ? 'Generated' : 'Verified (unchanged)'} manifest ` +
         `with ${manifest.components.length} component(s)` +
         (pageCount > 0 ? ` and ${pageCount} page(s)` : '') +
-        ` → ${manifestPath}`);
+        ` at ${manifestPath}`);
     return {
         manifestPath,
         componentCount: manifest.components.length,
         pageCount,
-        written,
+        written
     };
 }
 function writeManifestIfChanged(manifestPath, newContent) {
@@ -87,16 +87,11 @@ function writeManifestIfChanged(manifestPath, newContent) {
             return false;
         }
     }
-    // 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.
+    // Write in place (truncate + write, same inode). A temp file + atomic
+    // rename creates a new inode each time, and Vite's watcher loses the file
+    // when the manifest lives in a cache dir outside the project's source
+    // root, so @Showcase changes would stop triggering HMR. The manifest is
+    // only kilobytes, so a bundler seeing a partial write is unlikely.
     writeFileSync(manifestPath, newContent, 'utf-8');
     return true;
 }
@@ -139,12 +134,8 @@ function resolveEntryPoints(workspaceRoot, options) {
     const absoluteEntryPoint = join(workspaceRoot, options.entryPoint);
     const compilerOptions = resolveTsconfigPaths(dirname(absoluteEntryPoint));
     const entryIsDirectory = isDirectory(absoluteEntryPoint);
-    const libraryRoot = entryIsDirectory
-        ? absoluteEntryPoint
-        : findLibraryRoot(absoluteEntryPoint);
-    const discovered = libraryRoot
-        ? discoverSecondaryEntryPoints(libraryRoot, options.libraryImportPath)
-        : [];
+    const libraryRoot = entryIsDirectory ? absoluteEntryPoint : findLibraryRoot(absoluteEntryPoint);
+    const discovered = libraryRoot ? discoverSecondaryEntryPoints(libraryRoot, options.libraryImportPath) : [];
     // Fallback to a direct file scan when:
     //  - the entry is a file and no ng-package.json was found above it, OR
     //  - the entry is a file with an ng-package.json above it but discovery found nothing
@@ -153,8 +144,8 @@ function resolveEntryPoints(workspaceRoot, options) {
         ? [
             {
                 entryFile: absoluteEntryPoint,
-                importPath: options.libraryImportPath,
-            },
+                importPath: options.libraryImportPath
+            }
         ]
         : discovered;
     return { entryPoints, compilerOptions };

package/dist/builder/shared/resolve-cache-dir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-cache-dir.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/resolve-cache-dir.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAGpB"}
+{"version":3,"file":"resolve-cache-dir.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/resolve-cache-dir.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrG"}

package/dist/builder/shared/resolve-cache-dir.js

@@ -1,4 +1,4 @@
-import { join, isAbsolute } from 'path';
+import { isAbsolute, join } from 'path';
 /**
  * Normalizes a user-provided `cacheDir` builder option to an absolute path
  * (or `undefined` when the option is empty/unset).

package/dist/builder/watcher/index.d.ts

@@ -1,3 +1,3 @@
 export { createChangeHandler, startWatcher } from './prism-watcher.js';
-export type { ChangeHandler, ChangeHandlerOptions, WatcherHandle, StartWatcherOptions } from './prism-watcher.js';
+export type { ChangeHandler, ChangeHandlerOptions, StartWatcherOptions, WatcherHandle } from './prism-watcher.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

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,CAqDhF;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;IACjC,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;CACvB;AAED,MAAM,WAAW,aAAa;IAC1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAChC,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;CACvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqDhF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CA0CxE"}

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

@@ -1,6 +1,6 @@
-import chokidar from 'chokidar';
-import { dirname } from 'path';
 import { statSync } from 'fs';
+import { dirname } from 'path';
+import chokidar from 'chokidar';
 export function createChangeHandler(options) {
     const { onRebuild, logger, debounceMs = 300 } = options;
     let timer = null;
@@ -25,7 +25,7 @@ export function createChangeHandler(options) {
         }
         catch (err) {
             if (!disposed) {
-                logger.error(`ng-prism: Re-scan failed — ${err instanceof Error ? err.message : String(err)}`);
+                logger.error(`ng-prism: Re-scan failed: ${err instanceof Error ? err.message : String(err)}`);
             }
         }
         finally {
@@ -57,12 +57,14 @@ export function createChangeHandler(options) {
 export function startWatcher(options) {
     const { entryPoint, configFile, ignorePaths, onRebuild, logger, debounceMs } = options;
     const handler = createChangeHandler({ onRebuild, logger, debounceMs });
-    const isDir = (() => { try {
-        return statSync(entryPoint).isDirectory();
-    }
-    catch {
-        return false;
-    } })();
+    const isDir = (() => {
+        try {
+            return statSync(entryPoint).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    })();
     const watchPaths = [isDir ? entryPoint : dirname(entryPoint)];
     if (configFile) {
         watchPaths.push(configFile);
@@ -74,17 +76,17 @@ export function startWatcher(options) {
     const watcher = chokidar.watch(watchPaths, {
         ignored: ignorePatterns,
         ignoreInitial: true,
-        persistent: true,
+        persistent: true
     });
     watcher.on('change', (filePath) => handler.handleChange(filePath));
     watcher.on('add', (filePath) => handler.handleChange(filePath));
     watcher.on('unlink', (filePath) => handler.handleChange(filePath));
-    watcher.on('error', (err) => logger.error(`ng-prism: Watcher error — ${err instanceof Error ? err.message : String(err)}`));
+    watcher.on('error', (err) => logger.error(`ng-prism: Watcher error: ${err instanceof Error ? err.message : String(err)}`));
     logger.info(`ng-prism: Watching ${watchPaths.join(', ')} for changes...`);
     return {
         close() {
             handler.dispose();
             watcher.close();
-        },
+        }
     };
 }

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 { componentPage, customPage } 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';
+export type { ComponentPage, CustomPage, StyleguidePage } 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,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"}
+{"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,aAAa,EAAE,UAAU,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,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/config/index.js

@@ -1,2 +1,2 @@
 export { defineConfig } from '../plugin/define-config.js';
-export { customPage, componentPage } from '../plugin/page-helpers.js';
+export { componentPage, customPage } from '../plugin/page-helpers.js';

package/dist/decorator/index.d.ts

@@ -1,3 +1,3 @@
-export type { ShowcaseConfig, Variant, ComponentStatus, InputsOf, } from './showcase.types.js';
+export type { ComponentStatus, InputsOf, ShowcaseConfig, Variant } from './showcase.types.js';
 export { Showcase } from './showcase.decorator.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorator/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,OAAO,EACP,eAAe,EACf,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorator/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/decorator/showcase.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"showcase.decorator.d.ts","sourceRoot":"","sources":["../../src/decorator/showcase.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,cAAc,CAEhB"}
+{"version":3,"file":"showcase.decorator.d.ts","sourceRoot":"","sources":["../../src/decorator/showcase.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAEhF"}

package/dist/decorator/showcase.types.d.ts

@@ -16,7 +16,7 @@ type UnwrapSignalInput<S> = S extends InputSignalWithTransform<any, infer WriteT
  * (`input()`, `input.required()`, `model()`), unwrapping each to its value type.
  * `output()` and other properties are excluded.
  *
- * When `T` is `unknown` (the default — no generic argument given), falls back
+ * When `T` is `unknown` (the default, i.e. no generic argument given), falls back
  * to `Record<string, unknown>` so existing call sites without a generic param
  * keep working.
  */
@@ -26,7 +26,7 @@ export type InputsOf<T> = [unknown] extends [T] ? Record<string, unknown> : {
 export interface ShowcaseConfig<T = unknown> {
     /** Display name in the ng-prism UI */
     title: string;
-    /** Description text — Markdown supported */
+    /** Description text, Markdown supported */
     description?: string;
     /** Groups the component in the sidebar */
     category?: string;
@@ -36,14 +36,14 @@ export interface ShowcaseConfig<T = unknown> {
     componentOrder?: number;
     /**
      * Top-level section in the sidebar. Auto-detected if omitted:
-     * `@Directive` → 'Directives', otherwise 'Components'. Free-form string —
+     * 'Directives' for a `@Directive`, otherwise 'Components'. Free-form string:
      * any value creates a new top-level section (e.g. 'Pipes', 'Utilities').
      */
     section?: string;
     /**
      * Sort order of this section in the sidebar (lower = higher in list).
      * The section's effective order is the minimum `sectionOrder` of all its items.
-     * Defaults: 'Components' → 0, 'Directives' → 10, all others → 100.
+     * Defaults: 'Components' 0, 'Directives' 10, all others 100.
      */
     sectionOrder?: number;
     /** Predefined variants shown as tabs */
@@ -51,9 +51,11 @@ export interface ShowcaseConfig<T = unknown> {
     /** Tags for search and filtering */
     tags?: string[];
     /**
-     * Providers for a child injector scoped to this component.
-     * Use for components that require specific services (e.g. DialogService, OverlayService).
-     * For library-wide providers, use defineConfig({ appProviders }).
+     * @deprecated Deprecated since 22.4.0, removed in 23.0.0. Never reached
+     * the styleguide: providers are classes, factories or instances, which the
+     * static manifest cannot hold, so the build drops them with a warning. Use
+     * `defineConfig({ appProviders })`, or, for one component, a component
+     * page (`renderPage`) that declares them.
      */
     providers?: Provider[];
     /** Arbitrary metadata for plugins (e.g. { figma: 'https://...' }) */
@@ -93,8 +95,8 @@ export interface Variant<T = unknown> {
     inputs?: Partial<InputsOf<T>>;
     /**
      * Content projected into <ng-content>.
-     * - string → projected into the default (unnamed) slot
-     * - Record<string, string> → keys are slot selectors (e.g. '[card-header]'), 'default' is the unnamed slot
+     * - string: projected into the default (unnamed) slot
+     * - Record<string, string>: keys are slot selectors (e.g. '[card-header]'), 'default' is the unnamed slot
      */
     content?: string | Record<string, string>;
     /** Optional description for this variant */

package/dist/decorator/showcase.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"showcase.types.d.ts","sourceRoot":"","sources":["../../src/decorator/showcase.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"showcase.types.d.ts","sourceRoot":"","sources":["../../src/decorator/showcase.types.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,6 @@
-// Public API — decorator
+// Public API: decorator
 export * from './decorator/index.js';
-// Public API — plugin
+// Public API: plugin
 export * from './plugin/index.js';
-// Public API — app (styleguide)
+// Public API: app (styleguide)
 export * from './app/index.js';

package/dist/plugin/define-config.js

@@ -19,6 +19,6 @@ function warnOnDuplicatePluginNames(config) {
         }
     }
     for (const name of duplicates) {
-        console.warn(`⚠ ng-prism: plugin "${name}" is registered more than once — later hooks may overwrite earlier ones.`);
+        console.warn(`⚠ ng-prism: plugin "${name}" is registered more than once, so later hooks may overwrite earlier ones.`);
     }
 }

package/dist/plugin/index.d.ts

@@ -1,13 +1,13 @@
-export type { NgPrismPlugin, PanelBadge, PanelDefinition, ControlDefinition, HeaderWidgetDefinition, NavigationDecoration, NavigationDecorationDefinition, NgPrismConfig, PrismManifest, ScannedComponent, InputMeta, OutputMeta, RuntimeManifest, RuntimeComponent, DiscoveryManifest, DiscoveryComponent, DiscoveryVariant, DiscoveryPage, } from './plugin.types.js';
-export type { StyleguidePage, CustomPage, ComponentPage, } from './page.types.js';
+export type { ControlDefinition, DiscoveryComponent, DiscoveryManifest, DiscoveryPage, DiscoveryVariant, HeaderWidgetDefinition, InputMeta, NavigationDecoration, NavigationDecorationDefinition, NgPrismConfig, NgPrismPlugin, OutputMeta, PanelBadge, PanelDefinition, PrismManifest, RuntimeComponent, RuntimeManifest, ScannedComponent } from './plugin.types.js';
+export type { ComponentPage, CustomPage, StyleguidePage } from './page.types.js';
 export type { CanvasBg } from '../shared/canvas-bg.type.js';
 export { CANVAS_BGS } from '../shared/canvas-bg.type.js';
 export { DEFAULT_VARIANT_BG, resolveVariantBg } from '../shared/variant-bg.js';
 export type { VariantBgSource } from '../shared/variant-bg.js';
-export { customPage, componentPage } from './page-helpers.js';
+export { componentPage, customPage } from './page-helpers.js';
 export type { ComponentPageOptions } from './page-helpers.js';
 export { defineConfig } from './define-config.js';
 export { ICON_NAMES } from '../app/icons/icon-registry.js';
-export { PRISM_RENDERER_HOOKS, PRISM_MANIFEST, PRISM_CONFIG, } from '../app/tokens/prism-tokens.js';
+export { PRISM_CONFIG, PRISM_MANIFEST, PRISM_RENDERER_HOOKS } from '../app/tokens/prism-tokens.js';
 export type { PrismRendererHooks } from '../app/tokens/prism-tokens.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,8BAA8B,EAC9B,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAKzB,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,YAAY,GACb,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AACA,YAAY,EACR,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,oBAAoB,EACpB,8BAA8B,EAC9B,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKjF,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACnG,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/plugin/index.js

@@ -1,15 +1,11 @@
 export { CANVAS_BGS } from '../shared/canvas-bg.type.js';
 export { DEFAULT_VARIANT_BG, resolveVariantBg } from '../shared/variant-bg.js';
-export { customPage, componentPage } from './page-helpers.js';
+export { componentPage, customPage } from './page-helpers.js';
 export { defineConfig } from './define-config.js';
-// From the dependency-free registry module, not `prism-icon.component.js`.
-// The builder evaluates plugin config — and everything it imports — in
-// Node.js, and importing the component module would run an `@Component`
-// decorator there: template compilation, styles, the whole runtime.
-//
-// Not a blanket "no Angular below this line": `prism-tokens.js` a few lines
-// down imports `InjectionToken`, and evaluating a plain class constructor in
-// Node is harmless. The line being drawn is decorated declarations, not the
-// package.
+// Imported from the dependency-free registry module, not from
+// `prism-icon.component.js`. The builder evaluates plugin config in Node.js,
+// and importing the component module would run its `@Component` decorator
+// there. Plain Angular classes are fine (`prism-tokens.js` below imports
+// `InjectionToken`); decorated declarations are not.
 export { ICON_NAMES } from '../app/icons/icon-registry.js';
-export { PRISM_RENDERER_HOOKS, PRISM_MANIFEST, PRISM_CONFIG, } from '../app/tokens/prism-tokens.js';
+export { PRISM_CONFIG, PRISM_MANIFEST, PRISM_RENDERER_HOOKS } from '../app/tokens/prism-tokens.js';

package/dist/plugin/page-helpers.d.ts

@@ -1,5 +1,5 @@
 import type { Type } from '@angular/core';
-import type { CustomPage, ComponentPage } from './page.types.js';
+import type { ComponentPage, CustomPage } from './page.types.js';
 export interface CustomPageOptions {
     title: string;
     category?: string;

package/dist/plugin/page-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-helpers.d.ts","sourceRoot":"","sources":["../../src/plugin/page-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CASjE;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAS1E"}
+{"version":3,"file":"page-helpers.d.ts","sourceRoot":"","sources":["../../src/plugin/page-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CASjE;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAS1E"}

package/dist/plugin/page-helpers.js

@@ -5,7 +5,7 @@ export function customPage(options) {
         category: options.category,
         categoryOrder: options.categoryOrder,
         order: options.order,
-        data: options.data,
+        data: options.data
     };
 }
 export function componentPage(options) {
@@ -15,6 +15,6 @@ export function componentPage(options) {
         category: options.category,
         categoryOrder: options.categoryOrder,
         order: options.order,
-        component: options.component,
+        component: options.component
     };
 }

package/dist/plugin/page.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.types.d.ts","sourceRoot":"","sources":["../../src/plugin/page.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"page.types.d.ts","sourceRoot":"","sources":["../../src/plugin/page.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;CAC5B"}

package/dist/plugin/plugin.types.d.ts

@@ -1,8 +1,8 @@
 import type { Provider, Type } from '@angular/core';
-import type { StyleguidePage } from './page.types.js';
 import type { CanvasBg } from '../shared/canvas-bg.type.js';
+import type { StyleguidePage } from './page.types.js';
 export interface NgPrismPlugin {
-    /** Unique plugin name — used for debugging and conflict detection */
+    /** Unique plugin name, used for debugging and conflict detection */
     name: string;
     onComponentScanned?: (component: ScannedComponent) => ScannedComponent | void | Promise<ScannedComponent | void>;
     onPageScanned?: (page: StyleguidePage) => StyleguidePage | void | Promise<StyleguidePage | void>;
@@ -17,12 +17,12 @@ export interface NgPrismPlugin {
     wrapComponent?: Type<unknown>;
 }
 export interface HeaderWidgetDefinition {
-    /** Unique widget id — used for de-duplication and tracking. */
+    /** Unique widget id, used for de-duplication and tracking. */
     id: string;
     /** Eager component reference. */
     component?: Type<unknown>;
     /**
-     * Lazy-loaded component — use when the widget pulls in browser-only or
+     * Lazy-loaded component. Use it when the widget pulls in browser-only or
      * heavy dependencies that should not run at config-load time.
      */
     loadComponent?: () => Promise<Type<unknown>>;
@@ -33,7 +33,7 @@ export interface HeaderWidgetDefinition {
 }
 /** A short marker rendered on a panel's tab, usually a count. */
 export interface PanelBadge {
-    /** Kept to a couple of characters — the tab bar scrolls horizontally. */
+    /** Kept to a couple of characters because the tab bar scrolls horizontally. */
     text: string;
     /**
      * Colour role. `default` is the neutral primary tint used for a plain count;
@@ -44,7 +44,7 @@ export interface PanelBadge {
 /** What one source has to say about one component in the navigation. */
 export interface NavigationDecoration {
     /**
-     * Colour role. Deliberately only two: an 'ok' state would make the marker
+     * Colour role. Only two: an 'ok' state would make the marker
      * permanent, and a marker that is always present stops being a signal.
      */
     variant: 'warn' | 'danger';
@@ -52,7 +52,7 @@ export interface NavigationDecoration {
     label: string;
 }
 export interface NavigationDecorationDefinition {
-    /** Unique id — used for de-duplication when two plugins contribute the same source. */
+    /** Unique id, used for de-duplication when two plugins contribute the same source. */
     id: string;
     /** Icon name from the built-in registry (`ICON_NAMES`). */
     icon: string;
@@ -77,7 +77,7 @@ export interface PanelDefinition {
     label: string;
     /** Angular standalone component for the panel content */
     component?: Type<unknown>;
-    /** Lazy-loaded component — use when the component import would pull in browser-only dependencies (e.g. DomSanitizer) */
+    /** Lazy-loaded component. Use when the component import would pull in browser-only dependencies (e.g. DomSanitizer) */
     loadComponent?: () => Promise<Type<unknown>>;
     overlayComponent?: Type<unknown>;
     loadOverlayComponent?: () => Promise<Type<unknown>>;
@@ -91,7 +91,7 @@ export interface PanelDefinition {
     isVisible?: (component: RuntimeComponent) => boolean;
     /**
      * When provided, the panel's tab carries this badge for the active
-     * component. Return `null` for "nothing worth saying" — a badge that is
+     * component. Return `null` for "nothing worth saying": a badge that is
      * always present stops being a signal.
      *
      * Called during change detection, so it has to be cheap and pure: read what
@@ -102,7 +102,7 @@ export interface PanelDefinition {
      * Keep the panel's component instance alive across tab switches.
      * When `true`, the panel is rendered once on first activation and merely hidden
      * (instead of destroyed) when the user switches tabs. Use for panels with
-     * expensive setup (iframes, network calls, heavy DOM) — e.g. embedded designs,
+     * expensive setup (iframes, network calls, heavy DOM), e.g. embedded designs,
      * remote previews.
      *
      * Default: `false`.
@@ -134,6 +134,15 @@ export interface ScannedComponent {
     };
     /** Import path for the component's entry point (e.g. 'my-lib/atoms/pill') */
     importPath?: string;
+    /**
+     * Base classes with source the component extends, nearest first, for a
+     * plugin to read what the component inherits. Build time only: the
+     * manifest does not carry it.
+     */
+    baseClasses?: {
+        className: string;
+        filePath: string;
+    }[];
     /** Arbitrary plugin metadata */
     meta?: Record<string, unknown>;
 }
@@ -174,7 +183,7 @@ export interface DiscoveryManifest {
 }
 export interface DiscoveryComponent {
     className: string;
-    /** `ShowcaseConfig.title` — the display name, not the class name. */
+    /** `ShowcaseConfig.title`, i.e. the display name, not the class name. */
     title: string;
     variants: DiscoveryVariant[];
     /** Sanitised `ShowcaseConfig.meta`. Omitted when empty. */
@@ -182,14 +191,14 @@ export interface DiscoveryComponent {
 }
 export interface DiscoveryVariant {
     name: string;
-    /** 0-based index into the `variants` array — the `?variant=` URL value. */
+    /** 0-based index into the `variants` array (the `?variant=` URL value). */
     index: number;
     /**
      * The canvas background this variant renders on, already resolved:
      * `Variant.bg`, else `ShowcaseConfig.bg`, else `DEFAULT_VARIANT_BG`.
      *
      * Always present, because a screenshot runner cannot act on "nothing
-     * declared" — and it is the background capture mode paints, so the value
+     * declared". It is also the background capture mode paints, so the value
      * here and the pixels in the capture agree.
      */
     bg: CanvasBg;
@@ -202,7 +211,7 @@ export interface DiscoveryPage {
 export interface NgPrismConfig {
     plugins?: NgPrismPlugin[];
     pages?: StyleguidePage[];
-    /** Providers added to the Prism app bootstrap — for library-wide services */
+    /** Providers added to the Prism app bootstrap, for library-wide services */
     appProviders?: Provider[];
     theme?: Record<string, string>;
     darkTheme?: Record<string, string>;
@@ -235,5 +244,13 @@ export interface NgPrismConfig {
     };
     /** Accessibility (build-time audit + runtime live audit) configuration. */
     a11y?: import('../app/panels/a11y/a11y.types.js').NgPrismA11yConfig;
+    /**
+     * When true, the build fails instead of warning whenever the scanner has
+     * to drop a `@Showcase` value: one it cannot evaluate statically, an
+     * invalid `bg`, `status` or `canvasLayout`, a missing `title`, or the
+     * deprecated `providers`, which never reach the styleguide.
+     * Default: `false`.
+     */
+    strictShowcase?: boolean;
 }
 //# sourceMappingURL=plugin.types.d.ts.map