@evitcastudio/kit 3.2.2 → 3.3.0

package/lib/bundle/cli/kit-game-templates/single/_gitignore

@@ -1,180 +1,180 @@
-dist/
-lib/
-**/resource.json
-tests/temp/
-
-# Based on https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore
-
-# Logs
-
-logs
-_.log
-npm-debug.log_
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
-
-# Caches
-
-.cache
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-
-report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
-
-# Runtime data
-
-pids
-_.pid
-_.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-
-lib-cov
-
-# Coverage directory used by tools like istanbul
-
-coverage
-*.lcov
-
-# nyc test coverage
-
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-
-bower_components
-
-# node-waf configuration
-
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-
-build/Release
-
-# Dependency directories
-
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-
-web_modules/
-
-# TypeScript cache
-
-*.tsbuildinfo
-
-# Optional npm cache directory
-
-.npm
-
-# Optional eslint cache
-
-.eslintcache
-
-# Optional stylelint cache
-
-.stylelintcache
-
-# Microbundle cache
-
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-
-.node_repl_history
-
-# Output of 'npm pack'
-
-*.tgz
-
-# Yarn Integrity file
-
-.yarn-integrity
-
-# dotenv environment variable files
-
-.env
-.env.development.local
-.env.test.local
-.env.production.local
-.env.local
-
-# parcel-bundler cache (https://parceljs.org/)
-
-.parcel-cache
-
-# Next.js build output
-
-.next
-out
-
-# Nuxt.js build / generate output
-
-.nuxt
-dist
-
-# Gatsby files
-
-# Comment in the public line in if your project uses Gatsby and not Next.js
-
-# https://nextjs.org/blog/next-9-1#public-directory-support
-
-# public
-
-# vuepress build output
-
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-
-.temp
-
-# Docusaurus cache and generated files
-
-.docusaurus
-
-# Serverless directories
-
-.serverless/
-
-# FuseBox cache
-
-.fusebox/
-
-# DynamoDB Local files
-
-.dynamodb/
-
-# TernJS port file
-
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-
-.vscode-test
-
-# yarn v2
-
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-
-# IntelliJ based IDEs
-.idea
-
-# Finder (MacOS) folder config
-.DS_Store
+dist/
+lib/
+**/resource.json
+tests/temp/
+
+# Based on https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore
+
+# Logs
+
+logs
+_.log
+npm-debug.log_
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Caches
+
+.cache
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# Runtime data
+
+pids
+_.pid
+_.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+
+lib-cov
+
+# Coverage directory used by tools like istanbul
+
+coverage
+*.lcov
+
+# nyc test coverage
+
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+
+bower_components
+
+# node-waf configuration
+
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+
+build/Release
+
+# Dependency directories
+
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+
+web_modules/
+
+# TypeScript cache
+
+*.tsbuildinfo
+
+# Optional npm cache directory
+
+.npm
+
+# Optional eslint cache
+
+.eslintcache
+
+# Optional stylelint cache
+
+.stylelintcache
+
+# Microbundle cache
+
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+
+.node_repl_history
+
+# Output of 'npm pack'
+
+*.tgz
+
+# Yarn Integrity file
+
+.yarn-integrity
+
+# dotenv environment variable files
+
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+
+.parcel-cache
+
+# Next.js build output
+
+.next
+out
+
+# Nuxt.js build / generate output
+
+.nuxt
+dist
+
+# Gatsby files
+
+# Comment in the public line in if your project uses Gatsby and not Next.js
+
+# https://nextjs.org/blog/next-9-1#public-directory-support
+
+# public
+
+# vuepress build output
+
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+
+.temp
+
+# Docusaurus cache and generated files
+
+.docusaurus
+
+# Serverless directories
+
+.serverless/
+
+# FuseBox cache
+
+.fusebox/
+
+# DynamoDB Local files
+
+.dynamodb/
+
+# TernJS port file
+
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+
+.vscode-test
+
+# yarn v2
+
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

package/lib/bundle/cli/kit-game-templates/single/package.json

@@ -10,8 +10,14 @@
   },
   "scripts": {
     "build": "kit build",
+    "build:prod": "kit build --prod",
     "watch": "kit build --watch",
-    "host": "kit host -b"
+    "dev": "kit host -b",
+    "start": "kit host",
+    "host": "kit host -b",
+    "host:prod": "kit host -b --prod",
+    "doctor": "kit doctor",
+    "create:plugin": "kit create plugin"
   },
   "keywords": [],
   "dependencies": {

package/lib/bundle/cli/kit-game-templates/single/resource.json

@@ -1 +1,7 @@
-{}
+{
+  "interface": [],
+  "icon": [],
+  "map": [],
+  "sound": [],
+  "macros": []
+}

package/lib/cli/app-bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-bundler.d.ts","sourceRoot":"","sources":["../../src/cli/app-bundler.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,mBAAmB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAYvE;AA+DD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6KhI"}
+{"version":3,"file":"app-bundler.d.ts","sourceRoot":"","sources":["../../src/cli/app-bundler.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,EAAE,mBAAmB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAYvE;AA+DD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyLhI"}

package/lib/cli/app-bundler.js

@@ -123,7 +123,11 @@ export async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
             const startStamp = Date.now();
             const clientResult = await Bun.build({
                 entrypoints: [join(srcDir, 'index.ts')],
-                naming: 'index.js',
+                naming: {
+                    entry: 'index.[ext]',
+                    chunk: '[name]-[hash].[ext]',
+                    asset: '[name].[ext]'
+                },
                 outdir: pOutDir,
                 target: 'browser',
                 banner,
@@ -162,7 +166,11 @@ export async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
                 const clientStart = Date.now();
                 const clientResult = await Bun.build({
                     entrypoints: [clientEntry],
-                    naming: 'index.js',
+                    naming: {
+                        entry: 'index.[ext]',
+                        chunk: '[name]-[hash].[ext]',
+                        asset: '[name].[ext]'
+                    },
                     outdir: pOutDir,
                     target: 'browser',
                     banner,
@@ -189,7 +197,11 @@ export async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
                 const serverStart = Date.now();
                 const serverResult = await Bun.build({
                     entrypoints: [serverEntry],
-                    naming: 'server.js',
+                    naming: {
+                        entry: 'server.[ext]',
+                        chunk: '[name]-[hash].[ext]',
+                        asset: '[name].[ext]'
+                    },
                     outdir: pOutDir,
                     target: 'node',
                     banner,

package/lib/cli/resource-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-builder.d.ts","sourceRoot":"","sources":["../../src/cli/resource-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA+gB9C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvL"}
+{"version":3,"file":"resource-builder.d.ts","sourceRoot":"","sources":["../../src/cli/resource-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0oB9C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvL"}

package/lib/cli/resource-builder.js

@@ -1,6 +1,7 @@
-import { promises as fs, watch as fsWatch, existsSync } from 'fs';
-import { join, extname, basename, resolve } from 'path';
+import { promises as fs, existsSync } from 'fs';
+import { join, extname, basename, resolve, relative } from 'path';
 import chalk from 'chalk';
+import { watch as chokidarWatch } from 'chokidar';
 import { v4 as uuidv4 } from 'uuid';
 import { VYI } from '../vendor/vyi';
 import { bundleApp } from './app-bundler';
@@ -130,7 +131,8 @@ async function mirrorDirectory(pSourceDir, pDestDir) {
             const ext = extname(entry.name).slice(1);
             // Copy all assets except internal Vylocity engine binary formats
             if (!isEngineExtension(ext)) {
-                await fs.copyFile(srcPath, destPath);
+                const data = await fs.readFile(srcPath);
+                await fs.writeFile(destPath, data);
             }
         }
     }
@@ -374,7 +376,11 @@ async function clearResourceTypeDirectories(pBaseDirectory) {
 async function copyFile(pSource, pDestinationDir, pNewName) {
     try {
         await fs.mkdir(pDestinationDir, { recursive: true });
-        await fs.copyFile(pSource, join(pDestinationDir, pNewName));
+        // Use readFile + writeFile instead of fs.copyFile to avoid macOS APFS
+        // clone operations, which emit phantom FSEvents on the source file and
+        // cause external editors (e.g. Viewer) to falsely detect modifications.
+        const data = await fs.readFile(pSource);
+        await fs.writeFile(join(pDestinationDir, pNewName), data);
     }
     catch (pError) {
         logError(`[Error] Copying file ${pSource}: ${pError}`);
@@ -430,39 +436,139 @@ async function runBuild() {
  */
 async function runWatch() {
     await runBuild();
-    console.log(chalk.cyan(`\nWatching for changes in: ${chalk.bold(resourceInDirectory)}`));
+    const pathsToWatch = [];
+    if (existsSync(resourceInDirectory)) {
+        pathsToWatch.push(resourceInDirectory);
+    }
+    const srcDir = join(projectRootDirectory, 'src');
+    if (shouldBundleApp && existsSync(srcDir) && srcDir !== resourceInDirectory) {
+        pathsToWatch.push(srcDir);
+    }
+    const displayPaths = pathsToWatch
+        .map(p => chalk.bold(relative(projectRootDirectory, p) || p))
+        .join(', ');
+    console.log(chalk.cyan(`\nWatching for changes in: ${displayPaths}`));
     let debounceTimer = null;
+    let isRebuilding = false;
+    let queuedChange = null;
     const triggerRebuild = (pFilename) => {
         if (debounceTimer)
             clearTimeout(debounceTimer);
         debounceTimer = setTimeout(async () => {
-            console.log(chalk.dim(`\nFile changed: ${pFilename}, rebuilding...`));
-            await runBuild();
+            if (isRebuilding) {
+                queuedChange = pFilename;
+                return;
+            }
+            isRebuilding = true;
+            try {
+                console.log(chalk.dim(`\nFile changed: ${pFilename}, rebuilding...`));
+                await runBuild();
+            }
+            finally {
+                isRebuilding = false;
+                if (queuedChange) {
+                    const next = queuedChange;
+                    queuedChange = null;
+                    triggerRebuild(next);
+                }
+            }
         }, 150);
     };
-    const watchers = [];
-    if (existsSync(resourceInDirectory)) {
-        const resWatcher = fsWatch(resourceInDirectory, { recursive: true }, (_eventType, pFilename) => {
-            if (pFilename)
-                triggerRebuild(pFilename);
-        });
-        watchers.push(resWatcher);
-    }
-    const srcDir = join(projectRootDirectory, 'src');
-    if (shouldBundleApp && existsSync(srcDir) && srcDir !== resourceInDirectory) {
-        const srcWatcher = fsWatch(srcDir, { recursive: true }, (_eventType, pFilename) => {
-            if (!pFilename)
-                return;
-            // Ignore resources folder if inside src to prevent double triggers
-            if (pFilename.startsWith('resources'))
-                return;
-            triggerRebuild(pFilename);
-        });
-        watchers.push(srcWatcher);
+    const normalizedOutDir = resourceOutDirectory ? resourceOutDirectory.replace(/\\/g, '/') : '';
+    const isIgnored = (pPath) => {
+        const normalized = pPath.replace(/\\/g, '/');
+        // Ignore output directory
+        if (normalizedOutDir && (normalized === normalizedOutDir || normalized.startsWith(`${normalizedOutDir}/`))) {
+            return true;
+        }
+        // Ignore VCS and dependency folders
+        if (/(^|[/\\])(\.git|node_modules|\.DS_Store|Thumbs\.db)($|[/\\])/.test(normalized)) {
+            return true;
+        }
+        // Ignore vendor directory (precompiled/static vendor assets)
+        if (/(^|[/\\])vendor([/\\]|$)/.test(normalized)) {
+            return true;
+        }
+        // Ignore sourcemaps
+        if (normalized.endsWith('.map')) {
+            return true;
+        }
+        // Ignore generated manifest metadata files in project root
+        if (normalized.endsWith('resource.json') ||
+            normalized.endsWith('bounds.json') ||
+            normalized.endsWith('icon-points.json') ||
+            normalized.endsWith('sizes.json')) {
+            return true;
+        }
+        return false;
+    };
+    // Track known file modification times and sizes to eliminate phantom change events from copy/read operations
+    const fileStats = new Map();
+    const recordFileStat = async (pFilePath) => {
+        try {
+            const stats = await fs.stat(pFilePath);
+            if (stats.isFile()) {
+                fileStats.set(resolve(pFilePath), { mtime: stats.mtimeMs, size: stats.size });
+            }
+        }
+        catch {
+            // Ignored
+        }
+    };
+    const primeDirectoryStats = async (pDirPath) => {
+        try {
+            const entries = await fs.readdir(pDirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(pDirPath, entry.name);
+                if (isIgnored(fullPath))
+                    continue;
+                if (entry.isDirectory()) {
+                    await primeDirectoryStats(fullPath);
+                }
+                else if (entry.isFile()) {
+                    await recordFileStat(fullPath);
+                }
+            }
+        }
+        catch {
+            // Ignored
+        }
+    };
+    for (const p of pathsToWatch) {
+        await primeDirectoryStats(p);
     }
-    process.on('SIGINT', () => {
-        for (const w of watchers)
-            w.close();
+    const watcher = chokidarWatch(pathsToWatch, {
+        ignored: isIgnored,
+        ignoreInitial: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 100,
+            pollInterval: 50
+        }
+    });
+    watcher.on('all', async (event, filePath) => {
+        if (event === 'addDir' || event === 'unlinkDir')
+            return;
+        const absPath = resolve(filePath);
+        if (event === 'unlink') {
+            fileStats.delete(absPath);
+            const relativePath = relative(projectRootDirectory, filePath).replace(/\\/g, '/');
+            triggerRebuild(relativePath);
+            return;
+        }
+        // Verify mtime or size actually changed to eliminate phantom OS events
+        const stats = await fs.stat(absPath).catch(() => null);
+        if (!stats)
+            return;
+        const prev = fileStats.get(absPath);
+        if (prev && prev.mtime === stats.mtimeMs && prev.size === stats.size) {
+            return;
+        }
+        fileStats.set(absPath, { mtime: stats.mtimeMs, size: stats.size });
+        const relativePath = relative(projectRootDirectory, filePath).replace(/\\/g, '/');
+        triggerRebuild(relativePath);
+    });
+    process.on('SIGINT', async () => {
+        await watcher.close();
         process.exit(0);
     });
 }

package/lib/cli-runner.cjs

@@ -15,4 +15,4 @@ if (typeof Bun !== 'undefined') {
         shell: process.platform === 'win32'
     });
     process.exit(result.status ?? 0);
-}
+}