logicstamp-context 0.1.0

package/dist/core/signature.js

@@ -0,0 +1,208 @@
+/**
+ * @uif Contract 0.3
+ *
+ * Description: signature - Presentational component
+ *
+ * Version (Component Composition):
+ *   variables: []
+ *   hooks: []
+ *   components: []
+ *   functions: ["applyDisplayOnlyPreset","applyNavOnlyPreset","applySubmitOnlyPreset","buildLogicSignature","generateBehavioralPredictions","inferDescription"]
+ *   imports: ["../types/UIFContract.js","./astParser.js"]
+ *
+ * Logic Signature:
+ *   props: {}
+ *   emits: {}
+ *   state: {}
+ *
+ * Predictions:
+ *   (none)
+ *
+ * Hashes (informational only - authoritative values in .uif.json):
+ *   semantic: uif:9a5a412d07f6985e03fda241 (informational)
+ *   file: uif:64d7d3b1474878658358e5a8
+ */
+/**
+ * Build logic signature with preset validation
+ */
+export function buildLogicSignature(ast, preset) {
+    const signature = {
+        props: ast.props,
+        emits: ast.emits,
+        state: Object.keys(ast.state).length > 0 ? ast.state : undefined,
+    };
+    const prediction = [];
+    const violations = [];
+    // Apply preset-specific rules
+    switch (preset) {
+        case 'submit-only':
+            applySubmitOnlyPreset(ast, prediction, violations);
+            break;
+        case 'nav-only':
+            applyNavOnlyPreset(ast, prediction, violations);
+            break;
+        case 'display-only':
+            applyDisplayOnlyPreset(ast, prediction, violations);
+            break;
+        case 'none':
+            // No preset constraints
+            break;
+    }
+    return { signature, prediction, violations };
+}
+/**
+ * Submit-only preset: only onSubmit event allowed
+ */
+function applySubmitOnlyPreset(ast, prediction, violations) {
+    prediction.push('Contract preset: submit-only');
+    const allowedEvents = ['onSubmit'];
+    const eventKeys = Object.keys(ast.emits);
+    const forbidden = eventKeys.filter((key) => !allowedEvents.includes(key));
+    if (forbidden.length > 0) {
+        violations.push(`Submit-only contract violated: remove events [${forbidden.join(', ')}]`);
+    }
+    if (eventKeys.includes('onSubmit')) {
+        prediction.push('When loading=true, submit button should be disabled');
+        prediction.push('onSubmit is the only permitted action handler');
+    }
+    // Check for loading/busy state
+    if (ast.state.loading || ast.state.busy || ast.state.isLoading) {
+        prediction.push('Loading state controls button disabled state');
+    }
+}
+/**
+ * Nav-only preset: only onClick navigation allowed
+ */
+function applyNavOnlyPreset(ast, prediction, violations) {
+    prediction.push('Contract preset: nav-only');
+    const allowedEvents = ['onClick'];
+    const eventKeys = Object.keys(ast.emits);
+    const forbidden = eventKeys.filter((key) => !allowedEvents.includes(key));
+    if (forbidden.length > 0) {
+        violations.push(`Nav-only contract violated: remove events [${forbidden.join(', ')}]`);
+    }
+    if (!eventKeys.includes('onClick')) {
+        violations.push('Nav-only contract expects an onClick navigation handler');
+    }
+    prediction.push('Component handles navigation only, no form submission or data mutation');
+    // Check for href prop (for link-like components)
+    if ('href' in ast.props || 'to' in ast.props) {
+        prediction.push('Navigation target specified via href/to prop');
+    }
+}
+/**
+ * Display-only preset: no events allowed
+ */
+function applyDisplayOnlyPreset(ast, prediction, violations) {
+    prediction.push('Contract preset: display-only');
+    const eventKeys = Object.keys(ast.emits);
+    if (eventKeys.length > 0) {
+        violations.push(`Display-only contract violated: no events permitted, found [${eventKeys.join(', ')}]`);
+    }
+    prediction.push('Component is purely presentational with no event handlers');
+    prediction.push('All behavior driven by props only');
+    // Check for derived state
+    const stateKeys = Object.keys(ast.state);
+    if (stateKeys.length > 0) {
+        violations.push(`Display-only contract should minimize internal state, found [${stateKeys.join(', ')}]`);
+    }
+}
+/**
+ * Generate additional behavioral predictions based on common patterns
+ */
+export function generateBehavioralPredictions(ast) {
+    const predictions = [];
+    // Form handling patterns
+    if (ast.hooks.includes('useForm') || ast.functions.some((f) => f.includes('validate'))) {
+        predictions.push('Includes form validation logic');
+    }
+    // Side effects
+    if (ast.hooks.includes('useEffect')) {
+        predictions.push('Has side effects managed by useEffect');
+    }
+    // Data fetching
+    if (ast.hooks.some((h) => h.includes('Query') || h.includes('Mutation')) ||
+        ast.functions.some((f) => f.includes('fetch') || f.includes('load'))) {
+        predictions.push('Fetches or mutates external data');
+    }
+    // Memoization
+    if (ast.hooks.includes('useMemo') || ast.hooks.includes('useCallback')) {
+        predictions.push('Uses memoization for performance optimization');
+    }
+    // Context usage
+    if (ast.hooks.includes('useContext')) {
+        predictions.push('Consumes React Context for shared state');
+    }
+    // Refs
+    if (ast.hooks.includes('useRef')) {
+        predictions.push('Uses refs for DOM access or mutable values');
+    }
+    // Loading states
+    const stateKeys = Object.keys(ast.state);
+    if (stateKeys.some((k) => k.includes('loading') || k.includes('pending'))) {
+        predictions.push('Manages loading/pending UI states');
+    }
+    // Error states
+    if (stateKeys.some((k) => k.includes('error'))) {
+        predictions.push('Handles and displays error states');
+    }
+    return predictions;
+}
+/**
+ * Infer component description from file name and structure
+ */
+export function inferDescription(filePath, ast) {
+    const fileName = filePath.split(/[/\\]/).pop()?.replace(/\.(tsx?|jsx?)$/, '') || 'Component';
+    // Check kind first - non-React files should get appropriate labels
+    if (ast.kind === 'node:cli') {
+        return `${fileName} - CLI entry point`;
+    }
+    if (ast.kind === 'ts:module') {
+        // Check for common utility patterns
+        if (fileName.toLowerCase().includes('util') || fileName.toLowerCase().includes('helper')) {
+            return `${fileName} - Utility module`;
+        }
+        if (fileName.toLowerCase().includes('config')) {
+            return `${fileName} - Configuration module`;
+        }
+        if (fileName.toLowerCase().includes('type') || fileName.toLowerCase().includes('interface')) {
+            return `${fileName} - Type definitions`;
+        }
+        return `${fileName} - TypeScript module`;
+    }
+    // React component patterns (kind === 'react:component')
+    if (fileName.toLowerCase().includes('button')) {
+        return `${fileName} - Interactive button component`;
+    }
+    if (fileName.toLowerCase().includes('form')) {
+        return `${fileName} - Form component with validation`;
+    }
+    if (fileName.toLowerCase().includes('modal') || fileName.toLowerCase().includes('dialog')) {
+        return `${fileName} - Modal/dialog component`;
+    }
+    if (fileName.toLowerCase().includes('input') || fileName.toLowerCase().includes('field')) {
+        return `${fileName} - Form input field`;
+    }
+    if (fileName.toLowerCase().includes('card')) {
+        return `${fileName} - Card display component`;
+    }
+    if (fileName.toLowerCase().includes('nav') || fileName.toLowerCase().includes('menu')) {
+        return `${fileName} - Navigation component`;
+    }
+    // Default description based on state and emits
+    const hasState = Object.keys(ast.state).length > 0;
+    const hasEmits = Object.keys(ast.emits).length > 0;
+    if (hasState && hasEmits) {
+        return `${fileName} - Interactive component with internal state`;
+    }
+    else if (hasState) {
+        return `${fileName} - Stateful component`;
+    }
+    else if (hasEmits) {
+        return `${fileName} - Interactive component`;
+    }
+    else {
+        return `${fileName} - Presentational component`;
+    }
+}
+//# sourceMappingURL=signature.js.map

package/dist/core/signature.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LogicStamp Context - Main entry point
+ *
+ * This package provides tools for generating AI-friendly context bundles
+ * from React/TypeScript codebases.
+ *
+ * @example
+ * ```typescript
+ * import { extractFromFile, buildContract, pack } from 'logicstamp-context';
+ * ```
+ */
+export type { UIFContract, NextJSMetadata, LogicSignature, ContractKind, PropType, EventType } from './types/UIFContract.js';
+export type { LogicStampBundle, BundleNode, PackOptions, CodeInclusionMode, BundleFormat, MissingDependency } from './core/pack.js';
+export type { ProjectManifest, ComponentNode } from './core/manifest.js';
+export type { AstExtract } from './core/astParser.js';
+export type { ContractBuildResult, ContractBuildParams } from './core/contractBuilder.js';
+export type { SignatureResult } from './core/signature.js';
+export { extractFromFile } from './core/astParser.js';
+export { buildContract } from './core/contractBuilder.js';
+export { pack, computeBundleHash, validateHashLock } from './core/pack.js';
+export { buildLogicSignature } from './core/signature.js';
+export { contextCommand, type ContextOptions } from './cli/commands/context.js';
+export { compareCommand, type CompareOptions } from './cli/commands/compare.js';
+export { validateCommand } from './cli/commands/validate.js';
+export { init } from './cli/commands/init.js';
+export { cleanCommand } from './cli/commands/clean.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;;;;;;;;;;GAUG;AAGH,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC7H,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACpI,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * LogicStamp Context - Main entry point
+ *
+ * This package provides tools for generating AI-friendly context bundles
+ * from React/TypeScript codebases.
+ *
+ * @example
+ * ```typescript
+ * import { extractFromFile, buildContract, pack } from 'logicstamp-context';
+ * ```
+ */
+// Core functions
+export { extractFromFile } from './core/astParser.js';
+export { buildContract } from './core/contractBuilder.js';
+export { pack, computeBundleHash, validateHashLock } from './core/pack.js';
+export { buildLogicSignature } from './core/signature.js';
+// CLI commands (for programmatic use)
+export { contextCommand } from './cli/commands/context.js';
+export { compareCommand } from './cli/commands/compare.js';
+export { validateCommand } from './cli/commands/validate.js';
+export { init } from './cli/commands/init.js';
+export { cleanCommand } from './cli/commands/clean.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;;;;;;;;;;GAUG;AAUH,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAuB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAuB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/UIFContract.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @uif Contract 0.3
+ *
+ * Description: UIFContract - Presentational component
+ *
+ * Version (Component Composition):
+ *   variables: []
+ *   hooks: []
+ *   components: []
+ *   functions: ["isUIFContract"]
+ *   imports: []
+ *
+ * Logic Signature:
+ *   props: {}
+ *   emits: {}
+ *   state: {}
+ *
+ * Predictions:
+ *   (none)
+ *
+ * Hashes (informational only - authoritative values in .uif.json):
+ *   semantic: uif:84f4985dd25893f9bb7e43f6 (informational)
+ *   file: uif:f1297e88a770031270331b9b
+ */
+/**
+ * Core type definition for UI Forge Contract
+ * Schema version 0.3
+ */
+export type ContractPreset = 'submit-only' | 'nav-only' | 'display-only' | 'none';
+export type ContractKind = 'react:component' | 'ts:module' | 'node:cli';
+export interface ComponentVersion {
+    variables: string[];
+    hooks: string[];
+    components: string[];
+    functions: string[];
+    imports?: string[];
+}
+/**
+ * Prop type descriptors
+ */
+export type PropType = string | string[] | {
+    type: 'literal-union' | 'function' | 'object' | 'array' | string;
+    optional?: boolean;
+    literals?: string[];
+    signature?: string;
+};
+/**
+ * Event type descriptors
+ */
+export type EventType = string | {
+    type: 'function';
+    signature: string;
+    optional?: boolean;
+};
+export interface LogicSignature {
+    props: Record<string, PropType>;
+    emits: Record<string, EventType>;
+    state?: Record<string, string>;
+}
+export interface A11yMetrics {
+    contrastMin?: number;
+    role?: string;
+}
+export interface LatencyMetrics {
+    clientP95Ms?: number;
+}
+export interface CoverageMetrics {
+    lines?: number;
+    branches?: number;
+}
+export interface ContractMetrics {
+    a11y?: A11yMetrics;
+    latency?: LatencyMetrics;
+    coverage?: CoverageMetrics;
+}
+export interface ContractLinks {
+    tokens?: string;
+    figma?: string;
+    spec?: string;
+}
+export interface NextJSMetadata {
+    isInAppDir?: boolean;
+    directive?: 'client' | 'server';
+}
+export type ExportMetadata = 'default' | 'named' | {
+    named: string[];
+};
+export interface UIFContract {
+    type: 'UIFContract';
+    schemaVersion: '0.3';
+    kind: ContractKind;
+    entryId: string;
+    entryPathAbs?: string;
+    entryPathRel?: string;
+    os?: 'win32' | 'posix';
+    description: string;
+    usedIn?: string[];
+    version: ComponentVersion;
+    logicSignature: LogicSignature;
+    exports?: ExportMetadata;
+    prediction?: string[];
+    metrics?: ContractMetrics;
+    links?: ContractLinks;
+    nextjs?: NextJSMetadata;
+    semanticHash: string;
+    fileHash: string;
+}
+/**
+ * Utility type guards
+ */
+export declare function isUIFContract(obj: unknown): obj is UIFContract;
+//# sourceMappingURL=UIFContract.d.ts.map

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

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

package/dist/types/UIFContract.js

@@ -0,0 +1,36 @@
+/**
+ * @uif Contract 0.3
+ *
+ * Description: UIFContract - Presentational component
+ *
+ * Version (Component Composition):
+ *   variables: []
+ *   hooks: []
+ *   components: []
+ *   functions: ["isUIFContract"]
+ *   imports: []
+ *
+ * Logic Signature:
+ *   props: {}
+ *   emits: {}
+ *   state: {}
+ *
+ * Predictions:
+ *   (none)
+ *
+ * Hashes (informational only - authoritative values in .uif.json):
+ *   semantic: uif:84f4985dd25893f9bb7e43f6 (informational)
+ *   file: uif:f1297e88a770031270331b9b
+ */
+/**
+ * Utility type guards
+ */
+export function isUIFContract(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'type' in obj &&
+        obj.type === 'UIFContract' &&
+        'schemaVersion' in obj &&
+        obj.schemaVersion === '0.3');
+}
+//# sourceMappingURL=UIFContract.js.map

package/dist/types/UIFContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIFContract.js","sourceRoot":"","sources":["../../src/types/UIFContract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA0GH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACb,GAAG,CAAC,IAAI,KAAK,aAAa;QAC1B,eAAe,IAAI,GAAG;QACtB,GAAG,CAAC,aAAa,KAAK,KAAK,CAC5B,CAAC;AACJ,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Utilities for managing LogicStamp configuration
+ */
+export interface LogicStampConfig {
+    /** User's preference for .gitignore management: "added" | "skipped" */
+    gitignorePreference?: 'added' | 'skipped';
+    /** User's preference for LLM_CONTEXT.md generation: "added" | "skipped" */
+    llmContextPreference?: 'added' | 'skipped';
+}
+/**
+ * Get the config directory path for a project
+ */
+export declare function getConfigDir(projectRoot: string): string;
+/**
+ * Get the config file path for a project
+ */
+export declare function getConfigPath(projectRoot: string): string;
+/**
+ * Check if config file exists
+ */
+export declare function configExists(projectRoot: string): Promise<boolean>;
+/**
+ * Read config from disk
+ */
+export declare function readConfig(projectRoot: string): Promise<LogicStampConfig>;
+/**
+ * Write config to disk
+ */
+export declare function writeConfig(projectRoot: string, config: LogicStampConfig): Promise<void>;
+/**
+ * Update config with new values (merges with existing)
+ */
+export declare function updateConfig(projectRoot: string, updates: Partial<LogicStampConfig>): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ/E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzG"}

package/dist/utils/config.js

@@ -0,0 +1,62 @@
+/**
+ * Utilities for managing LogicStamp configuration
+ */
+import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Get the config directory path for a project
+ */
+export function getConfigDir(projectRoot) {
+    return join(projectRoot, '.logicstamp');
+}
+/**
+ * Get the config file path for a project
+ */
+export function getConfigPath(projectRoot) {
+    return join(getConfigDir(projectRoot), 'config.json');
+}
+/**
+ * Check if config file exists
+ */
+export async function configExists(projectRoot) {
+    try {
+        await access(getConfigPath(projectRoot));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read config from disk
+ */
+export async function readConfig(projectRoot) {
+    try {
+        const configPath = getConfigPath(projectRoot);
+        const content = await readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write config to disk
+ */
+export async function writeConfig(projectRoot, config) {
+    const configDir = getConfigDir(projectRoot);
+    const configPath = getConfigPath(projectRoot);
+    // Ensure config directory exists
+    await mkdir(configDir, { recursive: true });
+    // Write config file
+    await writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Update config with new values (merges with existing)
+ */
+export async function updateConfig(projectRoot, updates) {
+    const existing = await readConfig(projectRoot);
+    const merged = { ...existing, ...updates };
+    await writeConfig(projectRoot, merged);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAC;AAS1C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB,EAAE,MAAwB;IAC7E,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE9C,iCAAiC;IACjC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,oBAAoB;IACpB,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,OAAkC;IACxF,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,MAAM,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/fsx.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @uif Contract 0.3
+ *
+ * Description: fsx - Presentational component
+ *
+ * Version (Component Composition):
+ *   variables: []
+ *   hooks: []
+ *   components: []
+ *   functions: ["deleteSidecar","fileExists","findSidecarFiles","getRelativePath","getSidecarPath","globFiles","normalizeEntryId","readFileWithText","resolvePath"]
+ *   imports: ["glob","node:fs/promises","node:path"]
+ *
+ * Logic Signature:
+ *   props: {}
+ *   events: {}
+ *   state: {}
+ *
+ * Predictions:
+ *   (none)
+ *
+ * Hashes (informational only - authoritative values in .uif.json):
+ *   semantic: uif:80b91273520265259cc8e40e (informational)
+ *   file: uif:f6ee3958ee861ee956f6b5c9
+ */
+export interface FileWithText {
+    path: string;
+    text: string;
+}
+/**
+ * Find files matching glob patterns
+ */
+export declare function globFiles(searchPath: string, extensions?: string): Promise<string[]>;
+/**
+ * Read file and return path + content
+ */
+export declare function readFileWithText(filePath: string): Promise<FileWithText>;
+/**
+ * Find all sidecar files (*.uif.json) in a directory
+ */
+export declare function findSidecarFiles(searchPath: string): Promise<string[]>;
+/**
+ * Delete a sidecar file
+ */
+export declare function deleteSidecar(sidecarPath: string): Promise<void>;
+/**
+ * Get relative path from base directory
+ */
+export declare function getRelativePath(from: string, to: string): string;
+/**
+ * Resolve absolute path
+ */
+export declare function resolvePath(...paths: string[]): string;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Get sidecar path for a source file
+ */
+export declare function getSidecarPath(sourcePath: string, outRoot: string): string;
+/**
+ * Normalize a file path for cross-platform consistency
+ * This is the canonical path normalization used throughout the codebase.
+ * Rules:
+ * - Convert backslashes to forward slashes (POSIX-style)
+ * - Use Node's normalize() to resolve .. and . segments
+ * - On Windows: preserve drive letter but normalize case
+ * - Remove leading ./ if present
+ * - Result should match manifest keys exactly
+ *
+ * This function is the single source of truth for path normalization.
+ * All entryId fields in contracts and manifest keys use this normalization.
+ */
+export declare function normalizeEntryId(entryId: string): string;
+/**
+ * Get the folder path for a given file (parent directory)
+ * Returns normalized folder path
+ */
+export declare function getFolderPath(filePath: string): string;
+/**
+ * Group files by their containing folder
+ * Returns a Map of folderPath -> array of file paths
+ */
+export declare function groupFilesByFolder(files: string[], projectRoot: string): Map<string, string[]>;
+//# sourceMappingURL=fsx.d.ts.map

package/dist/utils/fsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsx.d.ts","sourceRoot":"","sources":["../../src/utils/fsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAmB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAmCnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM5E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAe9F"}