create-pixi-vn 2.1.3 → 2.1.5

package/template-nqtr-react-vite-muijoy/src/lib/utils/device-diagnostics-utility.ts

@@ -0,0 +1,382 @@
+import packageJson from "@/../package.json";
+import { canvas, PIXIVN_VERSION } from "@drincs/pixi-vn";
+import motionPackageJson from "motion/package.json";
+import { VERSION as PIXIJS_VERSION } from "pixi.js";
+import tonePackageJson from "tone/package.json";
+
+export interface WebglExtensionCheck {
+    name: string;
+    supported: boolean;
+}
+
+export interface WebglDiagnostics {
+    webgl1Supported: boolean;
+    webgl2Supported: boolean;
+    vendor: string | null;
+    renderer: string | null;
+    unmaskedVendor: string | null;
+    unmaskedRenderer: string | null;
+    /** null when it cannot be determined (e.g. WEBGL_debug_renderer_info is blocked). */
+    hardwareAccelerated: boolean | null;
+    maxTextureSize: number | null;
+    floatTexturesSupported: boolean;
+    msaaSupported: boolean;
+    shadersCompile: boolean;
+    keyExtensions: WebglExtensionCheck[];
+    allExtensions: string[];
+}
+
+export interface BrowserCapabilities {
+    audio: boolean;
+    gamepad: boolean;
+    clipboard: boolean;
+    fullscreen: boolean;
+    localStorage: boolean;
+    indexedDb: boolean;
+    /** Best-effort heuristic only: Steam's overlay is compositor-level and generally invisible to page JS. */
+    steamOverlayDetected: boolean;
+}
+
+export interface ResolutionInfo {
+    innerWidth: number;
+    innerHeight: number;
+    screenWidth: number;
+    screenHeight: number;
+    devicePixelRatio: number;
+}
+
+export interface JsMemoryInfo {
+    usedJSHeapSize: number;
+    totalJSHeapSize: number;
+    jsHeapSizeLimit: number;
+}
+
+const KEY_WEBGL_EXTENSIONS = [
+    "WEBGL_debug_renderer_info",
+    "WEBGL_lose_context",
+    "WEBGL_compressed_texture_s3tc",
+    "WEBGL_compressed_texture_astc",
+    "WEBGL_compressed_texture_etc",
+    "OES_texture_float",
+    "OES_texture_float_linear",
+    "OES_texture_half_float",
+    "OES_element_index_uint",
+    "OES_standard_derivatives",
+    "ANGLE_instanced_arrays",
+    "EXT_texture_filter_anisotropic",
+    "EXT_color_buffer_float",
+];
+
+const SOFTWARE_RENDERER_PATTERN =
+    /swiftshader|llvmpipe|software|microsoft basic render|d3d11 warp|apple software renderer/i;
+
+function testShaderCompilation(gl: WebGLRenderingContext | WebGL2RenderingContext): boolean {
+    try {
+        const vertexShader = gl.createShader(gl.VERTEX_SHADER);
+        const fragmentShader = gl.createShader(gl.FRAGMENT_SHADER);
+        if (!vertexShader || !fragmentShader) {
+            return false;
+        }
+
+        gl.shaderSource(
+            vertexShader,
+            "attribute vec2 p; void main() { gl_Position = vec4(p, 0.0, 1.0); }",
+        );
+        gl.compileShader(vertexShader);
+        gl.shaderSource(
+            fragmentShader,
+            "precision mediump float; void main() { gl_FragColor = vec4(1.0); }",
+        );
+        gl.compileShader(fragmentShader);
+        if (
+            !gl.getShaderParameter(vertexShader, gl.COMPILE_STATUS) ||
+            !gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS)
+        ) {
+            return false;
+        }
+
+        const program = gl.createProgram();
+        if (!program) {
+            return false;
+        }
+        gl.attachShader(program, vertexShader);
+        gl.attachShader(program, fragmentShader);
+        gl.linkProgram(program);
+        return !!gl.getProgramParameter(program, gl.LINK_STATUS);
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * Probes a throwaway canvas instead of the live Pixi-VN canvas so this works
+ * regardless of which renderer Pixi actually picked (or before Pixi has initialized).
+ */
+export function getWebglDiagnostics(): WebglDiagnostics {
+    const probeCanvas = document.createElement("canvas");
+    const gl2 = probeCanvas.getContext("webgl2") as WebGL2RenderingContext | null;
+    const gl1 = (probeCanvas.getContext("webgl") ??
+        probeCanvas.getContext("experimental-webgl")) as WebGLRenderingContext | null;
+    const gl = gl2 ?? gl1;
+
+    if (!gl) {
+        return {
+            webgl1Supported: false,
+            webgl2Supported: false,
+            vendor: null,
+            renderer: null,
+            unmaskedVendor: null,
+            unmaskedRenderer: null,
+            hardwareAccelerated: null,
+            maxTextureSize: null,
+            floatTexturesSupported: false,
+            msaaSupported: false,
+            shadersCompile: false,
+            keyExtensions: KEY_WEBGL_EXTENSIONS.map((name) => ({ name, supported: false })),
+            allExtensions: [],
+        };
+    }
+
+    const debugInfo = gl.getExtension("WEBGL_debug_renderer_info");
+    const vendor = (gl.getParameter(gl.VENDOR) as string) ?? null;
+    const renderer = (gl.getParameter(gl.RENDERER) as string) ?? null;
+    const unmaskedVendor = debugInfo
+        ? ((gl.getParameter(debugInfo.UNMASKED_VENDOR_WEBGL) as string) ?? null)
+        : null;
+    const unmaskedRenderer = debugInfo
+        ? ((gl.getParameter(debugInfo.UNMASKED_RENDERER_WEBGL) as string) ?? null)
+        : null;
+    const rendererForHeuristic = unmaskedRenderer ?? renderer;
+    const hardwareAccelerated = rendererForHeuristic
+        ? !SOFTWARE_RENDERER_PATTERN.test(rendererForHeuristic)
+        : null;
+
+    const allExtensions = gl.getSupportedExtensions() ?? [];
+    const keyExtensions = KEY_WEBGL_EXTENSIONS.map((name) => ({
+        name,
+        supported: allExtensions.includes(name),
+    }));
+
+    const maxTextureSize = (gl.getParameter(gl.MAX_TEXTURE_SIZE) as number) ?? null;
+    const floatTexturesSupported = gl2 ? true : allExtensions.includes("OES_texture_float");
+    const msaaSupported = gl2
+        ? ((gl2.getParameter(gl2.MAX_SAMPLES) as number) ?? 0) > 1
+        : (gl.getContextAttributes()?.antialias ?? false);
+    const shadersCompile = testShaderCompilation(gl);
+
+    // This is a throwaway probe context; release it instead of leaving it around.
+    gl.getExtension("WEBGL_lose_context")?.loseContext();
+
+    return {
+        webgl1Supported: !!gl1 || !!gl2,
+        webgl2Supported: !!gl2,
+        vendor,
+        renderer,
+        unmaskedVendor,
+        unmaskedRenderer,
+        hardwareAccelerated,
+        maxTextureSize,
+        floatTexturesSupported,
+        msaaSupported,
+        shadersCompile,
+        keyExtensions,
+        allExtensions,
+    };
+}
+
+export function detectPlatform(): string {
+    const ua = navigator.userAgent;
+    const uaData = (navigator as Navigator & { userAgentData?: { platform?: string } })
+        .userAgentData;
+    const platformHint = uaData?.platform ?? navigator.platform ?? "";
+
+    if (/android/i.test(ua)) return "Android";
+    if (/iphone|ipod/i.test(ua)) return "iOS";
+    // iPadOS reports as "MacIntel" but exposes multi-touch, unlike a real Mac.
+    if (/ipad/i.test(ua) || (/mac/i.test(platformHint) && navigator.maxTouchPoints > 1))
+        return "iOS";
+    if (/mac/i.test(platformHint)) return "macOS";
+    if (/win/i.test(platformHint)) return "Windows";
+    if (/linux/i.test(platformHint)) return "Linux";
+    return "Unknown";
+}
+
+export function detectBrowserEngine(): string {
+    const ua = navigator.userAgent;
+    if (/edg\//i.test(ua)) return "Chromium (Edge)";
+    if (/firefox|fxios/i.test(ua)) return "Gecko (Firefox)";
+    if (/crios/i.test(ua)) return "Chromium (Chrome iOS)";
+    if (/chrome|chromium/i.test(ua)) return "Chromium";
+    if (/safari/i.test(ua)) return "WebKit (Safari)";
+    return "Unknown";
+}
+
+export function getBrowserCapabilities(): BrowserCapabilities {
+    const win = window as Window & {
+        webkitAudioContext?: typeof AudioContext;
+        cefQuery?: unknown;
+    };
+
+    let localStorageAvailable = false;
+    try {
+        const testKey = "__diagnostics_test__";
+        window.localStorage.setItem(testKey, "1");
+        window.localStorage.removeItem(testKey);
+        localStorageAvailable = true;
+    } catch {
+        localStorageAvailable = false;
+    }
+
+    return {
+        audio: typeof AudioContext !== "undefined" || typeof win.webkitAudioContext !== "undefined",
+        gamepad: typeof navigator.getGamepads === "function",
+        clipboard: typeof navigator.clipboard?.writeText === "function",
+        fullscreen: document.fullscreenEnabled === true,
+        localStorage: localStorageAvailable,
+        indexedDb: typeof window.indexedDB !== "undefined",
+        steamOverlayDetected:
+            typeof win.cefQuery === "function" ||
+            /Valve Steam|SteamOverlay/i.test(navigator.userAgent),
+    };
+}
+
+export function getResolutionInfo(): ResolutionInfo {
+    return {
+        innerWidth: window.innerWidth,
+        innerHeight: window.innerHeight,
+        screenWidth: window.screen?.width ?? 0,
+        screenHeight: window.screen?.height ?? 0,
+        devicePixelRatio: window.devicePixelRatio || 1,
+    };
+}
+
+export function getJsMemoryInfo(): JsMemoryInfo | null {
+    const memory = (performance as Performance & { memory?: JsMemoryInfo }).memory;
+    if (!memory) {
+        return null;
+    }
+    return {
+        usedJSHeapSize: memory.usedJSHeapSize,
+        totalJSHeapSize: memory.totalJSHeapSize,
+        jsHeapSizeLimit: memory.jsHeapSizeLimit,
+    };
+}
+
+export function getCurrentFps(): number | null {
+    try {
+        return Math.round(canvas.app.ticker.FPS);
+    } catch {
+        return null;
+    }
+}
+
+export function getGameVersion(): string {
+    return packageJson.version;
+}
+
+export function getPixiJsVersion(): string {
+    return PIXIJS_VERSION;
+}
+
+export function getPixiVnVersion(): string {
+    return PIXIVN_VERSION;
+}
+
+export function getToneJsVersion(): string {
+    return tonePackageJson.version;
+}
+
+export function getMotionVersion(): string {
+    return motionPackageJson.version;
+}
+
+function formatBytes(bytes: number): string {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+export interface DeviceDiagnosticsSnapshot {
+    webgl: WebglDiagnostics;
+    capabilities: BrowserCapabilities;
+    resolution: ResolutionInfo;
+    memory: JsMemoryInfo | null;
+    fps: number | null;
+    userAgent: string;
+    platform: string;
+    browserEngine: string;
+    gameVersion: string;
+    pixiJsVersion: string;
+    pixiVnVersion: string;
+    toneJsVersion: string;
+    motionVersion: string;
+}
+
+export function buildDiagnosticsReportText(snapshot: DeviceDiagnosticsSnapshot): string {
+    const { webgl, capabilities, resolution, memory, fps } = snapshot;
+    const yn = (value: boolean | null) => (value === null ? "Unknown" : value ? "Yes" : "No");
+
+    const lines = [
+        "=== Device Diagnostics Report ===",
+        `Game version: ${snapshot.gameVersion}`,
+        `PixiJS version: ${snapshot.pixiJsVersion}`,
+        `Pixi'VN version: ${snapshot.pixiVnVersion}`,
+        `Tone.js version: ${snapshot.toneJsVersion}`,
+        `Motion version: ${snapshot.motionVersion}`,
+        `User Agent: ${snapshot.userAgent}`,
+        `Platform: ${snapshot.platform}`,
+        `Browser/WebView: ${snapshot.browserEngine}`,
+        "",
+        "-- Graphics --",
+        `WebGL1 available: ${yn(webgl.webgl1Supported)}`,
+        `WebGL2 available: ${yn(webgl.webgl2Supported)}`,
+        `Hardware acceleration: ${yn(webgl.hardwareAccelerated)}`,
+        `GPU vendor: ${webgl.unmaskedVendor ?? webgl.vendor ?? "Unknown"}`,
+        `GPU renderer: ${webgl.unmaskedRenderer ?? webgl.renderer ?? "Unknown"}`,
+        `Max texture size: ${webgl.maxTextureSize ?? "Unknown"}`,
+        `Float textures: ${yn(webgl.floatTexturesSupported)}`,
+        `MSAA: ${yn(webgl.msaaSupported)}`,
+        `Shaders compile: ${yn(webgl.shadersCompile)}`,
+        `WebGL extensions: ${webgl.keyExtensions
+            .filter((extension) => extension.supported)
+            .map((extension) => extension.name)
+            .join(", ")}`,
+        "",
+        "-- Display --",
+        `Resolution: ${resolution.innerWidth}x${resolution.innerHeight} (screen ${resolution.screenWidth}x${resolution.screenHeight})`,
+        `Device pixel ratio: ${resolution.devicePixelRatio}`,
+        `FPS: ${fps ?? "Unknown"}`,
+        "",
+        "-- Memory --",
+        memory
+            ? `JS heap: ${formatBytes(memory.usedJSHeapSize)} / ${formatBytes(memory.totalJSHeapSize)} (limit ${formatBytes(memory.jsHeapSizeLimit)})`
+            : "JS heap: Not available in this browser",
+        "",
+        "-- Browser capabilities --",
+        `Audio (Web Audio API): ${yn(capabilities.audio)}`,
+        `Gamepad API: ${yn(capabilities.gamepad)}`,
+        `Clipboard API: ${yn(capabilities.clipboard)}`,
+        `Fullscreen API: ${yn(capabilities.fullscreen)}`,
+        `LocalStorage: ${yn(capabilities.localStorage)}`,
+        `IndexedDB: ${yn(capabilities.indexedDb)}`,
+        `Steam Overlay detected (best-effort): ${yn(capabilities.steamOverlayDetected)}`,
+    ];
+
+    return lines.join("\n");
+}
+
+export function buildDiagnosticsReportJson(snapshot: DeviceDiagnosticsSnapshot): object {
+    return {
+        generatedAt: new Date().toISOString(),
+        ...snapshot,
+    };
+}
+
+export function downloadDiagnosticsReportJson(snapshot: DeviceDiagnosticsSnapshot) {
+    const jsonString = JSON.stringify(buildDiagnosticsReportJson(snapshot), null, 2);
+    const blob = new Blob([jsonString], { type: "application/json" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = `${__APP_NAME__}-${__APP_VERSION__}-diagnostics-${Date.now()}.json`;
+    a.click();
+    URL.revokeObjectURL(url);
+}

package/template-nqtr-react-vite-muijoy/src/locales/en.json

@@ -63,6 +63,56 @@
     "name": "Name",
     "version": "Version",
     "engine": "Engine",
+    "diagnostics": "Diagnostics",
+    "diagnostics_yes": "Yes",
+    "diagnostics_no": "No",
+    "diagnostics_unknown": "Unknown",
+    "diagnostics_webgl2_missing_message": "This game requires WebGL2. Please update your browser, operating system, or GPU drivers.",
+    "diagnostics_section_engine": "Engine",
+    "diagnostics_section_device": "Device",
+    "diagnostics_section_graphics": "Graphics",
+    "diagnostics_section_display": "Display",
+    "diagnostics_section_memory": "Memory",
+    "diagnostics_section_capabilities": "Browser Capabilities",
+    "diagnostics_section_extensions": "WebGL Extensions",
+    "diagnostics_game_version": "Game version",
+    "diagnostics_pixijs_version": "PixiJS version",
+    "diagnostics_pixivn_version": "Pixi'VN version",
+    "diagnostics_tonejs_version": "Tone.js version",
+    "diagnostics_motion_version": "Motion version",
+    "diagnostics_platform": "Platform",
+    "diagnostics_browser_engine": "Browser/WebView",
+    "diagnostics_user_agent": "User Agent",
+    "diagnostics_webgl1": "WebGL1 available",
+    "diagnostics_webgl2": "WebGL2 available",
+    "diagnostics_hardware_acceleration": "Hardware acceleration",
+    "diagnostics_gpu_vendor": "GPU vendor",
+    "diagnostics_gpu_renderer": "GPU renderer",
+    "diagnostics_max_texture_size": "Max texture size",
+    "diagnostics_max_texture_size_check": "Max texture size >= 8192",
+    "diagnostics_gpu_supported": "GPU supported",
+    "diagnostics_float_textures": "Float textures",
+    "diagnostics_msaa": "MSAA",
+    "diagnostics_shaders_compile": "Shaders compile",
+    "diagnostics_resolution": "Resolution",
+    "diagnostics_device_pixel_ratio": "Device pixel ratio",
+    "diagnostics_fps": "FPS",
+    "diagnostics_js_heap": "JS heap used / total",
+    "diagnostics_js_heap_unavailable": "Not available in this browser.",
+    "diagnostics_audio": "Audio (Web Audio API)",
+    "diagnostics_gamepad": "Gamepad API",
+    "diagnostics_clipboard": "Clipboard API",
+    "diagnostics_fullscreen": "Fullscreen API",
+    "diagnostics_local_storage": "LocalStorage",
+    "diagnostics_indexed_db": "IndexedDB",
+    "diagnostics_steam_overlay": "Steam Overlay",
+    "diagnostics_steam_overlay_hint": "Best-effort detection only; not reliable in a standard browser.",
+    "diagnostics_copy_report": "Copy report",
+    "diagnostics_report_copied": "Report copied to clipboard",
+    "diagnostics_report_copy_failed": "Could not copy the report",
+    "diagnostics_download_report": "Download JSON",
+    "diagnostics_report_downloaded": "Report downloaded",
+    "diagnostics_hotkey_description": "Open settings directly on the diagnostics page.",
     "quick_actions": "Quick Actions",
     "quick_actions_open_description": "Press Tab to open or close the quick actions wheel.",
     "quick_actions_click_hint": "Click an action to execute",

package/template-nqtr-react-vite-muijoy/src/pixi-vn.keys.gen.ts

@@ -24,7 +24,6 @@ declare module "@drincs/pixi-vn/narration" {
 }
 declare module "@drincs/pixi-vn/canvas" {
     interface PixivnBundleIds {
-        "default": never;
         "audio": never;
         "/": never;
         "main_map": never;
@@ -39,8 +38,6 @@ declare module "@drincs/pixi-vn/canvas" {
         "alice": never;
     }
     interface PixivnAssetAliasIds {
-        "bgm_cheerful": never;
-        "sfx_whoosh": never;
         "background_main_menu": never;
         "map-0": never;
         "map-1": never;
@@ -80,7 +77,7 @@ export const characterIds = ["mc","alice"] as const;
 export const characterIdsEnum = {"mc":"mc","alice":"alice"} as const;
 export const labelIds = ["sleep_1_hour","nap_1_hour","sleep","nap","start","order_product","talk_alice_sleep_result","talk_alice_sleep","talk_alice","alice_talk_menu","take_product"] as const;
 export const labelIdsEnum = {"sleep_1_hour":"sleep_1_hour","nap_1_hour":"nap_1_hour","sleep":"sleep","nap":"nap","start":"start","order_product":"order_product","talk_alice_sleep_result":"talk_alice_sleep_result","talk_alice_sleep":"talk_alice_sleep","talk_alice":"talk_alice","alice_talk_menu":"alice_talk_menu","take_product":"take_product"} as const;
-export const bundleIds = ["default","audio","/","main_map","nightcity_map","mc_room","alice_room","ann_room","bathroom","lounge","terrace","gym_room","alice"] as const;
-export const bundleIdsEnum = {"default":"default","audio":"audio","/":"/","main_map":"main_map","nightcity_map":"nightcity_map","mc_room":"mc_room","alice_room":"alice_room","ann_room":"ann_room","bathroom":"bathroom","lounge":"lounge","terrace":"terrace","gym_room":"gym_room","alice":"alice"} as const;
-export const assetAliasIds = ["bgm_cheerful","sfx_whoosh","background_main_menu","map-0","map-1","map-2","map-3","icon_location_home","icon_location_gym","map-nightcity","location_myroom-0","location_myroom-1","location_myroom-2","location_myroom-3","location_aliceroom-0","location_aliceroom-1","location_aliceroom-2","location_aliceroom-3","location_annroom-0","location_annroom-1","location_annroom-2","location_annroom-3","location_bathroom","location_lounge-0","location_lounge-1","location_lounge-2","location_lounge-3","location_terrace-0","location_terrace-1","location_terrace-2","location_terrace-3","location_gym","alice_terrace0A","alice_terrace0At","alice_roomsleep0A"] as const;
-export const assetAliasIdsEnum = {"bgm_cheerful":"bgm_cheerful","sfx_whoosh":"sfx_whoosh","background_main_menu":"background_main_menu","map-0":"map-0","map-1":"map-1","map-2":"map-2","map-3":"map-3","icon_location_home":"icon_location_home","icon_location_gym":"icon_location_gym","map-nightcity":"map-nightcity","location_myroom-0":"location_myroom-0","location_myroom-1":"location_myroom-1","location_myroom-2":"location_myroom-2","location_myroom-3":"location_myroom-3","location_aliceroom-0":"location_aliceroom-0","location_aliceroom-1":"location_aliceroom-1","location_aliceroom-2":"location_aliceroom-2","location_aliceroom-3":"location_aliceroom-3","location_annroom-0":"location_annroom-0","location_annroom-1":"location_annroom-1","location_annroom-2":"location_annroom-2","location_annroom-3":"location_annroom-3","location_bathroom":"location_bathroom","location_lounge-0":"location_lounge-0","location_lounge-1":"location_lounge-1","location_lounge-2":"location_lounge-2","location_lounge-3":"location_lounge-3","location_terrace-0":"location_terrace-0","location_terrace-1":"location_terrace-1","location_terrace-2":"location_terrace-2","location_terrace-3":"location_terrace-3","location_gym":"location_gym","alice_terrace0A":"alice_terrace0A","alice_terrace0At":"alice_terrace0At","alice_roomsleep0A":"alice_roomsleep0A"} as const;
+export const bundleIds = ["audio","/","main_map","nightcity_map","mc_room","alice_room","ann_room","bathroom","lounge","terrace","gym_room","alice"] as const;
+export const bundleIdsEnum = {"audio":"audio","/":"/","main_map":"main_map","nightcity_map":"nightcity_map","mc_room":"mc_room","alice_room":"alice_room","ann_room":"ann_room","bathroom":"bathroom","lounge":"lounge","terrace":"terrace","gym_room":"gym_room","alice":"alice"} as const;
+export const assetAliasIds = ["background_main_menu","map-0","map-1","map-2","map-3","icon_location_home","icon_location_gym","map-nightcity","location_myroom-0","location_myroom-1","location_myroom-2","location_myroom-3","location_aliceroom-0","location_aliceroom-1","location_aliceroom-2","location_aliceroom-3","location_annroom-0","location_annroom-1","location_annroom-2","location_annroom-3","location_bathroom","location_lounge-0","location_lounge-1","location_lounge-2","location_lounge-3","location_terrace-0","location_terrace-1","location_terrace-2","location_terrace-3","location_gym","alice_terrace0A","alice_terrace0At","alice_roomsleep0A"] as const;
+export const assetAliasIdsEnum = {"background_main_menu":"background_main_menu","map-0":"map-0","map-1":"map-1","map-2":"map-2","map-3":"map-3","icon_location_home":"icon_location_home","icon_location_gym":"icon_location_gym","map-nightcity":"map-nightcity","location_myroom-0":"location_myroom-0","location_myroom-1":"location_myroom-1","location_myroom-2":"location_myroom-2","location_myroom-3":"location_myroom-3","location_aliceroom-0":"location_aliceroom-0","location_aliceroom-1":"location_aliceroom-1","location_aliceroom-2":"location_aliceroom-2","location_aliceroom-3":"location_aliceroom-3","location_annroom-0":"location_annroom-0","location_annroom-1":"location_annroom-1","location_annroom-2":"location_annroom-2","location_annroom-3":"location_annroom-3","location_bathroom":"location_bathroom","location_lounge-0":"location_lounge-0","location_lounge-1":"location_lounge-1","location_lounge-2":"location_lounge-2","location_lounge-3":"location_lounge-3","location_terrace-0":"location_terrace-0","location_terrace-1":"location_terrace-1","location_terrace-2":"location_terrace-2","location_terrace-3":"location_terrace-3","location_gym":"location_gym","alice_terrace0A":"alice_terrace0A","alice_terrace0At":"alice_terrace0At","alice_roomsleep0A":"alice_roomsleep0A"} as const;

package/template-nqtr-react-vite-muijoy-ink/.assetpack.ts

@@ -1,5 +1,83 @@
-import type { AssetPackConfig } from "@assetpack/core";
+import type { AssetPackConfig, AssetPipe } from "@assetpack/core";
+import { path } from "@assetpack/core";
 import { pixiPipes } from "@assetpack/core/pixi";
+import fs from "node:fs/promises";
+
+const manifestOutput = "src/assets/manifest.gen.json";
+
+/**
+ * AssetPack only creates a manifest bundle for folders explicitly tagged
+ * with "{m}" (see pixiManifest's `manifest` tag); everything else lands in
+ * the single "default" bundle. This splits the "default" bundle into one
+ * bundle per top-level folder under the assets entry, named after that
+ * folder, so bundles mirror the folder structure without needing to tag
+ * every folder manually. Files directly at the entry root (no folder) stay
+ * in "default". Runs after the manifest has been written to disk, so it
+ * re-reads and rewrites the file.
+ */
+function groupBundlesByFolder(options: { output: string }): AssetPipe<{ output: string }> {
+    return {
+        name: "group-bundles-by-folder",
+        defaultOptions: options,
+        async finish(_asset, opts) {
+            const manifest = JSON.parse(await fs.readFile(opts.output, "utf-8"));
+
+            const bundles = new Map<string, { name: string; assets: unknown[] }>();
+            for (const bundle of manifest.bundles) {
+                if (bundle.name !== "default") {
+                    bundles.set(bundle.name, bundle);
+                    continue;
+                }
+                for (const asset of bundle.assets) {
+                    const folder = path.dirname(asset.src[0]).split("/")[0];
+                    const bundleName = folder === "." ? "default" : folder;
+                    const target = bundles.get(bundleName) ?? { name: bundleName, assets: [] };
+                    target.assets.push(asset);
+                    bundles.set(bundleName, target);
+                }
+            }
+            manifest.bundles = [...bundles.values()];
+
+            await fs.writeFile(opts.output, JSON.stringify(manifest, null, 2));
+        },
+    };
+}
+
+/**
+ * Removes file extensions from the aliases generated by the pixi manifest
+ * pipe and replaces path separators with underscores (e.g.
+ * "yard/yard1.png" -> "yard_yard1"). Runs after the manifest has been
+ * written to disk, so it re-reads and rewrites the file.
+ *
+ * If two assets end up with the same normalized alias, the later one is
+ * prefixed with its bundle name (e.g. "yard_yard_yard1") to keep aliases
+ * unique across the whole manifest.
+ */
+function normalizeAliases(options: { output: string }): AssetPipe<{ output: string }> {
+    return {
+        name: "normalize-aliases",
+        defaultOptions: options,
+        async finish(_asset, opts) {
+            const manifest = JSON.parse(await fs.readFile(opts.output, "utf-8"));
+
+            const seen = new Set<string>();
+            for (const bundle of manifest.bundles) {
+                for (const asset of bundle.assets) {
+                    asset.alias = asset.alias.map((alias: string) => {
+                        const normalized = path.trimExt(alias).replaceAll("/", "_");
+                        const unique = seen.has(normalized)
+                            ? `${bundle.name}_${normalized}`
+                            : normalized;
+                        seen.add(normalized);
+                        return unique;
+                    });
+                }
+            }
+
+            await fs.writeFile(opts.output, JSON.stringify(manifest, null, 2));
+        },
+    };
+}
 
 const config: AssetPackConfig = {
     entry: "./src/assets",
@@ -8,10 +86,12 @@ const config: AssetPackConfig = {
     pipes: [
         ...pixiPipes({
             manifest: {
-                output: "src/assets/manifest.gen.json",
+                output: manifestOutput,
                 createShortcuts: true,
             },
         }),
+        groupBundlesByFolder({ output: manifestOutput }),
+        normalizeAliases({ output: manifestOutput }),
     ],
 };
 

package/template-nqtr-react-vite-muijoy-ink/package.json

@@ -19,9 +19,9 @@
   },
   "dependencies": {
     "@base-ui/react": "^1.6.0",
-    "@drincs/nqtr": "^1.0.2",
-    "@drincs/pixi-vn": "^1.8.21",
-    "@drincs/pixi-vn-ink": "^1.1.4",
+    "@drincs/nqtr": "^1.0.3",
+    "@drincs/pixi-vn": "^1.8.25",
+    "@drincs/pixi-vn-ink": "^1.1.9",
     "@tailwindcss/vite": "^4.3.0",
     "@tanstack/hotkeys": "^0.8.0",
     "@tanstack/react-hotkeys": "^0.10.0",

package/template-nqtr-react-vite-muijoy-ink/src/assets/index.ts

@@ -14,16 +14,7 @@ export const manifest: AssetsManifest = {
         ...generatedManifestJson.bundles,
         {
             name: AUDIO_BUNDLE_NAME,
-            assets: [
-                {
-                    alias: "bgm_cheerful",
-                    src: "https://raw.githubusercontent.com/DRincs-Productions/pixi-vn-bucket/refs/heads/main/audio/bgm_cheerful.wav",
-                },
-                {
-                    alias: "sfx_whoosh",
-                    src: "https://raw.githubusercontent.com/DRincs-Productions/pixi-vn-bucket/refs/heads/main/audio/sfx_whoosh.wav",
-                },
-            ],
+            assets: [],
         },
         // screens
         {
@@ -31,7 +22,7 @@ export const manifest: AssetsManifest = {
             assets: [
                 {
                     alias: "background_main_menu",
-                    src: "https://raw.githubusercontent.com/DRincs-Productions/pixi-vn-bucket/refs/heads/main/main-menu.png",
+                    src: "https://pub-72ff059a2c6642fb9eab15df80fb3b45.r2.dev/main-menu.png",
                 },
             ],
         },

package/template-nqtr-react-vite-muijoy-ink/src/assets/manifest.gen.json

@@ -1,8 +1,3 @@
 {
-  "bundles": [
-    {
-      "name": "default",
-      "assets": []
-    }
-  ]
-}
+  "bundles": []
+}