@pixifact/platform-douyin 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 youxia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @pixifact/platform-douyin
+
+Pixifact 抖音小游戏 PixiJS 平台适配器。
+
+```bash
+bun add @pixifact/platform-douyin
+```
+
+在 Vite 配置启用 `pixifact()`，并在 mode env 中声明：
+
+```ini
+VITE_PLATFORM=douyin
+VITE_APP_ID=tt123456
+```
+
+游戏入口通过 `pixifact:platform` 使用统一 API：
+
+```ts
+import { createApplication } from 'pixifact:platform';
+
+const app = await createApplication();
+```
+
+返回值是原生 PixiJS `Application`。包的顶层 import 不读取 `tt` 或执行初始化；小游戏构建固定输出 ES2018。资源继续使用 PixiJS `Assets`，分包在首次读取前自动加载。
+
+完整配置见 [抖音小游戏构建](https://github.com/hxg2050/pixifact/blob/main/docs/zh/douyin-minigame.md)。

package/dist/application.d.ts

@@ -0,0 +1,2 @@
+import type { Application, ApplicationOptions } from 'pixi.js';
+export declare function createApplication(options?: Partial<ApplicationOptions>): Promise<Application>;

package/dist/application.js

@@ -0,0 +1,14 @@
+import { createMiniGameApplication } from 'pixifact/internal/minigame';
+import { fetchDouyinResource } from './fetch.js';
+import { installDouyinImageAssets } from './imageAssets.js';
+import { douyinApi } from './types.js';
+function douyinTouchCoordinates(touch) {
+    return {
+        x: touch.screenX ?? touch.clientX ?? touch.x ?? touch.pageX ?? 0,
+        y: touch.screenY ?? touch.clientY ?? touch.y ?? touch.pageY ?? 0,
+    };
+}
+export function createApplication(options = {}) {
+    installDouyinImageAssets();
+    return createMiniGameApplication(douyinApi(), 'DouyinMiniGame', fetchDouyinResource, douyinTouchCoordinates, options);
+}

package/dist/fetch.d.ts

@@ -0,0 +1 @@
+export declare function fetchDouyinResource(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;

package/dist/fetch.js

@@ -0,0 +1,9 @@
+import { fetchMiniGameResource, miniGameResourceSubpackage } from 'pixifact/internal/minigame';
+import { loadDouyinSubpackage } from './subpackage.js';
+import { douyinApi } from './types.js';
+export async function fetchDouyinResource(input, init = {}) {
+    const subpackage = miniGameResourceSubpackage(input);
+    if (subpackage)
+        await loadDouyinSubpackage(subpackage);
+    return fetchMiniGameResource(douyinApi(), input, init, 'Douyin');
+}

package/dist/imageAssets.d.ts

@@ -0,0 +1 @@
+export declare function installDouyinImageAssets(): void;

package/dist/imageAssets.js

@@ -0,0 +1,60 @@
+import { checkDataUrl, checkExtension, createTexture, extensions, ExtensionType, getResolutionOfUrl, ImageSource, LoaderParserPriority, } from 'pixi.js';
+import { douyinApi } from './types.js';
+const validImageExtensions = ['.jpeg', '.jpg', '.png', '.webp', '.avif'];
+const validImageMimes = ['image/jpeg', 'image/png', 'image/webp', 'image/avif'];
+const douyinImageLoaderId = 'pixifact-douyin-image';
+const douyinImageLoader = {
+    extension: {
+        type: ExtensionType.LoadParser,
+        priority: LoaderParserPriority.High + 1,
+        name: 'loadDouyinTextures',
+    },
+    id: douyinImageLoaderId,
+    test(url) {
+        return checkDataUrl(url, validImageMimes) || checkExtension(url, validImageExtensions);
+    },
+    async load(url, asset, loader) {
+        const image = await loadDouyinImage(url);
+        const { width, height } = image;
+        if (!isPositiveDimension(width) || !isPositiveDimension(height)) {
+            throw new Error(`[pixifact-douyin] Loaded image has no usable size: ${url}`);
+        }
+        const resolution = asset.data?.resolution || getResolutionOfUrl(url);
+        const source = new ImageSource({
+            alphaMode: 'premultiply-alpha-on-upload',
+            resolution,
+            ...asset.data,
+            resource: image,
+            width: width / resolution,
+            height: height / resolution,
+        });
+        return createTexture(source, loader, url);
+    },
+    unload(texture) {
+        texture.destroy(true);
+    },
+};
+export function installDouyinImageAssets() {
+    extensions.add(douyinImageLoader);
+}
+function loadDouyinImage(url) {
+    const image = douyinApi().createImage();
+    return new Promise((resolve, reject) => {
+        image.onload = () => {
+            clearImageHandlers(image);
+            resolve(image);
+        };
+        image.onerror = () => {
+            clearImageHandlers(image);
+            reject(new Error(`[pixifact-douyin] Failed to load image: ${url}`));
+        };
+        image.src = url;
+    });
+}
+function clearImageHandlers(image) {
+    image.onload = null;
+    image.onerror = null;
+}
+function isPositiveDimension(value) {
+    return Number.isFinite(value) && value > 0;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createApplication } from './application.js';
+export type { DouyinCanvas, DouyinMiniGameApi } from './types.js';

package/dist/index.js

@@ -0,0 +1 @@
+export { createApplication } from './application.js';

package/dist/input.d.ts

@@ -0,0 +1,5 @@
+import { type MiniGamePointerBinding, type MiniGamePointerEventSink } from 'pixifact/internal/minigame';
+import type { DouyinCanvas } from './types.js';
+export type DouyinPointerEventSink = MiniGamePointerEventSink;
+export type DouyinPointerBinding = MiniGamePointerBinding;
+export declare function bindDouyinPointerEvents(canvas: DouyinCanvas, sink: DouyinPointerEventSink): DouyinPointerBinding;

package/dist/input.js

@@ -0,0 +1,11 @@
+import { bindMiniGamePointerEvents, } from 'pixifact/internal/minigame';
+import { douyinApi } from './types.js';
+function douyinTouchCoordinates(touch) {
+    return {
+        x: touch.screenX ?? touch.clientX ?? touch.x ?? touch.pageX ?? 0,
+        y: touch.screenY ?? touch.clientY ?? touch.y ?? touch.pageY ?? 0,
+    };
+}
+export function bindDouyinPointerEvents(canvas, sink) {
+    return bindMiniGamePointerEvents(douyinApi(), canvas, sink, douyinTouchCoordinates);
+}

package/dist/lifecycle.d.ts

@@ -0,0 +1,6 @@
+import { bindMiniGameLifecycle, type MiniGameLifecycleBinding } from 'pixifact/internal/minigame';
+export type DouyinLifecycleBinding = MiniGameLifecycleBinding;
+export declare function bindDouyinLifecycle(target: Parameters<typeof bindMiniGameLifecycle>[1], options?: {
+    onHide?(): void;
+    onShow?(): void;
+}): DouyinLifecycleBinding;

package/dist/lifecycle.js

@@ -0,0 +1,5 @@
+import { bindMiniGameLifecycle } from 'pixifact/internal/minigame';
+import { douyinApi } from './types.js';
+export function bindDouyinLifecycle(target, options = {}) {
+    return bindMiniGameLifecycle(douyinApi(), target, options);
+}

package/dist/subpackage.d.ts

@@ -0,0 +1 @@
+export declare const loadDouyinSubpackage: (name: string) => Promise<void>;

package/dist/subpackage.js

@@ -0,0 +1,3 @@
+import { createMiniGameSubpackageLoader } from 'pixifact/internal/minigame';
+import { douyinApi } from './types.js';
+export const loadDouyinSubpackage = createMiniGameSubpackageLoader(douyinApi, 'Douyin');

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+import type { MiniGameApi, MiniGameCanvas, MiniGameImage, MiniGameTouch, MiniGameTouchEvent } from 'pixifact/internal/minigame';
+export type DouyinCanvas = MiniGameCanvas;
+export type DouyinImage = MiniGameImage;
+export type DouyinTouch = MiniGameTouch;
+export type DouyinTouchEvent = MiniGameTouchEvent;
+export type DouyinMiniGameApi = MiniGameApi;
+export declare function douyinApi(): MiniGameApi;

package/dist/types.js

@@ -0,0 +1,3 @@
+export function douyinApi() {
+    return globalThis.tt;
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@pixifact/platform-douyin",
+  "version": "0.7.0",
+  "description": "Pixifact 抖音小游戏 PixiJS 平台适配器。",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hxg2050/pixifact",
+    "directory": "packages/platform-douyin"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun ../pixifact/scripts/clean-dist.mjs dist && bunx --no-install tsc -p tsconfig.build.json && bun ../pixifact/scripts/fix-dist-esm-imports.mjs dist"
+  },
+  "peerDependencies": {
+    "pixifact": ">=0.7.0 <1",
+    "pixi.js": ">=8.3.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT"
+}