@sectile/core 0.2.0 → 0.2.1

package/dist/internal/composites/listbox.js

@@ -0,0 +1,251 @@
+import { unwrap } from '../../result.js';
+import { createCursorState } from '../state/cursor.js';
+import { fail, ok } from '../kernel/foundation.js';
+import { findEligibleFromEdge } from '../kernel/indexed-sequence.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+import { clearSelection, createSelectionState, selectOne, toggleMultipleSelection, } from '../state/selection.js';
+export function createListboxState(domain, input = {}, selectionMode = 'multiple') {
+    return unwrap(tryCreateListboxState(domain, input, selectionMode));
+}
+export function tryCreateListboxState(domain, input = {}, selectionMode = 'multiple') {
+    const current = input.current ?? null;
+    if (current !== null && !domain.contains(current)) {
+        return fail('construction', 'listbox-cursor-outside-domain', 'Listbox cursor must exist in the sequence domain.', { current });
+    }
+    const selection = createSelectionState(domain, selectionMode, input);
+    if (!selection.ok)
+        return selection;
+    return ok(listboxState(createCursorState(current), selection.value));
+}
+export function applyListboxEvent(domain, state, event, policies = {}) {
+    const stateError = validateListboxState(domain, state);
+    if (stateError !== null)
+        return { ok: false, error: stateError };
+    if (!isListboxEvent(event)) {
+        return fail('transition-rejection', 'invalid-listbox-event', 'Listbox event must be next, previous, first, last, toggle, activate, or clear.', { event });
+    }
+    const boundary = policies.boundary ?? 'stop';
+    if (boundary !== 'stop' && boundary !== 'wrap') {
+        return fail('transition-rejection', 'invalid-listbox-boundary', 'Listbox boundary must be stop or wrap.', { boundary });
+    }
+    const selectionFollowsFocus = policies.selectionFollowsFocus ?? false;
+    if (typeof selectionFollowsFocus !== 'boolean') {
+        return fail('transition-rejection', 'invalid-selection-follows-focus', 'selectionFollowsFocus must be boolean.', { selectionFollowsFocus });
+    }
+    const deselectable = policies.deselectable ?? false;
+    if (typeof deselectable !== 'boolean') {
+        return fail('transition-rejection', 'invalid-deselectable-policy', 'deselectable must be boolean.', { deselectable });
+    }
+    if (policies.eligible !== undefined && typeof policies.eligible !== 'function') {
+        return fail('transition-rejection', 'invalid-eligibility-policy', 'Listbox eligibility policy must be a function.');
+    }
+    const selectionMode = policies.selectionMode ?? 'multiple';
+    if (selectionMode !== 'single' && selectionMode !== 'multiple') {
+        return fail('transition-rejection', 'invalid-selection-mode', 'Listbox selection mode must be single or multiple.', { selectionMode });
+    }
+    if (selectionMode === 'single' && state.selection.size > 1) {
+        return fail('transition-rejection', 'invalid-selection-cardinality', 'Single-selection listbox state permits at most one selected identity.', { selectedCount: state.selection.size });
+    }
+    if (typeof event === 'object') {
+        if (!domain.contains(event.id) || policies.eligible?.(event.id) === false) {
+            return fail('transition-rejection', 'listbox-target-unavailable', 'Direct listbox events require an eligible identity in the domain.', { id: event.id });
+        }
+        if (event.type === 'focus') {
+            const selection = selectionFollowsFocus
+                ? selectOne(state.selection, event.id, domain)
+                : state.selection;
+            return createMachineUpdate(listboxState(createCursorState(event.id), selection), [{ type: 'focus', id: event.id }]);
+        }
+        if (event.type === 'toggle') {
+            return createMachineUpdate(listboxState(createCursorState(event.id), selectForMode(state.selection, event.id, domain, selectionMode, deselectable)), [{ type: 'focus', id: event.id }]);
+        }
+        return createMachineUpdate(listboxState(createCursorState(event.id), selectOne(state.selection, event.id, domain)), [{ type: 'focus', id: event.id }, { type: 'activate', id: event.id }]);
+    }
+    switch (event) {
+        case 'next':
+            return moveListbox(domain, state, 1, boundary, selectionFollowsFocus, policies);
+        case 'previous':
+            return moveListbox(domain, state, -1, boundary, selectionFollowsFocus, policies);
+        case 'first':
+            return moveListboxToEdge(domain, state, 1, selectionFollowsFocus, policies);
+        case 'last':
+            return moveListboxToEdge(domain, state, -1, selectionFollowsFocus, policies);
+        case 'toggle': {
+            const current = state.cursor.current;
+            if (current === null)
+                return noCursor();
+            return createMachineUpdate(listboxState(state.cursor, selectForMode(state.selection, current, domain, selectionMode, deselectable)));
+        }
+        case 'activate': {
+            const current = state.cursor.current;
+            if (current === null)
+                return noCursor();
+            return createMachineUpdate(listboxState(state.cursor, selectOne(state.selection, current, domain)), [{ type: 'activate', id: current }]);
+        }
+        case 'clear': {
+            const selection = clearSelection(state.selection);
+            return createMachineUpdate(selection === state.selection ? state : listboxState(state.cursor, selection));
+        }
+    }
+}
+export function findListboxTypeaheadMatch(domain, current, query, options) {
+    if (typeof query !== 'string' || query.length === 0)
+        return ok(null);
+    if (typeof options.textValue !== 'function') {
+        return fail('transition-rejection', 'invalid-typeahead-text-value', 'Listbox typeahead requires a textValue function.');
+    }
+    if (options.eligible !== undefined && typeof options.eligible !== 'function') {
+        return fail('transition-rejection', 'invalid-eligibility-policy', 'Listbox typeahead eligibility must be a function.');
+    }
+    if (options.normalize !== undefined && typeof options.normalize !== 'function') {
+        return fail('transition-rejection', 'invalid-typeahead-normalizer', 'Listbox typeahead normalize must be a function.');
+    }
+    if (options.maxScan !== undefined
+        && (!Number.isSafeInteger(options.maxScan) || options.maxScan < 0)) {
+        return fail('resource-rejection', 'invalid-scan-ceiling', 'Listbox typeahead maxScan must be a non-negative safe integer.');
+    }
+    if (current !== null && !domain.contains(current)) {
+        return fail('transition-rejection', 'listbox-cursor-outside-domain', 'Listbox typeahead cursor must exist in the sequence domain.', { current });
+    }
+    const normalize = options.normalize ?? ((text) => text.toLowerCase());
+    const needle = normalize(query);
+    if (needle.length === 0 || domain.size === 0)
+        return ok(null);
+    const eligible = options.eligible ?? (() => true);
+    const maxScan = options.maxScan ?? Number.MAX_SAFE_INTEGER;
+    const start = current === null ? 0 : (domain.indexOf(current) + 1) % domain.size;
+    let scanned = 0;
+    for (let offset = 0; offset < domain.size; offset += 1) {
+        if (scanned === maxScan) {
+            return fail('resource-rejection', 'scan-ceiling-reached', 'Listbox typeahead reached maxScan before its result was determined.', { maxScan });
+        }
+        const id = domain.at((start + offset) % domain.size);
+        scanned += 1;
+        if (id !== null && eligible(id) && normalize(options.textValue(id)).startsWith(needle)) {
+            return ok(id);
+        }
+    }
+    return ok(null);
+}
+function moveListbox(domain, state, direction, boundary, selectionFollowsFocus, policies) {
+    const eligible = policies.eligible ?? (() => true);
+    const current = state.cursor.current;
+    let target;
+    if (current === null) {
+        const initial = findEligibleFromEdge(domain, direction, {
+            eligible,
+            ...(policies.maxScan === undefined ? {} : { maxScan: policies.maxScan }),
+        });
+        if (!initial.ok)
+            return initial;
+        target = initial.value;
+    }
+    else {
+        const movement = domain.move(current, direction, boundary, {
+            eligible,
+            ...(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(state);
+    const cursor = createCursorState(target);
+    const selection = selectionFollowsFocus
+        ? selectOne(state.selection, target, domain)
+        : state.selection;
+    return createMachineUpdate(listboxState(cursor, selection), [{ type: 'focus', id: target }]);
+}
+function moveListboxToEdge(domain, state, direction, selectionFollowsFocus, policies) {
+    const target = findEligibleFromEdge(domain, direction, {
+        eligible: policies.eligible ?? (() => true),
+        ...(policies.maxScan === undefined ? {} : { maxScan: policies.maxScan }),
+    });
+    if (!target.ok)
+        return target;
+    if (target.value === null || target.value === state.cursor.current) {
+        return createMachineUpdate(state);
+    }
+    return createMachineUpdate(listboxState(createCursorState(target.value), selectionFollowsFocus ? selectOne(state.selection, target.value, domain) : state.selection), [{ type: 'focus', id: target.value }]);
+}
+function selectForMode(state, id, domain, selectionMode, deselectable) {
+    return selectionMode === 'single'
+        ? deselectable && state.has(id) ? clearSelection(state) : selectOne(state, id, domain)
+        : toggleMultipleSelection(state, id, domain);
+}
+function validateListboxState(domain, state) {
+    if (state.cursor.current !== null && !domain.contains(state.cursor.current)) {
+        return {
+            class: 'transition-rejection',
+            code: 'listbox-cursor-outside-domain',
+            message: 'Listbox cursor must exist in the sequence domain.',
+            details: { current: state.cursor.current },
+        };
+    }
+    const unique = new Set(state.selection.selected);
+    if (unique.size !== state.selection.selected.length || state.selection.size !== unique.size) {
+        return {
+            class: 'transition-rejection',
+            code: 'invalid-listbox-selection',
+            message: 'Listbox selection must contain unique identities with a matching size.',
+        };
+    }
+    let previousIndex = -1;
+    for (const id of unique) {
+        const index = domain.indexOf(id);
+        if (index === null) {
+            return {
+                class: 'transition-rejection',
+                code: 'listbox-selection-outside-domain',
+                message: 'Listbox selection identities must exist in the sequence domain.',
+                details: { id },
+            };
+        }
+        if (index <= previousIndex || !state.selection.has(id)) {
+            return {
+                class: 'transition-rejection',
+                code: 'invalid-listbox-selection',
+                message: 'Listbox selection observations must match canonical sequence order.',
+            };
+        }
+        previousIndex = index;
+    }
+    for (const id of domain.ids) {
+        if (state.selection.has(id) !== unique.has(id)) {
+            return {
+                class: 'transition-rejection',
+                code: 'invalid-listbox-selection',
+                message: 'Listbox selection membership observations must agree.',
+            };
+        }
+    }
+    if (state.selection.anchor !== null && !domain.contains(state.selection.anchor)) {
+        return {
+            class: 'transition-rejection',
+            code: 'listbox-anchor-outside-domain',
+            message: 'Listbox selection anchor must exist in the sequence domain.',
+            details: { anchor: state.selection.anchor },
+        };
+    }
+    return null;
+}
+function listboxState(cursor, selection) {
+    return Object.freeze({ cursor, selection });
+}
+function noCursor() {
+    return fail('transition-rejection', 'no-cursor', 'Listbox toggle and activate require a current cursor.');
+}
+function isListboxEvent(value) {
+    return typeof value === 'string' ? (value === 'next' ||
+        value === 'previous' ||
+        value === 'first' ||
+        value === 'last' ||
+        value === 'toggle' ||
+        value === 'activate' ||
+        value === 'clear') : typeof value === 'object' && value !== null
+        && 'type' in value && 'id' in value
+        && (value.type === 'focus' || value.type === 'toggle' || value.type === 'activate')
+        && typeof value.id === 'string';
+}
+//# sourceMappingURL=listbox.js.map

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

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

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

@@ -0,0 +1,29 @@
+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[]): MenuState<ID>;
+export declare function tryCreateMenuState<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":"AACA,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,SAAS,CAAC,EAAE,CAAC,CAEzJ;AAED,wBAAgB,kBAAkB,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,CAOpK;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,76 @@
+import { unwrap } from '../../result.js';
+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 = []) {
+    return unwrap(tryCreateMenuState(tree, open, current, openPath));
+}
+export function tryCreateMenuState(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 = tryCreateMenuState(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":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AAQzE,MAAM,UAAU,eAAe,CAAsB,IAAc,EAAE,IAAI,GAAG,KAAK,EAAE,OAAO,GAAc,IAAI,EAAE,QAAQ,GAAkB,EAAE;IACxI,OAAO,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAsB,IAAc,EAAE,IAAI,GAAG,KAAK,EAAE,OAAO,GAAc,IAAI,EAAE,QAAQ,GAAkB,EAAE;IAC3I,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC;IACzD,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,cAAc,EAAE,wBAAwB,EAAE,wDAAwD,CAAC,CAAC;IACrN,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;QAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAO,CAAC,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,cAAc,EAAE,6BAA6B,EAAE,4CAA4C,CAAC,CAAC;IACpO,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,cAAc,EAAE,8BAA8B,EAAE,kDAAkD,CAAC,CAAC;IACxK,IAAI,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,cAAc,EAAE,oBAAoB,EAAE,8BAA8B,CAAC,CAAC;IAC7J,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,cAAc,CAAsB,IAAc,EAAE,KAAoB,EAAE,KAAoB,EAAE,QAAQ,GAAqB,EAAE;IAC7I,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC;IACxL,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAAC,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IAChN,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,mBAAmB,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnI,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,sBAAsB,EAAE,aAAa,EAAE,mCAAmC,CAAC,CAAC;IACzG,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,4CAA4C,CAAC,CAAC;QAAC,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IACpU,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;IACrC,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IAChM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAO,CAAC,CAAC;QAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;QAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IACloB,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;QAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI;YAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAAC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IACpb,IAAI,KAAK,KAAK,eAAe;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9G,OAAO,mBAAmB,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;AACvH,CAAC;AAED,SAAS,UAAU,CAAsB,IAAc,EAAE,KAAoB,IAA4B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,KAAK,IAAI;IAAE,OAAO,mBAAmB,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpgB,SAAS,OAAO,CAAsB,IAAc,EAAE,EAAM,EAAE,WAA0B,IAAmB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACjO,SAAS,SAAS,CAAsB,IAAa,EAAE,OAAkB,EAAE,QAAuB,IAAmB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,21 @@
+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): PopupState;
+export declare function tryCreatePopupState(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":"AACA,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,UAAU,CAA0C;AACjG,wBAAgB,mBAAmB,CAAC,IAAI,UAAM,GAAE,MAAM,CAAC,UAAU,CAAC,CAAyI;AAC3M,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,10 @@
+import { unwrap } from '../../result.js';
+import { fail, ok } from '../kernel/foundation.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+export function createPopupState(open = false) { return unwrap(tryCreatePopupState(open)); }
+export function tryCreatePopupState(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":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACA,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,IAAa,OAAO,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAA,CAAA,CAAC;AACjG,MAAM,UAAU,mBAAmB,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;AAC3M,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,21 @@
+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): SliderState;
+export declare function tryCreateSliderState(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":"AACA,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,WAAW,CAEb;AAED,wBAAgB,oBAAoB,CAClC,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,73 @@
+import { unwrap } from '../../result.js';
+import { fail, ok } from '../kernel/foundation.js';
+import { createMachineUpdate } from '../kernel/machine.js';
+export function createSliderState(range, tick = 0) {
+    return unwrap(tryCreateSliderState(range, tick));
+}
+export function tryCreateSliderState(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,67 @@
+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[]): TreeGridModel<RowID, CellID>;
+export declare function tryCreateTreeGridModel<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>): TreeGridState<RowID, CellID>;
+export declare function tryCreateTreeGridState<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