@hamster-note/notes 3.2.0 → 3.4.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 (58) hide show
  1. package/README.md +14 -2
  2. package/dist/index.cjs +101 -85
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.js +14693 -13236
  5. package/dist/index.js.map +1 -1
  6. package/dist/lib/editor/NoteDocumentProvider.d.ts +1 -1
  7. package/dist/lib/editor/NoteDocumentProvider.d.ts.map +1 -1
  8. package/dist/lib/editor/NoteEditor.d.ts +2 -8
  9. package/dist/lib/editor/NoteEditor.d.ts.map +1 -1
  10. package/dist/lib/editor/PictureUploadDialog.d.ts +10 -0
  11. package/dist/lib/editor/PictureUploadDialog.d.ts.map +1 -0
  12. package/dist/lib/editor/ViewToolbar.d.ts +28 -0
  13. package/dist/lib/editor/ViewToolbar.d.ts.map +1 -0
  14. package/dist/lib/editor/blockMenu.d.ts +3 -4
  15. package/dist/lib/editor/blockMenu.d.ts.map +1 -1
  16. package/dist/lib/editor/blockReorder.d.ts +4 -3
  17. package/dist/lib/editor/blockReorder.d.ts.map +1 -1
  18. package/dist/lib/editor/documentSession.d.ts +12 -0
  19. package/dist/lib/editor/documentSession.d.ts.map +1 -1
  20. package/dist/lib/editor/documentTypes.d.ts +52 -1
  21. package/dist/lib/editor/documentTypes.d.ts.map +1 -1
  22. package/dist/lib/editor/interactionToolbar.d.ts.map +1 -1
  23. package/dist/lib/editor/linkEditing.d.ts +21 -0
  24. package/dist/lib/editor/linkEditing.d.ts.map +1 -0
  25. package/dist/lib/editor/listCommands.d.ts +39 -0
  26. package/dist/lib/editor/listCommands.d.ts.map +1 -0
  27. package/dist/lib/editor/pictureResolution.d.ts +21 -0
  28. package/dist/lib/editor/pictureResolution.d.ts.map +1 -0
  29. package/dist/lib/editor/pictureUpload.d.ts +4 -0
  30. package/dist/lib/editor/pictureUpload.d.ts.map +1 -1
  31. package/dist/lib/editor/session.d.ts +12 -1
  32. package/dist/lib/editor/session.d.ts.map +1 -1
  33. package/dist/lib/editor/types.d.ts +12 -1
  34. package/dist/lib/editor/types.d.ts.map +1 -1
  35. package/dist/lib/hnn/budgetedTransaction.d.ts.map +1 -1
  36. package/dist/lib/hnn/codec.d.ts.map +1 -1
  37. package/dist/lib/hnn/compositionDeletion.d.ts +10 -0
  38. package/dist/lib/hnn/compositionDeletion.d.ts.map +1 -0
  39. package/dist/lib/hnn/extensions.d.ts +7 -0
  40. package/dist/lib/hnn/extensions.d.ts.map +1 -1
  41. package/dist/lib/hnn/listInteractions.d.ts +6 -0
  42. package/dist/lib/hnn/listInteractions.d.ts.map +1 -0
  43. package/dist/lib/hnn/listNumbering.d.ts +9 -0
  44. package/dist/lib/hnn/listNumbering.d.ts.map +1 -0
  45. package/dist/lib/hnn/menuPopover.d.ts +4 -0
  46. package/dist/lib/hnn/menuPopover.d.ts.map +1 -1
  47. package/dist/lib/hnn/quoteInteractions.d.ts +3 -0
  48. package/dist/lib/hnn/quoteInteractions.d.ts.map +1 -0
  49. package/dist/lib/hnn/transactionPermission.d.ts +4 -0
  50. package/dist/lib/hnn/transactionPermission.d.ts.map +1 -0
  51. package/dist/lib/hnn/urlPolicy.d.ts +2 -0
  52. package/dist/lib/hnn/urlPolicy.d.ts.map +1 -1
  53. package/dist/lib/index.d.ts +2 -2
  54. package/dist/lib/index.d.ts.map +1 -1
  55. package/dist/styles.css +1 -1
  56. package/package.json +10 -6
  57. package/dist/lib/test-setup.d.ts +0 -1
  58. package/dist/lib/test-setup.d.ts.map +0 -1
package/README.md CHANGED
@@ -35,6 +35,12 @@ yarn build
35
35
 
36
36
  ## 公共 API
37
37
 
38
+ ### 分栏工具栏与文件入口(painting 0.8.4)
39
+
40
+ `NoteEditorView` 新增可选的分栏工具栏输入:`files`、`currentFileKey`、`paneId`、`busy`、`onSelectFile`、`onRequestRemove` 与 `layout`。文件按钮位于撤销/重做之后;库只发起带 `paneId` 与 `requestId` 的异步请求,当前项与列表始终由宿主快照决定,移除最后一项被禁止。未传 `files` 时保留旧工具且不显示文件入口。
41
+
42
+ `layout` 为 `{ edge: 'top' | 'bottom', insets: { top, bottom, left, right }, headerContentInset, bounds? }`。提供后使用 painting 0.8.4 的 `ToolbarShell` 在所属栏边缘渲染固定工具栏,`top`/`bottom` 安全区各消费一次(`headerContentInset` 与 `top` 取最大值,不相加),并通过占用空间回调为正文预留高度;仅切换 `edge` 不重建文档或会话。左右分屏两栏均传 `bottom`,上下分屏上栏传 `top`、下栏传 `bottom`。构建时期使用 `vendor/hamster-note-painting-0.8.4-57a82fb.tgz`,发布依赖待 painting 0.8.4 上架后统一。
43
+
38
44
  ### 3.1.2 宿主引用失效与图片上传
39
45
 
40
46
  `NoteDocumentProvider` 新增可选 `onPictureUpload?: PictureUploadHandler`。提供回调后,各 View 的图片选择、图片粘贴、外部拖入与失败重试/取消均可用;内部拖动不会重复上传。无回调保留原有行为。有到有的回调替换只影响未来 attempt;移除回调会 abort 并清理全部占位,再次提供无需重挂 Provider。
@@ -288,13 +294,19 @@ const exported = exportMarkdown(hnnDocument)
288
294
  onPictureUpload={async (file, { uploadId, attempt, signal }) => {
289
295
  // 宿主必须按 uploadId 幂等;retry 时 uploadId 不变、attempt 递增
290
296
  const uploaded = await host.uploadImage(file, { uploadId, attempt, signal })
291
- return { src: uploaded.httpsUrl, alt: uploaded.alt } // src 必须是 http/https
297
+ return { src: uploaded.httpsUrl, alt: uploaded.alt }
298
+ }}
299
+ onPictureResolve={async (src, { signal, documentId, loadKey }) => {
300
+ const resolved = await host.resolveImage(src, { signal, documentId, loadKey })
301
+ return { url: resolved.objectUrl, dispose: resolved.dispose }
292
302
  }}
293
303
  />
294
304
  ```
295
305
 
296
306
  - 每个文件一个稳定 `uploadId`,首次 `attempt` 为 1,retry 只递增 `attempt`;宿主应据此去重。
297
- - 成功时宿主返回可持久化的 `http`/`https` `src` 与可选 `alt`;库仅以一个 transaction 写入图片。
307
+ - 上传结果允许安全 HTTP(S) 或 `hamster_note_data/images/<32位小写md5>.<png|jpg|webp>` 托管路径;库仅以一个 transaction 写入图片。
308
+ - 托管路径必须由 `onPictureResolve` 解析;回调结果只接受 HTTP(S)/blob 运行时地址,替换、取消和销毁会释放对应资源,解析 URL 不写回正文。
309
+ - 单文件上限为 100 MiB,且校验真实 PNG/JPEG/WebP 文件头;picker、粘贴、拖放和重试使用同一规则。
298
310
  - 上传临时态、文件、`uploadId`、`attempt` 均为内存/DOM 桥状态,**绝不进入 HNN**;失败可重试或取消。
299
311
 
300
312
  ### 宿主引用(mention / resource / externalItem)