open-grid 1.2.1 → 1.3.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 (258) hide show
  1. package/CHANGELOG.md +388 -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/FilterSelect.d.ts +26 -5
  25. package/dist/types/core/FormulaEngine.d.ts +15 -4
  26. package/dist/types/core/GridRenderer.d.ts +143 -10
  27. package/dist/types/core/GridShuttle.d.ts +26 -10
  28. package/dist/types/core/GroupEngine.d.ts +68 -10
  29. package/dist/types/core/IconRegistry.d.ts +31 -13
  30. package/dist/types/core/MathUtils.d.ts +58 -5
  31. package/dist/types/core/MergeEngine.d.ts +45 -10
  32. package/dist/types/core/OGDecimal.d.ts +144 -13
  33. package/dist/types/core/OpenGrid.d.ts +401 -122
  34. package/dist/types/core/OrgChart.d.ts +32 -11
  35. package/dist/types/core/PivotEngine.d.ts +37 -0
  36. package/dist/types/core/RowDragDrop.d.ts +52 -6
  37. package/dist/types/core/SkinRegistry.d.ts +86 -19
  38. package/dist/types/core/TreeEngine.d.ts +60 -6
  39. package/dist/types/core/VirtualScroll.d.ts +64 -0
  40. package/dist/types/core/XmlConverter.d.ts +40 -0
  41. package/dist/types/core/a11y/AccessibilityAdapter.d.ts +103 -0
  42. package/dist/types/core/a11y/AriaIntent.d.ts +34 -0
  43. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +64 -0
  44. package/dist/types/core/a11y/LiveRegionController.d.ts +89 -0
  45. package/dist/types/core/a11y/OverlayStack.d.ts +36 -0
  46. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +37 -0
  47. package/dist/types/core/a11y/index.d.ts +13 -0
  48. package/dist/types/core/a11y/ports.d.ts +24 -0
  49. package/dist/types/core/appearance/Appearance.d.ts +68 -0
  50. package/dist/types/core/appearance/AppearanceAxis.d.ts +94 -0
  51. package/dist/types/core/appearance/AppearanceComposer.d.ts +45 -0
  52. package/dist/types/core/appearance/AppearanceProvider.d.ts +50 -0
  53. package/dist/types/core/appearance/AppearanceView.d.ts +51 -0
  54. package/dist/types/core/appearance/DensityRegistry.d.ts +36 -0
  55. package/dist/types/core/appearance/ResolvedAppearanceSnapshot.d.ts +84 -0
  56. package/dist/types/core/appearance/TextureRegistry.d.ts +32 -0
  57. package/dist/types/core/appearance/ThemeMetaRegistry.d.ts +67 -0
  58. package/dist/types/core/appearance/axisAdapters.d.ts +37 -0
  59. package/dist/types/core/appearance/defaults.d.ts +10 -0
  60. package/dist/types/core/appearance/index.d.ts +20 -0
  61. package/dist/types/core/appearance/tokenCatalog.d.ts +30 -0
  62. package/dist/types/core/cf/CFEngine.d.ts +56 -0
  63. package/dist/types/core/cf/CFEvaluator.d.ts +24 -0
  64. package/dist/types/core/cf/CFRule.d.ts +127 -0
  65. package/dist/types/core/cf/ColorScale.d.ts +49 -0
  66. package/dist/types/core/cf/InkResolver.d.ts +33 -0
  67. package/dist/types/core/cf/appearance.d.ts +20 -0
  68. package/dist/types/core/cf/encoders.d.ts +61 -0
  69. package/dist/types/core/cf/eval-types.d.ts +93 -0
  70. package/dist/types/core/cf/index.d.ts +21 -0
  71. package/dist/types/core/cf/lineage.d.ts +32 -0
  72. package/dist/types/core/cf/predicates.d.ts +27 -0
  73. package/dist/types/core/cf/serialize.d.ts +46 -0
  74. package/dist/types/core/chart/CanvasAdapter.d.ts +50 -1
  75. package/dist/types/core/chart/DataExtractor.d.ts +53 -12
  76. package/dist/types/core/chart/a11y.d.ts +22 -0
  77. package/dist/types/core/chart/chart-type-registry.d.ts +53 -0
  78. package/dist/types/core/chart/downsample-report.d.ts +36 -0
  79. package/dist/types/core/chart/downsample.d.ts +26 -1
  80. package/dist/types/core/chart/engine/ChartEngineRegistry.d.ts +52 -0
  81. package/dist/types/core/chart/geometry.d.ts +96 -0
  82. package/dist/types/core/chart/hittest.d.ts +21 -3
  83. package/dist/types/core/chart/palette.d.ts +96 -12
  84. package/dist/types/core/chart/parity.d.ts +12 -0
  85. package/dist/types/core/chart/provenance.d.ts +47 -0
  86. package/dist/types/core/chart/scales.d.ts +28 -1
  87. package/dist/types/core/chart/scene.d.ts +102 -0
  88. package/dist/types/core/chart/server.d.ts +36 -0
  89. package/dist/types/core/chart/surfaces/CanvasSurface.d.ts +48 -0
  90. package/dist/types/core/chart/surfaces/ServerRasterSurface.d.ts +26 -0
  91. package/dist/types/core/chart/surfaces/SvgSurface.d.ts +24 -0
  92. package/dist/types/core/chart/surfaces/pattern-overlay.d.ts +24 -0
  93. package/dist/types/core/chart/types.d.ts +102 -21
  94. package/dist/types/core/command/CommandBus.d.ts +51 -0
  95. package/dist/types/core/command/CommandRegistry.d.ts +43 -0
  96. package/dist/types/core/command/CommandStack.d.ts +38 -0
  97. package/dist/types/core/command/ICommand.d.ts +110 -0
  98. package/dist/types/core/command/commands/CellWriteCommand.d.ts +32 -0
  99. package/dist/types/core/command/commands/CompositeCommand.d.ts +17 -0
  100. package/dist/types/core/command/commands/RowCommands.d.ts +39 -0
  101. package/dist/types/core/command/index.d.ts +9 -0
  102. package/dist/types/core/command/support.d.ts +51 -0
  103. package/dist/types/core/coordinate/ColumnMetrics.d.ts +30 -0
  104. package/dist/types/core/coordinate/CoordinateKernel.d.ts +88 -0
  105. package/dist/types/core/coordinate/FrozenPanes.d.ts +29 -0
  106. package/dist/types/core/coordinate/MergeSourceAdapter.d.ts +18 -0
  107. package/dist/types/core/coordinate/NodeBudget.d.ts +33 -0
  108. package/dist/types/core/coordinate/ResizeGovernor.d.ts +50 -0
  109. package/dist/types/core/coordinate/RowMetrics.d.ts +37 -0
  110. package/dist/types/core/coordinate/ViewPermutation.d.ts +23 -0
  111. package/dist/types/core/coordinate/index.d.ts +10 -0
  112. package/dist/types/core/coordinate/ports.d.ts +45 -0
  113. package/dist/types/core/coordinate/types.d.ts +76 -0
  114. package/dist/types/core/detail/DetailGlyph.d.ts +42 -7
  115. package/dist/types/core/detail/DetailSplice.d.ts +42 -11
  116. package/dist/types/core/detail/DetailState.d.ts +80 -11
  117. package/dist/types/core/detail/SubgridCache.d.ts +72 -10
  118. package/dist/types/core/detail/index.d.ts +8 -0
  119. package/dist/types/core/domain/AggregateResult.d.ts +54 -0
  120. package/dist/types/core/domain/CellAddress.d.ts +61 -0
  121. package/dist/types/core/domain/CellValueAccess.d.ts +29 -0
  122. package/dist/types/core/domain/Delta.d.ts +37 -0
  123. package/dist/types/core/domain/DomainValue.d.ts +80 -0
  124. package/dist/types/core/domain/Missing.d.ts +65 -0
  125. package/dist/types/core/domain/Money.d.ts +42 -0
  126. package/dist/types/core/domain/NormalizationBasis.d.ts +47 -0
  127. package/dist/types/core/domain/Plain.d.ts +45 -0
  128. package/dist/types/core/domain/Quantity.d.ts +32 -0
  129. package/dist/types/core/domain/Ratios.d.ts +100 -0
  130. package/dist/types/core/domain/ThresholdSet.d.ts +46 -0
  131. package/dist/types/core/domain/ValueType.d.ts +71 -0
  132. package/dist/types/core/domain/rounding.d.ts +25 -0
  133. package/dist/types/core/domain/strategies.d.ts +38 -0
  134. package/dist/types/core/editors/DateEditor.d.ts +18 -0
  135. package/dist/types/core/editors/SelectEditor.d.ts +29 -0
  136. package/dist/types/core/export/ChannelRegistry.d.ts +18 -0
  137. package/dist/types/core/export/ExportManifest.d.ts +13 -0
  138. package/dist/types/core/export/GridArtifactSource.d.ts +62 -0
  139. package/dist/types/core/export/Provenance.d.ts +34 -0
  140. package/dist/types/core/export/StreamPump.d.ts +28 -0
  141. package/dist/types/core/export/channels/CsvChannel.d.ts +20 -0
  142. package/dist/types/core/export/channels/JsonChannel.d.ts +18 -0
  143. package/dist/types/core/export/channels/XlsxChannel.d.ts +53 -0
  144. package/dist/types/core/export/channels/XmlChannel.d.ts +21 -0
  145. package/dist/types/core/export/channels/capabilities.d.ts +13 -0
  146. package/dist/types/core/export/index.d.ts +24 -0
  147. package/dist/types/core/export/print/OutputChannelAdapter.d.ts +61 -0
  148. package/dist/types/core/export/print/Paginator.d.ts +48 -0
  149. package/dist/types/core/export/print/PrintRenderTarget.d.ts +36 -0
  150. package/dist/types/core/export/sinks.d.ts +40 -0
  151. package/dist/types/core/export/types.d.ts +211 -0
  152. package/dist/types/core/extension/DeprecationManager.d.ts +42 -0
  153. package/dist/types/core/extension/IExtension.d.ts +90 -0
  154. package/dist/types/core/extension/Registry.d.ts +142 -0
  155. package/dist/types/core/extension/SlotRegistry.d.ts +46 -0
  156. package/dist/types/core/extension/adapters.d.ts +44 -0
  157. package/dist/types/core/extension/conformance.d.ts +47 -0
  158. package/dist/types/core/extension/index.d.ts +16 -0
  159. package/dist/types/core/extension/registries.d.ts +31 -0
  160. package/dist/types/core/extension/reserved.d.ts +10 -0
  161. package/dist/types/core/format/DisplayFormatter.d.ts +47 -0
  162. package/dist/types/core/format/FormatCache.d.ts +20 -0
  163. package/dist/types/core/format/FormatterRegistry.d.ts +22 -0
  164. package/dist/types/core/format/grammar/AstRenderer.d.ts +10 -0
  165. package/dist/types/core/format/grammar/FormatCompiler.d.ts +16 -0
  166. package/dist/types/core/format/index.d.ts +55 -0
  167. package/dist/types/core/format/pipeline/DomainTypeResolver.d.ts +8 -0
  168. package/dist/types/core/format/pipeline/LocaleFormat.d.ts +11 -0
  169. package/dist/types/core/format/pipeline/ValueInterpreter.d.ts +8 -0
  170. package/dist/types/core/format/policy/MaskPolicy.d.ts +8 -0
  171. package/dist/types/core/format/policy/NegativePolicy.d.ts +12 -0
  172. package/dist/types/core/format/policy/NullPolicy.d.ts +10 -0
  173. package/dist/types/core/format/policy/TruncatePolicy.d.ts +11 -0
  174. package/dist/types/core/format/types.d.ts +292 -0
  175. package/dist/types/core/formula/CalcCacheStore.d.ts +89 -0
  176. package/dist/types/core/formula/CalcProvenance.d.ts +44 -0
  177. package/dist/types/core/formula/CalcService.d.ts +137 -0
  178. package/dist/types/core/formula/CyclePathReporter.d.ts +28 -0
  179. package/dist/types/core/formula/FormulaEvaluator.d.ts +35 -1
  180. package/dist/types/core/formula/FormulaGraph.d.ts +84 -7
  181. package/dist/types/core/formula/FormulaParser.d.ts +9 -0
  182. package/dist/types/core/formula/FormulaStore.d.ts +63 -1
  183. package/dist/types/core/formula/FunctionRegistry.d.ts +138 -0
  184. package/dist/types/core/formula/Generation.d.ts +86 -0
  185. package/dist/types/core/formula/RecalcCoordinator.d.ts +151 -9
  186. package/dist/types/core/formula/ReferenceRewriter.d.ts +81 -0
  187. package/dist/types/core/formula/functions/essential.d.ts +3 -0
  188. package/dist/types/core/formula/functions/extended/index.d.ts +10 -0
  189. package/dist/types/core/formula/normalizeRefs.d.ts +34 -3
  190. package/dist/types/core/formula/numericLiteral.d.ts +11 -1
  191. package/dist/types/core/formula/serializeFormula.d.ts +10 -1
  192. package/dist/types/core/host/CapabilityRegistry.d.ts +61 -0
  193. package/dist/types/core/host/GridHostDriver.d.ts +27 -0
  194. package/dist/types/core/host/GridHostPort.d.ts +37 -0
  195. package/dist/types/core/host/SliceOwnershipGuard.d.ts +27 -0
  196. package/dist/types/core/host/archCheck.d.ts +26 -0
  197. package/dist/types/core/host/index.d.ts +6 -0
  198. package/dist/types/core/host/reconcile.d.ts +22 -0
  199. package/dist/types/core/i18n/LocaleContext.d.ts +40 -0
  200. package/dist/types/core/i18n/LocaleRegistry.d.ts +0 -0
  201. package/dist/types/core/i18n/types.d.ts +67 -11
  202. package/dist/types/core/icons/bootstrap-icons.d.ts +4 -2
  203. package/dist/types/core/quality/ContrastAuditor.d.ts +64 -0
  204. package/dist/types/core/quality/DeterminismKernel.d.ts +68 -0
  205. package/dist/types/core/quality/PerfBaseline.d.ts +23 -0
  206. package/dist/types/core/quality/PerfSpec.d.ts +95 -0
  207. package/dist/types/core/quality/RealBrowserGate.d.ts +69 -0
  208. package/dist/types/core/quality/RegressionJudge.d.ts +35 -0
  209. package/dist/types/core/quality/ReleaseGate.d.ts +94 -0
  210. package/dist/types/core/quality/VisualRegression.d.ts +74 -0
  211. package/dist/types/core/quality/hooks.d.ts +53 -0
  212. package/dist/types/core/quality/index.d.ts +20 -0
  213. package/dist/types/core/quality/pixelMetrics.d.ts +24 -0
  214. package/dist/types/core/range/ClipboardCodec.d.ts +46 -4
  215. package/dist/types/core/range/FillEngine.d.ts +69 -9
  216. package/dist/types/core/range/RangeModel.d.ts +100 -13
  217. package/dist/types/core/range/types.d.ts +27 -11
  218. package/dist/types/core/realtime/BackpressureScheduler.d.ts +0 -0
  219. package/dist/types/core/realtime/FreshnessClock.d.ts +34 -0
  220. package/dist/types/core/realtime/IRealtimeSource.d.ts +82 -0
  221. package/dist/types/core/realtime/LiveStateGuard.d.ts +23 -0
  222. package/dist/types/core/realtime/PollingSource.d.ts +42 -0
  223. package/dist/types/core/realtime/RealtimeController.d.ts +54 -0
  224. package/dist/types/core/realtime/RtAnnouncePolicy.d.ts +53 -0
  225. package/dist/types/core/realtime/RtApplyCommand.d.ts +29 -0
  226. package/dist/types/core/realtime/RtChartTargetTrigger.d.ts +26 -0
  227. package/dist/types/core/realtime/StreamingSource.d.ts +47 -0
  228. package/dist/types/core/realtime/backoff.d.ts +12 -0
  229. package/dist/types/core/realtime/index.d.ts +13 -0
  230. package/dist/types/core/realtime/ports.d.ts +80 -0
  231. package/dist/types/core/render/CellApplier.d.ts +18 -0
  232. package/dist/types/core/render/CellErrorBoundary.d.ts +65 -0
  233. package/dist/types/core/render/CellPipeline.d.ts +39 -0
  234. package/dist/types/core/render/CellRenderRequest.d.ts +209 -0
  235. package/dist/types/core/render/CellStageRegistry.d.ts +53 -0
  236. package/dist/types/core/render/OverlayCompositor.d.ts +38 -0
  237. package/dist/types/core/render/RenderBudget.d.ts +67 -0
  238. package/dist/types/core/render/contrast.d.ts +33 -0
  239. package/dist/types/core/render/index.d.ts +35 -0
  240. package/dist/types/core/render/stages/BackgroundStage.d.ts +14 -0
  241. package/dist/types/core/render/stages/DecoratorStage.d.ts +12 -0
  242. package/dist/types/core/render/stages/OverlayStage.d.ts +12 -0
  243. package/dist/types/core/render/stages/ValueRendererStage.d.ts +15 -0
  244. package/dist/types/core/render/stages/index.d.ts +14 -0
  245. package/dist/types/core/state/AutosaveController.d.ts +63 -0
  246. package/dist/types/core/state/IStatePersistence.d.ts +59 -0
  247. package/dist/types/core/state/MultiTabGuard.d.ts +33 -0
  248. package/dist/types/core/state/SchemaMigrator.d.ts +33 -0
  249. package/dist/types/core/state/SemVerPolicy.d.ts +39 -0
  250. package/dist/types/core/state/StateCodec.d.ts +75 -0
  251. package/dist/types/core/state/index.d.ts +6 -0
  252. package/dist/types/core/types.d.ts +511 -226
  253. package/dist/types/react/OpenGrid.d.ts +54 -0
  254. package/dist/types/react/index.d.ts +5 -0
  255. package/dist/types/realtime/index.d.ts +1 -0
  256. package/dist/types/vue/index.d.ts +5 -0
  257. package/dist/types/vue/types.d.ts +35 -0
  258. package/package.json +112 -111
@@ -0,0 +1,142 @@
1
+ /** 등록 출처 — 충돌 정책의 1차 판별자. og 코어 보호의 근거. / Entry origin — primary discriminator of conflict policy. */
2
+ export type EntryOrigin = 'builtin' | 'plugin' | 'user';
3
+ /** 폐기 정보 — 예고 없는 제거 금지의 데이터화(§2.8). / Deprecation info — data form of "no removal without notice". */
4
+ export interface DeprecationInfo {
5
+ /** 폐기 표시 버전. / Version where deprecation was marked. */
6
+ readonly since: string;
7
+ /** 제거 예정 버전(게이트가 이전 제거를 차단). / Planned removal version (gate blocks earlier removal). */
8
+ readonly removeIn: string;
9
+ /** 대체 API/키. / Replacement API/key. */
10
+ readonly replacement?: string;
11
+ /** 부가 설명. / Extra note. */
12
+ readonly note?: string;
13
+ }
14
+ /** 등록 시 선언하는 정책 메타(데이터로서의 정책). / Policy metadata declared at registration (policy as data). */
15
+ export interface RegisterOptions {
16
+ /** 기본 'user'. 'builtin' 은 코어 부트스트랩만. / Default 'user'; 'builtin' is core bootstrap only. */
17
+ origin?: EntryOrigin;
18
+ /** 보호 키를 이기려는 명시 의사. 기본 false. / Explicit intent to override a protected key. Default false. */
19
+ override?: boolean;
20
+ /** og:* 예약 검사·매니페스트 추적·일괄 dispose 키. / Reserved-check, manifest tracking, batch-dispose key. */
21
+ pluginId?: string;
22
+ /** 다중 적용 순서(작을수록 먼저). 기본 0. / Multi-apply order (smaller first). Default 0. */
23
+ priority?: number;
24
+ /** 이 값이 구현하는 SPI 버전(peer 검증용). / SPI version this value implements (for peer verification). */
25
+ spiVersion?: string;
26
+ /** 이 키가 폐기 예정이면 동반. / Present when this key is deprecated. */
27
+ deprecated?: DeprecationInfo;
28
+ }
29
+ /** 등록 1건의 정규화된 기록(불변). seq 는 로드순 tiebreak 의 안정 기준. / A normalized registration record (immutable). */
30
+ export interface RegistryEntry<V> {
31
+ readonly key: string;
32
+ readonly value: V;
33
+ readonly origin: EntryOrigin;
34
+ readonly priority: number;
35
+ /** 모노톤 등록 순번(레지스트리 로컬). / Monotonic registration sequence (registry-local). */
36
+ readonly seq: number;
37
+ readonly pluginId?: string;
38
+ readonly spiVersion?: string;
39
+ readonly deprecated?: DeprecationInfo;
40
+ }
41
+ /** 등록 결과의 행동 분류. / Action classification of a registration result. */
42
+ export type RegisterAction = 'added' | 'replaced' | 'kept' | 'rejected';
43
+ /** 거부/유지 사유. / Reason for rejection/keep. */
44
+ export type RegisterReason = 'reserved-namespace' | 'protected-builtin' | 'invalid-key' | 'spi-mismatch' | 'disposed' | 'adapter-error';
45
+ /** 등록 결과 — never-throw. 거부/경고를 값으로 반환(조용한 실패 금지). / Registration result — never-throw; rejections/warnings returned as values. */
46
+ export interface RegisterResult {
47
+ /** 제공한 값이 지금 등록되었는가(added/replaced=true). / Whether the provided value is now registered (added/replaced=true). */
48
+ readonly ok: boolean;
49
+ readonly action: RegisterAction;
50
+ readonly reason?: RegisterReason;
51
+ /** [OpenGrid] 프리픽스로 방출된 경고 원문. / Emitted warning text ([OpenGrid]-prefixed). */
52
+ readonly warning?: string;
53
+ }
54
+ /** 중복 키 재등록 정책. / Duplicate-key re-registration policy. */
55
+ export type DuplicatePolicy = 'last-wins' | 'explicit-override' | 'protect-builtin';
56
+ /**
57
+ * 전 확장점이 상속하는 단일 계약. K=키 타입(기본 string), V=등록 값 타입.
58
+ * / The single contract inherited by every extension point.
59
+ */
60
+ export interface IRegistry<V, K extends string = string> {
61
+ /** 등록(정책 적용, never-throw). / Register (policy-applied, never-throw). */
62
+ register(key: K, value: V, opts?: RegisterOptions): RegisterResult;
63
+ /** 미등록 → undefined (I1). / Unregistered → undefined (I1). */
64
+ get(key: K): V | undefined;
65
+ /** 미등록 → fallback/dev 플레이스홀더 (I1, REQ-T4-803). / Unregistered → fallback/dev placeholder (I1). */
66
+ require(key: K, fallback?: V): V;
67
+ has(key: K): boolean;
68
+ /** 등록된 키 목록. / Registered keys. */
69
+ list(): K[];
70
+ /** 정규화 기록(카탈로그·진단·다중적용 순서용). / Normalized records (catalog/diagnostics/ordered-apply). */
71
+ entries(): ReadonlyArray<RegistryEntry<V>>;
72
+ unregister(key: K): boolean;
73
+ /** 플러그인 단위 일괄 해제(대칭 teardown). 해제 수 반환. / Batch dispose by plugin (symmetric teardown). Returns count. */
74
+ disposePlugin(pluginId: string): number;
75
+ /** 전체 해제(자원 대칭). / Dispose everything (resource symmetry). */
76
+ dispose(): void;
77
+ }
78
+ /** 선언 SPI 버전이 코어 SPI major 와 호환되는가(major 일치). / Whether a declared SPI version is major-compatible with the core SPI. */
79
+ export declare function spiCompatible(coreVersion: string, declared: string): boolean;
80
+ /** TypedRegistry 구성. / TypedRegistry configuration. */
81
+ export interface TypedRegistryConfig<V, K extends string = string> {
82
+ /** 미등록 시 dev 플레이스홀더 값 생성자(레지스트리별 상이: 물음표·—포맷터…). / Dev placeholder factory for unregistered keys. */
83
+ placeholder?: (key: K) => V;
84
+ /** 중복 정책. 기본 'protect-builtin'. / Duplicate policy. Default 'protect-builtin'. */
85
+ duplicatePolicy?: DuplicatePolicy;
86
+ /** 이 레지스트리가 소유하는 SPI 이름·현재 버전(peer 검증용). / SPI name/version this registry owns (for peer checks). */
87
+ spi?: {
88
+ name: string;
89
+ version: string;
90
+ };
91
+ /** dev 경고 싱크(테스트 주입 가능, 기본 console.warn). / Dev warning sink (test-injectable; defaults to console.warn). */
92
+ onWarn?: (msg: string) => void;
93
+ }
94
+ /**
95
+ * 단일 값 슬롯형(포맷터·차트타입: 키당 1값)과 다중 적용형(CF규칙·데코: 한 대상 N값)을
96
+ * 하나의 저장·정책 엔진으로 처리하고, 조회 관점만 분리한다(§2.2).
97
+ * / One storage+policy engine for both single-slot and multi-apply extension points; only the
98
+ * read perspective differs (§2.2).
99
+ *
100
+ * @example
101
+ * const reg = new TypedRegistry<IFormatter>({ spi: { name: 'IFormatter', version: '1' } });
102
+ * reg.register('currency', myFmt, { origin: 'builtin' });
103
+ * reg.register('currency', mine); // kept — built-in protected
104
+ */
105
+ export declare class TypedRegistry<V, K extends string = string> implements IRegistry<V, K> {
106
+ private _map;
107
+ private _seq;
108
+ private _disposed;
109
+ private _warned;
110
+ private readonly _cfg;
111
+ constructor(cfg?: TypedRegistryConfig<V, K>);
112
+ private _warn;
113
+ register(key: K, value: V, opts?: RegisterOptions): RegisterResult;
114
+ /** 충돌 시 신규가 이기는가? — 정책 진리표(§4.2). true=교체 허용. / Does the newcomer win? (§4.2 truth table). */
115
+ private _resolveConflict;
116
+ get(key: K): V | undefined;
117
+ require(key: K, fallback?: V): V;
118
+ has(key: K): boolean;
119
+ list(): K[];
120
+ entries(): ReadonlyArray<RegistryEntry<V>>;
121
+ unregister(key: K): boolean;
122
+ disposePlugin(pluginId: string): number;
123
+ dispose(): void;
124
+ }
125
+ /**
126
+ * 결정론 정렬: priority 오름차순, 동률이면 등록 순번(seq) 오름차순(§2.3).
127
+ * 한 대상에 여러 확장이 겹칠 때의 적용 순서. 저장 구조는 재사용, 조회 관점만 정렬.
128
+ * / Deterministic ordering: ascending priority, ties broken by seq (§2.3).
129
+ *
130
+ * @param reg - 대상 레지스트리 / The registry
131
+ * @returns priority→seq 정렬된 기록(불변) / Records sorted by priority then seq (immutable)
132
+ */
133
+ export declare function orderedApply<V>(reg: IRegistry<V>): ReadonlyArray<RegistryEntry<V>>;
134
+ /**
135
+ * 순서 모호성 감지(§2.3 결정론 정직성): 동일 priority 를 가진 2건 이상의 겹침은 등록순(seq)에
136
+ * 의존한다 — 순서 민감 확장은 priority 를 명시해야 한다. 모호한 priority 그룹을 반환.
137
+ * / Detect order ambiguity: overlaps sharing the same priority depend on registration order (seq).
138
+ *
139
+ * @param entries - 검사할 기록(보통 한 대상에 적용될 부분집합) / Records to inspect
140
+ * @returns 2건 이상 공유하는 priority 목록(빈 배열=모호성 없음) / Priorities shared by 2+ entries
141
+ */
142
+ export declare function detectAmbiguousOrder<V>(entries: ReadonlyArray<RegistryEntry<V>>): number[];
@@ -0,0 +1,46 @@
1
+ import { TypedRegistry, IRegistry } from './Registry.js';
2
+ import { IExtension } from './IExtension.js';
3
+ /** 슬롯 이름(빌트인 + 임의 확장). / Slot name (built-ins + arbitrary extension). */
4
+ export type SlotName = 'header' | 'cell' | 'footer' | 'empty' | 'contextView' | 'masterDetail' | (string & {});
5
+ /** 슬롯 산출물이 마운트되는 호스트(host CSS isolation 경계 안). / Host where slot output mounts (inside host CSS isolation). */
6
+ export interface SlotHost {
7
+ [k: string]: unknown;
8
+ }
9
+ /** mount 가 반환하는 핸들 — update/unmount 의 대상. / Handle returned by mount — target of update/unmount. */
10
+ export interface SlotHandle {
11
+ [k: string]: unknown;
12
+ }
13
+ /**
14
+ * 슬롯 렌더 provider(§2.7). host CSS isolation 경계 안에서 동작(외부 스타일 침투 차단).
15
+ * / Slot render provider. Operates inside the host CSS isolation boundary.
16
+ */
17
+ export interface ISlotProvider<Ctx = unknown> extends IExtension {
18
+ /** 최초 부착 — DOM/문자열 산출물 마운트. 반환 핸들은 update/unmount 의 대상. / Initial attach; returns a handle. */
19
+ mount(host: SlotHost, ctx: Ctx): SlotHandle;
20
+ /** 데이터/상태 변화 시 갱신(가상화 재사용 — 새 mount 대신 update). / Update on data/state change (virtualization reuse). */
21
+ update?(handle: SlotHandle, ctx: Ctx): void;
22
+ /** 대칭 해제(mount 자원 회수). / Symmetric teardown (reclaim mount resources). */
23
+ unmount?(handle: SlotHandle): void;
24
+ /** 산출 실패/미구현 시 코어가 쓸 기본 슬롯(never-blank). / Default slot on failure/unimplemented (never-blank). */
25
+ fallback?: ISlotProvider<Ctx>;
26
+ }
27
+ /** 슬롯 레지스트리 — IRegistry 동형(슬롯당 1 provider). / Slot registry — isomorphic to IRegistry (1 provider per slot). */
28
+ export type SlotRegistry = IRegistry<ISlotProvider>;
29
+ /**
30
+ * 슬롯 레지스트리 생성(protect-builtin 정책 — 빌트인 슬롯 보호).
31
+ * / Create a slot registry (protect-builtin — built-in slots are protected).
32
+ *
33
+ * @returns 슬롯 provider 레지스트리 / A slot-provider registry
34
+ */
35
+ export declare function createSlotRegistry(): TypedRegistry<ISlotProvider>;
36
+ /**
37
+ * 슬롯 provider 를 fallback 사슬을 따라 안전 마운트(never-blank, UC-9). provider.mount 가 throw 하면
38
+ * fallback 으로 폴백하고, fallback 도 없으면 null 반환(코어는 계속 동작).
39
+ * / Safely mount a slot provider following its fallback chain (never-blank). Falls back on throw.
40
+ *
41
+ * @param provider - 마운트할 슬롯 provider / The slot provider to mount
42
+ * @param host - 마운트 호스트 / The mount host
43
+ * @param ctx - 슬롯 컨텍스트 / Slot context
44
+ * @returns 핸들, 전 사슬 실패 시 null / A handle, or null if the whole chain fails
45
+ */
46
+ export declare function safeMount<Ctx>(provider: ISlotProvider<Ctx> | undefined, host: SlotHost, ctx: Ctx): SlotHandle | null;
@@ -0,0 +1,44 @@
1
+ import { IRegistry } from './Registry.js';
2
+ import { FormatterRegistry } from '../format/FormatterRegistry.js';
3
+ import { IFormatter } from '../format/types.js';
4
+ import { SkinRegistry } from '../SkinRegistry.js';
5
+ import { SkinTokenDelta } from '../types.js';
6
+ /** 어댑터가 원본 저장소와 소통하는 최소 브리지(원본을 건드리지 않고 위임). / Minimal bridge to the underlying store. */
7
+ export interface RegistryBridge<V, K extends string = string> {
8
+ get(key: K): V | undefined;
9
+ has(key: K): boolean;
10
+ list(): K[];
11
+ /** 값 저장(원본 register/define 위임). throw 하면 어댑터가 격리해 rejected 로 값화. / Persist; throws are isolated into a rejected result. */
12
+ set(key: K, value: V): void;
13
+ /** 삭제(선택 — 미지원 원본은 생략). / Delete (optional). */
14
+ delete?(key: K): boolean;
15
+ }
16
+ /**
17
+ * 임의 브리지를 IRegistry<V> 계약으로 어댑트. 예약 가드·충돌 정책·never-throw·메타를 얹되
18
+ * 저장은 브리지에 위임(원본 무교란). / Adapt an arbitrary bridge to the IRegistry<V> contract.
19
+ *
20
+ * @param bridge - 원본 저장소 브리지 / The underlying-store bridge
21
+ * @param cfg - 정책(중복·경고 싱크) / Policy (duplicate, warning sink)
22
+ * @returns IRegistry<V> 어댑터 / An IRegistry<V> adapter
23
+ */
24
+ export declare function adaptRegistry<V, K extends string = string>(bridge: RegistryBridge<V, K>, cfg?: {
25
+ duplicatePolicy?: 'last-wins' | 'explicit-override' | 'protect-builtin';
26
+ onWarn?: (msg: string) => void;
27
+ }): IRegistry<V, K>;
28
+ /**
29
+ * 기존 format/FormatterRegistry(register(f)/resolve/has/list, 키=f.name)를 IRegistry<IFormatter>
30
+ * 로 어댑트. 원본 API 표면 불변(§5.2). / Adapt the existing FormatterRegistry to IRegistry<IFormatter>.
31
+ *
32
+ * @param reg - 기존 FormatterRegistry / The existing FormatterRegistry
33
+ * @returns IRegistry<IFormatter> 어댑터 / An IRegistry<IFormatter> adapter
34
+ */
35
+ export declare function adaptFormatterRegistry(reg: FormatterRegistry): IRegistry<IFormatter>;
36
+ /**
37
+ * 기존 SkinRegistry(define/has/get/list, FORM-only 검증·가드레일)를 IRegistry<SkinTokenDelta> 로
38
+ * 어댑트. define 의 색 리터럴 거부 throw 는 어댑터가 격리해 rejected('adapter-error')로 값화(never-throw).
39
+ * / Adapt the existing SkinRegistry to IRegistry<SkinTokenDelta>; define()'s throw is isolated.
40
+ *
41
+ * @param reg - 기존 SkinRegistry / The existing SkinRegistry
42
+ * @returns IRegistry<SkinTokenDelta> 어댑터 / An IRegistry<SkinTokenDelta> adapter
43
+ */
44
+ export declare function adaptSkinRegistry(reg: SkinRegistry): IRegistry<SkinTokenDelta>;
@@ -0,0 +1,47 @@
1
+ import { IExtension } from './IExtension.js';
2
+ import { IRegistry } from './Registry.js';
3
+ /** 계약 검사 1건: (구현 팩토리) → 위반 목록. 빈 배열=통과. / One contract check: (factory) → violations; empty=pass. */
4
+ export interface ConformanceCheck<V> {
5
+ readonly id: string;
6
+ /** 위반 문자열 목록(빈 배열=통과). / List of violation strings (empty=pass). */
7
+ run(make: () => V): string[];
8
+ }
9
+ /** 확장 SPI 하나에 대한 적합성 계약(파라미터화 스위트). / A conformance kit for one extension SPI. */
10
+ export interface ConformanceKit<V> {
11
+ readonly spi: string;
12
+ readonly checks: ReadonlyArray<ConformanceCheck<V>>;
13
+ }
14
+ /** 계약 검사 결과 1건. / One conformance result. */
15
+ export interface ConformanceResult {
16
+ readonly id: string;
17
+ readonly violations: string[];
18
+ }
19
+ /** 전 SPI 공통 계약 설명자(문서·수용기준 표기용). 실행 검사는 baseExtensionChecks 가 제공. / Descriptors of the shared contract. */
20
+ export declare const BASE_REGISTRY_CHECK_IDS: readonly ["shape:구현이 SPI 필수 멤버를 모두 노출", "lifecycle:activate 후 dispose 가 획득 자원을 대칭 해제(누수 0)", "isolation:입력 스냅샷 변형 시도가 코어 모델을 오염시키지 않음", "error-isolation:구현이 throw 해도 코어·타 확장 영향 0(격리 경계)", "serialize:직렬화→역직렬화 왕복 동일성(해당 SPI 만)", "virtualization:가상화 스크롤에서 가시행 한정 호출·오프스크린 미호출", "fallback:미등록/미지원 경로가 never-throw 폴백으로 귀결"];
21
+ /**
22
+ * 모든 IExtension 구현이 통과해야 하는 공통 실행 검사(shape·lifecycle·error-isolation).
23
+ * SPI별 kit 이 이 배열을 스프레드해 고유 검사를 덧붙인다.
24
+ * / Shared runnable checks every IExtension must pass; SPI kits spread these and add their own.
25
+ */
26
+ export declare function baseExtensionChecks<V extends IExtension>(): ReadonlyArray<ConformanceCheck<V>>;
27
+ /**
28
+ * 파라미터화 러너: kit 의 각 검사를 구현 팩토리에 돌려 위반 목록을 표로 반환(수용기준).
29
+ * / Parameterized runner: runs each check against the factory, returns a table of violations.
30
+ *
31
+ * @param kit - 적합성 키트 / The conformance kit
32
+ * @param make - 검사 대상 구현 팩토리(검사마다 새 인스턴스) / Factory for the implementation under test
33
+ * @returns 검사별 위반 목록(전 항목 빈 배열=완전 통과) / Per-check violations (all empty = full pass)
34
+ */
35
+ export declare function runConformance<V>(kit: ConformanceKit<V>, make: () => V): ConformanceResult[];
36
+ /** 적합성 결과가 전부 통과인지. / Whether all conformance results pass. */
37
+ export declare function conformancePassed(results: ConformanceResult[]): boolean;
38
+ /**
39
+ * IRegistry 자체에 대한 재사용 계약 키트(§2.6). 빌트인·서드파티 레지스트리 팩토리를 이 키트로
40
+ * 돌려 never-throw 폴백·dispose 대칭·예약 가드·중복 결정론을 자가검증한다.
41
+ * / Reusable conformance kit for IRegistry itself: never-throw fallback, dispose symmetry,
42
+ * reserved guard, and duplicate determinism.
43
+ *
44
+ * @param placeholder - require 폴백에 쓸 플레이스홀더 값 / Placeholder value for the require fallback
45
+ * @returns 레지스트리 팩토리용 적합성 키트 / A conformance kit for a registry factory
46
+ */
47
+ export declare function registryConformanceKit<V>(placeholder: V): ConformanceKit<IRegistry<V>>;
@@ -0,0 +1,16 @@
1
+ export { TypedRegistry, orderedApply, detectAmbiguousOrder, spiCompatible, } from './Registry.js';
2
+ export type { IRegistry, RegisterOptions, RegisterResult, RegisterAction, RegisterReason, RegistryEntry, EntryOrigin, DuplicatePolicy, DeprecationInfo, TypedRegistryConfig, } from './Registry.js';
3
+ export { RESERVED_PREFIXES, isReserved } from './reserved.js';
4
+ export { verifyPeer, compareSemver, Capabilities } from './IExtension.js';
5
+ export type { IExtension, IValidator, ValResult, CoreCapabilities, CapabilitiesSpec, ExtensionPeer, PeerVerdict, } from './IExtension.js';
6
+ export { createSlotRegistry, safeMount } from './SlotRegistry.js';
7
+ export type { ISlotProvider, SlotRegistry, SlotName, SlotHost, SlotHandle } from './SlotRegistry.js';
8
+ export { baseExtensionChecks, runConformance, conformancePassed, registryConformanceKit, BASE_REGISTRY_CHECK_IDS, } from './conformance.js';
9
+ export type { ConformanceKit, ConformanceCheck, ConformanceResult } from './conformance.js';
10
+ export { DeprecationManager } from './DeprecationManager.js';
11
+ export type { DeprecationRecord } from './DeprecationManager.js';
12
+ export { createCellTypeRegistry, createFormatterRegistry, createValidatorRegistry, createExtensionRegistry, } from './registries.js';
13
+ export { adaptRegistry, adaptFormatterRegistry, adaptSkinRegistry } from './adapters.js';
14
+ export type { RegistryBridge } from './adapters.js';
15
+ export type { ICellRenderer } from '../render/CellRenderRequest.js';
16
+ export type { IFormatter } from '../format/types.js';
@@ -0,0 +1,31 @@
1
+ import { TypedRegistry } from './Registry.js';
2
+ import { IValidator } from './IExtension.js';
3
+ import { ICellRenderer } from '../render/CellRenderRequest.js';
4
+ import { IFormatter } from '../format/types.js';
5
+ /**
6
+ * 셀타입 레지스트리(ICellRenderer, DD-03 정본). 미등록 셀타입은 dev 물음표 플레이스홀더로
7
+ * require 폴백(never-throw). / Cell-type registry (ICellRenderer; DD-03 canonical).
8
+ *
9
+ * @param placeholder - 미등록 셀타입 dev 플레이스홀더(선택) / Dev placeholder for unregistered cell types (optional)
10
+ */
11
+ export declare function createCellTypeRegistry<T = any>(placeholder?: (key: string) => ICellRenderer<T>): TypedRegistry<ICellRenderer<T>>;
12
+ /**
13
+ * 확장 포맷터 레지스트리(IFormatter, DD-04 정본). 기존 format/FormatterRegistry 와 별개의
14
+ * IRegistry 동형 인스턴스(어댑트는 adapters.ts). / Formatter extension registry (IFormatter; DD-04 canonical).
15
+ */
16
+ export declare function createFormatterRegistry(): TypedRegistry<IFormatter>;
17
+ /**
18
+ * 검증기 레지스트리(IValidator, DD-10 소유). 다중 적용 가능 = orderedApply 로 순서 결정.
19
+ * / Validator registry (IValidator; DD-10-owned). Multi-apply via orderedApply.
20
+ */
21
+ export declare function createValidatorRegistry(): TypedRegistry<IValidator>;
22
+ /**
23
+ * SPI 정본 미착지 확장점(차트타입·수식함수·커맨드·CF규칙·데이터소스·export채널)용 제네릭 팩토리.
24
+ * 값 타입 V 를 호출측이 지정한다(소유 DD 착지 시 그 타입으로 교체). / Generic factory for
25
+ * extension points whose canonical SPI has not yet landed.
26
+ *
27
+ * @param spiName - SPI 이름(peer 버저닝) / SPI name (peer versioning)
28
+ * @param version - SPI 현재 major / Current SPI major
29
+ * @param duplicatePolicy - 중복 정책(기본 protect-builtin) / Duplicate policy (default protect-builtin)
30
+ */
31
+ export declare function createExtensionRegistry<V>(spiName: string, version?: string, duplicatePolicy?: 'last-wins' | 'explicit-override' | 'protect-builtin'): TypedRegistry<V>;
@@ -0,0 +1,10 @@
1
+ /** 코어가 예약하는 접두사 — 이 대역은 origin:'builtin' 만 점유할 수 있다.
2
+ * / Prefixes reserved by the core — only origin:'builtin' may occupy this band. */
3
+ export declare const RESERVED_PREFIXES: readonly ["og:", "og-"];
4
+ /**
5
+ * 키가 코어 예약 네임스페이스에 속하는지 판정. / Whether a key falls in the core-reserved namespace.
6
+ *
7
+ * @param key - 검사할 등록 키 / Registration key to inspect
8
+ * @returns 예약 접두사로 시작하면 true / true if it starts with a reserved prefix
9
+ */
10
+ export declare function isReserved(key: string): boolean;
@@ -0,0 +1,47 @@
1
+ import { ColumnFormatSpec, FormatContext, FormatInput, FormatResult, IDisplayFormatPort, IDomainTypeResolver, ILocaleFormat, IMaskPolicy, INegativePolicy, INullPolicy, ITruncatePolicy, IUserFormatSpec, IValueInterpreter } from './types.js';
2
+ import { FormatterRegistry } from './FormatterRegistry.js';
3
+ import { FormatCache } from './FormatCache.js';
4
+ /** DisplayFormatter 협력자 묶음(생성자 주입). / Collaborators injected into the facade. */
5
+ export interface DisplayFormatterDeps {
6
+ interpreter: IValueInterpreter;
7
+ domain: IDomainTypeResolver;
8
+ locale: ILocaleFormat;
9
+ user: IUserFormatSpec;
10
+ nullP: INullPolicy;
11
+ truncate: ITruncatePolicy;
12
+ negative: INegativePolicy;
13
+ mask: IMaskPolicy;
14
+ registry: FormatterRegistry;
15
+ cache: FormatCache;
16
+ }
17
+ /**
18
+ * 표시값 산출의 단일 정본 파사드. 모든 소비자(셀/차트/집계/export/aria/클립보드/인쇄)가 통과.
19
+ * / The single-source display formatter facade; every consumer passes through it.
20
+ */
21
+ export declare class DisplayFormatter implements IDisplayFormatPort {
22
+ private readonly d;
23
+ constructor(d: DisplayFormatterDeps);
24
+ /** 핵심: raw → 표시. 캐시 히트 시 단계 미실행. / Core: raw → display; skips stages on cache hit. */
25
+ format(input: FormatInput, spec: ColumnFormatSpec, ctx: FormatContext): FormatResult;
26
+ /** 편의(문자열만) — 대다수 소비자 핫패스. / Convenience: text only (hot path). */
27
+ text(input: FormatInput, spec: ColumnFormatSpec, ctx: FormatContext): string;
28
+ /**
29
+ * 차트/집계용 포트 — 이미 집계·다운샘플된 수치에 라벨 서식만 적용(REQ-T6-802).
30
+ * interpret 생략(이미 수치) → domainType→truncate→locale→userFormat→negative. 셀과 동일 서식.
31
+ * / Chart/aggregate port; applies label formatting to an already-aggregated number.
32
+ */
33
+ formatScalar(n: number, spec: ColumnFormatSpec, ctx: FormatContext): string;
34
+ /** 로케일 변경 훅 — 캐시 정확 무효화. / Locale-change hook — precise cache invalidation. */
35
+ onLocaleChange(): void;
36
+ /** 테마 변경 훅 — 색코드 축 무효화. / Theme-change hook — color-axis invalidation. */
37
+ onThemeChange(): void;
38
+ private _run;
39
+ /** 수치 파이프: truncate→locale/userFormat→negative. 우선순위 합성. / Numeric pipe with priority composition. */
40
+ private _numeric;
41
+ /** 도메인별 로케일 본문 산출(number/currency/percent). / Locale numeric body per domain. */
42
+ private _localeBody;
43
+ /** 결측 aria — 사유가 있으면 결측 낭독, 없으면 null 표시값. / Missing aria; spells the reason if present. */
44
+ private _missingAria;
45
+ /** ⑦ customHook 단계 — displayFormatter 슬롯/등록 포맷터를 마지막에 적용(null=파이프 산출 폴백). */
46
+ private _hook;
47
+ }
@@ -0,0 +1,20 @@
1
+ import { FormatCacheKey, FormatResult } from './types.js';
2
+ /**
3
+ * LRU 메모이즈 캐시(per-instance). get 시 최근성 갱신(move-to-end).
4
+ * / LRU memoize cache (per-instance); get() refreshes recency (move-to-end).
5
+ */
6
+ export declare class FormatCache {
7
+ private readonly max;
8
+ private _map;
9
+ constructor(max?: number);
10
+ get(key: FormatCacheKey): FormatResult | undefined;
11
+ set(key: FormatCacheKey, r: FormatResult): void;
12
+ /** 로케일 축 무효화 — 전체 클리어(모든 숫자/날짜 표기 변경). / Locale-axis invalidation — full clear. */
13
+ invalidateLocale(): void;
14
+ /** 테마 축 무효화 — 색코드 보유 엔트리만 제거(R3 부분 무효화). / Theme-axis invalidation — color entries only. */
15
+ invalidateTheme(): void;
16
+ /** 현재 엔트리 수(테스트·계측). / Current entry count (tests/metrics). */
17
+ get size(): number;
18
+ /** 전체 비우기. / Clear all. */
19
+ clear(): void;
20
+ }
@@ -0,0 +1,22 @@
1
+ import { IFormatter } from './types.js';
2
+ /**
3
+ * 커스텀 포맷터 등록소. register/resolve/child 는 DD-10 TypedRegistry<IFormatter> 매핑.
4
+ * / Custom formatter registry (isomorphic to DD-10 TypedRegistry<IFormatter>).
5
+ */
6
+ export declare class FormatterRegistry {
7
+ private _map;
8
+ private _parent;
9
+ constructor(parent?: FormatterRegistry);
10
+ /** 포맷터 등록(additive, 동일 이름 last-wins). / Register a formatter (last-wins on same name). */
11
+ register(f: IFormatter): this;
12
+ /** 이름으로 해석(미해석 → undefined, 파이프 기본 폴백). parent-chain 탐색. / Resolve by name; unknown → undefined. */
13
+ resolve(name: string): IFormatter | undefined;
14
+ /** 등록 여부(parent-chain 합집합). / Whether a formatter name is registered. */
15
+ has(name: string): boolean;
16
+ /** 이 레지스트리를 부모로 하는 자식(per-instance 격리, 멀티그리드 오염 0). / A child registry (per-instance isolation). */
17
+ child(): FormatterRegistry;
18
+ /** 등록된 포맷터 이름 목록(능력 매니페스트, parent-chain 합집합). / Registered formatter names (capability manifest). */
19
+ list(): string[];
20
+ }
21
+ /** 프로세스 전역 기본 포맷터 레지스트리. / Process-global default formatter registry. */
22
+ export declare const formatterRegistry: FormatterRegistry;
@@ -0,0 +1,10 @@
1
+ import { AstRender, FormatAst, FormatContext, ILocaleFormat, InterpretedValue, IUserFormatSpec } from '../types.js';
2
+ /**
3
+ * 기본 AST 렌더러. 로케일 서식기를 주입받아 숫자 본문을 로케일 위임으로 산출한다.
4
+ * / Default AST renderer; delegates numeric body to the injected locale formatter.
5
+ */
6
+ export declare class AstRenderer implements IUserFormatSpec {
7
+ private readonly locale;
8
+ constructor(locale: ILocaleFormat);
9
+ apply(ast: FormatAst, v: InterpretedValue, ctx: FormatContext): AstRender;
10
+ }
@@ -0,0 +1,16 @@
1
+ import { FormatAst, FormatDiagnostic, IUserFormatCompiler } from '../types.js';
2
+ /** 현 문법 버전(additive 진화). / Current grammar version. */
3
+ export declare const FORMAT_GRAMMAR_VERSION = 1;
4
+ /**
5
+ * 기본 포맷 컴파일러. 세미콜론 다중섹션(pos;neg;zero;text), 색코드, 숫자토큰 파싱.
6
+ * / Default compiler: semicolon multi-section, color codes, numeric token parsing.
7
+ */
8
+ export declare class FormatCompiler implements IUserFormatCompiler {
9
+ readonly grammarVersion = 1;
10
+ compile(format: string): {
11
+ ast: FormatAst;
12
+ diagnostics: FormatDiagnostic[];
13
+ };
14
+ }
15
+ /** 공유 컴파일러 싱글턴(순수·상태 없음). / Shared stateless compiler singleton. */
16
+ export declare const defaultFormatCompiler: FormatCompiler;
@@ -0,0 +1,55 @@
1
+ import { DisplayFormatter, DisplayFormatterDeps } from './DisplayFormatter.js';
2
+ import { FormatterRegistry } from './FormatterRegistry.js';
3
+ import { ColumnFormatSpec, DomainKind, MaskDef, MaskType, NegativePolicy as NegPolicy, NullPolicy as NullPol, AbbrevPolicy } from './types.js';
4
+ import { DisplayFormatterFn } from '../types.js';
5
+ export * from './types.js';
6
+ export { DisplayFormatter } from './DisplayFormatter.js';
7
+ export type { DisplayFormatterDeps } from './DisplayFormatter.js';
8
+ export { FormatterRegistry, formatterRegistry } from './FormatterRegistry.js';
9
+ export { FormatCache } from './FormatCache.js';
10
+ export { ValueInterpreter } from './pipeline/ValueInterpreter.js';
11
+ export { DomainTypeResolver } from './pipeline/DomainTypeResolver.js';
12
+ export { LocaleFormat } from './pipeline/LocaleFormat.js';
13
+ export { FormatCompiler, defaultFormatCompiler, FORMAT_GRAMMAR_VERSION } from './grammar/FormatCompiler.js';
14
+ export { AstRenderer } from './grammar/AstRenderer.js';
15
+ export { NullPolicy } from './policy/NullPolicy.js';
16
+ export { TruncatePolicy } from './policy/TruncatePolicy.js';
17
+ export { NegativePolicy } from './policy/NegativePolicy.js';
18
+ export { MaskPolicy } from './policy/MaskPolicy.js';
19
+ /** 기본 조립 옵션(협력자 오버라이드·격리). / Default assembly options. */
20
+ export interface CreateDisplayFormatterOptions {
21
+ /** 부모 포맷터 레지스트리(child 격리). 미지정 시 전역. / Parent registry (child isolation); global if unset. */
22
+ parentRegistry?: FormatterRegistry;
23
+ /** 협력자 부분 오버라이드(Strategy 교체·OCP). / Partial collaborator overrides (Strategy swap). */
24
+ overrides?: Partial<DisplayFormatterDeps>;
25
+ /** 캐시 최대 엔트리. / Cache max entries. */
26
+ cacheMax?: number;
27
+ }
28
+ /**
29
+ * 기본 DisplayFormatter 조립(8단계 + child registry + per-instance cache).
30
+ * / Assemble a default DisplayFormatter (8 stages + child registry + per-instance cache).
31
+ */
32
+ export declare function createDisplayFormatter(opts?: CreateDisplayFormatterOptions): DisplayFormatter;
33
+ /** compileFormatSpec 입력(컬럼 힌트, 헤드리스 — ColumnDef 미의존). / compileFormatSpec input (headless). */
34
+ export interface FormatSpecInput {
35
+ field?: string;
36
+ domain?: DomainKind;
37
+ /** 레거시 dataType/type('number'|'currency'|'date'|'mask'…). / Legacy dataType/type. */
38
+ type?: string;
39
+ /** Excel식 포맷 문자열('#,##0;[Red](#,##0)'). / Excel-style format string. */
40
+ format?: string;
41
+ currency?: string;
42
+ mask?: MaskType | MaskDef;
43
+ valueMap?: Readonly<Record<string, string>>;
44
+ abbreviate?: AbbrevPolicy;
45
+ negative?: NegPolicy;
46
+ nullPolicy?: NullPol;
47
+ customFormatter?: string | DisplayFormatterFn | null;
48
+ precision?: number;
49
+ datePattern?: string;
50
+ }
51
+ /**
52
+ * 컬럼 힌트 → ColumnFormatSpec(specId·AST 컴파일 1회). 명세 불변 동안 재사용(메모이즈 안정).
53
+ * / Compile a column hint into a ColumnFormatSpec (specId + one-time AST compile).
54
+ */
55
+ export declare function compileFormatSpec(input: FormatSpecInput): ColumnFormatSpec;
@@ -0,0 +1,8 @@
1
+ import { ColumnFormatSpec, DomainDirective, IDomainTypeResolver, InterpretedValue } from '../types.js';
2
+ /**
3
+ * 기본 도메인타입 해석기. valueMap 최우선, 그 다음 spec.domain, 폴백은 valueKind 추론.
4
+ * / Default resolver. valueMap wins; then spec.domain; falls back to inferring from valueKind.
5
+ */
6
+ export declare class DomainTypeResolver implements IDomainTypeResolver {
7
+ resolve(v: InterpretedValue, spec: ColumnFormatSpec): DomainDirective;
8
+ }
@@ -0,0 +1,11 @@
1
+ import { FormatContext, ILocaleFormat, NumberDirective } from '../types.js';
2
+ /**
3
+ * Intl 기반 로케일 서식. 잘못된 로케일/통화는 throw 아닌 폴백(never-throw, 렌더 루프 소비자).
4
+ * / Intl-based locale formatting; invalid locale/currency falls back instead of throwing.
5
+ */
6
+ export declare class LocaleFormat implements ILocaleFormat {
7
+ formatNumber(n: number, d: NumberDirective, ctx: FormatContext): string;
8
+ formatCurrency(n: number, currency: string, d: NumberDirective, ctx: FormatContext): string;
9
+ formatPercent(n: number, d: NumberDirective, ctx: FormatContext): string;
10
+ formatDate(d: Date, pattern: string | undefined, ctx: FormatContext): string;
11
+ }
@@ -0,0 +1,8 @@
1
+ import { FormatInput, InterpretedValue, IValueInterpreter } from '../types.js';
2
+ /**
3
+ * 기본 값객체 해석기. DD-01 값객체는 읽기만, 원시값은 런타임 추론.
4
+ * / Default interpreter. DD-01 value objects are read-only; primitives are inferred at runtime.
5
+ */
6
+ export declare class ValueInterpreter implements IValueInterpreter {
7
+ interpret(input: FormatInput): InterpretedValue;
8
+ }
@@ -0,0 +1,8 @@
1
+ import { IMaskPolicy, MaskDef, MaskType } from '../types.js';
2
+ /**
3
+ * 기본 마스킹 정책 — MaskingEngine.applyMask 래퍼(로직 재사용, 재구현 0).
4
+ * / Default mask policy — a thin wrapper over MaskingEngine.applyMask (no reimplementation).
5
+ */
6
+ export declare class MaskPolicy implements IMaskPolicy {
7
+ mask(value: string, def: MaskType | MaskDef): string;
8
+ }
@@ -0,0 +1,12 @@
1
+ import { INegativePolicy, NegativePolicy as NegPolicy, Sign } from '../types.js';
2
+ /**
3
+ * 기본 음수 정책. 이미 로케일 서식된 문자열을 받아 부호화 형태로 변환.
4
+ * / Default negative policy; transforms an already locale-formatted string.
5
+ */
6
+ export declare class NegativePolicy implements INegativePolicy {
7
+ encode(text: string, sign: Sign, p: NegPolicy): {
8
+ text: string;
9
+ aria?: string;
10
+ colorHint?: string;
11
+ };
12
+ }
@@ -0,0 +1,10 @@
1
+ import { FormatContext, FormatInput, INullPolicy } from '../types.js';
2
+ /**
3
+ * 기본 null 정책. raw 가 null/undefined/'' 이면 기본 표시값(default), 아니면 null(미참여).
4
+ * / Default null policy: raw null/empty → default display; otherwise null (not participating).
5
+ */
6
+ export declare class NullPolicy implements INullPolicy {
7
+ private readonly defaultText;
8
+ constructor(defaultText?: string);
9
+ render(input: FormatInput, _ctx: FormatContext): string | null;
10
+ }
@@ -0,0 +1,11 @@
1
+ import { AbbrevPolicy, FormatContext, ITruncatePolicy } from '../types.js';
2
+ /**
3
+ * 기본 축약 정책. threshold(기본 1000) 이상 절대값만 축약. 미만이면 null(미참여) 반환.
4
+ * / Default abbreviation policy; abbreviates only at/above threshold, else null.
5
+ */
6
+ export declare class TruncatePolicy implements ITruncatePolicy {
7
+ abbreviate(n: number, p: AbbrevPolicy, _ctx: FormatContext): {
8
+ text: string;
9
+ rawText: string;
10
+ } | null;
11
+ }