@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/components/data/table.d.ts

@@ -1,30 +1,168 @@
+import { TemplateResult } from 'lit';
 import { AitheElement } from '../../core/aithe-element';
-import type { AitheTableColumn } from '../../core/types';
+import type { AitheSelectableType, AitheTableColumnMeta } from '../../core/types';
+import './table-column';
 type TableRecord = Record<string, unknown>;
+/**
+ * Data table with sorting, row selection, column fixed, column resizing,
+ * column drag-to-reorder, loading state, single-select mode, and keyboard navigation.
+ *
+ * @slot empty - Content shown when the table has no data.
+ * @slot loading - Custom loading indicator content.
+ * @slot - Default slot for `<aithe-table-column>` children.
+ *
+ * @fires aithe-sort-change    - Emitted with `{ sortKey, sortOrder }`.
+ * @fires aithe-selection-change - Emitted with `{ selectionSet }`.
+ * @fires aithe-row-click      - Emitted with `{ record, rowIndex }`.
+ * @fires aithe-column-resize  - Emitted with `{ columnId, width }`.
+ * @fires aithe-column-reorder - Emitted with `{ columns }` (new column id order).
+ */
 export declare class AitheTable extends AitheElement {
     columnsJson: string;
-    columns: AitheTableColumn<TableRecord>[];
+    columns: AitheTableColumnMeta<TableRecord>[];
     dataJson: string;
     data: TableRecord[];
     rowKey: string;
     striped: boolean;
     bordered: boolean;
     hoverable: boolean;
-    selectable: boolean;
+    selectable: AitheSelectableType;
+    selectionSet: Set<string>;
     sortKey: string;
     sortOrder: 'asc' | 'desc' | '';
-    private selectedKeys;
+    loading: boolean;
+    loadingText: string;
+    private slotColumns;
+    private columnOrder;
+    private focusedRowIndex;
+    private slotObserver?;
+    private resizeData;
+    private dragData;
+    private readonly tableEl?;
+    /**
+     * Resolved column definitions with drag-to-reorder applied.
+     * 应用了拖拽排序后的列定义。
+     */
+    protected get resolvedColumns(): AitheTableColumnMeta<TableRecord>[];
+    /** Ordered column IDs from resolved columns. 已解析列的 ID 顺序。 */
+    private get orderedColumnIds();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    /**
+     * Keyboard navigation handler for ArrowDown/ArrowUp/Space/Enter.
+     * 键盘导航处理：ArrowDown/ArrowUp/空格/Enter。
+     */
+    private readonly _onKeyDown;
+    /**
+     * Scroll the row at the given index into the visible area.
+     * 将指定索引的行滚动到可视区域。
+     */
+    private _scrollRowIntoView;
+    /**
+     * Sync column definitions from `<aithe-table-column>` child elements.
+     * 从 `<aithe-table-column>` 子元素同步列定义。
+     */
+    protected syncSlotColumns(): void;
+    /**
+     * Parse JSON string properties into their object counterparts.
+     * 将 JSON 字符串属性解析为对象。
+     */
     protected willUpdate(changed: Map<string, unknown>): void;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private get rowData();
+    /**
+     * Sorted row data. Returns original data when no sort key is set.
+     * 排序后的行数据。未设置排序键时返回原始数据。
+     */
+    protected get rowData(): TableRecord[];
+    /** Whether all rows are selected. 是否所有行都被选中。 */
     private get allChecked();
+    /** Whether some (but not all) rows are selected. 是否部分行被选中。 */
     private get partiallyChecked();
+    /**
+     * Get the unique key for a record.
+     * 获取记录的唯一键。
+     */
     private getRecordKey;
+    /**
+     * Toggle sort state for a column (asc → desc → none → asc).
+     * 切换列的排序状态（升序 → 降序 → 无 → 升序）。
+     */
     private toggleSort;
+    /**
+     * Toggle selection state for a single row.
+     * 切换单行的选中状态。
+     */
     private toggleRowSelection;
+    /**
+     * Toggle all rows selection state (multi-select mode only).
+     * 切换所有行的选中状态（仅多选模式）。
+     */
     private toggleAllRows;
-    private renderCell;
-    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * Start column resize on mousedown of the resize handle.
+     * 在调整大小手柄上按下鼠标时开始列宽调整。
+     */
+    private _onResizeStart;
+    /** Attach document-level resize event listeners. 添加文档级调整大小事件监听。 */
+    private _addResizeListeners;
+    /** Remove document-level resize event listeners. 移除文档级调整大小事件监听。 */
+    private _removeResizeListeners;
+    /**
+     * Handle mousemove during column resize, updating column width.
+     * 列宽调整时处理鼠标移动，更新列宽。
+     */
+    private readonly _onResizeMove;
+    /**
+     * End column resize on mouseup, emit event with final width.
+     * 鼠标松开时结束列宽调整，发射最终宽度事件。
+     */
+    private readonly _onResizeEnd;
+    private readonly dragThreshold;
+    /**
+     * Handle mousedown on a column header th. If the user moves the mouse beyond
+     * the drag threshold, starts column drag-to-reorder.
+     * 处理列头 th 上的鼠标按下。如果鼠标移动超过拖拽阈值，开始列拖拽排序。
+     */
+    private _onThMouseDown;
+    /**
+     * Start column drag-to-reorder. Creates a drag ghost element and attaches
+     * document-level mousemove/mouseup listeners.
+     * 开始列拖拽排序。创建拖拽幽灵元素并添加文档级鼠标事件监听。
+     */
+    private _startDrag;
+    private readonly _onDragMove;
+    /**
+     * End column drag-to-reorder. Removes ghost element and event listeners,
+     * updates column order, and emits event.
+     * 结束列拖拽排序。移除幽灵元素和事件监听，更新列顺序并发射事件。
+     */
+    private readonly _onDragEnd;
+    private _clearDragClasses;
+    private _findDropTarget;
+    private _applyColumnReorder;
+    protected renderCell(column: AitheTableColumnMeta<TableRecord>, record: TableRecord): unknown;
+    private getSortIcon;
+    private renderColumnHeader;
+    /**
+     * Compute `left` or `right` offset for a fixed column.
+     * 计算固定列的 left 或 right 偏移值。
+     */
+    private _getFixedStyle;
+    private _calcLeftOffset;
+    private _calcRightOffset;
+    /**
+     * Get the current width of a column from the DOM.
+     * 从 DOM 获取列当前实际宽度。
+     */
+    private _getColumnWidth;
+    private _hasFixedLeft;
+    private _hasFixedRight;
+    private _renderLoadingRows;
+    private _renderSelectAllCheckbox;
+    private _renderSelectionCell;
+    private _renderTableBody;
+    render(): TemplateResult<1>;
 }
 export {};
 //# sourceMappingURL=table.d.ts.map

package/dist/components/data/table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/components/data/table.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,qBACa,UAAW,SAAQ,YAAY;IACQ,WAAW,SAAM;IACnC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAM;IAC/B,QAAQ,SAAM;IAC7B,IAAI,EAAE,WAAW,EAAE,CAAM;IACP,MAAM,SAAQ;IACnC,OAAO,UAAS;IAChB,QAAQ,UAAQ;IACQ,SAAS,UAAQ;IACzC,UAAU,UAAS;IACG,OAAO,SAAM;IACX,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAM;IAEhF,OAAO,CAAC,YAAY,CAAgB;IAE7C,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkBzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAkFpB;IAEF,OAAO,KAAK,OAAO,GAsBlB;IAED,OAAO,KAAK,UAAU,GAErB;IAED,OAAO,KAAK,gBAAgB,GAE3B;IAED,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;IAKlB,MAAM;CAsGP"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/components/data/table.ts"],"names":[],"mappings":"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"}