open-grid 1.2.1 → 1.3.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.
Files changed (251) hide show
  1. package/CHANGELOG.md +376 -365
  2. package/dist/{OpenGrid-0r_543Kj.cjs → OpenGrid-B7m7ei7f.cjs} +1222 -1029
  3. package/dist/{OpenGrid-HmhGVC2V.js → OpenGrid-CeUdO_fM.js} +1613 -1418
  4. package/dist/index-CeJ-0-80.cjs +260 -0
  5. package/dist/index-DnarQ4eR.js +266 -0
  6. package/dist/index-DrCPRuYi.js +548 -0
  7. package/dist/index-JjfWY3Bt.cjs +520 -0
  8. package/dist/open-grid-base.css +12 -1
  9. package/dist/open-grid-react.cjs +1 -1
  10. package/dist/open-grid-react.js +1 -1
  11. package/dist/open-grid-vue.cjs +7 -7
  12. package/dist/open-grid-vue.js +2 -2
  13. package/dist/open-grid.cjs +1 -1
  14. package/dist/open-grid.js +2 -2
  15. package/dist/types/bench/perf.d.ts +14 -8
  16. package/dist/types/core/AppearanceResolver.d.ts +98 -11
  17. package/dist/types/core/CFRenderBridge.d.ts +13 -0
  18. package/dist/types/core/CellTypeRegistry.d.ts +24 -0
  19. package/dist/types/core/ColumnLayout.d.ts +100 -2
  20. package/dist/types/core/CrossGridMapper.d.ts +43 -5
  21. package/dist/types/core/DataLayer.d.ts +210 -15
  22. package/dist/types/core/DragVisuals.d.ts +33 -4
  23. package/dist/types/core/EventEmitter.d.ts +54 -0
  24. package/dist/types/core/FormulaEngine.d.ts +15 -4
  25. package/dist/types/core/GridRenderer.d.ts +143 -10
  26. package/dist/types/core/GroupEngine.d.ts +68 -10
  27. package/dist/types/core/MathUtils.d.ts +58 -5
  28. package/dist/types/core/MergeEngine.d.ts +45 -10
  29. package/dist/types/core/OGDecimal.d.ts +144 -13
  30. package/dist/types/core/OpenGrid.d.ts +99 -0
  31. package/dist/types/core/PivotEngine.d.ts +37 -0
  32. package/dist/types/core/RowDragDrop.d.ts +52 -6
  33. package/dist/types/core/SkinRegistry.d.ts +4 -0
  34. package/dist/types/core/TreeEngine.d.ts +60 -6
  35. package/dist/types/core/VirtualScroll.d.ts +64 -0
  36. package/dist/types/core/a11y/AccessibilityAdapter.d.ts +103 -0
  37. package/dist/types/core/a11y/AriaIntent.d.ts +34 -0
  38. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +64 -0
  39. package/dist/types/core/a11y/LiveRegionController.d.ts +89 -0
  40. package/dist/types/core/a11y/OverlayStack.d.ts +36 -0
  41. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +37 -0
  42. package/dist/types/core/a11y/index.d.ts +13 -0
  43. package/dist/types/core/a11y/ports.d.ts +24 -0
  44. package/dist/types/core/appearance/Appearance.d.ts +68 -0
  45. package/dist/types/core/appearance/AppearanceAxis.d.ts +94 -0
  46. package/dist/types/core/appearance/AppearanceComposer.d.ts +45 -0
  47. package/dist/types/core/appearance/AppearanceProvider.d.ts +50 -0
  48. package/dist/types/core/appearance/AppearanceView.d.ts +51 -0
  49. package/dist/types/core/appearance/DensityRegistry.d.ts +36 -0
  50. package/dist/types/core/appearance/ResolvedAppearanceSnapshot.d.ts +84 -0
  51. package/dist/types/core/appearance/TextureRegistry.d.ts +32 -0
  52. package/dist/types/core/appearance/ThemeMetaRegistry.d.ts +67 -0
  53. package/dist/types/core/appearance/axisAdapters.d.ts +37 -0
  54. package/dist/types/core/appearance/defaults.d.ts +10 -0
  55. package/dist/types/core/appearance/index.d.ts +20 -0
  56. package/dist/types/core/appearance/tokenCatalog.d.ts +30 -0
  57. package/dist/types/core/cf/CFEngine.d.ts +56 -0
  58. package/dist/types/core/cf/CFEvaluator.d.ts +24 -0
  59. package/dist/types/core/cf/CFRule.d.ts +127 -0
  60. package/dist/types/core/cf/ColorScale.d.ts +49 -0
  61. package/dist/types/core/cf/InkResolver.d.ts +33 -0
  62. package/dist/types/core/cf/appearance.d.ts +20 -0
  63. package/dist/types/core/cf/encoders.d.ts +61 -0
  64. package/dist/types/core/cf/eval-types.d.ts +93 -0
  65. package/dist/types/core/cf/index.d.ts +21 -0
  66. package/dist/types/core/cf/lineage.d.ts +32 -0
  67. package/dist/types/core/cf/predicates.d.ts +27 -0
  68. package/dist/types/core/cf/serialize.d.ts +46 -0
  69. package/dist/types/core/chart/CanvasAdapter.d.ts +50 -1
  70. package/dist/types/core/chart/DataExtractor.d.ts +53 -12
  71. package/dist/types/core/chart/a11y.d.ts +22 -0
  72. package/dist/types/core/chart/chart-type-registry.d.ts +53 -0
  73. package/dist/types/core/chart/downsample-report.d.ts +36 -0
  74. package/dist/types/core/chart/downsample.d.ts +26 -1
  75. package/dist/types/core/chart/engine/ChartEngineRegistry.d.ts +52 -0
  76. package/dist/types/core/chart/geometry.d.ts +96 -0
  77. package/dist/types/core/chart/hittest.d.ts +21 -3
  78. package/dist/types/core/chart/palette.d.ts +96 -12
  79. package/dist/types/core/chart/parity.d.ts +12 -0
  80. package/dist/types/core/chart/provenance.d.ts +47 -0
  81. package/dist/types/core/chart/scales.d.ts +28 -1
  82. package/dist/types/core/chart/scene.d.ts +102 -0
  83. package/dist/types/core/chart/server.d.ts +36 -0
  84. package/dist/types/core/chart/surfaces/CanvasSurface.d.ts +48 -0
  85. package/dist/types/core/chart/surfaces/ServerRasterSurface.d.ts +26 -0
  86. package/dist/types/core/chart/surfaces/SvgSurface.d.ts +24 -0
  87. package/dist/types/core/chart/surfaces/pattern-overlay.d.ts +24 -0
  88. package/dist/types/core/command/CommandBus.d.ts +51 -0
  89. package/dist/types/core/command/CommandRegistry.d.ts +43 -0
  90. package/dist/types/core/command/CommandStack.d.ts +38 -0
  91. package/dist/types/core/command/ICommand.d.ts +110 -0
  92. package/dist/types/core/command/commands/CellWriteCommand.d.ts +32 -0
  93. package/dist/types/core/command/commands/CompositeCommand.d.ts +17 -0
  94. package/dist/types/core/command/commands/RowCommands.d.ts +39 -0
  95. package/dist/types/core/command/index.d.ts +9 -0
  96. package/dist/types/core/command/support.d.ts +51 -0
  97. package/dist/types/core/coordinate/ColumnMetrics.d.ts +30 -0
  98. package/dist/types/core/coordinate/CoordinateKernel.d.ts +88 -0
  99. package/dist/types/core/coordinate/FrozenPanes.d.ts +29 -0
  100. package/dist/types/core/coordinate/MergeSourceAdapter.d.ts +18 -0
  101. package/dist/types/core/coordinate/NodeBudget.d.ts +33 -0
  102. package/dist/types/core/coordinate/ResizeGovernor.d.ts +50 -0
  103. package/dist/types/core/coordinate/RowMetrics.d.ts +37 -0
  104. package/dist/types/core/coordinate/ViewPermutation.d.ts +23 -0
  105. package/dist/types/core/coordinate/index.d.ts +10 -0
  106. package/dist/types/core/coordinate/ports.d.ts +45 -0
  107. package/dist/types/core/coordinate/types.d.ts +76 -0
  108. package/dist/types/core/detail/DetailGlyph.d.ts +42 -7
  109. package/dist/types/core/detail/DetailSplice.d.ts +42 -11
  110. package/dist/types/core/detail/DetailState.d.ts +80 -11
  111. package/dist/types/core/detail/SubgridCache.d.ts +72 -10
  112. package/dist/types/core/detail/index.d.ts +8 -0
  113. package/dist/types/core/domain/AggregateResult.d.ts +54 -0
  114. package/dist/types/core/domain/CellAddress.d.ts +61 -0
  115. package/dist/types/core/domain/CellValueAccess.d.ts +29 -0
  116. package/dist/types/core/domain/Delta.d.ts +37 -0
  117. package/dist/types/core/domain/DomainValue.d.ts +80 -0
  118. package/dist/types/core/domain/Missing.d.ts +65 -0
  119. package/dist/types/core/domain/Money.d.ts +42 -0
  120. package/dist/types/core/domain/NormalizationBasis.d.ts +47 -0
  121. package/dist/types/core/domain/Plain.d.ts +45 -0
  122. package/dist/types/core/domain/Quantity.d.ts +32 -0
  123. package/dist/types/core/domain/Ratios.d.ts +100 -0
  124. package/dist/types/core/domain/ThresholdSet.d.ts +46 -0
  125. package/dist/types/core/domain/ValueType.d.ts +71 -0
  126. package/dist/types/core/domain/rounding.d.ts +25 -0
  127. package/dist/types/core/domain/strategies.d.ts +38 -0
  128. package/dist/types/core/editors/DateEditor.d.ts +18 -0
  129. package/dist/types/core/editors/SelectEditor.d.ts +29 -0
  130. package/dist/types/core/export/ChannelRegistry.d.ts +18 -0
  131. package/dist/types/core/export/ExportManifest.d.ts +13 -0
  132. package/dist/types/core/export/GridArtifactSource.d.ts +62 -0
  133. package/dist/types/core/export/Provenance.d.ts +34 -0
  134. package/dist/types/core/export/StreamPump.d.ts +28 -0
  135. package/dist/types/core/export/channels/CsvChannel.d.ts +20 -0
  136. package/dist/types/core/export/channels/JsonChannel.d.ts +18 -0
  137. package/dist/types/core/export/channels/XlsxChannel.d.ts +53 -0
  138. package/dist/types/core/export/channels/XmlChannel.d.ts +21 -0
  139. package/dist/types/core/export/channels/capabilities.d.ts +13 -0
  140. package/dist/types/core/export/index.d.ts +24 -0
  141. package/dist/types/core/export/print/OutputChannelAdapter.d.ts +61 -0
  142. package/dist/types/core/export/print/Paginator.d.ts +48 -0
  143. package/dist/types/core/export/print/PrintRenderTarget.d.ts +36 -0
  144. package/dist/types/core/export/sinks.d.ts +40 -0
  145. package/dist/types/core/export/types.d.ts +211 -0
  146. package/dist/types/core/extension/DeprecationManager.d.ts +42 -0
  147. package/dist/types/core/extension/IExtension.d.ts +90 -0
  148. package/dist/types/core/extension/Registry.d.ts +142 -0
  149. package/dist/types/core/extension/SlotRegistry.d.ts +46 -0
  150. package/dist/types/core/extension/adapters.d.ts +44 -0
  151. package/dist/types/core/extension/conformance.d.ts +47 -0
  152. package/dist/types/core/extension/index.d.ts +16 -0
  153. package/dist/types/core/extension/registries.d.ts +31 -0
  154. package/dist/types/core/extension/reserved.d.ts +10 -0
  155. package/dist/types/core/format/DisplayFormatter.d.ts +47 -0
  156. package/dist/types/core/format/FormatCache.d.ts +20 -0
  157. package/dist/types/core/format/FormatterRegistry.d.ts +22 -0
  158. package/dist/types/core/format/grammar/AstRenderer.d.ts +10 -0
  159. package/dist/types/core/format/grammar/FormatCompiler.d.ts +16 -0
  160. package/dist/types/core/format/index.d.ts +55 -0
  161. package/dist/types/core/format/pipeline/DomainTypeResolver.d.ts +8 -0
  162. package/dist/types/core/format/pipeline/LocaleFormat.d.ts +11 -0
  163. package/dist/types/core/format/pipeline/ValueInterpreter.d.ts +8 -0
  164. package/dist/types/core/format/policy/MaskPolicy.d.ts +8 -0
  165. package/dist/types/core/format/policy/NegativePolicy.d.ts +12 -0
  166. package/dist/types/core/format/policy/NullPolicy.d.ts +10 -0
  167. package/dist/types/core/format/policy/TruncatePolicy.d.ts +11 -0
  168. package/dist/types/core/format/types.d.ts +292 -0
  169. package/dist/types/core/formula/CalcCacheStore.d.ts +89 -0
  170. package/dist/types/core/formula/CalcProvenance.d.ts +44 -0
  171. package/dist/types/core/formula/CalcService.d.ts +137 -0
  172. package/dist/types/core/formula/CyclePathReporter.d.ts +28 -0
  173. package/dist/types/core/formula/FormulaEvaluator.d.ts +35 -1
  174. package/dist/types/core/formula/FormulaGraph.d.ts +84 -7
  175. package/dist/types/core/formula/FormulaParser.d.ts +9 -0
  176. package/dist/types/core/formula/FormulaStore.d.ts +63 -1
  177. package/dist/types/core/formula/FunctionRegistry.d.ts +138 -0
  178. package/dist/types/core/formula/Generation.d.ts +86 -0
  179. package/dist/types/core/formula/RecalcCoordinator.d.ts +151 -9
  180. package/dist/types/core/formula/ReferenceRewriter.d.ts +81 -0
  181. package/dist/types/core/formula/functions/essential.d.ts +3 -0
  182. package/dist/types/core/formula/functions/extended/index.d.ts +10 -0
  183. package/dist/types/core/formula/normalizeRefs.d.ts +34 -3
  184. package/dist/types/core/formula/numericLiteral.d.ts +11 -1
  185. package/dist/types/core/formula/serializeFormula.d.ts +10 -1
  186. package/dist/types/core/host/CapabilityRegistry.d.ts +61 -0
  187. package/dist/types/core/host/GridHostDriver.d.ts +27 -0
  188. package/dist/types/core/host/GridHostPort.d.ts +37 -0
  189. package/dist/types/core/host/SliceOwnershipGuard.d.ts +27 -0
  190. package/dist/types/core/host/archCheck.d.ts +26 -0
  191. package/dist/types/core/host/index.d.ts +6 -0
  192. package/dist/types/core/host/reconcile.d.ts +22 -0
  193. package/dist/types/core/i18n/LocaleContext.d.ts +40 -0
  194. package/dist/types/core/i18n/types.d.ts +26 -1
  195. package/dist/types/core/icons/bootstrap-icons.d.ts +4 -2
  196. package/dist/types/core/quality/ContrastAuditor.d.ts +64 -0
  197. package/dist/types/core/quality/DeterminismKernel.d.ts +68 -0
  198. package/dist/types/core/quality/PerfBaseline.d.ts +23 -0
  199. package/dist/types/core/quality/PerfSpec.d.ts +95 -0
  200. package/dist/types/core/quality/RealBrowserGate.d.ts +69 -0
  201. package/dist/types/core/quality/RegressionJudge.d.ts +35 -0
  202. package/dist/types/core/quality/ReleaseGate.d.ts +94 -0
  203. package/dist/types/core/quality/VisualRegression.d.ts +74 -0
  204. package/dist/types/core/quality/hooks.d.ts +53 -0
  205. package/dist/types/core/quality/index.d.ts +20 -0
  206. package/dist/types/core/quality/pixelMetrics.d.ts +24 -0
  207. package/dist/types/core/range/ClipboardCodec.d.ts +46 -4
  208. package/dist/types/core/range/FillEngine.d.ts +69 -9
  209. package/dist/types/core/range/RangeModel.d.ts +100 -13
  210. package/dist/types/core/range/types.d.ts +27 -11
  211. package/dist/types/core/realtime/BackpressureScheduler.d.ts +0 -0
  212. package/dist/types/core/realtime/FreshnessClock.d.ts +34 -0
  213. package/dist/types/core/realtime/IRealtimeSource.d.ts +82 -0
  214. package/dist/types/core/realtime/LiveStateGuard.d.ts +23 -0
  215. package/dist/types/core/realtime/PollingSource.d.ts +42 -0
  216. package/dist/types/core/realtime/RealtimeController.d.ts +54 -0
  217. package/dist/types/core/realtime/RtAnnouncePolicy.d.ts +53 -0
  218. package/dist/types/core/realtime/RtApplyCommand.d.ts +29 -0
  219. package/dist/types/core/realtime/RtChartTargetTrigger.d.ts +26 -0
  220. package/dist/types/core/realtime/StreamingSource.d.ts +47 -0
  221. package/dist/types/core/realtime/backoff.d.ts +12 -0
  222. package/dist/types/core/realtime/index.d.ts +13 -0
  223. package/dist/types/core/realtime/ports.d.ts +80 -0
  224. package/dist/types/core/render/CellApplier.d.ts +18 -0
  225. package/dist/types/core/render/CellErrorBoundary.d.ts +65 -0
  226. package/dist/types/core/render/CellPipeline.d.ts +39 -0
  227. package/dist/types/core/render/CellRenderRequest.d.ts +209 -0
  228. package/dist/types/core/render/CellStageRegistry.d.ts +53 -0
  229. package/dist/types/core/render/OverlayCompositor.d.ts +38 -0
  230. package/dist/types/core/render/RenderBudget.d.ts +67 -0
  231. package/dist/types/core/render/contrast.d.ts +33 -0
  232. package/dist/types/core/render/index.d.ts +35 -0
  233. package/dist/types/core/render/stages/BackgroundStage.d.ts +14 -0
  234. package/dist/types/core/render/stages/DecoratorStage.d.ts +12 -0
  235. package/dist/types/core/render/stages/OverlayStage.d.ts +12 -0
  236. package/dist/types/core/render/stages/ValueRendererStage.d.ts +15 -0
  237. package/dist/types/core/render/stages/index.d.ts +14 -0
  238. package/dist/types/core/state/AutosaveController.d.ts +63 -0
  239. package/dist/types/core/state/IStatePersistence.d.ts +59 -0
  240. package/dist/types/core/state/MultiTabGuard.d.ts +33 -0
  241. package/dist/types/core/state/SchemaMigrator.d.ts +33 -0
  242. package/dist/types/core/state/SemVerPolicy.d.ts +39 -0
  243. package/dist/types/core/state/StateCodec.d.ts +75 -0
  244. package/dist/types/core/state/index.d.ts +6 -0
  245. package/dist/types/core/types.d.ts +17 -0
  246. package/dist/types/react/OpenGrid.d.ts +54 -0
  247. package/dist/types/react/index.d.ts +5 -0
  248. package/dist/types/realtime/index.d.ts +1 -0
  249. package/dist/types/vue/index.d.ts +5 -0
  250. package/dist/types/vue/types.d.ts +35 -0
  251. package/package.json +112 -111
@@ -0,0 +1,17 @@
1
+ import { ICommand, ICommandCtx, CommandDTO, CommandFootprint } from '../ICommand.js';
2
+ /** 여러 커맨드를 단일 undo 단위로 묶는 합성 커맨드. / Composite command folding many commands into one undo unit. */
3
+ export declare class CompositeCommand<T = any> implements ICommand<T> {
4
+ readonly label: string;
5
+ private readonly _children;
6
+ readonly spi: "command";
7
+ readonly kind = "composite";
8
+ private _at;
9
+ constructor(label: string, _children: ReadonlyArray<ICommand<T>>);
10
+ /** 매크로는 구조 변경을 포함할 수 있으므로 보수적으로 structure 로 신고(dirty 안전측). / Conservative structure footprint. */
11
+ get footprint(): CommandFootprint;
12
+ get size(): number;
13
+ get children(): ReadonlyArray<ICommand<T>>;
14
+ do(ctx: ICommandCtx<T>): void;
15
+ undo(ctx: ICommandCtx<T>): void;
16
+ serialize(): CommandDTO;
17
+ }
@@ -0,0 +1,39 @@
1
+ import { ICommand, ICommandCtx, CommandDTO, CommandFootprint } from '../ICommand.js';
2
+ /** 행 하나를 삽입하는 커맨드. undo 는 do 가 부여받은 rowId 로 그 행을 삭제. / Insert a single row. */
3
+ export declare class RowInsertCommand<T = any> implements ICommand<T> {
4
+ readonly item: Partial<T>;
5
+ readonly position: number | 'first' | 'last';
6
+ readonly spi: "command";
7
+ readonly kind = "row.insert";
8
+ readonly label = "cmd.rowInsert";
9
+ private _rowId;
10
+ private _at;
11
+ constructor(item: Partial<T>, position?: number | 'first' | 'last');
12
+ get footprint(): CommandFootprint;
13
+ do(ctx: ICommandCtx<T>): void;
14
+ undo(ctx: ICommandCtx<T>): void;
15
+ serialize(): CommandDTO;
16
+ }
17
+ /** DTO payload → RowInsertCommand. / Rehydrate a RowInsertCommand from a DTO payload. */
18
+ export declare function rowInsertFromPayload<T = any>(payload: unknown): RowInsertCommand<T>;
19
+ /**
20
+ * 하나 이상의 행을 제거하는 커맨드. do 는 삭제 전 rowId·index·스냅샷을 동결, undo 는 원래 index 오름차순으로
21
+ * 스냅샷을 재삽입(각 삽입이 뒤 index 를 밀어 위치 정합).
22
+ * / Deletes one or more rows. do freezes rowId/index/snapshot before removal; undo reinserts by
23
+ * ascending original index (each insert shifts later indices back into place).
24
+ */
25
+ export declare class RowDeleteCommand<T = any> implements ICommand<T> {
26
+ readonly indices: readonly number[];
27
+ readonly spi: "command";
28
+ readonly kind = "row.delete";
29
+ readonly label = "cmd.rowDelete";
30
+ private _removed;
31
+ private _at;
32
+ constructor(indices: readonly number[]);
33
+ get footprint(): CommandFootprint;
34
+ do(ctx: ICommandCtx<T>): void;
35
+ undo(ctx: ICommandCtx<T>): void;
36
+ serialize(): CommandDTO;
37
+ }
38
+ /** DTO payload → RowDeleteCommand(복원). 재삽입 스냅샷을 그대로 싣는다. / Rehydrate a RowDeleteCommand. */
39
+ export declare function rowDeleteFromPayload<T = any>(payload: unknown): RowDeleteCommand<T>;
@@ -0,0 +1,9 @@
1
+ export type { ICommand, ICommandCtx, CommandDTO, CommandFootprint, MutationServiceFacade, CoordResolver, ValueEquality, FrozenClock, } from './ICommand.js';
2
+ export { defaultValueEquality, systemClock } from './ICommand.js';
3
+ export { CommandStack, type CommandStackConfig } from './CommandStack.js';
4
+ export { CommandBus, type CommandBusDeps } from './CommandBus.js';
5
+ export { DefaultAuditLog, DirtyTracker, MutationGuard, type AuditLog, type MutationViolationSink, } from './support.js';
6
+ export { DefaultCommandRegistry, RehydrateError, type CommandRegistry, type CommandSpec, } from './CommandRegistry.js';
7
+ export { CellWriteCommand, cellWriteFromPayload } from './commands/CellWriteCommand.js';
8
+ export { RowInsertCommand, RowDeleteCommand, rowInsertFromPayload, rowDeleteFromPayload, } from './commands/RowCommands.js';
9
+ export { CompositeCommand } from './commands/CompositeCommand.js';
@@ -0,0 +1,51 @@
1
+ import { CommandDTO, CommandFootprint } from './ICommand.js';
2
+ /** 커맨드 스트림 → 감사 로그(협업/디버그/재생). 순수 append. / Command stream → audit log (append-only). */
3
+ export interface AuditLog {
4
+ record(dto: CommandDTO): void;
5
+ /** 리비전(로그 인덱스) 이후 레코드. / Records since a revision (log index). */
6
+ since(rev: number): CommandDTO[];
7
+ all(): CommandDTO[];
8
+ readonly length: number;
9
+ }
10
+ /** 기본 인메모리 감사 로그. / Default in-memory audit log. */
11
+ export declare class DefaultAuditLog implements AuditLog {
12
+ private _log;
13
+ record(dto: CommandDTO): void;
14
+ since(rev: number): CommandDTO[];
15
+ all(): CommandDTO[];
16
+ get length(): number;
17
+ }
18
+ /**
19
+ * 마지막 저장 이후 변경 footprint 집합. RPO/부분저장/저장버튼 활성화 근거.
20
+ * / Set of change footprints since the last save. Basis for RPO / partial save / save-button state.
21
+ */
22
+ export declare class DirtyTracker {
23
+ private _fps;
24
+ private _dirty;
25
+ mark(fp: CommandFootprint): void;
26
+ isDirty(): boolean;
27
+ /** 저장 완료 후 dirty 해제(rev 인자는 MVP 미사용 — 전량 클리어). / Clear dirty after save (rev unused in MVP). */
28
+ clearTo(_rev?: number): void;
29
+ snapshot(): CommandFootprint[];
30
+ }
31
+ /** dev 우회변이 감지 위반 싱크. / Dev bypass-mutation violation sink. */
32
+ export type MutationViolationSink = (op: string) => void;
33
+ /**
34
+ * dev 모드: dispatch 구간 밖에서 모델 변이가 일어나면 경고(불변식 §1 단일 쓰기 경로).
35
+ * enter/leave 로 dispatch 구간을 표시하고, assertInside 로 우회를 감지한다.
36
+ * / Dev mode: warns when a mutation happens outside a dispatch window (invariant §1, single write path).
37
+ */
38
+ export declare class MutationGuard {
39
+ private _depth;
40
+ private readonly _sink;
41
+ private readonly _dev;
42
+ constructor(opts?: {
43
+ onViolation?: MutationViolationSink;
44
+ dev?: boolean;
45
+ });
46
+ enter(): void;
47
+ leave(): void;
48
+ get inside(): boolean;
49
+ /** dispatch 구간 밖에서 호출되면 위반 신고. / Reports a violation if called outside a dispatch window. */
50
+ assertInside(op: string): void;
51
+ }
@@ -0,0 +1,30 @@
1
+ import { Px, LeafColIndex } from './types.js';
2
+ /**
3
+ * 가로 축(리프 컬럼) 메트릭. 부분합으로 O(logN) index↔pixel. 순수 불변.
4
+ * / Horizontal leaf-column metrics; prefix sums for O(logN) index↔pixel. Pure & immutable.
5
+ */
6
+ export declare class ColumnMetrics {
7
+ private readonly _widths;
8
+ private readonly _left;
9
+ private readonly _frozenLeft;
10
+ /**
11
+ * @param widths 표시 리프 순서의 너비(px) / per visible-leaf widths
12
+ * @param frozenLeft 좌측 고정 리프 수 / left-frozen leaf count
13
+ */
14
+ constructor(widths: readonly Px[], frozenLeft: number);
15
+ /** 리프 컬럼 총수. / Total leaf columns. */
16
+ get count(): number;
17
+ /** 전체 콘텐츠 폭. / Total content width. */
18
+ totalWidth(): Px;
19
+ /** 컬럼 좌측 x(부분합). / Column left x (prefix sum). */
20
+ leftOf(col: LeafColIndex): Px;
21
+ /** 컬럼 너비. / Column width. */
22
+ widthOf(col: LeafColIndex): Px;
23
+ /** x → col(이분탐색). / x → col (binary search). */
24
+ colAt(x: Px): LeafColIndex;
25
+ /** 좌측 고정 리프 수. / Left-frozen leaf count. */
26
+ get frozenLeft(): number;
27
+ /** 고정 팬 폭(첫 frozenLeft 합). / Frozen pane width (sum of first frozenLeft). */
28
+ frozenWidth(): Px;
29
+ private _clampCol;
30
+ }
@@ -0,0 +1,88 @@
1
+ import { Px, ViewIndex, LeafColIndex, ModelIndex, IndexRange, CellRect, CellPlacement, PaneId } from './types.js';
2
+ import { RowMetrics } from './RowMetrics.js';
3
+ import { ColumnMetrics } from './ColumnMetrics.js';
4
+ import { ViewPermutation } from './ViewPermutation.js';
5
+ import { FrozenPanes } from './FrozenPanes.js';
6
+ import { NodeBudget } from './NodeBudget.js';
7
+ import { IMergeSource, IWindowingPort } from './ports.js';
8
+ /** 한 프레임의 불변 좌표 스냅샷 — 소비처는 이것만 읽는다. / Immutable per-frame snapshot. */
9
+ export interface CoordinateSnapshot {
10
+ readonly range: IndexRange;
11
+ readonly colRange: {
12
+ start: LeafColIndex;
13
+ end: LeafColIndex;
14
+ };
15
+ readonly offsetY: Px;
16
+ readonly totalHeight: Px;
17
+ readonly totalWidth: Px;
18
+ readonly nodeBudget: {
19
+ estimatedNodes: number;
20
+ withinBudget: boolean;
21
+ };
22
+ readonly clamped: {
23
+ viewport: boolean;
24
+ nodes: boolean;
25
+ };
26
+ }
27
+ /** 커널 조립 의존성. / Kernel assembly dependencies. */
28
+ export interface CoordinateKernelDeps {
29
+ perm: ViewPermutation;
30
+ rows: RowMetrics;
31
+ cols: ColumnMetrics;
32
+ frozen: FrozenPanes;
33
+ merges: IMergeSource;
34
+ budget: NodeBudget;
35
+ /** 세로/가로 윈도 오버스캔(기본 = budget.overscan). / windowing overscan. */
36
+ overscan?: number;
37
+ }
38
+ /**
39
+ * 좌표 변환 전권 SSOT. 순수 함수 커널(전역 미접근).
40
+ * / The coordinate authority. Pure kernel with no global access.
41
+ */
42
+ export declare class CoordinateKernel implements IWindowingPort {
43
+ private readonly perm;
44
+ private readonly rows;
45
+ private readonly cols;
46
+ private readonly frozen;
47
+ private readonly merges;
48
+ private readonly budget;
49
+ private readonly overscan;
50
+ constructor(deps: CoordinateKernelDeps);
51
+ /** v → m. / view → model. */
52
+ toModel(v: ViewIndex): ModelIndex;
53
+ /** m → v(-1 = 소멸). / model → view (-1 if gone). */
54
+ toView(m: ModelIndex): ViewIndex | -1;
55
+ /** 셀 완전 배치 — 소비처 SSOT. / Full cell placement — consumer SSOT. */
56
+ placeCell(view: ViewIndex, col: LeafColIndex): CellPlacement;
57
+ /** 셀 범위 사각형(frozen 경계 넘어도 콘텐츠 좌표 통합 사각형). / Rect covering an inclusive cell range. */
58
+ rectOfRange(a: {
59
+ view: ViewIndex;
60
+ col: LeafColIndex;
61
+ }, b: {
62
+ view: ViewIndex;
63
+ col: LeafColIndex;
64
+ }): CellRect;
65
+ /** 픽셀 → (view,col,pane). 은폐 셀은 앵커로 흡수. / Pixel → cell; hidden cells resolve to anchor. */
66
+ hitTest(x: Px, y: Px): {
67
+ view: ViewIndex;
68
+ col: LeafColIndex;
69
+ pane: PaneId;
70
+ } | null;
71
+ /** 세로 가시 view 범위(overscan 포함, 반열림). / Vertical visible range (overscan, half-open). */
72
+ verticalWindow(scrollTop: Px, viewportH: Px): IndexRange;
73
+ /** 가로 가시 리프 컬럼 범위(overscan 포함, 반열림). / Horizontal visible range. */
74
+ horizontalWindow(scrollLeft: Px, viewportW: Px): {
75
+ start: LeafColIndex;
76
+ end: LeafColIndex;
77
+ };
78
+ /** 뷰포트/노드예산/클램프 일괄 산출. / Compute range + budget + clamp in one shot. */
79
+ snapshot(scroll: {
80
+ top: Px;
81
+ left: Px;
82
+ }, viewport: {
83
+ h: Px;
84
+ w: Px;
85
+ }): CoordinateSnapshot;
86
+ /** 지정 view 가 보이도록 하는 scrollTop(이미 보이면 cur 유지). / scrollTop to reveal a view. */
87
+ scrollTopFor(view: ViewIndex, viewportH: Px, cur: Px): Px;
88
+ }
@@ -0,0 +1,29 @@
1
+ import { Px, ViewIndex, LeafColIndex, PaneId } from './types.js';
2
+ import { RowMetrics } from './RowMetrics.js';
3
+ import { ColumnMetrics } from './ColumnMetrics.js';
4
+ /**
5
+ * 고정 행/열 분할 상태. 순수 불변.
6
+ * / Frozen row/column split. Pure & immutable.
7
+ */
8
+ export declare class FrozenPanes {
9
+ private readonly _rows;
10
+ private readonly _cols;
11
+ /**
12
+ * @param opts.rows 상단 고정 행 수 / top-frozen row count
13
+ * @param opts.cols 좌측 고정 컬럼 수 / left-frozen column count
14
+ */
15
+ constructor(opts: {
16
+ rows: number;
17
+ cols: number;
18
+ });
19
+ /** 상단 고정 행 수. / Top-frozen row count. */
20
+ get rows(): number;
21
+ /** 좌측 고정 컬럼 수. / Left-frozen column count. */
22
+ get cols(): number;
23
+ /** 어느 팬에 속하는가 — view/col 를 팬으로 분류. / Classify (view,col) into a pane. */
24
+ paneOf(view: ViewIndex, col: LeafColIndex): PaneId;
25
+ /** 본문 스크롤에서 제외되는 상단 고정 높이. / Top-frozen height excluded from body scroll. */
26
+ topOffset(rm: RowMetrics): Px;
27
+ /** 본문 스크롤에서 제외되는 좌측 고정 폭. / Left-frozen width excluded from body scroll. */
28
+ leftOffset(cm: ColumnMetrics): Px;
29
+ }
@@ -0,0 +1,18 @@
1
+ import { MergeEngine } from '../MergeEngine.js';
2
+ import { IMergeSource } from './ports.js';
3
+ import { ViewIndex, LeafColIndex } from './types.js';
4
+ /**
5
+ * MergeEngine → IMergeSource 어댑터(내부 무변경). / Adapter wrapping MergeEngine as IMergeSource.
6
+ */
7
+ export declare class MergeSourceAdapter implements IMergeSource {
8
+ private readonly _engine;
9
+ constructor(_engine: MergeEngine);
10
+ getInfo(view: ViewIndex, col: LeafColIndex): {
11
+ rowSpan: number;
12
+ colSpan: number;
13
+ hidden: boolean;
14
+ } | null;
15
+ get isEmpty(): boolean;
16
+ }
17
+ /** 병합이 전혀 없는 빈 소스(균일 fast-path). / Empty merge source (uniform fast-path). */
18
+ export declare const EMPTY_MERGE_SOURCE: IMergeSource;
@@ -0,0 +1,33 @@
1
+ /** 노드 예산 판정 결과. / Node budget evaluation result. */
2
+ export interface NodeBudgetResult {
3
+ readonly estimatedNodes: number;
4
+ readonly withinBudget: boolean;
5
+ /** 예산 초과 시에만 존재 — 세로 윈도 축소 목표 행수. / Present only when over budget. */
6
+ readonly clampedRows?: number;
7
+ }
8
+ /**
9
+ * DOM 라이브 노드 상한 예산 계산기. 순수.
10
+ * / DOM live-node budget calculator. Pure.
11
+ */
12
+ export declare class NodeBudget {
13
+ private readonly _maxNodes;
14
+ private readonly _overscan;
15
+ /**
16
+ * @param opts.maxNodes 라이브 노드 상한(기본 5000) / live-node cap (default 5000)
17
+ * @param opts.overscan 기본 오버스캔(기본 5) / default overscan (default 5)
18
+ */
19
+ constructor(opts?: {
20
+ maxNodes?: number;
21
+ overscan?: number;
22
+ });
23
+ /** 상한(기본 5000). / Node cap. */
24
+ get maxNodes(): number;
25
+ /** 기본 오버스캔. / Default overscan. */
26
+ get overscan(): number;
27
+ /** 가시행수×표시열수+버퍼 → 예산 판정. / Evaluate rows×cols+buffer against the cap. */
28
+ evaluate(input: {
29
+ visibleRows: number;
30
+ visibleCols: number;
31
+ overscanRows: number;
32
+ }): NodeBudgetResult;
33
+ }
@@ -0,0 +1,50 @@
1
+ import { Px } from './types.js';
2
+ /** admit 판정 결과. / Result of an admit decision. */
3
+ export type ResizeDecision = {
4
+ kind: 'apply';
5
+ height: Px;
6
+ width: Px;
7
+ clamped: boolean;
8
+ } | {
9
+ kind: 'ignore';
10
+ reason: 'below-threshold' | 'reentrant' | 'oscillation' | 'coalesced';
11
+ };
12
+ /** governor 통계(회귀 게이트가 pull). / Governor stats (pulled by regression gate). */
13
+ export interface ResizeStats {
14
+ readonly passesThisFrame: number;
15
+ readonly oscillationDetected: boolean;
16
+ readonly lastConvergedInPasses: number;
17
+ }
18
+ /**
19
+ * ResizeObserver 되먹임 차단 계약. 순수 판정(임계값·재진입·진동·클램프).
20
+ * / Guarded governor for resize feedback. Pure decisions (threshold, reentrancy, oscillation, clamp).
21
+ */
22
+ export declare class ResizeGovernor {
23
+ private readonly _minDeltaPx;
24
+ private readonly _maxPassesPerFrame;
25
+ private readonly _fallback;
26
+ private _last;
27
+ private _passesThisFrame;
28
+ private _oscillationDetected;
29
+ private _lastConvergedInPasses;
30
+ private readonly _ring;
31
+ /**
32
+ * @param opts.minDeltaPx 크기 변화 임계값(기본 1px) / size-change threshold
33
+ * @param opts.maxPassesPerFrame 프레임당 재계산 상한(기본 1) / recompute cap per frame
34
+ * @param opts.fallbackViewportHeight 언바운드/0 클램프 목표 / clamp target for unbounded/0
35
+ */
36
+ constructor(opts: {
37
+ minDeltaPx?: Px;
38
+ maxPassesPerFrame?: number;
39
+ fallbackViewportHeight: Px;
40
+ });
41
+ /** 관측 크기 유입 → 반영해도 되는지 판정(진동·재진입 차단). / Admit an observed box. */
42
+ admit(box: {
43
+ height: number;
44
+ width: number;
45
+ }): ResizeDecision;
46
+ /** 프레임 경계 — 재진입/패스 카운터·진동 플래그 리셋. shell 이 rAF 마다 호출. / Frame boundary reset. */
47
+ beginFrame(): void;
48
+ /** 진동 감지·수렴 통계(회귀 게이트가 pull). / Convergence/oscillation stats. */
49
+ stats(): ResizeStats;
50
+ }
@@ -0,0 +1,37 @@
1
+ import { Px, ViewIndex } from './types.js';
2
+ /**
3
+ * 세로 축(행) 메트릭. 균일/가변(autoHeight) 겸용. 순수 불변.
4
+ * / Vertical row metrics; uniform and variable (autoHeight). Pure & immutable.
5
+ */
6
+ export declare class RowMetrics {
7
+ private readonly _rowHeight;
8
+ private readonly _total;
9
+ private readonly _overrides;
10
+ private readonly _pos;
11
+ private readonly _prefDelta;
12
+ private readonly _totalDelta;
13
+ /**
14
+ * @param opts.rowHeight 균일 행 높이(px) / uniform row height
15
+ * @param opts.total 가시(view) 행 총수 / total visible rows
16
+ * @param overrides autoHeight 측정 override(내부 재조립용, 선택) / measured overrides (internal)
17
+ */
18
+ constructor(opts: {
19
+ rowHeight: Px;
20
+ total: number;
21
+ }, overrides?: ReadonlyMap<number, number>);
22
+ /** 가시(view) 행 총수. / Total visible rows. */
23
+ get total(): number;
24
+ /** 콘텐츠 전체 높이(spacer 산출용). / Total content height (for spacer). */
25
+ totalHeight(): Px;
26
+ /** 행 상단 y(부분합). / Row top y (prefix sum). */
27
+ topOf(view: ViewIndex): Px;
28
+ /** 행 높이(override 우선). / Row height (override wins). */
29
+ heightOf(view: ViewIndex): Px;
30
+ /** y → view(이분탐색, 클램프). / y → view (binary search, clamped). */
31
+ indexAt(y: Px): ViewIndex;
32
+ /** 측정 캐시 주입(되먹임 차단의 핵심) — 새 불변 인스턴스 반환. / Apply measured overrides; returns a new instance. */
33
+ applyMeasured(overrides: ReadonlyMap<ViewIndex, Px>): RowMetrics;
34
+ /** 총 행수 변경 — 새 불변 인스턴스 반환. / Change total; returns a new instance. */
35
+ setTotal(total: number): RowMetrics;
36
+ private _clampView;
37
+ }
@@ -0,0 +1,23 @@
1
+ import { ModelIndex, ViewIndex } from './types.js';
2
+ /**
3
+ * model↔view 순열. 미필터면 항등(null). 순수 불변.
4
+ * / model↔view permutation; identity when null. Pure & immutable.
5
+ */
6
+ export declare class ViewPermutation {
7
+ private readonly _viewOrder;
8
+ private readonly _modelTotal;
9
+ private readonly _reverse;
10
+ /**
11
+ * @param viewOrder viewOrder[v] = m; null = 항등 / identity when null
12
+ * @param modelTotal 원본 행 총수 / total model rows
13
+ */
14
+ constructor(viewOrder: readonly ModelIndex[] | null, modelTotal: number);
15
+ /** 가시(view) 행 총수. / Total visible rows. */
16
+ get viewCount(): number;
17
+ /** v → m. 항등이면 그대로. / view → model. */
18
+ toModel(view: ViewIndex): ModelIndex;
19
+ /** m → v(숨김/필터아웃이면 -1). 역인덱스 O(1). / model → view (-1 if hidden). */
20
+ toView(model: ModelIndex): ViewIndex | -1;
21
+ /** model 이 현재 가시인지. / Whether a model row is currently visible. */
22
+ isVisible(model: ModelIndex): boolean;
23
+ }
@@ -0,0 +1,10 @@
1
+ export { type ModelIndex, type ViewIndex, type LeafColIndex, type Px, type IndexRange, type CellRect, type PaneId, type CellPlacement, px, modelIndex, viewIndex, leafColIndex, makeRange, makeRect, unbrandPx, } from './types.js';
2
+ export { RowMetrics } from './RowMetrics.js';
3
+ export { ColumnMetrics } from './ColumnMetrics.js';
4
+ export { ViewPermutation } from './ViewPermutation.js';
5
+ export { FrozenPanes } from './FrozenPanes.js';
6
+ export { NodeBudget, type NodeBudgetResult } from './NodeBudget.js';
7
+ export { ResizeGovernor, type ResizeDecision, type ResizeStats } from './ResizeGovernor.js';
8
+ export { CoordinateKernel, type CoordinateSnapshot, type CoordinateKernelDeps, } from './CoordinateKernel.js';
9
+ export { type IWindowingPort, type IMeasurementSeam, type IMergeSource, type SliceKey, SLICE_OWNERSHIP, } from './ports.js';
10
+ export { MergeSourceAdapter, EMPTY_MERGE_SOURCE } from './MergeSourceAdapter.js';
@@ -0,0 +1,45 @@
1
+ import { Px, ViewIndex, LeafColIndex, IndexRange } from './types.js';
2
+ /** 세로/가로 공통 윈도잉 포트(REQ-T3-817). / Common vertical/horizontal windowing port. */
3
+ export interface IWindowingPort {
4
+ verticalWindow(scrollTop: Px, viewportH: Px): IndexRange;
5
+ horizontalWindow(scrollLeft: Px, viewportW: Px): {
6
+ start: LeafColIndex;
7
+ end: LeafColIndex;
8
+ };
9
+ }
10
+ /** DOM 측정 이음새(humble shell 구현) — 커널은 촉발하지 않음. / DOM measurement seam (shell-implemented). */
11
+ export interface IMeasurementSeam {
12
+ /** view 행들의 실제 렌더 높이 읽기(reflow 는 shell 책임). / Read rendered heights of rows. */
13
+ measureRows(views: readonly ViewIndex[]): ReadonlyMap<ViewIndex, Px>;
14
+ /** 컨테이너 clientHeight/Width 읽기(언바운드/0 감지 원천). / Read container box. */
15
+ readViewportBox(): {
16
+ height: number;
17
+ width: number;
18
+ };
19
+ }
20
+ /** 병합 스팬 조회 어댑터 — MergeEngine.getInfo 를 커널 계약으로 래핑. 순수. / Merge span source. */
21
+ export interface IMergeSource {
22
+ getInfo(view: ViewIndex, col: LeafColIndex): {
23
+ rowSpan: number;
24
+ colSpan: number;
25
+ hidden: boolean;
26
+ } | null;
27
+ readonly isEmpty: boolean;
28
+ }
29
+ /**
30
+ * 슬라이스별 단일 소유자 규정(REQ-TX-841) — 비소유 모듈 직접 변이 차단(lint/런타임 가드 근거).
31
+ * 좌표 커널은 아래 슬라이스를 읽기 전용 입력으로만 받는다.
32
+ * / Single-owner map for state slices; the kernel takes these as read-only inputs only.
33
+ */
34
+ export declare const SLICE_OWNERSHIP: {
35
+ readonly totalRows: "DataLayer";
36
+ readonly viewOrder: "SortFilterManager";
37
+ readonly scroll: "ViewportController";
38
+ readonly frozen: "ViewportController";
39
+ readonly viewport: "ViewportController";
40
+ readonly rowHeight: "AppearanceResolver";
41
+ readonly measured: "MeasurementSeam";
42
+ readonly selection: "SelectionModel";
43
+ };
44
+ /** 슬라이스 키. / Slice key. */
45
+ export type SliceKey = keyof typeof SLICE_OWNERSHIP;
@@ -0,0 +1,76 @@
1
+ /** 원본 데이터 행 인덱스(0-base). / Original data row index (0-based). */
2
+ export type ModelIndex = number & {
3
+ readonly __brand: 'ModelIndex';
4
+ };
5
+ /** filter/sort/group 후 가시 순번(0-base). / Visible order index after filter/sort/group. */
6
+ export type ViewIndex = number & {
7
+ readonly __brand: 'ViewIndex';
8
+ };
9
+ /** 표시 리프 컬럼 순번(0-base). / Visible leaf column index. */
10
+ export type LeafColIndex = number & {
11
+ readonly __brand: 'LeafColIndex';
12
+ };
13
+ /** 콘텐츠 절대 픽셀. / Content-absolute pixel. */
14
+ export type Px = number & {
15
+ readonly __brand: 'Px';
16
+ };
17
+ /** number → Px. / Brand a number as Px. */
18
+ export declare const px: (n: number) => Px;
19
+ /** number → ModelIndex. */
20
+ export declare const modelIndex: (n: number) => ModelIndex;
21
+ /** number → ViewIndex. */
22
+ export declare const viewIndex: (n: number) => ViewIndex;
23
+ /** number → LeafColIndex. */
24
+ export declare const leafColIndex: (n: number) => LeafColIndex;
25
+ /** 반열림 index 범위 [start, end). 불변. / Half-open index range [start, end). Immutable. */
26
+ export interface IndexRange {
27
+ readonly start: ViewIndex;
28
+ readonly end: ViewIndex;
29
+ }
30
+ /**
31
+ * 콘텐츠 좌표계 사각형(스크롤 절대·frozen 반영 전). 불변.
32
+ * ★대표 소유(SSOT) = DD-02.
33
+ * / Content-coordinate rectangle (scroll-absolute, pre-frozen). Immutable. Owned by DD-02.
34
+ */
35
+ export interface CellRect {
36
+ readonly x: Px;
37
+ readonly y: Px;
38
+ readonly w: Px;
39
+ readonly h: Px;
40
+ }
41
+ /** 어느 팬(pane)에 속하는지 — 좌표 소비처의 컨테이너 선택 키. / Which pane a cell belongs to. */
42
+ export type PaneId = 'body' | 'frozen-left' | 'frozen-top' | 'frozen-corner';
43
+ /** 셀 하나의 완전 배치 — 소비처가 자체 산술 없이 그대로 쓴다. / Full placement of a single cell. */
44
+ export interface CellPlacement {
45
+ readonly view: ViewIndex;
46
+ readonly col: LeafColIndex;
47
+ /** 콘텐츠 좌표 사각형(merge 반영). / Content-coordinate rect (merge-applied). */
48
+ readonly rect: CellRect;
49
+ /** 소속 팬(고정/본문). / Owning pane (frozen/body). */
50
+ readonly pane: PaneId;
51
+ /** merge 반영 세로 스팬. / Row span (merge). */
52
+ readonly rowSpan: number;
53
+ /** merge 반영 가로 스팬. / Column span (merge). */
54
+ readonly colSpan: number;
55
+ /** merge 에 삼켜진 셀(렌더 생략). / Cell swallowed by a merge (render-skipped). */
56
+ readonly hidden: boolean;
57
+ }
58
+ /**
59
+ * 반열림 index 범위 생성(불변식 start ≤ end 보증). / Build an IndexRange (guarantees start ≤ end).
60
+ */
61
+ export declare function makeRange(start: number, end: number): IndexRange;
62
+ /**
63
+ * 콘텐츠 사각형 생성(불변식 w,h ≥ 0 클램프). / Build a CellRect (clamps w,h ≥ 0).
64
+ */
65
+ export declare function makeRect(x: number, y: number, w: number, h: number): CellRect;
66
+ /**
67
+ * 경계 1회 언브랜드(§2.0 계약) — 소비처(DD-03 렌더)는 커널 출력 수령 지점에서 1회만 언브랜드하고
68
+ * 내부는 순수 number 로 흐르되 좌표 재산술은 금지한다.
69
+ * / Single unbrand at the boundary; consumers flow plain numbers inward without re-deriving coords.
70
+ */
71
+ export declare function unbrandPx(rect: CellRect): {
72
+ x: number;
73
+ y: number;
74
+ w: number;
75
+ h: number;
76
+ };