@composy/kanban-core 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/README.md +37 -0
  2. package/dist/index.css +307 -0
  3. package/dist/index.js +1279 -0
  4. package/dist/index.js.map +1 -0
  5. package/dist/index.min.css +1 -0
  6. package/dist/index.min.js +1 -0
  7. package/es/core/ColumnManager.d.ts +99 -0
  8. package/es/core/ColumnManager.d.ts.map +1 -0
  9. package/es/core/ColumnManager.js +285 -0
  10. package/es/core/ColumnManager.js.map +1 -0
  11. package/es/core/DragController.d.ts +55 -0
  12. package/es/core/DragController.d.ts.map +1 -0
  13. package/es/core/DragController.js +225 -0
  14. package/es/core/DragController.js.map +1 -0
  15. package/es/core/EventEmitter.d.ts +35 -0
  16. package/es/core/EventEmitter.d.ts.map +1 -0
  17. package/es/core/EventEmitter.js +68 -0
  18. package/es/core/EventEmitter.js.map +1 -0
  19. package/es/core/FilterEngine.d.ts +45 -0
  20. package/es/core/FilterEngine.d.ts.map +1 -0
  21. package/es/core/FilterEngine.js +127 -0
  22. package/es/core/FilterEngine.js.map +1 -0
  23. package/es/core/KanbanBoard.d.ts +152 -0
  24. package/es/core/KanbanBoard.d.ts.map +1 -0
  25. package/es/core/KanbanBoard.js +332 -0
  26. package/es/core/KanbanBoard.js.map +1 -0
  27. package/es/core/Renderer.d.ts +59 -0
  28. package/es/core/Renderer.d.ts.map +1 -0
  29. package/es/core/Renderer.js +247 -0
  30. package/es/core/Renderer.js.map +1 -0
  31. package/es/core/index.d.ts +11 -0
  32. package/es/core/index.d.ts.map +1 -0
  33. package/es/core/index.js +17 -0
  34. package/es/index.d.ts +15 -0
  35. package/es/index.d.ts.map +1 -0
  36. package/es/index.js +21 -0
  37. package/es/styles/kanban.css +306 -0
  38. package/es/types/index.d.ts +209 -0
  39. package/es/types/index.d.ts.map +1 -0
  40. package/es/types/index.js +10 -0
  41. package/es/utils/dom.d.ts +24 -0
  42. package/es/utils/dom.d.ts.map +1 -0
  43. package/es/utils/dom.js +37 -0
  44. package/es/utils/dom.js.map +1 -0
  45. package/es/utils/id.d.ts +9 -0
  46. package/es/utils/id.d.ts.map +1 -0
  47. package/es/utils/id.js +22 -0
  48. package/es/utils/id.js.map +1 -0
  49. package/es/utils/index.d.ts +25 -0
  50. package/es/utils/index.d.ts.map +1 -0
  51. package/es/utils/index.js +20 -0
  52. package/es/utils/index.js.map +1 -0
  53. package/es/version.d.ts +6 -0
  54. package/es/version.d.ts.map +1 -0
  55. package/es/version.js +15 -0
  56. package/es/version.js.map +1 -0
  57. package/esm/core/ColumnManager.d.ts +99 -0
  58. package/esm/core/ColumnManager.d.ts.map +1 -0
  59. package/esm/core/ColumnManager.js +285 -0
  60. package/esm/core/ColumnManager.js.map +1 -0
  61. package/esm/core/DragController.d.ts +55 -0
  62. package/esm/core/DragController.d.ts.map +1 -0
  63. package/esm/core/DragController.js +225 -0
  64. package/esm/core/DragController.js.map +1 -0
  65. package/esm/core/EventEmitter.d.ts +35 -0
  66. package/esm/core/EventEmitter.d.ts.map +1 -0
  67. package/esm/core/EventEmitter.js +68 -0
  68. package/esm/core/EventEmitter.js.map +1 -0
  69. package/esm/core/FilterEngine.d.ts +45 -0
  70. package/esm/core/FilterEngine.d.ts.map +1 -0
  71. package/esm/core/FilterEngine.js +127 -0
  72. package/esm/core/FilterEngine.js.map +1 -0
  73. package/esm/core/KanbanBoard.d.ts +152 -0
  74. package/esm/core/KanbanBoard.d.ts.map +1 -0
  75. package/esm/core/KanbanBoard.js +332 -0
  76. package/esm/core/KanbanBoard.js.map +1 -0
  77. package/esm/core/Renderer.d.ts +59 -0
  78. package/esm/core/Renderer.d.ts.map +1 -0
  79. package/esm/core/Renderer.js +247 -0
  80. package/esm/core/Renderer.js.map +1 -0
  81. package/esm/core/index.d.ts +11 -0
  82. package/esm/core/index.d.ts.map +1 -0
  83. package/esm/core/index.js +17 -0
  84. package/esm/index.d.ts +15 -0
  85. package/esm/index.d.ts.map +1 -0
  86. package/esm/index.js +21 -0
  87. package/esm/styles/kanban.less +339 -0
  88. package/esm/types/index.d.ts +209 -0
  89. package/esm/types/index.d.ts.map +1 -0
  90. package/esm/types/index.js +10 -0
  91. package/esm/utils/dom.d.ts +24 -0
  92. package/esm/utils/dom.d.ts.map +1 -0
  93. package/esm/utils/dom.js +37 -0
  94. package/esm/utils/dom.js.map +1 -0
  95. package/esm/utils/id.d.ts +9 -0
  96. package/esm/utils/id.d.ts.map +1 -0
  97. package/esm/utils/id.js +22 -0
  98. package/esm/utils/id.js.map +1 -0
  99. package/esm/utils/index.d.ts +25 -0
  100. package/esm/utils/index.d.ts.map +1 -0
  101. package/esm/utils/index.js +20 -0
  102. package/esm/utils/index.js.map +1 -0
  103. package/esm/version.d.ts +6 -0
  104. package/esm/version.d.ts.map +1 -0
  105. package/esm/version.js +15 -0
  106. package/esm/version.js.map +1 -0
  107. package/lib/core/ColumnManager.cjs +286 -0
  108. package/lib/core/ColumnManager.cjs.map +1 -0
  109. package/lib/core/ColumnManager.d.ts +99 -0
  110. package/lib/core/DragController.cjs +226 -0
  111. package/lib/core/DragController.cjs.map +1 -0
  112. package/lib/core/DragController.d.ts +55 -0
  113. package/lib/core/EventEmitter.cjs +69 -0
  114. package/lib/core/EventEmitter.cjs.map +1 -0
  115. package/lib/core/EventEmitter.d.ts +35 -0
  116. package/lib/core/FilterEngine.cjs +128 -0
  117. package/lib/core/FilterEngine.cjs.map +1 -0
  118. package/lib/core/FilterEngine.d.ts +45 -0
  119. package/lib/core/KanbanBoard.cjs +334 -0
  120. package/lib/core/KanbanBoard.cjs.map +1 -0
  121. package/lib/core/KanbanBoard.d.ts +152 -0
  122. package/lib/core/Renderer.cjs +248 -0
  123. package/lib/core/Renderer.cjs.map +1 -0
  124. package/lib/core/Renderer.d.ts +59 -0
  125. package/lib/core/index.cjs +24 -0
  126. package/lib/core/index.d.ts +11 -0
  127. package/lib/index.cjs +37 -0
  128. package/lib/index.d.ts +15 -0
  129. package/lib/package.json +3 -0
  130. package/lib/styles/kanban.css +306 -0
  131. package/lib/types/index.cjs +11 -0
  132. package/lib/types/index.d.ts +209 -0
  133. package/lib/utils/dom.cjs +42 -0
  134. package/lib/utils/dom.cjs.map +1 -0
  135. package/lib/utils/dom.d.ts +24 -0
  136. package/lib/utils/id.cjs +24 -0
  137. package/lib/utils/id.cjs.map +1 -0
  138. package/lib/utils/id.d.ts +9 -0
  139. package/lib/utils/index.cjs +28 -0
  140. package/lib/utils/index.cjs.map +1 -0
  141. package/lib/utils/index.d.ts +25 -0
  142. package/lib/version.cjs +16 -0
  143. package/lib/version.cjs.map +1 -0
  144. package/lib/version.d.ts +6 -0
  145. package/package.json +105 -0
@@ -0,0 +1,334 @@
1
+ /*!
2
+ * ***********************************
3
+ * @composy/kanban-core v0.0.1 *
4
+ * Built with rollup *
5
+ * Build time: 2024-08-17 11:33:25 *
6
+ * Build mode: production *
7
+ * Minified: No *
8
+ * ***********************************
9
+ */
10
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
11
+ const require_ColumnManager = require("./ColumnManager.cjs");
12
+ const require_DragController = require("./DragController.cjs");
13
+ const require_EventEmitter = require("./EventEmitter.cjs");
14
+ const require_FilterEngine = require("./FilterEngine.cjs");
15
+ const require_dom = require("../utils/dom.cjs");
16
+ const require_Renderer = require("./Renderer.cjs");
17
+ const require_version = require("../version.cjs");
18
+ //#region src/core/KanbanBoard.ts
19
+ var KanbanBoard = class {
20
+ constructor(options) {
21
+ this.destroyed = false;
22
+ this.labels = [];
23
+ this.renderTimer = null;
24
+ this.options = {
25
+ draggable: true,
26
+ columnDraggable: true,
27
+ crossColumnDrag: true,
28
+ searchable: true,
29
+ showAddCard: true,
30
+ showAddColumn: true,
31
+ showColumnActions: true,
32
+ showCardCount: true,
33
+ classPrefix: "kanban",
34
+ ...options
35
+ };
36
+ const el = require_dom.resolveElement(options.container);
37
+ if (!el) throw new Error("[KanbanBoard] Container element not found");
38
+ this.container = el;
39
+ this.events = new require_EventEmitter.EventEmitter();
40
+ this.columnManager = new require_ColumnManager.ColumnManager(this.events);
41
+ this.dragController = new require_DragController.DragController(this.events, this.options.classPrefix || "kanban");
42
+ this.filterEngine = new require_FilterEngine.FilterEngine(this.events);
43
+ this.renderer = new require_Renderer.Renderer(this.container, this.events, this.dragController, this.options);
44
+ this.labels = options.labels || [];
45
+ this.init();
46
+ }
47
+ init() {
48
+ if (this.options.columns?.length) this.columnManager.init(this.options.columns);
49
+ this.bindInternalEvents();
50
+ this.render();
51
+ this.events.emit("ready", { instance: this });
52
+ this.options.onReady?.(this);
53
+ if (this.options.debug) console.log("[KanbanBoard] Initialized", {
54
+ columns: this.columnManager.getColumns().length,
55
+ cards: this.columnManager.getCardCount()
56
+ });
57
+ }
58
+ /**
59
+ * 绑定内部事件
60
+ */
61
+ bindInternalEvents() {
62
+ this.events.on("card:drop", (payload) => {
63
+ this.columnManager.moveCard(payload.cardId, payload.toColumnId, payload.toIndex);
64
+ this.options.onCardMove?.(this.columnManager.getCard(payload.cardId), payload.fromColumnId, payload.toColumnId, payload.toIndex);
65
+ this.scheduleRender();
66
+ });
67
+ this.events.on("column:drop", (payload) => {
68
+ const fromIndex = this.columnManager.getColumns().findIndex((c) => c.id === payload.fromColumnId);
69
+ this.columnManager.moveColumn(payload.fromColumnId, payload.toIndex);
70
+ const col = this.columnManager.getColumn(payload.fromColumnId);
71
+ if (col) this.options.onColumnMove?.(col, fromIndex, payload.toIndex);
72
+ this.scheduleRender();
73
+ });
74
+ this.events.on("ui:toggle-collapse", (payload) => {
75
+ this.columnManager.toggleCollapse(payload.columnId);
76
+ const col = this.columnManager.getColumn(payload.columnId);
77
+ if (col) this.options.onColumnCollapse?.(col, col.collapsed ?? false);
78
+ this.render();
79
+ });
80
+ this.events.on("card:add", (p) => this.options.onCardAdd?.(p.card, p.columnId));
81
+ this.events.on("card:remove", (p) => this.options.onCardRemove?.(p.card, p.columnId));
82
+ this.events.on("card:click", (p) => this.options.onCardClick?.(p.card));
83
+ this.events.on("card:update", (p) => this.options.onCardUpdate?.(p.card));
84
+ this.events.on("column:add", (p) => this.options.onColumnAdd?.(p.column));
85
+ this.events.on("column:remove", (p) => this.options.onColumnRemove?.(p.column));
86
+ this.events.on("error", (p) => this.options.onError?.(p.error));
87
+ }
88
+ /**
89
+ * 添加列
90
+ */
91
+ addColumn(partial) {
92
+ const column = this.columnManager.addColumn(partial);
93
+ this.render();
94
+ return column;
95
+ }
96
+ /**
97
+ * 移除列
98
+ */
99
+ removeColumn(id) {
100
+ const column = this.columnManager.removeColumn(id);
101
+ if (column) this.render();
102
+ return column;
103
+ }
104
+ /**
105
+ * 更新列
106
+ */
107
+ updateColumn(id, changes) {
108
+ const column = this.columnManager.updateColumn(id, changes);
109
+ if (column) this.render();
110
+ return column;
111
+ }
112
+ /**
113
+ * 移动列
114
+ */
115
+ moveColumn(id, toIndex) {
116
+ this.columnManager.moveColumn(id, toIndex);
117
+ this.render();
118
+ }
119
+ /**
120
+ * 折叠/展开列
121
+ */
122
+ toggleColumnCollapse(id) {
123
+ this.columnManager.toggleCollapse(id);
124
+ this.render();
125
+ }
126
+ /**
127
+ * 获取所有列
128
+ */
129
+ getColumns() {
130
+ return this.columnManager.getColumns();
131
+ }
132
+ /**
133
+ * 获取单列
134
+ */
135
+ getColumn(id) {
136
+ return this.columnManager.getColumn(id);
137
+ }
138
+ /**
139
+ * 添加卡片
140
+ */
141
+ addCard(columnId, partial) {
142
+ const card = this.columnManager.addCard(columnId, partial);
143
+ if (card) this.render();
144
+ return card;
145
+ }
146
+ /**
147
+ * 移除卡片
148
+ */
149
+ removeCard(cardId) {
150
+ const card = this.columnManager.removeCard(cardId);
151
+ if (card) this.render();
152
+ return card;
153
+ }
154
+ /**
155
+ * 更新卡片
156
+ */
157
+ updateCard(cardId, changes) {
158
+ const card = this.columnManager.updateCard(cardId, changes);
159
+ if (card) this.render();
160
+ return card;
161
+ }
162
+ /**
163
+ * 移动卡片
164
+ */
165
+ moveCard(cardId, toColumnId, toIndex) {
166
+ this.columnManager.moveCard(cardId, toColumnId, toIndex);
167
+ this.render();
168
+ }
169
+ /**
170
+ * 获取单张卡片
171
+ */
172
+ getCard(cardId) {
173
+ return this.columnManager.getCard(cardId);
174
+ }
175
+ /**
176
+ * 获取所有卡片
177
+ */
178
+ getAllCards() {
179
+ return this.columnManager.getAllCards();
180
+ }
181
+ /**
182
+ * 获取卡片总数
183
+ */
184
+ getCardCount() {
185
+ return this.columnManager.getCardCount();
186
+ }
187
+ /**
188
+ * 筛选卡片
189
+ */
190
+ filter(criteria) {
191
+ this.filterEngine.filter(criteria, this.columnManager.getColumns());
192
+ this.render();
193
+ }
194
+ /**
195
+ * 搜索卡片
196
+ */
197
+ search(keyword) {
198
+ const result = this.filterEngine.search(keyword, this.columnManager.getColumns());
199
+ this.render();
200
+ return result;
201
+ }
202
+ /**
203
+ * 清除筛选
204
+ */
205
+ clearFilter() {
206
+ this.filterEngine.clearFilter();
207
+ this.render();
208
+ }
209
+ /**
210
+ * 导出看板数据
211
+ */
212
+ exportData() {
213
+ const data = {
214
+ version: require_version.VERSION,
215
+ title: this.options.title || "Kanban Board",
216
+ columns: this.columnManager.getColumns(),
217
+ labels: this.labels,
218
+ exportedAt: (/* @__PURE__ */ new Date()).toISOString()
219
+ };
220
+ this.events.emit("data:export", { board: data });
221
+ return data;
222
+ }
223
+ /**
224
+ * 导入看板数据
225
+ */
226
+ importData(data) {
227
+ this.columnManager.setColumns(data.columns);
228
+ this.labels = data.labels || [];
229
+ this.filterEngine.clearFilter();
230
+ this.events.emit("data:import", { board: data });
231
+ this.render();
232
+ }
233
+ /**
234
+ * 监听事件
235
+ */
236
+ on(event, handler) {
237
+ return this.events.on(event, handler);
238
+ }
239
+ /**
240
+ * 监听一次性事件
241
+ */
242
+ once(event, handler) {
243
+ return this.events.once(event, handler);
244
+ }
245
+ /**
246
+ * 移除事件监听
247
+ */
248
+ off(event, handler) {
249
+ this.events.off(event, handler);
250
+ }
251
+ /**
252
+ * 获取所有标签
253
+ */
254
+ getLabels() {
255
+ return [...this.labels];
256
+ }
257
+ /**
258
+ * 添加标签
259
+ */
260
+ addLabel(label) {
261
+ this.labels.push(label);
262
+ }
263
+ /**
264
+ * 移除标签
265
+ */
266
+ removeLabel(id) {
267
+ this.labels = this.labels.filter((l) => l.id !== id);
268
+ }
269
+ /**
270
+ * 延迟渲染(合并多次调用,等待浏览器拖拽操作完成)
271
+ */
272
+ scheduleRender() {
273
+ if (this.renderTimer !== null) return;
274
+ this.renderTimer = setTimeout(() => {
275
+ this.renderTimer = null;
276
+ this.render();
277
+ }, 0);
278
+ }
279
+ /**
280
+ * 重新渲染
281
+ */
282
+ render() {
283
+ if (this.destroyed) return;
284
+ this.dragController.destroy();
285
+ this.dragController = new require_DragController.DragController(this.events, this.options.classPrefix || "kanban");
286
+ this.renderer = new require_Renderer.Renderer(this.container, this.events, this.dragController, this.options);
287
+ this.renderer.render(this.columnManager.getColumns(), this.filterEngine.getHiddenCardIds());
288
+ }
289
+ /**
290
+ * 获取看板根元素
291
+ */
292
+ getBoardElement() {
293
+ return this.renderer.getBoardElement();
294
+ }
295
+ /**
296
+ * 获取配置
297
+ */
298
+ getOptions() {
299
+ return { ...this.options };
300
+ }
301
+ /**
302
+ * 销毁实例
303
+ */
304
+ destroy() {
305
+ if (this.destroyed) return;
306
+ this.destroyed = true;
307
+ if (this.renderTimer !== null) {
308
+ clearTimeout(this.renderTimer);
309
+ this.renderTimer = null;
310
+ }
311
+ this.dragController.destroy();
312
+ this.filterEngine.destroy();
313
+ this.renderer.destroy();
314
+ this.columnManager.clear();
315
+ this.events.emit("destroy", void 0);
316
+ this.options.onDestroy?.();
317
+ this.events.removeAll();
318
+ if (this.options.debug) console.log("[KanbanBoard] Destroyed");
319
+ }
320
+ /**
321
+ * 是否已销毁
322
+ */
323
+ isDestroyed() {
324
+ return this.destroyed;
325
+ }
326
+ };
327
+ function createKanbanBoard(options) {
328
+ return new KanbanBoard(options);
329
+ }
330
+ //#endregion
331
+ exports.KanbanBoard = KanbanBoard;
332
+ exports.createKanbanBoard = createKanbanBoard;
333
+ /*! End of @composy/kanban-core | Powered by @composy/builder */
334
+ //# sourceMappingURL=KanbanBoard.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"KanbanBoard.cjs","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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"}
@@ -0,0 +1,152 @@
1
+ import type { KanbanOptions, Column, Card, FilterCriteria, BoardData, Label } from '../types';
2
+ import { EventEmitter, type EventHandler } from './EventEmitter';
3
+ /**
4
+ * KanbanBoard - 看板视图库,支持拖拽卡片与列管理
5
+ */
6
+ export declare class KanbanBoard {
7
+ private container;
8
+ private options;
9
+ private destroyed;
10
+ readonly events: EventEmitter;
11
+ private columnManager;
12
+ private dragController;
13
+ private filterEngine;
14
+ private renderer;
15
+ private labels;
16
+ constructor(options: KanbanOptions);
17
+ private init;
18
+ /**
19
+ * 绑定内部事件
20
+ */
21
+ private bindInternalEvents;
22
+ /**
23
+ * 添加列
24
+ */
25
+ addColumn(partial: Partial<Column>): Column;
26
+ /**
27
+ * 移除列
28
+ */
29
+ removeColumn(id: string): Column | undefined;
30
+ /**
31
+ * 更新列
32
+ */
33
+ updateColumn(id: string, changes: Partial<Column>): Column | undefined;
34
+ /**
35
+ * 移动列
36
+ */
37
+ moveColumn(id: string, toIndex: number): void;
38
+ /**
39
+ * 折叠/展开列
40
+ */
41
+ toggleColumnCollapse(id: string): void;
42
+ /**
43
+ * 获取所有列
44
+ */
45
+ getColumns(): Column[];
46
+ /**
47
+ * 获取单列
48
+ */
49
+ getColumn(id: string): Column | undefined;
50
+ /**
51
+ * 添加卡片
52
+ */
53
+ addCard(columnId: string, partial: Partial<Card>): Card | undefined;
54
+ /**
55
+ * 移除卡片
56
+ */
57
+ removeCard(cardId: string): Card | undefined;
58
+ /**
59
+ * 更新卡片
60
+ */
61
+ updateCard(cardId: string, changes: Partial<Card>): Card | undefined;
62
+ /**
63
+ * 移动卡片
64
+ */
65
+ moveCard(cardId: string, toColumnId: string, toIndex: number): void;
66
+ /**
67
+ * 获取单张卡片
68
+ */
69
+ getCard(cardId: string): Card | undefined;
70
+ /**
71
+ * 获取所有卡片
72
+ */
73
+ getAllCards(): Card[];
74
+ /**
75
+ * 获取卡片总数
76
+ */
77
+ getCardCount(): number;
78
+ /**
79
+ * 筛选卡片
80
+ */
81
+ filter(criteria: FilterCriteria): void;
82
+ /**
83
+ * 搜索卡片
84
+ */
85
+ search(keyword: string): Card[];
86
+ /**
87
+ * 清除筛选
88
+ */
89
+ clearFilter(): void;
90
+ /**
91
+ * 导出看板数据
92
+ */
93
+ exportData(): BoardData;
94
+ /**
95
+ * 导入看板数据
96
+ */
97
+ importData(data: BoardData): void;
98
+ /**
99
+ * 监听事件
100
+ */
101
+ on(event: string, handler: EventHandler): () => void;
102
+ /**
103
+ * 监听一次性事件
104
+ */
105
+ once(event: string, handler: EventHandler): () => void;
106
+ /**
107
+ * 移除事件监听
108
+ */
109
+ off(event: string, handler: EventHandler): void;
110
+ /**
111
+ * 获取所有标签
112
+ */
113
+ getLabels(): Label[];
114
+ /**
115
+ * 添加标签
116
+ */
117
+ addLabel(label: Label): void;
118
+ /**
119
+ * 移除标签
120
+ */
121
+ removeLabel(id: string): void;
122
+ private renderTimer;
123
+ /**
124
+ * 延迟渲染(合并多次调用,等待浏览器拖拽操作完成)
125
+ */
126
+ private scheduleRender;
127
+ /**
128
+ * 重新渲染
129
+ */
130
+ render(): void;
131
+ /**
132
+ * 获取看板根元素
133
+ */
134
+ getBoardElement(): HTMLElement | null;
135
+ /**
136
+ * 获取配置
137
+ */
138
+ getOptions(): Readonly<KanbanOptions>;
139
+ /**
140
+ * 销毁实例
141
+ */
142
+ destroy(): void;
143
+ /**
144
+ * 是否已销毁
145
+ */
146
+ isDestroyed(): boolean;
147
+ }
148
+ /**
149
+ * 创建看板实例(工厂函数)
150
+ */
151
+ export declare function createKanbanBoard(options: KanbanOptions): KanbanBoard;
152
+ //# sourceMappingURL=KanbanBoard.d.ts.map