@datalking/begonia-browser-sdk 0.0.0-stage → 0.1.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 (151) hide show
  1. package/LICENSE.md +661 -0
  2. package/README.md +8 -2
  3. package/dist/browser-advanced-ooxml-command-types.d.ts +3 -0
  4. package/dist/browser-advanced-ooxml-edit-plan-shape.d.ts +3 -0
  5. package/dist/browser-advanced-ooxml-inspector-controller.d.ts +2 -0
  6. package/dist/browser-advanced-ooxml-inspector-formats.d.ts +71 -0
  7. package/dist/browser-advanced-ooxml-inspector-snapshot.d.ts +3 -0
  8. package/dist/browser-advanced-ooxml-inspector-types.d.ts +56 -0
  9. package/dist/browser-advanced-ooxml-nodeview-events.d.ts +168 -0
  10. package/dist/browser-advanced-ooxml-subtree-chart.d.ts +13 -0
  11. package/dist/browser-advanced-ooxml-subtree-editor.d.ts +38 -0
  12. package/dist/browser-advanced-ooxml-subtree-math-insertions.d.ts +2 -0
  13. package/dist/browser-advanced-ooxml-subtree-math-serialize.d.ts +3 -0
  14. package/dist/browser-advanced-ooxml-subtree-math-shared.d.ts +16 -0
  15. package/dist/browser-advanced-ooxml-subtree-math.d.ts +7 -0
  16. package/dist/browser-advanced-ooxml-subtree-shape-insertions.d.ts +2 -0
  17. package/dist/browser-advanced-ooxml-subtree-shape-parse.d.ts +3 -0
  18. package/dist/browser-advanced-ooxml-subtree-shape-sections.d.ts +16 -0
  19. package/dist/browser-advanced-ooxml-subtree-shape-types.d.ts +12 -0
  20. package/dist/browser-advanced-ooxml-subtree-shape.d.ts +4 -0
  21. package/dist/browser-advanced-ooxml-surface-feature-helpers.d.ts +3 -0
  22. package/dist/browser-advanced-ooxml-surface-feature.d.ts +4 -0
  23. package/dist/browser-command-controller.d.ts +2 -0
  24. package/dist/browser-command-types.d.ts +263 -0
  25. package/dist/browser-comment-target-selection.d.ts +22 -0
  26. package/dist/browser-document-api-selection.d.ts +26 -0
  27. package/dist/browser-editor-active-comment-selection.d.ts +21 -0
  28. package/dist/browser-editor-active-comment.d.ts +16 -0
  29. package/dist/browser-editor-active-revision.d.ts +19 -0
  30. package/dist/browser-editor-advanced-ooxml-chart.d.ts +22 -0
  31. package/dist/browser-editor-advanced-ooxml-core.d.ts +25 -0
  32. package/dist/browser-editor-advanced-ooxml-math.d.ts +10 -0
  33. package/dist/browser-editor-advanced-ooxml-nodeview-bridge.d.ts +5 -0
  34. package/dist/browser-editor-advanced-ooxml-shape.d.ts +25 -0
  35. package/dist/browser-editor-advanced-ooxml.d.ts +4 -0
  36. package/dist/browser-editor-backend-access.d.ts +9 -0
  37. package/dist/browser-editor-backend-adapter-v1.d.ts +4 -0
  38. package/dist/browser-editor-backend-adapter.d.ts +17 -0
  39. package/dist/browser-editor-collaboration-state-types.d.ts +15 -0
  40. package/dist/browser-editor-comment-navigation.d.ts +16 -0
  41. package/dist/browser-editor-comment-replay-target.d.ts +23 -0
  42. package/dist/browser-editor-comment-target-selection-v1.d.ts +7 -0
  43. package/dist/browser-editor-comments-controller.d.ts +4 -0
  44. package/dist/browser-editor-comments-types.d.ts +47 -0
  45. package/dist/browser-editor-comments-write-state.d.ts +11 -0
  46. package/dist/browser-editor-contracts-v1.d.ts +47 -0
  47. package/dist/browser-editor-contracts.d.ts +59 -0
  48. package/dist/browser-editor-create.d.ts +7 -0
  49. package/dist/browser-editor-domain-types.d.ts +87 -0
  50. package/dist/browser-editor-host.d.ts +14 -0
  51. package/dist/browser-editor-inline-format-actions.d.ts +19 -0
  52. package/dist/browser-editor-inline-format-state.d.ts +7 -0
  53. package/dist/browser-editor-mount-controller.d.ts +23 -0
  54. package/dist/browser-editor-mount.d.ts +8 -0
  55. package/dist/browser-editor-node-selection-rebase.d.ts +21 -0
  56. package/dist/browser-editor-node-selection-target-types.d.ts +9 -0
  57. package/dist/browser-editor-point-context.d.ts +27 -0
  58. package/dist/browser-editor-point-position.d.ts +3 -0
  59. package/dist/browser-editor-point-types.d.ts +16 -0
  60. package/dist/browser-editor-preserved-range-shared.d.ts +31 -0
  61. package/dist/browser-editor-preserved-range-state.d.ts +39 -0
  62. package/dist/browser-editor-preserved-range-target-selection.d.ts +29 -0
  63. package/dist/browser-editor-projected-selection-change-ranges.d.ts +14 -0
  64. package/dist/browser-editor-projected-selection-review-rebase.d.ts +26 -0
  65. package/dist/browser-editor-projected-selection-review-state.d.ts +20 -0
  66. package/dist/browser-editor-projected-selection-review-transitions.d.ts +33 -0
  67. package/dist/browser-editor-projection-snapshot.d.ts +41 -0
  68. package/dist/browser-editor-range-selection.d.ts +10 -0
  69. package/dist/browser-editor-review-comment-selection.d.ts +12 -0
  70. package/dist/browser-editor-review-projection.d.ts +16 -0
  71. package/dist/browser-editor-review-selection-state.d.ts +39 -0
  72. package/dist/browser-editor-runtime-v1.d.ts +16 -0
  73. package/dist/browser-editor-selection-capture-create.d.ts +8 -0
  74. package/dist/browser-editor-selection-capture.d.ts +17 -0
  75. package/dist/browser-editor-selection-geometry.d.ts +35 -0
  76. package/dist/browser-editor-selection-handle.d.ts +6 -0
  77. package/dist/browser-editor-selection-orientation.d.ts +14 -0
  78. package/dist/browser-editor-selection-rebase-targets-surface.d.ts +34 -0
  79. package/dist/browser-editor-selection-rebase-targets-types.d.ts +39 -0
  80. package/dist/browser-editor-selection-rebase-targets.d.ts +37 -0
  81. package/dist/browser-editor-selection-rebase.d.ts +29 -0
  82. package/dist/browser-editor-selection-restore.d.ts +23 -0
  83. package/dist/browser-editor-selection-snapshot.d.ts +35 -0
  84. package/dist/browser-editor-selection-target-from-block-path.d.ts +3 -0
  85. package/dist/browser-editor-surface-projection-mode.d.ts +10 -0
  86. package/dist/browser-editor-text-target-selection.d.ts +29 -0
  87. package/dist/browser-editor-track-change-navigation.d.ts +8 -0
  88. package/dist/browser-editor-track-change-types.d.ts +69 -0
  89. package/dist/browser-editor-track-changes-controller.d.ts +6 -0
  90. package/dist/browser-editor-types-collaboration.d.ts +57 -0
  91. package/dist/browser-editor-types-controller.d.ts +139 -0
  92. package/dist/browser-editor-types-shared.d.ts +205 -0
  93. package/dist/browser-editor-types-state.d.ts +45 -0
  94. package/dist/browser-editor-types.d.ts +7 -0
  95. package/dist/browser-editor-ui-controller.d.ts +4 -0
  96. package/dist/browser-editor-ui-source.d.ts +5 -0
  97. package/dist/browser-editor-ui-types.d.ts +73 -0
  98. package/dist/browser-editor-ui.d.ts +2 -0
  99. package/dist/browser-editor-view-intent.d.ts +35 -0
  100. package/dist/browser-editor-viewport/browser-editor-viewport-bounds.d.ts +41 -0
  101. package/dist/browser-editor-viewport/browser-editor-viewport-normalize.d.ts +25 -0
  102. package/dist/browser-editor-viewport-context-types.d.ts +19 -0
  103. package/dist/browser-editor-viewport-geometry.d.ts +45 -0
  104. package/dist/browser-editor-viewport-helpers.d.ts +2 -0
  105. package/dist/browser-editor-viewport-scroll-into-view.d.ts +30 -0
  106. package/dist/browser-editor-viewport-session-navigation.d.ts +4 -0
  107. package/dist/browser-editor-viewport-session-patch.d.ts +3 -0
  108. package/dist/browser-editor-viewport-session-state-types.d.ts +23 -0
  109. package/dist/browser-editor-viewport-session-state.d.ts +4 -0
  110. package/dist/browser-editor-viewport-types.d.ts +21 -0
  111. package/dist/browser-headless-toolbar-types.d.ts +92 -0
  112. package/dist/browser-headless-toolbar.d.ts +3 -0
  113. package/dist/browser-paginated-preview-binding-projection.d.ts +9 -0
  114. package/dist/browser-paginated-preview-controller-state.d.ts +84 -0
  115. package/dist/browser-paginated-preview-controller.d.ts +16 -0
  116. package/dist/browser-paginated-preview-editor-binding.d.ts +28 -0
  117. package/dist/browser-paginated-preview-helpers.d.ts +35 -0
  118. package/dist/browser-paginated-preview-lifecycle-reset.d.ts +18 -0
  119. package/dist/browser-paginated-preview-mode-state.d.ts +9 -0
  120. package/dist/browser-paginated-preview-navigation-anchor.d.ts +4 -0
  121. package/dist/browser-paginated-preview-pins.d.ts +17 -0
  122. package/dist/browser-paginated-preview-position-hit.d.ts +31 -0
  123. package/dist/browser-paginated-preview-reset-plan.d.ts +31 -0
  124. package/dist/browser-paginated-preview-selection-actions.d.ts +13 -0
  125. package/dist/browser-paginated-preview-selection-v1.d.ts +1 -0
  126. package/dist/browser-paginated-preview-selection.d.ts +20 -0
  127. package/dist/browser-paginated-preview-session-state.d.ts +51 -0
  128. package/dist/browser-paginated-preview-text-selection.d.ts +21 -0
  129. package/dist/browser-paginated-preview-ui-controller.d.ts +19 -0
  130. package/dist/browser-paginated-preview-view-model.d.ts +35 -0
  131. package/dist/browser-review-comment-types.d.ts +33 -0
  132. package/dist/browser-review-revision-types.d.ts +41 -0
  133. package/dist/browser-slash-menu-controller.d.ts +2 -0
  134. package/dist/browser-theme.d.ts +26 -0
  135. package/dist/command.js +5 -0
  136. package/dist/editor.d.ts +36 -0
  137. package/dist/editor.js +4 -0
  138. package/dist/index.d.ts +24 -0
  139. package/dist/index.js +5 -0
  140. package/dist/ooxml.d.ts +17 -0
  141. package/dist/ooxml.js +4 -0
  142. package/dist/paginated-preview-selection-table/preview-selection-table-hit.d.ts +7 -0
  143. package/dist/paginated-preview-selection-table/preview-selection-table-resolve.d.ts +76 -0
  144. package/dist/paginated-preview-selection-v1/preview-selection-v1-handle.d.ts +7 -0
  145. package/dist/paginated-preview-selection-v1/preview-selection-v1-resolve.d.ts +33 -0
  146. package/dist/preview.d.ts +7 -0
  147. package/dist/preview.js +1 -0
  148. package/dist/theme.js +1 -0
  149. package/dist/v1.d.ts +40 -0
  150. package/dist/v1.js +9 -0
  151. package/package.json +63 -4
@@ -0,0 +1,25 @@
1
+ import type { BrowserViewportState } from '../browser-editor-types.ts';
2
+ export declare const DEFAULT_BROWSER_ZOOM_PERCENT = 100;
3
+ export declare const VIEWPORT_GEOMETRY_TOLERANCE_PX = 1;
4
+ export declare const VIEWPORT_SCALE_TOLERANCE = 0.000001;
5
+ export declare function isFiniteNumber(value: unknown): value is number;
6
+ export declare function sameFiniteNumberWithin(left: number, right: number, tolerance?: number): boolean;
7
+ export declare function sameNullableFiniteNumberWithin(left: number | null | undefined, right: number | null | undefined, tolerance?: number): boolean;
8
+ export declare function readNonNegativeInteger(value: unknown, fallback?: number): number;
9
+ export declare function readNullableNonNegativeInteger(value: unknown): number | null;
10
+ export declare function readNullablePositiveInteger(value: unknown): number | null;
11
+ export declare function normalizeViewportPageList(pageIndexValues: unknown, pageNumberValues: unknown): {
12
+ pageIndexes: number[];
13
+ pageNumbers: number[];
14
+ } | null;
15
+ export declare function normalizeLayoutMode(value: unknown): BrowserViewportState['layoutMode'];
16
+ export declare function normalizeFlowMode(value: unknown): BrowserViewportState['flowMode'];
17
+ export declare function normalizeScale(value: unknown): number | null;
18
+ export declare function normalizeViewportModes(flowModeValue: unknown, layoutModeValue: unknown): {
19
+ flowMode: "web";
20
+ layoutMode: 'vertical';
21
+ } | {
22
+ flowMode: "paginated" | null;
23
+ layoutMode: import("@datalking/begonia-layout-contracts").LayoutArrangement | null;
24
+ } | null;
25
+ export declare function isGeometricEmptyBandViewportAnchor(viewportAnchor: BrowserViewportState['viewportAnchor']): boolean;
@@ -0,0 +1,19 @@
1
+ import type { SelectionInfo } from '@datalking/begonia-document-api/core';
2
+ import type { BrowserEditorPositionAtPoint } from './browser-editor-point-types.ts';
3
+ export type BrowserEditorViewportEntityHit = {
4
+ type: 'comment';
5
+ id: string;
6
+ } | {
7
+ type: 'trackedChange';
8
+ id: string;
9
+ };
10
+ export interface BrowserEditorViewportContext {
11
+ point: {
12
+ x: number;
13
+ y: number;
14
+ };
15
+ entities: readonly BrowserEditorViewportEntityHit[];
16
+ position: BrowserEditorPositionAtPoint | null;
17
+ selection: SelectionInfo | null;
18
+ insideSelection: boolean;
19
+ }
@@ -0,0 +1,45 @@
1
+ import type { DocumentApiContract as DocumentApi, SelectionTextTarget } from '@datalking/begonia-document-api/core';
2
+ import { type ProjectionSelectionRect } from '@datalking/begonia-page-layout';
3
+ import { type BrowserPaginatedPreviewEditorBinding } from './browser-paginated-preview-editor-binding.ts';
4
+ import type { BrowserEditorViewportEntityHit } from './browser-editor-viewport-context-types.ts';
5
+ type BrowserDocumentApi = DocumentApi;
6
+ export type BrowserEditorViewportRectTarget = SelectionTextTarget | BrowserEditorViewportEntityHit;
7
+ export interface BrowserEditorViewportGetRectInput {
8
+ target: BrowserEditorViewportRectTarget | null | undefined;
9
+ }
10
+ export interface BrowserEditorResolvedViewportRect {
11
+ pageIndex: number;
12
+ pageNumber: number;
13
+ sectionId?: string | null;
14
+ region: ProjectionSelectionRect['region'];
15
+ blockIndex: number;
16
+ fragmentIndex: number;
17
+ columnIndex: number;
18
+ lineIndex: number;
19
+ lineCount: number;
20
+ left: number;
21
+ top: number;
22
+ width: number;
23
+ height: number;
24
+ }
25
+ export type BrowserEditorViewportRectFailureReason = 'not-ready' | 'invalid-target' | 'unresolved' | 'not-mounted';
26
+ export type BrowserEditorViewportGeometryReason = 'layout' | 'zoom' | 'scroll' | 'resize' | 'mixed';
27
+ export interface BrowserEditorViewportGeometryEvent {
28
+ reason: BrowserEditorViewportGeometryReason;
29
+ }
30
+ export type BrowserEditorViewportRectResult = {
31
+ success: true;
32
+ rect: BrowserEditorResolvedViewportRect;
33
+ rects: BrowserEditorResolvedViewportRect[];
34
+ pageIndex: number;
35
+ pageNumber: number;
36
+ } | {
37
+ success: false;
38
+ reason: BrowserEditorViewportRectFailureReason;
39
+ };
40
+ export interface BrowserEditorViewportRectSource {
41
+ preview: BrowserPaginatedPreviewEditorBinding | null | undefined;
42
+ documentApi: BrowserDocumentApi | null | undefined;
43
+ }
44
+ export declare function resolveBrowserEditorViewportRect(source: BrowserEditorViewportRectSource, input: BrowserEditorViewportGetRectInput): BrowserEditorViewportRectResult;
45
+ export {};
@@ -0,0 +1,2 @@
1
+ export { normalizeBrowserViewportPageAddress, normalizeBrowserZoomPercent, normalizeBrowserViewportRequestKey, sameBrowserViewportRequestKey, hasFreshBrowserViewportRequest, readBrowserZoomPercent, isBrowserViewportStateCompatibleWithFlowMode, isBrowserViewportStateCompatibleWithLayoutMode, isBrowserViewportStateCompatibleWithModes, sameBrowserViewportAnchor, normalizeBrowserViewportAnchor, resolveCompatibleBrowserPreviewViewportAnchor, browserViewportStateHasExplicitModeConflict, sameBrowserViewportState, sameBrowserViewportStateForControllerSync, cloneBrowserViewportState, fillBrowserViewportStateModes, } from './browser-editor-viewport/browser-editor-viewport-bounds.ts';
2
+ export { DEFAULT_BROWSER_ZOOM_PERCENT } from './browser-editor-viewport/browser-editor-viewport-normalize.ts';
@@ -0,0 +1,30 @@
1
+ import type { DocumentApiContract as DocumentApi, SelectionTextTarget } from '@datalking/begonia-document-api/core';
2
+ import { type BrowserBlockPathSelectionTargetDocumentApi } from './browser-editor-selection-target-from-block-path.ts';
3
+ import type { BrowserEditorViewportRectTarget } from './browser-editor-viewport-geometry.ts';
4
+ import type { BrowserPaginatedPreviewEditorBinding } from './browser-paginated-preview-editor-binding.ts';
5
+ import type { BrowserPreviewNavigationRequest } from './browser-editor-types-shared.ts';
6
+ type BrowserDocumentApi = BrowserBlockPathSelectionTargetDocumentApi & Pick<DocumentApi, 'comments' | 'trackChanges'>;
7
+ export interface BrowserEditorViewportScrollOptions {
8
+ timeoutMs?: number | null | undefined;
9
+ }
10
+ export interface BrowserEditorAsyncContinuation {
11
+ shouldContinue?: (() => boolean) | null | undefined;
12
+ subscribe?: ((listener: () => void) => (() => void) | void) | null | undefined;
13
+ }
14
+ export interface BrowserEditorViewportScrollIntoViewInput extends BrowserEditorViewportScrollOptions {
15
+ target: BrowserEditorViewportRectTarget | null | undefined;
16
+ continuation?: BrowserEditorAsyncContinuation | null | undefined;
17
+ }
18
+ export interface BrowserEditorViewportScrollIntoViewResult {
19
+ success: boolean;
20
+ }
21
+ export interface BrowserEditorViewportScrollIntoViewSource {
22
+ documentApi: BrowserDocumentApi | null | undefined;
23
+ preview: BrowserPaginatedPreviewEditorBinding | null | undefined;
24
+ subscribe(listener: () => void): () => void;
25
+ readPendingNavigationRequest(): BrowserPreviewNavigationRequest | null;
26
+ requestNavigationForTextTarget(target: SelectionTextTarget | null | undefined): BrowserPreviewNavigationRequest | null;
27
+ }
28
+ export declare function resolveBrowserEditorViewportScrollTarget(source: Pick<BrowserEditorViewportScrollIntoViewSource, 'documentApi' | 'preview'>, target: BrowserEditorViewportRectTarget | null | undefined): SelectionTextTarget | null;
29
+ export declare function scrollBrowserEditorViewportIntoView(source: BrowserEditorViewportScrollIntoViewSource, input: BrowserEditorViewportScrollIntoViewInput): Promise<BrowserEditorViewportScrollIntoViewResult>;
30
+ export {};
@@ -0,0 +1,4 @@
1
+ import type { BrowserPreviewNavigationRequestInput, BrowserViewportRequestKey } from './browser-editor-types.ts';
2
+ import type { BrowserPreviewNavigationStateResult, BrowserViewportSessionState } from './browser-editor-viewport-session-state-types.ts';
3
+ export declare function requestBrowserPreviewNavigation(state: BrowserViewportSessionState, request: BrowserPreviewNavigationRequestInput): BrowserPreviewNavigationStateResult;
4
+ export declare function acknowledgeBrowserPreviewNavigation(state: BrowserViewportSessionState, requestKey: BrowserViewportRequestKey | undefined): BrowserViewportSessionState;
@@ -0,0 +1,3 @@
1
+ import type { BrowserViewStatePatch } from './browser-editor-types.ts';
2
+ import type { BrowserViewStatePatchResult, BrowserViewportSessionState } from './browser-editor-viewport-session-state-types.ts';
3
+ export declare function applyBrowserViewStatePatch(state: BrowserViewportSessionState, patch: BrowserViewStatePatch, currentZoomPercent: number): BrowserViewStatePatchResult;
@@ -0,0 +1,23 @@
1
+ import type { BrowserEditorFlowMode, BrowserEditorLayoutMode, BrowserPreviewNavigationRequest, BrowserResolvedViewportRequestKey, BrowserViewportRequestKey, BrowserViewportState } from './browser-editor-types.ts';
2
+ export interface BrowserViewportSessionState {
3
+ flowMode: BrowserEditorFlowMode;
4
+ layoutMode: BrowserEditorLayoutMode;
5
+ preferredPaginatedLayoutMode: BrowserEditorLayoutMode;
6
+ viewport: BrowserViewportState | null;
7
+ viewportRequestKey: BrowserViewportRequestKey;
8
+ previewNavigationRequest: BrowserPreviewNavigationRequest | null;
9
+ nextPreviewNavigationRequestToken: number;
10
+ }
11
+ export interface BrowserPreviewNavigationStateResult {
12
+ nextState: BrowserViewportSessionState;
13
+ request: BrowserPreviewNavigationRequest | null;
14
+ changed: boolean;
15
+ }
16
+ export interface BrowserViewStatePatchResult {
17
+ nextState: BrowserViewportSessionState;
18
+ nextZoomPercent: number;
19
+ changed: boolean;
20
+ modesChanged: boolean;
21
+ }
22
+ export declare function createBrowserViewportSessionState(flowMode: BrowserEditorFlowMode, layoutMode: BrowserEditorLayoutMode, preferredPaginatedLayoutMode?: BrowserEditorLayoutMode): BrowserViewportSessionState;
23
+ export declare function resolveBrowserPreviewNavigationRequestKey(state: BrowserViewportSessionState): BrowserResolvedViewportRequestKey | null;
@@ -0,0 +1,4 @@
1
+ export { acknowledgeBrowserPreviewNavigation, requestBrowserPreviewNavigation, } from './browser-editor-viewport-session-navigation.ts';
2
+ export { applyBrowserViewStatePatch } from './browser-editor-viewport-session-patch.ts';
3
+ export { createBrowserViewportSessionState, resolveBrowserPreviewNavigationRequestKey, } from './browser-editor-viewport-session-state-types.ts';
4
+ export type { BrowserPreviewNavigationStateResult, BrowserViewportSessionState, BrowserViewStatePatchResult, } from './browser-editor-viewport-session-state-types.ts';
@@ -0,0 +1,21 @@
1
+ import type { SelectionTextTarget } from '@datalking/begonia-document-api/core';
2
+ import type { BrowserEditorPositionAtPoint, ResolveBrowserEditorPositionAtPointInput } from './browser-editor-point-types.ts';
3
+ import type { BrowserEditorViewportGeometryEvent } from './browser-editor-viewport-geometry.ts';
4
+ import type { BrowserEditorViewportScrollIntoViewInput, BrowserEditorViewportScrollIntoViewResult } from './browser-editor-viewport-scroll-into-view.ts';
5
+ import type { BrowserEditorViewportContext, BrowserEditorViewportEntityHit } from './browser-editor-viewport-context-types.ts';
6
+ import type { BrowserPreviewNavigationRequest, BrowserPreviewNavigationRequestInput, BrowserViewportState } from './browser-editor-types-shared.ts';
7
+ export interface BrowserEditorViewportHandle {
8
+ getSnapshot(): BrowserViewportState | null;
9
+ subscribe(listener: () => void): () => void;
10
+ observe(listener: (snapshot: BrowserViewportState | null) => void): () => void;
11
+ observeGeometry(listener: (event: BrowserEditorViewportGeometryEvent) => void): () => void;
12
+ scrollIntoView(input: BrowserEditorViewportScrollIntoViewInput): Promise<BrowserEditorViewportScrollIntoViewResult>;
13
+ getHost(): HTMLElement | null;
14
+ getScrollContainer(): HTMLElement | null;
15
+ entitiesAtPoint(input: ResolveBrowserEditorPositionAtPointInput): BrowserEditorViewportEntityHit[];
16
+ contextAtPoint(input: ResolveBrowserEditorPositionAtPointInput): BrowserEditorViewportContext;
17
+ positionAtPoint(input: ResolveBrowserEditorPositionAtPointInput): BrowserEditorPositionAtPoint | null;
18
+ requestNavigation(request: BrowserPreviewNavigationRequestInput): BrowserPreviewNavigationRequest | null;
19
+ requestNavigationForTextTarget(target: SelectionTextTarget | null | undefined): BrowserPreviewNavigationRequest | null;
20
+ ackNavigationRequest(requestKey?: BrowserPreviewNavigationRequest['requestKey'] | null): void;
21
+ }
@@ -0,0 +1,92 @@
1
+ import type { BrowserCommandCatalogEntry, BrowserCommandController, BrowserCommandExecutionResult, BrowserCommandHostTarget, BrowserCommandId, BrowserCommandSnapshot, BrowserCommandState, BrowserCommandTarget } from './browser-command-types.ts';
2
+ export type BrowserHeadlessToolbarItemId = BrowserCommandId;
3
+ export type BrowserHeadlessToolbarItemState = BrowserCommandState;
4
+ export interface BrowserHeadlessToolbarSection {
5
+ id: string;
6
+ label: string;
7
+ commandIds: readonly BrowserHeadlessToolbarItemId[];
8
+ }
9
+ export interface BrowserHeadlessToolbarSectionItem {
10
+ id: BrowserHeadlessToolbarItemId;
11
+ title: string;
12
+ description: string | null;
13
+ group: string | null;
14
+ keywords: readonly string[];
15
+ slash: boolean;
16
+ state: BrowserHeadlessToolbarItemState | null;
17
+ }
18
+ export interface BrowserHeadlessToolbarSectionSnapshot {
19
+ id: string;
20
+ label: string;
21
+ items: readonly BrowserHeadlessToolbarSectionItem[];
22
+ }
23
+ export interface BrowserHeadlessToolbarTarget {
24
+ execute: BrowserCommandController['execute'];
25
+ getSnapshot(): BrowserCommandSnapshot;
26
+ subscribe(listener: (snapshot: BrowserCommandSnapshot) => void): () => void;
27
+ observe(listener: (snapshot: BrowserCommandSnapshot) => void): () => void;
28
+ doc: BrowserCommandTarget['documentApi'];
29
+ }
30
+ export interface BrowserHeadlessToolbarContext {
31
+ selection: ReturnType<BrowserCommandController['getSnapshot']>['context']['selection'];
32
+ documentMode: ReturnType<BrowserCommandController['getSnapshot']>['context']['documentMode'];
33
+ editable: boolean;
34
+ trackChanges: ReturnType<BrowserCommandController['getSnapshot']>['context']['trackChanges'];
35
+ flowMode: ReturnType<BrowserCommandController['getSnapshot']>['context']['flowMode'];
36
+ layoutMode: ReturnType<BrowserCommandController['getSnapshot']>['context']['layoutMode'];
37
+ preferredPaginatedLayoutMode: ReturnType<BrowserCommandController['getSnapshot']>['context']['preferredPaginatedLayoutMode'];
38
+ zoomPercent: number;
39
+ viewport: ReturnType<BrowserCommandController['getSnapshot']>['context']['viewport'];
40
+ totalPages: number | null;
41
+ currentPageIndex: number | null;
42
+ currentPageNumber: number | null;
43
+ searchQuery: string;
44
+ searchHitCount: number;
45
+ activeSearchHitId: string | null;
46
+ activeSearchHitIndex: number;
47
+ revisionCount: number;
48
+ firstRevisionId: string | null;
49
+ proofingDiagnosticCount: number;
50
+ firstProofingDiagnosticId: string | null;
51
+ target: BrowserHeadlessToolbarTarget;
52
+ }
53
+ export interface BrowserHeadlessToolbarSnapshot {
54
+ context: BrowserHeadlessToolbarContext;
55
+ catalog: readonly BrowserCommandCatalogEntry[];
56
+ commands: Partial<Record<BrowserHeadlessToolbarItemId, BrowserHeadlessToolbarItemState>>;
57
+ sections: readonly BrowserHeadlessToolbarSectionSnapshot[];
58
+ }
59
+ export interface BrowserHeadlessToolbarSubscriptionEvent {
60
+ snapshot: BrowserHeadlessToolbarSnapshot;
61
+ }
62
+ interface BrowserHeadlessToolbarOptionsBase {
63
+ commandIds?: readonly BrowserHeadlessToolbarItemId[];
64
+ catalog?: readonly BrowserCommandCatalogEntry[];
65
+ sections?: readonly BrowserHeadlessToolbarSection[];
66
+ }
67
+ export type CreateBrowserHeadlessToolbarOptions = ({
68
+ ui: BrowserCommandTarget;
69
+ host?: never;
70
+ commands?: never;
71
+ } & BrowserHeadlessToolbarOptionsBase) | ({
72
+ host: BrowserCommandHostTarget;
73
+ ui?: never;
74
+ commands?: never;
75
+ } & BrowserHeadlessToolbarOptionsBase) | ({
76
+ commands: BrowserCommandController;
77
+ ui?: never;
78
+ host?: never;
79
+ commandIds?: never;
80
+ } & Omit<BrowserHeadlessToolbarOptionsBase, 'commandIds' | 'catalog'>);
81
+ export interface BrowserHeadlessToolbarController {
82
+ readonly target: BrowserCommandTarget;
83
+ /** @deprecated Use target. */
84
+ readonly ui: BrowserCommandTarget;
85
+ commands: BrowserCommandController;
86
+ getSnapshot(): BrowserHeadlessToolbarSnapshot;
87
+ subscribe(listener: (event: BrowserHeadlessToolbarSubscriptionEvent) => void): () => void;
88
+ observe(listener: (snapshot: BrowserHeadlessToolbarSnapshot) => void): () => void;
89
+ execute(id: BrowserHeadlessToolbarItemId, payload?: unknown): BrowserCommandExecutionResult;
90
+ destroy(): void;
91
+ }
92
+ export {};
@@ -0,0 +1,3 @@
1
+ import type { BrowserHeadlessToolbarController, CreateBrowserHeadlessToolbarOptions } from './browser-headless-toolbar-types.ts';
2
+ export declare function createBrowserHeadlessToolbar(options: CreateBrowserHeadlessToolbarOptions): BrowserHeadlessToolbarController;
3
+ export declare const createHeadlessToolbar: typeof createBrowserHeadlessToolbar;
@@ -0,0 +1,9 @@
1
+ import type { LayoutProjection } from '@datalking/begonia-layout-contracts';
2
+ import type { BrowserPaginatedPreviewEditorBinding } from './browser-paginated-preview-editor-binding.ts';
3
+ export interface ResolveBrowserPaginatedPreviewBindingProjectionInput {
4
+ binding: BrowserPaginatedPreviewEditorBinding | null | undefined;
5
+ source: unknown;
6
+ explicitProjection?: LayoutProjection | null | undefined;
7
+ resolvedProjection?: LayoutProjection | null | undefined;
8
+ }
9
+ export declare function resolveBrowserPaginatedPreviewBindingProjection(input: ResolveBrowserPaginatedPreviewBindingProjectionInput): LayoutProjection | null;
@@ -0,0 +1,84 @@
1
+ import type { LayoutProjection } from '@datalking/begonia-layout-contracts';
2
+ import type { BrowserEditorFlowMode, BrowserEditorLayoutMode, BrowserPreviewControllerNavigationMode, BrowserViewportState } from './browser-editor-types-shared.ts';
3
+ import type { BrowserEditorState } from './browser-editor-types-state.ts';
4
+ import { type BrowserPaginatedPreviewEditorBinding } from './browser-paginated-preview-editor-binding.ts';
5
+ import { resolveBrowserPaginatedPreviewControllerSyncState, resolveBrowserPaginatedPreviewSourceBinding } from './browser-paginated-preview-helpers.ts';
6
+ import type { BrowserPaginatedPreviewLifecycleResetCause } from './browser-paginated-preview-lifecycle-reset.ts';
7
+ import { type BrowserPaginatedPreviewModeOptions } from './browser-paginated-preview-mode-state.ts';
8
+ import type { BrowserPaginatedPreviewPositionHitEvent } from './browser-paginated-preview-position-hit.ts';
9
+ import type { BrowserPaginatedPreviewSessionState } from './browser-paginated-preview-session-state.ts';
10
+ import { type BrowserPaginatedPreviewViewModel } from './browser-paginated-preview-view-model.ts';
11
+ export interface BrowserPaginatedPreviewControllerInput {
12
+ editor: BrowserPaginatedPreviewEditorBinding | null;
13
+ source: unknown;
14
+ explicitProjection?: LayoutProjection | null | undefined;
15
+ explicitScale?: number | undefined;
16
+ pageGap?: number | undefined;
17
+ explicitFlowMode?: BrowserEditorFlowMode | undefined;
18
+ explicitLayoutMode?: BrowserEditorLayoutMode | undefined;
19
+ explicitAnchorPageNumber?: number | null | undefined;
20
+ controllerNavigationMode?: BrowserPreviewControllerNavigationMode | undefined;
21
+ syncViewportToEditor?: boolean | undefined;
22
+ pinnedPageNumbers?: readonly number[] | undefined;
23
+ layoutResolutionIdentity?: unknown;
24
+ }
25
+ export interface BrowserPaginatedPreviewControllerSnapshot {
26
+ previewProjection: LayoutProjection | null;
27
+ viewModel: BrowserPaginatedPreviewViewModel;
28
+ pinnedPageNumbers?: readonly number[] | undefined;
29
+ viewportResetVersion: number;
30
+ }
31
+ export interface NormalizedBrowserPaginatedPreviewControllerInput {
32
+ editor: BrowserPaginatedPreviewEditorBinding | null;
33
+ source: unknown;
34
+ boundToEditorDocument: boolean;
35
+ explicitProjection: LayoutProjection | null;
36
+ explicitScale?: number | undefined;
37
+ pageGap?: number | undefined;
38
+ explicitFlowMode?: BrowserEditorFlowMode | undefined;
39
+ explicitLayoutMode?: BrowserEditorLayoutMode | undefined;
40
+ explicitAnchorPageNumber: number | null;
41
+ controllerNavigationMode: BrowserPreviewControllerNavigationMode;
42
+ syncViewportToEditor: boolean;
43
+ pinnedPageNumbers?: readonly number[] | undefined;
44
+ layoutResolutionIdentity: unknown;
45
+ }
46
+ export interface BrowserPaginatedPreviewControllerLifecycleState {
47
+ editor: BrowserPaginatedPreviewEditorBinding | null;
48
+ controllerNavigationMode: BrowserPreviewControllerNavigationMode;
49
+ flowMode: BrowserEditorFlowMode | null | undefined;
50
+ layoutMode: BrowserEditorLayoutMode | null | undefined;
51
+ syncViewportToEditor: boolean;
52
+ previewSourceIdentity: unknown;
53
+ explicitAnchorPageNumber: number | null;
54
+ }
55
+ export interface BrowserPaginatedPreviewControllerDerivedState {
56
+ sourceBinding: ReturnType<typeof resolveBrowserPaginatedPreviewSourceBinding>;
57
+ controllerSyncState: ReturnType<typeof resolveBrowserPaginatedPreviewControllerSyncState>;
58
+ modeOptions: BrowserPaginatedPreviewModeOptions;
59
+ viewModel: BrowserPaginatedPreviewViewModel;
60
+ }
61
+ export declare function normalizeBrowserPaginatedPreviewControllerInput(input: BrowserPaginatedPreviewControllerInput): NormalizedBrowserPaginatedPreviewControllerInput;
62
+ export declare function sameBrowserPaginatedPreviewControllerSnapshot(left: BrowserPaginatedPreviewControllerSnapshot, right: BrowserPaginatedPreviewControllerSnapshot): boolean;
63
+ export declare function cloneBrowserPaginatedPreviewControllerSnapshot(value: BrowserPaginatedPreviewControllerSnapshot): BrowserPaginatedPreviewControllerSnapshot;
64
+ export declare function resolveBrowserPaginatedPreviewInteractionSelectionPageNumbers(event: BrowserPaginatedPreviewPositionHitEvent): number[];
65
+ export declare function deriveBrowserPaginatedPreviewControllerState(input: NormalizedBrowserPaginatedPreviewControllerInput, editorState: BrowserEditorState | null): BrowserPaginatedPreviewControllerDerivedState;
66
+ export declare function createBrowserPaginatedPreviewControllerLifecycleState(input: NormalizedBrowserPaginatedPreviewControllerInput, derived: BrowserPaginatedPreviewControllerDerivedState): BrowserPaginatedPreviewControllerLifecycleState;
67
+ export declare function shouldClearBrowserPaginatedPreviewResolvedProjection(input: {
68
+ previousInput: NormalizedBrowserPaginatedPreviewControllerInput;
69
+ nextInput: NormalizedBrowserPaginatedPreviewControllerInput;
70
+ resetCause: BrowserPaginatedPreviewLifecycleResetCause | null;
71
+ }): boolean;
72
+ export declare function resolveBrowserPaginatedPreviewProjection(input: NormalizedBrowserPaginatedPreviewControllerInput, resolvedProjection: LayoutProjection | null): LayoutProjection | null;
73
+ export declare function resolveBrowserPaginatedPreviewEditorZoomViewportMetrics(input: {
74
+ derived: BrowserPaginatedPreviewControllerDerivedState;
75
+ previewProjection: LayoutProjection | null;
76
+ viewport: BrowserViewportState | null | undefined;
77
+ controllerViewport?: BrowserViewportState | null | undefined;
78
+ fallbackViewport?: BrowserViewportState | null | undefined;
79
+ pageGap: number | undefined;
80
+ }): import("@datalking/begonia-layout-renderer").ViewportFitMetrics | null;
81
+ export declare function buildBrowserPaginatedPreviewControllerSnapshot(input: NormalizedBrowserPaginatedPreviewControllerInput, editorState: BrowserEditorState | null, derived: BrowserPaginatedPreviewControllerDerivedState, sessionState: BrowserPaginatedPreviewSessionState, resolvedProjection: LayoutProjection | null, interactionSelectionPageNumbers: readonly number[] | null): BrowserPaginatedPreviewControllerSnapshot;
82
+ export declare function settleBrowserPaginatedPreviewSuppressedRequestKey(suppressedPreviewNavigationRequestKey: string | number | null, editorState: Pick<BrowserEditorState, 'previewNavigationRequest'> | null | undefined): string | number | null;
83
+ export declare function suppressAcknowledgedBrowserPaginatedPreviewRequest(editorState: BrowserEditorState | null, suppressedPreviewNavigationRequestKey: string | number | null): BrowserEditorState | null;
84
+ export declare function syncBrowserPaginatedPreviewSessionState(sessionState: BrowserPaginatedPreviewSessionState, input: NormalizedBrowserPaginatedPreviewControllerInput, derived: BrowserPaginatedPreviewControllerDerivedState, editorState: BrowserEditorState | null): BrowserPaginatedPreviewSessionState;
@@ -0,0 +1,16 @@
1
+ import type { LayoutProjection } from '@datalking/begonia-layout-contracts';
2
+ import type { BrowserViewportState } from './browser-editor-types-shared.ts';
3
+ import type { BrowserPaginatedPreviewPositionHitEvent } from './browser-paginated-preview-position-hit.ts';
4
+ import { type BrowserPaginatedPreviewControllerInput, type BrowserPaginatedPreviewControllerSnapshot } from './browser-paginated-preview-controller-state.ts';
5
+ export type { BrowserPaginatedPreviewControllerInput, BrowserPaginatedPreviewControllerSnapshot, } from './browser-paginated-preview-controller-state.ts';
6
+ export interface BrowserPaginatedPreviewController {
7
+ getSnapshot(): BrowserPaginatedPreviewControllerSnapshot;
8
+ subscribe(listener: (snapshot: BrowserPaginatedPreviewControllerSnapshot) => void): () => void;
9
+ setInput(input: BrowserPaginatedPreviewControllerInput): void;
10
+ setResolvedProjection(projection: LayoutProjection | null): void;
11
+ observeViewport(viewport: BrowserViewportState, viewportResetVersion?: number | null): void;
12
+ resolvePositionHitEvent(event: BrowserPaginatedPreviewPositionHitEvent): BrowserPaginatedPreviewPositionHitEvent;
13
+ handlePositionHit(event: BrowserPaginatedPreviewPositionHitEvent): boolean;
14
+ destroy(): void;
15
+ }
16
+ export declare function createBrowserPaginatedPreviewController(input: BrowserPaginatedPreviewControllerInput): BrowserPaginatedPreviewController;
@@ -0,0 +1,28 @@
1
+ import type { EditorLayoutAdapter, LayoutProjection, LayoutProjectionOptions } from '@datalking/begonia-layout-contracts';
2
+ import type { BrowserPaginatedPreviewSelectionActions } from './browser-paginated-preview-selection-actions.ts';
3
+ import type { BrowserEditorState } from './browser-editor-types-state.ts';
4
+ import type { BrowserEditorZoomViewportMetrics, BrowserPreviewNavigationRequest, BrowserPreviewNavigationRequestInput, BrowserViewStatePatch } from './browser-editor-types-shared.ts';
5
+ export interface BrowserPaginatedPreviewEditorBinding {
6
+ readLayoutAdapter(): EditorLayoutAdapter<unknown> | null;
7
+ readLayoutSource(): unknown | null;
8
+ readDocumentSize?(): number | null;
9
+ getResolvedProjection?(): LayoutProjection | null;
10
+ getResolvedProjectionGeometryOptions?(): BrowserPaginatedPreviewProjectionGeometryOptions | null;
11
+ setResolvedProjection?(projection: LayoutProjection | null, geometryOptions?: BrowserPaginatedPreviewProjectionGeometryOptions | null): void;
12
+ subscribeResolvedProjection?(listener: (projection: LayoutProjection | null) => void): () => void;
13
+ selection?: BrowserPaginatedPreviewSelectionActions<unknown>;
14
+ getState(): BrowserEditorState | null;
15
+ subscribe(listener: (state: BrowserEditorState) => void): () => void;
16
+ requestPreviewNavigation(request: BrowserPreviewNavigationRequestInput): BrowserPreviewNavigationRequest | null;
17
+ ackPreviewNavigationRequest(requestKey?: BrowserPreviewNavigationRequest['requestKey'] | null): void;
18
+ setViewState(patch: BrowserViewStatePatch): void;
19
+ setZoomViewportMetrics(metrics: BrowserEditorZoomViewportMetrics | null): void;
20
+ }
21
+ export interface BrowserPaginatedPreviewProjectionGeometryOptions {
22
+ measureText?: LayoutProjectionOptions['measureText'] | undefined;
23
+ measurementEpoch?: LayoutProjectionOptions['measurementEpoch'];
24
+ }
25
+ export declare function readBrowserPaginatedPreviewDocument(binding: BrowserPaginatedPreviewEditorBinding | null | undefined): unknown;
26
+ export declare function readBrowserPaginatedPreviewDocumentSize(binding: BrowserPaginatedPreviewEditorBinding | null | undefined): number | null;
27
+ export declare function readBrowserPaginatedPreviewResolvedProjection(binding: BrowserPaginatedPreviewEditorBinding | null | undefined): LayoutProjection | null;
28
+ export declare function readBrowserPaginatedPreviewResolvedProjectionGeometryOptions(binding: BrowserPaginatedPreviewEditorBinding | null | undefined): BrowserPaginatedPreviewProjectionGeometryOptions | null;
@@ -0,0 +1,35 @@
1
+ import type { BrowserEditorState } from './browser-editor-types-state.ts';
2
+ import type { BrowserPreviewControllerNavigationMode, BrowserPreviewNavigationRequest } from './browser-editor-types-shared.ts';
3
+ import type { BrowserPaginatedPreviewEditorBinding } from './browser-paginated-preview-editor-binding.ts';
4
+ import { type BrowserPaginatedPreviewModeOptions } from './browser-paginated-preview-mode-state.ts';
5
+ export interface ResolveBrowserPaginatedPreviewControllerSyncInput {
6
+ controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined;
7
+ syncViewportToEditor: boolean;
8
+ sourceMatchesEditorDocument: boolean;
9
+ }
10
+ export interface ResolveBrowserPaginatedPreviewSourceBindingInput {
11
+ editor: BrowserPaginatedPreviewEditorBinding | null | undefined;
12
+ source: unknown;
13
+ explicitProjection?: unknown;
14
+ boundToEditorDocument?: boolean | undefined;
15
+ }
16
+ export interface BrowserPaginatedPreviewSourceBindingState {
17
+ sourceMatchesEditorDocument: boolean;
18
+ lifecycleSourceIdentity: unknown;
19
+ }
20
+ export interface BrowserPaginatedPreviewControllerSyncState {
21
+ controllerNavigationMode: BrowserPreviewControllerNavigationMode;
22
+ syncViewportToEditor: boolean;
23
+ }
24
+ export declare function resolveBrowserPaginatedPreviewSourceBinding(input: ResolveBrowserPaginatedPreviewSourceBindingInput): BrowserPaginatedPreviewSourceBindingState;
25
+ export declare function normalizeBrowserPreviewControllerNavigationMode(value: BrowserPreviewControllerNavigationMode | null | undefined): BrowserPreviewControllerNavigationMode;
26
+ export declare function resolveBrowserPaginatedPreviewControllerSyncState(input: ResolveBrowserPaginatedPreviewControllerSyncInput): BrowserPaginatedPreviewControllerSyncState;
27
+ export declare function resolveBrowserPaginatedPreviewNavigationRequest(editorState: Pick<BrowserEditorState, 'previewNavigationRequest'> | null | undefined, explicitAnchorPageNumber: number | null | undefined, viewportHydrated: boolean, controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined, lastConsumedRequestKey?: BrowserPreviewNavigationRequest['requestKey'] | null | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions): BrowserPreviewNavigationRequest | null;
28
+ export declare function resolveBrowserPaginatedPreviewAcknowledgementRequestKey(editorState: Pick<BrowserEditorState, 'previewNavigationRequest'> | null | undefined, explicitAnchorPageNumber: number | null | undefined, viewportHydrated: boolean, controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions): string | number | null;
29
+ export declare function resolveBrowserPaginatedPreviewExternalViewportRequest(editorState: Pick<BrowserEditorState, 'viewport' | 'viewportRequestKey'> | null | undefined, explicitAnchorPageNumber: number | null | undefined, viewportHydrated: boolean, controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined, lastAppliedViewport: BrowserEditorState['viewport'] | null | undefined, lastConsumedViewportRequestKey?: BrowserEditorState['viewportRequestKey'] | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions): import("./browser-editor-types-shared.ts").BrowserViewportState | null;
30
+ export declare function resolveBrowserPaginatedPreviewScale(editorState: Pick<BrowserEditorState, 'zoomPercent'> | null | undefined, explicitScale: number | undefined): number;
31
+ export declare function resolveBrowserPaginatedPreviewAnchorPageNumber(editorState: Pick<BrowserEditorState, 'viewport' | 'previewNavigationRequest'> | null | undefined, explicitAnchorPageNumber: number | null | undefined, viewportHydrated: boolean, controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions): number | null;
32
+ export declare function resolveBrowserPaginatedPreviewViewportAnchor(editorState: Pick<BrowserEditorState, 'viewport' | 'previewNavigationRequest'> | null | undefined, explicitAnchorPageNumber: number | null | undefined, viewportHydrated: boolean, controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions): import("./browser-editor-types-shared.ts").BrowserViewportAnchor | null;
33
+ export declare function resolveBrowserPaginatedPreviewViewportRequestKey(editorState: Pick<BrowserEditorState, 'viewport' | 'viewportRequestKey' | 'previewNavigationRequest'> | null | undefined, explicitAnchorPageNumber: number | null | undefined, viewportHydrated: boolean, controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions): import("@datalking/begonia-editor-contracts").EditorViewportRequestKey;
34
+ export declare function resolveBrowserPaginatedPreviewFlowMode(editorState: Pick<BrowserEditorState, 'flowMode'> | null | undefined, explicitFlowMode: BrowserEditorState['flowMode'] | undefined): import("@datalking/begonia-layout-contracts").LayoutFlowMode;
35
+ export declare function resolveBrowserPaginatedPreviewLayoutMode(editorState: Pick<BrowserEditorState, 'layoutMode' | 'flowMode' | 'preferredPaginatedLayoutMode'> | null | undefined, explicitLayoutMode: BrowserEditorState['layoutMode'] | undefined, explicitFlowMode: BrowserEditorState['flowMode'] | undefined): import("@datalking/begonia-layout-contracts").LayoutArrangement;
@@ -0,0 +1,18 @@
1
+ export type BrowserPaginatedPreviewLifecycleResetCause = 'editor-instance' | 'controller-navigation-mode' | 'preview-mode' | 'sync-viewport-toggle' | 'preview-source' | 'explicit-anchor';
2
+ export interface ResolveBrowserPaginatedPreviewLifecycleResetCauseInput {
3
+ previousEditor: unknown;
4
+ nextEditor: unknown;
5
+ previousControllerNavigationMode: string | null | undefined;
6
+ controllerNavigationMode: string | null | undefined;
7
+ previousFlowMode: string | null | undefined;
8
+ flowMode: string | null | undefined;
9
+ previousLayoutMode: string | null | undefined;
10
+ layoutMode: string | null | undefined;
11
+ previousSyncViewportToEditor: boolean;
12
+ syncViewportToEditor: boolean;
13
+ previousPreviewSourceIdentity: unknown;
14
+ previewSourceIdentity: unknown;
15
+ previousExplicitAnchorPageNumber: number | null | undefined;
16
+ explicitAnchorPageNumber: number | null | undefined;
17
+ }
18
+ export declare function resolveBrowserPaginatedPreviewLifecycleResetCause(input: ResolveBrowserPaginatedPreviewLifecycleResetCauseInput): BrowserPaginatedPreviewLifecycleResetCause | null;
@@ -0,0 +1,9 @@
1
+ import type { BrowserEditorState, BrowserPreviewNavigationRequest, BrowserViewportState } from './browser-editor-types.ts';
2
+ export interface BrowserPaginatedPreviewModeOptions {
3
+ flowMode?: BrowserEditorState['flowMode'];
4
+ layoutMode?: BrowserEditorState['layoutMode'];
5
+ }
6
+ export declare function resolveCompatibleBrowserPreviewViewport(editorState: Pick<BrowserEditorState, 'viewport'> | null | undefined, options?: BrowserPaginatedPreviewModeOptions): BrowserViewportState | null;
7
+ export declare function resolveCompatibleBrowserPreviewNavigationRequest(editorState: Pick<BrowserEditorState, 'previewNavigationRequest'> | null | undefined, options?: BrowserPaginatedPreviewModeOptions): BrowserPreviewNavigationRequest | null;
8
+ export declare function sameBrowserPaginatedPreviewViewportRequest(left: BrowserViewportState | null | undefined, right: BrowserViewportState | null | undefined, options?: BrowserPaginatedPreviewModeOptions): boolean;
9
+ export declare function sameBrowserPaginatedPreviewViewportSyncState(left: BrowserViewportState | null | undefined, right: BrowserViewportState | null | undefined, options?: BrowserPaginatedPreviewModeOptions): boolean;
@@ -0,0 +1,4 @@
1
+ import type { LayoutProjection } from '@datalking/begonia-layout-contracts';
2
+ import type { BrowserViewportAnchor } from './browser-editor-types.ts';
3
+ import type { BrowserPaginatedPreviewPositionHitEvent } from './browser-paginated-preview-position-hit.ts';
4
+ export declare function resolveBrowserPaginatedPreviewViewportAnchorFromHit(projection: LayoutProjection, event: BrowserPaginatedPreviewPositionHitEvent): BrowserViewportAnchor | null;
@@ -0,0 +1,17 @@
1
+ type SurfaceSelectionSnapshot = any;
2
+ import type { LayoutProjection } from '@datalking/begonia-layout-contracts';
3
+
4
+ import type { BrowserPreviewNavigationRequest } from './browser-editor-types.ts';
5
+ type BrowserPreviewSelectionLike = Pick<SurfaceSelectionSnapshot, 'from' | 'to'>;
6
+ type BrowserPreviewNavigationLike = Pick<BrowserPreviewNavigationRequest, 'anchorPageNumber' | 'viewportAnchor'>;
7
+ export interface ResolveBrowserPaginatedPreviewPinnedPageNumbersInput {
8
+ projection: LayoutProjection | null;
9
+ selection: BrowserPreviewSelectionLike | null | undefined;
10
+ selectionPageNumbers?: readonly number[] | undefined;
11
+ previewNavigationRequest?: BrowserPreviewNavigationLike | null | undefined;
12
+ pinnedPageNumbers?: readonly number[] | undefined;
13
+ documentSize?: number | null | undefined;
14
+ sourceMatchesEditorDocument?: boolean | undefined;
15
+ }
16
+ export declare function resolveBrowserPaginatedPreviewPinnedPageNumbers(input: ResolveBrowserPaginatedPreviewPinnedPageNumbersInput): number[] | undefined;
17
+ export {};
@@ -0,0 +1,31 @@
1
+ import type { LayoutProjection, ProjectionPositionHit } from '@datalking/begonia-layout-contracts';
2
+ import type { VirtualPageFrame } from '@datalking/begonia-layout-renderer';
3
+ import type { PreviewTextSelectionRange } from './browser-paginated-preview-text-selection.ts';
4
+ export interface BrowserPaginatedPreviewSelectionAnchor {
5
+ pageNumber: number;
6
+ x: number;
7
+ pageX: number;
8
+ y: number;
9
+ hit: ProjectionPositionHit | null;
10
+ clickCount?: number | null;
11
+ resolvedSelectionPos?: number | null;
12
+ resolvedSelectionRange?: PreviewTextSelectionRange | null;
13
+ resolvedSelectionClickCount?: number | null;
14
+ target?: EventTarget | null;
15
+ }
16
+ export interface BrowserPaginatedPreviewPositionHitEvent {
17
+ projection: LayoutProjection;
18
+ frame: VirtualPageFrame;
19
+ pageNumber: number;
20
+ x: number;
21
+ pageX: number;
22
+ y: number;
23
+ hit: ProjectionPositionHit | null;
24
+ clickCount?: number | null;
25
+ shiftKey?: boolean | null;
26
+ selectionAnchor?: BrowserPaginatedPreviewSelectionAnchor | null;
27
+ resolvedSelectionPos?: number | null;
28
+ resolvedSelectionRange?: PreviewTextSelectionRange | null;
29
+ resolvedSelectionClickCount?: number | null;
30
+ target?: EventTarget | null;
31
+ }
@@ -0,0 +1,31 @@
1
+ import type { BrowserEditorState, BrowserPreviewControllerNavigationMode, BrowserPreviewNavigationRequest, BrowserViewportState } from './browser-editor-types.ts';
2
+ import { type BrowserPaginatedPreviewModeOptions } from './browser-paginated-preview-mode-state.ts';
3
+ import type { BrowserPaginatedPreviewLifecycleResetCause } from './browser-paginated-preview-lifecycle-reset.ts';
4
+ export type BrowserPaginatedPreviewResetCause = BrowserPaginatedPreviewLifecycleResetCause | 'preview-navigation-request' | 'controller-viewport-request';
5
+ type BrowserPaginatedPreviewSyncEditorState = Pick<BrowserEditorState, 'viewport' | 'viewportRequestKey' | 'previewNavigationRequest'>;
6
+ export interface BrowserPaginatedPreviewTrackingState {
7
+ editorViewport: BrowserViewportState | null;
8
+ editorViewportRequestKey: string | number | null;
9
+ previewNavigationRequestKey: string | number | null;
10
+ previewNavigationRequest: BrowserPreviewNavigationRequest | null;
11
+ }
12
+ export interface ResolveBrowserPaginatedPreviewResetPlanInput {
13
+ editorState: BrowserPaginatedPreviewSyncEditorState | null | undefined;
14
+ explicitAnchorPageNumber: number | null | undefined;
15
+ viewportHydrated: boolean;
16
+ controllerNavigationMode: BrowserPreviewControllerNavigationMode | null | undefined;
17
+ modeOptions?: BrowserPaginatedPreviewModeOptions | undefined;
18
+ syncViewportToEditor: boolean;
19
+ lastAppliedViewport: BrowserViewportState | null | undefined;
20
+ trackingState: BrowserPaginatedPreviewTrackingState;
21
+ }
22
+ export interface BrowserPaginatedPreviewResetPlan {
23
+ previewNavigationRequest: BrowserPreviewNavigationRequest | null;
24
+ externalViewportRequest: BrowserViewportState | null;
25
+ shouldResetViewport: boolean;
26
+ resetCause: BrowserPaginatedPreviewResetCause | null;
27
+ nextTrackingState: BrowserPaginatedPreviewTrackingState;
28
+ }
29
+ export declare function captureBrowserPaginatedPreviewTrackingState(editorState: BrowserPaginatedPreviewSyncEditorState | null | undefined, modeOptions?: BrowserPaginatedPreviewModeOptions | undefined): BrowserPaginatedPreviewTrackingState;
30
+ export declare function resolveBrowserPaginatedPreviewResetPlan(input: ResolveBrowserPaginatedPreviewResetPlanInput): BrowserPaginatedPreviewResetPlan;
31
+ export {};
@@ -0,0 +1,13 @@
1
+ import type { LayoutProjection } from '@datalking/begonia-layout-contracts';
2
+ import type { BrowserPaginatedPreviewPositionHitEvent } from './browser-paginated-preview-position-hit.ts';
3
+ export interface BrowserPaginatedPreviewSelectionActionInput<TEditor = unknown> {
4
+ editor: TEditor;
5
+ previewSource: unknown;
6
+ explicitProjection?: LayoutProjection | null | undefined;
7
+ boundToEditorDocument?: boolean | undefined;
8
+ event: BrowserPaginatedPreviewPositionHitEvent;
9
+ }
10
+ export interface BrowserPaginatedPreviewSelectionActions<TEditor = unknown> {
11
+ resolvePositionHitEvent?(input: BrowserPaginatedPreviewSelectionActionInput<TEditor>): BrowserPaginatedPreviewPositionHitEvent;
12
+ handlePositionHit?(input: BrowserPaginatedPreviewSelectionActionInput<TEditor>): boolean;
13
+ }
@@ -0,0 +1 @@
1
+ export { resolveBrowserPaginatedPreviewSelectionPos, resolveBrowserPaginatedPreviewPositionHitEvent, handleBrowserPaginatedPreviewPositionHit, createBrowserPaginatedPreviewSelectionActionsV1, } from './paginated-preview-selection-v1/preview-selection-v1-handle.ts';