@composy/kanban-core 0.0.1

package/es/core/KanbanBoard.d.ts

@@ -0,0 +1,152 @@
+import type { KanbanOptions, Column, Card, FilterCriteria, BoardData, Label } from '../types';
+import { EventEmitter, type EventHandler } from './EventEmitter';
+/**
+ * KanbanBoard - 看板视图库，支持拖拽卡片与列管理
+ */
+export declare class KanbanBoard {
+    private container;
+    private options;
+    private destroyed;
+    readonly events: EventEmitter;
+    private columnManager;
+    private dragController;
+    private filterEngine;
+    private renderer;
+    private labels;
+    constructor(options: KanbanOptions);
+    private init;
+    /**
+     * 绑定内部事件
+     */
+    private bindInternalEvents;
+    /**
+     * 添加列
+     */
+    addColumn(partial: Partial<Column>): Column;
+    /**
+     * 移除列
+     */
+    removeColumn(id: string): Column | undefined;
+    /**
+     * 更新列
+     */
+    updateColumn(id: string, changes: Partial<Column>): Column | undefined;
+    /**
+     * 移动列
+     */
+    moveColumn(id: string, toIndex: number): void;
+    /**
+     * 折叠/展开列
+     */
+    toggleColumnCollapse(id: string): void;
+    /**
+     * 获取所有列
+     */
+    getColumns(): Column[];
+    /**
+     * 获取单列
+     */
+    getColumn(id: string): Column | undefined;
+    /**
+     * 添加卡片
+     */
+    addCard(columnId: string, partial: Partial<Card>): Card | undefined;
+    /**
+     * 移除卡片
+     */
+    removeCard(cardId: string): Card | undefined;
+    /**
+     * 更新卡片
+     */
+    updateCard(cardId: string, changes: Partial<Card>): Card | undefined;
+    /**
+     * 移动卡片
+     */
+    moveCard(cardId: string, toColumnId: string, toIndex: number): void;
+    /**
+     * 获取单张卡片
+     */
+    getCard(cardId: string): Card | undefined;
+    /**
+     * 获取所有卡片
+     */
+    getAllCards(): Card[];
+    /**
+     * 获取卡片总数
+     */
+    getCardCount(): number;
+    /**
+     * 筛选卡片
+     */
+    filter(criteria: FilterCriteria): void;
+    /**
+     * 搜索卡片
+     */
+    search(keyword: string): Card[];
+    /**
+     * 清除筛选
+     */
+    clearFilter(): void;
+    /**
+     * 导出看板数据
+     */
+    exportData(): BoardData;
+    /**
+     * 导入看板数据
+     */
+    importData(data: BoardData): void;
+    /**
+     * 监听事件
+     */
+    on(event: string, handler: EventHandler): () => void;
+    /**
+     * 监听一次性事件
+     */
+    once(event: string, handler: EventHandler): () => void;
+    /**
+     * 移除事件监听
+     */
+    off(event: string, handler: EventHandler): void;
+    /**
+     * 获取所有标签
+     */
+    getLabels(): Label[];
+    /**
+     * 添加标签
+     */
+    addLabel(label: Label): void;
+    /**
+     * 移除标签
+     */
+    removeLabel(id: string): void;
+    private renderTimer;
+    /**
+     * 延迟渲染（合并多次调用，等待浏览器拖拽操作完成）
+     */
+    private scheduleRender;
+    /**
+     * 重新渲染
+     */
+    render(): void;
+    /**
+     * 获取看板根元素
+     */
+    getBoardElement(): HTMLElement | null;
+    /**
+     * 获取配置
+     */
+    getOptions(): Readonly<KanbanOptions>;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+    /**
+     * 是否已销毁
+     */
+    isDestroyed(): boolean;
+}
+/**
+ * 创建看板实例（工厂函数）
+ */
+export declare function createKanbanBoard(options: KanbanOptions): KanbanBoard;
+//# sourceMappingURL=KanbanBoard.d.ts.map

package/es/core/KanbanBoard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KanbanBoard.d.ts","sourceRoot":"","sources":["../../src/core/KanbanBoard.ts"],"names":[],"mappings":"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"}

package/es/core/KanbanBoard.js

@@ -0,0 +1,332 @@
+/*!
+* ***********************************
+* @composy/kanban-core v0.0.1     *
+* Built with rollup               *
+* Build time: 2024-08-17 11:33:25 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { ColumnManager } from "./ColumnManager.js";
+import { DragController } from "./DragController.js";
+import { EventEmitter } from "./EventEmitter.js";
+import { FilterEngine } from "./FilterEngine.js";
+import { resolveElement } from "../utils/dom.js";
+import { Renderer } from "./Renderer.js";
+import { VERSION } from "../version.js";
+//#region src/core/KanbanBoard.ts
+var KanbanBoard = class {
+	constructor(options) {
+		this.destroyed = false;
+		this.labels = [];
+		this.renderTimer = null;
+		this.options = {
+			draggable: true,
+			columnDraggable: true,
+			crossColumnDrag: true,
+			searchable: true,
+			showAddCard: true,
+			showAddColumn: true,
+			showColumnActions: true,
+			showCardCount: true,
+			classPrefix: "kanban",
+			...options
+		};
+		const el = resolveElement(options.container);
+		if (!el) throw new Error("[KanbanBoard] Container element not found");
+		this.container = el;
+		this.events = new EventEmitter();
+		this.columnManager = new ColumnManager(this.events);
+		this.dragController = new DragController(this.events, this.options.classPrefix || "kanban");
+		this.filterEngine = new FilterEngine(this.events);
+		this.renderer = new Renderer(this.container, this.events, this.dragController, this.options);
+		this.labels = options.labels || [];
+		this.init();
+	}
+	init() {
+		if (this.options.columns?.length) this.columnManager.init(this.options.columns);
+		this.bindInternalEvents();
+		this.render();
+		this.events.emit("ready", { instance: this });
+		this.options.onReady?.(this);
+		if (this.options.debug) console.log("[KanbanBoard] Initialized", {
+			columns: this.columnManager.getColumns().length,
+			cards: this.columnManager.getCardCount()
+		});
+	}
+	/**
+	* 绑定内部事件
+	*/
+	bindInternalEvents() {
+		this.events.on("card:drop", (payload) => {
+			this.columnManager.moveCard(payload.cardId, payload.toColumnId, payload.toIndex);
+			this.options.onCardMove?.(this.columnManager.getCard(payload.cardId), payload.fromColumnId, payload.toColumnId, payload.toIndex);
+			this.scheduleRender();
+		});
+		this.events.on("column:drop", (payload) => {
+			const fromIndex = this.columnManager.getColumns().findIndex((c) => c.id === payload.fromColumnId);
+			this.columnManager.moveColumn(payload.fromColumnId, payload.toIndex);
+			const col = this.columnManager.getColumn(payload.fromColumnId);
+			if (col) this.options.onColumnMove?.(col, fromIndex, payload.toIndex);
+			this.scheduleRender();
+		});
+		this.events.on("ui:toggle-collapse", (payload) => {
+			this.columnManager.toggleCollapse(payload.columnId);
+			const col = this.columnManager.getColumn(payload.columnId);
+			if (col) this.options.onColumnCollapse?.(col, col.collapsed ?? false);
+			this.render();
+		});
+		this.events.on("card:add", (p) => this.options.onCardAdd?.(p.card, p.columnId));
+		this.events.on("card:remove", (p) => this.options.onCardRemove?.(p.card, p.columnId));
+		this.events.on("card:click", (p) => this.options.onCardClick?.(p.card));
+		this.events.on("card:update", (p) => this.options.onCardUpdate?.(p.card));
+		this.events.on("column:add", (p) => this.options.onColumnAdd?.(p.column));
+		this.events.on("column:remove", (p) => this.options.onColumnRemove?.(p.column));
+		this.events.on("error", (p) => this.options.onError?.(p.error));
+	}
+	/**
+	* 添加列
+	*/
+	addColumn(partial) {
+		const column = this.columnManager.addColumn(partial);
+		this.render();
+		return column;
+	}
+	/**
+	* 移除列
+	*/
+	removeColumn(id) {
+		const column = this.columnManager.removeColumn(id);
+		if (column) this.render();
+		return column;
+	}
+	/**
+	* 更新列
+	*/
+	updateColumn(id, changes) {
+		const column = this.columnManager.updateColumn(id, changes);
+		if (column) this.render();
+		return column;
+	}
+	/**
+	* 移动列
+	*/
+	moveColumn(id, toIndex) {
+		this.columnManager.moveColumn(id, toIndex);
+		this.render();
+	}
+	/**
+	* 折叠/展开列
+	*/
+	toggleColumnCollapse(id) {
+		this.columnManager.toggleCollapse(id);
+		this.render();
+	}
+	/**
+	* 获取所有列
+	*/
+	getColumns() {
+		return this.columnManager.getColumns();
+	}
+	/**
+	* 获取单列
+	*/
+	getColumn(id) {
+		return this.columnManager.getColumn(id);
+	}
+	/**
+	* 添加卡片
+	*/
+	addCard(columnId, partial) {
+		const card = this.columnManager.addCard(columnId, partial);
+		if (card) this.render();
+		return card;
+	}
+	/**
+	* 移除卡片
+	*/
+	removeCard(cardId) {
+		const card = this.columnManager.removeCard(cardId);
+		if (card) this.render();
+		return card;
+	}
+	/**
+	* 更新卡片
+	*/
+	updateCard(cardId, changes) {
+		const card = this.columnManager.updateCard(cardId, changes);
+		if (card) this.render();
+		return card;
+	}
+	/**
+	* 移动卡片
+	*/
+	moveCard(cardId, toColumnId, toIndex) {
+		this.columnManager.moveCard(cardId, toColumnId, toIndex);
+		this.render();
+	}
+	/**
+	* 获取单张卡片
+	*/
+	getCard(cardId) {
+		return this.columnManager.getCard(cardId);
+	}
+	/**
+	* 获取所有卡片
+	*/
+	getAllCards() {
+		return this.columnManager.getAllCards();
+	}
+	/**
+	* 获取卡片总数
+	*/
+	getCardCount() {
+		return this.columnManager.getCardCount();
+	}
+	/**
+	* 筛选卡片
+	*/
+	filter(criteria) {
+		this.filterEngine.filter(criteria, this.columnManager.getColumns());
+		this.render();
+	}
+	/**
+	* 搜索卡片
+	*/
+	search(keyword) {
+		const result = this.filterEngine.search(keyword, this.columnManager.getColumns());
+		this.render();
+		return result;
+	}
+	/**
+	* 清除筛选
+	*/
+	clearFilter() {
+		this.filterEngine.clearFilter();
+		this.render();
+	}
+	/**
+	* 导出看板数据
+	*/
+	exportData() {
+		const data = {
+			version: VERSION,
+			title: this.options.title || "Kanban Board",
+			columns: this.columnManager.getColumns(),
+			labels: this.labels,
+			exportedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.events.emit("data:export", { board: data });
+		return data;
+	}
+	/**
+	* 导入看板数据
+	*/
+	importData(data) {
+		this.columnManager.setColumns(data.columns);
+		this.labels = data.labels || [];
+		this.filterEngine.clearFilter();
+		this.events.emit("data:import", { board: data });
+		this.render();
+	}
+	/**
+	* 监听事件
+	*/
+	on(event, handler) {
+		return this.events.on(event, handler);
+	}
+	/**
+	* 监听一次性事件
+	*/
+	once(event, handler) {
+		return this.events.once(event, handler);
+	}
+	/**
+	* 移除事件监听
+	*/
+	off(event, handler) {
+		this.events.off(event, handler);
+	}
+	/**
+	* 获取所有标签
+	*/
+	getLabels() {
+		return [...this.labels];
+	}
+	/**
+	* 添加标签
+	*/
+	addLabel(label) {
+		this.labels.push(label);
+	}
+	/**
+	* 移除标签
+	*/
+	removeLabel(id) {
+		this.labels = this.labels.filter((l) => l.id !== id);
+	}
+	/**
+	* 延迟渲染（合并多次调用，等待浏览器拖拽操作完成）
+	*/
+	scheduleRender() {
+		if (this.renderTimer !== null) return;
+		this.renderTimer = setTimeout(() => {
+			this.renderTimer = null;
+			this.render();
+		}, 0);
+	}
+	/**
+	* 重新渲染
+	*/
+	render() {
+		if (this.destroyed) return;
+		this.dragController.destroy();
+		this.dragController = new DragController(this.events, this.options.classPrefix || "kanban");
+		this.renderer = new Renderer(this.container, this.events, this.dragController, this.options);
+		this.renderer.render(this.columnManager.getColumns(), this.filterEngine.getHiddenCardIds());
+	}
+	/**
+	* 获取看板根元素
+	*/
+	getBoardElement() {
+		return this.renderer.getBoardElement();
+	}
+	/**
+	* 获取配置
+	*/
+	getOptions() {
+		return { ...this.options };
+	}
+	/**
+	* 销毁实例
+	*/
+	destroy() {
+		if (this.destroyed) return;
+		this.destroyed = true;
+		if (this.renderTimer !== null) {
+			clearTimeout(this.renderTimer);
+			this.renderTimer = null;
+		}
+		this.dragController.destroy();
+		this.filterEngine.destroy();
+		this.renderer.destroy();
+		this.columnManager.clear();
+		this.events.emit("destroy", void 0);
+		this.options.onDestroy?.();
+		this.events.removeAll();
+		if (this.options.debug) console.log("[KanbanBoard] Destroyed");
+	}
+	/**
+	* 是否已销毁
+	*/
+	isDestroyed() {
+		return this.destroyed;
+	}
+};
+function createKanbanBoard(options) {
+	return new KanbanBoard(options);
+}
+//#endregion
+export { KanbanBoard, createKanbanBoard };
+/*! End of @composy/kanban-core | Powered by @composy/builder */
+//# sourceMappingURL=KanbanBoard.js.map

package/es/core/KanbanBoard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KanbanBoard.js","names":[],"sources":["../../src/core/KanbanBoard.ts"],"sourcesContent":["import type { KanbanOptions, Column, Card, FilterCriteria, BoardData, Label } from '../types';\nimport { resolveElement } from '../utils/dom';\nimport { EventEmitter, type EventHandler } from './EventEmitter';\nimport { ColumnManager } from './ColumnManager';\nimport { DragController } from './DragController';\nimport { FilterEngine } from './FilterEngine';\nimport { Renderer } from './Renderer';\nimport { VERSION } from '../version';\n\n/**\n * KanbanBoard - 看板视图库，支持拖拽卡片与列管理\n */\nexport class KanbanBoard {\n  private container: HTMLElement;\n  private options: KanbanOptions;\n  private destroyed = false;\n\n  readonly events: EventEmitter;\n  private columnManager: ColumnManager;\n  private dragController: DragController;\n  private filterEngine: FilterEngine;\n  private renderer: Renderer;\n  private labels: Label[] = [];\n\n  constructor(options: KanbanOptions) {\n    this.options = {\n      draggable: true,\n      columnDraggable: true,\n      crossColumnDrag: true,\n      searchable: true,\n      showAddCard: true,\n      showAddColumn: true,\n      showColumnActions: true,\n      showCardCount: true,\n      classPrefix: 'kanban',\n      ...options,\n    };\n\n    const el = resolveElement(options.container);\n    if (!el) {\n      throw new Error('[KanbanBoard] Container element not found');\n    }\n    this.container = el;\n\n    // 初始化子系统\n    this.events = new EventEmitter();\n    this.columnManager = new ColumnManager(this.events);\n    this.dragController = new DragController(this.events, this.options.classPrefix || 'kanban');\n    this.filterEngine = new FilterEngine(this.events);\n    this.renderer = new Renderer(this.container, this.events, this.dragController, this.options);\n\n    // 初始化标签\n    this.labels = options.labels || [];\n\n    this.init();\n  }\n\n  private init(): void {\n    // 初始化列数据\n    if (this.options.columns?.length) {\n      this.columnManager.init(this.options.columns as Partial<Column>[]);\n    }\n\n    // 绑定内部事件\n    this.bindInternalEvents();\n\n    // 首次渲染\n    this.render();\n\n    // 触发 ready\n    this.events.emit('ready', { instance: this });\n    this.options.onReady?.(this);\n\n    if (this.options.debug) {\n      console.log('[KanbanBoard] Initialized', {\n        columns: this.columnManager.getColumns().length,\n        cards: this.columnManager.getCardCount(),\n      });\n    }\n  }\n\n  /**\n   * 绑定内部事件\n   */\n  private bindInternalEvents(): void {\n    // 卡片拖拽放置\n    this.events.on('card:drop', (payload: unknown) => {\n      this.columnManager.moveCard(payload.cardId, payload.toColumnId, payload.toIndex);\n      this.options.onCardMove?.(this.columnManager.getCard(payload.cardId)!, payload.fromColumnId, payload.toColumnId, payload.toIndex);\n      // 延迟渲染，等待浏览器完成拖拽操作（dragend 事件触发后再重建 DOM）\n      this.scheduleRender();\n    });\n\n    // 列拖拽放置\n    this.events.on('column:drop', (payload: unknown) => {\n      const columns = this.columnManager.getColumns();\n      const fromIndex = columns.findIndex(c => c.id === payload.fromColumnId);\n      this.columnManager.moveColumn(payload.fromColumnId, payload.toIndex);\n      const col = this.columnManager.getColumn(payload.fromColumnId);\n      if (col) this.options.onColumnMove?.(col, fromIndex, payload.toIndex);\n      this.scheduleRender();\n    });\n\n    // UI 事件 - 折叠列\n    this.events.on('ui:toggle-collapse', (payload: unknown) => {\n      this.columnManager.toggleCollapse(payload.columnId);\n      const col = this.columnManager.getColumn(payload.columnId);\n      if (col) this.options.onColumnCollapse?.(col, col.collapsed ?? false);\n      this.render();\n    });\n\n    // 回调转发\n    this.events.on('card:add', (p: unknown) => this.options.onCardAdd?.(p.card, p.columnId));\n    this.events.on('card:remove', (p: unknown) => this.options.onCardRemove?.(p.card, p.columnId));\n    this.events.on('card:click', (p: unknown) => this.options.onCardClick?.(p.card));\n    this.events.on('card:update', (p: unknown) => this.options.onCardUpdate?.(p.card));\n    this.events.on('column:add', (p: unknown) => this.options.onColumnAdd?.(p.column));\n    this.events.on('column:remove', (p: unknown) => this.options.onColumnRemove?.(p.column));\n    this.events.on('error', (p: unknown) => this.options.onError?.(p.error));\n  }\n\n  // ============================================================\n  // Column API\n  // ============================================================\n\n  /**\n   * 添加列\n   */\n  addColumn(partial: Partial<Column>): Column {\n    const column = this.columnManager.addColumn(partial);\n    this.render();\n    return column;\n  }\n\n  /**\n   * 移除列\n   */\n  removeColumn(id: string): Column | undefined {\n    const column = this.columnManager.removeColumn(id);\n    if (column) this.render();\n    return column;\n  }\n\n  /**\n   * 更新列\n   */\n  updateColumn(id: string, changes: Partial<Column>): Column | undefined {\n    const column = this.columnManager.updateColumn(id, changes);\n    if (column) this.render();\n    return column;\n  }\n\n  /**\n   * 移动列\n   */\n  moveColumn(id: string, toIndex: number): void {\n    this.columnManager.moveColumn(id, toIndex);\n    this.render();\n  }\n\n  /**\n   * 折叠/展开列\n   */\n  toggleColumnCollapse(id: string): void {\n    this.columnManager.toggleCollapse(id);\n    this.render();\n  }\n\n  /**\n   * 获取所有列\n   */\n  getColumns(): Column[] {\n    return this.columnManager.getColumns();\n  }\n\n  /**\n   * 获取单列\n   */\n  getColumn(id: string): Column | undefined {\n    return this.columnManager.getColumn(id);\n  }\n\n  // ============================================================\n  // Card API\n  // ============================================================\n\n  /**\n   * 添加卡片\n   */\n  addCard(columnId: string, partial: Partial<Card>): Card | undefined {\n    const card = this.columnManager.addCard(columnId, partial);\n    if (card) this.render();\n    return card;\n  }\n\n  /**\n   * 移除卡片\n   */\n  removeCard(cardId: string): Card | undefined {\n    const card = this.columnManager.removeCard(cardId);\n    if (card) this.render();\n    return card;\n  }\n\n  /**\n   * 更新卡片\n   */\n  updateCard(cardId: string, changes: Partial<Card>): Card | undefined {\n    const card = this.columnManager.updateCard(cardId, changes);\n    if (card) this.render();\n    return card;\n  }\n\n  /**\n   * 移动卡片\n   */\n  moveCard(cardId: string, toColumnId: string, toIndex: number): void {\n    this.columnManager.moveCard(cardId, toColumnId, toIndex);\n    this.render();\n  }\n\n  /**\n   * 获取单张卡片\n   */\n  getCard(cardId: string): Card | undefined {\n    return this.columnManager.getCard(cardId);\n  }\n\n  /**\n   * 获取所有卡片\n   */\n  getAllCards(): Card[] {\n    return this.columnManager.getAllCards();\n  }\n\n  /**\n   * 获取卡片总数\n   */\n  getCardCount(): number {\n    return this.columnManager.getCardCount();\n  }\n\n  // ============================================================\n  // Filter / Search API\n  // ============================================================\n\n  /**\n   * 筛选卡片\n   */\n  filter(criteria: FilterCriteria): void {\n    this.filterEngine.filter(criteria, this.columnManager.getColumns());\n    this.render();\n  }\n\n  /**\n   * 搜索卡片\n   */\n  search(keyword: string): Card[] {\n    const result = this.filterEngine.search(keyword, this.columnManager.getColumns());\n    this.render();\n    return result;\n  }\n\n  /**\n   * 清除筛选\n   */\n  clearFilter(): void {\n    this.filterEngine.clearFilter();\n    this.render();\n  }\n\n  // ============================================================\n  // Import / Export API\n  // ============================================================\n\n  /**\n   * 导出看板数据\n   */\n  exportData(): BoardData {\n    const data: BoardData = {\n      version: VERSION,\n      title: this.options.title || 'Kanban Board',\n      columns: this.columnManager.getColumns(),\n      labels: this.labels,\n      exportedAt: new Date().toISOString(),\n    };\n    this.events.emit('data:export', { board: data });\n    return data;\n  }\n\n  /**\n   * 导入看板数据\n   */\n  importData(data: BoardData): void {\n    this.columnManager.setColumns(data.columns);\n    this.labels = data.labels || [];\n    this.filterEngine.clearFilter();\n    this.events.emit('data:import', { board: data });\n    this.render();\n  }\n\n  // ============================================================\n  // Event API\n  // ============================================================\n\n  /**\n   * 监听事件\n   */\n  on(event: string, handler: EventHandler): () => void {\n    return this.events.on(event, handler);\n  }\n\n  /**\n   * 监听一次性事件\n   */\n  once(event: string, handler: EventHandler): () => void {\n    return this.events.once(event, handler);\n  }\n\n  /**\n   * 移除事件监听\n   */\n  off(event: string, handler: EventHandler): void {\n    this.events.off(event, handler);\n  }\n\n  // ============================================================\n  // Label API\n  // ============================================================\n\n  /**\n   * 获取所有标签\n   */\n  getLabels(): Label[] {\n    return [...this.labels];\n  }\n\n  /**\n   * 添加标签\n   */\n  addLabel(label: Label): void {\n    this.labels.push(label);\n  }\n\n  /**\n   * 移除标签\n   */\n  removeLabel(id: string): void {\n    this.labels = this.labels.filter(l => l.id !== id);\n  }\n\n  // ============================================================\n  // Render\n  // ============================================================\n\n  private renderTimer: ReturnType<typeof setTimeout> | null = null;\n\n  /**\n   * 延迟渲染（合并多次调用，等待浏览器拖拽操作完成）\n   */\n  private scheduleRender(): void {\n    if (this.renderTimer !== null) return;\n    this.renderTimer = setTimeout(() => {\n      this.renderTimer = null;\n      this.render();\n    }, 0);\n  }\n\n  /**\n   * 重新渲染\n   */\n  render(): void {\n    if (this.destroyed) return;\n    this.dragController.destroy();\n    this.dragController = new DragController(this.events, this.options.classPrefix || 'kanban');\n    this.renderer = new Renderer(this.container, this.events, this.dragController, this.options);\n    this.renderer.render(\n      this.columnManager.getColumns(),\n      this.filterEngine.getHiddenCardIds(),\n    );\n  }\n\n  /**\n   * 获取看板根元素\n   */\n  getBoardElement(): HTMLElement | null {\n    return this.renderer.getBoardElement();\n  }\n\n  /**\n   * 获取配置\n   */\n  getOptions(): Readonly<KanbanOptions> {\n    return { ...this.options };\n  }\n\n  // ============================================================\n  // Lifecycle\n  // ============================================================\n\n  /**\n   * 销毁实例\n   */\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n\n    if (this.renderTimer !== null) {\n      clearTimeout(this.renderTimer);\n      this.renderTimer = null;\n    }\n\n    this.dragController.destroy();\n    this.filterEngine.destroy();\n    this.renderer.destroy();\n    this.columnManager.clear();\n\n    this.events.emit('destroy', undefined);\n    this.options.onDestroy?.();\n    this.events.removeAll();\n\n    if (this.options.debug) {\n      console.log('[KanbanBoard] Destroyed');\n    }\n  }\n\n  /**\n   * 是否已销毁\n   */\n  isDestroyed(): boolean {\n    return this.destroyed;\n  }\n}\n\n/**\n * 创建看板实例（工厂函数）\n */\nexport function createKanbanBoard(options: KanbanOptions): KanbanBoard {\n  return new KanbanBoard(options);\n}\n"],"mappings":"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"}

package/es/core/Renderer.d.ts

@@ -0,0 +1,59 @@
+import type { Column, KanbanOptions } from '../types';
+import { EventEmitter } from './EventEmitter';
+import { DragController } from './DragController';
+/**
+ * DOM 渲染器
+ */
+export declare class Renderer {
+    private container;
+    private boardEl;
+    private events;
+    private dragController;
+    private options;
+    private prefix;
+    private columnElements;
+    private columnBodyElements;
+    private cardElements;
+    constructor(container: HTMLElement, events: EventEmitter, dragController: DragController, options: KanbanOptions);
+    /**
+     * 渲染整个看板
+     */
+    render(columns: Column[], hiddenCardIds?: Set<string>): void;
+    /**
+     * 渲染单个列
+     */
+    private renderColumn;
+    /**
+     * 渲染列头部
+     */
+    private renderColumnHeader;
+    /**
+     * 渲染单张卡片
+     */
+    private renderCard;
+    /**
+     * 默认卡片渲染
+     */
+    private renderDefaultCard;
+    /**
+     * 获取列元素
+     */
+    getColumnElement(columnId: string): HTMLElement | undefined;
+    /**
+     * 获取卡片元素
+     */
+    getCardElement(cardId: string): HTMLElement | undefined;
+    /**
+     * 获取看板根元素
+     */
+    getBoardElement(): HTMLElement | null;
+    /**
+     * 清理 DOM
+     */
+    private cleanup;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=Renderer.d.ts.map

package/es/core/Renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../src/core/Renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAQ,aAAa,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,YAAY,CAAkC;gBAGpD,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,aAAa;IASxB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAiC5D;;OAEG;IACH,OAAO,CAAC,YAAY;IAuDpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgE1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAwBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmEzB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI3D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIvD;;OAEG;IACH,eAAe,IAAI,WAAW,GAAG,IAAI;IAIrC;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}