@aaas-pro/library 0.0.0-stage → 0.1.0

package/dist/components/draft-row-actions.js

@@ -0,0 +1,70 @@
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useContext, useState } from "react";
+import { PermissionContext } from "./permission-context.js";
+import { Pencil, Trash2 } from "../icons/index.js";
+import { Button } from "./ui/button.js";
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter } from "./ui/dialog.js";
+import { cn } from "../lib/utils.js";
+function DraftRowActions({ status, docLabel, docNo, onEdit, onDelete, editableStatuses = ["草稿", "待确认"], align = "center", disabled = false }) {
+  const can = useContext(PermissionContext);
+  const [open, setOpen] = useState(false), [busy, setBusy] = useState(false), [error, setError] = useState("");
+  if (!editableStatuses.includes(status)) return null;
+  async function confirm() {
+    if (busy || disabled || !can("delete")) return;
+    setBusy(true);
+    setError("");
+    try {
+      const result = await onDelete();
+      if (typeof result === "string" && result) setError(result);
+      else setOpen(false);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : "删除失败，请重试");
+    } finally {
+      setBusy(false);
+    }
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("div", { className: cn("flex gap-1", align === "center" ? "justify-center" : "justify-end"), children: [
+      /* @__PURE__ */ jsxs(Button, { type: "button", variant: "outline", size: "sm", disabled: disabled || busy, permissionAction: "update", onClick: () => {
+        if (can("update")) onEdit();
+      }, children: [
+        /* @__PURE__ */ jsx(Pencil, { className: "size-3.5" }),
+        "编辑"
+      ] }),
+      /* @__PURE__ */ jsxs(Button, { type: "button", variant: "outline", color: "danger", size: "sm", disabled: disabled || busy, permissionAction: "delete", onClick: () => {
+        if (can("delete")) {
+          setError("");
+          setOpen(true);
+        }
+      }, children: [
+        /* @__PURE__ */ jsx(Trash2, { className: "size-3.5" }),
+        "删除"
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx(Dialog, { open, onOpenChange: (next) => {
+      if (!busy) setOpen(next);
+    }, children: /* @__PURE__ */ jsxs(DialogContent, { children: [
+      /* @__PURE__ */ jsxs(DialogHeader, { children: [
+        /* @__PURE__ */ jsxs(DialogTitle, { children: [
+          "删除",
+          docLabel
+        ] }),
+        /* @__PURE__ */ jsxs(DialogDescription, { children: [
+          "确认删除",
+          docLabel,
+          " ",
+          docNo,
+          "？具体删除方式由业务应用处理。"
+        ] })
+      ] }),
+      error && /* @__PURE__ */ jsx("p", { role: "alert", className: "text-sm text-destructive", children: error }),
+      /* @__PURE__ */ jsxs(DialogFooter, { children: [
+        /* @__PURE__ */ jsx(Button, { type: "button", variant: "outline", disabled: busy, onClick: () => setOpen(false), children: "取消" }),
+        /* @__PURE__ */ jsx(Button, { type: "button", color: "danger", loading: busy, disabled, permissionAction: "delete", onClick: () => void confirm(), children: "确认删除" })
+      ] })
+    ] }) })
+  ] });
+}
+export {
+  DraftRowActions
+};

package/dist/components/error-boundary.d.ts

@@ -0,0 +1,14 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+interface Props {
+    children: ReactNode;
+}
+interface State {
+    error: Error | null;
+}
+export declare class ErrorBoundary extends Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+}
+export {};

package/dist/components/error-boundary.js

@@ -0,0 +1,35 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Component } from "react";
+class ErrorBoundary extends Component {
+  state = { error: null };
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    console.error("应用错误边界捕获:", error, info);
+  }
+  render() {
+    if (this.state.error) {
+      const msg = this.state.error?.message || String(this.state.error);
+      const stack = this.state.error?.stack || "";
+      return /* @__PURE__ */ jsx("div", { style: { minHeight: "100vh", display: "flex", alignItems: "center", justifyContent: "center", background: "#f0f4f3", padding: "24px" }, children: /* @__PURE__ */ jsxs("div", { style: { maxWidth: "640px", width: "100%", background: "#fff", border: "1px solid #e2e8f0", borderRadius: "12px", padding: "24px", boxShadow: "0 10px 30px rgba(0,0,0,0.08)" }, children: [
+        /* @__PURE__ */ jsx("h2", { style: { fontSize: "18px", fontWeight: 600, color: "#0f172a", margin: 0 }, children: "页面出错了" }),
+        /* @__PURE__ */ jsx("p", { style: { marginTop: "8px", fontSize: "14px", color: "#64748b", margin: 0 }, children: "应用遇到错误导致无法渲染，请把下方错误信息反馈给开发者。" }),
+        /* @__PURE__ */ jsx("pre", { style: { marginTop: "12px", maxHeight: "160px", overflow: "auto", background: "#0f172a", color: "#94a3b8", padding: "12px", borderRadius: "8px", fontSize: "12px", whiteSpace: "pre-wrap", wordBreak: "break-all", margin: "12px 0 0 0" }, children: msg }),
+        stack ? /* @__PURE__ */ jsx("pre", { style: { marginTop: "8px", maxHeight: "160px", overflow: "auto", background: "#f1f5f9", color: "#475569", padding: "12px", borderRadius: "8px", fontSize: "11px", whiteSpace: "pre-wrap", wordBreak: "break-all", margin: "8px 0 0 0" }, children: stack }) : null,
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: () => location.reload(),
+            style: { marginTop: "16px", background: "#1e3a5f", color: "#fff", border: "none", borderRadius: "8px", padding: "8px 20px", fontSize: "14px", cursor: "pointer" },
+            children: "刷新重试"
+          }
+        )
+      ] }) });
+    }
+    return this.props.children;
+  }
+}
+export {
+  ErrorBoundary
+};

package/dist/components/glow-card.d.ts

@@ -0,0 +1,13 @@
+import { type VariantProps } from '../lib/variants';
+declare const glowCardVariants: (props?: ({
+    glow?: "blue" | "orange" | "none" | "purple" | "red" | "default" | "neon" | null | undefined;
+    padding?: "none" | "default" | "sm" | "lg" | null | undefined;
+} & {
+    class?: import("../lib/class-names").ClassValue;
+    className?: import("../lib/class-names").ClassValue;
+}) | undefined) => string;
+export interface GlowCardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof glowCardVariants> {
+    children: React.ReactNode;
+}
+declare const GlowCard: import("react").ForwardRefExoticComponent<GlowCardProps & import("react").RefAttributes<HTMLDivElement>>;
+export { GlowCard, glowCardVariants };

package/dist/components/glow-card.js

@@ -0,0 +1,48 @@
+import { jsx } from "react/jsx-runtime";
+import { cn } from "../lib/utils.js";
+import { cva } from "../lib/variants.js";
+import { forwardRef } from "react";
+const glowCardVariants = cva(
+  "relative rounded-2xl bg-card border border-border/50 overflow-hidden transition-all duration-300 ease-out",
+  {
+    variants: {
+      glow: {
+        default: "hover:shadow-[0_0_20px_color-mix(in_srgb,var(--primary)_15%,transparent)] hover:-translate-y-0.5 hover:border-[var(--primary)]/30",
+        purple: "hover:shadow-[0_0_20px_rgba(114,46,209,0.15)] hover:-translate-y-0.5 hover:border-[#722ed1]/30",
+        blue: "hover:shadow-[0_0_20px_rgba(14,165,233,0.15)] hover:-translate-y-0.5 hover:border-[#0ea5e9]/30",
+        orange: "hover:shadow-[0_0_20px_rgba(245,158,11,0.15)] hover:-translate-y-0.5 hover:border-[#f59e0b]/30",
+        red: "hover:shadow-[0_0_20px_rgba(239,68,68,0.15)] hover:-translate-y-0.5 hover:border-[#ef4444]/30",
+        neon: "hover:shadow-[0_0_25px_rgba(0,230,118,0.2)] hover:-translate-y-0.5 hover:border-[var(--primary-light)]/40",
+        none: ""
+      },
+      padding: {
+        default: "p-5",
+        sm: "p-4",
+        lg: "p-6",
+        none: "p-0"
+      }
+    },
+    defaultVariants: {
+      glow: "default",
+      padding: "default"
+    }
+  }
+);
+const GlowCard = forwardRef(
+  ({ className, glow, padding, children, ...props }, ref) => {
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        className: cn(glowCardVariants({ glow, padding }), className),
+        ...props,
+        children
+      }
+    );
+  }
+);
+GlowCard.displayName = "GlowCard";
+export {
+  GlowCard,
+  glowCardVariants
+};

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

@@ -0,0 +1,17 @@
+import { type SelectionStateProps } from '../internal/selection-base';
+export interface OrganizationOption {
+    /** Unique organization identifier, including across branches. */
+    id: string;
+    name: string;
+    disabled?: boolean;
+    children?: OrganizationOption[];
+}
+export interface OrgPickerProps extends SelectionStateProps {
+    options: OrganizationOption[];
+    value: string | null;
+    onChange: (value: string | null, option: OrganizationOption | null) => void;
+    /** popover: input with dropdown; inline: embedded organization tree. */
+    mode?: 'popover' | 'inline';
+}
+/** Organization selection with host-provided tree data; no organization-level assumptions. */
+export declare function OrgPicker({ options, value, onChange, mode, disabled, loading, error, placeholder, allowClear, className, 'aria-label': name }: OrgPickerProps): import("react").JSX.Element;

package/dist/components/org-picker.js

@@ -0,0 +1,56 @@
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { ChevronRight, Building2 } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+import { SelectionSearch, SelectionMessage, SelectionFrame, SelectionCheck } from "../internal/selection-base.js";
+function flatten(nodes) {
+  return nodes.flatMap((n) => [n, ...flatten(n.children ?? [])]);
+}
+function matches(node, query) {
+  return node.name.toLocaleLowerCase().includes(query) || !!node.children?.some((n) => matches(n, query));
+}
+function OrganizationRows({ nodes, value, onSelect, query, depth = 0 }) {
+  const [collapsed, setCollapsed] = useState(/* @__PURE__ */ new Set());
+  return /* @__PURE__ */ jsx(Fragment, { children: nodes.filter((n) => matches(n, query)).map((node) => {
+    const expanded = !!query || !collapsed.has(node.id), hasChildren = !!node.children?.length;
+    return /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsxs("div", { className: cn("flex items-center rounded-md", value === node.id ? "bg-primary/10" : "hover:bg-muted"), style: { paddingLeft: depth * 16 }, children: [
+        hasChildren ? /* @__PURE__ */ jsx("button", { type: "button", "aria-label": `${expanded ? "折叠" : "展开"}${node.name}`, "aria-expanded": expanded, onClick: () => setCollapsed((prev) => {
+          const next = new Set(prev);
+          if (next.has(node.id)) next.delete(node.id);
+          else next.add(node.id);
+          return next;
+        }), className: "rounded p-1.5 text-muted-foreground focus-visible:ring-2 focus-visible:ring-ring", children: /* @__PURE__ */ jsx(ChevronRight, { className: cn("size-4 transition-transform", expanded && "rotate-90") }) }) : /* @__PURE__ */ jsx("span", { className: "w-7 shrink-0" }),
+        /* @__PURE__ */ jsxs("button", { type: "button", disabled: node.disabled, "aria-pressed": value === node.id, onClick: () => onSelect(node), className: "flex min-w-0 flex-1 items-center gap-2 rounded px-2 py-2 text-left text-sm disabled:cursor-not-allowed disabled:opacity-40 focus-visible:ring-2 focus-visible:ring-ring", children: [
+          /* @__PURE__ */ jsx(Building2, { className: "size-4 shrink-0 text-muted-foreground" }),
+          /* @__PURE__ */ jsx("span", { className: "flex-1 truncate", children: node.name }),
+          /* @__PURE__ */ jsx(SelectionCheck, { selected: value === node.id })
+        ] })
+      ] }),
+      hasChildren && expanded && /* @__PURE__ */ jsx(OrganizationRows, { nodes: node.children, value, onSelect, query, depth: depth + 1 })
+    ] }, node.id);
+  }) });
+}
+function OrgPicker({ options, value, onChange, mode = "popover", disabled = false, loading = false, error, placeholder = "请选择组织", allowClear = true, className, "aria-label": name = "组织选择" }) {
+  const [open, setOpen] = useState(false), [query, setQuery] = useState("");
+  const normalized = query.trim().toLocaleLowerCase();
+  const label = flatten(options).find((n) => n.id === value)?.name ?? (value ?? "");
+  const content = /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(SelectionSearch, { value: query, onChange: setQuery, label: "搜索组织名称" }),
+    /* @__PURE__ */ jsx(SelectionMessage, { loading, error, empty: !options.some((n) => matches(n, normalized)) }),
+    !loading && !error && /* @__PURE__ */ jsx("div", { className: "max-h-80 overflow-auto p-2", children: /* @__PURE__ */ jsx(OrganizationRows, { nodes: options, value, query: normalized, onSelect: (n) => {
+      if (!disabled) {
+        onChange(n.id, n);
+        setOpen(false);
+      }
+    } }) })
+  ] });
+  if (mode === "inline") return /* @__PURE__ */ jsxs("fieldset", { disabled, "aria-label": name, className: cn("min-w-0 rounded-lg border border-border bg-card disabled:opacity-50", className), children: [
+    content,
+    allowClear && value !== null && /* @__PURE__ */ jsx("button", { type: "button", className: "w-full border-t border-border p-2 text-sm text-primary", onClick: () => onChange(null, null), children: "清空选择" })
+  ] });
+  return /* @__PURE__ */ jsx(SelectionFrame, { label, placeholder, disabled, open, onOpenChange: setOpen, name, className, clear: allowClear && value !== null ? () => onChange(null, null) : void 0, children: content });
+}
+export {
+  OrgPicker
+};

package/dist/components/overflow-row-actions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 行操作收纳渲染（列表操作列通用）：
+ * 操作按钮总数不超过 3 个时全部平铺；超过 3 个时仅平铺主要业务动作（primary），
+ * 将编辑/删除等次级操作收进「更多」下拉菜单中选择，行为与平铺按钮完全一致
+ * （编辑打开同一表单回调、删除走同一确认流程）。
+ */
+import { ReactNode } from 'react';
+export type RowActionTone = 'default' | 'danger' | 'warn' | 'ok' | 'amber' | 'blue';
+export interface RowAction {
+    key: string;
+    label: string;
+    /** 按钮内图标（平铺与菜单一致展示） */
+    icon?: ReactNode;
+    tone?: RowActionTone;
+    title?: string;
+    /** 主操作（提交审批/发布竞价/转订单等业务动作）：收纳时优先平铺；编辑/删除等次级操作收进「更多」 */
+    primary?: boolean;
+    onClick: () => void | Promise<unknown>;
+    /** 点击后先弹确认框再执行（与平铺按钮的删除确认一致） */
+    confirm?: {
+        title: string;
+        description: ReactNode;
+        confirmLabel?: string;
+    };
+}
+export declare function OverflowRowActions({ actions, align }: {
+    actions: RowAction[];
+    align?: 'center' | 'end';
+}): import("react").JSX.Element | null;

package/dist/components/overflow-row-actions.js

@@ -0,0 +1,135 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useContext, useState } from "react";
+import { CommandPermissionContext } from "./permission-context.js";
+import { Button } from "./ui/button.js";
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter } from "./ui/dialog.js";
+import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem } from "./ui/dropdown-menu.js";
+import { MoreHorizontal } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+import { toast } from "../primitives/toast.js";
+const MAX_INLINE = 3;
+const TONE_CLASS = {
+  default: "",
+  danger: "text-rose-600 border-rose-200 hover:bg-rose-50 hover:text-rose-700",
+  warn: "text-amber-600 border-amber-200 hover:bg-amber-50 hover:text-amber-700",
+  ok: "text-emerald-600 border-emerald-200 hover:text-emerald-700 hover:bg-emerald-50",
+  amber: "border-amber-200 text-amber-700 hover:bg-amber-50",
+  blue: "border-blue-200 text-blue-700 hover:bg-blue-50"
+};
+const TONE_MENU_ITEM = {
+  default: "",
+  danger: "text-rose-600 focus:text-rose-700",
+  warn: "text-amber-600 focus:text-amber-700",
+  ok: "text-emerald-600 focus:text-emerald-700",
+  amber: "text-amber-700 focus:text-amber-700",
+  blue: "text-blue-700 focus:text-blue-700"
+};
+function OverflowRowActions({ actions, align = "center" }) {
+  const canCommand = useContext(CommandPermissionContext);
+  actions = actions.filter((action) => canCommand(action.key));
+  const [confirming, setConfirming] = useState(null);
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState("");
+  if (actions.length === 0) return null;
+  const overflow = actions.length > MAX_INLINE;
+  const primaries = actions.filter((a) => a.primary);
+  const inlineMax = MAX_INLINE - 1;
+  const inlineKeys = new Set(
+    overflow ? primaries.slice(0, Math.max(inlineMax, 0)).map((a) => a.key) : actions.map((a) => a.key)
+  );
+  const menuActions = overflow ? actions.filter((a) => !inlineKeys.has(a.key)) : [];
+  if (overflow && menuActions.length === 0) {
+    actions.slice(Math.max(inlineMax, 0)).forEach((a) => inlineKeys.delete(a.key));
+  }
+  async function run(a) {
+    if (!canCommand(a.key)) return;
+    if (a.confirm) {
+      setError("");
+      setConfirming(a);
+      return;
+    }
+    try {
+      await a.onClick();
+    } catch (reason) {
+      toast.error(reason instanceof Error ? reason.message : "操作失败，请重试");
+    }
+  }
+  async function confirmRun() {
+    if (!confirming || busy) return;
+    if (!canCommand(confirming.key)) {
+      setError("当前没有该操作权限");
+      toast.error("当前没有该操作权限");
+      return;
+    }
+    setBusy(true);
+    setError("");
+    try {
+      const r = await confirming.onClick();
+      if (typeof r === "string" && r) {
+        setError(r);
+        toast.error(r);
+        return;
+      }
+      setConfirming(null);
+    } catch (reason) {
+      const message = reason instanceof Error ? reason.message : "操作失败，请重试";
+      setError(message);
+      toast.error(message);
+    } finally {
+      setBusy(false);
+    }
+  }
+  const inlineActions = actions.filter((a) => inlineKeys.has(a.key));
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex items-center gap-1.5 flex-wrap", align === "center" ? "justify-center" : "justify-end"), children: [
+    inlineActions.map((a) => /* @__PURE__ */ jsxs(
+      Button,
+      {
+        variant: "outline",
+        size: "sm",
+        className: cn("h-7 px-2 text-xs gap-1", TONE_CLASS[a.tone || "default"]),
+        title: a.title ?? a.label,
+        onClick: () => run(a),
+        children: [
+          a.icon,
+          a.label
+        ]
+      },
+      a.key
+    )),
+    overflow && menuActions.length > 0 && /* @__PURE__ */ jsxs(DropdownMenu, { children: [
+      /* @__PURE__ */ jsx(DropdownMenuTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", className: "h-7 px-2 text-xs gap-1", title: "更多操作（编辑/删除等）", children: [
+        /* @__PURE__ */ jsx(MoreHorizontal, { className: "w-3.5 h-3.5" }),
+        "更多"
+      ] }) }),
+      /* @__PURE__ */ jsx(DropdownMenuContent, { align: "end", className: "min-w-28", children: menuActions.map((a) => /* @__PURE__ */ jsxs(
+        DropdownMenuItem,
+        {
+          className: cn("text-xs gap-1.5 cursor-pointer", TONE_MENU_ITEM[a.tone || "default"]),
+          title: a.title ?? a.label,
+          onClick: () => run(a),
+          children: [
+            a.icon,
+            a.label
+          ]
+        },
+        a.key
+      )) })
+    ] }),
+    /* @__PURE__ */ jsx(Dialog, { open: !!confirming, onOpenChange: (v) => {
+      if (!v && !busy) setConfirming(null);
+    }, children: /* @__PURE__ */ jsxs(DialogContent, { className: "max-w-sm", showCloseButton: !busy, children: [
+      /* @__PURE__ */ jsxs(DialogHeader, { children: [
+        /* @__PURE__ */ jsx(DialogTitle, { className: "text-base", children: confirming?.confirm?.title }),
+        /* @__PURE__ */ jsx(DialogDescription, { className: "text-xs", children: confirming?.confirm?.description })
+      ] }),
+      error && /* @__PURE__ */ jsx("p", { role: "alert", className: "text-sm text-destructive", children: error }),
+      /* @__PURE__ */ jsxs(DialogFooter, { className: "gap-2", children: [
+        /* @__PURE__ */ jsx(Button, { variant: "outline", color: "default", size: "sm", disabled: busy, onClick: () => setConfirming(null), children: "取消" }),
+        /* @__PURE__ */ jsx(Button, { size: "sm", color: "danger", loading: busy, permissionCommand: confirming?.key, onClick: () => void confirmRun(), children: confirming?.confirm?.confirmLabel ?? "确认删除" })
+      ] })
+    ] }) })
+  ] });
+}
+export {
+  OverflowRowActions
+};

package/dist/components/page-header.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+export interface PageHeaderProps {
+    /** 页面标题（h1）。 */
+    title: ReactNode;
+    /** 一句话说明页面用途或数据范围。 */
+    description?: ReactNode;
+    /** 标题前的图标，可使用库内 SVG 图标。 */
+    icon?: ReactNode;
+    /** 右侧主操作区（主按钮放最右）。 */
+    actions?: ReactNode;
+    /** 标题上方的面包屑或返回链接。 */
+    breadcrumb?: ReactNode;
+    /** 标题下方的附加内容，如页签或统计条。 */
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * 页面标题区：统一页面级层次（面包屑 → 标题/说明 → 操作），窄屏时操作区换行到标题下方。
+ * 只负责布局与排版，不包含路由或权限逻辑。
+ */
+export declare function PageHeader({ title, description, icon, actions, breadcrumb, children, className }: PageHeaderProps): import("react").JSX.Element;

package/dist/components/page-header.js

@@ -0,0 +1,21 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { cn } from "../lib/utils.js";
+function PageHeader({ title, description, icon, actions, breadcrumb, children, className }) {
+  return /* @__PURE__ */ jsxs("header", { "data-slot": "page-header", className: cn("flex flex-col gap-3 pb-4", className), children: [
+    breadcrumb && /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: breadcrumb }),
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-start justify-between gap-x-6 gap-y-3", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-start gap-3", children: [
+        icon && /* @__PURE__ */ jsx("div", { className: "mt-0.5 grid size-9 shrink-0 place-items-center rounded-lg bg-secondary text-primary [&_svg:not([class*=size-])]:size-5", children: icon }),
+        /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+          /* @__PURE__ */ jsx("h1", { className: "truncate text-xl leading-8 font-semibold text-foreground", children: title }),
+          description && /* @__PURE__ */ jsx("p", { className: "mt-0.5 text-sm text-muted-foreground", children: description })
+        ] })
+      ] }),
+      actions && /* @__PURE__ */ jsx("div", { className: "flex shrink-0 flex-wrap items-center gap-2", children: actions })
+    ] }),
+    children
+  ] });
+}
+export {
+  PageHeader
+};

package/dist/components/permission-button.d.ts

@@ -0,0 +1,4 @@
+import { type ComponentProps } from 'react';
+import { type PermissionProps } from './permission-context';
+/** 保留原生按钮外观和事件；用于已有原生按钮的权限绑定。 */
+export declare function PermissionButton({ permissionAction, permissionResource, permissionCommand, ...props }: ComponentProps<'button'> & PermissionProps): import("react").JSX.Element | null;

package/dist/components/permission-button.js

@@ -0,0 +1,17 @@
+import { jsx } from "react/jsx-runtime";
+import { usePermissionCheck } from "./permission-context.js";
+function PermissionButton({ permissionAction, permissionResource, permissionCommand, ...props }) {
+  const permitted = usePermissionCheck({ permissionAction, permissionResource, permissionCommand });
+  if (!permitted()) return null;
+  return /* @__PURE__ */ jsx("button", { ...props, onClickCapture: (event) => {
+    if (!permitted()) {
+      event.preventDefault();
+      event.stopPropagation();
+      return;
+    }
+    props.onClickCapture?.(event);
+  } });
+}
+export {
+  PermissionButton
+};

package/dist/components/permission-context.d.ts

@@ -0,0 +1,12 @@
+/** 技术门禁；业务资源与权限来源由使用方注入。默认维持既有组件行为。 */
+export type PermissionAction = 'view' | 'create' | 'delete' | 'update' | 'audit' | 'unaudit' | 'export' | 'report' | 'grant';
+export interface PermissionProps {
+    permissionAction?: PermissionAction;
+    permissionResource?: string;
+    permissionCommand?: string;
+}
+export declare const PermissionContext: import("react").Context<(action: PermissionAction, resource?: string) => boolean>;
+/** 动态行操作码由业务方解释；组件库只执行注入的判定。 */
+export declare const CommandPermissionContext: import("react").Context<(command: string) => boolean>;
+export declare function usePermissionCheck({ permissionAction, permissionResource, permissionCommand }: PermissionProps): () => boolean;
+export declare function useActionPermission(props: PermissionProps): boolean;

package/dist/components/permission-context.js

@@ -0,0 +1,17 @@
+import { createContext, useContext } from "react";
+const PermissionContext = createContext(() => true);
+const CommandPermissionContext = createContext(() => true);
+function usePermissionCheck({ permissionAction, permissionResource, permissionCommand }) {
+  const can = useContext(PermissionContext);
+  const canCommand = useContext(CommandPermissionContext);
+  return () => (permissionCommand === void 0 || canCommand(permissionCommand)) && (permissionAction === void 0 || can(permissionAction, permissionResource));
+}
+function useActionPermission(props) {
+  return usePermissionCheck(props)();
+}
+export {
+  CommandPermissionContext,
+  PermissionContext,
+  useActionPermission,
+  usePermissionCheck
+};

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

@@ -0,0 +1,20 @@
+import { type SelectionStateProps } from '../internal/selection-base';
+export interface PersonOption {
+    id: string;
+    name: string;
+    organization?: string;
+    description?: string;
+    disabled?: boolean;
+}
+export interface PersonPickerProps extends SelectionStateProps {
+    options: PersonOption[];
+    /** Unique person IDs. Single mode accepts zero or one ID. */
+    value: string[];
+    onChange: (value: string[], selected: PersonOption[]) => void;
+    /** Default: true. false selects one person and closes the dropdown. */
+    multiple?: boolean;
+    /** Optional search notification; fetching and request cancellation belong to the host. */
+    onSearch?: (keyword: string) => void;
+}
+/** Controlled person selection. The host owns fetching, permissions and identity data. */
+export declare function PersonPicker({ options, value, onChange, multiple, onSearch, disabled, loading, error, placeholder, allowClear, className, 'aria-label': name }: PersonPickerProps): import("react").JSX.Element;

package/dist/components/person-picker.js

@@ -0,0 +1,38 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { UserRound } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+import { SelectionFrame, SelectionSearch, SelectionMessage, SelectionCheck } from "../internal/selection-base.js";
+function PersonPicker({ options, value, onChange, multiple = true, onSearch, disabled = false, loading = false, error, placeholder = "请选择人员", allowClear = true, className, "aria-label": name = "人员选择" }) {
+  const [open, setOpen] = useState(false), [query, setQuery] = useState("");
+  const keyword = query.trim().toLocaleLowerCase(), rows = options.filter((n) => `${n.name} ${n.organization ?? ""} ${n.description ?? ""}`.toLocaleLowerCase().includes(keyword));
+  const label = value.map((id) => options.find((n) => n.id === id)?.name ?? id).join("、");
+  const change = (ids) => onChange(ids, options.filter((n) => ids.includes(n.id)));
+  return /* @__PURE__ */ jsxs(SelectionFrame, { label, placeholder, disabled, open, onOpenChange: setOpen, name, className, clear: allowClear && value.length ? () => change([]) : void 0, children: [
+    /* @__PURE__ */ jsx(SelectionSearch, { value: query, onChange: (next) => {
+      setQuery(next);
+      onSearch?.(next);
+    }, label: "搜索姓名或组织" }),
+    /* @__PURE__ */ jsx(SelectionMessage, { loading, error, empty: !rows.length }),
+    !loading && !error && /* @__PURE__ */ jsx("div", { className: "max-h-80 overflow-auto p-2", children: rows.map((n) => /* @__PURE__ */ jsxs("button", { type: "button", disabled: n.disabled, "aria-pressed": value.includes(n.id), onClick: () => {
+      change(multiple ? value.includes(n.id) ? value.filter((id) => id !== n.id) : [...value, n.id] : [n.id]);
+      if (!multiple) setOpen(false);
+    }, className: cn("flex w-full items-center gap-3 rounded-md px-3 py-2.5 text-left disabled:cursor-not-allowed disabled:opacity-40 focus-visible:ring-2 focus-visible:ring-ring", value.includes(n.id) ? "bg-primary/10" : "hover:bg-muted"), children: [
+      /* @__PURE__ */ jsx("span", { className: "grid size-9 shrink-0 place-items-center rounded-full bg-secondary text-primary", children: /* @__PURE__ */ jsx(UserRound, { className: "size-4" }) }),
+      /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1", children: [
+        /* @__PURE__ */ jsx("span", { className: "block truncate text-sm font-medium", children: n.name }),
+        (n.organization || n.description) && /* @__PURE__ */ jsx("span", { className: "block truncate text-xs text-muted-foreground", children: [n.organization, n.description].filter(Boolean).join(" · ") })
+      ] }),
+      /* @__PURE__ */ jsx(SelectionCheck, { selected: value.includes(n.id) })
+    ] }, n.id)) }),
+    /* @__PURE__ */ jsxs("div", { className: "border-t border-border px-4 py-2 text-xs text-muted-foreground", children: [
+      multiple ? "可选择多名人员" : "请选择一名人员",
+      " · 已选 ",
+      value.length,
+      " 人"
+    ] })
+  ] });
+}
+export {
+  PersonPicker
+};

package/dist/components/process-flow-bar.d.ts

@@ -0,0 +1,15 @@
+export interface FlowStep {
+    id?: string;
+    label: string;
+    detail?: string;
+    status: 'completed' | 'current' | 'pending';
+}
+export interface ProcessFlowBarProps {
+    steps: FlowStep[];
+    onStepClick?: (step: FlowStep, index: number) => void;
+    variant?: 'default' | 'compact';
+    disabled?: boolean;
+    className?: string;
+}
+/** A workflow progress view. State transitions, routing and document dialogs belong to the host. */
+export declare function ProcessFlowBar({ steps, onStepClick, variant, disabled, className }: ProcessFlowBarProps): import("react").JSX.Element;

package/dist/components/process-flow-bar.js

@@ -0,0 +1,19 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ChevronRight, Check } from "../icons/index.js";
+import { cn } from "../lib/utils.js";
+function ProcessFlowBar({ steps, onStepClick, variant = "default", disabled = false, className }) {
+  if (!steps.length) return /* @__PURE__ */ jsx("p", { role: "status", className: "p-4 text-sm text-muted-foreground", children: "暂无流程环节" });
+  return /* @__PURE__ */ jsx("ol", { "aria-label": "业务流程", className: cn("flex flex-wrap items-center gap-2 rounded-lg border border-border bg-card p-4", className), children: steps.map((step, index) => /* @__PURE__ */ jsxs("li", { className: "flex min-w-0 items-center gap-2", children: [
+    index > 0 && /* @__PURE__ */ jsx(ChevronRight, { "aria-hidden": true, className: "size-4 text-muted-foreground" }),
+    /* @__PURE__ */ jsxs("button", { type: "button", disabled: disabled || !onStepClick, "aria-current": step.status === "current" ? "step" : void 0, onClick: () => onStepClick?.(step, index), className: cn("flex items-center gap-2 rounded-md px-3 py-2 text-left focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-default", step.status === "current" ? "bg-primary/10 text-primary" : step.status === "completed" ? "text-success" : "text-muted-foreground"), children: [
+      /* @__PURE__ */ jsx("span", { className: cn("grid size-7 shrink-0 place-items-center rounded-full border text-xs", step.status === "current" ? "border-primary bg-primary text-primary-foreground" : "border-current"), children: step.status === "completed" ? /* @__PURE__ */ jsx(Check, { className: "size-4" }) : index + 1 }),
+      /* @__PURE__ */ jsxs("span", { children: [
+        /* @__PURE__ */ jsx("span", { className: "block text-sm font-medium", children: step.label }),
+        variant === "default" && step.detail && /* @__PURE__ */ jsx("span", { className: "block text-xs text-muted-foreground", children: step.detail })
+      ] })
+    ] })
+  ] }, step.id ?? index)) });
+}
+export {
+  ProcessFlowBar
+};