babel-preset-exodra 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# babel-preset-exodra
+
+Babel preset that compiles Exodra JSX in one line — JSX syntax (with namespaced
+`bind:` / `cache:` directives), the [`@exodra/babel-plugin-jsx`](../babel-plugin-jsx)
+transform, and `@babel/preset-typescript` for `.ts`/`.tsx`.
+
+## Installation
+
+```bash
+npm install --save-dev babel-preset-exodra
+```
+
+## Usage
+
+```javascript
+// babel.config.js
+module.exports = {
+  presets: ['exodra'],
+};
+```
+
+### Options
+
+```javascript
+// babel.config.js
+module.exports = {
+  presets: [
+    ['exodra', {
+      importSource: '@exodra/core', // where auto-imported h/text come from
+      hoistStatic: true,            // compile-time clone-cache for static subtrees
+      typescript: true,             // include preset-typescript (turn off if TS is handled elsewhere)
+    }],
+  ],
+};
+```
+
+## Testing with Jest
+
+This preset is what makes Exodra component tests runnable under Jest. Jest **can**
+compile Exodra JSX — through `babel-jest` (Jest's default Babel transform), which
+picks up `babel.config.js` automatically. `ts-jest` and `@swc/jest` do **not** run
+Babel plugins and so cannot compile Exodra JSX.
+
+```javascript
+// babel.config.js
+module.exports = { presets: ['exodra'] };
+```
+
+That is all Jest needs — component tests then compile the same way Vite compiles
+them.
+
+> If Jest reports an unexpected token on `<`, or "namespace tags are not
+> supported" on `bind:value`, you are almost certainly on `ts-jest` / `@swc/jest`.
+> Switch the transform to `babel-jest` and add the preset above.
+
+## Other bundlers & runners
+
+Exodra JSX is compiled by a **Babel** plugin, so any tool that can run Babel can
+compile it — via this preset. Tools that do **not** run Babel plugins (esbuild,
+SWC, Bun's native transpiler) need a dedicated plugin that hands the file to
+Babel; those wrap this same preset, so every path compiles identically.
+
+| Tool | How | Package |
+| --- | --- | --- |
+| **Vite / Vitest** | plugin | [`@exodra/vite-plugin`](../vite-plugin-exodra) |
+| **Jest** | `babel-jest` + this preset | `babel-preset-exodra` |
+| **esbuild / tsup** | plugin | [`esbuild-plugin-exodra`](../esbuild-plugin-exodra) |
+| **Rollup** | plugin | [`rollup-plugin-exodra`](../rollup-plugin-exodra) |
+| **Bun** | plugin | [`bun-plugin-exodra`](../bun-plugin-exodra) |
+| **webpack** | `babel-loader` + this preset | *(no package — see below)* |
+| **Parcel** | `.babelrc` + this preset | *(no package — see below)* |
+| **SWC / Next.js / `swc-loader`** | native Wasm plugin (full parity) | [`swc-plugin-exodra`](../swc-plugin-exodra) |
+
+### webpack
+
+```javascript
+// webpack.config.js
+module.exports = {
+  module: {
+    rules: [
+      {
+        test: /\.[jt]sx$/,
+        use: {
+          loader: 'babel-loader',
+          options: { presets: ['exodra'] },
+        },
+      },
+    ],
+  },
+  resolve: { extensions: ['.js', '.jsx', '.ts', '.tsx'] },
+};
+```
+
+### Parcel
+
+Parcel reads Babel config automatically:
+
+```json
+// .babelrc
+{ "presets": ["exodra"] }
+```
+
+### SWC / Next.js (default), `@swc/jest`
+
+SWC does not run Babel plugins, so this preset cannot drive it. Use the native
+Wasm plugin [`swc-plugin-exodra`](../swc-plugin-exodra) instead — a full-parity
+port (buckets, children, `bind:`/`cache:` directives, fragments, static hoisting,
+shadow-safe imports, strict errors).
+
+## Programmatic runner
+
+Every bundler plugin above calls one shared function, exported here, so there is a
+single copy of the pipeline **and** its invocation:
+
+```javascript
+import { transformExodraJsx } from 'babel-preset-exodra';
+
+const result = await transformExodraJsx(sourceCode, '/abs/path/File.tsx');
+// -> { code, map } | null   (typescript defaults on for .tsx, off otherwise)
+```

package/dist/index.cjs

@@ -0,0 +1,111 @@
+"use strict";
+// The canonical Exodra Babel integration, in one place.
+//
+//  - `default` export: a Babel PRESET that bundles the full pipeline (JSX syntax
+//    with `throwIfNamespace: false` so `bind:`/`cache:` survive, the
+//    `@exodra/babel-plugin-jsx` transform, and preset-typescript). This is the
+//    Jest / babel.config.js entry point:
+//
+//      // babel.config.js
+//      module.exports = { presets: ['exodra'] };
+//
+//  - `transformExodraJsx(code, filename)`: a small imperative RUNNER that applies
+//    that preset via `@babel/core`. It is the single source of truth every
+//    bundler plugin (Vite / esbuild / Rollup / Bun) calls, so there is exactly
+//    ONE copy of the pipeline AND its invocation — no drift between how tools
+//    compile Exodra JSX.
+//
+// ts-jest / @swc/jest do NOT run Babel plugins and so cannot compile Exodra JSX —
+// use `babel-jest` with the preset.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformExodraJsx = transformExodraJsx;
+const babel = __importStar(require("@babel/core"));
+// @babel/plugin-syntax-jsx and @babel/preset-typescript ship no type
+// declarations, and @exodra/babel-plugin-jsx ships as CommonJS with an empty
+// `export {}` .d.ts — so pull all three runtime values via require.
+/* eslint-disable @typescript-eslint/no-var-requires */
+const syntaxJsx = require('@babel/plugin-syntax-jsx');
+const presetTypescript = require('@babel/preset-typescript');
+const exodraJsxPlugin = require('@exodra/babel-plugin-jsx');
+function babelPresetExodra(api, options = {}) {
+    api.assertVersion(7);
+    const { importSource = '@exodra/core', hoistStatic = true, typescript = true, mode = 'dom', } = options;
+    const presets = [];
+    if (typescript) {
+        presets.push([
+            presetTypescript,
+            { isTSX: true, allExtensions: true },
+        ]);
+    }
+    return {
+        presets,
+        plugins: [
+            // Parse JSX; keep namespaced directives (`bind:value`, `cache:key`)
+            // instead of throwing, so the Exodra plugin can lower them.
+            [syntaxJsx, { throwIfNamespace: false }],
+            [exodraJsxPlugin, { importSource, hoistStatic, mode }],
+        ],
+    };
+}
+exports.default = babelPresetExodra;
+/**
+ * Compile one Exodra JSX/TSX source through the preset. The single invocation
+ * every bundler plugin shares. Returns `null` when Babel emits nothing.
+ */
+async function transformExodraJsx(code, filename, options = {}) {
+    const typescript = options.typescript ?? filename.endsWith('.tsx');
+    const result = await babel.transformAsync(code, {
+        filename,
+        babelrc: false,
+        configFile: false,
+        sourceMaps: true,
+        presets: [
+            [
+                babelPresetExodra,
+                {
+                    typescript,
+                    importSource: options.importSource,
+                    hoistStatic: options.hoistStatic,
+                    mode: options.mode,
+                },
+            ],
+        ],
+    });
+    if (!result || result.code == null)
+        return null;
+    return { code: result.code, map: result.map ?? null };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import type { ConfigAPI, PluginItem } from '@babel/core';
+export interface ExodraPresetOptions {
+    /** Module the auto-imported `h`/`text` come from. Default `@exodra/core`. */
+    importSource?: string;
+    /** Compile-time clone-cache for static subtrees. Default `true`. */
+    hoistStatic?: boolean;
+    /**
+     * Include `@babel/preset-typescript` so `.ts`/`.tsx` sources are stripped of
+     * types. Default `true` — turn off if your pipeline already handles TS.
+     */
+    typescript?: boolean;
+    /**
+     * 'dom' (default) compiles JSX to h() schemas for the client renderer; 'ssr'
+     * compiles to HTML-string functions for the server (see @exodra/babel-plugin-jsx).
+     */
+    mode?: 'dom' | 'ssr';
+}
+declare function babelPresetExodra(api: ConfigAPI, options?: ExodraPresetOptions): {
+    presets: PluginItem[];
+    plugins: PluginItem[];
+};
+export default babelPresetExodra;
+/** Result of {@link transformExodraJsx}: emitted code plus a raw source map. */
+export interface ExodraTransformResult {
+    code: string;
+    /** Babel's raw source map object; cast to your bundler's map input type. */
+    map: object | null;
+}
+/** Options for {@link transformExodraJsx}, forwarded to the preset. */
+export interface ExodraTransformOptions {
+    importSource?: string;
+    hoistStatic?: boolean;
+    /**
+     * Run preset-typescript. Defaults to `true` for `.tsx` files and `false`
+     * otherwise (a `.jsx` file has no types and must not be parsed as TSX).
+     */
+    typescript?: boolean;
+    /** 'dom' (default) or 'ssr' — see ExodraPresetOptions.mode. */
+    mode?: 'dom' | 'ssr';
+}
+/**
+ * Compile one Exodra JSX/TSX source through the preset. The single invocation
+ * every bundler plugin shares. Returns `null` when Babel emits nothing.
+ */
+export declare function transformExodraJsx(code: string, filename: string, options?: ExodraTransformOptions): Promise<ExodraTransformResult | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzD,MAAM,WAAW,mBAAmB;IAChC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACxB;AAED,iBAAS,iBAAiB,CACtB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,mBAAwB,GAClC;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CA2BlD;AAED,eAAe,iBAAiB,CAAC;AAEjC,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAuBvC"}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,wDAAwD;AACxD,EAAE;AACF,iFAAiF;AACjF,qEAAqE;AACrE,+EAA+E;AAC/E,yCAAyC;AACzC,EAAE;AACF,0BAA0B;AAC1B,iDAAiD;AACjD,EAAE;AACF,kFAAkF;AAClF,2EAA2E;AAC3E,+EAA+E;AAC/E,8EAA8E;AAC9E,yBAAyB;AACzB,EAAE;AACF,kFAAkF;AAClF,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFpC,gDA2BC;AAlHD,mDAAqC;AAGrC,qEAAqE;AACrE,6EAA6E;AAC7E,oEAAoE;AACpE,uDAAuD;AACvD,MAAM,SAAS,GAAG,OAAO,CAAC,0BAA0B,CAAe,CAAC;AACpE,MAAM,gBAAgB,GAAG,OAAO,CAAC,0BAA0B,CAAe,CAAC;AAC3E,MAAM,eAAe,GAAG,OAAO,CAAC,0BAA0B,CAAe,CAAC;AAoB1E,SAAS,iBAAiB,CACtB,GAAc,EACd,UAA+B,EAAE;IAEjC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAErB,MAAM,EACF,YAAY,GAAG,cAAc,EAC7B,WAAW,GAAG,IAAI,EAClB,UAAU,GAAG,IAAI,EACjB,IAAI,GAAG,KAAK,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC;YACT,gBAAgB;YAChB,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;SACvC,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,OAAO;QACP,OAAO,EAAE;YACL,oEAAoE;YACpE,4DAA4D;YAC5D,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;YACxC,CAAC,eAAe,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACzD;KACJ,CAAC;AACN,CAAC;AAED,kBAAe,iBAAiB,CAAC;AAsBjC;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CACpC,IAAY,EACZ,QAAgB,EAChB,UAAkC,EAAE;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE;QAC5C,QAAQ;QACR,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE;YACL;gBACI,iBAA+B;gBAC/B;oBACI,UAAU;oBACV,YAAY,EAAE,OAAO,CAAC,YAAY;oBAClC,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;iBACrB;aACJ;SACJ;KACJ,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAG,MAAM,CAAC,GAAqB,IAAI,IAAI,EAAE,CAAC;AAC7E,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "babel-preset-exodra",
+  "version": "0.1.0",
+  "description": "Babel preset for Exodra: JSX + TypeScript + directives, ready for Jest/babel-jest",
+  "keywords": [
+    "exodra",
+    "babel",
+    "babel-preset",
+    "jsx",
+    "jest",
+    "babel-jest",
+    "typescript"
+  ],
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && mv dist/index.js dist/index.cjs",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run"
+  },
+  "author": "Andrei Baikov",
+  "license": "MIT",
+  "homepage": "https://exodra.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abaikov/exodra.git",
+    "directory": "packages/babel-preset-exodra"
+  },
+  "bugs": {
+    "url": "https://github.com/abaikov/exodra/issues"
+  },
+  "dependencies": {
+    "@babel/core": "^7.24.0",
+    "@babel/plugin-syntax-jsx": "^7.24.0",
+    "@babel/preset-typescript": "^7.24.0",
+    "@exodra/babel-plugin-jsx": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5"
+  }
+}