@ng-prism/core 22.3.0 → 22.4.1

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

@@ -3,6 +3,7 @@ import { ChangeDetectionStrategy, Component, computed, DestroyRef, effect, Eleme
 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';
+import { PrismCanvasMeasureComponent } from '../canvas/prism-canvas-measure.component.js';
 import { PrismCanvasRulersComponent } from '../canvas/prism-canvas-rulers.component.js';
 import { snapViewportWidth } from '../canvas/viewport-snap.js';
 import { PrismResizerDirective } from '../directives/prism-resizer.directive.js';
@@ -22,7 +23,10 @@ import { resolveOverlay } from './overlay-resolver.js';
 import { parseContentToNodes } from './projectable-content.js';
 import * as i0 from "@angular/core";
 const _c0 = ["outlet"];
-function PrismRendererComponent_Conditional_1_Conditional_3_Template(rf, ctx) { if (rf & 1) {
+function PrismRendererComponent_Conditional_1_Conditional_2_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelement(0, "prism-canvas-measure");
+} }
+function PrismRendererComponent_Conditional_1_Conditional_4_Template(rf, ctx) { if (rf & 1) {
     const _r1 = i0.ɵɵgetCurrentView();
     i0.ɵɵelementStart(0, "span", 4);
     i0.ɵɵelement(1, "span", 5);
@@ -32,11 +36,11 @@ function PrismRendererComponent_Conditional_1_Conditional_3_Template(rf, ctx) {
     i0.ɵɵelement(4, "span", 5);
     i0.ɵɵelementEnd();
     i0.ɵɵelementStart(5, "div", 7);
-    i0.ɵɵlistener("valueChange", function PrismRendererComponent_Conditional_1_Conditional_3_Template_div_valueChange_5_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r1.onViewportResize($event)); });
+    i0.ɵɵlistener("valueChange", function PrismRendererComponent_Conditional_1_Conditional_4_Template_div_valueChange_5_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r1.onViewportResize($event)); });
     i0.ɵɵelement(6, "span", 8);
     i0.ɵɵelementEnd();
     i0.ɵɵelementStart(7, "div", 9);
-    i0.ɵɵlistener("valueChange", function PrismRendererComponent_Conditional_1_Conditional_3_Template_div_valueChange_7_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r1.onViewportResize($event)); });
+    i0.ɵɵlistener("valueChange", function PrismRendererComponent_Conditional_1_Conditional_4_Template_div_valueChange_7_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r1.onViewportResize($event)); });
     i0.ɵɵelement(8, "span", 8);
     i0.ɵɵelementEnd();
 } if (rf & 2) {
@@ -51,13 +55,17 @@ function PrismRendererComponent_Conditional_1_Conditional_3_Template(rf, ctx) {
     i0.ɵɵattribute("aria-valuenow", ctx_r1.viewportWidth())("aria-valuemin", ctx_r1.VIEWPORT_MIN)("aria-valuemax", ctx_r1.VIEWPORT_MAX);
 } }
 function PrismRendererComponent_Conditional_1_Template(rf, ctx) { if (rf & 1) {
-    i0.ɵɵelement(0, "div", 3)(1, "prism-canvas-rulers")(2, "prism-canvas-bg-pill");
-    i0.ɵɵconditionalCreate(3, PrismRendererComponent_Conditional_1_Conditional_3_Template, 9, 15);
+    i0.ɵɵelement(0, "div", 3)(1, "prism-canvas-rulers");
+    i0.ɵɵconditionalCreate(2, PrismRendererComponent_Conditional_1_Conditional_2_Template, 1, 0, "prism-canvas-measure");
+    i0.ɵɵelement(3, "prism-canvas-bg-pill");
+    i0.ɵɵconditionalCreate(4, PrismRendererComponent_Conditional_1_Conditional_4_Template, 9, 15);
 } if (rf & 2) {
     const ctx_r1 = i0.ɵɵnextContext();
     i0.ɵɵclassProp("visible", ctx_r1.canvasService.guides());
-    i0.ɵɵadvance(3);
-    i0.ɵɵconditional(ctx_r1.viewportWidth() !== null ? 3 : -1);
+    i0.ɵɵadvance(2);
+    i0.ɵɵconditional(ctx_r1.canvasService.measure() ? 2 : -1);
+    i0.ɵɵadvance(2);
+    i0.ɵɵconditional(ctx_r1.viewportWidth() !== null ? 4 : -1);
 } }
 function PrismRendererComponent_Conditional_5_ng_container_0_Template(rf, ctx) { if (rf & 1) {
     i0.ɵɵelementContainer(0);
@@ -80,7 +88,7 @@ export class PrismRendererComponent {
      * Every viewport binding reads this rather than the service directly, so
      * capture mode cannot be constrained by any route. Previously only the grips
      * and the dimension line sat behind the capture guard while the attributes
-     * that change `.demo-wrap`'s box did not — safe in practice, because capture
+     * that change `.demo-wrap`'s box did not. Safe in practice, because capture
      * never restores a persisted width and every setter is suppressed, but safe
      * by reachability argument rather than by construction. A future caller of
      * `setViewportWidth` during a capture run would have recorded every
@@ -94,7 +102,7 @@ export class PrismRendererComponent {
     /**
      * A drag on either grip, rested on a preset if it came close enough.
      *
-     * The snapping lives here and not in `PrismResizerDirective` on purpose: the
+     * The snapping lives here and not in `PrismResizerDirective` because the
      * directive also drives the sidebar and the panel, where there is nothing to
      * snap to, and a generic control that knows about viewport presets would be
      * the wrong shape.
@@ -131,7 +139,7 @@ export class PrismRendererComponent {
         return `${comp.meta.className}:${this.rendererService.activeVariantIndex()}`;
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "renderedKey" }] : /* istanbul ignore next */ []));
-    /** Resolved canvas layout for the active variant — variant overrides component config; defaults to 'fit'. */
+    /** Resolved canvas layout for the active variant. Variant overrides component config; defaults to 'fit'. */
     canvasLayout = computed(() => {
         const comp = this.navigationService.activeComponent();
         if (!comp)
@@ -178,7 +186,7 @@ export class PrismRendererComponent {
             const knownInputs = buildKnownInputs(comp);
             for (const [key, value] of Object.entries(inputs)) {
                 if (!knownInputs.has(key)) {
-                    console.warn(`[ng-prism] Unknown input "${key}" on <${comp.meta.componentMeta.selector}> — skipping. Remove it from @Showcase variants.`);
+                    console.warn(`[ng-prism] Unknown input "${key}" on <${comp.meta.componentMeta.selector}>, skipping. Remove it from @Showcase variants.`);
                     continue;
                 }
                 ref.setInput(key, value);
@@ -192,6 +200,7 @@ export class PrismRendererComponent {
             const allPanels = [...BUILTIN_PANELS, ...this.pluginService.panels()];
             const resolution = resolveOverlay(allPanels, panelId, {
                 captureActive: this.capture.active(),
+                measureActive: this.canvasService.measure(),
                 cache: this.overlayCache
             });
             if (resolution.kind === 'eager') {
@@ -256,7 +265,7 @@ export class PrismRendererComponent {
         const knownInputs = buildKnownInputs(comp);
         for (const [key, value] of Object.entries(this.rendererService.inputValues())) {
             if (!knownInputs.has(key)) {
-                console.warn(`[ng-prism] Unknown input "${key}" on <${selector}> — skipping. Remove it from @Showcase variants.`);
+                console.warn(`[ng-prism] Unknown input "${key}" on <${selector}>, skipping. Remove it from @Showcase variants.`);
                 continue;
             }
             this.componentRef.setInput(key, value);
@@ -288,7 +297,7 @@ export class PrismRendererComponent {
             i0.ɵɵqueryAdvance();
         } }, decls: 6, vars: 14, consts: [["outlet", ""], [1, "prism-canvas-stage"], [1, "demo-wrap"], [1, "stage-crosshair"], [1, "vp-dim"], [1, "vp-dim__rule"], [1, "vp-dim__v"], ["prismResizer", "", "axis", "x", "aria-label", "Viewport width, left edge", 1, "vp-grip", 3, "valueChange", "scale", "min", "max", "value"], [1, "vp-grip__bar"], ["prismResizer", "", "axis", "x", "aria-label", "Viewport width, right edge", 1, "vp-grip", "vp-grip--end", 3, "valueChange", "scale", "min", "max", "value"], [4, "ngComponentOutlet", "ngComponentOutletInputs", "ngComponentOutletInjector"]], template: function PrismRendererComponent_Template(rf, ctx) { if (rf & 1) {
             i0.ɵɵelementStart(0, "div", 1);
-            i0.ɵɵconditionalCreate(1, PrismRendererComponent_Conditional_1_Template, 4, 3);
+            i0.ɵɵconditionalCreate(1, PrismRendererComponent_Conditional_1_Template, 5, 4);
             i0.ɵɵelementStart(2, "div", 2);
             i0.ɵɵelementContainer(3, null, 0);
             i0.ɵɵconditionalCreate(5, PrismRendererComponent_Conditional_5_Template, 1, 3, "ng-container");
@@ -303,12 +312,12 @@ export class PrismRendererComponent {
             i0.ɵɵattribute("data-prism-rendered", ctx.renderedKey())("data-canvas-layout", ctx.canvasLayout())("data-viewport", ctx.viewportWidth() !== null ? "" : null);
             i0.ɵɵadvance(3);
             i0.ɵɵconditional(ctx.activeOverlay() ? 5 : -1);
-        } }, dependencies: [PrismCanvasRulersComponent, PrismCanvasBgPillComponent, NgComponentOutlet, PrismResizerDirective], styles: ["[_nghost-%COMP%] {\n    display: block;\n    flex: 1;\n    min-height: 0;\n}\n\n.prism-canvas-stage[_ngcontent-%COMP%] {\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    \n\n\n\n\n\n\n\n\n\n\n    outline: 1px solid var(--%NS%prism-stage-edge);\n    outline-offset: -1px;\n    background-color: var(--%NS%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(--%NS%dur-base);\n\n    --%NS%prism-canvas-overlay-top: 12px;\n    --%NS%prism-canvas-overlay-inline: 20px;\n}\n\n.prism-canvas-stage[data-rulers][_ngcontent-%COMP%] {\n    --%NS%prism-canvas-overlay-top: 28px;\n    --%NS%prism-canvas-overlay-inline: 28px;\n}\n\n.stage-crosshair[_ngcontent-%COMP%] {\n    position: absolute;\n    inset: 0;\n    pointer-events: none;\n    opacity: 0;\n    transition: opacity var(--%NS%dur-base);\n}\n\n.stage-crosshair.visible[_ngcontent-%COMP%] {\n    opacity: 1;\n}\n\n.stage-crosshair[_ngcontent-%COMP%]::before, \n.stage-crosshair[_ngcontent-%COMP%]::after {\n    position: absolute;\n    content: '';\n    background: color-mix(in srgb, var(--%NS%prism-primary) 20%, transparent);\n}\n\n.stage-crosshair[_ngcontent-%COMP%]::before {\n    top: 50%;\n    right: 0;\n    left: 0;\n    height: 1px;\n}\n\n.stage-crosshair[_ngcontent-%COMP%]::after {\n    top: 0;\n    bottom: 0;\n    left: 50%;\n    width: 1px;\n}\n\n.demo-wrap[_ngcontent-%COMP%] {\n    position: relative;\n    display: inline-block;\n    transform: scale(var(--%NS%zoom, 1));\n    transition: transform 0.18s;\n}\n\n.demo-wrap[data-canvas-layout='stretch'][_ngcontent-%COMP%] {\n    display: block;\n    width: 100%;\n    max-width: 800px;\n}\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n.demo-wrap[data-viewport][_ngcontent-%COMP%] {\n    display: grid;\n\n    \n\n\n\n\n\n\n\n\n    flex: none;\n\n    \n\n\n\n\n\n\n    justify-items: safe center;\n    width: var(--%NS%prism-vp-w);\n    max-width: none;\n    container-type: inline-size;\n}\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n.vp-grip[_ngcontent-%COMP%] {\n    position: absolute;\n    top: var(--%NS%prism-canvas-overlay-top, 12px);\n    bottom: 0;\n    left: calc(50% - var(--%NS%prism-vp-w) * var(--%NS%zoom, 1) / 2 - 4.5px);\n    z-index: 4;\n    display: grid;\n    width: 9px;\n\n    \n\n\n\n\n\n    pointer-events: none;\n    background: transparent;\n}\n\n.vp-grip--end[_ngcontent-%COMP%] {\n    right: calc(50% - var(--%NS%prism-vp-w) * var(--%NS%zoom, 1) / 2 - 4.5px);\n    left: auto;\n}\n\n\n\n\n\n\n\n\n\n\n\n\n.vp-grip__bar[_ngcontent-%COMP%] {\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(--%NS%prism-measure) 80%, transparent);\n    background-clip: content-box;\n    border-radius: 2px;\n    transition: background var(--%NS%dur-fast);\n}\n\n\n\n\n\n\n.vp-grip[_ngcontent-%COMP%]::after {\n    grid-area: 1 / 1;\n    place-self: stretch center;\n    width: 1px;\n    content: '';\n    background: color-mix(in srgb, var(--%NS%prism-measure) 75%, transparent);\n    transition: background var(--%NS%dur-fast);\n}\n\n.vp-grip[_ngcontent-%COMP%]:hover::after, \n.vp-grip.active[_ngcontent-%COMP%]::after, \n.vp-grip[_ngcontent-%COMP%]:focus-visible::after {\n    background: color-mix(in srgb, var(--%NS%prism-measure) 55%, transparent);\n}\n\n.vp-grip[_ngcontent-%COMP%]:hover   .vp-grip__bar[_ngcontent-%COMP%], \n.vp-grip.active[_ngcontent-%COMP%]   .vp-grip__bar[_ngcontent-%COMP%], \n.vp-grip[_ngcontent-%COMP%]:focus-visible   .vp-grip__bar[_ngcontent-%COMP%] {\n    background: var(--%NS%prism-measure);\n    background-clip: content-box;\n}\n\n\n\n\n.vp-grip[_ngcontent-%COMP%]:focus-visible {\n    outline: none;\n}\n\n.vp-grip[_ngcontent-%COMP%]:focus-visible   .vp-grip__bar[_ngcontent-%COMP%] {\n    outline: 2px solid var(--%NS%prism-primary);\n    outline-offset: 1px;\n}\n\n\n\n\n\n\n\n\n\n\n.vp-dim[_ngcontent-%COMP%] {\n    position: absolute;\n    top: var(--%NS%prism-canvas-overlay-top, 12px);\n    left: 50%;\n    z-index: 4;\n    display: flex;\n    gap: var(--%NS%sp-3);\n    align-items: center;\n    width: calc(var(--%NS%prism-vp-w) * var(--%NS%zoom, 1));\n    pointer-events: none;\n    transform: translateX(-50%);\n}\n\n\n\n\n.vp-dim__rule[_ngcontent-%COMP%] {\n    position: relative;\n    flex: 1;\n    height: 1px;\n    background: color-mix(in srgb, var(--%NS%prism-measure) 70%, transparent);\n}\n\n\n\n\n.vp-dim__rule[_ngcontent-%COMP%]::before {\n    position: absolute;\n    top: -3px;\n    width: 1px;\n    height: 7px;\n    content: '';\n    background: color-mix(in srgb, var(--%NS%prism-measure) 90%, transparent);\n}\n\n.vp-dim__rule[_ngcontent-%COMP%]:first-child::before {\n    left: 0;\n}\n\n.vp-dim__rule[_ngcontent-%COMP%]:last-child::before {\n    right: 0;\n}\n\n.vp-dim__v[_ngcontent-%COMP%] {\n    flex: none;\n    font-family: var(--%NS%font-mono);\n    font-size: 9px;\n    color: var(--%NS%prism-measure);\n    white-space: nowrap;\n}", "[data-bg=\"dots\"][_ngcontent-%COMP%] {\n    background-image: radial-gradient(circle, var(--%NS%prism-dot) 1px, transparent 1px);\n    background-size: 20px 20px;\n  }\n\n  [data-bg=\"plain\"][_ngcontent-%COMP%] {\n    background-image: none;\n  }\n\n  \n\n\n\n\n  \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n  [data-bg=\"light\"][_ngcontent-%COMP%] {\n    background-color: var(--%NS%prism-void-light, #f7f5fc);\n    background-image: none;\n    --%NS%prism-measure: #004d8a;\n  }\n  [data-bg=\"dark\"][_ngcontent-%COMP%] {\n    background-color: var(--%NS%prism-void-dark, #07050f);\n    background-image: none;\n    --%NS%prism-measure: #41bcff;\n  }\n\n  \n\n\n\n\n\n  [data-bg=\"checker\"][_ngcontent-%COMP%], \n   [data-bg=\"transparent\"][_ngcontent-%COMP%] {\n    background-image:\n      linear-gradient(45deg, var(--%NS%prism-border) 25%, transparent 25%),\n      linear-gradient(-45deg, var(--%NS%prism-border) 25%, transparent 25%),\n      linear-gradient(45deg, transparent 75%, var(--%NS%prism-border) 75%),\n      linear-gradient(-45deg, transparent 75%, var(--%NS%prism-border) 75%);\n    background-size: 16px 16px;\n    background-position: 0 0, 0 8px, 8px -8px, -8px 0;\n  }"] });
+        } }, dependencies: [PrismCanvasRulersComponent, PrismCanvasBgPillComponent, PrismCanvasMeasureComponent, NgComponentOutlet, PrismResizerDirective], styles: ["[_nghost-%COMP%] {\n    display: block;\n    flex: 1;\n    min-height: 0;\n}\n\n.prism-canvas-stage[_ngcontent-%COMP%] {\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    \n\n\n\n\n\n\n\n\n\n\n    outline: 1px solid var(--%NS%prism-stage-edge);\n    outline-offset: -1px;\n    background-color: var(--%NS%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(--%NS%dur-base);\n\n    --%NS%prism-canvas-overlay-top: 12px;\n    --%NS%prism-canvas-overlay-inline: 20px;\n}\n\n.prism-canvas-stage[data-rulers][_ngcontent-%COMP%] {\n    --%NS%prism-canvas-overlay-top: 28px;\n    --%NS%prism-canvas-overlay-inline: 28px;\n}\n\n.stage-crosshair[_ngcontent-%COMP%] {\n    position: absolute;\n    inset: 0;\n    pointer-events: none;\n    opacity: 0;\n    transition: opacity var(--%NS%dur-base);\n}\n\n.stage-crosshair.visible[_ngcontent-%COMP%] {\n    opacity: 1;\n}\n\n.stage-crosshair[_ngcontent-%COMP%]::before, \n.stage-crosshair[_ngcontent-%COMP%]::after {\n    position: absolute;\n    content: '';\n    background: color-mix(in srgb, var(--%NS%prism-primary) 20%, transparent);\n}\n\n.stage-crosshair[_ngcontent-%COMP%]::before {\n    top: 50%;\n    right: 0;\n    left: 0;\n    height: 1px;\n}\n\n.stage-crosshair[_ngcontent-%COMP%]::after {\n    top: 0;\n    bottom: 0;\n    left: 50%;\n    width: 1px;\n}\n\n.demo-wrap[_ngcontent-%COMP%] {\n    position: relative;\n    display: inline-block;\n    transform: scale(var(--%NS%zoom, 1));\n    transition: transform 0.18s;\n}\n\n.demo-wrap[data-canvas-layout='stretch'][_ngcontent-%COMP%] {\n    display: block;\n    width: 100%;\n    max-width: 800px;\n}\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n.demo-wrap[data-viewport][_ngcontent-%COMP%] {\n    display: grid;\n\n    \n\n\n\n\n\n\n\n\n    flex: none;\n\n    \n\n\n\n\n\n\n    justify-items: safe center;\n    width: var(--%NS%prism-vp-w);\n    max-width: none;\n    container-type: inline-size;\n}\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n.vp-grip[_ngcontent-%COMP%] {\n    position: absolute;\n    top: var(--%NS%prism-canvas-overlay-top, 12px);\n    bottom: 0;\n    left: calc(50% - var(--%NS%prism-vp-w) * var(--%NS%zoom, 1) / 2 - 4.5px);\n    z-index: 4;\n    display: grid;\n    width: 9px;\n\n    \n\n\n\n\n\n    pointer-events: none;\n    background: transparent;\n}\n\n.vp-grip--end[_ngcontent-%COMP%] {\n    right: calc(50% - var(--%NS%prism-vp-w) * var(--%NS%zoom, 1) / 2 - 4.5px);\n    left: auto;\n}\n\n\n\n\n\n\n\n\n\n\n\n\n.vp-grip__bar[_ngcontent-%COMP%] {\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(--%NS%prism-measure) 80%, transparent);\n    background-clip: content-box;\n    border-radius: 2px;\n    transition: background var(--%NS%dur-fast);\n}\n\n\n\n\n\n\n.vp-grip[_ngcontent-%COMP%]::after {\n    grid-area: 1 / 1;\n    place-self: stretch center;\n    width: 1px;\n    content: '';\n    background: color-mix(in srgb, var(--%NS%prism-measure) 75%, transparent);\n    transition: background var(--%NS%dur-fast);\n}\n\n.vp-grip[_ngcontent-%COMP%]:hover::after, \n.vp-grip.active[_ngcontent-%COMP%]::after, \n.vp-grip[_ngcontent-%COMP%]:focus-visible::after {\n    background: color-mix(in srgb, var(--%NS%prism-measure) 55%, transparent);\n}\n\n.vp-grip[_ngcontent-%COMP%]:hover   .vp-grip__bar[_ngcontent-%COMP%], \n.vp-grip.active[_ngcontent-%COMP%]   .vp-grip__bar[_ngcontent-%COMP%], \n.vp-grip[_ngcontent-%COMP%]:focus-visible   .vp-grip__bar[_ngcontent-%COMP%] {\n    background: var(--%NS%prism-measure);\n    background-clip: content-box;\n}\n\n\n\n\n.vp-grip[_ngcontent-%COMP%]:focus-visible {\n    outline: none;\n}\n\n.vp-grip[_ngcontent-%COMP%]:focus-visible   .vp-grip__bar[_ngcontent-%COMP%] {\n    outline: 2px solid var(--%NS%prism-primary);\n    outline-offset: 1px;\n}\n\n\n\n\n\n\n\n\n\n\n.vp-dim[_ngcontent-%COMP%] {\n    position: absolute;\n    top: var(--%NS%prism-canvas-overlay-top, 12px);\n    left: 50%;\n    z-index: 4;\n    display: flex;\n    gap: var(--%NS%sp-3);\n    align-items: center;\n    width: calc(var(--%NS%prism-vp-w) * var(--%NS%zoom, 1));\n    pointer-events: none;\n    transform: translateX(-50%);\n}\n\n\n\n\n.vp-dim__rule[_ngcontent-%COMP%] {\n    position: relative;\n    flex: 1;\n    height: 1px;\n    background: color-mix(in srgb, var(--%NS%prism-measure) 70%, transparent);\n}\n\n\n\n\n.vp-dim__rule[_ngcontent-%COMP%]::before {\n    position: absolute;\n    top: -3px;\n    width: 1px;\n    height: 7px;\n    content: '';\n    background: color-mix(in srgb, var(--%NS%prism-measure) 90%, transparent);\n}\n\n.vp-dim__rule[_ngcontent-%COMP%]:first-child::before {\n    left: 0;\n}\n\n.vp-dim__rule[_ngcontent-%COMP%]:last-child::before {\n    right: 0;\n}\n\n.vp-dim__v[_ngcontent-%COMP%] {\n    flex: none;\n    font-family: var(--%NS%font-mono);\n    font-size: 9px;\n    color: var(--%NS%prism-measure);\n    white-space: nowrap;\n}", "[data-bg=\"dots\"][_ngcontent-%COMP%] {\n    background-image: radial-gradient(circle, var(--%NS%prism-dot) 1px, transparent 1px);\n    background-size: 20px 20px;\n  }\n\n  [data-bg=\"plain\"][_ngcontent-%COMP%] {\n    background-image: none;\n  }\n\n  \n\n\n\n  \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n  [data-bg=\"light\"][_ngcontent-%COMP%] {\n    background-color: var(--%NS%prism-void-light, #f7f5fc);\n    background-image: none;\n    --%NS%prism-measure: #ca00c1;\n    --%NS%prism-measure-plate: var(--%NS%prism-void-light, #f7f5fc);\n  }\n  [data-bg=\"dark\"][_ngcontent-%COMP%] {\n    background-color: var(--%NS%prism-void-dark, #07050f);\n    background-image: none;\n    --%NS%prism-measure: #f632ff;\n    --%NS%prism-measure-plate: var(--%NS%prism-void-dark, #07050f);\n  }\n\n  \n\n\n  [data-bg=\"checker\"][_ngcontent-%COMP%], \n   [data-bg=\"transparent\"][_ngcontent-%COMP%] {\n    background-image:\n      linear-gradient(45deg, var(--%NS%prism-border) 25%, transparent 25%),\n      linear-gradient(-45deg, var(--%NS%prism-border) 25%, transparent 25%),\n      linear-gradient(45deg, transparent 75%, var(--%NS%prism-border) 75%),\n      linear-gradient(-45deg, transparent 75%, var(--%NS%prism-border) 75%);\n    background-size: 16px 16px;\n    background-position: 0 0, 0 8px, 8px -8px, -8px 0;\n  }"] });
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(PrismRendererComponent, [{
         type: Component,
-        args: [{ selector: 'prism-renderer', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, imports: [PrismCanvasRulersComponent, PrismCanvasBgPillComponent, 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        <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-canvas-layout]=\"canvasLayout()\"\n        [attr.data-viewport]=\"viewportWidth() !== null ? '' : null\">\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 is load-bearing 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 is confined to this rule, and that confinement is\n   load-bearing. 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 \u2014 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 \u2014 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 exactly as it does with the constraint off. The implicit\n   auto column still fills the declared width, so a component that asks\n   for width: 100% \u2014 the canvasLayout: 'stretch' case \u2014 keeps getting the\n   whole viewport. */\n.demo-wrap[data-viewport] {\n    display: grid;\n\n    /* flex: none, and it is load-bearing. 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 \u2014 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 exactly 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 \u2014 --prism-vp-w times --zoom \u2014 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 nothing else\n     may be clickable about it. 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 \u2014 hence the matching\n   grid-area \u2014 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 \u2014 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. Faint on purpose \u2014 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 a surface a component was\n     designed against \u2014 and they are the two backgrounds whose colour is\n     absolute rather than a theme token, which is what makes them the values\n     to declare for a screenshot baseline. \"dots\" already exists for anyone\n     who wants the grid. */\n  /* These two also re-point --prism-measure, and that is not decoration.\n     Every other canvas overlay is drawn in a theme colour over a theme\n     surface, so the two move together. These two backgrounds are absolute:\n     \"light\" stays near-white while the app runs the dark theme, and \"dark\"\n     stays near-black while it runs the light one. The measurement colour\n     picked for one theme is then sitting on the other theme's ground \u2014\n     measured, the dark theme's blue reaches 1.8:1 on the light background,\n     which is a viewport overlay you cannot see. Pinning the colour to the\n     ground rather than to the theme is what makes \"always visible\" true\n     instead of true-in-the-common-case.\n\n     Literal values because this file is theme-independent by construction \u2014\n     it is the one place that already hard-codes the two absolute grounds\n     below, for the same reason. 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: #004d8a;\n  }\n  [data-bg=\"dark\"] {\n    background-color: var(--prism-void-dark, #07050f);\n    background-image: none;\n    --prism-measure: #41bcff;\n  }\n\n  /* \"transparent\" shares the checkerboard on purpose. The two say the same\n     thing in the two media the canvas has: while browsing, the checkerboard\n     is already the UI's word for \"no surface here\"; in a capture it becomes\n     literal transparency. A stage that were really see-through in the app\n     would just show the shell through the canvas, which means nothing. The\n     split between the two lives entirely in CAPTURE_STYLES. */\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-canvas-layout]=\"canvasLayout()\"\n        [attr.data-viewport]=\"viewportWidth() !== null ? '' : null\">\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"] }]
     }], () => [], { 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: 50 }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(PrismRendererComponent, { className: "PrismRendererComponent", filePath: "app/renderer/prism-renderer.component.ts", lineNumber: 51 }); })();

package/dist/app/renderer/projectable-content.js

@@ -20,12 +20,12 @@ export function parseContentToNodes(content) {
         if (selector === 'default')
             continue;
         const wrapper = document.createElement('div');
-        // SAFETY: trusted developer-authored HTML — see SECURITY.md.
+        // SAFETY: trusted developer-authored HTML, see SECURITY.md.
         wrapper.innerHTML = html;
         const nodes = [];
         for (const child of Array.from(wrapper.childNodes)) {
             const el = document.createElement('div');
-            // SAFETY: trusted developer-authored HTML — see SECURITY.md.
+            // SAFETY: trusted developer-authored HTML (see SECURITY.md).
             el.innerHTML = child.outerHTML ?? child.textContent ?? '';
             const projected = el.firstChild;
             if (projected && projected instanceof Element) {
@@ -43,7 +43,7 @@ export function parseContentToNodes(content) {
     }
     return result;
 }
-// SAFETY: see `parseContentToNodes` above and SECURITY.md — `html` is trusted
+// SAFETY: see `parseContentToNodes` above and SECURITY.md. `html` is trusted
 // developer-authored variant content from the `@Showcase` decorator.
 function htmlToNodes(html) {
     const wrapper = document.createElement('div');

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

@@ -6,11 +6,21 @@ export declare class PrismCanvasService {
     readonly zoom: import("@angular/core").WritableSignal<number>;
     readonly guides: import("@angular/core").WritableSignal<boolean>;
     readonly rulers: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Whether the measuring tool is active.
+     *
+     * Lives here rather than in `PrismMeasureService` because it is the same
+     * kind of state as `guides` and `rulers`: a preference about the working
+     * environment, not a statement about this variant. That also means the
+     * toggle inherits the constructor's capture-mode behaviour below for
+     * free, without having to repeat it.
+     */
+    readonly measure: import("@angular/core").WritableSignal<boolean>;
     /**
      * The width `.demo-wrap` is constrained to, or `null` for "as wide as it
      * wants".
      *
-     * Nullable rather than a `0`/`-1` sentinel because "off" is genuinely a
+     * Nullable rather than a `0`/`-1` sentinel because "off" is a
      * different state and not a width: the renderer keys a whole set of CSS off
      * `[data-viewport]`, and a falsy number would make `viewportWidth() ? ... `
      * silently treat a legal narrow width as "off" the moment the floor ever
@@ -32,6 +42,7 @@ export declare class PrismCanvasService {
     setZoom(z: number): void;
     toggleGuides(): void;
     toggleRulers(): void;
+    toggleMeasure(): void;
     setViewportWidth(w: number | null): void;
     toggleViewport(): void;
     private loadFromStorage;

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

@@ -1 +1 @@
-{"version":3,"file":"prism-canvas.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-canvas.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;;AAI3E,YAAY,EAAE,QAAQ,EAAE,CAAC;AAIzB,qBACa,kBAAkB;IAC3B,QAAQ,CAAC,EAAE,mDAA4B;IACvC,QAAQ,CAAC,IAAI,iDAAa;IAC1B,QAAQ,CAAC,MAAM,kDAAiB;IAChC,QAAQ,CAAC,MAAM,kDAAiB;IAEhC;;;;;;;;;OASG;IACH,QAAQ,CAAC,aAAa,wDAA+B;IAErD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB,CAAoB;;IAW7C,KAAK,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAKzB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB,YAAY,IAAI,IAAI;IAKpB,YAAY,IAAI,IAAI;IAKpB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAYxC,cAAc,IAAI,IAAI;IAItB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,IAAI;yCAnGH,kBAAkB;;CAqH9B"}
+{"version":3,"file":"prism-canvas.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-canvas.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;;AAI3E,YAAY,EAAE,QAAQ,EAAE,CAAC;AAIzB,qBACa,kBAAkB;IAC3B,QAAQ,CAAC,EAAE,mDAA4B;IACvC,QAAQ,CAAC,IAAI,iDAAa;IAC1B,QAAQ,CAAC,MAAM,kDAAiB;IAChC,QAAQ,CAAC,MAAM,kDAAiB;IAEhC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,kDAAiB;IAEjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,aAAa,wDAA+B;IAErD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB,CAAoB;;IAW7C,KAAK,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAKzB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB,YAAY,IAAI,IAAI;IAKpB,YAAY,IAAI,IAAI;IAKpB,aAAa,IAAI,IAAI;IAKrB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAYxC,cAAc,IAAI,IAAI;IAItB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,IAAI;yCApHH,kBAAkB;;CAuI9B"}

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

@@ -13,11 +13,22 @@ export class PrismCanvasService {
     ...(ngDevMode ? [{ debugName: "guides" }] : /* istanbul ignore next */ []));
     rulers = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rulers" }] : /* istanbul ignore next */ []));
+    /**
+     * Whether the measuring tool is active.
+     *
+     * Lives here rather than in `PrismMeasureService` because it is the same
+     * kind of state as `guides` and `rulers`: a preference about the working
+     * environment, not a statement about this variant. That also means the
+     * toggle inherits the constructor's capture-mode behaviour below for
+     * free, without having to repeat it.
+     */
+    measure = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "measure" }] : /* istanbul ignore next */ []));
     /**
      * The width `.demo-wrap` is constrained to, or `null` for "as wide as it
      * wants".
      *
-     * Nullable rather than a `0`/`-1` sentinel because "off" is genuinely a
+     * Nullable rather than a `0`/`-1` sentinel because "off" is a
      * different state and not a width: the renderer keys a whole set of CSS off
      * `[data-viewport]`, and a falsy number would make `viewportWidth() ? ... `
      * silently treat a legal narrow width as "off" the moment the floor ever
@@ -36,10 +47,10 @@ export class PrismCanvasService {
      */
     lastViewportWidth = VIEWPORT_DEFAULT;
     constructor() {
-        // Capture mode renders for a screenshot tool: persisted zoom, guides and
-        // rulers would leak a previous session's state into the image, so the
-        // defaults (zoom 1, no guides, no rulers) are kept and nothing is written
-        // back.
+        // Capture mode renders for a screenshot tool: persisted zoom, guides,
+        // rulers and the measure toggle would leak a previous session's state
+        // into the image, so the defaults (zoom 1, no guides, no rulers, measure
+        // off) are kept and nothing is written back.
         if (this.capture.active())
             return;
         this.loadFromStorage();
@@ -60,6 +71,10 @@ export class PrismCanvasService {
         this.rulers.update((v) => !v);
         this.save();
     }
+    toggleMeasure() {
+        this.measure.update((v) => !v);
+        this.save();
+    }
     setViewportWidth(w) {
         if (w === null) {
             this.viewportWidth.set(null);
@@ -89,6 +104,8 @@ export class PrismCanvasService {
                 this.guides.set(d['guides']);
             if (typeof d['rulers'] === 'boolean')
                 this.rulers.set(d['rulers']);
+            if (typeof d['measure'] === 'boolean')
+                this.measure.set(d['measure']);
             if (typeof d['viewportWidth'] === 'number') {
                 const w = clampViewportWidth(d['viewportWidth']);
                 this.lastViewportWidth = w;
@@ -108,6 +125,7 @@ export class PrismCanvasService {
                 zoom: this.zoom(),
                 guides: this.guides(),
                 rulers: this.rulers(),
+                measure: this.measure(),
                 viewportWidth: this.viewportWidth()
             }));
         }

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

@@ -6,59 +6,33 @@ export declare const CAPTURE_ATTRIBUTE = "data-prism-capture";
 /**
  * Everything capture mode makes see-through for `bg: 'transparent'`.
  *
- * A screenshot tool clips the *composited* page, so a transparent stage alone
- * buys nothing: the wrappers behind it keep painting and the PNG comes back
- * opaque. The stage and every ancestor that paints have to go at once, which
- * is why this is one selector rather than a rule per layer.
- *
- * `html` and `body` are insurance rather than observation — ng-prism paints
- * neither, but a consuming app's global stylesheet can, and the guarantee this
- * makes is "nothing opaque between the component and the document root".
- * Above `html` the backdrop is the browser's own and no stylesheet reaches it;
- * a runner has to clear that with `omitBackground: true`.
- *
- * `prism-shell` is the *host element* the app bootstraps into, not the
- * `div.prism-shell` inside its template — both are in the chain and either can
- * be given a background, a `:host` rule being the easy way to do it by
- * accident. `.prism-body` is the grid between the shell and `.prism-main` and
- * is listed on the same insurance grounds.
- *
- * Scoped by `:has()` to a *transparent* stage, so the other five backgrounds
- * behave exactly as before. Exported so a test can assert the invariant
- * against the real DOM rather than against this list — the list is the
- * fragile part of the feature. A renamed wrapper or a newly introduced
- * painting layer turns the capture opaque again, and an opaque capture still
- * looks correct; it just silently stops testing transparency.
+ * A screenshot tool clips the composited page, so the stage and every painting
+ * ancestor must clear together or the PNG comes back opaque. `html`, `body`,
+ * the `prism-shell` host element and `.prism-body` are insurance: ng-prism
+ * paints none of them, but an app stylesheet or a `:host` rule can. The
+ * browser's own backdrop above `html` needs `omitBackground: true` in the runner.
+ *
+ * Scoped by `:has()` to a transparent stage so the other backgrounds are
+ * untouched. Exported so a test can check it against the real DOM: a renamed
+ * wrapper or a new painting layer makes captures opaque again, and an opaque
+ * capture still looks correct.
  */
 export declare const CAPTURE_TRANSPARENT_SELECTOR: string;
 /**
- * Capture-isolation mode.
- *
- * Screenshot tools clip the composited page to the capture target's box, so
- * anything painted behind or inside `.demo-wrap` ends up in the image. Capture
- * mode strips the canvas background down to its patternless colour — keeping
- * whatever `@Showcase({ bg })` declared, or clearing the whole paint chain to
- * real transparency for `bg: 'transparent'` — suppresses every piece of
- * canvas chrome, removes every other shell region from layout so the canvas
- * owns the viewport, locks zoom to 1 and freezes animation, so a variant
- * renders identically on every run.
- *
- * What that buys a runner is the right to screenshot `.demo-wrap` directly:
- * the target is composited against the declared background over its whole box,
- * not merely over the part that fits inside the canvas viewport. The one thing
- * the mode cannot do is make room that the viewport does not have — a
- * component larger than the viewport still overflows, and sizing the viewport
- * to fit is the runner's job.
- *
- * The flag is read once from the URL at construction time and never written
- * back — {@link PrismUrlStateService} rebuilds the query string from scratch,
- * so navigating inside the app drops `?capture=1` from the address bar while
- * the mode itself stays on for the lifetime of the document.
- *
- * Reading in the constructor (rather than during `PrismUrlStateService.init()`)
- * is deliberate: `PrismCanvasService` restores persisted zoom in *its* own
- * constructor, which can run first, so anything init-order dependent would
- * make zoom-locking racy.
+ * Capture-isolation mode, for external screenshot runners.
+ *
+ * Keeps the declared canvas colour but strips its pattern (or clears the whole
+ * paint chain for `bg: 'transparent'`), hides canvas chrome and every other
+ * shell region, locks zoom to 1 and freezes animation, so a variant renders the
+ * same on every run and a runner can screenshot `.demo-wrap` directly. It
+ * cannot make room the viewport lacks: sizing the viewport is the runner's job.
+ *
+ * The flag is read once from the URL in the constructor and never written back.
+ * {@link PrismUrlStateService} rebuilds the query string, so `?capture=1` leaves
+ * the address bar on navigation while the mode stays on. Reading it during
+ * `PrismUrlStateService.init()` instead would make zoom-locking racy:
+ * `PrismCanvasService` restores persisted zoom in its own constructor, which
+ * can run first.
  */
 export declare class PrismCaptureService {
     private readonly _active;

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

@@ -1 +1 @@
-{"version":3,"file":"prism-capture.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-capture.service.ts"],"names":[],"mappings":";AAEA,sFAAsF;AACtF,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAItD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,4BAA4B,QAE4H,CAAC;AAiJtK;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6F;IAErH,kEAAkE;IAClE,QAAQ,CAAC,MAAM,0CAA6B;;IAM5C,OAAO,CAAC,eAAe;yCAVd,mBAAmB;;CAoB/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKzD"}
+{"version":3,"file":"prism-capture.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-capture.service.ts"],"names":[],"mappings":";AAEA,sFAAsF;AACtF,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAItD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,QAE4H,CAAC;AA2FtK;;;;;;;;;;;;;;;GAeG;AACH,qBACa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6F;IAErH,kEAAkE;IAClE,QAAQ,CAAC,MAAM,0CAA6B;;IAM5C,OAAO,CAAC,eAAe;yCAVd,mBAAmB;;CAoB/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKzD"}