@farm.js/react 0.1.0-beta.0 → 0.1.0-beta.10

package/dist/index.cjs

@@ -2,6 +2,18 @@
 
 // src/index.ts
 var DEFAULT_COMPILER_DIRECTIVE = "use compiler";
+var DEFAULT_COMPILER_REPORT_FILE = ".farm/react-compiler.json";
+function normalizeCompilerReportFile(value) {
+  if (value === void 0) return DEFAULT_COMPILER_REPORT_FILE;
+  if (typeof value !== "string" || !value.trim()) {
+    throw new TypeError("The React compiler report file must be a non-empty relative path.");
+  }
+  const normalized = value.trim().replace(/\\/g, "/");
+  if (normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized) || normalized.split("/").includes("..")) {
+    throw new TypeError("The React compiler report file must stay inside the project root.");
+  }
+  return normalized;
+}
 function normalizeReactCompilerOptions(value) {
   const options = value === true ? {} : value;
   const mode = options.mode || "infer";
@@ -16,7 +28,21 @@ function normalizeReactCompilerOptions(value) {
   if (!["fallback", "warn", "error"].includes(onUnsupported)) {
     throw new TypeError(`Unknown unsupported-component behavior: ${String(onUnsupported)}`);
   }
-  return { mode, directive, onUnsupported };
+  const reactivity = options.reactivity || "hybrid";
+  if (reactivity !== "static" && reactivity !== "hybrid") {
+    throw new TypeError(`Unknown React compiler reactivity mode: ${String(reactivity)}`);
+  }
+  if (options.report !== void 0 && typeof options.report !== "boolean") {
+    throw new TypeError("The React compiler report option must be a boolean.");
+  }
+  if (options.report === false && options.reportFile !== void 0) {
+    throw new TypeError(
+      "A React compiler report file cannot be configured when reporting is false."
+    );
+  }
+  const reportFile = normalizeCompilerReportFile(options.reportFile);
+  const report = options.report === true || options.reportFile !== void 0;
+  return { mode, directive, onUnsupported, reactivity, report, reportFile };
 }
 var REACT_RENDERER = Object.freeze({
   name: "react",
@@ -54,6 +80,7 @@ function react(options = {}) {
 }
 
 exports.DEFAULT_COMPILER_DIRECTIVE = DEFAULT_COMPILER_DIRECTIVE;
+exports.DEFAULT_COMPILER_REPORT_FILE = DEFAULT_COMPILER_REPORT_FILE;
 exports.REACT_RENDERER = REACT_RENDERER;
 exports.normalizeReactCompilerOptions = normalizeReactCompilerOptions;
 exports.react = react;

package/dist/index.cjs.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { FarmRenderer } from \"@farm.js/core/renderer\";\n\nexport type ReactCompilerMode = \"infer\" | \"annotation\";\nexport type ReactCompilerReactivity = \"static\" | \"hybrid\";\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   * How compiled bindings subscribe to state. `hybrid` keeps compiler-proven\n   * dependencies and narrows short-circuited reads at runtime.\n   */\n  reactivity?: ReactCompilerReactivity;\n  /** Write a machine-readable compiler coverage report after a production build. */\n  report?: boolean;\n  /** Project-relative report location. Providing it also enables reporting. */\n  reportFile?: string;\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  reactivity: ReactCompilerReactivity;\n  report: boolean;\n  reportFile: string;\n}\n\nexport const DEFAULT_COMPILER_DIRECTIVE = \"use compiler\";\nexport const DEFAULT_COMPILER_REPORT_FILE = \".farm/react-compiler.json\";\n\nfunction normalizeCompilerReportFile(value: unknown): string {\n  if (value === undefined) return DEFAULT_COMPILER_REPORT_FILE;\n  if (typeof value !== \"string\" || !value.trim()) {\n    throw new TypeError(\"The React compiler report file must be a non-empty relative path.\");\n  }\n  const normalized = value.trim().replace(/\\\\/g, \"/\");\n  if (\n    normalized.startsWith(\"/\") ||\n    /^[A-Za-z]:\\//.test(normalized) ||\n    normalized.split(\"/\").includes(\"..\")\n  ) {\n    throw new TypeError(\"The React compiler report file must stay inside the project root.\");\n  }\n  return normalized;\n}\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  const reactivity = options.reactivity || \"hybrid\";\n  if (reactivity !== \"static\" && reactivity !== \"hybrid\") {\n    throw new TypeError(`Unknown React compiler reactivity mode: ${String(reactivity)}`);\n  }\n\n  if (options.report !== undefined && typeof options.report !== \"boolean\") {\n    throw new TypeError(\"The React compiler report option must be a boolean.\");\n  }\n  if (options.report === false && options.reportFile !== undefined) {\n    throw new TypeError(\n      \"A React compiler report file cannot be configured when reporting is false.\",\n    );\n  }\n  const reportFile = normalizeCompilerReportFile(options.reportFile);\n  const report = options.report === true || options.reportFile !== undefined;\n\n  return { mode, directive, onUnsupported, reactivity, report, reportFile };\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

@@ -2,6 +2,7 @@ import { FarmRenderer } from '@farm.js/core/renderer';
 export { FarmRenderer } from '@farm.js/core/renderer';
 
 type ReactCompilerMode = "infer" | "annotation";
+type ReactCompilerReactivity = "static" | "hybrid";
 type UnsupportedCompilerBehavior = "fallback" | "warn" | "error";
 interface ReactCompilerOptions {
     /** Compile every component that the safe subset can prove eligible. */
@@ -10,6 +11,15 @@ interface ReactCompilerOptions {
     directive?: string;
     /** What to do when a selected component is outside the safe subset. */
     onUnsupported?: UnsupportedCompilerBehavior;
+    /**
+     * How compiled bindings subscribe to state. `hybrid` keeps compiler-proven
+     * dependencies and narrows short-circuited reads at runtime.
+     */
+    reactivity?: ReactCompilerReactivity;
+    /** Write a machine-readable compiler coverage report after a production build. */
+    report?: boolean;
+    /** Project-relative report location. Providing it also enables reporting. */
+    reportFile?: string;
 }
 interface ReactRendererOptions {
     experimental?: {
@@ -21,11 +31,15 @@ interface NormalizedReactCompilerOptions {
     mode: ReactCompilerMode;
     directive: string;
     onUnsupported: UnsupportedCompilerBehavior;
+    reactivity: ReactCompilerReactivity;
+    report: boolean;
+    reportFile: string;
 }
 declare const DEFAULT_COMPILER_DIRECTIVE = "use compiler";
+declare const DEFAULT_COMPILER_REPORT_FILE = ".farm/react-compiler.json";
 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 };
+export { DEFAULT_COMPILER_DIRECTIVE, DEFAULT_COMPILER_REPORT_FILE, type NormalizedReactCompilerOptions, REACT_RENDERER, type ReactCompilerMode, type ReactCompilerOptions, type ReactCompilerReactivity, type ReactRendererOptions, type UnsupportedCompilerBehavior, normalizeReactCompilerOptions, react };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { FarmRenderer } from '@farm.js/core/renderer';
 export { FarmRenderer } from '@farm.js/core/renderer';
 
 type ReactCompilerMode = "infer" | "annotation";
+type ReactCompilerReactivity = "static" | "hybrid";
 type UnsupportedCompilerBehavior = "fallback" | "warn" | "error";
 interface ReactCompilerOptions {
     /** Compile every component that the safe subset can prove eligible. */
@@ -10,6 +11,15 @@ interface ReactCompilerOptions {
     directive?: string;
     /** What to do when a selected component is outside the safe subset. */
     onUnsupported?: UnsupportedCompilerBehavior;
+    /**
+     * How compiled bindings subscribe to state. `hybrid` keeps compiler-proven
+     * dependencies and narrows short-circuited reads at runtime.
+     */
+    reactivity?: ReactCompilerReactivity;
+    /** Write a machine-readable compiler coverage report after a production build. */
+    report?: boolean;
+    /** Project-relative report location. Providing it also enables reporting. */
+    reportFile?: string;
 }
 interface ReactRendererOptions {
     experimental?: {
@@ -21,11 +31,15 @@ interface NormalizedReactCompilerOptions {
     mode: ReactCompilerMode;
     directive: string;
     onUnsupported: UnsupportedCompilerBehavior;
+    reactivity: ReactCompilerReactivity;
+    report: boolean;
+    reportFile: string;
 }
 declare const DEFAULT_COMPILER_DIRECTIVE = "use compiler";
+declare const DEFAULT_COMPILER_REPORT_FILE = ".farm/react-compiler.json";
 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 };
+export { DEFAULT_COMPILER_DIRECTIVE, DEFAULT_COMPILER_REPORT_FILE, type NormalizedReactCompilerOptions, REACT_RENDERER, type ReactCompilerMode, type ReactCompilerOptions, type ReactCompilerReactivity, type ReactRendererOptions, type UnsupportedCompilerBehavior, normalizeReactCompilerOptions, react };

package/dist/index.mjs

@@ -1,5 +1,17 @@
 // src/index.ts
 var DEFAULT_COMPILER_DIRECTIVE = "use compiler";
+var DEFAULT_COMPILER_REPORT_FILE = ".farm/react-compiler.json";
+function normalizeCompilerReportFile(value) {
+  if (value === void 0) return DEFAULT_COMPILER_REPORT_FILE;
+  if (typeof value !== "string" || !value.trim()) {
+    throw new TypeError("The React compiler report file must be a non-empty relative path.");
+  }
+  const normalized = value.trim().replace(/\\/g, "/");
+  if (normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized) || normalized.split("/").includes("..")) {
+    throw new TypeError("The React compiler report file must stay inside the project root.");
+  }
+  return normalized;
+}
 function normalizeReactCompilerOptions(value) {
   const options = value === true ? {} : value;
   const mode = options.mode || "infer";
@@ -14,7 +26,21 @@ function normalizeReactCompilerOptions(value) {
   if (!["fallback", "warn", "error"].includes(onUnsupported)) {
     throw new TypeError(`Unknown unsupported-component behavior: ${String(onUnsupported)}`);
   }
-  return { mode, directive, onUnsupported };
+  const reactivity = options.reactivity || "hybrid";
+  if (reactivity !== "static" && reactivity !== "hybrid") {
+    throw new TypeError(`Unknown React compiler reactivity mode: ${String(reactivity)}`);
+  }
+  if (options.report !== void 0 && typeof options.report !== "boolean") {
+    throw new TypeError("The React compiler report option must be a boolean.");
+  }
+  if (options.report === false && options.reportFile !== void 0) {
+    throw new TypeError(
+      "A React compiler report file cannot be configured when reporting is false."
+    );
+  }
+  const reportFile = normalizeCompilerReportFile(options.reportFile);
+  const report = options.report === true || options.reportFile !== void 0;
+  return { mode, directive, onUnsupported, reactivity, report, reportFile };
 }
 var REACT_RENDERER = Object.freeze({
   name: "react",
@@ -51,6 +77,6 @@ function react(options = {}) {
   };
 }
 
-export { DEFAULT_COMPILER_DIRECTIVE, REACT_RENDERER, normalizeReactCompilerOptions, react };
+export { DEFAULT_COMPILER_DIRECTIVE, DEFAULT_COMPILER_REPORT_FILE, REACT_RENDERER, normalizeReactCompilerOptions, react };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +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.mjs","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"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { FarmRenderer } from \"@farm.js/core/renderer\";\n\nexport type ReactCompilerMode = \"infer\" | \"annotation\";\nexport type ReactCompilerReactivity = \"static\" | \"hybrid\";\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   * How compiled bindings subscribe to state. `hybrid` keeps compiler-proven\n   * dependencies and narrows short-circuited reads at runtime.\n   */\n  reactivity?: ReactCompilerReactivity;\n  /** Write a machine-readable compiler coverage report after a production build. */\n  report?: boolean;\n  /** Project-relative report location. Providing it also enables reporting. */\n  reportFile?: string;\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  reactivity: ReactCompilerReactivity;\n  report: boolean;\n  reportFile: string;\n}\n\nexport const DEFAULT_COMPILER_DIRECTIVE = \"use compiler\";\nexport const DEFAULT_COMPILER_REPORT_FILE = \".farm/react-compiler.json\";\n\nfunction normalizeCompilerReportFile(value: unknown): string {\n  if (value === undefined) return DEFAULT_COMPILER_REPORT_FILE;\n  if (typeof value !== \"string\" || !value.trim()) {\n    throw new TypeError(\"The React compiler report file must be a non-empty relative path.\");\n  }\n  const normalized = value.trim().replace(/\\\\/g, \"/\");\n  if (\n    normalized.startsWith(\"/\") ||\n    /^[A-Za-z]:\\//.test(normalized) ||\n    normalized.split(\"/\").includes(\"..\")\n  ) {\n    throw new TypeError(\"The React compiler report file must stay inside the project root.\");\n  }\n  return normalized;\n}\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  const reactivity = options.reactivity || \"hybrid\";\n  if (reactivity !== \"static\" && reactivity !== \"hybrid\") {\n    throw new TypeError(`Unknown React compiler reactivity mode: ${String(reactivity)}`);\n  }\n\n  if (options.report !== undefined && typeof options.report !== \"boolean\") {\n    throw new TypeError(\"The React compiler report option must be a boolean.\");\n  }\n  if (options.report === false && options.reportFile !== undefined) {\n    throw new TypeError(\n      \"A React compiler report file cannot be configured when reporting is false.\",\n    );\n  }\n  const reportFile = normalizeCompilerReportFile(options.reportFile);\n  const report = options.report === true || options.reportFile !== undefined;\n\n  return { mode, directive, onUnsupported, reactivity, report, reportFile };\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/list.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+var React = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+// src/list.tsx
+
+// src/iterable.ts
+var oneShotSnapshots = /* @__PURE__ */ new WeakMap();
+function materializeIterable(source) {
+  if (source == null) return [];
+  const iterator = source[Symbol.iterator]();
+  const oneShot = iterator === source && (typeof source === "object" || typeof source === "function");
+  if (oneShot) {
+    const cached = oneShotSnapshots.get(source);
+    if (cached) return cached;
+  }
+  const items = Array.from({ [Symbol.iterator]: () => iterator });
+  if (oneShot) oneShotSnapshots.set(source, items);
+  return items;
+}
+
+// src/list.tsx
+function List({ each, by, children }) {
+  const rows = materializeIterable(each);
+  return React__default.default.createElement(
+    React__default.default.Fragment,
+    null,
+    ...rows.map((item, index) => {
+      const row = children(item, index);
+      if (!React__default.default.isValidElement(row)) {
+        throw new TypeError("@farm.js/react List children must return one React element.");
+      }
+      return React__default.default.cloneElement(row, { key: by(item, index) });
+    })
+  );
+}
+
+exports.List = List;
+//# sourceMappingURL=list.cjs.map
+//# sourceMappingURL=list.cjs.map

package/dist/list.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iterable.ts","../src/list.tsx"],"names":["React"],"mappings":";;;;;;;;;;;AAAA,IAAM,gBAAA,uBAAuB,OAAA,EAAoC;AAG1D,SAAS,oBAA0B,MAAA,EAAmD;AAC3F,EAAA,IAAI,MAAA,IAAU,IAAA,EAAM,OAAO,EAAC;AAE5B,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAA,EAAE;AACzC,EAAA,MAAM,UACJ,QAAA,KAAc,MAAA,KACb,OAAO,MAAA,KAAW,QAAA,IAAY,OAAO,MAAA,KAAW,UAAA,CAAA;AACnD,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,GAAA,CAAI,MAAgB,CAAA;AACpD,IAAA,IAAI,QAAQ,OAAO,MAAA;AAAA,EACrB;AAEA,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,EAAE,CAAC,OAAO,QAAQ,GAAG,MAAM,QAAA,EAAU,CAAA;AAC9D,EAAA,IAAI,OAAA,EAAS,gBAAA,CAAiB,GAAA,CAAI,MAAA,EAAkB,KAAK,CAAA;AACzD,EAAA,OAAO,KAAA;AACT;;;ACCO,SAAS,IAAA,CAAW,EAAE,IAAA,EAAM,EAAA,EAAI,UAAS,EAAwC;AACtF,EAAA,MAAM,IAAA,GAAO,oBAAoB,IAAI,CAAA;AACrC,EAAA,OAAOA,sBAAA,CAAM,aAAA;AAAA,IACXA,sBAAA,CAAM,QAAA;AAAA,IACN,IAAA;AAAA,IACA,GAAG,IAAA,CAAK,GAAA,CAAI,CAAC,MAAM,KAAA,KAAU;AAC3B,MAAA,MAAM,GAAA,GAAM,QAAA,CAAS,IAAA,EAAM,KAAK,CAAA;AAChC,MAAA,IAAI,CAACA,sBAAA,CAAM,cAAA,CAAe,GAAG,CAAA,EAAG;AAC9B,QAAA,MAAM,IAAI,UAAU,6DAA6D,CAAA;AAAA,MACnF;AACA,MAAA,OAAOA,sBAAA,CAAM,aAAa,GAAA,EAAK,EAAE,KAAK,EAAA,CAAG,IAAA,EAAM,KAAK,CAAA,EAAuB,CAAA;AAAA,IAC7E,CAAC;AAAA,GACH;AACF","file":"list.cjs","sourcesContent":["const oneShotSnapshots = new WeakMap<object, readonly unknown[]>();\n\n/** Materialize an iterable without consuming a one-shot iterator more than once. */\nexport function materializeIterable<Item>(source: Iterable<Item> | null | undefined): Item[] {\n  if (source == null) return [];\n\n  const iterator = source[Symbol.iterator]();\n  const oneShot =\n    iterator === (source as unknown) &&\n    (typeof source === \"object\" || typeof source === \"function\");\n  if (oneShot) {\n    const cached = oneShotSnapshots.get(source as object);\n    if (cached) return cached as Item[];\n  }\n\n  const items = Array.from({ [Symbol.iterator]: () => iterator });\n  if (oneShot) oneShotSnapshots.set(source as object, items);\n  return items;\n}\n","import React from \"react\";\nimport { materializeIterable } from \"./iterable\";\n\nexport interface ListProps<Item> {\n  /** Items to render. Nullish collections are treated as empty. */\n  each: Iterable<Item> | null | undefined;\n  /** Returns the stable React key for one item. */\n  by(item: Item, index: number): React.Key;\n  /** Renders one keyed row. */\n  children(item: Item, index: number): React.ReactElement;\n}\n\n/**\n * An explicit keyed collection boundary for advanced list expressions.\n *\n * It behaves like ordinary React when the compiler is disabled. With the\n * experimental compiler enabled, eligible usages are isolated so local list\n * updates do not execute the surrounding user component.\n */\nexport function List<Item>({ each, by, children }: ListProps<Item>): React.ReactElement {\n  const rows = materializeIterable(each);\n  return React.createElement(\n    React.Fragment,\n    null,\n    ...rows.map((item, index) => {\n      const row = children(item, index);\n      if (!React.isValidElement(row)) {\n        throw new TypeError(\"@farm.js/react List children must return one React element.\");\n      }\n      return React.cloneElement(row, { key: by(item, index) } as React.Attributes);\n    }),\n  );\n}\n"]}

package/dist/list.d.mts

@@ -0,0 +1,20 @@
+import React from 'react';
+
+interface ListProps<Item> {
+    /** Items to render. Nullish collections are treated as empty. */
+    each: Iterable<Item> | null | undefined;
+    /** Returns the stable React key for one item. */
+    by(item: Item, index: number): React.Key;
+    /** Renders one keyed row. */
+    children(item: Item, index: number): React.ReactElement;
+}
+/**
+ * An explicit keyed collection boundary for advanced list expressions.
+ *
+ * It behaves like ordinary React when the compiler is disabled. With the
+ * experimental compiler enabled, eligible usages are isolated so local list
+ * updates do not execute the surrounding user component.
+ */
+declare function List<Item>({ each, by, children }: ListProps<Item>): React.ReactElement;
+
+export { List, type ListProps };

package/dist/list.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+
+interface ListProps<Item> {
+    /** Items to render. Nullish collections are treated as empty. */
+    each: Iterable<Item> | null | undefined;
+    /** Returns the stable React key for one item. */
+    by(item: Item, index: number): React.Key;
+    /** Renders one keyed row. */
+    children(item: Item, index: number): React.ReactElement;
+}
+/**
+ * An explicit keyed collection boundary for advanced list expressions.
+ *
+ * It behaves like ordinary React when the compiler is disabled. With the
+ * experimental compiler enabled, eligible usages are isolated so local list
+ * updates do not execute the surrounding user component.
+ */
+declare function List<Item>({ each, by, children }: ListProps<Item>): React.ReactElement;
+
+export { List, type ListProps };

package/dist/list.mjs

@@ -0,0 +1,38 @@
+import React from 'react';
+
+// src/list.tsx
+
+// src/iterable.ts
+var oneShotSnapshots = /* @__PURE__ */ new WeakMap();
+function materializeIterable(source) {
+  if (source == null) return [];
+  const iterator = source[Symbol.iterator]();
+  const oneShot = iterator === source && (typeof source === "object" || typeof source === "function");
+  if (oneShot) {
+    const cached = oneShotSnapshots.get(source);
+    if (cached) return cached;
+  }
+  const items = Array.from({ [Symbol.iterator]: () => iterator });
+  if (oneShot) oneShotSnapshots.set(source, items);
+  return items;
+}
+
+// src/list.tsx
+function List({ each, by, children }) {
+  const rows = materializeIterable(each);
+  return React.createElement(
+    React.Fragment,
+    null,
+    ...rows.map((item, index) => {
+      const row = children(item, index);
+      if (!React.isValidElement(row)) {
+        throw new TypeError("@farm.js/react List children must return one React element.");
+      }
+      return React.cloneElement(row, { key: by(item, index) });
+    })
+  );
+}
+
+export { List };
+//# sourceMappingURL=list.mjs.map
+//# sourceMappingURL=list.mjs.map

package/dist/list.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iterable.ts","../src/list.tsx"],"names":[],"mappings":";;;;;AAAA,IAAM,gBAAA,uBAAuB,OAAA,EAAoC;AAG1D,SAAS,oBAA0B,MAAA,EAAmD;AAC3F,EAAA,IAAI,MAAA,IAAU,IAAA,EAAM,OAAO,EAAC;AAE5B,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAA,EAAE;AACzC,EAAA,MAAM,UACJ,QAAA,KAAc,MAAA,KACb,OAAO,MAAA,KAAW,QAAA,IAAY,OAAO,MAAA,KAAW,UAAA,CAAA;AACnD,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,GAAA,CAAI,MAAgB,CAAA;AACpD,IAAA,IAAI,QAAQ,OAAO,MAAA;AAAA,EACrB;AAEA,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,EAAE,CAAC,OAAO,QAAQ,GAAG,MAAM,QAAA,EAAU,CAAA;AAC9D,EAAA,IAAI,OAAA,EAAS,gBAAA,CAAiB,GAAA,CAAI,MAAA,EAAkB,KAAK,CAAA;AACzD,EAAA,OAAO,KAAA;AACT;;;ACCO,SAAS,IAAA,CAAW,EAAE,IAAA,EAAM,EAAA,EAAI,UAAS,EAAwC;AACtF,EAAA,MAAM,IAAA,GAAO,oBAAoB,IAAI,CAAA;AACrC,EAAA,OAAO,KAAA,CAAM,aAAA;AAAA,IACX,KAAA,CAAM,QAAA;AAAA,IACN,IAAA;AAAA,IACA,GAAG,IAAA,CAAK,GAAA,CAAI,CAAC,MAAM,KAAA,KAAU;AAC3B,MAAA,MAAM,GAAA,GAAM,QAAA,CAAS,IAAA,EAAM,KAAK,CAAA;AAChC,MAAA,IAAI,CAAC,KAAA,CAAM,cAAA,CAAe,GAAG,CAAA,EAAG;AAC9B,QAAA,MAAM,IAAI,UAAU,6DAA6D,CAAA;AAAA,MACnF;AACA,MAAA,OAAO,KAAA,CAAM,aAAa,GAAA,EAAK,EAAE,KAAK,EAAA,CAAG,IAAA,EAAM,KAAK,CAAA,EAAuB,CAAA;AAAA,IAC7E,CAAC;AAAA,GACH;AACF","file":"list.mjs","sourcesContent":["const oneShotSnapshots = new WeakMap<object, readonly unknown[]>();\n\n/** Materialize an iterable without consuming a one-shot iterator more than once. */\nexport function materializeIterable<Item>(source: Iterable<Item> | null | undefined): Item[] {\n  if (source == null) return [];\n\n  const iterator = source[Symbol.iterator]();\n  const oneShot =\n    iterator === (source as unknown) &&\n    (typeof source === \"object\" || typeof source === \"function\");\n  if (oneShot) {\n    const cached = oneShotSnapshots.get(source as object);\n    if (cached) return cached as Item[];\n  }\n\n  const items = Array.from({ [Symbol.iterator]: () => iterator });\n  if (oneShot) oneShotSnapshots.set(source as object, items);\n  return items;\n}\n","import React from \"react\";\nimport { materializeIterable } from \"./iterable\";\n\nexport interface ListProps<Item> {\n  /** Items to render. Nullish collections are treated as empty. */\n  each: Iterable<Item> | null | undefined;\n  /** Returns the stable React key for one item. */\n  by(item: Item, index: number): React.Key;\n  /** Renders one keyed row. */\n  children(item: Item, index: number): React.ReactElement;\n}\n\n/**\n * An explicit keyed collection boundary for advanced list expressions.\n *\n * It behaves like ordinary React when the compiler is disabled. With the\n * experimental compiler enabled, eligible usages are isolated so local list\n * updates do not execute the surrounding user component.\n */\nexport function List<Item>({ each, by, children }: ListProps<Item>): React.ReactElement {\n  const rows = materializeIterable(each);\n  return React.createElement(\n    React.Fragment,\n    null,\n    ...rows.map((item, index) => {\n      const row = children(item, index);\n      if (!React.isValidElement(row)) {\n        throw new TypeError(\"@farm.js/react List children must return one React element.\");\n      }\n      return React.cloneElement(row, { key: by(item, index) } as React.Attributes);\n    }),\n  );\n}\n"]}