@uicontract/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UIC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @uicontract/core
+
+Core types, schema, validation, logger, and error classes for UIC.
+
+## Install
+
+```bash
+npm install @uicontract/core
+```
+
+## Usage
+
+```typescript
+import { type ManifestElement, validateManifest, createLogger, UicError } from '@uicontract/core';
+
+// Validate a manifest against the JSON Schema
+const result = validateManifest(manifest);
+if (!result.valid) {
+  console.error(result.errors);
+}
+
+// Create a structured logger
+const logger = createLogger({ level: 'info' });
+logger.info('Scan complete', { filesScanned: 42 });
+
+// Typed errors with code and context
+throw new UicError('MANIFEST_NOT_FOUND', {
+  message: 'No manifest.json found. Run "npx uic scan <dir>" first.',
+  path: '/my-app',
+});
+```
+
+## API
+
+- **Types**: `ManifestElement`, `RawElement`, `NamedElement`, `ParserPlugin`, `DiscoveryResult`, and more
+- **`validateManifest(manifest)`**: Validates a manifest object against the v1 JSON Schema; returns `{ valid, errors }`
+- **`createLogger(options)`**: Returns a structured logger with `debug`, `info`, `warn`, and `error` methods
+- **`UicError`**: Base error class with `code` and `context` properties for all UIC packages
+
+All shared types and interfaces live here. Framework-specific packages (`@uicontract/parser-react`, `@uicontract/parser-vue`) and the naming/annotation layers all depend on this package.
+
+## Part of UIC
+
+This package is part of [UIC (UI Contracts)](https://github.com/sherifkozman/uicontract) — making web app UIs machine-readable.
+
+## License
+
+[MIT](../../LICENSE)

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * UIC configuration loader and validator.
+ *
+ * Looks for `.uicrc.json` in the given directory and its parents,
+ * returning a typed UicConfig. Returns defaults when no file is found.
+ */
+export interface UicConfig {
+    /** ID prefixes that require explicit approval to change */
+    protectedScopes: string[];
+    /** How to handle breaking changes: "block" exits non-zero, "warn" prints warning but exits 0 */
+    breakingChangePolicy: 'block' | 'warn';
+    /** npm package names implementing the Parser interface to load at startup */
+    plugins: string[];
+}
+export declare const DEFAULT_CONFIG: UicConfig;
+/**
+ * Validate an unknown value as a UicConfig. Throws on invalid shape.
+ */
+export declare function validateConfig(raw: unknown): UicConfig;
+/**
+ * Load UIC configuration from `.uicrc.json` in `dir` or its parents.
+ * Returns `DEFAULT_CONFIG` when no config file is found.
+ * Throws `UicError` on invalid JSON or invalid shape.
+ */
+export declare function loadConfig(dir: string): Promise<UicConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gGAAgG;IAChG,oBAAoB,EAAE,OAAO,GAAG,MAAM,CAAC;IACvC,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,EAAE,SAI5B,CAAC;AAYF;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAkEtD;AA+BD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA4BhE"}

package/dist/config.js

@@ -0,0 +1,142 @@
+/**
+ * UIC configuration loader and validator.
+ *
+ * Looks for `.uicrc.json` in the given directory and its parents,
+ * returning a typed UicConfig. Returns defaults when no file is found.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { UicError } from './errors.js';
+export const DEFAULT_CONFIG = {
+    protectedScopes: [],
+    breakingChangePolicy: 'block',
+    plugins: [],
+};
+const CONFIG_FILENAME = '.uicrc.json';
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate an unknown value as a UicConfig. Throws on invalid shape.
+ */
+export function validateConfig(raw) {
+    if (!isRecord(raw)) {
+        throw new UicError('MANIFEST_INVALID', {
+            message: 'Invalid .uicrc.json: config must be a JSON object. See docs/CLI.md for the config schema.',
+            context: { received: typeof raw },
+        });
+    }
+    const config = { ...DEFAULT_CONFIG };
+    // protectedScopes
+    if ('protectedScopes' in raw) {
+        if (!Array.isArray(raw['protectedScopes'])) {
+            throw new UicError('MANIFEST_INVALID', {
+                message: 'Invalid .uicrc.json: "protectedScopes" must be an array of strings. Example: ["settings.billing"]',
+                context: { received: typeof raw['protectedScopes'] },
+            });
+        }
+        for (let i = 0; i < raw['protectedScopes'].length; i++) {
+            const item = raw['protectedScopes'][i];
+            if (typeof item !== 'string') {
+                throw new UicError('MANIFEST_INVALID', {
+                    message: `Invalid .uicrc.json: "protectedScopes[${String(i)}]" must be a string, got ${typeof item}.`,
+                    context: { index: i, received: typeof item },
+                });
+            }
+        }
+        config.protectedScopes = raw['protectedScopes'];
+    }
+    // plugins
+    if ('plugins' in raw) {
+        if (!Array.isArray(raw['plugins'])) {
+            throw new UicError('MANIFEST_INVALID', {
+                message: 'Invalid .uicrc.json: "plugins" must be an array of strings. Example: ["uic-parser-svelte"]',
+                context: { received: typeof raw['plugins'] },
+            });
+        }
+        for (let i = 0; i < raw['plugins'].length; i++) {
+            const item = raw['plugins'][i];
+            if (typeof item !== 'string') {
+                throw new UicError('MANIFEST_INVALID', {
+                    message: `Invalid .uicrc.json: "plugins[${String(i)}]" must be a string, got ${typeof item}.`,
+                    context: { index: i, received: typeof item },
+                });
+            }
+        }
+        config.plugins = raw['plugins'];
+    }
+    // breakingChangePolicy
+    if ('breakingChangePolicy' in raw) {
+        if (raw['breakingChangePolicy'] !== 'block' && raw['breakingChangePolicy'] !== 'warn') {
+            throw new UicError('MANIFEST_INVALID', {
+                message: 'Invalid .uicrc.json: "breakingChangePolicy" must be "block" or "warn".',
+                context: { received: raw['breakingChangePolicy'] },
+            });
+        }
+        config.breakingChangePolicy = raw['breakingChangePolicy'];
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+/**
+ * Walk up from `dir` looking for `.uicrc.json`.
+ * Returns `null` if none found.
+ */
+async function findConfigFile(dir) {
+    let current = path.resolve(dir);
+    for (;;) {
+        const candidate = path.join(current, CONFIG_FILENAME);
+        try {
+            await fs.access(candidate);
+            return candidate;
+        }
+        catch {
+            // not found — go up
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // reached filesystem root
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Load UIC configuration from `.uicrc.json` in `dir` or its parents.
+ * Returns `DEFAULT_CONFIG` when no config file is found.
+ * Throws `UicError` on invalid JSON or invalid shape.
+ */
+export async function loadConfig(dir) {
+    const configPath = await findConfigFile(dir);
+    if (configPath === null) {
+        return { ...DEFAULT_CONFIG };
+    }
+    let raw;
+    try {
+        raw = await fs.readFile(configPath, 'utf-8');
+    }
+    catch (err) {
+        throw new UicError('FILE_READ_ERROR', {
+            message: `Failed to read config file "${configPath}". Check permissions and try again.`,
+            context: { configPath },
+            cause: err instanceof Error ? err : undefined,
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new UicError('MANIFEST_INVALID', {
+            message: `Failed to parse "${configPath}" as JSON. Ensure it contains valid JSON.`,
+            context: { configPath },
+        });
+    }
+    return validateConfig(parsed);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error types for the UIC system.
+ */
+/** All known error codes */
+export type UicErrorCode = 'MANIFEST_NOT_FOUND' | 'MANIFEST_INVALID' | 'MANIFEST_VERSION_UNSUPPORTED' | 'DUPLICATE_AGENT_ID' | 'PARSER_NOT_FOUND' | 'PARSER_DUPLICATE' | 'SCAN_FAILED' | 'FILE_READ_ERROR' | 'FILE_WRITE_ERROR' | 'ANNOTATION_FAILED' | 'NAMING_FAILED' | 'UNKNOWN';
+/** Options for constructing a UicError */
+interface UicErrorOptions {
+    message: string;
+    context?: Record<string, unknown>;
+    cause?: Error;
+}
+/** Base error class with structured code and context */
+export declare class UicError extends Error {
+    readonly code: UicErrorCode;
+    readonly context: Record<string, unknown>;
+    constructor(code: UicErrorCode, options: UicErrorOptions);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,4BAA4B;AAC5B,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,8BAA8B,GAC9B,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,SAAS,CAAC;AAEd,0CAA0C;AAC1C,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,wDAAwD;AACxD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE9B,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe;CASzD"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+/**
+ * Error types for the UIC system.
+ */
+/** Base error class with structured code and context */
+export class UicError extends Error {
+    code;
+    context;
+    constructor(code, options) {
+        super(options.message);
+        this.name = 'UicError';
+        this.code = code;
+        this.context = options.context ?? {};
+        if (options.cause) {
+            this.cause = options.cause;
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwBH,wDAAwD;AACxD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,OAAO,CAA0B;IAE1C,YAAY,IAAkB,EAAE,OAAwB;QACtD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @uicontract/core — foundation types and utilities for UIC.
+ */
+export declare const VERSION = "0.0.0";
+export type { InteractiveElementType, RawElement, NamedElement, ManifestElement, Manifest, ParserOptions, ParserWarning, DiscoveryResult, Parser, } from './types.js';
+export { UicError } from './errors.js';
+export type { UicErrorCode } from './errors.js';
+export { createLogger, LOG_LEVELS } from './logger.js';
+export type { LogLevel, Logger } from './logger.js';
+export { validateManifest, buildManifest, serializeManifest, deserializeManifest, } from './schema/manifest.js';
+export type { ValidationError, ValidationResult } from './schema/manifest.js';
+export { ParserRegistry, parserRegistry } from './parser-registry.js';
+export { loadConfig, validateConfig, DEFAULT_CONFIG } from './config.js';
+export type { UicConfig } from './config.js';
+export { loadPlugins } from './plugin-loader.js';
+export type { PluginLoadResult } from './plugin-loader.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":"AAAA;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,aAAa,EACb,aAAa,EACb,eAAe,EACf,MAAM,GACP,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @uicontract/core — foundation types and utilities for UIC.
+ */
+export const VERSION = '0.0.0';
+// Errors
+export { UicError } from './errors.js';
+// Logger
+export { createLogger, LOG_LEVELS } from './logger.js';
+// Schema / Manifest
+export { validateManifest, buildManifest, serializeManifest, deserializeManifest, } from './schema/manifest.js';
+// Parser Registry
+export { ParserRegistry, parserRegistry } from './parser-registry.js';
+// Config
+export { loadConfig, validateConfig, DEFAULT_CONFIG } from './config.js';
+// Plugin Loader
+export { loadPlugins } from './plugin-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAe/B,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGvD,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtE,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzE,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Structured logger for the UIC system.
+ * All output goes to stderr (never stdout).
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/** Numeric ordering of log levels for filtering */
+export declare const LOG_LEVELS: Record<LogLevel, number>;
+interface CreateLoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+}
+/**
+ * Creates a structured logger that writes to stderr.
+ *
+ * Default level: 'warn'. Use --verbose for 'debug', --quiet for 'error'.
+ */
+export declare function createLogger(options?: CreateLoggerOptions): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED,mDAAmD;AACnD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAK/C,CAAC;AAEF,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA8ClE"}

package/dist/logger.js

@@ -0,0 +1,59 @@
+/**
+ * Structured logger for the UIC system.
+ * All output goes to stderr (never stdout).
+ */
+/** Numeric ordering of log levels for filtering */
+export const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Creates a structured logger that writes to stderr.
+ *
+ * Default level: 'warn'. Use --verbose for 'debug', --quiet for 'error'.
+ */
+export function createLogger(options) {
+    const level = options?.level ?? 'warn';
+    const prefix = options?.prefix ?? 'UIC';
+    const threshold = LOG_LEVELS[level];
+    function shouldLog(msgLevel) {
+        return LOG_LEVELS[msgLevel] >= threshold;
+    }
+    function formatContext(context) {
+        if (!context || Object.keys(context).length === 0) {
+            return '';
+        }
+        return ' ' + JSON.stringify(context);
+    }
+    function write(msgLevel, message, context) {
+        if (!shouldLog(msgLevel)) {
+            return;
+        }
+        const tag = msgLevel.toUpperCase();
+        const contextStr = formatContext(context);
+        if (level === 'debug') {
+            const timestamp = new Date().toISOString();
+            process.stderr.write(`[${prefix}] [${tag}] ${timestamp} ${message}${contextStr}\n`);
+        }
+        else {
+            process.stderr.write(`[${prefix}] [${tag}] ${message}${contextStr}\n`);
+        }
+    }
+    return {
+        debug(message, context) {
+            write('debug', message, context);
+        },
+        info(message, context) {
+            write('info', message, context);
+        },
+        warn(message, context) {
+            write('warn', message, context);
+        },
+        error(message, context) {
+            write('error', message, context);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAA6B;IAClD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAOF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAA6B;IACxD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAEpC,SAAS,SAAS,CAAC,QAAkB;QACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;IAC3C,CAAC;IAED,SAAS,aAAa,CAAC,OAAiC;QACtD,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,SAAS,KAAK,CAAC,QAAkB,EAAE,OAAe,EAAE,OAAiC;QACnF,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,UAAU,IAAI,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,UAAU,IAAI,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAe,EAAE,OAAiC;YACtD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,OAAiC;YACrD,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,OAAiC;YACrD,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,OAAe,EAAE,OAAiC;YACtD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/parser-registry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Registry for framework parsers.
+ * Parsers register themselves; the CLI uses the registry to detect and discover.
+ */
+import type { Parser } from './types.js';
+/** Registry that holds framework parsers and supports detection. */
+export declare class ParserRegistry {
+    private readonly parsers;
+    /** Register a parser. Throws if a parser for the same framework is already registered. */
+    register(parser: Parser): void;
+    /** Get a parser by framework name. */
+    get(framework: string): Parser | undefined;
+    /** Try each registered parser's detect() and return the first match. */
+    detect(dir: string): Promise<Parser | undefined>;
+    /** Get all registered parsers. */
+    getAll(): readonly Parser[];
+}
+/** Singleton parser registry instance. */
+export declare const parserRegistry: ParserRegistry;
+//# sourceMappingURL=parser-registry.d.ts.map

package/dist/parser-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-registry.d.ts","sourceRoot":"","sources":["../src/parser-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC,oEAAoE;AACpE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU9B,sCAAsC;IACtC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1C,wEAAwE;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUtD,kCAAkC;IAClC,MAAM,IAAI,SAAS,MAAM,EAAE;CAG5B;AAED,0CAA0C;AAC1C,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/parser-registry.js

@@ -0,0 +1,40 @@
+/**
+ * Registry for framework parsers.
+ * Parsers register themselves; the CLI uses the registry to detect and discover.
+ */
+import { UicError } from './errors.js';
+/** Registry that holds framework parsers and supports detection. */
+export class ParserRegistry {
+    parsers = new Map();
+    /** Register a parser. Throws if a parser for the same framework is already registered. */
+    register(parser) {
+        if (this.parsers.has(parser.framework)) {
+            throw new UicError('PARSER_DUPLICATE', {
+                message: `A parser for framework "${parser.framework}" is already registered. Each framework can only have one parser.`,
+                context: { framework: parser.framework },
+            });
+        }
+        this.parsers.set(parser.framework, parser);
+    }
+    /** Get a parser by framework name. */
+    get(framework) {
+        return this.parsers.get(framework);
+    }
+    /** Try each registered parser's detect() and return the first match. */
+    async detect(dir) {
+        for (const parser of this.parsers.values()) {
+            const detected = await parser.detect(dir);
+            if (detected) {
+                return parser;
+            }
+        }
+        return undefined;
+    }
+    /** Get all registered parsers. */
+    getAll() {
+        return Array.from(this.parsers.values());
+    }
+}
+/** Singleton parser registry instance. */
+export const parserRegistry = new ParserRegistry();
+//# sourceMappingURL=parser-registry.js.map

package/dist/parser-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-registry.js","sourceRoot":"","sources":["../src/parser-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,oEAAoE;AACpE,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,0FAA0F;IAC1F,QAAQ,CAAC,MAAc;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE;gBACrC,OAAO,EAAE,2BAA2B,MAAM,CAAC,SAAS,mEAAmE;gBACvH,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;aACzC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,sCAAsC;IACtC,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kCAAkC;IAClC,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC"}

package/dist/plugin-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Plugin loader for third-party UIC parsers.
+ *
+ * Dynamically imports npm packages listed in `.uicrc.json` `plugins` and
+ * registers them into the ParserRegistry. Invalid or missing plugins are
+ * warned about but do not throw.
+ */
+import type { Logger } from './logger.js';
+import { ParserRegistry } from './parser-registry.js';
+/** Result of loading plugins — which succeeded and which failed. */
+export interface PluginLoadResult {
+    loaded: string[];
+    failed: string[];
+}
+/**
+ * Dynamically import each plugin and register its Parser into the registry.
+ *
+ * Plugins are npm package names that export a Parser object. The loader tries
+ * several export patterns:
+ *
+ * 1. Default export is a Parser
+ * 2. Named `parser` export is a Parser
+ * 3. Module object itself is a Parser (CommonJS default)
+ *
+ * Invalid or missing plugins are logged as warnings and added to `failed`.
+ */
+export declare function loadPlugins(pluginNames: string[], registry: ParserRegistry, logger: Logger): Promise<PluginLoadResult>;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAqBtD,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CA4E3B"}

package/dist/plugin-loader.js

@@ -0,0 +1,100 @@
+/**
+ * Plugin loader for third-party UIC parsers.
+ *
+ * Dynamically imports npm packages listed in `.uicrc.json` `plugins` and
+ * registers them into the ParserRegistry. Invalid or missing plugins are
+ * warned about but do not throw.
+ */
+import { UicError } from './errors.js';
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+function isParser(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj['framework'] === 'string' &&
+        typeof obj['detect'] === 'function' &&
+        typeof obj['discover'] === 'function');
+}
+/**
+ * Dynamically import each plugin and register its Parser into the registry.
+ *
+ * Plugins are npm package names that export a Parser object. The loader tries
+ * several export patterns:
+ *
+ * 1. Default export is a Parser
+ * 2. Named `parser` export is a Parser
+ * 3. Module object itself is a Parser (CommonJS default)
+ *
+ * Invalid or missing plugins are logged as warnings and added to `failed`.
+ */
+export async function loadPlugins(pluginNames, registry, logger) {
+    const loaded = [];
+    const failed = [];
+    for (const name of pluginNames) {
+        try {
+            const mod = await import(name);
+            // Resolve the Parser from common export patterns
+            let parser;
+            // Try default export first
+            if (typeof mod === 'object' && mod !== null && 'default' in mod) {
+                const defaultExport = mod['default'];
+                if (isParser(defaultExport)) {
+                    parser = defaultExport;
+                }
+            }
+            // Try named `parser` export
+            if (!parser && typeof mod === 'object' && mod !== null && 'parser' in mod) {
+                const namedExport = mod['parser'];
+                if (isParser(namedExport)) {
+                    parser = namedExport;
+                }
+            }
+            // Try module itself (CommonJS pattern).
+            // Wrapped in try/catch because some module systems (including test mocks)
+            // throw on property access for exports not defined in the module.
+            if (!parser) {
+                try {
+                    if (isParser(mod)) {
+                        parser = mod;
+                    }
+                }
+                catch {
+                    // Property access threw — module is not a valid Parser
+                }
+            }
+            if (!isParser(parser)) {
+                logger.warn(`Plugin "${name}" does not export a valid Parser. ` +
+                    `Expected an object with { framework: string, detect: Function, discover: Function }.`);
+                failed.push(name);
+                continue;
+            }
+            try {
+                registry.register(parser);
+                loaded.push(name);
+                logger.debug(`Loaded plugin "${name}" (framework: ${parser.framework})`);
+            }
+            catch (err) {
+                if (err instanceof UicError && err.code === 'PARSER_DUPLICATE') {
+                    logger.warn(`Plugin "${name}" skipped: parser for framework "${parser.framework}" already registered.`);
+                    failed.push(name);
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        catch (err) {
+            // Re-throw UicError (from registry internals), catch everything else
+            if (err instanceof UicError)
+                throw err;
+            const message = err instanceof Error ? err.message : String(err);
+            logger.warn(`Failed to load plugin "${name}": ${message}. ` +
+                `Ensure it is installed: pnpm add ${name}`);
+            failed.push(name);
+        }
+    }
+    return { loaded, failed };
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/plugin-loader.js.map

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

package/dist/schema/manifest.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Manifest validation, building, and serialization.
+ *
+ * Validation is implemented manually (no ajv/JSON Schema library)
+ * to keep runtime dependencies at zero.
+ */
+import type { Manifest, NamedElement } from '../types.js';
+/** A single validation error */
+export interface ValidationError {
+    path: string;
+    code: string;
+    message: string;
+}
+/** Result of validating a manifest */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/** Validate a manifest object against the v1 schema. */
+export declare function validateManifest(manifest: unknown): ValidationResult;
+/** Build a manifest from named elements and metadata. */
+export declare function buildManifest(options: {
+    elements: NamedElement[];
+    framework: string;
+    projectRoot: string;
+    filesScanned: number;
+    warnings: number;
+    generatorVersion: string;
+}): Manifest;
+/** Serialize a manifest to a pretty-printed JSON string. */
+export declare function serializeManifest(manifest: Manifest): string;
+/** Deserialize a JSON string to a manifest, validating it in the process. */
+export declare function deserializeManifest(json: string): Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/schema/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/schema/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAmB,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAwID,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAiJpE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,QAAQ,CAsBX;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE5D;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAmB1D"}

package/dist/schema/manifest.js

@@ -0,0 +1,317 @@
+/**
+ * Manifest validation, building, and serialization.
+ *
+ * Validation is implemented manually (no ajv/JSON Schema library)
+ * to keep runtime dependencies at zero.
+ */
+const SCHEMA_VERSION_PATTERN = /^\d+\.\d+$/;
+const AGENT_ID_PATTERN = /^[a-z][a-z0-9.-]*$/;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isStringOrNull(value) {
+    return value === null || typeof value === 'string';
+}
+function validateElement(element, index, errors) {
+    const prefix = `elements[${String(index)}]`;
+    if (!isRecord(element)) {
+        errors.push({
+            path: prefix,
+            code: 'INVALID_TYPE',
+            message: `Element at index ${String(index)} must be an object.`,
+        });
+        return;
+    }
+    // agentId
+    if (typeof element['agentId'] !== 'string') {
+        errors.push({
+            path: `${prefix}.agentId`,
+            code: 'REQUIRED_FIELD',
+            message: 'agentId is required and must be a string.',
+        });
+    }
+    else if (element['agentId'].length === 0) {
+        errors.push({
+            path: `${prefix}.agentId`,
+            code: 'EMPTY_AGENT_ID',
+            message: 'agentId must not be empty.',
+        });
+    }
+    else if (!AGENT_ID_PATTERN.test(element['agentId'])) {
+        errors.push({
+            path: `${prefix}.agentId`,
+            code: 'INVALID_AGENT_ID',
+            message: `agentId "${element['agentId']}" must match pattern ^[a-z][a-z0-9.-]*$ (lowercase, starts with letter, contains only letters, digits, dots, hyphens).`,
+        });
+    }
+    // type
+    if (typeof element['type'] !== 'string' || element['type'].length === 0) {
+        errors.push({
+            path: `${prefix}.type`,
+            code: 'REQUIRED_FIELD',
+            message: 'type is required and must be a non-empty string.',
+        });
+    }
+    // filePath
+    if (typeof element['filePath'] !== 'string' || element['filePath'].length === 0) {
+        errors.push({
+            path: `${prefix}.filePath`,
+            code: 'REQUIRED_FIELD',
+            message: 'filePath is required and must be a non-empty string.',
+        });
+    }
+    // line
+    if (typeof element['line'] !== 'number' || !Number.isInteger(element['line']) || element['line'] < 1) {
+        errors.push({
+            path: `${prefix}.line`,
+            code: 'INVALID_TYPE',
+            message: 'line must be a positive integer.',
+        });
+    }
+    // column
+    if (typeof element['column'] !== 'number' ||
+        !Number.isInteger(element['column']) ||
+        element['column'] < 1) {
+        errors.push({
+            path: `${prefix}.column`,
+            code: 'INVALID_TYPE',
+            message: 'column must be a positive integer.',
+        });
+    }
+    // nullable string fields
+    const nullableFields = ['componentName', 'route', 'label', 'handler'];
+    for (const field of nullableFields) {
+        if (!(field in element)) {
+            errors.push({
+                path: `${prefix}.${field}`,
+                code: 'REQUIRED_FIELD',
+                message: `${field} is required (can be null).`,
+            });
+        }
+        else if (!isStringOrNull(element[field])) {
+            errors.push({
+                path: `${prefix}.${field}`,
+                code: 'INVALID_TYPE',
+                message: `${field} must be a string or null.`,
+            });
+        }
+    }
+    // attributes
+    if (!isRecord(element['attributes'])) {
+        errors.push({
+            path: `${prefix}.attributes`,
+            code: 'REQUIRED_FIELD',
+            message: 'attributes is required and must be an object.',
+        });
+    }
+    else {
+        for (const [key, value] of Object.entries(element['attributes'])) {
+            if (typeof value !== 'string') {
+                errors.push({
+                    path: `${prefix}.attributes.${key}`,
+                    code: 'INVALID_TYPE',
+                    message: `attributes["${key}"] must be a string.`,
+                });
+            }
+        }
+    }
+    // boolean fields
+    const booleanFields = ['conditional', 'dynamic'];
+    for (const field of booleanFields) {
+        if (typeof element[field] !== 'boolean') {
+            errors.push({
+                path: `${prefix}.${field}`,
+                code: 'REQUIRED_FIELD',
+                message: `${field} is required and must be a boolean.`,
+            });
+        }
+    }
+}
+/** Validate a manifest object against the v1 schema. */
+export function validateManifest(manifest) {
+    const errors = [];
+    if (!isRecord(manifest)) {
+        errors.push({
+            path: '',
+            code: 'INVALID_TYPE',
+            message: 'Manifest must be an object.',
+        });
+        return { valid: false, errors };
+    }
+    // schemaVersion
+    if (typeof manifest['schemaVersion'] !== 'string') {
+        errors.push({
+            path: 'schemaVersion',
+            code: 'REQUIRED_FIELD',
+            message: 'schemaVersion is required and must be a string.',
+        });
+    }
+    else if (!SCHEMA_VERSION_PATTERN.test(manifest['schemaVersion'])) {
+        errors.push({
+            path: 'schemaVersion',
+            code: 'INVALID_FORMAT',
+            message: 'schemaVersion must match format "major.minor" (e.g., "1.0").',
+        });
+    }
+    else {
+        const major = parseInt(manifest['schemaVersion'].split('.')[0] ?? '0', 10);
+        if (major !== 1) {
+            errors.push({
+                path: 'schemaVersion',
+                code: 'VERSION_UNSUPPORTED',
+                message: `schemaVersion major version ${String(major)} is not supported. Only version 1.x is supported. Please update @uicontract/core to handle this manifest version.`,
+            });
+        }
+    }
+    // generatedAt
+    if (typeof manifest['generatedAt'] !== 'string') {
+        errors.push({
+            path: 'generatedAt',
+            code: 'REQUIRED_FIELD',
+            message: 'generatedAt is required and must be an ISO 8601 datetime string.',
+        });
+    }
+    // generator
+    if (!isRecord(manifest['generator'])) {
+        errors.push({
+            path: 'generator',
+            code: 'REQUIRED_FIELD',
+            message: 'generator is required and must be an object with name and version.',
+        });
+    }
+    else {
+        if (typeof manifest['generator']['name'] !== 'string' || manifest['generator']['name'].length === 0) {
+            errors.push({
+                path: 'generator.name',
+                code: 'REQUIRED_FIELD',
+                message: 'generator.name is required and must be a non-empty string.',
+            });
+        }
+        if (typeof manifest['generator']['version'] !== 'string' || manifest['generator']['version'].length === 0) {
+            errors.push({
+                path: 'generator.version',
+                code: 'REQUIRED_FIELD',
+                message: 'generator.version is required and must be a non-empty string.',
+            });
+        }
+    }
+    // metadata
+    if (!isRecord(manifest['metadata'])) {
+        errors.push({
+            path: 'metadata',
+            code: 'REQUIRED_FIELD',
+            message: 'metadata is required and must be an object.',
+        });
+    }
+    else {
+        const meta = manifest['metadata'];
+        if (typeof meta['framework'] !== 'string' || meta['framework'].length === 0) {
+            errors.push({
+                path: 'metadata.framework',
+                code: 'REQUIRED_FIELD',
+                message: 'metadata.framework is required and must be a non-empty string.',
+            });
+        }
+        if (typeof meta['projectRoot'] !== 'string' || meta['projectRoot'].length === 0) {
+            errors.push({
+                path: 'metadata.projectRoot',
+                code: 'REQUIRED_FIELD',
+                message: 'metadata.projectRoot is required and must be a non-empty string.',
+            });
+        }
+        if (typeof meta['filesScanned'] !== 'number' || !Number.isInteger(meta['filesScanned'])) {
+            errors.push({
+                path: 'metadata.filesScanned',
+                code: 'INVALID_TYPE',
+                message: 'metadata.filesScanned must be an integer.',
+            });
+        }
+        if (typeof meta['elementsDiscovered'] !== 'number' || !Number.isInteger(meta['elementsDiscovered'])) {
+            errors.push({
+                path: 'metadata.elementsDiscovered',
+                code: 'INVALID_TYPE',
+                message: 'metadata.elementsDiscovered must be an integer.',
+            });
+        }
+        if (typeof meta['warnings'] !== 'number' || !Number.isInteger(meta['warnings'])) {
+            errors.push({
+                path: 'metadata.warnings',
+                code: 'INVALID_TYPE',
+                message: 'metadata.warnings must be an integer.',
+            });
+        }
+    }
+    // elements
+    if (!Array.isArray(manifest['elements'])) {
+        errors.push({
+            path: 'elements',
+            code: 'REQUIRED_FIELD',
+            message: 'elements is required and must be an array.',
+        });
+    }
+    else {
+        for (let i = 0; i < manifest['elements'].length; i++) {
+            validateElement(manifest['elements'][i], i, errors);
+        }
+        // Check for duplicate agentIds
+        const seenIds = new Set();
+        for (let i = 0; i < manifest['elements'].length; i++) {
+            const el = manifest['elements'][i];
+            if (isRecord(el) && typeof el['agentId'] === 'string' && el['agentId'].length > 0) {
+                if (seenIds.has(el['agentId'])) {
+                    errors.push({
+                        path: `elements[${String(i)}].agentId`,
+                        code: 'DUPLICATE_AGENT_ID',
+                        message: `Duplicate agentId "${el['agentId']}". Each element must have a unique agentId.`,
+                    });
+                }
+                seenIds.add(el['agentId']);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/** Build a manifest from named elements and metadata. */
+export function buildManifest(options) {
+    const manifestElements = options.elements.map((el) => ({
+        ...el,
+        attributes: { ...el.attributes },
+    }));
+    return {
+        schemaVersion: '1.0',
+        generatedAt: new Date().toISOString(),
+        generator: {
+            name: '@uicontract/cli',
+            version: options.generatorVersion,
+        },
+        metadata: {
+            framework: options.framework,
+            projectRoot: options.projectRoot,
+            filesScanned: options.filesScanned,
+            elementsDiscovered: manifestElements.length,
+            warnings: options.warnings,
+        },
+        elements: manifestElements,
+    };
+}
+/** Serialize a manifest to a pretty-printed JSON string. */
+export function serializeManifest(manifest) {
+    return JSON.stringify(manifest, null, 2);
+}
+/** Deserialize a JSON string to a manifest, validating it in the process. */
+export function deserializeManifest(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new Error('Failed to parse manifest JSON. Ensure the file contains valid JSON.');
+    }
+    const result = validateManifest(parsed);
+    if (!result.valid) {
+        const details = result.errors.map((e) => `  - ${e.path}: ${e.message}`).join('\n');
+        throw new Error(`Invalid manifest:\n${details}\n\nEnsure your manifest matches the v1 schema.`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/schema/manifest.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared types for the UIC (UI Contracts) system.
+ */
+/** Element types discovered by parsers */
+export type InteractiveElementType = 'button' | 'input' | 'select' | 'textarea' | 'a' | 'form' | 'div' | 'span' | 'img' | 'label';
+/** Raw element discovered by parser (before naming) */
+export interface RawElement {
+    type: InteractiveElementType;
+    filePath: string;
+    line: number;
+    column: number;
+    componentName: string | null;
+    route: string | null;
+    label: string | null;
+    handler: string | null;
+    attributes: Record<string, string>;
+    conditional: boolean;
+    dynamic: boolean;
+}
+/** Named element (after naming engine assigns an agentId) */
+export interface NamedElement extends RawElement {
+    agentId: string;
+}
+/** Manifest element (serialized to JSON) — identical to NamedElement by design. */
+export type ManifestElement = NamedElement;
+/** Full manifest structure */
+export interface Manifest {
+    schemaVersion: string;
+    generatedAt: string;
+    generator: {
+        name: string;
+        version: string;
+    };
+    metadata: {
+        framework: string;
+        projectRoot: string;
+        filesScanned: number;
+        elementsDiscovered: number;
+        warnings: number;
+    };
+    elements: ManifestElement[];
+}
+/** Options for parser discovery */
+export interface ParserOptions {
+    include?: string[];
+    exclude?: string[];
+    maxDepth?: number;
+}
+/** Warning emitted during parsing */
+export interface ParserWarning {
+    code: string;
+    message: string;
+    filePath: string;
+    line?: number;
+}
+/** Result of a parser's discover() call */
+export interface DiscoveryResult {
+    elements: RawElement[];
+    warnings: ParserWarning[];
+    metadata: {
+        filesScanned: number;
+        filesSkipped: number;
+        scanDurationMs: number;
+    };
+}
+/** Interface that framework parsers must implement */
+export interface Parser {
+    readonly framework: string;
+    detect(dir: string): Promise<boolean>;
+    discover(dir: string, options: ParserOptions): Promise<DiscoveryResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,GACV,GAAG,GACH,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,CAAC;AAEZ,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAE3C,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,sDAAsD;AACtD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACzE"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the UIC (UI Contracts) system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@uicontract/core",
+  "version": "0.1.0",
+  "description": "Core types, schema, validation, logger, and error classes for UIC",
+  "type": "module",
+  "license": "MIT",
+  "author": "UIC Contributors",
+  "homepage": "https://github.com/sherifkozman/uicontract/tree/main/packages/core",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sherifkozman/uicontract.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/sherifkozman/uicontract/issues"
+  },
+  "keywords": [
+    "uic",
+    "ui-contracts",
+    "schema",
+    "manifest",
+    "agent-id"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}