@mmapp/react-compiler 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/index.mjs

@@ -13,25 +13,25 @@ import {
   resolveActionReferences,
   resolveImport,
   topologicalSort
-} from "./chunk-EJRBDQDP.mjs";
+} from "./chunk-JRGFBWTN.mjs";
 import {
   decompile,
   decompileProject,
   shouldDecompileAsProject
-} from "./chunk-FKRO52XH.mjs";
+} from "./chunk-XDVM4YHX.mjs";
 import {
   createDevServer
-} from "./chunk-GCLGPOJZ.mjs";
-import "./chunk-72QWL54I.mjs";
+} from "./chunk-UDDTWG5J.mjs";
+import "./chunk-BZEXUPDH.mjs";
 import {
   buildEnvelope
-} from "./chunk-JLA5VNQ3.mjs";
+} from "./chunk-R2DD5GTY.mjs";
 import {
   deploy
-} from "./chunk-EQGA6A6D.mjs";
+} from "./chunk-ABYPKRSB.mjs";
 import {
   build
-} from "./chunk-5RKTOVR5.mjs";
+} from "./chunk-VLTKQDJ3.mjs";
 import {
   computeEnvelopeId,
   createSourceEnvelope,
@@ -57,7 +57,7 @@ import {
   extractStates,
   extractTransitions,
   transformToFrontend
-} from "./chunk-FYT47UBU.mjs";
+} from "./chunk-7T6Q5KAA.mjs";
 import "./chunk-CIESM3BP.mjs";
 
 // src/babel/emitters/ir-to-tsx-emitter.ts
@@ -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/dist/init-7FJENUDK.mjs

@@ -0,0 +1,407 @@
+import "./chunk-CIESM3BP.mjs";
+
+// src/cli/init.ts
+import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+function toTitleCase(slug) {
+  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("");
+}
+function generatePackageJson(name) {
+  return JSON.stringify(
+    {
+      name: `@mmapp/blueprint-${name}`,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        build: "mmrc build --src . --out dist",
+        dev: "mmrc dev --src . --port 5199",
+        deploy: "mmrc deploy --build --src ."
+      },
+      dependencies: {
+        "@mmapp/react": "^0.1.0-alpha.1"
+      },
+      devDependencies: {
+        typescript: "^5.5.0",
+        "@types/react": "^18.0.0",
+        react: "^18.0.0"
+      }
+    },
+    null,
+    2
+  );
+}
+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 '@mmapp/react';
+
+export default defineBlueprint({
+  slug: '${name}',
+  name: '${title}',
+  version: '1.0.0',
+  description: '${desc}',
+  author: '${author}',
+  icon: '${icon}',
+  mode: 'infer',
+  defaultRuntime: 'collaborative',
+
+  models: [
+    'models/item',
+  ],
+
+  routes: [
+    { path: '/', view: 'app/page', label: 'Home' },
+  ],
+
+  dependencies: [],
+});
+`;
+}
+function generateModel(name) {
+  const modelSlug = `${name}-item`;
+  const pascal = toPascalCase(name);
+  return `/**
+ * ${pascal} Item \u2014 data model with lifecycle states.
+ *
+ * States: draft \u2192 active \u2192 archived
+ */
+
+import { defineModel } from '@mmapp/react';
+
+export interface ${pascal}ItemFields {
+  title: string;
+  description: string;
+  priority: 'low' | 'medium' | 'high';
+  createdAt: number;
+}
+
+export default defineModel({
+  slug: '${modelSlug}',
+  version: '1.0.0',
+  category: ['model', '${name}'],
+
+  fields: {
+    title: { type: 'string', required: true },
+    description: { type: 'string', default: '' },
+    priority: { type: 'string', default: 'medium', enum: ['low', 'medium', 'high'] },
+    createdAt: { type: 'number', default: 0 },
+  },
+
+  states: {
+    draft: {
+      type: 'initial',
+      onEnter: [
+        { id: 'set-created', type: 'set_field', mode: 'auto', config: { field: 'createdAt', expression: 'NOW()' } },
+      ],
+    },
+    active: {
+      onEnter: [
+        { id: 'log-activated', type: 'log_event', mode: 'auto', config: { event: '${modelSlug}.activated' } },
+      ],
+    },
+    archived: {
+      type: 'end',
+    },
+  },
+
+  transitions: {
+    activate: {
+      from: 'draft',
+      to: 'active',
+      description: 'Publish this item',
+    },
+    archive: {
+      from: 'active',
+      to: 'archived',
+      description: 'Archive this item',
+    },
+  },
+});
+`;
+}
+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"
+ *
+ * Root layout with sidebar navigation.
+ */
+
+import {
+  Row,
+  Stack,
+  Slot,
+  Text,
+  Icon,
+  Button,
+  Divider,
+} from '@mmapp/react/atoms';
+import { useRouter } from '@mmapp/react';
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  const router = useRouter();
+
+  return (
+    <Row gap={0} height="100vh" overflow="hidden">
+      {/* Sidebar */}
+      <Stack
+        width={240}
+        borderRight="1px solid token:border"
+        height="100vh"
+        background="token:surface"
+      >
+        <Row padding={12} gap={8} align="center" borderBottom="1px solid token:border">
+          <Icon name="box" size={20} color="token:primary" />
+          <Text variant="label" size="sm" value="${title}" />
+        </Row>
+
+        <Stack padding={8} gap={4}>
+          <Button variant="ghost" onPress={() => router.push('/')}>
+            <Row gap={8} align="center">
+              <Icon name="home" size={16} />
+              <Text size="sm" value="Home" />
+            </Row>
+          </Button>
+          <Button variant="ghost" onPress={() => router.push('/settings')}>
+            <Row gap={8} align="center">
+              <Icon name="settings" size={16} />
+              <Text size="sm" value="Settings" />
+            </Row>
+          </Button>
+        </Stack>
+
+        <Divider />
+        <Stack flex={1} />
+        <Row padding={12}>
+          <Text variant="muted" size="xs" value="v1.0.0" />
+        </Row>
+      </Stack>
+
+      {/* Main content */}
+      <Stack flex={1} overflow="auto">
+        {children}
+      </Stack>
+    </Row>
+  );
+}
+`;
+}
+function generatePage(name) {
+  const title = toTitleCase(name);
+  const pascal = toPascalCase(name);
+  return `/**
+ * @workflow slug="${name}-home" version="1.0.0" category="page"
+ *
+ * Index page \u2014 lists items with create and search.
+ */
+
+import { useState } from 'react';
+import itemModel from '../models/item';
+import {
+  useQuery, useMutation, useRouter,
+  Stack, Row, Text, Button, Icon, Card, Show, TextInput, Badge,
+} from '@mmapp/react';
+
+const PRIORITY_COLORS: Record<string, string> = {
+  high: 'token:error',
+  medium: 'token:warning',
+  low: 'token:success',
+};
+
+export default function ${pascal}Home() {
+  const { data: items, loading } = useQuery(itemModel);
+  const mutation = useMutation(itemModel);
+  const router = useRouter();
+  const [search, setSearch] = useState('');
+
+  const activeItems = items.filter(i => i.state !== 'archived');
+  const filtered = activeItems.filter(i =>
+    i.fields.title.toLowerCase().includes(search.toLowerCase())
+  );
+
+  const handleCreate = async () => {
+    await mutation.create({ title: 'New Item', priority: 'medium' });
+  };
+
+  return (
+    <Stack gap={24} padding={24}>
+      {/* Header */}
+      <Row justify="space-between" align="center">
+        <Stack gap={4}>
+          <Text variant="h3" weight="bold" value="${title}" />
+          <Text variant="muted" size="sm" value={\`\${activeItems.length} items\`} />
+        </Stack>
+        <Button variant="primary" onPress={handleCreate}>
+          <Row gap={6} align="center">
+            <Icon name="plus" size={16} />
+            <Text value="Add Item" />
+          </Row>
+        </Button>
+      </Row>
+
+      {/* Search */}
+      <TextInput
+        value={search}
+        onChange={setSearch}
+        placeholder="Search items..."
+      />
+
+      {/* Loading */}
+      <Show when={loading}>
+        <Card padding={32}>
+          <Stack align="center">
+            <Text variant="muted" value="Loading..." />
+          </Stack>
+        </Card>
+      </Show>
+
+      {/* Empty state */}
+      <Show when={!loading && filtered.length === 0}>
+        <Card padding={32}>
+          <Stack align="center" gap={12}>
+            <Icon name="inbox" size={40} color="token:muted" />
+            <Text variant="muted" value="No items yet" />
+            <Button variant="outline" onPress={handleCreate}>
+              <Text value="Create your first item" />
+            </Button>
+          </Stack>
+        </Card>
+      </Show>
+
+      {/* Item list */}
+      <Show when={!loading && filtered.length > 0}>
+        <Stack gap={4}>
+          {filtered.map((item: any) => (
+            <Card key={item.id} padding={12}>
+              <Row align="center" gap={12}>
+                <Stack flex={1} gap={2}>
+                  <Text weight="medium" value={item.fields.title} />
+                  <Show when={!!item.fields.description}>
+                    <Text size="sm" variant="muted" value={item.fields.description} />
+                  </Show>
+                </Stack>
+                <Badge value={item.fields.priority} />
+                <Badge value={item.state} variant={item.state === 'active' ? 'success' : 'default'} />
+              </Row>
+            </Card>
+          ))}
+        </Stack>
+      </Show>
+    </Stack>
+  );
+}
+`;
+}
+function generateGitignore() {
+  return `node_modules
+dist
+dev.db
+.env
+.env.local
+.env.*.local
+*.log
+.DS_Store
+`;
+}
+function isInsideGitRepo(dir) {
+  try {
+    execSync("git rev-parse --git-dir", { cwd: dir, stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function scaffoldGit(dir) {
+  if (isInsideGitRepo(dir)) {
+    return "Skipped git init (inside existing repo)";
+  }
+  try {
+    execSync("git init", { cwd: dir, stdio: "pipe" });
+    execSync("git add -A", { cwd: dir, stdio: "pipe" });
+    execSync('git commit -m "Initial commit from mmrc init"', { cwd: dir, stdio: "pipe" });
+    return "Initialized git repository";
+  } catch (e) {
+    return `Git init failed: ${e.message}`;
+  }
+}
+async function init(options) {
+  const { name } = options;
+  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);
+  }
+  const cwd = process.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}
+`);
+  mkdirSync(join(blueprintDir, "models"), { recursive: true });
+  mkdirSync(join(blueprintDir, "app"), { recursive: true });
+  const { generateMmrcConfig } = await import("./config-PL24KEWL.mjs");
+  const files = [
+    ["package.json", generatePackageJson(name)],
+    ["tsconfig.json", generateTsconfig()],
+    ["mm.config.ts", generateMmConfig(name, options)],
+    ["mmrc.config.ts", generateMmrcConfig()],
+    [".gitignore", generateGitignore()],
+    ["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");
+    console.log(`  + ${relPath}`);
+  }
+  const gitMessage = scaffoldGit(blueprintDir);
+  console.log(`  ${gitMessage}`);
+  const title = toTitleCase(name);
+  console.log(`
+[mmrc] Blueprint "${title}" created at:
+  ${blueprintDir}
+
+Next steps:
+  1. cd ${blueprintDir.startsWith(cwd) ? blueprintDir.slice(cwd.length + 1) : blueprintDir}
+  2. mmrc dev                    # Start dev server
+  3. mmrc build                  # Compile to IR
+  4. mmrc deploy --build         # Build + deploy to backend
+`);
+}
+export {
+  init,
+  isInsideGitRepo,
+  scaffoldGit
+};