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,128 @@
1
+ // src/scope.ts
2
+ var active = null;
3
+ function notInitialized(name) {
4
+ throw new Error(
5
+ `[mini-three-adapter] Scoped global "${name}" was read before a runtime was created. Import 'mini-three-adapter/wechat-game' and await createWeChatGameRuntime() before importing three.js, or call installGlobals(scope) explicitly.`
6
+ );
7
+ }
8
+ var emptyScope = new Proxy(
9
+ { window: null, self: null, globalThis: null },
10
+ {
11
+ get(target, prop) {
12
+ if (prop === "window" || prop === "self" || prop === "globalThis") return emptyScope;
13
+ if (prop === "document") return notInitialized("document");
14
+ if (prop === Symbol.toStringTag) return "MiniThreeScope";
15
+ return notInitialized(String(prop));
16
+ },
17
+ has() {
18
+ return false;
19
+ }
20
+ }
21
+ );
22
+ function getActiveScope() {
23
+ return active != null ? active : emptyScope;
24
+ }
25
+ function setActiveScope(scope) {
26
+ const previous = active;
27
+ active = scope;
28
+ return () => {
29
+ if (active === scope) active = previous;
30
+ };
31
+ }
32
+ function hasActiveScope() {
33
+ return active !== null;
34
+ }
35
+ function createScope(overrides = {}) {
36
+ const scope = {
37
+ ...overrides
38
+ };
39
+ Object.defineProperties(scope, {
40
+ window: { get: () => scope, enumerable: true, configurable: true },
41
+ self: { get: () => scope, enumerable: true, configurable: true },
42
+ globalThis: { get: () => scope, enumerable: true, configurable: true }
43
+ });
44
+ return scope;
45
+ }
46
+ var GLOBAL_KEYS = [
47
+ "window",
48
+ "self",
49
+ "document",
50
+ "navigator",
51
+ "screen",
52
+ "innerWidth",
53
+ "innerHeight",
54
+ "outerWidth",
55
+ "outerHeight",
56
+ "devicePixelRatio",
57
+ "pageXOffset",
58
+ "pageYOffset",
59
+ "performance",
60
+ "requestAnimationFrame",
61
+ "cancelAnimationFrame",
62
+ "getComputedStyle",
63
+ "matchMedia",
64
+ "atob",
65
+ "btoa",
66
+ "Event",
67
+ "EventTarget",
68
+ "CustomEvent",
69
+ "PointerEvent",
70
+ "MouseEvent",
71
+ "TouchEvent",
72
+ "MessageEvent",
73
+ "ProgressEvent",
74
+ "KeyboardEvent",
75
+ "DOMException",
76
+ "HTMLElement",
77
+ "HTMLCanvasElement",
78
+ "HTMLImageElement",
79
+ "HTMLVideoElement",
80
+ "OffscreenCanvas",
81
+ "Image",
82
+ "ImageData",
83
+ "DOMRect",
84
+ "WebGLRenderingContext",
85
+ "WebGL2RenderingContext",
86
+ "AudioContext",
87
+ "Blob",
88
+ "URL",
89
+ "FileReader",
90
+ "TextDecoder",
91
+ "TextEncoder",
92
+ "AbortController",
93
+ "AbortSignal",
94
+ "fetch",
95
+ "XMLHttpRequest",
96
+ "WebSocket",
97
+ "createImageBitmap",
98
+ "Worker",
99
+ "WebAssembly",
100
+ "ResizeObserver"
101
+ ];
102
+ function installGlobals(scope, options = {}) {
103
+ var _a, _b;
104
+ const target = (_a = options.target) != null ? _a : globalThis;
105
+ const keys = [...GLOBAL_KEYS, ...(_b = options.extraKeys) != null ? _b : []];
106
+ const saved = /* @__PURE__ */ new Map();
107
+ for (const key of keys) {
108
+ const existing = Object.getOwnPropertyDescriptor(target, key);
109
+ if (options.skipExisting && existing) continue;
110
+ if (!(key in scope)) continue;
111
+ saved.set(key, existing);
112
+ Object.defineProperty(target, key, {
113
+ get: () => scope[key],
114
+ configurable: true,
115
+ enumerable: true
116
+ });
117
+ }
118
+ return () => {
119
+ for (const [key, descriptor] of saved) {
120
+ if (descriptor) Object.defineProperty(target, key, descriptor);
121
+ else delete target[key];
122
+ }
123
+ };
124
+ }
125
+
126
+ export { createScope, getActiveScope, hasActiveScope, installGlobals, setActiveScope };
127
+ //# sourceMappingURL=chunk-34RWHAW4.js.map
128
+ //# sourceMappingURL=chunk-34RWHAW4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/scope.ts"],"names":[],"mappings":"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","file":"chunk-34RWHAW4.js","sourcesContent":["/**\n * Scoped globals: the central design decision of mini-three-adapter.\n *\n * The original adapter style (and WeChat's official `weapp-adapter`) writes\n * `window`, `document`, `Image`, ... onto `globalThis`. That is convenient but\n * irreversible: it breaks H5 dual-target builds, makes two three.js versions\n * fight over the same canvas, and cannot be un-installed in tests.\n *\n * Here the shims live in one explicit `MiniThreeScope` object. Third-party\n * modules (three, three/addons, three-stdlib, ...) are rewritten at build time\n * by `mini-three-adapter/vite` so that their *free* references to browser\n * globals resolve through `getActiveScope()`. Application code is untouched.\n *\n * `installGlobals()` remains available as an explicit, reversible escape hatch\n * for libraries that cannot be transformed.\n */\nimport type {\n CanvasStyleLike,\n EventTargetLike,\n PatchedCanvas,\n Rect,\n} from './types';\n\nexport interface DocumentLike extends EventTargetLike {\n createElement(tagName: string): PatchedCanvas | unknown;\n createElementNS(namespaceURI: string | null, tagName: string): PatchedCanvas | unknown;\n body: ElementLike;\n documentElement: ElementLike;\n defaultView: MiniThreeScope | null;\n [key: string]: unknown;\n}\n\nexport interface ElementLike extends EventTargetLike {\n style: CanvasStyleLike;\n clientWidth: number;\n clientHeight: number;\n getBoundingClientRect(): Rect;\n setAttribute(name: string, value: unknown): void;\n removeAttribute(name: string): void;\n [key: string]: unknown;\n}\n\nexport interface NavigatorLike {\n userAgent: string;\n platform: string;\n hardwareConcurrency: number;\n [key: string]: unknown;\n}\n\n/**\n * The set of browser globals three.js (and its addons) may read. Members are\n * typed where they matter and `unknown` in the index signature so the build\n * plugin can add platform-specific extras without loosening the whole object.\n */\nexport interface MiniThreeScope extends EventTargetLike {\n readonly window: MiniThreeScope;\n readonly self: MiniThreeScope;\n readonly globalThis: MiniThreeScope;\n document: DocumentLike;\n navigator: NavigatorLike;\n screen: EventTargetLike & {\n width: number;\n height: number;\n availWidth: number;\n availHeight: number;\n colorDepth: number;\n pixelDepth: number;\n };\n innerWidth: number;\n innerHeight: number;\n outerWidth: number;\n outerHeight: number;\n devicePixelRatio: number;\n pageXOffset: number;\n pageYOffset: number;\n performance: { now(): number };\n requestAnimationFrame(callback: (time: number) => void): number;\n cancelAnimationFrame(id: number): void;\n getComputedStyle(element: unknown): CanvasStyleLike;\n matchMedia(query: string): { matches: boolean; media: string; addListener(l: unknown): void; removeListener(l: unknown): void };\n atob(data: string): string;\n btoa(data: string): string;\n\n Event: unknown;\n EventTarget: unknown;\n CustomEvent: unknown;\n PointerEvent: unknown;\n MouseEvent: unknown;\n TouchEvent: unknown;\n MessageEvent: unknown;\n ProgressEvent: unknown;\n KeyboardEvent: unknown;\n DOMException: unknown;\n\n HTMLElement: unknown;\n HTMLCanvasElement: unknown;\n HTMLImageElement: unknown;\n HTMLVideoElement: unknown;\n OffscreenCanvas: unknown;\n Image: unknown;\n ImageData: unknown;\n DOMRect: unknown;\n WebGLRenderingContext: unknown;\n WebGL2RenderingContext: unknown;\n AudioContext: unknown;\n\n Blob: unknown;\n URL: unknown;\n FileReader: unknown;\n TextDecoder: unknown;\n TextEncoder: unknown;\n AbortController: unknown;\n AbortSignal: unknown;\n fetch: unknown;\n XMLHttpRequest: unknown;\n WebSocket: unknown;\n createImageBitmap: unknown;\n Worker: unknown;\n WebAssembly: unknown;\n ResizeObserver: unknown;\n\n [key: string]: unknown;\n}\n\nlet active: MiniThreeScope | null = null;\n\nfunction notInitialized(name: string): never {\n throw new Error(\n `[mini-three-adapter] Scoped global \"${name}\" was read before a runtime was created. ` +\n `Import 'mini-three-adapter/wechat-game' and await createWeChatGameRuntime() before importing three.js, ` +\n `or call installGlobals(scope) explicitly.`,\n );\n}\n\n/**\n * A stable placeholder returned when no runtime exists yet. `typeof scope.window`\n * still yields \"object\" (which is what three.js feature-detection expects), but\n * any real access throws an actionable error instead of silently returning\n * `undefined` three frames later.\n */\nconst emptyScope: MiniThreeScope = new Proxy(\n { window: null, self: null, globalThis: null } as unknown as MiniThreeScope,\n {\n get(target, prop) {\n if (prop === 'window' || prop === 'self' || prop === 'globalThis') return emptyScope;\n if (prop === 'document') return notInitialized('document');\n if (prop === Symbol.toStringTag) return 'MiniThreeScope';\n return notInitialized(String(prop));\n },\n has() {\n return false;\n },\n },\n);\n\n/** Returns the currently installed scope (or the throwing placeholder). */\nexport function getActiveScope(): MiniThreeScope {\n return active ?? emptyScope;\n}\n\n/** Install / replace the active scope. Returns a disposer. */\nexport function setActiveScope(scope: MiniThreeScope | null): () => void {\n const previous = active;\n active = scope;\n return () => {\n if (active === scope) active = previous;\n };\n}\n\nexport function hasActiveScope(): boolean {\n return active !== null;\n}\n\n/**\n * Build a scope with a set of overrides. `window`, `self` and `globalThis`\n * are wired to the scope itself so that `window.window === window`.\n */\nexport function createScope(overrides: Partial<MiniThreeScope> = {}): MiniThreeScope {\n const scope = {\n ...overrides,\n } as MiniThreeScope;\n Object.defineProperties(scope, {\n window: { get: () => scope, enumerable: true, configurable: true },\n self: { get: () => scope, enumerable: true, configurable: true },\n globalThis: { get: () => scope, enumerable: true, configurable: true },\n });\n return scope;\n}\n\n/** Keys written by `installGlobals`. Kept explicit so restoration is exact. */\nconst GLOBAL_KEYS = [\n 'window', 'self', 'document', 'navigator', 'screen',\n 'innerWidth', 'innerHeight', 'outerWidth', 'outerHeight', 'devicePixelRatio',\n 'pageXOffset', 'pageYOffset', 'performance',\n 'requestAnimationFrame', 'cancelAnimationFrame', 'getComputedStyle', 'matchMedia',\n 'atob', 'btoa',\n 'Event', 'EventTarget', 'CustomEvent', 'PointerEvent', 'MouseEvent', 'TouchEvent',\n 'MessageEvent', 'ProgressEvent', 'KeyboardEvent', 'DOMException',\n 'HTMLElement', 'HTMLCanvasElement', 'HTMLImageElement', 'HTMLVideoElement',\n 'OffscreenCanvas', 'Image', 'ImageData', 'DOMRect',\n 'WebGLRenderingContext', 'WebGL2RenderingContext', 'AudioContext',\n 'Blob', 'URL', 'FileReader', 'TextDecoder', 'TextEncoder',\n 'AbortController', 'AbortSignal', 'fetch', 'XMLHttpRequest', 'WebSocket',\n 'createImageBitmap', 'Worker', 'WebAssembly', 'ResizeObserver',\n] as const;\n\nexport interface InstallGlobalsOptions {\n /** Defaults to `globalThis`. */\n target?: Record<string, unknown>;\n /** Skip keys that already exist (useful in a browser / H5 build). */\n skipExisting?: boolean;\n /** Additional keys to copy from the scope. */\n extraKeys?: string[];\n}\n\n/**\n * Explicit opt-in global pollution for libraries that cannot be transformed.\n * Returns a disposer that restores every overwritten descriptor exactly.\n *\n * This is intentionally NOT called automatically: the default path is scoped.\n */\nexport function installGlobals(\n scope: MiniThreeScope,\n options: InstallGlobalsOptions = {},\n): () => void {\n const target = options.target ?? (globalThis as unknown as Record<string, unknown>);\n const keys: string[] = [...GLOBAL_KEYS, ...(options.extraKeys ?? [])];\n const saved = new Map<string, PropertyDescriptor | undefined>();\n\n for (const key of keys) {\n const existing = Object.getOwnPropertyDescriptor(target, key);\n if (options.skipExisting && existing) continue;\n if (!(key in scope)) continue;\n saved.set(key, existing);\n Object.defineProperty(target, key, {\n get: () => (scope as Record<string, unknown>)[key],\n configurable: true,\n enumerable: true,\n });\n }\n\n return () => {\n for (const [key, descriptor] of saved) {\n if (descriptor) Object.defineProperty(target, key, descriptor);\n else delete target[key];\n }\n };\n}\n"]}