@farm.js/react 0.1.0-beta.4 → 0.1.0-beta.5

package/dist/compiler-runtime.d.mts

@@ -244,13 +244,40 @@ interface CompiledComponentDefinition<Props> {
     render(props: Props, state: readonly CompilerCell[], blocks: CompilerBlockRuntime): React.ReactElement;
     bindings: readonly CompilerBinding<Props>[];
 }
+type CompilerBlockRefresh = (afterCommit?: () => void, dirtyState?: ReadonlySet<number>) => void;
+interface CompilerRuntimeFeatureOwner {
+    setRoot(id: number, root: Element | null): void;
+    subscribe(id: number, refresh: CompilerBlockRefresh): () => void;
+}
+interface CompilerRuntimeFeature {
+    /** Stable identity used by Fast Refresh compatibility checks. */
+    name: string;
+    create(owner: CompilerRuntimeFeatureOwner): Partial<CompilerBlockRuntime>;
+}
+declare const conditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const hostConditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const conditionalRangesRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedListRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRangesRuntimeFeature: CompilerRuntimeFeature;
+declare const mixedRangesRuntimeFeature: CompilerRuntimeFeature;
+declare const componentRuntimeFeature: CompilerRuntimeFeature;
 /**
- * Runtime target emitted by the AOT transform.
+ * Tree-shakable runtime target emitted by the AOT transform.
  *
  * React owns initial placement, SSR, hydration, props, and event semantics.
- * Compiler cells own local updates and precomputed DOM paths. A proven host-only
- * keyed container may transfer its child-row ownership after mount.
+ * Compiler cells own local updates and precomputed DOM paths. Structural
+ * helpers are installed only when the compiler emitted that boundary kind.
+ */
+declare function createCompiledComponentWithFeatures<Props>(definition: CompiledComponentDefinition<Props>, runtimeFeatures: readonly CompilerRuntimeFeature[]): React.ComponentType<Props>;
+/**
+ * Compatibility entry for hand-authored runtime definitions.
+ * Compiler output uses createCompiledComponentWithFeatures so unused structural
+ * runtimes can be removed from production bundles.
  */
 declare function createCompiledComponent<Props>(definition: CompiledComponentDefinition<Props>): React.ComponentType<Props>;
 
-export { type CompiledComponentDefinition, type CompilerAttributeBinding, type CompilerBinding, type CompilerBlockRuntime, type CompilerCell, type CompilerComponentBlockProps, type CompilerConditionalBlockBinding, type CompilerConditionalBlockProps, type CompilerConditionalRange, type CompilerConditionalRangesBlockProps, type CompilerHostBlock, type CompilerHostConditionalBinding, type CompilerHostConditionalBlockProps, type CompilerHostConditionalBranch, type CompilerHostConditionalRanges, type CompilerHostElement, type CompilerHostKeyedRanges, type CompilerHostMixedRanges, type CompilerKeyedListBlockProps, type CompilerKeyedRange, type CompilerKeyedRangesBlockProps, type CompilerKeyedRowBinding, type CompilerKeyedRowConditional, type CompilerKeyedRowConditionalBranch, type CompilerKeyedRowElement, type CompilerKeyedRowEvent, type CompilerKeyedRowsBlockProps, type CompilerMixedRange, type CompilerMixedRangesBlockProps, type CompilerRuntimeReactivity, type CompilerStateUpdater, type CompilerStaticRangeBinding, type CompilerStyleBinding, type CompilerTextBinding, createCompiledComponent };
+export { type CompiledComponentDefinition, type CompilerAttributeBinding, type CompilerBinding, type CompilerBlockRuntime, type CompilerCell, type CompilerComponentBlockProps, type CompilerConditionalBlockBinding, type CompilerConditionalBlockProps, type CompilerConditionalRange, type CompilerConditionalRangesBlockProps, type CompilerHostBlock, type CompilerHostConditionalBinding, type CompilerHostConditionalBlockProps, type CompilerHostConditionalBranch, type CompilerHostConditionalRanges, type CompilerHostElement, type CompilerHostKeyedRanges, type CompilerHostMixedRanges, type CompilerKeyedListBlockProps, type CompilerKeyedRange, type CompilerKeyedRangesBlockProps, type CompilerKeyedRowBinding, type CompilerKeyedRowConditional, type CompilerKeyedRowConditionalBranch, type CompilerKeyedRowElement, type CompilerKeyedRowEvent, type CompilerKeyedRowsBlockProps, type CompilerMixedRange, type CompilerMixedRangesBlockProps, type CompilerRuntimeFeature, type CompilerRuntimeFeatureOwner, type CompilerRuntimeReactivity, type CompilerStateUpdater, type CompilerStaticRangeBinding, type CompilerStyleBinding, type CompilerTextBinding, componentRuntimeFeature, conditionalRangesRuntimeFeature, conditionalRuntimeFeature, createCompiledComponent, createCompiledComponentWithFeatures, hostConditionalRuntimeFeature, keyedListRuntimeFeature, keyedRangesRuntimeFeature, keyedRowsCompleteRuntimeFeature, keyedRowsConditionalRuntimeFeature, keyedRowsHostRuntimeFeature, keyedRowsRuntimeFeature, mixedRangesRuntimeFeature };

package/dist/compiler-runtime.d.ts

@@ -244,13 +244,40 @@ interface CompiledComponentDefinition<Props> {
     render(props: Props, state: readonly CompilerCell[], blocks: CompilerBlockRuntime): React.ReactElement;
     bindings: readonly CompilerBinding<Props>[];
 }
+type CompilerBlockRefresh = (afterCommit?: () => void, dirtyState?: ReadonlySet<number>) => void;
+interface CompilerRuntimeFeatureOwner {
+    setRoot(id: number, root: Element | null): void;
+    subscribe(id: number, refresh: CompilerBlockRefresh): () => void;
+}
+interface CompilerRuntimeFeature {
+    /** Stable identity used by Fast Refresh compatibility checks. */
+    name: string;
+    create(owner: CompilerRuntimeFeatureOwner): Partial<CompilerBlockRuntime>;
+}
+declare const conditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const hostConditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const conditionalRangesRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedListRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRangesRuntimeFeature: CompilerRuntimeFeature;
+declare const mixedRangesRuntimeFeature: CompilerRuntimeFeature;
+declare const componentRuntimeFeature: CompilerRuntimeFeature;
 /**
- * Runtime target emitted by the AOT transform.
+ * Tree-shakable runtime target emitted by the AOT transform.
  *
  * React owns initial placement, SSR, hydration, props, and event semantics.
- * Compiler cells own local updates and precomputed DOM paths. A proven host-only
- * keyed container may transfer its child-row ownership after mount.
+ * Compiler cells own local updates and precomputed DOM paths. Structural
+ * helpers are installed only when the compiler emitted that boundary kind.
+ */
+declare function createCompiledComponentWithFeatures<Props>(definition: CompiledComponentDefinition<Props>, runtimeFeatures: readonly CompilerRuntimeFeature[]): React.ComponentType<Props>;
+/**
+ * Compatibility entry for hand-authored runtime definitions.
+ * Compiler output uses createCompiledComponentWithFeatures so unused structural
+ * runtimes can be removed from production bundles.
  */
 declare function createCompiledComponent<Props>(definition: CompiledComponentDefinition<Props>): React.ComponentType<Props>;
 
-export { type CompiledComponentDefinition, type CompilerAttributeBinding, type CompilerBinding, type CompilerBlockRuntime, type CompilerCell, type CompilerComponentBlockProps, type CompilerConditionalBlockBinding, type CompilerConditionalBlockProps, type CompilerConditionalRange, type CompilerConditionalRangesBlockProps, type CompilerHostBlock, type CompilerHostConditionalBinding, type CompilerHostConditionalBlockProps, type CompilerHostConditionalBranch, type CompilerHostConditionalRanges, type CompilerHostElement, type CompilerHostKeyedRanges, type CompilerHostMixedRanges, type CompilerKeyedListBlockProps, type CompilerKeyedRange, type CompilerKeyedRangesBlockProps, type CompilerKeyedRowBinding, type CompilerKeyedRowConditional, type CompilerKeyedRowConditionalBranch, type CompilerKeyedRowElement, type CompilerKeyedRowEvent, type CompilerKeyedRowsBlockProps, type CompilerMixedRange, type CompilerMixedRangesBlockProps, type CompilerRuntimeReactivity, type CompilerStateUpdater, type CompilerStaticRangeBinding, type CompilerStyleBinding, type CompilerTextBinding, createCompiledComponent };
+export { type CompiledComponentDefinition, type CompilerAttributeBinding, type CompilerBinding, type CompilerBlockRuntime, type CompilerCell, type CompilerComponentBlockProps, type CompilerConditionalBlockBinding, type CompilerConditionalBlockProps, type CompilerConditionalRange, type CompilerConditionalRangesBlockProps, type CompilerHostBlock, type CompilerHostConditionalBinding, type CompilerHostConditionalBlockProps, type CompilerHostConditionalBranch, type CompilerHostConditionalRanges, type CompilerHostElement, type CompilerHostKeyedRanges, type CompilerHostMixedRanges, type CompilerKeyedListBlockProps, type CompilerKeyedRange, type CompilerKeyedRangesBlockProps, type CompilerKeyedRowBinding, type CompilerKeyedRowConditional, type CompilerKeyedRowConditionalBranch, type CompilerKeyedRowElement, type CompilerKeyedRowEvent, type CompilerKeyedRowsBlockProps, type CompilerMixedRange, type CompilerMixedRangesBlockProps, type CompilerRuntimeFeature, type CompilerRuntimeFeatureOwner, type CompilerRuntimeReactivity, type CompilerStateUpdater, type CompilerStaticRangeBinding, type CompilerStyleBinding, type CompilerTextBinding, componentRuntimeFeature, conditionalRangesRuntimeFeature, conditionalRuntimeFeature, createCompiledComponent, createCompiledComponentWithFeatures, hostConditionalRuntimeFeature, keyedListRuntimeFeature, keyedRangesRuntimeFeature, keyedRowsCompleteRuntimeFeature, keyedRowsConditionalRuntimeFeature, keyedRowsHostRuntimeFeature, keyedRowsRuntimeFeature, mixedRangesRuntimeFeature };

package/dist/compiler-runtime.mjs

@@ -1877,11 +1877,7 @@ function longestIncreasingSubsequencePositions(sequence) {
   }
   return positions;
 }
-function createKeyedRowsBlockComponent(owner) {
-  const rowHostScopeOwner = {
-    subscribe: () => () => {
-    }
-  };
+function createKeyedRowConditionalRuntime() {
   class FarmKeyedRowConditional extends React.Component {
     constructor() {
       super(...arguments);
@@ -1923,6 +1919,22 @@ function createKeyedRowsBlockComponent(owner) {
     }
   }
   FarmKeyedRowConditional.displayName = "FarmCompiledKeyedRowConditional";
+  return {
+    Component: FarmKeyedRowConditional,
+    readValues: readKeyedRowConditionalValues,
+    changed: keyedRowConditionalChanged
+  };
+}
+function createKeyedRowHostRuntime() {
+  const owner = {
+    subscribe: () => () => {
+    }
+  };
+  return {
+    mount: (element, descriptor, requestFallback) => mountCompilerHostTree(owner, element, descriptor, requestFallback)
+  };
+}
+function createKeyedRowsBlockComponent(owner, options = {}) {
   class FarmKeyedRowsBlock extends React.Component {
     constructor() {
       super(...arguments);
@@ -1995,7 +2007,9 @@ function createKeyedRowsBlockComponent(owner) {
       this.rowConditional = (item, index, conditionalId, render) => {
         if (this.state.fallback) return render(item, index);
         const key = keyedRowIdentity(this.currentProps.rowKey(item, index));
-        return React.createElement(FarmKeyedRowConditional, {
+        const Conditional = options.conditionals?.Component;
+        if (!Conditional) return render(item, index);
+        return React.createElement(Conditional, {
           key: `${key}:${conditionalId}`,
           owner: this.conditionalOwner,
           rowKey: key,
@@ -2089,12 +2103,10 @@ function createKeyedRowsBlockComponent(owner) {
     }
     mountRowHostScope(element, descriptor, props = this.currentProps) {
       if (!props.hostBlocks) return void 0;
-      return mountCompilerHostTree(
-        rowHostScopeOwner,
-        element,
-        descriptor,
-        this.requestHostScopeFallback
-      );
+      return options.hostBlocks?.mount(element, descriptor, this.requestHostScopeFallback) || null;
+    }
+    readConditionalValues(props, item, index) {
+      return options.conditionals?.readValues(props, item, index) || EMPTY_KEYED_ROW_CONDITIONAL_VALUES;
     }
     pruneEventHandlers(keys) {
       const active = new Set(keys);
@@ -2135,7 +2147,7 @@ function createKeyedRowsBlockComponent(owner) {
           values: this.hasReactOwnedRows() ? this.currentProps.bindings.map(() => UNSET_KEYED_ROW_BINDING) : readKeyedRowBindingValues(this.currentProps, rows.items[index], index),
           item: rows.items[index],
           index,
-          conditionalValues: readKeyedRowConditionalValues(
+          conditionalValues: this.readConditionalValues(
             this.currentProps,
             rows.items[index],
             index
@@ -2247,13 +2259,13 @@ function createKeyedRowsBlockComponent(owner) {
           }
         }
         applyKeyedRowBindings(this.currentProps, existing, rows.items[index], index);
-        const conditionalValues = readKeyedRowConditionalValues(
+        const conditionalValues = this.readConditionalValues(
           this.currentProps,
           rows.items[index],
           index
         );
         for (const [id, values] of conditionalValues) {
-          if (keyedRowConditionalChanged(existing.conditionalValues.get(id), values)) {
+          if (options.conditionals?.changed(existing.conditionalValues.get(id), values)) {
             conditionalChanges.push({ key, id, item: rows.items[index], index });
           }
         }
@@ -2290,13 +2302,13 @@ function createKeyedRowsBlockComponent(owner) {
           }
         }
         applyKeyedRowBindings(this.currentProps, existing, rows.items[index], index);
-        const conditionalValues = readKeyedRowConditionalValues(
+        const conditionalValues = this.readConditionalValues(
           this.currentProps,
           rows.items[index],
           index
         );
         for (const [id, values] of conditionalValues) {
-          if (keyedRowConditionalChanged(existing.conditionalValues.get(id), values)) {
+          if (options.conditionals?.changed(existing.conditionalValues.get(id), values)) {
             conditionalChanges.push({ key, id, item: rows.items[index], index });
           }
         }
@@ -2380,13 +2392,13 @@ function createKeyedRowsBlockComponent(owner) {
             }
           }
           applyKeyedRowBindings(this.currentProps, existing, rows.items[index], index);
-          const conditionalValues = readKeyedRowConditionalValues(
+          const conditionalValues = this.readConditionalValues(
             this.currentProps,
             rows.items[index],
             index
           );
           for (const [id, values] of conditionalValues) {
-            if (keyedRowConditionalChanged(existing.conditionalValues.get(id), values)) {
+            if (options.conditionals?.changed(existing.conditionalValues.get(id), values)) {
               conditionalChanges.push({ key, id, item: rows.items[index], index });
             }
           }
@@ -2413,7 +2425,7 @@ function createKeyedRowsBlockComponent(owner) {
           values: readKeyedRowBindingValues(this.currentProps, rows.items[index], index),
           item: rows.items[index],
           index,
-          conditionalValues: readKeyedRowConditionalValues(
+          conditionalValues: this.readConditionalValues(
             this.currentProps,
             rows.items[index],
             index
@@ -2892,12 +2904,86 @@ function createComponentBlockComponent(owner) {
   FarmComponentBlock.displayName = "FarmCompiledComponentIsland";
   return FarmComponentBlock;
 }
-function createCompiledComponent(definition) {
+var conditionalRuntimeFeature = {
+  name: "conditional",
+  create: (owner) => ({
+    Conditional: createConditionalBlockComponent(owner)
+  })
+};
+var hostConditionalRuntimeFeature = {
+  name: "host-conditional",
+  create: (owner) => ({
+    HostConditional: createHostConditionalBlockComponent(owner)
+  })
+};
+var conditionalRangesRuntimeFeature = {
+  name: "conditional-ranges",
+  create: (owner) => ({
+    ConditionalRanges: createConditionalRangesBlockComponent(owner)
+  })
+};
+var keyedListRuntimeFeature = {
+  name: "keyed-list",
+  create: (owner) => ({
+    KeyedList: createKeyedListBlockComponent(owner)
+  })
+};
+var keyedRowsRuntimeFeature = {
+  name: "keyed-rows",
+  create: (owner) => ({
+    KeyedRows: createKeyedRowsBlockComponent(owner)
+  })
+};
+var keyedRowsConditionalRuntimeFeature = {
+  name: "keyed-rows:conditional",
+  create: (owner) => ({
+    KeyedRows: createKeyedRowsBlockComponent(owner, {
+      conditionals: createKeyedRowConditionalRuntime()
+    })
+  })
+};
+var keyedRowsHostRuntimeFeature = {
+  name: "keyed-rows:host",
+  create: (owner) => ({
+    KeyedRows: createKeyedRowsBlockComponent(owner, {
+      hostBlocks: createKeyedRowHostRuntime()
+    })
+  })
+};
+var keyedRowsCompleteRuntimeFeature = {
+  name: "keyed-rows:complete",
+  create: (owner) => ({
+    KeyedRows: createKeyedRowsBlockComponent(owner, {
+      conditionals: createKeyedRowConditionalRuntime(),
+      hostBlocks: createKeyedRowHostRuntime()
+    })
+  })
+};
+var keyedRangesRuntimeFeature = {
+  name: "keyed-ranges",
+  create: (owner) => ({
+    KeyedRanges: createKeyedRangesBlockComponent(owner)
+  })
+};
+var mixedRangesRuntimeFeature = {
+  name: "mixed-ranges",
+  create: (owner) => ({
+    MixedRanges: createMixedRangesBlockComponent(owner)
+  })
+};
+var componentRuntimeFeature = {
+  name: "component",
+  create: (owner) => ({
+    Component: createComponentBlockComponent(owner)
+  })
+};
+function createCompiledComponentWithFeatures(definition, runtimeFeatures) {
   const stateSignature = definition.stateSignature || String(definition.initialize.length);
+  const runtimeSignature = [...new Set(runtimeFeatures.map((feature) => feature.name))].sort().join(",");
   if (definition.hmrId) {
     const registry = getCompilerHmrRegistry();
     const existing = registry.get(definition.hmrId);
-    if (existing?.stateSignature === stateSignature) {
+    if (existing?.stateSignature === stateSignature && existing.runtimeSignature === runtimeSignature) {
       existing.definition.current = definition;
       existing.component.displayName = `FarmCompiled(${definition.displayName})`;
       for (const refresh of existing.refreshListeners) refresh();
@@ -2971,34 +3057,17 @@ function createCompiledComponent(definition) {
           }
         };
       });
-      this.blockRuntime = {
-        Conditional: createConditionalBlockComponent({
-          setRoot: (id, root) => this.setBlockRoot(id, root),
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        HostConditional: createHostConditionalBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        ConditionalRanges: createConditionalRangesBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        KeyedList: createKeyedListBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        KeyedRows: createKeyedRowsBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        KeyedRanges: createKeyedRangesBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        MixedRanges: createMixedRangesBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
-        Component: createComponentBlockComponent({
-          subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
-        }),
+      const featureOwner = {
+        setRoot: (id, root) => this.setBlockRoot(id, root),
+        subscribe: (id, refresh) => this.subscribeToBlock(id, refresh)
+      };
+      const blockRuntime = {
         target: (id) => this.bindingTarget(id)
       };
+      for (const feature of runtimeFeatures) {
+        Object.assign(blockRuntime, feature.create(featureOwner));
+      }
+      this.blockRuntime = blockRuntime;
     }
     usesHybridReactivity() {
       return definitionReference.current.reactivity === "hybrid";
@@ -3349,12 +3418,26 @@ function createCompiledComponent(definition) {
       component,
       definition: definitionReference,
       refreshListeners,
-      stateSignature
+      stateSignature,
+      runtimeSignature
     });
   }
   return component;
 }
+var COMPLETE_RUNTIME_FEATURES = [
+  conditionalRuntimeFeature,
+  hostConditionalRuntimeFeature,
+  conditionalRangesRuntimeFeature,
+  keyedListRuntimeFeature,
+  keyedRowsCompleteRuntimeFeature,
+  keyedRangesRuntimeFeature,
+  mixedRangesRuntimeFeature,
+  componentRuntimeFeature
+];
+function createCompiledComponent(definition) {
+  return createCompiledComponentWithFeatures(definition, COMPLETE_RUNTIME_FEATURES);
+}
 
-export { createCompiledComponent };
+export { componentRuntimeFeature, conditionalRangesRuntimeFeature, conditionalRuntimeFeature, createCompiledComponent, createCompiledComponentWithFeatures, hostConditionalRuntimeFeature, keyedListRuntimeFeature, keyedRangesRuntimeFeature, keyedRowsCompleteRuntimeFeature, keyedRowsConditionalRuntimeFeature, keyedRowsHostRuntimeFeature, keyedRowsRuntimeFeature, mixedRangesRuntimeFeature };
 //# sourceMappingURL=compiler-runtime.mjs.map
 //# sourceMappingURL=compiler-runtime.mjs.map