@aaas-pro/library 0.0.0-stage → 0.1.0

package/dist/components/product-picker.d.ts

@@ -0,0 +1,19 @@
+export interface ProductOption {
+    code: string;
+    name: string;
+    category: string;
+    spec: string;
+    unitGroup: string;
+    price: string | number;
+}
+export declare function ProductPickerDialog<T extends ProductOption>({ products, exists, initialSelected, onConfirm, onClose, }: {
+    /** 商品库（商品主数据） */
+    products: T[];
+    /** 不允许选择的商品编码，默认 []。 */
+    exists?: string[];
+    /** 初始勾选的商品编码（编辑/回显已选） */
+    initialSelected?: string[];
+    /** 确认添加：返回勾选的商品行（含初始勾选的累计结果） */
+    onConfirm: (picked: T[]) => void;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/components/product-picker.js

@@ -0,0 +1,155 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState, useMemo } from "react";
+import { Button } from "./ui/button.js";
+import { Input } from "./ui/input.js";
+import { Badge } from "./ui/badge.js";
+import { Checkbox } from "./ui/checkbox.js";
+import { Table, TableHeader, TableRow, TableHead, TableBody, TableCell } from "./ui/table.js";
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from "./ui/dialog.js";
+import { PackagePlus, Search } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+function ProductPickerDialog({
+  products,
+  exists = [],
+  initialSelected,
+  onConfirm,
+  onClose
+}) {
+  const [q, setQ] = useState("");
+  const [cat, setCat] = useState("全部分类");
+  const [selected, setSelected] = useState((initialSelected || []).filter((id) => !exists.includes(id) && products.some((p) => p.code === id)));
+  const existsSet = useMemo(() => new Set(exists), [exists]);
+  const selectedSet = useMemo(() => new Set(selected), [selected]);
+  const [position, setPosition] = useState({ filter: "", page: 1 });
+  const filterKey = `${q}\0${cat}`;
+  const categoryCounts = useMemo(() => {
+    const counts = /* @__PURE__ */ new Map();
+    for (const p of products) if (p.category) counts.set(p.category, (counts.get(p.category) ?? 0) + 1);
+    return counts;
+  }, [products]);
+  const cats = useMemo(() => ["全部分类", ...categoryCounts.keys()], [categoryCounts]);
+  const filtered = useMemo(() => {
+    const kw = q.trim().toLowerCase();
+    return products.filter((p) => (cat === "全部分类" || p.category === cat) && (!kw || p.name.toLowerCase().includes(kw) || p.code.toLowerCase().includes(kw) || p.spec.toLowerCase().includes(kw)));
+  }, [products, q, cat]);
+  const pageSize = 50;
+  const pages = Math.max(1, Math.ceil(filtered.length / pageSize));
+  const page = position.filter === filterKey ? Math.min(position.page, pages) : 1;
+  const visibleProducts = filtered.slice((page - 1) * pageSize, page * pageSize);
+  const selectable = useMemo(() => filtered.filter((p) => !existsSet.has(p.code)).map((p) => p.code), [filtered, existsSet]);
+  const allSelected = selectable.length > 0 && selectable.every((c) => selectedSet.has(c));
+  function toggle(code) {
+    setSelected((prev) => prev.includes(code) ? prev.filter((x) => x !== code) : [...prev, code]);
+  }
+  function toggleAll() {
+    const selectableSet = new Set(selectable);
+    setSelected((prev) => allSelected ? prev.filter((id) => !selectableSet.has(id)) : [.../* @__PURE__ */ new Set([...prev, ...selectable])]);
+  }
+  function confirm() {
+    const picked = products.filter((p) => selectedSet.has(p.code) && !existsSet.has(p.code));
+    if (picked.length === 0) {
+      return;
+    }
+    onConfirm(picked);
+  }
+  return /* @__PURE__ */ jsx(Dialog, { open: true, onOpenChange: (v) => !v && onClose(), children: /* @__PURE__ */ jsxs(DialogContent, { className: "w-[96vw] sm:max-w-6xl h-[88vh] flex flex-col", children: [
+    /* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsxs(DialogTitle, { className: "flex items-center gap-2 text-base", children: [
+      /* @__PURE__ */ jsx(PackagePlus, { className: "w-4 h-4 text-primary" }),
+      "添加商品",
+      /* @__PURE__ */ jsx("span", { className: "text-xs font-normal text-muted-foreground", children: "从商品库按分类 + 名称 / 编码 / 规格快速搜索，勾选后返回给应用" })
+    ] }) }),
+    /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ jsxs("div", { className: "relative flex-1", children: [
+          /* @__PURE__ */ jsx(Search, { className: "w-4 h-4 text-muted-foreground absolute left-2.5 top-1/2 -translate-y-1/2" }),
+          /* @__PURE__ */ jsx(Input, { value: q, onChange: (e) => setQ(e.target.value), placeholder: "搜索商品名称 / 编码 / 规格...", className: "h-9 text-sm bg-card pl-8", autoFocus: true })
+        ] }),
+        /* @__PURE__ */ jsx(Button, { size: "sm", variant: "outline", className: "h-9 text-xs shrink-0", onClick: toggleAll, disabled: selectable.length === 0, children: allSelected ? "清空勾选" : "全选结果" })
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "flex max-h-24 overflow-y-auto items-center gap-1.5 flex-wrap", children: cats.map((c) => /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          "aria-label": c,
+          onClick: () => setCat(c),
+          className: cn(
+            "px-3 py-1.5 rounded-full text-xs font-medium transition-colors border",
+            cat === c ? "bg-primary text-white border-primary" : "bg-card border-border text-muted-foreground hover:border-primary hover:text-primary"
+          ),
+          children: [
+            c,
+            c !== "全部分类" && /* @__PURE__ */ jsxs("span", { className: cn("ml-1", cat === c ? "text-blue-100" : "text-muted-foreground"), children: [
+              "（",
+              categoryCounts.get(c),
+              "）"
+            ] })
+          ]
+        },
+        c
+      )) })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "flex-1 min-h-0 overflow-y-auto rounded-md border border-border", children: /* @__PURE__ */ jsxs(Table, { children: [
+      /* @__PURE__ */ jsx(TableHeader, { children: /* @__PURE__ */ jsxs(TableRow, { children: [
+        /* @__PURE__ */ jsx(TableHead, { className: "w-9" }),
+        /* @__PURE__ */ jsx(TableHead, { children: "商品" }),
+        /* @__PURE__ */ jsx(TableHead, { children: "分类" }),
+        /* @__PURE__ */ jsx(TableHead, { children: "规格" }),
+        /* @__PURE__ */ jsx(TableHead, { children: "单位" }),
+        /* @__PURE__ */ jsx(TableHead, { className: "text-right", children: "参考价格" })
+      ] }) }),
+      /* @__PURE__ */ jsxs(TableBody, { children: [
+        visibleProducts.map((p) => {
+          const inScheme = existsSet.has(p.code);
+          const on = selectedSet.has(p.code);
+          return /* @__PURE__ */ jsxs(TableRow, { className: cn(inScheme && "opacity-55"), children: [
+            /* @__PURE__ */ jsx(TableCell, { children: /* @__PURE__ */ jsx(Checkbox, { "aria-label": `选择${p.name}`, checked: inScheme || on, disabled: inScheme, onCheckedChange: () => toggle(p.code) }) }),
+            /* @__PURE__ */ jsxs(TableCell, { className: "text-sm", children: [
+              p.name,
+              /* @__PURE__ */ jsx("span", { className: "ml-1.5 font-mono text-[10px] text-slate-300", children: p.code }),
+              inScheme && /* @__PURE__ */ jsx(Badge, { variant: "outline", className: "ml-1.5 text-[10px] bg-muted text-muted-foreground border-border", children: "不可选择" })
+            ] }),
+            /* @__PURE__ */ jsx(TableCell, { children: /* @__PURE__ */ jsx(Badge, { variant: "outline", className: "text-[10px] bg-muted text-muted-foreground border-border", children: p.category }) }),
+            /* @__PURE__ */ jsx(TableCell, { className: "text-xs text-muted-foreground", children: p.spec }),
+            /* @__PURE__ */ jsx(TableCell, { className: "text-xs text-muted-foreground", children: p.unitGroup }),
+            /* @__PURE__ */ jsx(TableCell, { className: "text-right text-xs tabular-nums text-muted-foreground", children: p.price })
+          ] }, p.code);
+        }),
+        filtered.length === 0 && /* @__PURE__ */ jsx(TableRow, { children: /* @__PURE__ */ jsx(TableCell, { colSpan: 6, className: "text-center text-xs text-muted-foreground py-6", children: "当前分类下未搜到匹配商品，换个分类或关键词试试" }) })
+      ] })
+    ] }) }),
+    /* @__PURE__ */ jsxs("nav", { "aria-label": "商品分页", className: "flex items-center justify-between gap-2 text-xs text-muted-foreground", children: [
+      /* @__PURE__ */ jsxs("span", { children: [
+        "共 ",
+        filtered.length,
+        " 个商品 · 第 ",
+        page,
+        "/",
+        pages,
+        " 页 · 每页 ",
+        pageSize,
+        " 个"
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+        /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", "aria-label": "上一页商品", disabled: page <= 1, onClick: () => setPosition({ filter: filterKey, page: page - 1 }), children: "上一页" }),
+        /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", "aria-label": "下一页商品", disabled: page >= pages, onClick: () => setPosition({ filter: filterKey, page: page + 1 }), children: "下一页" })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs(DialogFooter, { className: "gap-2", children: [
+      /* @__PURE__ */ jsxs("span", { className: "mr-auto text-xs text-muted-foreground", children: [
+        "共勾选 ",
+        selected.length,
+        " 个商品",
+        cat !== "全部分类" && ` · 当前分类 ${cat}`
+      ] }),
+      /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", className: "h-8 text-xs", onClick: onClose, children: "取消" }),
+      /* @__PURE__ */ jsxs(Button, { size: "sm", className: "h-8 text-xs", disabled: selected.length === 0, onClick: confirm, children: [
+        "添加选中（",
+        selected.length,
+        "）"
+      ] })
+    ] })
+  ] }) });
+}
+export {
+  ProductPickerDialog
+};

package/dist/components/ref-doc-picker.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode } from 'react';
+export interface RefDocItem {
+    id: string;
+    label: string;
+    sub?: string;
+}
+export declare function RefDocPicker({ label, items, value, editable, onPick, onRemove, renderDetail, onOpenDoc, closeOnPick, hint, compact, }: {
+    label: string;
+    items: RefDocItem[];
+    value: string[];
+    editable: boolean;
+    onPick?: (id: string) => void;
+    onRemove?: (id: string) => void;
+    renderDetail?: (id: string) => ReactNode;
+    /** 给了就＝点关联单据直接开它的原生表单（优先于摘要弹窗） */
+    onOpenDoc?: (id: string) => void;
+    closeOnPick?: boolean;
+    hint?: string;
+    compact?: boolean;
+}): import("react").JSX.Element;
+export declare function DetailRow({ label: k, children }: {
+    label: string;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/components/ref-doc-picker.js

@@ -0,0 +1,139 @@
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { useState } from "react";
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from "./ui/dialog.js";
+import { Button } from "./ui/button.js";
+import { FileText, X, Search, FileDown } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+function RefDocPicker({
+  label,
+  items,
+  value,
+  editable,
+  onPick,
+  onRemove,
+  renderDetail,
+  onOpenDoc,
+  closeOnPick = true,
+  hint,
+  compact = false
+}) {
+  const [pickOpen, setPickOpen] = useState(false);
+  const [detailId, setDetailId] = useState(null);
+  const labelOf = (id) => items.find((i) => i.id === id)?.label || id;
+  const candidates = items.filter((i) => !value.includes(i.id));
+  const openDetail = (id) => {
+    if (onOpenDoc) onOpenDoc(id);
+    else setDetailId(id);
+  };
+  return /* @__PURE__ */ jsxs("div", { className: compact ? "flex items-center gap-1.5 flex-wrap" : "space-y-1.5", children: [
+    compact ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("span", { className: "text-[11px] text-muted-foreground shrink-0", children: label }),
+      value.length === 0 && /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: "未关联" }),
+      value.map((id) => /* @__PURE__ */ jsxs("span", { className: cn(
+        "inline-flex items-center gap-1 px-2 py-1 rounded-md border text-xs max-w-56",
+        "bg-card border-border text-primary hover:border-primary"
+      ), children: [
+        /* @__PURE__ */ jsxs("button", { type: "button", className: "truncate underline-offset-2 hover:underline", onClick: () => openDetail(id), title: onOpenDoc ? "打开原生表单" : "查看摘要", children: [
+          /* @__PURE__ */ jsx(FileText, { className: "w-3 h-3 inline mr-0.5 -mt-0.5 text-primary" }),
+          labelOf(id)
+        ] }),
+        editable && onRemove && /* @__PURE__ */ jsx("button", { type: "button", className: "text-slate-300 hover:text-red-500 shrink-0", "aria-label": `移除${labelOf(id)}`, onClick: () => onRemove(id), children: /* @__PURE__ */ jsx(X, { className: "w-3 h-3" }) })
+      ] }, id)),
+      editable && onPick && items.length > 0 && /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          onClick: () => setPickOpen(true),
+          className: "inline-flex items-center gap-1 px-2 py-1 rounded-md text-xs font-medium text-primary hover:bg-primary/5 border border-dashed border-border",
+          children: [
+            /* @__PURE__ */ jsx(Search, { className: "w-3 h-3" }),
+            "选择"
+          ]
+        }
+      )
+    ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2.5", children: [
+        /* @__PURE__ */ jsx("label", { className: "text-xs font-medium text-muted-foreground w-[84px] shrink-0 text-right pt-1.5", children: label }),
+        /* @__PURE__ */ jsxs("div", { className: "flex-1 flex items-center gap-1.5 flex-wrap min-h-8", children: [
+          value.length === 0 && /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: items.length > 0 ? "未关联" : "—" }),
+          value.map((id) => /* @__PURE__ */ jsxs("span", { className: cn(
+            "inline-flex items-center gap-1 px-2 py-1 rounded-md border text-xs max-w-72",
+            "bg-card border-border text-primary hover:border-primary"
+          ), children: [
+            /* @__PURE__ */ jsxs("button", { type: "button", className: "truncate underline-offset-2 hover:underline", onClick: () => openDetail(id), title: onOpenDoc ? "打开原生表单" : "查看摘要", children: [
+              /* @__PURE__ */ jsx(FileText, { className: "w-3 h-3 inline mr-0.5 -mt-0.5 text-primary" }),
+              labelOf(id)
+            ] }),
+            editable && onRemove && /* @__PURE__ */ jsx("button", { type: "button", className: "text-slate-300 hover:text-red-500 shrink-0", "aria-label": `移除${labelOf(id)}`, onClick: () => onRemove(id), children: /* @__PURE__ */ jsx(X, { className: "w-3 h-3" }) })
+          ] }, id)),
+          editable && onPick && items.length > 0 && /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              onClick: () => setPickOpen(true),
+              className: "inline-flex items-center gap-1 px-2.5 py-1 rounded-md text-xs font-medium text-primary hover:bg-primary/5 border border-dashed border-border",
+              children: [
+                /* @__PURE__ */ jsx(Search, { className: "w-3 h-3" }),
+                "选择关联"
+              ]
+            }
+          )
+        ] })
+      ] }),
+      hint && /* @__PURE__ */ jsx("div", { className: "text-[11px] text-muted-foreground pl-[92px]", children: hint })
+    ] }),
+    /* @__PURE__ */ jsx(Dialog, { open: pickOpen, onOpenChange: setPickOpen, children: /* @__PURE__ */ jsxs(DialogContent, { className: "max-w-xl", children: [
+      /* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsxs(DialogTitle, { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ jsx(FileDown, { className: "w-4 h-4 text-rose-400" }),
+        "选择关联",
+        label
+      ] }) }),
+      /* @__PURE__ */ jsxs("div", { className: "space-y-1.5 max-h-[50vh] overflow-y-auto", children: [
+        items.map((it) => {
+          const picked = value.includes(it.id);
+          return /* @__PURE__ */ jsxs("div", { className: cn(
+            "flex items-center gap-2 rounded border px-3 py-2 text-xs transition-colors",
+            picked ? "border-border bg-muted" : "border-border hover:border-primary hover:bg-primary/5"
+          ), children: [
+            /* @__PURE__ */ jsx("span", { className: "font-medium text-muted-foreground w-36 truncate", children: it.id }),
+            /* @__PURE__ */ jsx("span", { className: "text-muted-foreground flex-1 truncate", children: it.sub || it.label }),
+            picked ? /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "已关联" }) : /* @__PURE__ */ jsx(Button, { size: "sm", className: "h-7 text-xs bg-primary hover:bg-primary/90", onClick: () => {
+              onPick?.(it.id);
+              if (closeOnPick) setPickOpen(false);
+            }, children: "选择" })
+          ] }, it.id);
+        }),
+        items.length === 0 && /* @__PURE__ */ jsxs("div", { className: "text-center text-xs text-muted-foreground py-8", children: [
+          "暂无可关联的",
+          label
+        ] }),
+        candidates.length === 0 && items.length > 0 && /* @__PURE__ */ jsxs("div", { className: "text-center text-xs text-muted-foreground py-8", children: [
+          "可关联的",
+          label,
+          "均已关联"
+        ] })
+      ] })
+    ] }) }),
+    /* @__PURE__ */ jsx(Dialog, { open: !!detailId, onOpenChange: (v) => {
+      if (!v) setDetailId(null);
+    }, children: /* @__PURE__ */ jsxs(DialogContent, { className: "max-w-md", children: [
+      /* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsxs(DialogTitle, { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ jsx(FileText, { className: "w-4 h-4 text-primary" }),
+        label,
+        "详情 · ",
+        detailId
+      ] }) }),
+      detailId && /* @__PURE__ */ jsx("div", { className: "text-xs space-y-3", children: renderDetail ? renderDetail(detailId) : /* @__PURE__ */ jsx("div", { className: "text-muted-foreground", children: "暂无摘要数据源" }) })
+    ] }) })
+  ] });
+}
+function DetailRow({ label: k, children }) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex justify-between gap-4 border-b border-dashed border-border pb-1.5", children: [
+    /* @__PURE__ */ jsx("span", { className: "text-muted-foreground shrink-0", children: k }),
+    /* @__PURE__ */ jsx("span", { className: "font-medium text-foreground text-right", children })
+  ] });
+}
+export {
+  DetailRow,
+  RefDocPicker
+};

package/dist/components/scroll-to-top.d.ts

@@ -0,0 +1 @@
+export declare function ScrollToTop(): null;

package/dist/components/scroll-to-top.js

@@ -0,0 +1,20 @@
+import { useEffect } from "react";
+import { useLocation } from "react-router-dom";
+function ScrollToTop() {
+  const pathname = useLocation().pathname;
+  useEffect(() => {
+    const container = document.getElementById("main-scroll-container");
+    if (container && typeof container.scrollTo === "function") {
+      container.scrollTo(0, 0);
+    } else if (container) {
+      try {
+        container.scrollTop = 0;
+      } catch {
+      }
+    }
+  }, [pathname]);
+  return null;
+}
+export {
+  ScrollToTop
+};

package/dist/components/state-view.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+export type StateViewKind = 'loading' | 'empty' | 'error' | 'forbidden' | 'not-found' | 'offline';
+export interface StateViewProps {
+    kind: StateViewKind;
+    /** 覆盖默认标题。 */
+    title?: ReactNode;
+    /** 覆盖默认说明。 */
+    description?: ReactNode;
+    /** 提供时显示“重试”按钮（error / offline 默认文案）。 */
+    onRetry?: () => void;
+    /** 额外操作，如“新建”。显示在重试按钮之后。 */
+    action?: ReactNode;
+    /** 服务端请求 ID，便于用户反馈问题时定位日志。 */
+    requestId?: string;
+    /** page：页面级（居中、留白大）；section：卡片/表格内（紧凑）。默认 section。 */
+    size?: 'page' | 'section';
+    /** loading 时以骨架行代替旋转图标，适合表格与列表。 */
+    skeletonRows?: number;
+    className?: string;
+}
+/**
+ * 统一的数据状态视图：加载、空、失败、无权限、不存在、离线。
+ * 各状态使用不同图标、语义色与文案，避免把“无权限”“服务异常”都显示为“暂无数据”。
+ * 数据请求与重试逻辑由宿主负责，本组件只负责呈现。
+ */
+export declare function StateView({ kind, title, description, onRetry, action, requestId, size, skeletonRows, className }: StateViewProps): import("react").JSX.Element;

package/dist/components/state-view.js

@@ -0,0 +1,75 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { RotateCcw, WifiOff, FileQuestion, Lock, AlertTriangle, Inbox } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+import { Button } from "./ui/button.js";
+import { Skeleton } from "./ui/skeleton.js";
+import { Spinner } from "./ui/spinner.js";
+const presets = {
+  loading: { icon: /* @__PURE__ */ jsx(Spinner, {}), title: "加载中…", description: "", tone: "text-primary" },
+  empty: { icon: /* @__PURE__ */ jsx(Inbox, {}), title: "暂无数据", description: "当前条件下没有记录，可调整筛选条件后重试。", tone: "text-muted-foreground" },
+  error: { icon: /* @__PURE__ */ jsx(AlertTriangle, {}), title: "加载失败", description: "服务暂时不可用，请稍后重试。", tone: "text-destructive" },
+  forbidden: { icon: /* @__PURE__ */ jsx(Lock, {}), title: "没有访问权限", description: "当前账号或单位无权查看此内容，如需开通请联系管理员。", tone: "text-warning" },
+  "not-found": { icon: /* @__PURE__ */ jsx(FileQuestion, {}), title: "内容不存在", description: "记录可能已被删除，或不在当前单位的可见范围内。", tone: "text-muted-foreground" },
+  offline: { icon: /* @__PURE__ */ jsx(WifiOff, {}), title: "网络连接中断", description: "请检查网络后重试。", tone: "text-muted-foreground" }
+};
+function StateView({ kind, title, description, onRetry, action, requestId, size = "section", skeletonRows, className }) {
+  const preset = presets[kind];
+  const isError = kind === "error" || kind === "offline";
+  if (kind === "loading" && skeletonRows) {
+    return /* @__PURE__ */ jsx("div", { role: "status", "aria-label": "加载中", "aria-busy": true, className: cn("flex flex-col gap-3 p-4", className), "data-slot": "state-view", "data-kind": kind, children: Array.from({ length: skeletonRows }, (_, i) => /* @__PURE__ */ jsx(Skeleton, { className: "h-9 w-full", style: { opacity: 1 - i * (0.6 / skeletonRows) } }, i)) });
+  }
+  if (kind === "loading") {
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        role: "status",
+        "aria-label": "加载中",
+        "aria-busy": true,
+        "data-slot": "state-view",
+        "data-kind": kind,
+        className: cn(
+          "flex flex-col items-center justify-center text-center text-balance",
+          size === "page" ? "min-h-[50vh] gap-4 px-6 py-16" : "gap-3 px-4 py-10",
+          className
+        ),
+        children: [
+          /* @__PURE__ */ jsx(Spinner, { className: cn("text-primary motion-reduce:animate-none", size === "page" ? "size-8" : "size-7") }),
+          /* @__PURE__ */ jsxs("div", { className: "flex max-w-sm flex-col gap-1.5", children: [
+            /* @__PURE__ */ jsx("p", { className: cn("font-medium text-foreground/90", size === "page" ? "text-base" : "text-sm"), children: title ?? preset.title }),
+            description && /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: description })
+          ] })
+        ]
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: isError ? "alert" : "status",
+      "data-slot": "state-view",
+      "data-kind": kind,
+      className: cn("flex flex-col items-center justify-center gap-3 text-center text-balance", size === "page" ? "min-h-[50vh] px-6 py-16" : "px-4 py-10", className),
+      children: [
+        /* @__PURE__ */ jsx("div", { className: cn("grid size-12 place-items-center rounded-xl bg-muted ring-1 ring-border [&_svg:not([class*=size-])]:size-6", preset.tone), children: preset.icon }),
+        /* @__PURE__ */ jsxs("div", { className: "flex max-w-sm flex-col gap-1", children: [
+          /* @__PURE__ */ jsx("p", { className: cn("font-semibold text-foreground", size === "page" ? "text-lg" : "text-base"), children: title ?? preset.title }),
+          (description ?? preset.description) && /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: description ?? preset.description }),
+          requestId && /* @__PURE__ */ jsxs("p", { className: "mt-1 font-mono text-xs text-muted-foreground/80", children: [
+            "请求 ID：",
+            requestId
+          ] })
+        ] }),
+        (onRetry || action) && /* @__PURE__ */ jsxs("div", { className: "mt-1 flex flex-wrap items-center justify-center gap-2", children: [
+          onRetry && /* @__PURE__ */ jsxs(Button, { type: "button", variant: "outline", size: "sm", onClick: onRetry, children: [
+            /* @__PURE__ */ jsx(RotateCcw, {}),
+            "重试"
+          ] }),
+          action
+        ] })
+      ]
+    }
+  );
+}
+export {
+  StateView
+};

package/dist/components/theme-switcher.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from 'react';
+import { type ThemeName } from '../theme';
+export interface ThemeSwitcherProps {
+    /** 自定义触发器（会被 asChild 包裹）；不传时使用幽灵图标按钮。 */
+    children?: ReactNode;
+    /** 默认触发器是否显示当前主题名称。 */
+    showLabel?: boolean;
+    /** 菜单对齐方式与方向，默认 end / bottom。 */
+    align?: 'start' | 'center' | 'end';
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /** 菜单标题，默认「界面主题」。 */
+    title?: ReactNode;
+    /** 是否显示导航栏外观（浅色 / 深色）切换，默认显示。 */
+    showNavStyle?: boolean;
+    className?: string;
+    contentClassName?: string;
+}
+/** 主题色样：外圈页面底色、内圆主色，让用户一眼区分明暗与品牌色。 */
+export declare function ThemeSwatch({ theme, className }: {
+    theme: ThemeName;
+    className?: string;
+}): import("react").JSX.Element;
+/**
+ * 主题切换器：色彩预设以色样网格呈现，下方可切换导航栏外观；选中即时生效并写入本地记忆。
+ * 须位于 ThemeProvider 内；在深色导航栏中使用时请通过 children 传入与导航配色一致的触发器。
+ */
+export declare function ThemeSwitcher({ children, showLabel, align, side, title, showNavStyle, className, contentClassName }: ThemeSwitcherProps): import("react").JSX.Element;

package/dist/components/theme-switcher.js

@@ -0,0 +1,77 @@
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+import { themePresets, useTheme, themeDescriptions, navStyleLabels } from "../theme/index.js";
+import { Button } from "./ui/button.js";
+import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator } from "./ui/dropdown-menu.js";
+import { Moon, Sun, Palette } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+function ThemeSwatch({ theme, className }) {
+  const t = themePresets[theme];
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      "aria-hidden": true,
+      "data-slot": "theme-swatch",
+      className: cn("relative inline-grid size-5 shrink-0 place-items-center rounded-full border", className),
+      style: { background: t.colorBackground, borderColor: t.colorBorder },
+      children: /* @__PURE__ */ jsx("span", { className: "size-2.5 rounded-full", style: { background: t.colorPrimary } })
+    }
+  );
+}
+function NavStylePreview({ style, theme }) {
+  const t = themePresets[theme];
+  const nav = style === "dark" ? "#14212e" : t.colorSurface;
+  return /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "inline-flex h-5 w-7 shrink-0 overflow-hidden rounded-[4px] border", style: { borderColor: t.colorBorder, background: t.colorBackground }, children: /* @__PURE__ */ jsx("span", { className: "h-full w-2.5", style: { background: nav } }) });
+}
+function ThemeSwitcher({ children, showLabel = false, align = "end", side = "bottom", title = "界面主题", showNavStyle = true, className, contentClassName }) {
+  const { theme, setTheme, themes, labels, navStyle, setNavStyle } = useTheme();
+  const CurrentIcon = theme === "dark" ? Moon : themes.includes("dark") && themes.length === 2 ? Sun : Palette;
+  const navLocked = theme === "dark";
+  return /* @__PURE__ */ jsxs(DropdownMenu, { children: [
+    /* @__PURE__ */ jsx(DropdownMenuTrigger, { asChild: true, children: children ?? /* @__PURE__ */ jsxs(Button, { type: "button", variant: "ghost", color: "default", size: showLabel ? "sm" : "icon-sm", "aria-label": showLabel ? void 0 : `切换主题（当前：${labels[theme]}）`, title: showLabel ? void 0 : `切换主题（当前：${labels[theme]}）`, className: cn("text-muted-foreground hover:text-foreground", className), children: [
+      /* @__PURE__ */ jsx(CurrentIcon, {}),
+      showLabel && /* @__PURE__ */ jsx("span", { children: labels[theme] })
+    ] }) }),
+    /* @__PURE__ */ jsxs(DropdownMenuContent, { align, side, className: cn("w-[19rem] p-2", contentClassName), children: [
+      /* @__PURE__ */ jsx(DropdownMenuLabel, { className: "px-1 pb-1.5 pt-0.5 text-xs font-medium text-muted-foreground", children: title }),
+      /* @__PURE__ */ jsx(DropdownMenuRadioGroup, { value: theme, onValueChange: (v) => setTheme(v), className: "grid grid-cols-3 gap-1", children: themes.map((name) => /* @__PURE__ */ jsxs(
+        DropdownMenuRadioItem,
+        {
+          value: name,
+          "data-theme-option": name,
+          title: themeDescriptions[name],
+          className: "flex-col items-start gap-1.5 rounded-md border border-transparent px-2 py-2 pl-2 data-[state=checked]:border-primary data-[state=checked]:bg-secondary [&>span:first-child]:hidden",
+          children: [
+            /* @__PURE__ */ jsx(ThemeSwatch, { theme: name, className: "size-6" }),
+            /* @__PURE__ */ jsx("span", { className: "text-xs leading-none", children: labels[name] })
+          ]
+        },
+        name
+      )) }),
+      showNavStyle && /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(DropdownMenuSeparator, { className: "my-2" }),
+        /* @__PURE__ */ jsxs(DropdownMenuLabel, { className: "px-1 pb-1.5 pt-0 text-xs font-medium text-muted-foreground", children: [
+          "导航栏",
+          navLocked && /* @__PURE__ */ jsx("span", { className: "ml-1 font-normal", children: "（深色主题下固定为深色）" })
+        ] }),
+        /* @__PURE__ */ jsx(DropdownMenuRadioGroup, { value: navStyle, onValueChange: (v) => setNavStyle(v), className: "grid grid-cols-2 gap-1", children: ["light", "dark"].map((style) => /* @__PURE__ */ jsxs(
+          DropdownMenuRadioItem,
+          {
+            value: style,
+            disabled: navLocked,
+            "data-nav-option": style,
+            className: "gap-2 rounded-md border border-transparent px-2 py-1.5 pl-2 data-[state=checked]:border-primary data-[state=checked]:bg-secondary [&>span:first-child]:hidden",
+            children: [
+              /* @__PURE__ */ jsx(NavStylePreview, { style, theme }),
+              /* @__PURE__ */ jsx("span", { className: "text-xs", children: navStyleLabels[style] })
+            ]
+          },
+          style
+        )) })
+      ] })
+    ] })
+  ] });
+}
+export {
+  ThemeSwatch,
+  ThemeSwitcher
+};

package/dist/components/time-filter.d.ts

@@ -0,0 +1,7 @@
+export type TimeRange = 'today' | 'week' | 'month' | 'quarter' | 'year' | 'custom';
+interface TimeFilterProps {
+    value: TimeRange;
+    onChange: (value: TimeRange) => void;
+}
+export declare function TimeFilter({ value, onChange }: TimeFilterProps): import("react").JSX.Element;
+export {};