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
@@ -38,3 +38,84 @@ export declare class DownloadByteSink implements IByteSink {
38
38
  abort(): void;
39
39
  get desiredSize(): number;
40
40
  }
41
+ /** 엑셀 기본 MIME. / Default xlsx MIME type. */
42
+ export declare const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
43
+ /** FileSystemWritableFileStream 의 필요한 최소 모양(주입용). / Minimal shape of a writable file stream. */
44
+ export interface IWritableLike {
45
+ write(data: Uint8Array | string): Promise<void>;
46
+ close(): Promise<void>;
47
+ abort?(reason?: unknown): Promise<void> | void;
48
+ }
49
+ /**
50
+ * 디스크 직접 기록 싱크(File System Access). 호출부가 `showSaveFilePicker().createWritable()` 결과를 넘긴다.
51
+ * desiredSize = highWaterMark − 아직 기록 끝나지 않은 바이트(기록이 끝나면 회복).
52
+ * / Direct-to-disk sink; wraps a writable. desiredSize = highWaterMark − in-flight bytes.
53
+ */
54
+ export declare class FileSystemByteSink implements IByteSink {
55
+ private readonly _writable;
56
+ private readonly _highWaterMark;
57
+ private _pending;
58
+ private _closed;
59
+ private _aborted;
60
+ constructor(_writable: IWritableLike, _highWaterMark?: number);
61
+ write(chunk: Uint8Array | string): Promise<void>;
62
+ close(): Promise<void>;
63
+ abort(reason?: string): void;
64
+ get desiredSize(): number;
65
+ }
66
+ /** Blob 다운로드 옵션. / Blob download options. */
67
+ export interface BlobDownloadOptions {
68
+ fileName?: string;
69
+ mime?: string;
70
+ highWaterMark?: number | undefined;
71
+ /** 결과 Blob 전달 콜백(미지정 시 `<a download>` 클릭). / Receives the Blob (default: anchor click). */
72
+ download?: ((blob: Blob, fileName: string) => void) | undefined;
73
+ }
74
+ /**
75
+ * 폴백 싱크: 조각을 모아 close 때 Blob→objectURL→`<a download>`. 압축 바이트만 보유.
76
+ * / Fallback sink: collects pieces, downloads as a Blob on close.
77
+ */
78
+ export declare class BlobDownloadByteSink implements IByteSink {
79
+ private readonly _parts;
80
+ private _bytes;
81
+ private _closed;
82
+ private _aborted;
83
+ private readonly _fileName;
84
+ private readonly _mime;
85
+ private readonly _hwm;
86
+ private readonly _download?;
87
+ constructor(opts?: BlobDownloadOptions);
88
+ write(chunk: Uint8Array | string): Promise<void>;
89
+ close(): Promise<void>;
90
+ abort(): void;
91
+ get desiredSize(): number;
92
+ get bytesWritten(): number;
93
+ private static _anchorDownload;
94
+ }
95
+ /** 선택기 옵션. / Selector options. */
96
+ export interface PickExcelSinkOptions {
97
+ fileName?: string;
98
+ mime?: string;
99
+ /** 'off' 면 File System Access 를 쓰지 않는다(기본 'auto'). / 'off' blocks FS-Access. */
100
+ fsAccess?: 'auto' | 'off';
101
+ highWaterMark?: number;
102
+ /** Blob 경로의 다운로드 콜백. / Download callback for the Blob path. */
103
+ download?: BlobDownloadOptions['download'];
104
+ /** 판정 대상 환경(테스트용, 기본 window). / Environment to probe (tests; default window). */
105
+ env?: unknown;
106
+ }
107
+ /** pickExcelSink 결과. / Result of pickExcelSink. */
108
+ export interface ExcelSinkChoice {
109
+ readonly kind: 'fs' | 'blob';
110
+ /** 싱크 생성. 'fs' 는 저장 대화상자를 연다(사용자 취소 시 reject, 호출부가 처리). / Creates the sink; 'fs' opens the picker. */
111
+ create(): Promise<IByteSink>;
112
+ }
113
+ /** 순수 판정: File System Access 를 쓸 수 있고 막지 않았나. / Pure check: is FS-Access usable and not blocked. */
114
+ export declare function canUseFileSystemAccess(opts?: PickExcelSinkOptions): boolean;
115
+ /**
116
+ * 엑셀 싱크 선택기. 사용: `const sink = await pickExcelSink({ fileName: 'a.xlsx' }).create();`
117
+ * 이후 스트리밍 쓰기(`writeStreaming(source, sink, ctx)`)에 넘긴다. 'fs' 는 사용자 제스처 안에서 create() 를 호출해야 한다.
118
+ * / Usage: `const sink = await pickExcelSink({ fileName }).create()`, then pass it to the streaming writer.
119
+ * For 'fs', call create() inside a user gesture.
120
+ */
121
+ export declare function pickExcelSink(opts?: PickExcelSinkOptions): ExcelSinkChoice;
@@ -37,6 +37,69 @@ export interface CellArtifact {
37
37
  readonly align: CellAlign;
38
38
  /** 채널별 셀 타입 매핑용(xlsx number vs string). / Domain kind for per-channel typing. */
39
39
  readonly type: DomainKind;
40
+ /** 스트리밍 xlsx 셀 스타일(채움·글자색·굵기·숫자 서식 등). 없으면 기본 줄무늬. / Streaming-xlsx cell style; none = default banding. */
41
+ readonly xlsxStyle?: XlsxCellStyleSpec;
42
+ /** 스트리밍 xlsx 셀 안 서식 조각(낱말별 색·굵기). 있으면 `text` 대신 이 조각들을 이어 쓴다. / Rich-text runs; when present they replace `text` in the streaming xlsx. */
43
+ readonly xlsxRuns?: ReadonlyArray<XlsxRichTextRun>;
44
+ }
45
+ /**
46
+ * 셀 안 서식 조각 한 토막. 이어 붙인 글자가 셀 값이다.
47
+ *
48
+ * One rich-text run inside a cell; the concatenated texts form the cell value.
49
+ *
50
+ * セル内の書式付き断片。つなげた文字がセルの値になります。
51
+ *
52
+ * 单元格内的一段富文本;各段文字连起来就是单元格的值。
53
+ */
54
+ export interface XlsxRichTextRun {
55
+ /** 이 토막의 글자. / Text of this run. */
56
+ readonly text: string;
57
+ /** 이 토막의 글자 서식. 없으면 셀 기본. / Font of this run; none = cell default. */
58
+ readonly style?: {
59
+ readonly color?: {
60
+ readonly rgb: string;
61
+ };
62
+ readonly bold?: boolean;
63
+ readonly italic?: boolean;
64
+ /** 글자 크기(pt). / Font size in points. */
65
+ readonly size?: number;
66
+ };
67
+ }
68
+ /**
69
+ * 스트리밍 xlsx 셀 스타일 명세. 색은 `RRGGBB` 또는 `AARRGGBB`(# 없이). 같은 조합은 같은 스타일 번호를 공유한다.
70
+ *
71
+ * Streaming-xlsx cell style spec. Colors are `RRGGBB` or `AARRGGBB` (no `#`). Equal combinations share one style index.
72
+ *
73
+ * ストリーミング xlsx のセルスタイル指定。色は `RRGGBB` または `AARRGGBB`(# なし)。同じ組み合わせは同じ番号を共有します。
74
+ *
75
+ * 流式 xlsx 的单元格样式。颜色为 `RRGGBB` 或 `AARRGGBB`(不带 #)。相同组合共用同一样式编号。
76
+ */
77
+ export interface XlsxCellStyleSpec {
78
+ /** 배경 채움색. / Background fill. */
79
+ readonly fill?: {
80
+ readonly rgb: string;
81
+ };
82
+ /** 글자 서식. / Font. */
83
+ readonly font?: {
84
+ readonly bold?: boolean;
85
+ readonly italic?: boolean;
86
+ readonly color?: {
87
+ readonly rgb: string;
88
+ };
89
+ };
90
+ /** 숫자 서식(예: `#,##0.00`). / Number format. */
91
+ readonly numFmt?: string;
92
+ /** 사방 테두리. / Border on all four sides. */
93
+ readonly border?: {
94
+ readonly style: 'thin' | 'medium' | 'thick' | 'hair' | 'dotted' | 'dashed';
95
+ readonly color?: {
96
+ readonly rgb: string;
97
+ };
98
+ };
99
+ /** 가로 정렬. / Horizontal alignment. */
100
+ readonly align?: {
101
+ readonly horizontal: 'left' | 'center' | 'right';
102
+ };
40
103
  }
41
104
  /** 한 논리 행의 아티팩트. 화면 밖 행도 동일 구조(전량 순회, REQ-T3-805). / One logical row's artifact. */
42
105
  export interface RowArtifact {
@@ -1,4 +1,4 @@
1
- export type ArchRuleId = 'core-imports-framework' | 'headless-dom-global' | 'a11y-aria-write' | 'getcomputedstyle-scope';
1
+ export type ArchRuleId = 'core-imports-framework' | 'headless-dom-global' | 'a11y-aria-write' | 'getcomputedstyle-scope' | 'headless-imports-render' | 'headless-dom-type' | 'paint-path-dom-read' | 'private-name-string-access';
2
2
  export interface ArchViolation {
3
3
  readonly rule: ArchRuleId;
4
4
  readonly path: string;
@@ -16,6 +16,21 @@ export interface ArchCheckOptions {
16
16
  readonly coreDir?: string;
17
17
  /** 경계 화이트리스트(헤드리스 규칙 예외 — humble shell·boundary). / Boundary whitelist. */
18
18
  readonly boundaryDirs?: readonly string[];
19
+ /** 헤드리스 dir 이 import 하면 안 되는 그리기 쪽 경로(확장자 뺀 접두사). / DOM-side targets headless code must not import. */
20
+ readonly renderSideTargets?: readonly string[];
21
+ /** DOM 형 이름 금지 대상(새 헤드리스 파일·dir 접두사). / New headless files where DOM type names are banned. */
22
+ readonly domTypeBannedFiles?: readonly string[];
23
+ /** 그리는 길 파일(접두사) — DOM 읽기 금지. / Paint-path files where layout-forcing DOM reads are banned. */
24
+ readonly paintPathFiles?: readonly string[];
25
+ /** 그리는 길 DOM 읽기 허용 목록: 파일 통째(method 없음) 또는 그 파일의 메서드 하나. / Allowed readers. */
26
+ readonly paintPathReadAllow?: readonly PaintReadAllow[];
27
+ /** 글자로 불러도 되는 비공개 이름(이미 있던 예외 — 빌드 이름표가 그 글자를 보고 지킴). / Private names allowed as strings. */
28
+ readonly privateStringAllow?: readonly string[];
29
+ }
30
+ /** 그리는 길 DOM 읽기 허용 항목. method 를 주면 그 메서드 몸통 안에서만 허용. / Allow entry for paint-path reads. */
31
+ export interface PaintReadAllow {
32
+ readonly path: string;
33
+ readonly method?: string;
19
34
  }
20
35
  /**
21
36
  * 정적 적합성 검사. 위반 목록 반환(빈 배열=통과).
@@ -160,6 +160,12 @@ export declare const EN_MESSAGES: {
160
160
  };
161
161
  export: {
162
162
  printSummary: string;
163
+ preparing: string;
164
+ exporting: string;
165
+ cancel: string;
166
+ cancelled: string;
167
+ done: string;
168
+ exportError: string;
163
169
  };
164
170
  };
165
171
  /** en 포맷 메타. / en format meta. */
@@ -160,6 +160,12 @@ export declare const KO_MESSAGES: {
160
160
  };
161
161
  export: {
162
162
  printSummary: string;
163
+ preparing: string;
164
+ exporting: string;
165
+ cancel: string;
166
+ cancelled: string;
167
+ done: string;
168
+ exportError: string;
163
169
  };
164
170
  };
165
171
  /** ko 포맷 메타(Intl 태그·방향·수출 폰트). / ko format meta (Intl tag, direction, export font). */
@@ -669,6 +669,14 @@ export interface LocaleMessages {
669
669
  * 打印的摘要行。参数 {rows} {cols} {date}。
670
670
  */
671
671
  printSummary: MessageValue;
672
+ /** 엑셀 내보내기 진척 문구. / Excel export progress strings. */
673
+ preparing: MessageValue;
674
+ /** 파라미터 {done} {total} {percent}. / Params {done} {total} {percent}. */
675
+ exporting: MessageValue;
676
+ cancel: MessageValue;
677
+ cancelled: MessageValue;
678
+ done: MessageValue;
679
+ exportError: MessageValue;
672
680
  };
673
681
  }
674
682
  /**
@@ -0,0 +1,121 @@
1
+ import { IFooterView, IGeometryApplier, IScrollFollower } from './ports.js';
2
+ import { FooterResultLike } from '../domain/footer/ports.js';
3
+ import { FooterDef } from '../domain/footer/FooterValues.js';
4
+ import { IColumnGeometry } from '../coordinate/geometryPorts.js';
5
+ /** 그리기에 쓰는 옵션 몫(그리드 옵션 객체를 그대로 넘김). / The grid options the footer reads. */
6
+ export interface FooterViewOptions {
7
+ footer?: readonly FooterDef[] | null;
8
+ footerHeight?: number;
9
+ footerPosition?: string;
10
+ }
11
+ export interface FooterViewDeps {
12
+ /** 막대를 넣을 컨테이너 — 그릴 때마다 묻는다(지금 동작). / Container, asked on every paint. */
13
+ container(): HTMLElement;
14
+ options(): FooterViewOptions;
15
+ /** 보이는 잎 컬럼(정렬 기본값에 형을 봄). / Visible leaf columns. */
16
+ leaves(): readonly {
17
+ readonly type?: string;
18
+ readonly width?: number;
19
+ }[];
20
+ /** 컬럼 기하 — 그릴 때마다 한 번 묻는다. / Column geometry, asked once per paint. */
21
+ geometry(): IColumnGeometry;
22
+ /**
23
+ * 저장된 폭 배열. 폭 값은 기하에 묻고, 이 배열은 「그 잎에 폭이 저장돼 있나」만 본다(없으면 100px, 배열 자체가 없으면 잎의 width).
24
+ *
25
+ * Stored width array; only used to tell whether a leaf has a stored width — the value itself comes from the geometry.
26
+ */
27
+ widths(): readonly number[] | null | undefined;
28
+ /**
29
+ * 정의마다의 합계 결과를 주는 곳. 값 계산은 FooterValues 가 하고 이 객체는 결과만 받는다(어떤 정의·행으로
30
+ * 셈할지는 주는 쪽이 안다). 그릴 때마다 한 번 부른다.
31
+ *
32
+ * Supplies the per-definition results; FooterValues computes them and the supplier knows which
33
+ * definitions and rows. Called once per paint.
34
+ */
35
+ values(): readonly FooterResultLike[];
36
+ /** 가로 스크롤 따라가기(선택). / Optional horizontal scroll follower. */
37
+ follower?: IScrollFollower;
38
+ }
39
+ /**
40
+ * 푸터 막대 DOM 의 주인. 값은 deps.values(), 정의는 deps.options().footer 에서.
41
+ *
42
+ * Owner of the footer bar DOM.
43
+ */
44
+ export declare class FooterView implements IFooterView {
45
+ private readonly _d;
46
+ /** 마지막으로 그린 막대(따라가기 풀기·값만 고치기용). / Last painted bar. */
47
+ private _bar;
48
+ /** 그 막대를 그린 정의 배열(같은 배열이어야 값만 고칠 수 있다). / Definitions the bar was painted from. */
49
+ private _defs;
50
+ /** 정의마다의 칸(정의 순서). / One cell per definition. */
51
+ private _cells;
52
+ /** 정의마다 값 칸으로 그렸나(라벨만인 칸과 갈래가 바뀌면 통째로 다시). / Whether each cell was painted as a value cell. */
53
+ private _valued;
54
+ /** 그 막대를 그릴 때의 기하 판·높이·위치(바뀌면 값만 고칠 수 없다 — 칸 폭·막대 모양이 달라짐). / Shape inputs at paint time. */
55
+ private _geoVersion;
56
+ private _height;
57
+ private _position;
58
+ private _follower;
59
+ private _applier;
60
+ /** 막대 끝 여백 px(본문 세로 스크롤바 폭)와 그 자리 요소(0 이면 없음). / End gutter px and its element (none when 0). */
61
+ private _gutter;
62
+ private _gutterEl;
63
+ constructor(deps: FooterViewDeps);
64
+ /**
65
+ * 가로 따라가기 객체를 넘겨 받는다(그리드가 렌더러를 만든 뒤 한 번). 이미 그린 막대가 있으면 옛 객체에서 풀고 새 객체에 맡긴다.
66
+ *
67
+ * Receives the horizontal scroll follower; an existing bar moves from the old follower to the new one.
68
+ */
69
+ setFollower(f: IScrollFollower | null): void;
70
+ /**
71
+ * 폭 등록기를 넘겨 받는다(그리드가 기하·등록기를 만든 뒤). 막대를 그릴 때마다 폭 자리를 'footer' 범위로 등록해 두면
72
+ * 컬럼 폭을 끄는 동안 등록기가 머리글·본문과 같은 프레임에 푸터 칸 폭도 고친다(막대를 다시 만들지 않음).
73
+ * 이미 그린 막대가 있으면 한 번 다시 그려 등록을 맞춘다.
74
+ *
75
+ * Receives the geometry applier; each paint registers the footer's width spots under the 'footer' scope so a column
76
+ * drag updates footer cells in the same frame as header and body. An existing bar is repainted once to register.
77
+ */
78
+ /**
79
+ * 막대 끝 여백을 정한다(본문 세로 스크롤바 폭). 본문은 스크롤바 때문에 보이는 폭이 그만큼 좁아 가로로 그만큼 더 옮겨지는데,
80
+ * 막대는 스크롤바가 없어 끝까지 긁으면 그만큼 덜 간다 — 그 차이를 막대 끝 빈 칸으로 메운다. 0 이면 아무것도 쓰지 않는다
81
+ * (스크롤바가 없는 화면의 막대 글자는 지금과 같다). 이미 그린 막대는 다시 만들지 않고 그 칸만 고친다.
82
+ *
83
+ * Sets the bar's end gutter (the body's vertical scrollbar width) so the bar can scroll as far as the body. Zero
84
+ * writes nothing (markup unchanged when no scrollbar shows). An existing bar is patched, not rebuilt.
85
+ */
86
+ setEndGutter(px: number): void;
87
+ private _makeGutter;
88
+ setApplier(a: IGeometryApplier | null): void;
89
+ /**
90
+ * 막대를 통째로 다시 그린다. 있던 `.og-footer-bar` 를 떼고, 정의가 있으면 새로 만들어
91
+ * `footerPosition` 에 따라 컨테이너 맨 앞이나 맨 뒤에 넣는다.
92
+ *
93
+ * Rebuilds the bar: removes the existing `.og-footer-bar` and, when definitions exist, inserts a new
94
+ * one at the top or bottom of the container per `footerPosition`.
95
+ */
96
+ paint(): void;
97
+ /**
98
+ * 값만 다시: 같은 정의로 그린 막대가 아직 컨테이너에 붙어 있으면 값 칸의 글자와 title 만 고친다(요소는 그대로 — 따라가기·스크롤 위치도 그대로).
99
+ * 막대가 없거나, 막대 모양을 정하는 입력(정의 배열·컬럼 기하 판·높이·위치)이 바뀌었거나, 어느 칸이 값 칸↔라벨 칸으로 갈래가
100
+ * 바뀌면 통째로 다시 그린다(결과 글자는 통째와 같다).
101
+ *
102
+ * Values only: when the bar painted from the same definitions is attached, rewrite just the value cells' text
103
+ * and title (elements kept). Otherwise repaint fully; the resulting markup equals a full paint.
104
+ */
105
+ updateValues(): void;
106
+ /** 값 칸의 글자와 title(그리기·값만 고치기가 함께 쓰는 한 곳). / Text and title of a value cell. */
107
+ private _writeValue;
108
+ /** 따라가기를 풀고 막대 참조를 놓는다(막대 요소는 컨테이너와 함께 사라진다). / Releases the follower and the bar reference. */
109
+ destroy(): void;
110
+ /**
111
+ * 잎 하나의 칸 폭. 폭이 저장된 잎은 기하에 묻고, 저장된 폭이 없으면 100px, 폭 배열 자체가 없으면 잎의 width(없으면 100) —
112
+ * 모두 지금 동작. 기하 범위 밖(합쳐 그리기가 마지막 잎을 넘는 경우)은 저장된 값이나 100px.
113
+ *
114
+ * Width of one leaf: from the geometry when a width is stored, otherwise 100px (or the leaf's own width
115
+ * when there is no array at all) — all current behaviour.
116
+ */
117
+ /** 그 잎의 칸 폭이 기하에서 오나(저장 폭이 있고 기하 범위 안). / Whether the leaf's width comes from the geometry. */
118
+ private _fromGeometry;
119
+ private _widthAt;
120
+ private _release;
121
+ }
@@ -0,0 +1,55 @@
1
+ import { GeometryChange, IColumnGeometry } from '../coordinate/geometryPorts.js';
2
+ import { ICellRegistry, IGeometryApplier, ProjectionScope, WidthProps } from './ports.js';
3
+ type StyleProp = 'width' | 'minWidth' | 'maxWidth' | 'left';
4
+ /**
5
+ * 기하에서 나온 px 를 DOM 에 쓰는 유일한 객체.
6
+ * 불변: applyChange 뒤 등록된(살아 있는) 모든 폭 자리의 px == 기하 값 · 칸은 지도에 묻고 등록하지 않음 ·
7
+ * release(scope) 뒤 그 범위 등록 0(다른 범위는 건드리지 않음).
8
+ *
9
+ * Sole writer of geometry-derived px. Cells come from the registry; other spots are registered per scope.
10
+ */
11
+ export declare class GeometryApplier implements IGeometryApplier {
12
+ private readonly _geometry;
13
+ private readonly _cells;
14
+ private readonly _stores;
15
+ constructor(geometry: IColumnGeometry, cells: ICellRegistry);
16
+ /** 칸 폭을 쓴다(칸은 등록하지 않음 — 지도가 안다). */
17
+ writeCellWidth(el: HTMLElement, ci: number, p: WidthProps): void;
18
+ trackHeaderCell(th: HTMLElement, ci: number, p: WidthProps): void;
19
+ /** extraPx — 기하가 모르는 몫(마지막 컬럼을 넘는 병합의 넘은 컬럼 × 기본 폭 등). / px the geometry does not know. */
20
+ trackSpan(el: HTMLElement, ci: number, span: number, p: WidthProps, s: ProjectionScope, extraPx?: number): void;
21
+ /**
22
+ * 행 하나로 칸 여럿을 등록한다: row 의 자식 [firstChild, firstChild + (to − from)] 가 컬럼 [from, to] 의 칸 폭 자리.
23
+ * 칸 지도 밖 칸이 컬럼마다 있는 행(묶음 행 등)을 칸마다 등록하면 뜨거운 길에 기록이 칸 수만큼 생기므로 행 하나로 묶는다.
24
+ *
25
+ * Registers one row for many cells: row children [firstChild, firstChild + (to − from)] are the cells of columns
26
+ * [from, to]. Rows with an off-registry cell per column would otherwise create one record per cell on a hot path.
27
+ */
28
+ trackRowCells(row: HTMLElement, firstChild: number, from: number, to: number, p: WidthProps, s: ProjectionScope): void;
29
+ trackLeft(el: HTMLElement, ci: number, s: ProjectionScope): void;
30
+ trackTotal(el: HTMLElement, prop: 'width' | 'minWidth', s: ProjectionScope): void;
31
+ trackExtra(el: HTMLElement, s: ProjectionScope): void;
32
+ trackGap(el: HTMLElement, from: number, to: number, s: ProjectionScope, extraPx?: number): void;
33
+ trackBar(el: HTMLElement, ci: number, span: number, ratio: number): void;
34
+ untrack(el: HTMLElement): void;
35
+ /** 그 범위의 등록을 모두 푼다 — 그 범위를 통째로 다시 그리기 직전에 부른다(다른 범위는 훑지 않음). */
36
+ release(s: ProjectionScope): void;
37
+ /**
38
+ * 바뀐 몫만 다시 쓴다: 바뀐 컬럼의 칸(지도)·고정 칸 left → 등록 자리(병합 span 은 칸 쓰기 뒤라 span 값이 이김).
39
+ * 값이 지금과 같으면 쓰지 않는다. DOM 에서 떨어진 요소는 건너뛰고 등록을 푼다.
40
+ */
41
+ applyChange(change: GeometryChange, opts?: {
42
+ skipScope?: 'body';
43
+ }): void;
44
+ /** 진단·시험용: 등록된 자리마다 기하가 정한 값(행 등록은 칸마다 펼침). */
45
+ projections(scope?: ProjectionScope): readonly {
46
+ el: HTMLElement;
47
+ prop: StyleProp;
48
+ value: string;
49
+ }[];
50
+ /** 진단·시험용: 등록 수(요소 하나에 등록이 둘이면 둘로, 행 등록은 하나로 셈). */
51
+ trackedCount(scope?: ProjectionScope): number;
52
+ private _pick;
53
+ private _add;
54
+ }
55
+ export {};
@@ -0,0 +1,26 @@
1
+ import { IColumnGeometry, ViewportBox } from '../coordinate/geometryPorts.js';
2
+ import { IHorizontalReveal } from './ports.js';
3
+ /** 옮기기에 필요한 스크롤 쪽(스크롤 관찰 객체가 구현). / The scroll side needed to move (implemented by the scroll observer). */
4
+ export interface RevealScroll {
5
+ readonly box: ViewportBox;
6
+ scrollLeftTo(x: number): void;
7
+ }
8
+ /**
9
+ * 컬럼 하나가 보이도록 가로 위치를 정하는 곳. 상태 없음(기하·상자는 부를 때마다 묻는다).
10
+ *
11
+ * Decides the horizontal offset that reveals one column. Stateless (geometry and box are asked per call).
12
+ */
13
+ export declare class HorizontalReveal implements IHorizontalReveal {
14
+ private readonly _scroll;
15
+ private readonly _geometry;
16
+ constructor(_scroll: RevealScroll, _geometry: IColumnGeometry);
17
+ revealColumn(ci: number): void;
18
+ /**
19
+ * 컬럼 ci 가 보이게 옮기고 새 scrollLeft 를 돌려준다. 이미 보이거나(고정 컬럼 포함) 보이는 폭을 모르면 null(안 옮김).
20
+ * 컬럼이 보이는 폭보다 넓으면 왼쪽 끝을 맞춘다.
21
+ *
22
+ * Moves so column ci is visible and returns the new scrollLeft; null when already visible (frozen included) or the
23
+ * viewport width is unknown. A column wider than the viewport is aligned to its left edge.
24
+ */
25
+ reveal(ci: number): number | null;
26
+ }
@@ -0,0 +1,10 @@
1
+ import { IRangeOverlay } from './ports.js';
2
+ /** 덧그림을 다시 그릴 줄 아는 것(범위 선택 관리자). / Something that can repaint the range overlay. */
3
+ export interface RangeOverlayTarget {
4
+ repaint(): void;
5
+ }
6
+ export declare class RangeOverlayAdapter implements IRangeOverlay {
7
+ private readonly _target;
8
+ constructor(target: RangeOverlayTarget);
9
+ repaint(): void;
10
+ }