@maqiuyao/dxf-viewer 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @maqiuyao/dxf-viewer
+
+基于 [three.js](https://threejs.org) 的 DXF 图纸查看与对比库，支持 2D/3D 渲染、字体解析、图纸 diff 对比。
+
+## 安装
+
+```bash
+npm install @maqiuyao/dxf-viewer three
+```
+
+> `three` 是 peerDependency，请自行安装（建议 `>=0.160`）。
+
+## 引入样式
+
+```ts
+import "@maqiuyao/dxf-viewer/style.css";
+```
+
+## 单图查看
+
+```ts
+import { Viewer2d } from "@maqiuyao/dxf-viewer";
+
+const viewer = new Viewer2d({
+  containerId: "dxf-container", // 页面中已存在的容器 div id
+  language: "cn",
+  enableLayoutBar: true,
+});
+
+// 加载 SHX/TTF 字体（URL 由使用方自行提供，见下方"字体资源"）
+await viewer.setFont(["/fonts/hztxt.shx", "/fonts/simplex.shx"]);
+
+await viewer.loadModel(
+  {
+    modelId: "demo",
+    name: "demo.dxf",
+    src: "/files/demo.dxf",
+    encoding: "utf-8",
+  },
+  (event) => console.log("progress:", event.loaded)
+);
+```
+
+## 双图对比
+
+```ts
+import { DxfCompareHelper } from "@maqiuyao/dxf-viewer";
+
+const helper = new DxfCompareHelper(
+  { containerId: "left-container", language: "cn" },
+  { containerId: "right-container", language: "cn" }
+);
+
+await helper.setFont(["/fonts/hztxt.shx", "/fonts/simplex.shx"]);
+
+await helper.compare(
+  { src: "/files/a.dxf", modelId: "a", encoding: "utf-8" },
+  { src: "/files/b.dxf", modelId: "b", encoding: "utf-8" },
+  undefined, // DxfCompareConfig，可选
+  (p) => console.log("progress:", p.loaded)
+);
+
+// 变动列表：helper.getChanges()，每项含 type(新增/删除/修改)、handle、box
+helper.enableSyncCamera(true); // 左右相机同步
+```
+
+对比结果会在左右两个视口上用**修订云线框 + 半透明填充**标出每处变动（新增绿 / 删除红 / 修改黄），框与内容间自动留隙。
+
+## 字体资源
+
+DXF 文本渲染依赖 SHX/TTF 字体文件，本包**不内置**字体（版权原因）。请从你的 AutoCAD 安装目录或公开字体包中获取 `hztxt.shx`、`simplex.shx`、`@extfont2.shx` 等，放到你自己站点的可访问路径，再传给 `viewer.setFont([...])`。
+
+## 编码说明
+
+多数现代 DXF 为 UTF-8；若图纸中文乱码，可尝试 `encoding: "gbk"` 或 `"gb18030"`。
+
+## 许可
+
+MIT

package/dist/assets/vite-project.css

@@ -0,0 +1 @@
+.x-container{user-select:none;-webkit-user-select:none;outline:none}.x-container canvas{display:block}