@downcity/ui 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -5,9 +5,16 @@ import { Button as Button$1 } from '@base-ui/react/button';
 import { VariantProps } from 'class-variance-authority';
 import * as React from 'react';
 import { useRender } from '@base-ui/react/use-render';
+import { Checkbox as Checkbox$1 } from '@base-ui/react/checkbox';
+import { Dialog as Dialog$1 } from '@base-ui/react/dialog';
 import { Menu } from '@base-ui/react/menu';
 import { Popover as Popover$1 } from '@base-ui/react/popover';
+import { Separator as Separator$1 } from '@base-ui/react/separator';
+import { Tabs as Tabs$1 } from '@base-ui/react/tabs';
 import { ToasterProps } from 'sonner';
+import { Toggle as Toggle$1 } from '@base-ui/react/toggle';
+import { ToggleGroup as ToggleGroup$1 } from '@base-ui/react/toggle-group';
+import { Tooltip as Tooltip$1 } from '@base-ui/react/tooltip';
 
 /**
  * Downcity UI SDK 通用工具。
@@ -47,6 +54,759 @@ type DowncityDropdownMenuItemVariant = "default" | "destructive";
  */
 type DowncityToasterTheme = "light" | "dark" | "system";
 
+/**
+ * Workboard 组件公开类型。
+ *
+ * 关键点（中文）
+ * - 这里导出的是“全局 workboard”板面类型，而不是单个 agent 面板。
+ * - UI 组件只消费聚合后的公开状态，不知道 plugin 内部实现。
+ */
+/**
+ * 单个公开活动项。
+ */
+interface DowncityWorkboardActivityItem {
+    /**
+     * 活动稳定标识。
+     */
+    id: string;
+    /**
+     * 活动类型。
+     */
+    kind: "focus" | "progress" | "idle";
+    /**
+     * 对外标题。
+     */
+    title: string;
+    /**
+     * 对外摘要。
+     */
+    summary: string;
+    /**
+     * 当前状态。
+     */
+    status: "active" | "steady" | "waiting" | "issue";
+    /**
+     * 最近更新时间（ISO8601）。
+     */
+    updatedAt: string;
+    /**
+     * 对外安全标签。
+     */
+    tags: string[];
+}
+/**
+ * 单个公开线索项。
+ */
+interface DowncityWorkboardSignalItem {
+    /**
+     * 线索名称。
+     */
+    label: string;
+    /**
+     * 线索值。
+     */
+    value: string;
+    /**
+     * 线索语气。
+     */
+    tone: "neutral" | "accent" | "warning";
+}
+/**
+ * 单个 agent 的公开快照。
+ */
+interface DowncityWorkboardAgentSnapshot {
+    /**
+     * agent 展示名称。
+     */
+    name: string;
+    /**
+     * 是否运行中。
+     */
+    running: boolean;
+    /**
+     * 对外状态文案。
+     */
+    statusText: string;
+    /**
+     * 最近采样时间（ISO8601）。
+     */
+    collectedAt: string;
+    /**
+     * headline。
+     */
+    headline: string;
+    /**
+     * posture。
+     */
+    posture: string;
+    /**
+     * momentum。
+     */
+    momentum: string;
+    /**
+     * 可见性说明。
+     */
+    visibilityNote: string;
+    /**
+     * 当前公开活动列表。
+     */
+    current: DowncityWorkboardActivityItem[];
+    /**
+     * 最近公开活动列表。
+     */
+    recent: DowncityWorkboardActivityItem[];
+    /**
+     * 公开线索列表。
+     */
+    signals: DowncityWorkboardSignalItem[];
+}
+/**
+ * 全局看板中的单个 agent 项。
+ */
+interface DowncityWorkboardAgentItem {
+    /**
+     * agent 稳定标识。
+     */
+    id: string;
+    /**
+     * agent 展示名称。
+     */
+    name: string;
+    /**
+     * 当前是否运行中。
+     */
+    running: boolean;
+    /**
+     * headline。
+     */
+    headline: string;
+    /**
+     * posture。
+     */
+    posture: string;
+    /**
+     * momentum。
+     */
+    momentum: string;
+    /**
+     * 状态摘要文案。
+     */
+    statusText: string;
+    /**
+     * 最近采样时间（ISO8601）。
+     */
+    collectedAt: string;
+    /**
+     * 当前公开活动数量。
+     */
+    currentCount: number;
+    /**
+     * 近期片段数量。
+     */
+    recentCount: number;
+    /**
+     * 公开线索数量。
+     */
+    signalCount: number;
+    /**
+     * 该 agent 的完整公开快照。
+     */
+    snapshot: DowncityWorkboardAgentSnapshot;
+}
+/**
+ * 全局看板顶部摘要。
+ */
+interface DowncityWorkboardBoardSummary {
+    /**
+     * agent 总数。
+     */
+    totalAgents: number;
+    /**
+     * live agent 数量。
+     */
+    liveAgents: number;
+    /**
+     * 呈现活跃状态的 agent 数量。
+     */
+    activeAgents: number;
+    /**
+     * 安静中的 agent 数量。
+     */
+    quietAgents: number;
+}
+/**
+ * 全局 workboard 板面。
+ */
+interface DowncityWorkboardBoardSnapshot {
+    /**
+     * 顶部摘要。
+     */
+    summary: DowncityWorkboardBoardSummary;
+    /**
+     * agent 列表。
+     */
+    agents: DowncityWorkboardAgentItem[];
+    /**
+     * 最近采样时间（ISO8601）。
+     */
+    collectedAt: string;
+}
+/**
+ * Workboard 组件属性。
+ */
+interface DowncityWorkboardProps {
+    /**
+     * 当前板面。
+     */
+    board: DowncityWorkboardBoardSnapshot | null;
+    /**
+     * 当前是否处于刷新中。
+     */
+    loading?: boolean;
+    /**
+     * 当前选中的 agent id。
+     */
+    selectedAgentId?: string;
+    /**
+     * 外层接收选中变化。
+     */
+    onSelectAgent?: (agentId: string) => void;
+    /**
+     * 外层触发刷新。
+     */
+    onRefresh?: () => void;
+    /**
+     * 自定义类名。
+     */
+    className?: string;
+}
+
+/**
+ * Workboard 主舞台内部类型。
+ *
+ * 关键点（中文）
+ * - 这些类型只服务于 Workboard 的舞台布局与聚焦交互。
+ * - 它们仍然集中放在 `types/` 下，避免在组件文件里散落领域类型定义。
+ */
+
+/**
+ * Workboard 舞台层级。
+ */
+type DowncityWorkboardStageLevel = "clusters" | "agents";
+/**
+ * 像素角色在地图上的朝向。
+ */
+type DowncityWorkboardMotionDirection = "left" | "right" | "up" | "down";
+/**
+ * 像素角色当前的运动状态。
+ */
+type DowncityWorkboardMotionState = "walking" | "dwell";
+/**
+ * Workboard 公共状态分区标识。
+ */
+type DowncityWorkboardZoneId = "engaged" | "steady" | "quiet" | "drift";
+/**
+ * 单个状态分区的视觉与文案定义。
+ */
+interface DowncityWorkboardZoneDefinition {
+    /**
+     * 分区唯一标识。
+     */
+    id: DowncityWorkboardZoneId;
+    /**
+     * 分区标题。
+     */
+    title: string;
+    /**
+     * 分区辅助标题。
+     */
+    subtitle: string;
+    /**
+     * 分区说明文本。
+     */
+    description: string;
+    /**
+     * 分区徽标文案。
+     */
+    badge: string;
+    /**
+     * 分区背景样式类名。
+     */
+    areaClassName: string;
+    /**
+     * 分区边界样式类名。
+     */
+    borderClassName: string;
+    /**
+     * 分区辉光样式类名。
+     */
+    glowClassName: string;
+    /**
+     * 节点底板样式类名。
+     */
+    nodeClassName: string;
+    /**
+     * 连线样式类名。
+     */
+    lineClassName: string;
+}
+/**
+ * 舞台上的绝对坐标点。
+ */
+interface DowncityWorkboardStagePoint {
+    /**
+     * 舞台横向坐标，单位为像素。
+     */
+    x: number;
+    /**
+     * 舞台纵向坐标，单位为像素。
+     */
+    y: number;
+}
+/**
+ * 动效计算后的节点位置。
+ */
+interface DowncityWorkboardMotionFrame {
+    /**
+     * 当前横向坐标。
+     */
+    x: number;
+    /**
+     * 当前纵向坐标。
+     */
+    y: number;
+    /**
+     * 当前角色朝向。
+     */
+    direction: DowncityWorkboardMotionDirection;
+    /**
+     * 当前运动状态。
+     */
+    state: DowncityWorkboardMotionState;
+}
+/**
+ * 舞台 hover 标签。
+ */
+interface DowncityWorkboardHoverTag {
+    /**
+     * 标签唯一标识。
+     */
+    id: string;
+    /**
+     * 展示文本。
+     */
+    label: string;
+    /**
+     * 标签指向的横向坐标。
+     */
+    x: number;
+    /**
+     * 标签指向的纵向坐标。
+     */
+    y: number;
+}
+
+/**
+ * Workboard 游戏地图配置类型。
+ *
+ * 关键点（中文）
+ * - 这里定义的是把公开 workboard 数据映射成“游戏地图世界”的中间层。
+ * - 上层可以把它交给 Pxlkit，也可以交给当前自研地图渲染器。
+ * - 该模型只描述舞台、节点、路线、标签和热点，不关心 plugin 或 console 内部实现。
+ */
+
+/**
+ * 地图中的单个区域标签。
+ */
+interface DowncityWorkboardGameAreaLabel {
+    /**
+     * 标签稳定标识。
+     */
+    id: string;
+    /**
+     * 标签文案。
+     */
+    label: string;
+    /**
+     * 标签横向坐标。
+     */
+    x: number;
+    /**
+     * 标签纵向坐标。
+     */
+    y: number;
+}
+/**
+ * 地图中的单个兴趣点或场景道具。
+ */
+interface DowncityWorkboardGamePointOfInterest {
+    /**
+     * 道具稳定标识。
+     */
+    id: string;
+    /**
+     * 道具类型。
+     */
+    kind: "desk" | "rack" | "console" | "crate" | "bench" | "plant" | "hub";
+    /**
+     * 道具所在横向坐标。
+     */
+    x: number;
+    /**
+     * 道具所在纵向坐标。
+     */
+    y: number;
+    /**
+     * 该道具是否为当前聚焦热点。
+     */
+    active?: boolean;
+}
+/**
+ * 地图中的单条可视化路线。
+ */
+interface DowncityWorkboardGameRoute {
+    /**
+     * 路线稳定标识。
+     */
+    id: string;
+    /**
+     * 路径点集合。
+     */
+    points: DowncityWorkboardStagePoint[];
+    /**
+     * 路线类别。
+     */
+    kind: "corridor" | "patrol" | "hub-link";
+    /**
+     * 是否处于高亮状态。
+     */
+    active?: boolean;
+    /**
+     * 该路线所属的状态簇。
+     * 仅当路线和某个分区直接绑定时提供，便于舞台按簇过滤。
+     */
+    zoneId?: DowncityWorkboardZoneId;
+    /**
+     * 角色经过路径点时的停留比例。
+     * 用于让 actor 在门口、hub、工位等关键点有短暂停靠感。
+     */
+    dwellRatio?: number;
+    /**
+     * 路线坐标吸附到像素网格的尺寸。
+     * 该值会传给 motion 层，确保 movement 更像像素游戏。
+     */
+    snapSize?: number;
+    /**
+     * 路线在地图上的短标签。
+     * 当前主要用于自定义 host 或后续增强的路线标记。
+     */
+    label?: string;
+}
+/**
+ * 地图中的单个 agent actor。
+ */
+interface DowncityWorkboardGameActor {
+    /**
+     * actor 对应的 agent id。
+     */
+    id: string;
+    /**
+     * 关联的 agent 公开项。
+     */
+    agent: DowncityWorkboardAgentItem;
+    /**
+     * actor 当前所处分区。
+     */
+    zoneId: DowncityWorkboardZoneId;
+    /**
+     * actor 在 atlas 总览层的锚点。
+     */
+    overviewAnchor: DowncityWorkboardStagePoint;
+    /**
+     * actor 在 atlas 总览层对应的巡游路线。
+     */
+    overviewRoute: DowncityWorkboardStagePoint[];
+    /**
+     * actor 在 focused 局部舞台中的锚点。
+     * 只有进入该分区内部后才会被消费。
+     */
+    focusedAnchor?: DowncityWorkboardStagePoint;
+    /**
+     * actor 在 focused 局部舞台中所绑定的巡游路线 id。
+     * 渲染器会据此关联 patrol 路线并驱动节点运动。
+     */
+    focusedRouteId?: string;
+    /**
+     * actor 在 atlas 中进入当前分区的门口坐标。
+     * 渲染器可以用它表现角色从公共通道切入某个状态簇。
+     */
+    overviewGate: DowncityWorkboardStagePoint;
+    /**
+     * actor 在 focused 舞台中的工位坐标。
+     * 它通常接近 focusedAnchor，但语义上表示可停靠的 station。
+     */
+    focusedStation?: DowncityWorkboardStagePoint;
+    /**
+     * 该 actor 是否处于当前 spotlight。
+     */
+    active?: boolean;
+}
+/**
+ * 地图中的单个状态簇分区。
+ */
+interface DowncityWorkboardGameZone {
+    /**
+     * 分区标识。
+     */
+    id: DowncityWorkboardZoneId;
+    /**
+     * 分区标题。
+     */
+    title: string;
+    /**
+     * 分区副标题。
+     * 用于 atlas 标签和 focused 顶部提示语。
+     */
+    subtitle: string;
+    /**
+     * 分区的公开说明。
+     * 用于 inspector 或主舞台边角说明。
+     */
+    description: string;
+    /**
+     * 分区短徽标。
+     * 通常用于 focused hub 顶部的小型状态牌。
+     */
+    badge: string;
+    /**
+     * 分区当前 agent 数量。
+     */
+    count: number;
+    /**
+     * 该分区是否为当前活跃分区。
+     */
+    active: boolean;
+    /**
+     * 分区 hub 坐标。
+     */
+    hub: DowncityWorkboardStagePoint;
+}
+/**
+ * 完整的 workboard 游戏地图配置。
+ */
+interface DowncityWorkboardGameMapConfig {
+    /**
+     * 原始公开 board 快照。
+     */
+    board: DowncityWorkboardBoardSnapshot;
+    /**
+     * 当前活跃分区。
+     */
+    activeZoneId: DowncityWorkboardZoneId;
+    /**
+     * 当前选中的 agent id。
+     */
+    selectedAgentId?: string;
+    /**
+     * atlas 层的分区摘要。
+     */
+    zones: DowncityWorkboardGameZone[];
+    /**
+     * atlas 与 focused 共用的 actor 集合。
+     */
+    actors: DowncityWorkboardGameActor[];
+    /**
+     * atlas 层通道。
+     */
+    corridors: DowncityWorkboardGameRoute[];
+    /**
+     * focused 层巡游路线。
+     */
+    patrols: DowncityWorkboardGameRoute[];
+    /**
+     * focused 层兴趣点与道具。
+     */
+    pointsOfInterest: DowncityWorkboardGamePointOfInterest[];
+    /**
+     * focused 层区域标签。
+     */
+    areaLabels: DowncityWorkboardGameAreaLabel[];
+}
+
+/**
+ * Workboard 游戏化 UI 组件类型。
+ *
+ * 关键点（中文）
+ * - 这里只描述 Workboard game shell 内部组件的 props。
+ * - 类型集中放在 types/ 下，避免 renderer 文件继续混入类型定义。
+ * - 这些类型不表达 plugin 或 console 语义，只表达游戏地图 UI 的组合关系。
+ */
+
+/**
+ * Workboard atlas 世界地图组件属性。
+ */
+interface DowncityWorkboardGameAtlasProps {
+    /**
+     * 当前公开 board 快照。
+     */
+    board: DowncityWorkboardBoardSnapshot;
+    /**
+     * 当前游戏地图配置。
+     */
+    gameMap: DowncityWorkboardGameMapConfig;
+    /**
+     * 当前活跃分区。
+     */
+    activeZoneId: DowncityWorkboardZoneId;
+    /**
+     * 当前选中的 agent id。
+     */
+    selectedAgentId?: string;
+    /**
+     * 当前地图流速档位。
+     */
+    flowMode: "cruise" | "turbo";
+    /**
+     * 当前 motion hook 计算出的 actor 坐标。
+     */
+    motionFrames: Record<string, DowncityWorkboardMotionFrame>;
+    /**
+     * 选择状态簇的回调。
+     */
+    onSelectZone: (zoneId: DowncityWorkboardZoneId) => void;
+    /**
+     * 选择 agent 的回调。
+     */
+    onSelectAgent?: (agentId: string, zoneId: DowncityWorkboardZoneId) => void;
+}
+/**
+ * Workboard cluster room 场景组件属性。
+ */
+interface DowncityWorkboardGameRoomProps {
+    /**
+     * 当前房间所属状态簇。
+     */
+    zone: DowncityWorkboardZoneDefinition;
+    /**
+     * 当前房间中的 agent 列表。
+     */
+    items: DowncityWorkboardAgentItem[];
+    /**
+     * 当前游戏地图配置。
+     */
+    gameMap: DowncityWorkboardGameMapConfig;
+    /**
+     * 当前选中的 agent id。
+     */
+    selectedAgentId?: string;
+    /**
+     * 当前 motion hook 计算出的 actor 坐标。
+     */
+    motionFrames?: Record<string, DowncityWorkboardMotionFrame>;
+    /**
+     * 当前地图流速档位。
+     */
+    flowMode: "cruise" | "turbo";
+    /**
+     * 选择 agent 的回调。
+     */
+    onSelectAgent?: (agentId: string) => void;
+}
+/**
+ * Workboard 游戏化 HUD 属性。
+ */
+interface DowncityWorkboardGameHudProps {
+    /**
+     * 当前公开 board 快照。
+     */
+    board: DowncityWorkboardBoardSnapshot;
+    /**
+     * 当前舞台层级。
+     */
+    stageLevel: DowncityWorkboardStageLevel;
+    /**
+     * 当前活跃分区。
+     */
+    activeZone: DowncityWorkboardZoneDefinition;
+    /**
+     * 当前选中的 agent。
+     */
+    selected: DowncityWorkboardAgentItem | null;
+    /**
+     * 当前地图流速档位。
+     */
+    flowMode: "cruise" | "turbo";
+    /**
+     * 是否正在刷新。
+     */
+    loading?: boolean;
+    /**
+     * 是否处于全屏。
+     */
+    isFullscreen: boolean;
+    /**
+     * 底部 portal rail 展示的状态簇集合。
+     */
+    zones: DowncityWorkboardGameZone[];
+    /**
+     * 从底部 portal rail 进入某个状态簇。
+     */
+    onSelectZone?: (zoneId: DowncityWorkboardZoneId) => void;
+    /**
+     * 返回 atlas 的回调。
+     */
+    onBackToAtlas?: () => void;
+    /**
+     * 切换地图流速的回调。
+     */
+    onToggleFlowMode: () => void;
+    /**
+     * 刷新数据的回调。
+     */
+    onRefresh?: () => void;
+    /**
+     * 切换全屏的回调。
+     */
+    onToggleFullscreen: () => void;
+}
+/**
+ * Workboard 游戏化 inspector 属性。
+ */
+interface DowncityWorkboardGameInspectorProps {
+    /**
+     * 当前选中的 agent。
+     */
+    selected: DowncityWorkboardAgentItem | null;
+    /**
+     * 当前活跃分区。
+     */
+    activeZone: DowncityWorkboardZoneDefinition;
+    /**
+     * 当前分区里的 agent 列表。
+     */
+    selectedPeers: DowncityWorkboardAgentItem[];
+    /**
+     * 当前舞台层级。
+     */
+    stageLevel: DowncityWorkboardStageLevel;
+    /**
+     * 是否折叠 inspector。
+     */
+    collapsed: boolean;
+    /**
+     * 切换 inspector 折叠状态。
+     */
+    onToggleCollapsed?: () => void;
+    /**
+     * 选择 agent 的回调。
+     */
+    onSelectAgent?: (agentId: string) => void;
+}
+/**
+ * Workboard hover 标签状态更新函数。
+ */
+type DowncityWorkboardHoverTagSetter = (tag: DowncityWorkboardHoverTag | null) => void;
+
 declare const buttonVariants: (props?: ({
     variant?: "default" | "outline" | "secondary" | "ghost" | "destructive" | "link" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
@@ -68,6 +828,25 @@ declare function CardAction({ className, ...props }: React.ComponentProps<"div">
 declare function CardContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function CardFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
+declare function Checkbox({ className, ...props }: Checkbox$1.Root.Props): react_jsx_runtime.JSX.Element;
+
+declare function Dialog(props: Dialog$1.Root.Props): react_jsx_runtime.JSX.Element;
+declare function DialogTrigger(props: Dialog$1.Trigger.Props): react_jsx_runtime.JSX.Element;
+declare function DialogPortal(props: Dialog$1.Portal.Props): react_jsx_runtime.JSX.Element;
+declare function DialogClose(props: Dialog$1.Close.Props): react_jsx_runtime.JSX.Element;
+declare function DialogOverlay({ className, ...props }: Dialog$1.Backdrop.Props): react_jsx_runtime.JSX.Element;
+declare function DialogContent({ className, children, showCloseButton, ...props }: Dialog$1.Popup.Props & {
+    showCloseButton?: boolean;
+}): react_jsx_runtime.JSX.Element;
+declare function DialogHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function DialogFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function DialogTitle({ className, ...props }: Dialog$1.Title.Props): react_jsx_runtime.JSX.Element;
+declare function DialogDescription({ className, ...props }: Dialog$1.Description.Props): react_jsx_runtime.JSX.Element;
+
+declare function Input({ className, type, ...props }: React.ComponentProps<"input">): react_jsx_runtime.JSX.Element;
+
+declare function Label({ className, ...props }: React.ComponentProps<"label">): react_jsx_runtime.JSX.Element;
+
 declare function DropdownMenu({ ...props }: Menu.Root.Props): react_jsx_runtime.JSX.Element;
 declare function DropdownMenuPortal({ ...props }: Menu.Portal.Props): react_jsx_runtime.JSX.Element;
 declare function DropdownMenuTrigger({ ...props }: Menu.Trigger.Props): react_jsx_runtime.JSX.Element;
@@ -99,6 +878,90 @@ declare function Popover({ ...props }: Popover$1.Root.Props): react_jsx_runtime.
 declare function PopoverTrigger({ ...props }: Popover$1.Trigger.Props): react_jsx_runtime.JSX.Element;
 declare function PopoverContent({ className, side, sideOffset, align, alignOffset, ...props }: Popover$1.Popup.Props & Pick<Popover$1.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">): react_jsx_runtime.JSX.Element;
 
+declare function Separator({ className, orientation, ...props }: Separator$1.Props): react_jsx_runtime.JSX.Element;
+
+declare function Sheet({ ...props }: Dialog$1.Root.Props): react_jsx_runtime.JSX.Element;
+declare function SheetTrigger({ ...props }: Dialog$1.Trigger.Props): react_jsx_runtime.JSX.Element;
+declare function SheetClose({ ...props }: Dialog$1.Close.Props): react_jsx_runtime.JSX.Element;
+declare function SheetPortal({ ...props }: Dialog$1.Portal.Props): react_jsx_runtime.JSX.Element;
+declare function SheetOverlay({ className, ...props }: Dialog$1.Backdrop.Props): react_jsx_runtime.JSX.Element;
+declare function SheetContent({ className, children, side, showCloseButton, ...props }: Dialog$1.Popup.Props & {
+    side?: "top" | "right" | "bottom" | "left";
+    showCloseButton?: boolean;
+}): react_jsx_runtime.JSX.Element;
+declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function SheetFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function SheetTitle({ className, ...props }: Dialog$1.Title.Props): react_jsx_runtime.JSX.Element;
+declare function SheetDescription({ className, ...props }: Dialog$1.Description.Props): react_jsx_runtime.JSX.Element;
+
+declare function Skeleton({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+
+declare function Tabs({ className, orientation, ...props }: Tabs$1.Root.Props): react_jsx_runtime.JSX.Element;
+declare const tabsListVariants: (props?: ({
+    variant?: "default" | "line" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare function TabsList({ className, variant, ...props }: Tabs$1.List.Props & VariantProps<typeof tabsListVariants>): react_jsx_runtime.JSX.Element;
+declare function TabsTrigger({ className, ...props }: Tabs$1.Tab.Props): react_jsx_runtime.JSX.Element;
+declare function TabsContent({ className, ...props }: Tabs$1.Panel.Props): react_jsx_runtime.JSX.Element;
+
+/**
+ * Downcity Textarea 基础组件。
+ *
+ * 关键说明（中文）
+ * - 用于多行文本、Prompt、环境变量片段等输入场景。
+ * - 默认保留较舒展的内边距，适合配置面板中的长文本编辑。
+ */
+
+/**
+ * Textarea 组件属性。
+ *
+ * 关键说明（中文）
+ * - 直接复用原生 `textarea` 属性，保证宿主应用接入成本最低。
+ */
+interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+}
+declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
+
 declare function Toaster({ ...props }: ToasterProps): react_jsx_runtime.JSX.Element;
 
-export { Badge, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type DowncityButtonSize, type DowncityButtonVariant, type DowncityCardSize, type DowncityDropdownMenuItemVariant, type DowncityToasterTheme, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Popover, PopoverContent, PopoverTrigger, Toaster, badgeVariants, buttonVariants, cn };
+declare const toggleVariants: (props?: ({
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare function Toggle({ className, variant, size, ...props }: Toggle$1.Props & VariantProps<typeof toggleVariants>): react_jsx_runtime.JSX.Element;
+
+declare function ToggleGroup({ className, variant, size, spacing, orientation, children, ...props }: ToggleGroup$1.Props & VariantProps<typeof toggleVariants> & {
+    spacing?: number;
+    orientation?: "horizontal" | "vertical";
+}): react_jsx_runtime.JSX.Element;
+declare function ToggleGroupItem({ className, children, variant, size, ...props }: Toggle$1.Props & VariantProps<typeof toggleVariants>): react_jsx_runtime.JSX.Element;
+
+declare function TooltipProvider({ delay, ...props }: Tooltip$1.Provider.Props): react_jsx_runtime.JSX.Element;
+declare function Tooltip({ ...props }: Tooltip$1.Root.Props): react_jsx_runtime.JSX.Element;
+declare function TooltipTrigger({ ...props }: Tooltip$1.Trigger.Props): react_jsx_runtime.JSX.Element;
+declare function TooltipContent({ className, side, sideOffset, align, alignOffset, children, ...props }: Tooltip$1.Popup.Props & Pick<Tooltip$1.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">): react_jsx_runtime.JSX.Element;
+
+/**
+ * 渲染全局 Workboard 游戏世界。
+ */
+declare function Workboard(props: DowncityWorkboardProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Workboard 游戏地图配置构建器。
+ *
+ * 关键点（中文）
+ * - 这里负责把公开 board 快照映射成游戏地图层可消费的配置。
+ * - 它不直接渲染，只输出 zones / actors / routes / POI / labels。
+ * - 当前渲染器和未来接入的 Pxlkit 都可以复用这层配置。
+ */
+
+/**
+ * 根据当前 board 构建完整游戏地图配置。
+ */
+declare function buildWorkboardGameMapConfig(params: {
+    board: DowncityWorkboardBoardSnapshot;
+    activeZoneId: DowncityWorkboardZoneId;
+    selectedAgentId?: string;
+}): DowncityWorkboardGameMapConfig;
+
+export { Badge, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type DowncityButtonSize, type DowncityButtonVariant, type DowncityCardSize, type DowncityDropdownMenuItemVariant, type DowncityToasterTheme, type DowncityWorkboardActivityItem, type DowncityWorkboardAgentItem, type DowncityWorkboardAgentSnapshot, type DowncityWorkboardBoardSnapshot, type DowncityWorkboardBoardSummary, type DowncityWorkboardGameActor, type DowncityWorkboardGameAreaLabel, type DowncityWorkboardGameAtlasProps, type DowncityWorkboardGameHudProps, type DowncityWorkboardGameInspectorProps, type DowncityWorkboardGameMapConfig, type DowncityWorkboardGamePointOfInterest, type DowncityWorkboardGameRoomProps, type DowncityWorkboardGameRoute, type DowncityWorkboardGameZone, type DowncityWorkboardHoverTagSetter, type DowncityWorkboardProps, type DowncityWorkboardSignalItem, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Input, Label, Popover, PopoverContent, PopoverTrigger, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Workboard, badgeVariants, buildWorkboardGameMapConfig, buttonVariants, cn, tabsListVariants, toggleVariants };