@james_sww/metaform-asset-distribution 0.1.6 → 0.1.7

package/codebase/template/src/components/common/semantic-region/semantic-region-scaffold.tsx

@@ -4,17 +4,25 @@ import { type ReactNode, useId } from "react";
 import { Badge } from "../../ui/badge";
 import { Button } from "../../ui/button";
 import {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from "../../ui/collapsible";
+  Sheet,
+  SheetContent,
+  SheetHeader,
+  SheetTitle,
+  SheetDescription,
+  SheetTrigger,
+  SheetClose,
+} from "../../ui/sheet";
+import { ChartColumnIncreasing, ChevronRight, CircleDot, Database, FileText, MousePointer2, Sparkles, X } from "lucide-react";
+
+import "./semantic-region-scaffold.css";
 import { cn } from "../../../lib/utils";
 
 import type { SemanticAction, SemanticRegionContract } from "./contract";
 
 export interface SemanticRegionScaffoldProps {
   contract: SemanticRegionContract;
-  commands?: { onAction(action: SemanticAction): void };
+  commands?: { onAction?(action: SemanticAction): void; onStartDesign?(region: SemanticRegionContract): void };
+  presentation?: { expectedResult?: string; capabilities?: readonly string[] };
   slots?: { authoringActions?: ReactNode };
   className?: string;
   compact?: boolean;
@@ -39,74 +47,98 @@ export function SemanticRegionScaffold({
   contract,
   commands,
   slots,
+  presentation,
   className,
   compact = false,
 }: SemanticRegionScaffoldProps) {
   const titleId = useId();
+  const artId = useId().replace(/[^a-zA-Z0-9_-]/g, '');
+  const features = presentation?.capabilities ?? [
+    ...(contract.bindings.length ? ['关联业务数据'] : []),
+    ...(contract.inputs.length || contract.outputs.length ? ['输入与预期结果'] : []),
+    ...(contract.actions.length ? ['业务操作与反馈'] : []),
+    '区域替换契约',
+  ];
+  const icons = [Database, ChartColumnIncreasing, FileText, MousePointer2];
   return (
-    <section
-      aria-labelledby={titleId}
-      data-region-id={contract.id}
-      data-region-implementation="scaffold"
-      className={cn(
-        'min-w-0 rounded-lg border border-dashed border-border bg-card p-5 text-sm text-foreground',
-        className,
-      )}
-    >
-      <div className="flex flex-wrap items-start justify-between gap-3">
-        <div className="min-w-0 space-y-2">
-          <div className="flex flex-wrap items-center gap-3">
-            <h2 id={titleId} className="text-base font-semibold">
-              {contract.title}
-            </h2>
-            <Badge variant="outline">待打造</Badge>
-          </div>
-          <p className="max-w-3xl leading-relaxed text-muted-foreground">
-            {contract.responsibility}
-          </p>
-        </div>
-        {slots?.authoringActions}
-      </div>
-      <div className="mt-4 flex flex-wrap gap-x-5 gap-y-2 text-muted-foreground">
-        <span>{contract.progress.binding === 'ready' ? '绑定已确认' : '数据待绑定'}</span>
-        <span>{contract.progress.design === 'confirmed' ? '设计已确认' : '设计待确认'}</span>
-      </div>
-      {contract.actions.length ? (
-        <div className="mt-5 grid gap-3 sm:grid-cols-2">
-          {contract.actions.map((action) => {
-            const reason = !action.enabled
-              ? action.blockedReason
-              : !commands?.onAction
-                ? '尚未接入操作处理'
-                : undefined;
-            return (
-              <div key={action.id} className="space-y-2">
-                <Button
-                  type="button"
-                  variant="outline"
-                  data-action-id={action.id}
-                  disabled={Boolean(reason)}
-                  onClick={() => {
-                    if (!reason) commands?.onAction(action);
-                  }}
-                >
-                  {action.label}
-                </Button>
-                <p className="text-xs leading-relaxed text-muted-foreground">
-                  {reason ?? action.result}
-                </p>
+    <Sheet>
+      <section
+        aria-labelledby={titleId}
+        data-region-id={contract.id}
+        data-region-implementation="scaffold"
+        data-compact={compact || undefined}
+        className={cn('semantic-scaffold', className)}
+      >
+        <header className="semantic-scaffold-header">
+          <div className="semantic-scaffold-heading">
+            <span className="semantic-scaffold-icon" aria-hidden="true"><Sparkles /></span>
+            <div className="semantic-scaffold-intro">
+              <div className="semantic-scaffold-title-row">
+                <h2 id={titleId}>{contract.title}</h2>
+                <Badge className="semantic-scaffold-badge" variant="outline"><CircleDot aria-hidden="true" />待打造</Badge>
               </div>
-            );
-          })}
+              <p>{contract.responsibility}</p>
+            </div>
+          </div>
+          <SheetTrigger asChild>
+            <Button type="button" variant="outline" className="semantic-scaffold-definition">
+              <FileText aria-hidden="true" />查看区域定义<ChevronRight aria-hidden="true" />
+            </Button>
+          </SheetTrigger>
+        </header>
+        <div className="semantic-scaffold-main">
+          <svg data-scaffold-illustration aria-hidden="true" className="semantic-scaffold-art" viewBox="0 0 320 190" fill="none">
+            <defs>
+              <linearGradient id={`${artId}-panel`} x1="80" y1="40" x2="230" y2="150" gradientUnits="userSpaceOnUse">
+                <stop stopColor="var(--scaffold-violet)" stopOpacity=".24" /><stop offset="1" stopColor="var(--scaffold-blue)" stopOpacity=".05" />
+              </linearGradient>
+              <linearGradient id={`${artId}-spark`} x1="0" y1="0" x2="1" y2="1">
+                <stop stopColor="var(--scaffold-violet)" /><stop offset="1" stopColor="var(--scaffold-blue)" />
+              </linearGradient>
+            </defs>
+            <ellipse cx="160" cy="118" rx="139" ry="45" transform="rotate(-16 160 118)" stroke="var(--scaffold-violet)" strokeOpacity=".26" strokeWidth="1.5" strokeDasharray="5 5" />
+            <ellipse cx="162" cy="119" rx="122" ry="25" transform="rotate(-16 162 119)" fill="var(--scaffold-blue)" fillOpacity=".025" stroke="var(--scaffold-blue)" strokeOpacity=".09" />
+            <g transform="translate(0 -5) skewY(-10)">
+              <rect x="101" y="72" width="130" height="104" rx="9" fill={`url(#${artId}-panel)`} stroke="var(--scaffold-violet)" strokeOpacity=".1" />
+              <rect x="109" y="78" width="130" height="104" rx="9" fill="var(--card)" fillOpacity=".45" stroke="var(--scaffold-blue)" strokeOpacity=".12" />
+              <rect x="117" y="86" width="114" height="20" rx="4" fill="var(--scaffold-violet)" fillOpacity=".18" />
+              <circle cx="125" cy="96" r="2.5" fill="var(--card)" /><circle cx="134" cy="96" r="2.5" fill="var(--card)" />
+              <path d="M123 120H201M123 135H177M123 150H159" stroke="var(--scaffold-violet)" strokeOpacity=".24" strokeWidth="7" strokeLinecap="round" />
+            </g>
+            <circle cx="229" cy="48" r="22" fill={`url(#${artId}-spark)`} fillOpacity=".48" />
+            <path d="m228 31 4 12 12 4-12 4-4 12-4-12-12-4 12-4Z" fill="var(--card)" /><path d="m242 26 1.5 4.5L248 32l-4.5 1.5L242 38l-1.5-4.5L236 32l4.5-1.5Z" fill="var(--card)" />
+            <path d="m49 66 3 9 9 3-9 3-3 9-3-9-9-3 9-3Z" fill="var(--scaffold-violet)" fillOpacity=".52" /><path d="m277 131 2.5 7.5 7.5 2.5-7.5 2.5-2.5 7.5-2.5-7.5-7.5-2.5 7.5-2.5Z" fill="var(--scaffold-blue)" fillOpacity=".44" />
+          </svg>
+          <h3>该业务区域将通过 AI 打造</h3>
+          <p className="semantic-scaffold-expectation">{presentation?.expectedResult ?? (contract.outputs.length
+            ? `完成后将在此处展示${contract.outputs.join('、')}。`
+            : '根据当前区域定义，设计并实现业务内容与交互。')}</p>
+          <ul className="semantic-scaffold-features" aria-label="待实现能力">
+            {features.map((feature, index) => {
+              const Icon = icons[index % icons.length];
+              return <li key={`${index}:${feature}`}><Icon aria-hidden="true" /><span>{feature}</span></li>;
+            })}
+          </ul>
+          <div className="semantic-scaffold-authoring">
+            {slots?.authoringActions ?? <Button type="button" className="semantic-scaffold-start" data-start-design disabled={!commands?.onStartDesign} onClick={() => commands?.onStartDesign?.(contract)}>
+              <Sparkles aria-hidden="true" />开始设计与打造
+            </Button>}
+          </div>
         </div>
-      ) : null}
-      {compact ? null : <Collapsible className="mt-5 border-t border-border pt-3">
-        <CollapsibleTrigger asChild>
-          <Button type="button" variant="ghost-neutral">
-            查看区域设计详情
-          </Button>
-        </CollapsibleTrigger>
-        <CollapsibleContent className="pt-4">
+      </section>
+      <SheetContent side="right" data-side="right" showCloseButton={false} className="semantic-scaffold-definition-sheet">
+        <SheetHeader className="pr-14">
+          <SheetTitle>{contract.title} · 区域定义</SheetTitle>
+          <SheetDescription>{contract.responsibility}</SheetDescription>
+        </SheetHeader>
+        <SheetClose asChild>
+          <Button type="button" variant="ghost" size="icon" className="absolute right-3 top-3" aria-label="关闭区域定义"><X aria-hidden="true" /></Button>
+        </SheetClose>
+        <div className="semantic-scaffold-details">
+          <div className="mb-6 flex flex-wrap gap-x-5 gap-y-2 text-sm text-muted-foreground">
+            <span>{contract.progress.binding === 'ready' ? '绑定已确认' : '数据待绑定'}</span>
+            <span>{contract.progress.design === 'confirmed' ? '设计已确认' : '设计待确认'}</span>
+          </div>
           <div className="grid gap-6 sm:grid-cols-2">
             <DetailList title="输入与预期结果" items={[...contract.inputs, ...contract.outputs]} />
             <DetailList
@@ -147,8 +179,37 @@ export function SemanticRegionScaffold({
               )}
             />
           </div>
-        </CollapsibleContent>
-      </Collapsible>}
-    </section>
+          {contract.actions.length ? (
+            <div className="mt-5 grid gap-3 sm:grid-cols-2">
+              {contract.actions.map((action) => {
+                const reason = !action.enabled
+                  ? action.blockedReason || '操作尚未就绪'
+                  : !commands?.onAction
+                    ? '尚未接入操作处理'
+                    : undefined;
+                return (
+                  <div key={action.id} className="space-y-2">
+                    <Button
+                      type="button"
+                      variant="outline"
+                      data-action-id={action.id}
+                      disabled={Boolean(reason)}
+                      onClick={() => {
+                        if (!reason) commands?.onAction?.(action);
+                      }}
+                    >
+                      {action.label}
+                    </Button>
+                    <p className="text-xs leading-relaxed text-muted-foreground">
+                      {reason ?? action.result}
+                    </p>
+                  </div>
+                );
+              })}
+            </div>
+          ) : null}
+        </div>
+      </SheetContent>
+    </Sheet>
   );
 }

package/codebase/template/src/contexts/toast-context.tsx

@@ -1,4 +1,4 @@
-import { createContext, useContext, type ReactNode } from 'react';
+import { createContext, useContext, useMemo, type ReactNode } from 'react';
 import { toast as sonnerToast } from 'sonner';
 
 export interface ToastOptions {
@@ -23,7 +23,7 @@ export interface ToastContextValue {
 const ToastContext = createContext<ToastContextValue | undefined>(undefined);
 
 export function ToastProvider({ children }: { children: ReactNode }) {
-  const contextValue: ToastContextValue = {
+  const contextValue = useMemo<ToastContextValue>(() => ({
     success: (message, options) => {
       sonnerToast.success(options?.title || message, {
         description: options?.description || (options?.title ? message : undefined),
@@ -61,7 +61,7 @@ export function ToastProvider({ children }: { children: ReactNode }) {
     dismiss: (toastId) => {
       sonnerToast.dismiss(toastId);
     },
-  };
+  }), []);
 
   return <ToastContext.Provider value={contextValue}>{children}</ToastContext.Provider>;
 }

package/codebase/template/src/examples/navigation-example-data.ts

@@ -3,28 +3,22 @@ import type { WorkspaceNavigationItem } from '../layouts/workspace-navigation-mo
 // 仅用于交互示例，不作为应用的默认业务映射。
 export const navigationExampleItems: readonly WorkspaceNavigationItem[] = [
   {
-    id: 'example-tasks', label: '我的任务', count: 8, availability: 'implemented',
-    href: '/examples/navigation.html?page=example-tasks',
+    id: 'example-prepare', label: '检验准备', availability: 'implemented',
     children: [
-      {
-        id: 'example-prepare', label: '检验准备', availability: 'implemented',
-        children: [
-          { id: 'example-arrange', label: '确认待检安排', availability: 'implemented' },
-          { id: 'example-basis', label: '核对检验依据', availability: 'implemented' },
-          { id: 'example-conditions', label: '确认开检条件（待开放）', availability: 'planned' },
-        ],
-      },
-      {
-        id: 'example-inspection', label: '当班检验', availability: 'implemented',
-        children: [
-          { id: 'example-station', label: '工位检查', availability: 'implemented' },
-          { id: 'example-result', label: '记录检验结果', availability: 'implemented' },
-        ],
-      },
-      { id: 'example-recheck', label: '异常与复检', count: 2, availability: 'implemented' },
-      { id: 'example-analysis', label: '记录与分析', availability: 'implemented' },
+      { id: 'example-arrange', label: '确认待检安排', availability: 'implemented' },
+      { id: 'example-basis', label: '核对检验依据', availability: 'implemented' },
+      { id: 'example-conditions', label: '确认开检条件（待开放）', availability: 'planned' },
     ],
   },
+  {
+    id: 'example-inspection', label: '当班检验', availability: 'implemented',
+    children: [
+      { id: 'example-station', label: '工位检查', availability: 'implemented' },
+      { id: 'example-result', label: '记录检验结果', availability: 'implemented' },
+    ],
+  },
+  { id: 'example-recheck', label: '异常与复检', count: 2, availability: 'implemented' },
+  { id: 'example-analysis', label: '记录与分析', availability: 'implemented' },
   {
     id: 'example-planned-group', label: '待开放分组', availability: 'planned',
     children: [{ id: 'example-blocked-child', label: '不可进入的子项', availability: 'implemented' }],

package/codebase/template/src/examples/navigation-example.tsx

@@ -10,7 +10,7 @@ import '../styles/index.css';
 
 export function NavigationExample() {
   const [activeId, setActiveId] = useState(() =>
-    new URLSearchParams(window.location.search).get('page') === 'example-tasks' ? 'example-tasks' : 'example-arrange',
+    new URLSearchParams(window.location.search).get('page') === 'my-tasks' ? 'my-tasks' : 'example-arrange',
   );
   const path = findNavigationPath(navigationExampleItems, activeId);
   const title = path.at(-1)?.label ?? DEFAULT_WORKSPACE_ROUTES.find(item => item.id === activeId)?.label;

package/codebase/template/src/integrations/application-access.tsx

@@ -0,0 +1,70 @@
+import { type ReactNode, useEffect, useRef } from 'react';
+
+import { Button } from '../components/ui/button';
+import { DropdownMenuItem } from '../components/ui/dropdown-menu';
+import { EmptyState } from '../components/common/empty-state';
+import { RoleWorkspaceShell } from '../layouts/role-workspace-shell';
+import type { RoleWorkspaceShellProps, WorkspaceSession } from '../layouts/role-workspace-types';
+import { useApplicationAccess, useApplicationAuth, useApplicationLocation, useCapabilityAvailability } from './application-hooks';
+import { canAccessApplicationPage, filterApplicationRoleEntries } from './application-identity';
+
+export function ApplicationSignIn() {
+  const auth = useApplicationAuth();
+  const available = useCapabilityAvailability('signIn');
+  return <div className="flex flex-col items-start gap-3">
+    <Button type="button" disabled={available.state !== 'ready' || auth.command.status === 'loading'} onClick={() => { void auth.signIn(); }}>
+      {auth.session.status === 'success' && auth.session.data.status === 'expired' ? '重新登录' : '登录'}
+    </Button>
+    {auth.command.status === 'error' ? <p role="alert">{auth.command.error.message}</p> : auth.command.status === 'unavailable' ? <p role="status">{auth.command.reason}</p> : null}
+  </div>;
+}
+
+export function ApplicationAccessGuard({ children, pagePath, roleKey }: { children: ReactNode; pagePath?: string; roleKey?: string }) {
+  const auth = useApplicationAuth();
+  const { session, access } = auth;
+  if (session.status === 'idle' || session.status === 'loading') return <p role="status">正在确认身份与页面访问范围…</p>;
+  if (session.status !== 'success') return <EmptyState title="身份能力不可用" description={session.status === 'unavailable' ? session.reason : session.status === 'error' ? session.error.message : '身份请求已取消。'} />;
+  if (session.data.status === 'anonymous' || session.data.status === 'expired') return <div className="space-y-4"><EmptyState title={session.data.status === 'expired' ? '会话已过期' : '请先登录'} description="登录后继续访问当前应用页面。" /><ApplicationSignIn /></div>;
+  if (session.data.status !== 'authenticated') return <EmptyState title="身份能力不可用" description={session.data.status === 'unavailable' ? session.data.reason : '正在确认身份。'} />;
+  if (access.status === 'idle' || access.status === 'loading') return <p role="status">正在确认页面访问范围…</p>;
+  if (access.status !== 'success') return <EmptyState title="无可访问工作空间" description={access.status === 'unavailable' ? access.reason : access.status === 'error' ? access.error.message : '页面访问范围尚未确认。'} />;
+  const path = pagePath ?? (typeof window === 'undefined' ? '/' : window.location.pathname);
+  if (!canAccessApplicationPage(access.data, path, roleKey)) return <EmptyState title="无权访问此工作空间" description="当前账号未获准访问此入口，请联系管理员配置角色与页面。" />;
+  return <>{children}</>;
+}
+
+export function ApplicationAccountMenu() {
+  const access = useApplicationAccess();
+  const url = access.state.status === 'success' ? access.state.data.managementURL : undefined;
+  return url ? <DropdownMenuItem asChild><a href={url} target="_blank" rel="noopener noreferrer">角色与页面配置</a></DropdownMenuItem> : null;
+}
+
+export function ApplicationWorkspaceShell({ pagePath, roleKey, ...props }: RoleWorkspaceShellProps & { pagePath?: string; roleKey?: string }) {
+  const auth = useApplicationAuth();
+  const location = useApplicationLocation();
+  const previousHref = useRef(location.href);
+  useEffect(() => {
+    if (previousHref.current === location.href) return;
+    previousHref.current = location.href;
+    auth.refresh();
+  }, [location.href, auth.refresh]);
+  const signIn = useCapabilityAvailability('signIn');
+  const signOut = useCapabilityAvailability('signOut');
+  const session: WorkspaceSession = auth.session.status === 'success' ? auth.session.data
+    : auth.session.status === 'idle' || auth.session.status === 'loading' ? { status: 'loading' }
+      : { status: 'unavailable', reason: auth.session.status === 'unavailable' ? auth.session.reason : auth.session.status === 'error' ? auth.session.error.message : '身份请求已取消。' };
+  const access = auth.access.status === 'success' ? auth.access.data : undefined;
+  const content = props.slots.content;
+  return <RoleWorkspaceShell {...props}
+    model={{ ...props.model, session, roleEntries: filterApplicationRoleEntries(access, props.model.roleEntries ?? []) }}
+    commands={{ ...props.commands,
+      onSignIn: signIn.state === 'ready' ? () => { void auth.signIn(); } : undefined,
+      onReauthenticate: signIn.state === 'ready' ? () => { void auth.signIn(); } : undefined,
+      onSignOut: signOut.state === 'ready' ? () => { void auth.signOut(); } : undefined,
+    }}
+    slots={{ ...props.slots,
+      accountMenu: context => <><ApplicationAccountMenu />{typeof props.slots.accountMenu === 'function' ? props.slots.accountMenu(context) : props.slots.accountMenu}</>,
+      banner: context => <>{access?.mode === 'preview' ? <p role="status" className="px-4 py-2 text-xs text-muted-foreground">角色预览 · 当前登录身份保持不变，预览角色不授予业务权限。</p> : null}{auth.command.status === 'error' ? <p role="alert" className="px-4 py-2">{auth.command.error.message}</p> : auth.command.status === 'unavailable' ? <p role="status" className="px-4 py-2">{auth.command.reason}</p> : null}{typeof props.slots.banner === 'function' ? props.slots.banner(context) : props.slots.banner}</>,
+      content: context => <ApplicationAccessGuard pagePath={pagePath} roleKey={roleKey ?? props.model.activeRoleId}>{typeof content === 'function' ? content(context) : content}</ApplicationAccessGuard>,
+    }} />;
+}

package/codebase/template/src/integrations/application-contract.ts

@@ -0,0 +1,178 @@
+import type { ToastContextValue } from '../contexts/toast-context';
+import type { WorkspaceSession } from '../layouts/role-workspace-types';
+
+export type JsonValue = null | string | number | boolean | JsonValue[] | { [key: string]: JsonValue };
+export type JsonObject = { [key: string]: JsonValue };
+export type CapabilityAvailability =
+  | { state: 'ready' }
+  | { state: 'unavailable' | 'connecting' | 'disconnected' | 'denied' | 'error'; reason: string };
+export type CapabilityResult<T> =
+  | { status: 'success'; data: T }
+  | { status: 'unavailable'; reason: string }
+  | { status: 'cancelled'; reason: string; outcomeUnknown: boolean }
+  | { status: 'error'; error: { code: string; message: string; outcomeUnknown: boolean } };
+export type RequestOptions = { signal?: AbortSignal };
+export type ObjectReference = { type: string; id: string; version?: string | number };
+export type VersionedObjectReference = ObjectReference & { version: string | number };
+export type BusinessContext = {
+  object?: ObjectReference;
+  source?: { regionId?: string; actionId?: string; routeId?: string };
+  parameters?: JsonObject;
+};
+
+export type NavigationTarget = {
+  target: string;
+  object?: ObjectReference;
+  params?: Record<string, string | number | boolean>;
+  context?: BusinessContext;
+};
+export type ApplicationRoute = {
+  id: string;
+  path: string;
+  title: string | ((location: NavigationLocation) => string);
+  parent?: string;
+  queryParams?: readonly string[];
+};
+export type ReturnPoint = { target: NavigationTarget; focusId?: string; scroll?: { x: number; y: number } };
+export type NavigationLocation = NavigationTarget & {
+  href: string;
+  matched: boolean;
+  returnTo?: ReturnPoint;
+};
+export type NavigationBreadcrumb = { id: string; label: string; href: string; destination: NavigationTarget };
+export interface ApplicationNavigation {
+  homeTarget: string;
+  getLocation(): NavigationLocation;
+  getBreadcrumbs(): readonly NavigationBreadcrumb[];
+  subscribe(listener: () => void): () => void;
+  href(destination: NavigationTarget): CapabilityResult<string>;
+  open(destination: NavigationTarget, options?: { replace?: boolean; returnTo?: ReturnPoint }): CapabilityResult<NavigationLocation>;
+  back(fallback?: NavigationTarget): CapabilityResult<void>;
+  initialize(): void;
+}
+
+export type QueryRequest = {
+  key: string;
+  operation: string;
+  object?: ObjectReference;
+  conditions?: JsonObject;
+  page?: { number?: number; size?: number; cursor?: string };
+  sort?: readonly { field: string; direction: 'asc' | 'desc' }[];
+  context?: BusinessContext;
+};
+export type QueryResponse<T> = {
+  data: T;
+  page?: { number?: number; size?: number; total?: number; nextCursor?: string };
+};
+export type ConfirmationRequest = { title: string; description?: string; confirmText?: string; destructive?: boolean };
+export type CommandRequest = {
+  operation: string;
+  object?: VersionedObjectReference;
+  input: JsonObject;
+  context?: BusinessContext;
+  idempotencyKey?: string;
+  confirm?: ConfirmationRequest;
+  refresh?: readonly string[];
+};
+export type CommandReceipt<T = unknown> = {
+  status: 'succeeded' | 'accepted' | 'pending';
+  value?: T;
+  object?: VersionedObjectReference;
+  receiptId?: string;
+  refresh?: readonly string[];
+};
+export type ActionRequest = { operation: string; object?: ObjectReference; context?: BusinessContext };
+export type ActionAvailability = { allowed: true } | { allowed: false; reason: string };
+type Subscribable = { subscribe?(listener: () => void): () => void };
+export interface DataAdapter extends Subscribable {
+  availability(kind: 'query' | 'command', operation: string): CapabilityAvailability;
+  query?<T>(request: QueryRequest, options: RequestOptions): Promise<QueryResponse<T>>;
+  execute?<T>(request: CommandRequest, options: RequestOptions): Promise<CommandReceipt<T>>;
+}
+export type ApplicationAccess = {
+  mode: 'preview' | 'runtime';
+  applicationId: string;
+  releaseId?: string;
+  version: string;
+  pages: readonly { id: string; name: string; path: string; roleKey?: string }[];
+  permissions: readonly string[];
+  managementURL?: string;
+};
+export type ApplicationIdentityContext = { protocolVersion: 1; session: WorkspaceSession; access?: ApplicationAccess };
+export type ApplicationIdentitySDK = {
+  getContext(): Promise<ApplicationIdentityContext>;
+  signIn(): Promise<void>;
+  signOut(): Promise<void>;
+};
+export type IdentityRequestState<T> = { status: 'idle' | 'loading' } | CapabilityResult<T>;
+export type ApplicationIdentityState = {
+  session: IdentityRequestState<WorkspaceSession>;
+  access: IdentityRequestState<ApplicationAccess>;
+};
+export interface IdentityAdapter extends Subscribable {
+  availability(operation: 'session' | 'permission' | 'access' | 'signIn' | 'signOut'): CapabilityAvailability;
+  getSession?(options: RequestOptions): Promise<WorkspaceSession>;
+  getAccess?(options: RequestOptions): Promise<ApplicationAccess>;
+  signIn?(options: RequestOptions): Promise<void>;
+  signOut?(options: RequestOptions): Promise<void>;
+  refresh?(): void;
+  checkAction?(request: ActionRequest, options: RequestOptions): Promise<ActionAvailability>;
+}
+export type AttachmentReference = { id: string; name: string; size: number; mediaType: string; version?: string | number };
+export type AttachmentAccess = { url: string; expiresAt?: string; downloadName?: string };
+export type AttachmentOperation = 'upload' | 'link' | 'preview' | 'download';
+export interface AttachmentAdapter extends Subscribable {
+  availability(operation: AttachmentOperation): CapabilityAvailability;
+  upload?(request: { file: File; object?: ObjectReference; context?: BusinessContext }, options: RequestOptions): Promise<AttachmentReference>;
+  link?(request: { attachment: AttachmentReference; object: VersionedObjectReference; context?: BusinessContext }, options: RequestOptions): Promise<CommandReceipt>;
+  preview?(attachment: AttachmentReference, options: RequestOptions): Promise<AttachmentAccess>;
+  download?(attachment: AttachmentReference, options: RequestOptions): Promise<AttachmentAccess>;
+}
+export type ExtensionRequest = { operation: string; input?: JsonObject; context?: BusinessContext };
+export interface ExtensionAdapter extends Subscribable {
+  availability(operation?: string): CapabilityAvailability;
+  invoke<T>(request: ExtensionRequest, options: RequestOptions): Promise<T>;
+}
+export type ApplicationAdapters = {
+  data?: DataAdapter;
+  identity?: IdentityAdapter;
+  attachments?: AttachmentAdapter;
+  extensions?: Readonly<Record<string, ExtensionAdapter>>;
+};
+export type CapabilityName = 'navigation' | 'notification' | 'confirmation' | 'query' | 'command' |
+  'session' | 'permission' | 'access' | 'signIn' | 'signOut' | 'attachment.select' | `attachment.${AttachmentOperation}` | `extension.${string}`;
+
+export interface ApplicationCapabilities {
+  protocolVersion: 1;
+  navigation: ApplicationNavigation;
+  feedback: ToastContextValue;
+  confirm(request: ConfirmationRequest, options?: RequestOptions): Promise<CapabilityResult<void>>;
+  availability(capability: CapabilityName, operation?: string): CapabilityAvailability;
+  subscribeAvailability(capability: CapabilityName, listener: () => void): () => void;
+  data: {
+    query<T>(request: QueryRequest, options?: RequestOptions): Promise<CapabilityResult<QueryResponse<T>>>;
+    execute<T = unknown>(request: CommandRequest, options?: RequestOptions): Promise<CapabilityResult<CommandReceipt<T>>>;
+    refresh(keys: readonly string[]): void;
+    subscribe(key: string, listener: () => void): () => void;
+  };
+  identity: {
+    getSession(options?: RequestOptions): Promise<CapabilityResult<WorkspaceSession>>;
+    getAccess(options?: RequestOptions): Promise<CapabilityResult<ApplicationAccess>>;
+    signIn(options?: RequestOptions): Promise<CapabilityResult<void>>;
+    signOut(options?: RequestOptions): Promise<CapabilityResult<void>>;
+    refresh(): void;
+    getSnapshot(): ApplicationIdentityState;
+    subscribe(listener: () => void): () => void;
+    checkAction(request: ActionRequest, options?: RequestOptions): Promise<CapabilityResult<ActionAvailability>>;
+  };
+  attachments: {
+    select(request?: { accept?: string; multiple?: boolean }, options?: RequestOptions): Promise<CapabilityResult<readonly File[]>>;
+    upload(request: { file: File; object?: ObjectReference; context?: BusinessContext }, options?: RequestOptions): Promise<CapabilityResult<AttachmentReference>>;
+    link(request: { attachment: AttachmentReference; object: VersionedObjectReference; context?: BusinessContext }, options?: RequestOptions): Promise<CapabilityResult<CommandReceipt>>;
+    preview(attachment: AttachmentReference, options?: RequestOptions): Promise<CapabilityResult<AttachmentAccess>>;
+    download(attachment: AttachmentReference, options?: RequestOptions): Promise<CapabilityResult<AttachmentAccess>>;
+  };
+  extensions: {
+    invoke<T>(name: string, request: ExtensionRequest, options?: RequestOptions): Promise<CapabilityResult<{ value: T; connection: CapabilityAvailability }>>;
+  };
+}