printbench 0.8.7 → 0.8.10

package/README.md

@@ -99,9 +99,10 @@ function onExported(payload: PrintBenchExportedPayload) {
 | `showGrid`        | `boolean`                                             | `true`    | 宿主默认是否显示地面网格。挂载时写入设置一次                                                          |
 | `gridAutoFit`     | `boolean`                                             | —         | 宿主默认网格是否随模型包围盒放大（设置默认 `true`）。挂载时若传入则写入一次；固定尺寸时请设 `false`                              |
 | `gridSizeMm`      | `{ x, y, z }`                                         | —         | 宿主默认固定网格尺寸（mm，边长取床面两轴 max，20 格）。挂载时写入一次；若未同时传 `gridAutoFit`，会自动设为固定尺寸（`gridAutoFit: false`） |
+| `useAuthorNormals` | `boolean`                                            | —         | 宿主默认是否用导入平滑法线做预览（设置默认关）。挂载时若传入则写入一次；预览模式无画布开关，由宿主配置；编辑模式仍可在设置里改 |
 | `diagnosisZIndex` | `number`                                              | `100`     | 诊断浮层 `z-index`。也可在外层设 CSS 变量 `--printbench-diagnosis-z`                                         |
 | `annotations`     | `Annotation[]` \| `AnnotationDocument` \| `string`     | —         | 模型批注（世界坐标 mm）。需同时打开 `features.annotations` 才能编辑；详见下方「批注」           |
-| `features`        | `{ numeric?, primitives?, split?, autoSplit?, drafts?, extras?, restore?, layout?, importUnit?, hideEmpty?, hideTour?, hideStatusBar?, hidePanelModeToggle?, hidePreviewLighting?, annotations?, annotationPanel?, … }` | 能力项默认 `false` | 进阶能力。缺省精简：左栏仅导入 / 零件 / 导出 / 快照。未开 `drafts` 时不读不写自动草稿。导入单位优先用文件声明，否则按包围盒尺寸推测 mm/cm/m 再换算到内部毫米；开 `importUnit` 时可再确认。`split` 为切面拆件；`autoSplit` 为「自动拆件」按钮（默认隐藏，需显式打开）。`restore` 为「复原到导入状态」按钮（默认隐藏，宿主需显式打开；完整工作台预设已开启）。`layout` 打开贴地 / 镜像 / 目标尺寸缩放 / 选面朝下与打印床体积。`annotations` 打开批注能力（画布标记、放置、prop/事件与 ref API；默认关闭，`PRINTBENCH_FULL_FEATURES` 也不含）。`annotationPanel` 控制右栏自带批注 Tab（依赖 `annotations`；省略时随 `annotations` 开启，设 `false` 可自建宿主 UI）。`hideEmpty` / `hideTour` / `hideStatusBar` / `hidePanelModeToggle` / `hidePreviewLighting` 为 `true` 时分别隐藏空画布提示、首次引导 Tour（可与 `extras` 同开）、底栏状态条、零件栏悬浮/通栏切换按钮、预览模式左上角灯光模式控件（默认显示）。 |
+| `features`        | `{ numeric?, primitives?, split?, autoSplit?, drafts?, extras?, restore?, layout?, importUnit?, hideEmpty?, hideTour?, hideStatusBar?, hidePanelModeToggle?, hidePreviewLighting?, hideViewCube?, annotations?, annotationPanel?, … }` | 能力项默认 `false` | 进阶能力。缺省精简：左栏仅导入 / 零件 / 导出 / 快照。未开 `drafts` 时不读不写自动草稿。导入单位优先用文件声明，否则按包围盒尺寸推测 mm/cm/m 再换算到内部毫米；开 `importUnit` 时可再确认。`split` 为切面拆件；`autoSplit` 为「自动拆件」按钮（默认隐藏，需显式打开）。`restore` 为「复原到导入状态」按钮（默认隐藏，宿主需显式打开；完整工作台预设已开启）。`layout` 打开贴地 / 镜像 / 目标尺寸缩放 / 选面朝下与打印床体积。`annotations` 打开批注能力（画布标记、放置、prop/事件与 ref API；默认关闭，`PRINTBENCH_FULL_FEATURES` 也不含）。`annotationPanel` 控制右栏自带批注 Tab（依赖 `annotations`；省略时随 `annotations` 开启，设 `false` 可自建宿主 UI）。`hideEmpty` / `hideTour` / `hideStatusBar` / `hidePanelModeToggle` / `hidePreviewLighting` / `hideViewCube` 为 `true` 时分别隐藏空画布提示、首次引导 Tour（可与 `extras` 同开）、底栏状态条、零件栏悬浮/通栏切换按钮、预览模式左上角灯光模式控件、画布左下角方向立方体（默认显示）。 |
 
 
 嵌入预览示例（宿主列表 + 色板 + 自定义导出 + 按轴/最长边缩放）：
@@ -175,7 +176,7 @@ async function upload() {
 </template>
 ```
 
-`mode="preview"` 时插件不显示导出 / 快照按钮。宿主用 `ref.exportFile()` / `ref.exportSnapshot()` 只要文件：`customExport` 为 true 时不本地下载、不 POST，返回 `blob` 后由宿主保存或上传。工作台左栏导出与快照仍可用 `uploadUrl` 走插件上传。预览画布左上角默认显示灯光模式（与设置中同一套：`neutral` 标准照明、`studio` 摄影棚、`ibl` 环境光照、`sandbox` 展台照明、`headlamp` 跟随头灯）以及「原始法线」开关；宿主可设 `:features="{ hidePreviewLighting: true }"` 隐藏该控件。`sandbox`（展台照明）为蓝灰全景背景 + IBL，低仰角暖主光与冷轮廓光，环境光只做补光，适合验收预览。「原始法线」（设置项 `useAuthorNormals`，默认关闭）与灯光模式独立：开启时优先用导入的平滑法线做预览，无可用法线时静默回退重算，不影响打印。
+`mode="preview"` 时插件不显示导出 / 快照按钮。宿主用 `ref.exportFile()` / `ref.exportSnapshot()` 只要文件：`customExport` 为 true 时不本地下载、不 POST，返回 `blob` 后由宿主保存或上传。工作台左栏导出与快照仍可用 `uploadUrl` 走插件上传。预览画布左上角默认显示灯光模式（与设置中同一套：`neutral` 标准照明、`studio` 摄影棚、`ibl` 环境光照、`sandbox` 展台照明、`headlamp` 跟随头灯）；宿主可设 `:features="{ hidePreviewLighting: true }"` 隐藏该控件。`sandbox`（展台照明）为蓝灰全景背景 + IBL，低仰角暖主光与冷轮廓光，环境光只做补光，适合验收预览。「原始法线」（设置项 `useAuthorNormals`，默认关闭）与灯光模式独立：预览模式无画布开关，由宿主 prop `useAuthorNormals` 配置；开启时优先用导入的平滑法线做预览，无可用法线时静默回退重算，不影响打印。编辑模式仍可在设置中切换。
 
 `exportFile` 的 `longestEdgeMm` 与导出对话框「目标边长」一致：按内部毫米将参考边（默认最长边，或 `scaleAxis` 指定的 X/Y/Z）缩到该值后再换算 `unit` 写出。省略则不缩放。默认 `scaleBasis: 'model'`（按整模 AABB 算统一比例）；`partIds` 只过滤写出内容，不改变比例，分件后仍可组装。`scaleBasis: 'exportSet'` 则按写出集合自身 AABB 缩放。
 
@@ -199,7 +200,7 @@ async function upload() {
 | `part-colors-change` | `Record<string, string>`                          | 工作台内改色时抛出（嵌入预览以 `partColors` 为准）                   |
 | `annotations-change` | `{ schema, version, unit, coordinateSpace, fileName?, generatedAt, annotations, reason }` | 批注新增 / 修改 / 删除时抛出（`reason`: `add` \| `update` \| `remove`）。仅在 `features.annotations` 开启时触发 |
 | `annotation-select`  | `string \| null`                                      | 当前选中批注变化（列表、画布标记或 ref API）；关闭批注能力时不触发 |
-| `annotation-mode-change` | `'off' \| 'place'`                                 | 放置模式进出（含 Esc 取消与放置成功）；仅在 `features.annotations` 开启时触发 |
+| `annotation-mode-change` | `'off' \| 'place'`                                 | 放置模式进出（Esc 或再次切换按钮 / `setAnnotationMode('off')`）；新建成功不退出；仅在 `features.annotations` 开启时触发 |
 | `annotation-click`   | `string`                                              | 点击画布标注点（随后仍会选中并飞到锚点） |
 | `annotation-hover`   | `string \| null`                                      | 鼠标经过画布标注点；离开全部标记时为 `null` |
 
@@ -215,14 +216,14 @@ async function upload() {
 | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `exportFile(options?)` | 不打开插件对话框。`action` / `format` / `unit` 同上；`longestEdgeMm` + `scaleAxis?` 等比缩放；`scaleBasis`: `'model'`（默认，整模比例）\| `'exportSet'`；`partIds` 只导出指定零件；`groundCenter: true` 导出时贴地且床面居中于原点（不改工作台）；坐标帧跟随当前 `upAxis`（payload 含 `axis`）；`silent: true` 跳过确认。成功返回与 `exported` 相同的 payload。 |
 | `exportSnapshot(options?)` | 按当前视角截取模型图（不含网格、手柄、切面）。`action`: `'download'` \| `'upload'`；`format`: `'png'`（默认）\| `'jpeg'`；`quality` 仅 JPEG。成功返回与 `snapshot` 相同的 payload。`customExport` 时不本地下载、不 POST。 |
-| `autoSplit(options?)` | 多零件接触面自动装配（≥2 件）。检测接触后一端保留凸起、一端挖槽，再加卡扣。`connector`: `'ballSnap'` \| `'sphere'` \| `'square'`（默认 `ballSnap` 爪扣）；`connectorSize` 可选；`silent: true` 时不弹修复确认，未封闭则返回 `{ ok: false, needsRepair: true, repairPartNames }`。成功 `{ ok: true }`。 |
+| `autoSplit(options?)` | 多零件接触面自动装配（≥2 件）。检测接触后一端保留凸起、一端挖槽，再加卡扣。`connector`: `'none'` \| `'ballSnap'` \| `'sphere'` \| `'square'`（默认 `ballSnap` 爪扣；`'none'` 仅凹凸契合、不加卡扣）；`connectorSize` 可选；`silent: true` 时不弹修复确认，未封闭则返回 `{ ok: false, needsRepair: true, repairPartNames }`。成功 `{ ok: true }`。 |
 | `getPartBounds()` | 同步返回与 `@parts` 相同结构的零件列表（含 `initialSize` / `size`）。无模型时为 `[]`。 |
 | `getBBox()` | 同步返回与 `@bbox` 相同结构的整模载荷（含 `parts` / `axis`）。尚无诊断包围盒时为 `null`。 |
 | `getAnnotations()` | 返回 `AnnotationDocument`（`schema: 'printbench.annotations'`）。功能关闭时仍会规范化 `annotations` prop 后返回，便于宿主随时开启。 |
 | `exportAnnotations()` | 上面文档的格式化 JSON 字符串。 |
 | `setAnnotations(input)` | 用数组 / 文档 / JSON 字符串替换批注列表。 |
 | `addAnnotation(input)` | 以编程方式添加一条批注，返回新 `Annotation`；功能未开启时返回 `null`。 |
-| `setAnnotationMode(mode)` | `'off'` \| `'place'`：进入 / 退出画布放置模式（下一次点模型表面会钉一条批注）。 |
+| `setAnnotationMode(mode)` | `'off'` \| `'place'`：进入 / 退出画布放置模式。`place` 下可连续点模型钉批注（点到已有标记则选中且不新建）；新建成功不退出，需 Esc 或再次设为 `'off'`。 |
 | `getAnnotationMode()` | 当前放置模式。 |
 | `selectAnnotation(id)` | 选中批注，或传 `null` 清空；不飞相机。 |
 | `getSelectedAnnotationId()` | 当前选中批注 id。 |
@@ -264,7 +265,7 @@ const notes = ref<PrintBenchAnnotationsPayload | undefined>()
 </template>
 ```
 
-用户可在面板内点「放置批注」→ 点模型表面标注；支持级别、标题、说明与已解决标记。也可随时用 `ref` 读写：
+用户可在面板内点「放置批注」进入连续放置（再点按钮或 Esc 退出）；点模型表面可连续钉批注，点到已有标记会选中而非新建。支持级别、标题、说明与已解决标记。也可随时用 `ref` 读写：
 
 ```ts
 import type { PrintBenchExpose } from 'printbench'
@@ -347,7 +348,7 @@ function removeSelected() {
 
     <aside>
       <button type="button" @click="togglePlace">
-        {{ placing ? '点击模型放置…（Esc 取消）' : '放置批注' }}
+        {{ placing ? '放置中…（再点退出 / Esc）' : '放置批注' }}
       </button>
       <p v-if="hoveredId">悬停：{{ hoveredId }}</p>
 
@@ -379,8 +380,9 @@ function removeSelected() {
 ```
 
 要点：
-- `@annotation-mode-change` 同步放置态（含 Esc 取消、放置成功后回到 `off`）
+- `@annotation-mode-change` 同步放置态；**新建成功不退出** `place`，仅 Esc / 再点按钮 / `setAnnotationMode('off')` 退出
 - `@annotation-click` / `@annotation-hover` 响应画布标记手势；`@annotation-select` 覆盖列表与 API 选中
+- 放置模式下点到已有标记：选中并飞行，**不新建、不退出放置**；点空白模型表面才钉新批注
 - `annotationPanel: false` 时放置成功**不会**弹出右栏诊断浮层
 
 #### 数据格式
@@ -463,13 +465,13 @@ function removeSelected() {
 | Ctrl+S          | 保存自动草稿（需打开 `features.drafts`） |
 | 1 / 2 / 3       | 移动 / 旋转 / 缩放                  |
 | P               | 切换工作台观察预览                     |
-| Esc             | 取消手柄、预览、测量、选面朝下              |
+| Esc             | 取消批注放置、手柄、预览、测量、选面朝下     |
 | F               | 按模型自适应视角                      |
 | Shift           | 变换吸附                          |
 | Ctrl            | 多选、框选                         |
 
 
-草稿保存在浏览器本地，仅当 `features.drafts` 为 true 时读写并提示恢复。设置含**坐标系**（默认 **Z-up**，可切回 Y-up；切换前确认并对已加载模型做坐标重定向）、默认导入单位、默认导出格式、场景光照开关、灯光模式（标准照明 / 摄影棚 / 环境光照 / 展台照明 / 跟随头灯，默认标准照明）、原始法线预览开关（默认关）、最小壁厚、打印床尺寸（默认 220×220×250 mm，Z-up 时 Z 为高度）。地面网格默认开启，初始 200 mm / 20 格并随模型包围盒放大（`showGrid` / `gridAutoFit` 默认 `true`）；勾选「自定义网格尺寸」或宿主传 `gridSizeMm` 后可填 XYZ（边长取床面两轴 max）且不再随模型放大。打印床线框默认隐藏，可在布局区或设置中打开；宿主可用 props `upAxis` / `bedSizeMm` / `showBedVolume` / `showGrid` / `gridAutoFit` / `gridSizeMm` 提供初始默认值（只写入一次，不锁定控件）。旧版无 `upAxis` 的本地设置按 **Y-up** 兼容，避免升级后草稿静默错位。
+草稿保存在浏览器本地，仅当 `features.drafts` 为 true 时读写并提示恢复。设置含**坐标系**（默认 **Z-up**，可切回 Y-up；切换前确认并对已加载模型做坐标重定向）、默认导入单位、默认导出格式、场景光照开关、灯光模式（标准照明 / 摄影棚 / 环境光照 / 展台照明 / 跟随头灯，默认标准照明）、原始法线预览开关（默认关；预览模式由宿主 `useAuthorNormals` 配置）、最小壁厚、打印床尺寸（默认 220×220×250 mm，Z-up 时 Z 为高度）。地面网格默认开启，初始 200 mm / 20 格并随模型包围盒放大（`showGrid` / `gridAutoFit` 默认 `true`）；勾选「自定义网格尺寸」或宿主传 `gridSizeMm` 后可填 XYZ（边长取床面两轴 max）且不再随模型放大。打印床线框默认隐藏，可在布局区或设置中打开；宿主可用 props `upAxis` / `bedSizeMm` / `showBedVolume` / `showGrid` / `gridAutoFit` / `gridSizeMm` / `useAuthorNormals` 提供初始默认值（只写入一次，不锁定控件）。旧版无 `upAxis` 的本地设置按 **Y-up** 兼容，避免升级后草稿静默错位。
 
 开启 `features.layout` 后：贴地将零件落到 up=0；镜像相对包围盒中心；「缩放到」按最长边或指定轴等比缩放并自动贴地；「选面朝下」点击表面使该面朝下并贴地。超出打印床时底栏提示；显示床线框时超界会变为警示色。
 

package/dist/chunks/{3mf-CH9wGJ51.js → 3mf-CZnVuIIf.js}

@@ -1,5 +1,5 @@
 import j from "jszip";
-import { h as w, r as R } from "./index-BHL8_oaU.js";
+import { h as w, r as R } from "./index-C7dO80Ia.js";
 function p(s, l) {
   return s.match(new RegExp(`\\b${l}\\s*=\\s*"([^"]*)"`, "i"))?.[1];
 }

package/dist/chunks/{glb-XZ3fyf6P.js → glb-DOvphZz-.js}

@@ -1,6 +1,6 @@
 import { Group as w, Mesh as l, MeshStandardMaterial as u, DoubleSide as h, Color as c } from "three";
 import { GLTFExporter as p } from "three/examples/jsm/exporters/GLTFExporter.js";
-import { b as d } from "./index-BHL8_oaU.js";
+import { b as d } from "./index-C7dO80Ia.js";
 async function G(r, e, n) {
   const t = new w();
   t.name = "PrintBench", r.forEach((f, o) => {