arrowbase 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 0.1.1
+
+First public npm release.
+
+- Publishes six verified ESM entry points with declarations and provenance.
+- Ships the all-green 294/294 compatibility catalog against
+  `@tanstack/db@0.6.16`.
+- Adds columnar incremental live queries, spatial indexing, GeoArrow IPC,
+  persistence, cross-tab sync, and React bindings.
+- Adds the hosted City Ops playground and correctness-gated benchmark suite.
+- Hardens release automation, package contents, contribution guidance, and
+  private vulnerability reporting.
+
+## 0.1.0
+
+GitHub-only managed release for the @tanstack/db parity milestone.
+
+- Ships the all-green 294/294 export compatibility catalog against
+  `@tanstack/db@0.6.16`.
+- Adds TanStack DB migration docs, release notes, and head-to-head benchmark
+  coverage.
+- Keeps ArrowBase columnar storage, snapshot/Arrow IPC, IndexedDB persistence,
+  BroadcastChannel sync, and React bindings available from published subpaths.
+- Adds tag-driven GitHub release automation and optional npm publishing through
+  `NPM_TOKEN`.

package/COMPATIBILITY.md

@@ -0,0 +1,398 @@
+# COMPATIBILITY.md — ArrowBase ↔ @tanstack/db
+
+**Reference:** `@tanstack/db@0.6.16` (re-audit on every upstream release).
+
+Generated by `scripts/build-compat.mjs` from the enumerated export
+list in `/tmp/tanstack-exports.tsv`. Status column is maintained by hand.
+
+## Legend
+
+- ✅ — release parity. Named export exists in `arrowbase`, behaves
+  identically up to the documented tolerances in `GOAL.md §2`.
+- 🟡 / 🚫 / ⚫ — retained for future upstream re-audits only;
+  this release catalog has no partial, missing, or non-goal rows.
+
+**Totals:** 294 catalog rows are green. For 0.6.16,
+`tests/compatibility.test.ts` additionally audits every runtime root export,
+and `tests/query-builder-core.test.ts` requires exact 28/28 parity with the
+upstream `operators` manifest. New 0.6.16 runtime exports include arithmetic
+operators, `caseWhen`, `materialize`, collection/status helpers,
+`safeRandomUUID`, and `UnsafeAliasPathError`.
+
+## Collection (class + helpers)
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `Collection` | interface | ✅ | B | B.1–B.8; see B.10 conformance. |
+| `CollectionImpl` | class | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `createCollection` | function | ✅ | B | B.9; accepts compiled schema + capacity. StandardSchemaV1 path lands in Layer C. |
+
+## Transactions
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `createTransaction` | function | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `getActiveTransaction` | function | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+
+## Optimistic actions
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `createOptimisticAction` | function | ✅ | E | E.5; optimistic action wrapper covered by transaction tests. |
+
+## Local-only collection
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `LocalOnlyCollectionConfig` | interface | ✅ | E | E.7; local-only collection options and acceptMutations utility covered by focused tests. |
+| `localOnlyCollectionOptions` | function | ✅ | E | E.7; local-only collection options and acceptMutations utility covered by focused tests. |
+| `LocalOnlyCollectionUtils` | interface | ✅ | E | E.7; local-only collection options and acceptMutations utility covered by focused tests. |
+
+## Local-storage collection
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `ClearStorageFn` | type | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `GetStorageSizeFn` | type | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `LocalStorageCollectionConfig` | interface | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `localStorageCollectionOptions` | function | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `LocalStorageCollectionUtils` | interface | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `Parser` | interface | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `StorageApi` | type | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+| `StorageEventApi` | type | ✅ | E | E.8; local-storage hydration, persistence, parser, event sync, and utility behavior covered by focused tests. |
+
+## Paced mutations
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `createPacedMutations` | function | ✅ | E | E.6; paced mutation behavior covered for coalescing and queue strategies. |
+| `PacedMutationsConfig` | interface | ✅ | E | E.6; paced mutation behavior covered for coalescing and queue strategies. |
+
+## Query surface
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `add` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `and` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `ApplyJoinOptionalityToMergedSchema` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `avg` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `BaseQueryBuilder` | named | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `coalesce` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `caseWhen` | named | ✅ | C | 0.6.16 scalar expression helper; batch and differential behavior covered by query-method and columnar-live tests. |
+| `compileExpression` | named | ✅ | C | C.5/C.6/C.10; compiler evaluator and one-shot query behavior covered by focused tests. |
+| `compileQuery` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `compileSingleRowExpression` | named | ✅ | C | C.5/C.6/C.10; compiler evaluator and one-shot query behavior covered by focused tests. |
+| `concat` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `Context` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `ContextSchema` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `count` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `createLiveQueryCollection` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `DeduplicatedLoadSubset` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `eq` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `divide` | named | ✅ | C | 0.6.16 arithmetic expression helper; batch and differential behavior covered by query-method and columnar-live tests. |
+| `ExtractContext` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `extractFieldPath` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `extractSimpleComparisons` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `extractValue` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `FieldPath` | type | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `FunctionalHavingRow` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `GetResult` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `GroupByCallback` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `gt` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `gte` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `ilike` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `inArray` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `InferCollectionType` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `InferResultType` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `InitialQueryBuilder` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `isLimitSubset` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `isNull` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `isOffsetLimitSubset` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `isOrderBySubset` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `isPredicateSubset` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `isUndefined` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `isWhereSubset` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `JoinOnCallback` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `length` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `like` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `LiveQueryCollectionConfig` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `liveQueryCollectionOptions` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `LiveQueryCollectionUtils` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `lower` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `lt` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `lte` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `max` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `materialize` | named | ✅ | C | 0.6.16 includes helper; array and single-result materialization covered by compiler tests. |
+| `MergeContextForJoinCallback` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `MergeContextWithJoinType` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `min` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `multiply` | named | ✅ | C | 0.6.16 arithmetic expression helper; batch and differential behavior covered by query-method and columnar-live tests. |
+| `minusWherePredicates` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `not` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `or` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `OrderByCallback` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `ParsedOrderBy` | interface | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `parseLoadSubsetOptions` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `parseOrderByExpression` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `parseWhereExpression` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `ParseWhereOptions` | interface | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `Prettify` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `Query` | named | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `QueryBuilder` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `queryOnce` | named | ✅ | C | C.5/C.6/C.10; compiler evaluator and one-shot query behavior covered by focused tests. |
+| `QueryOnceConfig` | type | ✅ | C | C.5/C.6/C.10; compiler evaluator and one-shot query behavior covered by focused tests. |
+| `QueryResult` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `RefsForContext` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `ResultTypeFromSelect` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `SchemaFromSource` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `SelectObject` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `SimpleComparison` | interface | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `Source` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `sum` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `subtract` | named | ✅ | C | 0.6.16 arithmetic expression helper; batch and differential behavior covered by query-method and columnar-live tests. |
+| `toArray` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `toBooleanPredicate` | named | ✅ | C | C.5/C.6/C.10; compiler evaluator and one-shot query behavior covered by focused tests. |
+| `unionWherePredicates` | named | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `upper` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `walkExpression` | function | ✅ | C | C.12; expression-helper parity with @tanstack/db/query/expression-helpers. |
+| `WhereCallback` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `WithResult` | type | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+
+## Scheduler strategies
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `debounceStrategy` | named | ✅ | H | H.2; scheduler strategy timing and queue persistence behavior covered by focused parity tests. |
+| `queueStrategy` | named | ✅ | H | H.2; scheduler strategy timing and queue persistence behavior covered by focused parity tests. |
+| `throttleStrategy` | named | ✅ | H | H.2; scheduler strategy timing and queue persistence behavior covered by focused parity tests. |
+
+## SortedMap
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `SortedMap` | class | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+
+## Proxy utilities
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `createArrayChangeProxy` | function | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `createChangeProxy` | function | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `withArrayChangeTracking` | function | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `withChangeTracking` | function | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+
+## Errors
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `AggregateFunctionNotInSelectError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `AggregateNotSupportedError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CannotCombineEmptyExpressionListError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionConfigurationError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionInErrorStateError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionInputNotFoundError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionIsInErrorStateError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionOperationError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionRequiresConfigError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionRequiresSyncConfigError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `CollectionStateError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `DeleteKeyNotFoundError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `DistinctRequiresSelectError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `DuplicateAliasInSubqueryError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `DuplicateDbInstanceError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `DuplicateKeyError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `DuplicateKeySyncError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `EmptyReferencePathError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `FnSelectWithGroupByError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `GroupByError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `HavingRequiresGroupByError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidCollectionStatusTransitionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidJoinCondition` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidJoinConditionLeftSourceError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidJoinConditionRightSourceError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidJoinConditionSameSourceError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidJoinConditionSourceMismatchError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidKeyError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidSchemaError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidSourceError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidSourceTypeError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidStorageDataFormatError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidStorageObjectFormatError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `InvalidWhereExpressionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `JoinCollectionNotFoundError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `JoinConditionMustBeEqualityError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `JoinError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `KeyUpdateNotAllowedError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `LimitOffsetRequireOrderByError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `LocalStorageCollectionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingAliasInputsError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingDeleteHandlerError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingHandlerError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingInsertHandlerError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingMutationFunctionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingUpdateArgumentError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `MissingUpdateHandlerError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NegativeActiveSubscribersError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NoKeysPassedToDeleteError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NoKeysPassedToUpdateError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NonAggregateExpressionNotInGroupByError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NonRetriableError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NoPendingSyncTransactionCommitError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `NoPendingSyncTransactionWriteError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `OnlyOneSourceAllowedError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `OnMutateMustBeSynchronousError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `QueryBuilderError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `QueryCompilationError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `QueryMustHaveFromClauseError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `QueryOptimizerError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SchemaMustBeSynchronousError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SchemaValidationError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SerializationError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SetWindowRequiresOrderByError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `StorageError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `StorageKeyRequiredError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SubQueryMustHaveFromClauseError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SubscriptionNotFoundError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SyncCleanupError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SyncTransactionAlreadyCommittedError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `SyncTransactionAlreadyCommittedWriteError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `TanStackDBError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `TransactionAlreadyCompletedRollbackError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `TransactionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `TransactionNotPendingCommitError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `TransactionNotPendingMutateError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UndefinedKeyError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnknownExpressionTypeError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnknownFunctionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnknownHavingExpressionTypeError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnsupportedAggregateFunctionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnsupportedFromTypeError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnsupportedJoinSourceTypeError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnsupportedJoinTypeError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UnsupportedRootScalarSelectError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `UpdateKeyNotFoundError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+| `WhereClauseConversionError` | class | ✅ | H | H.2; TanStack error runtime names are root-exported and core constructors are parity-tested. |
+
+## Core types
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `BaseCollectionConfig` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `ChangeListener` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `ChangeMessage` | interface | ✅ | B | B.3; field-for-field shape. |
+| `ChangeMessageOrDeleteKeyMessage` | type | ✅ | B | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `ChangesPayload` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `CleanupFn` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `CollectionConfig` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `CollectionConfigSingleRowOption` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `CollectionLike` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `CollectionStatus` | type | ✅ | B | B.2. |
+| `CreateOptimisticActionsOptions` | interface | ✅ | E | E.5; optimistic action wrapper covered by transaction tests. |
+| `CurrentStateAsChangesOptions` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `CursorExpressions` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `DeleteKeyMessage` | type | ✅ | B | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `DeleteMutationFn` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `DeleteMutationFnParams` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `Fn` | type | ✅ | B | B.7. |
+| `InferSchemaInput` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `InferSchemaOutput` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `InputRow` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `InsertConfig` | interface | ✅ | B | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `InsertMutationFn` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `InsertMutationFnParams` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `KeyedNamespacedRow` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `KeyedStream` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `LoadSubsetFn` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `LoadSubsetOptions` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `MakeOptional` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `MaybeSingleResult` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `MutationFn` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `MutationFnParams` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `NamespacedAndKeyedStream` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `NamespacedRow` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `NonEmptyArray` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `NonSingleResult` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `OperationConfig` | interface | ✅ | B | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `OperationType` | type | ✅ | B | B.3. |
+| `OptimisticChangeMessage` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `PendingMutation` | interface | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `ResolveTransactionChanges` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `ResultStream` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `Row` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SingleResult` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `StandardSchema` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `StandardSchemaAlias` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `StringCollationConfig` | type | ✅ | B | B.7; stored on Collection, consumed by Layer-C orderBy. |
+| `SubscribeChangesOptions` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SubscribeChangesSnapshotOptions` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `Subscription` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SubscriptionEvents` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SubscriptionStatus` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SubscriptionStatusChangeEvent` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SubscriptionStatusEvent` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SubscriptionUnsubscribedEvent` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SyncConfig` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SyncConfigRes` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SyncMetadataApi` | interface | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `SyncMode` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `TransactionConfig` | interface | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `TransactionState` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `TransactionWithMutations` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `UnloadSubsetFn` | type | ✅ | C | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+| `UpdateMutationFn` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `UpdateMutationFnParams` | type | ✅ | E | E.2-E.4/E.9; transaction lifecycle, ambient scope, optimistic collection wiring, and mutation streams covered by focused + differential tests. |
+| `UtilsRecord` | type | ✅ | B | B.7. |
+| `WritableDeep` | type | ✅ | B | I.4 release review: covered by export audit, conformance, differential/golden tests, and GOAL.md documented tolerances. |
+
+## Top-level re-exports
+
+| Export | Kind | Status | Layer | Note |
+|---|---|---|---|---|
+| `BaseIndex` | named | ✅ | D | D.1-D.6; index classes/options shipped, maintained live through collection mutations, and benchmarked. |
+| `BasicIndex` | named | ✅ | D | D.1-D.6; index classes/options shipped, maintained live through collection mutations, and benchmarked. |
+| `BTreeIndex` | named | ✅ | D | D.1-D.6; index classes/options shipped, maintained live through collection mutations, and benchmarked. |
+| `clearQueryPatterns` | named | ✅ | D | D.3-D.6; dev-mode registry shipped with defensive-copy tests and auto-index integration. |
+| `configureIndexDevMode` | named | ✅ | D | D.3-D.6; dev-mode registry shipped with defensive-copy tests and auto-index integration. |
+| `createEffect` | named | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `deepEquals` | named | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `DeltaEvent` | type | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `DeltaType` | type | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `Effect` | type | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `EffectConfig` | type | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `EffectContext` | type | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `EffectQueryInput` | type | ✅ | H | H.2; createEffect delta dispatch, batching, skipInitial, cleanup, and async error handling covered by focused tests. |
+| `findIndexForField` | named | ✅ | D | D.2-D.6; optimizer indexed path covered by focused, differential, and benchmark tests. |
+| `getIndexDevModeConfig` | named | ✅ | D | D.3-D.6; dev-mode registry shipped with defensive-copy tests and auto-index integration. |
+| `getQueryPatterns` | named | ✅ | D | D.3-D.6; dev-mode registry shipped with defensive-copy tests and auto-index integration. |
+| `hasVirtualProps` | named | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `IndexOptions` | type | ✅ | D | D.1-D.6; index classes/options shipped, maintained live through collection mutations, and benchmarked. |
+| `IR` | local | ✅ | C | C.4/C.11; builder runtime + structural conformance for claimed Layer-C query subset. |
+| `isDevModeEnabled` | named | ✅ | D | D.3-D.6; dev-mode registry shipped with defensive-copy tests and auto-index integration. |
+| `OperatorName` | type | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `operators` | named | ✅ | C | C.3/C.10; expression helper signatures and runtime behavior covered by query-method tests. |
+| `optimizeExpressionWithIndexes` | named | ✅ | D | D.2-D.6; optimizer indexed path covered by focused, differential, and benchmark tests. |
+| `ReverseIndex` | named | ✅ | D | D.1-D.6; index classes/options shipped, maintained live through collection mutations, and benchmarked. |
+| `trackQuery` | named | ✅ | D | D.3-D.6; dev-mode registry shipped with defensive-copy tests and auto-index integration. |
+| `VirtualOrigin` | type | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `VirtualRowProps` | type | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `WithoutVirtualProps` | type | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+| `WithVirtualProps` | type | ✅ | H | H.2; virtual row, deepEquals, SortedMap, and proxy-change behavior covered against @tanstack/db. |
+
+## Summary by area
+
+| Area | Count | ✅ | 🟡 | 🚫 | ⚫ |
+|---|---|---|---|---|---|
+| Collection (class + helpers) | 3 | 3 | 0 | 0 | 0 |
+| Transactions | 2 | 2 | 0 | 0 | 0 |
+| Optimistic actions | 1 | 1 | 0 | 0 | 0 |
+| Local-only collection | 3 | 3 | 0 | 0 | 0 |
+| Local-storage collection | 8 | 8 | 0 | 0 | 0 |
+| Paced mutations | 2 | 2 | 0 | 0 | 0 |
+| Query surface | 85 | 85 | 0 | 0 | 0 |
+| Scheduler strategies | 3 | 3 | 0 | 0 | 0 |
+| SortedMap | 1 | 1 | 0 | 0 | 0 |
+| Proxy utilities | 4 | 4 | 0 | 0 | 0 |
+| Errors | 87 | 87 | 0 | 0 | 0 |
+| Core types | 66 | 66 | 0 | 0 | 0 |
+| Top-level re-exports | 29 | 29 | 0 | 0 | 0 |
+| **Total** | **294** | **294** | **0** | **0** | **0** |

package/LICENSE

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