@ng-prism/core 22.3.0 → 22.4.1

package/dist/builder/scanner/showcase-diagnostics.d.ts

@@ -0,0 +1,25 @@
+import ts from 'typescript';
+import { type UnevaluableIssue } from './ast-utils.js';
+import type { UnreadableBase } from './class-hierarchy.js';
+/**
+ * Describe one value the scanner had to drop from a `@Showcase` config:
+ * which component, where in the config, what the source said and where.
+ *
+ * `SguiFileInputComponent › variants[3] "Auto hint" › inputs.maxFileSize — "megabytes(5)" (src/file-input.component.ts:27:22) cannot be evaluated statically and was dropped.`
+ */
+export declare function describeUnevaluable(className: string, config: ts.Expression, issue: UnevaluableIssue): string;
+/**
+ * `providers` never reached the manifest: classes, factories and instances
+ * cannot be written into static data. One message for the field, not one per
+ * provider, because none of them could have been kept. It points at the
+ * literal property if there is one, else at `found`, a provider the scan came
+ * across through a spread or a constant, else at the whole config.
+ */
+export declare function describeDeprecatedProviders(className: string, config: ts.Expression, found?: ts.Node): string;
+/**
+ * A base class from a package only ships its declarations: no `input()`
+ * call, no required flag, no default. Its inputs are named so the reader
+ * knows which variant values will not reach the component.
+ */
+export declare function describeUnreadableBase(className: string, base: UnreadableBase): string;
+//# sourceMappingURL=showcase-diagnostics.d.ts.map

package/dist/builder/scanner/showcase-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/showcase-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAA2C,KAAK,gBAAgB,EAA4B,MAAM,gBAAgB,CAAC;AAC1H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAa3D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAY7G;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,CAO7G;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAOtF"}

package/dist/builder/scanner/showcase-diagnostics.js

@@ -0,0 +1,96 @@
+import { relative } from 'node:path';
+import ts from 'typescript';
+import { evaluateExpression } from './ast-utils.js';
+const MAX_EXCERPT_LENGTH = 60;
+const CAUSES = {
+    let: 'is declared with let; only const declarations can be read',
+    var: 'is declared with var; only const declarations can be read',
+    'no-value': 'is declared without a value, as in a .d.ts file or with declare',
+    cycle: 'refers back to itself',
+    'runtime-value': 'is a function or class, which only exists at runtime'
+};
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+/**
+ * Describe one value the scanner had to drop from a `@Showcase` config:
+ * which component, where in the config, what the source said and where.
+ *
+ * `SguiFileInputComponent › variants[3] "Auto hint" › inputs.maxFileSize — "megabytes(5)" (src/file-input.component.ts:27:22) cannot be evaluated statically and was dropped.`
+ */
+export function describeUnevaluable(className, config, issue) {
+    const isRoot = issue.node === config;
+    const where = issue.path.length === 0 ? '@Showcase' : formatShowcasePath(issue.path, config);
+    const consequence = isRoot
+        ? 'cannot be evaluated statically, so the component is skipped'
+        : issue.reason === 'runtime-value'
+            ? 'is a runtime value (function, class or instance) and cannot be part of the static manifest; it was dropped'
+            : 'cannot be evaluated statically and was dropped';
+    const cause = issue.cause ? `: ${excerpt(issue.cause.node)} ${CAUSES[issue.cause.kind]}` : '';
+    return `${className} › ${where} — "${excerpt(issue.node)}" (${location(issue.node)}) ${consequence}${cause}.`;
+}
+/**
+ * `providers` never reached the manifest: classes, factories and instances
+ * cannot be written into static data. One message for the field, not one per
+ * provider, because none of them could have been kept. It points at the
+ * literal property if there is one, else at `found`, a provider the scan came
+ * across through a spread or a constant, else at the whole config.
+ */
+export function describeDeprecatedProviders(className, config, found) {
+    const literal = ts.isObjectLiteralExpression(config) ? findProperty(config, 'providers') : undefined;
+    return (`${className} declares @Showcase providers (${location(literal ?? found ?? config)}), which are deprecated and will be removed in 23.0.0; ` +
+        `the manifest is static and cannot hold them, so they never reach the styleguide. Use defineConfig({ appProviders }) instead.`);
+}
+/**
+ * A base class from a package only ships its declarations: no `input()`
+ * call, no required flag, no default. Its inputs are named so the reader
+ * knows which variant values will not reach the component.
+ */
+export function describeUnreadableBase(className, base) {
+    const baseName = base.classDecl.name?.text ?? 'an anonymous class';
+    return (`${className} inherits ${base.inputs.join(', ')} from ${baseName}, which only exists as a declaration (${location(base.classDecl)}); ` +
+        `without its source these inputs cannot be read, so they are missing from the manifest and variants cannot set them.`);
+}
+/** A variant is named by its `name` as well as its index, since that is what the styleguide shows. */
+function formatShowcasePath(path, config) {
+    const [head, index, ...rest] = path;
+    if (head !== 'variants' || typeof index !== 'number')
+        return formatPath(path);
+    const name = variantName(config, index);
+    const variant = name === undefined ? `variants[${index}]` : `variants[${index}] ${JSON.stringify(name)}`;
+    return rest.length === 0 ? variant : `${variant} › ${formatPath(rest)}`;
+}
+function formatPath(path) {
+    return path
+        .map((segment, i) => {
+        if (typeof segment === 'number')
+            return `[${segment}]`;
+        if (!IDENTIFIER.test(segment))
+            return `[${JSON.stringify(segment)}]`;
+        return i === 0 ? segment : `.${segment}`;
+    })
+        .join('');
+}
+/** Read from the source, because the evaluated array has already lost the elements before the index. */
+function variantName(config, index) {
+    const variants = ts.isObjectLiteralExpression(config) ? findInitializer(config, 'variants') : undefined;
+    const variant = variants && ts.isArrayLiteralExpression(variants) ? variants.elements[index] : undefined;
+    const name = variant && ts.isObjectLiteralExpression(variant) ? findInitializer(variant, 'name') : undefined;
+    const value = name && evaluateExpression(name);
+    return typeof value === 'string' ? value : undefined;
+}
+function findProperty(object, key) {
+    return object.properties.find((prop) => prop.name !== undefined && (ts.isIdentifier(prop.name) || ts.isStringLiteral(prop.name)) && prop.name.text === key);
+}
+function findInitializer(object, key) {
+    const prop = findProperty(object, key);
+    return prop && ts.isPropertyAssignment(prop) ? prop.initializer : undefined;
+}
+function excerpt(node) {
+    const text = node.getText().replace(/\s+/g, ' ');
+    return text.length > MAX_EXCERPT_LENGTH ? `${text.slice(0, MAX_EXCERPT_LENGTH - 1)}…` : text;
+}
+/** Relative to the working directory and with line and column, so that terminals and editors can link it. */
+function location(node) {
+    const sourceFile = node.getSourceFile();
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return `${relative(process.cwd(), sourceFile.fileName)}:${line + 1}:${character + 1}`;
+}

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

@@ -17,7 +17,7 @@ export interface PrismPipelineResult {
 }
 export interface PrismPipelineState {
     scanner: Scanner | undefined;
-    /** Sorted, joined entry-file paths — used to detect when the entry set changed between rebuilds. */
+    /** Sorted, joined entry-file paths. Used to detect when the entry set changed between rebuilds. */
     lastEntrySetKey: string | undefined;
 }
 export declare function createPipelineState(): PrismPipelineState;

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":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAUhE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACjC,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;CACrB;AAED,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,oGAAoG;IACpG,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmFtJ"}
+{"version":3,"file":"prism-pipeline.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/prism-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAShE,OAAO,EAAiB,KAAK,OAAO,EAAmB,MAAM,uBAAuB,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACjC,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;CACrB;AAED,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mGAAmG;IACnG,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuFtJ"}

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

@@ -18,10 +18,13 @@ export async function runPrismPipeline(options, context, state) {
         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);
@@ -29,7 +32,7 @@ export async function runPrismPipeline(options, context, state) {
         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.`);
+            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
@@ -69,7 +72,7 @@ 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,
@@ -84,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;
 }

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

@@ -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 {
@@ -81,7 +81,7 @@ export function startWatcher(options) {
     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() {

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.map

@@ -1 +1 @@
-{"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;AAUlD,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"}
+{"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

@@ -2,14 +2,10 @@ export { CANVAS_BGS } from '../shared/canvas-bg.type.js';
 export { DEFAULT_VARIANT_BG, resolveVariantBg } from '../shared/variant-bg.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_CONFIG, PRISM_MANIFEST, PRISM_RENDERER_HOOKS } from '../app/tokens/prism-tokens.js';

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

@@ -2,7 +2,7 @@ import type { Provider, Type } from '@angular/core';
 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

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

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

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

@@ -46,7 +46,7 @@ function updateTsConfigMapping(tree, context) {
     }
     const existing = parsed.compilerOptions?.paths?.['prism-manifest/*'];
     if (!existing) {
-        // No existing mapping — fall through to addTsConfigPath which inserts the new default.
+        // No existing mapping, so fall through to addTsConfigPath which inserts the new default.
         addTsConfigPath(tree, 'tsconfig.json', 'prism-manifest/*', [NEW_PATH_MAPPING]);
         return;
     }
@@ -127,7 +127,7 @@ export function migrate() {
         }
         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 — ' +
+            '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.js

@@ -1,6 +1,6 @@
 import { chain, SchematicsException } from '@angular-devkit/schematics';
 // `@angular-devkit/schematics` has no `exports` map, so its subpaths must name
-// a file — Node's ESM resolver does not honour the legacy `tasks/package.json`
+// a file. Node's ESM resolver does not honour the legacy `tasks/package.json`
 // `main` field the way CommonJS `require()` does. See issue #32.
 import { NodePackageInstallTask } from '@angular-devkit/schematics/tasks/index.js';
 import { addTsConfigPath } from '../utils/tsconfig-paths.js';
@@ -20,8 +20,8 @@ function readJsonIfPresent(tree, path) {
 /**
  * Angular CLI workspaces install `@angular-devkit/build-angular`; Nx and newer
  * Angular workspaces install `@angular/build`. Presence in node_modules is not a
- * usable signal — `@angular-devkit/build-angular` depends on `@angular/build`
- * itself — so only a direct entry in package.json counts.
+ * usable signal (`@angular-devkit/build-angular` depends on `@angular/build`
+ * itself), so only a direct entry in package.json counts.
  */
 function resolveAppBuilder(tree) {
     const pkg = readJsonIfPresent(tree, 'package.json');
@@ -84,7 +84,7 @@ function readWorkspace(tree) {
     const buffer = tree.read('angular.json');
     if (!buffer) {
         throw new SchematicsException('Could not find angular.json. Run this from an Angular workspace root, or ' +
-            'in an Nx workspace via `nx g @ng-prism/core:ng-add --project=<library>` — ' +
+            'in an Nx workspace via `nx g @ng-prism/core:ng-add --project=<library>`. ' +
             'Nx supplies the workspace configuration the schematic reads.');
     }
     return JSON.parse(buffer.toString('utf-8'));

package/dist/shared/canvas-bg.type.d.ts

@@ -10,7 +10,7 @@ export type CanvasBg = 'dots' | 'plain' | 'light' | 'dark'
 /**
  * @deprecated Deprecated since 22.2.0, removed in 23.0.0. It draws the same
  * checkerboard as `transparent` while browsing, so the canvas cannot tell
- * the two apart — but it captures as `--prism-bg-surface`, a *theme* token,
+ * the two apart. But it captures as `--prism-bg-surface`, a *theme* token,
  * which makes a baseline recorded on it depend on the theme the runner's
  * browser started in. Use `transparent` for the same look with a capture
  * that keeps its alpha, or `light`/`dark` for an absolute colour.
@@ -19,11 +19,10 @@ export type CanvasBg = 'dots' | 'plain' | 'light' | 'dark'
 /**
  * Every value {@link CanvasBg} accepts, deprecated ones included.
  *
- * Also the list the canvas toolbar renders. That group is a readout as much as
- * a control — it marks the active and the recommended background — so a value
- * missing from it is a value the UI cannot *show*, not merely one it declines
- * to offer. Persisted canvas state is validated against this list too, so a
- * value only a decorator can reach still round-trips.
+ * Also the list the canvas toolbar renders. The toolbar marks the active
+ * background, so a value missing here could not be shown as active. Persisted
+ * canvas state is validated against this list too, so a value only a decorator
+ * can reach still round-trips.
  */
 export declare const CANVAS_BGS: readonly CanvasBg[];
 //# sourceMappingURL=canvas-bg.type.d.ts.map

package/dist/shared/canvas-bg.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-bg.type.d.ts","sourceRoot":"","sources":["../../src/shared/canvas-bg.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GACd,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM;AACR;;;;;;;GAOG;GACD,SAAS,GACT,aAAa,CAAC;AAEpB;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA0E,CAAC"}
+{"version":3,"file":"canvas-bg.type.d.ts","sourceRoot":"","sources":["../../src/shared/canvas-bg.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GACd,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM;AACR;;;;;;;GAOG;GACD,SAAS,GACT,aAAa,CAAC;AAEpB;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA0E,CAAC"}

package/dist/shared/canvas-bg.type.js

@@ -1,10 +1,9 @@
 /**
  * Every value {@link CanvasBg} accepts, deprecated ones included.
  *
- * Also the list the canvas toolbar renders. That group is a readout as much as
- * a control — it marks the active and the recommended background — so a value
- * missing from it is a value the UI cannot *show*, not merely one it declines
- * to offer. Persisted canvas state is validated against this list too, so a
- * value only a decorator can reach still round-trips.
+ * Also the list the canvas toolbar renders. The toolbar marks the active
+ * background, so a value missing here could not be shown as active. Persisted
+ * canvas state is validated against this list too, so a value only a decorator
+ * can reach still round-trips.
  */
 export const CANVAS_BGS = ['dots', 'plain', 'light', 'dark', 'checker', 'transparent'];