@openviking/react 0.0.0-stage → 0.1.1

package/dist/f~0.js

@@ -0,0 +1,284 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useId, useRef, useState } from "react";
+const chevron_downinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyBwcmVzZXJ2ZUFzcGVjdFJhdGlvPSJub25lIiBvdmVyZmxvdz0idmlzaWJsZSIgc3R5bGU9ImRpc3BsYXk6IGJsb2NrOyIgd2lkdGg9IjE0IiBoZWlnaHQ9IjE0IiB2aWV3Qm94PSIwIDAgMTQgMTQiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGlkPSJpY29uLyYjMjI4OyYjMTg0OyYjMTM5OyYjMjMwOyYjMTM5OyYjMTM3OyYjMjMxOyYjMTc0OyYjMTczOyYjMjI5OyYjMTY0OyYjMTgwOyI+CjxwYXRoIGlkPSJWZWN0b3IgKFN0cm9rZSkiIGQ9Ik05LjYwNzM0IDUuMjMyMzRDOS43NzgxOSA1LjA2MTQ5IDEwLjA1NTEgNS4wNjE0OSAxMC4yMjYgNS4yMzIzNEMxMC4zOTY4IDUuNDAzMTkgMTAuMzk2OCA1LjY4MDE0IDEwLjIyNiA1Ljg1MDk5TDcuMzA5MzMgOC43Njc2NkM3LjEzODQ3IDguOTM4NTEgNi44NjE1MyA4LjkzODUxIDYuNjkwNjcgOC43Njc2NkwzLjc3NDAxIDUuODUwOTlDMy42MDMxNSA1LjY4MDE0IDMuNjAzMTUgNS40MDMxOSAzLjc3NDAxIDUuMjMyMzRDMy45NDQ4NiA1LjA2MTQ5IDQuMjIxODEgNS4wNjE0OSA0LjM5MjY2IDUuMjMyMzRMNyA3LjgzOTY4TDkuNjA3MzQgNS4yMzIzNFoiIGZpbGw9IiMzRjNGNTEiLz4KPC9nPgo8L3N2Zz4K";
+function moveScopeFocus(event) {
+    if (![
+        'ArrowDown',
+        'ArrowUp',
+        'Home',
+        'End'
+    ].includes(event.key)) return;
+    const target = event.target;
+    const isSearch = target.matches('input.ov-scope-switcher__search');
+    if (event.defaultPrevented || !target.matches('[role="option"]') && !isSearch || isSearch && !event.key.startsWith('Arrow')) return;
+    const options = Array.from(event.currentTarget.querySelectorAll('[role="option"]:not([aria-disabled="true"])'));
+    if (!options.length) return;
+    event.preventDefault();
+    const current = options.indexOf(document.activeElement);
+    const next = 'Home' === event.key ? 0 : 'End' === event.key ? options.length - 1 : 'ArrowDown' === event.key ? (current + 1) % options.length : current < 0 ? options.length - 1 : (current - 1 + options.length) % options.length;
+    options[next]?.focus();
+}
+const checkinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyBwcmVzZXJ2ZUFzcGVjdFJhdGlvPSJub25lIiBvdmVyZmxvdz0idmlzaWJsZSIgc3R5bGU9ImRpc3BsYXk6IGJsb2NrOyIgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiB2aWV3Qm94PSIwIDAgMTYgMTYiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGlkPSJjaGVjayI+CjxwYXRoIGlkPSJJY29uIiBkPSJNMTMuMzMzMyA0TDYgMTEuMzMzM0wyLjY2NjY3IDgiIHN0cm9rZS13aWR0aD0iMS4yIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIHN0cm9rZT0iIzUyNTJGRiIvPgo8L2c+Cjwvc3ZnPgo=";
+function Highlight({ text, keyword }) {
+    const index = text.toLocaleLowerCase().indexOf(keyword.toLocaleLowerCase());
+    if (!keyword || index < 0) return /*#__PURE__*/ jsx(Fragment, {
+        children: text
+    });
+    return /*#__PURE__*/ jsxs(Fragment, {
+        children: [
+            text.slice(0, index),
+            /*#__PURE__*/ jsx("mark", {
+                children: text.slice(index, index + keyword.length)
+            }),
+            text.slice(index + keyword.length)
+        ]
+    });
+}
+function ScopePanel({ level, labels }) {
+    const focusPanel = useCallback((node)=>{
+        const target = node?.querySelector('input') ?? node?.querySelector('[role="option"][aria-selected="true"]:not([aria-disabled="true"])') ?? node?.querySelector('[role="option"]:not([aria-disabled="true"])');
+        (target ?? node)?.focus();
+    }, []);
+    const keyword = level.searchKeyword ?? '';
+    const searchVisible = level.onSearchKeywordChange && (keyword.length > 0 || Math.max(level.options.length, level.total ?? 0) > 10);
+    const search = searchVisible ? /*#__PURE__*/ jsx("input", {
+        type: "search",
+        className: "ov-scope-switcher__search",
+        value: keyword,
+        "aria-label": labels?.searchPlaceholder ?? 'Search',
+        placeholder: labels?.searchPlaceholder ?? 'Search',
+        onChange: (event)=>level.onSearchKeywordChange?.(event.currentTarget.value)
+    }) : null;
+    let list;
+    list = level.loading ? /*#__PURE__*/ jsx("div", {
+        className: "ov-scope-switcher__state",
+        role: "status",
+        children: labels?.loading ?? 'Loading…'
+    }) : level.error ? /*#__PURE__*/ jsx("div", {
+        className: "ov-scope-switcher__state",
+        role: "alert",
+        children: level.errorFallback ?? labels?.error ?? 'Unable to load options'
+    }) : level.options.length ? /*#__PURE__*/ jsx("div", {
+        className: "ov-scope-switcher__list",
+        role: "listbox",
+        "aria-label": level.ariaLabel ?? level.selectedLabel,
+        "aria-busy": level.busy,
+        onScroll: (event)=>{
+            const { scrollTop, scrollHeight, clientHeight } = event.currentTarget;
+            level.onScroll?.({
+                scrollTop,
+                scrollHeight,
+                clientHeight
+            });
+        },
+        children: level.options.map((option)=>{
+            const selected = option.id === level.selectedId;
+            const content = /*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    option.icon && /*#__PURE__*/ jsx("span", {
+                        className: "ov-scope-switcher__icon",
+                        "aria-hidden": "true",
+                        children: option.icon
+                    }),
+                    /*#__PURE__*/ jsxs("span", {
+                        className: "ov-scope-switcher__option-text",
+                        children: [
+                            /*#__PURE__*/ jsx("span", {
+                                children: /*#__PURE__*/ jsx(Highlight, {
+                                    text: option.label,
+                                    keyword: keyword
+                                })
+                            }),
+                            option.description && /*#__PURE__*/ jsx("small", {
+                                children: option.description
+                            })
+                        ]
+                    }),
+                    selected && /*#__PURE__*/ jsx("span", {
+                        className: "ov-scope-switcher__check",
+                        "aria-hidden": "true",
+                        children: /*#__PURE__*/ jsx("img", {
+                            src: checkinline_namespaceObject,
+                            alt: "",
+                            width: 16,
+                            height: 16
+                        })
+                    })
+                ]
+            });
+            return /*#__PURE__*/ jsx("div", {
+                tabIndex: option.disabled || level.busy ? -1 : 0,
+                role: "option",
+                "aria-selected": selected,
+                className: "ov-scope-switcher__option",
+                title: option.label,
+                "aria-disabled": option.disabled || level.busy || void 0,
+                onClick: (event)=>{
+                    const target = event.target;
+                    if (option.disabled || level.busy || target.closest('button, a, input, select, textarea, [role="button"]')) return;
+                    level.onSelect?.(option);
+                },
+                onKeyDown: (event)=>{
+                    if (event.target !== event.currentTarget || option.disabled || level.busy) return;
+                    if ('Enter' === event.key || ' ' === event.key) {
+                        event.preventDefault();
+                        level.onSelect?.(option);
+                    }
+                },
+                children: level.renderOption ? level.renderOption(content, option) : content
+            }, option.id);
+        })
+    }, keyword) : /*#__PURE__*/ jsx("div", {
+        className: "ov-scope-switcher__state",
+        role: "status",
+        children: level.emptyFallback ?? (keyword ? labels?.noMatch ?? labels?.empty ?? 'No matches' : labels?.empty ?? 'No options')
+    });
+    return /*#__PURE__*/ jsx("div", {
+        role: "group",
+        tabIndex: -1,
+        ref: focusPanel,
+        onKeyDownCapture: moveScopeFocus,
+        children: level.renderPanel ? level.renderPanel({
+            search,
+            list
+        }) : /*#__PURE__*/ jsxs(Fragment, {
+            children: [
+                search,
+                list
+            ]
+        })
+    });
+}
+function ScopeSelector({ level, labels }) {
+    const [localVisible, setLocalVisible] = useState(false);
+    const root = useRef(null);
+    const trigger = useRef(null);
+    const restoreSelectionFocus = useRef(false);
+    const panelId = useId();
+    const open = 'selectable' === level.kind && (level.visible ?? localVisible) && !level.disabled;
+    const onVisibleChange = 'selectable' === level.kind ? level.onVisibleChange : void 0;
+    const changeVisible = useCallback((visible)=>{
+        setLocalVisible(visible);
+        onVisibleChange?.(visible);
+    }, [
+        onVisibleChange
+    ]);
+    useEffect(()=>{
+        if (!open) return;
+        const dismiss = (event)=>{
+            if (event.target instanceof Node && !root.current?.contains(event.target)) changeVisible(false);
+        };
+        const escape = (event)=>{
+            if ('Escape' === event.key) {
+                event.preventDefault();
+                changeVisible(false);
+                trigger.current?.focus();
+            }
+        };
+        document.addEventListener('pointerdown', dismiss);
+        document.addEventListener('keydown', escape);
+        return ()=>{
+            document.removeEventListener('pointerdown', dismiss);
+            document.removeEventListener('keydown', escape);
+        };
+    }, [
+        open,
+        changeVisible
+    ]);
+    useEffect(()=>{
+        if (open || !restoreSelectionFocus.current) return;
+        restoreSelectionFocus.current = false;
+        if (document.activeElement === document.body || root.current?.contains(document.activeElement)) trigger.current?.focus();
+    }, [
+        open
+    ]);
+    const content = /*#__PURE__*/ jsxs(Fragment, {
+        children: [
+            level.icon && /*#__PURE__*/ jsx("span", {
+                className: "ov-scope-switcher__icon",
+                "aria-hidden": "true",
+                children: level.icon
+            }),
+            /*#__PURE__*/ jsx("span", {
+                className: "ov-scope-switcher__label",
+                children: level.selectedLabel
+            }),
+            level.tag && /*#__PURE__*/ jsx("span", {
+                className: "ov-scope-switcher__tag",
+                children: level.tag
+            })
+        ]
+    });
+    return /*#__PURE__*/ jsxs("div", {
+        ref: root,
+        role: "group",
+        className: "ov-scope-switcher__level",
+        onBlur: (event)=>{
+            if (open && event.relatedTarget instanceof Node && !event.currentTarget.contains(event.relatedTarget)) changeVisible(false);
+        },
+        children: [
+            'fixed' === level.kind ? /*#__PURE__*/ jsx("span", {
+                className: "ov-scope-switcher__trigger",
+                "aria-label": level.ariaLabel,
+                title: level.selectedLabel,
+                children: content
+            }) : /*#__PURE__*/ jsxs("button", {
+                ref: trigger,
+                type: "button",
+                className: "ov-scope-switcher__trigger",
+                "aria-label": level.ariaLabel,
+                title: level.selectedLabel,
+                disabled: level.disabled,
+                "aria-expanded": open,
+                "aria-haspopup": "dialog",
+                "aria-controls": open ? panelId : void 0,
+                onClick: ()=>changeVisible(!open),
+                onKeyDown: (event)=>{
+                    if ('ArrowDown' === event.key || 'ArrowUp' === event.key) {
+                        event.preventDefault();
+                        if (open) root.current?.querySelector('[role="option"]:not([aria-disabled="true"])')?.focus();
+                        else changeVisible(true);
+                    }
+                },
+                children: [
+                    content,
+                    /*#__PURE__*/ jsx("span", {
+                        className: "ov-scope-switcher__arrow",
+                        "aria-hidden": "true",
+                        children: /*#__PURE__*/ jsx("img", {
+                            src: chevron_downinline_namespaceObject,
+                            alt: "",
+                            width: 14,
+                            height: 14
+                        })
+                    })
+                ]
+            }),
+            open && 'selectable' === level.kind && /*#__PURE__*/ jsx("div", {
+                id: panelId,
+                className: "ov-scope-switcher__panel",
+                role: "dialog",
+                "aria-label": level.ariaLabel ?? level.selectedLabel,
+                children: /*#__PURE__*/ jsx(ScopePanel, {
+                    level: {
+                        ...level,
+                        onSelect: (option)=>{
+                            restoreSelectionFocus.current = true;
+                            changeVisible(false);
+                            level.onSelect?.(option);
+                        }
+                    },
+                    labels: labels
+                })
+            })
+        ]
+    });
+}
+function ScopeSwitcher({ children, className = '', ...props }) {
+    return /*#__PURE__*/ jsx("div", {
+        ...props,
+        className: `ov-scope-switcher ${className}`,
+        children: children
+    });
+}
+export { ScopeSelector, ScopeSwitcher };

package/dist/icons/index.d.ts

@@ -0,0 +1,23 @@
+import type { ComponentPropsWithoutRef } from 'react';
+type IconProps = Omit<ComponentPropsWithoutRef<'img'>, 'src' | 'srcSet'>;
+export declare const AudioIcon: {
+    (props: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const PdfIcon: {
+    (props: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const PptIcon: {
+    (props: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const VideoIcon: {
+    (props: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const WordIcon: {
+    (props: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/icons.js

@@ -0,0 +1,25 @@
+import { jsx } from "react/jsx-runtime";
+const audioinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2IiBmaWxsPSJub25lIj4KICA8cmVjdCB4PSIzIiB5PSIyIiB3aWR0aD0iMTEiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjN2MzYWVkIi8+CiAgPGcgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjEuMSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj4KICAgIDxwYXRoIGQ9Ik03IDExVjdsNC0xdjRNNyAxMUg2bTUtMWgtMSIvPgogIDwvZz4KPC9zdmc+Cg==";
+const pdfinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2IiBmaWxsPSJub25lIj4KICA8cmVjdCB4PSIzIiB5PSIyIiB3aWR0aD0iMTEiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjYjkxYzFjIi8+CiAgPGcgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjEuMSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj4KICAgIDxwYXRoIGQ9Ik02IDExVjZoM3YzSDZtNCAyaDEiLz4KICA8L2c+Cjwvc3ZnPgo=";
+const pptinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2IiBmaWxsPSJub25lIj4KICA8cmVjdCB4PSIzIiB5PSIyIiB3aWR0aD0iMTEiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjYzI0MTBjIi8+CiAgPGcgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjEuMSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj4KICAgIDxwYXRoIGQ9Ik02IDdoNXY0SDZ6bTIuNSA0djEiLz4KICA8L2c+Cjwvc3ZnPgo=";
+const videoinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2IiBmaWxsPSJub25lIj4KICA8cmVjdCB4PSIzIiB5PSIyIiB3aWR0aD0iMTEiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjMDM2OWExIi8+CiAgPGcgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjEuMSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj4KICAgIDxwYXRoIGQ9Im03IDYgNCAyLjVMNyAxMXoiLz4KICA8L2c+Cjwvc3ZnPgo=";
+const wordinline_namespaceObject = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2IiBmaWxsPSJub25lIj4KICA8cmVjdCB4PSIzIiB5PSIyIiB3aWR0aD0iMTEiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjMWQ0ZWQ4Ii8+CiAgPGcgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjEuMSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj4KICAgIDxwYXRoIGQ9Im01LjUgNyAxIDQgMi0zIDIgMyAxLTQiLz4KICA8L2c+Cjwvc3ZnPgo=";
+function createIcon(src, name) {
+    function Icon(props) {
+        return /*#__PURE__*/ jsx("img", {
+            alt: "",
+            width: 16,
+            height: 16,
+            ...props,
+            src: src
+        });
+    }
+    Icon.displayName = name;
+    return Icon;
+}
+const AudioIcon = createIcon(audioinline_namespaceObject, 'AudioIcon');
+const PdfIcon = createIcon(pdfinline_namespaceObject, 'PdfIcon');
+const PptIcon = createIcon(pptinline_namespaceObject, 'PptIcon');
+const VideoIcon = createIcon(videoinline_namespaceObject, 'VideoIcon');
+const WordIcon = createIcon(wordinline_namespaceObject, 'WordIcon');
+export { AudioIcon, PdfIcon, PptIcon, VideoIcon, WordIcon };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { FileTree } from './components/file-tree/index.js';
+export type { FileTreeProps } from './components/file-tree/index.js';
+export { Tui } from './components/tui/index.js';
+export type { TuiProps } from './components/tui/index.js';
+export { ScopeSwitcher, ScopeSelector, } from './components/scope-switcher/index.js';
+export type { ScopeSwitcherProps, ScopeSelectorProps, } from './components/scope-switcher/index.js';
+export { AgentConnect } from './components/agent-connect/index.js';
+export type { AgentConnectProps } from './components/agent-connect/index.js';
+export { FileBrowser } from './modules/file-browser/index.js';
+export type { FileBrowserProps } from './modules/file-browser/index.js';
+export { Console } from './modules/console/index.js';
+export type { ConsoleProps } from './modules/console/index.js';
+export { TaskCenter } from './modules/task-center/index.js';
+export type { TaskCenterProps } from './modules/task-center/index.js';
+export { ScopeCascade } from './modules/scope-cascade/index.js';
+export type { ScopeCascadeProps } from './modules/scope-cascade/index.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+export { AgentConnect } from "./u~0.js";
+export { Console } from "./a~0.js";
+export { FileBrowser } from "./l~0.js";
+export { FileTree } from "./n~0.js";
+export { ScopeCascade } from "./lk~0.js";
+export { ScopeSelector, ScopeSwitcher } from "./f~0.js";
+export { TaskCenter } from "./i~0.js";
+export { Tui } from "./3~0.js";

package/dist/i~0.js

@@ -0,0 +1,21 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+function TaskCenter({ className, style, labels }) {
+    return /*#__PURE__*/ jsxs("div", {
+        className: [
+            'ov-module-placeholder',
+            className
+        ].filter(Boolean).join(' '),
+        style: style,
+        children: [
+            /*#__PURE__*/ jsx("p", {
+                className: "ov-module-placeholder__title",
+                children: labels?.title ?? 'Task center'
+            }),
+            /*#__PURE__*/ jsx("p", {
+                className: "ov-module-placeholder__description",
+                children: labels?.description ?? 'Placeholder. Functionality is not available yet.'
+            })
+        ]
+    });
+}
+export { TaskCenter };

package/dist/lk~0.js

@@ -0,0 +1,220 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useSyncExternalStore } from "react";
+import { ScopeSelector, ScopeSwitcher } from "./f~0.js";
+const indices = [
+    0,
+    1,
+    2
+];
+const empty = (enabled, parentIds = [])=>({
+        options: [],
+        enabled,
+        loading: false,
+        error: null,
+        scopeKey: JSON.stringify(parentIds),
+        parentIds
+    });
+function createScopeController() {
+    const snapshots = [
+        empty(true),
+        empty(false),
+        empty(false)
+    ];
+    const listeners = indices.map(()=>new Set());
+    const requests = [];
+    let api;
+    let active = false;
+    const notify = (index)=>listeners[index].forEach((listener)=>listener());
+    const update = (index, patch)=>{
+        snapshots[index] = {
+            ...snapshots[index],
+            ...patch
+        };
+    };
+    const abort = (index)=>{
+        requests[index]?.abort();
+        requests[index] = void 0;
+    };
+    const resetDescendants = (index)=>{
+        for(let next = index + 1; next < 3; next++){
+            abort(next);
+            const ancestors = snapshots.slice(0, next).map((item)=>item.selected?.id);
+            snapshots[next] = empty(ancestors.every((id)=>void 0 !== id), ancestors.filter((id)=>void 0 !== id));
+        }
+    };
+    const load = async (index)=>{
+        if (!active || !api || !snapshots[index].enabled) return;
+        abort(index);
+        const request = new AbortController();
+        requests[index] = request;
+        update(index, {
+            loading: true,
+            error: null
+        });
+        notify(index);
+        try {
+            const libraryId = snapshots[0].selected?.id;
+            const spaceId = snapshots[1].selected?.id;
+            const options = await (0 === index ? api.loadLibraries(request.signal) : 1 === index ? api.loadSpaces(libraryId, request.signal) : api.loadUsers(libraryId, spaceId, request.signal));
+            if (!active || request.signal.aborted || requests[index] !== request) return;
+            const previous = snapshots[index].selected;
+            const selected = options.find((option)=>option.id === previous?.id && !option.disabled);
+            update(index, {
+                options,
+                selected,
+                loading: false,
+                error: null
+            });
+            const revoked = void 0 !== previous && void 0 === selected;
+            if (revoked) resetDescendants(index);
+            notify(index);
+            if (revoked) for(let next = index + 1; next < 3; next++)notify(next);
+        } catch (error) {
+            if (!active || request.signal.aborted || requests[index] !== request) return;
+            update(index, {
+                loading: false,
+                error: error instanceof Error ? error : new Error(String(error))
+            });
+            notify(index);
+        }
+    };
+    const select = (index, candidate)=>{
+        const state = snapshots[index];
+        if (!active || !state.enabled || state.loading || state.error) return;
+        const option = state.options.find((item)=>item.id === candidate.id && !item.disabled);
+        if (!option || option.id === state.selected?.id) return;
+        update(index, {
+            selected: option
+        });
+        resetDescendants(index);
+        for(let next = index; next < 3; next++)notify(next);
+        if (index < 2) load(index + 1);
+    };
+    const channel = (index)=>({
+            getSnapshot: ()=>snapshots[index],
+            subscribe: (listener)=>{
+                listeners[index].add(listener);
+                return ()=>{
+                    listeners[index].delete(listener);
+                };
+            },
+            select: (option)=>select(index, option),
+            refresh: ()=>{
+                load(index);
+            }
+        });
+    const controller = {
+        levels: [
+            channel(0),
+            channel(1),
+            channel(2)
+        ]
+    };
+    return {
+        controller,
+        start (nextApi) {
+            api = nextApi;
+            active = true;
+            indices.forEach((index)=>{
+                abort(index);
+                snapshots[index] = empty(0 === index);
+            });
+            indices.forEach(notify);
+            load(0);
+            return ()=>{
+                active = false;
+                indices.forEach(abort);
+            };
+        }
+    };
+}
+function useScopeCascade({ loadLibraries, loadSpaces, loadUsers }) {
+    const [instance] = useState(createScopeController);
+    useEffect(()=>instance.start({
+            loadLibraries,
+            loadSpaces,
+            loadUsers
+        }), [
+        instance,
+        loadLibraries,
+        loadSpaces,
+        loadUsers
+    ]);
+    return instance.controller;
+}
+function useScopeCascadeLevel(level) {
+    return useSyncExternalStore(level.subscribe, level.getSnapshot, level.getSnapshot);
+}
+function ConnectedLevel(props) {
+    const state = useScopeCascadeLevel(props.level);
+    return /*#__PURE__*/ jsx(LevelView, {
+        ...props,
+        state: state
+    }, state.scopeKey);
+}
+function LevelView({ level, state, name, labels, retryLabel }) {
+    const [keyword, setKeyword] = useState('');
+    return /*#__PURE__*/ jsx(ScopeSelector, {
+        labels: labels,
+        level: {
+            kind: 'selectable',
+            key: name,
+            ariaLabel: name,
+            selectedId: state.selected?.id ?? '',
+            selectedLabel: state.selected?.label ?? name,
+            icon: state.selected?.icon,
+            disabled: !state.enabled,
+            options: state.options.filter((option)=>option.label.toLocaleLowerCase().includes(keyword.toLocaleLowerCase())),
+            total: state.options.length,
+            loading: state.loading,
+            error: null !== state.error,
+            searchKeyword: keyword,
+            onSearchKeywordChange: setKeyword,
+            onSelect: (option)=>{
+                level.select(option);
+                setKeyword('');
+            },
+            errorFallback: /*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    labels?.error ?? 'Unable to load options',
+                    ' ',
+                    /*#__PURE__*/ jsx("button", {
+                        type: "button",
+                        onClick: level.refresh,
+                        children: retryLabel ?? 'Retry'
+                    })
+                ]
+            })
+        }
+    });
+}
+function ScopeCascade({ controller, labels, levelNames = [
+    'Library',
+    'Space',
+    'User'
+], retryLabel, ...props }) {
+    return /*#__PURE__*/ jsxs(ScopeSwitcher, {
+        ...props,
+        children: [
+            /*#__PURE__*/ jsx(ConnectedLevel, {
+                level: controller.levels[0],
+                name: levelNames[0],
+                labels: labels,
+                retryLabel: retryLabel
+            }),
+            /*#__PURE__*/ jsx(ConnectedLevel, {
+                level: controller.levels[1],
+                name: levelNames[1],
+                labels: labels,
+                retryLabel: retryLabel
+            }),
+            /*#__PURE__*/ jsx(ConnectedLevel, {
+                level: controller.levels[2],
+                name: levelNames[2],
+                labels: labels,
+                retryLabel: retryLabel
+            })
+        ]
+    });
+}
+export { ScopeCascade, useScopeCascade, useScopeCascadeLevel };

package/dist/l~0.js

@@ -0,0 +1,44 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+function FileBrowserToolbarButton({ icon, children, onClick, disabled, className, ...rest }) {
+    return /*#__PURE__*/ jsxs("button", {
+        ...rest,
+        type: "button",
+        disabled: disabled,
+        className: [
+            'ov-file-browser__toolbar-button',
+            className
+        ].filter(Boolean).join(' '),
+        onClick: onClick,
+        children: [
+            /*#__PURE__*/ jsx("span", {
+                className: "ov-file-browser__toolbar-button-icon",
+                "aria-hidden": "true",
+                children: icon
+            }),
+            /*#__PURE__*/ jsx("span", {
+                className: "ov-file-browser__toolbar-button-label",
+                children: children
+            })
+        ]
+    });
+}
+function FileBrowser({ className, style, labels }) {
+    return /*#__PURE__*/ jsxs("div", {
+        className: [
+            'ov-module-placeholder',
+            className
+        ].filter(Boolean).join(' '),
+        style: style,
+        children: [
+            /*#__PURE__*/ jsx("p", {
+                className: "ov-module-placeholder__title",
+                children: labels?.title ?? 'File browser'
+            }),
+            /*#__PURE__*/ jsx("p", {
+                className: "ov-module-placeholder__description",
+                children: labels?.description ?? 'Placeholder. Functionality is not available yet.'
+            })
+        ]
+    });
+}
+export { FileBrowser, FileBrowserToolbarButton };

package/dist/modules/console/console.d.ts

@@ -0,0 +1,4 @@
+import type { ConsoleProps } from './types.js';
+export type { ConsoleLabels, ConsoleMode, ConsoleProps, ConsoleSlots, } from './types.js';
+/** 占位组件：渲染一个带模块名的空容器，真实实现随模块 Hook 与组合视图迁入。 */
+export declare function Console({ className, style, labels }: ConsoleProps): import("react").JSX.Element;

package/dist/modules/console/index.d.ts

@@ -0,0 +1 @@
+export * from './console.js';