@sectile/terminal 0.2.0 → 0.2.1

package/dist/tree-grid.js

@@ -0,0 +1,308 @@
+import { createFacadeConnection } from './internal/facade.js';
+import { unwrap } from '@sectile/core/result';
+import { tryCreateInteractionState, requireInteraction, } from '@sectile/core/interaction';
+import { tryCreateRevisionSnapshot, rejectRevisionInput, } from '@sectile/core/revision';
+import { applyTreeGridEvent, tryCreateTreeGridModelFromRows, tryCreateTreeGridState, } from '@sectile/core/tree-grid';
+import { applyControllerEvent, synchronizeControllerState } from './internal/controller.js';
+import { applyTerminalTextInput, } from './keyboard.js';
+export function createTreeGridController(options) {
+    const value = options.value !== undefined ? options.value : options.defaultValue ?? null;
+    const initial = tryCreateTreeGridState(options.model, {
+        selected: value === null ? [] : [value],
+        anchor: value,
+        expanded: options.expandedValue ?? options.defaultExpandedValue ?? [],
+        current: options.highlightedValue !== undefined
+            ? options.highlightedValue
+            : options.defaultHighlightedValue ?? null,
+        editMode: options.editMode ?? options.defaultEditMode ?? 'navigation',
+    });
+    if (!initial.ok)
+        return initial;
+    const snapshot = tryCreateRevisionSnapshot(initial.value);
+    if (!snapshot.ok)
+        return snapshot;
+    const interaction = tryCreateInteractionState(options);
+    if (!interaction.ok)
+        return interaction;
+    return { ok: true, value: new TerminalTreeGridController(options, snapshot.value, interaction.value) };
+}
+export function createTreeGrid(options) {
+    return unwrap(tryCreateTreeGrid(options));
+}
+export function tryCreateTreeGrid(options) {
+    return createFacadeConnection(options, (options) => tryCreateTreeGridConnection(options));
+}
+function tryCreateTreeGridConnection(options) {
+    const model = tryCreateTreeGridModelFromRows(options.rows);
+    if (!model.ok)
+        return model;
+    const controller = createTreeGridController({ ...options, model: model.value });
+    if (!controller.ok)
+        return controller;
+    return { ok: true, value: connectTreeGrid({ ...options, controller: controller.value }) };
+}
+export function connectTreeGrid(options) {
+    return new TerminalTreeGridConnection(options);
+}
+export function toTreeGridEvent(input, editMode = 'navigation') {
+    if (input.ctrlKey === true)
+        return null;
+    if (editMode === 'editing') {
+        if (input.key === 'enter')
+            return 'commit-edit';
+        if (input.key === 'escape')
+            return 'cancel-edit';
+        if (input.key === 'edit')
+            return 'start-edit';
+        return null;
+    }
+    if (input.altKey === true && input.key === 'right')
+        return 'expand';
+    if (input.altKey === true && input.key === 'left')
+        return 'collapse';
+    if (input.key === 'left')
+        return 'left';
+    if (input.key === 'right')
+        return 'right';
+    if (input.key === 'up')
+        return 'up';
+    if (input.key === 'down')
+        return 'down';
+    if (input.key === 'expand')
+        return 'expand';
+    if (input.key === 'collapse')
+        return 'collapse';
+    if (input.key === 'o')
+        return 'expand';
+    if (input.key === 'c')
+        return 'collapse';
+    if (input.key === 'space')
+        return 'select';
+    if (input.key === 'enter' || input.key === 'edit')
+        return 'start-edit';
+    return null;
+}
+class TerminalTreeGridConnection {
+    model;
+    #controller;
+    #getCellValue;
+    #setCellValue;
+    #onTransition;
+    #onUpdate;
+    #disabled;
+    #readOnly;
+    #editBaseline = null;
+    constructor(options) {
+        this.#controller = options.controller;
+        this.model = options.controller.model;
+        this.#getCellValue = options.getCellValue;
+        this.#setCellValue = options.setCellValue;
+        this.#onTransition = options.onTransition;
+        this.#onUpdate = options.onUpdate;
+        this.#disabled = options.disabled === true;
+        this.#readOnly = options.readOnly === true;
+    }
+    getSnapshot() {
+        return this.#controller.getSnapshot();
+    }
+    syncControlledValues(values) {
+        const result = this.#controller.syncControlledValues(values);
+        if (result.ok)
+            this.#onUpdate?.();
+        return result;
+    }
+    handleKeyboardInput(input) {
+        const snapshot = this.#controller.getSnapshot();
+        if (snapshot.state.editMode === 'editing' && snapshot.state.cursor.current !== null) {
+            if (this.#disabled || this.#readOnly)
+                return false;
+            const id = snapshot.state.cursor.current;
+            const nextValue = applyTerminalTextInput(this.#getCellValue(id), input);
+            if (nextValue !== null) {
+                this.#setCellValue(id, nextValue);
+                this.#onUpdate?.();
+                return true;
+            }
+        }
+        const event = toTreeGridEvent(input, snapshot.state.editMode);
+        if (event === null)
+            return false;
+        const result = this.#controller.handleKeyboardInput(input);
+        if (result.ok)
+            this.#applyEffects(result.commands);
+        this.#onTransition?.(Object.freeze({ event, result }));
+        if (result.ok)
+            this.#onUpdate?.();
+        return result.ok;
+    }
+    #applyEffects(effects) {
+        for (const effect of effects) {
+            if (effect.type === 'begin-cell-edit') {
+                this.#editBaseline = Object.freeze({
+                    id: effect.id,
+                    value: this.#getCellValue(effect.id),
+                });
+            }
+            else if (effect.type === 'cancel-cell-edit') {
+                if (this.#editBaseline?.id === effect.id) {
+                    this.#setCellValue(effect.id, this.#editBaseline.value);
+                }
+                this.#editBaseline = null;
+            }
+            else if (effect.type === 'commit-cell-edit') {
+                this.#editBaseline = null;
+            }
+        }
+    }
+}
+export function toTreeGridEffect(command) {
+    if (command.type === 'focus') {
+        return Object.freeze({ type: 'move-highlight', id: command.id });
+    }
+    if (command.type === 'begin-edit') {
+        return Object.freeze({ type: 'begin-cell-edit', id: command.id });
+    }
+    if (command.type === 'commit-edit') {
+        return Object.freeze({ type: 'commit-cell-edit', id: command.id });
+    }
+    return Object.freeze({ type: 'cancel-cell-edit', id: command.id });
+}
+class TerminalTreeGridController {
+    model;
+    #policies;
+    #valueControlled;
+    #expandedControlled;
+    #highlightControlled;
+    #editModeControlled;
+    #onValueChange;
+    #onExpandedValueChange;
+    #onHighlightedValueChange;
+    #onEditModeChange;
+    #interaction;
+    #snapshot;
+    constructor(options, snapshot, interaction) {
+        this.model = options.model;
+        this.#policies = options.policies ?? {};
+        this.#valueControlled = options.value !== undefined;
+        this.#expandedControlled = options.expandedValue !== undefined;
+        this.#highlightControlled = options.highlightedValue !== undefined;
+        this.#editModeControlled = options.editMode !== undefined;
+        this.#onValueChange = options.onValueChange;
+        this.#onExpandedValueChange = options.onExpandedValueChange;
+        this.#onHighlightedValueChange = options.onHighlightedValueChange;
+        this.#onEditModeChange = options.onEditModeChange;
+        this.#interaction = interaction;
+        this.#snapshot = snapshot;
+    }
+    getSnapshot() {
+        return this.#snapshot;
+    }
+    syncControlledValues(values) {
+        const error = controlledInputError(this.#valueControlled, this.#expandedControlled, this.#highlightControlled, this.#editModeControlled, values);
+        if (error !== null)
+            return { ok: false, error };
+        const selected = this.#valueControlled
+            ? values.value
+            : selectedValue(this.#snapshot.state);
+        const state = tryCreateTreeGridState(this.model, {
+            selected: selected === null ? [] : [selected],
+            anchor: this.#valueControlled ? selected : this.#snapshot.state.selection.anchor,
+            expanded: this.#expandedControlled
+                ? values.expandedValue
+                : this.#snapshot.state.expansion.ids,
+            current: this.#highlightControlled
+                ? values.highlightedValue
+                : this.#snapshot.state.cursor.current,
+            editMode: this.#editModeControlled
+                ? values.editMode
+                : this.#snapshot.state.editMode,
+        });
+        const snapshot = synchronizeControllerState(this.#snapshot, state);
+        if (!snapshot.ok)
+            return snapshot;
+        this.#snapshot = snapshot.value;
+        return snapshot;
+    }
+    handleKeyboardInput(input, expectedRevision = this.#snapshot.revision) {
+        const event = toTreeGridEvent(input, this.#snapshot.state.editMode);
+        if (event === null) {
+            return rejectRevisionInput(this.#snapshot, {
+                class: 'transition-rejection',
+                code: 'unsupported-terminal-key',
+                message: 'Terminal keyboard input does not map to a tree-grid semantic event.',
+                details: { key: input.key },
+            });
+        }
+        const permitted = requireInteraction(this.#interaction, treeGridIntent(event));
+        if (!permitted.ok)
+            return rejectRevisionInput(this.#snapshot, permitted.error);
+        const result = applyControllerEvent(this.#snapshot, expectedRevision, event, (state, semanticEvent) => applyTreeGridEvent(this.model, state, semanticEvent, this.#policies), (previous, proposed) => controlledState(this.model, previous, proposed, this.#valueControlled, this.#expandedControlled, this.#highlightControlled, this.#editModeControlled), (previous, proposed) => this.#notify(previous, proposed), toTreeGridEffect);
+        if (result.ok)
+            this.#snapshot = result.snapshot;
+        return result;
+    }
+    #notify(previous, proposed) {
+        const previousValue = selectedValue(previous);
+        const value = selectedValue(proposed);
+        if (previousValue !== value) {
+            this.#onValueChange?.(Object.freeze({ value, previousValue }));
+        }
+        if (!sameIDs(previous.expansion.ids, proposed.expansion.ids)) {
+            this.#onExpandedValueChange?.(Object.freeze({
+                value: proposed.expansion.ids,
+                previousValue: previous.expansion.ids,
+            }));
+        }
+        if (previous.cursor.current !== proposed.cursor.current) {
+            this.#onHighlightedValueChange?.(Object.freeze({
+                value: proposed.cursor.current,
+                previousValue: previous.cursor.current,
+            }));
+        }
+        if (previous.editMode !== proposed.editMode) {
+            this.#onEditModeChange?.(Object.freeze({
+                value: proposed.editMode,
+                previousValue: previous.editMode,
+            }));
+        }
+    }
+}
+function treeGridIntent(event) {
+    const type = typeof event === 'object' ? event.type : event;
+    return type === 'start-edit' || type === 'commit-edit' || type === 'cancel-edit'
+        ? 'mutate'
+        : 'navigate';
+}
+function controlledState(model, previous, proposed, valueControlled, expandedControlled, highlightControlled, editModeControlled) {
+    return tryCreateTreeGridState(model, {
+        selected: valueControlled ? previous.selection.selected : proposed.selection.selected,
+        anchor: valueControlled ? previous.selection.anchor : proposed.selection.anchor,
+        expanded: expandedControlled ? previous.expansion.ids : proposed.expansion.ids,
+        current: highlightControlled ? previous.cursor.current : proposed.cursor.current,
+        editMode: editModeControlled ? previous.editMode : proposed.editMode,
+    });
+}
+function selectedValue(state) {
+    return state.selection.selected[0] ?? null;
+}
+function controlledInputError(valueControlled, expandedControlled, highlightControlled, editModeControlled, values) {
+    return fieldError(valueControlled, values.value !== undefined, 'value', 'tree-grid selection')
+        ?? fieldError(expandedControlled, values.expandedValue !== undefined, 'expanded-value', 'tree-grid expansion')
+        ?? fieldError(highlightControlled, values.highlightedValue !== undefined, 'highlighted-value', 'tree-grid highlight')
+        ?? fieldError(editModeControlled, values.editMode !== undefined, 'edit-mode', 'tree-grid edit mode');
+}
+function fieldError(controlled, provided, codeName, label) {
+    if (controlled === provided)
+        return null;
+    return {
+        class: 'construction',
+        code: controlled ? `controlled-${codeName}-required` : `uncontrolled-${codeName}-update`,
+        message: controlled
+            ? `Controlled ${label} sync requires its external value.`
+            : `Uncontrolled ${label} cannot be synchronized externally.`,
+    };
+}
+function sameIDs(left, right) {
+    return left.length === right.length && left.every((id, index) => id === right[index]);
+}
+//# sourceMappingURL=tree-grid.js.map

package/dist/tree-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-grid.js","sourceRoot":"","sources":["../src/tree-grid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyB,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EACL,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,8BAA8B,EAC9B,sBAAsB,GAQvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EACL,sBAAsB,GAEvB,MAAM,eAAe,CAAC;AA+HvB,MAAM,UAAU,wBAAwB,CAItC,OAAiD;IAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IACzF,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,KAAK,EAAE;QACpD,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACvC,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,oBAAoB,IAAI,EAAE;QACrE,OAAO,EAAE,OAAO,CAAC,gBAAgB,KAAK,SAAS;YAC7C,CAAC,CAAC,OAAO,CAAC,gBAAgB;YAC1B,CAAC,CAAC,OAAO,CAAC,uBAAuB,IAAI,IAAI;QAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,eAAe,IAAI,YAAY;KACtE,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,WAAW,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,WAAW,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC;IACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAuC;IAEvC,OAAO,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAuC;IAEvC,OAAO,sBAAsB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,2BAA2B,CAClC,OAAuC;IAEvC,MAAM,KAAK,GAAG,8BAA8B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,UAAU,GAAG,wBAAwB,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,UAAU,CAAC,EAAE;QAAE,OAAO,UAAU,CAAC;IACtC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAiD;IAEjD,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,eAAe,CAI7B,KAAoB,EACpB,QAAQ,GAAqB,YAAY;IAEzC,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO;YAAE,OAAO,aAAa,CAAC;QAChD,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,aAAa,CAAC;QACjD,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;YAAE,OAAO,YAAY,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IACrE,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAChD,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC;IACzC,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,0BAA0B;IAEd,KAAK,CAA+B;IAC3C,WAAW,CAAoC;IAC/C,aAAa,CAAyB;IACtC,aAAa,CAAsC;IACnD,aAAa,CAER;IACL,SAAS,CAA2B;IACpC,SAAS,CAAU;IACnB,SAAS,CAAU;IAC5B,aAAa,GAA2D,IAAI,CAAC;IAE7E,YAAmB,OAAiD;QAClE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC7C,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAEM,oBAAoB,CACzB,MAA+C;QAE/C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,mBAAmB,CAAC,KAAoB;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAChD,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACpF,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YACnD,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YACxE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;gBAClC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACnB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAgB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7E,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,OAA0C;QACtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACtC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;oBACjC,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;iBACrC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC9C,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;oBACzC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC1D,CAAC;gBACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC5B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAgC;IAEhC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,0BAA0B;IAEd,KAAK,CAA+B;IAC3C,SAAS,CAA2B;IACpC,gBAAgB,CAAU;IAC1B,mBAAmB,CAAU;IAC7B,oBAAoB,CAAU;IAC9B,mBAAmB,CAAU;IAC7B,cAAc,CAET;IACL,sBAAsB,CAEjB;IACL,yBAAyB,CAEpB;IACL,iBAAiB,CAEZ;IACL,YAAY,CAAmB;IACxC,SAAS,CAAiD;IAE1D,YACE,OAAiD,EACjD,QAAwD,EACxD,WAA6B;QAE7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC;QACpD,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC;QAC/D,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC;QACnE,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;QAC5D,IAAI,CAAC,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;QAClE,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,oBAAoB,CACzB,MAA+C;QAE/C,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,mBAAmB,EACxB,MAAM,CACP,CAAC;QACF,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB;YACpC,CAAC,CAAE,MAAM,CAAC,KAAuB;YACjC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,EAAE;YAC/C,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC7C,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM;YAChF,QAAQ,EAAE,IAAI,CAAC,mBAAmB;gBAChC,CAAC,CAAE,MAAM,CAAC,aAAkC;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG;YACtC,OAAO,EAAE,IAAI,CAAC,oBAAoB;gBAChC,CAAC,CAAE,MAAM,CAAC,gBAAkC;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO;YACvC,QAAQ,EAAE,IAAI,CAAC,mBAAmB;gBAChC,CAAC,CAAE,MAAM,CAAC,QAA6B;gBACvC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ;SAClC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,mBAAmB,CACxB,KAAoB,EACpB,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ;QAE1C,MAAM,KAAK,GAAG,eAAe,CAAgB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE;gBACzC,KAAK,EAAE,sBAAsB;gBAC7B,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,qEAAqE;gBAC9E,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;aAC5B,CAAC,CAAC;QACL,CAAC;QACD,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS,CAAC,EAAE;YAAE,OAAO,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,oBAAoB,CACjC,IAAI,CAAC,SAAS,EACd,gBAAgB,EAChB,KAAK,EACL,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,kBAAkB,CAC1C,IAAI,CAAC,KAAK,EACV,KAAK,EACL,aAAa,EACb,IAAI,CAAC,SAAS,CACf,EACD,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,eAAe,CACrC,IAAI,CAAC,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,mBAAmB,CACzB,EACD,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACxD,gBAAgB,CACjB,CAAC;QACF,IAAI,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,CACL,QAAsC,EACtC,QAAsC;QAEtC,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC1C,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG;gBAC7B,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG;aACtC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxD,IAAI,CAAC,yBAAyB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC7C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;gBAC9B,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;aACvC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,IAAI,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBACrC,KAAK,EAAE,QAAQ,CAAC,QAAQ;gBACxB,aAAa,EAAE,QAAQ,CAAC,QAAQ;aACjC,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;CACF;AAED,SAAS,cAAc,CACrB,KAAmC;IAEnC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5D,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,aAAa;QAC9E,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CACtB,KAAmC,EACnC,QAAsC,EACtC,QAAsC,EACtC,eAAwB,EACxB,kBAA2B,EAC3B,mBAA4B,EAC5B,kBAA2B;IAE3B,OAAO,sBAAsB,CAAC,KAAK,EAAE;QACnC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ;QACrF,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM;QAC/E,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG;QAC9E,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO;QAChF,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;KACrE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CACpB,KAAmC;IAEnC,OAAO,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,oBAAoB,CAC3B,eAAwB,EACxB,kBAA2B,EAC3B,mBAA4B,EAC5B,kBAA2B,EAC3B,MAA+C;IAE/C,OAAO,UAAU,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,OAAO,EAAE,qBAAqB,CAAC;WACzF,UAAU,CACX,kBAAkB,EAClB,MAAM,CAAC,aAAa,KAAK,SAAS,EAClC,gBAAgB,EAChB,qBAAqB,CACtB;WACE,UAAU,CACX,mBAAmB,EACnB,MAAM,CAAC,gBAAgB,KAAK,SAAS,EACrC,mBAAmB,EACnB,qBAAqB,CACtB;WACE,UAAU,CACX,kBAAkB,EAClB,MAAM,CAAC,QAAQ,KAAK,SAAS,EAC7B,WAAW,EACX,qBAAqB,CACtB,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CACjB,UAAmB,EACnB,QAAiB,EACjB,QAAgB,EAChB,KAAa;IAEb,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO;QACL,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,cAAc,QAAQ,WAAW,CAAC,CAAC,CAAC,gBAAgB,QAAQ,SAAS;QACxF,OAAO,EAAE,UAAU;YACjB,CAAC,CAAC,cAAc,KAAK,oCAAoC;YACzD,CAAC,CAAC,gBAAgB,KAAK,qCAAqC;KAC/D,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAsB,IAAmB,EAAE,KAAoB;IAC7E,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/tree-view.d.ts

@@ -0,0 +1,83 @@
+import { type FacadeConnection } from './internal/facade.js';
+import type { Result, StableID } from '@sectile/core';
+import { type RevisionResult, type RevisionSnapshot } from '@sectile/core/revision';
+import { type Tree, type TreeNodeInput } from '@sectile/core/tree';
+import { type TreeViewCommand, type TreeViewEvent, type TreeViewPolicies, type TreeViewSelectionMode, type TreeViewState } from '@sectile/core/tree-view';
+import type { TerminalKeyboardInput } from './keyboard.js';
+export type KeyboardInput = TerminalKeyboardInput;
+export type { TreeViewSelectionMode } from '@sectile/core/tree-view';
+export interface TreeViewEffect<ID extends StableID = StableID> {
+    readonly type: 'move-highlight';
+    readonly id: ID;
+}
+export interface TreeViewValueChangeDetails<ID extends StableID = StableID> {
+    readonly value: readonly ID[];
+    readonly previousValue: readonly ID[];
+}
+export interface TreeViewExpandedValuesChangeDetails<ID extends StableID = StableID> {
+    readonly value: readonly ID[];
+    readonly previousValue: readonly ID[];
+}
+export interface TreeViewHighlightChangeDetails<ID extends StableID = StableID> {
+    readonly value: ID | null;
+    readonly previousValue: ID | null;
+}
+export interface TreeViewControllerOptions<ID extends StableID = StableID> {
+    readonly tree: Tree<ID>;
+    readonly selectionMode?: TreeViewSelectionMode;
+    readonly disabled?: boolean;
+    readonly value?: readonly ID[];
+    readonly defaultValue?: readonly ID[];
+    readonly expandedValues?: readonly ID[];
+    readonly defaultExpandedValues?: readonly ID[];
+    readonly highlightedValue?: ID | null;
+    readonly defaultHighlightedValue?: ID | null;
+    readonly policies?: TreeViewPolicies<ID>;
+    readonly onValueChange?: (change: TreeViewValueChangeDetails<ID>) => void;
+    readonly onExpandedValuesChange?: (change: TreeViewExpandedValuesChangeDetails<ID>) => void;
+    readonly onHighlightedValueChange?: (change: TreeViewHighlightChangeDetails<ID>) => void;
+}
+export type TreeViewControllerValueChangeHandler<ID extends StableID = StableID> = NonNullable<TreeViewControllerOptions<ID>['onValueChange']>;
+export type TreeViewControllerExpandedValuesChangeHandler<ID extends StableID = StableID> = NonNullable<TreeViewControllerOptions<ID>['onExpandedValuesChange']>;
+export type TreeViewControllerHighlightedValueChangeHandler<ID extends StableID = StableID> = NonNullable<TreeViewControllerOptions<ID>['onHighlightedValueChange']>;
+export interface TreeViewControlledValues<ID extends StableID = StableID> {
+    readonly value?: readonly ID[];
+    readonly expandedValues?: readonly ID[];
+    readonly highlightedValue?: ID | null;
+}
+export interface TreeViewController<ID extends StableID = StableID> {
+    readonly tree: Tree<ID>;
+    readonly selectionMode: TreeViewSelectionMode;
+    getSnapshot(): RevisionSnapshot<TreeViewState<ID>>;
+    syncControlledValues(values: TreeViewControlledValues<ID>): Result<RevisionSnapshot<TreeViewState<ID>>>;
+    handleKeyboardInput(input: KeyboardInput, expectedRevision?: number): RevisionResult<TreeViewState<ID>, TreeViewEffect<ID>>;
+}
+export interface TreeViewTransitionDetails<ID extends StableID = StableID> {
+    readonly event: TreeViewEvent<ID>;
+    readonly result: RevisionResult<TreeViewState<ID>, TreeViewEffect<ID>>;
+}
+export interface TreeViewConnectionOptions<ID extends StableID = StableID> {
+    readonly controller: TreeViewController<ID>;
+    readonly disabled?: boolean;
+    readonly onTransition?: (details: TreeViewTransitionDetails<ID>) => void;
+    readonly onUpdate?: () => void;
+}
+export type TreeViewConnectionTransitionHandler<ID extends StableID = StableID> = NonNullable<TreeViewConnectionOptions<ID>['onTransition']>;
+export type TreeViewConnectionUpdateHandler<ID extends StableID = StableID> = NonNullable<TreeViewConnectionOptions<ID>['onUpdate']>;
+export interface TreeViewConnection<ID extends StableID = StableID> {
+    readonly tree: Tree<ID>;
+    getSnapshot(): RevisionSnapshot<TreeViewState<ID>>;
+    syncControlledValues(values: TreeViewControlledValues<ID>): Result<RevisionSnapshot<TreeViewState<ID>>>;
+    handleKeyboardInput(input: KeyboardInput): boolean;
+}
+export type TreeViewOptions<ID extends StableID = StableID> = Omit<TreeViewControllerOptions<ID>, 'tree'> & Omit<TreeViewConnectionOptions<ID>, 'controller'> & {
+    readonly nodes: readonly TreeNodeInput<ID>[];
+    readonly disabledItems?: readonly ID[];
+};
+export declare function createTreeViewController<ID extends StableID>(options: TreeViewControllerOptions<ID>): Result<TreeViewController<ID>>;
+export declare function createTreeView<ID extends StableID>(options: TreeViewOptions<ID>): FacadeConnection<TreeViewConnection<ID>>;
+export declare function tryCreateTreeView<ID extends StableID>(options: TreeViewOptions<ID>): Result<FacadeConnection<TreeViewConnection<ID>>>;
+export declare function connectTreeView<ID extends StableID>(options: TreeViewConnectionOptions<ID>): TreeViewConnection<ID>;
+export declare function toTreeViewEvent<ID extends StableID = StableID>(input: KeyboardInput): TreeViewEvent<ID> | null;
+export declare function toTreeViewEffect<ID extends StableID>(command: TreeViewCommand<ID>): TreeViewEffect<ID>;
+//# sourceMappingURL=tree-view.d.ts.map

package/dist/tree-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view.d.ts","sourceRoot":"","sources":["../src/tree-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAgB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMpE,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAiB,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,cAAc,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAC5D,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACxE,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,mCAAmC,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACjF,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,8BAA8B,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAC5E,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACvE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;IACxC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,mCAAmC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5F,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,8BAA8B,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;CAC1F;AAED,MAAM,MAAM,oCAAoC,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/I,MAAM,MAAM,6CAA6C,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC;AACjK,MAAM,MAAM,+CAA+C,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAErK,MAAM,WAAW,wBAAwB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAChE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,WAAW,IAAI,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,oBAAoB,CAClB,MAAM,EAAE,wBAAwB,CAAC,EAAE,CAAC,GACnC,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,mBAAmB,CACjB,KAAK,EAAE,aAAa,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,yBAAyB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACvE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,yBAAyB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACvE,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,mCAAmC,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7I,MAAM,MAAM,+BAA+B,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAErI,MAAM,WAAW,kBAAkB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAChE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,WAAW,IAAI,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,oBAAoB,CAClB,MAAM,EAAE,wBAAwB,CAAC,EAAE,CAAC,GACnC,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;CACpD;AAED,MAAM,MAAM,eAAe,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IACxD,IAAI,CAAC,yBAAyB,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,GACzC,IAAI,CAAC,yBAAyB,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,GACjD;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,CAAA;CAAE,CAAC;AAE7F,wBAAgB,wBAAwB,CAAC,EAAE,SAAS,QAAQ,EAC1D,OAAO,EAAE,yBAAyB,CAAC,EAAE,CAAC,GACrC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAehC;AAED,wBAAgB,cAAc,CAAC,EAAE,SAAS,QAAQ,EAChD,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,GAC3B,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAE1C;AAED,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,QAAQ,EACnD,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,GAC3B,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,CAElD;AAgBD,wBAAgB,eAAe,CAAC,EAAE,SAAS,QAAQ,EACjD,OAAO,EAAE,yBAAyB,CAAC,EAAE,CAAC,GACrC,kBAAkB,CAAC,EAAE,CAAC,CAExB;AAED,wBAAgB,eAAe,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,EAC5D,KAAK,EAAE,aAAa,GACnB,aAAa,CAAC,EAAE,CAAC,GAAG,IAAI,CAO1B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,QAAQ,EAClD,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,GAC3B,cAAc,CAAC,EAAE,CAAC,CAEpB"}

package/dist/tree-view.js

@@ -0,0 +1,216 @@
+import { createFacadeConnection } from './internal/facade.js';
+import { unwrap } from '@sectile/core/result';
+import { tryCreateInteractionState, requireInteraction, } from '@sectile/core/interaction';
+import { tryCreateRevisionSnapshot, rejectRevisionInput, } from '@sectile/core/revision';
+import { tryCreateTree } from '@sectile/core/tree';
+import { applyTreeViewEvent, tryCreateTreeViewState, } from '@sectile/core/tree-view';
+import { applyControllerEvent, synchronizeControllerState } from './internal/controller.js';
+export function createTreeViewController(options) {
+    const selectionMode = options.selectionMode ?? options.policies?.selectionMode ?? 'single';
+    const initial = tryCreateTreeViewState(options.tree, {
+        selected: options.value ?? options.defaultValue ?? [],
+        expanded: options.expandedValues ?? options.defaultExpandedValues ?? [],
+        current: options.highlightedValue !== undefined
+            ? options.highlightedValue
+            : options.defaultHighlightedValue ?? null,
+    }, selectionMode);
+    if (!initial.ok)
+        return initial;
+    const snapshot = tryCreateRevisionSnapshot(initial.value);
+    if (!snapshot.ok)
+        return snapshot;
+    const interaction = tryCreateInteractionState(options);
+    if (!interaction.ok)
+        return interaction;
+    return { ok: true, value: new TerminalTreeViewController({ ...options, selectionMode }, snapshot.value, interaction.value) };
+}
+export function createTreeView(options) {
+    return unwrap(tryCreateTreeView(options));
+}
+export function tryCreateTreeView(options) {
+    return createFacadeConnection(options, (options) => tryCreateTreeViewConnection(options));
+}
+function tryCreateTreeViewConnection(options) {
+    const tree = tryCreateTree(options.nodes);
+    if (!tree.ok)
+        return tree;
+    const disabled = new Set(options.disabledItems ?? []);
+    for (const id of disabled)
+        if (!tree.value.has(id))
+            return { ok: false, error: { class: 'construction', code: 'disabled-item-outside-domain', message: 'Every disabled tree-view item must exist in the tree.', details: { id } } };
+    const suppliedEligibility = options.policies?.eligible;
+    const policies = { ...options.policies, eligible: (id) => !disabled.has(id) && (suppliedEligibility?.(id) ?? true) };
+    const controller = createTreeViewController({ ...options, policies, tree: tree.value });
+    if (!controller.ok)
+        return controller;
+    return { ok: true, value: connectTreeView({ ...options, controller: controller.value }) };
+}
+export function connectTreeView(options) {
+    return new TerminalTreeViewConnection(options);
+}
+export function toTreeViewEvent(input) {
+    if (input.key === 'down')
+        return 'next';
+    if (input.key === 'up')
+        return 'previous';
+    if (input.key === 'right')
+        return 'right';
+    if (input.key === 'left')
+        return 'left';
+    if (input.key === 'space')
+        return 'toggle-select';
+    return null;
+}
+export function toTreeViewEffect(command) {
+    return Object.freeze({ type: 'move-highlight', id: command.id });
+}
+class TerminalTreeViewConnection {
+    tree;
+    #controller;
+    #onTransition;
+    #onUpdate;
+    constructor(options) {
+        this.#controller = options.controller;
+        this.tree = options.controller.tree;
+        this.#onTransition = options.onTransition;
+        this.#onUpdate = options.onUpdate;
+    }
+    getSnapshot() {
+        return this.#controller.getSnapshot();
+    }
+    syncControlledValues(values) {
+        const result = this.#controller.syncControlledValues(values);
+        if (result.ok)
+            this.#onUpdate?.();
+        return result;
+    }
+    handleKeyboardInput(input) {
+        const event = toTreeViewEvent(input);
+        if (event === null)
+            return false;
+        const result = this.#controller.handleKeyboardInput(input);
+        this.#onTransition?.(Object.freeze({ event, result }));
+        if (result.ok)
+            this.#onUpdate?.();
+        return result.ok;
+    }
+}
+class TerminalTreeViewController {
+    tree;
+    selectionMode;
+    #tree;
+    #policies;
+    #valueControlled;
+    #expandedControlled;
+    #highlightControlled;
+    #onValueChange;
+    #onExpandedValuesChange;
+    #onHighlightedValueChange;
+    #interaction;
+    #snapshot;
+    constructor(options, snapshot, interaction) {
+        this.tree = options.tree;
+        this.selectionMode = options.selectionMode ?? options.policies?.selectionMode ?? 'single';
+        this.#tree = options.tree;
+        this.#policies = { ...options.policies, selectionMode: this.selectionMode };
+        this.#valueControlled = options.value !== undefined;
+        this.#expandedControlled = options.expandedValues !== undefined;
+        this.#highlightControlled = options.highlightedValue !== undefined;
+        this.#onValueChange = options.onValueChange;
+        this.#onExpandedValuesChange = options.onExpandedValuesChange;
+        this.#onHighlightedValueChange = options.onHighlightedValueChange;
+        this.#interaction = interaction;
+        this.#snapshot = snapshot;
+    }
+    getSnapshot() {
+        return this.#snapshot;
+    }
+    syncControlledValues(values) {
+        const error = controlledInputError(this.#valueControlled, this.#expandedControlled, this.#highlightControlled, values);
+        if (error !== null)
+            return { ok: false, error };
+        const state = tryCreateTreeViewState(this.#tree, {
+            selected: this.#valueControlled
+                ? values.value
+                : this.#snapshot.state.selection.selected,
+            anchor: this.#snapshot.state.selection.anchor,
+            expanded: this.#expandedControlled
+                ? values.expandedValues
+                : this.#snapshot.state.expansion.ids,
+            current: this.#highlightControlled
+                ? values.highlightedValue
+                : this.#snapshot.state.cursor.current,
+        }, this.selectionMode);
+        const snapshot = synchronizeControllerState(this.#snapshot, state);
+        if (!snapshot.ok)
+            return snapshot;
+        this.#snapshot = snapshot.value;
+        return snapshot;
+    }
+    handleKeyboardInput(input, expectedRevision = this.#snapshot.revision) {
+        const permitted = requireInteraction(this.#interaction, 'navigate');
+        if (!permitted.ok)
+            return rejectRevisionInput(this.#snapshot, permitted.error);
+        const event = toTreeViewEvent(input);
+        if (event === null) {
+            return rejectRevisionInput(this.#snapshot, {
+                class: 'transition-rejection',
+                code: 'unsupported-terminal-key',
+                message: 'Terminal keyboard input does not map to a tree-view semantic event.',
+                details: { key: input.key },
+            });
+        }
+        const result = applyControllerEvent(this.#snapshot, expectedRevision, event, (state, semanticEvent) => applyTreeViewEvent(this.#tree, state, semanticEvent, this.#policies), (previous, proposed) => controlledState(this.#tree, previous, proposed, this.#valueControlled, this.#expandedControlled, this.#highlightControlled, this.selectionMode), (previous, proposed) => this.#notify(previous, proposed), toTreeViewEffect);
+        if (result.ok)
+            this.#snapshot = result.snapshot;
+        return result;
+    }
+    #notify(previous, proposed) {
+        if (!sameIDs(previous.selection.selected, proposed.selection.selected)) {
+            this.#onValueChange?.(Object.freeze({
+                value: proposed.selection.selected,
+                previousValue: previous.selection.selected,
+            }));
+        }
+        if (!sameIDs(previous.expansion.ids, proposed.expansion.ids)) {
+            this.#onExpandedValuesChange?.(Object.freeze({
+                value: proposed.expansion.ids,
+                previousValue: previous.expansion.ids,
+            }));
+        }
+        if (previous.cursor.current !== proposed.cursor.current) {
+            this.#onHighlightedValueChange?.(Object.freeze({
+                value: proposed.cursor.current,
+                previousValue: previous.cursor.current,
+            }));
+        }
+    }
+}
+function controlledState(tree, previous, proposed, valueControlled, expandedControlled, highlightControlled, selectionMode) {
+    return tryCreateTreeViewState(tree, {
+        selected: valueControlled ? previous.selection.selected : proposed.selection.selected,
+        anchor: valueControlled ? previous.selection.anchor : proposed.selection.anchor,
+        expanded: expandedControlled ? previous.expansion.ids : proposed.expansion.ids,
+        current: highlightControlled ? previous.cursor.current : proposed.cursor.current,
+    }, selectionMode);
+}
+function controlledInputError(valueControlled, expandedControlled, highlightControlled, values) {
+    return fieldError(valueControlled, values.value !== undefined, 'value', 'tree-view selection')
+        ?? fieldError(expandedControlled, values.expandedValues !== undefined, 'expanded-values', 'tree-view expansion')
+        ?? fieldError(highlightControlled, values.highlightedValue !== undefined, 'highlighted-value', 'tree-view highlight');
+}
+function fieldError(controlled, provided, codeName, label) {
+    if (controlled === provided)
+        return null;
+    return {
+        class: 'construction',
+        code: controlled ? `controlled-${codeName}-required` : `uncontrolled-${codeName}-update`,
+        message: controlled
+            ? `Controlled ${label} sync requires its external value.`
+            : `Uncontrolled ${label} cannot be synchronized externally.`,
+    };
+}
+function sameIDs(left, right) {
+    return left.length === right.length && left.every((id, index) => id === right[index]);
+}
+//# sourceMappingURL=tree-view.js.map