@ixfx/components 0.2.3 → 0.2.4

package/dist/common/tree-data-model.js

@@ -0,0 +1,207 @@
+// ---------------------------------------------------------------------------
+// Pure tree-mutation helpers (functional, produce new roots)
+// ---------------------------------------------------------------------------
+function cloneNode(node) {
+    if (node.children === undefined)
+        return { item: { ...node.item } };
+    return { item: { ...node.item }, children: node.children.map(cloneNode) };
+}
+function findNode(root, key) {
+    if (root.item.key === key)
+        return root;
+    if (!root.children)
+        return undefined;
+    for (const child of root.children) {
+        const found = findNode(child, key);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+/** Return a new root with the node at `key` replaced by `replacer(node)`. */
+function mapNode(root, key, replacer) {
+    if (root.item.key === key)
+        return replacer(root);
+    if (!root.children)
+        return root;
+    return { item: root.item, children: root.children.map(c => mapNode(c, key, replacer)) };
+}
+/** Return a new root with `newChild` appended to the children of the node at `parentKey`. */
+function addChildTo(root, parentKey, newChild) {
+    return mapNode(root, parentKey, parent => ({
+        item: parent.item,
+        children: [...(parent.children ?? []), newChild],
+    }));
+}
+/** Return a new root with the node at `key` removed (along with all its descendants). */
+function removeNodeFrom(root, key) {
+    if (!root.children)
+        return root;
+    return {
+        item: root.item,
+        children: root.children
+            .filter(c => c.item.key !== key)
+            .map(c => removeNodeFrom(c, key)),
+    };
+}
+/** Return a new root with the node at `key` moved to become a child of `newParentKey`. */
+function moveNodeTo(root, key, newParentKey) {
+    const target = findNode(root, key);
+    if (!target)
+        return root;
+    const withoutTarget = removeNodeFrom(root, key);
+    return addChildTo(withoutTarget, newParentKey, target);
+}
+// ---------------------------------------------------------------------------
+// TreeDataModel
+// ---------------------------------------------------------------------------
+/**
+ * Manages tree data for tree-like components.
+ *
+ * Handles two concerns:
+ * 1. **Lazy loading** — caches children fetched via `loadChildren` and can invalidate
+ *    specific branches so they are re-fetched on next expand.
+ * 2. **Structural mutations** — convenience methods to add, remove, update, or move
+ *    nodes. Each mutation produces a new immutable root and notifies connected components.
+ *
+ * Assign an instance to a component's `model` property instead of setting `root`/`loadChildren`
+ * directly. The same model instance can be shared across multiple components.
+ *
+ * @example
+ * ```typescript
+ * const model = new TreeDataModel({
+ *   root: { item: { key: 'root', label: 'Root' }, children: [] },
+ *   loadChildren: async (node, depth, signal) => fetchChildren(node.item.key),
+ * });
+ * myTreeList.model = model;
+ * myMillerList.model = model;
+ *
+ * // Later — invalidate a branch to force a re-fetch on next expand:
+ * model.invalidate('some-key');
+ * ```
+ */
+export class TreeDataModel {
+    #root;
+    #loadChildren;
+    #cache = new Map();
+    #subscribers = new Set();
+    constructor(options) {
+        this.#root = options.root;
+        this.#loadChildren = options.loadChildren;
+    }
+    // ---------------------------------------------------------------------------
+    // Root
+    // ---------------------------------------------------------------------------
+    /** The current immutable root snapshot. */
+    get root() {
+        return this.#root;
+    }
+    /**
+     * Replace the entire root with a new immutable snapshot.
+     * All cached children are cleared. Connected components re-render.
+     */
+    setRoot(root) {
+        this.#root = root;
+        this.#cache.clear();
+        this.#notify({ type: 'root', root });
+    }
+    // ---------------------------------------------------------------------------
+    // Child loading
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns children for the given node.
+     * If children are cached, they are returned immediately (as a resolved Promise).
+     * Otherwise the `loadChildren` callback is invoked and the result is cached.
+     * If no `loadChildren` is set and no cache entry exists, returns `[]`.
+     *
+     * Called by components internally — not typically called by application code.
+     */
+    async getChildren(node, depth, signal) {
+        const key = node.item.key;
+        if (this.#cache.has(key)) {
+            return this.#cache.get(key);
+        }
+        if (!this.#loadChildren) {
+            return [];
+        }
+        const result = await this.#loadChildren(node, depth, signal);
+        if (!signal.aborted) {
+            this.#cache.set(key, result);
+        }
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Cache invalidation
+    // ---------------------------------------------------------------------------
+    /**
+     * Clears the cached children for the node with the given key.
+     * Connected components will collapse that node (if currently expanded), so that
+     * the next expand triggers a fresh `loadChildren` call.
+     */
+    invalidate(key) {
+        this.#cache.delete(key);
+        this.#notify({ type: 'invalidate', key });
+    }
+    // ---------------------------------------------------------------------------
+    // Convenience mutators
+    // ---------------------------------------------------------------------------
+    /**
+     * Adds `node` as a child of the node identified by `parentKey`.
+     * Returns the new root (connected components are notified automatically).
+     */
+    addNode(parentKey, node) {
+        this.#root = addChildTo(this.#root, parentKey, node);
+        this.#notify({ type: 'root', root: this.#root });
+        return this.#root;
+    }
+    /**
+     * Removes the node with the given key and all its descendants.
+     * Returns the new root (connected components are notified automatically).
+     */
+    removeNode(key) {
+        this.#cache.delete(key);
+        this.#root = removeNodeFrom(this.#root, key);
+        this.#notify({ type: 'root', root: this.#root });
+        return this.#root;
+    }
+    /**
+     * Applies a partial update to the `item` of the node with the given key.
+     * Returns the new root (connected components are notified automatically).
+     */
+    updateItem(key, patch) {
+        this.#root = mapNode(this.#root, key, n => ({
+            item: { ...n.item, ...patch },
+            children: n.children,
+        }));
+        this.#notify({ type: 'root', root: this.#root });
+        return this.#root;
+    }
+    /**
+     * Moves the node with the given key to become a child of `newParentKey`.
+     * Returns the new root (connected components are notified automatically).
+     */
+    moveNode(key, newParentKey) {
+        this.#root = moveNodeTo(this.#root, key, newParentKey);
+        this.#notify({ type: 'root', root: this.#root });
+        return this.#root;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal subscription (used by components — not part of the public API)
+    // ---------------------------------------------------------------------------
+    /**
+     * Subscribe to model events. Returns an unsubscribe function.
+     * Components call this when the `model` property is set, and unsubscribe when it is unset.
+     *
+     * @internal
+     */
+    _subscribe(callback) {
+        this.#subscribers.add(callback);
+        return () => this.#subscribers.delete(callback);
+    }
+    #notify(event) {
+        for (const sub of this.#subscribers) {
+            sub(event);
+        }
+    }
+}
+//# sourceMappingURL=tree-data-model.js.map

package/dist/common/tree-data-model.js.map

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

package/dist/common/tree-item.d.ts

@@ -0,0 +1,7 @@
+export type TreeItem = {
+    label: string;
+    icon?: string;
+    tooltip?: string;
+    value?: string;
+};
+//# sourceMappingURL=tree-item.d.ts.map

package/dist/common/tree-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.d.ts","sourceRoot":"","sources":["../../src/common/tree-item.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/common/tree-item.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree-item.js.map

package/dist/common/tree-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.js","sourceRoot":"","sources":["../../src/common/tree-item.ts"],"names":[],"mappings":""}

package/dist/common/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Canonical shared types for all tree-like components (ixfx-tree-list, ixfx-miller-list,
+ * ixfx-crumb-navigation). Import from here rather than from individual component packages.
+ */
+/** A single node's display data. */
+export type TreeItem = {
+    /** Unique identifier within the tree. */
+    key: string;
+    /** Visible label text. */
+    label: string;
+    /** When true the node cannot have children and will not show an expand affordance. */
+    isLeaf?: boolean;
+    /** Arbitrary application data associated with this node. */
+    data?: unknown;
+    /** Icon name passed to an icon component, if icons are enabled. */
+    icon?: string;
+    /** Tooltip text shown on hover. */
+    tooltip?: string;
+    /** Optional string value, e.g. for use as a command/route. */
+    value?: string;
+};
+/** A node in the tree, potentially containing lazily-loaded children. */
+export type TreeNode = {
+    item: TreeItem;
+    /**
+     * Child nodes.
+     * - `undefined` = children not yet loaded (component will call loadChildren if set)
+     * - `[]` = confirmed leaf / empty branch
+     * - non-empty array = loaded children
+     */
+    children?: TreeNode[];
+};
+/**
+ * Callback invoked when a node's children need to be loaded.
+ * The AbortSignal is cancelled if the request is superseded (e.g. node collapsed before load completes).
+ */
+export type LoadChildrenCallback = (node: TreeNode, depth: number, signal: AbortSignal) => TreeNode[] | Promise<TreeNode[]>;
+/**
+ * Predicate used by search/filter controllers to determine whether a node should be visible.
+ * Receives depth so column-scoped filtering (e.g. in ixfx-miller-list) is possible.
+ * Tree implementations that do not need depth can simply ignore the parameter.
+ */
+export type TreeFilterPredicate = (node: TreeNode, depth: number) => boolean;
+/**
+ * Controls how expanding a node affects its siblings.
+ * - `'none'`   — no constraint; any number of nodes may be expanded simultaneously
+ * - `'depth'`  — only one sibling at the same depth may be expanded at a time (accordion)
+ * - `'global'` — only one node anywhere in the tree may be expanded at a time
+ */
+export type TreeExclusivity = 'none' | 'depth' | 'global';
+/**
+ * Restricts which kinds of nodes may enter the selection.
+ * Applied as a guard in all interaction modes.
+ * - `'none'`   — no node can be selected (read-only / display-only)
+ * - `'leaf'`   — only leaf nodes are selectable
+ * - `'branch'` — only branch nodes (nodes with children) are selectable
+ * - `'all'`    — both leaf and branch nodes are selectable
+ */
+export type TreeSelectionFilter = 'none' | 'leaf' | 'branch' | 'all';
+/**
+ * Controls how pointer and keyboard gestures map to selection changes.
+ * - `'implicit'`  — single selection that follows the click; clicking always selects + toggles expand
+ * - `'standard'`  — single click selects+toggles; Ctrl/Cmd+click toggles item; Shift+click range-selects
+ * - `'manual'`    — component never auto-selects; use `select()`/`deselect()`/`clearSelection()` to drive state
+ * - `'checked'`   — checkboxes on every item; checkbox click toggles selection recursively; row click only expands/collapses
+ * - `'vscode'`    — like `standard` for clicks; Shift+arrow uses snapshot-based toggle-range
+ */
+export type TreeInteractionMode = 'implicit' | 'standard' | 'manual' | 'checked' | 'vscode';
+//# sourceMappingURL=types.d.ts.map

package/dist/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AACpC,MAAM,MAAM,QAAQ,GAAG;IACrB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,KAChB,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist/common/types.js

@@ -0,0 +1,6 @@
+/**
+ * Canonical shared types for all tree-like components (ixfx-tree-list, ixfx-miller-list,
+ * ixfx-crumb-navigation). Import from here rather than from individual component packages.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/crumbs/crumb-navigation.d.ts

@@ -0,0 +1,96 @@
+import type { PropertyValues } from 'lit';
+import type { LoadChildrenCallback, TreeNode } from '../tree/types.js';
+import type { TreeComponent } from '../common/tree-component.js';
+import type { TreeExclusivity, TreeFilterPredicate, TreeSelectionFilter } from '../common/types.js';
+import { TreeDataModel } from '../common/tree-data-model.js';
+import { LitElement } from 'lit';
+import '../menu/menu-trigger.js';
+import '../menu/menu-container.js';
+import '../menu/menu-item.js';
+import '../narrowed-text/index.js';
+/** @deprecated Use TreeSelectDetail from src/common/tree-component.ts */
+export type CrumbNavigationChangeDetail = {
+    readonly selected: TreeNode;
+    readonly previous: TreeNode | undefined;
+};
+export type CrumbNavigationChangeEvent = CustomEvent<CrumbNavigationChangeDetail>;
+export type CrumbNavigationItemClickDetail = {
+    node: TreeNode;
+    depth: number;
+};
+export type CrumbNavigationItemClickEvent = CustomEvent<CrumbNavigationItemClickDetail>;
+export type CrumbNavigationExpandDetail = {
+    node: TreeNode;
+    depth: number;
+};
+export type CrumbNavigationExpandEvent = CustomEvent<CrumbNavigationExpandDetail>;
+/**
+ * Breadcrumb navigation with lazy-loading support.
+ *
+ * Uses the same `TreeNode` / `TreeItem` data model as `ixfx-tree-list`,
+ * so the two components can be swapped with minimal code changes.
+ *
+ * Events
+ * - `navigate`: fired when user clicks a breadcrumb label. detail: `{ node: TreeNode }`
+ * - `change`: fired when selected node changes. detail: `{ selected: TreeNode, previous: TreeNode | undefined }`
+ * - `expand`: fired when user clicks a caret whose node has no children yet.
+ *             detail: `{ node: TreeNode, depth: number, signal: AbortSignal }`
+ *             Populate `node.children` then call `requestUpdate()` on the element.
+ *
+ * CSS variables
+ * --text-highlight: var(--accent); // highlight on mouse hover
+ * --separator: var(--surface-muted-text);   // text colour of separator character
+ * --padding-s: var(--space-xs);   // padding between items
+ */
+export declare class CrumbNavigationElement extends LitElement implements TreeComponent {
+    #private;
+    root: TreeNode | undefined;
+    model: TreeDataModel | undefined;
+    selectedNode: TreeNode | undefined;
+    private _selectedNodes;
+    get selectedNodes(): ReadonlySet<TreeNode>;
+    /** Callback to lazily load children for a node. When set, replaces event-based lazy loading. */
+    loadChildren: LoadChildrenCallback | undefined;
+    filterPredicate: TreeFilterPredicate | undefined;
+    exclusivity: TreeExclusivity;
+    selectionFilter: TreeSelectionFilter;
+    private _openIdx;
+    private _isFocused;
+    private _menuOpen;
+    private _focusOnNarrowedText;
+    inputMode: string;
+    private tickled;
+    select(node: TreeNode): void;
+    deselect(_node: TreeNode): void;
+    clearSelection(): void;
+    getNodes(): ReadonlyArray<{
+        node: TreeNode;
+        depth: number;
+    }>;
+    updated(changedProps: PropertyValues): void;
+    disconnectedCallback(): void;
+    /** Navigate to a node by key path. Returns false if any key is not found in already-loaded children. */
+    navigateTo(keys: readonly string[]): boolean;
+    /** Navigate to the first node matching the predicate. Returns false if not found. */
+    navigateToNode(predicate: (node: TreeNode) => boolean): boolean;
+    render(): import("lit").TemplateResult<1>;
+    static styles: import("lit").CSSResult[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ixfx-crumb-navigation": CrumbNavigationElement;
+    }
+}
+import type { TreeActivateEvent, TreeComponentEventMap, TreeExpandEvent, TreeItemClickEvent, TreeSelectEvent, TreeTickleEvent } from '../common/tree-component.js';
+export interface CrumbNavigationElementEventMap extends TreeComponentEventMap {
+    'item-click': TreeItemClickEvent;
+    'expand': TreeExpandEvent;
+    'select': TreeSelectEvent;
+    'tickle': TreeTickleEvent;
+    'activate': TreeActivateEvent;
+}
+export interface CrumbNavigationElement {
+    addEventListener<K extends keyof CrumbNavigationElementEventMap>(type: K, listener: (this: CrumbNavigationElement, event: CrumbNavigationElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+}
+//# sourceMappingURL=crumb-navigation.d.ts.map

package/dist/crumbs/crumb-navigation.d.ts.map

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