mini-three-adapter 0.1.1 → 0.1.3

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 (51) hide show
  1. package/AGENTS.md +85 -85
  2. package/README.md +159 -159
  3. package/dist/build/rollup.js +60 -9
  4. package/dist/build/rollup.js.map +1 -1
  5. package/dist/build/vite.js +60 -9
  6. package/dist/build/vite.js.map +1 -1
  7. package/dist/{chunk-Z7AMDRN3.js → chunk-3QUEDYTT.js} +12 -5
  8. package/dist/chunk-3QUEDYTT.js.map +1 -0
  9. package/dist/{chunk-WLRQDTSZ.js → chunk-52IMRKOX.js} +3 -3
  10. package/dist/{chunk-WLRQDTSZ.js.map → chunk-52IMRKOX.js.map} +1 -1
  11. package/dist/{chunk-3UGQWFH3.js → chunk-J7VBWZRR.js} +87 -27
  12. package/dist/chunk-J7VBWZRR.js.map +1 -0
  13. package/dist/{chunk-4UEBRAK6.js → chunk-LCJNTN6F.js} +19 -9
  14. package/dist/chunk-LCJNTN6F.js.map +1 -0
  15. package/dist/{chunk-MTBMOFAL.js → chunk-OL7NVZZJ.js} +29 -14
  16. package/dist/chunk-OL7NVZZJ.js.map +1 -0
  17. package/dist/{chunk-LB3WL24R.js → chunk-WZ2HKYC5.js} +8 -4
  18. package/dist/chunk-WZ2HKYC5.js.map +1 -0
  19. package/dist/core/index.d.ts +15 -5
  20. package/dist/core/index.js +2 -2
  21. package/dist/index.d.ts +2 -2
  22. package/dist/index.js +6 -6
  23. package/dist/platforms/browser.d.ts +2 -2
  24. package/dist/platforms/browser.js +3 -3
  25. package/dist/platforms/wechat-game.d.ts +2 -2
  26. package/dist/platforms/wechat-game.js +4 -4
  27. package/dist/platforms/wechat-miniprogram.d.ts +2 -2
  28. package/dist/platforms/wechat-miniprogram.js +4 -4
  29. package/dist/polyfills/index.d.ts +8 -1
  30. package/dist/polyfills/index.js +1 -1
  31. package/dist/{runtime-7uUOoFhC.d.ts → runtime-DnEkKZjo.d.ts} +1 -1
  32. package/dist/scope.d.ts +1 -1
  33. package/dist/{types-BzK0LQMa.d.ts → types-X_5SJh4y.d.ts} +7 -0
  34. package/docs/02-architecture.md +126 -126
  35. package/docs/03-module-map.md +99 -99
  36. package/docs/04-api-reference.md +294 -291
  37. package/docs/05-build-plugin.md +33 -5
  38. package/docs/06-platform-notes.md +116 -108
  39. package/docs/07-integration-guide.md +14 -0
  40. package/docs/09-testing-and-release.md +209 -206
  41. package/docs/10-ai-playbook.md +141 -140
  42. package/docs/11-compat-matrix.md +96 -94
  43. package/docs/adr/0007-capability-probe-fallback.md +57 -0
  44. package/docs/adr/README.md +1 -0
  45. package/llms.txt +69 -65
  46. package/package.json +1 -1
  47. package/dist/chunk-3UGQWFH3.js.map +0 -1
  48. package/dist/chunk-4UEBRAK6.js.map +0 -1
  49. package/dist/chunk-LB3WL24R.js.map +0 -1
  50. package/dist/chunk-MTBMOFAL.js.map +0 -1
  51. package/dist/chunk-Z7AMDRN3.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/platforms/wechat-miniprogram.ts"],"names":[],"mappings":"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","file":"chunk-LB3WL24R.js","sourcesContent":["/** WeChat Mini Program (小程序, canvas type=\"webgl2\") platform binding. */\nimport type { Capabilities, ContextType, Disposer, Rect, TouchLikeEvent } from '../types';\nimport type { PlatformBinding } from '../core/platform';\nimport { createRuntime, type MiniThreeRuntime, type RuntimeOptions } from '../core/runtime';\nimport { detectCapabilities } from '../core/capabilities';\nimport { createDiagnostics, type Diagnostics } from '../core/diagnostics';\nimport {\n createNow,\n createOffscreenCanvasRaw,\n createRafPair,\n createWechatImageFactory,\n probeContext,\n rectFromSelectorResult,\n watchWxVisibility,\n} from './wechat-common';\nimport { resolveWx, type WxCanvas, type WxLike, type WxSelectorQuery, type WxSelectorQueryResult } from './wx-types';\n\nexport interface SelectorCtx {\n createSelectorQuery(): WxSelectorQuery;\n}\n\nexport interface WeChatMiniProgramOptions {\n wx?: WxLike;\n /** CSS selector of the `<canvas type=\"webgl2\">` node. */\n selector: string;\n /** Inside a custom component, pass `this` so the query is scoped correctly. */\n selectorCtx?: SelectorCtx;\n /** Milliseconds to wait for layout before querying (uni-app needs a tick). */\n queryDelay?: number;\n capabilities?: Partial<Capabilities>;\n diagnostics?: Diagnostics;\n}\n\nfunction queryNode(\n ctx: SelectorCtx | WxLike,\n selector: string,\n delay: number,\n): Promise<{ node: WxCanvas; result: WxSelectorQueryResult }> {\n return new Promise((resolve, reject) => {\n const run = (): void => {\n try {\n const create = ctx.createSelectorQuery;\n if (typeof create !== 'function') {\n reject(new Error('[mini-three-adapter] createSelectorQuery is unavailable; pass a valid selectorCtx'));\n return;\n }\n const query = create.call(ctx);\n query\n .select(selector)\n .fields({ node: true, id: true, rect: true, size: true })\n .exec((results) => {\n const result = results?.[0];\n if (!result?.node) {\n reject(new Error(\n `[mini-three-adapter] selector \"${selector}\" returned no canvas node. ` +\n 'Ensure <canvas type=\"webgl2\" id=\"...\"> exists and the component is rendered.',\n ));\n return;\n }\n resolve({ node: result.node, result });\n });\n } catch (error) {\n reject(error instanceof Error ? error : new Error(String(error)));\n }\n };\n if (delay > 0) setTimeout(run, delay);\n else run();\n });\n}\n\nexport async function createWeChatMiniProgramBinding(\n options: WeChatMiniProgramOptions,\n): Promise<PlatformBinding> {\n const wx = resolveWx(options.wx);\n const diagnostics = options.diagnostics ?? createDiagnostics('warn');\n const ctx = options.selectorCtx ?? wx;\n const { node, result } = await queryNode(ctx, options.selector, options.queryDelay ?? 0);\n const rawCanvas = node;\n const capabilities = detectCapabilities(wx, 'wechat-miniprogram', {\n overrides: options.capabilities,\n probeContext: (type) => probeContext(wx, type),\n });\n const imageFactory = createWechatImageFactory(wx, diagnostics);\n const raf = createRafPair(wx, rawCanvas);\n const now = createNow(wx);\n let lastRect = rectFromSelectorResult(result);\n\n const getCanvasRect = async (): Promise<Rect> => {\n const fresh = await queryNode(ctx, options.selector, 0);\n lastRect = rectFromSelectorResult(fresh.result);\n return lastRect;\n };\n\n const watchVisibility = (handler: (visible: boolean) => void): Disposer => {\n const host = wx as Record<string, unknown>;\n const onShow = (): void => handler(true);\n const onHide = (): void => handler(false);\n if (typeof host.onAppShow === 'function') (host.onAppShow as (l: () => void) => void).call(wx, onShow);\n if (typeof host.onAppHide === 'function') (host.onAppHide as (l: () => void) => void).call(wx, onHide);\n const fallback = watchWxVisibility(wx, handler);\n return () => {\n if (typeof host.offAppShow === 'function') (host.offAppShow as (l: () => void) => void).call(wx, onShow);\n if (typeof host.offAppHide === 'function') (host.offAppHide as (l: () => void) => void).call(wx, onHide);\n fallback();\n };\n };\n\n diagnostics.info('mini program canvas resolved', { selector: options.selector, rect: lastRect });\n\n return {\n kind: 'wechat-miniprogram',\n wx,\n rawCanvas,\n capabilities,\n imageFactory,\n getCanvasRect,\n createOffscreenCanvas: (width: number, height: number, type: ContextType) =>\n createOffscreenCanvasRaw(wx, width, height, type, diagnostics),\n // Mini programs deliver touch events through WXML bindings, not wx.onTouch*.\n // The app must forward them: <canvas @touchstart=\"runtime.handleTouch\" ... />\n watchTouch: (_handler: (event: TouchLikeEvent) => void): Disposer => () => undefined,\n watchVisibility,\n requestAnimationFrame: raf.request,\n cancelAnimationFrame: raf.cancel,\n now,\n dispose: () => diagnostics.debug('wechat-miniprogram binding disposed'),\n };\n}\n\nexport type WeChatMiniProgramRuntimeOptions = WeChatMiniProgramOptions & RuntimeOptions;\n\nexport function createWeChatMiniProgramRuntime(\n options: WeChatMiniProgramRuntimeOptions,\n): Promise<MiniThreeRuntime> {\n return createRuntime(() => createWeChatMiniProgramBinding(options), options);\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/platforms/wechat-common.ts","../src/platforms/wx-types.ts"],"names":["_a","_b","raw"],"mappings":"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","file":"chunk-MTBMOFAL.js","sourcesContent":["/** Shared WeChat plumbing used by both mini game and mini program bindings. */\nimport type { ContextType, Disposer, Rect, TouchLikeEvent } from '../types';\nimport type { WxCanvas, WxLike, WxTouchEvent } from './wx-types';\nimport { createImageFactory, type ImageFactory } from '../core/image';\nimport type { Diagnostics } from '../core/diagnostics';\n\nexport function createWechatImageFactory(wx: WxLike, diagnostics?: Diagnostics): ImageFactory {\n return createImageFactory(wx, diagnostics);\n}\n\n/** rAF comes from the global in mini games, from the canvas node in mini programs. */\nexport function createRafPair(\n wx: WxLike,\n canvas?: WxCanvas,\n): { request(cb: (time: number) => void): number; cancel(id: number): void } {\n const host = globalThis as unknown as {\n requestAnimationFrame?: (cb: (time: number) => void) => number;\n cancelAnimationFrame?: (id: number) => void;\n };\n const canvasRaf = canvas?.requestAnimationFrame?.bind(canvas);\n const canvasCaf = canvas?.cancelAnimationFrame?.bind(canvas);\n const request = canvasRaf ?? host.requestAnimationFrame?.bind(host) ??\n ((cb: (time: number) => void) => setTimeout(() => cb(Date.now()), 16) as unknown as number);\n const cancel = canvasCaf ?? host.cancelAnimationFrame?.bind(host) ??\n ((id: number) => clearTimeout(id as unknown as ReturnType<typeof setTimeout>));\n void wx;\n return { request, cancel };\n}\n\nexport function createNow(wx: WxLike): () => number {\n const perf = wx.getPerformance?.();\n if (perf && typeof perf.now === 'function') return () => perf.now();\n const host = globalThis as unknown as { performance?: { now(): number } };\n const hostPerf = host.performance;\n if (hostPerf && typeof hostPerf.now === 'function') return () => hostPerf.now();\n const start = Date.now();\n return () => Date.now() - start;\n}\n\n/** Subscribe to mini game touch events. Mini programs use WXML bindings instead. */\nexport function watchWxTouch(wx: WxLike, handler: (event: TouchLikeEvent) => void): Disposer {\n const methods = ['onTouchStart', 'onTouchMove', 'onTouchEnd', 'onTouchCancel'] as const;\n const offs = ['offTouchStart', 'offTouchMove', 'offTouchEnd', 'offTouchCancel'] as const;\n const attached: Array<[string, (event: WxTouchEvent) => void]> = [];\n methods.forEach((name, index) => {\n const attach = wx[name];\n if (typeof attach !== 'function') return;\n const listener = (event: WxTouchEvent): void => handler(event as TouchLikeEvent);\n attach.call(wx, listener);\n attached.push([offs[index] as string, listener]);\n });\n return () => {\n for (const [off, listener] of attached) {\n const fn = (wx as Record<string, unknown>)[off];\n if (typeof fn === 'function') (fn as (l: unknown) => void).call(wx, listener);\n }\n };\n}\n\nexport function watchWxVisibility(wx: WxLike, handler: (visible: boolean) => void): Disposer {\n const onShow = (): void => handler(true);\n const onHide = (): void => handler(false);\n wx.onShow?.(onShow);\n wx.onHide?.(onHide);\n return () => {\n wx.offShow?.(onShow);\n wx.offHide?.(onHide);\n };\n}\n\n/**\n * WebGL2 capability probe. Uses `createOffscreenCanvas` so the first\n * `wx.createCanvas()` call still produces the on-screen canvas.\n */\nexport function probeContext(wx: WxLike, type: ContextType): boolean {\n if (typeof wx.createOffscreenCanvas !== 'function') return false;\n try {\n const off = wx.createOffscreenCanvas({ width: 1, height: 1, type });\n const ctx = off.getContext(type);\n if (!ctx) return false;\n // Release GPU resources as soon as possible on constrained devices.\n const lose = (ctx as { getExtension?: (name: string) => { loseContext?: () => void } | null }).getExtension;\n lose?.call(ctx, 'WEBGL_lose_context')?.loseContext?.();\n return true;\n } catch {\n return false;\n }\n}\n\nexport function createOffscreenCanvasRaw(\n wx: WxLike,\n width: number,\n height: number,\n type: ContextType,\n diagnostics?: Diagnostics,\n): WxCanvas {\n if (typeof wx.createOffscreenCanvas === 'function') {\n try {\n const raw = wx.createOffscreenCanvas({ width, height, type });\n raw.width = width;\n raw.height = height;\n return raw;\n } catch (error) {\n diagnostics?.warn(`createOffscreenCanvas(${type}) failed, falling back to 2d`, error);\n }\n }\n // Last resort for old base libraries: createCanvas() after the first call is\n // guaranteed to be off-screen, but it still counts against the canvas budget.\n if (typeof wx.createCanvas !== 'function') {\n throw new Error('[mini-three-adapter] no canvas creation API available');\n }\n const raw = wx.createCanvas();\n raw.width = width;\n raw.height = height;\n return raw;\n}\n\nexport function rectFromWindowInfo(wx: WxLike): Rect {\n const info = wx.getWindowInfo?.() ?? wx.getSystemInfoSync?.() ??\n { windowWidth: 0, windowHeight: 0, pixelRatio: 1 };\n return {\n left: 0,\n top: 0,\n width: info.windowWidth,\n height: info.windowHeight,\n right: info.windowWidth,\n bottom: info.windowHeight,\n };\n}\n\nexport function rectFromSelectorResult(result: {\n width?: number; height?: number; top?: number; left?: number; right?: number; bottom?: number;\n}): Rect {\n const width = result.width ?? 0;\n const height = result.height ?? 0;\n const left = result.left ?? 0;\n const top = result.top ?? 0;\n return {\n width, height, left, top,\n right: result.right ?? left + width,\n bottom: result.bottom ?? top + height,\n };\n}\n","/**\n * Hand-written, minimal structural types for the WeChat runtime.\n *\n * Why not `minigame-api-typings`? Because consuming the official typings forces\n * a global `wx` declaration onto every consumer (including browser builds and\n * Node tests) and couples us to a specific version. Structural interfaces let\n * the adapter work with a real `wx`, a mock in tests, or a future platform.\n */\n\nexport interface WxCanvas {\n width: number;\n height: number;\n getContext(type: string, attributes?: Record<string, unknown>): unknown;\n toDataURL?(type?: string, quality?: number): string;\n createImage?(): WxImage;\n requestAnimationFrame?(callback: (time: number) => void): number;\n cancelAnimationFrame?(id: number): void;\n [key: string]: unknown;\n}\n\nexport interface WxImage {\n width: number;\n height: number;\n src: string;\n onload?: ((event?: unknown) => void) | null;\n onerror?: ((error?: unknown) => void) | null;\n complete?: boolean;\n [key: string]: unknown;\n}\n\nexport interface WxRect {\n top: number;\n left: number;\n width: number;\n height: number;\n right: number;\n bottom: number;\n}\n\nexport interface WxWindowInfo {\n windowWidth: number;\n windowHeight: number;\n pixelRatio: number;\n screenWidth?: number;\n screenHeight?: number;\n safeArea?: WxRect;\n}\n\nexport interface WxTouchPoint {\n identifier?: number;\n clientX?: number;\n clientY?: number;\n pageX?: number;\n pageY?: number;\n x?: number;\n y?: number;\n force?: number;\n}\n\nexport interface WxTouchEvent {\n type: string;\n touches?: ArrayLike<WxTouchPoint>;\n changedTouches?: ArrayLike<WxTouchPoint>;\n timeStamp?: number;\n}\n\nexport interface WxRequestResult {\n statusCode: number;\n data: string | ArrayBuffer | Record<string, unknown>;\n header?: Record<string, string>;\n errMsg?: string;\n}\n\nexport interface WxRequestOptions {\n url: string;\n method?: string;\n data?: unknown;\n header?: Record<string, string>;\n responseType?: 'text' | 'arraybuffer';\n timeout?: number;\n success?: (result: WxRequestResult) => void;\n fail?: (error: { errMsg?: string; [key: string]: unknown }) => void;\n}\n\nexport interface WxSelectorQueryResult {\n node?: WxCanvas;\n width?: number;\n height?: number;\n top?: number;\n left?: number;\n right?: number;\n bottom?: number;\n}\n\nexport interface WxSelectorQuery {\n select(selector: string): WxSelectorQuery;\n fields(fields: Record<string, boolean>): WxSelectorQuery;\n exec(callback: (results: (WxSelectorQueryResult | null)[]) => void): void;\n}\n\n/** The subset of `wx` the adapter touches. All members are optional so the\n * same interface can describe a mini game, a mini program or a test mock. */\nexport interface WxLike {\n createCanvas?(): WxCanvas;\n createOffscreenCanvas?(options?: {\n width?: number;\n height?: number;\n type?: '2d' | 'webgl' | 'webgl2';\n }): WxCanvas;\n createImage?(): WxImage;\n createImageData?(width: number, height: number): unknown;\n getWindowInfo?(): WxWindowInfo;\n getSystemInfoSync?(): WxWindowInfo;\n onWindowResize?(listener: (res: { windowWidth: number; windowHeight: number }) => void): void;\n offWindowResize?(listener: (res: { windowWidth: number; windowHeight: number }) => void): void;\n\n onTouchStart?(listener: (event: WxTouchEvent) => void): void;\n onTouchMove?(listener: (event: WxTouchEvent) => void): void;\n onTouchEnd?(listener: (event: WxTouchEvent) => void): void;\n onTouchCancel?(listener: (event: WxTouchEvent) => void): void;\n offTouchStart?(listener: (event: WxTouchEvent) => void): void;\n offTouchMove?(listener: (event: WxTouchEvent) => void): void;\n offTouchEnd?(listener: (event: WxTouchEvent) => void): void;\n offTouchCancel?(listener: (event: WxTouchEvent) => void): void;\n\n onShow?(listener: () => void): void;\n onHide?(listener: () => void): void;\n offShow?(listener: () => void): void;\n offHide?(listener: () => void): void;\n\n request?(options: WxRequestOptions): { abort?(): void };\n createSelectorQuery?(): WxSelectorQuery;\n getPerformance?(): { now(): number };\n setPreferredFramesPerSecond?(fps: number): void;\n triggerGC?(): void;\n createWorker?(path: string, options?: unknown): unknown;\n env?: { USER_DATA_PATH?: string; [key: string]: unknown };\n getSystemInfo?(options: { success?: (info: WxWindowInfo & { SDKVersion?: string }) => void }): void;\n [key: string]: unknown;\n}\n\n/** Resolve `wx` from an explicit injection or from the host global. */\nexport function resolveWx(injected?: WxLike): WxLike {\n if (injected) return injected;\n const host = globalThis as unknown as Record<string, unknown>;\n const wx = host.wx as WxLike | undefined;\n if (!wx) {\n throw new Error(\n '[mini-three-adapter] `wx` is not available. Pass `{ wx }` in options when running outside WeChat (e.g. in Node tests).',\n );\n }\n return wx;\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/platforms/wechat-game.ts"],"names":[],"mappings":"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","file":"chunk-Z7AMDRN3.js","sourcesContent":["/** WeChat Mini Game (小游戏) platform binding. */\nimport type { Capabilities, ContextType, Disposer, Rect, TouchLikeEvent } from '../types';\nimport type { PlatformBinding } from '../core/platform';\nimport { createRuntime, type MiniThreeRuntime, type RuntimeOptions } from '../core/runtime';\nimport { detectCapabilities } from '../core/capabilities';\nimport { createDiagnostics, type Diagnostics } from '../core/diagnostics';\nimport {\n createNow,\n createOffscreenCanvasRaw,\n createRafPair,\n createWechatImageFactory,\n probeContext,\n rectFromWindowInfo,\n watchWxTouch,\n watchWxVisibility,\n} from './wechat-common';\nimport { resolveWx, type WxCanvas, type WxLike } from './wx-types';\n\nexport interface WeChatGameOptions {\n /** Inject a `wx` mock (tests / non-WeChat hosts). */\n wx?: WxLike;\n /**\n * Reuse an existing on-screen canvas. If omitted, the adapter checks\n * `GameGlobal.screencanvas`, `globalThis.canvas` (weapp-adapter) and finally\n * calls `wx.createCanvas()` exactly once.\n */\n canvas?: WxCanvas;\n capabilities?: Partial<Capabilities>;\n diagnostics?: Diagnostics;\n /** Call wx.setPreferredFramesPerSecond(fps) when supported. */\n preferredFps?: number;\n}\n\nlet cachedScreenCanvas: WxCanvas | null = null;\n\n/** Resolve (and memoize) the single on-screen canvas. */\nexport function getScreenCanvas(wx: WxLike, supplied?: WxCanvas): WxCanvas {\n if (supplied) return supplied;\n if (cachedScreenCanvas) return cachedScreenCanvas;\n const host = globalThis as unknown as Record<string, unknown>;\n const gameGlobal = host.GameGlobal as Record<string, unknown> | undefined;\n const existing = (gameGlobal?.screencanvas ?? host.canvas) as WxCanvas | undefined;\n if (existing && typeof existing.getContext === 'function') {\n cachedScreenCanvas = existing;\n return existing;\n }\n if (typeof wx.createCanvas !== 'function') {\n throw new Error('[mini-three-adapter] wx.createCanvas is missing: this is not a WeChat Mini Game runtime');\n }\n cachedScreenCanvas = wx.createCanvas();\n return cachedScreenCanvas;\n}\n\n/** Only for tests: forget the memoized screen canvas. */\nexport function resetScreenCanvasCache(): void {\n cachedScreenCanvas = null;\n}\n\nexport function createWeChatGameBinding(options: WeChatGameOptions = {}): PlatformBinding {\n const wx = resolveWx(options.wx);\n const diagnostics = options.diagnostics ?? createDiagnostics('warn');\n const rawCanvas = getScreenCanvas(wx, options.canvas);\n const capabilities = detectCapabilities(wx, 'wechat-game', {\n overrides: options.capabilities,\n probeContext: (type) => probeContext(wx, type),\n });\n const imageFactory = createWechatImageFactory(wx, diagnostics);\n const raf = createRafPair(wx, rawCanvas);\n const now = createNow(wx);\n\n if (options.preferredFps && typeof wx.setPreferredFramesPerSecond === 'function') {\n wx.setPreferredFramesPerSecond(options.preferredFps);\n }\n\n const getCanvasRect = (): Rect => rectFromWindowInfo(wx);\n\n return {\n kind: 'wechat-game',\n wx,\n rawCanvas,\n capabilities,\n imageFactory,\n getCanvasRect,\n createOffscreenCanvas: (width: number, height: number, type: ContextType) =>\n createOffscreenCanvasRaw(wx, width, height, type, diagnostics),\n watchTouch: (handler: (event: TouchLikeEvent) => void): Disposer => watchWxTouch(wx, handler),\n watchVisibility: (handler) => watchWxVisibility(wx, handler),\n requestAnimationFrame: raf.request,\n cancelAnimationFrame: raf.cancel,\n now,\n dispose: () => {\n // The on-screen canvas belongs to the game; never destroy it here.\n diagnostics.debug('wechat-game binding disposed');\n },\n };\n}\n\nexport type WeChatGameRuntimeOptions = WeChatGameOptions & RuntimeOptions;\n\n/** One-line bootstrap for mini games. */\nexport function createWeChatGameRuntime(\n options: WeChatGameRuntimeOptions = {},\n): Promise<MiniThreeRuntime> {\n return createRuntime(() => createWeChatGameBinding(options), options);\n}\n"]}