@hamster-note/notes 2.0.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. package/README.md +205 -59
  2. package/dist/index.cjs +227 -57
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.js +42042 -22960
  5. package/dist/index.js.map +1 -1
  6. package/dist/lib/editor/HnnDataDrawer.d.ts +18 -0
  7. package/dist/lib/editor/HnnDataDrawer.d.ts.map +1 -0
  8. package/dist/lib/editor/HostReferenceUI.d.ts +22 -0
  9. package/dist/lib/editor/HostReferenceUI.d.ts.map +1 -0
  10. package/dist/lib/editor/MarkdownExport.d.ts +29 -0
  11. package/dist/lib/editor/MarkdownExport.d.ts.map +1 -0
  12. package/dist/lib/editor/NoteEditor.d.ts +19 -0
  13. package/dist/lib/editor/NoteEditor.d.ts.map +1 -0
  14. package/dist/lib/editor/NoteSaveStatus.d.ts +22 -0
  15. package/dist/lib/editor/NoteSaveStatus.d.ts.map +1 -0
  16. package/dist/lib/editor/blockMenu.d.ts +19 -0
  17. package/dist/lib/editor/blockMenu.d.ts.map +1 -0
  18. package/dist/lib/editor/blockReorder.d.ts +77 -0
  19. package/dist/lib/editor/blockReorder.d.ts.map +1 -0
  20. package/dist/lib/editor/hostReferenceInteractions.d.ts +34 -0
  21. package/dist/lib/editor/hostReferenceInteractions.d.ts.map +1 -0
  22. package/dist/lib/editor/hostReferences.d.ts +40 -0
  23. package/dist/lib/editor/hostReferences.d.ts.map +1 -0
  24. package/dist/lib/editor/nativeClipboard.d.ts +8 -0
  25. package/dist/lib/editor/nativeClipboard.d.ts.map +1 -0
  26. package/dist/lib/editor/pictureUpload.d.ts +27 -0
  27. package/dist/lib/editor/pictureUpload.d.ts.map +1 -0
  28. package/dist/lib/editor/session.d.ts +71 -0
  29. package/dist/lib/editor/session.d.ts.map +1 -0
  30. package/dist/lib/editor/sessionKey.d.ts +6 -0
  31. package/dist/lib/editor/sessionKey.d.ts.map +1 -0
  32. package/dist/lib/editor/types.d.ts +143 -0
  33. package/dist/lib/editor/types.d.ts.map +1 -0
  34. package/dist/lib/hnn/budgetedTransaction.d.ts +44 -0
  35. package/dist/lib/hnn/budgetedTransaction.d.ts.map +1 -0
  36. package/dist/lib/hnn/cardPayload.d.ts +48 -0
  37. package/dist/lib/hnn/cardPayload.d.ts.map +1 -0
  38. package/dist/lib/hnn/codec.d.ts +21 -0
  39. package/dist/lib/hnn/codec.d.ts.map +1 -0
  40. package/dist/lib/hnn/directoryEntries.d.ts +12 -0
  41. package/dist/lib/hnn/directoryEntries.d.ts.map +1 -0
  42. package/dist/lib/hnn/drawingPayload.d.ts +26 -0
  43. package/dist/lib/hnn/drawingPayload.d.ts.map +1 -0
  44. package/dist/lib/hnn/extensions.d.ts +50 -0
  45. package/dist/lib/hnn/extensions.d.ts.map +1 -0
  46. package/dist/lib/hnn/limits.d.ts +30 -0
  47. package/dist/lib/hnn/limits.d.ts.map +1 -0
  48. package/dist/lib/hnn/markdown.d.ts +29 -0
  49. package/dist/lib/hnn/markdown.d.ts.map +1 -0
  50. package/dist/lib/hnn/menuPopover.d.ts +46 -0
  51. package/dist/lib/hnn/menuPopover.d.ts.map +1 -0
  52. package/dist/lib/hnn/nodeId.d.ts +20 -0
  53. package/dist/lib/hnn/nodeId.d.ts.map +1 -0
  54. package/dist/lib/hnn/persistedStringBudget.d.ts +21 -0
  55. package/dist/lib/hnn/persistedStringBudget.d.ts.map +1 -0
  56. package/dist/lib/hnn/schema.d.ts +6 -0
  57. package/dist/lib/hnn/schema.d.ts.map +1 -0
  58. package/dist/lib/hnn/stringBytes.d.ts +29 -0
  59. package/dist/lib/hnn/stringBytes.d.ts.map +1 -0
  60. package/dist/lib/hnn/tableEdgeControls.d.ts +39 -0
  61. package/dist/lib/hnn/tableEdgeControls.d.ts.map +1 -0
  62. package/dist/lib/hnn/urlPolicy.d.ts +8 -0
  63. package/dist/lib/hnn/urlPolicy.d.ts.map +1 -0
  64. package/dist/lib/index.d.ts +6 -6
  65. package/dist/lib/index.d.ts.map +1 -1
  66. package/dist/styles.css +1 -1
  67. package/package.json +13 -8
  68. package/dist/lib/BlockActionMenu.d.ts +0 -55
  69. package/dist/lib/BlockActionMenu.d.ts.map +0 -1
  70. package/dist/lib/BlockActionMenuTypes.d.ts +0 -23
  71. package/dist/lib/BlockActionMenuTypes.d.ts.map +0 -1
  72. package/dist/lib/BottomBlockControls.d.ts +0 -17
  73. package/dist/lib/BottomBlockControls.d.ts.map +0 -1
  74. package/dist/lib/CardInspector.d.ts +0 -10
  75. package/dist/lib/CardInspector.d.ts.map +0 -1
  76. package/dist/lib/CardLinkOverlay.d.ts +0 -13
  77. package/dist/lib/CardLinkOverlay.d.ts.map +0 -1
  78. package/dist/lib/LinkMentionMenu.d.ts +0 -9
  79. package/dist/lib/LinkMentionMenu.d.ts.map +0 -1
  80. package/dist/lib/NoteBlockEditingControls.d.ts +0 -20
  81. package/dist/lib/NoteBlockEditingControls.d.ts.map +0 -1
  82. package/dist/lib/NoteBlockFocus.d.ts +0 -15
  83. package/dist/lib/NoteBlockFocus.d.ts.map +0 -1
  84. package/dist/lib/NoteCalloutBlock.d.ts +0 -10
  85. package/dist/lib/NoteCalloutBlock.d.ts.map +0 -1
  86. package/dist/lib/NoteCardBlock.d.ts +0 -10
  87. package/dist/lib/NoteCardBlock.d.ts.map +0 -1
  88. package/dist/lib/NoteChecklistBlock.d.ts +0 -10
  89. package/dist/lib/NoteChecklistBlock.d.ts.map +0 -1
  90. package/dist/lib/NoteCodeEditorBlock.d.ts +0 -10
  91. package/dist/lib/NoteCodeEditorBlock.d.ts.map +0 -1
  92. package/dist/lib/NoteCollapsibleBlock.d.ts +0 -10
  93. package/dist/lib/NoteCollapsibleBlock.d.ts.map +0 -1
  94. package/dist/lib/NoteContent.d.ts +0 -9
  95. package/dist/lib/NoteContent.d.ts.map +0 -1
  96. package/dist/lib/NoteContentBlocks.d.ts +0 -6
  97. package/dist/lib/NoteContentBlocks.d.ts.map +0 -1
  98. package/dist/lib/NoteContentEditing.d.ts +0 -58
  99. package/dist/lib/NoteContentEditing.d.ts.map +0 -1
  100. package/dist/lib/NoteDirectoryBlock.d.ts +0 -10
  101. package/dist/lib/NoteDirectoryBlock.d.ts.map +0 -1
  102. package/dist/lib/NoteDrawingBlock.d.ts +0 -10
  103. package/dist/lib/NoteDrawingBlock.d.ts.map +0 -1
  104. package/dist/lib/NoteFormulaBlock.d.ts +0 -10
  105. package/dist/lib/NoteFormulaBlock.d.ts.map +0 -1
  106. package/dist/lib/NoteListBlock.d.ts +0 -12
  107. package/dist/lib/NoteListBlock.d.ts.map +0 -1
  108. package/dist/lib/NoteParagraphBlock.d.ts +0 -12
  109. package/dist/lib/NoteParagraphBlock.d.ts.map +0 -1
  110. package/dist/lib/NotePictureBlock.d.ts +0 -10
  111. package/dist/lib/NotePictureBlock.d.ts.map +0 -1
  112. package/dist/lib/NoteQuoteBlock.d.ts +0 -11
  113. package/dist/lib/NoteQuoteBlock.d.ts.map +0 -1
  114. package/dist/lib/NoteTableBlock.d.ts +0 -5
  115. package/dist/lib/NoteTableBlock.d.ts.map +0 -1
  116. package/dist/lib/NoteTextBlockLayouts.d.ts +0 -27
  117. package/dist/lib/NoteTextBlockLayouts.d.ts.map +0 -1
  118. package/dist/lib/NoteTextBlocks.d.ts +0 -11
  119. package/dist/lib/NoteTextBlocks.d.ts.map +0 -1
  120. package/dist/lib/NoteTodoBlock.d.ts +0 -11
  121. package/dist/lib/NoteTodoBlock.d.ts.map +0 -1
  122. package/dist/lib/PictureUploadMenuItem.d.ts +0 -9
  123. package/dist/lib/PictureUploadMenuItem.d.ts.map +0 -1
  124. package/dist/lib/SelectionPopover.d.ts +0 -28
  125. package/dist/lib/SelectionPopover.d.ts.map +0 -1
  126. package/dist/lib/TableDragHandle.d.ts +0 -15
  127. package/dist/lib/TableDragHandle.d.ts.map +0 -1
  128. package/dist/lib/TableOperationMenu.d.ts +0 -16
  129. package/dist/lib/TableOperationMenu.d.ts.map +0 -1
  130. package/dist/lib/blockContainerDom.d.ts +0 -11
  131. package/dist/lib/blockContainerDom.d.ts.map +0 -1
  132. package/dist/lib/blockContainerMove.d.ts +0 -17
  133. package/dist/lib/blockContainerMove.d.ts.map +0 -1
  134. package/dist/lib/blockConversion.d.ts +0 -57
  135. package/dist/lib/blockConversion.d.ts.map +0 -1
  136. package/dist/lib/blockDowngrade.d.ts +0 -21
  137. package/dist/lib/blockDowngrade.d.ts.map +0 -1
  138. package/dist/lib/blockDragBindingKey.d.ts +0 -3
  139. package/dist/lib/blockDragBindingKey.d.ts.map +0 -1
  140. package/dist/lib/blockDragDesktop.d.ts +0 -13
  141. package/dist/lib/blockDragDesktop.d.ts.map +0 -1
  142. package/dist/lib/blockDragDom.d.ts +0 -24
  143. package/dist/lib/blockDragDom.d.ts.map +0 -1
  144. package/dist/lib/blockDragTarget.d.ts +0 -15
  145. package/dist/lib/blockDragTarget.d.ts.map +0 -1
  146. package/dist/lib/blockDragTouch.d.ts +0 -17
  147. package/dist/lib/blockDragTouch.d.ts.map +0 -1
  148. package/dist/lib/blockEditing.d.ts +0 -36
  149. package/dist/lib/blockEditing.d.ts.map +0 -1
  150. package/dist/lib/blockSourceConversion.d.ts +0 -41
  151. package/dist/lib/blockSourceConversion.d.ts.map +0 -1
  152. package/dist/lib/blockSourceInsertion.d.ts +0 -17
  153. package/dist/lib/blockSourceInsertion.d.ts.map +0 -1
  154. package/dist/lib/blockSourceMove.d.ts +0 -39
  155. package/dist/lib/blockSourceMove.d.ts.map +0 -1
  156. package/dist/lib/blockSourceOperations.d.ts +0 -37
  157. package/dist/lib/blockSourceOperations.d.ts.map +0 -1
  158. package/dist/lib/blockSourceSplit.d.ts +0 -4
  159. package/dist/lib/blockSourceSplit.d.ts.map +0 -1
  160. package/dist/lib/cardData.d.ts +0 -6
  161. package/dist/lib/cardData.d.ts.map +0 -1
  162. package/dist/lib/cardGeometry.d.ts +0 -14
  163. package/dist/lib/cardGeometry.d.ts.map +0 -1
  164. package/dist/lib/drawingData.d.ts +0 -37
  165. package/dist/lib/drawingData.d.ts.map +0 -1
  166. package/dist/lib/editableSelection.d.ts +0 -6
  167. package/dist/lib/editableSelection.d.ts.map +0 -1
  168. package/dist/lib/externalNoteDrag.d.ts +0 -55
  169. package/dist/lib/externalNoteDrag.d.ts.map +0 -1
  170. package/dist/lib/externalNoteDropTarget.d.ts +0 -11
  171. package/dist/lib/externalNoteDropTarget.d.ts.map +0 -1
  172. package/dist/lib/inlineFormulaRendering.d.ts +0 -37
  173. package/dist/lib/inlineFormulaRendering.d.ts.map +0 -1
  174. package/dist/lib/inlineMarkdownShortcut.d.ts +0 -75
  175. package/dist/lib/inlineMarkdownShortcut.d.ts.map +0 -1
  176. package/dist/lib/inlineSelectionFormatting.d.ts +0 -164
  177. package/dist/lib/inlineSelectionFormatting.d.ts.map +0 -1
  178. package/dist/lib/markdownShortcut.d.ts +0 -71
  179. package/dist/lib/markdownShortcut.d.ts.map +0 -1
  180. package/dist/lib/noteAtomicMutation.d.ts +0 -5
  181. package/dist/lib/noteAtomicMutation.d.ts.map +0 -1
  182. package/dist/lib/noteBoundarySplice.d.ts +0 -6
  183. package/dist/lib/noteBoundarySplice.d.ts.map +0 -1
  184. package/dist/lib/noteClipboardBlockCodec.d.ts +0 -4
  185. package/dist/lib/noteClipboardBlockCodec.d.ts.map +0 -1
  186. package/dist/lib/noteClipboardLimits.d.ts +0 -4
  187. package/dist/lib/noteClipboardLimits.d.ts.map +0 -1
  188. package/dist/lib/noteClipboardRegionSlice.d.ts +0 -4
  189. package/dist/lib/noteClipboardRegionSlice.d.ts.map +0 -1
  190. package/dist/lib/noteClipboardSlices.d.ts +0 -35
  191. package/dist/lib/noteClipboardSlices.d.ts.map +0 -1
  192. package/dist/lib/noteContentUndoRedo.d.ts +0 -34
  193. package/dist/lib/noteContentUndoRedo.d.ts.map +0 -1
  194. package/dist/lib/noteId.d.ts +0 -3
  195. package/dist/lib/noteId.d.ts.map +0 -1
  196. package/dist/lib/noteNestedMutation.d.ts +0 -7
  197. package/dist/lib/noteNestedMutation.d.ts.map +0 -1
  198. package/dist/lib/notePointerSelection.d.ts +0 -6
  199. package/dist/lib/notePointerSelection.d.ts.map +0 -1
  200. package/dist/lib/noteRegionCodec.d.ts +0 -9
  201. package/dist/lib/noteRegionCodec.d.ts.map +0 -1
  202. package/dist/lib/noteSelectAll.d.ts +0 -2
  203. package/dist/lib/noteSelectAll.d.ts.map +0 -1
  204. package/dist/lib/noteSelectionRestore.d.ts +0 -14
  205. package/dist/lib/noteSelectionRestore.d.ts.map +0 -1
  206. package/dist/lib/noteSnapshotMutation.d.ts +0 -8
  207. package/dist/lib/noteSnapshotMutation.d.ts.map +0 -1
  208. package/dist/lib/noteStructuredClipboard.d.ts +0 -17
  209. package/dist/lib/noteStructuredClipboard.d.ts.map +0 -1
  210. package/dist/lib/noteStructuredPaste.d.ts +0 -10
  211. package/dist/lib/noteStructuredPaste.d.ts.map +0 -1
  212. package/dist/lib/noteStructuredTail.d.ts +0 -3
  213. package/dist/lib/noteStructuredTail.d.ts.map +0 -1
  214. package/dist/lib/noteTextFlow.d.ts +0 -23
  215. package/dist/lib/noteTextFlow.d.ts.map +0 -1
  216. package/dist/lib/noteTextOffset.d.ts +0 -4
  217. package/dist/lib/noteTextOffset.d.ts.map +0 -1
  218. package/dist/lib/noteTransferReplacement.d.ts +0 -10
  219. package/dist/lib/noteTransferReplacement.d.ts.map +0 -1
  220. package/dist/lib/quoteLineEditing.d.ts +0 -5
  221. package/dist/lib/quoteLineEditing.d.ts.map +0 -1
  222. package/dist/lib/restrictedHtml.d.ts +0 -7
  223. package/dist/lib/restrictedHtml.d.ts.map +0 -1
  224. package/dist/lib/syntaxHighlight.d.ts +0 -9
  225. package/dist/lib/syntaxHighlight.d.ts.map +0 -1
  226. package/dist/lib/tableDragPreview.d.ts +0 -15
  227. package/dist/lib/tableDragPreview.d.ts.map +0 -1
  228. package/dist/lib/tableDragTarget.d.ts +0 -13
  229. package/dist/lib/tableDragTarget.d.ts.map +0 -1
  230. package/dist/lib/tableEditing.d.ts +0 -35
  231. package/dist/lib/tableEditing.d.ts.map +0 -1
  232. package/dist/lib/tableKeyboardNavigation.d.ts +0 -14
  233. package/dist/lib/tableKeyboardNavigation.d.ts.map +0 -1
  234. package/dist/lib/tableMoveFocus.d.ts +0 -11
  235. package/dist/lib/tableMoveFocus.d.ts.map +0 -1
  236. package/dist/lib/types.d.ts +0 -302
  237. package/dist/lib/types.d.ts.map +0 -1
  238. package/dist/lib/useBlockDrag.d.ts +0 -11
  239. package/dist/lib/useBlockDrag.d.ts.map +0 -1
  240. package/dist/lib/useBlockEditing.d.ts +0 -9
  241. package/dist/lib/useBlockEditing.d.ts.map +0 -1
  242. package/dist/lib/useDraggedTouchClickSuppression.d.ts +0 -7
  243. package/dist/lib/useDraggedTouchClickSuppression.d.ts.map +0 -1
  244. package/dist/lib/useExternalNoteDrag.d.ts +0 -15
  245. package/dist/lib/useExternalNoteDrag.d.ts.map +0 -1
  246. package/dist/lib/useTableMoveFocus.d.ts +0 -11
  247. package/dist/lib/useTableMoveFocus.d.ts.map +0 -1
  248. package/dist/lib/useTableOperationMenus.d.ts +0 -19
  249. package/dist/lib/useTableOperationMenus.d.ts.map +0 -1
  250. package/dist/lib/utils.d.ts +0 -10
  251. package/dist/lib/utils.d.ts.map +0 -1
@@ -0,0 +1,18 @@
1
+ import { ReactElement } from 'react';
2
+ import { Editor } from '@tiptap/core';
3
+ type HnnDataDrawerProps = Readonly<{
4
+ editor: Editor;
5
+ /** 显式主题只切换 hn-* token 修饰类,与编辑壳一致;缺省 light。 */
6
+ theme: "light" | "dark";
7
+ }>;
8
+ /** 内部组件:card/drawing 块的底部 Drawer 数据编辑器(Phase 6.3)。
9
+ *
10
+ * 会话绑定(Gate 6.3 安全约束):宿主以 `key = mounted sessionKey` 挂载本组件,
11
+ * editor 取自同一原子挂载态。会话切换/卸载时 React 整体 remount——portal 随卸载
12
+ * 移除、进行中的草稿只被丢弃:绝不 commit、绝不触发旧会话保存、绝不把焦点还给
13
+ * 可能已随旧会话断开的 anchor(close() 只在同会话内被显式关闭路径调用,且已用
14
+ * anchor.isConnected 兜底)。卸载路径上不安排任何 commit/焦点副作用。
15
+ */
16
+ export declare function HnnDataDrawer({ editor, theme }: HnnDataDrawerProps): ReactElement;
17
+ export {};
18
+ //# sourceMappingURL=HnnDataDrawer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"HnnDataDrawer.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/HnnDataDrawer.tsx"],"names":[],"mappings":"AACA,OAAO,qCAAqC,CAAA;AAM5C,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAkB1C,KAAK,kBAAkB,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;CACxB,CAAC,CAAA;AA2EF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,kBAAkB,GAAG,YAAY,CAkQjF"}
@@ -0,0 +1,22 @@
1
+ import { ReactElement } from 'react';
2
+ import { Editor } from '@tiptap/core';
3
+ import { HostReferenceInstaller } from './hostReferences';
4
+ /**
5
+ * 7.2 宿主引用候选菜单(mention/resource)。
6
+ * - 触发/键盘/取消/精确替换等交互全部在 headless 交互桥(hostReferenceInteractions)
7
+ * 中实现;本组件只负责渲染候选浮层与把点击选择转交桥;
8
+ * - 视觉遵 DESIGN.md §14:fixed 定位于光标下方的 listbox,沿用现有桌面 popover 表面
9
+ * (#1e293b、10px 圆角、阴影、0.12s 透明度淡入),不引入新色板或动效语言;
10
+ * - 候选 pending/error/empty 以非交互状态行可观察呈现;选项 role=option +
11
+ * aria-selected,键盘高亮由桥驱动(focus 保留在编辑器);
12
+ * - pointerdown/mousedown preventDefault:点击候选不打断编辑器焦点与选区,
13
+ * 存储的触发 range 不会在选中前丢失。
14
+ */
15
+ export type HostReferenceUIProps = Readonly<{
16
+ editor: Editor;
17
+ /** 由接线层(NoteEditor)随会话创建/销毁的宿主引用 installer。 */
18
+ installer: HostReferenceInstaller;
19
+ className?: string;
20
+ }>;
21
+ export declare function HostReferenceUI(props: HostReferenceUIProps): ReactElement | null;
22
+ //# sourceMappingURL=HostReferenceUI.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"HostReferenceUI.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/HostReferenceUI.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAO9D,OAAO,uBAAuB,CAAA;AAE9B;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,SAAS,EAAE,sBAAsB,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAC,CAAA;AAqEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,GAAG,IAAI,CAkIhF"}
@@ -0,0 +1,29 @@
1
+ import { ReactElement } from 'react';
2
+ import { HnnDocument } from '../hnn/codec';
3
+ import { MarkdownExportResult } from '../hnn/markdown';
4
+ /** 宿主写出上下文:独立 AbortSignal 随取消/会话切换/卸载中止;宿主忽略 abort 时库内也会丢弃陈旧结果。 */
5
+ export type MarkdownExportContext = Readonly<{
6
+ signal: AbortSignal;
7
+ }>;
8
+ /**
9
+ * Markdown 导出界面(OpenSpec 7.6)。默认保存始终是 HNN,本组件只在用户显式点击
10
+ * 「导出 Markdown」时捕获一次快照并运行纯函数 codec:无诊断直接交给宿主写出;
11
+ * 有降级诊断则展示诊断与预览,用户显式确认前绝不调用 onExport。取消不写出、
12
+ * 不触碰文档/save baseline/history;确认写出的始终是当次已诊断的那份结果,
13
+ * 绝不偷偷重抓新内容。会话切换或卸载时 abort 在途写出并丢弃陈旧 UI 回写。
14
+ */
15
+ export type MarkdownExportProps = Readonly<{
16
+ /** 返回当前文档的 HNN 快照;仅在用户点击导出时调用一次,不暴露 editor/schema。 */
17
+ snapshot: () => HnnDocument;
18
+ /** 宿主写出回调;仅在无诊断直接导出或用户显式确认诊断之后调用。 */
19
+ onExport: (result: MarkdownExportResult, context: MarkdownExportContext) => void | Promise<void>;
20
+ /** 编辑会话标识:变化时中止在途导出、丢弃待确认诊断与一切陈旧结果。 */
21
+ sessionKey: string;
22
+ /** 显式主题只切换 hn-* token 修饰类;缺省继承祖先 token。 */
23
+ theme?: "light" | "dark";
24
+ /** 宿主侧额外禁用触发入口,不影响进行中的导出语义。 */
25
+ disabled?: boolean;
26
+ className?: string;
27
+ }>;
28
+ export declare function MarkdownExport(props: MarkdownExportProps): ReactElement;
29
+ //# sourceMappingURL=MarkdownExport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MarkdownExport.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/MarkdownExport.tsx"],"names":[],"mappings":"AACA,OAAO,qCAAqC,CAAA;AAC5C,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,sBAAsB,CAAA;AAE7B,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,WAAW,CAAA;CACpB,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,WAAW,CAAA;IAC3B,qCAAqC;IACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChG,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAC,CAAA;AA2CF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA4MvE"}
@@ -0,0 +1,19 @@
1
+ import { MarkdownExportProps } from './MarkdownExport';
2
+ import { EditorSessionOptions } from './types';
3
+ /**
4
+ * 内部 NoteEditor props。7.1 会以其为公开类型基础(故导出类型但不导出组件根入口);
5
+ * onExportMarkdown 这类纯 UI 触点只放在组件 props 上,不进入 EditorSessionOptions,
6
+ * 会话因此不携带任何纯 UI 依赖。
7
+ */
8
+ export type NoteEditorProps = EditorSessionOptions & Readonly<{
9
+ /** 显式主题只切换 hn-* token 修饰类,不进入会话或保存语义;缺省为 light。 */
10
+ theme?: "light" | "dark";
11
+ /**
12
+ * Markdown 显式导出回调(任务 7.6)。缺省不呈现导出入口,默认保存始终为 HNN;
13
+ * 导出仅在用户显式点击并经降级诊断确认后调用。
14
+ */
15
+ onExportMarkdown?: MarkdownExportProps["onExport"];
16
+ }>;
17
+ /** 内部组件,Phase 7 前不得从 src/lib/index.ts 公开。 */
18
+ export declare function NoteEditor(props: NoteEditorProps): import("react").JSX.Element;
19
+ //# sourceMappingURL=NoteEditor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NoteEditor.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/NoteEditor.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAK3E,OAAO,KAAK,EACV,oBAAoB,EAKrB,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,QAAQ,CAAC;IAC5D,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAA;CACnD,CAAC,CAAA;AAgdF,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,+BAEhD"}
@@ -0,0 +1,22 @@
1
+ import { EditorSessionState } from './types';
2
+ /**
3
+ * 保存状态界面(OpenSpec 7.3)。只消费 EditorSession 暴露的权威状态,不自建保存
4
+ * 逻辑或状态机:dirty/saving/error/conflict 的判定、CAS 单飞与冲突决策全部留在
5
+ * EditorSession 内,本组件负责把它们可观察地呈现出来。
6
+ */
7
+ export type NoteSaveStatusProps = Readonly<{
8
+ /** EditorSession.state 的快照;组件不修改也不推断它之外的保存语义。 */
9
+ state: EditorSessionState;
10
+ /**
11
+ * 触发一次正常保存(由接线方转调 EditorSession.save())。允许返回 Promise;
12
+ * 组件会吞掉 rejected 以防止 unhandled rejection,但绝不以此代替权威 state。
13
+ */
14
+ onSave: () => void | Promise<unknown>;
15
+ /** 宿主侧额外禁用(例如整体只读),不影响状态文案的呈现。 */
16
+ disabled?: boolean;
17
+ /** 显式主题只切换 hn-* token 修饰类,与 NoteEditor 的 theme 约定一致;缺省继承祖先 token。 */
18
+ theme?: "light" | "dark";
19
+ className?: string;
20
+ }>;
21
+ export declare function NoteSaveStatus(props: NoteSaveStatusProps): import("react").JSX.Element;
22
+ //# sourceMappingURL=NoteSaveStatus.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NoteSaveStatus.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/NoteSaveStatus.tsx"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEjD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,iDAAiD;IACjD,KAAK,EAAE,kBAAkB,CAAA;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAC,CAAA;AASF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BAoFxD"}
@@ -0,0 +1,19 @@
1
+ import { Editor } from '@tiptap/core';
2
+ import { AnchoredMenuHandle } from '../hnn/menuPopover';
3
+ export interface BlockMenuCapabilities {
4
+ /** 宿主是否提供图片上传(决定图片入口可用性,DESIGN.md §12)。 */
5
+ readonly canUploadPicture: () => boolean;
6
+ /** 与 picker/paste/drop 相同的上传入队通道;position 为文档内插入点。 */
7
+ readonly enqueuePictures: (files: Iterable<File>, position: number) => readonly string[];
8
+ }
9
+ export interface OpenBlockMenuOptions {
10
+ readonly editor: Editor;
11
+ /** 定位与焦点归还的锚点(块手柄)。 */
12
+ readonly anchor: HTMLElement;
13
+ readonly getPos: () => number | undefined;
14
+ readonly capabilities: BlockMenuCapabilities;
15
+ /** 菜单因任何原因关闭后恰好调用一次(blockReorder 据此复位手柄激活态)。 */
16
+ readonly onClosed: () => void;
17
+ }
18
+ export declare function openBlockMenu(options: OpenBlockMenuOptions): AnchoredMenuHandle | null;
19
+ //# sourceMappingURL=blockMenu.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"blockMenu.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/blockMenu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAS1C,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAQtG,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,OAAO,CAAA;IACxC,sDAAsD;IACtD,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAA;CACzF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAA;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B;AAkDD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,IAAI,CAiKtF"}
@@ -0,0 +1,77 @@
1
+ import { Editor } from '@tiptap/core';
2
+ import { EditorView } from '@tiptap/pm/view';
3
+ /**
4
+ * 顶层内容块重排(OpenSpec migrate-to-tiptap-prosemirror D10 / 任务 6.5)。
5
+ *
6
+ * - 仅 PM doc 顶层子块可重排:手柄只以 widget decoration 挂在顶层子块起点,
7
+ * 嵌套列表项、表格内部节点结构上拿不到手柄,也不是合法重排目标。
8
+ * - 桌面端:手柄原生 `draggable` + `data-drag-handle`,dragstart 即 stopPropagation
9
+ * (PM 的 view.dragging 保持 null,可据此区分内部拖拽),drop 在 document capture
10
+ * 阶段 preventDefault + stopImmediatePropagation,PM 原生 drop 不会二次执行;
11
+ * 另有插件 handleDOMEvents.drop/dragover 双保险:仅认领携带重排 MIME 的事件,
12
+ * 外部图片/文件 drop 不携带此 MIME,原样交还 PM,未来图片 drop 不会双写。
13
+ * - 移动端:手柄 Pointer Events 长按 500ms 启动;长按阈值前的位移(>10px)、
14
+ * 提前抬起、pointercancel、卸载都会取消挂起手势且不产生任何事务,原生滚动保留。
15
+ * 长按未激活的快速点按(click)不拖拽,改为打开块操作菜单(DESIGN.md §9)。
16
+ * - 手柄同时是块操作菜单入口(D9/任务 7.5):可聚焦按钮(role/tabindex/aria),
17
+ * 点击、Enter/Space/ArrowDown 打开菜单,菜单内提供键盘可用的上移/下移(与拖拽
18
+ * 共享同一提交入口);菜单打开期间手柄保持 token 激活态,关闭后 aria-expanded
19
+ * 复位;拖拽手势结束后的残余 click 被抑制,不会误开菜单。
20
+ * - 两端复用同一个位置计算(computeInsertionBoundary,DESIGN.md §13 垂直中点规则)
21
+ * 与同一个提交入口(reorderTopLevelBlock),文档变更恰好一个 PM transaction;
22
+ * closeHistory 使重排与前序输入分属不同 undo 事件,提交后再补一个无 step 的
23
+ * meta-only 历史栅栏 transaction,保证紧随其后的相邻输入也独立成组:
24
+ * 一步撤销只还原这次重排(PM closeHistory 只重置 prevTime/prevRanges,
25
+ * 不阻止后续 500ms 内相邻输入并入,见 prosemirror-history applyTransaction)。
26
+ * - 手势捕获的 fromIndex 只在文档不变的窗口内有效:pending/active 期间任何
27
+ * docChanged 都保守取消手势(不提交错块),drop 以自身 clientY 刷新最终落点;
28
+ * 只读视图(view.editable=false)手势与程序化提交都被拒绝,handle 由 CSS 隐藏。
29
+ * - 拖拽预览(3px 主题线)与源块高亮以 PM 持有的 node decorations 渲染
30
+ * (bug-7.5-2 修复):类由 PM 自己写进内容 DOM,DOMObserver 的重绘不再抹掉,
31
+ * 整个手势期间持续可见;装饰只经 meta-only transaction 更新(无 step),
32
+ * doc/selection/history 零扰动,且随 docChanged 自动清空(保守取消)。手柄的
33
+ * --dragging 类仍直写 widget DOM——PM 对 widget 内部 mutation 一律 ignore,
34
+ * 不触发重绘,类在整个手势期间存活。
35
+ */
36
+ /** 桌面原生拖拽的自定义 MIME。绝不写 text/html,避免 PM 原生 drop 解析出 slice。 */
37
+ export declare const HNN_BLOCK_REORDER_MIME = "application/x-hnn-block-reorder";
38
+ /** 移动端长按启动拖拽的阈值(DESIGN.md §13 的 500ms)。 */
39
+ export declare const HNN_REORDER_HOLD_MS = 500;
40
+ /**
41
+ * 块操作菜单的注入入口(DESIGN.md §9,任务 7.5/D9):手柄点击(无拖移位)或
42
+ * 键盘 Enter/Space/ArrowDown 激活时调用,返回菜单关闭函数;返回 undefined 表示
43
+ * 菜单未打开(如块已失效),手柄激活态立即复位。onClosed 由菜单在任何关闭路径
44
+ * (Esc/外部点击/scroll/resize/执行完成)后恰好调用一次。菜单实现不得导给宿主。
45
+ */
46
+ export interface BlockReorderOptions {
47
+ readonly openMenu?: (anchor: HTMLElement, getPos: () => number | undefined, onClosed: () => void) => ((restoreFocus?: boolean) => void) | void;
48
+ }
49
+ /** 单个顶层块的垂直跨度(viewport 坐标),供插入边界的纯计算使用。 */
50
+ export type BlockReorderSpan = Readonly<{
51
+ top: number;
52
+ bottom: number;
53
+ }>;
54
+ /**
55
+ * 垂直中点规则(DESIGN.md §13):clientY 越过多少个块的中点,插入边界就落在第
56
+ * 几个块之后。返回 0..spans.length 的边界下标。spans 必须按文档顺序(即垂直顺序)。
57
+ */
58
+ export declare function computeInsertionBoundary(spans: readonly BlockReorderSpan[], clientY: number): number;
59
+ /**
60
+ * 提交一次顶层块重排:把第 fromIndex 个顶层块移动到 boundary 边界(0..块数,
61
+ * 语义为“原顺序中第 boundary 个块之前”)。boundary === fromIndex 或 fromIndex + 1
62
+ * 是原地放置,连同非法下标一起按 no-op 处理——不产生 transaction,不污染历史与
63
+ * dirty 基准。合法移动的文档变更恰好一个 transaction(delete + insert 同一节点实例),
64
+ * nodeId 随节点本身保留。历史隔离分两半:
65
+ * - closeHistory(tr) 重置 prevTime/prevRanges,使重排与前序输入分属不同 undo 事件;
66
+ * - 紧随其后补一个无 step 的 meta-only 栅栏 transaction 再次重置二者——PM 的分组规则
67
+ * 会把 500ms 内与插入区间相邻的后续输入并入当前事件,栅栏令后续输入另起一组。
68
+ * 栅栏不改变文档、不产生历史条目、不触发 update/dirty。
69
+ * 最终:第一步撤销只还原这次重排,重排前后的编辑各有独立 undo step。
70
+ */
71
+ export declare function reorderTopLevelBlock(view: EditorView, fromIndex: number, boundary: number): boolean;
72
+ /**
73
+ * 在编辑会话上安装顶层块重排,返回卸载函数。手柄是 PM widget decoration(带
74
+ * nodeId key,节点移动/编辑时 DOM 复用且 getPos 实时),随插件注销整体移除。
75
+ */
76
+ export declare function installBlockReorder(editor: Editor, options?: BlockReorderOptions): () => void;
77
+ //# sourceMappingURL=blockReorder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"blockReorder.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/blockReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAI1C,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,oCAAoC,CAAA;AAEvE,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAatC;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAClB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,IAAI,KACjB,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/C;AAED,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAExE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOpG;AAYD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuBnG;AA6CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,IAAI,CAmgBjG"}
@@ -0,0 +1,34 @@
1
+ import { Editor } from '@tiptap/core';
2
+ import { HostReferenceInstaller } from './hostReferences';
3
+ import { HostCandidateKind, HostReferenceCandidate } from './types';
4
+ export type HostReferenceTrigger = Readonly<{
5
+ kind: HostCandidateKind;
6
+ query: string;
7
+ /** 触发串(含 `@`/`[[`)在文档中的精确范围,选择候选时整体替换。 */
8
+ from: number;
9
+ to: number;
10
+ }>;
11
+ export type HostReferenceInteractionState = Readonly<{
12
+ /** null 表示候选菜单关闭。 */
13
+ trigger: HostReferenceTrigger | null;
14
+ /** 键盘高亮项下标;UI 侧按候选数量 clamp 后渲染。 */
15
+ activeIndex: number;
16
+ }>;
17
+ export interface HostReferenceInteractions {
18
+ getState(): HostReferenceInteractionState;
19
+ subscribe(listener: () => void): () => void;
20
+ /** listbox/option 的 DOM id,供 UI 渲染与 aria-activedescendant 对齐。 */
21
+ readonly menuId: string;
22
+ optionId(index: number): string;
23
+ /**
24
+ * 选择候选:校验存储 range 仍与当前光标/文档一致后交给 installer 精确替换;
25
+ * 无论成败都收尾关闭菜单;插入为单 transaction 单 undo 步。
26
+ */
27
+ selectCandidate(candidate: HostReferenceCandidate): boolean;
28
+ setActiveIndex(index: number): void;
29
+ /** 关闭菜单并取消候选请求;不改变触发文本。 */
30
+ cancel(): void;
31
+ destroy(): void;
32
+ }
33
+ export declare function createHostReferenceInteractions(editor: Editor, installer: HostReferenceInstaller): HostReferenceInteractions;
34
+ //# sourceMappingURL=hostReferenceInteractions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hostReferenceInteractions.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/hostReferenceInteractions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAG1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAA2B,sBAAsB,EAAqB,MAAM,SAAS,CAAA;AA2CpH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX,CAAC,CAAA;AAEF,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACnD,qBAAqB;IACrB,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACpC,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;CACpB,CAAC,CAAA;AAEF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,IAAI,6BAA6B,CAAA;IACzC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAC3C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAA;IAC3D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,2BAA2B;IAC3B,MAAM,IAAI,IAAI,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;CAChB;AAmCD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,GAAG,yBAAyB,CAmX5H"}
@@ -0,0 +1,40 @@
1
+ import { Editor } from '@tiptap/core';
2
+ import { HostCandidateKind, HostCandidateProvider, HostCandidateState, HostReferenceActivate, HostReferenceActivation, HostReferenceCandidate, HostReferenceResolve, HostReferenceState } from './types';
3
+ export interface HostReferenceInsertRange {
4
+ from: number;
5
+ to: number;
6
+ }
7
+ export interface HostReferenceOptions {
8
+ readonly documentId: string;
9
+ /** 候选查询:kind 仅 mention/resource。缺省时受控 empty,不破坏文档。 */
10
+ readonly candidates?: HostCandidateProvider;
11
+ /** 激活宿主引用:库只调用回调,绝不自行 navigate。 */
12
+ readonly activate?: HostReferenceActivate;
13
+ /** 运行时解析:缺省时受控 missing,不破坏文档。 */
14
+ readonly resolve?: HostReferenceResolve;
15
+ readonly onCandidateStateChange?: (state: HostCandidateState) => void;
16
+ readonly onReferenceStateChange?: (state: HostReferenceState) => void;
17
+ }
18
+ export interface HostReferenceInstaller {
19
+ /** 仅在宿主提供激活回调时暴露链接/键盘语义;该能力属于内部接线,不进入 HNN。 */
20
+ readonly hasActivate: boolean;
21
+ /** 发起候选查询;同 kind/query 的旧请求会被 abort,旧结果不会覆盖。 */
22
+ requestCandidates(kind: HostCandidateKind, query: string): void;
23
+ /** 取消候选查询并回到 idle。 */
24
+ cancelCandidates(): void;
25
+ getCandidateState(): HostCandidateState;
26
+ subscribeCandidates(listener: (state: HostCandidateState) => void): () => void;
27
+ /**
28
+ * 以单个 transaction 在当前 TextSelection 或给定 range 插入合法 inline ref;
29
+ * marks 为空、nodeId 新生成、整文档预算前置校验、closeHistory 保证唯一历史步。
30
+ * 仅持久 resourceId/name;失败返回 false 且不产生任何文档/历史变化。
31
+ */
32
+ selectCandidate(kind: HostCandidateKind, candidate: HostReferenceCandidate, range?: HostReferenceInsertRange): boolean;
33
+ /** 调用宿主 activate;不自行导航,不修改文档。 */
34
+ activate(reference: HostReferenceActivation): void;
35
+ getReferenceState(): HostReferenceState;
36
+ subscribeReferences(listener: (state: HostReferenceState) => void): () => void;
37
+ destroy(): void;
38
+ }
39
+ export declare function installHostReferences(editor: Editor, options: HostReferenceOptions): HostReferenceInstaller;
40
+ //# sourceMappingURL=hostReferences.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hostReferences.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/hostReferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAS1C,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EAEtB,oBAAoB,EAGpB,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAgBhB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAC3C,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IACzC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;IACvC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAA;IACrE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAA;CACtE;AAED,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,gDAAgD;IAChD,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/D,sBAAsB;IACtB,gBAAgB,IAAI,IAAI,CAAA;IACxB,iBAAiB,IAAI,kBAAkB,CAAA;IACvC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC9E;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAA;IACtH,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAClD,iBAAiB,IAAI,kBAAkB,CAAA;IACvC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC9E,OAAO,IAAI,IAAI,CAAA;CAChB;AAqED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,sBAAsB,CA8Q3G"}
@@ -0,0 +1,8 @@
1
+ import { Editor } from '@tiptap/core';
2
+ /**
3
+ * 保持 PM 原生 copy/cut/paste handler 和默认单 transaction dispatch。capture 阶段先拒绝
4
+ * 原始非法 custom marker/composition paste,dispatch 阶段再验证实际 document-changing
5
+ * transaction(覆盖 TableKit、ordered-list 等任何前序 handler 生成的 transaction)。
6
+ */
7
+ export declare function installHnnClipboardHistoryBoundary(editor: Editor): () => void;
8
+ //# sourceMappingURL=nativeClipboard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nativeClipboard.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/nativeClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAiE1C;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAqE7E"}
@@ -0,0 +1,27 @@
1
+ import { Editor } from '@tiptap/core';
2
+ import { PictureUploadHandler, PictureUploadState } from './types';
3
+ export interface PictureUploadOptions {
4
+ /** 宿主图片上传回调:库只传文件与 { uploadId, attempt, signal }。 */
5
+ readonly upload: PictureUploadHandler;
6
+ /** 可选单文件字节上限;超限立即失败,不调用宿主。 */
7
+ readonly maxFileBytes?: number;
8
+ /** 状态变化回调(等价于 subscribe 的便捷入口)。 */
9
+ readonly onStateChange?: (state: PictureUploadState) => void;
10
+ }
11
+ export interface PictureUploadInstaller {
12
+ /**
13
+ * 显式插入入口:picker/paste/drop 都调用它。position 缺省取当前选区;返回本次
14
+ * 入队的 uploadId 列表(无法确定合法插入位置时返回空数组,绝不 fallback 0)。
15
+ */
16
+ enqueue(files: Iterable<File>, position?: number): readonly string[];
17
+ /** 失败后以相同 uploadId、递增 attempt 重试。 */
18
+ retry(uploadId: string): boolean;
19
+ /** 取消进行中或失败的上传并移除对应占位。 */
20
+ cancel(uploadId: string): boolean;
21
+ getState(): PictureUploadState;
22
+ subscribe(listener: (state: PictureUploadState) => void): () => void;
23
+ /** 卸载:abort 全部上传、注销插件并丢弃一切陈旧结果。 */
24
+ destroy(): void;
25
+ }
26
+ export declare function installPictureUpload(editor: Editor, options: PictureUploadOptions): PictureUploadInstaller;
27
+ //# sourceMappingURL=pictureUpload.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pictureUpload.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/pictureUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAU1C,OAAO,KAAK,EAAE,oBAAoB,EAA0C,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAsC/G,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAA;CAC7D;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACpE,qCAAqC;IACrC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACjC,QAAQ,IAAI,kBAAkB,CAAA;IAC9B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACpE,mCAAmC;IACnC,OAAO,IAAI,IAAI,CAAA;CAChB;AA8CD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,sBAAsB,CA8T1G"}
@@ -0,0 +1,71 @@
1
+ import { Editor } from '@tiptap/core';
2
+ import { HostReferenceInstaller } from './hostReferences';
3
+ import { PictureUploadInstaller } from './pictureUpload';
4
+ import { EditorSessionOptions, EditorSessionState, HostCandidateProvider, HostReferenceActivate, HostReferenceResolve, NoteSaveResult, PictureUploadHandler } from './types';
5
+ /** 宿主引用三回调能力集合(任务 7.2):仅会话内部配置使用,不进入 7.1 前的公开面。 */
6
+ export type HostReferenceCapability = Readonly<{
7
+ candidates?: HostCandidateProvider;
8
+ activate?: HostReferenceActivate;
9
+ resolve?: HostReferenceResolve;
10
+ }>;
11
+ type Listener = () => void;
12
+ /**
13
+ * 单次已验证装载的私有编辑会话。ProseMirror Node 是不可变持久数据结构,因此捕获的
14
+ * 文档既可安全作为保存快照的源,也可作为保存 baseline,不会被后续 transaction 改写。
15
+ */
16
+ export declare class EditorSession {
17
+ #private;
18
+ readonly editor: Editor;
19
+ constructor(options: EditorSessionOptions);
20
+ get state(): EditorSessionState;
21
+ get revision(): string | undefined;
22
+ /**
23
+ * 图片上传 installer(任务 6.7)。仅供 NoteEditor 内部控件消费:7.1 之前
24
+ * EditorSession 不公开,此访问器也不构成公开 API;当前未启用上传(构造未提供
25
+ * 或 configurePictureUpload 已移除回调)时为 undefined,控件据此不呈现上传入口。
26
+ */
27
+ get pictureUpload(): PictureUploadInstaller | undefined;
28
+ /**
29
+ * 内部上传能力配置(任务 6.7):仅 NoteEditor 在同 key 已提交 callback 变化时调用,
30
+ * 不属于 7.1 之前的公开面。callback 不是 initial-only 输入:
31
+ * - undefined → fn:只增安装上传插件(picker/粘贴/拖入即刻可用),不重建 editor,
32
+ * doc/selection/history/baseline 全部保留;
33
+ * - fn → undefined:禁止一切新入队,abort 全部在途上传、清空上传状态并注销插件,
34
+ * 宿主即使忽略 abort,stale 结果也在库内丢弃、绝不写入;
35
+ * - fn1 → fn2:仅未来请求使用新 handler,在途 uploadId/signal 稳定;
36
+ * - 移除后再次添加在同一 session 上重新安装(可重启)。
37
+ */
38
+ configurePictureUpload(handler: PictureUploadHandler | undefined): void;
39
+ /**
40
+ * 宿主引用 installer(任务 7.2)。仅供 NoteEditor 内部控件消费:7.1 之前
41
+ * EditorSession 不公开,此访问器也不构成公开 API;三回调全无(或已全部移除)时
42
+ * 为 undefined,控件据此不挂载候选/激活/解析界面。
43
+ */
44
+ get hostReferences(): HostReferenceInstaller | undefined;
45
+ /**
46
+ * 内部宿主引用能力配置(任务 7.2):仅 NoteEditor 在同 key 已提交 callback 变化时
47
+ * 调用,不属于 7.1 之前的公开面。callback 不是 initial-only 输入:
48
+ * - 全无 → 任一:只增安装(候选触发/解析/激活即刻可用),不重建 editor,
49
+ * doc/selection/history/baseline 全部保留;
50
+ * - 任一 → 全无:abort 全部在途候选/解析/激活并注销,宿主即使忽略 abort,stale
51
+ * 结果也在核心内丢弃、绝不写入;
52
+ * - 纯 fn → fn(candidates/activate/resolve 三个 presence 全部不变):仅未来请求
53
+ * 使用新 handler,在途候选/解析/激活全部稳定,installer 不重建、不打断;
54
+ * - 任一 presence 变化(含 candidates/resolve 单独增删):保守重建 installer,
55
+ * abort 全部在途请求并重新扫描合法 doc。原因不止 activate 决定 install 期捕获的
56
+ * readonly hasActivate:已 settle 的 missing/resolved 条目与在途请求都绑定旧
57
+ * 能力——不重建则 resolve none→fn 时既有引用永久 missing、fn→none 时旧 pending
58
+ * 仍落地 resolved,candidates fn→none 时旧 pending 仍可 ready/插入。重建后
59
+ * 闭包 wrapper 按新字段受控 empty/missing 或调新回调,既有引用即刻按新能力
60
+ * 重新解析/呈现;文档内容、selection、history、baseline 均不受影响。
61
+ */
62
+ configureHostReferences(options: HostReferenceCapability): void;
63
+ subscribe(listener: Listener): () => void;
64
+ undo(): boolean;
65
+ redo(): boolean;
66
+ save(): Promise<NoteSaveResult | undefined>;
67
+ destroy(): void;
68
+ }
69
+ export declare function createEditorSession(options: EditorSessionOptions): EditorSession;
70
+ export {};
71
+ //# sourceMappingURL=session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAMrC,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAErF,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACnF,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAC/B,CAAC,CAAA;AAEF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAA;AAc1B;;;GAGG;AACH,qBAAa,aAAa;;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBA4BX,OAAO,EAAE,oBAAoB;IA6DzC,IAAI,KAAK,IAAI,kBAAkB,CAO9B;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,sBAAsB,GAAG,SAAS,CAEtD;IAeD;;;;;;;;;OASG;IACH,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI;IAavE;;;;OAIG;IACH,IAAI,cAAc,IAAI,sBAAsB,GAAG,SAAS,CAEvD;IA4BD;;;;;;;;;;;;;;;;OAgBG;IACH,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IA8B/D,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAKzC,IAAI,IAAI,OAAO;IAIf,IAAI,IAAI,OAAO;IAIf,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAyC3C,OAAO,IAAI,IAAI;CAkFhB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * React key 必须区分类型和值,尤其是 JavaScript 的 -0 与 0。非有限数字没有稳定的
3
+ * 会话语义,因此在渲染前硬失败而非静默碰撞。
4
+ */
5
+ export declare function encodeNoteEditorSessionKey(documentId: string, loadKey: string | number): string;
6
+ //# sourceMappingURL=sessionKey.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sessionKey.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/sessionKey.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAM/F"}
@@ -0,0 +1,143 @@
1
+ import { HnnDocument } from '../hnn/codec';
2
+ /** 宿主必须以 documentId 与 baseRevision 实施 CAS;中止只隔离库内状态。 */
3
+ export type NoteSaveContext = Readonly<{
4
+ documentId: string;
5
+ baseRevision?: string;
6
+ signal: AbortSignal;
7
+ }>;
8
+ export type NoteSaveResult = Readonly<{
9
+ kind: "saved";
10
+ revision?: string;
11
+ }> | Readonly<{
12
+ kind: "conflict";
13
+ }>;
14
+ export type NoteSave = (snapshot: HnnDocument, context: NoteSaveContext) => Promise<NoteSaveResult>;
15
+ export type InitialLoadErrorContext = Readonly<{
16
+ documentId: string;
17
+ loadKey: string | number;
18
+ }>;
19
+ /** 初始 HNN 严格校验失败时通知候选会话;不会替换仍在运行的旧会话。 */
20
+ export type InitialLoadErrorHandler = (error: unknown, context: InitialLoadErrorContext) => void;
21
+ export type EditorSessionStatus = "idle" | "saving" | "error" | "conflict";
22
+ export type EditorSessionState = Readonly<{
23
+ dirty: boolean;
24
+ status: EditorSessionStatus;
25
+ error?: unknown;
26
+ }>;
27
+ /** 这些属性刻意不包含 extensions、schema 或 history,HNN 文档结构始终由库封闭定义。 */
28
+ export type EditorSessionOptions = Readonly<{
29
+ documentId: string;
30
+ /** 仅接受有限 number;NaN 和正负 Infinity 在创建会话时会硬失败。 */
31
+ loadKey: string | number;
32
+ initialDocument: unknown;
33
+ initialRevision?: string;
34
+ onSave?: NoteSave;
35
+ onChange?: (snapshot: HnnDocument) => void;
36
+ /**
37
+ * 图片上传宿主回调(D8/任务 6.7)。提供时会话才安装上传插件(picker/粘贴/拖入
38
+ * 入口随之可用);缺省时会话没有任何上传能力。构造时捕获,会话销毁时全部中止,
39
+ * 陈旧结果在库内丢弃。
40
+ */
41
+ onPictureUpload?: PictureUploadHandler;
42
+ /**
43
+ * 宿主引用候选查询(D11/任务 7.2):mention/resource 的 `@`/`[[` 候选。缺省时无
44
+ * 候选入口;文档只持久 resourceId/name,候选与解析结果绝不写入 HNN。
45
+ */
46
+ onReferenceCandidates?: HostCandidateProvider;
47
+ /**
48
+ * 宿主引用激活(D11):点击/键盘激活 mention/resource/externalItem 或 hnmagic 链接
49
+ * 时调用,库绝不自行导航。缺省时引用节点不暴露 tab stop;hnmagic 仍禁止原生跳转。
50
+ */
51
+ onReferenceActivate?: HostReferenceActivate;
52
+ /**
53
+ * 宿主引用运行时解析(D11):loading/resolved/missing/error 只读映射供占位呈现;
54
+ * 缺省时一律受控 missing,不破坏文档。
55
+ */
56
+ onReferenceResolve?: HostReferenceResolve;
57
+ onInitialLoadError?: InitialLoadErrorHandler;
58
+ }>;
59
+ /**
60
+ * 图片上传宿主契约(D8)。库仅处理 picture 节点的图片文件;每个文件一个稳定
61
+ * `uploadId`,首次 `attempt` 为 1、retry 仅递增 `attempt`。宿主 MUST 按 `uploadId`
62
+ * 幂等,并返回可持久化的 http/https `src` 与可选 `alt`。
63
+ */
64
+ export type PictureUploadRequest = Readonly<{
65
+ uploadId: string;
66
+ attempt: number;
67
+ signal: AbortSignal;
68
+ }>;
69
+ export type PictureUploadResult = Readonly<{
70
+ src: string;
71
+ alt?: string;
72
+ }>;
73
+ export type PictureUploadHandler = (file: File, request: PictureUploadRequest) => Promise<PictureUploadResult>;
74
+ /** 上传临时态只存在于内存/DOM 桥,绝不进入 HNN。 */
75
+ export type PictureUploadItemStatus = "uploading" | "failed";
76
+ export type PictureUploadItem = Readonly<{
77
+ uploadId: string;
78
+ fileName: string;
79
+ attempt: number;
80
+ status: PictureUploadItemStatus;
81
+ error?: unknown;
82
+ }>;
83
+ export type PictureUploadState = Readonly<{
84
+ items: readonly PictureUploadItem[];
85
+ }>;
86
+ /**
87
+ * 宿主引用(mention/resource/externalItem)的候选、激活与解析契约(D11)。
88
+ * 文档内只保存 resourceId 与展示 name;真实内容由宿主 resolve 回调在运行时提供,
89
+ * 库绝不把解析结果写入文档。
90
+ */
91
+ export type HostReferenceKind = "mention" | "resource" | "externalItem";
92
+ export type HostCandidateKind = Extract<HostReferenceKind, "mention" | "resource">;
93
+ export type HostReferenceContext = Readonly<{
94
+ documentId: string;
95
+ signal: AbortSignal;
96
+ }>;
97
+ /** 候选只含最小资源标识与展示名,不允许 HTML/富内容。 */
98
+ export type HostReferenceCandidate = Readonly<{
99
+ resourceId: string;
100
+ name: string;
101
+ }>;
102
+ export type HostCandidateProvider = (kind: HostCandidateKind, query: string, context: HostReferenceContext) => readonly HostReferenceCandidate[] | Promise<readonly HostReferenceCandidate[]>;
103
+ /** kind 区分文档引用与魔法链接;链接保留原始 href,不虚构资源标识。 */
104
+ export type HostReferenceActivation = Readonly<{
105
+ kind: HostReferenceKind;
106
+ resourceId: string;
107
+ name: string;
108
+ }> | Readonly<{
109
+ kind: "hnmagic";
110
+ href: string;
111
+ }>;
112
+ export type HostReferenceActivate = (reference: HostReferenceActivation, context: HostReferenceContext) => void | Promise<void>;
113
+ export type HostReferenceLookup = Readonly<{
114
+ kind: HostReferenceKind;
115
+ resourceId: string;
116
+ }>;
117
+ /** 运行时最小展示信息:label 必填,description 可选;不接受 HTML。 */
118
+ export type HostReferenceResolution = Readonly<{
119
+ label: string;
120
+ description?: string;
121
+ }>;
122
+ export type HostReferenceResolve = (reference: HostReferenceLookup, context: HostReferenceContext) => HostReferenceResolution | null | Promise<HostReferenceResolution | null>;
123
+ export type HostCandidateStatus = "idle" | "loading" | "ready" | "empty" | "error";
124
+ export type HostCandidateState = Readonly<{
125
+ kind: HostCandidateKind | null;
126
+ query: string;
127
+ status: HostCandidateStatus;
128
+ items: readonly HostReferenceCandidate[];
129
+ error?: unknown;
130
+ }>;
131
+ export type HostReferenceResolutionStatus = "loading" | "resolved" | "missing" | "error";
132
+ export type HostReferenceResolutionEntry = Readonly<{
133
+ kind: HostReferenceKind;
134
+ resourceId: string;
135
+ status: HostReferenceResolutionStatus;
136
+ label?: string;
137
+ description?: string;
138
+ error?: unknown;
139
+ }>;
140
+ export type HostReferenceState = Readonly<{
141
+ entries: readonly HostReferenceResolutionEntry[];
142
+ }>;
143
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/editor/types.ts"],"names":[],"mappings":"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"}