open-grid 1.3.1 → 1.4.0

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.
package/README.zh.md ADDED
@@ -0,0 +1,455 @@
1
+ # OPEN_GRID
2
+
3
+ **认识 Open Grid** —— 核心零依赖的超轻量数据表格,可以毫不费力地融入任何技术栈。React、Vue、
4
+ Angular、jQuery,或纯 JavaScript,装上就能用。采用 MIT 许可,商用毫无拘束;定制没有上限,
5
+ 还配有面向 AI 的 override 指南,让你把表格做得比以往更远。
6
+
7
+ 高性能、不绑定框架的数据表格,支持虚拟滚动、行内编辑、分组、树形视图、拖放、变更追踪、页脚聚合与列重排。
8
+
9
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
10
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
11
+ [![npm](https://img.shields.io/badge/npm-1.4.0-orange)](https://www.npmjs.com/package/open-grid)
12
+
13
+ [English](README.md) · [日本語](README.ja.md) · **中文**
14
+
15
+ 📖 **[开发指南](https://foxnail.kr/open-grid/demo/v2/guide/index.php)** —— 从安装到高级 API 的分步指南
16
+ 🔗 **[演示 / 主页](https://foxnail.kr/open-grid/demo/v2/index.php)**
17
+ 📚 **[API 文档](https://foxnail.kr/open-grid/demo/v2/api-docs/)** —— 韩、英、日、中四种语言的 JSDoc
18
+
19
+ ## 功能
20
+
21
+ ### 核心
22
+
23
+ | 功能 | 状态 |
24
+ |---|---|
25
+ | 虚拟滚动(100 万行以上) | ✅ |
26
+ | 行内编辑(click / dblclick / F2) | ✅ |
27
+ | 单元格渲染器(text、number、date、checkbox、button、badge、link、template、sparkline 等) | ✅ |
28
+ | 5 种单元格编辑器(text、number、select、date、checkbox) | ✅ |
29
+ | 多列排序(Shift+点击) | ✅ |
30
+ | 列筛选界面(9 种运算符) | ✅ |
31
+ | 列宽调整(拖拽) | ✅ |
32
+ | 列重排(拖拽表头,`columnReorder: true`) | ✅ |
33
+ | 冻结列 | ✅ |
34
+ | 行 / 列分组(表头合并) | ✅ |
35
+ | 分组 + 汇总(SUM/AVG/MIN/MAX/COUNT) | ✅ |
36
+ | 树形表格(扁平数据 → 层级,展开 / 折叠) | ✅ |
37
+ | 组织结构图(OrgChart,带主题) | ✅ |
38
+ | 单元格合并(手动 + 自动 rowSpan/colSpan) | ✅ |
39
+ | 行拖放 | ✅ |
40
+ | 变更追踪(`getChanges` / `getChangedColumns` / `getOriginalRow`) | ✅ |
41
+ | 页脚聚合(`setFooter`、`getFooterValue`,OGDecimal 精度) | ✅ |
42
+ | 数据脱敏(10 种类型,可按单元格 / 列开关) | ✅ |
43
+ | 分页 | ✅ |
44
+ | Excel / CSS 主题导出 | ✅ |
45
+ | CSV / JSON 导出 | ✅ |
46
+ | 剪贴板(Ctrl+C / Ctrl+V) | ✅ |
47
+ | 键盘导航(方向键 / Tab / F2 / Esc) | ✅ |
48
+ | 核心零依赖 | ✅ |
49
+
50
+ ### 电子表格级(v1.1)
51
+
52
+ | 功能 | 状态 |
53
+ |---|---|
54
+ | 区域选择 + 填充 —— 拖选单元格区域、序列填充、TSV 剪贴板、Ctrl+D/R(`rangeSelection`) | ✅ |
55
+ | 主从视图 —— 把一行展开为 HTML 面板或子表格(`masterDetail`、`expandRow`) | ✅ |
56
+ | 公式单元格 —— `=B1*C1`、`=SUM(C1:C10)`,19 个函数,`[field]`/A1 引用,`#REF`/`#CYCLE` 错误(`formula`) | ✅ |
57
+ | 集成图表 —— 用表格数据绘制柱状图 / 折线图,LTTB 降采样 + 采样标记,内置 canvas 渲染器(`chart`) | ✅ |
58
+
59
+ ### 格式与数据(v1.3)
60
+
61
+ | 功能 | 状态 |
62
+ |---|---|
63
+ | 条件格式 —— 数据条、热力图、图标集、规则优先级 | ✅ |
64
+ | 实时数据 —— 带背压的流式 / 轮询数据源 | ✅ |
65
+ | 外观双轴 —— 密度与质感设置方法 | ✅ |
66
+
67
+ ### 外观风格
68
+
69
+ | 功能 | 状态 |
70
+ |---|---|
71
+ | 15 款内置主题(dark、ocean、forest、crimson、stitch 等) | ✅ |
72
+ | 6 款皮肤(形态轴,与颜色正交)—— sharp / rounded / stitch / flat / high-contrast / material | ✅ |
73
+ | 64 个语义图标(Bootstrap Icons,MIT)—— `renderIcon`、`grid.setIcon`、`OpenGrid.defineIconSet` | ✅ |
74
+ | 本地化 / i18n(内置 `ko`·`en`,`setLocale`,自定义语言包) | ✅ |
75
+
76
+ ### 扩展性
77
+
78
+ | 功能 | 状态 |
79
+ |---|---|
80
+ | `grid.override(...)` —— 不碰核心即可定制行为(配面向 AI 的指南) | ✅ |
81
+ | 扩展注册表 —— `TypedRegistry`,返回 `added`/`replaced`/`kept`/`rejected` 处理结果,保留前缀 `og:` 防护,`protect-builtin` | ✅ |
82
+ | Vue 3 组件 | ✅ |
83
+ | React 18 组件 | ✅ |
84
+
85
+ ## 安装
86
+
87
+ ```bash
88
+ npm install open-grid
89
+ ```
90
+
91
+ ## 快速上手
92
+
93
+ ### 原生 JavaScript / TypeScript
94
+
95
+ ```typescript
96
+ import { OpenGrid } from 'open-grid';
97
+ import 'open-grid/style.css';
98
+
99
+ const grid = new OpenGrid('#container', {
100
+ columns: [
101
+ { field: 'name', header: '이름', width: 120 },
102
+ { field: 'price', header: '금액', width: 100, type: 'number', align: 'right' },
103
+ { field: 'date', header: '날짜', width: 110, type: 'date' },
104
+ ],
105
+ editable: true,
106
+ sortable: true,
107
+ rowNumber: true,
108
+ height: 500,
109
+
110
+ onReady: (g) => g.setData(myData),
111
+ onCellClick: (e) => console.log(e.field, e.value),
112
+ onEditEnd: (e) => console.log(e.oldValue, '→', e.newValue),
113
+ });
114
+ ```
115
+
116
+ ### Vue 3
117
+
118
+ ```vue
119
+ <template>
120
+ <OpenGrid
121
+ :columns="columns"
122
+ :data="rows"
123
+ :editable="true"
124
+ :sortable="true"
125
+ :height="500"
126
+ @cell-click="onCellClick"
127
+ @edit-end="onEditEnd"
128
+ @update:data="rows = $event"
129
+ />
130
+ </template>
131
+
132
+ <script setup lang="ts">
133
+ import { ref } from 'vue';
134
+ import { OpenGrid } from 'open-grid/vue';
135
+ import 'open-grid/style.css';
136
+
137
+ const columns = [
138
+ { field: 'name', header: '이름', width: 120 },
139
+ { field: 'price', header: '금액', width: 100, type: 'number', align: 'right' },
140
+ ];
141
+ const rows = ref(myData);
142
+ </script>
143
+ ```
144
+
145
+ ### React 18
146
+
147
+ ```tsx
148
+ import { OpenGrid } from 'open-grid/react';
149
+ import 'open-grid/style.css';
150
+
151
+ function App() {
152
+ const [data, setData] = useState(myData);
153
+ const gridRef = useRef(null);
154
+
155
+ return (
156
+ <OpenGrid
157
+ columns={columns}
158
+ data={data}
159
+ editable sortable
160
+ height={500}
161
+ onReady={(g) => { gridRef.current = g; }}
162
+ onDataChange={setData}
163
+ />
164
+ );
165
+ }
166
+ ```
167
+
168
+ ## API 参考
169
+
170
+ ### 构造函数
171
+
172
+ ```typescript
173
+ new OpenGrid(container: string | HTMLElement, options: GridOptions)
174
+ ```
175
+
176
+ ### 数据 API
177
+
178
+ | 方法 | 说明 |
179
+ |---|---|
180
+ | `setData(data)` | 设置数据 |
181
+ | `getData()` | 返回当前显示的数据 |
182
+ | `insertRow(item, position?)` | 插入行(`'first'` / `'last'` / 索引) |
183
+ | `deleteRow(rowIndex)` | 删除行(软删除) |
184
+ | `pushRow(items)` | 在末尾追加行 |
185
+ | `unshiftRow(items)` | 在开头插入行 |
186
+ | `readCell(rowIndex, field)` | 读取单元格值 |
187
+ | `writeCell(rowIndex, field, value)` | 写入单元格值 |
188
+ | `reorderRow(from, to)` | 移动行顺序 |
189
+
190
+ ### 变更追踪 API(v0.1.2)
191
+
192
+ | 方法 | 说明 |
193
+ |---|---|
194
+ | `getChanges()` | 一次性返回 `{ added, edited, removed }`。edited 行中带 `_changedFields` |
195
+ | `getEditedRows()` | 只返回修改过的行 |
196
+ | `getAddedRows()` | 返回新增的行 |
197
+ | `getRemovedRows()` | 返回删除的行 |
198
+ | `getChangedColumns()` | `{ row, fields, diff[] }` 列级差异(oldValue/newValue) |
199
+ | `getOriginalRow(rowIndex)` | 返回修改前的原始行数据 |
200
+
201
+ ### 页脚 / 小计 API(v0.1.2)
202
+
203
+ | 方法 | 说明 |
204
+ |---|---|
205
+ | `setFooter(FooterDef[])` | 设置页脚聚合(SUM/AVG/MIN/MAX/COUNT、colspan、format) |
206
+ | `getFooterValue(field)` | 查询指定字段的聚合结果 |
207
+ | `getFooterData()` | 返回全部页脚聚合数据的数组 |
208
+
209
+ ```typescript
210
+ grid.setFooter([
211
+ { label: '합계', colspan: 2, align: 'left' },
212
+ { field: 'salary', op: 'SUM', format: '#,##0', align: 'right' },
213
+ { field: 'rate', op: 'SUM', format: '#,##0.00', align: 'right' }, // OGDecimal 정밀계산
214
+ { field: 'score', op: 'AVG', format: '#,##0.0', align: 'right' },
215
+ ]);
216
+
217
+ const total = grid.getFooterValue('salary'); // 숫자 반환
218
+ ```
219
+
220
+ ### 列重排 API(v0.1.1)
221
+
222
+ ```typescript
223
+ const grid = new OpenGrid('#container', {
224
+ columns,
225
+ columnReorder: true, // 헤더 드래그 활성화
226
+ onColumnReorder: ({ fromIndex, toIndex, field }) => {
227
+ console.log(`컬럼 이동: ${fromIndex} → ${toIndex} (${field})`);
228
+ },
229
+ });
230
+
231
+ grid.applyColumns([...originalColumns]); // 원래 순서로 복원
232
+ ```
233
+
234
+ ### 排序 / 筛选
235
+
236
+ | 方法 | 说明 |
237
+ |---|---|
238
+ | `orderBy(field, dir?)` | 排序 |
239
+ | `resetOrder()` | 重置排序 |
240
+ | `setFilter(field, items)` | 设置筛选 |
241
+ | `resetFilter(field?)` | 重置筛选 |
242
+
243
+ ### 分组
244
+
245
+ | 方法 | 说明 |
246
+ |---|---|
247
+ | `groupBy(fields[])` | 设置分组 |
248
+ | `clearGroup()` | 取消分组 |
249
+ | `expandAll()` | 全部展开 |
250
+ | `collapseAll()` | 全部折叠 |
251
+
252
+ ### 树形表格
253
+
254
+ | 方法 | 说明 |
255
+ |---|---|
256
+ | `enableTree()` | 启用树形模式 |
257
+ | `disableTree()` | 关闭树形模式 |
258
+ | `expandNodes(ids, open?)` | 展开 / 折叠指定节点 |
259
+ | `expandAllNodes()` | 全部展开 |
260
+ | `collapseAllNodes()` | 全部折叠 |
261
+
262
+ ### 单元格合并
263
+
264
+ | 方法 | 说明 |
265
+ |---|---|
266
+ | `mergeCells(cells)` | 手动合并 `[{row, col, rowSpan?, colSpan?}]` |
267
+ | `autoMerge(fields[])` | 对连续相同的值自动 rowSpan |
268
+ | `clearMerge()` | 取消合并 |
269
+
270
+ ### 导出
271
+
272
+ | 方法 | 说明 |
273
+ |---|---|
274
+ | `exportExcel(options?)` | 导出 Excel (.xlsx) |
275
+ | `exportCsv(options?)` | 导出 CSV |
276
+ | `exportJson(options?)` | 导出 JSON |
277
+
278
+ ### UI
279
+
280
+ | 方法 | 说明 |
281
+ |---|---|
282
+ | `jumpToRow(rowIndex)` | 滚动到指定行 |
283
+ | `setTheme(theme)` | 切换主题(`'default'` / `'dark'`) |
284
+ | `resize(w?, h?)` | 调整尺寸 |
285
+ | `destroy()` | 销毁实例 |
286
+
287
+ ## GridOptions
288
+
289
+ ```typescript
290
+ interface GridOptions {
291
+ columns: ColumnDef[]; // 컬럼 정의 (필수)
292
+ height?: number | string; // 그리드 높이 (기본: '100%')
293
+ width?: number | string; // 그리드 너비 (기본: '100%')
294
+ editable?: boolean; // 인라인 편집 활성화
295
+ editMode?: 'click' | 'dblclick'; // 편집 진입 방식
296
+ sortable?: boolean; // 정렬 활성화
297
+ multiSort?: boolean; // 멀티소트 (Shift+클릭)
298
+ filterable?: boolean; // 필터 UI 활성화
299
+ rowNumber?: boolean; // 행 번호 컬럼
300
+ checkColumn?: boolean; // 체크박스 컬럼
301
+ stateColumn?: boolean; // 상태 표시 컬럼 (✚/✎/✖)
302
+ frozenColumns?: number; // 고정 컬럼 수
303
+ selection?: 'single' | 'multiple' | 'row';
304
+ clipboard?: boolean; // Ctrl+C/V 클립보드
305
+ draggable?: boolean; // 행 드래그앤드롭
306
+ pagination?: boolean; // 페이징 UI
307
+ pageSize?: number; // 페이지당 행 수
308
+ treeId?: string; // 트리 id 필드명 (기본: 'id')
309
+ treeParentId?: string; // 트리 parentId 필드명 (기본: 'parentId')
310
+ expandOnLoad?: boolean; // 트리 초기 전체 펼침
311
+ summary?: SummaryOptions; // 그룹 소계 설정
312
+ theme?: 'default' | 'dark';
313
+ defaultSort?: SortItem[]; // 초기 정렬
314
+
315
+ // 이벤트 콜백
316
+ onReady?: (grid: OpenGridInstance) => void;
317
+ onCellClick?: (e: CellEvent) => void;
318
+ onCellDblClick?: (e: CellEvent) => void;
319
+ onRowClick?: (e: RowEvent) => void;
320
+ onEditStart?: (e: EditEvent) => void;
321
+ onEditEnd?: (e: EditEvent) => void;
322
+ onSortChange?: (e: SortEvent) => void;
323
+ onFilterChange?: (e: FilterEvent) => void;
324
+ onDataChange?: (data: any[]) => void;
325
+ onSelectionChange?: (e: SelectionEvent) => void;
326
+ onRowDrop?: (e: { fromIndex: number; toIndex: number }) => void;
327
+ onPageChange?: (e: PageEvent) => void;
328
+ // v0.1.1+
329
+ columnReorder?: boolean; // 헤더 드래그 컬럼 순서 변경
330
+ onColumnReorder?: (e: { fromIndex: number; toIndex: number; field: string }) => void;
331
+ // v0.1.2+
332
+ footer?: FooterDef[]; // 초기 푸터 설정
333
+ }
334
+ ```
335
+
336
+ ## ColumnDef
337
+
338
+ ```typescript
339
+ interface ColumnDef {
340
+ field: string; // 데이터 필드명 (필수)
341
+ header?: string; // 헤더 텍스트
342
+ width?: number; // 컬럼 너비 (px)
343
+ type?: 'text' | 'number' | 'date' | 'checkbox' | 'button' | 'badge' | 'link' | 'template';
344
+ align?: 'left' | 'center' | 'right';
345
+ editable?: boolean | ((row, rowIndex) => boolean);
346
+ sortable?: boolean;
347
+ filterable?: boolean;
348
+ resizable?: boolean;
349
+ hidden?: boolean;
350
+ format?: string; // 숫자 포맷 (예: '#,##0')
351
+ children?: ColumnDef[]; // 그룹 헤더
352
+ cellStyle?: CSSProperties | ((value, row, rowIndex) => CSSProperties);
353
+ renderer?: (ctx: RenderContext) => HTMLElement;
354
+ }
355
+ ```
356
+
357
+ ## 性能
358
+
359
+ 10 万行数据的基准测试结果:
360
+
361
+ | 操作 | 耗时 |
362
+ |---|---|
363
+ | 生成数据 | ~65ms |
364
+ | setData() | ~30ms |
365
+ | applySort(单列) | ~38ms |
366
+ | applySort(多列) | ~40ms |
367
+ | applyFilter | ~17ms |
368
+ | buildGroups | ~3ms |
369
+ | buildTree | ~25ms |
370
+
371
+ ## CSS 定制
372
+
373
+ 用 CSS 变量就能完全定制主题:
374
+
375
+ ```css
376
+ .og-container {
377
+ --og-primary: #1976d2;
378
+ --og-header-bg: #f5f5f5;
379
+ --og-row-bg: #ffffff;
380
+ --og-row-alt-bg: #fafafa;
381
+ --og-row-selected-bg: #bbdefb;
382
+ --og-border-color: #e0e0e0;
383
+ --og-font-size: 13px;
384
+ --og-group-bg: #e8eaf6;
385
+ --og-tree-toggle-color: #1976d2;
386
+ }
387
+ ```
388
+
389
+ ## 本地化(i18n)
390
+
391
+ 所有内置界面文案 —— 标签、`aria-label`、live region 播报、提示气泡、占位符 —— 都放在可替换的语言包里,
392
+ 与核心分离。内置 **`ko`(默认)和 `en`**。现有应用不受影响:不传 `locale`/`messages` 选项时,
393
+ 输出与此前逐字节一致。
394
+
395
+ ```ts
396
+ import { OpenGrid, localeRegistry } from 'open-grid';
397
+
398
+ // 1) Pick a built-in locale per instance
399
+ const grid = new OpenGrid(el, { columns, locale: 'en' });
400
+
401
+ // 2) Switch at runtime (re-labels chrome, updates the `lang` attribute, emits `localeChange`)
402
+ grid.setLocale('ko');
403
+
404
+ // 3) Override just a few messages for one instance
405
+ new OpenGrid(el, { locale: 'en', messages: { contextMenu: { sortAsc: 'Sort A→Z' } } });
406
+
407
+ // 4) Register a custom locale globally (partial dictionaries are fine — missing keys fall back)
408
+ localeRegistry.register('ja', { contextMenu: { find: '検索' }, pagination: { rowsPerPage: '行/ページ:' } });
409
+ new OpenGrid(el, { locale: 'ja' });
410
+ ```
411
+
412
+ 回退链:实例级覆盖 → 当前语言 → `ko`(完整语言包)→ 原始 key。
413
+ 数字与日期格式化、面向开发者的错误信息有意不在覆盖范围内
414
+ (前者请用 `Intl`,后者保持日志可 grep)。完整 key 列表见
415
+ [本地化指南](https://foxnail.kr/open-grid/demo/v2/guide/index.php)。
416
+
417
+ ## 更新日志
418
+
419
+ 完整发布历史见 [`CHANGELOG.md`](CHANGELOG.md)。
420
+
421
+ 近期要点:
422
+
423
+ - **1.4.0** —— 公开扩展注册表(`TypedRegistry`、保留命名空间守卫);
424
+ 公开 API 的 JSDoc 提供韩语、英语、日语、中文四种语言。
425
+ - **1.3.1** —— 重写公开 API 的 JSDoc,让人读得懂(仅改注释,逻辑未动)。
426
+ - **1.3.0** —— 条件格式、集成图表子系统、实时数据源、外观双轴(密度 / 质感)。
427
+ - **1.2.0** —— 国际化,语言资源独立(`LocaleRegistry`)。
428
+ - **1.1.0** —— 区域选择 + 填充、主从视图、公式单元格、集成图表。
429
+ - **1.0.0** —— `grid.override()` 定制接口。
430
+
431
+ ## 许可
432
+
433
+ MIT © OPEN_GRID Contributors
434
+
435
+ ### 零运行时依赖(Excel 导出照样开箱即用)
436
+
437
+ `npm install open-grid` **不会拉取任何外部运行时依赖** —— 表格核心完全自包含。
438
+
439
+ **Excel 导出开箱即用,无需另装任何东西。** 它使用 SheetJS(`xlsx-js-style`),该库**已打包在本包内**
440
+ (位于 `dist/`),只有在真正执行导出时才按需加载。你**不需要**往自己的项目里添加
441
+ `xlsx`/`xlsx-js-style` —— 它们随 OPEN_GRID 一起发布。(它们列在 `devDependencies` 下,
442
+ 是因为*构建*产物时需要,而*使用*时不需要。)
443
+
444
+ ### 第三方许可
445
+
446
+ 内置的 Excel 导出使用 **SheetJS Community Edition (`xlsx`)** 与 **`xlsx-js-style`**,
447
+ 两者均以 **Apache License, Version 2.0** 授权(© SheetJS LLC;样式分支为 Brent Ely)。
448
+ 其署名声明与完整许可证文本收录在 [`NOTICE`](NOTICE) 和
449
+ [`THIRD_PARTY_LICENSES.txt`](THIRD_PARTY_LICENSES.txt) 中。
450
+
451
+ > **自 1.0.2 起**,`NOTICE` 与 `THIRD_PARTY_LICENSES.txt` 这两个文件随发布包一同分发,
452
+ > 以满足内置组件的 Apache-2.0 署名要求 —— 由此修复了早期版本(≤ 1.0.1)中潜在的
453
+ > 许可合规缺口:那些版本只附带了 MIT 许可证,缺少必需的 Apache-2.0 声明。
454
+ > OPEN_GRID 自身的 MIT 许可证未变;MIT 与 Apache-2.0 相互兼容,因此这仅是一次署名修正。
455
+ > 详情见 [`CHANGELOG.md`](CHANGELOG.md)。
@@ -6905,7 +6905,7 @@ const _OpenGrid = class _OpenGrid extends EventEmitter {
6905
6905
  this._cf = null, this._cfStats.clear(), this._doRender(...this._visRange());
6906
6906
  return;
6907
6907
  }
6908
- const s = await Promise.resolve().then(() => require("./index-JjfWY3Bt.cjs"));
6908
+ const s = await Promise.resolve().then(() => require("./index-D1l3XFCM.cjs"));
6909
6909
  this._cf = new s.CFEngine(new s.CFRuleStore(e)), this._cfAppearance = s.staticAppearanceView(), this._cfComputeStats = s.computeColumnStats, this._recomputeCFStats(), this._doRender(...this._visRange());
6910
6910
  }
6911
6911
  _recomputeCFStats() {
@@ -7382,4 +7382,4 @@ _OpenGrid.defaults = { strategy(e, s) {
7382
7382
  } };
7383
7383
  let OpenGrid = _OpenGrid;
7384
7384
  exports.DEFAULT_ICON_ROLES = DEFAULT_ICON_ROLES, exports.IconRegistry = IconRegistry, exports.LocaleRegistry = LocaleRegistry, exports.OpenGrid = OpenGrid, exports.SkinRegistry = SkinRegistry, exports.buildTree = buildTree, exports.contrastRatio = contrastRatio, exports.iconRegistry = iconRegistry, exports.localeRegistry = localeRegistry, exports.parseColor = parseColor, exports.renderIcon = renderIcon, exports.skinRegistry = skinRegistry, exports.t = t;
7385
- //# sourceMappingURL=OpenGrid-B7m7ei7f.cjs.map
7385
+ //# sourceMappingURL=OpenGrid-BOtTt5aI.cjs.map
@@ -6904,7 +6904,7 @@ const _J = class _J extends Is {
6904
6904
  this._cf = null, this._cfStats.clear(), this._doRender(...this._visRange());
6905
6905
  return;
6906
6906
  }
6907
- const t = await import("./index-DrCPRuYi.js");
6907
+ const t = await import("./index-B3fKi43v.js");
6908
6908
  this._cf = new t.CFEngine(new t.CFRuleStore(e)), this._cfAppearance = t.staticAppearanceView(), this._cfComputeStats = t.computeColumnStats, this._recomputeCFStats(), this._doRender(...this._visRange());
6909
6909
  }
6910
6910
  _recomputeCFStats() {
@@ -7395,4 +7395,4 @@ export {
7395
7395
  Ze as s,
7396
7396
  B as t
7397
7397
  };
7398
- //# sourceMappingURL=OpenGrid-CeUdO_fM.js.map
7398
+ //# sourceMappingURL=OpenGrid-sI_vdHQw.js.map
@@ -0,0 +1,74 @@
1
+ const a = ["og:", "og-"];
2
+ function d(t) {
3
+ return a.some((i) => t.startsWith(i));
4
+ }
5
+ function c(t) {
6
+ const i = t.lastIndexOf("@"), r = i >= 0 ? t.slice(i + 1) : t;
7
+ return r.split(".")[0] ?? r;
8
+ }
9
+ function u(t, i) {
10
+ return c(t) === c(i);
11
+ }
12
+ function l(t, i, r, e, s) {
13
+ const n = { key: t, value: i, origin: r, priority: e.priority ?? 0, seq: s };
14
+ return e.pluginId !== void 0 && (n.pluginId = e.pluginId), e.spiVersion !== void 0 && (n.spiVersion = e.spiVersion), e.deprecated !== void 0 && (n.deprecated = e.deprecated), n;
15
+ }
16
+ class p {
17
+ constructor(i = {}) {
18
+ this._map = /* @__PURE__ */ new Map(), this._seq = 0, this._disposed = false, this._warned = /* @__PURE__ */ new Set(), this._cfg = i;
19
+ }
20
+ _warn(i, r) {
21
+ const e = `[OpenGrid] ${r}`, s = `${i}::${r}`;
22
+ return this._warned.has(s) || (this._warned.add(s), (this._cfg.onWarn ?? ((o) => {
23
+ typeof console < "u" && console.warn(o);
24
+ }))(e)), e;
25
+ }
26
+ register(i, r, e = {}) {
27
+ if (this._disposed) return { ok: false, action: "rejected", reason: "disposed" };
28
+ if (typeof i != "string" || i.length === 0) return { ok: false, action: "rejected", reason: "invalid-key" };
29
+ const s = e.origin ?? "user";
30
+ if (d(i) && s !== "builtin") return { ok: false, action: "rejected", reason: "reserved-namespace", warning: this._warn(i, `reserved namespace: '${i}' 는 og:* 코어 예약 대역입니다(origin:'builtin' 만 점유).`) };
31
+ if (this._cfg.spi && e.spiVersion !== void 0 && !u(this._cfg.spi.version, e.spiVersion)) return { ok: false, action: "rejected", reason: "spi-mismatch", warning: this._warn(i, `SPI major 불일치: '${i}' 선언 ${e.spiVersion}, 코어 ${this._cfg.spi.name}@${this._cfg.spi.version}.`) };
32
+ const n = this._map.get(i);
33
+ return n && !this._resolveConflict(n, e) ? { ok: false, action: "kept", reason: "protected-builtin", warning: this._warn(i, `'${i}' 는 ${n.origin === "builtin" ? "내장(built-in) 보호" : "override 미지정"} — 덮으려면 { override:true }.`) } : (this._map.set(i, l(i, r, s, e, this._seq++)), { ok: true, action: n ? "replaced" : "added" });
34
+ }
35
+ _resolveConflict(i, r) {
36
+ return i.origin === "builtin" && r.override !== true ? false : this._cfg.duplicatePolicy === "explicit-override" ? r.override === true : true;
37
+ }
38
+ get(i) {
39
+ var _a;
40
+ return (_a = this._map.get(i)) == null ? void 0 : _a.value;
41
+ }
42
+ require(i, r) {
43
+ const e = this.get(i);
44
+ if (e !== void 0) return e;
45
+ if (r !== void 0) return r;
46
+ if (this._cfg.placeholder) return this._cfg.placeholder(i);
47
+ }
48
+ has(i) {
49
+ return this._map.has(i);
50
+ }
51
+ list() {
52
+ return [...this._map.keys()];
53
+ }
54
+ entries() {
55
+ return [...this._map.values()];
56
+ }
57
+ unregister(i) {
58
+ return this._map.delete(i);
59
+ }
60
+ disposePlugin(i) {
61
+ let r = 0;
62
+ for (const [e, s] of this._map) s.pluginId === i && (this._map.delete(e), r++);
63
+ return r;
64
+ }
65
+ dispose() {
66
+ this._map.clear(), this._warned.clear(), this._disposed = true;
67
+ }
68
+ }
69
+ export {
70
+ a as R,
71
+ p as T,
72
+ d as i
73
+ };
74
+ //# sourceMappingURL=Registry-CPJYOqCn.js.map
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ const RESERVED_PREFIXES = ["og:", "og-"];
3
+ function isReserved(t) {
4
+ return RESERVED_PREFIXES.some((e) => t.startsWith(e));
5
+ }
6
+ function spiMajor(t) {
7
+ const e = t.lastIndexOf("@"), r = e >= 0 ? t.slice(e + 1) : t;
8
+ return r.split(".")[0] ?? r;
9
+ }
10
+ function spiCompatible(t, e) {
11
+ return spiMajor(t) === spiMajor(e);
12
+ }
13
+ function buildEntry(t, e, r, i, s) {
14
+ const n = { key: t, value: e, origin: r, priority: i.priority ?? 0, seq: s };
15
+ return i.pluginId !== void 0 && (n.pluginId = i.pluginId), i.spiVersion !== void 0 && (n.spiVersion = i.spiVersion), i.deprecated !== void 0 && (n.deprecated = i.deprecated), n;
16
+ }
17
+ class TypedRegistry {
18
+ constructor(e = {}) {
19
+ this._map = /* @__PURE__ */ new Map(), this._seq = 0, this._disposed = false, this._warned = /* @__PURE__ */ new Set(), this._cfg = e;
20
+ }
21
+ _warn(e, r) {
22
+ const i = `[OpenGrid] ${r}`, s = `${e}::${r}`;
23
+ return this._warned.has(s) || (this._warned.add(s), (this._cfg.onWarn ?? ((o) => {
24
+ typeof console < "u" && console.warn(o);
25
+ }))(i)), i;
26
+ }
27
+ register(e, r, i = {}) {
28
+ if (this._disposed) return { ok: false, action: "rejected", reason: "disposed" };
29
+ if (typeof e != "string" || e.length === 0) return { ok: false, action: "rejected", reason: "invalid-key" };
30
+ const s = i.origin ?? "user";
31
+ if (isReserved(e) && s !== "builtin") return { ok: false, action: "rejected", reason: "reserved-namespace", warning: this._warn(e, `reserved namespace: '${e}' 는 og:* 코어 예약 대역입니다(origin:'builtin' 만 점유).`) };
32
+ if (this._cfg.spi && i.spiVersion !== void 0 && !spiCompatible(this._cfg.spi.version, i.spiVersion)) return { ok: false, action: "rejected", reason: "spi-mismatch", warning: this._warn(e, `SPI major 불일치: '${e}' 선언 ${i.spiVersion}, 코어 ${this._cfg.spi.name}@${this._cfg.spi.version}.`) };
33
+ const n = this._map.get(e);
34
+ return n && !this._resolveConflict(n, i) ? { ok: false, action: "kept", reason: "protected-builtin", warning: this._warn(e, `'${e}' 는 ${n.origin === "builtin" ? "내장(built-in) 보호" : "override 미지정"} — 덮으려면 { override:true }.`) } : (this._map.set(e, buildEntry(e, r, s, i, this._seq++)), { ok: true, action: n ? "replaced" : "added" });
35
+ }
36
+ _resolveConflict(e, r) {
37
+ return e.origin === "builtin" && r.override !== true ? false : this._cfg.duplicatePolicy === "explicit-override" ? r.override === true : true;
38
+ }
39
+ get(e) {
40
+ var _a;
41
+ return (_a = this._map.get(e)) == null ? void 0 : _a.value;
42
+ }
43
+ require(e, r) {
44
+ const i = this.get(e);
45
+ if (i !== void 0) return i;
46
+ if (r !== void 0) return r;
47
+ if (this._cfg.placeholder) return this._cfg.placeholder(e);
48
+ }
49
+ has(e) {
50
+ return this._map.has(e);
51
+ }
52
+ list() {
53
+ return [...this._map.keys()];
54
+ }
55
+ entries() {
56
+ return [...this._map.values()];
57
+ }
58
+ unregister(e) {
59
+ return this._map.delete(e);
60
+ }
61
+ disposePlugin(e) {
62
+ let r = 0;
63
+ for (const [i, s] of this._map) s.pluginId === e && (this._map.delete(i), r++);
64
+ return r;
65
+ }
66
+ dispose() {
67
+ this._map.clear(), this._warned.clear(), this._disposed = true;
68
+ }
69
+ }
70
+ exports.RESERVED_PREFIXES = RESERVED_PREFIXES, exports.TypedRegistry = TypedRegistry, exports.isReserved = isReserved;
71
+ //# sourceMappingURL=Registry-D74ZmdDz.cjs.map