@ng-prism/core 21.0.0

package/dist/builder/scanner/scanner.d.ts

@@ -0,0 +1,16 @@
+import ts from 'typescript';
+import type { PrismManifest } from '../../plugin/plugin.types.js';
+export interface CreateScannerOptions {
+    entryPoint: string;
+    compilerOptions?: ts.CompilerOptions;
+}
+export interface Scanner {
+    /** Scan the entry point. Reuses TypeScript program state from previous scans. */
+    scan(): PrismManifest;
+}
+/**
+ * Create a stateful scanner that retains the previous ts.Program between scans.
+ * TypeScript reuses parsed SourceFile objects from the old program, making incremental scans fast.
+ */
+export declare function createScanner(options: CreateScannerOptions): Scanner;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/builder/scanner/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/scanner/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,OAAO;IACtB,iFAAiF;IACjF,IAAI,IAAI,aAAa,CAAC;CACvB;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAmBpE"}

package/dist/builder/scanner/scanner.js

@@ -0,0 +1,28 @@
+import ts from 'typescript';
+import { resolveEntryPointExports } from './entry-point.scanner.js';
+import { scanComponents } from './component.scanner.js';
+const DEFAULT_COMPILER_OPTIONS = {
+    target: ts.ScriptTarget.ES2022,
+    module: ts.ModuleKind.ES2022,
+    moduleResolution: ts.ModuleResolutionKind.Node10,
+    experimentalDecorators: true,
+    strict: true,
+    skipLibCheck: true,
+};
+/**
+ * Create a stateful scanner that retains the previous ts.Program between scans.
+ * TypeScript reuses parsed SourceFile objects from the old program, making incremental scans fast.
+ */
+export function createScanner(options) {
+    const compilerOptions = { ...DEFAULT_COMPILER_OPTIONS, ...options.compilerOptions };
+    let previousProgram;
+    return {
+        scan() {
+            const { program, exports } = resolveEntryPointExports(options.entryPoint, compilerOptions, previousProgram);
+            previousProgram = program;
+            const checker = program.getTypeChecker();
+            const components = scanComponents(exports, checker);
+            return { components };
+        },
+    };
+}

package/dist/builder/serve/index.d.ts

@@ -0,0 +1,6 @@
+import { type Builder } from '@angular-devkit/architect';
+import type { json } from '@angular-devkit/core';
+import type { ServeBuilderSchema } from './schema.js';
+declare const builder: Builder<ServeBuilderSchema & json.JsonObject>;
+export default builder;
+//# sourceMappingURL=index.d.ts.map

package/dist/builder/serve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAA2C,MAAM,2BAA2B,CAAC;AACjH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA0DtD,QAAA,MAAM,OAAO,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAyD,CAAC;AACrH,eAAe,OAAO,CAAC"}

package/dist/builder/serve/index.js

@@ -0,0 +1,48 @@
+import { createBuilder } from '@angular-devkit/architect';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { runPrismPipeline, createPipelineState } from '../shared/prism-pipeline.js';
+import { startWatcher } from '../watcher/index.js';
+async function createServeBuilder(options, context) {
+    const pipelineOptions = {
+        entryPoint: options.entryPoint,
+        libraryImportPath: options.libraryImportPath ?? options.libraryProject ?? options.prismProject,
+        prismProject: options.prismProject,
+        configFile: options.configFile ?? 'ng-prism.config.ts',
+    };
+    const state = createPipelineState();
+    await runPrismPipeline(pipelineOptions, context, state);
+    const absoluteEntryPoint = join(context.workspaceRoot, options.entryPoint);
+    const configFilePath = join(context.workspaceRoot, pipelineOptions.configFile);
+    const absolutePrismProject = join(context.workspaceRoot, options.prismProject);
+    const watcher = startWatcher({
+        entryPoint: absoluteEntryPoint,
+        configFile: existsSync(configFilePath) ? configFilePath : undefined,
+        ignorePaths: [absolutePrismProject],
+        debounceMs: 50,
+        onRebuild: async () => {
+            await runPrismPipeline(pipelineOptions, context, state);
+        },
+        logger: {
+            info: (msg) => console.log(msg),
+            error: (msg) => console.error(msg),
+        },
+    });
+    const run = await context.scheduleTarget({ project: options.prismProject, target: 'serve', configuration: '' }, { port: options.port ?? 4400 });
+    const shutdown = () => {
+        watcher.close();
+        run.stop();
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    return new Promise((resolve, reject) => {
+        let lastOutput;
+        run.output.subscribe({
+            next: (output) => { lastOutput = output; },
+            error: (err) => { shutdown(); reject(err); },
+            complete: () => { watcher.close(); resolve(lastOutput ?? { success: false }); },
+        });
+    });
+}
+const builder = createBuilder(createServeBuilder);
+export default builder;

package/dist/builder/serve/schema.d.ts

@@ -0,0 +1,9 @@
+export interface ServeBuilderSchema {
+    entryPoint: string;
+    prismProject: string;
+    libraryProject?: string;
+    port?: number;
+    libraryImportPath?: string;
+    configFile?: string;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/builder/serve/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/builder/serve/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/builder/serve/schema.js

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

package/dist/builder/shared/index.d.ts

@@ -0,0 +1,3 @@
+export { runPrismPipeline, createPipelineState } from './prism-pipeline.js';
+export type { PrismPipelineOptions, PrismPipelineResult, PrismPipelineState } from './prism-pipeline.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builder/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/builder/shared/index.js

@@ -0,0 +1 @@
+export { runPrismPipeline, createPipelineState } from './prism-pipeline.js';

package/dist/builder/shared/prism-pipeline.d.ts

@@ -0,0 +1,21 @@
+import type { BuilderContext } from '@angular-devkit/architect';
+import { type Scanner } from '../scanner/scanner.js';
+export interface PrismPipelineOptions {
+    entryPoint: string;
+    libraryImportPath: string;
+    prismProject: string;
+    configFile: string;
+}
+export interface PrismPipelineResult {
+    manifestPath: string;
+    componentCount: number;
+    pageCount: number;
+    /** True if the manifest file was actually written; false if the existing content was identical. */
+    written: boolean;
+}
+export interface PrismPipelineState {
+    scanners: Map<string, Scanner>;
+}
+export declare function createPipelineState(): PrismPipelineState;
+export declare function runPrismPipeline(options: PrismPipelineOptions, context: BuilderContext, state: PrismPipelineState): Promise<PrismPipelineResult>;
+//# sourceMappingURL=prism-pipeline.d.ts.map

package/dist/builder/shared/prism-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prism-pipeline.d.ts","sourceRoot":"","sources":["../../../src/builder/shared/prism-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMpE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAmD9B"}

package/dist/builder/shared/prism-pipeline.js

@@ -0,0 +1,95 @@
+import { join } from 'path';
+import { writeFileSync, readFileSync, mkdirSync, statSync, renameSync, existsSync, unlinkSync } from 'fs';
+import { createScanner } from '../scanner/scanner.js';
+import { discoverSecondaryEntryPoints } from '../scanner/entry-point-discovery.js';
+import { loadConfig } from '../config-loader/config-loader.js';
+import { runPluginHooks } from '../plugin-runner/plugin-runner.js';
+import { generateRuntimeManifest } from '../manifest/runtime-manifest.generator.js';
+export function createPipelineState() {
+    return { scanners: new Map() };
+}
+export async function runPrismPipeline(options, context, state) {
+    const { workspaceRoot } = context;
+    context.reportStatus('Loading ng-prism config...');
+    const config = await loadConfig({
+        workspaceRoot,
+        configFileName: options.configFile,
+    });
+    context.reportStatus('Scanning components...');
+    const scanResult = scanEntryPoints(workspaceRoot, options, state);
+    const pages = config.pages ? [...config.pages] : [];
+    context.reportStatus('Running plugin hooks...');
+    const manifest = await runPluginHooks({ ...scanResult, pages }, config.plugins ?? []);
+    context.reportStatus('Generating runtime manifest...');
+    const source = generateRuntimeManifest({
+        components: manifest.components,
+        libraryImportPath: options.libraryImportPath,
+        pages: manifest.pages,
+    });
+    const projectMeta = await context.getProjectMetadata(options.prismProject);
+    const sourceRoot = projectMeta['sourceRoot']
+        ?? join('projects', options.prismProject, 'src');
+    const manifestPath = join(workspaceRoot, sourceRoot, 'prism-manifest.ts');
+    mkdirSync(join(workspaceRoot, sourceRoot), { recursive: true });
+    const written = writeManifestIfChanged(manifestPath, source);
+    const pageCount = (manifest.pages ?? []).length;
+    context.reportStatus('');
+    context.logger.info(`ng-prism: ${written ? 'Generated' : 'Verified (unchanged)'} manifest ` +
+        `with ${manifest.components.length} component(s)` +
+        (pageCount > 0 ? ` and ${pageCount} page(s)` : '') +
+        ` → ${manifestPath}`);
+    return {
+        manifestPath,
+        componentCount: manifest.components.length,
+        pageCount,
+        written,
+    };
+}
+function writeManifestIfChanged(manifestPath, newContent) {
+    if (existsSync(manifestPath)) {
+        const currentContent = readFileSync(manifestPath, 'utf-8');
+        if (currentContent === newContent) {
+            return false;
+        }
+    }
+    const tempPath = manifestPath + '.tmp';
+    writeFileSync(tempPath, newContent, 'utf-8');
+    if (existsSync(manifestPath)) {
+        unlinkSync(manifestPath);
+    }
+    renameSync(tempPath, manifestPath);
+    return true;
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function scanEntryPoints(workspaceRoot, options, state) {
+    const absoluteEntryPoint = join(workspaceRoot, options.entryPoint);
+    if (!isDirectory(absoluteEntryPoint)) {
+        return getOrCreateScanner(state, absoluteEntryPoint).scan();
+    }
+    const entryPoints = discoverSecondaryEntryPoints(absoluteEntryPoint, options.libraryImportPath);
+    const allComponents = [];
+    for (const ep of entryPoints) {
+        const scanner = getOrCreateScanner(state, ep.entryFile);
+        const result = scanner.scan();
+        for (const comp of result.components) {
+            comp.importPath = ep.importPath;
+            allComponents.push(comp);
+        }
+    }
+    return { components: allComponents };
+}
+function getOrCreateScanner(state, entryFile) {
+    let scanner = state.scanners.get(entryFile);
+    if (!scanner) {
+        scanner = createScanner({ entryPoint: entryFile });
+        state.scanners.set(entryFile, scanner);
+    }
+    return scanner;
+}

package/dist/builder/token-scanner/index.d.ts

@@ -0,0 +1,2 @@
+export { parseTokenFile, detectVisualization, scanTokens, type ScanTokensOptions } from './token-scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builder/token-scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/token-scanner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/builder/token-scanner/index.js

@@ -0,0 +1 @@
+export { parseTokenFile, detectVisualization, scanTokens } from './token-scanner.js';

package/dist/builder/token-scanner/token-scanner.d.ts

@@ -0,0 +1,9 @@
+import type { DesignTokenGroup, TokenVisualization } from '../../plugin/page.types.js';
+export interface ScanTokensOptions {
+    patterns: string[];
+    workspaceRoot: string;
+}
+export declare function detectVisualization(value: string): TokenVisualization;
+export declare function parseTokenFile(content: string, filePath: string): DesignTokenGroup[];
+export declare function scanTokens(options: ScanTokensOptions): DesignTokenGroup[];
+//# sourceMappingURL=token-scanner.d.ts.map

package/dist/builder/token-scanner/token-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-scanner.d.ts","sourceRoot":"","sources":["../../../src/builder/token-scanner/token-scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAerE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA0DpF;AAsBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,CAazE"}

package/dist/builder/token-scanner/token-scanner.js

@@ -0,0 +1,95 @@
+import { readFileSync } from 'fs';
+import { globSync } from 'glob';
+export function detectVisualization(value) {
+    const trimmed = value.trim();
+    if (/^#([0-9a-fA-F]{3,8})$/.test(trimmed))
+        return 'color';
+    if (/^rgba?\s*\(/.test(trimmed))
+        return 'color';
+    if (/^hsla?\s*\(/.test(trimmed))
+        return 'color';
+    if (/^\d+(\.\d+)?\s*(px|rem|em|%)$/.test(trimmed))
+        return 'spacing';
+    if (/\d+\s*px\s+\d+\s*px\s+.*rgba?\s*\(/.test(trimmed))
+        return 'shadow';
+    if (/^0\s+\d/.test(trimmed) && /rgba?\s*\(/.test(trimmed))
+        return 'shadow';
+    if (/['"][^'"]+['"]/.test(trimmed) && /sans-serif|serif|monospace|system-ui/.test(trimmed))
+        return 'typography';
+    return 'raw';
+}
+export function parseTokenFile(content, filePath) {
+    const groups = [];
+    let current = null;
+    let nextTypeOverride = null;
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        const prismMatch = trimmed.match(/^\/\/\s*@prism\s+(.+)$/);
+        if (prismMatch) {
+            current = {
+                title: prismMatch[1].trim(),
+                filePath,
+                tokens: [],
+            };
+            groups.push(current);
+            nextTypeOverride = null;
+            continue;
+        }
+        if (!current)
+            continue;
+        const descMatch = trimmed.match(/^\/\/\s*@description\s+(.+)$/);
+        if (descMatch) {
+            current.description = descMatch[1].trim();
+            continue;
+        }
+        const catMatch = trimmed.match(/^\/\/\s*@category\s+(.+)$/);
+        if (catMatch) {
+            current.category = catMatch[1].trim();
+            continue;
+        }
+        const typeMatch = trimmed.match(/^\/\/\s*@type\s+(\w+)$/);
+        if (typeMatch) {
+            nextTypeOverride = typeMatch[1];
+            continue;
+        }
+        const scssMatch = trimmed.match(/^(\$[\w-]+)\s*:\s*(.+?)\s*(!default\s*)?;(.*)$/);
+        if (scssMatch) {
+            const token = buildToken(scssMatch[1], scssMatch[2], scssMatch[4], nextTypeOverride);
+            current.tokens.push(token);
+            nextTypeOverride = null;
+            continue;
+        }
+        const cssMatch = trimmed.match(/^(--[\w-]+)\s*:\s*(.+?)\s*;(.*)$/);
+        if (cssMatch) {
+            const token = buildToken(cssMatch[1], cssMatch[2], cssMatch[3], nextTypeOverride);
+            current.tokens.push(token);
+            nextTypeOverride = null;
+            continue;
+        }
+    }
+    return groups;
+}
+function buildToken(name, value, trailingComment, typeOverride) {
+    const token = {
+        name,
+        value: value.trim(),
+        visualization: typeOverride ?? detectVisualization(value),
+    };
+    const commentMatch = trailingComment?.match(/\/\/\s*(.+)$/);
+    if (commentMatch) {
+        token.description = commentMatch[1].trim();
+    }
+    return token;
+}
+export function scanTokens(options) {
+    const { patterns, workspaceRoot } = options;
+    const groups = [];
+    for (const pattern of patterns) {
+        const files = globSync(pattern, { cwd: workspaceRoot, absolute: true });
+        for (const file of files) {
+            const content = readFileSync(file, 'utf-8');
+            groups.push(...parseTokenFile(content, file));
+        }
+    }
+    return groups;
+}

package/dist/builder/watcher/index.d.ts

@@ -0,0 +1,3 @@
+export { createChangeHandler, startWatcher } from './prism-watcher.js';
+export type { ChangeHandler, ChangeHandlerOptions, WatcherHandle, StartWatcherOptions } from './prism-watcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builder/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/builder/watcher/index.js

@@ -0,0 +1 @@
+export { createChangeHandler, startWatcher } from './prism-watcher.js';

package/dist/builder/watcher/prism-watcher.d.ts

@@ -0,0 +1,29 @@
+export interface ChangeHandlerOptions {
+    onRebuild: () => Promise<void>;
+    logger: {
+        info(msg: string): void;
+        error(msg: string): void;
+    };
+    debounceMs?: number;
+}
+export interface ChangeHandler {
+    handleChange(filename: string | null): void;
+    dispose(): void;
+}
+export interface WatcherHandle {
+    close(): void;
+}
+export interface StartWatcherOptions {
+    entryPoint: string;
+    configFile?: string;
+    ignorePaths?: string[];
+    onRebuild: () => Promise<void>;
+    logger: {
+        info(msg: string): void;
+        error(msg: string): void;
+    };
+    debounceMs?: number;
+}
+export declare function createChangeHandler(options: ChangeHandlerOptions): ChangeHandler;
+export declare function startWatcher(options: StartWatcherOptions): WatcherHandle;
+//# sourceMappingURL=prism-watcher.d.ts.map

package/dist/builder/watcher/prism-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prism-watcher.d.ts","sourceRoot":"","sources":["../../../src/builder/watcher/prism-watcher.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0ChF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAkCxE"}

package/dist/builder/watcher/prism-watcher.js

@@ -0,0 +1,79 @@
+import chokidar from 'chokidar';
+import { dirname } from 'path';
+import { statSync } from 'fs';
+export function createChangeHandler(options) {
+    const { onRebuild, logger, debounceMs = 300 } = options;
+    let timer = null;
+    let isRebuilding = false;
+    let disposed = false;
+    function handleChange(filename) {
+        if (disposed)
+            return;
+        if (filename && !/\.(ts|scss|css|svg)$/.test(filename))
+            return;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(async () => {
+            if (disposed || isRebuilding)
+                return;
+            isRebuilding = true;
+            logger.info('ng-prism: Change detected, re-scanning...');
+            try {
+                await onRebuild();
+                if (!disposed) {
+                    logger.info('ng-prism: Re-scan complete.');
+                }
+            }
+            catch (err) {
+                if (!disposed) {
+                    logger.error(`ng-prism: Re-scan failed — ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            finally {
+                isRebuilding = false;
+            }
+        }, debounceMs);
+    }
+    function dispose() {
+        disposed = true;
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    }
+    return { handleChange, dispose };
+}
+export function startWatcher(options) {
+    const { entryPoint, configFile, ignorePaths, onRebuild, logger, debounceMs } = options;
+    const handler = createChangeHandler({ onRebuild, logger, debounceMs });
+    const isDir = (() => { try {
+        return statSync(entryPoint).isDirectory();
+    }
+    catch {
+        return false;
+    } })();
+    const watchPaths = [isDir ? entryPoint : dirname(entryPoint)];
+    if (configFile) {
+        watchPaths.push(configFile);
+    }
+    const ignorePatterns = [/(?:^|[/\\])(?:node_modules|\.git)[/\\]/];
+    if (ignorePaths) {
+        ignorePatterns.push(...ignorePaths);
+    }
+    const watcher = chokidar.watch(watchPaths, {
+        ignored: ignorePatterns,
+        ignoreInitial: true,
+        persistent: true,
+    });
+    watcher.on('change', (filePath) => handler.handleChange(filePath));
+    watcher.on('add', (filePath) => handler.handleChange(filePath));
+    watcher.on('unlink', (filePath) => handler.handleChange(filePath));
+    watcher.on('error', (err) => logger.error(`ng-prism: Watcher error — ${err instanceof Error ? err.message : String(err)}`));
+    logger.info(`ng-prism: Watching ${watchPaths.join(', ')} for changes...`);
+    return {
+        close() {
+            handler.dispose();
+            watcher.close();
+        },
+    };
+}

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+export { defineConfig } from '../plugin/define-config.js';
+export { customPage, componentPage } from '../plugin/page-helpers.js';
+export type { ComponentPageOptions } from '../plugin/page-helpers.js';
+export type { NgPrismConfig, NgPrismPlugin } from '../plugin/plugin.types.js';
+export type { StyleguidePage, CustomPage, ComponentPage } from '../plugin/page.types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { defineConfig } from '../plugin/define-config.js';
+export { customPage, componentPage } from '../plugin/page-helpers.js';

package/dist/decorator/index.d.ts

@@ -0,0 +1,3 @@
+export type { ShowcaseConfig, Variant } from './showcase.types.js';
+export { Showcase } from './showcase.decorator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorator/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/decorator/index.js

@@ -0,0 +1 @@
+export { Showcase } from './showcase.decorator.js';

package/dist/decorator/showcase.decorator.d.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+import type { ShowcaseConfig } from './showcase.types.js';
+export declare const SHOWCASE_METADATA_KEY = "ngPrism:config";
+export declare function Showcase(config: ShowcaseConfig): ClassDecorator;
+//# sourceMappingURL=showcase.decorator.d.ts.map

package/dist/decorator/showcase.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase.decorator.d.ts","sourceRoot":"","sources":["../../src/decorator/showcase.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAI/D"}

package/dist/decorator/showcase.decorator.js

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+export const SHOWCASE_METADATA_KEY = 'ngPrism:config';
+export function Showcase(config) {
+    return (target) => {
+        Reflect.defineMetadata(SHOWCASE_METADATA_KEY, config, target);
+    };
+}

package/dist/decorator/showcase.types.d.ts

@@ -0,0 +1,54 @@
+import type { Provider } from '@angular/core';
+export interface DirectiveHost {
+    selector: string;
+    import: {
+        name: string;
+        from: string;
+    };
+    inputs?: Record<string, unknown>;
+}
+export interface ShowcaseConfig {
+    /** Display name in the ng-prism UI */
+    title: string;
+    /** Description text — Markdown supported */
+    description?: string;
+    /** Groups the component in the sidebar */
+    category?: string;
+    /** Controls the order of this category in the sidebar (lower = higher). Categories without this sort alphabetically after ordered ones. */
+    categoryOrder?: number;
+    /** Controls the order of this component within its category (lower = higher). Components without this sort alphabetically after ordered ones. */
+    componentOrder?: number;
+    /** Predefined variants shown as tabs */
+    variants?: Variant[];
+    /** Tags for search and filtering */
+    tags?: string[];
+    /**
+     * Providers for a child injector scoped to this component.
+     * Use for components that require specific services (e.g. DialogService, OverlayService).
+     * For library-wide providers, use defineConfig({ appProviders }).
+     */
+    providers?: Provider[];
+    /** Arbitrary metadata for plugins (e.g. { figma: 'https://...' }) */
+    meta?: Record<string, unknown>;
+    /** Host element for directive showcases. String = HTML element (e.g. '<button class="btn">'), object = Angular component. */
+    host?: string | DirectiveHost;
+    /** Title of a registered ComponentPage to render instead of the component itself. Use for complex components that need template projections or mock data. The page component can inject PrismRendererService to react to control panel changes. */
+    renderPage?: string;
+}
+export interface Variant {
+    /** Tab label */
+    name: string;
+    /** @Input() values for this variant */
+    inputs?: Record<string, unknown>;
+    /**
+     * Content projected into <ng-content>.
+     * - string → projected into the default (unnamed) slot
+     * - Record<string, string> → keys are slot selectors (e.g. '[card-header]'), 'default' is the unnamed slot
+     */
+    content?: string | Record<string, string>;
+    /** Optional description for this variant */
+    description?: string;
+    /** Arbitrary metadata for plugins (e.g. { figma: 'https://...?node-id=12-34' }) */
+    meta?: Record<string, unknown>;
+}
+//# sourceMappingURL=showcase.types.d.ts.map

package/dist/decorator/showcase.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase.types.d.ts","sourceRoot":"","sources":["../../src/decorator/showcase.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2IAA2I;IAC3I,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iJAAiJ;IACjJ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,6HAA6H;IAC7H,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IAC9B,mPAAmP;IACnP,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/decorator/showcase.types.js

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './decorator/index.js';
+export * from './plugin/index.js';
+export * from './app/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AAGrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Public API — decorator
+export * from './decorator/index.js';
+// Public API — plugin
+export * from './plugin/index.js';
+// Public API — app (styleguide)
+export * from './app/index.js';

package/dist/plugin/define-config.d.ts

@@ -0,0 +1,4 @@
+import type { NgPrismConfig } from './plugin.types.js';
+/** Identity helper for TypeScript type safety on ng-prism.config.ts */
+export declare function defineConfig(config: NgPrismConfig): NgPrismConfig;
+//# sourceMappingURL=define-config.d.ts.map