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,33 @@
1
+ import { PersistedRecord } from './IStatePersistence.js';
2
+ /** 다른 탭 저장 통지. / Notice of another tab's save. */
3
+ export interface TabConflictNotice {
4
+ readonly otherTabId: string;
5
+ readonly otherRevision: number;
6
+ readonly savedAt: number;
7
+ }
8
+ /**
9
+ * revision 기반 낙관적 잠금. observe/onExternalSave 로 최신 매체 리비전을 추적하고, checkBeforeSave
10
+ * 로 저장 전 충돌을 감지한다. 내 탭(tabId) 저장은 충돌로 보지 않는다.
11
+ * / Revision-based optimistic lock. Tracks the latest media revision via observe/onExternalSave and
12
+ * detects conflicts before a save via checkBeforeSave. My own tab's saves are never conflicts.
13
+ */
14
+ export declare class MultiTabGuard {
15
+ private readonly _tabId;
16
+ private _latestRevision;
17
+ private _latestRec;
18
+ constructor(_tabId: string);
19
+ get tabId(): string;
20
+ /** 매체에서 관측한 최신 레코드 반영(subscribe 콜백/명시 폴링). / Record the latest observed media state. */
21
+ observe(rec: PersistedRecord): void;
22
+ /**
23
+ * 저장 전 충돌 검사: 관측한 최신 리비전이 baseRevision 보다 앞서고 그게 다른 탭 소행이면 충돌.
24
+ * / Pre-save conflict check: conflict if the observed latest revision leads baseRevision and it
25
+ * came from another tab.
26
+ */
27
+ checkBeforeSave(baseRevision: number): 'ok' | {
28
+ conflict: PersistedRecord;
29
+ };
30
+ /** 다른 탭 저장 통지 수신 → 관측 반영 + 경고(내 탭이면 null). / Receive another tab's save notice. */
31
+ onExternalSave(rec: PersistedRecord): TabConflictNotice | null;
32
+ get latestRevision(): number;
33
+ }
@@ -0,0 +1,33 @@
1
+ import { SemVerPolicy } from './SemVerPolicy.js';
2
+ import { StateEnvelope } from './StateCodec.js';
3
+ export interface MigrationNote {
4
+ readonly fromMajor: number;
5
+ readonly toMajor: number;
6
+ readonly note: string;
7
+ }
8
+ /** 한 major 단계 변환기(fromMajor → fromMajor+1). / A single major-step migrator. */
9
+ export interface MigrationStep {
10
+ readonly fromMajor: number;
11
+ migrate(env: StateEnvelope): StateEnvelope;
12
+ }
13
+ export type MigrateResult = {
14
+ readonly env: StateEnvelope;
15
+ readonly notes: MigrationNote[];
16
+ } | {
17
+ readonly rejected: true;
18
+ readonly reason: string;
19
+ };
20
+ /** 버전 간 변환 체인 계약. / Inter-version migration chain contract. */
21
+ export interface SchemaMigrator {
22
+ migrate(env: unknown): MigrateResult;
23
+ }
24
+ /** 등록된 major 단계들을 순차 적용하는 기본 마이그레이터. / Default migrator applying registered major steps in sequence. */
25
+ export declare class DefaultSchemaMigrator implements SchemaMigrator {
26
+ private readonly _steps;
27
+ private readonly _current;
28
+ private readonly _policy;
29
+ constructor(current: string, policy?: SemVerPolicy);
30
+ /** major 승격 단계 등록(Strategy 확장점). / Register a major-promotion step (Strategy extension point). */
31
+ register(step: MigrationStep): this;
32
+ migrate(env: unknown): MigrateResult;
33
+ }
@@ -0,0 +1,39 @@
1
+ /** 'MAJOR.MINOR.PATCH' 만 허용하는 브랜드 문자열(파싱 실패 = 거부 대상). / Branded 'MAJOR.MINOR.PATCH'. */
2
+ export type SemVer = string & {
3
+ readonly __brand: 'SemVer';
4
+ };
5
+ /** 검증 없이 브랜드 부여(호출자 책임). 실검증은 parse/classify 가 한다. / Brand without validation. */
6
+ export declare function asSemVer(s: string): SemVer;
7
+ export interface ParsedSemVer {
8
+ readonly major: number;
9
+ readonly minor: number;
10
+ readonly patch: number;
11
+ }
12
+ /** classify 결과 — 5분기. / classify result — 5 branches. */
13
+ export type Classification = {
14
+ readonly kind: 'load';
15
+ } | {
16
+ readonly kind: 'tolerant';
17
+ readonly unknownSections: string[];
18
+ } | {
19
+ readonly kind: 'migrate';
20
+ readonly fromMajor: number;
21
+ } | {
22
+ readonly kind: 'reject';
23
+ readonly reason: string;
24
+ };
25
+ /** classify 부가 입력(관용 로드 시 미지 섹션 산출). / Extra input for classify (unknown-section derivation). */
26
+ export interface ClassifyContext {
27
+ readonly loadedSections?: readonly string[];
28
+ readonly knownSections?: readonly string[];
29
+ }
30
+ /** semver 비교 커널(단일 소유 — 봉투/커맨드 payloadVersion 공용). / semver comparison kernel. */
31
+ export interface SemVerPolicy {
32
+ parse(s: string): ParsedSemVer | null;
33
+ classify(loaded: string, current: string, ctx?: ClassifyContext): Classification;
34
+ }
35
+ /** §2.5.1 표를 구현한 기본 정책. / Default policy implementing the §2.5.1 table. */
36
+ export declare class DefaultSemVerPolicy implements SemVerPolicy {
37
+ parse(s: string): ParsedSemVer | null;
38
+ classify(loaded: string, current: string, ctx?: ClassifyContext): Classification;
39
+ }
@@ -0,0 +1,75 @@
1
+ import { SemVerPolicy } from './SemVerPolicy.js';
2
+ import { SchemaMigrator } from './SchemaMigrator.js';
3
+ /** 저장 봉투 — 전 서브시스템 조각의 합성 + 단일 버전 권위. / Save envelope — composition of all sections + single version authority. */
4
+ export interface StateEnvelope {
5
+ readonly schemaVersion: string;
6
+ readonly savedAt: number;
7
+ /** 커맨드 리비전(멀티탭 충돌 감지 키). / Command revision (multi-tab conflict key). */
8
+ readonly revision: number;
9
+ readonly sections: Record<string, unknown>;
10
+ }
11
+ /** 조각 로드 결과 — 부분실패는 값으로 신고(조용한 실패 0). / Section load result — partial failure reported as a value. */
12
+ export interface SectionLoadResult {
13
+ readonly restored?: boolean;
14
+ readonly partial?: {
15
+ readonly reason: string;
16
+ };
17
+ }
18
+ /**
19
+ * 봉투에 담기는 한 조각의 소유 계약(해당 DD 소유). 봉투는 이 계약을 호출만 하고 내부 스키마를 모른다.
20
+ * / Ownership contract for one section (owned by its DD). The envelope only calls it, never knows its schema.
21
+ */
22
+ export interface ISectionCodec {
23
+ readonly key: string;
24
+ toState(): unknown;
25
+ fromState(raw: unknown): SectionLoadResult;
26
+ }
27
+ /** 로드 결과 — 무엇이 복원/일부실패/거부됐는지 표면화(조용한 실패 금지). / Load result — surfaces restored/partial/rejected. */
28
+ export interface LoadResult {
29
+ readonly ok: boolean;
30
+ readonly restored: string[];
31
+ readonly partial: {
32
+ section: string;
33
+ reason: string;
34
+ }[];
35
+ readonly rejected?: string;
36
+ }
37
+ export interface StateCodecConfig {
38
+ /** 런타임이 아는 현재 봉투 버전. / Current envelope version known to the runtime. */
39
+ readonly current: string;
40
+ readonly sections: ISectionCodec[];
41
+ readonly policy?: SemVerPolicy;
42
+ readonly migrator?: SchemaMigrator;
43
+ /** 봉투에 심을 리비전 소스(CommandBus dirty/audit 연동). / Revision source stamped into the envelope. */
44
+ readonly revision?: () => number;
45
+ readonly now?: () => number;
46
+ }
47
+ /** getState/setState 정본 + 버전 마이그레이션 파사드. / Canonical getState/setState + version migration facade. */
48
+ export declare class StateCodec {
49
+ private readonly _current;
50
+ private readonly _sections;
51
+ private readonly _policy;
52
+ private readonly _migrator;
53
+ private readonly _rev;
54
+ private readonly _now;
55
+ /** future-minor 로드 시 보존한 미지 섹션(round-trip 무손실 재방출). / Opaque unknown sections preserved for lossless round-trip. */
56
+ private _opaque;
57
+ constructor(cfg: StateCodecConfig);
58
+ /** 살아있는 그리드 → 봉투. 각 조각의 toState() 합성 + 보존된 opaque 섹션 병합(무손실). / Live grid → envelope. */
59
+ getState(): StateEnvelope;
60
+ /**
61
+ * 봉투 → 살아있는 그리드. schemaVersion 라우팅(§2.5.1) → 마이그레이션/관용/거부 → 조각 fromState.
62
+ * 로드는 CommandBus 를 거치지 않는 초기화 경로(undo 스택 clear 는 호출자 책임).
63
+ * / envelope → live grid; routes by schemaVersion, then applies section fromState.
64
+ */
65
+ setState(env: unknown): LoadResult;
66
+ /**
67
+ * 왕복 자기검사(골든 하니스용): 두 봉투의 섹션 동일성. 조각 소유 DD 값객체 equals 를 못 부르는
68
+ * DD-09 층에서는 구조(JSON) 동일성으로 판정하고, 손실경계는 diffs 로 표면화한다.
69
+ * / Round-trip self-check: section equality between two envelopes (structural JSON compare here).
70
+ */
71
+ roundTripEquals(a: StateEnvelope, b: StateEnvelope): {
72
+ equal: boolean;
73
+ diffs: string[];
74
+ };
75
+ }
@@ -0,0 +1,6 @@
1
+ export { DefaultSemVerPolicy, asSemVer, type SemVer, type ParsedSemVer, type Classification, type ClassifyContext, type SemVerPolicy, } from './SemVerPolicy.js';
2
+ export { StateCodec, type StateEnvelope, type ISectionCodec, type SectionLoadResult, type LoadResult, type StateCodecConfig, } from './StateCodec.js';
3
+ export { DefaultSchemaMigrator, type SchemaMigrator, type MigrationStep, type MigrationNote, type MigrateResult, } from './SchemaMigrator.js';
4
+ export { InMemoryStatePersistence, LocalStorageStatePersistence, type IStatePersistence, type PersistedRecord, } from './IStatePersistence.js';
5
+ export { MultiTabGuard, type TabConflictNotice } from './MultiTabGuard.js';
6
+ export { AutosaveController, type AutosavePolicy, type AutosaveControllerConfig, type DraftStatus, type DraftDiff, } from './AutosaveController.js';