@icen.ai/ui 0.5.0 → 0.8.1

package/dist/behaviors/copy.mjs

@@ -1,5 +1,12 @@
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/copy.ts
-var initialized = /* @__PURE__ */ new WeakSet();
+var handlers = /* @__PURE__ */ new WeakMap();
 var flashing = /* @__PURE__ */ new WeakMap();
 function legacyCopy(text) {
   const ta = document.createElement("textarea");
@@ -19,14 +26,20 @@ function legacyCopy(text) {
   return ok;
 }
 async function copyText(text) {
-  try {
-    if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+  const hasApi = typeof navigator !== "undefined" && !!navigator.clipboard?.writeText;
+  if (hasApi) {
+    try {
       await navigator.clipboard.writeText(text);
-      return true;
+      return { ok: true };
+    } catch (err) {
+      const fallbackOk = legacyCopy(text);
+      if (fallbackOk) return { ok: true };
+      const reason = err instanceof Error ? err.message : String(err);
+      return { ok: false, reason: `clipboard API \u88AB\u62D2\uFF08${reason}\uFF09\u4E14\u56DE\u9000 execCommand \u5931\u8D25` };
     }
-  } catch {
   }
-  return legacyCopy(text);
+  if (legacyCopy(text)) return { ok: true };
+  return { ok: false, reason: "\u526A\u8D34\u677F\u4E0D\u53EF\u7528\uFF08\u65E0 clipboard API \u4E14 execCommand \u56DE\u9000\u5931\u8D25\uFF09" };
 }
 function flashDone(btn) {
   const prev = flashing.get(btn);
@@ -34,10 +47,10 @@ function flashDone(btn) {
   const iconOnly = btn.hasAttribute("data-copy-icon");
   const original = prev ? prev.original : iconOnly ? null : btn.textContent;
   if (!iconOnly) btn.textContent = "\u5DF2\u590D\u5236";
-  btn.classList.add("done");
+  btn.classList.add("is-done");
   const timer = window.setTimeout(() => {
     if (!iconOnly) btn.textContent = original;
-    btn.classList.remove("done");
+    btn.classList.remove("is-done");
     flashing.delete(btn);
   }, 1400);
   flashing.set(btn, { original, timer });
@@ -48,15 +61,28 @@ function onClick(root, ev) {
   const btn = target.closest(".copy-btn[data-copy]");
   if (!btn || !root.contains(btn)) return;
   const text = btn.getAttribute("data-copy") ?? "";
-  void copyText(text).then((ok) => {
-    if (ok) flashDone(btn);
+  void copyText(text).then((outcome) => {
+    if (outcome.ok) {
+      flashDone(btn);
+      emitIcen(btn, "icen:copy-success", { text });
+    } else {
+      emitIcen(btn, "icen:copy-error", { text, reason: outcome.reason ?? "\u672A\u77E5\u9519\u8BEF" });
+    }
   });
 }
-function initCopy(root = document) {
-  if (typeof document === "undefined") return;
-  if (initialized.has(root)) return;
-  initialized.add(root);
-  root.addEventListener("click", (ev) => onClick(root, ev));
+function initCopy(root) {
+  if (typeof document === "undefined") return () => {
+  };
+  const scope = root ?? document;
+  if (handlers.has(scope)) return () => {
+  };
+  const handler = (ev) => onClick(scope, ev);
+  handlers.set(scope, handler);
+  scope.addEventListener("click", handler);
+  return () => {
+    scope.removeEventListener("click", handler);
+    handlers.delete(scope);
+  };
 }
 export {
   initCopy

package/dist/behaviors/datatable.d.mts

@@ -0,0 +1,90 @@
+import { ContextMenuItem } from './context-menu.js';
+import './popover.js';
+
+interface TableColumn<Row = Record<string, unknown>> {
+    key: string;
+    title: string;
+    /** CSS 宽度：'72px' / '120px' / '2fr'；缺省 minmax(0,1fr) */
+    width?: string;
+    align?: 'left' | 'center' | 'right';
+    sortable?: boolean;
+    /** 自定义比较（默认：数字感知的 localeCompare） */
+    sortFn?: (a: Row, b: Row) => number;
+    filterable?: boolean;
+    /** 返回 Node 可嵌套任意组件；返回 string/number 走 textContent（安全） */
+    render?: (value: unknown, row: Row, rowIndex: number) => Node | string | number | null;
+    hidden?: boolean;
+    /** 冻结列（左固定，横向滚动时不跟随） */
+    frozen?: boolean;
+}
+interface TableOptions<Row = Record<string, unknown>> {
+    columns: TableColumn<Row>[];
+    data: Row[];
+    /** 行唯一键：字段名或函数（多选/展开跨页保持的依据），缺省用行索引 */
+    rowKey?: keyof Row | ((row: Row) => string);
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    selectable?: boolean;
+    /** 分页（默认开启，pageSize 默认 10 条/页；传 false 关闭；virtual 时忽略） */
+    pagination?: boolean;
+    pageSize?: number;
+    pageSizes?: number[];
+    /** 虚拟滚动（大数据量；与 pagination 互斥，virtual 优先） */
+    virtual?: boolean;
+    /** 虚拟行高 px（默认 44）与窗口高度（默认 '420px'） */
+    rowHeight?: number;
+    height?: string;
+    /** 行展开内容（虚拟模式下忽略） */
+    expandable?: (row: Row) => Node | string;
+    /** 行右键菜单（复用 context-menu；需 menu.css，kit 入口已带） */
+    contextMenu?: (row: Row) => ContextMenuItem[];
+    striped?: boolean;
+    emptyLabel?: string;
+    loading?: boolean;
+    /** 密度：normal 默认 44px 行高 / compact 紧凑 32px */
+    density?: 'normal' | 'compact';
+    /** 列宽可拖拽调整（默认 true） */
+    resizable?: boolean;
+    /** 工具栏列显隐开关（默认 false） */
+    columnVisibility?: boolean;
+    /** 导出 CSV 按钮显示在工具栏（默认 false） */
+    exportable?: boolean;
+    /** 行自定义 class（条件着色 / 状态行） */
+    rowClassName?: (row: Row, index: number) => string;
+    onSelectionChange?: (rows: Row[]) => void;
+    onRowClick?: (row: Row) => void;
+    onSortChange?: (key: string | null, dir: 'asc' | 'desc') => void;
+    /** 搜索谓词（默认跨列 String includes；自定义拼音/高亮/索引匹配） */
+    searchFn?: (query: string, row: Row) => boolean;
+    /** 服务端/受控分页：开启后翻页只派事件与回调，不再本地切片（配 totalCount + setData/setPage 喂数） */
+    remote?: boolean;
+    /** remote 模式总条数（缺省 data.length） */
+    totalCount?: number;
+    onPageChange?: (page: number, pageSize: number) => void;
+    onPageSizeChange?: (pageSize: number) => void;
+}
+interface TableHandle<Row = Record<string, unknown>> {
+    setData(data: Row[]): void;
+    getSelected(): Row[];
+    clearSelection(): void;
+    setSearch(query: string): void;
+    /** values=null 清除该列筛选 */
+    setFilter(key: string, values: string[] | null): void;
+    setSort(key: string | null, dir?: 'asc' | 'desc'): void;
+    /** 获取当前管线（搜索→筛选→排序）后的数据 */
+    getData(): Row[];
+    /** 导出当前管线数据为 CSV 并触发下载 */
+    exportCSV(filename?: string): void;
+    /** 显示/隐藏列 */
+    showColumn(key: string): void;
+    /** 外部驱动页码（remote 模式与服务端同步） */
+    setPage(page: number): void;
+    setPageSize(size: number): void;
+    hideColumn(key: string): void;
+    /** 数据被外部原地修改后重渲 */
+    refresh(): void;
+    destroy(): void;
+}
+declare function createTable<Row = Record<string, unknown>>(el: HTMLElement, opts: TableOptions<Row>): TableHandle<Row>;
+
+export { type TableColumn, type TableHandle, type TableOptions, createTable };