@mmapp/react-compiler 0.1.0-alpha.1 → 0.1.0-alpha.5

package/dist/index.mjs

@@ -13,25 +13,25 @@ import {
   resolveActionReferences,
   resolveImport,
   topologicalSort
-} from "./chunk-ILFGMUVD.mjs";
+} from "./chunk-NTB7OEX2.mjs";
 import {
   decompile,
   decompileProject,
   shouldDecompileAsProject
-} from "./chunk-SU4E6E7B.mjs";
+} from "./chunk-WBYMW4NQ.mjs";
 import {
   createDevServer
-} from "./chunk-NRXQKQ74.mjs";
-import "./chunk-46YKSHQR.mjs";
+} from "./chunk-5GUFFFGL.mjs";
+import "./chunk-EO6SYNCG.mjs";
 import {
   buildEnvelope
-} from "./chunk-FX6URXWN.mjs";
+} from "./chunk-J7JUAHS4.mjs";
 import {
   deploy
-} from "./chunk-EQGA6A6D.mjs";
+} from "./chunk-52XHYD2V.mjs";
 import {
   build
-} from "./chunk-KFGYOOVS.mjs";
+} from "./chunk-THFYE5ZX.mjs";
 import {
   computeEnvelopeId,
   createSourceEnvelope,
@@ -57,8 +57,8 @@ import {
   extractStates,
   extractTransitions,
   transformToFrontend
-} from "./chunk-HLRGCCIL.mjs";
-import "./chunk-Y6FXYEAI.mjs";
+} from "./chunk-OPJKP747.mjs";
+import "./chunk-CIESM3BP.mjs";
 
 // src/babel/emitters/ir-to-tsx-emitter.ts
 function decompileToTSX(definition, options) {
@@ -320,7 +320,214 @@ function validateSourceRoundTrip(source, filename = "test.workflow.tsx") {
   if (!ir) return null;
   return validateRoundTrip(ir);
 }
+
+// src/diagnostics.ts
+var DIAGNOSTIC_CODES = {
+  // -- Flow extractor (imperative workflows) --
+  FLOW001: "No default export async function found",
+  FLOW002: "Workflow function has no typed parameter",
+  FLOW003: "Interface not found for parameter type",
+  FLOW004: "Unknown function call in workflow body",
+  FLOW005: "userAction() without a following state (cannot resolve transition target)",
+  FLOW006: "Import could not be resolved as a service",
+  FLOW007: "validate() with unparseable condition",
+  // -- Middleware extractor --
+  MDLW001: "defineMiddleware() missing required 'name' field",
+  MDLW002: "Invalid match pattern format",
+  MDLW003: "No before/after/around handler defined",
+  // -- Constraint extractor --
+  CNST001: "Unknown built-in constraint name",
+  CNST002: "Empty constraint list",
+  // -- Actor extractor --
+  ACTR001: "Invalid supervision strategy",
+  ACTR002: "spawnActor() called outside workflow function",
+  // -- Hook-based visitor --
+  HOOK001: "Forbidden hook in strict mode",
+  HOOK002: "Raw useEffect in infer mode (component becomes opaque)",
+  HOOK003: "Forbidden import in strict mode",
+  // -- Model extractor --
+  MODL001: "defineModel() missing required fields",
+  MODL002: "Unknown field type in model definition",
+  // -- Emitter --
+  EMIT001: "Empty workflow \u2014 no states, fields, or experience extracted"
+};
+var DiagnosticCollector = class {
+  constructor() {
+    this.diagnostics = [];
+  }
+  /**
+   * Record an error diagnostic.
+   */
+  error(code, message, location, suggestion) {
+    this.diagnostics.push({
+      severity: "error",
+      code,
+      message,
+      file: location?.file,
+      line: location?.line,
+      column: location?.column,
+      suggestion
+    });
+  }
+  /**
+   * Record a warning diagnostic.
+   */
+  warning(code, message, location, suggestion) {
+    this.diagnostics.push({
+      severity: "warning",
+      code,
+      message,
+      file: location?.file,
+      line: location?.line,
+      column: location?.column,
+      suggestion
+    });
+  }
+  /**
+   * Record an informational diagnostic.
+   */
+  info(code, message) {
+    this.diagnostics.push({
+      severity: "info",
+      code,
+      message
+    });
+  }
+  /**
+   * Record a hint diagnostic (always includes a suggestion).
+   */
+  hint(code, message, suggestion) {
+    this.diagnostics.push({
+      severity: "hint",
+      code,
+      message,
+      suggestion
+    });
+  }
+  /**
+   * Whether any error-level diagnostics have been recorded.
+   */
+  hasErrors() {
+    return this.diagnostics.some((d) => d.severity === "error");
+  }
+  /**
+   * Whether any warning-level diagnostics have been recorded.
+   */
+  hasWarnings() {
+    return this.diagnostics.some((d) => d.severity === "warning");
+  }
+  /**
+   * Total number of diagnostics collected.
+   */
+  get count() {
+    return this.diagnostics.length;
+  }
+  /**
+   * Return all collected diagnostics.
+   */
+  getAll() {
+    return [...this.diagnostics];
+  }
+  /**
+   * Return only error-severity diagnostics.
+   */
+  getErrors() {
+    return this.diagnostics.filter((d) => d.severity === "error");
+  }
+  /**
+   * Return only warning-severity diagnostics.
+   */
+  getWarnings() {
+    return this.diagnostics.filter((d) => d.severity === "warning");
+  }
+  /**
+   * Return only info-severity diagnostics.
+   */
+  getInfos() {
+    return this.diagnostics.filter((d) => d.severity === "info");
+  }
+  /**
+   * Return only hint-severity diagnostics.
+   */
+  getHints() {
+    return this.diagnostics.filter((d) => d.severity === "hint");
+  }
+  /**
+   * Merge diagnostics from another collector into this one.
+   */
+  merge(other) {
+    this.diagnostics.push(...other.getAll());
+  }
+  /**
+   * Clear all collected diagnostics.
+   */
+  clear() {
+    this.diagnostics = [];
+  }
+  /**
+   * Pretty-print all diagnostics for terminal output.
+   *
+   * Format:
+   *   error[FLOW001]: No default export async function found
+   *     --> models/task.ts
+   *     = hint: Add `export default async function taskWorkflow(task: Task) { ... }`
+   *
+   *   warning[FLOW004]: Unknown function 'processData' in workflow body
+   *     --> models/order.ts:15:5
+   *     = note: Not a local async function, not imported, and not a stdlib function
+   *     = hint: Did you mean to import it?
+   */
+  format() {
+    if (this.diagnostics.length === 0) return "";
+    const lines = [];
+    for (const d of this.diagnostics) {
+      lines.push(`${d.severity}[${d.code}]: ${d.message}`);
+      if (d.file || d.line != null) {
+        let loc = "  --> ";
+        if (d.file) loc += d.file;
+        if (d.line != null) {
+          loc += (d.file ? ":" : "") + d.line;
+          if (d.column != null) loc += ":" + d.column;
+        }
+        lines.push(loc);
+      }
+      if (d.suggestion) {
+        lines.push(`  = hint: ${d.suggestion}`);
+      }
+      lines.push("");
+    }
+    const errorCount = this.getErrors().length;
+    const warningCount = this.getWarnings().length;
+    const parts = [];
+    if (errorCount > 0) parts.push(`${errorCount} error${errorCount !== 1 ? "s" : ""}`);
+    if (warningCount > 0) parts.push(`${warningCount} warning${warningCount !== 1 ? "s" : ""}`);
+    if (parts.length > 0) {
+      lines.push(parts.join(", ") + " emitted");
+    }
+    return lines.join("\n");
+  }
+  /**
+   * Machine-readable JSON representation.
+   */
+  toJSON() {
+    return {
+      diagnostics: this.getAll(),
+      summary: {
+        errors: this.getErrors().length,
+        warnings: this.getWarnings().length,
+        infos: this.getInfos().length,
+        hints: this.getHints().length,
+        total: this.diagnostics.length
+      }
+    };
+  }
+};
+function createDiagnosticCollector() {
+  return new DiagnosticCollector();
+}
 export {
+  DIAGNOSTIC_CODES,
+  DiagnosticCollector,
   IncrementalCache,
   IncrementalProjectCompiler,
   babelPlugin,
@@ -336,6 +543,7 @@ export {
   computeEnvelopeId,
   computeTransitiveDirtySet,
   createDevServer,
+  createDiagnosticCollector,
   createSourceEnvelope,
   createVisitor,
   decompile,

package/{src/cli/init.ts → dist/init-7JQMAAXS.mjs}

@@ -1,73 +1,40 @@
-/**
- * CLI Init Command — scaffolds a new blueprint package.
- *
- * Usage:
- *   mmrc init <name> [--description "..."] [--icon "..."] [--author "..."]
- *
- * Creates:
- *   packages/blueprint-<name>/
- *   ├── package.json
- *   ├── mm.config.ts
- *   ├── models/
- *   │   └── item.ts
- *   └── app/
- *       ├── layout.tsx
- *       └── page.tsx
- */
+import "./chunk-Y6FXYEAI.mjs";
 
-import { mkdirSync, writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-export interface InitOptions {
-  name: string;
-  description?: string;
-  icon?: string;
-  author?: string;
+// src/cli/init.ts
+import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+function toTitleCase(slug) {
+  return slug.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
-
-/** Convert "my-app" to "My App" */
-function toTitleCase(slug: string): string {
-  return slug
-    .split('-')
-    .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-    .join(' ');
+function toPascalCase(slug) {
+  return slug.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
 }
-
-/** Convert "my-app" to "MyApp" */
-function toPascalCase(slug: string): string {
-  return slug
-    .split('-')
-    .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-    .join('');
-}
-
-function generatePackageJson(name: string): string {
+function generatePackageJson(name) {
   return JSON.stringify(
     {
       name: `@mindmatrix/blueprint-${name}`,
-      version: '0.1.0',
+      version: "0.1.0",
       private: true,
-      type: 'module',
+      type: "module",
       scripts: {
-        build: 'mmrc build --src . --out dist',
-        dev: 'mmrc dev --src . --port 5199',
-        deploy: 'mmrc deploy --build --src .',
+        build: "mmrc build --src . --out dist",
+        dev: "mmrc dev --src . --port 5199",
+        deploy: "mmrc deploy --build --src ."
       },
       dependencies: {
-        '@mindmatrix/react': 'workspace:*',
-      },
+        "@mmapp/react": "^0.1.0-alpha.1"
+      }
     },
     null,
-    2,
+    2
   );
 }
-
-function generateMmConfig(name: string, opts: InitOptions): string {
+function generateMmConfig(name, opts) {
   const title = toTitleCase(name);
   const desc = opts.description ?? `${title} blueprint.`;
-  const icon = opts.icon ?? 'box';
-  const author = opts.author ?? 'MindMatrix';
-  return `import { defineBlueprint } from '@mindmatrix/react';
+  const icon = opts.icon ?? "box";
+  const author = opts.author ?? "MindMatrix";
+  return `import { defineBlueprint } from '@mmapp/react';
 
 export default defineBlueprint({
   slug: '${name}',
@@ -91,18 +58,16 @@ export default defineBlueprint({
 });
 `;
 }
-
-function generateModel(name: string): string {
+function generateModel(name) {
   const modelSlug = `${name}-item`;
   const pascal = toPascalCase(name);
-
   return `/**
- * ${pascal} Item — data model with lifecycle states.
+ * ${pascal} Item \u2014 data model with lifecycle states.
  *
- * States: draft → active → archived
+ * States: draft \u2192 active \u2192 archived
  */
 
-import { defineModel } from '@mindmatrix/react';
+import { defineModel } from '@mmapp/react';
 
 export interface ${pascal}ItemFields {
   title: string;
@@ -155,10 +120,30 @@ export default defineModel({
 });
 `;
 }
-
-function generateLayout(name: string): string {
+function generateTsconfig() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        target: "ES2020",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        jsx: "react-jsx",
+        strict: true,
+        esModuleInterop: true,
+        skipLibCheck: true,
+        forceConsistentCasingInFileNames: true,
+        declaration: false,
+        noEmit: true
+      },
+      include: ["**/*.ts", "**/*.tsx"],
+      exclude: ["node_modules", "dist"]
+    },
+    null,
+    2
+  );
+}
+function generateLayout(name) {
   const title = toTitleCase(name);
-
   return `/**
  * @workflow slug="${name}-layout" version="1.0.0" category="view"
  *
@@ -173,8 +158,8 @@ import {
   Icon,
   Button,
   Divider,
-} from '@mindmatrix/react/atoms';
-import { useRouter } from '@mindmatrix/react';
+} from '@mmapp/react/atoms';
+import { useRouter } from '@mmapp/react';
 
 export default function Layout({ children }: { children: React.ReactNode }) {
   const router = useRouter();
@@ -224,22 +209,20 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 }
 `;
 }
-
-function generatePage(name: string): string {
+function generatePage(name) {
   const title = toTitleCase(name);
   const pascal = toPascalCase(name);
-
   return `/**
  * @workflow slug="${name}-home" version="1.0.0" category="page"
  *
- * Index page — lists items with create and search.
+ * Index page \u2014 lists items with create and search.
  */
 
 import itemModel from '../models/item';
 import {
   useQuery, useMutation, useRouter, useState,
   Stack, Row, Text, Button, Icon, Card, Show, Each, TextInput, Badge,
-} from '@mindmatrix/react';
+} from '@mmapp/react';
 
 const PRIORITY_COLORS: Record<string, string> = {
   high: 'token:error',
@@ -333,47 +316,36 @@ export default function ${pascal}Home() {
 }
 `;
 }
-
-export async function init(options: InitOptions): Promise<void> {
+async function init(options) {
   const { name } = options;
-
-  // Validate name
   if (!/^[a-z][a-z0-9-]*$/.test(name)) {
     console.error(`[mmrc] Error: Blueprint name must be lowercase alphanumeric with hyphens (got "${name}")`);
     process.exit(1);
   }
-
-  // Determine output directory — look for packages/ directory (monorepo) or use cwd
   const cwd = process.cwd();
-  const packagesDir = existsSync(join(cwd, 'packages')) ? join(cwd, 'packages') : cwd;
+  const packagesDir = existsSync(join(cwd, "packages")) ? join(cwd, "packages") : cwd;
   const blueprintDir = join(packagesDir, `blueprint-${name}`);
-
   if (existsSync(blueprintDir)) {
     console.error(`[mmrc] Error: Directory already exists: ${blueprintDir}`);
     process.exit(1);
   }
-
-  console.log(`[mmrc] Creating blueprint: ${name}\n`);
-
-  // Create directories
-  mkdirSync(join(blueprintDir, 'models'), { recursive: true });
-  mkdirSync(join(blueprintDir, 'app'), { recursive: true });
-
-  // Write files
-  const files: Array<[string, string]> = [
-    ['package.json', generatePackageJson(name)],
-    ['mm.config.ts', generateMmConfig(name, options)],
-    ['models/item.ts', generateModel(name)],
-    ['app/layout.tsx', generateLayout(name)],
-    ['app/page.tsx', generatePage(name)],
+  console.log(`[mmrc] Creating blueprint: ${name}
+`);
+  mkdirSync(join(blueprintDir, "models"), { recursive: true });
+  mkdirSync(join(blueprintDir, "app"), { recursive: true });
+  const files = [
+    ["package.json", generatePackageJson(name)],
+    ["tsconfig.json", generateTsconfig()],
+    ["mm.config.ts", generateMmConfig(name, options)],
+    ["models/item.ts", generateModel(name)],
+    ["app/layout.tsx", generateLayout(name)],
+    ["app/page.tsx", generatePage(name)]
   ];
-
   for (const [relPath, content] of files) {
     const fullPath = join(blueprintDir, relPath);
-    writeFileSync(fullPath, content, 'utf-8');
+    writeFileSync(fullPath, content, "utf-8");
     console.log(`  + ${relPath}`);
   }
-
   const title = toTitleCase(name);
   console.log(`
 [mmrc] Blueprint "${title}" created at:
@@ -386,3 +358,6 @@ Next steps:
   4. mmrc deploy --build         # Build + deploy to backend
 `);
 }
+export {
+  init
+};