open-grid 1.6.1 → 1.7.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 (134) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/dist/ExportProgressView-BYPw8osg.cjs +2 -0
  3. package/dist/ExportProgressView-Bt5-z7rE.js +2 -0
  4. package/dist/LcpMergeOrderer-CeP6C6G1.cjs +2 -0
  5. package/dist/LcpMergeOrderer-Ebwuir-r.js +2 -0
  6. package/dist/OpenGrid-Bh1NMOcm.cjs +98 -0
  7. package/dist/OpenGrid-CeXt04ho.js +98 -0
  8. package/dist/Registry-CrT46EAO.js +2 -0
  9. package/dist/Registry-DpHOpU5V.cjs +2 -0
  10. package/dist/XlsxChannel-CuOZ3LQz.js +2 -0
  11. package/dist/XlsxChannel-DQHLGend.cjs +2 -0
  12. package/dist/XlsxWorkbookWriter-DixuNGtw.cjs +3 -0
  13. package/dist/XlsxWorkbookWriter-VgbibI0Z.js +3 -0
  14. package/dist/fflate-Cs3txMgg.js +2 -0
  15. package/dist/fflate-G9RAFEgF.cjs +2 -0
  16. package/dist/index-1OXjJmct.js +2 -0
  17. package/dist/index-B5V7e4Xc.js +2 -0
  18. package/dist/index-DbKDox8y.cjs +2 -0
  19. package/dist/index-HaDoF1HM.cjs +2 -0
  20. package/dist/open-grid-react.cjs +1 -27
  21. package/dist/open-grid-react.js +1 -30
  22. package/dist/open-grid-vue.cjs +1 -31
  23. package/dist/open-grid-vue.js +1 -33
  24. package/dist/open-grid.cjs +6 -275
  25. package/dist/open-grid.js +6 -293
  26. package/dist/sinks-BCZFMGQJ.cjs +2 -0
  27. package/dist/sinks-qkBJ5bKn.js +2 -0
  28. package/dist/types/core/CFRenderBridge.d.ts +5 -1
  29. package/dist/types/core/CellEditManager.d.ts +26 -2
  30. package/dist/types/core/CellEventHandler.d.ts +6 -2
  31. package/dist/types/core/ColumnLayout.d.ts +8 -0
  32. package/dist/types/core/DataLayer.d.ts +48 -1
  33. package/dist/types/core/DetailManager.d.ts +43 -2
  34. package/dist/types/core/ExportManager.d.ts +25 -0
  35. package/dist/types/core/FindBarManager.d.ts +6 -2
  36. package/dist/types/core/FlatRowModel.d.ts +61 -3
  37. package/dist/types/core/FooterManager.d.ts +43 -1
  38. package/dist/types/core/FormulaController.d.ts +4 -4
  39. package/dist/types/core/GridComposer.d.ts +11 -1
  40. package/dist/types/core/GridRenderer.d.ts +84 -19
  41. package/dist/types/core/GroupTreeManager.d.ts +6 -4
  42. package/dist/types/core/KeyboardManager.d.ts +3 -2
  43. package/dist/types/core/MutationService.d.ts +10 -8
  44. package/dist/types/core/OpenGrid.d.ts +7 -5
  45. package/dist/types/core/RangeSelectionManager.d.ts +23 -2
  46. package/dist/types/core/RenderController.d.ts +126 -8
  47. package/dist/types/core/SortFilterManager.d.ts +10 -2
  48. package/dist/types/core/VirtualScroll.d.ts +12 -0
  49. package/dist/types/core/coordinate/CellTextPolicy.d.ts +58 -0
  50. package/dist/types/core/coordinate/ColumnGeometry.d.ts +60 -0
  51. package/dist/types/core/coordinate/ColumnWindow.d.ts +40 -0
  52. package/dist/types/core/coordinate/ColumnWindowPolicy.d.ts +89 -0
  53. package/dist/types/core/coordinate/ExtraColumns.d.ts +39 -0
  54. package/dist/types/core/coordinate/RangeRectCalculator.d.ts +35 -0
  55. package/dist/types/core/coordinate/ViewportHeightJudge.d.ts +28 -0
  56. package/dist/types/core/coordinate/geometryPorts.d.ts +250 -0
  57. package/dist/types/core/coordinate/ports.d.ts +5 -0
  58. package/dist/types/core/domain/footer/FooterValues.d.ts +50 -0
  59. package/dist/types/core/domain/footer/ports.d.ts +31 -0
  60. package/dist/types/core/domain/render/RenderPlanner.d.ts +17 -0
  61. package/dist/types/core/domain/render/RenderRequest.d.ts +91 -0
  62. package/dist/types/core/domain/render/ports.d.ts +169 -0
  63. package/dist/types/core/domain/resize/ResizeGesture.d.ts +25 -0
  64. package/dist/types/core/domain/resize/ResizeHitZone.d.ts +23 -0
  65. package/dist/types/core/domain/resize/ports.d.ts +64 -0
  66. package/dist/types/core/domain/sort/ComparisonOrderer.d.ts +11 -0
  67. package/dist/types/core/domain/sort/LcpMergeOrderer.d.ts +15 -0
  68. package/dist/types/core/domain/sort/RankIndex.d.ts +74 -0
  69. package/dist/types/core/domain/sort/SortCostEstimate.d.ts +36 -0
  70. package/dist/types/core/domain/sort/SortKeyColumn.d.ts +89 -0
  71. package/dist/types/core/domain/sort/SortKeyStore.d.ts +34 -0
  72. package/dist/types/core/domain/sort/Sorter.d.ts +54 -0
  73. package/dist/types/core/domain/sort/SyncSortRunner.d.ts +9 -0
  74. package/dist/types/core/domain/sort/commonPrefix.d.ts +5 -0
  75. package/dist/types/core/domain/sort/ports.d.ts +140 -0
  76. package/dist/types/core/export/ExportProgressView.d.ts +28 -0
  77. package/dist/types/core/export/channels/XlsxChannel.d.ts +38 -1
  78. package/dist/types/core/export/channels/XlsxRichTextRun.d.ts +14 -0
  79. package/dist/types/core/export/channels/XlsxSheetXml.d.ts +19 -0
  80. package/dist/types/core/export/channels/XlsxStyleEntries.d.ts +80 -0
  81. package/dist/types/core/export/channels/XlsxStylesRegistry.d.ts +20 -0
  82. package/dist/types/core/export/channels/XlsxWorkbookWriter.d.ts +20 -0
  83. package/dist/types/core/export/channels/XlsxXml.d.ts +6 -0
  84. package/dist/types/core/export/index.d.ts +2 -0
  85. package/dist/types/core/export/sinks.d.ts +81 -0
  86. package/dist/types/core/export/types.d.ts +63 -0
  87. package/dist/types/core/host/archCheck.d.ts +16 -1
  88. package/dist/types/core/i18n/locales/en.d.ts +6 -0
  89. package/dist/types/core/i18n/locales/ko.d.ts +6 -0
  90. package/dist/types/core/i18n/types.d.ts +8 -0
  91. package/dist/types/core/render/FooterView.d.ts +121 -0
  92. package/dist/types/core/render/GeometryApplier.d.ts +55 -0
  93. package/dist/types/core/render/HorizontalReveal.d.ts +26 -0
  94. package/dist/types/core/render/RangeOverlayAdapter.d.ts +10 -0
  95. package/dist/types/core/render/RenderScheduler.d.ts +225 -0
  96. package/dist/types/core/render/ResizeSinkAdapter.d.ts +35 -0
  97. package/dist/types/core/render/ScrollFollower.d.ts +34 -0
  98. package/dist/types/core/render/ScrollObserver.d.ts +47 -0
  99. package/dist/types/core/render/ScrollbarGutter.d.ts +19 -0
  100. package/dist/types/core/render/body/BodyEventRouter.d.ts +58 -0
  101. package/dist/types/core/render/body/BodyRowSet.d.ts +28 -0
  102. package/dist/types/core/render/body/BodyView.d.ts +185 -0
  103. package/dist/types/core/render/body/CellLocator.d.ts +36 -0
  104. package/dist/types/core/render/body/CellRegistry.d.ts +24 -0
  105. package/dist/types/core/render/body/ColumnPaintPlan.d.ts +19 -0
  106. package/dist/types/core/render/body/ExtraCellPainters.d.ts +20 -0
  107. package/dist/types/core/render/body/rows/BodyRowContext.d.ts +138 -0
  108. package/dist/types/core/render/body/rows/DataRowPainter.d.ts +58 -0
  109. package/dist/types/core/render/body/rows/DetailRowPainter.d.ts +24 -0
  110. package/dist/types/core/render/body/rows/GroupRowPainter.d.ts +32 -0
  111. package/dist/types/core/render/body/rows/RowPainterTable.d.ts +24 -0
  112. package/dist/types/core/render/body/rows/WindowLayout.d.ts +38 -0
  113. package/dist/types/core/render/dom.d.ts +10 -0
  114. package/dist/types/core/render/header/HeaderSortIndicator.d.ts +39 -0
  115. package/dist/types/core/render/header/HeaderView.d.ts +84 -0
  116. package/dist/types/core/render/header/ResizeHandleBinder.d.ts +110 -0
  117. package/dist/types/core/render/ports.d.ts +218 -0
  118. package/dist/types/core/renderers/CellRenderer.d.ts +7 -0
  119. package/dist/types/core/types.d.ts +94 -0
  120. package/dist/types/index.d.ts +1 -0
  121. package/dist/types/vue/OpenGrid.vue.d.ts +1 -1
  122. package/dist/xlsx.min-CMvrM6b4.cjs +138 -0
  123. package/dist/xlsx.min-i_b-4PvU.js +138 -0
  124. package/package.json +3 -8
  125. package/dist/OpenGrid-CLk8Vt7j.cjs +0 -7459
  126. package/dist/OpenGrid-D6YxCsnV.js +0 -7472
  127. package/dist/Registry-CPJYOqCn.js +0 -74
  128. package/dist/Registry-D74ZmdDz.cjs +0 -71
  129. package/dist/index-CeJ-0-80.cjs +0 -260
  130. package/dist/index-D0DJtKYI.cjs +0 -452
  131. package/dist/index-DnarQ4eR.js +0 -266
  132. package/dist/index-VkKgQ506.js +0 -481
  133. package/dist/xlsx.min-BQ1o3sB6.cjs +0 -11793
  134. package/dist/xlsx.min-Bbz2ZypC.js +0 -11794
@@ -0,0 +1,89 @@
1
+ import { ISortKeyColumn, SortComparator, SortDir } from './ports.js';
2
+ /**
3
+ * 기본 단일 키 비교 — 그리드가 처음부터 써 온 규칙 그대로다.
4
+ * null/undefined 가 먼저, 둘 다 숫자면 뺄셈, 나머지는 String() 으로 바꿔 UTF-16 코드 단위 순.
5
+ * 모듈 상수로 둔 까닭: 덮어쓴 비교자가 이것과 같은 함수인지(===) 보고 빠른 길을 고를 수 있게 하려는 것.
6
+ *
7
+ * The built-in single-key comparison, exactly as the grid has always done it: null/undefined first,
8
+ * numeric subtraction when both are numbers, otherwise String() compared by UTF-16 code units.
9
+ * It is a module constant so a resolved override can be recognised by identity (===).
10
+ */
11
+ export declare const DEFAULT_SORT_COMPARATOR: SortComparator;
12
+ /**
13
+ * 키 열의 뼈대. 어떤 구현을 쓸지는 build 한 곳에서만 고른다(부르는 쪽이 종류를 조건문으로 가르지 않게).
14
+ *
15
+ * Base of the key-column strategies; build() is the single place that picks an implementation,
16
+ * so callers never branch on the kind themselves.
17
+ */
18
+ export declare abstract class SortKeyColumn implements ISortKeyColumn {
19
+ abstract readonly field: string;
20
+ abstract readonly kind: ISortKeyColumn['kind'];
21
+ abstract readonly cacheable: boolean;
22
+ abstract compare(i: number, j: number): number;
23
+ abstract stringKeyAt(i: number): string | null;
24
+ /**
25
+ * 한 컬럼의 키 열을 만든다. values[i] = 모델 행 i 의 값(한 번만 읽어 넘긴 것).
26
+ * dir 은 비교자에 그대로 넘기는 정렬 방향이다 — 옛 비교 고리가 사용자 비교자에 (a, b, field, dir) 를
27
+ * 넘겼으므로 덮어쓴 비교자가 dir 을 읽어도 같은 값을 받게 한다. 비교 결과 자체는 늘 오름차순 뜻이고,
28
+ * 내림차순 뒤집기는 순서 매기기 쪽이 한다. 방향이 빠진 정렬 목록이면 undefined 를 그대로 넘긴다(옛 고리와 같음 —
29
+ * 순서는 「asc 가 아니면 뒤집음」이라 내림차순인데, 기본값을 채우면 비교자만 「asc」라고 듣게 된다).
30
+ *
31
+ * Builds the key column for one field; values[i] is model row i's value, read once.
32
+ * dir is forwarded to the comparator unchanged, because the legacy loop passed (a, b, field, dir)
33
+ * and an override may read it. The result of compare() is always in ascending sense; the orderer flips it.
34
+ * A missing dir is passed on as undefined, as before — no default is filled in.
35
+ */
36
+ static build(field: string, values: readonly unknown[], cmp: SortComparator, isDefaultCmp: boolean, dir?: SortDir): SortKeyColumn;
37
+ }
38
+ /**
39
+ * 옛 비교자를 그대로 부르는 키 열. 섞인 열·사용자 비교자·비교가 일관되지 않는 값(NaN 등)이 오는 자리.
40
+ * 비교마다 행에서 값을 다시 꺼내지 않도록 값 배열만 들고, 비교는 그 배열의 두 칸을 비교자에 넘긴다.
41
+ *
42
+ * Key column that calls the legacy comparator as-is — used for mixed columns, user comparators and
43
+ * values the comparator does not order consistently (NaN …). It holds the extracted value array so
44
+ * a comparison never goes back to the row objects.
45
+ */
46
+ export declare class GeneralKeyColumn extends SortKeyColumn {
47
+ readonly field: string;
48
+ private readonly _values;
49
+ private readonly _cmp;
50
+ private readonly _dir;
51
+ readonly kind: "general";
52
+ readonly cacheable: boolean;
53
+ constructor(field: string, _values: readonly unknown[], _cmp: SortComparator, _dir: SortDir | undefined);
54
+ compare(i: number, j: number): number;
55
+ stringKeyAt(_i: number): string | null;
56
+ }
57
+ /**
58
+ * 숫자만 든 열. 키를 Float64Array 에, 빈 값(null/undefined)을 따로 표시해 두고 비교는 두 칸 뺄셈뿐이다.
59
+ * 옛 비교자와 같은 값을 돌려준다: 빈 값끼리 0, 빈 값이 앞, 나머지는 a - b(−0 과 0 은 같음).
60
+ *
61
+ * Numbers-only column: keys in a Float64Array plus an empty-value mark; compare() returns exactly what the
62
+ * legacy comparator returned (empties equal and first, otherwise a - b, so −0 equals 0).
63
+ */
64
+ export declare class NumberKeyColumn extends SortKeyColumn {
65
+ readonly field: string;
66
+ readonly kind: "number";
67
+ readonly cacheable = true;
68
+ private readonly _keys;
69
+ private readonly _empty;
70
+ constructor(field: string, values: readonly unknown[]);
71
+ compare(i: number, j: number): number;
72
+ stringKeyAt(_i: number): string | null;
73
+ }
74
+ /**
75
+ * 글자만 든 열. String() 을 행마다 한 번만 불러 키를 들고, 비교는 UTF-16 코드 단위 사전순(옛 비교자와 같음).
76
+ * 빈 값(null/undefined)은 키 null 로 두고 앞에 온다. 긴 공통 머리말 정렬이 쓰도록 키를 그대로 내준다.
77
+ *
78
+ * Strings-only column: String() runs once per row; compare() is UTF-16 code-unit order like the legacy
79
+ * comparator, with empties (key null) first. stringKeyAt() exposes the key for prefix-aware orderers.
80
+ */
81
+ export declare class StringKeyColumn extends SortKeyColumn {
82
+ readonly field: string;
83
+ readonly kind: "string";
84
+ readonly cacheable = true;
85
+ private readonly _keys;
86
+ constructor(field: string, values: readonly unknown[]);
87
+ compare(i: number, j: number): number;
88
+ stringKeyAt(i: number): string | null;
89
+ }
@@ -0,0 +1,34 @@
1
+ import { IRowSource, ISortKeyColumn, ISortKeyStore, SortComparator, SortDir, SortSpec } from './ports.js';
2
+ /**
3
+ * 행 원천에서 정렬할 행의 한 컬럼 값을 한 번 읽어 키 열을 만들고, 보관할 수 있으면 들고 있다.
4
+ *
5
+ * Reads one field of the rows being sorted once, builds its key column, and keeps it when that is safe.
6
+ */
7
+ export declare class SortKeyStore implements ISortKeyStore {
8
+ private readonly _source;
9
+ private readonly _kept;
10
+ constructor(_source: IRowSource);
11
+ /** 진단: 지금 보관 중인 컬럼 수. / Diagnostic: number of columns currently kept. */
12
+ get size(): number;
13
+ /**
14
+ * @param start 이번 정렬의 출발 순서. 생략하면 원천의 지금 표시 순서 / this sort's start order; defaults to the source's display order
15
+ */
16
+ keyColumnFor(spec: SortSpec, cmp: SortComparator, start?: readonly number[]): ISortKeyColumn;
17
+ /**
18
+ * 정렬이 끝났다는 알림. key 가 이 저장소가 내준(보관 중인) 키 열이면 결과 순서만 기억해 둔다 — 등수는
19
+ * 같은 컬럼을 다시 정렬할 때 매긴다(첫 정렬에 이웃 비교 n 번을 더 치르지 않으려고).
20
+ *
21
+ * Notification that a sort finished. If key is a column this store handed out and keeps, only the order is
22
+ * remembered; ranks are taken on the next sort of the same column, so the first sort pays nothing extra.
23
+ */
24
+ noteSorted(key: ISortKeyColumn, sorted: ArrayLike<number>, dir: SortDir | undefined): void;
25
+ clear(): void;
26
+ /**
27
+ * 낡지 않은 보관분을 다시 쓴다 — 지난 정렬 결과를 알면 거기서 등수를 매겨(이웃 비교 n 번) 등수 키 열로,
28
+ * 등수가 이번에 정렬할 행을 다 덮지 못하면(필터가 풀려 행이 늘어난 경우 등) 뽑아 둔 키 열 그대로.
29
+ *
30
+ * Reuses a fresh entry: ranks are taken from the last sort result (n neighbour comparisons) and handed out as
31
+ * a ranked column; if they do not cover every row to sort now (e.g. a filter was lifted), the kept key column.
32
+ */
33
+ private _reuse;
34
+ }
@@ -0,0 +1,54 @@
1
+ import { IRowSource, ISorter, ISortKeyColumn, ISortKeyStore, ISortOrderer, ISortRunner, SortComparator, SortJob, SortSpec } from './ports.js';
2
+ /** 따로 내려받는 조각이 내놓는 것 — 머리말 기억 정렬과 그것을 고르는 비용 어림. / What the lazily loaded chunk provides. */
3
+ export interface PrefixSortChunk {
4
+ readonly LcpMergeOrderer: new () => ISortOrderer;
5
+ readonly SortCostEstimate: {
6
+ pickOrderer(orderers: readonly ISortOrderer[], keys: readonly ISortKeyColumn[], start: readonly number[]): ISortOrderer;
7
+ };
8
+ }
9
+ /** 생성 옵션. / Construction options. */
10
+ export interface SorterOptions {
11
+ /** 머리말 기억 정렬 조각을 내려받는 함수(없으면 비교 정렬만). / Loader for the prefix-sort chunk (none: comparison only). */
12
+ readonly loadPrefixSort?: () => Promise<PrefixSortChunk>;
13
+ }
14
+ /**
15
+ * 정렬 파사드. sortNow 는 늘 동기로 끝난 순서를 돌려준다(orderBy 의 공개 뜻).
16
+ *
17
+ * Sorting facade; sortNow always returns a finished order synchronously (orderBy's public meaning).
18
+ */
19
+ export declare class Sorter implements ISorter {
20
+ private readonly _source;
21
+ private readonly _store;
22
+ private readonly _sync;
23
+ /** 진단: 마지막 정렬이 쓴 순서 매기기의 이름표. / Diagnostic: id of the orderer used by the last sort. */
24
+ lastOrdererId: string;
25
+ /** 머리말 정렬 조각 받기가 끝나면(실패 포함) 풀리는 약속 — 시험·진단용. / Settles once the chunk load ends (incl. failure). */
26
+ prefixSortReady: Promise<void>;
27
+ private _orderers;
28
+ private _pick;
29
+ private _load;
30
+ /**
31
+ * @param source 행 원천(원 자료 + 지금 표시 순서) / row source (data + current display order)
32
+ * @param store 키 열을 주는 곳 / key-column store
33
+ * @param orderers 순서 매기기 후보(받아 주는 첫 전략을 씀 — 조각이 오면 비용 어림이 고름) / candidate orderers
34
+ * @param sync 한 번에 끝내는 실행기 / run-to-completion runner
35
+ * @param opts 머리말 정렬 조각 로더 / prefix-sort chunk loader
36
+ */
37
+ constructor(_source: IRowSource, _store: ISortKeyStore, orderers: readonly ISortOrderer[], _sync: ISortRunner, opts?: SorterOptions);
38
+ /**
39
+ * @param start 출발 순서. 생략하면 원천의 지금 표시 순서(원천을 쥐고 직접 부르는 쪽의 편의 — 표시 순서의 주인은 늘 넘긴다)
40
+ * / start order; defaults to the source's current display order (the display-order owner always passes it)
41
+ */
42
+ sortNow(specs: readonly SortSpec[], cmp: SortComparator, start?: readonly number[]): readonly number[];
43
+ sortInteractive(specs: readonly SortSpec[], cmp: SortComparator, start?: readonly number[]): SortJob;
44
+ private _start;
45
+ private _ordererFor;
46
+ /**
47
+ * 글자 키 하나로 큰 표를 정렬할 때 처음 한 번만 머리말 정렬 조각을 부른다. 이번 정렬은 기다리지 않는다.
48
+ * 받기에 실패하면 비교 정렬로 계속(결과는 같고 느릴 뿐).
49
+ *
50
+ * Fetches the prefix-sort chunk once, on the first large single-string-key sort; this sort does not wait.
51
+ * A failed fetch keeps the comparison sort (same result, only slower).
52
+ */
53
+ private _fetchPrefixSortIfUseful;
54
+ }
@@ -0,0 +1,9 @@
1
+ import { ISortKeyColumn, ISortOrderer, ISortRunner, SortDir, SortJob } from './ports.js';
2
+ /**
3
+ * 부른 자리에서 순서 매기기를 한 번 부르고 끝난 작업을 돌려준다. 순서는 매기지 않는다(전략에 맡김).
4
+ *
5
+ * Calls the orderer once, synchronously, and returns a finished job; ordering itself is the orderer's job.
6
+ */
7
+ export declare class SyncSortRunner implements ISortRunner {
8
+ run(start: readonly number[], keys: readonly ISortKeyColumn[], dirs: readonly SortDir[], orderer: ISortOrderer): SortJob;
9
+ }
@@ -0,0 +1,5 @@
1
+ /**
2
+ * a, b 의 공통 머리말 길이. h 글자까지는 같다고 이미 안다(그 다음부터 센다).
3
+ * Common prefix length of a and b, counting from h (the first h characters are known equal).
4
+ */
5
+ export declare function commonPrefix(a: string, b: string, h: number): number;
@@ -0,0 +1,140 @@
1
+ /** DataLayer 가 구현. 정렬 출발점 = 지금 표시 순서(삭제 행 제외) — 안정 정렬의 「직전 순서」 보존. */
2
+ export interface IRowSource<T = unknown> {
3
+ /** 원 자료(읽기 전용 뷰 — 복사 아님). */
4
+ readonly rows: readonly T[];
5
+ displayOrder(): readonly number[];
6
+ }
7
+ export type SortDir = 'asc' | 'desc';
8
+ export interface SortSpec {
9
+ readonly field: string;
10
+ readonly dir: SortDir;
11
+ }
12
+ /** 지금 applySort 의 비교자 꼴(OverrideKernel 'sortComparator' 슬롯과 같은 서명). */
13
+ /** 정렬 목록에 방향이 빠지면 dir 은 undefined 로 온다(채우지 않는다 — 옛 고리와 같음). */
14
+ export type SortComparator = (a: unknown, b: unknown, field: string, dir: SortDir | undefined) => number;
15
+ /** 시간 자르기 포트(rAF/MessageChannel 은 구현, 시험은 가짜 시계). */
16
+ export interface ITaskScheduler {
17
+ now(): number;
18
+ next(cb: () => void): number;
19
+ cancel(id: number): void;
20
+ }
21
+ /**
22
+ * ① 키 뽑기 — 한 컬럼의 값을 비교 가능한 키로 한 번 뽑아 둔다.
23
+ * 구현: NumberKeyColumn(Float64Array + null 표지) / StringKeyColumn(String() 한 번) / GeneralKeyColumn(지금 비교자 그대로).
24
+ * 불변: compare 의 부호는 DEFAULT_SORT_COMPARATOR(오름차순, null/undefined 먼저)와 같다.
25
+ * 옛 비교자가 일관되지 않는 값(NaN 이 섞인 숫자 열 등 — 비교 결과가 NaN)이 있으면 Number/String 키 열을 만들지 않고
26
+ * GeneralKeyColumn 으로 떨어지며, ComparisonOrderer 는 그 경우 **같은 출발 배열에 옛 비교자를 그대로 넘겨 Array.prototype.sort** 를 부른다
27
+ * → 같은 엔진·같은 입력·같은 비교자라 순서가 지금과 바이트까지 같다.
28
+ */
29
+ export interface ISortKeyColumn {
30
+ readonly field: string;
31
+ readonly kind: 'number' | 'string' | 'general' | 'ranked';
32
+ /** 원시값만 보관 가능(Date 등 객체 값은 false — 제자리 수정이 === 를 통과하므로). */
33
+ readonly cacheable: boolean;
34
+ /** 모델 행 번호 i, j 의 오름차순 비교. */
35
+ compare(i: number, j: number): number;
36
+ /** 문자열 키면 그 키(순서 매기기 전략이 머리말 기억·기수 정렬에 쓴다), 아니면 null. */
37
+ stringKeyAt(i: number): string | null;
38
+ }
39
+ /** 등수 보관(값 객체). 같은 값 = 같은 등수. */
40
+ export interface IRankIndex {
41
+ readonly field: string;
42
+ compare(i: number, j: number): number;
43
+ /** O(n) 낡음 검사: 같은 자리의 원시값이 보관값과 === 인가. */
44
+ isFreshFor(rows: readonly unknown[]): boolean;
45
+ }
46
+ /**
47
+ * 등수 보관의 유일한 주인. 무효화 호출을 변경 지점에 흩지 않는다(낡음은 값 검사로).
48
+ * 등수가 순서 매기기에 들어가는 길 — 저장소는 비교 함수가 아니라 **키 열**을 준다.
49
+ * 등수가 있으면 `RankedKeyColumn`(ISortKeyColumn 의 한 구현, 정수 비교·stringKeyAt=null), 없으면 새로 뽑은 Number/String/General 키 열.
50
+ * 그래서 ISortOrderer 는 등수가 있든 없든 같은 입력(ISortKeyColumn[])을 받는다. 같은 값 = 같은 등수라 순서 결과는 같다.
51
+ */
52
+ export interface ISortKeyStore {
53
+ /** 낡았으면 다시 만들고, cacheable 이 아니면 보관하지 않는다. */
54
+ /** start = 이번 정렬의 출발 순서(원 자료 색인). 이 행들의 값만 읽는다. */
55
+ keyColumnFor(spec: SortSpec, cmp: SortComparator, start: readonly number[]): ISortKeyColumn;
56
+ /**
57
+ * 정렬이 끝났다는 알림(선택). key 가 이 저장소가 내준 키 열이면 결과 순서를 기억해 두었다가, 같은 컬럼을 다시 정렬할 때
58
+ * 그 순서에서 등수를 매긴다(이웃 비교 n 번). 첫 키에 대해서만 부른다.
59
+ */
60
+ noteSorted?(key: ISortKeyColumn, sorted: ArrayLike<number>, dir: SortDir | undefined): void;
61
+ /** setData·clearData 때 메모리만 푼다. */
62
+ clear(): void;
63
+ }
64
+ /**
65
+ * ② 순서 매기기 — 출발 순서 + 비교 → 안정 정렬 결과.
66
+ * 구현: ComparisonOrderer(안정 비교 정렬) · LcpMergeOrderer(문자열 키 전용, 표본을 정렬한 뒤 이웃 공통 머리말 평균으로 고름).
67
+ * 불변: 결과 순서 = 출발 순서에서 안정 비교 정렬한 순서(어느 구현이든 같은 결과 — 대조 시험).
68
+ */
69
+ export interface ISortOrderer {
70
+ readonly id: string;
71
+ /** 이 키·행 수에 쓸 수 있나(예: 문자열 키 전용 전략은 general 키면 false). */
72
+ accepts(keys: readonly ISortKeyColumn[], rowCount: number): boolean;
73
+ order(start: readonly number[], keys: readonly ISortKeyColumn[], dirs: readonly SortDir[]): Int32Array;
74
+ }
75
+ /** 진행 중 정렬 하나. onDone 은 많아야 한 번, cancel 뒤엔 안 불림. */
76
+ export interface SortJob {
77
+ readonly done: boolean;
78
+ cancel(): void;
79
+ onDone(cb: (order: Int32Array) => void): void;
80
+ /**
81
+ * 그 자리에서 동기로 끝내고 전체 순서를 돌려준다(이미 끝났으면 그대로).
82
+ * DataLayer 는 **모든 공개 메서드의 첫 줄**에서 미확정이면 이것을 먼저 부른다(예외: 순서와 무관한 메서드).
83
+ * 미확정 중 applySort·applyFilter·setFindFilter·setData·clearData 는 settle 이 아니라 cancel 후 진행.
84
+ */
85
+ settle(): Int32Array;
86
+ /**
87
+ * 「화면 구간 먼저」 실행기만 — 최종 순서의 [start, end) 구간(확정된 값)을 돌려준다. 못 주면 null.
88
+ * 이 구간은 최종 순서와 한 칸도 다르지 않다(대조 시험).
89
+ */
90
+ peekWindow(start: number, end: number): Int32Array | null;
91
+ }
92
+ /**
93
+ * ③ 실행 방식 — 한 번에(SyncSortRunner) / 조각으로(SlicedSortRunner, 지연 청크, 조각 8ms) /
94
+ * 화면 구간 먼저(WindowFirstSortRunner — 조건이 맞을 때만: 구간 고르기(quickselect 두 번) + 구간 정렬 → 나머지는 조각으로).
95
+ * 양보 수단: scheduler.yield() 가 있으면 쓰고 없으면 MessageChannel(ITaskScheduler 구현 안).
96
+ * 구간 먼저 실행기에 넘기는 구간은 run 뒤 setWindow 로 준다.
97
+ */
98
+ export interface ISortRunnerWindowed {
99
+ setWindow(start: number, end: number): void;
100
+ }
101
+ /**
102
+ * 불변: 같은 입력이면 어느 실행기든 같은 순서. 그리드당 진행 중 작업은 많아야 하나(새 작업이 앞 작업 취소).
103
+ */
104
+ export interface ISortRunner {
105
+ run(start: readonly number[], keys: readonly ISortKeyColumn[], dirs: readonly SortDir[], orderer: ISortOrderer): SortJob;
106
+ }
107
+ /** 「얼마나 걸릴까」의 주인. 틀려도 결과는 같고 늦게 끝날 뿐이라 정교할 필요 없다. */
108
+ export interface ISortCostEstimate {
109
+ readonly expectedMs: number;
110
+ prefersSlicing(thresholdMs?: number): boolean;
111
+ }
112
+ /** 조립 파사드 — DataLayer·SortFilterManager 가 아는 것은 이것뿐. / Assembly facade for sorting. */
113
+ export interface ISorter {
114
+ /**
115
+ * orderBy()·applySort 용 — 늘 동기. 사용자 비교자면 general 키로 지금 비교 그대로.
116
+ * start = 출발 순서(표시 순서의 주인이 정렬을 시작할 때 한 번 뽑아 넘김 — 같은 값끼리는 이 순서를 지킨다).
117
+ */
118
+ sortNow(specs: readonly SortSpec[], cmp: SortComparator, start: readonly number[]): readonly number[];
119
+ /** 머리글 누름 — 추정이 문턱(100ms)을 넘으면 나눠서. */
120
+ sortInteractive(specs: readonly SortSpec[], cmp: SortComparator, start: readonly number[]): SortJob;
121
+ }
122
+ /**
123
+ * 그리기 전용 접근자(DataLayer 가 구현, 내부 — 공개 API 아님). 첫 화면을 settle 없이 그릴 수 있는 유일한 길.
124
+ * 미확정이면 peekWindow 로 받은 [s, e) 안은 확정 구간에서, 밖은 settle 후. 쓰는 곳: 본문 그리개 · FlatRowModel.resolveForPaint 만.
125
+ */
126
+ export interface IPaintRowSource<T = unknown> {
127
+ paintRowAt(viewIndex: number): T | undefined;
128
+ paintRowStateAt(viewIndex: number): string;
129
+ /** 진단: 지금까지 settle 이 실제로 일어난 횟수(시험 「첫 프레임 settle 0」). */
130
+ readonly settleCount: number;
131
+ /** 진단: 지금 미확정 정렬이 있나. */
132
+ readonly pending: boolean;
133
+ }
134
+ /**
135
+ * 시험 이음새(내부) — Sorter 생성자 옵션. 실행기 고르기를 작은 자료에서도 강제한다. 기본 undefined(비용 추정으로 고름).
136
+ * 'windowFirst' = WindowFirstSortRunner. 헤드리스 파일이라 DOM 전역 이름과 같은 낱말('window')을 값으로 쓰지 않는다.
137
+ */
138
+ export interface SorterTestOptions {
139
+ readonly forceRunner?: 'sync' | 'sliced' | 'windowFirst';
140
+ }
@@ -0,0 +1,28 @@
1
+ type Translate = (key: string, params?: Record<string, string | number>) => string;
2
+ /** 진척바 생성 옵션. / Options for the progress view. */
3
+ export interface ExportProgressViewOptions {
4
+ /** i18n 해석기(미주입 시 영문 기본 문구). / i18n resolver (English fallback when absent). */
5
+ t?: Translate | undefined;
6
+ /** 취소 단추 콜백. / Cancel button callback. */
7
+ onCancel?: () => void;
8
+ }
9
+ export declare class ExportProgressView {
10
+ private readonly opts;
11
+ private _root;
12
+ private _bar;
13
+ private _text;
14
+ private _btn;
15
+ private _closed;
16
+ private _failed;
17
+ private _prevFocus;
18
+ constructor(opts?: ExportProgressViewOptions);
19
+ private _t;
20
+ /** 진행 갱신. / Update progress. */
21
+ update(done: number, total: number): void;
22
+ /** 오류 표시(취소 단추는 닫기 역할로 바뀐다). / Show an error; the button becomes a close button. */
23
+ fail(message?: string): void;
24
+ /** 닫기. 여러 번 불러도 안전. / Close; idempotent. */
25
+ close(): void;
26
+ get isOpen(): boolean;
27
+ }
28
+ export {};
@@ -1,4 +1,4 @@
1
- import { ChannelCapabilities, ExportResult, ExportRunCtx, IArtifactSource, IByteSink } from '../types.js';
1
+ import { ChannelCapabilities, ExportResult, ExportRunCtx, IArtifactSource, IByteSink, XlsxCellStyleSpec, XlsxRichTextRun } from '../types.js';
2
2
  /** 순수 셀 모델(값 + 상류 확정 스타일). / Pure cell model (value + upstream-confirmed style). */
3
3
  export interface SheetCell {
4
4
  /** 표시값(= CellArtifact.text). / Display value. */
@@ -10,6 +10,12 @@ export interface SheetCell {
10
10
  /** 채움 위 잉크색(= cf.inkColor). / Ink color from cf.inkColor. */
11
11
  readonly ink?: string;
12
12
  readonly align: 'left' | 'right' | 'center';
13
+ /** 미리 등록한 스타일 번호(session.addStyle 반환값). 있으면 그대로 쓴다. / Pre-registered style index; used as-is when present. */
14
+ readonly s?: number;
15
+ /** 셀 스타일 명세(쓰기기가 등록·중복 제거). / Cell style spec (registered and de-duplicated by the writer). */
16
+ readonly style?: XlsxCellStyleSpec;
17
+ /** 셀 안 서식 조각(있으면 글자 대신 이 조각들을 쓴다). / In-cell rich-text runs (replace the plain text when present). */
18
+ readonly runs?: ReadonlyArray<XlsxRichTextRun>;
13
19
  readonly rowSpan: number;
14
20
  readonly colSpan: number;
15
21
  }
@@ -35,10 +41,35 @@ export interface IWorkbookWriter {
35
41
  /** SheetModel → 바이트(sink 로 기록). / SheetModel → bytes (written to sink). */
36
42
  write(model: SheetModel, sink: IByteSink): Promise<number>;
37
43
  }
44
+ /** 스트리밍 시트 개시 정보. / Streaming sheet init info. */
45
+ export interface XlsxStreamInit {
46
+ readonly sheetName: string;
47
+ readonly header: ReadonlyArray<string>;
48
+ readonly colWidthsPx: ReadonlyArray<number>;
49
+ /** false 면 머리글 행을 쓰지 않는다(기본 true). / false omits the header row (default true). */
50
+ readonly includeHeader?: boolean;
51
+ }
52
+ /** 스트리밍 쓰기 세션(행 청크 단위). / Streaming write session (row-chunk granularity). */
53
+ export interface IXlsxStreamSession {
54
+ /** 행 청크 추가(sink 쓰기를 await = 백프레셔). / Append a row chunk (awaits sink writes). */
55
+ appendRows(rows: ReadonlyArray<ReadonlyArray<SheetCell>>, merges?: ReadonlyArray<MergeRegion>): Promise<void>;
56
+ /** 스타일 등록 후 번호 반환(같은 조합은 같은 번호). / Register a style and return its index (equal combos share one). */
57
+ addStyle?(spec: XlsxCellStyleSpec): number;
58
+ /** 마무리(총 바이트 반환). sink.close 는 호출자 몫. / Finish; returns total bytes (caller closes sink). */
59
+ finish(): Promise<number>;
60
+ /** 중단(이후 쓰기 없음). / Abort. */
61
+ abort(): void;
62
+ }
63
+ /** 스트리밍 가능한 쓰기기 SPI. / Streaming-capable writer SPI. */
64
+ export interface IStreamingWorkbookWriter extends IWorkbookWriter {
65
+ openStream(init: XlsxStreamInit, sink: IByteSink): Promise<IXlsxStreamSession>;
66
+ }
38
67
  /** xlsx 채널 옵션. / xlsx channel options. */
39
68
  export interface XlsxChannelOptions {
40
69
  readonly sheetName?: string;
41
70
  readonly includeProvenance?: boolean;
71
+ /** 스트리밍: false 면 머리글 행 제외(기본 true). / Streaming: false omits the header row (default true). */
72
+ readonly includeHeader?: boolean;
42
73
  }
43
74
  /** xlsx 직렬화 전략(순수 접기 + 주입 인코더). / xlsx serialization strategy (pure fold + injected writer). */
44
75
  export declare class XlsxChannel {
@@ -50,4 +81,10 @@ export declare class XlsxChannel {
50
81
  /** 순수: 소스 → SheetModel(파리티 골든 대상). / Pure: source → SheetModel (parity golden target). */
51
82
  buildModel(source: IArtifactSource, ctx?: ExportRunCtx): Promise<SheetModel>;
52
83
  write(source: IArtifactSource, sink: IByteSink, ctx?: ExportRunCtx): Promise<ExportResult>;
84
+ /**
85
+ * 스트리밍 쓰기: 전 행을 적재하지 않고 청크 단위로 writer 에 흘린다(머리글 먼저).
86
+ * 취소(ctx.signal)·진척(ctx.onProgress)·백프레셔(sink.write await) 지원. 기존 write 는 불변.
87
+ * / Streaming write: flows row chunks to the writer without materializing all rows.
88
+ */
89
+ writeStreaming(source: IArtifactSource, sink: IByteSink, ctx?: ExportRunCtx): Promise<ExportResult>;
53
90
  }
@@ -0,0 +1,14 @@
1
+ import { XlsxRichTextRun } from '../types.js';
2
+ import { FontEntry } from './XlsxStyleEntries.js';
3
+ /** 셀 안 서식 조각. / One in-cell run. */
4
+ export declare class RichTextRunEntry {
5
+ readonly text: string;
6
+ readonly font: FontEntry | undefined;
7
+ private constructor();
8
+ /** DTO 한 토막 → 값 객체(글자가 비면 undefined). / DTO run → entry (undefined when the text is empty). */
9
+ static from(run: XlsxRichTextRun): RichTextRunEntry | undefined;
10
+ /** DTO 목록 → 값 객체 목록(빈 토막은 버린다). / DTO list → entries (empty runs dropped). */
11
+ static fromAll(runs: ReadonlyArray<XlsxRichTextRun>): RichTextRunEntry[];
12
+ /** `<r>` 한 조각. / One `<r>` fragment. */
13
+ toXml(): string;
14
+ }
@@ -0,0 +1,19 @@
1
+ import { MergeRegion, SheetCell, XlsxStreamInit } from './XlsxChannel.js';
2
+ import { StylesRegistry } from './XlsxStylesRegistry.js';
3
+ /** 시트 XML 조립기. / Sheet XML builder. */
4
+ export declare class SheetXmlBuilder {
5
+ private readonly init;
6
+ private readonly styles;
7
+ private nextRow;
8
+ private readonly merges;
9
+ private readonly writeHeader;
10
+ constructor(init: XlsxStreamInit, styles: StylesRegistry);
11
+ /** 시트 머리(열 너비·머리글 행 포함). / Sheet head (column widths + header row). */
12
+ head(): string;
13
+ /** 행 청크 → XML(빈 청크면 빈 문자열). / Row chunk → XML (empty string for an empty chunk). */
14
+ rows(rows: ReadonlyArray<ReadonlyArray<SheetCell>>, rowMerges?: ReadonlyArray<MergeRegion>): string;
15
+ /** 시트 꼬리(병합 영역 포함). / Sheet tail (with merge regions). */
16
+ tail(): string;
17
+ /** 셀 → 스타일 번호(미리 준 번호 > 명세 > 색 필드 > 줄무늬). / Cell → style index. */
18
+ private styleIndex;
19
+ }
@@ -0,0 +1,80 @@
1
+ import { XlsxCellStyleSpec } from '../types.js';
2
+ /** 풀에 담기는 항목의 공통 약속. / Contract shared by pooled entries. */
3
+ export interface IStyleEntry {
4
+ /** 같은 내용이면 같은 문자열. / Equal content → equal string. */
5
+ hashKey(): string;
6
+ /** XML 한 조각. / One XML fragment. */
7
+ toXml(): string;
8
+ }
9
+ /** 색 문자열(#rgb·#rrggbb·rgb()·RRGGBB·AARRGGBB) → AARRGGBB 대문자. 못 읽으면 undefined. / Normalize to AARRGGBB; undefined if unreadable. */
10
+ export declare function argb(c: string | undefined): string | undefined;
11
+ /** 글꼴 항목. / Font entry. */
12
+ export declare class FontEntry implements IStyleEntry {
13
+ readonly bold: boolean;
14
+ readonly italic: boolean;
15
+ readonly color: string | undefined;
16
+ readonly size: number;
17
+ constructor(bold: boolean, italic: boolean, color: string | undefined, size?: number);
18
+ /** 기본 글꼴(굵기·기울임·색 없음). / The plain default font. */
19
+ static plain(): FontEntry;
20
+ /** 명세에서 글꼴이 필요하면 만든다. / Build when the spec asks for a font. */
21
+ static from(spec: XlsxCellStyleSpec): FontEntry | undefined;
22
+ /** 셀 안 조각용 글꼴(명세가 비면 undefined). / Font for an in-cell run (undefined when the spec is empty). */
23
+ static fromRun(style: {
24
+ color?: {
25
+ rgb: string;
26
+ };
27
+ bold?: boolean;
28
+ italic?: boolean;
29
+ size?: number;
30
+ } | undefined): FontEntry | undefined;
31
+ hashKey(): string;
32
+ equals(o: FontEntry): boolean;
33
+ toXml(): string;
34
+ /** 셀 안 조각의 `<rPr>`. / The `<rPr>` of an in-cell run. */
35
+ toRunPropsXml(): string;
36
+ }
37
+ /** 채움 항목. / Fill entry. */
38
+ export declare class FillEntry implements IStyleEntry {
39
+ private readonly pattern;
40
+ readonly color: string | undefined;
41
+ private constructor();
42
+ static none(): FillEntry;
43
+ static gray125(): FillEntry;
44
+ static solid(color: string): FillEntry;
45
+ static from(spec: XlsxCellStyleSpec): FillEntry | undefined;
46
+ hashKey(): string;
47
+ equals(o: FillEntry): boolean;
48
+ toXml(): string;
49
+ }
50
+ /** 테두리 항목(사방 같은 선). / Border entry (same line on all four sides). */
51
+ export declare class BorderEntry implements IStyleEntry {
52
+ private readonly style;
53
+ private readonly color;
54
+ constructor(style: string | undefined, color: string | undefined);
55
+ static none(): BorderEntry;
56
+ static from(spec: XlsxCellStyleSpec): BorderEntry | undefined;
57
+ hashKey(): string;
58
+ equals(o: BorderEntry): boolean;
59
+ toXml(): string;
60
+ }
61
+ /** 사용자 숫자 서식 항목(번호는 등록소가 매긴다). / Custom number-format entry (id assigned by the registry). */
62
+ export declare class NumFmtEntry implements IStyleEntry {
63
+ readonly code: string;
64
+ readonly id: number;
65
+ constructor(code: string, id: number);
66
+ /** 내장 서식이면 그 번호, 아니면 undefined. / Built-in id, or undefined. */
67
+ static builtinId(code: string): number | undefined;
68
+ hashKey(): string;
69
+ equals(o: NumFmtEntry): boolean;
70
+ toXml(): string;
71
+ }
72
+ /** 가로 정렬 항목. / Horizontal-alignment entry. */
73
+ export declare class AlignmentEntry implements IStyleEntry {
74
+ readonly horizontal: string;
75
+ constructor(horizontal: string);
76
+ static from(spec: XlsxCellStyleSpec): AlignmentEntry | undefined;
77
+ hashKey(): string;
78
+ equals(o: AlignmentEntry): boolean;
79
+ toXml(): string;
80
+ }
@@ -0,0 +1,20 @@
1
+ import { XlsxCellStyleSpec } from '../types.js';
2
+ /** 줄무늬 채움색(styles 2번). / Stripe fill color (style index 2). */
3
+ export declare const STRIPE_RGB = "F5F7FA";
4
+ /** 스타일 등록소. / Style registry. */
5
+ export declare class StylesRegistry {
6
+ private readonly fonts;
7
+ private readonly fills;
8
+ private readonly borders;
9
+ private readonly numFmts;
10
+ private readonly xfs;
11
+ private readonly xfIds;
12
+ constructor();
13
+ /** 등록된 고유 서식 수. / Distinct registered styles. */
14
+ get size(): number;
15
+ /** 스타일 등록 → 번호(같은 조합은 같은 번호). / Register a style → index (equal combos share one). */
16
+ add(spec: XlsxCellStyleSpec): number;
17
+ private numFmtId;
18
+ /** styles.xml 전체(마지막에 한 번). / Full styles.xml (serialized once at the end). */
19
+ toXml(): string;
20
+ }
@@ -0,0 +1,20 @@
1
+ import { IByteSink } from '../types.js';
2
+ import { IStreamingWorkbookWriter, IXlsxStreamSession, SheetModel, XlsxStreamInit } from './XlsxChannel.js';
3
+ import { StylesRegistry } from './XlsxStylesRegistry.js';
4
+ import { xmlEscape } from './XlsxXml.js';
5
+ export { xmlEscape };
6
+ /** 쓰기기 옵션. / Writer options. */
7
+ export interface XlsxWorkbookWriterOptions {
8
+ /** deflate 수준(0 = 저장만, 기본 6). 0~9 밖의 값은 6 으로 본다. / Deflate level (0 = stored; default 6). Values outside 0..9 are treated as 6. */
9
+ readonly level?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | undefined;
10
+ /** 스트림마다 쓸 스타일 등록소 공급자(주입, 기본 새 등록소). / Per-stream styles registry factory (injected; default a fresh registry). */
11
+ readonly createStyles?: (() => StylesRegistry) | undefined;
12
+ }
13
+ /** 스트리밍 xlsx 쓰기기. / Streaming xlsx writer. */
14
+ export declare class XlsxWorkbookWriter implements IStreamingWorkbookWriter {
15
+ private readonly opts;
16
+ constructor(opts?: XlsxWorkbookWriterOptions);
17
+ /** SheetModel → 바이트(소형 경로도 같은 스트리밍 엔진 사용). / Model path reuses the streaming engine. */
18
+ write(model: SheetModel, sink: IByteSink): Promise<number>;
19
+ openStream(init: XlsxStreamInit, sink: IByteSink): Promise<IXlsxStreamSession>;
20
+ }
@@ -0,0 +1,6 @@
1
+ /** XML 에서 허용되지 않는 제어문자 제거 + 특수문자 이스케이프. / Strip illegal control chars + escape. */
2
+ export declare function xmlEscape(s: string): string;
3
+ /** 0-base 열 → A, B, … AA. / 0-based column → letters. */
4
+ export declare function colName(i: number): string;
5
+ export declare const XML_HEAD = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n";
6
+ export declare const NS = "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
@@ -4,6 +4,8 @@ export type { ArtifactProvenanceOptions } from './Provenance.js';
4
4
  export { ExportManifest } from './ExportManifest.js';
5
5
  export { StreamPump, STREAM_DEFAULTS, shouldStream } from './StreamPump.js';
6
6
  export { MemoryByteSink, DownloadByteSink } from './sinks.js';
7
+ export { FileSystemByteSink, BlobDownloadByteSink, pickExcelSink, canUseFileSystemAccess, XLSX_MIME, } from './sinks.js';
8
+ export type { IWritableLike, BlobDownloadOptions, PickExcelSinkOptions, ExcelSinkChoice, } from './sinks.js';
7
9
  export { GridArtifactSource } from './GridArtifactSource.js';
8
10
  export type { GridArtifactSourceDeps, ArtifactColumn, PlacementFn, CfFn, } from './GridArtifactSource.js';
9
11
  export { ChannelRegistry } from './ChannelRegistry.js';