@series-inc/stowkit-cli 0.6.34 → 0.6.35

package/templates/engine/scripts/copy-decoders.mjs

@@ -0,0 +1,40 @@
+import { cpSync, mkdirSync, existsSync } from "node:fs"
+import { resolve, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = resolve(__dirname, "..")
+
+function copyDir(src, dest) {
+    if (!existsSync(src)) return false
+    mkdirSync(dest, { recursive: true })
+    cpSync(src, dest, { recursive: true })
+    return true
+}
+
+function copyFile(src, dest) {
+    if (!existsSync(src)) return false
+    mkdirSync(dirname(dest), { recursive: true })
+    cpSync(src, dest)
+    return true
+}
+
+const loaderPkg = resolve(root, "node_modules/@series-inc/stowkit-three-loader/public")
+const readerPkg = resolve(root, "node_modules/@series-inc/stowkit-reader/dist")
+
+let ok = true
+
+// basis/ — engine default path: "basis/"
+ok = copyDir(resolve(loaderPkg, "basis"), resolve(root, "public/basis")) && ok
+
+// stowkit/draco/ — engine default path: "stowkit/draco/"
+ok = copyDir(resolve(loaderPkg, "draco"), resolve(root, "public/stowkit/draco")) && ok
+
+// stowkit_reader.wasm — engine default path: "stowkit_reader.wasm"
+ok = copyFile(resolve(readerPkg, "stowkit_reader.wasm"), resolve(root, "public/stowkit_reader.wasm")) && ok
+
+if (ok) {
+    console.log("Copied WASM decoders to public/")
+} else {
+    console.warn("Warning: some decoder files were not found. Run npm install to ensure all packages are present.")
+}

package/templates/engine/src/Game.ts

@@ -0,0 +1,84 @@
+import * as THREE from "three"
+import { AssetManager, VenusGame } from "@series-inc/rundot-3d-engine"
+import { AudioSystem, PhysicsSystem } from "@series-inc/rundot-3d-engine/systems"
+import RundotGameAPI from "@series-inc/rundot-game-sdk/api"
+import { Prefabs } from "./Prefabs"
+
+export class Game extends VenusGame {
+    protected getConfig() {
+        const isMobile = /Android|iPhone|iPad|iPod/i.test(navigator.userAgent) || "ontouchstart" in window
+        return {
+            backgroundColor: 0x87ceeb,
+            shadowMapEnabled: true,
+            shadowMapType: isMobile ? "basic" as const : "pcf_soft" as const,
+            toneMapping: "linear" as const,
+            toneMappingExposure: 1.0,
+            audioEnabled: true,
+        }
+    }
+
+    protected async onStart(): Promise<void> {
+        this.renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))
+
+        // Initialize engine systems
+        AssetManager.init(this.scene)
+        AudioSystem.initialize()
+        await Promise.all([
+            PhysicsSystem.initialize(),
+            Prefabs.initialize(),
+        ])
+
+        await RundotGameAPI.preloader.setLoaderProgress(0.5)
+
+        this.setupLighting()
+        this.setupCamera()
+
+        // --- Your game setup goes here ---
+
+        await VenusGame.loadingFinished()
+    }
+
+    protected preRender(_deltaTime: number): void {
+        // Called every frame before render. Use for game updates.
+    }
+
+    protected async onDispose(): Promise<void> {
+        // Cleanup when game is destroyed.
+    }
+
+    private setupLighting(): void {
+        const sun = new THREE.DirectionalLight(0xffffff, 1.5)
+        sun.position.set(10, 20, 10)
+        sun.castShadow = true
+        sun.shadow.mapSize.set(1024, 1024)
+        sun.shadow.camera.left = -30
+        sun.shadow.camera.right = 30
+        sun.shadow.camera.top = 30
+        sun.shadow.camera.bottom = -30
+        sun.shadow.camera.near = 1
+        sun.shadow.camera.far = 100
+        this.scene.add(sun)
+        this.scene.add(sun.target)
+
+        const ambient = new THREE.AmbientLight(0xffffff, 0.5)
+        this.scene.add(ambient)
+    }
+
+    private setupCamera(): void {
+        const camera = new THREE.PerspectiveCamera(
+            60,
+            window.innerWidth / window.innerHeight,
+            0.1,
+            500,
+        )
+        camera.position.set(0, 5, 10)
+        camera.lookAt(0, 0, 0)
+        this.scene.add(camera)
+        this.camera = camera
+
+        window.addEventListener("resize", () => {
+            camera.aspect = window.innerWidth / window.innerHeight
+            camera.updateProjectionMatrix()
+        })
+    }
+}

package/templates/engine/src/Prefabs.ts

@@ -0,0 +1,28 @@
+import RundotGameAPI from "@series-inc/rundot-game-sdk/api"
+import { GameObject } from "@series-inc/rundot-3d-engine"
+import { PrefabCollection, PrefabLoader, StowKitSystem } from "@series-inc/rundot-3d-engine/systems"
+
+export class Prefabs {
+    private static collection: PrefabCollection
+
+    private constructor() {
+        throw new Error("Prefabs is a static class and cannot be instantiated")
+    }
+
+    public static async initialize() {
+        const stowkit = StowKitSystem.getInstance()
+
+        const buildJson = (await import("../prefabs/build.json")).default
+        this.collection = await stowkit.loadFromBuildJson(buildJson, {
+            fetchBlob: (path) => RundotGameAPI.cdn.fetchAsset(path)
+        })
+    }
+
+    public static instantiate(name: string, parent?: GameObject) {
+        const prefab = this.collection.getPrefabByName(name)
+        if (!prefab) {
+            throw new Error(`Prefab not found: ${name}`)
+        }
+        return PrefabLoader.instantiatePrefab(prefab, parent)
+    }
+}

package/templates/engine/src/main.ts

@@ -0,0 +1,16 @@
+import "./styles/main.css"
+import RundotGameAPI from "@series-inc/rundot-game-sdk/api"
+import { Game } from "./Game"
+
+;(async function () {
+    try {
+        await RundotGameAPI.preloader.showLoadScreen()
+        await RundotGameAPI.preloader.setLoaderProgress(0)
+
+        const game = await Game.create()
+        ;(window as any).game = game
+    } catch (error) {
+        console.error("Failed to start game:", error)
+        try { await RundotGameAPI.preloader.hideLoadScreen() } catch {}
+    }
+})()

package/templates/engine/src/styles/main.css

@@ -0,0 +1,22 @@
+html, body {
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  padding: 0;
+  overflow: hidden;
+  background-color: #333333;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+#renderCanvas {
+  width: 100%;
+  height: 100%;
+  touch-action: none;
+  outline: none;
+  display: block;
+}
+
+* {
+  -webkit-tap-highlight-color: transparent;
+  box-sizing: border-box;
+}

package/templates/engine/stubs/capacitor.ts

@@ -0,0 +1,6 @@
+// Stub for Capacitor modules - not needed for web-only builds
+export const Capacitor = { isNativePlatform: () => false, getPlatform: () => "web" }
+export const Preferences = { get: async () => ({}), set: async () => {}, remove: async () => {} }
+export const LocalNotifications = { schedule: async () => {}, addListener: () => ({ remove: () => {} }) }
+export const App = { addListener: () => ({ remove: () => {} }) }
+export const SplashScreen = { hide: async () => {} }

package/templates/engine/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "allowJs": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src/**/*", "vite-env.d.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/engine/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/templates/engine/vite.config.ts

@@ -0,0 +1,39 @@
+import { defineConfig } from "vite"
+import wasm from "vite-plugin-wasm"
+import topLevelAwait from "vite-plugin-top-level-await"
+import path from "path"
+
+export default defineConfig(() => ({
+  base: "./",
+  resolve: {
+    dedupe: ['three', '@series-inc/rundot-game-sdk', '@series-inc/stowkit-three-loader', '@series-inc/stowkit-reader'],
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+      "@capacitor/core": path.resolve(__dirname, "./stubs/capacitor.ts"),
+      "@capacitor/app": path.resolve(__dirname, "./stubs/capacitor.ts"),
+      "@capacitor/local-notifications": path.resolve(__dirname, "./stubs/capacitor.ts"),
+      "@capacitor/preferences": path.resolve(__dirname, "./stubs/capacitor.ts"),
+      "@capacitor/splash-screen": path.resolve(__dirname, "./stubs/capacitor.ts"),
+    },
+  },
+  optimizeDeps: {
+    exclude: ["@dimforge/rapier3d"],
+  },
+  server: {
+    port: 3033,
+    host: "0.0.0.0",
+    allowedHosts: true,
+  },
+  build: {
+    outDir: "dist",
+    assetsDir: "assets",
+    emptyOutDir: true,
+    target: "esnext",
+    sourcemap: false,
+  },
+  publicDir: "public",
+  plugins: [
+    wasm(),
+    topLevelAwait(),
+  ],
+}))