@sectile/core 0.1.0

package/dist/internal/composites/menu.d.ts

@@ -0,0 +1,28 @@
+import type { Result, StableID } from '../../shared.js';
+import type { Tree } from '../../structures/tree.js';
+import { type CursorState } from '../state/cursor.js';
+export interface MenuState<ID extends StableID = StableID> {
+    readonly open: boolean;
+    readonly cursor: CursorState<ID>;
+    readonly openPath: readonly ID[];
+}
+export type MenuEvent<ID extends StableID = StableID> = 'open-popup' | 'close-popup' | 'next' | 'previous' | 'first' | 'last' | 'open-submenu' | 'close-submenu' | 'invoke' | 'escape' | {
+    readonly type: 'focus';
+    readonly id: ID;
+};
+export type MenuCommand<ID extends StableID = StableID> = {
+    readonly type: 'focus' | 'invoke';
+    readonly id: ID;
+} | {
+    readonly type: 'restore-focus';
+};
+export interface MenuUpdate<ID extends StableID = StableID> {
+    readonly state: MenuState<ID>;
+    readonly commands: readonly MenuCommand<ID>[];
+}
+export interface MenuPolicies<ID extends StableID = StableID> {
+    readonly disabled?: (id: ID) => boolean;
+}
+export declare function createMenuState<ID extends StableID>(tree: Tree<ID>, open?: boolean, current?: ID | null, openPath?: readonly ID[]): Result<MenuState<ID>>;
+export declare function applyMenuEvent<ID extends StableID>(tree: Tree<ID>, state: MenuState<ID>, event: MenuEvent<ID>, policies?: MenuPolicies<ID>): Result<MenuUpdate<ID>>;
+//# sourceMappingURL=menu.d.ts.map

package/dist/internal/composites/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/internal/composites/menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,WAAW,SAAS,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAA;CAAE;AACzJ,MAAM,MAAM,SAAS,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC;AACrO,MAAM,MAAM,WAAW,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AACtJ,MAAM,WAAW,UAAU,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAAI,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,CAAC,EAAE,CAAC,EAAE,CAAA;CAAE;AAC5I,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAA;CAAE;AAEzG,wBAAgB,eAAe,CAAC,EAAE,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,UAAQ,EAAE,OAAO,GAAE,EAAE,GAAG,IAAW,EAAE,QAAQ,GAAE,SAAS,EAAE,EAAO,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAOjK;AAED,wBAAgB,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAE,YAAY,CAAC,EAAE,CAAM,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAcvK"}

package/dist/internal/composites/menu.js

@@ -0,0 +1,72 @@
+import { fail, ok } from '../kernel/foundation.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+import { createCursorState } from '../state/cursor.js';
+export function createMenuState(tree, open = false, current = null, openPath = []) {
+    const normalized = tree.normalizeExpansion(openPath).ids;
+    if (normalized.length !== openPath.length || normalized.some((id, index) => id !== openPath[index]))
+        return fail('construction', 'invalid-menu-open-path', 'Menu open path must contain ordered branch identities.');
+    for (let index = 1; index < openPath.length; index += 1)
+        if (tree.parentOf(openPath[index]) !== openPath[index - 1])
+            return fail('construction', 'disconnected-menu-open-path', 'Menu open path must be one ancestor chain.');
+    if (!open && (current !== null || openPath.length > 0))
+        return fail('construction', 'closed-menu-has-active-state', 'Closed menu cannot own a cursor or submenu path.');
+    if (open && current !== null && !tree.visible(openPath).contains(current))
+        return fail('construction', 'menu-cursor-hidden', 'Menu cursor must be visible.');
+    return ok(Object.freeze({ open, cursor: createCursorState(current), openPath: Object.freeze([...openPath]) }));
+}
+export function applyMenuEvent(tree, state, event, policies = {}) {
+    const valid = createMenuState(tree, state.open, state.cursor.current, state.openPath);
+    if (!valid.ok)
+        return { ok: false, error: { ...valid.error, class: 'transition-rejection' } };
+    if (event === 'open-popup') {
+        if (state.open)
+            return createMachineUpdate(state);
+        const id = tree.roots.at(0);
+        return createMachineUpdate(menuState(true, id, []), id === null ? [] : [{ type: 'focus', id }]);
+    }
+    if (event === 'close-popup')
+        return createMachineUpdate(menuState(false, null, []), state.open ? [{ type: 'restore-focus' }] : []);
+    if (!state.open)
+        return fail('transition-rejection', 'menu-closed', 'Menu events require an open menu.');
+    if (typeof event === 'object') {
+        if (!tree.visible(state.openPath).contains(event.id))
+            return fail('transition-rejection', 'menu-target-hidden', 'Direct menu focus requires a visible item.');
+        return createMachineUpdate(menuState(true, event.id, pathFor(tree, event.id, state.openPath)), [{ type: 'focus', id: event.id }]);
+    }
+    const current = state.cursor.current;
+    if (event === 'escape')
+        return closeLevel(tree, state);
+    if (current === null) {
+        const id = tree.roots.at(event === 'last' ? tree.roots.size - 1 : 0);
+        return createMachineUpdate(menuState(true, id, []), id === null ? [] : [{ type: 'focus', id }]);
+    }
+    if (event === 'next' || event === 'previous' || event === 'first' || event === 'last') {
+        const siblings = tree.parentOf(current) === null ? tree.roots : tree.childrenOf(tree.parentOf(current));
+        if (siblings === null || siblings.size === 0)
+            return createMachineUpdate(state);
+        const index = siblings.indexOf(current) ?? 0;
+        const target = event === 'first' ? 0 : event === 'last' ? siblings.size - 1 : (index + (event === 'next' ? 1 : -1) + siblings.size) % siblings.size;
+        const id = siblings.at(target);
+        return id === null ? createMachineUpdate(state) : createMachineUpdate(menuState(true, id, state.openPath), [{ type: 'focus', id }]);
+    }
+    if (event === 'open-submenu') {
+        if (policies.disabled?.(current) === true)
+            return createMachineUpdate(state);
+        const child = tree.childrenOf(current)?.at(0) ?? null;
+        if (child === null)
+            return createMachineUpdate(state);
+        const path = [...(tree.ancestorsOf(current) ?? [])].reverse().filter((id) => tree.isLeaf(id) === false);
+        path.push(current);
+        return createMachineUpdate(menuState(true, child, path), [{ type: 'focus', id: child }]);
+    }
+    if (event === 'close-submenu')
+        return closeLevel(tree, state);
+    if (tree.isLeaf(current) !== true || policies.disabled?.(current) === true)
+        return createMachineUpdate(state);
+    return createMachineUpdate(menuState(false, null, []), [{ type: 'invoke', id: current }, { type: 'restore-focus' }]);
+}
+function closeLevel(tree, state) { const current = state.cursor.current; const parent = current === null ? null : tree.parentOf(current); if (parent === null)
+    return createMachineUpdate(menuState(false, null, []), [{ type: 'restore-focus' }]); const path = state.openPath.filter((id) => id !== parent && !(tree.ancestorsOf(id) ?? []).includes(parent)); return createMachineUpdate(menuState(true, parent, path), [{ type: 'focus', id: parent }]); }
+function pathFor(tree, id, currentPath) { const ancestors = new Set(tree.ancestorsOf(id) ?? []); return currentPath.filter((branch) => ancestors.has(branch)); }
+function menuState(open, current, openPath) { return Object.freeze({ open, cursor: createCursorState(current), openPath: Object.freeze([...openPath]) }); }
+//# sourceMappingURL=menu.js.map

package/dist/internal/composites/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../src/internal/composites/menu.ts"],"names":[],"mappings":"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"}

package/dist/internal/composites/popup.d.ts

@@ -0,0 +1,20 @@
+import type { Result } from '../../shared.js';
+export interface PopupState {
+    readonly open: boolean;
+}
+export type PopupEvent = 'open' | 'close' | 'toggle' | {
+    readonly type: 'set-open';
+    readonly open: boolean;
+};
+export type PopupCommand = {
+    readonly type: 'popup-opened';
+} | {
+    readonly type: 'popup-closed';
+};
+export interface PopupUpdate {
+    readonly state: PopupState;
+    readonly commands: readonly PopupCommand[];
+}
+export declare function createPopupState(open?: boolean): Result<PopupState>;
+export declare function applyPopupEvent(state: PopupState, event: PopupEvent): Result<PopupUpdate>;
+//# sourceMappingURL=popup.d.ts.map

package/dist/internal/composites/popup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../src/internal/composites/popup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAI,EAAC,MAAM,EAAC,MAAI,iBAAiB,CAAC;AACzC,MAAM,WAAW,UAAU;IAAC,QAAQ,CAAC,IAAI,EAAC,OAAO,CAAA;CAAC;AAAA,MAAM,MAAM,UAAU,GAAC,MAAM,GAAC,OAAO,GAAC,QAAQ,GAAC;IAAC,QAAQ,CAAC,IAAI,EAAC,UAAU,CAAC;IAAA,QAAQ,CAAC,IAAI,EAAC,OAAO,CAAA;CAAC,CAAC;AAAA,MAAM,MAAM,YAAY,GAAC;IAAC,QAAQ,CAAC,IAAI,EAAC,cAAc,CAAA;CAAC,GAAC;IAAC,QAAQ,CAAC,IAAI,EAAC,cAAc,CAAA;CAAC,CAAC;AAAA,MAAM,WAAW,WAAW;IAAC,QAAQ,CAAC,KAAK,EAAC,UAAU,CAAC;IAAA,QAAQ,CAAC,QAAQ,EAAC,SAAS,YAAY,EAAE,CAAA;CAAC;AAC1U,wBAAgB,gBAAgB,CAAC,IAAI,UAAM,GAAE,MAAM,CAAC,UAAU,CAAC,CAAyI;AACxM,wBAAgB,eAAe,CAAC,KAAK,EAAC,UAAU,EAAC,KAAK,EAAC,UAAU,GAAE,MAAM,CAAC,WAAW,CAAC,CAAwjB"}

package/dist/internal/composites/popup.js

@@ -0,0 +1,8 @@
+import { fail, ok } from '../kernel/foundation.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+export function createPopupState(open = false) { return typeof open === 'boolean' ? ok(Object.freeze({ open })) : fail('construction', 'invalid-popup-state', 'Popup open state must be boolean.'); }
+export function applyPopupEvent(state, event) { if (typeof state.open !== 'boolean')
+    return fail('transition-rejection', 'invalid-popup-state', 'Popup open state must be boolean.'); const next = typeof event === 'object' ? event.type === 'set-open' && typeof event.open === 'boolean' ? event.open : null : event === 'toggle' ? !state.open : event === 'open' ? true : event === 'close' ? false : null; if (next === null)
+    return fail('transition-rejection', 'invalid-popup-event', 'Popup event is not accepted.'); if (next === state.open)
+    return createMachineUpdate(state); return createMachineUpdate(Object.freeze({ open: next }), [{ type: next ? 'popup-opened' : 'popup-closed' }]); }
+//# sourceMappingURL=popup.js.map

package/dist/internal/composites/popup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup.js","sourceRoot":"","sources":["../../../src/internal/composites/popup.ts"],"names":[],"mappings":"AAAyC,OAAM,EAAC,IAAI,EAAC,EAAE,EAAC,MAAI,yBAAyB,CAAC;AAAA,OAAM,EAAC,mBAAmB,EAAC,MAAI,sBAAsB,CAAC;AAE5I,MAAM,UAAU,gBAAgB,CAAC,IAAI,GAAC,KAAK,IAAqB,OAAO,OAAO,IAAI,KAAG,SAAS,CAAA,CAAC,CAAA,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,CAAA,CAAC,CAAA,IAAI,CAAC,cAAc,EAAC,qBAAqB,EAAC,mCAAmC,CAAC,CAAA,CAAA,CAAC;AACxM,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAC,KAAgB,IAAsB,IAAG,OAAO,KAAK,CAAC,IAAI,KAAG,SAAS;IAAC,OAAO,IAAI,CAAC,sBAAsB,EAAC,qBAAqB,EAAC,mCAAmC,CAAC,CAAC,CAAA,MAAM,IAAI,GAAC,OAAO,KAAK,KAAG,QAAQ,CAAA,CAAC,CAAA,KAAK,CAAC,IAAI,KAAG,UAAU,IAAE,OAAO,KAAK,CAAC,IAAI,KAAG,SAAS,CAAA,CAAC,CAAA,KAAK,CAAC,IAAI,CAAA,CAAC,CAAA,IAAI,CAAA,CAAC,CAAA,KAAK,KAAG,QAAQ,CAAA,CAAC,CAAA,CAAC,KAAK,CAAC,IAAI,CAAA,CAAC,CAAA,KAAK,KAAG,MAAM,CAAA,CAAC,CAAA,IAAI,CAAA,CAAC,CAAA,KAAK,KAAG,OAAO,CAAA,CAAC,CAAA,KAAK,CAAA,CAAC,CAAA,IAAI,CAAC,CAAA,IAAG,IAAI,KAAG,IAAI;IAAC,OAAO,IAAI,CAAC,sBAAsB,EAAC,qBAAqB,EAAC,8BAA8B,CAAC,CAAC,CAAA,IAAG,IAAI,KAAG,KAAK,CAAC,IAAI;IAAC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAA,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,IAAI,EAAC,CAAC,EAAC,CAAC,EAAC,IAAI,EAAC,IAAI,CAAA,CAAC,CAAA,cAAc,CAAA,CAAC,CAAA,cAAc,EAAC,CAAC,CAAC,CAAA,CAAA,CAAC"}

package/dist/internal/composites/slider.d.ts

@@ -0,0 +1,20 @@
+import type { Result } from '../../shared.js';
+import type { QuantizedRange } from '../../structures/range.js';
+export type SliderEvent = 'increment' | 'decrement' | 'page-up' | 'page-down' | 'home' | 'end' | {
+    readonly type: 'set-tick';
+    readonly tick: number;
+};
+export interface SliderState {
+    readonly tick: number;
+}
+export interface SliderCommand {
+    readonly type: 'announce-tick';
+    readonly tick: number;
+}
+export interface SliderUpdate {
+    readonly state: SliderState;
+    readonly commands: readonly SliderCommand[];
+}
+export declare function createSliderState(range: QuantizedRange, tick?: number): Result<SliderState>;
+export declare function applySliderEvent(range: QuantizedRange, state: SliderState, event: SliderEvent, page?: number): Result<SliderUpdate>;
+//# sourceMappingURL=slider.d.ts.map

package/dist/internal/composites/slider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../../src/internal/composites/slider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,WAAW,GACX,SAAS,GACT,WAAW,GACX,MAAM,GACN,KAAK,GACL;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,IAAI,SAAI,GACP,MAAM,CAAC,WAAW,CAAC,CAUrB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,IAAI,SAAI,GACP,MAAM,CAAC,YAAY,CAAC,CAgEtB"}

package/dist/internal/composites/slider.js

@@ -0,0 +1,69 @@
+import { fail, ok } from '../kernel/foundation.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+export function createSliderState(range, tick = 0) {
+    if (!isSliderTick(range, tick)) {
+        return fail('construction', 'slider-tick-outside-range', 'Slider tick must be a safe integer inside the quantized range.', { tick, count: range.count });
+    }
+    return ok(sliderState(tick));
+}
+export function applySliderEvent(range, state, event, page = 2) {
+    if (!isSliderTick(range, state.tick)) {
+        return fail('transition-rejection', 'slider-tick-outside-range', 'Slider tick must be a safe integer inside the quantized range.', { tick: state.tick, count: range.count });
+    }
+    if (!isSliderEvent(event)) {
+        return fail('transition-rejection', 'invalid-slider-event', 'Slider event must be increment, decrement, page-up, page-down, home, or end.', { event });
+    }
+    if (!Number.isSafeInteger(page) || page < 1) {
+        return fail('transition-rejection', 'invalid-slider-page', 'Slider page must be a positive safe integer.', { page });
+    }
+    if (typeof event === 'object') {
+        if (!isSliderTick(range, event.tick)) {
+            return fail('transition-rejection', 'slider-tick-outside-range', 'Direct slider input requires a tick inside the quantized range.', { tick: event.tick, count: range.count });
+        }
+        if (event.tick === state.tick)
+            return createMachineUpdate(state);
+        return createMachineUpdate(sliderState(event.tick), [{ type: 'announce-tick', tick: event.tick }]);
+    }
+    let tick;
+    switch (event) {
+        case 'increment':
+            tick = state.tick === range.count ? range.count : state.tick + 1;
+            break;
+        case 'decrement':
+            tick = state.tick === 0 ? 0 : state.tick - 1;
+            break;
+        case 'page-up':
+            tick = page >= range.count - state.tick ? range.count : state.tick + page;
+            break;
+        case 'page-down':
+            tick = page >= state.tick ? 0 : state.tick - page;
+            break;
+        case 'home':
+            tick = 0;
+            break;
+        case 'end':
+            tick = range.count;
+            break;
+    }
+    if (tick === state.tick)
+        return createMachineUpdate(state);
+    const next = sliderState(tick);
+    return createMachineUpdate(next, [{ type: 'announce-tick', tick }]);
+}
+function isSliderTick(range, tick) {
+    return Number.isSafeInteger(tick) && tick >= 0 && tick <= range.count;
+}
+function isSliderEvent(value) {
+    return typeof value === 'string' ? (value === 'increment' ||
+        value === 'decrement' ||
+        value === 'page-up' ||
+        value === 'page-down' ||
+        value === 'home' ||
+        value === 'end') : typeof value === 'object' && value !== null
+        && 'type' in value && value.type === 'set-tick'
+        && 'tick' in value && typeof value.tick === 'number';
+}
+function sliderState(tick) {
+    return Object.freeze({ tick });
+}
+//# sourceMappingURL=slider.js.map

package/dist/internal/composites/slider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.js","sourceRoot":"","sources":["../../../src/internal/composites/slider.ts"],"names":[],"mappings":"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"}

package/dist/internal/composites/tree-grid.d.ts

@@ -0,0 +1,65 @@
+import type { AxisBoundaryPolicy, GridDirection, Result, StableID } from '../../shared.js';
+import type { Grid } from '../../structures/grid.js';
+import type { Tree } from '../../structures/tree.js';
+import { type CursorState } from '../state/cursor.js';
+import { type ExpansionState } from '../state/expansion.js';
+import { type SelectionSnapshotInput, type SelectionState } from '../state/selection.js';
+export type TreeGridEditMode = 'navigation' | 'editing';
+export type TreeGridEvent<RowID extends StableID = StableID, CellID extends StableID = StableID> = GridDirection | 'expand' | 'collapse' | 'select' | 'start-edit' | 'commit-edit' | 'cancel-edit' | {
+    readonly type: 'focus';
+    readonly id: CellID;
+} | {
+    readonly type: 'select';
+    readonly id: CellID;
+} | {
+    readonly type: 'start-edit';
+    readonly id: CellID;
+} | {
+    readonly type: 'set-expanded';
+    readonly id: RowID;
+    readonly open: boolean;
+};
+export type TreeGridCommand<CellID extends StableID = StableID> = {
+    readonly type: 'focus';
+    readonly id: CellID;
+} | {
+    readonly type: 'begin-edit';
+    readonly id: CellID;
+} | {
+    readonly type: 'commit-edit';
+    readonly id: CellID;
+} | {
+    readonly type: 'cancel-edit';
+    readonly id: CellID;
+};
+export interface TreeGridModel<RowID extends StableID = StableID, CellID extends StableID = StableID> {
+    readonly tree: Tree<RowID>;
+    readonly grid: Grid<CellID>;
+    readonly rowIDs: readonly RowID[];
+    rowIndexOf(id: RowID): number | null;
+    rowOfCell(id: CellID): RowID | null;
+}
+export interface TreeGridState<RowID extends StableID = StableID, CellID extends StableID = StableID> {
+    readonly expansion: ExpansionState<RowID>;
+    readonly cursor: CursorState<CellID>;
+    readonly selection: SelectionState<CellID>;
+    readonly editMode: TreeGridEditMode;
+}
+export interface TreeGridStateInput<RowID extends StableID = StableID, CellID extends StableID = StableID> extends SelectionSnapshotInput<CellID> {
+    readonly expanded?: Iterable<RowID>;
+    readonly current?: CellID | null;
+    readonly editMode?: TreeGridEditMode;
+}
+export interface TreeGridPolicies<CellID extends StableID = StableID> {
+    readonly eligible?: (id: CellID) => boolean;
+    readonly boundary?: AxisBoundaryPolicy;
+    readonly maxScan?: number;
+}
+export interface TreeGridUpdate<RowID extends StableID = StableID, CellID extends StableID = StableID> {
+    readonly state: TreeGridState<RowID, CellID>;
+    readonly commands: readonly TreeGridCommand<CellID>[];
+}
+export declare function createTreeGridModel<RowID extends StableID, CellID extends StableID>(tree: Tree<RowID>, grid: Grid<CellID>, rowIDs: readonly RowID[]): Result<TreeGridModel<RowID, CellID>>;
+export declare function createTreeGridState<RowID extends StableID, CellID extends StableID>(model: TreeGridModel<RowID, CellID>, input?: TreeGridStateInput<RowID, CellID>): Result<TreeGridState<RowID, CellID>>;
+export declare function applyTreeGridEvent<RowID extends StableID, CellID extends StableID>(model: TreeGridModel<RowID, CellID>, state: TreeGridState<RowID, CellID>, event: TreeGridEvent<RowID, CellID>, policies?: TreeGridPolicies<CellID>): Result<TreeGridUpdate<RowID, CellID>>;
+//# sourceMappingURL=tree-grid.d.ts.map

package/dist/internal/composites/tree-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-grid.d.ts","sourceRoot":"","sources":["../../../src/internal/composites/tree-grid.ts"],"names":[],"mappings":"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"}

package/dist/internal/composites/tree-grid.js

@@ -0,0 +1,274 @@
+import { fail, freezeArray, ok } from '../kernel/foundation.js';
+import { findEligibleFromEdge, IndexedSequence } from '../kernel/indexed-sequence.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+import { createCursorState } from '../state/cursor.js';
+import { createExpansionState, setExpansionOpen, } from '../state/expansion.js';
+import { createSelectionState, selectOne, } from '../state/selection.js';
+class IndexedTreeGridModel {
+    tree;
+    grid;
+    rowIDs;
+    #rowIndices;
+    constructor(tree, grid, rowIDs) {
+        this.tree = tree;
+        this.grid = grid;
+        this.rowIDs = freezeArray(rowIDs);
+        this.#rowIndices = new Map(this.rowIDs.map((id, index) => [id, index]));
+        Object.freeze(this);
+    }
+    rowIndexOf(id) {
+        return this.#rowIndices.get(id) ?? null;
+    }
+    rowOfCell(id) {
+        const position = this.grid.positionOf(id);
+        return position === null ? null : (this.rowIDs[position.row] ?? null);
+    }
+}
+export function createTreeGridModel(tree, grid, rowIDs) {
+    if (rowIDs.length !== grid.rowCount || rowIDs.length !== tree.size) {
+        return fail('construction', 'tree-grid-row-count-mismatch', 'Tree-grid must map every tree row to exactly one grid row.', { mappedRows: rowIDs.length, gridRows: grid.rowCount, treeRows: tree.size });
+    }
+    const seen = new Set();
+    for (let index = 0; index < rowIDs.length; index += 1) {
+        const id = rowIDs[index];
+        if (id === undefined || !tree.has(id)) {
+            return fail('construction', 'tree-grid-row-outside-tree', 'Every mapped tree-grid row must exist in the tree.', { index, id });
+        }
+        if (seen.has(id)) {
+            return fail('construction', 'duplicate-tree-grid-row', 'Each tree row must map to one grid row.', { index, id });
+        }
+        seen.add(id);
+    }
+    return ok(new IndexedTreeGridModel(tree, grid, rowIDs));
+}
+export function createTreeGridState(model, input = {}) {
+    const expansion = createExpansionState(model.tree, input.expanded ?? []);
+    const visible = visibleCells(model, expansion);
+    const current = input.current ?? null;
+    if (current !== null && !visible.contains(current)) {
+        return fail('construction', 'tree-grid-cursor-hidden', 'Tree-grid cursor must belong to a visible row.', { current });
+    }
+    const selection = createSelectionState(allCells(model), 'single', input);
+    if (!selection.ok)
+        return selection;
+    const editMode = input.editMode ?? 'navigation';
+    if (!isTreeGridEditMode(editMode)) {
+        return fail('construction', 'invalid-tree-grid-edit-mode', 'Tree-grid edit mode must be navigation or editing.', { editMode });
+    }
+    if (editMode === 'editing' && current === null) {
+        return fail('construction', 'tree-grid-edit-without-cursor', 'Tree-grid editing requires a current cell.');
+    }
+    return ok(treeGridState(expansion, createCursorState(current), selection.value, editMode));
+}
+export function applyTreeGridEvent(model, state, event, policies = {}) {
+    const expansion = createExpansionState(model.tree, state.expansion.ids);
+    const visible = visibleCells(model, expansion);
+    const domain = allCells(model);
+    const stateError = validateTreeGridState(visible, domain, state);
+    if (stateError !== null)
+        return { ok: false, error: stateError };
+    if (!isTreeGridEvent(event)) {
+        return fail('transition-rejection', 'invalid-tree-grid-event', 'Tree-grid event is not part of the accepted event vocabulary.', { event });
+    }
+    const boundary = policies.boundary ?? 'stop';
+    if (boundary !== 'stop' && boundary !== 'wrap-axis') {
+        return fail('transition-rejection', 'invalid-tree-grid-boundary', 'Tree-grid boundary must be stop or wrap-axis.', { boundary });
+    }
+    if (policies.eligible !== undefined && typeof policies.eligible !== 'function') {
+        return fail('transition-rejection', 'invalid-eligibility-policy', 'Tree-grid eligibility policy must be a function.');
+    }
+    const normalized = sameExpansion(expansion, state.expansion)
+        ? state
+        : treeGridState(expansion, state.cursor, state.selection, state.editMode);
+    const current = state.cursor.current;
+    if (typeof event === 'object') {
+        if (event.type === 'set-expanded') {
+            if (!model.tree.has(event.id)) {
+                return fail('transition-rejection', 'tree-grid-row-outside-tree', 'Direct tree-grid expansion requires a row in the tree.', { id: event.id });
+            }
+            const nextExpansion = setExpansionOpen(expansion, event.id, event.open, model.tree);
+            const nextVisible = visibleCells(model, nextExpansion);
+            const rowIndex = model.rowIndexOf(event.id);
+            const target = current === null || nextVisible.contains(current)
+                ? current
+                : (rowIndex === null ? null : model.grid.row(rowIndex)?.at(0) ?? null);
+            return createMachineUpdate(treeGridState(nextExpansion, createCursorState(target), state.selection, 'navigation'), target === null || target === current ? [] : [{ type: 'focus', id: target }]);
+        }
+        if (!visible.contains(event.id) || policies.eligible?.(event.id) === false) {
+            return fail('transition-rejection', 'tree-grid-target-unavailable', 'Direct tree-grid cell events require an eligible visible cell.', { id: event.id });
+        }
+        const cursor = createCursorState(event.id);
+        if (event.type === 'focus') {
+            return createMachineUpdate(treeGridState(expansion, cursor, state.selection, 'navigation'), [{ type: 'focus', id: event.id }]);
+        }
+        const selection = selectOne(state.selection, event.id, domain);
+        if (event.type === 'select') {
+            return createMachineUpdate(treeGridState(expansion, cursor, selection, 'navigation'), [{ type: 'focus', id: event.id }]);
+        }
+        return createMachineUpdate(treeGridState(expansion, cursor, selection, 'editing'), [{ type: 'focus', id: event.id }, { type: 'begin-edit', id: event.id }]);
+    }
+    if (event === 'commit-edit' || event === 'cancel-edit') {
+        if (state.editMode !== 'editing' || current === null) {
+            return fail('transition-rejection', 'tree-grid-not-editing', 'Tree-grid can only finish an active edit.');
+        }
+        return createMachineUpdate(treeGridState(expansion, state.cursor, state.selection, 'navigation'), [{ type: event, id: current }]);
+    }
+    if (state.editMode === 'editing') {
+        if (event === 'start-edit')
+            return createMachineUpdate(normalized);
+        return fail('transition-rejection', 'tree-grid-edit-active', 'Tree-grid navigation is suspended while a cell edit is active.', { event });
+    }
+    if (event === 'start-edit') {
+        if (current === null) {
+            return fail('transition-rejection', 'no-cursor', 'Tree-grid editing requires a cursor.');
+        }
+        return createMachineUpdate(treeGridState(expansion, state.cursor, state.selection, 'editing'), [{ type: 'begin-edit', id: current }]);
+    }
+    if (event === 'select') {
+        if (current === null) {
+            return fail('transition-rejection', 'no-cursor', 'Tree-grid selection requires a cursor.');
+        }
+        const selection = selectOne(state.selection, current, domain);
+        return createMachineUpdate(selection === state.selection
+            ? normalized
+            : treeGridState(expansion, state.cursor, selection, 'navigation'));
+    }
+    if (event === 'expand' || event === 'collapse') {
+        if (current === null)
+            return createMachineUpdate(normalized);
+        const row = model.rowOfCell(current);
+        if (row === null)
+            return createMachineUpdate(normalized);
+        const nextExpansion = setExpansionOpen(expansion, row, event === 'expand', model.tree);
+        return createMachineUpdate(nextExpansion === expansion
+            ? normalized
+            : treeGridState(nextExpansion, state.cursor, state.selection, 'navigation'));
+    }
+    const eligible = policies.eligible ?? (() => true);
+    let target;
+    if (current === null) {
+        const initial = findEligibleFromEdge(visible, event === 'right' || event === 'down' ? 1 : -1, {
+            eligible,
+            ...(policies.maxScan === undefined ? {} : { maxScan: policies.maxScan }),
+        });
+        if (!initial.ok)
+            return initial;
+        target = initial.value;
+    }
+    else {
+        const visibleRows = new Set(model.tree.visible(expansion).ids);
+        const movement = model.grid.move(current, event, boundary, {
+            eligible: (id) => {
+                const row = model.rowOfCell(id);
+                return row !== null && visibleRows.has(row) && eligible(id);
+            },
+            ...(policies.maxScan === undefined ? {} : { maxScan: policies.maxScan }),
+        });
+        if (movement.kind === 'resource-rejected')
+            return { ok: false, error: movement.error };
+        target = movement.kind === 'found' ? movement.id : null;
+    }
+    if (target === null)
+        return createMachineUpdate(normalized);
+    return createMachineUpdate(treeGridState(expansion, createCursorState(target), state.selection, 'navigation'), [{ type: 'focus', id: target }]);
+}
+function allCells(model) {
+    return cellsWhere(model, () => true);
+}
+function visibleCells(model, expansion) {
+    const visibleRows = new Set(model.tree.visible(expansion).ids);
+    return cellsWhere(model, (row) => visibleRows.has(row));
+}
+function cellsWhere(model, includeRow) {
+    const ids = [];
+    for (let rowIndex = 0; rowIndex < model.grid.rowCount; rowIndex += 1) {
+        const row = model.rowIDs[rowIndex];
+        if (row === undefined || !includeRow(row))
+            continue;
+        for (let column = 0; column < model.grid.columnCount; column += 1) {
+            const id = model.grid.cellAt(rowIndex, column);
+            if (id !== null)
+                ids.push(id);
+        }
+    }
+    return new IndexedSequence(ids);
+}
+function validateTreeGridState(visible, domain, state) {
+    if (!isTreeGridEditMode(state.editMode)) {
+        return {
+            class: 'transition-rejection',
+            code: 'invalid-tree-grid-edit-mode',
+            message: 'Tree-grid edit mode must be navigation or editing.',
+        };
+    }
+    if (state.cursor.current !== null && !visible.contains(state.cursor.current)) {
+        return {
+            class: 'transition-rejection',
+            code: 'tree-grid-cursor-hidden',
+            message: 'Tree-grid cursor must remain on a visible row.',
+            details: { current: state.cursor.current },
+        };
+    }
+    if (state.editMode === 'editing' && state.cursor.current === null) {
+        return {
+            class: 'transition-rejection',
+            code: 'tree-grid-edit-without-cursor',
+            message: 'Tree-grid editing requires a current cell.',
+        };
+    }
+    if (state.selection.size > 1 || state.selection.selected.length !== state.selection.size) {
+        return {
+            class: 'transition-rejection',
+            code: 'invalid-tree-grid-selection',
+            message: 'Tree-grid selection must contain at most one identity.',
+        };
+    }
+    for (const id of state.selection.selected) {
+        if (!domain.contains(id) || !state.selection.has(id)) {
+            return {
+                class: 'transition-rejection',
+                code: 'tree-grid-selection-outside-grid',
+                message: 'Tree-grid selection must agree with the cell grid.',
+                details: { id },
+            };
+        }
+    }
+    if (state.selection.anchor !== null && !domain.contains(state.selection.anchor)) {
+        return {
+            class: 'transition-rejection',
+            code: 'tree-grid-anchor-outside-grid',
+            message: 'Tree-grid selection anchor must exist in the cell grid.',
+            details: { anchor: state.selection.anchor },
+        };
+    }
+    return null;
+}
+function treeGridState(expansion, cursor, selection, editMode) {
+    return Object.freeze({ expansion, cursor, selection, editMode });
+}
+function sameExpansion(left, right) {
+    return left.ids.length === right.ids.length && left.ids.every((id, index) => id === right.ids[index]);
+}
+function isTreeGridEditMode(value) {
+    return value === 'navigation' || value === 'editing';
+}
+function isTreeGridEvent(value) {
+    if (typeof value === 'string')
+        return [
+            'left',
+            'right',
+            'up',
+            'down',
+            'expand',
+            'collapse',
+            'select',
+            'start-edit',
+            'commit-edit',
+            'cancel-edit',
+        ].includes(value);
+    return typeof value === 'object' && value !== null
+        && 'type' in value && 'id' in value && typeof value.id === 'string'
+        && (value.type === 'focus' || value.type === 'select' || value.type === 'start-edit'
+            || (value.type === 'set-expanded' && 'open' in value && typeof value.open === 'boolean'));
+}
+//# sourceMappingURL=tree-grid.js.map