@undefineds.co/xpod 0.4.19 → 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/solid-auth-boundary.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import { type AuthSurfaceMode, type StorageBootstrapCopy, type WebIdLoginRouteCopy } from '@undefineds.co/shared-ui';
+import { type AppIdentity, type AuthSurfaceMode, type PodSignInCopy, type PodSignInLocale, type StorageBootstrapCopy, type WebIdLoginRouteCopy } from '@undefineds.co/shared-ui';
 import type { StorageSelectionState, StorageBinding, WebIdAuthState, WebIdLoginRouteDescriptor } from '@undefineds.co/solid-sdk';
 export interface SolidAuthBoundaryProps {
     state: WebIdAuthState;
@@ -9,6 +9,11 @@ export interface SolidAuthBoundaryProps {
     onCreateStorage?: () => void | Promise<void>;
     onContinueStorage?: (binding: StorageBinding) => void | Promise<void>;
     onSelectStorage?: (binding: StorageBinding) => void | Promise<void>;
+    /**
+     * `storage` still overrides the Pod chooser wording. `route` is retained for
+     * source compatibility only: the sign-in wording now ships with `PodSignIn`
+     * (`podSignInCopy` overrides it).
+     */
     copy?: {
         route?: Partial<WebIdLoginRouteCopy>;
         storage?: Partial<StorageBootstrapCopy>;
@@ -22,6 +27,19 @@ export interface SolidAuthBoundaryProps {
     /** Optional host-owned close action for modal presentation. */
     onSurfaceClose?: () => void | Promise<void>;
     auxiliary?: ReactNode;
+    /** The application's own name and icon for the source mark. Nothing is assumed when omitted. */
+    app?: AppIdentity;
+    /** Sign-in wording language. Defaults to `en`. */
+    locale?: PodSignInLocale;
+    /** Partial overrides of the shared sign-in wording. */
+    podSignInCopy?: Partial<PodSignInCopy>;
+    /** Technical detail of a failure becomes expandable. */
+    developerMode?: boolean;
     children: ReactNode;
 }
-export declare function SolidAuthBoundary({ state, storageState, routes, storageRouteId, onCreateStorage, onContinueStorage, onSelectStorage, copy, onLogin, onRetry, onCancel, onSwitchAccount, surfaceMode, onSurfaceClose, auxiliary, children, }: SolidAuthBoundaryProps): import("react").JSX.Element;
+/**
+ * The application front door for third-party apps: maps the WebID and Pod
+ * selection state onto the shared `PodSignIn` states (A0-A3, plus a one-line
+ * C notice). It renders no second login flow; every action calls the host.
+ */
+export declare function SolidAuthBoundary({ state, storageState, routes, storageRouteId, onCreateStorage, onContinueStorage, onSelectStorage, copy, onLogin, onRetry, onCancel, onSwitchAccount, surfaceMode, onSurfaceClose, auxiliary, app: appProp, locale, podSignInCopy, developerMode, children, }: SolidAuthBoundaryProps): import("react").JSX.Element;

package/node_modules/@undefineds.co/extension-sdk/dist/react/solid-auth-boundary.js

@@ -1,83 +1,19 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState } from 'react';
-import { AuthSurface, Button, Card, CardContent, CardDescription, CardHeader, CardTitle, StorageBootstrapView, WebIdLoginRouteView, } from '@undefineds.co/shared-ui';
-const routeCopy = {
-    title: 'Connect to Solid',
-    description: 'Choose an identity route to continue.',
-    startLabel: 'Continue',
-    restoringLabel: 'Restoring your session…',
-    connectingLabel: 'Connecting…',
-    rememberedLabel: 'Remembered identity',
-    expiredTitle: 'Session expired',
-    retryLabel: 'Try again',
-    cancelLabel: 'Cancel',
-    storageConflictTitle: 'Storage conflict',
-    failureTitle: 'Could not sign in',
-    switchAccountLabel: 'Switch account',
-};
-const storageCopy = {
-    title: 'Prepare storage',
-    description: 'The host is preparing the selected storage binding.',
-    creationMessage: 'Storage is not ready yet.',
-    waitingMessage: 'Waiting for the storage binding.',
-    readyMessage: 'Storage is ready.',
-    conflictMessage: 'The selected storage conflicts with this identity.',
-    errorMessage: 'Storage could not be prepared.',
-    createLabel: 'Create storage',
-    continueLabel: 'Continue',
-    retryLabel: 'Try again',
-    cancelLabel: 'Cancel',
-};
-function presentationState(state, storageState) {
-    if (storageState?.status === 'conflict') {
-        return { status: 'storage-conflict', message: storageState.message };
-    }
-    if (storageState?.status === 'error') {
-        return { status: 'error', message: storageState.message };
-    }
-    switch (state.status) {
-        case 'restoring':
-            return state.remembered
-                ? { status: 'restoring', remembered: state.remembered }
-                : { status: 'restoring' };
-        case 'anonymous':
-            return state.remembered
-                ? { status: 'remembered', remembered: state.remembered }
-                : { status: 'anonymous' };
-        case 'connecting':
-            return { status: 'connecting' };
-        case 'authenticated':
-            return { status: 'authenticated', webId: state.webId };
-        case 'expired':
-            return state.remembered
-                ? { status: 'expired', remembered: state.remembered }
-                : { status: 'expired' };
-        case 'error':
-            return { status: 'error', message: state.message };
+import { useRef, useState } from 'react';
+import { Button, PodSignIn, PodSignInFrame, SourceMark, formatCopy, resolvePodSignInCopy, webIdShortName, } from '@undefineds.co/shared-ui';
+const DEFAULT_APP_NAME = 'Solid';
+function presentationFor(mode) {
+    switch (mode) {
+        case 'page': return { presentation: 'page', modal: false };
+        case 'modal': return { presentation: 'dialog', modal: true };
+        case 'embedded': return { presentation: 'dialog', modal: false };
     }
 }
-function storageViewState(state) {
-    switch (state.status) {
-        case 'loading':
-            return 'waiting';
-        case 'empty':
-            return 'creation';
-        case 'selecting':
-            return 'waiting_for_binding';
-        case 'creating':
-            return 'creating';
-        case 'waiting_for_binding':
-            return 'waiting_for_binding';
-        case 'ready':
-            return 'ready';
-        case 'conflict':
-            return { status: 'conflict', message: state.message };
-        case 'error':
-            return { status: 'error', message: state.message };
-    }
-}
-function isStorageReady(state) {
-    return state === undefined || state.status === 'ready';
+function rememberedIdentity(remembered) {
+    return {
+        displayName: remembered.displayName,
+        ...(remembered.avatarUrl ? { avatarUrl: remembered.avatarUrl } : {}),
+    };
 }
 function storageBindingLabel(binding) {
     if (binding.label?.trim())
@@ -87,62 +23,143 @@ function storageBindingLabel(binding) {
 function storageBindingKey(binding) {
     return `${binding.storageUrl}\u0000${binding.webId}`;
 }
-function StorageSelectionView({ state, copy, onSelectStorage, onContinueStorage, }) {
+/** The Pod chooser: the same 360px body and tokens as the sign-in states. */
+function StorageSelectionView({ state, app, copy, storageCopy, onSelectStorage, onContinueStorage, }) {
     const [selectedKey, setSelectedKey] = useState();
     const selected = state.candidates.find((candidate) => storageBindingKey(candidate) === selectedKey);
     const canSelect = Boolean(onSelectStorage || onContinueStorage);
-    return (_jsxs(Card, { className: "w-full rounded-none border-0 bg-transparent text-card-foreground shadow-none", children: [copy.title || copy.description ? (_jsxs(CardHeader, { children: [copy.title ? _jsx(CardTitle, { children: copy.title }) : null, copy.description ? _jsx(CardDescription, { children: copy.description }) : null] })) : null, _jsxs(CardContent, { className: "space-y-4 px-4 pb-4 pt-0", children: [_jsx("p", { role: "status", "aria-live": "polite", className: "text-sm text-foreground", children: "Choose a storage binding to continue." }), _jsx("div", { className: "space-y-2", children: state.candidates.map((candidate) => {
-                            const key = storageBindingKey(candidate);
-                            const label = storageBindingLabel(candidate);
-                            const isSelected = key === selectedKey;
-                            const content = (_jsxs(_Fragment, { children: [_jsx("span", { className: "min-w-0 truncate", children: label }), _jsx("span", { className: "shrink-0 text-xs text-muted-foreground", children: isSelected ? 'Selected' : 'Select' })] }));
-                            return canSelect ? (_jsx(Button, { type: "button", variant: isSelected ? 'secondary' : 'outline', className: "h-auto w-full justify-between gap-3 px-3 py-3 text-left", "aria-label": `${isSelected ? 'Selected' : 'Select'} ${label}`, "aria-pressed": isSelected, onClick: () => {
-                                    setSelectedKey(key);
-                                    if (onSelectStorage)
-                                        void onSelectStorage(candidate);
-                                }, children: content }, key)) : (_jsx("div", { className: "flex items-center justify-between gap-3 rounded-md border border-border/60 px-3 py-3 text-sm", children: content }, key));
-                        }) }), selected && onContinueStorage ? (_jsx(Button, { type: "button", className: "w-full", onClick: () => void onContinueStorage(selected), children: copy.continueLabel })) : null] })] }));
+    const title = storageCopy?.title || copy.choosePodTitle;
+    const continueLabel = storageCopy?.continueLabel || copy.customSubmit;
+    return (_jsxs("div", { "data-pod-sign-in-state": "choose-pod", className: "flex flex-col gap-6", children: [_jsx(SourceMark, { icon: app.icon, name: app.name }), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("h1", { className: "text-xl font-semibold text-foreground", children: title }), _jsx("p", { role: "status", "aria-live": "polite", className: "text-sm text-muted-foreground", children: storageCopy?.description || copy.choosePodLead })] }), _jsx("div", { className: "flex flex-col gap-2", children: state.candidates.map((candidate) => {
+                    const key = storageBindingKey(candidate);
+                    const label = storageBindingLabel(candidate);
+                    const isSelected = key === selectedKey;
+                    const stateLabel = isSelected ? copy.selected : copy.select;
+                    const content = (_jsxs(_Fragment, { children: [_jsx("span", { className: "min-w-0 truncate text-sm text-foreground", children: label }), _jsx("span", { className: "shrink-0 text-[13px] text-muted-foreground", children: stateLabel })] }));
+                    return canSelect ? (_jsx("button", { type: "button", "aria-label": `${stateLabel} ${label}`, "aria-pressed": isSelected, className: `flex min-h-11 w-full items-center justify-between gap-3 rounded-lg border px-3 py-2 text-left focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring ${isSelected ? 'border-primary bg-accent' : 'border-border bg-card'}`, onClick: () => {
+                            setSelectedKey(key);
+                            if (onSelectStorage)
+                                void onSelectStorage(candidate);
+                        }, children: content }, key)) : (_jsx("div", { className: "flex min-h-11 items-center justify-between gap-3 rounded-lg border border-border bg-card px-3 py-2", children: content }, key));
+                }) }), selected && onContinueStorage ? (_jsx(Button, { type: "button", className: "h-11 w-full rounded-lg text-sm font-medium", onClick: () => void onContinueStorage(selected), children: continueLabel })) : null] }));
+}
+function isStorageReady(state) {
+    return state === undefined || state.status === 'ready';
 }
-export function SolidAuthBoundary({ state, storageState, routes, storageRouteId, onCreateStorage, onContinueStorage, onSelectStorage, copy, onLogin, onRetry, onCancel, onSwitchAccount, surfaceMode = 'page', onSurfaceClose, auxiliary, children, }) {
-    const visibleRouteCopy = { ...routeCopy, ...copy?.route };
-    const visibleStorageCopy = { ...storageCopy, ...copy?.storage };
-    // AuthSurface owns both the accessible heading and the card frame for the
-    // boundary. The nested views render unframed with presentation-only titles
-    // so the surface does not show double cards or two equally named headings.
-    const routeViewCopy = { ...visibleRouteCopy, title: '' };
-    const storageViewCopy = { ...visibleStorageCopy, title: '' };
-    const surface = (title, content) => (_jsx(AuthSurface, { mode: surfaceMode, title: title, onClose: onSurfaceClose, closeLabel: "Close", children: content }));
+/**
+ * The application front door for third-party apps: maps the WebID and Pod
+ * selection state onto the shared `PodSignIn` states (A0-A3, plus a one-line
+ * C notice). It renders no second login flow; every action calls the host.
+ */
+export function SolidAuthBoundary({ state, storageState, routes, storageRouteId, onCreateStorage, onContinueStorage, onSelectStorage, copy, onLogin, onRetry, onCancel, onSwitchAccount, surfaceMode = 'page', onSurfaceClose, auxiliary, app: appProp, locale = 'en', podSignInCopy, developerMode = false, children, }) {
+    const text = resolvePodSignInCopy(locale, podSignInCopy);
+    // `connecting` carries only the route, so the screen the user pressed the button on
+    // (remembered identity or first visit) is remembered from the states before it.
+    const lastRemembered = useRef(undefined);
+    if (state.status === 'anonymous' || state.status === 'restoring' || state.status === 'expired') {
+        lastRemembered.current = state.remembered;
+    }
+    const app = appProp ?? { name: DEFAULT_APP_NAME };
+    const { presentation, modal } = presentationFor(surfaceMode);
+    const frame = (content) => (_jsxs(PodSignInFrame, { presentation: presentation, modal: modal, ariaLabel: text.chooseTitle, onClose: onSurfaceClose ? () => void onSurfaceClose() : undefined, closeLabel: onSurfaceClose ? text.close : undefined, children: [content, auxiliary ? _jsx("div", { className: "mt-4", children: auxiliary }) : null] }));
     if (state.status === 'authenticated' && isStorageReady(storageState)) {
         return _jsx(_Fragment, { children: children });
     }
     if (state.status === 'authenticated' && storageState?.status === 'selecting') {
-        return surface(visibleStorageCopy.title, (_jsx(StorageSelectionView, { state: storageState, copy: storageViewCopy, onSelectStorage: onSelectStorage, onContinueStorage: onContinueStorage })));
+        return frame(_jsx(StorageSelectionView, { state: storageState, app: app, copy: text, storageCopy: copy?.storage, onSelectStorage: onSelectStorage, onContinueStorage: onContinueStorage }));
+    }
+    // Route used by "sign in" and "sign in again": the remembered identity's route,
+    // else the only route. With several routes and nothing remembered the first is the primary one.
+    const rememberedOf = (s) => (s.status === 'anonymous' || s.status === 'restoring' || s.status === 'expired' ? s.remembered : undefined);
+    const remembered = rememberedOf(state);
+    const primaryRoute = state.status === 'connecting'
+        ? state.route
+        : routes.find((route) => route.id === remembered?.routeId) ?? routes[0];
+    const login = () => { if (primaryRoute)
+        void onLogin(primaryRoute.id); };
+    const relogin = () => {
+        const routeId = state.status === 'error' ? state.retryRouteId : primaryRoute?.id;
+        if (routeId && onRetry)
+            void onRetry(routeId);
+        else
+            login();
+    };
+    const noop = () => undefined;
+    const extraRoutes = state.status === 'anonymous' && !remembered ? routes.filter((route) => route !== primaryRoute) : [];
+    let podState;
+    let notice;
+    let onPrimary = login;
+    let onUseAnother = onSwitchAccount ? () => void onSwitchAccount() : undefined;
+    const serviceLabel = primaryRoute?.label;
+    // Route-specific label for the primary button on the first-visit screen.
+    const routeCopy = serviceLabel
+        ? { useXpod: formatCopy(text.signInWith, { service: serviceLabel }) }
+        : undefined;
+    if (state.status === 'authenticated') {
+        // Valid WebID sessions stay valid while their Pod opens or retries: never
+        // turn a Pod problem into a second login.
+        const identity = { displayName: webIdShortName(state.webId) };
+        const busy = storageState?.status === 'loading'
+            || storageState?.status === 'waiting_for_binding'
+            || storageState?.status === 'creating';
+        podState = { kind: 'remembered', identity, busy };
+        onUseAnother = undefined;
+        onPrimary = noop;
+        if (storageState?.status === 'error') {
+            notice = { tone: 'warning', text: text.noticeUnreachable, primaryLabel: text.retry, developerDetail: storageState.message };
+            const retryRouteId = storageRouteId;
+            onPrimary = retryRouteId && onRetry ? () => void onRetry(retryRouteId) : noop;
+        }
+        else if (storageState?.status === 'conflict') {
+            notice = { tone: 'warning', text: text.noticeIncomplete, primaryLabel: text.useAnother, developerDetail: storageState.message };
+            onPrimary = onSwitchAccount
+                ? () => void onSwitchAccount()
+                : storageRouteId && onRetry ? () => void onRetry(storageRouteId) : noop;
+        }
+        else if (storageState?.status === 'empty') {
+            notice = { tone: 'neutral', text: text.noticeNoWebId, primaryLabel: text.goCreate };
+            onPrimary = onCreateStorage ? () => void onCreateStorage() : noop;
+        }
+    }
+    else if (state.status === 'restoring') {
+        podState = { kind: 'restoring', ...(remembered ? { identity: rememberedIdentity(remembered) } : {}) };
+    }
+    else if (state.status === 'connecting') {
+        // The screen the user pressed the button on, with the button spinning.
+        podState = lastRemembered.current
+            ? { kind: 'remembered', identity: rememberedIdentity(lastRemembered.current), busy: true }
+            : { kind: 'choose-service', busy: true };
+        if (lastRemembered.current)
+            onUseAnother = undefined;
+    }
+    else if (state.status === 'expired') {
+        podState = {
+            kind: 'expired',
+            identity: rememberedIdentity(remembered ?? { displayName: serviceLabel ?? app.name }),
+        };
+        onPrimary = relogin;
     }
-    if (state.status === 'authenticated' && storageState) {
-        const storageStateView = storageViewState(storageState);
-        const canRetryStorage = Boolean(onRetry && storageRouteId
-            && (storageState.status === 'conflict' || storageState.status === 'error'));
-        const canCancelStorage = Boolean(onCancel
-            && (storageState.status === 'creating' || storageState.status === 'waiting_for_binding'));
-        return surface(visibleStorageCopy.title, (_jsx(StorageBootstrapView, { state: storageStateView, copy: storageViewCopy, onCreate: storageState.status === 'empty' ? onCreateStorage : undefined, onRetry: canRetryStorage ? () => void onRetry?.(storageRouteId) : undefined, onCancel: canCancelStorage ? onCancel : undefined, framed: false })));
+    else {
+        // anonymous, or error (same screens plus a C4 notice)
+        podState = remembered
+            ? { kind: 'remembered', identity: rememberedIdentity(remembered) }
+            : { kind: 'choose-service' };
+        if (state.status === 'error') {
+            notice = {
+                tone: 'warning',
+                text: text.noticeIncomplete,
+                primaryLabel: text.reauthenticate,
+                developerDetail: state.message,
+            };
+            onPrimary = relogin;
+        }
+        if (primaryRoute?.availability === 'starting') {
+            podState = { ...podState, busy: true };
+        }
+        else if (primaryRoute?.availability === 'unavailable' && !notice) {
+            notice = { tone: 'warning', text: primaryRoute.unavailableReason ?? text.noticeUnreachable };
+            onPrimary = noop;
+        }
     }
-    const routeList = state.status === 'connecting'
-        ? [state.route]
-        : routes.length > 0
-            ? routes
-            : [];
-    const mappedState = presentationState(state, storageState);
-    return surface(visibleRouteCopy.title, (_jsxs("div", { className: "flex w-full flex-col gap-4", children: [routeList.map((route) => {
-                const retryRouteId = state.status === 'error'
-                    ? state.retryRouteId
-                    : state.status === 'expired'
-                        ? state.remembered?.routeId ?? (routes.length === 1 ? routes[0]?.id : undefined)
-                        : undefined;
-                const canRetry = Boolean(onRetry && (retryRouteId === route.id
-                    || (storageRouteId === route.id
-                        && (storageState?.status === 'conflict' || storageState?.status === 'error'))));
-                const canStart = state.status === 'anonymous';
-                const canCancel = state.status === 'connecting';
-                return (_jsx(WebIdLoginRouteView, { route: route, state: mappedState, copy: routeViewCopy, onStart: canStart ? onLogin : undefined, onRetry: canRetry ? onRetry : undefined, onCancel: canCancel ? onCancel : undefined, onSwitchAccount: onSwitchAccount, framed: false }, route.id));
-            }), auxiliary ? _jsx("div", { children: auxiliary }) : null] })));
+    return frame(_jsxs(_Fragment, { children: [_jsx(PodSignIn, { app: app, state: podState, notice: notice, locale: locale, copy: { ...routeCopy, ...podSignInCopy }, developerMode: developerMode, primaryIcon: null, capabilities: { customService: false, register: false }, onPrimary: onPrimary, onUseAnother: onUseAnother }), extraRoutes.length > 0 ? (_jsx("div", { className: "mt-3 flex flex-col gap-2", children: extraRoutes.map((route) => (_jsx(Button, { type: "button", variant: "outline", className: "h-11 w-full rounded-lg text-sm font-medium", disabled: route.availability === 'unavailable', onClick: () => void onLogin(route.id), children: formatCopy(text.signInWith, { service: route.label }) }, route.id))) })) : null, state.status === 'connecting' && onCancel ? (_jsx(Button, { type: "button", variant: "ghost", className: "mt-2 h-9 w-full rounded-lg px-2 text-sm font-medium", onClick: () => void onCancel(), children: text.cancel })) : null] }));
 }

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;