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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. package/ATOM-PIPELINE.md +144 -0
  2. package/README.md +88 -40
  3. package/dist/babel/index.js +113 -6
  4. package/dist/babel/index.mjs +2 -2
  5. package/dist/chunk-3USIFFE4.mjs +2190 -0
  6. package/dist/chunk-45YMGEVT.mjs +186 -0
  7. package/dist/chunk-4FN2AISW.mjs +148 -0
  8. package/dist/chunk-4OPI5L7G.mjs +2593 -0
  9. package/dist/chunk-4RYTKOOJ.mjs +186 -0
  10. package/dist/chunk-5RKTOVR5.mjs +244 -0
  11. package/dist/chunk-5YDMOO4X.mjs +214 -0
  12. package/dist/chunk-64ZWEMLJ.mjs +148 -0
  13. package/dist/chunk-6XP4KSWQ.mjs +2190 -0
  14. package/dist/chunk-72QWL54I.mjs +175 -0
  15. package/dist/chunk-7B4TRI7C.mjs +4835 -0
  16. package/dist/chunk-7ZKGHTNB.mjs +4952 -0
  17. package/dist/chunk-CIESM3BP.mjs +33 -0
  18. package/dist/chunk-DE3ZGQAC.mjs +148 -0
  19. package/dist/chunk-DMCY3BBG.mjs +1933 -0
  20. package/dist/chunk-DPIK3PJS.mjs +244 -0
  21. package/dist/chunk-E5IVH4RE.mjs +186 -0
  22. package/dist/chunk-E6FZNUR5.mjs +4953 -0
  23. package/dist/chunk-EJRBDQDP.mjs +2607 -0
  24. package/dist/chunk-ELO4TXJL.mjs +186 -0
  25. package/dist/chunk-FKRO52XH.mjs +3446 -0
  26. package/dist/chunk-FL4YAKU6.mjs +4941 -0
  27. package/dist/chunk-FYT47UBU.mjs +5076 -0
  28. package/dist/chunk-GCLGPOJZ.mjs +148 -0
  29. package/dist/chunk-GXB4JOP7.mjs +5072 -0
  30. package/dist/chunk-HFXOUMTD.mjs +175 -0
  31. package/dist/chunk-HWIZ47US.mjs +214 -0
  32. package/dist/chunk-IB7MNPQL.mjs +4953 -0
  33. package/dist/chunk-ICSIHQCG.mjs +148 -0
  34. package/dist/chunk-JLA5VNQ3.mjs +186 -0
  35. package/dist/chunk-JQLWFCTM.mjs +214 -0
  36. package/dist/chunk-KFJJCQAL.mjs +148 -0
  37. package/dist/chunk-KJUIIEQE.mjs +186 -0
  38. package/dist/chunk-KNWTHRVQ.mjs +175 -0
  39. package/dist/chunk-KSG4XSZF.mjs +175 -0
  40. package/dist/chunk-LF5N6DOU.mjs +175 -0
  41. package/dist/chunk-LJQCM2IM.mjs +214 -0
  42. package/dist/chunk-NW6555WJ.mjs +186 -0
  43. package/dist/chunk-OMZE6VLQ.mjs +214 -0
  44. package/dist/chunk-P4BR7WVO.mjs +2190 -0
  45. package/dist/chunk-QQHVYH2X.mjs +244 -0
  46. package/dist/chunk-S5QLWLLT.mjs +186 -0
  47. package/dist/chunk-SCWGT2FY.mjs +2190 -0
  48. package/dist/chunk-SMKJUSB3.mjs +2190 -0
  49. package/dist/chunk-VCAY2KGM.mjs +175 -0
  50. package/dist/chunk-WECAV6QB.mjs +148 -0
  51. package/dist/chunk-WMKBXUCE.mjs +3228 -0
  52. package/dist/chunk-XAJ5BKKL.mjs +4947 -0
  53. package/dist/chunk-XG2X7AEA.mjs +175 -0
  54. package/dist/chunk-XG7Z23NQ.mjs +148 -0
  55. package/dist/chunk-XWZAOCQ7.mjs +2607 -0
  56. package/dist/chunk-Y6MA7ULW.mjs +148 -0
  57. package/dist/chunk-YMS7Q7LG.mjs +214 -0
  58. package/dist/chunk-ZA37XTGA.mjs +175 -0
  59. package/dist/cli/index.js +1616 -366
  60. package/dist/cli/index.mjs +8 -8
  61. package/dist/codemod/cli.mjs +1 -1
  62. package/dist/codemod/index.mjs +1 -1
  63. package/dist/dev-server-RmGHIntF.d.mts +113 -0
  64. package/dist/dev-server-RmGHIntF.d.ts +113 -0
  65. package/dist/dev-server.d.mts +1 -1
  66. package/dist/dev-server.d.ts +1 -1
  67. package/dist/dev-server.js +982 -53
  68. package/dist/dev-server.mjs +5 -5
  69. package/dist/envelope.js +113 -6
  70. package/dist/envelope.mjs +3 -3
  71. package/dist/index.d.mts +5 -1
  72. package/dist/index.d.ts +5 -1
  73. package/dist/index.js +992 -63
  74. package/dist/index.mjs +8 -8
  75. package/{src/cli/init.ts → dist/init-7JQMAAXS.mjs} +70 -95
  76. package/dist/init-EHO4VQ22.mjs +369 -0
  77. package/dist/init-UC3FWPIW.mjs +367 -0
  78. package/dist/init-UNSMVKIK.mjs +366 -0
  79. package/dist/init-UNV5XIDE.mjs +367 -0
  80. package/dist/project-compiler-2P4N4DR7.mjs +10 -0
  81. package/dist/project-compiler-D2LCC27O.mjs +10 -0
  82. package/dist/project-compiler-EJ3GANJE.mjs +10 -0
  83. package/dist/project-compiler-LOQKVRZJ.mjs +10 -0
  84. package/dist/project-compiler-RQ6OQKRM.mjs +10 -0
  85. package/dist/project-compiler-VWNNCHGO.mjs +10 -0
  86. package/dist/project-compiler-XVAAU4C5.mjs +10 -0
  87. package/dist/project-compiler-YES5FGMD.mjs +10 -0
  88. package/dist/project-compiler-ZKMQDLGU.mjs +10 -0
  89. package/dist/project-decompiler-FLXCEJHS.mjs +7 -0
  90. package/dist/project-decompiler-VLPR22QF.mjs +7 -0
  91. package/dist/pull-FUS5QYZS.mjs +109 -0
  92. package/dist/pull-LD5ENLGY.mjs +109 -0
  93. package/dist/testing/index.js +113 -6
  94. package/dist/testing/index.mjs +2 -2
  95. package/dist/vite/index.js +113 -6
  96. package/dist/vite/index.mjs +3 -3
  97. package/examples/uber-app/app/admin/fleet.tsx +19 -19
  98. package/package.json +4 -3
  99. package/compile-blueprint-chat.mjs +0 -99
  100. package/compile-blueprint-glass-console.mjs +0 -98
  101. package/compile-chat-defs.mjs +0 -92
  102. package/examples/uber-app/tests/payment.test.tsx +0 -129
  103. package/examples/uber-app/tests/ride-flow.test.tsx +0 -123
  104. package/package.json.backup +0 -86
  105. package/scripts/decompile.ts +0 -226
  106. package/scripts/seed-auth.ts +0 -267
  107. package/scripts/seed-uber.ts +0 -248
  108. package/scripts/validate-uber.ts +0 -119
  109. package/seed-blueprint-chat.mjs +0 -444
  110. package/seed-blueprint-glass-console.mjs +0 -445
  111. package/seed-compiled.mjs +0 -318
  112. package/src/RoundTripValidator.ts +0 -400
  113. package/src/__tests__/atom-rendering-coverage.test.ts +0 -680
  114. package/src/__tests__/auth-module-compilation.test.ts +0 -247
  115. package/src/__tests__/auth-template-compilation.test.ts +0 -589
  116. package/src/__tests__/change-extractor.test.ts +0 -142
  117. package/src/__tests__/cli-pull.test.ts +0 -73
  118. package/src/__tests__/cli-test.test.ts +0 -72
  119. package/src/__tests__/component-extractor.test.ts +0 -331
  120. package/src/__tests__/context-extractor.test.ts +0 -145
  121. package/src/__tests__/decompiler.test.ts +0 -718
  122. package/src/__tests__/define-blueprint.test.ts +0 -133
  123. package/src/__tests__/definition-validator.test.ts +0 -519
  124. package/src/__tests__/during-extractor.test.ts +0 -152
  125. package/src/__tests__/effect-extractor.test.ts +0 -107
  126. package/src/__tests__/event-emission.test.ts +0 -127
  127. package/src/__tests__/examples.test.ts +0 -236
  128. package/src/__tests__/full-blueprint-coverage.test.ts +0 -1221
  129. package/src/__tests__/golden-suite.test.ts +0 -403
  130. package/src/__tests__/grammar-island-extractor.test.ts +0 -289
  131. package/src/__tests__/instance-key.test.ts +0 -82
  132. package/src/__tests__/ir-migration.test.ts +0 -255
  133. package/src/__tests__/lock-file.test.ts +0 -117
  134. package/src/__tests__/model-extractor.test.ts +0 -195
  135. package/src/__tests__/model-field-acl.test.ts +0 -237
  136. package/src/__tests__/model-hooks.test.ts +0 -130
  137. package/src/__tests__/model-ref-resolution.test.ts +0 -268
  138. package/src/__tests__/model-roundtrip.test.ts +0 -502
  139. package/src/__tests__/model-runtime.test.ts +0 -112
  140. package/src/__tests__/model-transitions.test.ts +0 -183
  141. package/src/__tests__/nrt-action-trace.test.ts +0 -391
  142. package/src/__tests__/pipeline-hardening.test.ts +0 -413
  143. package/src/__tests__/project-compiler.test.ts +0 -546
  144. package/src/__tests__/project-decompiler.test.ts +0 -343
  145. package/src/__tests__/query-compilation.test.ts +0 -145
  146. package/src/__tests__/round-trip/PLAN.md +0 -158
  147. package/src/__tests__/round-trip/README.md +0 -52
  148. package/src/__tests__/round-trip/RESULTS.md +0 -86
  149. package/src/__tests__/round-trip/fixtures/data-heavy/main.workflow.tsx +0 -55
  150. package/src/__tests__/round-trip/fixtures/data-heavy/mm.config.ts +0 -11
  151. package/src/__tests__/round-trip/fixtures/data-heavy/models/contact.ts +0 -54
  152. package/src/__tests__/round-trip/fixtures/full-workflow/main.workflow.tsx +0 -79
  153. package/src/__tests__/round-trip/fixtures/full-workflow/mm.config.ts +0 -12
  154. package/src/__tests__/round-trip/fixtures/full-workflow/models/order.ts +0 -50
  155. package/src/__tests__/round-trip/fixtures/simple-crud/main.workflow.tsx +0 -25
  156. package/src/__tests__/round-trip/fixtures/simple-crud/mm.config.ts +0 -11
  157. package/src/__tests__/round-trip/fixtures/simple-crud/models/task.ts +0 -32
  158. package/src/__tests__/round-trip/fixtures/view-heavy/main.workflow.tsx +0 -79
  159. package/src/__tests__/round-trip/fixtures/view-heavy/mm.config.ts +0 -10
  160. package/src/__tests__/round-trip/round-trip.test.ts +0 -2598
  161. package/src/__tests__/round-trip-ir.test.ts +0 -300
  162. package/src/__tests__/round-trip.test.ts +0 -1212
  163. package/src/__tests__/route-merging.test.ts +0 -372
  164. package/src/__tests__/router-composition.test.ts +0 -489
  165. package/src/__tests__/router-extractor.test.ts +0 -176
  166. package/src/__tests__/server-action-extractor.test.ts +0 -128
  167. package/src/__tests__/smart-type-inference.test.ts +0 -365
  168. package/src/__tests__/source-envelope.test.ts +0 -284
  169. package/src/__tests__/source-fidelity.test.ts +0 -516
  170. package/src/__tests__/state-extractor.test.ts +0 -115
  171. package/src/__tests__/strict-mode.test.ts +0 -227
  172. package/src/__tests__/transition-effect-extractor.test.ts +0 -119
  173. package/src/__tests__/transition-extractor.test.ts +0 -68
  174. package/src/__tests__/ts-to-expression.test.ts +0 -462
  175. package/src/__tests__/type-generator.test.ts +0 -201
  176. package/src/__tests__/uber-validation.test.ts +0 -502
  177. package/src/action-compiler.ts +0 -361
  178. package/src/babel/emitters/experience-transform.ts +0 -199
  179. package/src/babel/emitters/ir-to-tsx-emitter.ts +0 -110
  180. package/src/babel/emitters/pure-form-emitter.ts +0 -1023
  181. package/src/babel/emitters/runtime-glue-emitter.ts +0 -39
  182. package/src/babel/extractors/change-extractor.ts +0 -199
  183. package/src/babel/extractors/component-extractor.ts +0 -907
  184. package/src/babel/extractors/computed-extractor.ts +0 -262
  185. package/src/babel/extractors/context-extractor.ts +0 -277
  186. package/src/babel/extractors/during-extractor.ts +0 -295
  187. package/src/babel/extractors/effect-extractor.ts +0 -340
  188. package/src/babel/extractors/event-extractor.ts +0 -235
  189. package/src/babel/extractors/grammar-island-extractor.ts +0 -302
  190. package/src/babel/extractors/model-extractor.ts +0 -1018
  191. package/src/babel/extractors/router-extractor.ts +0 -303
  192. package/src/babel/extractors/server-action-extractor.ts +0 -173
  193. package/src/babel/extractors/server-action-hook-extractor.ts +0 -72
  194. package/src/babel/extractors/server-state-extractor.ts +0 -88
  195. package/src/babel/extractors/state-extractor.ts +0 -214
  196. package/src/babel/extractors/transition-effect-extractor.ts +0 -176
  197. package/src/babel/extractors/transition-extractor.ts +0 -143
  198. package/src/babel/index.ts +0 -24
  199. package/src/babel/transpilers/ts-to-expression.ts +0 -674
  200. package/src/babel/visitor.ts +0 -807
  201. package/src/cli/auth.ts +0 -255
  202. package/src/cli/build.ts +0 -288
  203. package/src/cli/deploy.ts +0 -206
  204. package/src/cli/index.ts +0 -328
  205. package/src/cli/installer.ts +0 -261
  206. package/src/cli/lock-file.ts +0 -94
  207. package/src/cli/mmrc.ts +0 -22
  208. package/src/cli/pull.ts +0 -172
  209. package/src/cli/registry-client.ts +0 -175
  210. package/src/cli/test.ts +0 -397
  211. package/src/cli/type-generator.ts +0 -243
  212. package/src/codemod/__tests__/forward.test.ts +0 -239
  213. package/src/codemod/__tests__/reverse.test.ts +0 -145
  214. package/src/codemod/__tests__/round-trip.test.ts +0 -137
  215. package/src/codemod/annotation.ts +0 -97
  216. package/src/codemod/classify.ts +0 -197
  217. package/src/codemod/cli.ts +0 -207
  218. package/src/codemod/control-flow.ts +0 -409
  219. package/src/codemod/forward.ts +0 -244
  220. package/src/codemod/import-manager.ts +0 -171
  221. package/src/codemod/index.ts +0 -120
  222. package/src/codemod/reverse.ts +0 -197
  223. package/src/codemod/rules.ts +0 -174
  224. package/src/codemod/state-transform.ts +0 -126
  225. package/src/decompiler/ast-builder.ts +0 -538
  226. package/src/decompiler/config-generator.ts +0 -151
  227. package/src/decompiler/index.ts +0 -315
  228. package/src/decompiler/project-decompiler.ts +0 -1776
  229. package/src/decompiler/project.ts +0 -862
  230. package/src/decompiler/split-strategy.ts +0 -140
  231. package/src/decompiler/state-emitter.ts +0 -1053
  232. package/src/decompiler/sx-emitter.ts +0 -318
  233. package/src/decompiler/workspace-hydrator.ts +0 -189
  234. package/src/dev-server.ts +0 -238
  235. package/src/envelope/fs-tree.ts +0 -217
  236. package/src/envelope/source-envelope.ts +0 -264
  237. package/src/envelope.ts +0 -315
  238. package/src/incremental-compiler.ts +0 -401
  239. package/src/index.ts +0 -99
  240. package/src/model-compiler.ts +0 -277
  241. package/src/project-compiler.ts +0 -1629
  242. package/src/route-extractor.ts +0 -333
  243. package/src/testing/index.ts +0 -32
  244. package/src/testing/snapshot.ts +0 -252
  245. package/src/testing/test-utils.ts +0 -226
  246. package/src/types.ts +0 -68
  247. package/src/vite/index.ts +0 -288
  248. package/test-compile.mjs +0 -142
  249. package/tsconfig.json +0 -25
  250. package/tsup.config.ts +0 -23
  251. package/vitest.config.ts +0 -9
@@ -4,12 +4,12 @@ import {
4
4
  } from "../chunk-EQGA6A6D.mjs";
5
5
  import {
6
6
  build
7
- } from "../chunk-KFGYOOVS.mjs";
7
+ } from "../chunk-5RKTOVR5.mjs";
8
8
  import "../chunk-5M7DKKBC.mjs";
9
- import "../chunk-HLRGCCIL.mjs";
9
+ import "../chunk-FYT47UBU.mjs";
10
10
  import {
11
11
  __require
12
- } from "../chunk-Y6FXYEAI.mjs";
12
+ } from "../chunk-CIESM3BP.mjs";
13
13
 
14
14
  // src/cli/test.ts
15
15
  import { glob } from "glob";
@@ -39,8 +39,8 @@ async function test(options = {}) {
39
39
  const rel = f.startsWith(srcDir + "/") ? f.slice(srcDir.length + 1) : f;
40
40
  fileMap[rel] = readFileSync(f, "utf-8");
41
41
  }
42
- const { compileProject } = await import("../project-compiler-EGJUTAJU.mjs");
43
- const { decompileProjectEnhanced } = await import("../project-decompiler-5GY2KSG4.mjs");
42
+ const { compileProject } = await import("../project-compiler-D2LCC27O.mjs");
43
+ const { decompileProjectEnhanced } = await import("../project-decompiler-FLXCEJHS.mjs");
44
44
  process.stdout.write(` Compiling project...`);
45
45
  const t0 = performance.now();
46
46
  let ir1;
@@ -514,7 +514,7 @@ async function main() {
514
514
  const { glob: glob2 } = await import("glob");
515
515
  const configPath = resolve2(srcDir, "mm.config.ts");
516
516
  if (existsSync3(configPath)) {
517
- const { compileProject } = await import("../project-compiler-EGJUTAJU.mjs");
517
+ const { compileProject } = await import("../project-compiler-D2LCC27O.mjs");
518
518
  const allFiles = await glob2(`${srcDir}/**/*.{ts,tsx}`, {
519
519
  ignore: ["**/node_modules/**", "**/dist/**", "**/__tests__/**", "**/*.test.*"]
520
520
  });
@@ -577,7 +577,7 @@ async function main() {
577
577
  console.error('[mmrc] Error: name is required\n Usage: mmrc init <name> [--description "..."] [--icon "..."] [--author "..."]');
578
578
  process.exit(1);
579
579
  }
580
- const { init } = await import("../init-IXEE2RCF.mjs");
580
+ const { init } = await import("../init-UC3FWPIW.mjs");
581
581
  await init({
582
582
  name,
583
583
  description: getFlag("--description"),
@@ -600,7 +600,7 @@ async function main() {
600
600
  console.error(" 3. Set MMRC_TOKEN environment variable");
601
601
  process.exit(1);
602
602
  }
603
- const { pull } = await import("../pull-JBEQWVPE.mjs");
603
+ const { pull } = await import("../pull-LD5ENLGY.mjs");
604
604
  await pull({ slug, apiUrl, token, outDir });
605
605
  } else {
606
606
  console.log(`
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  transform
4
4
  } from "../chunk-CKGOZAB7.mjs";
5
- import "../chunk-Y6FXYEAI.mjs";
5
+ import "../chunk-CIESM3BP.mjs";
6
6
 
7
7
  // src/codemod/cli.ts
8
8
  import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -10,7 +10,7 @@ import {
10
10
  reverseClassifyAtom,
11
11
  transform
12
12
  } from "../chunk-CKGOZAB7.mjs";
13
- import "../chunk-Y6FXYEAI.mjs";
13
+ import "../chunk-CIESM3BP.mjs";
14
14
  export {
15
15
  ATOM_IMPORT_SOURCE,
16
16
  FORWARD_RULES,
@@ -0,0 +1,113 @@
1
+ import { ViteDevServer } from 'vite';
2
+ import { IRWorkflowDefinition } from '@mindmatrix/player-core';
3
+
4
+ /**
5
+ * CLI Build Command — compiles workflow files to Pure Form JSON.
6
+ *
7
+ * Supports three file types:
8
+ * - *.workflow.tsx — React workflow components
9
+ * - models/*.ts — TypeScript model files
10
+ * - *.server.ts — Server action files
11
+ *
12
+ * Produces:
13
+ * - *.workflow.json — IR (Pure Form)
14
+ * - *.json — Engine-compatible definition
15
+ * - envelope.json — Source envelope with file manifest
16
+ */
17
+
18
+ interface BuildOptions {
19
+ src?: string;
20
+ outDir?: string;
21
+ mode?: 'strict' | 'infer';
22
+ /** Generate source envelope. */
23
+ envelope?: boolean;
24
+ /** Blueprint slug for envelope. */
25
+ slug?: string;
26
+ /** Blueprint version for envelope. */
27
+ version?: string;
28
+ /** Skip TypeScript type checking (not recommended). */
29
+ skipTypeCheck?: boolean;
30
+ /** Watch mode: auto-recompile on file changes. */
31
+ watch?: boolean;
32
+ }
33
+ interface BuildResult {
34
+ compiled: number;
35
+ errors: number;
36
+ warnings: number;
37
+ definitions: IRWorkflowDefinition[];
38
+ errorDetails: {
39
+ file: string;
40
+ message: string;
41
+ line?: number;
42
+ }[];
43
+ }
44
+ declare function build(options?: BuildOptions): Promise<BuildResult>;
45
+
46
+ /**
47
+ * Dev Server — Vite-based development server for MindMatrix React workflows.
48
+ *
49
+ * Uses the Vite plugin to watch .workflow.tsx files. On file change:
50
+ * 1. Compile through Babel plugin → extract IR
51
+ * 2. Diff IR against last known state
52
+ * 3. Notify connected frontends via WebSocket
53
+ * 4. Optionally seed definitions to the dev API
54
+ *
55
+ * Usage (programmatic):
56
+ * import { createDevServer } from '@mindmatrix/react-compiler';
57
+ * const server = await createDevServer({ port: 5199 });
58
+ * // ... server.close() to stop
59
+ *
60
+ * Usage (CLI):
61
+ * mmrc dev --port 5199 --src src/workflows --seed
62
+ */
63
+
64
+ /** Minimal WebSocket interface — avoids requiring @types/ws at compile time */
65
+ interface WsClient {
66
+ readyState: number;
67
+ send(data: string): void;
68
+ close(): void;
69
+ on(event: string, listener: (...args: unknown[]) => void): void;
70
+ }
71
+ interface DevServerOptions {
72
+ /** Port for the dev server. Default: 5199 */
73
+ port?: number;
74
+ /** Source directory to watch. Default: 'src/workflows' */
75
+ src?: string;
76
+ /** Compilation mode. Default: 'infer' */
77
+ mode?: 'strict' | 'infer';
78
+ /** Glob patterns for workflow files. Default: ['**\/*.workflow.tsx'] */
79
+ include?: string[];
80
+ /** Output directory for .workflow.json sidecar files. Default: 'dist/workflows' */
81
+ outDir?: string;
82
+ /** Seed compiled definitions to the dev API on change. Default: false */
83
+ seed?: boolean;
84
+ /** Dev API base URL. Default: 'http://localhost:4200/api/v1' */
85
+ apiUrl?: string;
86
+ /** Auth token for dev API. Default: reads from MINDMATRIX_TOKEN env */
87
+ authToken?: string;
88
+ /** Enable WebSocket notification channel. Default: true */
89
+ ws?: boolean;
90
+ /** Open browser on start. Default: false */
91
+ open?: boolean;
92
+ }
93
+ interface DevServerInstance {
94
+ /** The underlying Vite dev server */
95
+ vite: ViteDevServer;
96
+ /** Port the server is running on */
97
+ port: number;
98
+ /** Connected WebSocket clients */
99
+ clients: Set<WsClient>;
100
+ /** Trigger a full rebuild of all workflow files */
101
+ rebuild: () => Promise<BuildResult>;
102
+ /** Stop the dev server */
103
+ close: () => Promise<void>;
104
+ }
105
+ /**
106
+ * Create and start a MindMatrix dev server.
107
+ *
108
+ * This is a thin Vite server configured with the mindmatrixReact plugin,
109
+ * plus a WebSocket channel that pushes compile events to connected editors.
110
+ */
111
+ declare function createDevServer(options?: DevServerOptions): Promise<DevServerInstance>;
112
+
113
+ export { type BuildOptions as B, type DevServerOptions as D, type DevServerInstance as a, build as b, createDevServer as c, type BuildResult as d };
@@ -0,0 +1,113 @@
1
+ import { ViteDevServer } from 'vite';
2
+ import { IRWorkflowDefinition } from '@mindmatrix/player-core';
3
+
4
+ /**
5
+ * CLI Build Command — compiles workflow files to Pure Form JSON.
6
+ *
7
+ * Supports three file types:
8
+ * - *.workflow.tsx — React workflow components
9
+ * - models/*.ts — TypeScript model files
10
+ * - *.server.ts — Server action files
11
+ *
12
+ * Produces:
13
+ * - *.workflow.json — IR (Pure Form)
14
+ * - *.json — Engine-compatible definition
15
+ * - envelope.json — Source envelope with file manifest
16
+ */
17
+
18
+ interface BuildOptions {
19
+ src?: string;
20
+ outDir?: string;
21
+ mode?: 'strict' | 'infer';
22
+ /** Generate source envelope. */
23
+ envelope?: boolean;
24
+ /** Blueprint slug for envelope. */
25
+ slug?: string;
26
+ /** Blueprint version for envelope. */
27
+ version?: string;
28
+ /** Skip TypeScript type checking (not recommended). */
29
+ skipTypeCheck?: boolean;
30
+ /** Watch mode: auto-recompile on file changes. */
31
+ watch?: boolean;
32
+ }
33
+ interface BuildResult {
34
+ compiled: number;
35
+ errors: number;
36
+ warnings: number;
37
+ definitions: IRWorkflowDefinition[];
38
+ errorDetails: {
39
+ file: string;
40
+ message: string;
41
+ line?: number;
42
+ }[];
43
+ }
44
+ declare function build(options?: BuildOptions): Promise<BuildResult>;
45
+
46
+ /**
47
+ * Dev Server — Vite-based development server for MindMatrix React workflows.
48
+ *
49
+ * Uses the Vite plugin to watch .workflow.tsx files. On file change:
50
+ * 1. Compile through Babel plugin → extract IR
51
+ * 2. Diff IR against last known state
52
+ * 3. Notify connected frontends via WebSocket
53
+ * 4. Optionally seed definitions to the dev API
54
+ *
55
+ * Usage (programmatic):
56
+ * import { createDevServer } from '@mindmatrix/react-compiler';
57
+ * const server = await createDevServer({ port: 5199 });
58
+ * // ... server.close() to stop
59
+ *
60
+ * Usage (CLI):
61
+ * mmrc dev --port 5199 --src src/workflows --seed
62
+ */
63
+
64
+ /** Minimal WebSocket interface — avoids requiring @types/ws at compile time */
65
+ interface WsClient {
66
+ readyState: number;
67
+ send(data: string): void;
68
+ close(): void;
69
+ on(event: string, listener: (...args: unknown[]) => void): void;
70
+ }
71
+ interface DevServerOptions {
72
+ /** Port for the dev server. Default: 5199 */
73
+ port?: number;
74
+ /** Source directory to watch. Default: 'src/workflows' */
75
+ src?: string;
76
+ /** Compilation mode. Default: 'infer' */
77
+ mode?: 'strict' | 'infer';
78
+ /** Glob patterns for workflow files. Default: ['**\/*.workflow.tsx'] */
79
+ include?: string[];
80
+ /** Output directory for .workflow.json sidecar files. Default: 'dist/workflows' */
81
+ outDir?: string;
82
+ /** Seed compiled definitions to the dev API on change. Default: false */
83
+ seed?: boolean;
84
+ /** Dev API base URL. Default: 'http://localhost:4200/api/v1' */
85
+ apiUrl?: string;
86
+ /** Auth token for dev API. Default: reads from MINDMATRIX_TOKEN env */
87
+ authToken?: string;
88
+ /** Enable WebSocket notification channel. Default: true */
89
+ ws?: boolean;
90
+ /** Open browser on start. Default: false */
91
+ open?: boolean;
92
+ }
93
+ interface DevServerInstance {
94
+ /** The underlying Vite dev server */
95
+ vite: ViteDevServer;
96
+ /** Port the server is running on */
97
+ port: number;
98
+ /** Connected WebSocket clients */
99
+ clients: Set<WsClient>;
100
+ /** Trigger a full rebuild of all workflow files */
101
+ rebuild: () => Promise<BuildResult>;
102
+ /** Stop the dev server */
103
+ close: () => Promise<void>;
104
+ }
105
+ /**
106
+ * Create and start a MindMatrix dev server.
107
+ *
108
+ * This is a thin Vite server configured with the mindmatrixReact plugin,
109
+ * plus a WebSocket channel that pushes compile events to connected editors.
110
+ */
111
+ declare function createDevServer(options?: DevServerOptions): Promise<DevServerInstance>;
112
+
113
+ export { type BuildOptions as B, type DevServerOptions as D, type DevServerInstance as a, build as b, createDevServer as c, type BuildResult as d };
@@ -1,3 +1,3 @@
1
1
  import 'vite';
2
- export { a as DevServerInstance, D as DevServerOptions, c as createDevServer } from './dev-server-Bs_sz2DG.mjs';
2
+ export { a as DevServerInstance, D as DevServerOptions, c as createDevServer } from './dev-server-RmGHIntF.mjs';
3
3
  import '@mindmatrix/player-core';
@@ -1,3 +1,3 @@
1
1
  import 'vite';
2
- export { a as DevServerInstance, D as DevServerOptions, c as createDevServer } from './dev-server-Bs_sz2DG.js';
2
+ export { a as DevServerInstance, D as DevServerOptions, c as createDevServer } from './dev-server-RmGHIntF.js';
3
3
  import '@mindmatrix/player-core';