@mmapp/react-compiler 0.1.0-alpha.16 → 0.1.0-alpha.17

package/dist/envelope-DD7v0v6E.d.mts

@@ -1,265 +0,0 @@
-import { IRWorkflowDefinition } from '@mindmatrix/player-core';
-
-/**
- * File System Tree — generates a manifest of project files with roles and hashes.
- *
- * The fs.tree is the first component of the source envelope.
- * It maps every source file to its role in the workflow project.
- *
- * Roles:
- * - view-entry: .workflow.tsx files (main workflow components)
- * - model: models/*.ts files (workflow definitions)
- * - server-action: *.server.ts files (backend action handlers)
- * - layout: layout.tsx files (route layout boundaries)
- * - page: page.tsx files (route page components)
- * - config: mm.config.ts, blueprint.config.ts
- * - component: regular .tsx components used by workflows
- * - asset: static assets (images, styles, etc.)
- * - unknown: unclassified files
- */
-type FileRole = 'view-entry' | 'model' | 'server-action' | 'layout' | 'page' | 'config' | 'component' | 'test' | 'asset' | 'unknown';
-interface FsTreeEntry {
-    /** Relative path from project root. */
-    path: string;
-    /** File role in the workflow project. */
-    role: FileRole;
-    /** SHA-256 content hash. */
-    hash: string;
-    /** File size in bytes. */
-    size: number;
-    /** Last modified timestamp. */
-    mtime: string;
-    /** Workflow slug (for view-entry and model files). */
-    slug?: string;
-}
-interface FsTree {
-    /** fs.tree format version. */
-    version: 1;
-    /** Project root directory (absolute). */
-    root: string;
-    /** Timestamp when the tree was generated. */
-    generatedAt: string;
-    /** File entries. */
-    entries: FsTreeEntry[];
-    /** Summary statistics. */
-    summary: {
-        totalFiles: number;
-        byRole: Record<FileRole, number>;
-        totalSize: number;
-    };
-}
-/**
- * Determines the role of a file based on its path and naming convention.
- */
-declare function detectFileRole(relativePath: string): FileRole;
-/**
- * Generates an FsTree from a list of file paths.
- */
-declare function generateFsTree(files: string[], rootDir: string): FsTree;
-/**
- * Filters an FsTree to only include specific roles.
- */
-declare function filterByRole(tree: FsTree, roles: FileRole[]): FsTreeEntry[];
-/**
- * Finds changed files between two FsTree snapshots.
- */
-declare function diffFsTrees(before: FsTree, after: FsTree): {
-    added: FsTreeEntry[];
-    removed: FsTreeEntry[];
-    modified: FsTreeEntry[];
-};
-
-/**
- * Source Envelope — bundles compiled workflows with source metadata.
- *
- * A source envelope is the unit of deployment. It contains:
- * 1. All compiled workflow definitions (IR)
- * 2. File manifest (fs.tree) with content hashes
- * 3. Source bindings (semantic refs ↔ file spans)
- * 4. Deployment metadata (version, timestamp, environment)
- *
- * The envelope enables:
- * - Immutable versioning (content-addressed)
- * - Source-level debugging (map IR back to .tsx source)
- * - Differential deployment (only deploy changed workflows)
- * - P2P sync (envelope is the unit of transfer)
- */
-
-interface SourceEnvelope {
-    /** Envelope format version. */
-    version: 1;
-    /** Content-addressed envelope ID (SHA-256 of canonical content). */
-    envelopeId: string;
-    /** Blueprint slug this envelope belongs to. */
-    blueprintSlug: string;
-    /** Blueprint version. */
-    blueprintVersion: string;
-    /** When the envelope was created. */
-    createdAt: string;
-    /** Deployment target environment. */
-    environment?: string;
-    /** Compiled workflow definitions. */
-    definitions: IRWorkflowDefinition[];
-    /** File manifest. */
-    fsTree: FsTree;
-    /** Source bindings (IR element → source location). */
-    sourceBindings: SourceBinding[];
-    /** Deployment metadata. */
-    metadata: EnvelopeMetadata;
-}
-/**
- * Maps an IR element to its source location.
- */
-interface SourceBinding {
-    /** Type of IR element. */
-    kind: 'field' | 'state' | 'transition' | 'action' | 'component' | 'grammar-island';
-    /** Name/ID of the element. */
-    name: string;
-    /** Workflow slug this binding belongs to. */
-    workflowSlug: string;
-    /** Source file path (relative). */
-    file: string;
-    /** Start line (1-based). */
-    startLine: number;
-    /** Start column (0-based). */
-    startColumn: number;
-    /** End line (1-based). */
-    endLine?: number;
-    /** End column (0-based). */
-    endColumn?: number;
-}
-/**
- * Deployment metadata.
- */
-interface EnvelopeMetadata {
-    /** Total number of workflow definitions. */
-    definitionCount: number;
-    /** Total number of fields across all definitions. */
-    totalFields: number;
-    /** Total number of states across all definitions. */
-    totalStates: number;
-    /** Total number of transitions across all definitions. */
-    totalTransitions: number;
-    /** Compiler version. */
-    compilerVersion: string;
-    /** Build mode. */
-    mode: 'strict' | 'infer';
-    /** Whether any errors were detected. */
-    hasErrors: boolean;
-    /** Error/warning summary. */
-    diagnostics: DiagnosticSummary;
-}
-interface DiagnosticSummary {
-    errors: number;
-    warnings: number;
-    errorCodes: string[];
-}
-/**
- * Creates a source envelope from compiled definitions.
- */
-declare function createSourceEnvelope(params: {
-    blueprintSlug: string;
-    blueprintVersion: string;
-    definitions: IRWorkflowDefinition[];
-    fsTree: FsTree;
-    sourceBindings?: SourceBinding[];
-    environment?: string;
-    mode?: 'strict' | 'infer';
-    compilerVersion?: string;
-}): SourceEnvelope;
-/**
- * Computes a content-addressed ID for an envelope.
- * Uses SHA-256 of the canonical JSON (sorted keys, no whitespace).
- */
-declare function computeEnvelopeId(envelope: SourceEnvelope): string;
-/**
- * Checks if two envelopes have the same content (ignoring timestamps).
- */
-declare function envelopesEqual(a: SourceEnvelope, b: SourceEnvelope): boolean;
-/**
- * Finds definitions that changed between two envelopes.
- */
-declare function diffEnvelopes(before: SourceEnvelope, after: SourceEnvelope): {
-    added: string[];
-    removed: string[];
-    modified: string[];
-    unchanged: string[];
-};
-
-/**
- * Envelope Builder — walks a project directory, compiles all .workflow.tsx files,
- * and produces a content-addressed SHA-256 deployment bundle.
- *
- * This is the high-level API that combines:
- *   - File discovery (fs-tree)
- *   - Compilation (babel plugin)
- *   - Source binding extraction
- *   - Content-addressed envelope creation
- *
- * Usage:
- *   import { buildEnvelope } from '@mindmatrix/react-compiler';
- *   const envelope = await buildEnvelope('./src/workflows', { slug: 'my-app' });
- *   // envelope.manifest.hash === 'a1b2c3...' (SHA-256)
- */
-
-interface EnvelopeManifest {
-    /** Content-addressed SHA-256 hash of the entire envelope. */
-    hash: string;
-    /** Files included in the envelope (relative paths). */
-    files: EnvelopeFile[];
-    /** Blueprint version string. */
-    version: string;
-    /** ISO 8601 timestamp. */
-    timestamp: string;
-    /** Total compiled definitions. */
-    definitionCount: number;
-    /** Total compilation errors. */
-    errorCount: number;
-}
-interface EnvelopeFile {
-    /** Relative path from project root. */
-    path: string;
-    /** SHA-256 hash of file content. */
-    hash: string;
-    /** File size in bytes. */
-    size: number;
-    /** Workflow slug (if this file produced a definition). */
-    slug?: string;
-    /** Whether compilation succeeded for this file. */
-    compiled: boolean;
-}
-interface BuildEnvelopeOptions {
-    /** Blueprint slug. Default: basename of projectDir */
-    slug?: string;
-    /** Blueprint version. Default: '0.1.0' */
-    version?: string;
-    /** Compilation mode. Default: 'infer' */
-    mode?: 'strict' | 'infer';
-    /** Glob patterns for files to include. Default: discovers all workflow-related files */
-    include?: string[];
-    /** Environment tag. Default: undefined */
-    environment?: string;
-}
-interface BuildEnvelopeResult {
-    /** The complete source envelope. */
-    envelope: SourceEnvelope;
-    /** Content-addressed manifest for the bundle. */
-    manifest: EnvelopeManifest;
-    /** Individual file compilation results. */
-    files: EnvelopeFile[];
-    /** Definitions that compiled successfully. */
-    definitions: IRWorkflowDefinition[];
-    /** Compilation errors. */
-    errors: Array<{
-        file: string;
-        message: string;
-        line?: number;
-    }>;
-}
-/**
- * Walk a project directory, compile all workflow files, and produce a
- * content-addressed deployment bundle.
- */
-declare function buildEnvelope(projectDir: string, options?: BuildEnvelopeOptions): Promise<BuildEnvelopeResult>;
-
-export { type BuildEnvelopeOptions as B, type EnvelopeManifest as E, type FileRole as F, type SourceEnvelope as S, type EnvelopeFile as a, buildEnvelope as b, type BuildEnvelopeResult as c, createSourceEnvelope as d, computeEnvelopeId as e, envelopesEqual as f, diffEnvelopes as g, type SourceBinding as h, type EnvelopeMetadata as i, generateFsTree as j, detectFileRole as k, filterByRole as l, diffFsTrees as m, type FsTree as n, type FsTreeEntry as o };

package/dist/envelope-DD7v0v6E.d.ts

@@ -1,265 +0,0 @@
-import { IRWorkflowDefinition } from '@mindmatrix/player-core';
-
-/**
- * File System Tree — generates a manifest of project files with roles and hashes.
- *
- * The fs.tree is the first component of the source envelope.
- * It maps every source file to its role in the workflow project.
- *
- * Roles:
- * - view-entry: .workflow.tsx files (main workflow components)
- * - model: models/*.ts files (workflow definitions)
- * - server-action: *.server.ts files (backend action handlers)
- * - layout: layout.tsx files (route layout boundaries)
- * - page: page.tsx files (route page components)
- * - config: mm.config.ts, blueprint.config.ts
- * - component: regular .tsx components used by workflows
- * - asset: static assets (images, styles, etc.)
- * - unknown: unclassified files
- */
-type FileRole = 'view-entry' | 'model' | 'server-action' | 'layout' | 'page' | 'config' | 'component' | 'test' | 'asset' | 'unknown';
-interface FsTreeEntry {
-    /** Relative path from project root. */
-    path: string;
-    /** File role in the workflow project. */
-    role: FileRole;
-    /** SHA-256 content hash. */
-    hash: string;
-    /** File size in bytes. */
-    size: number;
-    /** Last modified timestamp. */
-    mtime: string;
-    /** Workflow slug (for view-entry and model files). */
-    slug?: string;
-}
-interface FsTree {
-    /** fs.tree format version. */
-    version: 1;
-    /** Project root directory (absolute). */
-    root: string;
-    /** Timestamp when the tree was generated. */
-    generatedAt: string;
-    /** File entries. */
-    entries: FsTreeEntry[];
-    /** Summary statistics. */
-    summary: {
-        totalFiles: number;
-        byRole: Record<FileRole, number>;
-        totalSize: number;
-    };
-}
-/**
- * Determines the role of a file based on its path and naming convention.
- */
-declare function detectFileRole(relativePath: string): FileRole;
-/**
- * Generates an FsTree from a list of file paths.
- */
-declare function generateFsTree(files: string[], rootDir: string): FsTree;
-/**
- * Filters an FsTree to only include specific roles.
- */
-declare function filterByRole(tree: FsTree, roles: FileRole[]): FsTreeEntry[];
-/**
- * Finds changed files between two FsTree snapshots.
- */
-declare function diffFsTrees(before: FsTree, after: FsTree): {
-    added: FsTreeEntry[];
-    removed: FsTreeEntry[];
-    modified: FsTreeEntry[];
-};
-
-/**
- * Source Envelope — bundles compiled workflows with source metadata.
- *
- * A source envelope is the unit of deployment. It contains:
- * 1. All compiled workflow definitions (IR)
- * 2. File manifest (fs.tree) with content hashes
- * 3. Source bindings (semantic refs ↔ file spans)
- * 4. Deployment metadata (version, timestamp, environment)
- *
- * The envelope enables:
- * - Immutable versioning (content-addressed)
- * - Source-level debugging (map IR back to .tsx source)
- * - Differential deployment (only deploy changed workflows)
- * - P2P sync (envelope is the unit of transfer)
- */
-
-interface SourceEnvelope {
-    /** Envelope format version. */
-    version: 1;
-    /** Content-addressed envelope ID (SHA-256 of canonical content). */
-    envelopeId: string;
-    /** Blueprint slug this envelope belongs to. */
-    blueprintSlug: string;
-    /** Blueprint version. */
-    blueprintVersion: string;
-    /** When the envelope was created. */
-    createdAt: string;
-    /** Deployment target environment. */
-    environment?: string;
-    /** Compiled workflow definitions. */
-    definitions: IRWorkflowDefinition[];
-    /** File manifest. */
-    fsTree: FsTree;
-    /** Source bindings (IR element → source location). */
-    sourceBindings: SourceBinding[];
-    /** Deployment metadata. */
-    metadata: EnvelopeMetadata;
-}
-/**
- * Maps an IR element to its source location.
- */
-interface SourceBinding {
-    /** Type of IR element. */
-    kind: 'field' | 'state' | 'transition' | 'action' | 'component' | 'grammar-island';
-    /** Name/ID of the element. */
-    name: string;
-    /** Workflow slug this binding belongs to. */
-    workflowSlug: string;
-    /** Source file path (relative). */
-    file: string;
-    /** Start line (1-based). */
-    startLine: number;
-    /** Start column (0-based). */
-    startColumn: number;
-    /** End line (1-based). */
-    endLine?: number;
-    /** End column (0-based). */
-    endColumn?: number;
-}
-/**
- * Deployment metadata.
- */
-interface EnvelopeMetadata {
-    /** Total number of workflow definitions. */
-    definitionCount: number;
-    /** Total number of fields across all definitions. */
-    totalFields: number;
-    /** Total number of states across all definitions. */
-    totalStates: number;
-    /** Total number of transitions across all definitions. */
-    totalTransitions: number;
-    /** Compiler version. */
-    compilerVersion: string;
-    /** Build mode. */
-    mode: 'strict' | 'infer';
-    /** Whether any errors were detected. */
-    hasErrors: boolean;
-    /** Error/warning summary. */
-    diagnostics: DiagnosticSummary;
-}
-interface DiagnosticSummary {
-    errors: number;
-    warnings: number;
-    errorCodes: string[];
-}
-/**
- * Creates a source envelope from compiled definitions.
- */
-declare function createSourceEnvelope(params: {
-    blueprintSlug: string;
-    blueprintVersion: string;
-    definitions: IRWorkflowDefinition[];
-    fsTree: FsTree;
-    sourceBindings?: SourceBinding[];
-    environment?: string;
-    mode?: 'strict' | 'infer';
-    compilerVersion?: string;
-}): SourceEnvelope;
-/**
- * Computes a content-addressed ID for an envelope.
- * Uses SHA-256 of the canonical JSON (sorted keys, no whitespace).
- */
-declare function computeEnvelopeId(envelope: SourceEnvelope): string;
-/**
- * Checks if two envelopes have the same content (ignoring timestamps).
- */
-declare function envelopesEqual(a: SourceEnvelope, b: SourceEnvelope): boolean;
-/**
- * Finds definitions that changed between two envelopes.
- */
-declare function diffEnvelopes(before: SourceEnvelope, after: SourceEnvelope): {
-    added: string[];
-    removed: string[];
-    modified: string[];
-    unchanged: string[];
-};
-
-/**
- * Envelope Builder — walks a project directory, compiles all .workflow.tsx files,
- * and produces a content-addressed SHA-256 deployment bundle.
- *
- * This is the high-level API that combines:
- *   - File discovery (fs-tree)
- *   - Compilation (babel plugin)
- *   - Source binding extraction
- *   - Content-addressed envelope creation
- *
- * Usage:
- *   import { buildEnvelope } from '@mindmatrix/react-compiler';
- *   const envelope = await buildEnvelope('./src/workflows', { slug: 'my-app' });
- *   // envelope.manifest.hash === 'a1b2c3...' (SHA-256)
- */
-
-interface EnvelopeManifest {
-    /** Content-addressed SHA-256 hash of the entire envelope. */
-    hash: string;
-    /** Files included in the envelope (relative paths). */
-    files: EnvelopeFile[];
-    /** Blueprint version string. */
-    version: string;
-    /** ISO 8601 timestamp. */
-    timestamp: string;
-    /** Total compiled definitions. */
-    definitionCount: number;
-    /** Total compilation errors. */
-    errorCount: number;
-}
-interface EnvelopeFile {
-    /** Relative path from project root. */
-    path: string;
-    /** SHA-256 hash of file content. */
-    hash: string;
-    /** File size in bytes. */
-    size: number;
-    /** Workflow slug (if this file produced a definition). */
-    slug?: string;
-    /** Whether compilation succeeded for this file. */
-    compiled: boolean;
-}
-interface BuildEnvelopeOptions {
-    /** Blueprint slug. Default: basename of projectDir */
-    slug?: string;
-    /** Blueprint version. Default: '0.1.0' */
-    version?: string;
-    /** Compilation mode. Default: 'infer' */
-    mode?: 'strict' | 'infer';
-    /** Glob patterns for files to include. Default: discovers all workflow-related files */
-    include?: string[];
-    /** Environment tag. Default: undefined */
-    environment?: string;
-}
-interface BuildEnvelopeResult {
-    /** The complete source envelope. */
-    envelope: SourceEnvelope;
-    /** Content-addressed manifest for the bundle. */
-    manifest: EnvelopeManifest;
-    /** Individual file compilation results. */
-    files: EnvelopeFile[];
-    /** Definitions that compiled successfully. */
-    definitions: IRWorkflowDefinition[];
-    /** Compilation errors. */
-    errors: Array<{
-        file: string;
-        message: string;
-        line?: number;
-    }>;
-}
-/**
- * Walk a project directory, compile all workflow files, and produce a
- * content-addressed deployment bundle.
- */
-declare function buildEnvelope(projectDir: string, options?: BuildEnvelopeOptions): Promise<BuildEnvelopeResult>;
-
-export { type BuildEnvelopeOptions as B, type EnvelopeManifest as E, type FileRole as F, type SourceEnvelope as S, type EnvelopeFile as a, buildEnvelope as b, type BuildEnvelopeResult as c, createSourceEnvelope as d, computeEnvelopeId as e, envelopesEqual as f, diffEnvelopes as g, type SourceBinding as h, type EnvelopeMetadata as i, generateFsTree as j, detectFileRole as k, filterByRole as l, diffFsTrees as m, type FsTree as n, type FsTreeEntry as o };