@sylwellsoftware/fray 0.2.0 → 0.3.0

package/README.md

@@ -1,10 +1,10 @@
 # Fray
 
-Fray is an experimental, browser-only component and DOM runtime built around
+Fray is a browser-only component and DOM runtime built around
 Glue emitters. It targets modern evergreen browsers. Its `0.x` API may change
 with documented migration notes.
 
-Install the published alpha together with its Glue peer:
+Install it together with its Glue peer:
 
 ```bash
 pnpm add @sylwellsoftware/glue @sylwellsoftware/fray
@@ -207,7 +207,7 @@ TypeScript TSX is Fray's supported template syntax. Classic JSX and direct
 use the same renderer. A future template-file syntax can target this vnode
 contract without changing Glue binding semantics.
 
-Fray's own stable and experimental built-ins are authored in TSX. Direct
+Fray's built-ins are authored in TSX. Direct
 `h()` remains supported for consumers that do not use JSX and as the renderer's
 canonical vnode operation, but it is not the built-in component authoring
 format. The workspace lint gate rejects new `h()` templates under
@@ -738,19 +738,87 @@ operation, labelled roles, reduced motion, 200% configured text sizing, and
 forced-colors focus visibility. A formal manual screen-reader pass is still a
 release-candidate requirement; automated checks are not a substitute for it.
 
-## Experimental data components
+## Data workflows
 
-`ListView`, `DataTable`, `TreeView`, `TreeItem`, `Dialog`, filters, selection
-handlers, and `Placeholder` are available only from
-`@sylwellsoftware/fray/experimental`. They are outside the stable alpha
-compatibility surface and may change without a migration bridge. Their state
-model, keyboard behavior, measured data boundary, and current limitations are
-documented in [EXPERIMENTAL.md](EXPERIMENTAL.md).
+`ListView`, `DataTable`, `TreeView`, `TreeItem`, `Dialog`, `FilterPanel`, and
+their model helpers are part of the package entry point. All accept
+ordinary Glue emitters; they do not introduce a second state store.
+
+List and table selection is discriminated by cardinality. Single selection is
+an item or `null`; array state is reserved for explicit multi-selection:
+
+```tsx
+const selected = new Emitter<Project | null>(null)
+const selectedRows = new Emitter<Project[]>([])
+
+<ListView items={projects} selectedItemEmitter={selected} itemKey="id" />
+<DataTable
+    data={projects}
+    columns={columns}
+    multiSelect
+    selectedItemsEmitter={selectedRows}
+/>
+```
+
+Both modes reconcile selected keys to fresh objects when data is replaced.
+Multi-selection retains Control/Command toggles, Shift and pointer-drag ranges,
+and keyboard operation.
+
+DataTable accepts exactly one data boundary:
+
+```tsx
+// Direct local data; Fray derives sorted/filtered rows.
+<DataTable data={projects} columns={columns} />
+
+// Convenient REST adapter; the table creates and disposes this source.
+<DataTable
+    rest={{url: '/api/projects', baseUrl: location.href}}
+    columns={columns}
+/>
+
+// Explicit source; the caller owns and eventually disposes it.
+const source = createQueryTableDataSource({query, sortEmitter, filtersEmitter})
+<DataTable dataSource={source} columns={columns} />
+```
+
+`createLocalTableDataSource`, `createQueryTableDataSource`,
+`createHandlerTableDataSource`, and `createRestTableDataSource` make ownership
+visible. Sources package the row query with sort/filter emitters, retry, and
+disposal. The default REST serializer retains the compact existing endpoint
+tokens; inject `serializeQuery` when an endpoint uses another wire contract.
+
+Tree node state is projected from complete immutable snapshots:
+
+```ts
+const selectedNode = deriveTreeNode(treeNodes, selectedKey)
+
+// Only for an authoritative writable root:
+updateWritableTreeNode(treeNodes, 'project-1', (node) => ({...node, label: 'Updated'}))
+```
+
+For a tree derived from domain state, a callback updates that real source; the
+tree derivation then rebuilds and `deriveTreeNode` resolves the fresh node.
+`updateTreeNode` is the equivalent pure path-copy operation.
+
+Generic `FilterState` keeps `neutral`, `prefer`, `require`, and `deny` semantic
+values separate from glyphs and transport. `filterByState`,
+`deriveFilterPredicate`, and `deriveFilteredItems` consume caller-supplied
+dimension matchers. `serializeFilterState`/`parseFilterState` round-trip
+validated version-1 plain data without owning URL or storage access. Unknown
+valid keys are preserved and ignored until a matching definition exists.
+Dimensions combine with AND. Within each dimension, a denied match always
+rejects, every required option must match, and at least one preferred option
+must match when preferences are active. Neutral options do not constrain the
+result.
+
+The stable non-virtualized performance boundary and detailed state behavior are
+documented in this guide. See the migration notes in the changelog before
+upgrading from 0.2.x.
 
 Fray is not a replacement for an SSR/hydration framework, Web Components,
 React/Vue adapters, a broad design system, a virtualized production data grid,
 legacy-browser support, or a stable `1.0` API. See the [workspace
-overview](../../README.md), [alpha API surface](../../docs/API_SURFACE.md),
+overview](../../README.md), [API surface](../../docs/API_SURFACE.md),
 [architecture overview](../../docs/architecture.md),
 [changelog](../../CHANGELOG.md), [contribution guide](../../CONTRIBUTING.md),
 and [security policy](../../SECURITY.md).

package/dist/Components/Placeholder.d.ts

@@ -3,7 +3,7 @@ import type { ComponentProps } from './component.js';
 export interface PlaceholderProps extends ComponentProps {
     width?: number | string;
 }
-/** Deterministic loading placeholder for experimental data components. */
+/** Deterministic loading placeholder for data components. */
 export declare class Placeholder extends Component<PlaceholderProps> {
     render(): import("@sylwellsoftware/fray/jsx-runtime").JSX.Element;
     static hostName: string;

package/dist/Components/Placeholder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Placeholder.d.ts","sourceRoot":"","sources":["../../src/Components/Placeholder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAElD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,0EAA0E;AAC1E,qBAAa,WAAY,SAAQ,SAAS,CAAC,gBAAgB,CAAC;IACxD,MAAM;IAMN,OAAgB,QAAQ,SAAgB;IACxC,OAAgB,kBAAkB,SAAwB;IAE1D,MAAM,CAAC,UAAU,0BAEhB;IAED,MAAM,CAAC,GAAG,SAgBT;CACJ"}
+{"version":3,"file":"Placeholder.d.ts","sourceRoot":"","sources":["../../src/Components/Placeholder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAElD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,6DAA6D;AAC7D,qBAAa,WAAY,SAAQ,SAAS,CAAC,gBAAgB,CAAC;IACxD,MAAM;IAMN,OAAgB,QAAQ,SAAgB;IACxC,OAAgB,kBAAkB,SAAwB;IAE1D,MAAM,CAAC,UAAU,0BAEhB;IAED,MAAM,CAAC,GAAG,SAgBT;CACJ"}

package/dist/Components/controlUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controlUtils.d.ts","sourceRoot":"","sources":["../../src/Components/controlUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1E,OAAO,KAAK,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAE7D,MAAM,WAAW,YAAY,CAAC,MAAM,CAAE,SAAQ,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CACtD;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM,CAAE,SAAQ,cAAc;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAGnF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EACrC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAChB,YAAY,CAAC,MAAM,CAAC,CAWtB;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAG,OAAO,EAC1C,KAAK,EAAE,OAAO,EACd,IAAI,SAAY,GACjB,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAQvC;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAKvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,MAAM,CAEzF;AAED,wBAAgB,MAAM,CAAC,UAAU,SAAS,OAAO,EAAE,EAC/C,QAAQ,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,EAC5D,GAAG,IAAI,EAAE,UAAU,GACpB,IAAI,CAIN;AAED,wBAAgB,aAAa,CAAC,OAAO,EACjC,OAAO,EAAE,OAAO,EAChB,IAAI,SAAY,GACjB,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAE9B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD"}
+{"version":3,"file":"controlUtils.d.ts","sourceRoot":"","sources":["../../src/Components/controlUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1E,OAAO,KAAK,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAG7D,MAAM,WAAW,YAAY,CAAC,MAAM,CAAE,SAAQ,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CACtD;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM,CAAE,SAAQ,cAAc;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAGnF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EACrC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAChB,YAAY,CAAC,MAAM,CAAC,CAWtB;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAG,OAAO,EAC1C,KAAK,EAAE,OAAO,EACd,IAAI,SAAY,GACjB,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAQvC;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAKvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,MAAM,CAEzF;AAED,wBAAgB,MAAM,CAAC,UAAU,SAAS,OAAO,EAAE,EAC/C,QAAQ,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,EAC5D,GAAG,IAAI,EAAE,UAAU,GACpB,IAAI,CAIN;AAED,wBAAgB,aAAa,CAAC,OAAO,EACjC,OAAO,EAAE,OAAO,EAChB,IAAI,SAAY,GACjB,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAE9B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/dist/Components/data/filterState.d.ts

@@ -0,0 +1,38 @@
+import { DerivedEmitter } from '@sylwellsoftware/glue';
+import type { ReadableEmitter } from '@sylwellsoftware/glue';
+import type { FilterModeValue } from '../../util/filterMode.js';
+export type FilterOptionState = Readonly<Record<string, FilterModeValue>>;
+export type FilterState = Readonly<Record<string, FilterOptionState>>;
+export interface SerializedFilterState {
+    readonly version: 1;
+    readonly dimensions: Record<string, Record<string, FilterModeValue>>;
+}
+export interface FilterOptionDefinition<TItem> {
+    /** Stable persisted identity within its dimension. */
+    key: string;
+    matches: (item: TItem) => boolean;
+}
+export interface FilterDimensionDefinition<TItem> {
+    /** Stable persisted identity for the dimension. */
+    key: string;
+    options: readonly FilterOptionDefinition<TItem>[];
+}
+/**
+ * Test an item against semantic filter state.
+ *
+ * Dimensions combine with AND. Within one dimension, deny wins, every required
+ * option must match, and at least one preferred option must match when any are
+ * active. Unknown persisted dimensions and options are retained by
+ * serialization but do not constrain matching.
+ */
+export declare function matchesFilterState<TItem>(item: TItem, state: FilterState, dimensions: readonly FilterDimensionDefinition<TItem>[]): boolean;
+export declare function filterByState<TItem>(items: readonly TItem[], state: FilterState, dimensions: readonly FilterDimensionDefinition<TItem>[]): TItem[];
+/** Derive a reusable predicate without giving Fray ownership of persistence. */
+export declare function deriveFilterPredicate<TItem>(state: ReadableEmitter<FilterState, unknown>, dimensions: readonly FilterDimensionDefinition<TItem>[], owner?: unknown): DerivedEmitter<(item: TItem) => boolean, readonly [ReadableEmitter<FilterState, unknown>]>;
+/** Derive a filtered collection from application-owned items and filter state. */
+export declare function deriveFilteredItems<TItem>(items: ReadableEmitter<readonly TItem[], unknown>, state: ReadableEmitter<FilterState, unknown>, dimensions: readonly FilterDimensionDefinition<TItem>[], owner?: unknown): DerivedEmitter<TItem[], readonly [ReadableEmitter<readonly TItem[], unknown>, ReadableEmitter<FilterState, unknown>]>;
+/** Convert state to deterministic, versioned, plain JSON-compatible data. */
+export declare function serializeFilterState(state: FilterState): SerializedFilterState;
+/** Validate and restore versioned filter data. Unknown keys are preserved. */
+export declare function parseFilterState(value: unknown): FilterState;
+//# sourceMappingURL=filterState.d.ts.map

package/dist/Components/data/filterState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterState.d.ts","sourceRoot":"","sources":["../../../src/Components/data/filterState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAG1D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AAE7D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;AACzE,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAA;AAErE,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;CACvE;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK;IACzC,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAA;CACpC;AAED,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAC5C,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,SAAS,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAA;CACpD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EACpC,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,SAAS,yBAAyB,CAAC,KAAK,CAAC,EAAE,GACxD,OAAO,CAsBT;AAED,wBAAgB,aAAa,CAAC,KAAK,EAC/B,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,SAAS,yBAAyB,CAAC,KAAK,CAAC,EAAE,GACxD,KAAK,EAAE,CAGT;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EACvC,KAAK,EAAE,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,EAC5C,UAAU,EAAE,SAAS,yBAAyB,CAAC,KAAK,CAAC,EAAE,EACvD,KAAK,GAAE,OAAc,GACtB,cAAc,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAO5F;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EACrC,KAAK,EAAE,eAAe,CAAC,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,EACjD,KAAK,EAAE,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,EAC5C,UAAU,EAAE,SAAS,yBAAyB,CAAC,KAAK,CAAC,EAAE,EACvD,KAAK,GAAE,OAAc,GACtB,cAAc,CACb,KAAK,EAAE,EACP,SAAS,CAAC,eAAe,CAAC,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAC/F,CAOA;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAY9E;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAuB5D"}

package/dist/Components/data/listview/listview.d.ts

@@ -4,31 +4,41 @@ import { Component } from '../../component.js';
 import type { ComponentProps, FrayChild } from '../../component.js';
 import type { ValueEmitter } from '../../controlUtils.js';
 import type { BaseSelectionHandler, ItemKeyGetter } from '../selectionhandler.js';
-export interface ListViewProps<TItem = unknown> extends ComponentProps {
+interface ListViewCommonProps<TItem> extends ComponentProps {
     items?: readonly TItem[] | ReadableEmitter<readonly TItem[], unknown>;
-    selectedItemsEmitter?: ValueEmitter<TItem[]>;
     itemKey?: string | ItemKeyGetter<TItem>;
-    multiSelect?: boolean;
     label?: string;
     placeholderCount?: number;
     renderItem?: (item: TItem, index: number) => FrayChild;
 }
-/** Experimental accessible listbox with stable-key selection. */
+export type ListViewProps<TItem = unknown> = ListViewCommonProps<TItem> & ({
+    multiSelect?: false;
+    selectedItemEmitter?: ValueEmitter<TItem | null>;
+    selectedItemsEmitter?: never;
+} | {
+    multiSelect: true;
+    selectedItemsEmitter?: ValueEmitter<TItem[]>;
+    selectedItemEmitter?: never;
+});
+/** Accessible listbox with stable-key selection. */
 export declare class ListView<TItem = unknown> extends Component<ListViewProps<TItem>> {
     readonly itemsEmitter: ReadableEmitter<readonly TItem[], unknown>;
     readonly items$: ReadableEmitter<readonly TItem[], unknown>;
     readonly selectedItemsEmitter: ValueEmitter<TItem[]>;
     readonly selectedItems$: ValueEmitter<TItem[]>;
+    readonly selectedItemEmitter: ValueEmitter<TItem | null> | null;
+    readonly selectedItem$: ValueEmitter<TItem | null> | null;
     readonly getItemKey: ItemKeyGetter<TItem>;
     readonly selectionHandler: BaseSelectionHandler<TItem>;
     private readonly ownedItemsEmitter;
-    private readonly ownedSelectedItemsEmitter;
     constructor(props?: ListViewProps<TItem>);
     initialize(): void;
     render(): FrayChild;
     afterUpdate(dom: ChildNode | null): void;
     getSelectedItems(): TItem[];
     getSelectedItemsEmitter(): ValueEmitter<TItem[]>;
+    getSelectedItem(): TItem | null;
+    getSelectedItemEmitter(): ValueEmitter<TItem | null> | null;
     onDestroy(): void;
     static dependencies: (typeof Placeholder)[];
     static hostName: string;
@@ -36,4 +46,5 @@ export declare class ListView<TItem = unknown> extends Component<ListViewProps<T
     static baseStyles: string[][];
     static css: string;
 }
+export {};
 //# sourceMappingURL=listview.d.ts.map

package/dist/Components/data/listview/listview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listview.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/listview/listview.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAC,SAAS,EAAM,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAEjE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAKvD,OAAO,KAAK,EACR,oBAAoB,EACpB,aAAa,EAChB,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,cAAc;IAClE,KAAK,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,eAAe,CAAC,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;IACrE,oBAAoB,CAAC,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;IAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACvC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAA;CACzD;AAED,iEAAiE;AACjE,qBAAa,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1E,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;IACjE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;IAC3D,QAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;IACpD,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;IAC9C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;IACzC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IACtD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAyB;gBAEvD,KAAK,GAAE,aAAa,CAAC,KAAK,CAAM;IA6B5C,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,SAAS;IAyDnB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAOxC,gBAAgB,IAAI,KAAK,EAAE;IAI3B,uBAAuB,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;IAIhD,SAAS,IAAI,IAAI;IAMjB,MAAM,CAAC,YAAY,yBAAgB;IAEnC,OAAgB,QAAQ,SAAc;IACtC,OAAgB,kBAAkB,SAAc;IAEhD,MAAM,CAAC,UAAU,aAGhB;IAED,MAAM,CAAC,GAAG,SAwCT;CACJ"}
+{"version":3,"file":"listview.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/listview/listview.tsx"],"names":[],"mappings":"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"}

package/dist/Components/data/selectionhandler.d.ts

@@ -1,11 +1,23 @@
 import type { ValueEmitter } from '../controlUtils.js';
 export type ItemKeyGetter<TItem> = (item: TItem, index: number) => unknown;
-export interface SelectionHandlerConfig<TItem> {
+interface SelectionHandlerCommonConfig<TItem> {
     getItems: () => readonly TItem[];
     getKey?: ItemKeyGetter<TItem>;
-    selectedItemsEmitter?: ValueEmitter<TItem[]>;
     owner?: unknown;
-    multiSelect?: boolean;
+}
+export interface SingleSelectionHandlerConfig<TItem> extends SelectionHandlerCommonConfig<TItem> {
+    multiSelect?: false;
+    selectedItemEmitter?: ValueEmitter<TItem | null>;
+    selectedItemsEmitter?: never;
+}
+export interface MultiSelectionHandlerConfig<TItem> extends SelectionHandlerCommonConfig<TItem> {
+    multiSelect: true;
+    selectedItemsEmitter?: ValueEmitter<TItem[]>;
+    selectedItemEmitter?: never;
+}
+export type SelectionHandlerConfig<TItem> = SingleSelectionHandlerConfig<TItem> | MultiSelectionHandlerConfig<TItem>;
+interface BaseSelectionHandlerConfig<TItem> extends SelectionHandlerCommonConfig<TItem> {
+    selectedItemsEmitter?: ValueEmitter<TItem[]>;
 }
 type SelectionEvent = MouseEvent | KeyboardEvent;
 /**
@@ -32,7 +44,7 @@ export declare class BaseSelectionHandler<TItem = unknown> {
     private suppressClickTimer;
     private destroyed;
     private readonly ownedSelectedItemsEmitter;
-    constructor({ getItems, getKey, selectedItemsEmitter, owner, }: SelectionHandlerConfig<TItem>);
+    constructor({ getItems, getKey, selectedItemsEmitter, owner, }: BaseSelectionHandlerConfig<TItem>);
     rowsUpdated(rows: Iterable<HTMLElement> | ArrayLike<HTMLElement> | null): void;
     private wireRow;
     private handleClick;
@@ -54,7 +66,13 @@ export declare class BaseSelectionHandler<TItem = unknown> {
     destroy(): void;
 }
 export declare class SingleSelectionHandler<TItem = unknown> extends BaseSelectionHandler<TItem> {
+    readonly selectedItemEmitter: ValueEmitter<TItem | null>;
+    readonly selectedItem$: ValueEmitter<TItem | null>;
+    private readonly ownedSelectedItemEmitter;
+    constructor(config: SingleSelectionHandlerConfig<TItem>);
     protected selectIndex(index: number): void;
+    getSelectedItem(): TItem | null;
+    destroy(): void;
 }
 export declare class MultiSelectionHandler<TItem = unknown> extends BaseSelectionHandler<TItem> {
     protected selectIndex(index: number, event: SelectionEvent): void;
@@ -62,7 +80,8 @@ export declare class MultiSelectionHandler<TItem = unknown> extends BaseSelectio
     protected supportsDragSelection(): boolean;
     protected selectDragRange(startIndex: number, endIndex: number, event: MouseEvent): void;
 }
-export declare function createSelectionHandler<TItem>(config: SelectionHandlerConfig<TItem>): BaseSelectionHandler<TItem>;
+export declare function createSelectionHandler<TItem>(config: MultiSelectionHandlerConfig<TItem>): MultiSelectionHandler<TItem>;
+export declare function createSelectionHandler<TItem>(config: SingleSelectionHandlerConfig<TItem>): SingleSelectionHandler<TItem>;
 export declare function defaultItemKey<TItem>(item: TItem, index: number): unknown;
 export {};
 //# sourceMappingURL=selectionhandler.d.ts.map

package/dist/Components/data/selectionhandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectionhandler.d.ts","sourceRoot":"","sources":["../../../src/Components/data/selectionhandler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAA;AAEpD,MAAM,MAAM,aAAa,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;AAE1E,MAAM,WAAW,sBAAsB,CAAC,KAAK;IACzC,QAAQ,EAAE,MAAM,SAAS,KAAK,EAAE,CAAA;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;IAC7B,oBAAoB,CAAC,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,KAAK,cAAc,GAAG,UAAU,GAAG,aAAa,CAAA;AAEhD;;;;;GAKG;AACH,qBAAa,oBAAoB,CAAC,KAAK,GAAG,OAAO;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,SAAS,KAAK,EAAE,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;IACrC,QAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;IACpD,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAA;IAC9C,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAA;IAC1C,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,CAAK;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,SAAS,CAAC,WAAW,SAAI;IACzB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAO;IAC3C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,kBAAkB,CAA6C;IACvE,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAyB;gBAEvD,EACR,QAAQ,EACR,MAAuB,EACvB,oBAAoB,EACpB,KAAY,GACf,EAAE,sBAAsB,CAAC,KAAK,CAAC;IAkBhC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,IAAI;IAU9E,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,aAAa;IAqBrB,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAInE,SAAS,CAAC,qBAAqB,IAAI,OAAO;IAI1C,SAAS,CAAC,eAAe,CACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GACnB,IAAI;IAEP,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAEnE,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,SAAsB,GAAG,IAAI;IAK7E,gBAAgB,IAAI,KAAK,EAAE;IAI3B,uBAAuB,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;IAIhD,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,IAAI,IAAI;CAQlB;AAED,qBAAa,sBAAsB,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,oBAAoB,CAAC,KAAK,CAAC;IACpF,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,qBAAa,qBAAqB,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,oBAAoB,CAAC,KAAK,CAAC;IACnF,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAkCjE,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAInE,SAAS,CAAC,qBAAqB,IAAI,OAAO;IAI1C,SAAS,CAAC,eAAe,CACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,GAClB,IAAI;CAWV;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EACxC,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC,GACtC,oBAAoB,CAAC,KAAK,CAAC,CAI7B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CASzE"}
+{"version":3,"file":"selectionhandler.d.ts","sourceRoot":"","sources":["../../../src/Components/data/selectionhandler.ts"],"names":[],"mappings":"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"}

package/dist/Components/data/table/DataTable.d.ts

@@ -1,5 +1,4 @@
-import { Emitter } from '@sylwellsoftware/glue';
-import type { FetchLike, QueryHandlerLike, QuerySerializer, ReadableEmitter } from '@sylwellsoftware/glue';
+import type { ReadableEmitter } from '@sylwellsoftware/glue';
 import { Placeholder } from '../../Placeholder.js';
 import { Component } from '../../component.js';
 import type { ComponentProps, FrayChild } from '../../component.js';
@@ -9,28 +8,11 @@ import type { FilterModeValue } from '../../../util/filterMode.js';
 import type { BaseSelectionHandler, ItemKeyGetter } from '../selectionhandler.js';
 import { TableHeader } from './TableHeader.js';
 import type { TableColumn, TableRow } from './TableHeaderCell.js';
+import type { RestTableDataSourceOptions, TableDataSource, TableQueryInput } from './tableDataSource.js';
 import type { TableFilters, TableSort } from './tableQuery.js';
-export type TableQueryArguments = {
-    sort: TableSort | null;
-    filters: TableFilters;
-};
-export type TableQueryInput<TRow extends TableRow = TableRow> = ReadableEmitter<readonly TRow[] | undefined, unknown> & {
-    retry?: (cause?: unknown) => unknown;
-    dispose?: () => void;
-};
-export interface DataTableProps<TRow extends TableRow = TableRow> extends ComponentProps {
-    mode: 'local' | 'remote';
+interface DataTableCommonProps<TRow extends TableRow> extends ComponentProps {
     columns: readonly TableColumn<TRow>[];
-    data?: readonly TRow[] | ReadableEmitter<readonly TRow[], unknown>;
-    query?: TableQueryInput<TRow>;
-    queryHandler?: QueryHandlerLike<TableQueryArguments, readonly TRow[]>;
-    queryUrl?: string;
-    baseUrl?: string;
-    fetch?: FetchLike<readonly TRow[]>;
-    serializeQuery?: QuerySerializer<TableQueryArguments>;
-    selectedItemsEmitter?: ValueEmitter<TRow[]>;
     rowKey?: Extract<keyof TRow, string> | ItemKeyGetter<TRow>;
-    multiSelect?: boolean;
     caption?: FrayChild;
     emptyMessage?: FrayChild;
     placeholderCount?: number;
@@ -38,35 +20,59 @@ export interface DataTableProps<TRow extends TableRow = TableRow> extends Compon
     defaultSemanticState?: FilterModeValue;
     onFilterChange?: (filters: TableFilters, event: Event | null) => void;
 }
-/** Experimental table with explicit local and remote data modes. */
+type DataTableInputProps<TRow extends TableRow> = {
+    data?: readonly TRow[] | ReadableEmitter<readonly TRow[], unknown>;
+    dataSource?: never;
+    rest?: never;
+} | {
+    data?: never;
+    dataSource: TableDataSource<TRow>;
+    rest?: never;
+} | {
+    data?: never;
+    dataSource?: never;
+    rest: Omit<RestTableDataSourceOptions<TRow>, 'owner' | 'sortEmitter' | 'filtersEmitter'>;
+};
+type DataTableSelectionProps<TRow extends TableRow> = {
+    multiSelect?: false;
+    selectedItemEmitter?: ValueEmitter<TRow | null>;
+    selectedItemsEmitter?: never;
+} | {
+    multiSelect: true;
+    selectedItemsEmitter?: ValueEmitter<TRow[]>;
+    selectedItemEmitter?: never;
+};
+export type DataTableProps<TRow extends TableRow = TableRow> = DataTableCommonProps<TRow> & DataTableInputProps<TRow> & DataTableSelectionProps<TRow>;
+/** Accessible table over an explicit local, caller-query, or REST data source. */
 export declare class DataTable<TRow extends TableRow = TableRow> extends Component<DataTableProps<TRow>> {
     readonly columns: readonly TableColumn<TRow>[];
     readonly rowKey: ItemKeyGetter<TRow>;
-    readonly sortEmitter: Emitter<TableSort | null>;
-    readonly filtersEmitter: Emitter<TableFilters>;
+    readonly sortEmitter: ValueEmitter<TableSort | null>;
+    readonly filtersEmitter: ValueEmitter<TableFilters>;
     readonly selectedItemsEmitter: ValueEmitter<TRow[]>;
+    readonly selectedItemEmitter: ValueEmitter<TRow | null> | null;
     readonly selectionHandler: BaseSelectionHandler<TRow>;
     query: TableQueryInput<TRow> | null;
     private dataSource;
-    private readonly ownedSelectedItemsEmitter;
+    private readonly suppliedDataSource;
+    private readonly ownedSortEmitter;
+    private readonly ownedFiltersEmitter;
     private ownedDataSource;
-    private ownsQuery;
-    private readonly queryArgs;
     constructor(props: DataTableProps<TRow>);
     initialize(): void;
-    private createLocalQuery;
-    private createRemoteQuery;
-    private createRestHandler;
     render(): FrayChild;
     private renderRow;
     private renderPlaceholders;
     afterUpdate(dom: ChildNode | null): void;
     getSelectedRows(): TRow[];
     getSelectedRowsEmitter(): ValueEmitter<TRow[]>;
+    getSelectedRow(): TRow | null;
+    getSelectedRowEmitter(): ValueEmitter<TRow | null> | null;
     onDestroy(): void;
     static dependencies: (typeof Placeholder | typeof TableHeader)[];
     static hostName: string;
     static standaloneHostName: string;
     static css: string;
 }
+export {};
 //# sourceMappingURL=DataTable.d.ts.map

package/dist/Components/data/table/DataTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/DataTable.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/DataTable.tsx"],"names":[],"mappings":"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"}

package/dist/Components/data/table/FilterPanel.d.ts

@@ -21,12 +21,19 @@ export interface FilterPanelProps extends ComponentProps {
     label?: string;
     onChange?: (filters: Map<FilterValue, FilterModeValue>, event: Event | null) => void;
 }
-/** Experimental filter choices. Option data is always supplied by the caller. */
+/** Filter choices whose option data is always supplied by the caller. */
 export declare class FilterPanel extends Component<FilterPanelProps> {
     readonly optionsEmitter: ReadableEmitter<FilterOptions, unknown> | null;
+    private readonly optionStateEmitters;
+    private staleOptionValues;
+    private placementTimer;
     constructor(props?: FilterPanelProps);
     initialize(): void;
     render(): FrayChild;
+    afterUpdate(dom: ChildNode | null): void;
+    onDestroy(): void;
+    private optionEmitter;
+    private placeInsideViewport;
     static dependencies: (typeof Checkbox)[];
     static hostName: string;
     static standaloneHostName: string;

package/dist/Components/data/table/FilterPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterPanel.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/FilterPanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAC,SAAS,EAAM,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAuB,cAAc,EAAE,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAEvF,OAAO,EAAC,QAAQ,EAAC,MAAM,uCAAuC,CAAA;AAC9D,OAAO,KAAK,EAER,cAAc,EACjB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAA;AAEhE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,YAAY,CAAA;AAC1D,MAAM,MAAM,aAAa,GAAG,SAAS,iBAAiB,EAAE,CAAA;AACxD,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,eAAe,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;AACzF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;AAEvE,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,EAAE,CAAA;IAChF,WAAW,CAAC,EAAE,SAAS,cAAc,CAAC,eAAe,CAAC,EAAE,CAAA;IACxD,oBAAoB,CAAC,EAAE,eAAe,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAA;CACvF;AAED,iFAAiF;AACjF,qBAAa,WAAY,SAAQ,SAAS,CAAC,gBAAgB,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;gBAE3D,KAAK,GAAE,gBAAqB;IAKxC,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,SAAS;IAyDnB,MAAM,CAAC,YAAY,sBAAa;IAEhC,OAAgB,QAAQ,SAAiB;IACzC,OAAgB,kBAAkB,SAAiB;IAEnD,MAAM,CAAC,GAAG,SAiBT;CACJ"}
+{"version":3,"file":"FilterPanel.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/FilterPanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAC,SAAS,EAAM,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAuB,cAAc,EAAE,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAEvF,OAAO,EAAC,QAAQ,EAAC,MAAM,uCAAuC,CAAA;AAC9D,OAAO,KAAK,EAER,cAAc,EACjB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAA;AAEhE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,YAAY,CAAA;AAC1D,MAAM,MAAM,aAAa,GAAG,SAAS,iBAAiB,EAAE,CAAA;AACxD,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,eAAe,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;AACzF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;AAEvE,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,EAAE,CAAA;IAChF,WAAW,CAAC,EAAE,SAAS,cAAc,CAAC,eAAe,CAAC,EAAE,CAAA;IACxD,oBAAoB,CAAC,EAAE,eAAe,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAA;CACvF;AAED,yEAAyE;AACzE,qBAAa,WAAY,SAAQ,SAAS,CAAC,gBAAgB,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACvE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmD;IACvF,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,cAAc,CAA6C;gBAEvD,KAAK,GAAE,gBAAqB;IAKxC,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,SAAS;IA8DnB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAaxC,SAAS,IAAI,IAAI;IAOjB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,mBAAmB;IAsB3B,MAAM,CAAC,YAAY,sBAAa;IAEhC,OAAgB,QAAQ,SAAiB;IACzC,OAAgB,kBAAkB,SAAiB;IAEnD,MAAM,CAAC,GAAG,SAmBT;CACJ"}

package/dist/Components/data/table/TableHeaderCell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableHeaderCell.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/TableHeaderCell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uCAAuC,CAAA;AACzE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EACR,mBAAmB,EACnB,eAAe,EAElB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAA;AAE5D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE9C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACtC;AAED,MAAM,WAAW,WAAW,CAAC,IAAI,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,eAAe;IAClF,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAA;CACnD;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc,EAAE,eAAe;IACzE,WAAW,EAAE,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3C,cAAc,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;IAC1C,WAAW,CAAC,EAAE,SAAS,cAAc,CAAC,eAAe,CAAC,EAAE,CAAA;IACxD,oBAAoB,CAAC,EAAE,eAAe,CAAA;IACtC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAA;CACxE;AAED,qBAAa,eAAgB,SAAQ,SAAS,CAAC,oBAAoB,CAAC;IAChE,OAAO,CAAC,aAAa,CAAQ;IAE7B,UAAU,IAAI,IAAI;IAOlB,UAAU,IAAI,IAAI;IAYlB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM1C,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI;IAQ/D,MAAM,IAAI,SAAS;IA2DnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAQ7B;IAED,MAAM,CAAC,YAAY,yBAAgB;IAEnC,MAAM,CAAC,UAAU,0BAIhB;IAED,MAAM,CAAC,GAAG,SA+BT;CACJ"}
+{"version":3,"file":"TableHeaderCell.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/TableHeaderCell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,oBAAoB,CAAA;AACjE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uCAAuC,CAAA;AACzE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EACR,mBAAmB,EACnB,eAAe,EAElB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAA;AAE5D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE9C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACtC;AAED,MAAM,WAAW,WAAW,CAAC,IAAI,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,eAAe;IAClF,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAA;CACnD;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc,EAAE,eAAe;IACzE,WAAW,EAAE,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3C,cAAc,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;IAC1C,WAAW,CAAC,EAAE,SAAS,cAAc,CAAC,eAAe,CAAC,EAAE,CAAA;IACxD,oBAAoB,CAAC,EAAE,eAAe,CAAA;IACtC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAA;CACxE;AAED,qBAAa,eAAgB,SAAQ,SAAS,CAAC,oBAAoB,CAAC;IAChE,OAAO,CAAC,aAAa,CAAQ;IAE7B,UAAU,IAAI,IAAI;IAOlB,UAAU,IAAI,IAAI;IAYlB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM1C,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI;IAQ/D,MAAM,IAAI,SAAS;IA4DnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAQ7B;IAED,MAAM,CAAC,YAAY,yBAAgB;IAEnC,MAAM,CAAC,UAAU,0BAIhB;IAED,MAAM,CAAC,GAAG,SA+BT;CACJ"}

package/dist/Components/data/table/tableDataSource.d.ts

@@ -0,0 +1,49 @@
+import type { FetchLike, QueryHandlerLike, QuerySerializer, ReadableEmitter } from '@sylwellsoftware/glue';
+import type { ValueEmitter } from '../../controlUtils.js';
+import type { TableRow } from './TableHeaderCell.js';
+import type { TableFilters, TableSort } from './tableQuery.js';
+export type TableQueryArguments = {
+    sort: TableSort | null;
+    filters: TableFilters;
+};
+export type TableQueryInput<TRow extends TableRow = TableRow> = ReadableEmitter<readonly TRow[] | undefined, unknown> & {
+    retry?: (cause?: unknown) => unknown;
+    dispose?: () => void;
+};
+export interface TableDataSource<TRow extends TableRow = TableRow> {
+    readonly query: TableQueryInput<TRow>;
+    readonly sortEmitter: ValueEmitter<TableSort | null>;
+    readonly filtersEmitter: ValueEmitter<TableFilters>;
+    readonly retry?: (cause?: unknown) => unknown;
+    dispose(): void;
+}
+interface TableStateOptions {
+    sortEmitter?: ValueEmitter<TableSort | null>;
+    filtersEmitter?: ValueEmitter<TableFilters>;
+    owner?: unknown;
+}
+export interface LocalTableDataSourceOptions<TRow extends TableRow> extends TableStateOptions {
+    data: readonly TRow[] | ReadableEmitter<readonly TRow[], unknown>;
+}
+export interface QueryTableDataSourceOptions<TRow extends TableRow> extends TableStateOptions {
+    query: TableQueryInput<TRow>;
+}
+export interface HandlerTableDataSourceOptions<TRow extends TableRow> extends TableStateOptions {
+    handler: QueryHandlerLike<TableQueryArguments, readonly TRow[]>;
+}
+export interface RestTableDataSourceOptions<TRow extends TableRow> extends TableStateOptions {
+    url: string;
+    baseUrl?: string;
+    fetch?: FetchLike<readonly TRow[]>;
+    serializeQuery?: QuerySerializer<TableQueryArguments>;
+}
+/** Create a source that applies table state to local data. The caller owns it. */
+export declare function createLocalTableDataSource<TRow extends TableRow>(options: LocalTableDataSourceOptions<TRow>): TableDataSource<TRow>;
+/** Package a caller-owned query with the sort/filter emitters that drive it. */
+export declare function createQueryTableDataSource<TRow extends TableRow>(options: QueryTableDataSourceOptions<TRow>): TableDataSource<TRow>;
+/** Create a LiveQuery-backed source from an application-supplied handler. */
+export declare function createHandlerTableDataSource<TRow extends TableRow>(options: HandlerTableDataSourceOptions<TRow>): TableDataSource<TRow>;
+/** Create the convenient REST-backed source. The caller owns the result. */
+export declare function createRestTableDataSource<TRow extends TableRow>(options: RestTableDataSourceOptions<TRow>): TableDataSource<TRow>;
+export {};
+//# sourceMappingURL=tableDataSource.d.ts.map

package/dist/Components/data/table/tableDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableDataSource.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/tableDataSource.ts"],"names":[],"mappings":"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"}

package/dist/Components/data/table/tableQuery.d.ts

@@ -13,11 +13,15 @@ export interface TableQueryState {
     sort?: TableSort | null;
     filters?: TableFilters;
 }
+export declare const DefaultTableFilterEncoding: Readonly<Record<FilterModeValue, string>>;
 /**
- * Serialize Fray's experimental remote-table wire format.
+ * Serialize Fray's compact remote-table wire format.
  *
  * - `sort=field:asc|desc`
- * - repeated `filter=field:mode:JSON(value)` entries
+ * - repeated `filter=field:token:JSON(value)` entries
+ *
+ * Semantic modes deliberately remain separate from this compatibility wire
+ * encoding. Endpoints with another contract should inject their own serializer.
  */
 export declare function serializeTableQuery<TUrl extends UrlLike>(url: TUrl, { sort, filters }?: TableQueryState): TUrl;
 export declare function applyLocalTableState<TRow>(rows: readonly TRow[], sort: TableSort | null, filters: TableFilters): TRow[];

package/dist/Components/data/table/tableQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tableQuery.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/tableQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,uBAAuB,CAAA;AAGlD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAA;AAEhE,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,OAAO,IAAI,SAAS;IACtD,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,eAAe;CACxB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,YAAY,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,OAAO,EACpD,GAAG,EAAE,IAAI,EACT,EAAC,IAAW,EAAE,OAAY,EAAC,GAAE,eAAoB,GAClD,IAAI,CAkBN;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EACrC,IAAI,EAAE,SAAS,IAAI,EAAE,EACrB,IAAI,EAAE,SAAS,GAAG,IAAI,EACtB,OAAO,EAAE,YAAY,GACtB,IAAI,EAAE,CAQR;AAmBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAOnE"}
+{"version":3,"file":"tableQuery.d.ts","sourceRoot":"","sources":["../../../../src/Components/data/table/tableQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,uBAAuB,CAAA;AAGlD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAA;AAEhE,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,OAAO,IAAI,SAAS;IACtD,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,eAAe;CACxB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,YAAY,CAAA;CACzB;AAED,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAKhF,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,OAAO,EACpD,GAAG,EAAE,IAAI,EACT,EAAC,IAAW,EAAE,OAAY,EAAC,GAAE,eAAoB,GAClD,IAAI,CAkBN;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EACrC,IAAI,EAAE,SAAS,IAAI,EAAE,EACrB,IAAI,EAAE,SAAS,GAAG,IAAI,EACtB,OAAO,EAAE,YAAY,GACtB,IAAI,EAAE,CAQR;AAmBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAOnE"}

package/dist/Components/data/treeview/treeModel.d.ts

@@ -0,0 +1,23 @@
+import { DerivedEmitter } from '@sylwellsoftware/glue';
+import type { ReadableEmitter } from '@sylwellsoftware/glue';
+import type { Key } from '../../component.js';
+import type { ValueEmitter } from '../../controlUtils.js';
+import type { TreeNode } from './treeitem.js';
+/** Validate a tree snapshot and reject keys that are not globally unique. */
+export declare function assertTreeNodes<TValue>(value: unknown): asserts value is readonly TreeNode<TValue>[];
+export declare function findTreeNode<TValue>(nodes: readonly TreeNode<TValue>[], key: Key): TreeNode<TValue> | null;
+/**
+ * Project the current node for a key from complete root snapshots.
+ *
+ * The projection is read-only: application commands update the authoritative
+ * source, which causes the full tree and then this projection to recompute.
+ */
+export declare function deriveTreeNode<TValue>(nodes: ReadableEmitter<readonly TreeNode<TValue>[], unknown>, key: ReadableEmitter<Key | null, unknown>, owner?: unknown): DerivedEmitter<TreeNode<TValue> | null, readonly [
+    ReadableEmitter<readonly TreeNode<TValue>[], unknown>,
+    ReadableEmitter<Key | null, unknown>
+]>;
+/** Return a path-copied root snapshot, or the original array when no key exists. */
+export declare function updateTreeNode<TValue>(nodes: readonly TreeNode<TValue>[], key: Key, update: (node: TreeNode<TValue>) => TreeNode<TValue>): readonly TreeNode<TValue>[];
+/** Apply a path-copy update to an authoritative writable root emitter. */
+export declare function updateWritableTreeNode<TValue>(nodes: ValueEmitter<readonly TreeNode<TValue>[]>, key: Key, update: (node: TreeNode<TValue>) => TreeNode<TValue>, cause?: unknown): boolean;
+//# sourceMappingURL=treeModel.d.ts.map