dsh-plugin-core 0.31.0 → 0.33.0

package/dist/ui/layout/PanelDock.js

@@ -0,0 +1,390 @@
+/**
+ * 停靠面板（PanelDock）—— 可停靠的右侧分栏容器。
+ *
+ * 形态：**布局成员，不是浮层**。占宽度、把主区挤窄，因此必须由调用方放进自己的
+ * flex 根容器里；不能像 Modal 那样自挂 `document.body`（自挂只能遮盖、挤不窄）。
+ *
+ * 分工照成熟组件库的通行做法（Ant Design `Tabs` / `Drawer` 同一套）：
+ *   · **结构写在调用点** —— `<PanelDock dock={dock}><DockPanel id="files">…</DockPanel></PanelDock>`；
+ *   · **显隐归状态** —— `dock.open('files')` / `dock.close('files')`，只传 id，不传内容；
+ *   · **头部可控** —— `title` / `icon` / `extra` 三件套；要更自由就 `header` 整块替换，`header={null}` 表示不要头部；
+ *   · **关闭钮可退让** —— `closable={false}` 不出；`closeButton="floating"` 浮在右上角，不占头部布局。
+ */
+import { Children, createElement as h, isValidElement, useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { createPortal } from 'react-dom';
+import { t } from '../../utils/i18n.js';
+import { startResizeLayoutWidth } from './resizer.js';
+import { DEFAULT_PANEL_ID, clampWidth, closePanel, collapsePanel, emptyDock, expandPanel, isCollapsed as isCollapsedState, isOpen, openPanel, othersWidth, setPanelWidth, } from './panel-dock-logic.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { PANEL_DOCK_CSS } from './panel-dock-css.js';
+import { SIDE_PANEL_CSS } from '../infra/side-panel-css.js';
+import { FEEDBACK_CSS } from '../feedback/feedback-css.js';
+// ── 分栏占宽契约（用户 2026-10-22 拍板）──
+// 遮罩必须知道「页面右侧被分栏占掉多少」，否则它会把 dock 一起压暗、还吃掉点击
+// （`.dshpc-overlay` 的 right inset 读的就是这个变量）。挂在根元素上，是因为遮罩不保证
+// 是本 dock 那个 flex 行的后代；同页多个 dock 按实例求和，全部关掉即移除变量。
+const INSET_VAR = '--dshpc-page-inset-right';
+const dockInsets = new Map();
+let dockSeq = 0;
+function publishInset(key, width, el) {
+    // 先摘掉「元素已离开文档」的条目：有人绕过 close 直接 remove 挂载体时，React 的卸载
+    // 清理不会跑，这份残留宽度会把遮罩永久卡在让位状态（2026-10-22 真机踩过）。
+    for (const [stale, entry] of dockInsets) {
+        if (entry.el !== null && !entry.el.isConnected)
+            dockInsets.delete(stale);
+    }
+    if (width > 0)
+        dockInsets.set(key, { width, el });
+    else
+        dockInsets.delete(key);
+    if (typeof document === 'undefined')
+        return;
+    let total = 0;
+    for (const entry of dockInsets.values())
+        total += entry.width;
+    const style = document.documentElement.style;
+    if (total > 0)
+        style.setProperty(INSET_VAR, `${Math.round(total)}px`);
+    else
+        style.removeProperty(INSET_VAR);
+}
+/**
+ * 声明一个面板。**它自己不渲染任何东西**——由父级 `<PanelDock>` 读它的 props 后统一画。
+ * 因此必须作为 `<PanelDock>` 的**直接子元素**（可以条件渲染成 `null`）。
+ */
+export function DockPanel(_props) {
+    return null;
+}
+function readStoredWidth(key) {
+    try {
+        if (typeof localStorage === 'undefined')
+            return null;
+        const raw = localStorage.getItem(key);
+        if (raw === null)
+            return null;
+        const value = Number(raw);
+        return Number.isFinite(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeStoredWidth(key, width) {
+    try {
+        if (typeof localStorage === 'undefined')
+            return;
+        localStorage.setItem(key, String(width));
+    }
+    catch {
+        /* 隐私模式 / 配额满：记忆失败不影响功能 */
+    }
+}
+/**
+ * 造一个面板控制器。状态在它身上，组件用 `useSyncExternalStore` 订阅。
+ *
+ * 为什么状态不放在组件里：开门/关门常常发生在按钮 onClick、事件回调里（命令式），
+ * 而**内容与头部仍在调用点声明**——这正是 Tabs 那种「状态 + children」的分工。
+ */
+export function createPanelDock(options = {}) {
+    const maxPanels = options.maxPanels ?? 3;
+    const defaultWidth = options.defaultWidth ?? 460;
+    const minWidth = options.minWidth ?? 320;
+    const storageKey = options.storageKey ?? 'dshpc-dock';
+    const widthKey = (id) => (storageKey === false ? '' : `${storageKey}:width:${id}`);
+    let state = emptyDock();
+    const listeners = new Set();
+    const emit = (next) => {
+        if (next === state)
+            return;
+        state = next;
+        for (const listener of listeners)
+            listener();
+    };
+    const controller = {
+        defaults: { maxPanels, defaultWidth, minWidth },
+        open(id = DEFAULT_PANEL_ID) {
+            const { state: next, result } = openPanel(state, id, maxPanels);
+            if (result.ok && result.created) {
+                const stored = storageKey === false ? null : readStoredWidth(widthKey(id));
+                emit(stored === null ? next : setPanelWidth(next, id, stored));
+                options.onOpen?.({ id, created: true });
+            }
+            else if (result.ok) {
+                emit(next);
+            }
+            else {
+                options.onLimitReached?.({ id });
+            }
+            return result;
+        },
+        close(id = DEFAULT_PANEL_ID, reason = 'api') {
+            // 对已收起的耳朵也放行：关闭 = 连耳朵一起抹掉。
+            if (!isOpen(state, id) && !isCollapsedState(state, id))
+                return;
+            if (options.onBeforeClose?.({ id, reason }) === false)
+                return;
+            emit(closePanel(state, id));
+            options.onClose?.({ id, reason });
+        },
+        toggle(id = DEFAULT_PANEL_ID) {
+            if (controller.isOpen(id)) {
+                controller.close(id, 'api');
+                return { ok: true, id, created: false };
+            }
+            return controller.open(id);
+        },
+        collapse(id = DEFAULT_PANEL_ID) {
+            if (!isOpen(state, id))
+                return;
+            emit(collapsePanel(state, id));
+        },
+        expand(id = DEFAULT_PANEL_ID) {
+            if (!isCollapsedState(state, id))
+                return;
+            // 展开也是「多开一栏」，同样受数量闸约束；不静默超额。
+            if (state.ids.length >= maxPanels) {
+                options.onLimitReached?.({ id });
+                return;
+            }
+            emit(expandPanel(state, id));
+        },
+        isOpen(id = DEFAULT_PANEL_ID) {
+            return isOpen(state, id);
+        },
+        isCollapsed(id = DEFAULT_PANEL_ID) {
+            return isCollapsedState(state, id);
+        },
+        ids() {
+            return state.ids;
+        },
+        setWidth(id, width) {
+            const next = setPanelWidth(state, id, width);
+            if (next === state)
+                return;
+            emit(next);
+            if (storageKey !== false)
+                writeStoredWidth(widthKey(id), width);
+            options.onResize?.({ id, width });
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        getSnapshot() {
+            return state;
+        },
+    };
+    return controller;
+}
+/** 收集直接子元素里的 `<DockPanel>`；顺序即渲染顺序（与打开顺序无关，稳定）。 */
+function panesOf(children) {
+    const out = [];
+    Children.forEach(children, (child) => {
+        if (isValidElement(child) && child.type === DockPanel)
+            out.push(child.props);
+    });
+    return out;
+}
+/** 停靠栏本体：只渲染「开着的」面板，结构取自对应的 `<DockPanel>`。 */
+export function PanelDock(props) {
+    ensureComponentStyles('side-panel', SIDE_PANEL_CSS);
+    ensureComponentStyles('panel-dock', PANEL_DOCK_CSS);
+    ensureComponentStyles('feedback', FEEDBACK_CSS);
+    const tt = props.translate ?? t;
+    const state = useSyncExternalStore(props.dock.subscribe, props.dock.getSnapshot, props.dock.getSnapshot);
+    const rootRef = useRef(null);
+    const panelRefs = useRef(new Map());
+    const panes = panesOf(props.children);
+    const { defaultWidth, minWidth: fallbackMin } = props.dock.defaults;
+    // 记忆里那份宽度也过一遍夹：上次在宽屏拖到 900，换窄窗口重开会把主区挤没。
+    const widthOf = (pane) => clampWidth(state.widths[pane.id] ?? pane.width ?? defaultWidth, pane.minWidth ?? fallbackMin, pane.maxWidth);
+    // 耳朵**只显示一个箭头**（用户 2026-10-28 三轮：图标也不放，那会把面板的玩意带出来）。
+    // 名字只进无障碍名：优先面板标题（字符串），否则无障碍名，再退回组名。
+    const earLabelOf = (id) => {
+        const pane = panes.find((item) => item.id === id);
+        if (pane === undefined)
+            return id;
+        if (typeof pane.title === 'string')
+            return pane.title;
+        if (typeof pane.ariaLabel === 'string')
+            return pane.ariaLabel;
+        return id;
+    };
+    // 收起的出场动效：先把栏宽收到 0（CSS transition），落定后再真正退出布局 ——
+    // 用户 2026-10-28：「突然就出来了，特别奇怪」。展开方向的入场走 CSS 挂载动画，不需要 JS。
+    const [closing, setClosing] = useState([]);
+    const collapseWithAnim = (id) => {
+        setClosing((prev) => (prev.includes(id) ? prev : [...prev, id]));
+        window.setTimeout(() => {
+            setClosing((prev) => prev.filter((item) => item !== id));
+            props.dock.collapse(id);
+        }, 220);
+    };
+    // 关闭（不只是收起）也要收回去（用户 2026-11-02）：id 从 ids 消失后先留在 DOM 里收宽 220ms 再摘。
+    // 收起流程走完会把 id 挪进 collapsed，那种不算「关闭」，要排除掉，否则多演一遍。
+    const prevIds = useRef(state.ids);
+    useEffect(() => {
+        const gone = prevIds.current.filter((id) => !state.ids.includes(id) && !state.collapsed.includes(id));
+        prevIds.current = state.ids;
+        if (gone.length === 0)
+            return;
+        setClosing((prev) => [...prev, ...gone.filter((id) => !prev.includes(id))]);
+        window.setTimeout(() => setClosing((prev) => prev.filter((id) => !gone.includes(id))), 220);
+    }, [state.ids, state.collapsed]);
+    // 本 dock 在「页面右侧占宽」里的那一份：实例唯一键，拖拽期也用它实时更新。
+    const insetKey = useRef('');
+    if (insetKey.current === '')
+        insetKey.current = `dock-${++dockSeq}`;
+    const restWidth = (paneId) => othersWidth(state, paneId, (id) => {
+        const other = panes.find((item) => item.id === id);
+        return other === undefined ? defaultWidth : widthOf(other);
+    });
+    const totalWidth = panes
+        .filter((pane) => state.ids.includes(pane.id))
+        .reduce((sum, pane) => sum + widthOf(pane), 0);
+    // 开合 / 拖宽松手后同步一次（拖拽中的实时值由 onMove 写）；卸载归零，别把变量留给下一个人。
+    // 让位量 = 已开栏宽（不留缝：滚动条的 1px 让位在主区容器自己身上）。
+    useEffect(() => {
+        publishInset(insetKey.current, state.ids.length > 0 ? totalWidth : 0, rootRef.current);
+    });
+    useEffect(() => () => {
+        publishInset(insetKey.current, 0, null);
+    }, []);
+    // 打开但没声明的 id 得说出来，否则用户只会看到一个永远空白的面板。
+    for (const id of state.ids) {
+        if (!panes.some((pane) => pane.id === id)) {
+            console.warn(`[dsh-plugin-core] PanelDock: 面板 "${id}" 已打开但没有对应的 <DockPanel id="${id}"> 声明`);
+        }
+    }
+    const beginResize = (pane, event) => {
+        const element = panelRefs.current.get(pane.id);
+        if (element === undefined || typeof window === 'undefined')
+            return;
+        const startX = event.clientX;
+        const startWidth = widthOf(pane);
+        const min = pane.minWidth ?? fallbackMin;
+        const mainMin = props.mainMinWidth ?? 480;
+        // 拖拽期点亮**这一栏**：染的是面板自己的 border-left，不是另画一条线（用户 2026-10-28 四轮）。
+        element.classList.add('dshpc-dock__panel--resizing');
+        startResizeLayoutWidth({
+            startEvent: event,
+            root: rootRef.current,
+            rootClass: 'dshpc-dock--resizing',
+            rafThrottle: true,
+            compute: (clientX) => {
+                const viewportMax = window.innerWidth - restWidth(pane.id) - mainMin;
+                const businessMax = pane.maxWidth ?? Number.POSITIVE_INFINITY;
+                const max = Math.min(viewportMax, businessMax);
+                return clampWidth(startWidth + (startX - clientX), min, Math.max(min, max));
+            },
+            onMove: (width) => {
+                element.style.width = `${width}px`;
+                // 遮罩的右边界跟着走，否则拖出去的那条缝会被遮罩压住（用户 2026-10-22）。
+                publishInset(insetKey.current, restWidth(pane.id) + width, rootRef.current);
+            },
+            onCommit: (width) => {
+                element.classList.remove('dshpc-dock__panel--resizing');
+                props.dock.setWidth(pane.id, width);
+            },
+        });
+    };
+    // 关钮一律**绝对定位**在面板右上（top 10 / right 8，与内置头完全一致）：
+    // ① 不占头部布局宽度 —— 自定义头因此拿到整行（下划线能顶到最右）；
+    // ② 锚在面板上、不在 body 滚动内容里 —— 正文怎么滚它都不动；
+    // ③ 内置头的标题区用 padding-right 预留出它的位置，谁也不压谁。
+    const headerCloseOf = (pane) => {
+        const closable = pane.closable !== false;
+        const mode = pane.closeButton ?? 'auto';
+        const hasHeader = pane.header !== null;
+        if (!closable || !(mode === 'header' || (mode === 'auto' && hasHeader)))
+            return null;
+        return h('button', {
+            type: 'button',
+            className: 'dshpc-dock__close dshpc-dock__close--abs',
+            'aria-label': tt('dockClose'),
+            onClick: () => props.dock.close(pane.id, 'button'),
+        }, pane.closeIcon ?? '✕');
+    };
+    const renderHeader = (pane) => {
+        if (pane.header === null)
+            return null;
+        if (pane.header !== undefined) {
+            // 自定义头部：整行都归调用方 —— 库不加内边距/边框/背景。
+            return h('div', { className: 'dshpc-dock__head dshpc-dock__head--custom' }, pane.header);
+        }
+        return h('div', { className: 'dshpc-dock__head' }, pane.icon === undefined ? null : h('div', { className: 'dshpc-dock__lead' }, pane.icon), h('div', { className: 'dshpc-dock__title' }, pane.title), pane.extra === undefined ? null : h('div', { className: 'dshpc-dock__extra' }, pane.extra));
+    };
+    const floatingCloseOf = (pane) => {
+        if (pane.closable === false)
+            return null;
+        const mode = pane.closeButton ?? 'auto';
+        const hasHeader = pane.header !== null;
+        if (mode !== 'floating' && !(mode === 'auto' && !hasHeader))
+            return null;
+        return h('button', {
+            type: 'button',
+            className: 'dshpc-dock__close dshpc-dock__close--floating',
+            'aria-label': tt('dockClose'),
+            onClick: () => props.dock.close(pane.id, 'button'),
+        }, pane.closeIcon ?? '✕');
+    };
+    // 开着时根元素带 --open：CSS 据此给主区滚动条让出一条缝（全关即无缝，不留白边）。
+    const rootClass = `dshpc-dock${state.ids.length > 0 ? ' dshpc-dock--open' : ''}${props.className === undefined ? '' : ` ${props.className}`}`;
+    // 收起后的耳朵：**独立的 fixed 浮层**，与分栏不是一体（用户 2026-10-28 口径）。
+    // portal 到 body：dock 有时在弹窗 DOM 里，留在原地会被弹窗的 stacking context 关住，
+    // 遮罩一盖就点不到（2026-11-04 真机）。层序走 --dshpc-z-ear（高于遮罩）。
+    const ears = state.collapsed.length === 0
+        ? null
+        : h('div', { className: 'dshpc-dock__ears' }, state.collapsed.map((id) => {
+            const label = earLabelOf(id);
+            return h('button', {
+                key: id,
+                type: 'button',
+                className: 'dshpc-dock__ear',
+                // 不放 title：原生 tooltip 会把面板标题弹出来，用户明确「不要显示任何标题」。
+                'aria-label': `${label} · ${tt('dockExpand')}`,
+                onClick: () => props.dock.expand(id),
+            }, 
+            // 只有一个箭头，与收起钮同尺寸反向：收起钮 ›（往右收），耳朵 ‹（往左拉回来）。
+            h('span', { className: 'dshpc-dock__ear-arrow', 'aria-hidden': true }, '‹'));
+        }));
+    return h('div', {
+        ref: rootRef,
+        className: rootClass,
+    }, panes
+        // closing 里的 pane 已不在 ids，但仍要渲染一帧把宽度收回去。
+        .filter((pane) => state.ids.includes(pane.id) || closing.includes(pane.id))
+        .map((pane) => h('section', {
+        key: pane.id,
+        ref: (element) => {
+            if (element === null)
+                panelRefs.current.delete(pane.id);
+            else
+                panelRefs.current.set(pane.id, element);
+        },
+        // side-surface = 与 SideSheet 共用的面板皮肤（背景 / 阴影 / 头部 / 拖拽条都在那份里）。
+        className: `dshpc-side-surface dshpc-dock__panel${closing.includes(pane.id) ? ' dshpc-dock__panel--closing' : ''}`,
+        style: { width: `${widthOf(pane)}px` },
+        'data-panel': pane.id,
+        'aria-label': pane.ariaLabel ?? (typeof pane.title === 'string' ? pane.title : pane.id),
+    }, h('div', {
+        className: 'dshpc-dock__resizer',
+        role: 'separator',
+        'aria-orientation': 'vertical',
+        'aria-label': tt('dockResize'),
+        onPointerDown: (event) => {
+            beginResize(pane, event);
+        },
+    }), 
+    // 收起钮是 resizer 的**兄弟**，不是子元素 —— 用户 2026-10-28：鼠标停在按钮上时，
+    // 拖宽线不能亮、也不能出蓝色发光（那是在拖宽，不是点按钮）。挂在面板左缘外。
+    h('button', {
+        type: 'button',
+        className: 'dshpc-dock__collapse',
+        'aria-label': tt('dockCollapse'),
+        onClick: () => collapseWithAnim(pane.id),
+    }, '›'), renderHeader(pane), headerCloseOf(pane), floatingCloseOf(pane), h('div', { className: 'dshpc-dock__body' }, pane.children ?? null))), ears === null || typeof document === 'undefined' ? null : createPortal(ears, document.body));
+}
+//# sourceMappingURL=PanelDock.js.map

package/dist/ui/layout/PanelDock.js.map

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

package/dist/ui/layout/QuickToolbar.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 快捷工具栏（UI 基础层）：**右侧悬浮的一列圆钮**，内置「回到顶部」，并可挂自定义按钮。
+ *
+ * 用法：
+ *   <QuickToolbar
+ *     anchorId="dshpc-main"
+ *     onAction={(id) => …}
+ *     items={[{ id: 'search', icon: <SearchIcon />, label: '搜索' }]}
+ *   />
+ *
+ * 行为（2026-10-31 用户拍板）：
+ * - **纵向恒定**贴屏幕底边，距离 `offset`（默认 16px）；按钮从下往上排。
+ * - **横向默认**贴屏幕右缘、留 `offset`；给了 `anchorId` / `anchor()` 就贴到那个控件的
+ *   **右缘外侧**，同样留 `offset`。右侧放不下（再留一个 `offset` 后越界）就退回贴屏幕右缘。
+ *   控件找不到按「跟随窗口」处理，不报错。
+ * - 内置「回到顶部」默认 `when: 'scroll'`、阈值 320：滚过才出现；可传 `backToTop: false` 关掉，
+ *   或用 `{ order, label, threshold }` 调整。
+ * - 自定义项：`icon` / `label` / `onClick`；`visible` / `when` / `order` / `threshold` / `color` /
+ *   `fgColor` 都可配。点击后先调 `onClick`，再统一回调 `onAction(id, item)`。
+ * - 滚动容器默认取工具栏最近的「可纵向滚动」祖先，也可以显式给 `scrollContainer`。
+ * - 显隐切换带 0.2s 动画：挂载淡入，消失先淡出、播完才卸载（`reduced-motion` 下关闭）。
+ *
+ * 样式只注入自己那一份（`controls/quick-toolbar.css`），横向位置 / 尺寸 / 间距由本组件在
+ * style 上实时写入，不写死 CSS。
+ */
+import { createElement as h } from 'react';
+import { type QuickToolbarBackToTop, type QuickToolbarItem } from './quick-toolbar-logic.js';
+export interface QuickToolbarProps {
+    /** 自定义按钮；按数组顺序排在「回到顶部」下面。 */
+    items?: QuickToolbarItem[];
+    /** 内置回顶部：`false` 关掉；对象可调 `order` / `label` / `threshold`。 */
+    backToTop?: boolean | QuickToolbarBackToTop;
+    /** 自定义项点击后的统一回调（在单项 `onClick` 之后触发）。 */
+    onAction?: (id: string, item: QuickToolbarItem) => void;
+    /** 与屏幕 / 锚点右缘、屏幕底边的距离（px，默认 16）。 */
+    offset?: number;
+    /** 相邻按钮的纵向间距（px，默认 12）。 */
+    gap?: number;
+    /** 按钮直径（px，默认 44）。 */
+    size?: number;
+    /** 跟随这个 id 的控件：横向贴它的右缘外侧；不传 = 跟随窗口右缘。 */
+    anchorId?: string;
+    /** 动态锚点函数（优先于 `anchorId`）：返回 null 时按跟随窗口处理。 */
+    anchor?: () => HTMLElement | null;
+    /** 滚动容器；不传则取工具栏最近的可纵向滚动祖先，再退回窗口。 */
+    scrollContainer?: HTMLElement | (() => HTMLElement | null);
+    /** 无障碍名，默认内置字典「快捷工具栏」。 */
+    ariaLabel?: string;
+    /** 追加 class（只允许补布局）。 */
+    className?: string;
+}
+/** 右侧浮动的快捷工具栏：内置回顶部 + 自定义按钮。 */
+export declare function QuickToolbar(props: QuickToolbarProps): ReturnType<typeof h>;
+//# sourceMappingURL=QuickToolbar.d.ts.map

package/dist/ui/layout/QuickToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuickToolbar.d.ts","sourceRoot":"","sources":["../../../src/ui/layout/QuickToolbar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,aAAa,IAAI,CAAC,EAAmE,MAAM,OAAO,CAAA;AAI3G,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAA;AAYjC,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC1B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAA;IAC3C,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACvD,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IACjC,oCAAoC;IACpC,eAAe,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,CAAA;IAC1D,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA+CD,gCAAgC;AAChC,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAoL3E"}