@ng-prism/core 22.6.0 → 22.7.0-beta.1

package/dist/app/renderer/prism-renderer.component.js

@@ -1,5 +1,6 @@
 import { NgComponentOutlet } from '@angular/common';
 import { ChangeDetectionStrategy, Component, computed, DestroyRef, effect, ElementRef, inject, Injector, reflectComponentType, signal, untracked, viewChild, ViewContainerRef } from '@angular/core';
+import { PRISM_VARIANT_INPUT } from '../../shared/composition.js';
 import { VIEWPORT_MAX, VIEWPORT_MIN } from '../../shared/viewport.type.js';
 import { CANVAS_BG_STYLES } from '../canvas/canvas-bg.styles.js';
 import { PrismCanvasBgPillComponent } from '../canvas/prism-canvas-bg-pill.component.js';
@@ -20,7 +21,8 @@ import { PrismPseudoStateService } from '../services/prism-pseudo-state.service.
 import { PrismRendererService } from '../services/prism-renderer.service.js';
 import { PrismVariantBgService } from '../services/prism-variant-bg.service.js';
 import { PRISM_RENDERER_HOOKS } from '../tokens/prism-tokens.js';
-import { buildInputBindings } from './input-bindings.js';
+import { activeCase, renderSignature, renderTypeFor, sameRender } from './composition.js';
+import { buildInputBindings, unboundInputs } from './input-bindings.js';
 import { resolveOverlay } from './overlay-resolver.js';
 import { parseContentToNodes } from './projectable-content.js';
 import { resolveExcludedReason, resolveRenderedKey } from './rendered-key.js';
@@ -128,7 +130,8 @@ export class PrismRendererComponent {
     outlet = viewChild.required('outlet', { ...(ngDevMode ? { debugName: "outlet" } : /* istanbul ignore next */ {}), read: ViewContainerRef });
     componentRef = null;
     outputSubscriptions = [];
-    lastProjectedContent = undefined;
+    /** What the instance on the canvas renders, `null` without one: a variant switch to another render creates a new instance. */
+    lastRender = null;
     isRenderPage = false;
     overlayCache = new Map();
     activeOverlay = signal(null, /* @ts-ignore */
@@ -196,6 +199,7 @@ export class PrismRendererComponent {
         effect(() => {
             const inputs = this.rendererService.inputValues();
             const content = this.rendererService.activeContent();
+            const variantIndex = this.rendererService.activeVariantIndex();
             const ref = this.componentRef;
             if (!ref)
                 return;
@@ -206,20 +210,12 @@ export class PrismRendererComponent {
             const comp = untracked(() => this.navigationService.activeComponent());
             if (!comp)
                 return;
-            if (content !== this.lastProjectedContent) {
+            if (!sameRender(this.lastRender, renderSignature(comp, variantIndex, content))) {
                 untracked(() => this.createComponent(comp));
                 return;
             }
             performance.mark('prism:rerender:start');
-            const inputBindings = buildInputBindings(comp);
-            for (const [key, value] of Object.entries(inputs)) {
-                const binding = inputBindings.get(key);
-                if (binding === undefined) {
-                    console.warn(`[ng-prism] Unknown input "${key}" on <${comp.meta.componentMeta.selector}>, skipping. Remove it from @Showcase variants.`);
-                    continue;
-                }
-                ref.setInput(binding, value);
-            }
+            this.setInputs(ref, comp, variantIndex, inputs);
             ref.changeDetectorRef.detectChanges();
             performance.mark('prism:rerender:end');
             performance.measure('prism:rerender', 'prism:rerender:start', 'prism:rerender:end');
@@ -292,11 +288,15 @@ export class PrismRendererComponent {
             parent: this.injector
         });
         const content = this.rendererService.activeContent();
-        this.lastProjectedContent = content;
-        const projectableNodes = content
-            ? parseContentToNodes(content, reflectComponentType(comp.type)?.ngContentSelectors ?? [], (key) => console.warn(`[ng-prism] Variant content "${key}" matches no <ng-content> of ${comp.meta.className}, skipping it.`))
+        const variantIndex = this.rendererService.activeVariantIndex();
+        const composed = activeCase(comp, variantIndex) !== null;
+        const type = renderTypeFor(comp, variantIndex);
+        this.lastRender = renderSignature(comp, variantIndex, content);
+        // A composed variant has its content in the template of its case.
+        const projectableNodes = content && !composed
+            ? parseContentToNodes(content, reflectComponentType(type)?.ngContentSelectors ?? [], (key) => console.warn(`[ng-prism] Variant content "${key}" matches no <ng-content> of ${comp.meta.className}, skipping it.`))
             : undefined;
-        this.componentRef = this.outlet().createComponent(comp.type, {
+        this.componentRef = this.outlet().createComponent(type, {
             injector,
             projectableNodes
         });
@@ -307,21 +307,33 @@ export class PrismRendererComponent {
                 this.outputSubscriptions.push(sub);
             }
         }
-        const inputBindings = buildInputBindings(comp);
-        for (const [key, value] of Object.entries(this.rendererService.inputValues())) {
-            const binding = inputBindings.get(key);
-            if (binding === undefined) {
-                console.warn(`[ng-prism] Unknown input "${key}" on <${selector}>, skipping. Remove it from @Showcase variants.`);
-                continue;
-            }
-            this.componentRef.setInput(binding, value);
-        }
+        if (composed)
+            this.componentRef.setInput(PRISM_VARIANT_INPUT, variantIndex);
+        this.setInputs(this.componentRef, comp, variantIndex, this.rendererService.inputValues());
         this.componentRef.changeDetectorRef.detectChanges();
         performance.mark('prism:render:end', detail);
         performance.measure('prism:render', 'prism:render:start', 'prism:render:end');
         this.rendererService.renderedElement.set(this.componentRef.location.nativeElement);
         this.rendererHooks?.onAfterCreate?.(selector);
     }
+    /**
+     * Sets `values` on the instance by the bindings of the variant. A key that
+     * names no input gets a warning, an input the composition of the variant
+     * leaves unbound is skipped without one.
+     */
+    setInputs(ref, comp, variantIndex, values) {
+        const bindings = buildInputBindings(comp, variantIndex);
+        const unbound = unboundInputs(comp, variantIndex);
+        for (const [key, value] of Object.entries(values)) {
+            const binding = bindings.get(key);
+            if (binding !== undefined) {
+                ref.setInput(binding, value);
+            }
+            else if (!unbound.has(key)) {
+                console.warn(`[ng-prism] Unknown input "${key}" on <${comp.meta.componentMeta.selector}>, skipping. Remove it from @Showcase variants.`);
+            }
+        }
+    }
     cleanup() {
         const hadComponent = this.componentRef !== null;
         this.rendererService.renderedElement.set(null);
@@ -331,7 +343,7 @@ export class PrismRendererComponent {
         this.outputSubscriptions = [];
         this.outlet().clear();
         this.componentRef = null;
-        this.lastProjectedContent = undefined;
+        this.lastRender = null;
         if (hadComponent) {
             this.rendererHooks?.onAfterDestroy?.('');
         }
@@ -362,8 +374,8 @@ export class PrismRendererComponent {
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(PrismRendererComponent, [{
         type: Component,
-        args: [{ selector: 'prism-renderer', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, imports: [PrismCanvasRulersComponent, PrismCanvasBgPillComponent, PrismCanvasMeasureComponent, NgComponentOutlet, PrismResizerDirective], template: "<div\n    class=\"prism-canvas-stage\"\n    [attr.data-bg]=\"variantBg.effective()\"\n    [attr.data-rulers]=\"canvasService.rulers() ? '' : null\"\n    [attr.data-viewport]=\"viewportWidth() !== null ? '' : null\"\n    [style.--prism-vp-w.px]=\"viewportWidth()\"\n    [style.--zoom]=\"canvasService.zoom()\">\n    @if (!capture.active()) {\n        <div\n            class=\"stage-crosshair\"\n            [class.visible]=\"canvasService.guides()\"></div>\n        <prism-canvas-rulers />\n        @if (canvasService.measure()) {\n            <prism-canvas-measure />\n        }\n        <prism-canvas-bg-pill />\n        @if (viewportWidth() !== null) {\n            <!-- Grips and the dimension line are siblings of .demo-wrap, never\n       children of it: .demo-wrap is what plugin-visual-regression\n       screenshots, and anything inside it composites into every baseline.\n       They sit inside the capture guard for the same reason the rulers and\n       the pill do. -->\n            <span class=\"vp-dim\">\n                <span class=\"vp-dim__rule\"></span>\n                <span class=\"vp-dim__v\">{{ viewportWidth() }} px</span>\n                <span class=\"vp-dim__rule\"></span>\n            </span>\n            <div\n                class=\"vp-grip\"\n                prismResizer\n                axis=\"x\"\n                [scale]=\"-2 / (canvasService.zoom() || 1)\"\n                [min]=\"VIEWPORT_MIN\"\n                [max]=\"VIEWPORT_MAX\"\n                [value]=\"viewportWidth()!\"\n                (valueChange)=\"onViewportResize($event)\"\n                aria-label=\"Viewport width, left edge\"\n                [attr.aria-valuenow]=\"viewportWidth()\"\n                [attr.aria-valuemin]=\"VIEWPORT_MIN\"\n                [attr.aria-valuemax]=\"VIEWPORT_MAX\">\n                <span class=\"vp-grip__bar\"></span>\n            </div>\n            <div\n                class=\"vp-grip vp-grip--end\"\n                prismResizer\n                axis=\"x\"\n                [scale]=\"2 / (canvasService.zoom() || 1)\"\n                [min]=\"VIEWPORT_MIN\"\n                [max]=\"VIEWPORT_MAX\"\n                [value]=\"viewportWidth()!\"\n                (valueChange)=\"onViewportResize($event)\"\n                aria-label=\"Viewport width, right edge\"\n                [attr.aria-valuenow]=\"viewportWidth()\"\n                [attr.aria-valuemin]=\"VIEWPORT_MIN\"\n                [attr.aria-valuemax]=\"VIEWPORT_MAX\">\n                <span class=\"vp-grip__bar\"></span>\n            </div>\n        }\n    }\n\n    <div\n        class=\"demo-wrap\"\n        [style.--zoom]=\"canvasService.zoom()\"\n        [attr.data-prism-rendered]=\"renderedKey()\"\n        [attr.data-prism-excluded]=\"excludedReason()\"\n        [attr.data-canvas-layout]=\"canvasLayout()\"\n        [attr.data-viewport]=\"viewportWidth() !== null ? '' : null\"\n        [attr.data-pseudo]=\"forcedStates()\">\n        <ng-container #outlet />\n        @if (activeOverlay()) {\n            <ng-container *ngComponentOutlet=\"activeOverlay()!; inputs: overlayInputs; injector: overlayInjector()\" />\n        }\n    </div>\n</div>\n", styles: [":host {\n    display: block;\n    flex: 1;\n    min-height: 0;\n}\n\n.prism-canvas-stage {\n    position: relative;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n    min-height: 200px;\n    padding: 32px;\n    overflow: auto;\n\n    /* The edge is outline + shadow, never border and never extra padding.\n   plugin-visual-regression screenshots .demo-wrap, which is centred in\n   this element; a border would shrink the content box by 2px and move\n   that centre, shifting all 15 baselines in test-workspace/vrt/baseline\n   without a single component having changed. Capture mode resets this\n   element's padding but not its border, and this repo has no VRT runner\n   to catch the drift. outline and box-shadow do not participate in\n   layout, so the box is provably unchanged. Keep it that way.\n   They do still paint, and outline-offset is negative, so the line lands\n   inside the box: CAPTURE_STYLES in prism-capture.service.ts sets both\n   to none, which is only safe because neither affects layout here. */\n    outline: 1px solid var(--prism-stage-edge);\n    outline-offset: -1px;\n    background-color: var(--prism-stage);\n    box-shadow:\n        0 1px 3px rgb(0 0 0 / 10%),\n        0 8px 24px -12px rgb(0 0 0 / 18%);\n    transition: filter var(--dur-base);\n\n    --prism-canvas-overlay-top: 12px;\n    --prism-canvas-overlay-inline: 20px;\n}\n\n.prism-canvas-stage[data-rulers] {\n    --prism-canvas-overlay-top: 28px;\n    --prism-canvas-overlay-inline: 28px;\n}\n\n.stage-crosshair {\n    position: absolute;\n    inset: 0;\n    pointer-events: none;\n    opacity: 0;\n    transition: opacity var(--dur-base);\n}\n\n.stage-crosshair.visible {\n    opacity: 1;\n}\n\n.stage-crosshair::before,\n.stage-crosshair::after {\n    position: absolute;\n    content: '';\n    background: color-mix(in srgb, var(--prism-primary) 20%, transparent);\n}\n\n.stage-crosshair::before {\n    top: 50%;\n    right: 0;\n    left: 0;\n    height: 1px;\n}\n\n.stage-crosshair::after {\n    top: 0;\n    bottom: 0;\n    left: 50%;\n    width: 1px;\n}\n\n.demo-wrap {\n    position: relative;\n    display: inline-block;\n    transform: scale(var(--zoom, 1));\n    transition: transform 0.18s;\n}\n\n.demo-wrap[data-canvas-layout='stretch'] {\n    display: block;\n    width: 100%;\n    max-width: 800px;\n}\n\n/* max-width: none rather than min(800px, var(--prism-vp-w)): an explicitly\n   requested width beats a layout default, and min() would silently cap a\n   1024 viewport at 800 on any component declaring canvasLayout:\n   'stretch'.\n\n   container-type must stay confined to this rule. It implies contain: inline-size, which on the width:auto\n   inline-block .demo-wrap is at rest would decouple its width from its\n   contents, collapsing the box and shifting every baseline in\n   test-workspace/vrt/baseline without a component having changed. Here\n   the width is explicit, so containment costs nothing and is what makes\n   a component's own @container rules respond. Media queries do not and\n   cannot: they read the real browser viewport.\n\n   grid + justify-items: center, and not text-align: center, which is the\n   obvious way to centre an inline-level child and the wrong one. The\n   showcase component is created through ViewContainerRef, so its host\n   element carries none of this component's _ngcontent attribute and no\n   scoped rule here can reach it to undo an inherited value. text-align\n   would therefore leak all the way into the specimen and silently\n   re-align its own text the moment the viewport is switched on. That is a\n   canvas that lies about what it is showing. Centring at the container\n   instead touches nothing inside.\n\n   Shrinking is not a side effect of that choice, it is the resting\n   behaviour preserved: at rest .demo-wrap is an inline-block that\n   already shrink-wraps its child, so a block-level specimen sizes to its\n   content here the same as with the constraint off. The implicit\n   auto column still fills the declared width, so a component that asks\n   for width: 100% (the canvasLayout: 'stretch' case) keeps getting the\n   whole viewport. */\n.demo-wrap[data-viewport] {\n    display: grid;\n\n    /* flex: none is required. The stage is a flex container\n     and this is its only item, so the default flex-shrink: 1 lets the\n     box render narrower than the width just asked for whenever the\n     canvas is the smaller of the two, and container-type below drops\n     the automatic minimum size to zero, so nothing stops the shrink.\n     The result is the one failure this whole feature cannot afford:\n     the dimension line states 1024 while every @container rule in the\n     specimen answers whatever the canvas happened to allow. The stage\n     is overflow: auto, so refusing to shrink scrolls instead. */\n    flex: none;\n\n    /* safe center, not bare center. Centring is right while the specimen\n     fits and wrong the moment it does not: bare centring spills an\n     over-wide specimen equally past both edges, where a real viewport of\n     that width clips at zero and scrolls in one direction. The safe\n     keyword falls back to start only when the item overflows, which\n     is the browser making a case distinction CSS cannot otherwise\n     express. */\n    justify-items: safe center;\n    width: var(--prism-vp-w);\n    max-width: none;\n    container-type: inline-size;\n}\n\n/* Both grips derive their position arithmetically, because .demo-wrap is\n   centred by the stage's own flexbox and then scaled in place by\n   transform: scale(var(--zoom)): the transform preserves that centre, so\n   each edge sits half the *painted* width (--prism-vp-w times --zoom) away\n   from the middle. No measurement, no ResizeObserver, and nothing to\n   fall out of step when either the width or the zoom changes.\n\n   The grip's own [scale] input (in the template) undoes the same factor\n   in the other direction: a pointer that has moved dx across the painted\n   box must change --prism-vp-w by dx / zoom for the grip to stay under the\n   cursor, so the directive multiplier is 2 / zoom on the right grip and\n   -2 / zoom on the left, not the flat \u00B12 a permanent zoom of 1 would\n   need. */\n.vp-grip {\n    position: absolute;\n    top: var(--prism-canvas-overlay-top, 12px);\n    bottom: 0;\n    left: calc(50% - var(--prism-vp-w) * var(--zoom, 1) / 2 - 4.5px);\n    z-index: 4;\n    display: grid;\n    width: 9px;\n\n    /* The element is the guide line's full-height track and must not be\n     clickable. It runs from the overlay band to the\n     bottom of the stage at z-index 4, straight over prism-canvas-bg-pill\n     at z-index 2, so leaving it hit-testable made part of the pill's\n     Reset button unreachable whenever a viewport was on. Only the bar\n     below takes pointer events back. */\n    pointer-events: none;\n    background: transparent;\n}\n\n.vp-grip--end {\n    right: calc(50% - var(--prism-vp-w) * var(--zoom, 1) / 2 - 4.5px);\n    left: auto;\n}\n\n/* The part you grab, and the only part of the grip that takes pointer\n   events back. It shares the guide line's grid cell (hence the matching\n   grid-area) and is raised above it so the 1px rule does not paint a\n   seam down the middle of the 3px bar.\n\n   The padding is the hit box and the background is the bar: content-box\n   sizing plus background-clip: content-box paints 3x34 while leaving\n   9x44 clickable, so the target is comfortable without the mark growing\n   to match. It is still narrow for WCAG 2.5.8, which the Width chooser\n   in the tools menu answers: the same widths are reachable there, and\n   both grips take Home/End and the arrow keys. */\n.vp-grip__bar {\n    z-index: 1;\n    box-sizing: content-box;\n    grid-area: 1 / 1;\n    place-self: center center;\n    width: 3px;\n    height: 34px;\n    padding: 5px 3px;\n    pointer-events: auto;\n    background: color-mix(in srgb, var(--prism-measure) 80%, transparent);\n    background-clip: content-box;\n    border-radius: 2px;\n    transition: background var(--dur-fast);\n}\n\n/* The edge itself, carried the whole height of the stage. Without it a\n   grip is a floating nub that says where you may pull but not what it is\n   pulling: the line is what makes the constrained region legible as a\n   region rather than as two loose handles. Kept faint because it crosses\n   the specimen, so it has to stay readable as chrome. */\n.vp-grip::after {\n    grid-area: 1 / 1;\n    place-self: stretch center;\n    width: 1px;\n    content: '';\n    background: color-mix(in srgb, var(--prism-measure) 75%, transparent);\n    transition: background var(--dur-fast);\n}\n\n.vp-grip:hover::after,\n.vp-grip.active::after,\n.vp-grip:focus-visible::after {\n    background: color-mix(in srgb, var(--prism-measure) 55%, transparent);\n}\n\n.vp-grip:hover .vp-grip__bar,\n.vp-grip.active .vp-grip__bar,\n.vp-grip:focus-visible .vp-grip__bar {\n    background: var(--prism-measure);\n    background-clip: content-box;\n}\n\n/* The ring goes on the bar, not on the host: the host is the full-height\n   track, and outlining that would draw a rule the length of the stage\n   for a control 34px tall. */\n.vp-grip:focus-visible {\n    outline: none;\n}\n\n.vp-grip:focus-visible .vp-grip__bar {\n    outline: 2px solid var(--prism-primary);\n    outline-offset: 1px;\n}\n\n/* The third resident of the overlay band: pill left, dimension centre,\n   rail right. It reads the same --prism-canvas-overlay-top the other two\n   do, so switching rulers on moves all three together.\n\n   Spans the painted width rather than sitting in the middle of it as a\n   badge, and carries the same --prism-vp-w * --zoom the grips do so the\n   three stay locked together. A badge states a number; a dimension line\n   states which distance the number measures, and that is the whole\n   claim this overlay makes. */\n.vp-dim {\n    position: absolute;\n    top: var(--prism-canvas-overlay-top, 12px);\n    left: 50%;\n    z-index: 4;\n    display: flex;\n    gap: var(--sp-3);\n    align-items: center;\n    width: calc(var(--prism-vp-w) * var(--zoom, 1));\n    pointer-events: none;\n    transform: translateX(-50%);\n}\n\n/* Two halves with the value in the gap, rather than one rule behind it:\n   a line running under the digits would need a background plate to stay\n   readable, and the plate is the badge this replaced. */\n.vp-dim__rule {\n    position: relative;\n    flex: 1;\n    height: 1px;\n    background: color-mix(in srgb, var(--prism-measure) 70%, transparent);\n}\n\n/* The end ticks. They are what make the rule read as a measurement of\n   the span between them instead of as a divider laid across the canvas,\n   and they mark the two edges the grips can be dragged to. */\n.vp-dim__rule::before {\n    position: absolute;\n    top: -3px;\n    width: 1px;\n    height: 7px;\n    content: '';\n    background: color-mix(in srgb, var(--prism-measure) 90%, transparent);\n}\n\n.vp-dim__rule:first-child::before {\n    left: 0;\n}\n\n.vp-dim__rule:last-child::before {\n    right: 0;\n}\n\n.vp-dim__v {\n    flex: none;\n    font-family: var(--font-mono);\n    font-size: 9px;\n    color: var(--prism-measure);\n    white-space: nowrap;\n}\n", "\n  [data-bg=\"dots\"] {\n    background-image: radial-gradient(circle, var(--prism-dot) 1px, transparent 1px);\n    background-size: 20px 20px;\n  }\n\n  [data-bg=\"plain\"] {\n    background-image: none;\n  }\n\n  /* Flat, not dotted. \"light\" and \"dark\" name the surface a component was\n     designed against, and their colour is absolute rather than a theme token,\n     which makes them the values to declare for a screenshot baseline. Use\n     \"dots\" for the grid. */\n  /* These two also re-point --prism-measure. Other overlays use theme colours\n     on theme surfaces, but these grounds ignore the theme: \"light\" stays\n     near-white in the dark theme and \"dark\" stays near-black in the light one.\n     The dark theme's magenta reaches only 2.85:1 on the light ground, under the\n     4.5:1 its 9px readout needs, so the measurement colour has to follow the\n     ground, not the theme.\n\n     --prism-measure-plate follows it for the same reason. It is the surface\n     the measuring tool's value label paints itself on, so the label reads as a\n     gap in the measurement line rather than a badge on top of it. At its\n     --prism-stage fallback it would be the theme's stage under a re-pointed\n     foreground: the light theme's magenta on the dark theme's stage reads\n     3.71:1, the dark theme's on white 3.08:1. Pinned to the ground the same way,\n     the pairs reach 4.54:1 and 6.57:1. A color-mix against the ground would\n     work too, but this file already states both grounds literally, and one\n     mechanism per decision is enough.\n\n     Literal values because this file is theme-independent, like the two\n     grounds below. Keep them in step with --prism-measure in\n     prism-default-theme.ts; semantic-colours.spec.ts fails if they drift. */\n  [data-bg=\"light\"] {\n    background-color: var(--prism-void-light, #f7f5fc);\n    background-image: none;\n    --prism-measure: #ca00c1;\n    --prism-measure-plate: var(--prism-void-light, #f7f5fc);\n  }\n  [data-bg=\"dark\"] {\n    background-color: var(--prism-void-dark, #07050f);\n    background-image: none;\n    --prism-measure: #f632ff;\n    --prism-measure-plate: var(--prism-void-dark, #07050f);\n  }\n\n  /* \"transparent\" shares the checkerboard. In the app the checkerboard is\n     already the UI's sign for \"no surface\", and a see-through stage would only\n     show the shell behind it. Only CAPTURE_STYLES tells the two apart. */\n  [data-bg=\"checker\"],\n  [data-bg=\"transparent\"] {\n    background-image:\n      linear-gradient(45deg, var(--prism-border) 25%, transparent 25%),\n      linear-gradient(-45deg, var(--prism-border) 25%, transparent 25%),\n      linear-gradient(45deg, transparent 75%, var(--prism-border) 75%),\n      linear-gradient(-45deg, transparent 75%, var(--prism-border) 75%);\n    background-size: 16px 16px;\n    background-position: 0 0, 0 8px, 8px -8px, -8px 0;\n  }\n"] }]
+        args: [{ selector: 'prism-renderer', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, imports: [PrismCanvasRulersComponent, PrismCanvasBgPillComponent, PrismCanvasMeasureComponent, NgComponentOutlet, PrismResizerDirective], template: "<div\n    class=\"prism-canvas-stage\"\n    [attr.data-bg]=\"variantBg.effective()\"\n    [attr.data-rulers]=\"canvasService.rulers() ? '' : null\"\n    [attr.data-viewport]=\"viewportWidth() !== null ? '' : null\"\n    [style.--prism-vp-w.px]=\"viewportWidth()\"\n    [style.--zoom]=\"canvasService.zoom()\">\n    @if (!capture.active()) {\n        <div\n            class=\"stage-crosshair\"\n            [class.visible]=\"canvasService.guides()\"></div>\n        <prism-canvas-rulers />\n        @if (canvasService.measure()) {\n            <prism-canvas-measure />\n        }\n        <prism-canvas-bg-pill />\n        @if (viewportWidth() !== null) {\n            <!-- Grips and the dimension line are siblings of .demo-wrap, never\n       children of it: .demo-wrap is what plugin-visual-regression\n       screenshots, and anything inside it composites into every baseline.\n       They sit inside the capture guard for the same reason the rulers and\n       the pill do. -->\n            <span class=\"vp-dim\">\n                <span class=\"vp-dim__rule\"></span>\n                <span class=\"vp-dim__v\">{{ viewportWidth() }} px</span>\n                <span class=\"vp-dim__rule\"></span>\n            </span>\n            <div\n                class=\"vp-grip\"\n                prismResizer\n                axis=\"x\"\n                [scale]=\"-2 / (canvasService.zoom() || 1)\"\n                [min]=\"VIEWPORT_MIN\"\n                [max]=\"VIEWPORT_MAX\"\n                [value]=\"viewportWidth()!\"\n                (valueChange)=\"onViewportResize($event)\"\n                aria-label=\"Viewport width, left edge\"\n                [attr.aria-valuenow]=\"viewportWidth()\"\n                [attr.aria-valuemin]=\"VIEWPORT_MIN\"\n                [attr.aria-valuemax]=\"VIEWPORT_MAX\">\n                <span class=\"vp-grip__bar\"></span>\n            </div>\n            <div\n                class=\"vp-grip vp-grip--end\"\n                prismResizer\n                axis=\"x\"\n                [scale]=\"2 / (canvasService.zoom() || 1)\"\n                [min]=\"VIEWPORT_MIN\"\n                [max]=\"VIEWPORT_MAX\"\n                [value]=\"viewportWidth()!\"\n                (valueChange)=\"onViewportResize($event)\"\n                aria-label=\"Viewport width, right edge\"\n                [attr.aria-valuenow]=\"viewportWidth()\"\n                [attr.aria-valuemin]=\"VIEWPORT_MIN\"\n                [attr.aria-valuemax]=\"VIEWPORT_MAX\">\n                <span class=\"vp-grip__bar\"></span>\n            </div>\n        }\n    }\n\n    <div\n        class=\"demo-wrap\"\n        [style.--zoom]=\"canvasService.zoom()\"\n        [attr.data-prism-rendered]=\"renderedKey()\"\n        [attr.data-prism-excluded]=\"excludedReason()\"\n        [attr.data-canvas-layout]=\"canvasLayout()\"\n        [attr.data-viewport]=\"viewportWidth() !== null ? '' : null\"\n        [attr.data-pseudo]=\"forcedStates()\">\n        <ng-container #outlet />\n        @if (activeOverlay()) {\n            <ng-container *ngComponentOutlet=\"activeOverlay()!; inputs: overlayInputs; injector: overlayInjector()\" />\n        }\n    </div>\n</div>\n", styles: [":host {\n    display: block;\n    flex: 1;\n    min-height: 0;\n}\n\n.prism-canvas-stage {\n    position: relative;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n    min-height: 200px;\n    padding: 32px;\n    overflow: auto;\n\n    /* The edge is outline + shadow, never border and never extra padding.\n   plugin-visual-regression screenshots .demo-wrap, which is centred in\n   this element; a border would shrink the content box by 2px and move\n   that centre, shifting all 15 baselines in test-workspace/vrt/baseline\n   without a single component having changed. Capture mode resets this\n   element's padding but not its border, and this repo has no VRT runner\n   to catch the drift. outline and box-shadow do not participate in\n   layout, so the box is provably unchanged. Keep it that way.\n   They do still paint, and outline-offset is negative, so the line lands\n   inside the box: CAPTURE_STYLES in prism-capture.service.ts sets both\n   to none, which is only safe because neither affects layout here. */\n    outline: 1px solid var(--prism-stage-edge);\n    outline-offset: -1px;\n    background-color: var(--prism-stage);\n    box-shadow:\n        0 1px 3px rgb(0 0 0 / 10%),\n        0 8px 24px -12px rgb(0 0 0 / 18%);\n    transition: filter var(--dur-base);\n\n    --prism-canvas-overlay-top: 12px;\n    --prism-canvas-overlay-inline: 20px;\n}\n\n.prism-canvas-stage[data-rulers] {\n    --prism-canvas-overlay-top: 28px;\n    --prism-canvas-overlay-inline: 28px;\n}\n\n.stage-crosshair {\n    position: absolute;\n    inset: 0;\n    pointer-events: none;\n    opacity: 0;\n    transition: opacity var(--dur-base);\n}\n\n.stage-crosshair.visible {\n    opacity: 1;\n}\n\n.stage-crosshair::before,\n.stage-crosshair::after {\n    position: absolute;\n    content: '';\n    background: color-mix(in srgb, var(--prism-primary) 20%, transparent);\n}\n\n.stage-crosshair::before {\n    top: 50%;\n    right: 0;\n    left: 0;\n    height: 1px;\n}\n\n.stage-crosshair::after {\n    top: 0;\n    bottom: 0;\n    left: 50%;\n    width: 1px;\n}\n\n.demo-wrap {\n    position: relative;\n    display: inline-block;\n    transform: scale(var(--zoom, 1));\n    transition: transform 0.18s;\n}\n\n.demo-wrap[data-canvas-layout='stretch'] {\n    display: block;\n    width: 100%;\n    max-width: 800px;\n}\n\n/* max-width: none rather than min(800px, var(--prism-vp-w)): an explicitly\n   requested width beats a layout default, and min() would silently cap a\n   1024 viewport at 800 on any component declaring canvasLayout:\n   'stretch'.\n\n   container-type must stay confined to this rule. It implies contain: inline-size, which on the width:auto\n   inline-block .demo-wrap is at rest would decouple its width from its\n   contents, collapsing the box and shifting every baseline in\n   test-workspace/vrt/baseline without a component having changed. Here\n   the width is explicit, so containment costs nothing and is what makes\n   a component's own @container rules respond. Media queries do not and\n   cannot: they read the real browser viewport.\n\n   grid + justify-items: center, and not text-align: center, which is the\n   obvious way to centre an inline-level child and the wrong one. The\n   showcase component is created through ViewContainerRef, so its host\n   element carries none of this component's _ngcontent attribute and no\n   scoped rule here can reach it to undo an inherited value. text-align\n   would therefore leak all the way into the specimen and silently\n   re-align its own text the moment the viewport is switched on. That is a\n   canvas that lies about what it is showing. Centring at the container\n   instead touches nothing inside.\n\n   Shrinking is not a side effect of that choice, it is the resting\n   behaviour preserved: at rest .demo-wrap is an inline-block that\n   already shrink-wraps its child, so a block-level specimen sizes to its\n   content here the same as with the constraint off. The implicit\n   auto column still fills the declared width, so a component that asks\n   for width: 100% (the canvasLayout: 'stretch' case) keeps getting the\n   whole viewport. */\n.demo-wrap[data-viewport] {\n    display: grid;\n\n    /* flex: none is required. The stage is a flex container\n     and this is its only item, so the default flex-shrink: 1 lets the\n     box render narrower than the width just asked for whenever the\n     canvas is the smaller of the two, and container-type below drops\n     the automatic minimum size to zero, so nothing stops the shrink.\n     The result is the one failure this whole feature cannot afford:\n     the dimension line states 1024 while every @container rule in the\n     specimen answers whatever the canvas happened to allow. The stage\n     is overflow: auto, so refusing to shrink scrolls instead. */\n    flex: none;\n\n    /* safe center, not bare center. Centring is right while the specimen\n     fits and wrong the moment it does not: bare centring spills an\n     over-wide specimen equally past both edges, where a real viewport of\n     that width clips at zero and scrolls in one direction. The safe\n     keyword falls back to start only when the item overflows, which\n     is the browser making a case distinction CSS cannot otherwise\n     express. */\n    justify-items: safe center;\n    width: var(--prism-vp-w);\n    max-width: none;\n    container-type: inline-size;\n}\n\n/* Both grips derive their position arithmetically, because .demo-wrap is\n   centred by the stage's own flexbox and then scaled in place by\n   transform: scale(var(--zoom)): the transform preserves that centre, so\n   each edge sits half the *painted* width (--prism-vp-w times --zoom) away\n   from the middle. No measurement, no ResizeObserver, and nothing to\n   fall out of step when either the width or the zoom changes.\n\n   The grip's own [scale] input (in the template) undoes the same factor\n   in the other direction: a pointer that has moved dx across the painted\n   box must change --prism-vp-w by dx / zoom for the grip to stay under the\n   cursor, so the directive multiplier is 2 / zoom on the right grip and\n   -2 / zoom on the left, not the flat \u00B12 a permanent zoom of 1 would\n   need. */\n.vp-grip {\n    position: absolute;\n    top: var(--prism-canvas-overlay-top, 12px);\n    bottom: 0;\n    left: calc(50% - var(--prism-vp-w) * var(--zoom, 1) / 2 - 4.5px);\n    z-index: 4;\n    display: grid;\n    width: 9px;\n\n    /* The element is the guide line's full-height track and must not be\n     clickable. It runs from the overlay band to the\n     bottom of the stage at z-index 4, straight over prism-canvas-bg-pill\n     at z-index 2, so leaving it hit-testable made part of the pill's\n     Reset button unreachable whenever a viewport was on. Only the bar\n     below takes pointer events back. */\n    pointer-events: none;\n    background: transparent;\n}\n\n.vp-grip--end {\n    right: calc(50% - var(--prism-vp-w) * var(--zoom, 1) / 2 - 4.5px);\n    left: auto;\n}\n\n/* The part you grab, and the only part of the grip that takes pointer\n   events back. It shares the guide line's grid cell (hence the matching\n   grid-area) and is raised above it so the 1px rule does not paint a\n   seam down the middle of the 3px bar.\n\n   The padding is the hit box and the background is the bar: content-box\n   sizing plus background-clip: content-box paints 3x34 while leaving\n   9x44 clickable, so the target is comfortable without the mark growing\n   to match. It is still narrow for WCAG 2.5.8, which the Width chooser\n   in the tools menu answers: the same widths are reachable there, and\n   both grips take Home/End and the arrow keys. */\n.vp-grip__bar {\n    z-index: 1;\n    box-sizing: content-box;\n    grid-area: 1 / 1;\n    place-self: center center;\n    width: 3px;\n    height: 34px;\n    padding: 5px 3px;\n    pointer-events: auto;\n    background: color-mix(in srgb, var(--prism-measure) 80%, transparent);\n    background-clip: content-box;\n    border-radius: 2px;\n    transition: background var(--dur-fast);\n}\n\n/* The edge itself, carried the whole height of the stage. Without it a\n   grip is a floating nub that says where you may pull but not what it is\n   pulling: the line is what makes the constrained region legible as a\n   region rather than as two loose handles. Kept faint because it crosses\n   the specimen, so it has to stay readable as chrome. */\n.vp-grip::after {\n    grid-area: 1 / 1;\n    place-self: stretch center;\n    width: 1px;\n    content: '';\n    background: color-mix(in srgb, var(--prism-measure) 75%, transparent);\n    transition: background var(--dur-fast);\n}\n\n.vp-grip:hover::after,\n.vp-grip.active::after,\n.vp-grip:focus-visible::after {\n    background: color-mix(in srgb, var(--prism-measure) 55%, transparent);\n}\n\n.vp-grip:hover .vp-grip__bar,\n.vp-grip.active .vp-grip__bar,\n.vp-grip:focus-visible .vp-grip__bar {\n    background: var(--prism-measure);\n    background-clip: content-box;\n}\n\n/* The ring goes on the bar, not on the host: the host is the full-height\n   track, and outlining that would draw a rule the length of the stage\n   for a control 34px tall. */\n.vp-grip:focus-visible {\n    outline: none;\n}\n\n.vp-grip:focus-visible .vp-grip__bar {\n    outline: 2px solid var(--prism-primary);\n    outline-offset: 1px;\n}\n\n/* The third resident of the overlay band: pill left, dimension centre,\n   rail right. It reads the same --prism-canvas-overlay-top the other two\n   do, so switching rulers on moves all three together.\n\n   Spans the painted width rather than sitting in the middle of it as a\n   badge, and carries the same --prism-vp-w * --zoom the grips do so the\n   three stay locked together. A badge states a number; a dimension line\n   states which distance the number measures, and that is the whole\n   claim this overlay makes. */\n.vp-dim {\n    position: absolute;\n    top: var(--prism-canvas-overlay-top, 12px);\n    left: 50%;\n    z-index: 4;\n    display: flex;\n    gap: var(--sp-3);\n    align-items: center;\n    width: calc(var(--prism-vp-w) * var(--zoom, 1));\n    pointer-events: none;\n    transform: translateX(-50%);\n}\n\n/* Two halves with the value in the gap, rather than one rule behind it:\n   a line running under the digits would need a background plate to stay\n   readable, and the plate is the badge this replaced. */\n.vp-dim__rule {\n    position: relative;\n    flex: 1;\n    height: 1px;\n    background: color-mix(in srgb, var(--prism-measure) 70%, transparent);\n}\n\n/* The end ticks. They are what make the rule read as a measurement of\n   the span between them instead of as a divider laid across the canvas,\n   and they mark the two edges the grips can be dragged to. */\n.vp-dim__rule::before {\n    position: absolute;\n    top: -3px;\n    width: 1px;\n    height: 7px;\n    content: '';\n    background: color-mix(in srgb, var(--prism-measure) 90%, transparent);\n}\n\n.vp-dim__rule:first-child::before {\n    left: 0;\n}\n\n.vp-dim__rule:last-child::before {\n    right: 0;\n}\n\n.vp-dim__v {\n    flex: none;\n    font-family: var(--font-mono);\n    font-size: 9px;\n    color: var(--prism-measure);\n    white-space: nowrap;\n}\n", "\n  [data-bg=\"dots\"] {\n    background-image: radial-gradient(circle, var(--prism-dot) 1px, transparent 1px);\n    background-size: 20px 20px;\n  }\n\n  [data-bg=\"plain\"] {\n    background-image: none;\n  }\n\n  /* Flat, not dotted. \"light\" and \"dark\" name the surface a component was\n     designed against, and their colour is absolute rather than a theme token,\n     which makes them the values to declare for a screenshot baseline. Use\n     \"dots\" for the grid. */\n  /* These two also re-point --prism-measure. Other overlays use theme colours\n     on theme surfaces, but these grounds ignore the theme: \"light\" stays\n     near-white in the dark theme and \"dark\" stays near-black in the light one.\n     The dark theme's magenta reaches only 2.85:1 on the light ground, under the\n     4.5:1 its 9px readout needs, so the measurement colour has to follow the\n     ground, not the theme.\n\n     --prism-measure-plate follows it for the same reason. It is the surface\n     the measuring tool's value label paints itself on, so the label reads as a\n     gap in the measurement line rather than a badge on top of it. At its\n     --prism-stage fallback it would be the theme's stage under a re-pointed\n     foreground: the light theme's magenta on the dark theme's stage reads\n     3.71:1, the dark theme's on white 3.08:1. Pinned to the ground the same way,\n     the pairs reach 4.54:1 and 6.57:1. A color-mix against the ground would\n     work too, but this file already states both grounds literally, and one\n     mechanism per decision is enough.\n\n     Literal values because this file is theme-independent, like the two\n     grounds below. Keep them in step with --prism-measure in canvas-overlay-tokens.ts and\n     prism-default-theme.ts; semantic-colours.spec.ts fails if they drift. */\n  [data-bg=\"light\"] {\n    background-color: var(--prism-void-light, #f7f5fc);\n    background-image: none;\n    --prism-measure: #ca00c1;\n    --prism-measure-plate: var(--prism-void-light, #f7f5fc);\n  }\n  [data-bg=\"dark\"] {\n    background-color: var(--prism-void-dark, #07050f);\n    background-image: none;\n    --prism-measure: #f632ff;\n    --prism-measure-plate: var(--prism-void-dark, #07050f);\n  }\n\n  /* \"transparent\" shares the checkerboard. In the app the checkerboard is\n     already the UI's sign for \"no surface\", and a see-through stage would only\n     show the shell behind it. Only CAPTURE_STYLES tells the two apart. */\n  [data-bg=\"checker\"],\n  [data-bg=\"transparent\"] {\n    background-image:\n      linear-gradient(45deg, var(--prism-border) 25%, transparent 25%),\n      linear-gradient(-45deg, var(--prism-border) 25%, transparent 25%),\n      linear-gradient(45deg, transparent 75%, var(--prism-border) 75%),\n      linear-gradient(-45deg, transparent 75%, var(--prism-border) 75%);\n    background-size: 16px 16px;\n    background-position: 0 0, 0 8px, 8px -8px, -8px 0;\n  }\n"] }]
     }], () => [], { outlet: [{ type: i0.ViewChild, args: ['outlet', { ...{
                         read: ViewContainerRef
                     }, isSignal: true }] }] }); })();
-(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(PrismRendererComponent, { className: "PrismRendererComponent", filePath: "app/renderer/prism-renderer.component.ts", lineNumber: 55 }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(PrismRendererComponent, { className: "PrismRendererComponent", filePath: "app/renderer/prism-renderer.component.ts", lineNumber: 57 }); })();

package/dist/app/renderer/snippet-generator.d.ts

@@ -1,7 +1,19 @@
-import type { DirectiveHost } from '../../decorator/showcase.types.js';
+import type { DirectiveHost, HostTemplate } from '../../decorator/showcase.types.js';
 import type { InputMeta } from '../../plugin/plugin.types.js';
 export interface SnippetDirectiveOptions {
-    host?: string | DirectiveHost;
+    host?: string | DirectiveHost | HostTemplate;
 }
+/**
+ * The attributes that put the current values on the subject element. A value that equals its default is left out unless
+ * the variant sets it (`explicitKeys`); `skip` holds the member names of inputs that are not written at all, such as
+ * the ones a composition does not bind.
+ */
+export declare function subjectAttributes(inputs: InputMeta[], values: Record<string, unknown>, explicitKeys?: ReadonlySet<string>, skip?: ReadonlySet<string>): string[];
+/**
+ * The composition of a case as its author wrote it, with `attributes` on the subject element in place of the slot
+ * ng-prism leaves in `CompositionCase.template`. Only a bare attribute of the subject that one of them gives a value
+ * (`libTooltip`, which the selector asks for) is left out, as `attributes` writes it again.
+ */
+export declare function generateCompositionSnippet(caseTemplate: string, attributes: string[]): string;
 export declare function generateSnippet(selector: string, inputs: InputMeta[], values: Record<string, unknown>, explicitKeys?: ReadonlySet<string>, content?: string | Record<string, string>, directiveOptions?: SnippetDirectiveOptions): string;
 //# sourceMappingURL=snippet-generator.d.ts.map

package/dist/app/renderer/snippet-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snippet-generator.d.ts","sourceRoot":"","sources":["../../../src/app/renderer/snippet-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CACjC;AAoBD,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,gBAAgB,CAAC,EAAE,uBAAuB,GAC3C,MAAM,CA4DR"}
+{"version":3,"file":"snippet-generator.d.ts","sourceRoot":"","sources":["../../../src/app/renderer/snippet-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAQ9D,MAAM,WAAW,uBAAuB;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,YAAY,CAAC;CAChD;AAoBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CA0BhK;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAO7F;AAaD,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,gBAAgB,CAAC,EAAE,uBAAuB,GAC3C,MAAM,CAcR"}

package/dist/app/renderer/snippet-generator.js

@@ -1,3 +1,8 @@
+import { COMPOSITION_SUBJECT_SLOT } from '../../shared/composition.js';
+import { VOID_ELEMENTS } from '../../shared/void-elements.js';
+import { PRISM_CONTENT_INPUT } from './input-bindings.js';
+/** The value a directive's host renders its text content through: the snippet writes it as content, never as an attribute. */
+const HOST_CONTENT_KEYS = new Set([PRISM_CONTENT_INPUT]);
 function escapeAttrValue(value) {
     return String(value).replace(/&/g, '&').replace(/"/g, '"');
 }
@@ -18,14 +23,18 @@ function pushAttribute(attributes, name, value) {
         attributes.push(`[${name}]="${escapeAttrValue(value)}"`);
     }
 }
-export function generateSnippet(selector, inputs, values, explicitKeys, content, directiveOptions) {
-    if (directiveOptions?.host) {
-        return generateDirectiveSnippet(selector, inputs, values, explicitKeys, content, directiveOptions.host);
-    }
+/**
+ * The attributes that put the current values on the subject element. A value that equals its default is left out unless
+ * the variant sets it (`explicitKeys`); `skip` holds the member names of inputs that are not written at all, such as
+ * the ones a composition does not bind.
+ */
+export function subjectAttributes(inputs, values, explicitKeys, skip) {
     const attributes = [];
-    const processed = new Set();
+    const processed = new Set(skip);
     for (const input of inputs) {
         processed.add(input.name);
+        if (skip?.has(input.name))
+            continue;
         const value = values[input.name];
         if (value === undefined)
             continue;
@@ -46,48 +55,137 @@ export function generateSnippet(selector, inputs, values, explicitKeys, content,
             continue;
         pushAttribute(attributes, name, value);
     }
-    const contentHtml = resolveContentHtml(content);
-    if (!contentHtml) {
-        if (attributes.length === 0) {
-            return `<${selector} />`;
+    return attributes;
+}
+/**
+ * The composition of a case as its author wrote it, with `attributes` on the subject element in place of the slot
+ * ng-prism leaves in `CompositionCase.template`. Only a bare attribute of the subject that one of them gives a value
+ * (`libTooltip`, which the selector asks for) is left out, as `attributes` writes it again.
+ */
+export function generateCompositionSnippet(caseTemplate, attributes) {
+    const written = attributes.length > 0 ? ` ${attributes.join(' ')}` : '';
+    const names = attributes.map((attribute) => attribute.split('=')[0].replace(/^\[(.*)\]$/, '$1'));
+    const parts = caseTemplate.split(COMPOSITION_SUBJECT_SLOT);
+    // The slot ends the subject's start tag, so each part but the last ends with one.
+    return parts.map((part, index) => (index < parts.length - 1 ? withoutBareAttributes(part, names) : part)).join(written);
+}
+/** `text` without the bare attributes `names` in the start tag it ends with. */
+function withoutBareAttributes(text, names) {
+    const start = text.lastIndexOf('<');
+    if (start < 0)
+        return text;
+    const startTag = names.reduce((tag, name) => tag.replace(new RegExp(`\\s+${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?=\\s|$)`), ''), text.slice(start));
+    return text.slice(0, start) + startTag;
+}
+export function generateSnippet(selector, inputs, values, explicitKeys, content, directiveOptions) {
+    const host = directiveOptions?.host;
+    // A `{ template }` host is not shown yet: the snippet is the directive's selector, as without a host.
+    if (host && !(typeof host === 'object' && 'template' in host)) {
+        return generateDirectiveSnippet(selector, inputs, values, explicitKeys, content, host);
+    }
+    // A directive without a host renders on the element of its selector, with its text content in `__prismContent__`.
+    const attributes = subjectAttributes(inputs, values, explicitKeys, HOST_CONTENT_KEYS);
+    const element = selectorToElement(selector);
+    const selectorAttributes = unwrittenSelectorAttributes(element.attributes, attributes);
+    return renderElement(element.tag, [...selectorAttributes, ...attributes], resolveContentHtml(content ?? hostContentValue(values)));
+}
+function hostContentValue(values) {
+    const value = values[PRISM_CONTENT_INPUT];
+    return typeof value === 'string' ? value : undefined;
+}
+/** The parts of a selector list. `:not()` is ignored. */
+function selectorParts(selector) {
+    return selector
+        .replace(/:not\([^)]*\)/g, '')
+        .split(',')
+        .map((part) => {
+        const text = part.trim();
+        const tag = text.match(/^[a-zA-Z][\w-]*/)?.[0];
+        const attributes = [];
+        const classNames = [];
+        for (const [, name, value, className] of text.slice(tag?.length ?? 0).matchAll(/\[([^\]=]+)(?:=["']?([^\]"']*)["']?)?\]|\.([\w-]+)/g)) {
+            if (className) {
+                classNames.push(className);
+            }
+            else {
+                attributes.push(value ? `${name}="${escapeAttrValue(value)}"` : name);
+            }
         }
-        const singleLine = `<${selector} ${attributes.join(' ')} />`;
-        if (singleLine.length <= 80) {
+        if (classNames.length > 0)
+            attributes.push(`class="${classNames.join(' ')}"`);
+        return { tag, attributes };
+    });
+}
+/**
+ * The element and the attributes a component's selector asks for: `button[libBtn]` is `<button libBtn>`. Of a selector
+ * list only the first part counts, and a selector without an element is a `div`, as when the styleguide renders it.
+ */
+function selectorToElement(selector) {
+    const [first] = selectorParts(selector);
+    return { tag: first.tag ?? 'div', attributes: first.attributes };
+}
+/**
+ * The attributes of a directive's selector that put it on a host element `tag`: those of the first part of a selector
+ * list that names `tag` or no element, as the generated wrapper takes them. When no part fits, the first part's.
+ */
+function selectorAttributesOnHost(selector, tag) {
+    const parts = selectorParts(selector);
+    const fitting = parts.find((part) => (part.tag ?? tag).toLowerCase() === tag.toLowerCase()) ?? parts[0];
+    return fitting.attributes;
+}
+/** The attributes of a selector that no written attribute sets yet: an input aliased to one of them gives it its value. */
+function unwrittenSelectorAttributes(selectorAttributes, written) {
+    return selectorAttributes.filter((attribute) => {
+        const name = attribute.split('=')[0];
+        return !written.some((w) => w.startsWith(`${name}=`) || w.startsWith(`[${name}]=`));
+    });
+}
+/**
+ * One element, on a single line when it fits in 80 characters. A void element takes no content and no end tag
+ * (`<input>` and `<input />` are valid, `<input>text</input>` is not). Only void and custom elements may close
+ * themselves: Angular rejects `<button />`, so any other element without content gets its end tag.
+ */
+function renderElement(tag, attributes, contentHtml) {
+    const attrStr = attributes.length > 0 ? ` ${attributes.join(' ')}` : '';
+    const indented = attributes.map((attr) => `  ${attr}`).join('\n');
+    const content = VOID_ELEMENTS.has(tag.toLowerCase()) ? undefined : contentHtml;
+    if (!content) {
+        const selfClosing = VOID_ELEMENTS.has(tag.toLowerCase()) || tag.includes('-');
+        const end = selfClosing ? ' />' : `></${tag}>`;
+        const singleLine = `<${tag}${attrStr}${end}`;
+        if (attributes.length === 0 || singleLine.length <= 80)
             return singleLine;
-        }
-        const indented = attributes.map((attr) => `  ${attr}`).join('\n');
-        return `<${selector}\n${indented} />`;
+        return `<${tag}\n${indented}${end}`;
     }
-    const attrStr = attributes.length > 0 ? ' ' + attributes.join(' ') : '';
-    const openTag = `<${selector}${attrStr}>`;
-    const closeTag = `</${selector}>`;
-    const singleLine = `${openTag}${contentHtml}${closeTag}`;
-    if (singleLine.length <= 80) {
+    const openTag = `<${tag}${attrStr}>`;
+    const closeTag = `</${tag}>`;
+    const singleLine = `${openTag}${content}${closeTag}`;
+    if (singleLine.length <= 80)
         return singleLine;
-    }
-    if (attributes.length <= 2) {
-        return `${openTag}\n  ${contentHtml}\n${closeTag}`;
-    }
-    const indented = attributes.map((attr) => `  ${attr}`).join('\n');
-    return `<${selector}\n${indented}>\n  ${contentHtml}\n${closeTag}`;
-}
-function directiveSelectorToAttr(selector) {
-    const match = selector.match(/^\[([^\]]+)]$/);
-    return match ? match[1] : selector;
+    if (attributes.length <= 2)
+        return `${openTag}\n  ${content}\n${closeTag}`;
+    return `<${tag}\n${indented}>\n  ${content}\n${closeTag}`;
 }
+/**
+ * The element a string host starts with, its attributes as written, and the content between its start and end tag
+ * (`<button class="btn">Hover me</button>`): that content is what the host renders when a variant sets none.
+ */
 function parseHostStringSimple(host) {
-    const match = host.trim().match(/^<\s*([a-zA-Z][a-zA-Z0-9-]*)((?:\s+[^>]*?)?)\s*\/?\s*>$/);
-    if (!match)
+    const start = host.match(/^\s*<\s*([a-zA-Z][\w-]*)([^>]*?)\s*\/?\s*>/);
+    if (!start)
         return { tag: 'div', attrs: '' };
-    return { tag: match[1], attrs: match[2].trim() };
+    const [opening, tag, attrs] = start;
+    const content = host.slice(opening.length).match(new RegExp(`^([\\s\\S]*?)<\\/\\s*${tag}\\s*>\\s*$`, 'i'))?.[1];
+    return { tag, attrs: attrs.trim(), content };
 }
 function generateDirectiveSnippet(selector, inputs, values, explicitKeys, content, host) {
-    const directiveAttr = directiveSelectorToAttr(selector);
     let tag;
+    let hostContent;
     const hostAttrs = [];
     if (typeof host === 'string') {
         const parsed = parseHostStringSimple(host);
         tag = parsed.tag;
+        hostContent = parsed.content;
         if (parsed.attrs)
             hostAttrs.push(parsed.attrs);
     }
@@ -99,55 +197,12 @@ function generateDirectiveSnippet(selector, inputs, values, explicitKeys, conten
             }
         }
     }
-    const attributes = [];
-    const processed = new Set(['__prismContent__']);
-    for (const input of inputs) {
-        processed.add(input.name);
-        const value = values[input.name];
-        if (value === undefined)
-            continue;
-        if (input.defaultValue !== undefined && value === input.defaultValue && !explicitKeys?.has(input.name))
-            continue;
-        // Only a guess, and only sound when no default is known: a boolean input
-        // that defaults to `true` has to show its explicit `false`.
-        if (input.defaultValue === undefined && typeof value === 'boolean' && !value)
-            continue;
-        pushAttribute(attributes, input.alias ?? input.name, value);
-    }
-    for (const [name, value] of Object.entries(values)) {
-        if (processed.has(name))
-            continue;
-        if (value === undefined)
-            continue;
-        if (typeof value === 'boolean' && !value)
-            continue;
-        pushAttribute(attributes, name, value);
-    }
-    const projectedContent = content ?? (typeof values['__prismContent__'] === 'string' ? values['__prismContent__'] : undefined);
-    // An input aliased to the directive's own selector already puts the directive on the host.
-    const selectorAttrs = attributes.some((a) => a.startsWith(`${directiveAttr}=`) || a.startsWith(`[${directiveAttr}]=`)) ? [] : [directiveAttr];
-    const allAttrs = [...hostAttrs, ...selectorAttrs, ...attributes].join(' ');
-    const contentHtml = resolveContentHtml(projectedContent);
-    if (!contentHtml) {
-        if (!allAttrs)
-            return `<${tag} />`;
-        const singleLine = `<${tag} ${allAttrs} />`;
-        if (singleLine.length <= 80)
-            return singleLine;
-        const indented = [...hostAttrs, ...selectorAttrs, ...attributes].map((a) => `  ${a}`).join('\n');
-        return `<${tag}\n${indented} />`;
-    }
-    const openTag = `<${tag} ${allAttrs}>`;
-    const closeTag = `</${tag}>`;
-    const singleLine = `${openTag}${contentHtml}${closeTag}`;
-    if (singleLine.length <= 80)
-        return singleLine;
-    const allAttrsList = [...hostAttrs, ...selectorAttrs, ...attributes];
-    if (allAttrsList.length <= 2) {
-        return `${openTag}\n  ${contentHtml}\n${closeTag}`;
-    }
-    const indented = allAttrsList.map((a) => `  ${a}`).join('\n');
-    return `<${tag}\n${indented}>\n  ${contentHtml}\n${closeTag}`;
+    const attributes = subjectAttributes(inputs, values, explicitKeys, HOST_CONTENT_KEYS);
+    // The variant's content, else the content of the host: the generated host's `__prismContent__` defaults to it.
+    const projectedContent = content ?? hostContentValue(values) ?? hostContent;
+    // An input aliased to an attribute of the directive's selector already puts the directive on the host.
+    const selectorAttrs = unwrittenSelectorAttributes(selectorAttributesOnHost(selector, tag), attributes);
+    return renderElement(tag, [...hostAttrs, ...selectorAttrs, ...attributes], resolveContentHtml(projectedContent));
 }
 function resolveContentHtml(content) {
     if (!content)

package/dist/app/services/navigation-item.d.ts

@@ -0,0 +1,10 @@
+import type { ShowcaseConfig } from '../../decorator/showcase.types.js';
+import type { NavigationItem } from './navigation-item.types.js';
+/** The `@Showcase` config behind a component, a service or a pipe, `undefined` for a page, which has none. */
+export declare function itemShowcaseConfig(item: NavigationItem): ShowcaseConfig | undefined;
+/**
+ * Identifies an item in a list. The prefixes keep a service, a pipe and a page
+ * from colliding with a component of the same name or title.
+ */
+export declare function itemKey(item: NavigationItem): string;
+//# sourceMappingURL=navigation-item.d.ts.map

package/dist/app/services/navigation-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-item.d.ts","sourceRoot":"","sources":["../../../src/app/services/navigation-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,8GAA8G;AAC9G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAEnF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAWpD"}

package/dist/app/services/navigation-item.js

@@ -0,0 +1,20 @@
+/** The `@Showcase` config behind a component, a service or a pipe, `undefined` for a page, which has none. */
+export function itemShowcaseConfig(item) {
+    return item.kind === 'page' ? undefined : item.data.meta.showcaseConfig;
+}
+/**
+ * Identifies an item in a list. The prefixes keep a service, a pipe and a page
+ * from colliding with a component of the same name or title.
+ */
+export function itemKey(item) {
+    switch (item.kind) {
+        case 'component':
+            return item.data.meta.className;
+        case 'service':
+            return `service:${item.data.meta.className}`;
+        case 'pipe':
+            return `pipe:${item.data.meta.className}`;
+        case 'page':
+            return `page:${item.data.title}`;
+    }
+}

package/dist/app/services/navigation-item.types.d.ts

@@ -1,8 +1,16 @@
 import type { StyleguidePage } from '../../plugin/page.types.js';
+import type { RuntimePipe } from '../../plugin/pipe.types.js';
 import type { RuntimeComponent } from '../../plugin/plugin.types.js';
+import type { RuntimeService } from '../../plugin/service.types.js';
 export type NavigationItem = {
     kind: 'component';
     data: RuntimeComponent;
+} | {
+    kind: 'service';
+    data: RuntimeService;
+} | {
+    kind: 'pipe';
+    data: RuntimePipe;
 } | {
     kind: 'page';
     data: StyleguidePage;

package/dist/app/services/navigation-item.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-item.types.d.ts","sourceRoot":"","sources":["../../../src/app/services/navigation-item.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC"}
+{"version":3,"file":"navigation-item.types.d.ts","sourceRoot":"","sources":["../../../src/app/services/navigation-item.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC"}

package/dist/app/services/prism-layout.service.d.ts

@@ -1,4 +1,16 @@
 import * as i0 from "@angular/core";
+/** Bounds and default of the sidebar width, shared by the service, the resizer and the shell's CSS fallback. */
+export declare const SIDEBAR_WIDTH: {
+    readonly min: 200;
+    readonly max: 360;
+    readonly default: 280;
+};
+/** Bounds and default of the addon panel height. */
+export declare const PANEL_HEIGHT: {
+    readonly min: 200;
+    readonly max: 560;
+    readonly default: 300;
+};
 export declare class PrismLayoutService {
     readonly sidebarVisible: import("@angular/core").WritableSignal<boolean>;
     readonly addonsVisible: import("@angular/core").WritableSignal<boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"prism-layout.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-layout.service.ts"],"names":[],"mappings":";AAIA,qBACa,kBAAkB;IAC3B,QAAQ,CAAC,cAAc,kDAAgB;IACvC,QAAQ,CAAC,aAAa,kDAAgB;IACtC,QAAQ,CAAC,cAAc,kDAAgB;IACvC,QAAQ,CAAC,iBAAiB,6DAAwC;IAClE,QAAQ,CAAC,YAAY,iDAAe;IACpC,QAAQ,CAAC,WAAW,iDAAe;IACnC,QAAQ,CAAC,UAAU,iDAAe;;IAMlC,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAKpB,aAAa,IAAI,IAAI;IAKrB,iBAAiB,IAAI,IAAI;IAKzB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKjC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKhC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK/B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,aAAa;yCArEZ,kBAAkB;;CAkF9B"}
+{"version":3,"file":"prism-layout.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-layout.service.ts"],"names":[],"mappings":";AAIA,gHAAgH;AAChH,eAAO,MAAM,aAAa;;;;CAAgD,CAAC;AAE3E,oDAAoD;AACpD,eAAO,MAAM,YAAY;;;;CAAgD,CAAC;AAI1E,qBACa,kBAAkB;IAC3B,QAAQ,CAAC,cAAc,kDAAgB;IACvC,QAAQ,CAAC,aAAa,kDAAgB;IACtC,QAAQ,CAAC,cAAc,kDAAgB;IACvC,QAAQ,CAAC,iBAAiB,6DAAwC;IAClE,QAAQ,CAAC,YAAY,iDAAyC;IAC9D,QAAQ,CAAC,WAAW,iDAAwC;IAC5D,QAAQ,CAAC,UAAU,iDAAe;;IAMlC,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAKpB,aAAa,IAAI,IAAI;IAKrB,iBAAiB,IAAI,IAAI;IAKzB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKjC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKhC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK/B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,aAAa;yCArEZ,kBAAkB;;CAsF9B"}