@hamster-note/notes 3.3.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 (35) hide show
  1. package/README.md +8 -2
  2. package/dist/index.cjs +81 -81
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.js +11580 -11217
  5. package/dist/index.js.map +1 -1
  6. package/dist/lib/editor/NoteDocumentProvider.d.ts.map +1 -1
  7. package/dist/lib/editor/NoteEditor.d.ts +2 -8
  8. package/dist/lib/editor/NoteEditor.d.ts.map +1 -1
  9. package/dist/lib/editor/PictureUploadDialog.d.ts +10 -0
  10. package/dist/lib/editor/PictureUploadDialog.d.ts.map +1 -0
  11. package/dist/lib/editor/blockMenu.d.ts +2 -4
  12. package/dist/lib/editor/blockMenu.d.ts.map +1 -1
  13. package/dist/lib/editor/documentSession.d.ts +12 -0
  14. package/dist/lib/editor/documentSession.d.ts.map +1 -1
  15. package/dist/lib/editor/documentTypes.d.ts +2 -1
  16. package/dist/lib/editor/documentTypes.d.ts.map +1 -1
  17. package/dist/lib/editor/pictureResolution.d.ts +21 -0
  18. package/dist/lib/editor/pictureResolution.d.ts.map +1 -0
  19. package/dist/lib/editor/pictureUpload.d.ts +4 -0
  20. package/dist/lib/editor/pictureUpload.d.ts.map +1 -1
  21. package/dist/lib/editor/session.d.ts +12 -1
  22. package/dist/lib/editor/session.d.ts.map +1 -1
  23. package/dist/lib/editor/types.d.ts +12 -1
  24. package/dist/lib/editor/types.d.ts.map +1 -1
  25. package/dist/lib/hnn/codec.d.ts.map +1 -1
  26. package/dist/lib/hnn/extensions.d.ts +7 -0
  27. package/dist/lib/hnn/extensions.d.ts.map +1 -1
  28. package/dist/lib/hnn/menuPopover.d.ts +4 -0
  29. package/dist/lib/hnn/menuPopover.d.ts.map +1 -1
  30. package/dist/lib/hnn/urlPolicy.d.ts +2 -0
  31. package/dist/lib/hnn/urlPolicy.d.ts.map +1 -1
  32. package/dist/lib/index.d.ts +1 -1
  33. package/dist/lib/index.d.ts.map +1 -1
  34. package/dist/styles.css +1 -1
  35. package/package.json +1 -1
package/README.md CHANGED
@@ -294,13 +294,19 @@ const exported = exportMarkdown(hnnDocument)
294
294
  onPictureUpload={async (file, { uploadId, attempt, signal }) => {
295
295
  // 宿主必须按 uploadId 幂等;retry 时 uploadId 不变、attempt 递增
296
296
  const uploaded = await host.uploadImage(file, { uploadId, attempt, signal })
297
- 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 }
298
302
  }}
299
303
  />
300
304
  ```
301
305
 
302
306
  - 每个文件一个稳定 `uploadId`,首次 `attempt` 为 1,retry 只递增 `attempt`;宿主应据此去重。
303
- - 成功时宿主返回可持久化的 `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、粘贴、拖放和重试使用同一规则。
304
310
  - 上传临时态、文件、`uploadId`、`attempt` 均为内存/DOM 桥状态,**绝不进入 HNN**;失败可重试或取消。
305
311
 
306
312
  ### 宿主引用(mention / resource / externalItem)