@undefineds.co/xpod 0.4.20 → 0.4.25

package/node_modules/@undefineds.co/extension-sdk/dist/layout.js

@@ -34,3 +34,43 @@ function assertValidLayoutContext(context) {
         throw new Error('Applet layout descriptor context.initiallyCollapsed must be a boolean');
     }
 }
+/**
+ * §8.3 断点的唯一来源，单位是内容视口 CSS px。页面不得自选断点。
+ */
+/**
+ * 宽窗口导航列宽度（§8.3）。`AppLayout` 的 Tailwind 类必须与它一致
+ * （`md:grid-cols-[184px_minmax(0,1fr)]`），`packages/extension-sdk/test/app-layout.test.tsx` 两边都断言。
+ */
+export const XPOD_LAYOUT_RAIL_WIDTH = 184;
+export const XPOD_LAYOUT_BREAKPOINTS = {
+    /** 低于此宽度使用任务栏 + 导航抽屉，不强制底部 Tab。 */
+    narrow: 768,
+    /** 只有达到此宽度且确有对象集合，才增加对象列。 */
+    wideObjects: 1100,
+};
+/**
+ * 把页型、宽度与集合事实映射成布局计划（spec §8.3）：
+ * - <768px：任务栏 + 导航抽屉，单面板；
+ * - 768–1099px：184px 文字导航，集合页用堆叠；
+ * - ≥1100px：只有真正集合才额外出现对象列。
+ */
+export function resolveAppletPanePlan(input) {
+    const { pageType, contentWidth } = input;
+    const hasCollection = input.hasObjectCollection === true;
+    if (!Number.isFinite(contentWidth) || contentWidth <= 0) {
+        throw new Error('Applet pane plan needs a positive contentWidth');
+    }
+    if (contentWidth < XPOD_LAYOUT_BREAKPOINTS.narrow) {
+        return { pageType, navigation: 'task-bar', panes: 'single', showObjectColumn: false };
+    }
+    const showObjectColumn = contentWidth >= XPOD_LAYOUT_BREAKPOINTS.wideObjects && pageType === 'collection' && hasCollection;
+    if (showObjectColumn) {
+        return { pageType, navigation: 'rail', panes: 'list-detail', showObjectColumn: true };
+    }
+    return {
+        pageType,
+        navigation: 'rail',
+        panes: pageType === 'collection' && contentWidth < XPOD_LAYOUT_BREAKPOINTS.wideObjects ? 'stack' : 'single',
+        showObjectColumn: false,
+    };
+}

package/node_modules/@undefineds.co/extension-sdk/dist/react/app-layout.d.ts

@@ -3,5 +3,17 @@ export interface AppLayoutProps {
     navigation: ReactNode;
     children: ReactNode;
     className?: string;
+    /** 窄窗任务栏的标题（spec §8.3）。宽窗由页面自己的标题承担。 */
+    narrowTitle?: ReactNode;
+    /** 提供时，窄窗任务栏显示返回按钮。 */
+    onNarrowBack?: () => void;
+    narrowBackLabel?: string;
+    /** 导航按钮与抽屉的名字；抽屉复用同一棵导航树。 */
+    navigationLabel?: string;
 }
-export declare function AppLayout({ navigation, children, className, }: AppLayoutProps): import("react").JSX.Element;
+/**
+ * 工作区布局（spec §8.3）：
+ * - ≥768px（Tailwind `md`，与 `XPOD_LAYOUT_BREAKPOINTS.narrow` 对齐）：184px 文字导航 + 内容；
+ * - <768px：48px 顶部任务栏（返回、标题、有名称的导航按钮）+ 单面板，导航树放进抽屉，不强制底部 Tab。
+ */
+export declare function AppLayout({ navigation, children, className, narrowTitle, onNarrowBack, narrowBackLabel, navigationLabel, }: AppLayoutProps): import("react").JSX.Element;

package/node_modules/@undefineds.co/extension-sdk/dist/react/app-layout.js

@@ -1,5 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cn } from '@undefineds.co/shared-ui';
-export function AppLayout({ navigation, children, className, }) {
-    return (_jsxs("section", { className: cn('grid h-screen min-h-0 grid-cols-[minmax(0,1fr)] grid-rows-[minmax(0,1fr)_64px] bg-background sm:grid-cols-[60px_minmax(0,1fr)] sm:grid-rows-[minmax(0,1fr)]', className), "data-app-layout": "workspace", children: [_jsx("aside", { className: "row-start-2 min-h-0 overflow-x-auto overflow-y-hidden border-t border-border/50 bg-layout-sidebar sm:col-start-1 sm:row-start-1 sm:overflow-hidden sm:border-r sm:border-t-0", "data-app-layout-navigation": true, children: navigation }), _jsx("div", { className: "col-start-1 row-start-1 min-h-0 min-w-0 overflow-hidden bg-layout-content sm:col-start-2", "data-app-layout-content": true, children: children })] }));
+import { useState } from 'react';
+import { ArrowLeft, Menu } from 'lucide-react';
+import { cn, Dialog, DialogContent, DialogTitle, DialogTrigger, } from '@undefineds.co/shared-ui';
+/**
+ * 工作区布局（spec §8.3）：
+ * - ≥768px（Tailwind `md`，与 `XPOD_LAYOUT_BREAKPOINTS.narrow` 对齐）：184px 文字导航 + 内容；
+ * - <768px：48px 顶部任务栏（返回、标题、有名称的导航按钮）+ 单面板，导航树放进抽屉，不强制底部 Tab。
+ */
+export function AppLayout({ navigation, children, className, narrowTitle, onNarrowBack, narrowBackLabel = '返回', navigationLabel = '导航', }) {
+    const [drawerOpen, setDrawerOpen] = useState(false);
+    return (_jsxs("section", { className: cn('grid h-screen min-h-0 grid-cols-[minmax(0,1fr)] grid-rows-[48px_minmax(0,1fr)] bg-background md:grid-cols-[184px_minmax(0,1fr)] md:grid-rows-[minmax(0,1fr)]', className), "data-app-layout": "workspace", children: [_jsxs("header", { className: "col-start-1 row-start-1 flex h-12 min-w-0 items-center gap-1 border-b border-border/50 bg-layout-sidebar px-1 md:hidden", "data-app-layout-header": true, children: [onNarrowBack ? (_jsx("button", { type: "button", onClick: onNarrowBack, "aria-label": narrowBackLabel, className: "flex h-9 w-9 shrink-0 items-center justify-center rounded-lg text-foreground hover:bg-accent focus:outline-none focus-visible:bg-accent", children: _jsx(ArrowLeft, { className: "h-5 w-5", "aria-hidden": "true" }) })) : null, _jsx("div", { className: "min-w-0 flex-1 truncate px-1 text-sm font-medium", "data-app-layout-title": true, children: narrowTitle }), _jsxs(Dialog, { open: drawerOpen, onOpenChange: setDrawerOpen, children: [_jsx(DialogTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "flex h-9 shrink-0 items-center gap-2 rounded-lg px-3 text-sm text-foreground hover:bg-accent focus:outline-none focus-visible:bg-accent", children: [_jsx(Menu, { className: "h-5 w-5", "aria-hidden": "true" }), navigationLabel] }) }), _jsxs(DialogContent, { variant: "sheet-left", "aria-describedby": undefined, children: [_jsx(DialogTitle, { className: "sr-only", children: navigationLabel }), navigation] })] })] }), _jsx("aside", { className: "row-start-2 hidden min-h-0 overflow-hidden border-border/50 bg-layout-sidebar md:row-start-1 md:block md:border-r", "data-app-layout-navigation": true, children: navigation }), _jsx("div", { className: "col-start-1 row-start-2 min-h-0 min-w-0 overflow-hidden bg-layout-content md:col-start-2 md:row-start-1", "data-app-layout-content": true, children: children })] }));
 }

package/node_modules/@undefineds.co/extension-sdk/dist/react/workspace-layout.d.ts

@@ -1,13 +1,36 @@
 import { type ReactNode } from 'react';
-import { type WorkspaceLayoutMode, type WorkspaceLayoutPane } from './layout-context';
+import { type AppletPageType } from '../layout.js';
+import { type WorkspaceLayoutMode, type WorkspaceLayoutPane } from './layout-context.js';
+/** Host-owned navigation drawer; other hosts retain list/detail stack navigation. */
+export declare const WorkspaceDrawerContext: import("react").Context<{
+    open: boolean;
+    onClose?: () => void;
+    headerLeading?: ReactNode;
+} | undefined>;
 export type TwoPaneLayoutMode = 'auto' | WorkspaceLayoutMode;
-export interface TwoPaneLayoutProps {
+/** Host-owned labels; omitted entries retain the existing neutral defaults. */
+export interface WorkspaceLayoutCopy {
+    backToList?: string;
+    backToMain?: string;
+    expandContext?: string;
+    collapseContext?: string;
+}
+export interface WorkspacePageTypeProps {
+    /**
+     * §8.3 页型。概览、固定配置、诊断不会渲染对象列；只有 `collection` 且确有集合才在宽断点出现。
+     * 默认保持旧行为（集合页 + 有集合），新页面应显式声明。
+     */
+    pageType?: AppletPageType;
+    hasObjectCollection?: boolean;
+}
+export interface TwoPaneLayoutProps extends WorkspacePageTypeProps {
     listHeader: ReactNode;
     list: ReactNode;
     mainHeader: ReactNode;
     main: ReactNode;
     mode?: TwoPaneLayoutMode;
     history?: WorkspaceLayoutHistoryAdapter;
+    copy?: Pick<WorkspaceLayoutCopy, 'backToList'>;
     className?: string;
 }
 export interface SinglePaneLayoutProps {
@@ -19,7 +42,7 @@ export interface ThreePaneLayoutContextConfig {
     collapsible?: boolean;
     initiallyCollapsed?: boolean;
 }
-export interface ThreePaneLayoutProps {
+export interface ThreePaneLayoutProps extends WorkspacePageTypeProps {
     header?: ReactNode;
     list: ReactNode;
     main: ReactNode;
@@ -27,12 +50,13 @@ export interface ThreePaneLayoutProps {
     mode?: TwoPaneLayoutMode;
     history?: WorkspaceLayoutHistoryAdapter;
     contextConfig?: ThreePaneLayoutContextConfig;
+    copy?: WorkspaceLayoutCopy;
     className?: string;
 }
 export interface WorkspaceLayoutHistoryAdapter {
     push(pane: WorkspaceLayoutPane): void;
     subscribe(listener: (pane: WorkspaceLayoutPane) => void): () => void;
 }
-export declare function TwoPaneLayout({ listHeader, list, mainHeader, main, mode, history, className, }: TwoPaneLayoutProps): import("react").JSX.Element;
+export declare function TwoPaneLayout({ listHeader, list, mainHeader, main, mode, history, copy, className, pageType, hasObjectCollection, }: TwoPaneLayoutProps): import("react").JSX.Element;
 export declare function SinglePaneLayout({ header, main, className, }: SinglePaneLayoutProps): import("react").JSX.Element;
-export declare function ThreePaneLayout({ header, list, main, context, mode, history, contextConfig, className, }: ThreePaneLayoutProps): import("react").JSX.Element;
+export declare function ThreePaneLayout({ header, list, main, context, mode, history, contextConfig, copy, className, pageType, hasObjectCollection, }: ThreePaneLayoutProps): import("react").JSX.Element;

package/node_modules/@undefineds.co/extension-sdk/dist/react/workspace-layout.js

@@ -1,7 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
+import { createContext, useContext, useCallback, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
 import { cn } from '@undefineds.co/shared-ui';
+import { resolveAppletPanePlan, XPOD_LAYOUT_BREAKPOINTS, XPOD_LAYOUT_RAIL_WIDTH, } from '../layout.js';
 import { WorkspaceLayoutContext, } from './layout-context.js';
+/** Host-owned navigation drawer; other hosts retain list/detail stack navigation. */
+export const WorkspaceDrawerContext = createContext(undefined);
 const stackMediaQuery = '(max-width: 767px)';
 const twoPaneGridStyle = {
     gridTemplateColumns: '210px minmax(0, 1fr)',
@@ -33,6 +36,54 @@ function useResolvedMode(mode) {
     const autoMode = useSyncExternalStore(subscribeToStackModeChange, getAutoModeSnapshot, getServerAutoModeSnapshot);
     return mode === 'auto' ? autoMode : mode;
 }
+/**
+ * 对象列的可用宽度媒体查询：§8.3 的 1100px 是**内容**宽度，宽窗口还有一个 184px 导航列，
+ * 所以视口阈值要加上它。
+ */
+const objectColumnMediaQuery = `(min-width: ${XPOD_LAYOUT_BREAKPOINTS.wideObjects + XPOD_LAYOUT_RAIL_WIDTH}px)`;
+/**
+ * 是否够放对象列。
+ *
+ * 没有 `matchMedia` 的环境（服务端渲染、旧测试环境）按宽窗口处理——与 `getServerAutoModeSnapshot`
+ * 的既有默认一致：产品主要跑在桌面壳里，未知环境不应把已有的两栏布局变成堆叠。
+ */
+function useRoomForObjectColumn() {
+    return useSyncExternalStore((onStoreChange) => {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+            return () => undefined;
+        }
+        const media = window.matchMedia(objectColumnMediaQuery);
+        media.addEventListener('change', onStoreChange);
+        return () => media.removeEventListener('change', onStoreChange);
+    }, () => (typeof window === 'undefined' || typeof window.matchMedia !== 'function'
+        ? true
+        : window.matchMedia(objectColumnMediaQuery).matches), () => true);
+}
+/**
+ * 把 §8.3 的页型、宽度与集合事实落到布局上：复用 `resolveAppletPanePlan` 作为唯一判断处，
+ * 概览/固定配置/诊断在任何宽度都不出现对象列，集合页在 1100px 以下改为堆叠。
+ */
+function useObjectColumn(input) {
+    const narrow = useSyncExternalStore(subscribeToStackModeChange, getAutoModeSnapshot, getServerAutoModeSnapshot) === 'stack';
+    const roomForObjects = useRoomForObjectColumn();
+    // 只需要区分三个区间，因此给 plan 一个能代表当前区间的宽度
+    const contentWidth = roomForObjects
+        ? XPOD_LAYOUT_BREAKPOINTS.wideObjects
+        : narrow
+            ? XPOD_LAYOUT_BREAKPOINTS.narrow - 1
+            : XPOD_LAYOUT_BREAKPOINTS.narrow;
+    const plan = resolveAppletPanePlan({
+        pageType: input.pageType,
+        contentWidth,
+        hasObjectCollection: input.hasObjectCollection,
+    });
+    // §8.3：只有真正的集合列出现时才是并排；其余（含窄窗的集合页）都走 list→detail 的堆叠
+    const autoMode = plan.panes === 'list-detail' ? 'split' : 'stack';
+    return {
+        resolvedMode: input.mode === 'auto' ? autoMode : input.mode,
+        showObjectColumn: plan.showObjectColumn,
+    };
+}
 function useStackNavigation({ resolvedMode, history, resolvePane, }) {
     const [activePane, setActivePane] = useState('list');
     const focusPaneRef = useRef(null);
@@ -86,13 +137,21 @@ function useStackNavigation({ resolvedMode, history, resolvePane, }) {
         openContext,
     };
 }
-export function TwoPaneLayout({ listHeader, list, mainHeader, main, mode = 'auto', history, className, }) {
-    const resolvedMode = useResolvedMode(mode);
-    const { activePane, paneRefs, openList, openMain, openContext, } = useStackNavigation({
+export function TwoPaneLayout({ listHeader, list, mainHeader, main, mode = 'auto', history, copy, className, pageType = 'collection', hasObjectCollection = true, }) {
+    const drawer = useContext(WorkspaceDrawerContext);
+    const { resolvedMode: objectMode } = useObjectColumn({ mode, pageType, hasObjectCollection });
+    const viewportMode = useResolvedMode(mode);
+    const resolvedMode = drawer ? viewportMode : objectMode;
+    // §8.3：非集合页不渲染对象列；集合页只有宽断点才显示
+    // §8.3：只有集合页才有对象列表；宽度决定它是并排的对象列还是堆叠的第一屏
+    const showList = pageType === 'collection' && hasObjectCollection;
+    const { activePane, paneRefs, openList, openMain: navigateMain, openContext, } = useStackNavigation({
         resolvedMode,
         history,
         resolvePane: mapContextPaneToMain,
     });
+    const closeDrawer = drawer?.onClose;
+    const openMain = useCallback(() => { navigateMain(); closeDrawer?.(); }, [navigateMain, closeDrawer]);
     const navigation = useMemo(() => ({
         mode: resolvedMode,
         activePane,
@@ -101,15 +160,19 @@ export function TwoPaneLayout({ listHeader, list, mainHeader, main, mode = 'auto
         openContext,
     }), [activePane, openContext, openList, openMain, resolvedMode]);
     const isStack = resolvedMode === 'stack';
-    const listHidden = isStack && activePane !== 'list';
-    const mainHidden = isStack && activePane !== 'main';
-    return (_jsx(WorkspaceLayoutContext.Provider, { value: navigation, children: _jsx("section", { className: cn('flex min-h-0 flex-1 flex-col bg-background', className), "data-workspace-layout": "two-pane", "data-workspace-mode": resolvedMode, children: _jsxs("div", { className: cn('grid min-h-0 flex-1', isStack ? 'grid-cols-1' : null), style: isStack ? undefined : twoPaneGridStyle, "data-workspace-layout-mode": mode, "data-workspace-active-pane": activePane, children: [_jsxs("aside", { ref: paneRefs.list, className: cn('min-h-0 flex-col overflow-hidden bg-layout-list-item @container', listHidden ? 'hidden' : 'flex', isStack ? 'border-r-0' : 'border-r border-border'), "data-testid": "workspace-list-pane", "data-workspace-pane": "list", hidden: listHidden, tabIndex: isStack ? -1 : undefined, children: [_jsx("header", { className: "h-12 shrink-0 border-b border-border bg-layout-list-header", "data-workspace-list-header": "true", children: listHeader }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: list })] }), _jsxs("main", { ref: paneRefs.main, className: cn('min-h-0 flex-col overflow-hidden bg-layout-content @container', mainHidden ? 'hidden' : 'flex'), "data-testid": "workspace-main-pane", "data-workspace-pane": "main", hidden: mainHidden, tabIndex: isStack ? -1 : undefined, children: [_jsx("header", { className: "h-12 shrink-0 border-b border-border bg-layout-content", "data-workspace-main-header": "true", children: mainHeader }), _jsxs("div", { className: "min-h-0 flex-1 overflow-y-auto", children: [isStack ? (_jsx("button", { type: "button", className: "inline-flex items-center px-4 py-3 text-sm text-muted-foreground hover:text-foreground", onClick: openList, children: "\u8FD4\u56DE\u5217\u8868" })) : null, main] })] })] }) }) }));
+    const stacked = showList && isStack;
+    const listHidden = !showList || (drawer ? resolvedMode === 'stack' && !drawer.open : stacked && activePane !== 'list');
+    const mainHidden = !drawer && stacked && activePane !== 'main';
+    return (_jsx(WorkspaceLayoutContext.Provider, { value: navigation, children: _jsx("section", { className: cn('flex min-h-0 flex-1 flex-col bg-background', className), "data-workspace-layout": "two-pane", "data-workspace-mode": resolvedMode, children: _jsxs("div", { className: cn('grid min-h-0 flex-1', stacked || !showList ? 'grid-cols-1' : null), style: stacked || !showList ? undefined : twoPaneGridStyle, "data-workspace-layout-mode": mode, "data-workspace-object-column": showList && resolvedMode === 'split' ? 'shown' : 'hidden', "data-workspace-active-pane": activePane, children: [_jsxs("aside", { ref: paneRefs.list, className: cn('min-h-0 flex-col overflow-hidden bg-layout-list-item @container', listHidden ? 'hidden' : 'flex', stacked ? 'border-r-0' : 'border-r border-border'), "data-testid": "workspace-list-pane", "data-workspace-pane": "list", hidden: listHidden, tabIndex: stacked ? -1 : undefined, children: [_jsx("header", { className: "h-12 shrink-0 border-b border-border bg-layout-list-header", "data-workspace-list-header": "true", children: listHeader }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: list })] }), _jsxs("main", { ref: paneRefs.main, className: cn('min-h-0 flex-col overflow-hidden bg-layout-content @container', mainHidden ? 'hidden' : 'flex'), "data-testid": "workspace-main-pane", "data-workspace-pane": "main", hidden: mainHidden, inert: drawer?.open && resolvedMode === 'stack' ? true : undefined, tabIndex: stacked ? -1 : undefined, children: [_jsxs("header", { className: cn('h-12 shrink-0 border-b border-border bg-layout-content', drawer?.headerLeading && 'flex min-w-0 items-center'), "data-workspace-main-header": "true", children: [drawer?.headerLeading ? _jsx("div", { className: "flex h-full shrink-0 items-center md:hidden", "data-workspace-header-leading": true, children: drawer.headerLeading }) : null, drawer?.headerLeading ? _jsx("div", { className: "h-full min-w-0 flex-1", children: mainHeader }) : mainHeader] }), _jsxs("div", { className: "min-h-0 flex-1 overflow-y-auto", children: [stacked && !drawer ? (_jsx("button", { type: "button", className: "inline-flex items-center px-4 py-3 text-sm text-muted-foreground hover:text-foreground", onClick: openList, children: copy?.backToList ?? '返回列表' })) : null, main] })] })] }) }) }));
 }
 export function SinglePaneLayout({ header, main, className, }) {
     return (_jsxs("section", { className: cn('flex min-h-0 flex-1 flex-col bg-background', className), "data-workspace-layout": "single-pane", children: [header ? (_jsx("header", { className: "h-16 shrink-0 border-b border-border bg-layout-content", children: header })) : null, _jsx("main", { className: "min-h-0 flex-1 overflow-y-auto bg-layout-content @container", "data-testid": "workspace-content-pane", "data-workspace-pane": "content", children: main })] }));
 }
-export function ThreePaneLayout({ header, list, main, context, mode = 'auto', history, contextConfig, className, }) {
-    const resolvedMode = useResolvedMode(mode);
+export function ThreePaneLayout({ header, list, main, context, mode = 'auto', history, contextConfig, copy, className, pageType = 'collection', hasObjectCollection = true, }) {
+    const { resolvedMode } = useObjectColumn({ mode, pageType, hasObjectCollection });
+    // §8.3：非集合页不渲染对象列
+    // §8.3：只有集合页才有对象列表；宽度决定它是并排的对象列还是堆叠的第一屏
+    const showList = pageType === 'collection' && hasObjectCollection;
     const [contextCollapsed, setContextCollapsed] = useState(contextConfig?.initiallyCollapsed ?? false);
     const { activePane, paneRefs, openList, openMain, openContext, } = useStackNavigation({ resolvedMode, history });
     const toggleContextCollapsed = useCallback(() => {
@@ -123,10 +186,11 @@ export function ThreePaneLayout({ header, list, main, context, mode = 'auto', hi
         openContext,
     }), [activePane, openContext, openList, openMain, resolvedMode]);
     const isStack = resolvedMode === 'stack';
-    const listHidden = isStack && activePane !== 'list';
-    const mainHidden = isStack && activePane !== 'main';
-    const contextHidden = isStack
+    const stacked = showList && isStack;
+    const listHidden = !showList || (stacked && activePane !== 'list');
+    const mainHidden = stacked && activePane !== 'main';
+    const contextHidden = stacked
         ? activePane !== 'context'
         : Boolean(contextConfig?.collapsible && contextCollapsed);
-    return (_jsx(WorkspaceLayoutContext.Provider, { value: navigation, children: _jsxs("section", { className: cn('flex min-h-0 flex-1 flex-col bg-background', className), "data-workspace-layout": "three-pane", "data-workspace-mode": resolvedMode, children: [header ? (_jsx("header", { className: "h-16 shrink-0 border-b border-border bg-layout-content", children: header })) : null, contextConfig?.collapsible && !isStack ? (_jsx("div", { className: "shrink-0 border-b border-border bg-layout-content px-3 py-2", children: _jsx("button", { type: "button", "aria-expanded": !contextCollapsed, className: "inline-flex items-center rounded-md px-3 py-1.5 text-sm text-muted-foreground hover:bg-accent hover:text-foreground", onClick: toggleContextCollapsed, children: contextCollapsed ? '展开上下文面板' : '折叠上下文面板' }) })) : null, _jsxs("div", { className: cn('grid min-h-0 flex-1', isStack ? 'grid-cols-1' : null), style: isStack ? undefined : threePaneGridStyle, "data-workspace-layout-mode": mode, "data-workspace-active-pane": activePane, children: [_jsx("aside", { ref: paneRefs.list, className: cn('min-h-0 overflow-y-auto bg-layout-list-item @container', listHidden ? 'hidden' : null, isStack ? 'border-r-0' : 'border-r border-border'), "data-testid": "workspace-list-pane", "data-workspace-pane": "list", hidden: listHidden, tabIndex: isStack ? -1 : undefined, children: list }), _jsxs("main", { ref: paneRefs.main, className: cn('min-h-0 overflow-y-auto bg-layout-content @container', mainHidden ? 'hidden' : null), "data-testid": "workspace-main-pane", "data-workspace-pane": "main", hidden: mainHidden, tabIndex: isStack ? -1 : undefined, children: [isStack ? (_jsx("button", { type: "button", className: "inline-flex items-center px-4 py-3 text-sm text-muted-foreground hover:text-foreground", onClick: openList, children: "\u8FD4\u56DE\u5217\u8868" })) : null, main] }), _jsxs("aside", { ref: paneRefs.context, className: cn('min-h-0 overflow-y-auto bg-layout-content @container', contextHidden ? 'hidden' : null, isStack ? 'border-l-0' : 'border-l border-border'), "data-testid": "workspace-context-pane", "data-workspace-pane": "context", hidden: contextHidden, tabIndex: isStack ? -1 : undefined, children: [isStack ? (_jsx("button", { type: "button", className: "inline-flex items-center px-4 py-3 text-sm text-muted-foreground hover:text-foreground", onClick: openMain, children: "\u8FD4\u56DE\u4E3B\u533A\u57DF" })) : null, context] })] })] }) }));
+    return (_jsx(WorkspaceLayoutContext.Provider, { value: navigation, children: _jsxs("section", { className: cn('flex min-h-0 flex-1 flex-col bg-background', className), "data-workspace-layout": "three-pane", "data-workspace-mode": resolvedMode, children: [header ? (_jsx("header", { className: "h-16 shrink-0 border-b border-border bg-layout-content", children: header })) : null, contextConfig?.collapsible && !stacked ? (_jsx("div", { className: "shrink-0 border-b border-border bg-layout-content px-3 py-2", children: _jsx("button", { type: "button", "aria-expanded": !contextCollapsed, className: "inline-flex items-center rounded-md px-3 py-1.5 text-sm text-muted-foreground hover:bg-accent hover:text-foreground", onClick: toggleContextCollapsed, children: contextCollapsed ? (copy?.expandContext ?? '展开上下文面板') : (copy?.collapseContext ?? '折叠上下文面板') }) })) : null, _jsxs("div", { className: cn('grid min-h-0 flex-1', stacked ? 'grid-cols-1' : null), style: stacked || !showList ? undefined : threePaneGridStyle, "data-workspace-layout-mode": mode, "data-workspace-active-pane": activePane, children: [_jsx("aside", { ref: paneRefs.list, className: cn('min-h-0 overflow-y-auto bg-layout-list-item @container', listHidden ? 'hidden' : null, stacked ? 'border-r-0' : 'border-r border-border'), "data-testid": "workspace-list-pane", "data-workspace-pane": "list", hidden: listHidden, tabIndex: stacked ? -1 : undefined, children: list }), _jsxs("main", { ref: paneRefs.main, className: cn('min-h-0 overflow-y-auto bg-layout-content @container', mainHidden ? 'hidden' : null), "data-testid": "workspace-main-pane", "data-workspace-pane": "main", hidden: mainHidden, tabIndex: stacked ? -1 : undefined, children: [stacked ? (_jsx("button", { type: "button", className: "inline-flex items-center px-4 py-3 text-sm text-muted-foreground hover:text-foreground", onClick: openList, children: copy?.backToList ?? '返回列表' })) : null, main] }), _jsxs("aside", { ref: paneRefs.context, className: cn('min-h-0 overflow-y-auto bg-layout-content @container', contextHidden ? 'hidden' : null, stacked ? 'border-l-0' : 'border-l border-border'), "data-testid": "workspace-context-pane", "data-workspace-pane": "context", hidden: contextHidden, tabIndex: stacked ? -1 : undefined, children: [stacked ? (_jsx("button", { type: "button", className: "inline-flex items-center px-4 py-3 text-sm text-muted-foreground hover:text-foreground", onClick: openMain, children: copy?.backToMain ?? '返回主区域' })) : null, context] })] })] }) }));
 }

package/node_modules/@undefineds.co/extension-sdk/dist/react.d.ts

@@ -1,9 +1,9 @@
-import { type DescriptorSinglePaneAppletModule, type DescriptorThreePaneAppletModule, type DescriptorTwoPaneAppletModule, type MountedThreePaneApplet, type MountedSinglePaneApplet, type MountedTwoPaneApplet, type SinglePaneAppletModule, type TwoPaneAppletModule, type WebExtensionHost } from './web';
+import { type DescriptorSinglePaneAppletModule, type DescriptorThreePaneAppletModule, type DescriptorTwoPaneAppletModule, type MountedThreePaneApplet, type MountedSinglePaneApplet, type MountedTwoPaneApplet, type SinglePaneAppletModule, type TwoPaneAppletModule, type WebExtensionHost } from './web.js';
 export type { LoginEndpointDescriptor, RememberedWebIdLogin, StorageBinding, StorageSelectionState, WebIdAuthState, WebIdLoginActions, WebIdLoginRouteDescriptor, WebIdLoginTransaction, } from '@undefineds.co/solid-sdk';
-export * from './react/layout-context';
-export * from './react/app-layout';
-export * from './react/workspace-layout';
-export * from './react/solid-auth-boundary';
+export * from './react/layout-context.js';
+export * from './react/app-layout.js';
+export * from './react/workspace-layout.js';
+export * from './react/solid-auth-boundary.js';
 export interface UseAppletOptions {
     enabled?: boolean;
 }

package/node_modules/@undefineds.co/extension-sdk/dist/shell-state.d.ts

@@ -0,0 +1,55 @@
+/** Host projections point to Pod objects; resolving an object removes every projection. */
+export interface ShellAttentionItem {
+    id: string;
+    title: string;
+    href: string;
+    kind: 'approval' | 'run' | 'network' | 'quota';
+    approvalId?: string;
+    thread?: string;
+    run?: string;
+    resumeApproval?: string;
+    risk?: string;
+    expiresAt?: string;
+    toolName?: string;
+}
+export interface ShellActivityItem {
+    id: string;
+    title: string;
+    href: string;
+    createdAt: string;
+    read?: boolean;
+}
+export interface ShellProgressItem {
+    id: string;
+    title: string;
+    href: string;
+}
+export interface ShellInboxItem {
+    id: string;
+    actor?: string;
+    object: string;
+    createdAt: string;
+    approvalId?: string;
+}
+export interface ShellAttentionSnapshot {
+    attention: ShellAttentionItem[];
+    activity: ShellActivityItem[];
+    inProgress: ShellProgressItem[];
+    inbox: ShellInboxItem[];
+}
+export interface DesktopRuntimeSettings {
+    state: 'stopped' | 'starting' | 'running' | 'failed';
+    ownership: 'none' | 'external' | 'desktop';
+    launchAtLogin: boolean;
+    /** Undefined means the host cannot configure automatic restart. */
+    autoRestart?: boolean;
+    dataDirectory?: string;
+}
+export interface DesktopRuntimeBridge {
+    getRuntimeSettings(): Promise<DesktopRuntimeSettings>;
+    setLaunchAtLogin(enabled: boolean): Promise<void>;
+    setAutoRestart(enabled: boolean): Promise<void>;
+    runtimeAction(action: 'start' | 'stop' | 'restart'): Promise<void>;
+    showDataDirectory(): Promise<void>;
+    selectDataDirectory(): Promise<string | undefined>;
+}

package/node_modules/@undefineds.co/extension-sdk/dist/shell-state.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@undefineds.co/extension-sdk/dist/solid-permissions.d.ts

@@ -1,5 +1,5 @@
 import { universalAccess } from '@inrupt/solid-client';
-import type { SolidPermissionCapability } from './web';
+import type { SolidPermissionCapability } from './web.js';
 type UniversalAccess = Pick<typeof universalAccess, 'getAgentAccess' | 'setAgentAccess'>;
 export interface SolidPermissionCapabilityOptions {
     fetch: typeof fetch;

package/node_modules/@undefineds.co/extension-sdk/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import type { WebExtensionHost, WebExtensionSolidCapability, WebExtensionSolidPod } from './web';
+import type { WebExtensionHost, WebExtensionSolidCapability, WebExtensionSolidPod } from './web.js';
 export interface MockWebExtensionHostOverrides {
     solid?: WebExtensionSolidCapability;
     navigation?: Partial<WebExtensionHost['navigation']>;

package/node_modules/@undefineds.co/extension-sdk/dist/web.d.ts

@@ -2,11 +2,11 @@ import type { OpenPodRuntime, SolidSessionRuntime } from '@undefineds.co/solid-s
 import type { PodModelDescriptor } from '@undefineds.co/models';
 import type { PodCollection, PodCollectionOptions, PodSyncState, RowOf } from '@undefineds.co/pod-collections';
 import { type ReactElement } from 'react';
-import { type AppletLayoutType, SinglePaneAppletLayoutDescriptor, ThreePaneAppletLayoutDescriptor, TwoPaneAppletLayoutDescriptor } from './layout';
-import type { AppletManifest, ExtensionManifest } from './manifest';
+import { type AppletLayoutType, SinglePaneAppletLayoutDescriptor, ThreePaneAppletLayoutDescriptor, TwoPaneAppletLayoutDescriptor } from './layout.js';
+import type { AppletManifest, ExtensionManifest } from './manifest.js';
 export type { LoginEndpointDescriptor, RememberedWebIdLogin, StorageBinding, StorageSelectionState, WebIdAuthState, WebIdLoginActions, WebIdLoginRouteDescriptor, WebIdLoginTransaction, } from '@undefineds.co/solid-sdk';
-export { defineAppletLayout } from './layout';
-export type { AppletLayoutDescriptor } from './layout';
+export { defineAppletLayout } from './layout.js';
+export type { AppletLayoutDescriptor } from './layout.js';
 export type WebExtensionSessionStatus = 'anonymous' | 'authenticating' | 'authenticated' | 'expired';
 export type AiClientId = 'codex' | 'claude-code' | 'pi' | 'codebuddy';
 export interface AiClientConfigurationStatus {
@@ -474,5 +474,5 @@ export interface WebExtensionModule<Database = unknown> {
     manifest: WebExtensionManifest;
     applets: Record<string, AppletModule<Database>>;
 }
-export { createSolidPermissionCapability } from './solid-permissions';
-export type { SolidPermissionCapabilityOptions } from './solid-permissions';
+export { createSolidPermissionCapability } from './solid-permissions.js';
+export type { SolidPermissionCapabilityOptions } from './solid-permissions.js';

package/node_modules/@undefineds.co/extension-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/extension-sdk",
-  "version": "0.1.1-rc.0",
+  "version": "0.1.2",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@inrupt/solid-client": "^3.0.0",
-    "@undefineds.co/models": "0.2.59"
+    "@undefineds.co/models": "0.2.60"
   },
   "peerDependencies": {
     "react": "^19.2.0"

package/node_modules/@undefineds.co/extensions/dist-cjs/adapters/langchain.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLangChainDocuments = toLangChainDocuments;
+exports.createLangChainDocumentLoader = createLangChainDocumentLoader;
+exports.createReaderFromLangChainLoader = createReaderFromLangChainLoader;
+const reader_js_1 = require("../reader.js");
+function toLangChainDocuments(result) {
+    return result.documents.map((document) => ({
+        pageContent: document.text,
+        metadata: (0, reader_js_1.mergeDocumentMetadata)(result, document),
+    }));
+}
+function createLangChainDocumentLoader(reader, request, ctx) {
+    return {
+        load: async () => toLangChainDocuments(await reader.read(request, ctx)),
+    };
+}
+function createReaderFromLangChainLoader(options) {
+    return {
+        id: options.id,
+        displayName: options.displayName,
+        outputs: options.outputs,
+        transports: options.transports,
+        supportedSourceSchemes: options.supportedSourceSchemes,
+        supportedMimeTypes: options.supportedMimeTypes,
+        read: async (request, ctx) => {
+            const loader = await options.createLoader(request, ctx);
+            const langChainDocuments = await loader.load();
+            const documents = langChainDocuments.map((document) => langChainDocumentToReaderDocument(document));
+            const result = {
+                reader: options.id,
+                model: request.model,
+                documents,
+                text: documents.map((document) => document.text).filter(Boolean).join('\n\n'),
+            };
+            return {
+                ...result,
+                text: (0, reader_js_1.readResultText)(result),
+            };
+        },
+    };
+}
+function langChainDocumentToReaderDocument(document) {
+    return {
+        id: document.id,
+        text: document.pageContent,
+        metadata: document.metadata ?? {},
+    };
+}

package/node_modules/@undefineds.co/extensions/dist-cjs/adapters/llamaindex.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLlamaIndexDocuments = toLlamaIndexDocuments;
+exports.createLlamaIndexReader = createLlamaIndexReader;
+exports.createReaderFromLlamaIndexReader = createReaderFromLlamaIndexReader;
+const reader_js_1 = require("../reader.js");
+function toLlamaIndexDocuments(result) {
+    return result.documents.map((document) => ({
+        text: document.text,
+        metadata: (0, reader_js_1.mergeDocumentMetadata)(result, document),
+    }));
+}
+function createLlamaIndexReader(reader, ctx) {
+    return {
+        loadData: async (input) => {
+            const requests = Array.isArray(input) ? input : [input];
+            const results = await Promise.all(requests.map((request) => reader.read(request, ctx)));
+            return results.flatMap((result) => toLlamaIndexDocuments(result));
+        },
+    };
+}
+function createReaderFromLlamaIndexReader(options) {
+    return {
+        id: options.id,
+        displayName: options.displayName,
+        outputs: options.outputs,
+        transports: options.transports,
+        supportedSourceSchemes: options.supportedSourceSchemes,
+        supportedMimeTypes: options.supportedMimeTypes,
+        read: async (request, ctx) => {
+            const llamaReader = await options.createReader(request, ctx);
+            const loadInput = options.createLoadDataInput?.(request, ctx) ?? request;
+            const llamaDocuments = await llamaReader.loadData(loadInput);
+            const documents = llamaDocuments.map((document) => llamaIndexDocumentToReaderDocument(document));
+            const result = {
+                reader: options.id,
+                model: request.model,
+                documents,
+                text: documents.map((document) => document.text).filter(Boolean).join('\n\n'),
+            };
+            return {
+                ...result,
+                text: (0, reader_js_1.readResultText)(result),
+            };
+        },
+    };
+}
+function llamaIndexDocumentToReaderDocument(document) {
+    return {
+        id: document.id_ ?? document.id,
+        text: document.getText?.() ?? document.text ?? document.textResource?.text ?? '',
+        metadata: document.metadata ?? {},
+    };
+}

package/node_modules/@undefineds.co/extensions/dist-cjs/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./registry.js"), exports);
+__exportStar(require("./reader.js"), exports);
+__exportStar(require("./adapters/langchain.js"), exports);
+__exportStar(require("./adapters/llamaindex.js"), exports);
+__exportStar(require("./paddleocr.js"), exports);

package/node_modules/@undefineds.co/extensions/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}