weifuwu 0.93.2 → 0.93.3

package/dist/client/components/AppShell/AppShell.d.ts

@@ -11,11 +11,22 @@
  * （wf-app-shell + wf-sidebar 系列 + wf-main——grid 栅格 + 移动端降级），
  * 组件只补品牌区/用户区细节（AppShell.css）。
  *
+ * **移动抽屉（W2——AppLayout 功能面入库）**：`mobile` prop 父层驱动
+ * （useBreakpoint 交还用户——库惯例同 Layout/NavMenu「响应式折叠交还用户」；
+ * 零 breakpoint 内建保证 SSR 首帧确定性——node 无 matchMedia 时 useBreakpoint
+ * 恒返回基档（mobile）导致 SSR≡SPA 首帧不一致（absorb 违例——实证））。
+ * <768 侧栏转抽屉（translateX 滑入——layout 堆叠降级被替换）+ 遮罩 + 移动
+ * 顶栏（NavBar——汉堡开抽屉 · 右侧设置）+ aside 头部关闭按钮。
+ *
+ * **导航徽标（W2）**：nav[].badge → Menu badge 胶囊（Badge count——
+ * 99+ 溢出内建）——审批待办计数场景。
+ *
  * 状态约定（父层驱动）：
  * - nav/path：菜单数据与当前路由（activeKey 计算）
  * - user：用户信息（null = 未登录——父层守卫跳登录）
  * - onNavigate/onLogout/onSettings：回调上抛
  * - loading：守卫加载态（骨架占位）
+ * - mobile：移动模式（父层 breakpoint 判定）——抽屉/顶栏分支
  */
 import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AppShellNavItem {
@@ -23,9 +34,11 @@ export interface AppShellNavItem {
     label: string;
     icon?: VNodeChild;
     group?: string;
+    /** 导航徽标（数字 → Badge count 胶囊——99+ 溢出内建） */
+    badge?: string | number;
 }
 export interface AppShellProps {
-    /** 导航菜单项（Menu items——key/label/icon/group） */
+    /** 导航菜单项（Menu items——key/label/icon/group/badge） */
     nav?: AppShellNavItem[];
     /** 当前路由路径（activeKey 匹配——'/' 精确，其余前缀） */
     path?: string;
@@ -52,5 +65,9 @@ export interface AppShellProps {
     footer?: VNodeChild;
     /** 侧栏宽度（layout 变量——默认 240px） */
     sidebarWidth?: string;
+    /** 移动顶栏标题（默认 brand.name） */
+    mobileTitle?: string;
+    /** 移动模式（父层 breakpoint 判定——抽屉/顶栏分支；SSR 一致性：默认 false） */
+    mobile?: boolean;
 }
 export declare const AppShell: Component<AppShellProps>;

package/dist/client/components/CronPicker/CronPicker.d.ts

@@ -0,0 +1,31 @@
+/** CronPicker：cron 表达式快捷输入（预置常见 + 自由编辑）（showcase /components/cronpicker） */
+import type { Component } from '../../vdom/index.ts';
+/**
+ * weifuwu/components — CronPicker
+ *
+ * cron 表达式输入原语：预置语义 + 自由编辑双通道。
+ * - 预置面：常见档（每分钟/每 5 分钟/每小时/每天/工作日——单源 PRESETS）
+ * - 自由面：Input 直编（任何 cron 表达式——服务端解析器裁决语义）
+ * - 契约：preset 选中 → onChange（五段 * / N / N-M / N,M 与 server 解析器
+ *   语义对齐——见 src/server/... cron 解析面）；自由输入全量直传。
+ *
+ * 来源：agent-platform CronPicker（平台层单一消费者 workflow 详情——入
+ * 库判负登记已推翻（用户指令 = 第二消费面确立）——库件标准形（Select 单源
+ * 表单面——替换原生 select）。
+ */
+export interface CronPickerProps {
+    value: string;
+    onChange?: (v: string) => void;
+    /** 预置档（默认 6 档——Preset 可覆盖——自定义场景） */
+    presets?: {
+        label: string;
+        value: string;
+    }[];
+    /** 预设选择占位文案 */
+    placeholder?: string;
+}
+export declare const CRON_PRESETS: {
+    label: string;
+    value: string;
+}[];
+export declare const CronPicker: Component<CronPickerProps>;

package/dist/client/components/ListScaffold/ListScaffold.d.ts

@@ -0,0 +1,40 @@
+/** ListScaffold：列表页骨架（PageHeader + 工具栏 + loading/empty + 内容插槽）（showcase /components/list-scaffold） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
+/**
+ * weifuwu/components — ListScaffold
+ *
+ * 列表页骨架原语：PageHeader + 搜索/工具区 + loading/empty 态 + 内容插槽。
+ * 各页面差异在内容循环（render 插槽）——头部/状态区单点一致。
+ * 组合 PageHeader/EmptyState/Loading（库内组合——无自有样式——布局类单源）。
+ *
+ * **empty 显式契约**（agent-platform ListScaffold 空态与列表并存 bug 修复——
+ * 2027-09 沉淀入库）：empty 仅在 `isEmpty` 时渲染——**有数据也显示空态**
+ * 的空态/列表并存已消除（原实现 empty 条件缺失 isEmpty——双段显示）。
+ * loading 优先于 empty（加载中不闪空态）——空态在 loading 后判断。
+ *
+ * 来源：agent-platform ListScaffold（>1 消费者 Agents/Departments——
+ * 入库判负登记已推翻：用户指令 = 框架层第二消费面确立）。
+ */
+export interface ListScaffoldProps {
+    /** 页面标题（PageHeader title） */
+    title: string;
+    /** 标题副文案 */
+    sub?: string;
+    /** header 右区（按钮组——JSX 子元素面） */
+    actions?: VNodeChild;
+    /** 搜索/筛选工具区（loading 时仍渲染——搜索框可用） */
+    toolbar?: VNodeChild;
+    /** 加载中（loading 优先于 empty——不闪空态） */
+    loading?: boolean;
+    /** 空态定义（图标/文案/提示） */
+    empty?: {
+        icon?: string | null;
+        text?: string;
+        hint?: string;
+    };
+    /** 内容空（empty 仅在 isEmpty 时显示） */
+    isEmpty?: boolean;
+    /** 内容插槽（页面核心循环——children 在 empty 之后——有数据时渲染） */
+    children?: VNodeChild;
+}
+export declare const ListScaffold: Component<ListScaffoldProps>;

package/dist/client/components/Menu/Menu.d.ts

@@ -15,6 +15,8 @@ export interface MenuItem {
     group?: string;
     active?: boolean;
     danger?: boolean;
+    /** 计数徽标（数字 → Badge count 胶囊——99+ 溢出；label 直传自定义形态） */
+    badge?: string | number;
     onClick?: () => void;
     /** 子菜单项（有 children 即渲染为可展开子菜单） */
     children?: MenuItem[];

package/dist/client/components/StatusDot/StatusDot.d.ts

@@ -0,0 +1,25 @@
+/** StatusDot：状态点（on/tone 语义——label 缺省只渲染点）（showcase /components/status-dot） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
+/**
+ * weifuwu/components — StatusDot
+ *
+ * 状态点原语（颜色语义——一个状态一个声音）。
+ * 契约（agent-platform StatusDot 语言化——原名「自带默认文案的运行中/已暂停」
+ * 与调用方状态标签撞车——双标签实证修复）：
+ * - **label 缺省只渲染点**（文字是调用方职责——防双标签）
+ * - tone 覆盖点/文字色：success 绿（健康运行）· warning 黄（降级）·
+ *   error 红（故障）· default 灰（非活跃）
+ * - on 是主开关（true→success · false→default）——tone 仅在非绿非灰时传
+ *
+ * 来源：agent-platform ui.tsx StatusDot（平台原语——库无状态点面——
+ * 入库：通用状态语义组件）。
+ */
+export interface StatusDotProps {
+    /** 状态开关（true→success · false→default） */
+    on?: boolean;
+    /** 状态文案（缺省只渲染点——文字是调用方职责） */
+    label?: VNodeChild;
+    /** 覆盖色（非绿非灰时传——降级/故障） */
+    tone?: 'success' | 'warning' | 'error' | 'default';
+}
+export declare const StatusDot: Component<StatusDotProps>;

package/dist/client/components/index.d.ts

@@ -290,3 +290,9 @@ export { Math } from './Math/Math.ts';
 export type { MathProps } from './Math/Math.ts';
 export { WordCloud } from './WordCloud/WordCloud.ts';
 export type { WordCloudProps, WordCloudData } from './WordCloud/WordCloud.ts';
+export { CronPicker } from './CronPicker/CronPicker.ts';
+export type { CronPickerProps } from './CronPicker/CronPicker.ts';
+export { ListScaffold } from './ListScaffold/ListScaffold.ts';
+export type { ListScaffoldProps } from './ListScaffold/ListScaffold.ts';
+export { StatusDot } from './StatusDot/StatusDot.ts';
+export type { StatusDotProps } from './StatusDot/StatusDot.ts';