@ng-prism/core 22.2.0-beta.3 → 22.2.0-beta.5

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

@@ -19,6 +19,12 @@ const STYLE_ELEMENT_ID = 'ng-prism-capture-styles';
  * 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
@@ -27,7 +33,52 @@ const STYLE_ELEMENT_ID = 'ng-prism-capture-styles';
  * looks correct; it just silently stops testing transparency.
  */
 export const CAPTURE_TRANSPARENT_SELECTOR = `[${CAPTURE_ATTRIBUTE}] .prism-canvas-stage[data-bg='transparent'],\n` +
-    `[${CAPTURE_ATTRIBUTE}] :is(html, body, .prism-shell, .prism-main, .prism-canvas-wrap):has(.prism-canvas-stage[data-bg='transparent'])`;
+    `[${CAPTURE_ATTRIBUTE}] :is(html, body, prism-shell, .prism-shell, .prism-body, .prism-main, .prism-canvas-wrap):has(.prism-canvas-stage[data-bg='transparent'])`;
+/**
+ * Everything capture mode removes from layout so the canvas owns the viewport.
+ *
+ * The canvas is not an overlay host: `.prism-canvas-wrap` is one flex sibling
+ * among several inside `.prism-main`, which is itself one grid cell of
+ * `.prism-body` inside `.prism-shell`. A screenshot tool captures the *screen
+ * coordinates* of `.demo-wrap`, and `.demo-wrap` is centred in a stage that
+ * scrolls — so whenever the component is larger than the canvas viewport, its
+ * box extends past the canvas and the compositor fills those coordinates with
+ * whichever sibling lives there. Measured in Chromium against the real
+ * stylesheets, a 200x400 component at a 1280x720 viewport leaks 57px upwards
+ * into the variant ribbon and 121px downwards into the panel. That is neither
+ * a z-order nor a clipping bug: the capture target legitimately extends beyond
+ * its scroll container and the page paints something there.
+ *
+ * `display: none` rather than `visibility: hidden`, and this is the one thing
+ * not to "simplify" later. Keeping the layout box is the tempting minimal-churn
+ * fix — nothing re-centres, no unaffected baseline moves — and it does not
+ * work: the box still occupies its space, so what paints at those coordinates
+ * becomes `.prism-main`'s own background instead of the panel. Measured at the
+ * bottom row of a `bg: 'transparent'` capture: `#11284e` with the panel left
+ * alone, `#11284e` with `visibility: hidden`, transparent only once the panel
+ * leaves layout. The canvas is `flex: 1`; it has to reclaim the space for the
+ * stage to paint there, and only removal from layout gives it back.
+ *
+ * Written as a structural rule rather than a list of chrome selectors, because
+ * enumeration is what makes this class of bug recur: the list has to be revised
+ * every time the shell grows a region, nothing fails when it is not, and the
+ * baselines recorded in the meantime look perfectly fine while guarding the
+ * wrong image. At every level from the shell to the canvas wrap, the one child
+ * that leads to the stage survives and every sibling is removed, so a region
+ * added tomorrow is suppressed without anyone remembering this file exists.
+ *
+ * The track collapses are not cosmetic. `.prism-shell` and `.prism-body` are
+ * grids with sized tracks (`52px 1fr`, `var(--sw) 4px 1fr`); hiding the header
+ * and the sidebar without collapsing them would auto-place the survivor into
+ * the *first* track and render the canvas 52px tall or 264px wide.
+ *
+ * Scoped by `:has(.prism-canvas-stage)` throughout: a component page or a view
+ * panel has no canvas, and blanking the shell around it would leave a runner
+ * with an empty screenshot rather than an honest one.
+ */
+const CAPTURE_CANVAS_ONLY_SELECTOR = `[${CAPTURE_ATTRIBUTE}] ` +
+    `:is(.prism-shell, .prism-body, .prism-main, .prism-canvas-wrap)` +
+    `:has(.prism-canvas-stage) > :not(:has(.prism-canvas-stage))`;
 /**
  * Global stylesheet applied in capture mode.
  *
@@ -51,6 +102,23 @@ export const CAPTURE_TRANSPARENT_SELECTOR = `[${CAPTURE_ATTRIBUTE}] .prism-canva
  * layers involved. Alpha is not what the paragraph above rules out: a pattern
  * has a phase that moves when the component resizes, an alpha channel is a
  * per-pixel value that does not.
+ *
+ * Colour is only half of it. The rules from
+ * {@link CAPTURE_CANVAS_ONLY_SELECTOR} down hand the whole viewport to the
+ * canvas, which is what makes the declared background reach the *whole* of the
+ * capture target's box rather than only the part that happens to fit inside
+ * the canvas viewport.
+ *
+ * The stage's padding goes with them, and it buys more than the 32px it looks
+ * like. The stage is `height: 100%` under `content-box`, so its padding lands
+ * *outside* that height: the stage is 64px taller than the row it sits in,
+ * overflows it, and centres the component 32px below the true centre of what
+ * is actually painted. Dropping the padding makes the stage exactly the canvas
+ * and the component's centre the viewport's centre, which turns the guarantee
+ * crisp — a component is contained iff it fits the viewport. Measured: a
+ * 200x700 component at 1280x720 still leaks 22px past the canvas with the
+ * regions gone but the padding kept. None of that padding is ever inside a
+ * `.demo-wrap` screenshot, so nothing is lost by removing it.
  */
 const CAPTURE_STYLES = `
 [${CAPTURE_ATTRIBUTE}] *,
@@ -64,12 +132,29 @@ const CAPTURE_STYLES = `
 
 [${CAPTURE_ATTRIBUTE}] .prism-canvas-stage {
   background-image: none !important;
+  padding: 0 !important;
 }
 
 ${CAPTURE_TRANSPARENT_SELECTOR} {
   background-color: transparent !important;
   background-image: none !important;
 }
+
+${CAPTURE_CANVAS_ONLY_SELECTOR} {
+  display: none !important;
+}
+
+[${CAPTURE_ATTRIBUTE}] .prism-shell:has(.prism-canvas-stage) {
+  grid-template-rows: minmax(0, 1fr) !important;
+}
+
+[${CAPTURE_ATTRIBUTE}] .prism-body:has(.prism-canvas-stage) {
+  grid-template-columns: minmax(0, 1fr) !important;
+}
+
+[${CAPTURE_ATTRIBUTE}] .prism-canvas-wrap:has(.prism-canvas-stage) {
+  grid-template-rows: minmax(0, 1fr) !important;
+}
 `;
 /**
  * Capture-isolation mode.
@@ -79,8 +164,16 @@ ${CAPTURE_TRANSPARENT_SELECTOR} {
  * 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, locks zoom to 1 and freezes animation, so a variant renders
- * identically on every run.
+ * 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,

package/dist/app/services/prism-event-log.service.d.ts

@@ -11,6 +11,6 @@ export declare class PrismEventLogService {
     log(name: string, value: unknown): void;
     clear(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismEventLogService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismEventLogService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-event-log.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-event-log.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-event-log.service.ts"],"names":[],"mappings":";AAEA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBACa,oBAAoB;IAC/B,QAAQ,CAAC,MAAM,0DAA+B;IAC9C,OAAO,CAAC,OAAO,CAAK;IAEpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;yCAXF,oBAAoB;6CAApB,oBAAoB;CAchC"}
+{"version":3,"file":"prism-event-log.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-event-log.service.ts"],"names":[],"mappings":";AAEA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBACa,oBAAoB;IAC/B,QAAQ,CAAC,MAAM,0DAA+B;IAC9C,OAAO,CAAC,OAAO,CAAK;IAEpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;yCAXF,oBAAoB;;CAchC"}

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

@@ -21,6 +21,6 @@ export declare class PrismLayoutService {
     private loadFromStorage;
     private saveToStorage;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismLayoutService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismLayoutService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-layout.service.d.ts.map

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;IAC7B,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;IAClC,QAAQ,CAAC,sBAAsB,kDAAiB;;IAMhD,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAKpB,aAAa,IAAI,IAAI;IAKrB,iBAAiB,IAAI,IAAI;IAKzB,qBAAqB,IAAI,IAAI;IAI7B,oBAAoB,IAAI,IAAI;IAI5B,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;IA0BvB,OAAO,CAAC,aAAa;yCAnFV,kBAAkB;6CAAlB,kBAAkB;CA+F9B"}
+{"version":3,"file":"prism-layout.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-layout.service.ts"],"names":[],"mappings":";AAIA,qBACa,kBAAkB;IAC7B,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;IAClC,QAAQ,CAAC,sBAAsB,kDAAiB;;IAMhD,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAKpB,aAAa,IAAI,IAAI;IAKrB,iBAAiB,IAAI,IAAI;IAKzB,qBAAqB,IAAI,IAAI;IAI7B,oBAAoB,IAAI,IAAI;IAI5B,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;IA0BvB,OAAO,CAAC,aAAa;yCAnFV,kBAAkB;;CA+F9B"}

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

@@ -10,6 +10,6 @@ export declare class PrismManifestService {
     readonly groupedByCategory: import("@angular/core").Signal<Map<string, RuntimeComponent[]>>;
     updateManifest(manifest: RuntimeManifest): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismManifestService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismManifestService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-manifest.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-manifest.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-manifest.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;;AAGjE,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAE7E,QAAQ,CAAC,QAAQ,kDAA+B;IAEhD,QAAQ,CAAC,UAAU,qDAAmE;IAEtF,QAAQ,CAAC,KAAK,mDAAkE;IAEhF,QAAQ,CAAC,UAAU,2CAsBhB;IAEH,QAAQ,CAAC,iBAAiB,kEAUvB;IAEH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;yCA7CpC,oBAAoB;6CAApB,oBAAoB;CAgDhC"}
+{"version":3,"file":"prism-manifest.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-manifest.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;;AAGjE,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAE7E,QAAQ,CAAC,QAAQ,kDAA+B;IAEhD,QAAQ,CAAC,UAAU,qDAAmE;IAEtF,QAAQ,CAAC,KAAK,mDAAkE;IAEhF,QAAQ,CAAC,UAAU,2CAsBhB;IAEH,QAAQ,CAAC,iBAAiB,kEAUvB;IAEH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;yCA7CpC,oBAAoB;;CAgDhC"}

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

@@ -24,6 +24,6 @@ export declare class PrismNavigationService {
     selectPage(page: StyleguidePage): void;
     selectFirst(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismNavigationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismNavigationService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-navigation.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-navigation.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-navigation.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;;AAWjE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAG1D;AAeD,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAEhE,QAAQ,CAAC,UAAU,gEAAuC;IAE1D,QAAQ,CAAC,eAAe,0DAQrB;IAEH,QAAQ,CAAC,UAAU,wDAQhB;IAEH,QAAQ,CAAC,WAAW,gDAiFjB;IAEH,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAIpC,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAItC,WAAW,IAAI,IAAI;yCArHR,sBAAsB;6CAAtB,sBAAsB;CAkIlC"}
+{"version":3,"file":"prism-navigation.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-navigation.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;;AAWjE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAG1D;AAeD,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAEhE,QAAQ,CAAC,UAAU,gEAAuC;IAE1D,QAAQ,CAAC,eAAe,0DAQrB;IAEH,QAAQ,CAAC,UAAU,wDAQhB;IAEH,QAAQ,CAAC,WAAW,gDAiFjB;IAEH,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAIpC,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAItC,WAAW,IAAI,IAAI;yCArHR,sBAAsB;;CAkIlC"}

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

@@ -14,6 +14,6 @@ export declare class PrismPanelService {
      */
     getInjector(panelId: string): EnvironmentInjector | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismPanelService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismPanelService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-panel.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-panel.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-panel.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,mBAAmB,EAIpB,MAAM,eAAe,CAAC;;AAIvB,qBACa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IAExE,QAAQ,CAAC,aAAa,iDAA8B;IACpD,QAAQ,CAAC,YAAY,iDAA8B;IAEnD,QAAQ,CAAC,mBAAmB,6DAE1B;IAEF;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;yCAjB7C,iBAAiB;6CAAjB,iBAAiB;CAiC7B"}
+{"version":3,"file":"prism-panel.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-panel.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,mBAAmB,EAIpB,MAAM,eAAe,CAAC;;AAIvB,qBACa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IAExE,QAAQ,CAAC,aAAa,iDAA8B;IACpD,QAAQ,CAAC,YAAY,iDAA8B;IAEnD,QAAQ,CAAC,mBAAmB,6DAE1B;IAEF;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;yCAjB7C,iBAAiB;;CAiC7B"}

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

@@ -16,6 +16,6 @@ export declare class PrismPersistenceService {
     private writeDebounced;
     private serialize;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismPersistenceService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismPersistenceService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-persistence.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-persistence.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-persistence.service.ts"],"names":[],"mappings":";AA+BA,qBACa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CACyC;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,cAAc,CAAuB;IAE7C,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,kBAAkB;IAmD1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,SAAS;yCA5GN,uBAAuB;6CAAvB,uBAAuB;CA0InC"}
+{"version":3,"file":"prism-persistence.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-persistence.service.ts"],"names":[],"mappings":";AA+BA,qBACa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CACyC;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,cAAc,CAAuB;IAE7C,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,kBAAkB;IAmD1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,SAAS;yCA5GN,uBAAuB;;CA0InC"}

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

@@ -1,4 +1,4 @@
-import type { ControlDefinition, HeaderWidgetDefinition, PanelDefinition } from '../../plugin/plugin.types.js';
+import type { ControlDefinition, HeaderWidgetDefinition, NavigationDecorationDefinition, PanelDefinition } from '../../plugin/plugin.types.js';
 import * as i0 from "@angular/core";
 export declare class PrismPluginService {
     private readonly config;
@@ -9,7 +9,13 @@ export declare class PrismPluginService {
     readonly headerWidgets: import("@angular/core").Signal<HeaderWidgetDefinition[]>;
     readonly headerWidgetsStart: import("@angular/core").Signal<HeaderWidgetDefinition[]>;
     readonly headerWidgetsEnd: import("@angular/core").Signal<HeaderWidgetDefinition[]>;
+    /**
+     * Plugin-contributed navigation markers. Built-ins are merged in by the
+     * consumer via `resolveNavigationDecorations`, the same split `panels` and
+     * `headerWidgets` already use.
+     */
+    readonly navigationDecorations: import("@angular/core").Signal<NavigationDecorationDefinition[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismPluginService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismPluginService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-plugin.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-plugin.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-plugin.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EAChB,MAAM,8BAA8B,CAAC;;AAGtC,qBACa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C,QAAQ,CAAC,MAAM,oDAQZ;IAEH,QAAQ,CAAC,WAAW,oDAElB;IAEF,QAAQ,CAAC,UAAU,oDAEjB;IAEF,QAAQ,CAAC,QAAQ,sDAQd;IAEH,QAAQ,CAAC,aAAa,2DAQnB;IAEH,QAAQ,CAAC,kBAAkB,2DAEzB;IAEF,QAAQ,CAAC,gBAAgB,2DAEvB;yCA/CS,kBAAkB;6CAAlB,kBAAkB;CAgD9B"}
+{"version":3,"file":"prism-plugin.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-plugin.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,8BAA8B,EAC9B,eAAe,EAChB,MAAM,8BAA8B,CAAC;;AAGtC,qBACa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C,QAAQ,CAAC,MAAM,oDAQZ;IAEH,QAAQ,CAAC,WAAW,oDAElB;IAEF,QAAQ,CAAC,UAAU,oDAEjB;IAEF,QAAQ,CAAC,QAAQ,sDAQd;IAEH,QAAQ,CAAC,aAAa,2DAQnB;IAEH,QAAQ,CAAC,kBAAkB,2DAEzB;IAEF,QAAQ,CAAC,gBAAgB,2DAEvB;IAEF;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,mEAU5B;yCAhES,kBAAkB;;CAiE9B"}

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

@@ -41,6 +41,21 @@ export class PrismPluginService {
     ...(ngDevMode ? [{ debugName: "headerWidgetsStart" }] : /* istanbul ignore next */ []));
     headerWidgetsEnd = computed(() => this.headerWidgets().filter((w) => (w.placement ?? 'end') === 'end'), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "headerWidgetsEnd" }] : /* istanbul ignore next */ []));
+    /**
+     * Plugin-contributed navigation markers. Built-ins are merged in by the
+     * consumer via `resolveNavigationDecorations`, the same split `panels` and
+     * `headerWidgets` already use.
+     */
+    navigationDecorations = computed(() => {
+        const result = [];
+        for (const plugin of this.config.plugins ?? []) {
+            if (plugin.navigationDecorations) {
+                result.push(...plugin.navigationDecorations);
+            }
+        }
+        return result;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "navigationDecorations" }] : /* istanbul ignore next */ []));
     static ɵfac = function PrismPluginService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || PrismPluginService)(); };
     static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: PrismPluginService, factory: PrismPluginService.ɵfac, providedIn: 'root' });
 }

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

@@ -22,6 +22,6 @@ export declare class PrismRendererService {
     resetInputsToVariantDefaults(): void;
     private applyVariant;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismRendererService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismRendererService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-renderer.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-renderer.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-renderer.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;;AAGrE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC5D;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC5E,oBAAoB,CA+CtB;AAaD,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE,QAAQ,CAAC,kBAAkB,iDAAa;IACxC,QAAQ,CAAC,WAAW,kEAAuC;IAC3D,QAAQ,CAAC,aAAa,sFAAkE;IACxF,QAAQ,CAAC,eAAe,yDAAgC;IAExD,QAAQ,CAAC,eAAe,yCAcrB;IAEH,OAAO,CAAC,cAAc,CAAuB;IAE7C,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAM/C,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IA2CnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,4BAA4B,IAAI,IAAI;IAMpC,OAAO,CAAC,YAAY;yCA3FT,oBAAoB;6CAApB,oBAAoB;CAqGhC"}
+{"version":3,"file":"prism-renderer.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-renderer.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;;AAGrE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC5D;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC5E,oBAAoB,CA+CtB;AAaD,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE,QAAQ,CAAC,kBAAkB,iDAAa;IACxC,QAAQ,CAAC,WAAW,kEAAuC;IAC3D,QAAQ,CAAC,aAAa,sFAAkE;IACxF,QAAQ,CAAC,eAAe,yDAAgC;IAExD,QAAQ,CAAC,eAAe,yCAcrB;IAEH,OAAO,CAAC,cAAc,CAAuB;IAE7C,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAM/C,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IA2CnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,4BAA4B,IAAI,IAAI;IAMpC,OAAO,CAAC,YAAY;yCA3FT,oBAAoB;;CAqGhC"}

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

@@ -8,6 +8,6 @@ export declare class PrismSearchService {
     search(q: string): void;
     clear(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismSearchService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismSearchService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-search.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-search.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-search.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;;AAGjE,qBACa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAEhE,QAAQ,CAAC,KAAK,iDAAc;IAE5B,QAAQ,CAAC,kBAAkB,8EAYxB;IAEH,QAAQ,CAAC,aAAa,mDAQnB;IAEH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvB,KAAK,IAAI,IAAI;yCAjCF,kBAAkB;6CAAlB,kBAAkB;CAoC9B"}
+{"version":3,"file":"prism-search.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-search.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;;AAGjE,qBACa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAEhE,QAAQ,CAAC,KAAK,iDAAc;IAE5B,QAAQ,CAAC,kBAAkB,8EAYxB;IAEH,QAAQ,CAAC,aAAa,mDAQnB;IAEH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvB,KAAK,IAAI,IAAI;yCAjCF,kBAAkB;;CAoC9B"}

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

@@ -16,6 +16,6 @@ export declare class PrismThemeService {
     private applyFavicon;
     private readStoredTheme;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismThemeService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismThemeService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-theme.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-theme.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-theme.service.ts"],"names":[],"mappings":";AAUA,qBACa,iBAAiB;IAC5B,QAAQ,CAAC,KAAK,2DAAoD;IAClE,QAAQ,CAAC,MAAM,0CAA2C;IAE1D,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAA8B;;IAYpD,MAAM,IAAI,IAAI;IAId,oBAAoB,CAAC,MAAM,EAAE;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,GAAG,IAAI;IAOR,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,eAAe;yCA/DZ,iBAAiB;6CAAjB,iBAAiB;CAsE7B"}
+{"version":3,"file":"prism-theme.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-theme.service.ts"],"names":[],"mappings":";AAUA,qBACa,iBAAiB;IAC5B,QAAQ,CAAC,KAAK,2DAAoD;IAClE,QAAQ,CAAC,MAAM,0CAA2C;IAE1D,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAA8B;;IAYpD,MAAM,IAAI,IAAI;IAId,oBAAoB,CAAC,MAAM,EAAE;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,GAAG,IAAI;IAOR,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,eAAe;yCA/DZ,iBAAiB;;CAsE7B"}

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

@@ -11,6 +11,6 @@ export declare class PrismUrlStateService {
     private restoreFromUrl;
     private writeToUrl;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismUrlStateService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismUrlStateService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-url-state.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-url-state.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-url-state.service.ts"],"names":[],"mappings":";AAgBA,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,IAAI,IAAI;IAqBZ,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,UAAU;yCA5EP,oBAAoB;6CAApB,oBAAoB;CAyHhC"}
+{"version":3,"file":"prism-url-state.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-url-state.service.ts"],"names":[],"mappings":";AAgBA,qBACa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAS;IAE7B,IAAI,IAAI,IAAI;IAqBZ,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,UAAU;yCA5EP,oBAAoB;;CAyHhC"}

package/dist/app/services/prism-variant-bg.service.d.ts

@@ -45,6 +45,6 @@ export declare class PrismVariantBgService {
     setOverride(bg: CanvasBg): void;
     clearOverride(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrismVariantBgService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrismVariantBgService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 //# sourceMappingURL=prism-variant-bg.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prism-variant-bg.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-variant-bg.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;;AAU/D,qBACa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD,QAAQ,CAAC,WAAW,kDAOjB;IAEH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,QAAQ,CAAC,QAAQ,kDAA+B;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,SAAS,2CAIhB;IAEF,gFAAgF;IAChF,QAAQ,CAAC,WAAW,0CAMjB;;IAUH,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI/B,aAAa,IAAI,IAAI;yCA3EV,qBAAqB;6CAArB,qBAAqB;CA8EjC"}
+{"version":3,"file":"prism-variant-bg.service.d.ts","sourceRoot":"","sources":["../../../src/app/services/prism-variant-bg.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;;AAU/D,qBACa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD,QAAQ,CAAC,WAAW,kDAOjB;IAEH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,QAAQ,CAAC,QAAQ,kDAA+B;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,SAAS,2CAIhB;IAEF,gFAAgF;IAChF,QAAQ,CAAC,WAAW,0CAMjB;;IAUH,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI/B,aAAa,IAAI,IAAI;yCA3EV,qBAAqB;;CA8EjC"}

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

@@ -183,7 +183,7 @@ export class PrismShellComponent {
             i0.ɵɵadvance();
             i0.ɵɵconditional(ctx.layout.sidebarVisible() ? 3 : -1);
             i0.ɵɵadvance();
-            i0.ɵɵstyleProp("--ph", ctx.showPanel() ? ctx.layout.panelHeight() : 0, "px");
+            i0.ɵɵstyleProp("--%NS%ph", ctx.showPanel() ? ctx.layout.panelHeight() : 0, "px");
             i0.ɵɵadvance();
             i0.ɵɵconditional(ctx.navigationService.activeComponent() ? 5 : ctx.navigationService.activePage() ? 6 : 7);
         } }, dependencies: [PrismHeaderComponent,
@@ -197,7 +197,7 @@ export class PrismShellComponent {
             PrismViewPanelHostComponent,
             PrismResizerDirective,
             PrismCanvasToolbarComponent,
-            PrismTemplatePopoverComponent], styles: ["[_nghost-%COMP%] { display: block; height: 100%; }\n\n    .prism-shell[_ngcontent-%COMP%] {\n      height: 100vh;\n      display: grid;\n      grid-template-rows: 52px 1fr;\n      background: var(--prism-void);\n      font-family: var(--font-sans, var(--prism-font-sans));\n      color: var(--prism-text);\n      overflow: hidden;\n    }\n\n    .prism-body[_ngcontent-%COMP%] {\n      display: grid;\n      grid-template-columns: var(--sw, 264px) 4px 1fr;\n      min-height: 0;\n    }\n    .prism-body--no-sidebar[_ngcontent-%COMP%] {\n      grid-template-columns: 1fr;\n    }\n\n    .prism-sidebar-wrap[_ngcontent-%COMP%] {\n      background: var(--prism-bg);\n      border-right: 1px solid var(--prism-border);\n      display: flex;\n      flex-direction: column;\n      min-height: 0;\n      overflow: hidden;\n    }\n\n    .prism-sidebar-wrap[_ngcontent-%COMP%]   prism-sidebar[_ngcontent-%COMP%] {\n      flex: 1;\n      min-height: 0;\n    }\n\n    .prism-sidebar-foot[_ngcontent-%COMP%] {\n      border-top: 1px solid var(--prism-border);\n      padding: 10px 14px;\n      font-size: 11px;\n      color: var(--prism-text-ghost);\n      display: flex;\n      align-items: center;\n      gap: 8px;\n    }\n    .prism-sidebar-foot__logo[_ngcontent-%COMP%] {\n      width: 16px;\n      flex-shrink: 0;\n    }\n    .prism-sidebar-foot__link[_ngcontent-%COMP%] {\n      color: var(--prism-text-ghost);\n      text-decoration: none;\n      transition: color var(--dur-fast);\n    }\n    .prism-sidebar-foot__link[_ngcontent-%COMP%]:hover {\n      color: var(--prism-text-2);\n    }\n\n    .prism-resizer-col[_ngcontent-%COMP%] {\n      width: 4px;\n      background: transparent;\n      transition: background var(--dur-fast) var(--ease-default);\n      position: relative;\n      z-index: 5;\n    }\n    .prism-resizer-col[_ngcontent-%COMP%]:hover, \n   .prism-resizer-col.active[_ngcontent-%COMP%] {\n      background: var(--prism-primary);\n    }\n\n    .prism-main[_ngcontent-%COMP%] {\n      display: flex;\n      flex-direction: column;\n      min-height: 0;\n      background: var(--prism-void);\n      overflow: hidden;\n    }\n\n    .prism-resizer-row[_ngcontent-%COMP%] {\n      flex-shrink: 0;\n      height: 4px;\n      background: transparent;\n      transition: background var(--dur-fast) var(--ease-default);\n      position: relative;\n      z-index: 5;\n    }\n    .prism-resizer-row[_ngcontent-%COMP%]:hover, \n   .prism-resizer-row.active[_ngcontent-%COMP%] {\n      background: var(--prism-primary);\n    }\n\n    .prism-canvas-wrap[_ngcontent-%COMP%] {\n      flex: 1;\n      min-height: 0;\n      display: grid;\n      grid-template-rows: auto minmax(0, 1fr);\n      background: var(--prism-bg-surface);\n      overflow: hidden;\n      position: relative;\n    }\n    .prism-main__view-bar[_ngcontent-%COMP%] { flex-shrink: 0; }\n    .prism-main__canvas[_ngcontent-%COMP%] { flex: 1; min-height: 0; overflow: auto; }\n\n    .prism-main__panel[_ngcontent-%COMP%] {\n      height: var(--ph, 260px);\n      flex-shrink: 0;\n      overflow: hidden;\n      min-height: 0;\n    }\n\n    .prism-shell__empty[_ngcontent-%COMP%] {\n      display: flex;\n      flex-direction: column;\n      align-items: center;\n      justify-content: center;\n      gap: 8px;\n      grid-row: 1 / -1;\n    }\n    .prism-shell__empty-icon[_ngcontent-%COMP%] {\n      width: 48px;\n      height: 48px;\n      color: var(--prism-text-ghost);\n      margin-bottom: 8px;\n    }\n    .prism-shell__empty-text[_ngcontent-%COMP%] {\n      margin: 0;\n      font-size: var(--fs-xl);\n      font-weight: 500;\n      color: var(--prism-text-muted);\n    }\n    .prism-shell__empty-hint[_ngcontent-%COMP%] {\n      margin: 0;\n      font-size: var(--fs-lg);\n      color: var(--prism-text-ghost);\n    }"] });
+            PrismTemplatePopoverComponent], styles: ["[_nghost-%COMP%] { display: block; height: 100%; }\n\n    .prism-shell[_ngcontent-%COMP%] {\n      height: 100vh;\n      display: grid;\n      grid-template-rows: 52px 1fr;\n      background: var(--%NS%prism-void);\n      font-family: var(--%NS%font-sans, var(--%NS%prism-font-sans));\n      color: var(--%NS%prism-text);\n      overflow: hidden;\n    }\n\n    .prism-body[_ngcontent-%COMP%] {\n      display: grid;\n      grid-template-columns: var(--%NS%sw, 264px) 4px 1fr;\n      min-height: 0;\n    }\n    .prism-body--no-sidebar[_ngcontent-%COMP%] {\n      grid-template-columns: 1fr;\n    }\n\n    .prism-sidebar-wrap[_ngcontent-%COMP%] {\n      background: var(--%NS%prism-bg);\n      border-right: 1px solid var(--%NS%prism-border);\n      display: flex;\n      flex-direction: column;\n      min-height: 0;\n      overflow: hidden;\n    }\n\n    .prism-sidebar-wrap[_ngcontent-%COMP%]   prism-sidebar[_ngcontent-%COMP%] {\n      flex: 1;\n      min-height: 0;\n    }\n\n    .prism-sidebar-foot[_ngcontent-%COMP%] {\n      border-top: 1px solid var(--%NS%prism-border);\n      padding: 10px 14px;\n      font-size: 11px;\n      color: var(--%NS%prism-text-ghost);\n      display: flex;\n      align-items: center;\n      gap: 8px;\n    }\n    .prism-sidebar-foot__logo[_ngcontent-%COMP%] {\n      width: 16px;\n      flex-shrink: 0;\n    }\n    .prism-sidebar-foot__link[_ngcontent-%COMP%] {\n      color: var(--%NS%prism-text-ghost);\n      text-decoration: none;\n      transition: color var(--%NS%dur-fast);\n    }\n    .prism-sidebar-foot__link[_ngcontent-%COMP%]:hover {\n      color: var(--%NS%prism-text-2);\n    }\n\n    .prism-resizer-col[_ngcontent-%COMP%] {\n      width: 4px;\n      background: transparent;\n      transition: background var(--%NS%dur-fast) var(--%NS%ease-default);\n      position: relative;\n      z-index: 5;\n    }\n    .prism-resizer-col[_ngcontent-%COMP%]:hover, \n   .prism-resizer-col.active[_ngcontent-%COMP%] {\n      background: var(--%NS%prism-primary);\n    }\n\n    .prism-main[_ngcontent-%COMP%] {\n      display: flex;\n      flex-direction: column;\n      min-height: 0;\n      background: var(--%NS%prism-void);\n      overflow: hidden;\n    }\n\n    .prism-resizer-row[_ngcontent-%COMP%] {\n      flex-shrink: 0;\n      height: 4px;\n      background: transparent;\n      transition: background var(--%NS%dur-fast) var(--%NS%ease-default);\n      position: relative;\n      z-index: 5;\n    }\n    .prism-resizer-row[_ngcontent-%COMP%]:hover, \n   .prism-resizer-row.active[_ngcontent-%COMP%] {\n      background: var(--%NS%prism-primary);\n    }\n\n    .prism-canvas-wrap[_ngcontent-%COMP%] {\n      flex: 1;\n      min-height: 0;\n      display: grid;\n      grid-template-rows: auto minmax(0, 1fr);\n      background: var(--%NS%prism-bg-surface);\n      overflow: hidden;\n      position: relative;\n    }\n    .prism-main__view-bar[_ngcontent-%COMP%] { flex-shrink: 0; }\n    .prism-main__canvas[_ngcontent-%COMP%] { flex: 1; min-height: 0; overflow: auto; }\n\n    .prism-main__panel[_ngcontent-%COMP%] {\n      height: var(--%NS%ph, 260px);\n      flex-shrink: 0;\n      overflow: hidden;\n      min-height: 0;\n    }\n\n    .prism-shell__empty[_ngcontent-%COMP%] {\n      display: flex;\n      flex-direction: column;\n      align-items: center;\n      justify-content: center;\n      gap: 8px;\n      grid-row: 1 / -1;\n    }\n    .prism-shell__empty-icon[_ngcontent-%COMP%] {\n      width: 48px;\n      height: 48px;\n      color: var(--%NS%prism-text-ghost);\n      margin-bottom: 8px;\n    }\n    .prism-shell__empty-text[_ngcontent-%COMP%] {\n      margin: 0;\n      font-size: var(--%NS%fs-xl);\n      font-weight: 500;\n      color: var(--%NS%prism-text-muted);\n    }\n    .prism-shell__empty-hint[_ngcontent-%COMP%] {\n      margin: 0;\n      font-size: var(--%NS%fs-lg);\n      color: var(--%NS%prism-text-ghost);\n    }"] });
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(PrismShellComponent, [{
         type: Component,

package/dist/app/sidebar/navigation-decorations.d.ts

@@ -0,0 +1,67 @@
+import type { ComponentStatus } from '../../decorator/showcase.types.js';
+import type { NavigationDecorationDefinition } from '../../plugin/plugin.types.js';
+import type { NavigationItem } from '../services/navigation-item.types.js';
+/** One source's verdict on one component, resolved for rendering. */
+export interface ItemMark {
+    /**
+     * The definition's id. `resolveNavigationDecorations` guarantees these are
+     * unique, so this is the only field safe to `@for track` by — `icon` is a
+     * free-form string on a public extension point and two sources can pick the
+     * same one.
+     */
+    id: string;
+    icon: string;
+    variant: 'warn' | 'danger';
+    label: string;
+}
+export interface ItemDecorations {
+    /** Ordered marks — never empty; `decorateItem` returns null instead. */
+    marks: ItemMark[];
+    /** Worst variant across `marks`. Drives the group roll-up. */
+    worst: 'warn' | 'danger';
+    /** Newline-joined labels for the item's `title` attribute. */
+    tooltip: string;
+}
+export interface CategoryRollup {
+    /** Number of items in the category carrying at least one mark. */
+    problems: number;
+    /** Worst variant among them, or null for a clean category. */
+    variant: 'warn' | 'danger' | null;
+}
+/**
+ * Built-ins first, then plugin contributions, de-duplicated by id and sorted
+ * by `order`.
+ *
+ * Built-ins win a collision: a plugin must not be able to silence or restyle a
+ * core source by claiming its id. Sorting is by `order` alone — the reading
+ * contract says position names the source, so registration order must not leak
+ * into the result.
+ */
+export declare function resolveNavigationDecorations(builtin: readonly NavigationDecorationDefinition[], fromPlugins: readonly NavigationDecorationDefinition[]): NavigationDecorationDefinition[];
+/**
+ * Runs every definition against one item.
+ *
+ * Returns `null` rather than an empty result for a clean component, so callers
+ * cannot accidentally render an empty marker container.
+ */
+export declare function decorateItem(item: NavigationItem, defs: readonly NavigationDecorationDefinition[]): ItemDecorations | null;
+/**
+ * Counts the items in one category that carry at least one mark.
+ *
+ * Items, not marks: a component with three findings is one thing to look at,
+ * and a group head reading "3" for a single broken component would overstate
+ * the work.
+ *
+ * Takes each item's already-resolved `ItemDecorations` rather than the raw
+ * items — callers already run `decorateItem` once per item to render its
+ * marks, and recomputing it here would both waste the work and let the
+ * roll-up drift from what actually renders.
+ */
+export declare function rollupCategory(decorations: readonly (ItemDecorations | null)[]): CategoryRollup;
+/**
+ * The left icon slot carries lifecycle — what the author declared — in form
+ * alone. Colour in the sidebar means exactly one thing, measured quality, so a
+ * work-in-progress component must never look like a finding.
+ */
+export declare function lifecycleIcon(status: ComponentStatus | undefined): string;
+//# sourceMappingURL=navigation-decorations.d.ts.map

package/dist/app/sidebar/navigation-decorations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-decorations.d.ts","sourceRoot":"","sources":["../../../src/app/sidebar/navigation-decorations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAE3E,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;CACnC;AAID;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,SAAS,8BAA8B,EAAE,EAClD,WAAW,EAAE,SAAS,8BAA8B,EAAE,GACrD,8BAA8B,EAAE,CAWlC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,SAAS,8BAA8B,EAAE,GAC9C,eAAe,GAAG,IAAI,CAuBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,EAAE,GAC/C,cAAc,CAahB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAEzE"}

package/dist/app/sidebar/navigation-decorations.js

@@ -0,0 +1,84 @@
+const SEVERITY = { warn: 1, danger: 2 };
+/**
+ * Built-ins first, then plugin contributions, de-duplicated by id and sorted
+ * by `order`.
+ *
+ * Built-ins win a collision: a plugin must not be able to silence or restyle a
+ * core source by claiming its id. Sorting is by `order` alone — the reading
+ * contract says position names the source, so registration order must not leak
+ * into the result.
+ */
+export function resolveNavigationDecorations(builtin, fromPlugins) {
+    const seen = new Set();
+    const result = [];
+    for (const def of [...builtin, ...fromPlugins]) {
+        if (seen.has(def.id))
+            continue;
+        seen.add(def.id);
+        result.push(def);
+    }
+    return result.sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+}
+/**
+ * Runs every definition against one item.
+ *
+ * Returns `null` rather than an empty result for a clean component, so callers
+ * cannot accidentally render an empty marker container.
+ */
+export function decorateItem(item, defs) {
+    if (item.kind !== 'component')
+        return null;
+    const marks = [];
+    for (const def of defs) {
+        const badge = def.badge(item.data);
+        if (!badge)
+            continue;
+        marks.push({
+            id: def.id,
+            icon: def.icon,
+            variant: badge.variant,
+            label: badge.label,
+        });
+    }
+    if (marks.length === 0)
+        return null;
+    let worst = 'warn';
+    for (const mark of marks) {
+        if (SEVERITY[mark.variant] > SEVERITY[worst])
+            worst = mark.variant;
+    }
+    return { marks, worst, tooltip: marks.map((m) => m.label).join('\n') };
+}
+/**
+ * Counts the items in one category that carry at least one mark.
+ *
+ * Items, not marks: a component with three findings is one thing to look at,
+ * and a group head reading "3" for a single broken component would overstate
+ * the work.
+ *
+ * Takes each item's already-resolved `ItemDecorations` rather than the raw
+ * items — callers already run `decorateItem` once per item to render its
+ * marks, and recomputing it here would both waste the work and let the
+ * roll-up drift from what actually renders.
+ */
+export function rollupCategory(decorations) {
+    let problems = 0;
+    let variant = null;
+    for (const decoration of decorations) {
+        if (!decoration)
+            continue;
+        problems++;
+        if (!variant || SEVERITY[decoration.worst] > SEVERITY[variant]) {
+            variant = decoration.worst;
+        }
+    }
+    return { problems, variant };
+}
+/**
+ * The left icon slot carries lifecycle — what the author declared — in form
+ * alone. Colour in the sidebar means exactly one thing, measured quality, so a
+ * work-in-progress component must never look like a finding.
+ */
+export function lifecycleIcon(status) {
+    return status === 'wip' ? 'box-select' : 'box';
+}

package/dist/app/sidebar/prism-sidebar.component.d.ts

@@ -2,16 +2,30 @@ import type { NavigationItem } from '../services/navigation-item.types.js';
 import { PrismNavigationService } from '../services/prism-navigation.service.js';
 import { PrismSearchService } from '../services/prism-search.service.js';
 import type { ComponentStatus } from '../../decorator/showcase.types.js';
+import { type CategoryRollup, type ItemDecorations } from './navigation-decorations.js';
 import * as i0 from "@angular/core";
 interface SidebarCategory {
     name: string;
     color: string;
     items: NavigationItem[];
 }
+interface SidebarItem {
+    item: NavigationItem;
+    icon: string;
+    decorations: ItemDecorations | null;
+}
+interface ComponentCategory {
+    name: string;
+    color: string;
+    items: SidebarItem[];
+    rollup: CategoryRollup;
+}
 export declare class PrismSidebarComponent {
     protected readonly navigationService: PrismNavigationService;
     protected readonly searchService: PrismSearchService;
+    private readonly pluginService;
     private readonly filterInput;
+    private readonly decorations;
     protected onGlobalKey(e: KeyboardEvent): void;
     private readonly collapsedSet;
     protected readonly totalPages: import("@angular/core").Signal<number>;
@@ -21,18 +35,21 @@ export declare class PrismSidebarComponent {
         icon: string;
         color: string;
         totalCount: number;
-        categories: {
-            name: string;
-            color: string;
-            items: NavigationItem[];
-        }[];
+        categories: ComponentCategory[];
     }[]>;
     protected isCollapsed(key: string): boolean;
     protected toggleCollapse(key: string): void;
     protected itemKey(item: NavigationItem): string;
     protected itemLabel(item: NavigationItem): string;
     protected itemStatus(item: NavigationItem): ComponentStatus | undefined;
-    protected itemTooltip(item: NavigationItem): string | null;
+    /**
+     * Accessible name for the roll-up pill. The pill otherwise renders a bare
+     * number distinguished only by colour — a screen reader would read the
+     * group head as "Feedback 3 12" with nothing naming what either number
+     * means, and a colour-blind reader can't tell them apart at all.
+     */
+    protected rollupTooltip(rollup: CategoryRollup): string;
+    protected itemTooltip(item: NavigationItem, decorations: ItemDecorations | null): string | null;
     protected isActive(item: NavigationItem): boolean;
     protected onSelect(item: NavigationItem): void;
     private loadCollapsed;