@ng-prism/core 21.12.0-beta.0 → 21.12.0-beta.2

package/dist/cli/audit-a11y/aggregator.js

@@ -0,0 +1,64 @@
+export function aggregateAuditResults(results) {
+    if (results.length === 0) {
+        return {
+            total: {
+                score: 100,
+                violations: 0,
+                critical: 0,
+                serious: 0,
+                moderate: 0,
+                minor: 0,
+                passes: 0,
+                incomplete: 0,
+                auditedComponents: 0,
+                auditedVariants: 0,
+            },
+            components: {},
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    const byComponent = new Map();
+    for (const r of results) {
+        const list = byComponent.get(r.className) ?? [];
+        list.push(r.score);
+        byComponent.set(r.className, list);
+    }
+    const componentBreakdown = {};
+    for (const [className, scores] of byComponent) {
+        componentBreakdown[className] = averageScore(scores);
+    }
+    const all = results.map((r) => r.score);
+    const total = averageScore(all);
+    return {
+        total: {
+            ...total,
+            // Sum (not average) of violation counts — they aggregate across the library.
+            violations: sum(all, (s) => s.violations),
+            critical: sum(all, (s) => s.critical),
+            serious: sum(all, (s) => s.serious),
+            moderate: sum(all, (s) => s.moderate),
+            minor: sum(all, (s) => s.minor),
+            auditedComponents: byComponent.size,
+            auditedVariants: results.length,
+        },
+        components: componentBreakdown,
+        generatedAt: new Date().toISOString(),
+    };
+}
+function averageScore(scores) {
+    const n = scores.length;
+    const sumF = (sel) => scores.reduce((acc, s) => acc + sel(s), 0);
+    return {
+        score: Math.round(sumF((s) => s.score) / n),
+        violations: Math.round(sumF((s) => s.violations) / n),
+        critical: Math.round(sumF((s) => s.critical) / n),
+        serious: Math.round(sumF((s) => s.serious) / n),
+        moderate: Math.round(sumF((s) => s.moderate) / n),
+        minor: Math.round(sumF((s) => s.minor) / n),
+        passes: Math.round(sumF((s) => s.passes) / n),
+        incomplete: Math.round(sumF((s) => s.incomplete) / n),
+    };
+}
+function sum(scores, sel) {
+    return scores.reduce((acc, s) => acc + sel(s), 0);
+}

package/dist/cli/audit-a11y/auditor.d.ts

@@ -0,0 +1,14 @@
+import type { RawAuditResult } from './aggregator.js';
+export interface AuditOptions {
+    baseUrl: string;
+    /** Component class names to limit the audit to. Empty = all. */
+    include?: string[];
+    /** Component class names to skip. */
+    exclude?: string[];
+    /** Per-page navigation/render timeout in ms. Default 10_000. */
+    timeoutMs?: number;
+    /** Logger for progress output. */
+    log?: (msg: string) => void;
+}
+export declare function auditPrismApp(opts: AuditOptions): Promise<RawAuditResult[]>;
+//# sourceMappingURL=auditor.d.ts.map

package/dist/cli/audit-a11y/auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["../../../src/cli/audit-a11y/auditor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAyGjF"}

package/dist/cli/audit-a11y/auditor.js

@@ -0,0 +1,104 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export async function auditPrismApp(opts) {
+    const log = opts.log ?? (() => undefined);
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    const playwright = await loadPlaywright();
+    const axeSource = loadAxeSource();
+    const browser = await playwright.chromium.launch({ headless: true });
+    try {
+        const context = await browser.newContext();
+        const page = await context.newPage();
+        await page.goto(opts.baseUrl, { waitUntil: 'networkidle', timeout: timeoutMs });
+        await page.waitForFunction(() => globalThis['__PRISM_MANIFEST__'] !== undefined, undefined, { timeout: timeoutMs });
+        const manifest = (await page.evaluate(() => globalThis['__PRISM_MANIFEST__']));
+        const targets = manifest.components.filter((c) => {
+            if (opts.include?.length && !opts.include.includes(c.className))
+                return false;
+            if (opts.exclude?.length && opts.exclude.includes(c.className))
+                return false;
+            return true;
+        });
+        const results = [];
+        for (const comp of targets) {
+            for (const variant of comp.variants) {
+                const url = new URL(opts.baseUrl);
+                url.searchParams.set('component', comp.className);
+                if (variant.index > 0) {
+                    url.searchParams.set('variant', String(variant.index));
+                }
+                log(`Auditing ${comp.className} :: ${variant.name} (#${variant.index})`);
+                await page.goto(url.toString(), { waitUntil: 'load', timeout: timeoutMs });
+                await page.waitForFunction(([expected]) => {
+                    const el = document.querySelector('.demo-wrap');
+                    const key = el?.getAttribute('data-prism-rendered');
+                    return typeof key === 'string' && key.startsWith(expected);
+                }, [`${comp.className}:`], { timeout: timeoutMs });
+                await page.addScriptTag({ content: axeSource });
+                const score = (await page.evaluate(async () => {
+                    const target = document.querySelector('.demo-wrap');
+                    const axe = globalThis['axe'];
+                    if (!target) {
+                        return {
+                            score: 0,
+                            violations: 0,
+                            critical: 0,
+                            serious: 0,
+                            moderate: 0,
+                            minor: 0,
+                            passes: 0,
+                            incomplete: 0,
+                        };
+                    }
+                    const r = await axe.run(target);
+                    const critical = r.violations.filter((v) => v.impact === 'critical').length;
+                    const serious = r.violations.filter((v) => v.impact === 'serious').length;
+                    const moderate = r.violations.filter((v) => v.impact === 'moderate').length;
+                    const minor = r.violations.filter((v) => v.impact === 'minor').length;
+                    const deductions = critical * 25 + serious * 10 + moderate * 5 + minor * 1;
+                    return {
+                        score: Math.max(0, 100 - deductions),
+                        violations: r.violations.length,
+                        critical,
+                        serious,
+                        moderate,
+                        minor,
+                        passes: r.passes.length,
+                        incomplete: r.incomplete.length,
+                    };
+                }));
+                results.push({
+                    className: comp.className,
+                    variantName: variant.name,
+                    variantIndex: variant.index,
+                    score,
+                });
+            }
+        }
+        return results;
+    }
+    finally {
+        await browser.close();
+    }
+}
+async function loadPlaywright() {
+    try {
+        return (await import('playwright'));
+    }
+    catch (err) {
+        throw new Error('ng-prism-audit-a11y: `playwright` is not installed. Run `npm install --save-dev playwright` ' +
+            'and `npx playwright install chromium`. Original error: ' +
+            (err instanceof Error ? err.message : String(err)));
+    }
+}
+function loadAxeSource() {
+    try {
+        const path = require.resolve('axe-core/axe.min.js');
+        return require('node:fs').readFileSync(path, 'utf-8');
+    }
+    catch (err) {
+        throw new Error('ng-prism-audit-a11y: `axe-core` is not installed. Run `npm install --save-dev axe-core`. ' +
+            'Original error: ' +
+            (err instanceof Error ? err.message : String(err)));
+    }
+}

package/dist/cli/audit-a11y/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli/audit-a11y/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/audit-a11y/cli.ts"],"names":[],"mappings":""}

package/dist/cli/audit-a11y/cli.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { aggregateAuditResults } from './aggregator.js';
+import { auditPrismApp } from './auditor.js';
+import { startStaticServer } from './static-server.js';
+import { checkA11yThresholds, } from '../../builder/a11y/a11y-report-reader.js';
+import { resolveA11yThresholds } from '../../app/panels/a11y/a11y-thresholds.js';
+function parseArgs(argv) {
+    const args = {
+        dist: '',
+        output: 'a11y-report.json',
+        port: 4317,
+        thresholds: {},
+        include: [],
+        exclude: [],
+        failOnViolation: true,
+    };
+    for (let i = 2; i < argv.length; i++) {
+        const a = argv[i];
+        const next = () => {
+            const v = argv[++i];
+            if (v === undefined) {
+                throw new Error(`Missing value for ${a}`);
+            }
+            return v;
+        };
+        switch (a) {
+            case '--dist':
+                args.dist = next();
+                break;
+            case '--output':
+            case '-o':
+                args.output = next();
+                break;
+            case '--port':
+                args.port = parseInt(next(), 10);
+                break;
+            case '--include':
+                args.include = next().split(',').map((s) => s.trim()).filter(Boolean);
+                break;
+            case '--exclude':
+                args.exclude = next().split(',').map((s) => s.trim()).filter(Boolean);
+                break;
+            case '--score':
+                args.thresholds.score = parseInt(next(), 10);
+                break;
+            case '--max-critical':
+                args.thresholds.critical = parseInt(next(), 10);
+                break;
+            case '--max-serious':
+                args.thresholds.serious = parseInt(next(), 10);
+                break;
+            case '--max-moderate':
+                args.thresholds.moderate = parseInt(next(), 10);
+                break;
+            case '--no-fail':
+                args.failOnViolation = false;
+                break;
+            case '-h':
+            case '--help':
+                printHelp();
+                process.exit(0);
+            default:
+                throw new Error(`Unknown argument: ${a}`);
+        }
+    }
+    if (!args.dist) {
+        throw new Error('Missing required --dist <path-to-built-prism-app>');
+    }
+    return args;
+}
+function printHelp() {
+    process.stdout.write(`ng-prism-audit-a11y — accessibility audit for a built Prism app.\n\n` +
+        `Usage:\n` +
+        `  ng-prism-audit-a11y --dist <path> [options]\n\n` +
+        `Required:\n` +
+        `  --dist <path>          Path to the built Prism app (contains index.html)\n\n` +
+        `Output:\n` +
+        `  --output <file>        Report output path (default: a11y-report.json)\n\n` +
+        `Server:\n` +
+        `  --port <n>             Static server port (default: 4317)\n\n` +
+        `Filtering:\n` +
+        `  --include A,B          Only audit these component class names\n` +
+        `  --exclude A,B          Skip these component class names\n\n` +
+        `Thresholds (CI failure):\n` +
+        `  --score <n>            Minimum avg score (default 80)\n` +
+        `  --max-critical <n>     Allowed critical violations (default 0)\n` +
+        `  --max-serious <n>      Allowed serious violations (default 0)\n` +
+        `  --max-moderate <n>     Allowed moderate violations (default unlimited)\n` +
+        `  --no-fail              Write report but never exit non-zero\n\n`);
+}
+async function main() {
+    const args = parseArgs(process.argv);
+    const server = await startStaticServer(args.dist, args.port);
+    process.stdout.write(`Serving ${args.dist} at ${server.url}\n`);
+    try {
+        const rawResults = await auditPrismApp({
+            baseUrl: server.url,
+            include: args.include,
+            exclude: args.exclude,
+            log: (msg) => process.stdout.write(`  ${msg}\n`),
+        });
+        const report = aggregateAuditResults(rawResults);
+        const resolvedThresholds = resolveA11yThresholds(args.thresholds);
+        const outputPath = resolve(args.output);
+        writeFileSync(outputPath, JSON.stringify(report, null, 2), 'utf-8');
+        process.stdout.write(`\nReport written: ${outputPath}\n`);
+        process.stdout.write(`Library score: ${report.total.score}% ` +
+            `(${report.total.auditedVariants} variants across ${report.total.auditedComponents} components)\n` +
+            `Violations: ${report.total.critical} critical · ${report.total.serious} serious · ` +
+            `${report.total.moderate} moderate · ${report.total.minor} minor\n`);
+        const violations = checkA11yThresholds({
+            total: report.total,
+            thresholds: resolvedThresholds,
+        });
+        if (violations.length > 0) {
+            process.stderr.write('\nThreshold violations:\n');
+            for (const v of violations) {
+                process.stderr.write(`  - ${formatViolation(v)}\n`);
+            }
+            if (args.failOnViolation) {
+                process.exitCode = 1;
+            }
+        }
+        else {
+            process.stdout.write('\nAll thresholds met.\n');
+        }
+    }
+    finally {
+        await server.close();
+    }
+}
+function formatViolation(v) {
+    if (v.metric === 'score') {
+        return `score ${v.actual}% < ${v.threshold}%`;
+    }
+    return `${v.metric}: ${v.actual} > ${v.threshold} allowed`;
+}
+main().catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/cli/audit-a11y/index.d.ts

@@ -0,0 +1,4 @@
+export { auditPrismApp, type AuditOptions } from './auditor.js';
+export { aggregateAuditResults, type RawAuditResult } from './aggregator.js';
+export { startStaticServer, type StaticServerHandle } from './static-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/audit-a11y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/audit-a11y/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cli/audit-a11y/index.js

@@ -0,0 +1,3 @@
+export { auditPrismApp } from './auditor.js';
+export { aggregateAuditResults } from './aggregator.js';
+export { startStaticServer } from './static-server.js';

package/dist/cli/audit-a11y/static-server.d.ts

@@ -0,0 +1,11 @@
+export interface StaticServerHandle {
+    url: string;
+    port: number;
+    close(): Promise<void>;
+}
+/**
+ * Minimal static file server for Angular SPA output.
+ * Serves files relative to `root`; for unknown routes returns index.html (SPA fallback).
+ */
+export declare function startStaticServer(root: string, port: number): Promise<StaticServerHandle>;
+//# sourceMappingURL=static-server.d.ts.map

package/dist/cli/audit-a11y/static-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-server.d.ts","sourceRoot":"","sources":["../../../src/cli/audit-a11y/static-server.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8CzF"}

package/dist/cli/audit-a11y/static-server.js

@@ -0,0 +1,61 @@
+import { createServer } from 'node:http';
+import { createReadStream, existsSync, statSync } from 'node:fs';
+import { extname, join, normalize, resolve } from 'node:path';
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ico': 'image/x-icon',
+};
+/**
+ * Minimal static file server for Angular SPA output.
+ * Serves files relative to `root`; for unknown routes returns index.html (SPA fallback).
+ */
+export function startStaticServer(root, port) {
+    const absRoot = resolve(root);
+    if (!existsSync(absRoot)) {
+        return Promise.reject(new Error(`Static root does not exist: ${absRoot}`));
+    }
+    const indexPath = join(absRoot, 'index.html');
+    if (!existsSync(indexPath)) {
+        return Promise.reject(new Error(`No index.html found in ${absRoot}`));
+    }
+    const server = createServer((req, res) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        let relPath = decodeURIComponent(url.pathname);
+        if (relPath === '/' || relPath === '')
+            relPath = '/index.html';
+        const normalized = normalize(relPath).replace(/^[/\\]+/, '');
+        const filePath = join(absRoot, normalized);
+        // Path traversal guard.
+        if (!filePath.startsWith(absRoot)) {
+            res.writeHead(403).end();
+            return;
+        }
+        const target = existsSync(filePath) && statSync(filePath).isFile()
+            ? filePath
+            : indexPath;
+        const ext = extname(target).toLowerCase();
+        const mime = MIME[ext] ?? 'application/octet-stream';
+        res.writeHead(200, { 'Content-Type': mime });
+        createReadStream(target).pipe(res);
+    });
+    return new Promise((resolveFn, reject) => {
+        server.once('error', reject);
+        server.listen(port, '127.0.0.1', () => {
+            resolveFn({
+                url: `http://127.0.0.1:${port}`,
+                port,
+                close: () => new Promise((r) => server.close(() => r())),
+            });
+        });
+    });
+}

package/dist/plugin/index.d.ts

@@ -1,8 +1,8 @@
-export type { NgPrismPlugin, PanelDefinition, ControlDefinition, NgPrismConfig, PrismManifest, ScannedComponent, InputMeta, OutputMeta, RuntimeManifest, RuntimeComponent, } from './plugin.types.js';
+export type { NgPrismPlugin, PanelDefinition, ControlDefinition, HeaderWidgetDefinition, NgPrismConfig, PrismManifest, ScannedComponent, InputMeta, OutputMeta, RuntimeManifest, RuntimeComponent, } from './plugin.types.js';
 export type { StyleguidePage, CustomPage, ComponentPage, } from './page.types.js';
 export { customPage, componentPage } from './page-helpers.js';
 export type { ComponentPageOptions } from './page-helpers.js';
 export { defineConfig } from './define-config.js';
-export { PRISM_RENDERER_HOOKS } from '../app/tokens/prism-tokens.js';
+export { PRISM_RENDERER_HOOKS, PRISM_MANIFEST, PRISM_CONFIG, } from '../app/tokens/prism-tokens.js';
 export type { PrismRendererHooks } from '../app/tokens/prism-tokens.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,YAAY,GACb,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/plugin/index.js

@@ -1,3 +1,3 @@
 export { customPage, componentPage } from './page-helpers.js';
 export { defineConfig } from './define-config.js';
-export { PRISM_RENDERER_HOOKS } from '../app/tokens/prism-tokens.js';
+export { PRISM_RENDERER_HOOKS, PRISM_MANIFEST, PRISM_CONFIG, } from '../app/tokens/prism-tokens.js';

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

@@ -8,9 +8,26 @@ export interface NgPrismPlugin {
     onManifestReady?: (manifest: PrismManifest) => PrismManifest | void | Promise<PrismManifest | void>;
     panels?: PanelDefinition[];
     controls?: ControlDefinition[];
+    /** Header widgets rendered in the Prism shell header bar */
+    headerWidgets?: HeaderWidgetDefinition[];
     /** Angular standalone component that wraps each rendered component */
     wrapComponent?: Type<unknown>;
 }
+export interface HeaderWidgetDefinition {
+    /** Unique widget id — used for de-duplication and tracking. */
+    id: string;
+    /** Eager component reference. */
+    component?: Type<unknown>;
+    /**
+     * Lazy-loaded component — use when the widget pulls in browser-only or
+     * heavy dependencies that should not run at config-load time.
+     */
+    loadComponent?: () => Promise<Type<unknown>>;
+    /** Slot in the header: 'start' renders next to the brand, 'end' next to the existing actions. Default: 'end'. */
+    placement?: 'start' | 'end';
+    /** Sort order within the same placement (lower = earlier). Default: 0. */
+    order?: number;
+}
 export interface PanelDefinition {
     id: string;
     label: string;
@@ -28,6 +45,16 @@ export interface PanelDefinition {
     providers?: Provider[];
     /** When provided, the panel tab is only shown if this returns true for the active component */
     isVisible?: (component: RuntimeComponent) => boolean;
+    /**
+     * Keep the panel's component instance alive across tab switches.
+     * When `true`, the panel is rendered once on first activation and merely hidden
+     * (instead of destroyed) when the user switches tabs. Use for panels with
+     * expensive setup (iframes, network calls, heavy DOM) — e.g. embedded designs,
+     * remote previews.
+     *
+     * Default: `false`.
+     */
+    keepAlive?: boolean;
 }
 export interface ControlDefinition {
     /** Returns true if this control should handle the given input */
@@ -38,6 +65,8 @@ export interface ControlDefinition {
 export interface PrismManifest {
     components: ScannedComponent[];
     pages?: StyleguidePage[];
+    /** Library-wide plugin metadata (e.g. aggregate coverage totals). */
+    meta?: Record<string, unknown>;
 }
 export interface ScannedComponent {
     className: string;
@@ -71,6 +100,8 @@ export interface OutputMeta {
 export interface RuntimeManifest {
     components: RuntimeComponent[];
     pages?: StyleguidePage[];
+    /** Library-wide plugin metadata, mirrored from the build-time PrismManifest. */
+    meta?: Record<string, unknown>;
 }
 export interface RuntimeComponent {
     meta: ScannedComponent;
@@ -110,5 +141,7 @@ export interface NgPrismConfig {
         version?: string;
         gitHash?: string;
     };
+    /** Accessibility (build-time audit + runtime live audit) configuration. */
+    a11y?: import('../app/panels/a11y/a11y.types.js').NgPrismA11yConfig;
 }
 //# sourceMappingURL=plugin.types.d.ts.map

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

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

package/package.json

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