@farm.js/react 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Farm.js Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,75 @@
+# @farm.js/react
+
+React renderer integration for FARMJS, including the experimental Group 1 AOT compiler.
+
+React remains the default renderer and needs no package or configuration. Install this package only
+when opting into the compiler experiment:
+
+```bash
+pnpm add @farm.js/react
+```
+
+```ts
+import { defineConfig } from "@farm.js/core";
+import { react } from "@farm.js/react";
+
+export default defineConfig({
+  renderer: react({
+    experimental: {
+      compiler: true,
+    },
+  }),
+});
+```
+
+`compiler: true` uses inference: every application TSX/JSX component is considered, eligible
+components are compiled, and everything else keeps the normal React path.
+
+For selective adoption, use annotation mode:
+
+```ts
+renderer: react({
+  experimental: {
+    compiler: {
+      mode: "annotation",
+      directive: "use compiler",
+      onUnsupported: "warn",
+    },
+  },
+}),
+```
+
+```tsx
+export function Counter() {
+  "use compiler";
+  const [count, setCount] = useState(0);
+  return <button onClick={() => setCount((value) => value + 1)}>Count: {count}</button>;
+}
+```
+
+The directive is configurable and only has meaning in annotation mode.
+
+## Group 1 contract
+
+The first compiler group handles components that the compiler can prove have:
+
+- one host-element root and a static host-element tree;
+- top-level `useState` declarations;
+- state-driven text and basic attribute/property bindings;
+- React-managed event handlers; and
+- no refs, effects, custom child components, keyed lists, or conditional child structure.
+
+The generated component preserves React ownership of placement, props, events, SSR, and hydration.
+Local state cells batch updates into a microtask and patch only compiler-known DOM paths. A local
+state update therefore does not schedule a React render or reconciliation pass.
+
+Unsupported components fall back to React by default. Use `onUnsupported: "warn"` for diagnostics
+or `onUnsupported: "error"` while tightening an annotated migration.
+
+The runtime test compares the same counter interaction on both paths: ordinary React performs a
+second component render and commit, while the compiled component remains at one render and one
+commit and updates its two bindings directly. This is a deterministic structural performance
+assertion; it is not presented as a cross-machine timing benchmark.
+
+Keyed list lowering, structural conditionals, effects, and more advanced hook support belong to
+later compiler groups and intentionally stay on React in this release.

package/dist/client.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var client = require('@farm.js/core/renderer/react/client');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var client__default = /*#__PURE__*/_interopDefault(client);
+
+
+
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () { return client__default.default; }
+});
+Object.keys(client).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return client[k]; }
+  });
+});
+//# sourceMappingURL=client.cjs.map
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"client.cjs","sourcesContent":[]}

package/dist/client.d.mts

@@ -0,0 +1,2 @@
+export * from '@farm.js/core/renderer/react/client';
+export { default } from '@farm.js/core/renderer/react/client';

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export * from '@farm.js/core/renderer/react/client';
+export { default } from '@farm.js/core/renderer/react/client';

package/dist/client.mjs

@@ -0,0 +1,4 @@
+export * from '@farm.js/core/renderer/react/client';
+export { default } from '@farm.js/core/renderer/react/client';
+//# sourceMappingURL=client.mjs.map
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"client.mjs","sourcesContent":[]}

package/dist/compiler-runtime.cjs

@@ -0,0 +1,140 @@
+'use strict';
+
+var React = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+// src/compiler-runtime.tsx
+function renderTextValue(value) {
+  if (Array.isArray(value)) return value.map(renderTextValue).join("");
+  if (value === null || value === void 0 || typeof value === "boolean") return "";
+  return String(value);
+}
+function findBindingTarget(root, path) {
+  let current = root;
+  for (const index of path) {
+    current = current?.children.item(index) || null;
+  }
+  return current;
+}
+function updateAttribute(element, name, value) {
+  const attributeName = name === "className" ? "class" : name === "htmlFor" ? "for" : name;
+  const stringifiesBoolean = attributeName.startsWith("data-") || attributeName.startsWith("aria-");
+  if (name === "value" && element instanceof HTMLInputElement) {
+    element.value = value === null || value === void 0 ? "" : String(value);
+    return;
+  }
+  if (name === "checked" && element instanceof HTMLInputElement) {
+    element.checked = Boolean(value);
+    return;
+  }
+  if (name === "selected" && element instanceof HTMLOptionElement) {
+    element.selected = Boolean(value);
+    return;
+  }
+  if (name === "disabled" && "disabled" in element) {
+    element.disabled = Boolean(value);
+    return;
+  }
+  if (value === null || value === void 0 || value === false && !stringifiesBoolean) {
+    element.removeAttribute(attributeName);
+  } else if (value === true && !stringifiesBoolean) {
+    element.setAttribute(attributeName, "");
+  } else {
+    element.setAttribute(attributeName, String(value));
+  }
+}
+function createCompiledComponent(definition) {
+  class FarmCompiledComponent extends React__default.default.Component {
+    constructor(props) {
+      super(props);
+      this.root = null;
+      this.mounted = false;
+      this.flushQueued = false;
+      this.dirtyState = /* @__PURE__ */ new Set();
+      this.captureRoot = (root) => {
+        this.root = root;
+      };
+      this.cells = definition.initialize(props).map((initialValue, index) => {
+        let value = initialValue;
+        const pending = [];
+        return {
+          get: () => value,
+          set: (next) => {
+            pending.push(next);
+            this.scheduleBindingFlush(index);
+          },
+          flush: () => {
+            if (pending.length === 0) return false;
+            const previous = value;
+            for (const next of pending.splice(0)) {
+              value = typeof next === "function" ? next(value) : next;
+            }
+            return !Object.is(previous, value);
+          }
+        };
+      });
+    }
+    scheduleBindingFlush(index) {
+      this.dirtyState.add(index);
+      if (!this.mounted || this.flushQueued) return;
+      this.flushQueued = true;
+      queueMicrotask(() => {
+        this.flushQueued = false;
+        if (!this.mounted) return;
+        const dirty = /* @__PURE__ */ new Set();
+        for (const index2 of this.dirtyState) {
+          if (this.cells[index2]?.flush()) dirty.add(index2);
+        }
+        this.dirtyState.clear();
+        if (dirty.size === 0) return;
+        for (const binding of definition.bindings) {
+          if (binding.dependencies.some((dependency) => dirty.has(dependency))) {
+            this.applyBinding(binding);
+          }
+        }
+      });
+    }
+    applyBinding(binding) {
+      if (!this.root) return;
+      const target = findBindingTarget(this.root, binding.path);
+      if (!target) return;
+      const value = binding.read(this.props, this.cells);
+      if (binding.kind === "text") {
+        target.textContent = renderTextValue(value);
+      } else {
+        updateAttribute(target, binding.name, value);
+      }
+    }
+    componentDidMount() {
+      this.mounted = true;
+    }
+    componentDidUpdate() {
+      for (const binding of definition.bindings) this.applyBinding(binding);
+    }
+    componentWillUnmount() {
+      this.mounted = false;
+      this.root = null;
+      this.dirtyState.clear();
+    }
+    render() {
+      const element = definition.render(this.props, this.cells);
+      if (!React__default.default.isValidElement(element) || typeof element.type !== "string") {
+        throw new TypeError(
+          `Compiled component ${definition.displayName} must return one host element.`
+        );
+      }
+      return React__default.default.cloneElement(element, {
+        ref: this.captureRoot
+      });
+    }
+  }
+  FarmCompiledComponent.displayName = `FarmCompiled(${definition.displayName})`;
+  return FarmCompiledComponent;
+}
+
+exports.createCompiledComponent = createCompiledComponent;
+//# sourceMappingURL=compiler-runtime.cjs.map
+//# sourceMappingURL=compiler-runtime.cjs.map

package/dist/compiler-runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compiler-runtime.tsx"],"names":["React","index"],"mappings":";;;;;;;;;AAqCA,SAAS,gBAAgB,KAAA,EAAwB;AAC/C,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,MAAM,GAAA,CAAI,eAAe,CAAA,CAAE,IAAA,CAAK,EAAE,CAAA;AACnE,EAAA,IAAI,UAAU,IAAA,IAAQ,KAAA,KAAU,UAAa,OAAO,KAAA,KAAU,WAAW,OAAO,EAAA;AAChF,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAEA,SAAS,iBAAA,CAAkB,MAAe,IAAA,EAAyC;AACjF,EAAA,IAAI,OAAA,GAA0B,IAAA;AAC9B,EAAA,KAAA,MAAW,SAAS,IAAA,EAAM;AACxB,IAAA,OAAA,GAAU,OAAA,EAAS,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA,IAAK,IAAA;AAAA,EAC7C;AACA,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,eAAA,CAAgB,OAAA,EAAkB,IAAA,EAAc,KAAA,EAAsB;AAC7E,EAAA,MAAM,gBAAgB,IAAA,KAAS,WAAA,GAAc,OAAA,GAAU,IAAA,KAAS,YAAY,KAAA,GAAQ,IAAA;AACpF,EAAA,MAAM,qBAAqB,aAAA,CAAc,UAAA,CAAW,OAAO,CAAA,IAAK,aAAA,CAAc,WAAW,OAAO,CAAA;AAEhG,EAAA,IAAI,IAAA,KAAS,OAAA,IAAW,OAAA,YAAmB,gBAAA,EAAkB;AAC3D,IAAA,OAAA,CAAQ,QAAQ,KAAA,KAAU,IAAA,IAAQ,UAAU,MAAA,GAAY,EAAA,GAAK,OAAO,KAAK,CAAA;AACzE,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,KAAS,SAAA,IAAa,OAAA,YAAmB,gBAAA,EAAkB;AAC7D,IAAA,OAAA,CAAQ,OAAA,GAAU,QAAQ,KAAK,CAAA;AAC/B,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,KAAS,UAAA,IAAc,OAAA,YAAmB,iBAAA,EAAmB;AAC/D,IAAA,OAAA,CAAQ,QAAA,GAAW,QAAQ,KAAK,CAAA;AAChC,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,KAAS,UAAA,IAAc,UAAA,IAAc,OAAA,EAAS;AAChD,IAAC,OAAA,CAA8B,QAAA,GAAW,OAAA,CAAQ,KAAK,CAAA;AACvD,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,UAAU,IAAA,IAAQ,KAAA,KAAU,UAAc,KAAA,KAAU,KAAA,IAAS,CAAC,kBAAA,EAAqB;AACrF,IAAA,OAAA,CAAQ,gBAAgB,aAAa,CAAA;AAAA,EACvC,CAAA,MAAA,IAAW,KAAA,KAAU,IAAA,IAAQ,CAAC,kBAAA,EAAoB;AAChD,IAAA,OAAA,CAAQ,YAAA,CAAa,eAAe,EAAE,CAAA;AAAA,EACxC,CAAA,MAAO;AACL,IAAA,OAAA,CAAQ,YAAA,CAAa,aAAA,EAAe,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACnD;AACF;AAQO,SAAS,wBACd,UAAA,EAC4B;AAAA,EAC5B,MAAM,qBAAA,SAA8BA,sBAAA,CAAM,SAAA,CAAiB;AAAA,IAOzD,YAAY,KAAA,EAAc;AACxB,MAAA,KAAA,CAAM,KAAK,CAAA;AAPb,MAAA,IAAA,CAAQ,IAAA,GAAuB,IAAA;AAC/B,MAAA,IAAA,CAAQ,OAAA,GAAU,KAAA;AAClB,MAAA,IAAA,CAAQ,WAAA,GAAc,KAAA;AACtB,MAAA,IAAA,CAAiB,UAAA,uBAAiB,GAAA,EAAY;AA0B9C,MAAA,IAAA,CAAQ,WAAA,GAAc,CAAC,IAAA,KAAyB;AAC9C,QAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,MACd,CAAA;AAvBE,MAAA,IAAA,CAAK,KAAA,GAAQ,WAAW,UAAA,CAAW,KAAK,EAAE,GAAA,CAAI,CAAC,cAAc,KAAA,KAAU;AACrE,QAAA,IAAI,KAAA,GAAQ,YAAA;AACZ,QAAA,MAAM,UAAkC,EAAC;AACzC,QAAA,OAAO;AAAA,UACL,KAAK,MAAM,KAAA;AAAA,UACX,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,YAAA,OAAA,CAAQ,KAAK,IAAI,CAAA;AACjB,YAAA,IAAA,CAAK,qBAAqB,KAAK,CAAA;AAAA,UACjC,CAAA;AAAA,UACA,OAAO,MAAM;AACX,YAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AACjC,YAAA,MAAM,QAAA,GAAW,KAAA;AACjB,YAAA,KAAA,MAAW,IAAA,IAAQ,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,EAAG;AACpC,cAAA,KAAA,GAAQ,OAAO,IAAA,KAAS,UAAA,GAAa,IAAA,CAAK,KAAK,CAAA,GAAI,IAAA;AAAA,YACrD;AACA,YAAA,OAAO,CAAC,MAAA,CAAO,EAAA,CAAG,QAAA,EAAU,KAAK,CAAA;AAAA,UACnC;AAAA,SACF;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAAA,IAMQ,qBAAqB,KAAA,EAAqB;AAChD,MAAA,IAAA,CAAK,UAAA,CAAW,IAAI,KAAK,CAAA;AACzB,MAAA,IAAI,CAAC,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,WAAA,EAAa;AACvC,MAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,MAAA,cAAA,CAAe,MAAM;AACnB,QAAA,IAAA,CAAK,WAAA,GAAc,KAAA;AACnB,QAAA,IAAI,CAAC,KAAK,OAAA,EAAS;AACnB,QAAA,MAAM,KAAA,uBAAY,GAAA,EAAY;AAC9B,QAAA,KAAA,MAAWC,MAAAA,IAAS,KAAK,UAAA,EAAY;AACnC,UAAA,IAAI,IAAA,CAAK,MAAMA,MAAK,CAAA,EAAG,OAAM,EAAG,KAAA,CAAM,IAAIA,MAAK,CAAA;AAAA,QACjD;AACA,QAAA,IAAA,CAAK,WAAW,KAAA,EAAM;AACtB,QAAA,IAAI,KAAA,CAAM,SAAS,CAAA,EAAG;AACtB,QAAA,KAAA,MAAW,OAAA,IAAW,WAAW,QAAA,EAAU;AACzC,UAAA,IAAI,OAAA,CAAQ,aAAa,IAAA,CAAK,CAAC,eAAe,KAAA,CAAM,GAAA,CAAI,UAAU,CAAC,CAAA,EAAG;AACpE,YAAA,IAAA,CAAK,aAAa,OAAO,CAAA;AAAA,UAC3B;AAAA,QACF;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAAA,IAEQ,aAAa,OAAA,EAAuC;AAC1D,MAAA,IAAI,CAAC,KAAK,IAAA,EAAM;AAChB,MAAA,MAAM,MAAA,GAAS,iBAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,QAAQ,IAAI,CAAA;AACxD,MAAA,IAAI,CAAC,MAAA,EAAQ;AACb,MAAA,MAAM,QAAQ,OAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,KAAK,KAAK,CAAA;AACjD,MAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAQ;AAC3B,QAAA,MAAA,CAAO,WAAA,GAAc,gBAAgB,KAAK,CAAA;AAAA,MAC5C,CAAA,MAAO;AACL,QAAA,eAAA,CAAgB,MAAA,EAAQ,OAAA,CAAQ,IAAA,EAAM,KAAK,CAAA;AAAA,MAC7C;AAAA,IACF;AAAA,IAEA,iBAAA,GAA0B;AACxB,MAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AAAA,IACjB;AAAA,IAEA,kBAAA,GAA2B;AAIzB,MAAA,KAAA,MAAW,OAAA,IAAW,UAAA,CAAW,QAAA,EAAU,IAAA,CAAK,aAAa,OAAO,CAAA;AAAA,IACtE;AAAA,IAEA,oBAAA,GAA6B;AAC3B,MAAA,IAAA,CAAK,OAAA,GAAU,KAAA;AACf,MAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,MAAA,IAAA,CAAK,WAAW,KAAA,EAAM;AAAA,IACxB;AAAA,IAEA,MAAA,GAA0B;AACxB,MAAA,MAAM,UAAU,UAAA,CAAW,MAAA,CAAO,IAAA,CAAK,KAAA,EAAO,KAAK,KAAK,CAAA;AACxD,MAAA,IAAI,CAACD,uBAAM,cAAA,CAAe,OAAO,KAAK,OAAO,OAAA,CAAQ,SAAS,QAAA,EAAU;AACtE,QAAA,MAAM,IAAI,SAAA;AAAA,UACR,CAAA,mBAAA,EAAsB,WAAW,WAAW,CAAA,8BAAA;AAAA,SAC9C;AAAA,MACF;AACA,MAAA,OAAOA,sBAAA,CAAM,aAAa,OAAA,EAAS;AAAA,QACjC,KAAK,IAAA,CAAK;AAAA,OACS,CAAA;AAAA,IACvB;AAAA;AAGF,EAAC,qBAAA,CAAqD,WAAA,GACpD,CAAA,aAAA,EAAgB,UAAA,CAAW,WAAW,CAAA,CAAA,CAAA;AACxC,EAAA,OAAO,qBAAA;AACT","file":"compiler-runtime.cjs","sourcesContent":["import React from \"react\";\n\nexport type CompilerStateUpdater = unknown | ((previous: unknown) => unknown);\n\nexport interface CompilerCell {\n  get(): unknown;\n  set(next: CompilerStateUpdater): void;\n}\n\ninterface RuntimeCell extends CompilerCell {\n  flush(): boolean;\n}\n\nexport interface CompilerTextBinding<Props> {\n  kind: \"text\";\n  path: readonly number[];\n  dependencies: readonly number[];\n  read(props: Props, state: readonly CompilerCell[]): unknown;\n}\n\nexport interface CompilerAttributeBinding<Props> {\n  kind: \"attribute\";\n  path: readonly number[];\n  dependencies: readonly number[];\n  name: string;\n  read(props: Props, state: readonly CompilerCell[]): unknown;\n}\n\nexport type CompilerBinding<Props> = CompilerTextBinding<Props> | CompilerAttributeBinding<Props>;\n\nexport interface CompiledComponentDefinition<Props> {\n  displayName: string;\n  initialize(props: Props): readonly unknown[];\n  render(props: Props, state: readonly CompilerCell[]): React.ReactElement;\n  bindings: readonly CompilerBinding<Props>[];\n}\n\nfunction renderTextValue(value: unknown): string {\n  if (Array.isArray(value)) return value.map(renderTextValue).join(\"\");\n  if (value === null || value === undefined || typeof value === \"boolean\") return \"\";\n  return String(value);\n}\n\nfunction findBindingTarget(root: Element, path: readonly number[]): Element | null {\n  let current: Element | null = root;\n  for (const index of path) {\n    current = current?.children.item(index) || null;\n  }\n  return current;\n}\n\nfunction updateAttribute(element: Element, name: string, value: unknown): void {\n  const attributeName = name === \"className\" ? \"class\" : name === \"htmlFor\" ? \"for\" : name;\n  const stringifiesBoolean = attributeName.startsWith(\"data-\") || attributeName.startsWith(\"aria-\");\n\n  if (name === \"value\" && element instanceof HTMLInputElement) {\n    element.value = value === null || value === undefined ? \"\" : String(value);\n    return;\n  }\n\n  if (name === \"checked\" && element instanceof HTMLInputElement) {\n    element.checked = Boolean(value);\n    return;\n  }\n\n  if (name === \"selected\" && element instanceof HTMLOptionElement) {\n    element.selected = Boolean(value);\n    return;\n  }\n\n  if (name === \"disabled\" && \"disabled\" in element) {\n    (element as HTMLButtonElement).disabled = Boolean(value);\n    return;\n  }\n\n  if (value === null || value === undefined || (value === false && !stringifiesBoolean)) {\n    element.removeAttribute(attributeName);\n  } else if (value === true && !stringifiesBoolean) {\n    element.setAttribute(attributeName, \"\");\n  } else {\n    element.setAttribute(attributeName, String(value));\n  }\n}\n\n/**\n * Runtime target emitted by the AOT transform.\n *\n * React owns component placement, SSR, hydration, props, and event semantics.\n * Compiler cells own local state updates and patch only precomputed DOM paths.\n */\nexport function createCompiledComponent<Props>(\n  definition: CompiledComponentDefinition<Props>,\n): React.ComponentType<Props> {\n  class FarmCompiledComponent extends React.Component<Props> {\n    private root: Element | null = null;\n    private mounted = false;\n    private flushQueued = false;\n    private readonly dirtyState = new Set<number>();\n    private readonly cells: RuntimeCell[];\n\n    constructor(props: Props) {\n      super(props);\n      this.cells = definition.initialize(props).map((initialValue, index) => {\n        let value = initialValue;\n        const pending: CompilerStateUpdater[] = [];\n        return {\n          get: () => value,\n          set: (next) => {\n            pending.push(next);\n            this.scheduleBindingFlush(index);\n          },\n          flush: () => {\n            if (pending.length === 0) return false;\n            const previous = value;\n            for (const next of pending.splice(0)) {\n              value = typeof next === \"function\" ? next(value) : next;\n            }\n            return !Object.is(previous, value);\n          },\n        };\n      });\n    }\n\n    private captureRoot = (root: Element | null) => {\n      this.root = root;\n    };\n\n    private scheduleBindingFlush(index: number): void {\n      this.dirtyState.add(index);\n      if (!this.mounted || this.flushQueued) return;\n      this.flushQueued = true;\n      queueMicrotask(() => {\n        this.flushQueued = false;\n        if (!this.mounted) return;\n        const dirty = new Set<number>();\n        for (const index of this.dirtyState) {\n          if (this.cells[index]?.flush()) dirty.add(index);\n        }\n        this.dirtyState.clear();\n        if (dirty.size === 0) return;\n        for (const binding of definition.bindings) {\n          if (binding.dependencies.some((dependency) => dirty.has(dependency))) {\n            this.applyBinding(binding);\n          }\n        }\n      });\n    }\n\n    private applyBinding(binding: CompilerBinding<Props>): void {\n      if (!this.root) return;\n      const target = findBindingTarget(this.root, binding.path);\n      if (!target) return;\n      const value = binding.read(this.props, this.cells);\n      if (binding.kind === \"text\") {\n        target.textContent = renderTextValue(value);\n      } else {\n        updateAttribute(target, binding.name, value);\n      }\n    }\n\n    componentDidMount(): void {\n      this.mounted = true;\n    }\n\n    componentDidUpdate(): void {\n      // React has reconciled a parent-driven prop update. Reapply compiled\n      // bindings from the current cells so React and the imperative state stay\n      // coherent even when both change in the same turn.\n      for (const binding of definition.bindings) this.applyBinding(binding);\n    }\n\n    componentWillUnmount(): void {\n      this.mounted = false;\n      this.root = null;\n      this.dirtyState.clear();\n    }\n\n    render(): React.ReactNode {\n      const element = definition.render(this.props, this.cells);\n      if (!React.isValidElement(element) || typeof element.type !== \"string\") {\n        throw new TypeError(\n          `Compiled component ${definition.displayName} must return one host element.`,\n        );\n      }\n      return React.cloneElement(element, {\n        ref: this.captureRoot,\n      } as React.Attributes);\n    }\n  }\n\n  (FarmCompiledComponent as React.ComponentType<Props>).displayName =\n    `FarmCompiled(${definition.displayName})`;\n  return FarmCompiledComponent;\n}\n"]}

package/dist/compiler-runtime.d.mts

@@ -0,0 +1,36 @@
+import React from 'react';
+
+type CompilerStateUpdater = unknown | ((previous: unknown) => unknown);
+interface CompilerCell {
+    get(): unknown;
+    set(next: CompilerStateUpdater): void;
+}
+interface CompilerTextBinding<Props> {
+    kind: "text";
+    path: readonly number[];
+    dependencies: readonly number[];
+    read(props: Props, state: readonly CompilerCell[]): unknown;
+}
+interface CompilerAttributeBinding<Props> {
+    kind: "attribute";
+    path: readonly number[];
+    dependencies: readonly number[];
+    name: string;
+    read(props: Props, state: readonly CompilerCell[]): unknown;
+}
+type CompilerBinding<Props> = CompilerTextBinding<Props> | CompilerAttributeBinding<Props>;
+interface CompiledComponentDefinition<Props> {
+    displayName: string;
+    initialize(props: Props): readonly unknown[];
+    render(props: Props, state: readonly CompilerCell[]): React.ReactElement;
+    bindings: readonly CompilerBinding<Props>[];
+}
+/**
+ * Runtime target emitted by the AOT transform.
+ *
+ * React owns component placement, SSR, hydration, props, and event semantics.
+ * Compiler cells own local state updates and patch only precomputed DOM paths.
+ */
+declare function createCompiledComponent<Props>(definition: CompiledComponentDefinition<Props>): React.ComponentType<Props>;
+
+export { type CompiledComponentDefinition, type CompilerAttributeBinding, type CompilerBinding, type CompilerCell, type CompilerStateUpdater, type CompilerTextBinding, createCompiledComponent };

package/dist/compiler-runtime.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+
+type CompilerStateUpdater = unknown | ((previous: unknown) => unknown);
+interface CompilerCell {
+    get(): unknown;
+    set(next: CompilerStateUpdater): void;
+}
+interface CompilerTextBinding<Props> {
+    kind: "text";
+    path: readonly number[];
+    dependencies: readonly number[];
+    read(props: Props, state: readonly CompilerCell[]): unknown;
+}
+interface CompilerAttributeBinding<Props> {
+    kind: "attribute";
+    path: readonly number[];
+    dependencies: readonly number[];
+    name: string;
+    read(props: Props, state: readonly CompilerCell[]): unknown;
+}
+type CompilerBinding<Props> = CompilerTextBinding<Props> | CompilerAttributeBinding<Props>;
+interface CompiledComponentDefinition<Props> {
+    displayName: string;
+    initialize(props: Props): readonly unknown[];
+    render(props: Props, state: readonly CompilerCell[]): React.ReactElement;
+    bindings: readonly CompilerBinding<Props>[];
+}
+/**
+ * Runtime target emitted by the AOT transform.
+ *
+ * React owns component placement, SSR, hydration, props, and event semantics.
+ * Compiler cells own local state updates and patch only precomputed DOM paths.
+ */
+declare function createCompiledComponent<Props>(definition: CompiledComponentDefinition<Props>): React.ComponentType<Props>;
+
+export { type CompiledComponentDefinition, type CompilerAttributeBinding, type CompilerBinding, type CompilerCell, type CompilerStateUpdater, type CompilerTextBinding, createCompiledComponent };

package/dist/compiler-runtime.mjs

@@ -0,0 +1,134 @@
+import React from 'react';
+
+// src/compiler-runtime.tsx
+function renderTextValue(value) {
+  if (Array.isArray(value)) return value.map(renderTextValue).join("");
+  if (value === null || value === void 0 || typeof value === "boolean") return "";
+  return String(value);
+}
+function findBindingTarget(root, path) {
+  let current = root;
+  for (const index of path) {
+    current = current?.children.item(index) || null;
+  }
+  return current;
+}
+function updateAttribute(element, name, value) {
+  const attributeName = name === "className" ? "class" : name === "htmlFor" ? "for" : name;
+  const stringifiesBoolean = attributeName.startsWith("data-") || attributeName.startsWith("aria-");
+  if (name === "value" && element instanceof HTMLInputElement) {
+    element.value = value === null || value === void 0 ? "" : String(value);
+    return;
+  }
+  if (name === "checked" && element instanceof HTMLInputElement) {
+    element.checked = Boolean(value);
+    return;
+  }
+  if (name === "selected" && element instanceof HTMLOptionElement) {
+    element.selected = Boolean(value);
+    return;
+  }
+  if (name === "disabled" && "disabled" in element) {
+    element.disabled = Boolean(value);
+    return;
+  }
+  if (value === null || value === void 0 || value === false && !stringifiesBoolean) {
+    element.removeAttribute(attributeName);
+  } else if (value === true && !stringifiesBoolean) {
+    element.setAttribute(attributeName, "");
+  } else {
+    element.setAttribute(attributeName, String(value));
+  }
+}
+function createCompiledComponent(definition) {
+  class FarmCompiledComponent extends React.Component {
+    constructor(props) {
+      super(props);
+      this.root = null;
+      this.mounted = false;
+      this.flushQueued = false;
+      this.dirtyState = /* @__PURE__ */ new Set();
+      this.captureRoot = (root) => {
+        this.root = root;
+      };
+      this.cells = definition.initialize(props).map((initialValue, index) => {
+        let value = initialValue;
+        const pending = [];
+        return {
+          get: () => value,
+          set: (next) => {
+            pending.push(next);
+            this.scheduleBindingFlush(index);
+          },
+          flush: () => {
+            if (pending.length === 0) return false;
+            const previous = value;
+            for (const next of pending.splice(0)) {
+              value = typeof next === "function" ? next(value) : next;
+            }
+            return !Object.is(previous, value);
+          }
+        };
+      });
+    }
+    scheduleBindingFlush(index) {
+      this.dirtyState.add(index);
+      if (!this.mounted || this.flushQueued) return;
+      this.flushQueued = true;
+      queueMicrotask(() => {
+        this.flushQueued = false;
+        if (!this.mounted) return;
+        const dirty = /* @__PURE__ */ new Set();
+        for (const index2 of this.dirtyState) {
+          if (this.cells[index2]?.flush()) dirty.add(index2);
+        }
+        this.dirtyState.clear();
+        if (dirty.size === 0) return;
+        for (const binding of definition.bindings) {
+          if (binding.dependencies.some((dependency) => dirty.has(dependency))) {
+            this.applyBinding(binding);
+          }
+        }
+      });
+    }
+    applyBinding(binding) {
+      if (!this.root) return;
+      const target = findBindingTarget(this.root, binding.path);
+      if (!target) return;
+      const value = binding.read(this.props, this.cells);
+      if (binding.kind === "text") {
+        target.textContent = renderTextValue(value);
+      } else {
+        updateAttribute(target, binding.name, value);
+      }
+    }
+    componentDidMount() {
+      this.mounted = true;
+    }
+    componentDidUpdate() {
+      for (const binding of definition.bindings) this.applyBinding(binding);
+    }
+    componentWillUnmount() {
+      this.mounted = false;
+      this.root = null;
+      this.dirtyState.clear();
+    }
+    render() {
+      const element = definition.render(this.props, this.cells);
+      if (!React.isValidElement(element) || typeof element.type !== "string") {
+        throw new TypeError(
+          `Compiled component ${definition.displayName} must return one host element.`
+        );
+      }
+      return React.cloneElement(element, {
+        ref: this.captureRoot
+      });
+    }
+  }
+  FarmCompiledComponent.displayName = `FarmCompiled(${definition.displayName})`;
+  return FarmCompiledComponent;
+}
+
+export { createCompiledComponent };
+//# sourceMappingURL=compiler-runtime.mjs.map
+//# sourceMappingURL=compiler-runtime.mjs.map

package/dist/compiler-runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compiler-runtime.tsx"],"names":["index"],"mappings":"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","file":"compiler-runtime.mjs","sourcesContent":["import React from \"react\";\n\nexport type CompilerStateUpdater = unknown | ((previous: unknown) => unknown);\n\nexport interface CompilerCell {\n  get(): unknown;\n  set(next: CompilerStateUpdater): void;\n}\n\ninterface RuntimeCell extends CompilerCell {\n  flush(): boolean;\n}\n\nexport interface CompilerTextBinding<Props> {\n  kind: \"text\";\n  path: readonly number[];\n  dependencies: readonly number[];\n  read(props: Props, state: readonly CompilerCell[]): unknown;\n}\n\nexport interface CompilerAttributeBinding<Props> {\n  kind: \"attribute\";\n  path: readonly number[];\n  dependencies: readonly number[];\n  name: string;\n  read(props: Props, state: readonly CompilerCell[]): unknown;\n}\n\nexport type CompilerBinding<Props> = CompilerTextBinding<Props> | CompilerAttributeBinding<Props>;\n\nexport interface CompiledComponentDefinition<Props> {\n  displayName: string;\n  initialize(props: Props): readonly unknown[];\n  render(props: Props, state: readonly CompilerCell[]): React.ReactElement;\n  bindings: readonly CompilerBinding<Props>[];\n}\n\nfunction renderTextValue(value: unknown): string {\n  if (Array.isArray(value)) return value.map(renderTextValue).join(\"\");\n  if (value === null || value === undefined || typeof value === \"boolean\") return \"\";\n  return String(value);\n}\n\nfunction findBindingTarget(root: Element, path: readonly number[]): Element | null {\n  let current: Element | null = root;\n  for (const index of path) {\n    current = current?.children.item(index) || null;\n  }\n  return current;\n}\n\nfunction updateAttribute(element: Element, name: string, value: unknown): void {\n  const attributeName = name === \"className\" ? \"class\" : name === \"htmlFor\" ? \"for\" : name;\n  const stringifiesBoolean = attributeName.startsWith(\"data-\") || attributeName.startsWith(\"aria-\");\n\n  if (name === \"value\" && element instanceof HTMLInputElement) {\n    element.value = value === null || value === undefined ? \"\" : String(value);\n    return;\n  }\n\n  if (name === \"checked\" && element instanceof HTMLInputElement) {\n    element.checked = Boolean(value);\n    return;\n  }\n\n  if (name === \"selected\" && element instanceof HTMLOptionElement) {\n    element.selected = Boolean(value);\n    return;\n  }\n\n  if (name === \"disabled\" && \"disabled\" in element) {\n    (element as HTMLButtonElement).disabled = Boolean(value);\n    return;\n  }\n\n  if (value === null || value === undefined || (value === false && !stringifiesBoolean)) {\n    element.removeAttribute(attributeName);\n  } else if (value === true && !stringifiesBoolean) {\n    element.setAttribute(attributeName, \"\");\n  } else {\n    element.setAttribute(attributeName, String(value));\n  }\n}\n\n/**\n * Runtime target emitted by the AOT transform.\n *\n * React owns component placement, SSR, hydration, props, and event semantics.\n * Compiler cells own local state updates and patch only precomputed DOM paths.\n */\nexport function createCompiledComponent<Props>(\n  definition: CompiledComponentDefinition<Props>,\n): React.ComponentType<Props> {\n  class FarmCompiledComponent extends React.Component<Props> {\n    private root: Element | null = null;\n    private mounted = false;\n    private flushQueued = false;\n    private readonly dirtyState = new Set<number>();\n    private readonly cells: RuntimeCell[];\n\n    constructor(props: Props) {\n      super(props);\n      this.cells = definition.initialize(props).map((initialValue, index) => {\n        let value = initialValue;\n        const pending: CompilerStateUpdater[] = [];\n        return {\n          get: () => value,\n          set: (next) => {\n            pending.push(next);\n            this.scheduleBindingFlush(index);\n          },\n          flush: () => {\n            if (pending.length === 0) return false;\n            const previous = value;\n            for (const next of pending.splice(0)) {\n              value = typeof next === \"function\" ? next(value) : next;\n            }\n            return !Object.is(previous, value);\n          },\n        };\n      });\n    }\n\n    private captureRoot = (root: Element | null) => {\n      this.root = root;\n    };\n\n    private scheduleBindingFlush(index: number): void {\n      this.dirtyState.add(index);\n      if (!this.mounted || this.flushQueued) return;\n      this.flushQueued = true;\n      queueMicrotask(() => {\n        this.flushQueued = false;\n        if (!this.mounted) return;\n        const dirty = new Set<number>();\n        for (const index of this.dirtyState) {\n          if (this.cells[index]?.flush()) dirty.add(index);\n        }\n        this.dirtyState.clear();\n        if (dirty.size === 0) return;\n        for (const binding of definition.bindings) {\n          if (binding.dependencies.some((dependency) => dirty.has(dependency))) {\n            this.applyBinding(binding);\n          }\n        }\n      });\n    }\n\n    private applyBinding(binding: CompilerBinding<Props>): void {\n      if (!this.root) return;\n      const target = findBindingTarget(this.root, binding.path);\n      if (!target) return;\n      const value = binding.read(this.props, this.cells);\n      if (binding.kind === \"text\") {\n        target.textContent = renderTextValue(value);\n      } else {\n        updateAttribute(target, binding.name, value);\n      }\n    }\n\n    componentDidMount(): void {\n      this.mounted = true;\n    }\n\n    componentDidUpdate(): void {\n      // React has reconciled a parent-driven prop update. Reapply compiled\n      // bindings from the current cells so React and the imperative state stay\n      // coherent even when both change in the same turn.\n      for (const binding of definition.bindings) this.applyBinding(binding);\n    }\n\n    componentWillUnmount(): void {\n      this.mounted = false;\n      this.root = null;\n      this.dirtyState.clear();\n    }\n\n    render(): React.ReactNode {\n      const element = definition.render(this.props, this.cells);\n      if (!React.isValidElement(element) || typeof element.type !== \"string\") {\n        throw new TypeError(\n          `Compiled component ${definition.displayName} must return one host element.`,\n        );\n      }\n      return React.cloneElement(element, {\n        ref: this.captureRoot,\n      } as React.Attributes);\n    }\n  }\n\n  (FarmCompiledComponent as React.ComponentType<Props>).displayName =\n    `FarmCompiled(${definition.displayName})`;\n  return FarmCompiledComponent;\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+// src/index.ts
+var DEFAULT_COMPILER_DIRECTIVE = "use compiler";
+function normalizeReactCompilerOptions(value) {
+  const options = value === true ? {} : value;
+  const mode = options.mode || "infer";
+  if (mode !== "infer" && mode !== "annotation") {
+    throw new TypeError(`Unknown React compiler mode: ${String(mode)}`);
+  }
+  if (options.directive !== void 0 && mode !== "annotation") {
+    throw new TypeError("The React compiler directive can only be configured in annotation mode.");
+  }
+  const directive = options.directive?.trim() || DEFAULT_COMPILER_DIRECTIVE;
+  const onUnsupported = options.onUnsupported || "fallback";
+  if (!["fallback", "warn", "error"].includes(onUnsupported)) {
+    throw new TypeError(`Unknown unsupported-component behavior: ${String(onUnsupported)}`);
+  }
+  return { mode, directive, onUnsupported };
+}
+var REACT_RENDERER = Object.freeze({
+  name: "react",
+  vite: "@farm.js/react/vite",
+  server: "@farm.js/react/server",
+  client: "@farm.js/react/client",
+  jsxImportSource: "react",
+  dedupe: ["react", "react-dom", "react/jsx-runtime", "react/jsx-dev-runtime"],
+  optimizeDeps: [
+    "react",
+    "react-dom",
+    "react-dom/client",
+    "react/jsx-runtime",
+    "react/jsx-dev-runtime",
+    "@farm.js/react/compiler-runtime"
+  ],
+  capabilities: {
+    streaming: { node: true, web: false }
+  }
+});
+function react(options = {}) {
+  const compiler = options.experimental?.compiler;
+  const normalizedCompiler = compiler ? normalizeReactCompilerOptions(compiler) : false;
+  return {
+    ...REACT_RENDERER,
+    dedupe: [...REACT_RENDERER.dedupe || []],
+    optimizeDeps: [...REACT_RENDERER.optimizeDeps || []],
+    capabilities: {
+      streaming: { ...REACT_RENDERER.capabilities?.streaming }
+    },
+    options: {
+      experimental: { compiler: normalizedCompiler }
+    }
+  };
+}
+
+exports.DEFAULT_COMPILER_DIRECTIVE = DEFAULT_COMPILER_DIRECTIVE;
+exports.REACT_RENDERER = REACT_RENDERER;
+exports.normalizeReactCompilerOptions = normalizeReactCompilerOptions;
+exports.react = react;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA2BO,IAAM,0BAAA,GAA6B;AAEnC,SAAS,8BACd,KAAA,EACgC;AAChC,EAAA,MAAM,OAAA,GAAU,KAAA,KAAU,IAAA,GAAO,EAAC,GAAI,KAAA;AACtC,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,OAAA;AAE7B,EAAA,IAAI,IAAA,KAAS,OAAA,IAAW,IAAA,KAAS,YAAA,EAAc;AAC7C,IAAA,MAAM,IAAI,SAAA,CAAU,CAAA,6BAAA,EAAgC,MAAA,CAAO,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,EACpE;AAEA,EAAA,IAAI,OAAA,CAAQ,SAAA,KAAc,MAAA,IAAa,IAAA,KAAS,YAAA,EAAc;AAC5D,IAAA,MAAM,IAAI,UAAU,yEAAyE,CAAA;AAAA,EAC/F;AAEA,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,EAAW,IAAA,EAAK,IAAK,0BAAA;AAC/C,EAAA,MAAM,aAAA,GAAgB,QAAQ,aAAA,IAAiB,UAAA;AAC/C,EAAA,IAAI,CAAE,CAAC,UAAA,EAAY,MAAA,EAAQ,OAAO,CAAA,CAAY,QAAA,CAAS,aAAa,CAAA,EAAG;AACrE,IAAA,MAAM,IAAI,SAAA,CAAU,CAAA,wCAAA,EAA2C,MAAA,CAAO,aAAa,CAAC,CAAA,CAAE,CAAA;AAAA,EACxF;AAEA,EAAA,OAAO,EAAE,IAAA,EAAM,SAAA,EAAW,aAAA,EAAc;AAC1C;AAEA,IAAM,cAAA,GAAyC,OAAO,MAAA,CAAO;AAAA,EAC3D,IAAA,EAAM,OAAA;AAAA,EACN,IAAA,EAAM,qBAAA;AAAA,EACN,MAAA,EAAQ,uBAAA;AAAA,EACR,MAAA,EAAQ,uBAAA;AAAA,EACR,eAAA,EAAiB,OAAA;AAAA,EACjB,MAAA,EAAQ,CAAC,OAAA,EAAS,WAAA,EAAa,qBAAqB,uBAAuB,CAAA;AAAA,EAC3E,YAAA,EAAc;AAAA,IACZ,OAAA;AAAA,IACA,WAAA;AAAA,IACA,kBAAA;AAAA,IACA,mBAAA;AAAA,IACA,uBAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,SAAA,EAAW,EAAE,IAAA,EAAM,IAAA,EAAM,KAAK,KAAA;AAAM;AAExC,CAAC;AAGM,SAAS,KAAA,CAAM,OAAA,GAAgC,EAAC,EAAiB;AACtE,EAAA,MAAM,QAAA,GAAW,QAAQ,YAAA,EAAc,QAAA;AACvC,EAAA,MAAM,kBAAA,GAAqB,QAAA,GAAW,6BAAA,CAA8B,QAAQ,CAAA,GAAI,KAAA;AAEhF,EAAA,OAAO;AAAA,IACL,GAAG,cAAA;AAAA,IACH,QAAQ,CAAC,GAAI,cAAA,CAAe,MAAA,IAAU,EAAG,CAAA;AAAA,IACzC,cAAc,CAAC,GAAI,cAAA,CAAe,YAAA,IAAgB,EAAG,CAAA;AAAA,IACrD,YAAA,EAAc;AAAA,MACZ,SAAA,EAAW,EAAE,GAAG,cAAA,CAAe,cAAc,SAAA;AAAU,KACzD;AAAA,IACA,OAAA,EAAS;AAAA,MACP,YAAA,EAAc,EAAE,QAAA,EAAU,kBAAA;AAAmB;AAC/C,GACF;AACF","file":"index.cjs","sourcesContent":["import type { FarmRenderer } from \"@farm.js/core/renderer\";\n\nexport type ReactCompilerMode = \"infer\" | \"annotation\";\nexport type UnsupportedCompilerBehavior = \"fallback\" | \"warn\" | \"error\";\n\nexport interface ReactCompilerOptions {\n  /** Compile every component that the safe subset can prove eligible. */\n  mode?: ReactCompilerMode;\n  /** Function or module directive used only by annotation mode. */\n  directive?: string;\n  /** What to do when a selected component is outside the safe subset. */\n  onUnsupported?: UnsupportedCompilerBehavior;\n}\n\nexport interface ReactRendererOptions {\n  experimental?: {\n    /** `true` enables automatic inference; an object customizes selection. */\n    compiler?: boolean | ReactCompilerOptions;\n  };\n}\n\nexport interface NormalizedReactCompilerOptions {\n  mode: ReactCompilerMode;\n  directive: string;\n  onUnsupported: UnsupportedCompilerBehavior;\n}\n\nexport const DEFAULT_COMPILER_DIRECTIVE = \"use compiler\";\n\nexport function normalizeReactCompilerOptions(\n  value: true | ReactCompilerOptions,\n): NormalizedReactCompilerOptions {\n  const options = value === true ? {} : value;\n  const mode = options.mode || \"infer\";\n\n  if (mode !== \"infer\" && mode !== \"annotation\") {\n    throw new TypeError(`Unknown React compiler mode: ${String(mode)}`);\n  }\n\n  if (options.directive !== undefined && mode !== \"annotation\") {\n    throw new TypeError(\"The React compiler directive can only be configured in annotation mode.\");\n  }\n\n  const directive = options.directive?.trim() || DEFAULT_COMPILER_DIRECTIVE;\n  const onUnsupported = options.onUnsupported || \"fallback\";\n  if (!([\"fallback\", \"warn\", \"error\"] as const).includes(onUnsupported)) {\n    throw new TypeError(`Unknown unsupported-component behavior: ${String(onUnsupported)}`);\n  }\n\n  return { mode, directive, onUnsupported };\n}\n\nconst REACT_RENDERER: Readonly<FarmRenderer> = Object.freeze({\n  name: \"react\",\n  vite: \"@farm.js/react/vite\",\n  server: \"@farm.js/react/server\",\n  client: \"@farm.js/react/client\",\n  jsxImportSource: \"react\",\n  dedupe: [\"react\", \"react-dom\", \"react/jsx-runtime\", \"react/jsx-dev-runtime\"],\n  optimizeDeps: [\n    \"react\",\n    \"react-dom\",\n    \"react-dom/client\",\n    \"react/jsx-runtime\",\n    \"react/jsx-dev-runtime\",\n    \"@farm.js/react/compiler-runtime\",\n  ],\n  capabilities: {\n    streaming: { node: true, web: false },\n  },\n});\n\n/** Select React and optionally enable Farm's experimental AOT compiler. */\nexport function react(options: ReactRendererOptions = {}): FarmRenderer {\n  const compiler = options.experimental?.compiler;\n  const normalizedCompiler = compiler ? normalizeReactCompilerOptions(compiler) : false;\n\n  return {\n    ...REACT_RENDERER,\n    dedupe: [...(REACT_RENDERER.dedupe || [])],\n    optimizeDeps: [...(REACT_RENDERER.optimizeDeps || [])],\n    capabilities: {\n      streaming: { ...REACT_RENDERER.capabilities?.streaming },\n    },\n    options: {\n      experimental: { compiler: normalizedCompiler },\n    },\n  };\n}\n\nexport { REACT_RENDERER };\nexport type { FarmRenderer } from \"@farm.js/core/renderer\";\n"]}

package/dist/index.d.mts

@@ -0,0 +1,31 @@
+import { FarmRenderer } from '@farm.js/core/renderer';
+export { FarmRenderer } from '@farm.js/core/renderer';
+
+type ReactCompilerMode = "infer" | "annotation";
+type UnsupportedCompilerBehavior = "fallback" | "warn" | "error";
+interface ReactCompilerOptions {
+    /** Compile every component that the safe subset can prove eligible. */
+    mode?: ReactCompilerMode;
+    /** Function or module directive used only by annotation mode. */
+    directive?: string;
+    /** What to do when a selected component is outside the safe subset. */
+    onUnsupported?: UnsupportedCompilerBehavior;
+}
+interface ReactRendererOptions {
+    experimental?: {
+        /** `true` enables automatic inference; an object customizes selection. */
+        compiler?: boolean | ReactCompilerOptions;
+    };
+}
+interface NormalizedReactCompilerOptions {
+    mode: ReactCompilerMode;
+    directive: string;
+    onUnsupported: UnsupportedCompilerBehavior;
+}
+declare const DEFAULT_COMPILER_DIRECTIVE = "use compiler";
+declare function normalizeReactCompilerOptions(value: true | ReactCompilerOptions): NormalizedReactCompilerOptions;
+declare const REACT_RENDERER: Readonly<FarmRenderer>;
+/** Select React and optionally enable Farm's experimental AOT compiler. */
+declare function react(options?: ReactRendererOptions): FarmRenderer;
+
+export { DEFAULT_COMPILER_DIRECTIVE, type NormalizedReactCompilerOptions, REACT_RENDERER, type ReactCompilerMode, type ReactCompilerOptions, type ReactRendererOptions, type UnsupportedCompilerBehavior, normalizeReactCompilerOptions, react };