@ng-prism/core 22.4.1 → 22.6.0

package/dist/builder/scanner/scanner.js

@@ -1,6 +1,7 @@
 import ts from 'typescript';
 import { scanComponents } from './component.scanner.js';
 import { resolveEntryPointExports } from './entry-point.scanner.js';
+import { createSourceFileCache } from './source-file-cache.js';
 const DEFAULT_COMPILER_OPTIONS = {
     target: ts.ScriptTarget.ES2022,
     module: ts.ModuleKind.ES2022,
@@ -22,38 +23,47 @@ const DEFAULT_COMPILER_OPTIONS = {
  * transitive type graph (Angular framework typings, etc.) is parsed once and shared via
  * the program's `TypeChecker`, instead of N programs that each load Material/CDK/RxJS.
  *
- * TypeScript reuses parsed SourceFile objects from the old program on rebuild, making
- * incremental scans fast.
+ * On rebuild, the source-file cache hands TypeScript the already parsed SourceFile of
+ * every unchanged file, so only the changed files are parsed again.
  */
 export function createScanner(options) {
     const compilerOptions = {
         ...DEFAULT_COMPILER_OPTIONS,
         ...options.compilerOptions
     };
+    const sourceFiles = createSourceFileCache(compilerOptions);
     let previousProgram;
     return {
         scan() {
-            const { program, entries } = resolveEntryPointExports(options.entryPoints, compilerOptions, previousProgram);
+            const { program, entries } = resolveEntryPointExports(options.entryPoints, compilerOptions, previousProgram, sourceFiles.host);
             previousProgram = program;
+            sourceFiles.prune(program);
             const checker = program.getTypeChecker();
             const allComponents = [];
             const diagnostics = [];
             const notices = new Set();
-            for (const { exports, importPath } of entries) {
+            const fromPrimary = new Set();
+            for (const { exports, importPath, primary } of entries) {
                 const components = scanComponents(exports, checker, diagnostics, notices);
-                for (const c of components)
+                for (const c of components) {
                     c.importPath = importPath;
+                    if (primary)
+                        fromPrimary.add(c);
+                }
                 allComponents.push(...components);
             }
             // Dedupe by (filePath, className): if a component class is re-exported from
             // multiple entry points (e.g. atoms/button + barrel index.ts), we keep the first
             // occurrence. The duplicate would otherwise produce duplicate imports in the
-            // generated manifest and a runtime collision in the Prism shell.
+            // generated manifest and a runtime collision in the Prism shell. The primary
+            // entry point comes last and re-exporting its secondaries is normal there.
             const seen = new Set();
             const unique = [];
             for (const c of allComponents) {
                 const key = `${c.filePath}::${c.className}`;
                 if (seen.has(key)) {
+                    if (fromPrimary.has(c))
+                        continue;
                     console.warn(`⚠ ng-prism: ${c.className} is exported by multiple entry points; ` +
                         `keeping the first occurrence (importPath: ${unique.find((u) => u.className === c.className && u.filePath === c.filePath)?.importPath}).`);
                     continue;

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

@@ -49,14 +49,14 @@ export function describeUnreadableBase(className, base) {
     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. */
+/** A variant or a state 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')
+    if ((head !== 'variants' && head !== 'states') || 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)}`;
+    const name = elementName(config, head, index);
+    const element = name === undefined ? `${head}[${index}]` : `${head}[${index}] ${JSON.stringify(name)}`;
+    return rest.length === 0 ? element : `${element} › ${formatPath(rest)}`;
 }
 function formatPath(path) {
     return path
@@ -70,10 +70,10 @@ function formatPath(path) {
         .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;
+function elementName(config, key, index) {
+    const elements = ts.isObjectLiteralExpression(config) ? findInitializer(config, key) : undefined;
+    const element = elements && ts.isArrayLiteralExpression(elements) ? elements.elements[index] : undefined;
+    const name = element && ts.isObjectLiteralExpression(element) ? findInitializer(element, 'name') : undefined;
     const value = name && evaluateExpression(name);
     return typeof value === 'string' ? value : undefined;
 }

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

@@ -0,0 +1,17 @@
+import type { ShowcaseState } from '../../decorator/showcase.types.js';
+/**
+ * `ShowcaseConfig.states` as the scanner evaluated it, with everything it
+ * cannot use reported. `undefined` when it is no list, or an empty one.
+ *
+ * Every slot of the list survives, because a state is identified by its
+ * position (the URL, the marker and the discovery manifest use it): an
+ * unusable entry becomes a state without pseudo states, which the styleguide
+ * shows as an empty column, instead of shifting the entries behind it.
+ * A state without a usable name is called `State <position>`.
+ *
+ * `unevaluable` holds the source positions of the entries the evaluator could
+ * not read at all. They are missing from `value`, so an empty slot goes back
+ * in at each of them, without a message of its own.
+ */
+export declare function readShowcaseStates(value: unknown, className: string, report: (message: string) => void, unevaluable?: ReadonlySet<number>): ShowcaseState[] | undefined;
+//# sourceMappingURL=showcase-states.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-states.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/showcase-states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAUvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACjC,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa,GAC7C,aAAa,EAAE,GAAG,SAAS,CA4C7B"}

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

@@ -0,0 +1,58 @@
+import { describeValue, readPseudoStates } from './pseudo-states.js';
+function isEmptyObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && Object.keys(value).length === 0;
+}
+/** Stands in for a state the evaluator dropped, which its own diagnostic already explains. */
+const GAP = Symbol('unevaluable state');
+/**
+ * `ShowcaseConfig.states` as the scanner evaluated it, with everything it
+ * cannot use reported. `undefined` when it is no list, or an empty one.
+ *
+ * Every slot of the list survives, because a state is identified by its
+ * position (the URL, the marker and the discovery manifest use it): an
+ * unusable entry becomes a state without pseudo states, which the styleguide
+ * shows as an empty column, instead of shifting the entries behind it.
+ * A state without a usable name is called `State <position>`.
+ *
+ * `unevaluable` holds the source positions of the entries the evaluator could
+ * not read at all. They are missing from `value`, so an empty slot goes back
+ * in at each of them, without a message of its own.
+ */
+export function readShowcaseStates(value, className, report, unevaluable = new Set()) {
+    if (!Array.isArray(value)) {
+        report(`${className} declares invalid states ${describeValue(value)}, expected a list of { name, pseudo }. Skipping.`);
+        return undefined;
+    }
+    const entries = [...value];
+    // Ascending, so that each position is already the one the source gives it once the earlier gaps are back.
+    for (const index of [...unevaluable].sort((a, b) => a - b))
+        entries.splice(index, 0, GAP);
+    if (entries.length === 0)
+        return undefined;
+    const firstIndexOfName = new Map();
+    return entries.map((entry, index) => {
+        const state = typeof entry === 'object' && entry !== null && !Array.isArray(entry) ? entry : undefined;
+        const declaredName = state?.['name'];
+        const hasName = typeof declaredName === 'string' && declaredName.trim() !== '';
+        if (state && !hasName)
+            report(`${className} states[${index}] has no name, expected a non-empty string. Calling it "State ${index + 1}".`);
+        else if (!state && entry !== GAP)
+            report(`${className} states[${index}] is ${describeValue(entry)}, expected { name, pseudo }. Its column stays empty.`);
+        const name = hasName ? declaredName : `State ${index + 1}`;
+        const first = firstIndexOfName.get(name);
+        if (first !== undefined) {
+            report(`${className} state "${name}" repeats the name of states[${first}]; only the first one is used. Its column stays empty.`);
+            return { name, pseudo: {} };
+        }
+        firstIndexOfName.set(name, index);
+        if (!state)
+            return { name, pseudo: {} };
+        const pseudo = state['pseudo'];
+        // `readPseudoStates` reports what it drops, but an empty object has nothing to drop.
+        if (pseudo === undefined || isEmptyObject(pseudo)) {
+            report(`${className} state "${name}" declares no pseudo states. Its column stays empty.`);
+            return { name, pseudo: {} };
+        }
+        return { name, pseudo: readPseudoStates(pseudo, `${className} state "${name}"`, report) ?? {} };
+    });
+}

package/dist/builder/scanner/source-file-cache.d.ts

@@ -0,0 +1,26 @@
+import ts from 'typescript';
+export interface SourceFileCache {
+    /** Pass to `ts.createProgram` together with the previous program. */
+    host: ts.CompilerHost;
+    /** Drop every cached file the given program no longer contains. */
+    prune(program: ts.Program): void;
+}
+/**
+ * A compiler host that hands out the same `SourceFile` for a file that has
+ * not changed since it was last parsed.
+ *
+ * `ts.createProgram(…, oldProgram)` only reuses a file from the old program
+ * when the host returns the identical object. The default host reads and
+ * parses on every call, so without this cache each rebuild re-parses the
+ * whole program, Angular's typings included.
+ *
+ * A file counts as unchanged while its mtime and size are. An edit that keeps
+ * the size and lands within the file system's mtime resolution goes unseen;
+ * APFS and ext4 record nanoseconds, so in practice that does not happen.
+ *
+ * Module resolutions are recomputed on every program. Reusing them would
+ * miss a file created after an import of it had already failed to resolve,
+ * because the importing file itself has not changed.
+ */
+export declare function createSourceFileCache(compilerOptions: ts.CompilerOptions): SourceFileCache;
+//# sourceMappingURL=source-file-cache.d.ts.map

package/dist/builder/scanner/source-file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file-cache.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/source-file-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC5B,qEAAqE;IACrE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC;IACtB,mEAAmE;IACnE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC;CACpC;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,GAAG,eAAe,CAmC1F"}

package/dist/builder/scanner/source-file-cache.js

@@ -0,0 +1,60 @@
+import { statSync } from 'fs';
+import ts from 'typescript';
+/**
+ * A compiler host that hands out the same `SourceFile` for a file that has
+ * not changed since it was last parsed.
+ *
+ * `ts.createProgram(…, oldProgram)` only reuses a file from the old program
+ * when the host returns the identical object. The default host reads and
+ * parses on every call, so without this cache each rebuild re-parses the
+ * whole program, Angular's typings included.
+ *
+ * A file counts as unchanged while its mtime and size are. An edit that keeps
+ * the size and lands within the file system's mtime resolution goes unseen;
+ * APFS and ext4 record nanoseconds, so in practice that does not happen.
+ *
+ * Module resolutions are recomputed on every program. Reusing them would
+ * miss a file created after an import of it had already failed to resolve,
+ * because the importing file itself has not changed.
+ */
+export function createSourceFileCache(compilerOptions) {
+    const host = ts.createCompilerHost(compilerOptions);
+    const parse = host.getSourceFile.bind(host);
+    const cache = new Map();
+    host.getSourceFile = (fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile) => {
+        const stamp = readStamp(fileName);
+        if (stamp === undefined) {
+            cache.delete(fileName);
+            return undefined;
+        }
+        const cached = cache.get(fileName);
+        if (cached?.stamp === stamp && !shouldCreateNewSourceFile)
+            return cached.sourceFile;
+        const sourceFile = parse(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile);
+        if (sourceFile)
+            cache.set(fileName, { stamp, sourceFile });
+        else
+            cache.delete(fileName);
+        return sourceFile;
+    };
+    host.hasInvalidatedResolutions = () => true;
+    return {
+        host,
+        prune(program) {
+            const live = new Set(program.getSourceFiles().map((sf) => sf.fileName));
+            for (const fileName of cache.keys()) {
+                if (!live.has(fileName))
+                    cache.delete(fileName);
+            }
+        }
+    };
+}
+function readStamp(fileName) {
+    try {
+        const { mtimeMs, size } = statSync(fileName);
+        return `${mtimeMs}:${size}`;
+    }
+    catch {
+        return undefined;
+    }
+}

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;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"}
+{"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,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,CA2FtJ"}

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

@@ -3,9 +3,10 @@ import { dirname, join } from 'path';
 import ts from 'typescript';
 import { checkA11yThresholds, DEFAULT_A11Y_REPORT_PATH, readA11yForComponents, readA11yMeta } from '../a11y/a11y-report-reader.js';
 import { loadConfig } from '../config-loader/config-loader.js';
+import { describeDeprecatedOptions } from '../config-loader/deprecated-options.js';
 import { generateRuntimeManifest } from '../manifest/runtime-manifest.generator.js';
 import { runPluginHooks } from '../plugin-runner/plugin-runner.js';
-import { discoverSecondaryEntryPoints } from '../scanner/entry-point-discovery.js';
+import { discoverSecondaryEntryPoints, findPrimaryEntryFile } from '../scanner/entry-point-discovery.js';
 import { createScanner } from '../scanner/scanner.js';
 export function createPipelineState() {
     return { scanner: undefined, lastEntrySetKey: undefined };
@@ -17,6 +18,9 @@ export async function runPrismPipeline(options, context, state) {
         workspaceRoot,
         configFileName: options.configFile
     });
+    for (const notice of describeDeprecatedOptions(config, options.configFile)) {
+        console.warn(`⚠ ng-prism: ${notice}`);
+    }
     context.reportStatus('Scanning components...');
     const { components, diagnostics } = scanEntryPoints(workspaceRoot, options, state);
     if (config.strictShowcase && diagnostics.length > 0) {
@@ -115,6 +119,18 @@ function findLibraryRoot(filePath) {
     }
     return undefined;
 }
+/**
+ * Reads config files, `extends` included, but lists no directories. Only
+ * `paths` and `baseUrl` are taken from the config, so enumerating the files it
+ * includes would only cost time: with no `include`, that is every source file
+ * below the config, on every rebuild.
+ */
+const CONFIG_HOST = {
+    useCaseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames,
+    fileExists: ts.sys.fileExists,
+    readFile: ts.sys.readFile,
+    readDirectory: () => []
+};
 function resolveTsconfigPaths(entryPointDir) {
     const configPath = ts.findConfigFile(entryPointDir, ts.sys.fileExists, 'tsconfig.json');
     if (!configPath)
@@ -122,7 +138,7 @@ function resolveTsconfigPaths(entryPointDir) {
     const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
     if (configFile.error)
         return {};
-    const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, dirname(configPath));
+    const parsed = ts.parseJsonConfigFileContent(configFile.config, CONFIG_HOST, dirname(configPath));
     const result = {};
     if (parsed.options.paths)
         result.paths = parsed.options.paths;
@@ -136,18 +152,17 @@ function resolveEntryPoints(workspaceRoot, options) {
     const entryIsDirectory = isDirectory(absoluteEntryPoint);
     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
-    //    (e.g. primary-only library, root ng-package.json carries `dest`).
-    const entryPoints = discovered.length === 0 && !entryIsDirectory
-        ? [
-            {
-                entryFile: absoluteEntryPoint,
-                importPath: options.libraryImportPath
-            }
-        ]
+    // The primary entry point is scanned after the secondary ones: a file entryPoint is
+    // the primary itself, a directory names it in its ng-package.json. A root
+    // ng-package.json without `dest` is already among the discovered ones.
+    const primaryEntryFile = entryIsDirectory ? findPrimaryEntryFile(absoluteEntryPoint) : absoluteEntryPoint;
+    const entryPoints = primaryEntryFile && !discovered.some((e) => e.entryFile === primaryEntryFile)
+        ? [...discovered, { entryFile: primaryEntryFile, importPath: options.libraryImportPath, primary: true }]
         : discovered;
+    if (entryPoints.length === 0) {
+        console.warn(`⚠ ng-prism: entryPoint "${options.entryPoint}" resolves to no entry file: no ng-package.json with a lib.entryFile ` +
+            `that exists, and no secondary entry points below it. Point entryPoint at the library's barrel file.`);
+    }
     return { entryPoints, compilerOptions };
 }
 function scanEntryPoints(workspaceRoot, options, state) {

package/dist/decorator/index.d.ts

@@ -1,3 +1,3 @@
-export type { ComponentStatus, InputsOf, ShowcaseConfig, Variant } from './showcase.types.js';
+export type { ComponentStatus, InputsOf, ShowcaseConfig, ShowcaseState, 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,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9F,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,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -1,6 +1,7 @@
 import type { InputSignalWithTransform, Provider } from '@angular/core';
 import type { CanvasBg } from '../shared/canvas-bg.type.js';
 import type { CanvasLayout } from '../shared/canvas-layout.type.js';
+import type { ForcedPseudoStates } from '../shared/pseudo-state.type.js';
 export type ComponentStatus = 'stable' | 'beta' | 'wip' | 'deprecated';
 export interface DirectiveHost {
     selector: string;
@@ -23,6 +24,17 @@ type UnwrapSignalInput<S> = S extends InputSignalWithTransform<any, infer WriteT
 export type InputsOf<T> = [unknown] extends [T] ? Record<string, unknown> : {
     [K in keyof T as T[K] extends InputSignalWithTransform<any, any> ? K : never]: UnwrapSignalInput<T[K]>;
 };
+/**
+ * A named combination of forced pseudo states, combined with every variant of
+ * the component that does not opt out with `Variant.states: false`, and forced
+ * where it fits: only on targets the browser could put into the state.
+ */
+export interface ShowcaseState {
+    /** Column title in the Overview, chip label in the tools menu. Unique within the component. */
+    name: string;
+    /** Same shape and semantics as `Variant.pseudo`. */
+    pseudo: ForcedPseudoStates;
+}
 export interface ShowcaseConfig<T = unknown> {
     /** Display name in the ng-prism UI */
     title: string;
@@ -48,6 +60,16 @@ export interface ShowcaseConfig<T = unknown> {
     sectionOrder?: number;
     /** Predefined variants shown as tabs */
     variants?: Variant<T>[];
+    /**
+     * Named pseudo-state combinations, e.g. `{ name: 'Hover', pseudo: { hover: '.btn' } }`.
+     * Each one is combined with every variant and forced where it fits, so the Overview shows
+     * a column per state and a variant can be viewed in any of them. A variant opts out with
+     * `states: false`.
+     * Not combinable with `renderPage`: a component page has no Overview.
+     *
+     * The position in the list identifies a state, so keep the order stable.
+     */
+    states?: ShowcaseState[];
     /** Tags for search and filtering */
     tags?: string[];
     /**
@@ -107,6 +129,17 @@ export interface Variant<T = unknown> {
     bg?: CanvasBg;
     /** Canvas layout mode for this variant. Overrides `ShowcaseConfig.canvasLayout`. See `ShowcaseConfig.canvasLayout` for semantics. */
     canvasLayout?: CanvasLayout;
+    /**
+     * Pseudo states forced on while this variant renders, e.g.
+     * `{ 'focus-visible': '.btn' }` or `{ hover: true }`.
+     * - `true`: the state is forced on every element of the rendered component, the host included.
+     * - A selector, or a list of them: only on the matching elements, resolved against the host and everything inside it.
+     *
+     * The component's own CSS applies: every selector using the pseudo-class is widened to also match a stand-in class on the targeted elements.
+     */
+    pseudo?: ForcedPseudoStates;
+    /** `false` keeps this variant out of every combination with the component's `states`: it renders in its own pseudo states only, as a single cell in the Overview. */
+    states?: false;
 }
 export {};
 //# sourceMappingURL=showcase.types.d.ts.map

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/plugin/index.d.ts

@@ -1,9 +1,11 @@
-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 { ControlDefinition, DiscoveryComponent, DiscoveryManifest, DiscoveryPage, DiscoveryState, 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 type { ForcedPseudoStates, PseudoState, PseudoTarget } from '../shared/pseudo-state.type.js';
+export { PSEUDO_STATES } from '../shared/pseudo-state.type.js';
 export { componentPage, customPage } from './page-helpers.js';
 export type { ComponentPageOptions } from './page-helpers.js';
 export { defineConfig } from './define-config.js';

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;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"}
+{"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,cAAc,EACd,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;AAK/D,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,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,5 +1,6 @@
 export { CANVAS_BGS } from '../shared/canvas-bg.type.js';
 export { DEFAULT_VARIANT_BG, resolveVariantBg } from '../shared/variant-bg.js';
+export { PSEUDO_STATES } from '../shared/pseudo-state.type.js';
 export { componentPage, customPage } from './page-helpers.js';
 export { defineConfig } from './define-config.js';
 // Imported from the dependency-free registry module, not from

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

@@ -1,5 +1,6 @@
 import type { Provider, Type } from '@angular/core';
 import type { CanvasBg } from '../shared/canvas-bg.type.js';
+import type { ForcedPseudoStates } from '../shared/pseudo-state.type.js';
 import type { StyleguidePage } from './page.types.js';
 export interface NgPrismPlugin {
     /** Unique plugin name, used for debugging and conflict detection */
@@ -13,7 +14,7 @@ export interface NgPrismPlugin {
     headerWidgets?: HeaderWidgetDefinition[];
     /** Markers contributed to each component's navigation item. */
     navigationDecorations?: NavigationDecorationDefinition[];
-    /** Angular standalone component that wraps each rendered component */
+    /** @deprecated Deprecated since 22.6.0, removed in 23.0.0. It has never had an effect: nothing reads it. */
     wrapComponent?: Type<unknown>;
 }
 export interface HeaderWidgetDefinition {
@@ -82,8 +83,9 @@ export interface PanelDefinition {
     overlayComponent?: Type<unknown>;
     loadOverlayComponent?: () => Promise<Type<unknown>>;
     icon?: string;
+    /** @deprecated Deprecated since 22.6.0, removed in 23.0.0. It has never had an effect: nothing reads it. Where a panel appears is `placement`. */
     position?: 'bottom' | 'right';
-    /** Where this panel appears: 'addon' (bottom/right tabbar) or 'view' (top view toolbar). Default: 'addon' */
+    /** Where this panel appears: 'addon' (the tab bar below the canvas) or 'view' (top view toolbar). Default: 'addon' */
     placement?: 'addon' | 'view';
     /** Providers injected into a child EnvironmentInjector scoped to this panel */
     providers?: Provider[];
@@ -147,7 +149,10 @@ export interface ScannedComponent {
     meta?: Record<string, unknown>;
 }
 export interface InputMeta {
+    /** The class member. Variants and controls use this name. */
     name: string;
+    /** The public name Angular binds the input by, when an `alias` makes it differ from `name`. */
+    alias?: string;
     type: 'string' | 'number' | 'boolean' | 'union' | 'array' | 'object' | 'unknown';
     rawType?: string;
     values?: string[];
@@ -156,7 +161,10 @@ export interface InputMeta {
     doc?: string;
 }
 export interface OutputMeta {
+    /** The class member. */
     name: string;
+    /** The public event name, when an `alias` makes it differ from `name`. */
+    alias?: string;
     doc?: string;
 }
 export interface RuntimeManifest {
@@ -173,9 +181,10 @@ export interface RuntimeComponent {
  * The shape external tooling reads from `globalThis.__PRISM_MANIFEST__`.
  *
  * A thin, JSON-safe projection of the runtime manifest: enough to enumerate and
- * address every variant, plus the `@Showcase` metadata a tool needs to decide how
- * to treat one. It carries no Angular class references, and `meta` values that
- * cannot survive a structured clone are dropped rather than half-serialised.
+ * address every variant and component-level state, plus the `@Showcase` metadata
+ * a tool needs to decide how to treat one. It carries no Angular class
+ * references, and `meta` values that cannot survive a structured clone are
+ * dropped rather than half-serialised.
  */
 export interface DiscoveryManifest {
     components: DiscoveryComponent[];
@@ -186,6 +195,16 @@ export interface DiscoveryComponent {
     /** `ShowcaseConfig.title`, i.e. the display name, not the class name. */
     title: string;
     variants: DiscoveryVariant[];
+    /**
+     * `ShowcaseConfig.states`: the component-level states, one entry per declared
+     * slot. Omitted when the component declares none. A component without
+     * `variants` lists them next to its single `Default` variant.
+     *
+     * Whether a state fits a variant is not part of the manifest, because that is
+     * only known once the variant renders; the render marker reports it
+     * (`data-prism-excluded`).
+     */
+    states?: DiscoveryState[];
     /** Sanitised `ShowcaseConfig.meta`. Omitted when empty. */
     meta?: Record<string, unknown>;
 }
@@ -204,6 +223,29 @@ export interface DiscoveryVariant {
     bg: CanvasBg;
     /** Sanitised `Variant.meta`. Omitted when empty. */
     meta?: Record<string, unknown>;
+    /**
+     * `Variant.pseudo`: the pseudo states the variant forces. Omitted when it
+     * forces none. The render marker waits for them, so a capture shows them
+     * without any action on the runner's side.
+     */
+    pseudo?: ForcedPseudoStates;
+    /**
+     * `false` when the variant opts out of the component's `states` (`Variant.states`).
+     * Omitted otherwise. Nothing is forced for a state on such a variant, and the
+     * render marker still reports its cell as excluded.
+     */
+    states?: false;
+}
+export interface DiscoveryState {
+    name: string;
+    /** 0-based index into the `states` array (the `?state=` URL value). */
+    index: number;
+    /**
+     * The pseudo states the state forces, exactly as declared. An empty object
+     * for a slot that forces nothing, for example one the scanner could not
+     * evaluate: the slot stays listed so the indices behind it keep their value.
+     */
+    pseudo: ForcedPseudoStates;
 }
 export interface DiscoveryPage {
     title: string;
@@ -222,7 +264,9 @@ export interface NgPrismConfig {
     };
     title?: string;
     subtitle?: string;
+    /** @deprecated Deprecated since 22.6.0, removed in 23.0.0. It has never had an effect: nothing reads it. */
     themeStylesheet?: string;
+    /** @deprecated Deprecated since 22.6.0, removed in 23.0.0. It has never had an effect: nothing reads it. */
     ui?: {
         header?: Type<unknown>;
         sidebar?: Type<unknown>;
@@ -232,7 +276,9 @@ export interface NgPrismConfig {
         eventsPanel?: Type<unknown>;
         footer?: Type<unknown>;
     };
+    /** @deprecated Deprecated since 22.6.0, removed in 23.0.0. It has never had an effect: nothing reads it. */
     headless?: boolean;
+    /** @deprecated Deprecated since 22.6.0, removed in 23.0.0. It has never had an effect: nothing reads it. */
     appComponent?: Type<unknown>;
     /** When false, disables URL state sync (default: true). */
     urlState?: boolean;
@@ -247,8 +293,8 @@ export interface NgPrismConfig {
     /**
      * 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.
+     * invalid `bg`, `status`, `canvasLayout` or `pseudo`, a missing `title`,
+     * or the deprecated `providers`, which never reach the styleguide.
      * Default: `false`.
      */
     strictShowcase?: boolean;