@ng-prism/core 22.4.1 → 22.6.0

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

@@ -1,4 +1,4 @@
-import { computed, inject, Injectable, signal } from '@angular/core';
+import { computed, effect, inject, Injectable, signal, untracked } from '@angular/core';
 import { PrismNavigationService } from './prism-navigation.service.js';
 import * as i0 from "@angular/core";
 export function computeVariantState(comp, index, options = {}) {
@@ -57,6 +57,13 @@ export class PrismRendererService {
     navigationService = inject(PrismNavigationService);
     activeVariantIndex = signal(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "activeVariantIndex" }] : /* istanbul ignore next */ []));
+    /**
+     * Position in `ShowcaseConfig.states` of the component-level state on the
+     * canvas, `null` for none. Part of the addressed cell next to the variant:
+     * it survives a variant change and goes with the component.
+     */
+    activeStateIndex = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "activeStateIndex" }] : /* istanbul ignore next */ []));
     inputValues = signal({}, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "inputValues" }] : /* istanbul ignore next */ []));
     activeContent = signal(undefined, /* @ts-ignore */
@@ -78,20 +85,45 @@ export class PrismRendererService {
         return count;
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "dirtyInputCount" }] : /* istanbul ignore next */ []));
+    /** The component the variant, the state and the inputs belong to, `null` before the first. */
     _lastClassName = null;
+    constructor() {
+        // The variant and the state go with the component in every view, so the reset on a switch follows
+        // navigation, not the renderer: the shell mounts `<prism-renderer>` in the Playground only, and the Overview
+        // keeps its view when the sidebar picks another component. A root effect, created before the URL service's,
+        // so it runs first in the same flush and the URL never sees the previous component's cell on the new one.
+        effect(() => {
+            const comp = this.navigationService.activeComponent();
+            if (comp)
+                untracked(() => this.reconcileForComponent(comp));
+        });
+    }
     resetForComponent(comp) {
         this._lastClassName = comp.meta.className;
         this.activeVariantIndex.set(0);
+        this.activeStateIndex.set(null);
         this.applyVariant(0, comp);
     }
+    /**
+     * Brings the variant, the state and the inputs in line with `comp`: a full
+     * reset when it is another component than the last one, else the variant
+     * and the state clamped to what it still declares and the inputs kept.
+     * Runs on every navigation and again when the renderer mounts, which then
+     * finds the component current and keeps what an Overview cell or a restore
+     * selected.
+     */
     reconcileForComponent(comp) {
         const prev = this._lastClassName;
         this._lastClassName = comp.meta.className;
         if (prev !== null && prev !== comp.meta.className) {
             this.activeVariantIndex.set(0);
+            this.activeStateIndex.set(null);
             this.applyVariant(0, comp);
             return;
         }
+        const stateIndex = this.activeStateIndex();
+        if (stateIndex !== null && stateIndex >= (comp.meta.showcaseConfig.states?.length ?? 0))
+            this.activeStateIndex.set(null);
         const variants = comp.meta.showcaseConfig.variants ?? [];
         const maxIndex = Math.max(0, variants.length - 1);
         const preservedIndex = Math.min(this.activeVariantIndex(), maxIndex);
@@ -125,6 +157,9 @@ export class PrismRendererService {
         if (comp)
             this.applyVariant(index, comp);
     }
+    selectState(index) {
+        this.activeStateIndex.set(index);
+    }
     updateInput(name, value) {
         this.inputValues.update((prev) => ({ ...prev, [name]: value }));
     }
@@ -147,4 +182,4 @@ export class PrismRendererService {
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(PrismRendererService, [{
         type: Injectable,
         args: [{ providedIn: 'root' }]
-    }], null, null); })();
+    }], () => [], null); })();

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

@@ -1 +1 @@
-{"version":3,"file":"prism-url-state.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-url-state.service.ts"],"names":[],"mappings":";AAgBA,qBACa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,IAAI,IAAI;IAqBZ,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,UAAU;yCA1ET,oBAAoB;;CA+GhC"}
+{"version":3,"file":"prism-url-state.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-url-state.service.ts"],"names":[],"mappings":";AAiCA,qBACa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,IAAI,IAAI;IAsBZ,OAAO,CAAC,cAAc;IA2DtB,OAAO,CAAC,UAAU;yCA3FT,oBAAoB;;CAmIhC"}

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

@@ -8,10 +8,25 @@ import * as i0 from "@angular/core";
 const PARAM_COMPONENT = 'component';
 const PARAM_PAGE = 'page';
 const PARAM_VARIANT = 'variant';
+const PARAM_STATE = 'state';
 const PARAM_VIEW = 'view';
 const DEFAULT_VIEW = 'renderer';
 const PARAM_PANEL = 'panel';
 const DEFAULT_PANEL = 'controls';
+/** The index a `variant` parameter addresses in a list of `count` variants, `0` for anything that is not one. */
+function parseVariantIndex(param, count) {
+    if (param === null)
+        return 0;
+    const index = parseInt(param, 10);
+    return !Number.isNaN(index) && index >= 0 && index < count ? index : 0;
+}
+/** The index a `state` parameter addresses in a list of `count` states, `null` for anything that is not one. */
+function parseStateIndex(param, count) {
+    if (param === null || !/^\d+$/.test(param))
+        return null;
+    const index = Number(param);
+    return index < count ? index : null;
+}
 export class PrismUrlStateService {
     manifestService = inject(PrismManifestService);
     navigationService = inject(PrismNavigationService);
@@ -27,11 +42,12 @@ export class PrismUrlStateService {
         effect(() => {
             const item = this.navigationService.activeItem();
             const variantIndex = this.rendererService.activeVariantIndex();
+            const stateIndex = this.rendererService.activeStateIndex();
             const viewId = this.panelService.activeViewId();
             const panelId = this.panelService.activePanelId();
             if (this.suppressSync)
                 return;
-            this.writeToUrl(item, variantIndex, viewId, panelId);
+            this.writeToUrl(item, variantIndex, stateIndex, viewId, panelId);
         }, { injector: this.injector });
         window.addEventListener('popstate', () => this.restoreFromUrl());
     }
@@ -40,21 +56,32 @@ export class PrismUrlStateService {
         const componentClassName = params.get(PARAM_COMPONENT);
         const pageTitle = params.get(PARAM_PAGE);
         const variantParam = params.get(PARAM_VARIANT);
+        const stateParam = params.get(PARAM_STATE);
         const viewId = params.get(PARAM_VIEW);
         const panelId = params.get(PARAM_PANEL);
+        let stateIndex = null;
         this.suppressSync = true;
         try {
             if (componentClassName) {
                 const comp = this.manifestService.components().find((c) => c.meta.className === componentClassName);
                 if (comp) {
+                    const previousClassName = this.navigationService.activeComponent()?.meta.className;
                     this.navigationService.select(comp);
-                    if (variantParam !== null) {
-                        const index = parseInt(variantParam, 10);
-                        const maxIndex = (comp.meta.showcaseConfig.variants?.length ?? 1) - 1;
-                        if (!Number.isNaN(index) && index >= 0 && index <= maxIndex) {
-                            this.rendererService.activeVariantIndex.set(index);
-                        }
+                    // Switching to another component resets the variant and the state
+                    // once `PrismRendererService` follows the navigation, after this
+                    // restore. Starting the component here makes it the current one
+                    // before the indexes below are set, so that reset, and the renderer
+                    // mounting it, keep them (a popstate between components). Not for
+                    // the component already on screen: a popstate that addresses it (a
+                    // hash link inside it fires one) must keep the control overrides.
+                    if (previousClassName !== comp.meta.className) {
+                        this.rendererService.resetForComponent(comp);
                     }
+                    const variantIndex = parseVariantIndex(variantParam, comp.meta.showcaseConfig.variants?.length ?? 1);
+                    if (variantIndex !== this.rendererService.activeVariantIndex()) {
+                        this.rendererService.selectVariant(variantIndex);
+                    }
+                    stateIndex = parseStateIndex(stateParam, comp.meta.showcaseConfig.states?.length ?? 0);
                 }
             }
             else if (pageTitle) {
@@ -63,6 +90,7 @@ export class PrismUrlStateService {
                     this.navigationService.selectPage(page);
                 }
             }
+            this.rendererService.selectState(stateIndex);
             if (viewId) {
                 this.panelService.activeViewId.set(viewId);
             }
@@ -74,7 +102,7 @@ export class PrismUrlStateService {
             this.suppressSync = false;
         }
     }
-    writeToUrl(item, variantIndex, viewId, panelId) {
+    writeToUrl(item, variantIndex, stateIndex, viewId, panelId) {
         // Built from scratch, never from the current search string: parameters the
         // app does not own must not survive a navigation. `?capture=1` relies on
         // this; the "capture flag" specs pin the guarantee.
@@ -84,6 +112,9 @@ export class PrismUrlStateService {
             if (variantIndex > 0) {
                 params.set(PARAM_VARIANT, String(variantIndex));
             }
+            if (stateIndex !== null) {
+                params.set(PARAM_STATE, String(stateIndex));
+            }
         }
         else if (item?.kind === 'page') {
             params.set(PARAM_PAGE, item.data.title);

package/dist/app/theme/prism-default-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prism-default-theme.d.ts","sourceRoot":"","sources":["../../../src/app/theme/prism-default-theme.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyCnD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyCpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0DpD,CAAC;AAEF,eAAO,MAAM,mBAAmB,wBAAmB,CAAC"}
+{"version":3,"file":"prism-default-theme.d.ts","sourceRoot":"","sources":["../../../src/app/theme/prism-default-theme.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyCnD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyCpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2DpD,CAAC;AAEF,eAAO,MAAM,mBAAmB,wBAAmB,CAAC"}

package/dist/app/theme/prism-default-theme.js

@@ -91,13 +91,14 @@ export const PRISM_BASE_TOKENS = {
     '--dur-base': '0.2s',
     '--dur-slow': '0.3s',
     /**
-     * Chrome density. Set on the shell host, so a consuming app can compact or
-     * loosen the entire interface from CSS alone:
+     * Chrome density. A consuming app compacts or loosens the entire interface
+     * with one token in ng-prism.config.ts:
      *
-     *   prism-shell { --density: .8 }
+     *   theme: { '--density': '0.8' }
      *
-     * There is no signal, service or menu behind this. The whole
-     * control surface is the custom property.
+     * The band heights below resolve it on <html>, where every token is set,
+     * so a --density on a descendant such as prism-shell doesn't reach them.
+     * There is no signal, service or menu behind this.
      */
     '--density': '1',
     '--band-header': 'calc(40px * var(--density))',

package/dist/builder/config-loader/deprecated-options.d.ts

@@ -0,0 +1,7 @@
+import type { NgPrismConfig } from '../../plugin/plugin.types.js';
+/**
+ * One notice per deprecated option the config or one of its plugins sets.
+ * They never had an effect, so the notice only asks to remove them.
+ */
+export declare function describeDeprecatedOptions(config: NgPrismConfig, configFile: string): string[];
+//# sourceMappingURL=deprecated-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-options.d.ts","sourceRoot":"","sources":["../../../src/builder/config-loader/deprecated-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAOlE;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAe7F"}

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

@@ -0,0 +1,23 @@
+/** Config options declared since the first release that nothing has ever read. */
+const DEPRECATED_CONFIG_OPTIONS = ['ui', 'themeStylesheet', 'headless', 'appComponent'];
+const NEVER_HAD_AN_EFFECT = 'which is deprecated and will be removed in 23.0.0. It has never had an effect; remove it.';
+/**
+ * One notice per deprecated option the config or one of its plugins sets.
+ * They never had an effect, so the notice only asks to remove them.
+ */
+export function describeDeprecatedOptions(config, configFile) {
+    const notices = [];
+    for (const option of DEPRECATED_CONFIG_OPTIONS) {
+        if (config[option] !== undefined)
+            notices.push(`${configFile} sets "${option}", ${NEVER_HAD_AN_EFFECT}`);
+    }
+    for (const plugin of config.plugins ?? []) {
+        if (plugin.wrapComponent !== undefined)
+            notices.push(`plugin "${plugin.name}" sets wrapComponent, ${NEVER_HAD_AN_EFFECT}`);
+        for (const panel of plugin.panels ?? []) {
+            if (panel.position !== undefined)
+                notices.push(`plugin "${plugin.name}" sets position on panel "${panel.id}", ${NEVER_HAD_AN_EFFECT}`);
+        }
+    }
+    return notices;
+}

package/dist/builder/manifest/runtime-manifest.generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-manifest.generator.d.ts","sourceRoot":"","sources":["../../../src/builder/manifest/runtime-manifest.generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhF,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAoHD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAkF/E"}
+{"version":3,"file":"runtime-manifest.generator.d.ts","sourceRoot":"","sources":["../../../src/builder/manifest/runtime-manifest.generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhF,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAqHD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAkF/E"}

package/dist/builder/manifest/runtime-manifest.generator.js

@@ -68,8 +68,9 @@ function generateWrapperClass(comp) {
         attrs = '';
         importsArray = `[${comp.className}]`;
     }
-    const inputBindings = bindableInputs.map((i) => ` [${i.name}]="${i.name}()"`).join('');
-    const outputBindings = comp.outputs.map((o) => ` (${o.name})="${o.name}.emit($event)"`).join('');
+    // The wrapper declares its inputs and outputs under the member names and binds the directive's public ones.
+    const inputBindings = bindableInputs.map((i) => ` [${i.alias ?? i.name}]="${i.name}()"`).join('');
+    const outputBindings = comp.outputs.map((o) => ` (${o.alias ?? o.name})="${o.name}.emit($event)"`).join('');
     const template = `<${tag}${attrs} ${directiveAttr}${inputBindings}${outputBindings}>{{ __prismContent__() }}</${tag}>`;
     const members = [];
     for (const i of bindableInputs) {

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

@@ -1 +1 @@
-{"version":3,"file":"component.scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/component.scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAgDrE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,WAAW,GAAE,MAAM,EAAO,EAAE,OAAO,cAAoB,GAAG,gBAAgB,EAAE,CAsEzJ"}
+{"version":3,"file":"component.scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/component.scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAkDrE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,WAAW,GAAE,MAAM,EAAO,EAAE,OAAO,cAAoB,GAAG,gBAAgB,EAAE,CAsEzJ"}

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

@@ -4,7 +4,9 @@ import { CANVAS_LAYOUTS } from '../../shared/canvas-layout.type.js';
 import { evaluateExpression, evaluateStatic, findDecorator, getDecoratorArgument, UNEVALUABLE } from './ast-utils.js';
 import { getClassHierarchy } from './class-hierarchy.js';
 import { extractInputs, extractOutputs } from './input.extractor.js';
+import { describeValue, readPseudoStates } from './pseudo-states.js';
 import { describeDeprecatedProviders, describeUnevaluable, describeUnreadableBase } from './showcase-diagnostics.js';
+import { readShowcaseStates } from './showcase-states.js';
 const COMPONENT_STATUSES = ['stable', 'beta', 'wip', 'deprecated'];
 function isComponentStatus(value) {
     return typeof value === 'string' && COMPONENT_STATUSES.includes(value);
@@ -122,6 +124,8 @@ function extractShowcaseConfig(decorator, className, report, checker) {
         return undefined;
     // Reported once for the whole field below, wherever it came from: the literal, a spread or a constant.
     let providers;
+    // A state the evaluator dropped whole leaves no element behind, so its position is noted to keep the later states where the source has them.
+    const unevaluableStates = new Set();
     const raw = evaluateStatic(arg, {
         checker,
         report: (issue) => {
@@ -129,6 +133,8 @@ function extractShowcaseConfig(decorator, className, report, checker) {
                 providers ??= issue.node;
                 return;
             }
+            if (issue.path[0] === 'states' && issue.path.length === 2 && typeof issue.path[1] === 'number')
+                unevaluableStates.add(issue.path[1]);
             report(describeUnevaluable(className, arg, issue));
         }
     });
@@ -168,6 +174,16 @@ function extractShowcaseConfig(decorator, className, report, checker) {
         config.host = obj['host'];
     if (obj['renderPage'])
         config.renderPage = obj['renderPage'];
+    if (obj['states'] !== undefined) {
+        if (config.renderPage) {
+            report(`${className} declares states together with renderPage; a component page has no Overview to show them in. Skipping states.`);
+        }
+        else {
+            const states = readShowcaseStates(obj['states'], className, report, unevaluableStates);
+            if (states)
+                config.states = states;
+        }
+    }
     if (obj['status'] !== undefined) {
         if (isComponentStatus(obj['status'])) {
             config.status = obj['status'];
@@ -210,6 +226,17 @@ function extractShowcaseConfig(decorator, className, report, checker) {
                     `invalid canvasLayout "${String(variant['canvasLayout'])}", expected one of: ${CANVAS_LAYOUTS.join(', ')}. Skipping.`);
                 delete cleaned['canvasLayout'];
             }
+            if (variant['pseudo'] !== undefined) {
+                const pseudo = readPseudoStates(variant['pseudo'], `${className} variant "${String(variant['name'])}"`, report);
+                if (pseudo)
+                    cleaned['pseudo'] = pseudo;
+                else
+                    delete cleaned['pseudo'];
+            }
+            if (variant['states'] !== undefined && variant['states'] !== false) {
+                report(`${className} variant "${String(variant['name'])}" declares invalid states ${describeValue(variant['states'])}, expected false. Skipping.`);
+                delete cleaned['states'];
+            }
             return cleaned;
         });
     }

package/dist/builder/scanner/entry-point-discovery.d.ts

@@ -3,4 +3,9 @@ export interface DiscoveredEntryPoint {
     importPath: string;
 }
 export declare function discoverSecondaryEntryPoints(libraryRoot: string, baseImportPath: string): DiscoveredEntryPoint[];
+/**
+ * The primary entry file of the library at `libraryRoot`: `lib.entryFile` of its
+ * own `ng-package.json`, or `undefined` when there is no such file.
+ */
+export declare function findPrimaryEntryFile(libraryRoot: string): string | undefined;
 //# sourceMappingURL=entry-point-discovery.d.ts.map

package/dist/builder/scanner/entry-point-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point-discovery.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/entry-point-discovery.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAKhH"}
+{"version":3,"file":"entry-point-discovery.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/entry-point-discovery.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAKhH;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS5E"}

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

@@ -5,6 +5,20 @@ export function discoverSecondaryEntryPoints(libraryRoot, baseImportPath) {
     findNgPackageJsons(libraryRoot, libraryRoot, baseImportPath, entryPoints);
     return entryPoints;
 }
+/** ng-packagr's default for `lib.entryFile`. */
+const NG_PACKAGR_DEFAULT_ENTRY_FILE = 'src/public_api.ts';
+/**
+ * The primary entry file of the library at `libraryRoot`: `lib.entryFile` of its
+ * own `ng-package.json`, or `undefined` when there is no such file.
+ */
+export function findPrimaryEntryFile(libraryRoot) {
+    const ngPackagePath = join(libraryRoot, 'ng-package.json');
+    if (!existsSync(ngPackagePath))
+        return undefined;
+    const ngPackage = JSON.parse(readFileSync(ngPackagePath, 'utf-8'));
+    const entryFilePath = join(libraryRoot, ngPackage.lib?.entryFile ?? NG_PACKAGR_DEFAULT_ENTRY_FILE);
+    return existsSync(entryFilePath) ? entryFilePath : undefined;
+}
 function findNgPackageJsons(dir, libraryRoot, baseImportPath, result) {
     const isLibraryRoot = dir === libraryRoot;
     const ngPackagePath = join(dir, 'ng-package.json');

package/dist/builder/scanner/entry-point.scanner.d.ts

@@ -2,6 +2,8 @@ import ts from 'typescript';
 export interface EntryPointInput {
     entryFile: string;
     importPath: string;
+    /** The library's primary entry point. A component it re-exports from a secondary one keeps that one, silently. */
+    primary?: boolean;
 }
 export interface ResolvedEntryPoint extends EntryPointInput {
     exports: ts.Symbol[];
@@ -18,5 +20,5 @@ export interface MultiEntryResult {
  *
  * Re-exports (`export * from '...'`) are resolved automatically by TypeScript.
  */
-export declare function resolveEntryPointExports(entryPoints: ReadonlyArray<EntryPointInput>, compilerOptions: ts.CompilerOptions, previousProgram?: ts.Program): MultiEntryResult;
+export declare function resolveEntryPointExports(entryPoints: ReadonlyArray<EntryPointInput>, compilerOptions: ts.CompilerOptions, previousProgram?: ts.Program, host?: ts.CompilerHost): MultiEntryResult;
 //# sourceMappingURL=entry-point.scanner.d.ts.map

package/dist/builder/scanner/entry-point.scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point.scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/entry-point.scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACvD,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACpC,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,EAC3C,eAAe,EAAE,EAAE,CAAC,eAAe,EACnC,eAAe,CAAC,EAAE,EAAE,CAAC,OAAO,GAC7B,gBAAgB,CA4BlB"}
+{"version":3,"file":"entry-point.scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/entry-point.scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kHAAkH;IAClH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACvD,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACpC,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,EAC3C,eAAe,EAAE,EAAE,CAAC,eAAe,EACnC,eAAe,CAAC,EAAE,EAAE,CAAC,OAAO,EAC5B,IAAI,CAAC,EAAE,EAAE,CAAC,YAAY,GACvB,gBAAgB,CA8BlB"}

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

@@ -7,23 +7,24 @@ import ts from 'typescript';
  *
  * Re-exports (`export * from '...'`) are resolved automatically by TypeScript.
  */
-export function resolveEntryPointExports(entryPoints, compilerOptions, previousProgram) {
-    const program = ts.createProgram(entryPoints.map((e) => e.entryFile), compilerOptions, undefined, previousProgram);
+export function resolveEntryPointExports(entryPoints, compilerOptions, previousProgram, host) {
+    const program = ts.createProgram(entryPoints.map((e) => e.entryFile), compilerOptions, host, previousProgram);
     const checker = program.getTypeChecker();
-    const entries = entryPoints.map(({ entryFile, importPath }) => {
+    const entries = entryPoints.map((entryPoint) => {
+        const { entryFile } = entryPoint;
         try {
             const sourceFile = program.getSourceFile(entryFile);
             if (!sourceFile) {
                 console.warn(`⚠ ng-prism: source file not found for entry point ${entryFile}, skipping.`);
-                return { entryFile, importPath, exports: [] };
+                return { ...entryPoint, exports: [] };
             }
             const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
             const exports = moduleSymbol ? checker.getExportsOfModule(moduleSymbol) : [];
-            return { entryFile, importPath, exports };
+            return { ...entryPoint, exports };
         }
         catch (err) {
             console.error(`⚠ ng-prism: failed to resolve exports for ${entryFile}: ${err instanceof Error ? err.message : String(err)}`);
-            return { entryFile, importPath, exports: [] };
+            return { ...entryPoint, exports: [] };
         }
     });
     return { program, entries };

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

@@ -1 +1 @@
-{"version":3,"file":"input.extractor.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/input.extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,gDAAwC,GAAG,SAAS,EAAE,CAuCrJ;AAsED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,gDAAwC,GAAG,UAAU,EAAE,CAuBvJ"}
+{"version":3,"file":"input.extractor.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/input.extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,gDAAwC,GAAG,SAAS,EAAE,CAuCrJ;AAwFD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,gDAAwC,GAAG,UAAU,EAAE,CA4BvJ"}

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

@@ -1,5 +1,5 @@
 import ts from 'typescript';
-import { evaluateStatic, findDecorator, getDecoratorArgument, getJsDocComment } from './ast-utils.js';
+import { evaluateExpression, 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
@@ -58,12 +58,14 @@ function readInput(member, name, checker, owner, subclass) {
     const inputDecorator = findDecorator(member, 'Input');
     if (inputDecorator) {
         const required = isDecoratorInputRequired(inputDecorator);
+        const alias = readAlias(getDecoratorArgument(inputDecorator), name, checker);
         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,
+            ...(alias && { alias }),
             type,
             rawType,
             required,
@@ -76,6 +78,8 @@ function readInput(member, name, checker, owner, subclass) {
     if (!signalCall)
         return undefined;
     const required = isSignalInputRequired(signalCall);
+    // `input(initial, options)`, but `input.required(options)`.
+    const alias = readAlias(signalCall.arguments[required ? 0 : 1], name, checker);
     const defaultValue = readInitialValue(member, checker);
     const doc = getJsDocComment(member, checker);
     const declaredType = signalCall.typeArguments?.[0] ?? signalCall.arguments[0];
@@ -84,6 +88,7 @@ function readInput(member, name, checker, owner, subclass) {
     const { type, values, rawType } = instantiated ? mapType(instantiated, checker) : resolveSignalInputType(signalCall, checker);
     return {
         name,
+        ...(alias && { alias }),
         type,
         rawType,
         required,
@@ -92,6 +97,17 @@ function readInput(member, name, checker, owner, subclass) {
         ...(doc && { doc })
     };
 }
+/**
+ * The `alias` of an input or output, from a decorator argument (`'x'` or
+ * `{ alias: 'x' }`) or the options of `input()`, `model()` and `output()`.
+ * It counts when the builder can evaluate it statically to a string (a literal
+ * or a constant) that differs from the member name.
+ */
+function readAlias(arg, name, checker) {
+    const value = arg ? evaluateExpression(arg, checker) : undefined;
+    const alias = typeof value === 'object' && value !== null ? value['alias'] : value;
+    return typeof alias === 'string' && alias !== name ? alias : undefined;
+}
 /**
  * Extract all @Output() and output() signal metadata from a class declaration
  * and the base classes Angular inherits outputs from.
@@ -108,11 +124,14 @@ export function extractOutputs(classDecl, checker, hierarchy = getClassHierarchy
             const name = member.name && ts.isIdentifier(member.name) ? member.name.text : undefined;
             if (!name || seen.has(name))
                 continue;
-            if (!findDecorator(member, 'Output') && !isOutputSignal(member))
+            const outputDecorator = findDecorator(member, 'Output');
+            if (!outputDecorator && !isOutputSignal(member))
                 continue;
             const doc = getJsDocComment(member, checker);
+            const options = outputDecorator ? getDecoratorArgument(outputDecorator) : member.initializer.arguments[0];
+            const alias = readAlias(options, name, checker);
             seen.add(name);
-            outputs.push({ name, ...(doc && { doc }) });
+            outputs.push({ name, ...(alias && { alias }), ...(doc && { doc }) });
         }
     }
     return outputs;

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

@@ -0,0 +1,12 @@
+import { type ForcedPseudoStates } from '../../shared/pseudo-state.type.js';
+export declare function describeValue(value: unknown): string;
+/**
+ * `Variant.pseudo` as the scanner evaluated it, with everything it cannot use
+ * reported and dropped: a value that is no object, an unknown state, and a
+ * target that is neither `true` nor selectors. `undefined` when nothing is left.
+ *
+ * Selectors are checked to be non-empty strings only. Whether one parses is up
+ * to the browser, which warns about it once the variant renders.
+ */
+export declare function readPseudoStates(value: unknown, where: string, report: (message: string) => void): ForcedPseudoStates | undefined;
+//# sourceMappingURL=pseudo-states.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pseudo-states.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/pseudo-states.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAsD,MAAM,mCAAmC,CAAC;AAUhI,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,kBAAkB,GAAG,SAAS,CAmBjI"}

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

@@ -0,0 +1,58 @@
+import { PSEUDO_STATES } from '../../shared/pseudo-state.type.js';
+function isPseudoState(value) {
+    return PSEUDO_STATES.includes(value);
+}
+function isSelector(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+export function describeValue(value) {
+    if (typeof value === 'string' || (typeof value === 'object' && value !== null))
+        return JSON.stringify(value) ?? String(value);
+    return String(value);
+}
+/**
+ * `Variant.pseudo` as the scanner evaluated it, with everything it cannot use
+ * reported and dropped: a value that is no object, an unknown state, and a
+ * target that is neither `true` nor selectors. `undefined` when nothing is left.
+ *
+ * Selectors are checked to be non-empty strings only. Whether one parses is up
+ * to the browser, which warns about it once the variant renders.
+ */
+export function readPseudoStates(value, where, report) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        report(`${where} declares invalid pseudo ${describeValue(value)}, expected an object mapping pseudo states to true or selectors. Skipping.`);
+        return undefined;
+    }
+    const states = {};
+    for (const [state, target] of Object.entries(value)) {
+        if (!isPseudoState(state)) {
+            report(`${where} declares unknown pseudo state "${state}", expected one of: ${PSEUDO_STATES.join(', ')}. Skipping.`);
+            continue;
+        }
+        const read = readTarget(target, `${where} declares pseudo state "${state}"`, report);
+        if (read !== undefined)
+            states[state] = read;
+    }
+    return Object.keys(states).length > 0 ? states : undefined;
+}
+function readTarget(target, where, report) {
+    if (target === true || isSelector(target))
+        return target;
+    if (typeof target === 'string') {
+        report(`${where} with an empty selector. Skipping.`);
+        return undefined;
+    }
+    if (Array.isArray(target)) {
+        const selectors = target.filter(isSelector);
+        const invalid = target.filter((entry) => !isSelector(entry));
+        if (invalid.length > 0) {
+            report(`${where} with ${invalid.map(describeValue).join(', ')} in its selector list, expected non-empty strings. Skipping ${invalid.length === 1 ? 'it' : 'them'}.`);
+        }
+        else if (selectors.length === 0) {
+            report(`${where} with an empty selector list. Skipping.`);
+        }
+        return selectors.length > 0 ? selectors : undefined;
+    }
+    report(`${where} with invalid target ${describeValue(target)}, expected true, a selector or a list of selectors. Skipping.`);
+    return undefined;
+}

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

@@ -20,8 +20,8 @@ export interface Scanner {
  * 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 declare function createScanner(options: CreateScannerOptions): Scanner;
 //# sourceMappingURL=scanner.d.ts.map

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