@manifesto-ai/compiler 1.6.2 → 1.8.0

package/README.md

@@ -46,13 +46,14 @@ pnpm add -D @manifesto-ai/compiler
 
 ---
 
-## Bundler Integrations (Subpath Exports)
+## Bundler Integration (unplugin)
 
-Use subpath exports to load `.mel` files directly.
+The compiler uses [unplugin](https://github.com/unjs/unplugin) to provide a unified MEL plugin for all major bundlers. One implementation, every bundler.
 
 ### Vite
 
 ```typescript
+// vite.config.ts
 import { defineConfig } from "vite";
 import { melPlugin } from "@manifesto-ai/compiler/vite";
 
@@ -61,28 +62,75 @@ export default defineConfig({
 });
 ```
 
-### Node / tsx Loader
+### Next.js / Webpack
 
-```bash
-npx tsx --loader @manifesto-ai/compiler/loader main.ts
+```javascript
+// next.config.js
+const mel = require("@manifesto-ai/compiler/webpack");
+
+module.exports = {
+  webpack: (config) => {
+    config.plugins.push(mel());
+    return config;
+  },
+};
 ```
 
-### Webpack
+### Rollup
 
 ```javascript
-module.exports = {
-  module: {
-    rules: [
-      {
-        test: /\.mel$/,
-        use: "@manifesto-ai/compiler/loader",
-      },
-    ],
+// rollup.config.js
+import { melPlugin } from "@manifesto-ai/compiler/rollup";
+
+export default { plugins: [melPlugin()] };
+```
+
+### esbuild
+
+```javascript
+import { melPlugin } from "@manifesto-ai/compiler/esbuild";
+
+await esbuild.build({ plugins: [melPlugin()] });
+```
+
+### Rspack
+
+```javascript
+const mel = require("@manifesto-ai/compiler/rspack");
+
+module.exports = { plugins: [mel()] };
+```
+
+### Node / tsx (ESM Loader)
+
+```bash
+npx tsx --loader @manifesto-ai/compiler/node-loader main.ts
+```
+
+### Plugin Options
+
+```typescript
+melPlugin({
+  include: /\.mel$/,           // File filter (default: /\.mel$/)
+  codegen: {                    // Optional: auto-generate types
+    outDir: "src/generated",   // Output directory
+    plugins: [/* custom */],   // Defaults to TS + Zod plugins
   },
-};
+});
 ```
 
-`vite` and `webpack` are managed as optional peer dependencies for adapter compatibility.
+The `codegen` option requires `@manifesto-ai/codegen` as a peer dependency. When enabled, TypeScript types and Zod schemas are generated automatically at build time.
+
+### Subpath Exports
+
+| Export | Bundler |
+| --- | --- |
+| `@manifesto-ai/compiler/vite` | Vite |
+| `@manifesto-ai/compiler/webpack` | Webpack / Next.js |
+| `@manifesto-ai/compiler/rollup` | Rollup |
+| `@manifesto-ai/compiler/esbuild` | esbuild |
+| `@manifesto-ai/compiler/rspack` | Rspack |
+| `@manifesto-ai/compiler/node-loader` | Node ESM loader hooks |
 
 ---
 
@@ -142,8 +190,9 @@ type CompileOptions = {
 | [MEL Syntax](../../docs/mel/SYNTAX.md) | Grammar and syntax |
 | [MEL Examples](../../docs/mel/EXAMPLES.md) | Example library |
 | [MEL Error Guide](../../docs/mel/ERROR-GUIDE.md) | Error codes and fixes |
-| [Compiler Spec](docs/SPEC.md) | Full compiler and MEL spec |
-| [Compiler FDR](docs/FDR-0.3.3v.md) | Design rationale |
+| [Compiler Spec](docs/SPEC-v0.7.0.md) | Full compiler and MEL spec |
+| [Compiler FDR](docs/FDR-v0.5.0.md) | Design rationale |
+| [Compiler Compliance Suite](docs/compiler-SPEC-compilance-test-suite.md) | CCTS structure, rule modes, and execution guide |
 
 ---
 

package/dist/chunk-BH25NHMN.js

@@ -0,0 +1,74 @@
+import {
+  formatDiagnostic
+} from "./chunk-D62NIFP4.js";
+import {
+  compileMelDomain
+} from "./chunk-MKLDAZ2Z.js";
+
+// src/unplugin.ts
+import { createUnplugin } from "unplugin";
+function normalizeId(id) {
+  return id.split("?", 1)[0];
+}
+function testRegex(regex, value) {
+  regex.lastIndex = 0;
+  return regex.test(value);
+}
+var unpluginMel = createUnplugin((options = {}) => {
+  const include = options.include ?? /\.mel$/;
+  const compiledSchemas = /* @__PURE__ */ new Map();
+  return {
+    name: "manifesto:mel",
+    enforce: "pre",
+    transformInclude(id) {
+      return testRegex(include, normalizeId(id));
+    },
+    transform(source, id) {
+      const sourceId = normalizeId(id);
+      const result = compileMelDomain(source, { mode: "domain" });
+      if (result.errors.length > 0) {
+        const details = result.errors.map(formatDiagnostic).join("\n");
+        throw new Error(`MEL compilation failed for ${sourceId}
+${details}`);
+      }
+      if (!result.schema) {
+        throw new Error(`MEL compilation produced no schema for ${sourceId}`);
+      }
+      if (options.codegen) {
+        compiledSchemas.set(sourceId, result.schema);
+      }
+      const serializedSchema = JSON.stringify(result.schema, null, 2);
+      return `export default ${serializedSchema};
+`;
+    },
+    async buildEnd() {
+      if (!options.codegen || compiledSchemas.size === 0) return;
+      let codegen;
+      try {
+        codegen = await import("@manifesto-ai/codegen");
+      } catch {
+        console.warn(
+          "[manifesto:mel] codegen option is enabled but @manifesto-ai/codegen is not installed. Skipping."
+        );
+        return;
+      }
+      const plugins = options.codegen.plugins ?? [
+        codegen.createTsPlugin(),
+        codegen.createZodPlugin()
+      ];
+      for (const [sourceId, schema] of compiledSchemas) {
+        await codegen.generate({
+          schema,
+          outDir: options.codegen.outDir,
+          plugins,
+          sourceId
+        });
+      }
+    }
+  };
+});
+
+export {
+  unpluginMel
+};
+//# sourceMappingURL=chunk-BH25NHMN.js.map

package/dist/chunk-BH25NHMN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/unplugin.ts"],"sourcesContent":["/**\n * Unified MEL plugin via unplugin.\n *\n * Single implementation that targets Vite, Webpack, Rollup, esbuild, and Rspack.\n */\n\nimport { createUnplugin } from \"unplugin\";\nimport type { DomainSchema } from \"@manifesto-ai/core\";\nimport { compileMelDomain } from \"./api/index.js\";\nimport { formatDiagnostic } from \"./mel-module.js\";\n\nexport type MelCodegenOptions = {\n  readonly outDir: string;\n  readonly plugins?: readonly import(\"@manifesto-ai/codegen\").CodegenPlugin[];\n};\n\nexport type MelPluginOptions = {\n  readonly include?: RegExp;\n  readonly codegen?: MelCodegenOptions | false;\n};\n\nfunction normalizeId(id: string): string {\n  return id.split(\"?\", 1)[0];\n}\n\nfunction testRegex(regex: RegExp, value: string): boolean {\n  regex.lastIndex = 0;\n  return regex.test(value);\n}\n\nexport const unpluginMel = createUnplugin((options: MelPluginOptions = {}) => {\n  const include = options.include ?? /\\.mel$/;\n  const compiledSchemas = new Map<string, DomainSchema>();\n\n  return {\n    name: \"manifesto:mel\",\n    enforce: \"pre\" as const,\n\n    transformInclude(id: string) {\n      return testRegex(include, normalizeId(id));\n    },\n\n    transform(source: string, id: string) {\n      const sourceId = normalizeId(id);\n      const result = compileMelDomain(source, { mode: \"domain\" });\n\n      if (result.errors.length > 0) {\n        const details = result.errors.map(formatDiagnostic).join(\"\\n\");\n        throw new Error(`MEL compilation failed for ${sourceId}\\n${details}`);\n      }\n\n      if (!result.schema) {\n        throw new Error(`MEL compilation produced no schema for ${sourceId}`);\n      }\n\n      if (options.codegen) {\n        compiledSchemas.set(sourceId, result.schema);\n      }\n\n      const serializedSchema = JSON.stringify(result.schema, null, 2);\n      return `export default ${serializedSchema};\\n`;\n    },\n\n    async buildEnd() {\n      if (!options.codegen || compiledSchemas.size === 0) return;\n\n      let codegen: typeof import(\"@manifesto-ai/codegen\");\n      try {\n        codegen = await import(\"@manifesto-ai/codegen\");\n      } catch {\n        console.warn(\n          \"[manifesto:mel] codegen option is enabled but @manifesto-ai/codegen is not installed. Skipping.\"\n        );\n        return;\n      }\n\n      const plugins = options.codegen.plugins ?? [\n        codegen.createTsPlugin(),\n        codegen.createZodPlugin(),\n      ];\n\n      for (const [sourceId, schema] of compiledSchemas) {\n        await codegen.generate({\n          schema,\n          outDir: options.codegen.outDir,\n          plugins,\n          sourceId,\n        });\n      }\n    },\n  };\n});\n"],"mappings":";;;;;;;;AAMA,SAAS,sBAAsB;AAe/B,SAAS,YAAY,IAAoB;AACvC,SAAO,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC;AAC3B;AAEA,SAAS,UAAU,OAAe,OAAwB;AACxD,QAAM,YAAY;AAClB,SAAO,MAAM,KAAK,KAAK;AACzB;AAEO,IAAM,cAAc,eAAe,CAAC,UAA4B,CAAC,MAAM;AAC5E,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,kBAAkB,oBAAI,IAA0B;AAEtD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IAET,iBAAiB,IAAY;AAC3B,aAAO,UAAU,SAAS,YAAY,EAAE,CAAC;AAAA,IAC3C;AAAA,IAEA,UAAU,QAAgB,IAAY;AACpC,YAAM,WAAW,YAAY,EAAE;AAC/B,YAAM,SAAS,iBAAiB,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE1D,UAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,cAAM,UAAU,OAAO,OAAO,IAAI,gBAAgB,EAAE,KAAK,IAAI;AAC7D,cAAM,IAAI,MAAM,8BAA8B,QAAQ;AAAA,EAAK,OAAO,EAAE;AAAA,MACtE;AAEA,UAAI,CAAC,OAAO,QAAQ;AAClB,cAAM,IAAI,MAAM,0CAA0C,QAAQ,EAAE;AAAA,MACtE;AAEA,UAAI,QAAQ,SAAS;AACnB,wBAAgB,IAAI,UAAU,OAAO,MAAM;AAAA,MAC7C;AAEA,YAAM,mBAAmB,KAAK,UAAU,OAAO,QAAQ,MAAM,CAAC;AAC9D,aAAO,kBAAkB,gBAAgB;AAAA;AAAA,IAC3C;AAAA,IAEA,MAAM,WAAW;AACf,UAAI,CAAC,QAAQ,WAAW,gBAAgB,SAAS,EAAG;AAEpD,UAAI;AACJ,UAAI;AACF,kBAAU,MAAM,OAAO,uBAAuB;AAAA,MAChD,QAAQ;AACN,gBAAQ;AAAA,UACN;AAAA,QACF;AACA;AAAA,MACF;AAEA,YAAM,UAAU,QAAQ,QAAQ,WAAW;AAAA,QACzC,QAAQ,eAAe;AAAA,QACvB,QAAQ,gBAAgB;AAAA,MAC1B;AAEA,iBAAW,CAAC,UAAU,MAAM,KAAK,iBAAiB;AAChD,cAAM,QAAQ,SAAS;AAAA,UACrB;AAAA,UACA,QAAQ,QAAQ,QAAQ;AAAA,UACxB;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/chunk-D62NIFP4.js

@@ -0,0 +1,33 @@
+import {
+  compileMelDomain
+} from "./chunk-MKLDAZ2Z.js";
+
+// src/mel-module.ts
+function formatDiagnostic(diagnostic) {
+  const location = diagnostic.location;
+  if (!location) {
+    return `[${diagnostic.code}] ${diagnostic.message}`;
+  }
+  const { line, column } = location.start;
+  return `[${diagnostic.code}] ${diagnostic.message} (${line}:${column})`;
+}
+function compileMelToModuleCode(melSource, sourceId) {
+  const result = compileMelDomain(melSource, { mode: "domain" });
+  if (result.errors.length > 0) {
+    const details = result.errors.map(formatDiagnostic).join("\n");
+    throw new Error(`MEL compilation failed for ${sourceId}
+${details}`);
+  }
+  if (!result.schema) {
+    throw new Error(`MEL compilation produced no schema for ${sourceId}`);
+  }
+  const serializedSchema = JSON.stringify(result.schema, null, 2);
+  return `export default ${serializedSchema};
+`;
+}
+
+export {
+  formatDiagnostic,
+  compileMelToModuleCode
+};
+//# sourceMappingURL=chunk-D62NIFP4.js.map

package/dist/chunk-D62NIFP4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mel-module.ts"],"sourcesContent":["/**\n * MEL Module Helpers\n *\n * Utilities for turning MEL source into JavaScript module code.\n */\n\nimport type { Diagnostic } from \"./diagnostics/types.js\";\nimport { compileMelDomain } from \"./api/index.js\";\n\nexport function formatDiagnostic(diagnostic: Diagnostic): string {\n  const location = diagnostic.location;\n\n  if (!location) {\n    return `[${diagnostic.code}] ${diagnostic.message}`;\n  }\n\n  const { line, column } = location.start;\n  return `[${diagnostic.code}] ${diagnostic.message} (${line}:${column})`;\n}\n\n/**\n * Compile MEL source and emit ESM source that exports the compiled schema.\n *\n * @param melSource - MEL domain source text\n * @param sourceId - Human-readable source identifier for diagnostics\n */\nexport function compileMelToModuleCode(melSource: string, sourceId: string): string {\n  const result = compileMelDomain(melSource, { mode: \"domain\" });\n\n  if (result.errors.length > 0) {\n    const details = result.errors.map(formatDiagnostic).join(\"\\n\");\n    throw new Error(`MEL compilation failed for ${sourceId}\\n${details}`);\n  }\n\n  if (!result.schema) {\n    throw new Error(`MEL compilation produced no schema for ${sourceId}`);\n  }\n\n  const serializedSchema = JSON.stringify(result.schema, null, 2);\n  return `export default ${serializedSchema};\\n`;\n}\n\n"],"mappings":";;;;;AASO,SAAS,iBAAiB,YAAgC;AAC/D,QAAM,WAAW,WAAW;AAE5B,MAAI,CAAC,UAAU;AACb,WAAO,IAAI,WAAW,IAAI,KAAK,WAAW,OAAO;AAAA,EACnD;AAEA,QAAM,EAAE,MAAM,OAAO,IAAI,SAAS;AAClC,SAAO,IAAI,WAAW,IAAI,KAAK,WAAW,OAAO,KAAK,IAAI,IAAI,MAAM;AACtE;AAQO,SAAS,uBAAuB,WAAmB,UAA0B;AAClF,QAAM,SAAS,iBAAiB,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,UAAM,UAAU,OAAO,OAAO,IAAI,gBAAgB,EAAE,KAAK,IAAI;AAC7D,UAAM,IAAI,MAAM,8BAA8B,QAAQ;AAAA,EAAK,OAAO,EAAE;AAAA,EACtE;AAEA,MAAI,CAAC,OAAO,QAAQ;AAClB,UAAM,IAAI,MAAM,0CAA0C,QAAQ,EAAE;AAAA,EACtE;AAEA,QAAM,mBAAmB,KAAK,UAAU,OAAO,QAAQ,MAAM,CAAC;AAC9D,SAAO,kBAAkB,gBAAgB;AAAA;AAC3C;","names":[]}