printbench 0.8.2 → 0.8.3

package/README.md

@@ -94,6 +94,9 @@ function onExported(payload: PrintBenchExportedPayload) {
 | `partColors`      | `Record<string, string>`                              | —         | 受控零件色，`#RRGGBB`，key 为零件 `id`                                                                         |
 | `bedSizeMm`       | `{ x, y, z }`                                         | —         | 宿主默认打印床体积（mm：X/Z 床面，Y 高度）。挂载时写入设置一次，之后仍可在布局区/设置中修改                                   |
 | `showBedVolume`   | `boolean`                                             | —         | 宿主默认是否显示打印床线框。挂载时写入设置一次，之后仍可开关（未传时默认隐藏）                                            |
+| `showGrid`        | `boolean`                                             | `true`    | 宿主默认是否显示地面网格。挂载时写入设置一次                                                          |
+| `gridAutoFit`     | `boolean`                                             | —         | 宿主默认网格是否随模型包围盒放大（设置默认 `true`）。挂载时若传入则写入一次；固定尺寸时请设 `false`                              |
+| `gridSizeMm`      | `{ x, y, z }`                                         | —         | 宿主默认固定网格尺寸（mm，边长取 max(X,Z)，20 格）。挂载时写入一次；若未同时传 `gridAutoFit`，会自动设为固定尺寸（`gridAutoFit: false`） |
 | `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?, … }` | 能力项默认 `false` | 进阶能力。缺省精简：左栏仅导入 / 零件 / 导出 / 快照。未开 `drafts` 时不读不写自动草稿。导入单位优先用文件声明，否则按包围盒尺寸推测 mm/cm/m 再换算到内部毫米；开 `importUnit` 时可再确认。`split` 为切面拆件；`autoSplit` 为「自动拆件」按钮（默认隐藏，需显式打开）。`restore` 为「复原到导入状态」按钮（默认隐藏，宿主需显式打开；完整工作台预设已开启）。`layout` 打开贴地 / 镜像 / 目标尺寸缩放 / 选面朝下与打印床体积。`annotations` 打开模型批注（默认关闭，`PRINTBENCH_FULL_FEATURES` 也不含该项）。`hideEmpty` / `hideTour` / `hideStatusBar` / `hidePanelModeToggle` / `hidePreviewLighting` 为 `true` 时分别隐藏空画布提示、首次引导 Tour（可与 `extras` 同开）、底栏状态条、零件栏悬浮/通栏切换按钮、预览模式左上角灯光模式控件（默认显示）。 |
@@ -314,7 +317,7 @@ JSON 结构：
 | Ctrl            | 多选、框选                         |
 
 
-草稿保存在浏览器本地，仅当 `features.drafts` 为 true 时读写并提示恢复。设置含默认导入单位、默认导出格式、网格/场景光照开关、灯光模式（标准照明 / 摄影棚 / 环境光照 / 跟随头灯，默认标准照明）、最小壁厚、打印床尺寸（默认 220×220×250 mm，Y 为高度）。打印床线框默认隐藏，可在布局区或设置中打开；宿主可用 props `bedSizeMm` / `showBedVolume` 提供初始默认值（只写入一次，不锁定控件）。
+草稿保存在浏览器本地，仅当 `features.drafts` 为 true 时读写并提示恢复。设置含默认导入单位、默认导出格式、场景光照开关、灯光模式（标准照明 / 摄影棚 / 环境光照 / 跟随头灯，默认标准照明）、最小壁厚、打印床尺寸（默认 220×220×250 mm，Y 为高度）。地面网格默认开启，初始 200 mm / 20 格并随模型包围盒放大（`showGrid` / `gridAutoFit` 默认 `true`）；勾选「自定义网格尺寸」或宿主传 `gridSizeMm` 后可填 XYZ（边长取 max(X,Z)）且不再随模型放大。打印床线框默认隐藏，可在布局区或设置中打开；宿主可用 props `bedSizeMm` / `showBedVolume` / `showGrid` / `gridAutoFit` / `gridSizeMm` 提供初始默认值（只写入一次，不锁定控件）。
 
 开启 `features.layout` 后：贴地将零件落到 Y=0；镜像相对包围盒中心；「缩放到」按最长边或指定轴等比缩放并自动贴地；「选面朝下」点击表面使该面朝下并贴地。超出打印床时底栏提示；显示床线框时超界会变为警示色。
 

package/dist/chunks/{3mf-BIDwgB-x.js → 3mf-ECHCUgKd.js}

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

package/dist/chunks/{glb-CFD6zP-z.js → glb-CHKLJs5K.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-Cwlaqcgp.js";
+import { b as d } from "./index-taUrTXAq.js";
 async function G(r, e, n) {
   const t = new w();
   t.name = "PrintBench", r.forEach((f, o) => {