@farm.js/react 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/compiler-runtime.d.ts

@@ -1,12 +1,77 @@
 import React from 'react';
 
 type CompilerStateUpdater = unknown | ((previous: unknown) => unknown);
+type CompilerRuntimeReactivity = "static" | "hybrid";
+type CompilerKeyedCollectionKind = "set" | "map";
+type CompilerKeyedCollectionMutation = "set-add" | "set-delete" | "map-set" | "map-delete";
+/**
+ * @internal Executes a compiler-proven Array.map pipeline and records its final same-order delta.
+ * The three-argument value/index form remains accepted for older generated output.
+ */
+declare function createCompilerKeyedMapUpdate(previous: unknown, valueOrPipeline: unknown, changedIndices?: unknown): unknown;
+/**
+ * @internal Executes proven native maps within a keyed reorder pipeline.
+ * The three-argument form remains accepted for older generated output.
+ */
+declare function createCompilerKeyedArrayMapPipeline(previous: unknown, methodOrPipeline: unknown, callback?: unknown): unknown;
+/** @internal Executes a queued native map next to a compiler-proven keyed-array reorder. */
+declare function createCompilerKeyedArrayQueuedMapPipeline(previous: unknown, pipeline: (...values: readonly unknown[]) => unknown): unknown;
+/** @internal Executes a safe map inside one compiler-proven rolling-window setter chain. */
+declare function createCompilerKeyedArrayRollingWindowMapPipeline(previous: unknown, pipeline: (...values: readonly unknown[]) => unknown): unknown;
+/** @internal Executes a native reorder after a proven same-key map pipeline. */
+declare function createCompilerKeyedArrayMapReorder(previous: unknown, method: unknown, ...args: readonly unknown[]): unknown;
+/** @internal Records a compiler-proven immutable keyed-array append and returns the Array. */
+declare function createCompilerKeyedArrayAppend(previous: unknown, value: unknown): unknown;
+/** @internal Records an append that may follow a compiler-proven structural update. */
+declare function createCompilerKeyedArrayStructuralAppend(previous: unknown, value: unknown): unknown;
+/** @internal Records an append that directly follows compiler-proven mapped structural work. */
+declare function createCompilerKeyedArrayMappedStructuralAppend(previous: unknown, value: unknown): unknown;
+/** @internal Executes safe maps while retaining structural append lineage. */
+declare function createCompilerKeyedArrayStructuralAppendMapPipeline(previous: unknown, pipeline: (...values: readonly unknown[]) => unknown): unknown;
+/** @internal Records a compiler-proven immutable keyed-array prepend and returns the Array. */
+declare function createCompilerKeyedArrayPrepend(previous: unknown, value: unknown): unknown;
+/** @internal Records a prepend that may follow a compiler-proven structural update. */
+declare function createCompilerKeyedArrayStructuralPrepend(previous: unknown, value: unknown): unknown;
+/** @internal Records a prepend that directly follows compiler-proven mapped structural work. */
+declare function createCompilerKeyedArrayMappedStructuralPrepend(previous: unknown, value: unknown): unknown;
+/** @internal Executes safe maps while retaining structural prepend lineage. */
+declare function createCompilerKeyedArrayStructuralPrependMapPipeline(previous: unknown, pipeline: (...values: readonly unknown[]) => unknown): unknown;
+/** @internal Executes Array.filter while recording compiler-proven removal positions. */
+declare function createCompilerKeyedArrayFilter(previous: unknown, method: unknown, predicate: unknown): unknown;
+/** @internal Executes a compiler-proven native Array.slice and records its retained interval. */
+declare function createCompilerKeyedArraySlice(previous: unknown, method: unknown, ...args: readonly number[]): unknown;
+/** @internal Retains mapped lineage through a compiler-proven terminal filter or slice. */
+declare function finalizeCompilerKeyedArrayMappedStructuralUpdate(value: unknown): unknown;
+/** @internal Records a compiler-proven retained tail followed by incoming keyed rows. */
+declare function createCompilerKeyedArrayRollingWindow(previous: unknown, retained: unknown, value: unknown): unknown;
+/** @internal Records one rolling step inside a compiler-proven mapped window chain. */
+declare function createCompilerKeyedArrayMappedRollingWindow(previous: unknown, retained: unknown, value: unknown): unknown;
+/** @internal Executes a native known-position insert, removal, or replacement and records it. */
+declare function createCompilerKeyedArrayPositionUpdate(previous: unknown, method: unknown, kind: "insert" | "remove" | "replace", position: number, ...args: readonly unknown[]): unknown;
+/** @internal Executes a native exact-position batch insertion and records it. */
+declare function createCompilerKeyedArrayBatchInsert(previous: unknown, method: unknown, position: number, ...items: readonly unknown[]): unknown;
+/** @internal Executes a native exact-window replacement and records it. */
+declare function createCompilerKeyedArrayWindowReplace(previous: unknown, method: unknown, position: number, deleteCount: number, ...items: readonly unknown[]): unknown;
+/** @internal Executes a native reverse and records its exact keyed-row permutation. */
+declare function createCompilerKeyedArrayReorder(previous: unknown, method: unknown): unknown;
+/** @internal Executes a native immutable sort and records its keyed-row permutation. */
+declare function createCompilerKeyedArraySort(previous: unknown, method: unknown, ...args: readonly unknown[]): unknown;
+/** @internal Executes a native reverse after a compiler-proven filter or slice pipeline. */
+declare function createCompilerKeyedArrayStructuralReorder(previous: unknown, method: unknown): unknown;
+/** @internal Executes a native sort after a compiler-proven filter or slice pipeline. */
+declare function createCompilerKeyedArrayStructuralSort(previous: unknown, method: unknown, ...args: readonly unknown[]): unknown;
+/** @internal Preserves a proven native collection mutation while recording its executed key. */
+declare function applyCompilerKeyedCollectionMutation(collection: unknown, method: unknown, operation: CompilerKeyedCollectionMutation, key: unknown, value?: unknown): unknown;
+/** @internal Connects compiler-owned immutable Set/Map mutations to their committed source. */
+declare function createCompilerKeyedCollectionUpdate(previous: unknown, value: unknown, kind: CompilerKeyedCollectionKind): unknown;
 interface CompilerCell {
     get(): unknown;
     set(next: CompilerStateUpdater): void;
 }
 interface CompilerTextBinding<Props> {
     kind: "text";
+    /** Runtime tracking is useful only for compiler-proven short-circuiting readers. */
+    tracking?: "dynamic";
     path: readonly number[];
     /** Stable ref target emitted by newer compiler versions. */
     target?: number;
@@ -15,6 +80,8 @@ interface CompilerTextBinding<Props> {
 }
 interface CompilerAttributeBinding<Props> {
     kind: "attribute";
+    /** Runtime tracking is useful only for compiler-proven short-circuiting readers. */
+    tracking?: "dynamic";
     path: readonly number[];
     /** Stable ref target emitted by newer compiler versions. */
     target?: number;
@@ -24,6 +91,8 @@ interface CompilerAttributeBinding<Props> {
 }
 interface CompilerStyleBinding<Props> {
     kind: "style";
+    /** Runtime tracking is useful only for compiler-proven short-circuiting readers. */
+    tracking?: "dynamic";
     path: readonly number[];
     /** Stable ref target emitted by newer compiler versions. */
     target?: number;
@@ -58,10 +127,14 @@ interface CompilerHostElement {
         value: unknown;
     }[];
     children: readonly (CompilerHostElement | unknown)[];
+    /** Direct-child structure owned without creating another React fiber. */
+    block?: CompilerHostBlock;
 }
 type CompilerKeyedRowElement = CompilerHostElement;
 interface CompilerKeyedRowEvent {
     name: string;
+    /** Host-element path relative to the keyed row root. */
+    path?: readonly number[];
     invoke(item: unknown, index: number, event: React.SyntheticEvent): unknown;
 }
 interface CompilerKeyedRowConditionalBranch {
@@ -82,10 +155,45 @@ interface CompilerHostConditionalBinding {
     name?: string;
     read(): unknown;
 }
+interface CompilerStaticRangeBinding {
+    kind: "text" | "attribute" | "style";
+    /** Static segment before range N, or the trailing segment at ranges.length. */
+    segment: number;
+    /** Direct host sibling inside that static segment. */
+    sibling: number;
+    /** Host-element path relative to the selected static sibling. */
+    path: readonly number[];
+    name?: string;
+    read(): unknown;
+}
 interface CompilerHostConditionalBranch {
     create(): CompilerHostElement;
     bindings: readonly CompilerHostConditionalBinding[];
 }
+interface CompilerHostConditionalRanges {
+    kind: "conditional-ranges";
+    id: number;
+    ranges: readonly CompilerConditionalRange[];
+    trailing: number;
+    bindings?: readonly CompilerStaticRangeBinding[];
+}
+interface CompilerHostKeyedRanges {
+    kind: "keyed-ranges";
+    id: number;
+    ranges: readonly CompilerKeyedRange[];
+    trailing: number;
+    bindings?: readonly CompilerStaticRangeBinding[];
+    /** Compiler output may store only static direct children and materialize rows from the ranges. */
+    staticChildrenOnly?: boolean;
+}
+interface CompilerHostMixedRanges {
+    kind: "mixed-ranges";
+    id: number;
+    ranges: readonly CompilerMixedRange[];
+    trailing: number;
+    bindings?: readonly CompilerStaticRangeBinding[];
+}
+type CompilerHostBlock = CompilerHostConditionalRanges | CompilerHostKeyedRanges | CompilerHostMixedRanges;
 interface CompilerHostConditionalBlockProps {
     id: number;
     render(): React.ReactElement;
@@ -95,21 +203,74 @@ interface CompilerHostConditionalBlockProps {
     truthy?: CompilerHostConditionalBranch;
     falsy?: CompilerHostConditionalBranch;
 }
+interface CompilerConditionalRange {
+    /** Number of static direct host siblings between this slot and the previous slot. */
+    before: number;
+    test(): unknown;
+    /** Logical && can produce a visible number instead of an empty branch. */
+    logical?: boolean;
+    truthy?: CompilerHostConditionalBranch;
+    falsy?: CompilerHostConditionalBranch;
+}
+interface CompilerConditionalRangesBlockProps {
+    id: number;
+    render(): React.ReactElement;
+    rootRef?: React.RefCallback<Element>;
+    ranges: readonly CompilerConditionalRange[];
+    /** Number of static direct host siblings after the final conditional slot. */
+    trailing: number;
+    bindings?: readonly CompilerStaticRangeBinding[];
+}
 interface CompilerKeyedRowBinding {
     kind: "text" | "attribute" | "style";
     path: readonly number[];
     name?: string;
+    /** Component state cells read by this binding, when emitted by the compiler. */
+    dependencies?: readonly number[];
+    /** A compiler-proven primitive value compared strictly with this row's key. */
+    identityTarget?: {
+        dependency: number;
+        read(): unknown;
+    };
+    /** A compiler-proven native Set whose members are compared with this row's key. */
+    membershipTarget?: {
+        dependency: number;
+        read(): unknown;
+    };
+    /** A compiler-proven native Map whose values are read with this row's key. */
+    mapLookupTarget?: {
+        dependency: number;
+        read(): unknown;
+    };
     read(item: unknown, index: number): unknown;
 }
 interface CompilerKeyedRowsBlockProps {
     id: number;
     render(event: (item: unknown, index: number, eventId: number) => React.EventHandler<React.SyntheticEvent>, conditional: (item: unknown, index: number, conditionalId: number, render: (item: unknown, index: number) => React.ReactNode) => React.ReactNode): React.ReactElement;
     items(): Iterable<unknown> | null | undefined;
+    /** Complete component-state dependencies used anywhere inside this boundary. */
+    dependencies?: readonly number[];
+    /** State cells that can change the row collection or its key projection. */
+    structureDependencies?: readonly number[];
+    /** Direct state cell supplying items, eligible for compiler-emitted update hints. */
+    collectionDependency?: number;
+    /** Compiler proof that shifted row indexes are not observed by this boundary. */
+    filterIndexIndependent?: boolean;
+    /** Compiler proof that prepending cannot expose shifted indexes to existing rows. */
+    prependIndexIndependent?: boolean;
+    /** Compiler proof that a known-position insert cannot expose shifted row indexes. */
+    positionIndexIndependent?: boolean;
+    /** Compiler proof that reordering cannot expose changed row indexes. */
+    reorderIndexIndependent?: boolean;
     rowKey(item: unknown, index: number): React.Key;
     create(item: unknown, index: number): CompilerKeyedRowElement;
     bindings: readonly CompilerKeyedRowBinding[];
     events?: readonly CompilerKeyedRowEvent[];
+    /** Route compiler-proven bubbling row events through the stable React container. */
+    delegateEvents?: boolean;
     conditionals?: readonly CompilerKeyedRowConditional[];
+    /** Row descriptors contain compiler-owned nested host scopes. */
+    hostBlocks?: boolean;
 }
 interface CompilerKeyedRange {
     /** Number of static direct host siblings between this range and the previous range. */
@@ -119,6 +280,17 @@ interface CompilerKeyedRange {
     create(item: unknown, index: number): CompilerKeyedRowElement;
     bindings: readonly CompilerKeyedRowBinding[];
 }
+type CompilerMixedRange = ({
+    kind: "conditional";
+} & CompilerConditionalRange) | ({
+    kind: "keyed";
+} & CompilerKeyedRange);
+interface CompilerMixedRangesBlockProps {
+    id: number;
+    render(): React.ReactElement;
+    create(): CompilerHostElement;
+    rootRef?: React.RefCallback<Element>;
+}
 interface CompilerKeyedRangesBlockProps {
     id: number;
     render(): React.ReactElement;
@@ -126,6 +298,7 @@ interface CompilerKeyedRangesBlockProps {
     ranges: readonly CompilerKeyedRange[];
     /** Number of static direct host siblings after the final keyed range. */
     trailing: number;
+    bindings?: readonly CompilerStaticRangeBinding[];
 }
 interface CompilerComponentBlockProps {
     id: number;
@@ -134,30 +307,143 @@ interface CompilerComponentBlockProps {
 interface CompilerBlockRuntime {
     Conditional: React.ComponentType<CompilerConditionalBlockProps>;
     HostConditional: React.ComponentType<CompilerHostConditionalBlockProps>;
+    ConditionalRanges: React.ComponentType<CompilerConditionalRangesBlockProps>;
     KeyedList: React.ComponentType<CompilerKeyedListBlockProps>;
     KeyedRows: React.ComponentType<CompilerKeyedRowsBlockProps>;
     KeyedRanges: React.ComponentType<CompilerKeyedRangesBlockProps>;
+    MixedRanges: React.ComponentType<CompilerMixedRangesBlockProps>;
     Component: React.ComponentType<CompilerComponentBlockProps>;
     target(id: number): React.RefCallback<Element>;
 }
 type CompilerBinding<Props> = CompilerTextBinding<Props> | CompilerAttributeBinding<Props> | CompilerStyleBinding<Props> | CompilerConditionalBlockBinding;
 interface CompiledComponentDefinition<Props> {
     displayName: string;
+    /** Scheduler selected by the compiler. Hand-authored definitions default to `static`. */
+    reactivity?: CompilerRuntimeReactivity;
     /** Stable development-only identity used to preserve state across compatible refreshes. */
     hmrId?: string;
     /** Changes when the compiler-owned state layout is no longer refresh-compatible. */
     stateSignature?: string;
     initialize(props: Props): readonly unknown[];
+    /**
+     * Compiler-emitted flat prop reads. Primitive values can share the local
+     * dependency graph; identity-bearing values retain normal React rendering.
+     */
+    readProps?(props: Props): readonly unknown[];
     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, expectedRoot?: Element | null): void;
+    subscribe(id: number, refresh: CompilerBlockRefresh): () => void;
+    /** Opaque identity used to detect compatible definition replacement. */
+    getDefinitionVersion?(): unknown;
+}
+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 keyedRowsPlainRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsIdentityRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsMembershipRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsMapLookupRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsBatchPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsWindowPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsReorderHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsMapReorderHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsAllHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsMappedRollingWindowHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsBatchEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsWindowEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsFilterHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsIdentityFilterHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsIdentityFilterOnlyRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsStructuralAppendHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsStructuralAppendMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsStructuralPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsStructuralPrependMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsFilterPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalBatchPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalWindowPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalReorderHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalAllHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalMappedRollingWindowHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalBatchEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalWindowEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalFilterHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalStructuralAppendHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalStructuralAppendMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalStructuralPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalStructuralPrependMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsConditionalFilterPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostBatchPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostWindowPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostReorderHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostAllHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostMappedRollingWindowHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostBatchEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostWindowEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostFilterHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostStructuralAppendHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostStructuralAppendMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostStructuralPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostStructuralPrependMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsHostFilterPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompletePositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteBatchPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteWindowPositionHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteReorderHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteAllHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteMappedRollingWindowHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteBatchEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteWindowEveryHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteFilterHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteStructuralAppendHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteStructuralAppendMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteStructuralPrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteStructuralPrependMapHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompletePrependHintedRuntimeFeature: CompilerRuntimeFeature;
+declare const keyedRowsCompleteFilterPrependHintedRuntimeFeature: 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 CompilerHostConditionalBinding, type CompilerHostConditionalBlockProps, type CompilerHostConditionalBranch, type CompilerHostElement, type CompilerKeyedListBlockProps, type CompilerKeyedRange, type CompilerKeyedRangesBlockProps, type CompilerKeyedRowBinding, type CompilerKeyedRowConditional, type CompilerKeyedRowConditionalBranch, type CompilerKeyedRowElement, type CompilerKeyedRowEvent, type CompilerKeyedRowsBlockProps, type CompilerStateUpdater, 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, applyCompilerKeyedCollectionMutation, componentRuntimeFeature, conditionalRangesRuntimeFeature, conditionalRuntimeFeature, createCompiledComponent, createCompiledComponentWithFeatures, createCompilerKeyedArrayAppend, createCompilerKeyedArrayBatchInsert, createCompilerKeyedArrayFilter, createCompilerKeyedArrayMapPipeline, createCompilerKeyedArrayMapReorder, createCompilerKeyedArrayMappedRollingWindow, createCompilerKeyedArrayMappedStructuralAppend, createCompilerKeyedArrayMappedStructuralPrepend, createCompilerKeyedArrayPositionUpdate, createCompilerKeyedArrayPrepend, createCompilerKeyedArrayQueuedMapPipeline, createCompilerKeyedArrayReorder, createCompilerKeyedArrayRollingWindow, createCompilerKeyedArrayRollingWindowMapPipeline, createCompilerKeyedArraySlice, createCompilerKeyedArraySort, createCompilerKeyedArrayStructuralAppend, createCompilerKeyedArrayStructuralAppendMapPipeline, createCompilerKeyedArrayStructuralPrepend, createCompilerKeyedArrayStructuralPrependMapPipeline, createCompilerKeyedArrayStructuralReorder, createCompilerKeyedArrayStructuralSort, createCompilerKeyedArrayWindowReplace, createCompilerKeyedCollectionUpdate, createCompilerKeyedMapUpdate, finalizeCompilerKeyedArrayMappedStructuralUpdate, hostConditionalRuntimeFeature, keyedListRuntimeFeature, keyedRangesRuntimeFeature, keyedRowsAllHintedRuntimeFeature, keyedRowsBatchEveryHintedRuntimeFeature, keyedRowsBatchPositionHintedRuntimeFeature, keyedRowsCompleteAllHintedRuntimeFeature, keyedRowsCompleteBatchEveryHintedRuntimeFeature, keyedRowsCompleteBatchPositionHintedRuntimeFeature, keyedRowsCompleteEveryHintedRuntimeFeature, keyedRowsCompleteFilterHintedRuntimeFeature, keyedRowsCompleteFilterPrependHintedRuntimeFeature, keyedRowsCompleteHintedRuntimeFeature, keyedRowsCompleteMappedRollingWindowHintedRuntimeFeature, keyedRowsCompletePositionHintedRuntimeFeature, keyedRowsCompletePrependHintedRuntimeFeature, keyedRowsCompleteReorderHintedRuntimeFeature, keyedRowsCompleteRuntimeFeature, keyedRowsCompleteStructuralAppendHintedRuntimeFeature, keyedRowsCompleteStructuralAppendMapHintedRuntimeFeature, keyedRowsCompleteStructuralPrependHintedRuntimeFeature, keyedRowsCompleteStructuralPrependMapHintedRuntimeFeature, keyedRowsCompleteWindowEveryHintedRuntimeFeature, keyedRowsCompleteWindowPositionHintedRuntimeFeature, keyedRowsConditionalAllHintedRuntimeFeature, keyedRowsConditionalBatchEveryHintedRuntimeFeature, keyedRowsConditionalBatchPositionHintedRuntimeFeature, keyedRowsConditionalEveryHintedRuntimeFeature, keyedRowsConditionalFilterHintedRuntimeFeature, keyedRowsConditionalFilterPrependHintedRuntimeFeature, keyedRowsConditionalHintedRuntimeFeature, keyedRowsConditionalMappedRollingWindowHintedRuntimeFeature, keyedRowsConditionalPositionHintedRuntimeFeature, keyedRowsConditionalPrependHintedRuntimeFeature, keyedRowsConditionalReorderHintedRuntimeFeature, keyedRowsConditionalRuntimeFeature, keyedRowsConditionalStructuralAppendHintedRuntimeFeature, keyedRowsConditionalStructuralAppendMapHintedRuntimeFeature, keyedRowsConditionalStructuralPrependHintedRuntimeFeature, keyedRowsConditionalStructuralPrependMapHintedRuntimeFeature, keyedRowsConditionalWindowEveryHintedRuntimeFeature, keyedRowsConditionalWindowPositionHintedRuntimeFeature, keyedRowsEveryHintedRuntimeFeature, keyedRowsFilterHintedRuntimeFeature, keyedRowsFilterPrependHintedRuntimeFeature, keyedRowsHintedRuntimeFeature, keyedRowsHostAllHintedRuntimeFeature, keyedRowsHostBatchEveryHintedRuntimeFeature, keyedRowsHostBatchPositionHintedRuntimeFeature, keyedRowsHostEveryHintedRuntimeFeature, keyedRowsHostFilterHintedRuntimeFeature, keyedRowsHostFilterPrependHintedRuntimeFeature, keyedRowsHostHintedRuntimeFeature, keyedRowsHostMappedRollingWindowHintedRuntimeFeature, keyedRowsHostPositionHintedRuntimeFeature, keyedRowsHostPrependHintedRuntimeFeature, keyedRowsHostReorderHintedRuntimeFeature, keyedRowsHostRuntimeFeature, keyedRowsHostStructuralAppendHintedRuntimeFeature, keyedRowsHostStructuralAppendMapHintedRuntimeFeature, keyedRowsHostStructuralPrependHintedRuntimeFeature, keyedRowsHostStructuralPrependMapHintedRuntimeFeature, keyedRowsHostWindowEveryHintedRuntimeFeature, keyedRowsHostWindowPositionHintedRuntimeFeature, keyedRowsIdentityFilterHintedRuntimeFeature, keyedRowsIdentityFilterOnlyRuntimeFeature, keyedRowsIdentityRuntimeFeature, keyedRowsMapLookupRuntimeFeature, keyedRowsMapReorderHintedRuntimeFeature, keyedRowsMappedRollingWindowHintedRuntimeFeature, keyedRowsMembershipRuntimeFeature, keyedRowsPlainRuntimeFeature, keyedRowsPositionHintedRuntimeFeature, keyedRowsPrependHintedRuntimeFeature, keyedRowsReorderHintedRuntimeFeature, keyedRowsRuntimeFeature, keyedRowsStructuralAppendHintedRuntimeFeature, keyedRowsStructuralAppendMapHintedRuntimeFeature, keyedRowsStructuralPrependHintedRuntimeFeature, keyedRowsStructuralPrependMapHintedRuntimeFeature, keyedRowsWindowEveryHintedRuntimeFeature, keyedRowsWindowPositionHintedRuntimeFeature, mixedRangesRuntimeFeature };