mini-three-adapter 0.0.0-stage → 0.1.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 (73) hide show
  1. package/AGENTS.md +85 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/build/rollup.d.ts +8 -0
  5. package/dist/build/rollup.js +393 -0
  6. package/dist/build/rollup.js.map +1 -0
  7. package/dist/build/vite.d.ts +15 -0
  8. package/dist/build/vite.js +395 -0
  9. package/dist/build/vite.js.map +1 -0
  10. package/dist/chunk-34RWHAW4.js +128 -0
  11. package/dist/chunk-34RWHAW4.js.map +1 -0
  12. package/dist/chunk-3UGQWFH3.js +1246 -0
  13. package/dist/chunk-3UGQWFH3.js.map +1 -0
  14. package/dist/chunk-4UEBRAK6.js +711 -0
  15. package/dist/chunk-4UEBRAK6.js.map +1 -0
  16. package/dist/chunk-LB3WL24R.js +91 -0
  17. package/dist/chunk-LB3WL24R.js.map +1 -0
  18. package/dist/chunk-MTBMOFAL.js +132 -0
  19. package/dist/chunk-MTBMOFAL.js.map +1 -0
  20. package/dist/chunk-QYQQ5J6E.js +3 -0
  21. package/dist/chunk-QYQQ5J6E.js.map +1 -0
  22. package/dist/chunk-V6TY7KAL.js +7 -0
  23. package/dist/chunk-V6TY7KAL.js.map +1 -0
  24. package/dist/chunk-WLRQDTSZ.js +145 -0
  25. package/dist/chunk-WLRQDTSZ.js.map +1 -0
  26. package/dist/chunk-Z7AMDRN3.js +66 -0
  27. package/dist/chunk-Z7AMDRN3.js.map +1 -0
  28. package/dist/core/index.d.ts +101 -0
  29. package/dist/core/index.js +7 -0
  30. package/dist/core/index.js.map +1 -0
  31. package/dist/index.d.ts +8 -0
  32. package/dist/index.js +11 -0
  33. package/dist/index.js.map +1 -0
  34. package/dist/platforms/browser.d.ts +23 -0
  35. package/dist/platforms/browser.js +7 -0
  36. package/dist/platforms/browser.js.map +1 -0
  37. package/dist/platforms/wechat-game.d.ts +31 -0
  38. package/dist/platforms/wechat-game.js +8 -0
  39. package/dist/platforms/wechat-game.js.map +1 -0
  40. package/dist/platforms/wechat-miniprogram.d.ts +26 -0
  41. package/dist/platforms/wechat-miniprogram.js +8 -0
  42. package/dist/platforms/wechat-miniprogram.js.map +1 -0
  43. package/dist/plugin-core-BuqW9C-L.d.ts +127 -0
  44. package/dist/polyfills/index.d.ts +291 -0
  45. package/dist/polyfills/index.js +4 -0
  46. package/dist/polyfills/index.js.map +1 -0
  47. package/dist/runtime-7uUOoFhC.d.ts +263 -0
  48. package/dist/scope.d.ts +146 -0
  49. package/dist/scope.js +4 -0
  50. package/dist/scope.js.map +1 -0
  51. package/dist/types-BzK0LQMa.d.ts +153 -0
  52. package/dist/wx-types-NMNyrsWO.d.ts +150 -0
  53. package/docs/01-design-principles.md +105 -0
  54. package/docs/02-architecture.md +126 -0
  55. package/docs/03-module-map.md +99 -0
  56. package/docs/04-api-reference.md +291 -0
  57. package/docs/05-build-plugin.md +146 -0
  58. package/docs/06-platform-notes.md +108 -0
  59. package/docs/07-integration-guide.md +211 -0
  60. package/docs/08-extension-guide.md +101 -0
  61. package/docs/09-testing-and-release.md +206 -0
  62. package/docs/10-ai-playbook.md +140 -0
  63. package/docs/11-compat-matrix.md +94 -0
  64. package/docs/README.md +41 -0
  65. package/docs/adr/0001-scoped-globals.md +41 -0
  66. package/docs/adr/0002-unified-runtime-lifecycle.md +40 -0
  67. package/docs/adr/0003-ast-rewrite.md +51 -0
  68. package/docs/adr/0004-in-place-patching.md +42 -0
  69. package/docs/adr/0005-webgl2-only.md +44 -0
  70. package/docs/adr/0006-zero-three-dependency.md +43 -0
  71. package/docs/adr/README.md +28 -0
  72. package/llms.txt +65 -0
  73. package/package.json +117 -4
@@ -0,0 +1,42 @@
1
+ # ADR-0004 · 就地 patch 画布,不改原型、不用 Proxy
2
+
3
+ - 状态:Accepted
4
+ - 日期:2026-11-08
5
+ - 影响模块:`src/core/element.ts`、`src/core/canvas.ts`、`src/core/image.ts`、`src/core/dom.ts`
6
+
7
+ ## 背景
8
+
9
+ 宿主内部按对象身份保存画布与图片的校验数据,任何「新建一个类实例包装」「用 Proxy 拦截」「克隆对象」的做法都会让这些校验失效。因此 three 需要的 DOM 属性与方法必须直接补到宿主返回的那个对象上。
10
+
11
+ 同时,three 与 addons 会用 `instanceof HTMLCanvasElement` 之类的判定选择代码分支,补丁还需要让这些判定成立。修改对象原型虽然能达到目的,但在 JSC/V8 上是明确的去优化操作,且会与其他库对原型的修改互相覆盖。
12
+
13
+ ## 决策
14
+
15
+ 1. **保持对象身份**:所有补丁都是对 `wx` 返回的那个对象执行 `Object.defineProperty`。
16
+ 2. **禁止** `new Proxy(...)` 包装、禁止克隆对象、禁止 `Object.setPrototypeOf`。
17
+ 3. `instanceof` 用 `createMockClass()` 生成的 `Symbol.hasInstance` + `WeakSet` 注册表实现,补丁时把对象注册进对应的 shim。
18
+ 4. 需要 `new SomeCtor()` 的场景(如 `OffscreenCanvas`)提供真正返回平台对象的构造器函数。
19
+ 5. `style.width/height`、`clientWidth/Height`、`getBoundingClientRect()` 用闭包 `rect` 的响应式 getter,`updateRect()` 一处更新全处生效。
20
+
21
+ ## 理由
22
+
23
+ - 宿主校验依赖对象身份;任何包装都会破坏它。
24
+ - `Object.setPrototypeOf` 是去优化操作,而且会与其他补丁冲突。
25
+ - `Symbol.hasInstance` 是标准机制,精确且零副作用;`WeakSet` 不阻止 GC。
26
+
27
+ ## 后果
28
+
29
+ - 正面:兼容宿主校验、性能更好、可与其他补丁共存;身份不变也让缓存/Map 键稳定。
30
+ - 负面:每个新 DOM 属性都要显式补;three 升级时可能发现新的属性缺失(这是 `docs/11` 升级检查项)。
31
+ - 负面:`instanceof` 只对注册过的对象成立;业务自己 `new` 出来的假对象不会被识别(可接受)。
32
+ - 风险:`defineProperty` 可能遇到宿主不可配置属性 → `normalizeContext()` 里对 `ctx.canvas` 的赋值用 try/catch 保护。
33
+
34
+ ## 被否决的备选方案
35
+
36
+ - 继承/代理包装:破坏身份,否决。
37
+ - 改原型:去优化 + 冲突风险,否决。
38
+ - 只靠 `Object.defineProperty` 不做 `instanceof`:three 与 addons 会用 `instanceof HTMLCanvasElement` 分支,否决。
39
+
40
+ ## 验证方式
41
+
42
+ `tests/runtime.test.ts`:「patches the canvas in place」「caches WebGL2 context identity and satisfies instanceof」断言 `runtime.canvas === wx.__canvases[0]` 且 `instanceof` 成立。
@@ -0,0 +1,44 @@
1
+ # ADR-0005 · WebGL2 优先,不静默降级到 WebGL1
2
+
3
+ - 状态:Accepted
4
+ - 日期:2026-11-08
5
+ - 影响模块:`src/core/capabilities.ts`、`src/core/canvas.ts`、`src/core/dom.ts`、`src/platforms/wechat-common.ts`、`src/build/plugin-core.ts`
6
+
7
+ ## 背景
8
+
9
+ - three.js r163 起 `WebGLRenderer` 不再支持 WebGL1(见 [Migration Guide](https://github.com/mrdoob/three.js/wiki/Migration-Guide))。
10
+ - 微信官方文档在 iOS 高性能+ 模式里明确「建议使用 WebGL2、内存压力大的游戏开启」([iOS 高性能模式](https://developers.weixin.qq.com/minigame/dev/guide/game-engine/unity-webgl-transform/Design/iOSOptimization.html))。
11
+ - 三方库里存在 `new WebGLRenderer()` 不传 canvas 的写法,此时 `document.createElement('canvas')` 产出的默认上下文类型直接决定渲染器能否创建。
12
+ - 宿主规定首次 `wx.createCanvas()` 是唯一上屏画布,能力探测不能碰它。
13
+ - 小游戏环境没有 WebGPU,而 three 的 `three/webgpu` 入口依赖 NodeMaterial / TSL,无法用重命名的方式退回 WebGL。
14
+
15
+ ## 决策
16
+
17
+ 1. `defaultContextType` 默认 `'webgl2'`;`document.createElement('canvas')` 优先 `wx.createOffscreenCanvas({ type: 'webgl2' })`,失败降级 2d **并告警**。
18
+ 2. `probeContext()` 只用 `wx.createOffscreenCanvas()` 探测 WebGL2,探测后主动 `WEBGL_lose_context` 释放;绝不调用 `wx.createCanvas()`。
19
+ 3. `capabilities.webgl2 === false` 时发出明确告警 + 能力报告,**不静默切到 WebGL1**。
20
+ 4. WebGPU:插件对 `from 'three/webgpu'` 默认告警,`webgpu: 'rewrite'` 是有损的显式 opt-in。
21
+ 5. 已知宿主 WebGL 差异(`getExtension` 返回数字、`drawingBufferWidth`)由 `normalizeWebGL: true` 显式修复,可关闭。
22
+
23
+ ## 理由
24
+
25
+ - three 要求 WebGL2,静默降级只会把错误推迟到渲染阶段,不如在启动时给出可操作信息。
26
+ - 探测不占用上屏画布是硬性约束(ADR 不变量 #1)。
27
+ - 把「平台差异补丁」做成可开关、可观测,而不是在运行时改写渲染器行为。
28
+
29
+ ## 后果
30
+
31
+ - 正面:启动即可诊断环境问题;与 three r163+ / 官方高性能+ 建议一致。
32
+ - 负面:极老设备 / 极旧基础库无法运行(明确不支持,见 `docs/11`)。
33
+ - 负面:WebGPU 生态项目必须改用 WebGL 构建目标(写进 `docs/05` / `docs/11`)。
34
+ - 风险:`createOffscreenCanvas({type:'webgl2'})` 在个别基础库上抛错 → `createOffscreenCanvasRaw()` 已带 catch 与降级日志。
35
+
36
+ ## 被否决的备选方案
37
+
38
+ - 运行时自动检测 WebGL2 → 回退 WebGL1:three 不支持,否决。
39
+ - 用 `wx.createCanvas().getContext('webgl2')` 探测:会占用上屏画布,否决。
40
+ - 打包定制版 three 内核:违反「零 three 依赖 / 不 fork」边界,否决。
41
+
42
+ ## 验证方式
43
+
44
+ `tests/runtime.test.ts` 覆盖 `getContext('webgl2')` 缓存与 `instanceof`;`docs/09` 真机清单要求 iOS/Android 各一台验证 WebGL2 出图。
@@ -0,0 +1,43 @@
1
+ # ADR-0006 · 运行时零 `three` 依赖,构建 / 运行严格隔离
2
+
3
+ - 状态:Accepted
4
+ - 日期:2026-11-08
5
+ - 影响模块:`package.json`、`tsup.config.ts`、`src/**`、`docs/03-module-map.md`
6
+
7
+ ## 背景
8
+
9
+ 适配层如果与某个具体的 three 版本绑定(打包内置 three、替换 three 内部模块、改写渲染器方法),three 升级就必须同步发布适配层,行为也变得难以预测。
10
+
11
+ 另一方面,构建插件运行在 Node,运行时代码运行在 JS 引擎。两者若混在同一个 bundle 里,`node:fs` 之类的依赖会被带进小游戏代码包,既增大体积又破坏可移植性。
12
+
13
+ ## 决策
14
+
15
+ 1. `src/**` **不得 import `three`**;`three` 只是 `optional peerDependency`,且被 tsup 标为 `external`。
16
+ 2. 运行时只实现「浏览器环境 shim」,不关心 three 的类、材质、渲染流程。
17
+ 3. 所有 three 相关的构建期行为集中在 `src/build/**`,且只做三件事:AST 全局重写、WebGPU 策略、worker/wasm 资产收集;**不改写 three 源码语义**。
18
+ 4. 依赖方向固定:`types → scope/polyfills → core → platforms`;`build` 是独立分支,不得 import `core`/`platforms`;`node:fs` 只允许出现在 `build/`。
19
+ 5. tsup 两套构建:runtime = `es2019` / `platform: neutral` / splitting / dts;build tooling = `node18` / `platform: node` / 不 splitting。
20
+ 6. `es2019` 目标让 esbuild 降级 `?.` / `??`,减少微信开发者工具语法报错。
21
+
22
+ ## 理由
23
+
24
+ - 适配层与 three 解耦后,three 从 r163 到 r18x 的升级不需要改适配层内核,只需按 `docs/11` 补全局清单 / DOM 属性。
25
+ - 构建/运行隔离保证产物体积与可移植性;也便于在 Node 里跑单元测试。
26
+ - 不做语义改写 → 行为可预测、可调试,不会在 three 升级后突然失效。
27
+
28
+ ## 后果
29
+
30
+ - 正面:包体小、版本兼容面宽、可测试、可 tree-shake。
31
+ - 负面:某些 loader 的 worker/wasm 需要业务自行 `setDecoderPath()`;插件只负责把资源放进包并生成 manifest。
32
+ - 负面:不提供「自动替换 addons 模块」的便利,接入时按 `docs/07` 配置 decoder 路径即可。
33
+ - 风险:未来 three 引入依赖原生 Web API 的新模块时,需要按 `docs/08` 补 polyfill(这是常规迭代,不是架构变更)。
34
+
35
+ ## 被否决的备选方案
36
+
37
+ - fork / 打包 three:体积、版本、许可都不可接受,否决。
38
+ - 运行时 monkey-patch `WebGLRenderer`:隐式、脆弱、不可观测,否决。
39
+ - 把插件与运行时打成一个包入口:`node:fs` 会进小游戏 bundle,否决。
40
+
41
+ ## 验证方式
42
+
43
+ `npx tsc --noEmit` + `npx tsup` 产物检查(`dist/index.js` 不含 `node:` 导入);`tests/*` 全程在 Node 中用 mock `wx` 运行,不加载真实 three。
@@ -0,0 +1,28 @@
1
+ # 架构决策记录(ADR)
2
+
3
+ 每条 ADR 记录一个**难以从代码本身看出原因**的决策。新增或推翻决策时不要删除旧文件,把状态改为 `Superseded by ADR-XXXX` 并写明原因——这是给后续 AI 迭代保留「为什么」的关键。
4
+
5
+ | 编号 | 决策 | 状态 |
6
+ | --- | --- | --- |
7
+ | [0001](./0001-scoped-globals.md) | 作用域化的浏览器环境 shim | Accepted |
8
+ | [0002](./0002-unified-runtime-lifecycle.md) | 单一 `createRuntime()` / `MiniThreeRuntime` 生命周期 | Accepted |
9
+ | [0003](./0003-ast-rewrite.md) | 用 Babel AST 作用域分析重写三方模块全局引用 | Accepted |
10
+ | [0004](./0004-in-place-patching.md) | 就地 patch 画布,不改原型、不用 Proxy | Accepted |
11
+ | [0005](./0005-webgl2-only.md) | WebGL2 优先,不静默降级到 WebGL1 | Accepted |
12
+ | [0006](./0006-zero-three-dependency.md) | 运行时零 `three` 依赖,构建/运行严格隔离 | Accepted |
13
+
14
+ 模板(新增 ADR 时复制):
15
+
16
+ ```markdown
17
+ # ADR-NNNN · 标题
18
+ - 状态:Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
19
+ - 日期:YYYY-MM-DD
20
+ - 影响模块:...
21
+
22
+ ## 背景
23
+ ## 决策
24
+ ## 理由
25
+ ## 后果(正面 / 负面 / 风险)
26
+ ## 被否决的备选方案
27
+ ## 验证方式
28
+ ```
package/llms.txt ADDED
@@ -0,0 +1,65 @@
1
+ # mini-three-adapter
2
+
3
+ > A modern TypeScript-first, ESM, zero-global-pollution Three.js adapter for WeChat Mini Games / Mini Programs. Build-time AST rewriting redirects third-party browser globals into a scoped object; runtime patches the single wx canvas in place and exposes one disposable MiniThreeRuntime. MIT licensed, no runtime dependency on three.
4
+
5
+ ## Start here (AI agents)
6
+
7
+ - [AGENTS.md](./AGENTS.md): hard constraints, commands, invariants, review checklist. READ FIRST.
8
+ - [docs/10-ai-playbook.md](./docs/10-ai-playbook.md): prompt templates and iteration workflow.
9
+ - [docs/03-module-map.md](./docs/03-module-map.md): which file to edit for a given change.
10
+
11
+ ## Core docs
12
+
13
+ - [README.md](./README.md): overview, quick start, architecture sketch.
14
+ - [docs/README.md](./docs/README.md): documentation index and reading order.
15
+ - [docs/01-design-principles.md](./docs/01-design-principles.md): goals, runtime constraints, technology choices, capability boundaries.
16
+ - [docs/02-architecture.md](./docs/02-architecture.md): layering, data flow, 10 architecture invariants, failure modes.
17
+ - [docs/04-api-reference.md](./docs/04-api-reference.md): every public export and signature.
18
+ - [docs/05-build-plugin.md](./docs/05-build-plugin.md): AST rewriting, WebGPU policy, asset collection, manifest.
19
+ - [docs/06-platform-notes.md](./docs/06-platform-notes.md): WeChat runtime facts, known bugs, import order, packaging.
20
+ - [docs/07-integration-guide.md](./docs/07-integration-guide.md): integrating into an existing project, subpackages, checklist.
21
+ - [docs/08-extension-guide.md](./docs/08-extension-guide.md): add a platform / polyfill / asset rule.
22
+ - [docs/09-testing-and-release.md](./docs/09-testing-and-release.md): commands, CI, npm publishing workflow, version bumps.
23
+ - [docs/11-compat-matrix.md](./docs/11-compat-matrix.md): three.js / base library / platform support matrix.
24
+
25
+ ## Architecture decision records
26
+
27
+ - [docs/adr/README.md](./docs/adr/README.md): ADR index and template.
28
+ - [ADR-0001 scoped globals](./docs/adr/0001-scoped-globals.md)
29
+ - [ADR-0002 unified runtime lifecycle](./docs/adr/0002-unified-runtime-lifecycle.md)
30
+ - [ADR-0003 AST rewrite](./docs/adr/0003-ast-rewrite.md)
31
+ - [ADR-0004 in-place patching](./docs/adr/0004-in-place-patching.md)
32
+ - [ADR-0005 WebGL2 only](./docs/adr/0005-webgl2-only.md)
33
+ - [ADR-0006 zero three dependency](./docs/adr/0006-zero-three-dependency.md)
34
+
35
+ ## Source entry points
36
+
37
+ - [src/index.ts](./src/index.ts): umbrella exports.
38
+ - [src/scope.ts](./src/scope.ts): MiniThreeScope, getActiveScope, installGlobals (target of the injected plugin import).
39
+ - [src/core/runtime.ts](./src/core/runtime.ts): createRuntime, MiniThreeRuntime, lifecycle.
40
+ - [src/core/platform.ts](./src/core/platform.ts): PlatformBinding contract.
41
+ - [src/core/pointer.ts](./src/core/pointer.ts): touch -> pointer event state machine.
42
+ - [src/core/element.ts](./src/core/element.ts): in-place DOM patching + Symbol.hasInstance registry.
43
+ - [src/core/canvas.ts](./src/core/canvas.ts): canvas patching, context cache, WebGL normalization.
44
+ - [src/build/scope-rewrite.ts](./src/build/scope-rewrite.ts): Babel-based global rewriting.
45
+ - [src/build/plugin-core.ts](./src/build/plugin-core.ts): Rollup/Vite plugin core.
46
+ - [src/build/assets.ts](./src/build/assets.ts): worker/wasm collection and manifest.
47
+ - [src/platforms/wechat-game.ts](./src/platforms/wechat-game.ts): mini game entry.
48
+ - [src/platforms/wechat-miniprogram.ts](./src/platforms/wechat-miniprogram.ts): mini program entry.
49
+ - [src/platforms/browser.ts](./src/platforms/browser.ts): H5 / Node test platform.
50
+ - [package.json](./package.json): exports map, scripts, peers.
51
+ - [tsup.config.ts](./tsup.config.ts): two build targets (es2019 runtime / node18 tooling).
52
+
53
+ ## Tests and examples
54
+
55
+ - [tests/runtime.test.ts](./tests/runtime.test.ts): canvas patching, scope, touch bridge, disposal.
56
+ - [tests/scope-rewrite.test.ts](./tests/scope-rewrite.test.ts): AST correctness.
57
+ - [tests/polyfills.test.ts](./tests/polyfills.test.ts): event/blob/url/network.
58
+ - [tests/plugin.test.ts](./tests/plugin.test.ts): plugin and assets.
59
+ - [tests/helpers/mock-wx.ts](./tests/helpers/mock-wx.ts): injectable wx simulator.
60
+ - [examples/README.md](./examples/README.md): three runnable targets (mini game / mini program / H5).
61
+
62
+ ## Optional
63
+
64
+ - [CHANGELOG.md](./CHANGELOG.md)
65
+ - [CONTRIBUTING.md](./CONTRIBUTING.md)
package/package.json CHANGED
@@ -1,6 +1,119 @@
1
1
  {
2
2
  "name": "mini-three-adapter",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "A modern, TypeScript-first, zero-global-pollution Three.js adapter for WeChat Mini Games and Mini Programs",
5
+ "type": "module",
6
+ "types": "./dist/index.d.ts",
7
+ "license": "MIT",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/hmtx1024/mini-three-adapter.git"
11
+ },
12
+ "homepage": "https://github.com/hmtx1024/mini-three-adapter#readme",
13
+ "bugs": {
14
+ "url": "https://github.com/hmtx1024/mini-three-adapter/issues"
15
+ },
16
+ "keywords": [
17
+ "three.js",
18
+ "wechat",
19
+ "minigame",
20
+ "miniprogram",
21
+ "adapter",
22
+ "webgl2",
23
+ "小游戏",
24
+ "适配层"
25
+ ],
26
+ "files": [
27
+ "dist",
28
+ "README.md",
29
+ "AGENTS.md",
30
+ "llms.txt",
31
+ "docs"
32
+ ],
33
+ "sideEffects": [
34
+ "./dist/platforms/wechat-game.js",
35
+ "./dist/platforms/wechat-miniprogram.js"
36
+ ],
37
+ "exports": {
38
+ ".": {
39
+ "types": "./dist/index.d.ts",
40
+ "import": "./dist/index.js"
41
+ },
42
+ "./core": {
43
+ "types": "./dist/core/index.d.ts",
44
+ "import": "./dist/core/index.js"
45
+ },
46
+ "./scope": {
47
+ "types": "./dist/scope.d.ts",
48
+ "import": "./dist/scope.js"
49
+ },
50
+ "./wechat-game": {
51
+ "types": "./dist/platforms/wechat-game.d.ts",
52
+ "import": "./dist/platforms/wechat-game.js"
53
+ },
54
+ "./wechat-miniprogram": {
55
+ "types": "./dist/platforms/wechat-miniprogram.d.ts",
56
+ "import": "./dist/platforms/wechat-miniprogram.js"
57
+ },
58
+ "./browser": {
59
+ "types": "./dist/platforms/browser.d.ts",
60
+ "import": "./dist/platforms/browser.js"
61
+ },
62
+ "./polyfills": {
63
+ "types": "./dist/polyfills/index.d.ts",
64
+ "import": "./dist/polyfills/index.js"
65
+ },
66
+ "./vite": {
67
+ "types": "./dist/build/vite.d.ts",
68
+ "import": "./dist/build/vite.js"
69
+ },
70
+ "./rollup": {
71
+ "types": "./dist/build/rollup.d.ts",
72
+ "import": "./dist/build/rollup.js"
73
+ },
74
+ "./plugin": {
75
+ "types": "./dist/build/vite.d.ts",
76
+ "import": "./dist/build/vite.js"
77
+ },
78
+ "./package.json": "./package.json"
79
+ },
80
+ "scripts": {
81
+ "build": "tsup",
82
+ "typecheck": "tsc --noEmit",
83
+ "test": "vitest run",
84
+ "test:watch": "vitest",
85
+ "check": "npm run typecheck && npm run test && npm run build",
86
+ "clean": "node scripts/clean.mjs",
87
+ "prepublishOnly": "npm run clean && npm run check",
88
+ "release:check": "npm pack --dry-run --json"
89
+ },
90
+ "dependencies": {
91
+ "@babel/parser": "^7.26.0",
92
+ "@babel/traverse": "^7.26.0",
93
+ "magic-string": "^0.30.17"
94
+ },
95
+ "peerDependencies": {
96
+ "three": ">=0.163.0",
97
+ "vite": ">=5.0.0",
98
+ "rollup": ">=4.0.0"
99
+ },
100
+ "peerDependenciesMeta": {
101
+ "three": { "optional": true },
102
+ "vite": { "optional": true },
103
+ "rollup": { "optional": true }
104
+ },
105
+ "devDependencies": {
106
+ "@types/babel__traverse": "^7.20.6",
107
+ "@types/node": "^22.10.0",
108
+ "tsup": "^8.3.5",
109
+ "typescript": "^5.7.2",
110
+ "vitest": "^2.1.8"
111
+ },
112
+ "engines": {
113
+ "node": ">=18"
114
+ },
115
+ "publishConfig": {
116
+ "access": "public",
117
+ "registry": "https://registry.npmjs.org/"
118
+ }
119
+ }