@ng-prism/core 22.2.1 → 22.4.0

package/dist/builder/scanner/input.extractor.js

@@ -1,84 +1,174 @@
 import ts from 'typescript';
-import { evaluateExpression, findDecorator, getDecoratorArgument, getJsDocComment, } from './ast-utils.js';
+import { evaluateStatic, findDecorator, getDecoratorArgument, getJsDocComment } from './ast-utils.js';
+import { getClassHierarchy } from './class-hierarchy.js';
 /**
- * Extract all @Input(), input() and model() signal metadata from a class declaration.
+ * Extract all @Input(), input() and model() signal metadata from a class
+ * declaration and the base classes Angular inherits inputs from. An input the
+ * subclass redeclares wins over the one in its base class.
  */
-export function extractInputs(classDecl, checker) {
+export function extractInputs(classDecl, checker, hierarchy = getClassHierarchy(classDecl, checker)) {
     const inputs = [];
-    for (const member of classDecl.members) {
-        if (!ts.isPropertyDeclaration(member))
-            continue;
-        const name = member.name && ts.isIdentifier(member.name)
-            ? member.name.text
-            : undefined;
-        if (!name)
-            continue;
-        const inputDecorator = findDecorator(member, 'Input');
-        if (inputDecorator) {
-            const required = isDecoratorInputRequired(inputDecorator);
-            const defaultValue = member.initializer
-                ? evaluateExpression(member.initializer)
-                : undefined;
-            const doc = getJsDocComment(member, checker);
-            const { type, values, rawType } = resolveDecoratorInputType(member, checker);
-            inputs.push({
-                name,
-                type,
-                rawType,
-                required,
-                ...(values && { values }),
-                ...(defaultValue !== undefined && { defaultValue }),
-                ...(doc && { doc }),
-            });
-            continue;
-        }
-        const signalCall = getInputSignalCall(member);
-        if (signalCall) {
-            const required = isSignalInputRequired(signalCall);
-            const defaultValue = !required && signalCall.arguments.length > 0
-                ? evaluateExpression(signalCall.arguments[0])
-                : undefined;
-            const doc = getJsDocComment(member, checker);
-            const { type, values, rawType } = resolveSignalInputType(signalCall, checker);
-            inputs.push({
-                name,
-                type,
-                rawType,
-                required,
-                ...(values && { values }),
-                ...(defaultValue !== undefined && { defaultValue }),
-                ...(doc && { doc }),
-            });
+    const seen = new Set();
+    // Fields a more derived class initializes without declaring them an input.
+    // Angular keeps the inherited input, but the component starts out with that value.
+    const reinitialized = new Map();
+    for (const { classDecl: owner, definesMetadata } of hierarchy.classes) {
+        const subclass = owner === classDecl ? undefined : classDecl;
+        for (const member of owner.members) {
+            if (!ts.isPropertyDeclaration(member) || isStatic(member))
+                continue;
+            const name = member.name && ts.isIdentifier(member.name) ? member.name.text : undefined;
+            if (!name || seen.has(name))
+                continue;
+            const input = definesMetadata ? readInput(member, name, checker, owner, subclass) : undefined;
+            if (!input) {
+                if (member.initializer && !reinitialized.has(name))
+                    reinitialized.set(name, member);
+                continue;
+            }
+            const initializedBy = reinitialized.get(name);
+            if (initializedBy) {
+                const defaultValue = readInitialValue(initializedBy, checker);
+                if (defaultValue === undefined)
+                    delete input.defaultValue;
+                else
+                    input.defaultValue = defaultValue;
+            }
+            seen.add(name);
+            inputs.push(input);
         }
     }
     return inputs;
 }
+function isStatic(member) {
+    return !!ts.getModifiers(member)?.some((m) => m.kind === ts.SyntaxKind.StaticKeyword);
+}
+/** What a field starts out with: its initializer, or for `input()` and `model()` the value passed to them. */
+function readInitialValue(member, checker) {
+    const signalCall = getInputSignalCall(member);
+    if (!signalCall)
+        return member.initializer ? evaluateDefault(member.initializer, checker) : undefined;
+    return !isSignalInputRequired(signalCall) && signalCall.arguments.length > 0 ? evaluateDefault(signalCall.arguments[0], checker) : undefined;
+}
 /**
- * Extract all @Output() and output() signal metadata from a class declaration.
+ * `owner` declares the member. `subclass` is the showcased class when that is
+ * a different one, which decides what the type parameters of `owner` stand for.
  */
-export function extractOutputs(classDecl, checker) {
+function readInput(member, name, checker, owner, subclass) {
+    const inputDecorator = findDecorator(member, 'Input');
+    if (inputDecorator) {
+        const required = isDecoratorInputRequired(inputDecorator);
+        const defaultValue = readInitialValue(member, checker);
+        const doc = getJsDocComment(member, checker);
+        const instantiated = subclass && usesTypeParameters(member.type ?? member.initializer, owner, checker) ? getInstantiatedType(name, subclass, checker) : undefined;
+        const { type, values, rawType } = instantiated ? mapType(instantiated, checker) : resolveDecoratorInputType(member, checker);
+        return {
+            name,
+            type,
+            rawType,
+            required,
+            ...(values && { values }),
+            ...(defaultValue !== undefined && { defaultValue }),
+            ...(doc && { doc })
+        };
+    }
+    const signalCall = getInputSignalCall(member);
+    if (!signalCall)
+        return undefined;
+    const required = isSignalInputRequired(signalCall);
+    const defaultValue = readInitialValue(member, checker);
+    const doc = getJsDocComment(member, checker);
+    const declaredType = signalCall.typeArguments?.[0] ?? signalCall.arguments[0];
+    // A signal is a getter function, so its call signature returns the value type.
+    const instantiated = subclass && usesTypeParameters(declaredType, owner, checker) ? getInstantiatedType(name, subclass, checker)?.getCallSignatures()[0]?.getReturnType() : undefined;
+    const { type, values, rawType } = instantiated ? mapType(instantiated, checker) : resolveSignalInputType(signalCall, checker);
+    return {
+        name,
+        type,
+        rawType,
+        required,
+        ...(values && { values }),
+        ...(defaultValue !== undefined && { defaultValue }),
+        ...(doc && { doc })
+    };
+}
+/**
+ * Extract all @Output() and output() signal metadata from a class declaration
+ * and the base classes Angular inherits outputs from.
+ */
+export function extractOutputs(classDecl, checker, hierarchy = getClassHierarchy(classDecl, checker)) {
     const outputs = [];
-    for (const member of classDecl.members) {
-        if (!ts.isPropertyDeclaration(member))
+    const seen = new Set();
+    for (const { classDecl: owner, definesMetadata } of hierarchy.classes) {
+        if (!definesMetadata)
             continue;
-        const name = member.name && ts.isIdentifier(member.name)
-            ? member.name.text
-            : undefined;
-        if (!name)
-            continue;
-        const outputDecorator = findDecorator(member, 'Output');
-        if (outputDecorator) {
-            const doc = getJsDocComment(member, checker);
-            outputs.push({ name, ...(doc && { doc }) });
-            continue;
-        }
-        if (isOutputSignal(member)) {
+        for (const member of owner.members) {
+            if (!ts.isPropertyDeclaration(member))
+                continue;
+            const name = member.name && ts.isIdentifier(member.name) ? member.name.text : undefined;
+            if (!name || seen.has(name))
+                continue;
+            if (!findDecorator(member, 'Output') && !isOutputSignal(member))
+                continue;
             const doc = getJsDocComment(member, checker);
+            seen.add(name);
             outputs.push({ name, ...(doc && { doc }) });
         }
     }
     return outputs;
 }
+/**
+ * Whether a declared type, or the expression a type is inferred from,
+ * mentions a type parameter of the class that declares it. Only then does the
+ * subclass change the type; otherwise the source text stays, alias names included.
+ */
+function usesTypeParameters(node, owner, checker) {
+    const parameters = owner.typeParameters;
+    if (!node || !parameters?.length)
+        return false;
+    const isOwnParameter = (declaration) => !!declaration && ts.isTypeParameterDeclaration(declaration) && parameters.includes(declaration);
+    const visit = (child) => {
+        if (ts.isTypeReferenceNode(child) && ts.isIdentifier(child.typeName) && isOwnParameter(checker.getSymbolAtLocation(child.typeName)?.declarations?.[0])) {
+            return true;
+        }
+        return ts.forEachChild(child, visit) ?? false;
+    };
+    // An inferred type can depend on `T` without the source naming it: `model(this.initial)`.
+    return visit(node) || (!ts.isTypeNode(node) && typeMentions(checker.getTypeAtLocation(node), isOwnParameter, checker));
+}
+function typeMentions(type, isOwnParameter, checker, visited = new Set()) {
+    if (visited.has(type))
+        return false;
+    visited.add(type);
+    if (type.flags & ts.TypeFlags.TypeParameter)
+        return isOwnParameter(type.symbol?.declarations?.[0]);
+    const isReference = type.flags & ts.TypeFlags.Object && type.objectFlags & ts.ObjectFlags.Reference;
+    const nested = [
+        ...(type.isUnionOrIntersection() ? type.types : []),
+        ...(type.aliasTypeArguments ?? []),
+        ...(isReference ? checker.getTypeArguments(type) : [])
+    ];
+    return nested.some((t) => typeMentions(t, isOwnParameter, checker, visited));
+}
+/**
+ * The type of a property declared in a generic base class, as the subclass
+ * sees it: `items = input.required<T[]>()` in `Field<T>` is an
+ * `InputSignal<Country[]>` on `Picker extends Field<Country>`.
+ */
+function getInstantiatedType(name, subclass, checker) {
+    const property = checker.getPropertyOfType(checker.getTypeAtLocation(subclass), name);
+    return property && checker.getTypeOfSymbolAtLocation(property, subclass);
+}
+/**
+ * A default is all or nothing. The renderer applies it to the component, so
+ * the part of `{ ...shared, size: 'm' }` that can be read would overwrite the
+ * whole default the component actually declares.
+ */
+function evaluateDefault(node, checker) {
+    let complete = true;
+    const value = evaluateStatic(node, { checker, report: () => (complete = false) });
+    return complete ? value : undefined;
+}
 function getInputSignalCall(member) {
     const init = member.initializer;
     if (!init || !ts.isCallExpression(init))
@@ -97,9 +187,7 @@ function getInputSignalCall(member) {
 }
 function isSignalInputRequired(callExpr) {
     const expr = callExpr.expression;
-    return (ts.isPropertyAccessExpression(expr) &&
-        ts.isIdentifier(expr.name) &&
-        expr.name.text === 'required');
+    return ts.isPropertyAccessExpression(expr) && ts.isIdentifier(expr.name) && expr.name.text === 'required';
 }
 function isOutputSignal(member) {
     const init = member.initializer;
@@ -125,9 +213,7 @@ function isDecoratorInputRequired(decorator) {
     if (!arg || !ts.isObjectLiteralExpression(arg))
         return false;
     for (const prop of arg.properties) {
-        if (ts.isPropertyAssignment(prop) &&
-            ts.isIdentifier(prop.name) &&
-            prop.name.text === 'required') {
+        if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name) && prop.name.text === 'required') {
             return prop.initializer.kind === ts.SyntaxKind.TrueKeyword;
         }
     }
@@ -135,19 +221,14 @@ function isDecoratorInputRequired(decorator) {
 }
 function resolveDecoratorInputType(member, checker) {
     const tsType = checker.getTypeAtLocation(member);
-    const declaredText = member.type
-        ? normalizeTypeText(member.type.getText())
-        : undefined;
+    const declaredText = member.type ? normalizeTypeText(member.type.getText()) : undefined;
     return mapType(tsType, checker, declaredText);
 }
 function normalizeTypeText(text) {
     return text.replace(/\s+/g, ' ').trim();
 }
 function getRawTypeLabel(tsType, checker) {
-    if (tsType.flags &
-        (ts.TypeFlags.Boolean |
-            ts.TypeFlags.BooleanLike |
-            ts.TypeFlags.BooleanLiteral)) {
+    if (tsType.flags & (ts.TypeFlags.Boolean | ts.TypeFlags.BooleanLike | ts.TypeFlags.BooleanLiteral)) {
         return 'boolean';
     }
     if (tsType.isUnion()) {

package/dist/builder/scanner/manifest.generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.generator.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/manifest.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,gBAAgB,EAAE,GAC7B,MAAM,CAyBR"}
+{"version":3,"file":"manifest.generator.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/manifest.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAyBvE"}

package/dist/builder/scanner/manifest.generator.js

@@ -3,11 +3,11 @@
  */
 export function generateManifest(components) {
     const lines = [
-        '// AUTO-GENERATED by ng-prism — do not edit!',
+        '// AUTO-GENERATED by ng-prism. Do not edit!',
         "import type { PrismManifest } from 'ng-prism/plugin';",
         '',
         'export const PRISM_MANIFEST: PrismManifest = {',
-        '  components: [',
+        '  components: ['
     ];
     for (const comp of components) {
         lines.push('    {');
@@ -30,6 +30,10 @@ function json(value) {
 function indent(depth) {
     return ' '.repeat(depth);
 }
+/** `'aria-label'` and content slots like `'[card-header]'` are only valid keys in quotes. */
+function formatKey(key) {
+    return /^[A-Za-z_$][\w$]*$/.test(key) ? key : JSON.stringify(key);
+}
 function formatObject(obj, baseIndent) {
     const entries = Object.entries(obj).filter(([, v]) => v !== undefined);
     if (entries.length === 0)
@@ -41,7 +45,7 @@ function formatObject(obj, baseIndent) {
             : typeof value === 'object' && value !== null
                 ? formatObject(value, inner)
                 : json(value);
-        return `${indent(inner)}${key}: ${formatted},`;
+        return `${indent(inner)}${formatKey(key)}: ${formatted},`;
     });
     return `{\n${lines.join('\n')}\n${indent(baseIndent)}}`;
 }
@@ -50,9 +54,7 @@ function formatArray(arr, baseIndent) {
         return '[]';
     const inner = baseIndent + 2;
     const items = arr.map((item) => {
-        const formatted = typeof item === 'object' && item !== null && !Array.isArray(item)
-            ? formatObject(item, inner)
-            : json(item);
+        const formatted = typeof item === 'object' && item !== null && !Array.isArray(item) ? formatObject(item, inner) : json(item);
         return `${indent(inner)}${formatted},`;
     });
     return `[\n${items.join('\n')}\n${indent(baseIndent)}]`;

package/dist/builder/scanner/scanner.d.ts

@@ -7,6 +7,8 @@ export interface CreateScannerOptions {
 }
 export interface ScanResult {
     components: ScannedComponent[];
+    /** One message per @Showcase value the scan had to drop, already printed as a warning. */
+    diagnostics: string[];
 }
 export interface Scanner {
     /** Scan all entry points. Reuses TypeScript program state from previous scans. */
@@ -16,7 +18,7 @@ export interface Scanner {
  * Create a stateful multi-entry scanner that retains the previous ts.Program between scans.
  * A single shared program is created with every entry-point file as a root name, so the
  * 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.
+ * 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.

package/dist/builder/scanner/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC5C,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,OAAO;IACtB,kFAAkF;IAClF,IAAI,IAAI,UAAU,CAAC;CACpB;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAoDpE"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,KAAK,eAAe,EAA4B,MAAM,0BAA0B,CAAC;AAE1F,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC5C,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,0FAA0F;IAC1F,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACpB,kFAAkF;IAClF,IAAI,IAAI,UAAU,CAAC;CACtB;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAiDpE"}

package/dist/builder/scanner/scanner.js

@@ -1,6 +1,6 @@
 import ts from 'typescript';
-import { resolveEntryPointExports, } from './entry-point.scanner.js';
 import { scanComponents } from './component.scanner.js';
+import { resolveEntryPointExports } from './entry-point.scanner.js';
 const DEFAULT_COMPILER_OPTIONS = {
     target: ts.ScriptTarget.ES2022,
     module: ts.ModuleKind.ES2022,
@@ -13,14 +13,14 @@ const DEFAULT_COMPILER_OPTIONS = {
     types: [],
     // Perf: we never call program.emit(); skip emit-related setup work.
     noEmit: true,
-    // Perf: complement to skipLibCheck — also skip type-checking lib.*.d.ts files.
-    skipDefaultLibCheck: true,
+    // Perf: complements skipLibCheck by also skipping type-checking of lib.*.d.ts files.
+    skipDefaultLibCheck: true
 };
 /**
  * Create a stateful multi-entry scanner that retains the previous ts.Program between scans.
  * A single shared program is created with every entry-point file as a root name, so the
  * 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.
+ * 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.
@@ -28,7 +28,7 @@ const DEFAULT_COMPILER_OPTIONS = {
 export function createScanner(options) {
     const compilerOptions = {
         ...DEFAULT_COMPILER_OPTIONS,
-        ...options.compilerOptions,
+        ...options.compilerOptions
     };
     let previousProgram;
     return {
@@ -37,8 +37,10 @@ export function createScanner(options) {
             previousProgram = program;
             const checker = program.getTypeChecker();
             const allComponents = [];
+            const diagnostics = [];
+            const notices = new Set();
             for (const { exports, importPath } of entries) {
-                const components = scanComponents(exports, checker);
+                const components = scanComponents(exports, checker, diagnostics, notices);
                 for (const c of components)
                     c.importPath = importPath;
                 allComponents.push(...components);
@@ -59,7 +61,7 @@ export function createScanner(options) {
                 seen.add(key);
                 unique.push(c);
             }
-            return { components: unique };
-        },
+            return { components: unique, diagnostics };
+        }
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EAGb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA0FtD,QAAA,MAAM,OAAO,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,UAAU,CACJ,CAAC;AACxD,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAA0D,MAAM,2BAA2B,CAAC;AACjH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAsEtD,QAAA,MAAM,OAAO,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAyD,CAAC;AAErH,eAAe,OAAO,CAAC"}

package/dist/builder/serve/index.js

@@ -1,19 +1,17 @@
-import { createBuilder, } from '@angular-devkit/architect';
-import { join } from 'path';
 import { existsSync } from 'fs';
-import { runPrismPipeline, createPipelineState, } from '../shared/prism-pipeline.js';
+import { join } from 'path';
+import { createBuilder } from '@angular-devkit/architect';
+import { createPipelineState, runPrismPipeline } from '../shared/prism-pipeline.js';
 import { resolveCacheDir } from '../shared/resolve-cache-dir.js';
 import { startWatcher } from '../watcher/index.js';
 async function createServeBuilder(options, context) {
     const cacheDir = resolveCacheDir(options.cacheDir, context.workspaceRoot);
     const pipelineOptions = {
         entryPoint: options.entryPoint,
-        libraryImportPath: options.libraryImportPath ??
-            options.libraryProject ??
-            options.prismProject,
+        libraryImportPath: options.libraryImportPath ?? options.libraryProject ?? options.prismProject,
         prismProject: options.prismProject,
         configFile: options.configFile ?? 'ng-prism.config.ts',
-        cacheDir,
+        cacheDir
     };
     const state = createPipelineState();
     await runPrismPipeline(pipelineOptions, context, state);
@@ -30,8 +28,8 @@ async function createServeBuilder(options, context) {
         },
         logger: {
             info: (msg) => context.logger.info(msg),
-            error: (msg) => context.logger.error(msg),
-        },
+            error: (msg) => context.logger.error(msg)
+        }
     });
     const run = await context.scheduleTarget({ project: options.prismProject, target: 'serve', configuration: '' }, { port: options.port ?? 4400 });
     const shutdown = () => {
@@ -59,7 +57,7 @@ async function createServeBuilder(options, context) {
                 cleanupSignals();
                 watcher.close();
                 resolve(lastOutput ?? { success: false });
-            },
+            }
         });
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

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

@@ -1,3 +1,3 @@
-export { runPrismPipeline, createPipelineState } from './prism-pipeline.js';
+export { createPipelineState, runPrismPipeline } from './prism-pipeline.js';
 export type { PrismPipelineOptions, PrismPipelineResult, PrismPipelineState } from './prism-pipeline.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/builder/shared/index.js

@@ -1 +1 @@
-export { runPrismPipeline, createPipelineState } from './prism-pipeline.js';
+export { createPipelineState, runPrismPipeline } from './prism-pipeline.js';

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":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAapE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,oGAAoG;IACpG,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAyF9B"}
+{"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"}