superdoc 2.29.0 → 2.30.0-next.13

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 (131) hide show
  1. package/README.md +127 -25
  2. package/dist/chunks/{FindReplaceSurface-B_5ggdWg.es.js → FindReplaceSurface-BEnRLpD9.es.js} +1 -1
  3. package/dist/chunks/{FindReplaceSurface-fVHxPXtn.cjs → FindReplaceSurface-DWXgWgg7.cjs} +1 -1
  4. package/dist/chunks/{PasswordPromptSurface-CZqhDQQ1.es.js → PasswordPromptSurface-DjV1JgjD.es.js} +1 -1
  5. package/dist/chunks/{PasswordPromptSurface-x8GNmMJT.cjs → PasswordPromptSurface-VFPnQOML.cjs} +1 -1
  6. package/dist/chunks/{PdfViewer-CW09MNrB.es.js → PdfViewer-C2r-K8zC.es.js} +1 -1
  7. package/dist/chunks/{PdfViewer-CkrAHpC-.cjs → PdfViewer-DYTbPVUr.cjs} +1 -1
  8. package/dist/chunks/{_plugin-vue_export-helper-BkbCxNeT.cjs → _plugin-vue_export-helper-BzM2_tVU.cjs} +9 -0
  9. package/dist/chunks/{_plugin-vue_export-helper-DRPRMkeA.es.js → _plugin-vue_export-helper-CmkaJDnr.es.js} +4 -1
  10. package/dist/chunks/{create-super-doc-ui-Dc8dQAMc.es.js → create-super-doc-ui--o8TcYYv.es.js} +6080 -5456
  11. package/dist/chunks/{create-super-doc-ui-L60GhVAX.cjs → create-super-doc-ui-CvK1JdZv.cjs} +3567 -2937
  12. package/dist/collaboration-upgrade-engine.cjs +1 -1
  13. package/dist/collaboration-upgrade-engine.es.js +1 -1
  14. package/dist/document-api/src/changes/changes.d.ts +26 -0
  15. package/dist/document-api/src/changes/changes.types.d.ts +156 -0
  16. package/dist/document-api/src/comments/comment-create-attribution.d.ts +4 -0
  17. package/dist/document-api/src/comments/comments.types.d.ts +4 -0
  18. package/dist/document-api/src/contract/command-catalog.d.ts +1 -1
  19. package/dist/document-api/src/contract/operation-definitions.d.ts +76 -8
  20. package/dist/document-api/src/contract/operation-registry.d.ts +2 -2
  21. package/dist/document-api/src/contract/schemas.d.ts +7 -1
  22. package/dist/document-api/src/create/create.d.ts +0 -4
  23. package/dist/document-api/src/diff/diff.types.d.ts +6 -6
  24. package/dist/document-api/src/header-footers/header-footers.d.ts +1 -3
  25. package/dist/document-api/src/index.d.ts +13 -1
  26. package/dist/document-api/src/inline-semantics/token-sets.d.ts +0 -2
  27. package/dist/document-api/src/insert/insert.d.ts +0 -1
  28. package/dist/document-api/src/paragraphs/paragraphs.d.ts +8 -3
  29. package/dist/document-api/src/paragraphs/paragraphs.types.d.ts +49 -5
  30. package/dist/document-api/src/tables/data/table-preset-appearance.generated.d.ts +2 -0
  31. package/dist/document-api/src/tables/table-style-presets.d.ts +73 -0
  32. package/dist/document-api/src/tables/tables.d.ts +4 -1
  33. package/dist/document-api/src/types/sd-props.d.ts +7 -0
  34. package/dist/document-api/src/types/table-operations.types.d.ts +12 -15
  35. package/dist/layout-engine/contracts/src/index.d.ts +4 -1
  36. package/dist/layout-engine/contracts/src/table-cell-vector-overlay.d.ts +2 -0
  37. package/dist/layout-engine/dom-contract/src/data-attrs.d.ts +4 -0
  38. package/dist/layout-engine/layout-bridge/src/coupled-footnote-pagination.d.ts +1 -0
  39. package/dist/layout-engine/layout-bridge/src/footnote-page-certificate.d.ts +1 -0
  40. package/dist/layout-engine/layout-bridge/src/footnote-page-planner.d.ts +5 -0
  41. package/dist/layout-engine/layout-bridge/src/incrementalLayout.d.ts +1 -0
  42. package/dist/layout-engine/layout-engine/src/footnote-page-flow.d.ts +3 -0
  43. package/dist/layout-engine/layout-engine/src/index.d.ts +7 -0
  44. package/dist/layout-engine/layout-engine/src/layout-paragraph.d.ts +5 -0
  45. package/dist/layout-engine/layout-engine/src/layout-table.d.ts +3 -1
  46. package/dist/layout-engine/layout-engine/src/layout-utils.d.ts +0 -4
  47. package/dist/layout-engine/layout-engine/src/paginator.d.ts +4 -0
  48. package/dist/layout-engine/painters/dom/src/index.d.ts +2 -0
  49. package/dist/layout-engine/painters/dom/src/paragraph/list-marker.d.ts +1 -1
  50. package/dist/layout-engine/painters/dom/src/paragraph/renderParagraphContent.d.ts +1 -1
  51. package/dist/layout-engine/painters/dom/src/styles.d.ts +0 -10
  52. package/dist/layout-engine/painters/dom/src/svg-utils.d.ts +1 -13
  53. package/dist/public/ui-react.cjs +1 -1
  54. package/dist/public/ui-react.es.js +1 -1
  55. package/dist/public/ui-vue.cjs +1 -1
  56. package/dist/public/ui-vue.es.js +1 -1
  57. package/dist/public/ui.cjs +1 -1
  58. package/dist/public/ui.es.js +1 -1
  59. package/dist/shared/common/Telemetry.d.ts +50 -0
  60. package/dist/shared/common/event-types.d.ts +13 -0
  61. package/dist/shared/font-system/src/bundled-face-names.d.ts +1 -0
  62. package/dist/shared/font-system/src/resolver.d.ts +1 -0
  63. package/dist/style.css +1 -1
  64. package/dist/style.layered.css +1 -1
  65. package/dist/superdoc/src/components/CommentsLayer/CommentDialog.vue.d.ts +17 -33
  66. package/dist/superdoc/src/components/CommentsLayer/collect-tracked-change-thread.d.ts +6 -4
  67. package/dist/superdoc/src/components/CommentsLayer/comment-params.d.ts +84 -0
  68. package/dist/superdoc/src/components/CommentsLayer/use-comment.d.ts +15 -95
  69. package/dist/superdoc/src/components/Whiteboard/use-whiteboard.d.ts +30 -9
  70. package/dist/superdoc/src/composables/use-comment-sidebar.d.ts +6 -0
  71. package/dist/superdoc/src/composables/use-document.d.ts +51 -99
  72. package/dist/superdoc/src/core/SuperDoc.d.ts +12 -3
  73. package/dist/superdoc/src/core/collaboration/cdn-collaboration-comment-map.d.ts +1 -0
  74. package/dist/superdoc/src/core/collaboration/collaboration-comment-map.d.ts +2 -0
  75. package/dist/superdoc/src/core/collaboration/helpers.d.ts +1 -1
  76. package/dist/superdoc/src/core/config/normalize-interaction-config.d.ts +10 -1
  77. package/dist/superdoc/src/core/document-open-telemetry.d.ts +1 -1
  78. package/dist/superdoc/src/core/editor-runtime/types.d.ts +4 -0
  79. package/dist/superdoc/src/core/editor-runtime/v2/v2-editor-runtime-adapter.d.ts +1 -0
  80. package/dist/superdoc/src/core/types/index.d.ts +110 -39
  81. package/dist/superdoc/src/helpers/deprecation.d.ts +12 -3
  82. package/dist/superdoc/src/helpers/object-guards.d.ts +1 -0
  83. package/dist/superdoc/src/helpers/v2-review-geometry-delivery.d.ts +22 -0
  84. package/dist/superdoc/src/internal/toolbar/built-in/ToolbarButton.vue.d.ts +1 -0
  85. package/dist/superdoc/src/public/content-control-ref.d.ts +12 -0
  86. package/dist/superdoc/src/public/index.d.cts +20 -0
  87. package/dist/superdoc/src/public/index.d.ts +4 -1
  88. package/dist/superdoc/src/public/ui/async-read-cache.d.ts +32 -0
  89. package/dist/superdoc/src/public/ui/block-commands.d.ts +39 -0
  90. package/dist/superdoc/src/public/ui/command-results.d.ts +39 -0
  91. package/dist/superdoc/src/public/ui/commands.d.ts +5 -1
  92. package/dist/superdoc/src/public/ui/create-super-doc-ui.d.ts +1 -17
  93. package/dist/superdoc/src/public/ui/document-change-records.d.ts +7 -0
  94. package/dist/superdoc/src/public/ui/entity-rows.d.ts +14 -0
  95. package/dist/superdoc/src/public/ui/font-options.d.ts +7 -0
  96. package/dist/superdoc/src/public/ui/format-painter-paragraph.d.ts +7 -0
  97. package/dist/superdoc/src/public/ui/format-painter-state.d.ts +29 -0
  98. package/dist/superdoc/src/public/ui/heavy-read-policy.d.ts +11 -0
  99. package/dist/superdoc/src/public/ui/host-events.d.ts +3 -0
  100. package/dist/superdoc/src/public/ui/inline-values.d.ts +80 -0
  101. package/dist/superdoc/src/public/ui/loose-record.d.ts +4 -0
  102. package/dist/superdoc/src/public/ui/reasons.d.ts +1 -0
  103. package/dist/superdoc/src/public/ui/selection-targets.d.ts +53 -0
  104. package/dist/superdoc/src/public/ui/shared-tracked-changes-catalog.d.ts +16 -0
  105. package/dist/superdoc/src/public/ui/tracked-change-ids.d.ts +51 -0
  106. package/dist/superdoc/src/public/ui/types.d.ts +25 -2
  107. package/dist/superdoc/src/public/ui/ui-bench-timing.d.ts +9 -0
  108. package/dist/superdoc/src/public/ui.d.cts +18 -0
  109. package/dist/superdoc/src/public/ui.d.ts +1 -1
  110. package/dist/superdoc/src/stores/comments-store.d.ts +23022 -546
  111. package/dist/superdoc/src/stores/helpers/comment-grouping.d.ts +1 -1
  112. package/dist/superdoc/src/stores/helpers/comment-identity.d.ts +10 -10
  113. package/dist/superdoc/src/stores/helpers/review-presentation.d.ts +91 -0
  114. package/dist/superdoc/src/stores/helpers/tracked-change-identity.d.ts +4 -2
  115. package/dist/superdoc/src/stores/helpers/tracked-change-row-values.d.ts +1 -8
  116. package/dist/superdoc/src/stores/helpers/tracked-change-thread-index.d.ts +1 -1
  117. package/dist/superdoc/src/stores/helpers/v2-review-adapters.d.ts +147 -0
  118. package/dist/superdoc/src/stores/superdoc-store.d.ts +12 -2895
  119. package/dist/superdoc.cjs +915 -516
  120. package/dist/superdoc.es.js +915 -516
  121. package/dist/word-layout/src/marker-utils.d.ts +0 -5
  122. package/dist/word-layout/src/unit-conversions.d.ts +0 -1
  123. package/dist-cdn/style.layered.css +1 -1
  124. package/dist-cdn/superdoc.min.css +1 -1
  125. package/dist-cdn/superdoc.min.js +38 -42
  126. package/package.json +12 -3
  127. package/dist/document-api/src/diff/index.d.ts +0 -3
  128. package/dist/document-api/src/write/locator.d.ts +0 -24
  129. package/dist/layout-engine/painters/dom/src/features/feature-registry.d.ts +0 -41
  130. package/dist/superdoc/src/internal/toolbar/built-in/format-negation.d.ts +0 -11
  131. package/dist/word-layout/src/tab-layout.d.ts +0 -193
@@ -305,7 +305,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
305
305
  trackedChangeAnchorKey: string | null;
306
306
  trackedChangeCanonicalId: string | null;
307
307
  trackedChangePositionAliases: string[];
308
- trackedChangeDecision: ("accept" | "reject") | null;
308
+ trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
309
309
  trackedChangeLabel: string | null;
310
310
  trackedChangeDetailLines: {
311
311
  excerpt: string;
@@ -313,13 +313,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
313
313
  }[] | null;
314
314
  trackedChangeImagePreview: {
315
315
  src: string;
316
- contentType: string;
317
- role: "deleted" | "inserted" | "before" | "after";
318
- partUri?: string | undefined;
319
- relationshipId?: string | undefined;
316
+ contentType?: string | undefined;
317
+ role?: string | undefined;
320
318
  width?: number | undefined;
321
319
  height?: number | undefined;
322
- alt?: string | undefined;
320
+ alt: string;
323
321
  } | null;
324
322
  customAttributes: readonly {
325
323
  name: string;
@@ -338,7 +336,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
338
336
  docxCommentJSON: {} | null;
339
337
  origin: "word" | "google-docs" | "unknown" | undefined;
340
338
  threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
341
- threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
339
+ threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
342
340
  threadingParentCommentId: string | null | undefined;
343
341
  originalXmlStructure: {
344
342
  hasCommentsExtended: boolean;
@@ -349,7 +347,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
349
347
  text: string;
350
348
  superdoc?: {
351
349
  emit: (event: "comments-update", payload: {
352
- type: import('../../../../shared/common').CommentEvent;
350
+ type: import('../../../shared/common/event-types.js').CommentEvent;
353
351
  changes?: {
354
352
  key: string;
355
353
  value: unknown;
@@ -371,7 +369,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
371
369
  text: string;
372
370
  superdoc: {
373
371
  emit: (event: "comments-update", payload: {
374
- type: import('../../../../shared/common').CommentEvent;
372
+ type: import('../../../shared/common/event-types.js').CommentEvent;
375
373
  changes?: {
376
374
  key: string;
377
375
  value: unknown;
@@ -443,7 +441,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
443
441
  trackedChangeAnchorKey: string | null;
444
442
  trackedChangeCanonicalId: string | null;
445
443
  trackedChangePositionAliases: string[];
446
- trackedChangeDecision: ("accept" | "reject") | null;
444
+ trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
447
445
  trackedChangeLabel: string | null;
448
446
  trackedChangeDetailLines: {
449
447
  excerpt: string;
@@ -451,13 +449,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
451
449
  }[] | null;
452
450
  trackedChangeImagePreview: {
453
451
  src: string;
454
- contentType: string;
455
- role: "deleted" | "inserted" | "before" | "after";
456
- partUri?: string | undefined;
457
- relationshipId?: string | undefined;
452
+ contentType?: string | undefined;
453
+ role?: string | undefined;
458
454
  width?: number | undefined;
459
455
  height?: number | undefined;
460
- alt?: string | undefined;
456
+ alt: string;
461
457
  } | null;
462
458
  customAttributes: readonly {
463
459
  name: string;
@@ -472,7 +468,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
472
468
  resolvedByName: string | null | undefined;
473
469
  origin: "word" | "google-docs" | "unknown" | undefined;
474
470
  threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
475
- threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
471
+ threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
476
472
  threadingParentCommentId: string | null | undefined;
477
473
  originalXmlStructure: {
478
474
  hasCommentsExtended: boolean;
@@ -486,7 +482,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
486
482
  name?: string | null;
487
483
  superdoc: {
488
484
  emit: (event: "comments-update", payload: {
489
- type: import('../../../../shared/common').CommentEvent;
485
+ type: import('../../../shared/common/event-types.js').CommentEvent;
490
486
  changes?: {
491
487
  key: string;
492
488
  value: unknown;
@@ -503,7 +499,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
503
499
  modules?: import('../public/index.js').Modules;
504
500
  };
505
501
  };
506
- decision?: "accept" | "reject";
502
+ decision?: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision;
507
503
  reconciliationToken?: symbol;
508
504
  }) => {
509
505
  ok: false;
@@ -513,7 +509,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
513
509
  isInternal: boolean;
514
510
  superdoc: {
515
511
  emit: (event: "comments-update", payload: {
516
- type: import('../../../../shared/common').CommentEvent;
512
+ type: import('../../../shared/common/event-types.js').CommentEvent;
517
513
  changes?: {
518
514
  key: string;
519
515
  value: unknown;
@@ -534,12 +530,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
534
530
  ok: false;
535
531
  reason: "read-only-document";
536
532
  } | undefined;
537
- updatePosition: (coords: {
538
- top: number;
539
- left: number;
540
- right: number;
541
- bottom: number;
542
- }, parentElement: Pick<Element, "getBoundingClientRect">) => void;
533
+ updatePosition: (coords: import('../components/CommentsLayer/comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
543
534
  getCommentUser: () => {
544
535
  name: string;
545
536
  email: string | null | undefined;
@@ -551,14 +542,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
551
542
  email: string | null;
552
543
  image: string | null;
553
544
  };
554
- updateIdentityValues: (updates?: {
555
- commentId?: string;
556
- importedId?: string | null;
557
- parentCommentId?: string | null;
558
- trackedChangeParentId?: string | null;
559
- trackedChangeThreadParentId?: string | null;
560
- threadingParentCommentId?: string | null;
561
- }) => void;
545
+ updateIdentityValues: (updates?: import('../components/CommentsLayer/comment-params.js').CommentIdentity) => void;
562
546
  }[], {
563
547
  uid: string | undefined;
564
548
  commentId: string;
@@ -628,7 +612,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
628
612
  trackedChangeAnchorKey: string | null;
629
613
  trackedChangeCanonicalId: string | null;
630
614
  trackedChangePositionAliases: string[];
631
- trackedChangeDecision: ("accept" | "reject") | null;
615
+ trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
632
616
  trackedChangeLabel: string | null;
633
617
  trackedChangeDetailLines: {
634
618
  excerpt: string;
@@ -636,13 +620,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
636
620
  }[] | null;
637
621
  trackedChangeImagePreview: {
638
622
  src: string;
639
- contentType: string;
640
- role: "deleted" | "inserted" | "before" | "after";
641
- partUri?: string | undefined;
642
- relationshipId?: string | undefined;
623
+ contentType?: string | undefined;
624
+ role?: string | undefined;
643
625
  width?: number | undefined;
644
626
  height?: number | undefined;
645
- alt?: string | undefined;
627
+ alt: string;
646
628
  } | null;
647
629
  customAttributes: readonly {
648
630
  name: string;
@@ -661,7 +643,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
661
643
  docxCommentJSON: {} | null;
662
644
  origin: "word" | "google-docs" | "unknown" | undefined;
663
645
  threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
664
- threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
646
+ threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
665
647
  threadingParentCommentId: string | null | undefined;
666
648
  originalXmlStructure: {
667
649
  hasCommentsExtended: boolean;
@@ -672,7 +654,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
672
654
  text: string;
673
655
  superdoc?: {
674
656
  emit: (event: "comments-update", payload: {
675
- type: import('../../../../shared/common').CommentEvent;
657
+ type: import('../../../shared/common/event-types.js').CommentEvent;
676
658
  changes?: {
677
659
  key: string;
678
660
  value: unknown;
@@ -694,7 +676,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
694
676
  text: string;
695
677
  superdoc: {
696
678
  emit: (event: "comments-update", payload: {
697
- type: import('../../../../shared/common').CommentEvent;
679
+ type: import('../../../shared/common/event-types.js').CommentEvent;
698
680
  changes?: {
699
681
  key: string;
700
682
  value: unknown;
@@ -766,7 +748,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
766
748
  trackedChangeAnchorKey: string | null;
767
749
  trackedChangeCanonicalId: string | null;
768
750
  trackedChangePositionAliases: string[];
769
- trackedChangeDecision: ("accept" | "reject") | null;
751
+ trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
770
752
  trackedChangeLabel: string | null;
771
753
  trackedChangeDetailLines: {
772
754
  excerpt: string;
@@ -774,13 +756,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
774
756
  }[] | null;
775
757
  trackedChangeImagePreview: {
776
758
  src: string;
777
- contentType: string;
778
- role: "deleted" | "inserted" | "before" | "after";
779
- partUri?: string | undefined;
780
- relationshipId?: string | undefined;
759
+ contentType?: string | undefined;
760
+ role?: string | undefined;
781
761
  width?: number | undefined;
782
762
  height?: number | undefined;
783
- alt?: string | undefined;
763
+ alt: string;
784
764
  } | null;
785
765
  customAttributes: readonly {
786
766
  name: string;
@@ -795,7 +775,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
795
775
  resolvedByName: string | null | undefined;
796
776
  origin: "word" | "google-docs" | "unknown" | undefined;
797
777
  threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
798
- threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
778
+ threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
799
779
  threadingParentCommentId: string | null | undefined;
800
780
  originalXmlStructure: {
801
781
  hasCommentsExtended: boolean;
@@ -809,7 +789,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
809
789
  name?: string | null;
810
790
  superdoc: {
811
791
  emit: (event: "comments-update", payload: {
812
- type: import('../../../../shared/common').CommentEvent;
792
+ type: import('../../../shared/common/event-types.js').CommentEvent;
813
793
  changes?: {
814
794
  key: string;
815
795
  value: unknown;
@@ -826,7 +806,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
826
806
  modules?: import('../public/index.js').Modules;
827
807
  };
828
808
  };
829
- decision?: "accept" | "reject";
809
+ decision?: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision;
830
810
  reconciliationToken?: symbol;
831
811
  }) => {
832
812
  ok: false;
@@ -836,7 +816,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
836
816
  isInternal: boolean;
837
817
  superdoc: {
838
818
  emit: (event: "comments-update", payload: {
839
- type: import('../../../../shared/common').CommentEvent;
819
+ type: import('../../../shared/common/event-types.js').CommentEvent;
840
820
  changes?: {
841
821
  key: string;
842
822
  value: unknown;
@@ -857,12 +837,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
857
837
  ok: false;
858
838
  reason: "read-only-document";
859
839
  } | undefined;
860
- updatePosition: (coords: {
861
- top: number;
862
- left: number;
863
- right: number;
864
- bottom: number;
865
- }, parentElement: Pick<Element, "getBoundingClientRect">) => void;
840
+ updatePosition: (coords: import('../components/CommentsLayer/comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
866
841
  getCommentUser: () => {
867
842
  name: string;
868
843
  email: string | null | undefined;
@@ -874,14 +849,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
874
849
  email: string | null;
875
850
  image: string | null;
876
851
  };
877
- updateIdentityValues: (updates?: {
878
- commentId?: string;
879
- importedId?: string | null;
880
- parentCommentId?: string | null;
881
- trackedChangeParentId?: string | null;
882
- trackedChangeThreadParentId?: string | null;
883
- threadingParentCommentId?: string | null;
884
- }) => void;
852
+ updateIdentityValues: (updates?: import('../components/CommentsLayer/comment-params.js').CommentIdentity) => void;
885
853
  }[] | {
886
854
  uid: string | undefined;
887
855
  commentId: string;
@@ -951,7 +919,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
951
919
  trackedChangeAnchorKey: string | null;
952
920
  trackedChangeCanonicalId: string | null;
953
921
  trackedChangePositionAliases: string[];
954
- trackedChangeDecision: ("accept" | "reject") | null;
922
+ trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
955
923
  trackedChangeLabel: string | null;
956
924
  trackedChangeDetailLines: {
957
925
  excerpt: string;
@@ -959,13 +927,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
959
927
  }[] | null;
960
928
  trackedChangeImagePreview: {
961
929
  src: string;
962
- contentType: string;
963
- role: "deleted" | "inserted" | "before" | "after";
964
- partUri?: string | undefined;
965
- relationshipId?: string | undefined;
930
+ contentType?: string | undefined;
931
+ role?: string | undefined;
966
932
  width?: number | undefined;
967
933
  height?: number | undefined;
968
- alt?: string | undefined;
934
+ alt: string;
969
935
  } | null;
970
936
  customAttributes: readonly {
971
937
  name: string;
@@ -984,7 +950,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
984
950
  docxCommentJSON: {} | null;
985
951
  origin: "word" | "google-docs" | "unknown" | undefined;
986
952
  threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
987
- threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
953
+ threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
988
954
  threadingParentCommentId: string | null | undefined;
989
955
  originalXmlStructure: {
990
956
  hasCommentsExtended: boolean;
@@ -995,7 +961,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
995
961
  text: string;
996
962
  superdoc?: {
997
963
  emit: (event: "comments-update", payload: {
998
- type: import('../../../../shared/common').CommentEvent;
964
+ type: import('../../../shared/common/event-types.js').CommentEvent;
999
965
  changes?: {
1000
966
  key: string;
1001
967
  value: unknown;
@@ -1017,7 +983,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1017
983
  text: string;
1018
984
  superdoc: {
1019
985
  emit: (event: "comments-update", payload: {
1020
- type: import('../../../../shared/common').CommentEvent;
986
+ type: import('../../../shared/common/event-types.js').CommentEvent;
1021
987
  changes?: {
1022
988
  key: string;
1023
989
  value: unknown;
@@ -1089,7 +1055,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1089
1055
  trackedChangeAnchorKey: string | null;
1090
1056
  trackedChangeCanonicalId: string | null;
1091
1057
  trackedChangePositionAliases: string[];
1092
- trackedChangeDecision: ("accept" | "reject") | null;
1058
+ trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
1093
1059
  trackedChangeLabel: string | null;
1094
1060
  trackedChangeDetailLines: {
1095
1061
  excerpt: string;
@@ -1097,13 +1063,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1097
1063
  }[] | null;
1098
1064
  trackedChangeImagePreview: {
1099
1065
  src: string;
1100
- contentType: string;
1101
- role: "deleted" | "inserted" | "before" | "after";
1102
- partUri?: string | undefined;
1103
- relationshipId?: string | undefined;
1066
+ contentType?: string | undefined;
1067
+ role?: string | undefined;
1104
1068
  width?: number | undefined;
1105
1069
  height?: number | undefined;
1106
- alt?: string | undefined;
1070
+ alt: string;
1107
1071
  } | null;
1108
1072
  customAttributes: readonly {
1109
1073
  name: string;
@@ -1118,7 +1082,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1118
1082
  resolvedByName: string | null | undefined;
1119
1083
  origin: "word" | "google-docs" | "unknown" | undefined;
1120
1084
  threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
1121
- threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
1085
+ threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
1122
1086
  threadingParentCommentId: string | null | undefined;
1123
1087
  originalXmlStructure: {
1124
1088
  hasCommentsExtended: boolean;
@@ -1132,7 +1096,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1132
1096
  name?: string | null;
1133
1097
  superdoc: {
1134
1098
  emit: (event: "comments-update", payload: {
1135
- type: import('../../../../shared/common').CommentEvent;
1099
+ type: import('../../../shared/common/event-types.js').CommentEvent;
1136
1100
  changes?: {
1137
1101
  key: string;
1138
1102
  value: unknown;
@@ -1149,7 +1113,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1149
1113
  modules?: import('../public/index.js').Modules;
1150
1114
  };
1151
1115
  };
1152
- decision?: "accept" | "reject";
1116
+ decision?: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision;
1153
1117
  reconciliationToken?: symbol;
1154
1118
  }) => {
1155
1119
  ok: false;
@@ -1159,7 +1123,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1159
1123
  isInternal: boolean;
1160
1124
  superdoc: {
1161
1125
  emit: (event: "comments-update", payload: {
1162
- type: import('../../../../shared/common').CommentEvent;
1126
+ type: import('../../../shared/common/event-types.js').CommentEvent;
1163
1127
  changes?: {
1164
1128
  key: string;
1165
1129
  value: unknown;
@@ -1180,12 +1144,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1180
1144
  ok: false;
1181
1145
  reason: "read-only-document";
1182
1146
  } | undefined;
1183
- updatePosition: (coords: {
1184
- top: number;
1185
- left: number;
1186
- right: number;
1187
- bottom: number;
1188
- }, parentElement: Pick<Element, "getBoundingClientRect">) => void;
1147
+ updatePosition: (coords: import('../components/CommentsLayer/comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
1189
1148
  getCommentUser: () => {
1190
1149
  name: string;
1191
1150
  email: string | null | undefined;
@@ -1197,14 +1156,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
1197
1156
  email: string | null;
1198
1157
  image: string | null;
1199
1158
  };
1200
- updateIdentityValues: (updates?: {
1201
- commentId?: string;
1202
- importedId?: string | null;
1203
- parentCommentId?: string | null;
1204
- trackedChangeParentId?: string | null;
1205
- trackedChangeThreadParentId?: string | null;
1206
- threadingParentCommentId?: string | null;
1207
- }) => void;
1159
+ updateIdentityValues: (updates?: import('../components/CommentsLayer/comment-params.js').CommentIdentity) => void;
1208
1160
  }[]>;
1209
1161
  commentThreadingProfile: import('vue').Ref<{} | null, {} | null>;
1210
1162
  setEditor: (ref: Editor | null) => Editor | null;
@@ -2,7 +2,7 @@ import { SuperDocDiagnostics } from './types/diagnostics.js';
2
2
  import { EventEmitter } from 'eventemitter3';
3
3
  import { DocumentReplacementResult } from '../public/document-replacement.js';
4
4
  import { HocuspocusProviderWebsocket } from '@hocuspocus/provider';
5
- import { createSuperdocVueApp } from './create-app.js';
5
+ import { Pinia } from 'pinia';
6
6
  import { Whiteboard } from './whiteboard/Whiteboard.js';
7
7
  import { normalizeUiConfig } from './config/normalize-ui-config.js';
8
8
  import { normalizeInteractionConfig } from './config/normalize-interaction-config.js';
@@ -47,10 +47,12 @@ interface SuperDocEventMap {
47
47
  'comments-list-change': [SuperDocCommentsListChangePayload];
48
48
  /** Requests the shell open its find/replace surface (e.g. the toolbar search button). */
49
49
  'search:open': [];
50
+ /** @deprecated replaceWith=`superdoc.ui.zoom.observe` removeIn=v3.0 */
50
51
  zoomChange: [SuperDocZoomPayload];
51
52
  'measurement-unit-change': [SuperDocMeasurementUnitChangePayload];
52
53
  'page-margins-change': [SuperDocPageMarginsChangePayload];
53
54
  'formatting-marks-change': [SuperDocFormattingMarksChangePayload];
55
+ /** @deprecated replaceWith=`superdoc.ui.document.observe` removeIn=v3.0 */
54
56
  'document-mode-change': [SuperDocDocumentModeChangePayload];
55
57
  /**
56
58
  * The active editor was assigned or cleared. Internal: the UI controller
@@ -85,9 +87,15 @@ interface SuperDocEventMap {
85
87
  'fonts-resolved': [FontsResolvedPayload];
86
88
  'fonts-changed': [FontsChangedPayload];
87
89
  'pagination-update': [SuperDocPaginationUpdatePayload];
90
+ /**
91
+ * Never emitted by SuperDoc 2.
92
+ *
93
+ * @deprecated replaceWith=`editor-update` and `doc.lists.list` removeIn=v3.0
94
+ */
88
95
  'list-definitions-change': [ListDefinitionsPayload];
89
96
  'comments-update': [SuperDocCommentsUpdatePayload];
90
97
  'content-control:active-change': [ContentControlActiveChangePayload];
98
+ /** @deprecated replaceWith=`superdoc.ui.contentControls.onClick` removeIn=v3.0 */
91
99
  'content-control:click': [ContentControlClickPayload];
92
100
  'collaboration-ready': [SuperDocEditorPayload];
93
101
  'awareness-update': [SuperDocAwarenessUpdatePayload];
@@ -98,6 +106,7 @@ interface SuperDocEventMap {
98
106
  'whiteboard:change': [WhiteboardData];
99
107
  'whiteboard:enabled': [boolean];
100
108
  'whiteboard:tool': [string];
109
+ /** A union of payloads; narrow by `stage`, `code`, `itemName`, `source`, or `diagnosticCode` before reading on. */
101
110
  exception: [SuperDocExceptionPayload];
102
111
  'viewport-change': [SuperDocViewportChangePayload];
103
112
  'source:complete': [];
@@ -235,7 +244,7 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
235
244
  */
236
245
  private app;
237
246
  /** Pinia store root for the SuperDoc Vue app. Set in `#initVueApp`. */
238
- pinia: ReturnType<typeof createSuperdocVueApp>['pinia'] | undefined;
247
+ pinia: Pinia | undefined;
239
248
  /** Count of editors that have signaled `editorCreate`. */
240
249
  readyEditors: number;
241
250
  activeEditor: Editor | null;
@@ -339,7 +348,7 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
339
348
  * surface does not pull the Pinia comment model type graph.
340
349
  *
341
350
  */
342
- getComment(commentId: string): import('../stores/helpers/comment-identity.js').CommentIdentityRow | null;
351
+ getComment(commentId: string): Record<string, unknown> | null;
343
352
  /**
344
353
  * Get the SuperDoc container element
345
354
  */
@@ -0,0 +1 @@
1
+ export declare function createCollaborationCommentMap(entries: Iterable<[string, unknown]>): import('yjs').Map<unknown>;
@@ -0,0 +1,2 @@
1
+ import { Map as YMap } from 'yjs';
2
+ export declare function createCollaborationCommentMap(entries: Iterable<[string, unknown]>): YMap<unknown>;
@@ -1,4 +1,4 @@
1
- import { CommentEvent } from '../../../../../shared/common';
1
+ import { CommentEvent } from '../../../../shared/common/event-types.js';
2
2
  import { SuperDoc } from '../SuperDoc.js';
3
3
  import { Modules, User } from '../types/index.js';
4
4
  import { CollaborationCommentEvent } from './collaboration-comments.js';
@@ -1,4 +1,4 @@
1
- import { CommentInteractionLevel, Config } from '../types/index.js';
1
+ import { CommentInteractionLevel, Config, WritingAssistanceConfig } from '../types/index.js';
2
2
  type InteractionSource = Pick<Config, 'interaction' | 'modules'>;
3
3
  type NormalizedInteractionConfig = {
4
4
  comments: {
@@ -9,6 +9,15 @@ type NormalizedInteractionConfig = {
9
9
  trackedChanges: {
10
10
  allowDecisions: boolean;
11
11
  };
12
+ touch: {
13
+ gestures: boolean;
14
+ };
15
+ writingAssistance: {
16
+ enabled: boolean;
17
+ autocorrect: boolean;
18
+ autocapitalize: NonNullable<WritingAssistanceConfig['autocapitalize']>;
19
+ spellcheck: boolean;
20
+ };
12
21
  };
13
22
  /**
14
23
  * Resolve the effective interaction policy.
@@ -1,4 +1,4 @@
1
- import { Telemetry, TelemetryConfig } from '../../../../shared/common';
1
+ import { Telemetry, TelemetryConfig } from '../../../shared/common/Telemetry.js';
2
2
  import { Config } from './types/index.js';
3
3
  type DocumentOpenTelemetryClient = Pick<Telemetry, 'trackDocumentOpen'>;
4
4
  export type DocumentOpenTelemetry = {
@@ -377,6 +377,10 @@ export type EditorRuntimeUnsubscribe = () => void;
377
377
  * computeds without forcing them async in current implementation.
378
378
  */
379
379
  export interface EditorRuntimeUser {
380
+ commentIdentity?: {
381
+ providerId: string;
382
+ userId: string;
383
+ } | null;
380
384
  name: string;
381
385
  id?: string;
382
386
  email?: string;
@@ -189,5 +189,6 @@ export interface V2EditorRuntimeAdapterOptions {
189
189
  export declare function createV2EditorRuntimeAdapter(options: V2EditorRuntimeAdapterOptions): {
190
190
  runtime: EditorRuntime;
191
191
  attachMountHandle(handle: HostMountHandleLike | null): void;
192
+ detach(): void;
192
193
  };
193
194
  export {};