@ng-prism/core 22.5.0 → 22.7.0-beta.0

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

@@ -1,20 +1,33 @@
 import type { Provider, Type } from '@angular/core';
+import type { ShowcaseImport } from '../decorator/showcase.types.js';
 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';
+import type { RuntimePipe, ScannedPipe } from './pipe.types.js';
+import type { ApiDocTags, ApiMethod, ApiTypeDoc, ApiTypeRef, PanelTarget, RuntimeService, ScannedService } from './service.types.js';
 export interface NgPrismPlugin {
     /** Unique plugin name, used for debugging and conflict detection */
     name: string;
     onComponentScanned?: (component: ScannedComponent) => ScannedComponent | void | Promise<ScannedComponent | void>;
+    onServiceScanned?: (service: ScannedService) => ScannedService | void | Promise<ScannedService | void>;
+    onPipeScanned?: (pipe: ScannedPipe) => ScannedPipe | void | Promise<ScannedPipe | void>;
     onPageScanned?: (page: StyleguidePage) => StyleguidePage | void | Promise<StyleguidePage | void>;
     onManifestReady?: (manifest: PrismManifest) => PrismManifest | void | Promise<PrismManifest | void>;
+    /**
+     * Set when a hook or a panel of the plugin reads {@link ScannedComponent.api}. The scan only reads the API of the
+     * components, and the manifest only carries it, when a plugin in the config sets this. Read from the plugin's
+     * Node entry, like the build-time hooks.
+     *
+     * @experimental Experimental until 23.0.0, like {@link ComponentApi}: it may change in a 22.x minor release.
+     */
+    componentApi?: boolean;
     panels?: PanelDefinition[];
     controls?: ControlDefinition[];
     /** Header widgets rendered in the Prism shell header bar */
     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 {
@@ -32,13 +45,26 @@ export interface HeaderWidgetDefinition {
     /** Sort order within the same placement (lower = earlier). Default: 0. */
     order?: number;
 }
-/** A short marker rendered on a panel's tab, usually a count. */
+/**
+ * A short marker on a panel's tab.
+ *
+ * Two kinds, and a filled badge means exactly one thing: `issues` is a number of
+ * open findings, drawn as a pill in its tone and hidden at zero; `count` is a
+ * plain quantity, drawn as a muted figure without a fill.
+ */
 export interface PanelBadge {
+    /** Defaults from `variant` for badges written before 22.7: a judgement is `issues`, anything else `count`. Since 22.7.0. */
+    kind?: 'count' | 'issues';
     /** Kept to a couple of characters because the tab bar scrolls horizontally. */
     text: string;
+    /** Tone of an `issues` badge. Default `'danger'`. Since 22.7.0. */
+    tone?: 'primary' | 'warn' | 'danger';
+    /** Read after the tab's label by assistive technology, e.g. `'1 violation'`. Defaults to `text`. Since 22.7.0. */
+    label?: string;
     /**
-     * Colour role. `default` is the neutral primary tint used for a plain count;
-     * the other three carry a judgement and should be reserved for one.
+     * @deprecated Deprecated since 22.7.0, removed in 23.0.0. Use `kind` and `tone`:
+     * `warn`/`danger` map to `kind: 'issues'` with that tone, `default` to `kind: 'count'`,
+     * and `ok` is not rendered.
      */
     variant?: 'default' | 'ok' | 'warn' | 'danger';
 }
@@ -83,9 +109,22 @@ 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';
+    /**
+     * Where this panel appears. Default: `['component']`. A panel with `'component'`
+     * gets the input `activeComponent`, one with `'service'` gets the input
+     * `activeService` (`RuntimeService | null`), one with `'pipe'` gets the input
+     * `activePipe` (`RuntimePipe | null`). `isVisible` and `badge` are only
+     * called for components.
+     *
+     * `'service'` and `'pipe'` only count on a view panel (`placement: 'view'`): a
+     * service or pipe page has no addon area, so an addon panel shows on component
+     * pages alone, and only when it applies to `'component'`. Since 22.7.0.
+     */
+    appliesTo?: readonly PanelTarget[];
     /** Providers injected into a child EnvironmentInjector scoped to this panel */
     providers?: Provider[];
     /** When provided, the panel tab is only shown if this returns true for the active component */
@@ -118,6 +157,8 @@ export interface ControlDefinition {
 }
 export interface PrismManifest {
     components: ScannedComponent[];
+    services?: ScannedService[];
+    pipes?: ScannedPipe[];
     pages?: StyleguidePage[];
     /** Library-wide plugin metadata (e.g. aggregate coverage totals). */
     meta?: Record<string, unknown>;
@@ -144,24 +185,121 @@ export interface ScannedComponent {
         className: string;
         filePath: string;
     }[];
+    /**
+     * What the API page needs beyond `inputs` and `outputs`. Read only when a
+     * plugin in the config sets {@link NgPrismPlugin.componentApi}. Absent
+     * without one, when the scan cannot read it, when a plugin hook builds the
+     * component, or in the manifest of an older core.
+     *
+     * @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release.
+     */
+    api?: ComponentApi;
+    /**
+     * The compositions of the showcase: what its variants render, written as Angular templates. Absent when no variant
+     * declares a `template` or a host template, and when a plugin hook builds the component. Since 22.7.0.
+     */
+    composition?: ComponentComposition;
     /** Arbitrary plugin metadata */
     meta?: Record<string, unknown>;
 }
+/**
+ * One distinct composition of a showcase, the markup of one or more variants as the generated wrapper renders it in a
+ * `@case`. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release.
+ */
+export interface CompositionCase {
+    /**
+     * The markup as written, the subject element included, with `COMPOSITION_SUBJECT_SLOT` at the end of the start tag
+     * of the subject.
+     */
+    template: string;
+    /**
+     * The inputs of the subject that the wrapper does not bind in this case: `'template'` when the template sets the
+     * input itself, `'default'` when its default could not be read and the variant does not set it. Controls show
+     * them as not editable. `name` is the member name.
+     */
+    unbound: {
+        name: string;
+        reason: 'template' | 'default';
+    }[];
+    /**
+     * Where the case comes from, as `file:line` and the variants: for the comments and errors of the generated code.
+     * Set by the scan at build time, absent in the runtime manifest.
+     */
+    origin?: string;
+}
+/**
+ * The compositions of a showcase: the distinct ones, and which one each variant uses. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release.
+ */
+export interface ComponentComposition {
+    /**
+     * One entry per variant, or one for a showcase without variants, which renders as one implicit variant. Each is
+     * the index into `cases`, or `-1` for a variant without a composition, which renders as it did before.
+     */
+    variantCases: number[];
+    cases: CompositionCase[];
+    /**
+     * Every class the generated wrapper imports besides the subject: the library classes the templates use, matched
+     * by selector, the showcase's `imports`, and the class of a directive's object host. Set by the scan, and in the
+     * runtime manifest as well, so that a usage example in the browser can name them.
+     */
+    imports?: ShowcaseImport[];
+}
+/**
+ * What the API page of a component or directive needs beyond `inputs` and `outputs`.
+ *
+ * @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release.
+ */
+export interface ComponentApi {
+    /** The class's own description (Markdown, `{@link}` kept), as for services and pipes. */
+    description?: string;
+    tags: ApiDocTags;
+    /** The type of each input by member name, as written, with links. */
+    inputTypes: Record<string, ApiTypeRef>;
+    /** The payload type of each `output()` by member name. */
+    outputTypes: Record<string, ApiTypeRef>;
+    /** One entry per `model()` input: the change output Angular adds for it. `input` is the member name. */
+    modelChanges: {
+        input: string;
+        event: string;
+        type: ApiTypeRef;
+    }[];
+    /** Public methods with JSDoc of their own or inherited, signatures from the code. */
+    methods: ApiMethod[];
+    types: ApiTypeDoc[];
+}
 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[];
     defaultValue?: unknown;
+    /**
+     * The input starts out with a value the scan could not evaluate, such as the result of a function call: it has a
+     * default, but `defaultValue` cannot say which. Not set for `input<string>()`, which starts out `undefined`.
+     * Since 22.7.0.
+     */
+    defaultUnreadable?: true;
     required: boolean;
     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 {
     components: RuntimeComponent[];
+    services?: RuntimeService[];
+    pipes?: RuntimePipe[];
     pages?: StyleguidePage[];
     /** Library-wide plugin metadata, mirrored from the build-time PrismManifest. */
     meta?: Record<string, unknown>;
@@ -169,14 +307,21 @@ export interface RuntimeManifest {
 export interface RuntimeComponent {
     meta: ScannedComponent;
     type: Type<unknown>;
+    /**
+     * The generated wrapper that renders the compositions of the showcase, for a component with
+     * {@link ScannedComponent.composition}. It is set to the index of the variant through its `__prismVariant__` input.
+     * When every variant is composed, `type` is this wrapper too. Since 22.7.0.
+     */
+    composition?: Type<unknown>;
 }
 /**
  * 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[];
@@ -187,6 +332,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>;
 }
@@ -211,6 +366,23 @@ export interface DiscoveryVariant {
      * 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;
@@ -229,7 +401,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>;
@@ -239,7 +413,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;

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

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

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

@@ -0,0 +1,124 @@
+import type { ShowcaseConfig } from '../decorator/showcase.types.js';
+/** How a service reaches the injector: on its own, or through a providers array. */
+export type ServiceProvision = 'auto' | 'manual';
+/** Where a panel appears: on component pages, on service pages, on pipe pages, or on several. */
+export type PanelTarget = 'component' | 'service' | 'pipe';
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ApiDocTags {
+    deprecated?: string | true;
+    since?: string;
+    /** From `@version`. */
+    version?: string;
+    see?: string[];
+    example?: string[];
+    /** From `@default`. Prose such as "Default `x`." is not read. */
+    default?: string;
+}
+/**
+ * A type as written, plus the ids of documented types it mentions.
+ *
+ * @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release.
+ */
+export interface ApiTypeRef {
+    /** Display text, e.g. `ToastOptions`, `Signal<boolean>`, `number | null`. */
+    text: string;
+    /** Ids of the entries in the page's `types` (service, pipe or component) whose names occur in `text`. Omitted when none. */
+    links?: string[];
+}
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ApiParam {
+    name: string;
+    type: ApiTypeRef;
+    optional: boolean;
+    rest?: true;
+    /** The initializer as written, e.g. `{}`. */
+    defaultValue?: string;
+    /** From `@param`. */
+    description?: string;
+}
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ApiMethod {
+    name: string;
+    params: ApiParam[];
+    returnType: ApiTypeRef;
+    description?: string;
+    tags: ApiDocTags;
+}
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ApiProperty {
+    name: string;
+    type: ApiTypeRef;
+    readonly: boolean;
+    /** `?` on an interface member. */
+    optional?: true;
+    description?: string;
+    tags: ApiDocTags;
+}
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ApiTypeDoc {
+    /** Unique within one page's `types` (service, pipe or component): the name, or `${name}@${importPath}` when two reachable types share a name. */
+    id: string;
+    name: string;
+    kind: 'interface' | 'class' | 'type' | 'enum';
+    importPath: string;
+    description?: string;
+    tags: ApiDocTags;
+    /** Interfaces, classes and object-literal type aliases. */
+    properties?: ApiProperty[];
+    /** Interfaces and classes. */
+    methods?: ApiMethod[];
+    /** A type alias of a literal union: each member as written, e.g. `'top-left'`. */
+    union?: string[];
+    /** Any other type alias: the aliased type as written. */
+    text?: string;
+    /** Enums. */
+    members?: {
+        name: string;
+        value?: string;
+        description?: string;
+    }[];
+    /** Where the type was first reached, e.g. `parameter of show()`, `via options.action`. */
+    reachedFrom?: string;
+}
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ApiSetupEntry {
+    name: string;
+    kind: 'function' | 'token';
+    importPath: string;
+    description?: string;
+    tags: ApiDocTags;
+    /** Functions only. */
+    params?: ApiParam[];
+    returnType?: ApiTypeRef;
+    /** Tokens only: `InjectionToken<T>` as written. */
+    tokenType?: ApiTypeRef;
+    /** The properties of the first parameter's object type (function) or of `T` (token). */
+    config?: ApiProperty[];
+}
+/** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+export interface ServiceApi {
+    description?: string;
+    tags: ApiDocTags;
+    properties: ApiProperty[];
+    methods: ApiMethod[];
+    setup: ApiSetupEntry[];
+    types: ApiTypeDoc[];
+}
+export interface ScannedService {
+    className: string;
+    filePath: string;
+    /** Import path of the entry point that exports the service. */
+    importPath?: string;
+    /** Only the fields that apply to services: title, description, category, categoryOrder, componentOrder, section, sectionOrder, tags, meta, status. */
+    showcaseConfig: ShowcaseConfig;
+    provision: ServiceProvision;
+    /** @experimental Experimental until 23.0.0: the shape may change in a 22.x minor release. */
+    api: ServiceApi;
+    /** Arbitrary plugin metadata */
+    meta?: Record<string, unknown>;
+}
+/** A service in the runtime manifest. Carries data only: the class is never imported into the styleguide. */
+export interface RuntimeService {
+    meta: ScannedService;
+}
+//# sourceMappingURL=service.types.d.ts.map

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

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

package/dist/plugin/service.types.js

@@ -0,0 +1 @@
+export {};

package/dist/plugin/status.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One grading rule for every key figure the styleguide shows.
+ *
+ * Framework-free on purpose: plugins grade at build time in Node
+ * (`onComponentScanned` writes the sidebar's verdict into the meta) and the app
+ * grades live values in the browser, and the two must never disagree about
+ * the same number. Thresholds come from whoever owns the figure: the a11y
+ * config, the coverage plugin, the visual regression plugin.
+ */
+export type StatusTone = 'ok' | 'warn' | 'danger';
+/** How far below a single target a value may fall before it is critical. */
+export declare const STATUS_DANGER_RATIO = 0.75;
+/**
+ * `higher` (default): ok from `ok` up, warn from `warn` up, below that danger.
+ * `lower`: ok up to `ok`, warn up to `warn`, above that danger.
+ */
+export interface StatusThreshold {
+    ok: number;
+    warn: number;
+    direction?: 'higher' | 'lower';
+}
+export declare function statusFor(value: number, threshold: StatusThreshold): StatusTone;
+/** A threshold from a single target: ok at the target, warn down to {@link STATUS_DANGER_RATIO} of it. */
+export declare function thresholdFromTarget(target: number): StatusThreshold;
+/** The most severe of several verdicts; `ok` when there are none. */
+export declare function worstTone(tones: Iterable<StatusTone>): StatusTone;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/plugin/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAClC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,UAAU,CAO/E;AAED,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAEnE;AAID,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,UAAU,CAOjE"}

package/dist/plugin/status.js

@@ -0,0 +1,26 @@
+/** How far below a single target a value may fall before it is critical. */
+export const STATUS_DANGER_RATIO = 0.75;
+export function statusFor(value, threshold) {
+    if (threshold.direction === 'lower') {
+        if (value <= threshold.ok)
+            return 'ok';
+        return value <= threshold.warn ? 'warn' : 'danger';
+    }
+    if (value >= threshold.ok)
+        return 'ok';
+    return value >= threshold.warn ? 'warn' : 'danger';
+}
+/** A threshold from a single target: ok at the target, warn down to {@link STATUS_DANGER_RATIO} of it. */
+export function thresholdFromTarget(target) {
+    return { ok: target, warn: target * STATUS_DANGER_RATIO };
+}
+const SEVERITY = { ok: 0, warn: 1, danger: 2 };
+/** The most severe of several verdicts; `ok` when there are none. */
+export function worstTone(tones) {
+    let worst = 'ok';
+    for (const tone of tones) {
+        if (SEVERITY[tone] > SEVERITY[worst])
+            worst = tone;
+    }
+    return worst;
+}

package/dist/shared/composition.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Where the subject element of a composition takes the attributes and bindings ng-prism gives it: the end of its start
+ * tag, in `CompositionCase.template`. Snippets replace it with the current values, the generated wrapper with the
+ * bindings. A private-use character, so that it cannot occur in the markup an author wrote. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export declare const COMPOSITION_SUBJECT_SLOT = "\uE000";
+/**
+ * Attribute the generated wrapper puts on the subject element, which is how the styleguide finds it in the rendered
+ * composition. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export declare const COMPOSITION_SUBJECT_ATTR = "data-prism-subject";
+/**
+ * Attribute an author puts on the one of several elements matching the subject's selector that is the subject. It is
+ * removed from the generated template and from snippets. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export declare const SUBJECT_MARKER_ATTR = "prism-subject";
+/**
+ * The input a composition wrapper declares to switch between its cases: the index of the variant, which the wrapper
+ * maps onto a case. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export declare const PRISM_VARIANT_INPUT = "__prismVariant__";
+//# sourceMappingURL=composition.d.ts.map

package/dist/shared/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/shared/composition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,qBAAqB,CAAC"}

package/dist/shared/composition.js

@@ -0,0 +1,29 @@
+/**
+ * Where the subject element of a composition takes the attributes and bindings ng-prism gives it: the end of its start
+ * tag, in `CompositionCase.template`. Snippets replace it with the current values, the generated wrapper with the
+ * bindings. A private-use character, so that it cannot occur in the markup an author wrote. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export const COMPOSITION_SUBJECT_SLOT = '\uE000';
+/**
+ * Attribute the generated wrapper puts on the subject element, which is how the styleguide finds it in the rendered
+ * composition. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export const COMPOSITION_SUBJECT_ATTR = 'data-prism-subject';
+/**
+ * Attribute an author puts on the one of several elements matching the subject's selector that is the subject. It is
+ * removed from the generated template and from snippets. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export const SUBJECT_MARKER_ATTR = 'prism-subject';
+/**
+ * The input a composition wrapper declares to switch between its cases: the index of the variant, which the wrapper
+ * maps onto a case. Since 22.7.0.
+ *
+ * @experimental Experimental until 23.0.0: it may change in a 22.x minor release.
+ */
+export const PRISM_VARIANT_INPUT = '__prismVariant__';

package/dist/shared/pseudo-state.type.d.ts

@@ -14,7 +14,8 @@ export declare const PSEUDO_STATES: readonly PseudoState[];
  *
  * `true` puts it on every element of the rendered component, the host
  * included. A selector, or a list of them, limits it to the matching elements,
- * resolved against the host and everything inside it.
+ * resolved against what is rendered: the host and everything inside it, or the
+ * whole composition for a variant with a `template` or a host template.
  */
 export type PseudoTarget = true | string | readonly string[];
 /** The pseudo states a variant forces, each with the elements it applies to. */

package/dist/shared/pseudo-state.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pseudo-state.type.d.ts","sourceRoot":"","sources":["../../src/shared/pseudo-state.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,GAAG,cAAc,CAAC;AAE1F,uFAAuF;AACvF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA2E,CAAC;AAE5H;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC"}
+{"version":3,"file":"pseudo-state.type.d.ts","sourceRoot":"","sources":["../../src/shared/pseudo-state.type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,GAAG,cAAc,CAAC;AAE1F,uFAAuF;AACvF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA2E,CAAC;AAE5H;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC"}

package/dist/shared/void-elements.d.ts

@@ -0,0 +1,3 @@
+/** The HTML elements that take no content and no end tag: `<input>` and `<input />` are valid, `<input></input>` is not. */
+export declare const VOID_ELEMENTS: ReadonlySet<string>;
+//# sourceMappingURL=void-elements.d.ts.map

package/dist/shared/void-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"void-elements.d.ts","sourceRoot":"","sources":["../../src/shared/void-elements.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAAmH,CAAC"}

package/dist/shared/void-elements.js

@@ -0,0 +1,2 @@
+/** The HTML elements that take no content and no end tag: `<input>` and `<input />` are valid, `<input></input>` is not. */
+export const VOID_ELEMENTS = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'source', 'track', 'wbr']);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-prism/core",
-  "version": "22.5.0",
+  "version": "22.7.0-beta.0",
   "description": "ng-prism: the Angular-native Storybook alternative. Lightweight component showcase with @Showcase decorator, no story files needed.",
   "keywords": [
     "ng-prism",