@pix3/cli 1.6.4 → 2.0.0-alpha.0

package/templates/base/files/README.md

@@ -0,0 +1,39 @@
+# {{PROJECT_NAME}}
+
+A Pix3 game: a Vite + TypeScript project with `@pix3/runtime` and the Pix3 editor
+(`@pix3/vite-plugin`).
+
+```bash
+npm install
+npm run dev        # the game at http://localhost:5173/, the editor at http://localhost:5173/__pix3/ (*)
+npm run editor     # pix3 editor: the dev server (started if needed) + the editor in Chrome for a coding agent
+npm run build      # dist/index.html — one self-contained playable
+npm run preview    # serve dist/ to try the build
+npm run check      # pix3 check: scenes, res:// paths, components, a type-check of the scripts
+npm run smoke      # pix3 smoke: run the game headless for 2 s and report what threw
+```
+
+(*) 5173 is Vite's first choice, not a promise: when it is taken Vite uses 5174, 5175, … The
+address in use is what `npm run dev` / `npm run editor` prints, and `.pix3/dev.json`
+(`editorUrl`) while the server runs.
+
+**Pix3 2.0.0-alpha is not on npm yet**, so `npm install` fails until it is published. Until
+then, link a pix3-core checkout instead: build it once (`npm install && npm run build -w
+packages/editor-core && npm run build -w packages/vite-plugin` in the checkout), then in this
+project `rm -rf node_modules && ln -s <pix3-core>/node_modules node_modules` — the checkout's
+workspaces provide `@pix3/*`, Vite and the rest. The `pix3` scripts (`editor`, `check`, `smoke`)
+need the CLI's bin, which the checkout links only once its CLI is built (prepack steps in its
+`packages/cli`); until then run `node <pix3-core>/packages/cli/src/index.ts editor` (or `check`,
+`smoke`) from this folder.
+
+## Layout
+
+- `scenes/` — scenes (`.pix3scene`, YAML); `scenes/main.pix3scene` is the entry scene
+  (`defaultExportScenePath` in `pix3project.yaml`)
+- `scripts/` — script components (`export class X extends Script`, used as `user:X`)
+- `sprites/`, `audio/` — assets, referenced as `res://sprites/x.png`
+- `design/` — design notes and references
+- `src/main.ts` — boots the entry scene (`startGame` from `@pix3/vite-plugin/player`)
+- `pix3project.yaml` — the project manifest (viewport, quality, entry scene)
+- `AGENTS.md`, `CLAUDE.md`, `.claude/skills/`, `design/tests/bots/` — the agent kit: rules, skills
+  and bot-policy types for coding agents (`pix3 kit --update` refreshes it)

package/templates/base/files/gitignore

@@ -0,0 +1,11 @@
+node_modules/
+dist/
+# Pix3 editor + CLI bookkeeping (dev server, version journal, keys fallback, gaps) — ignored, except
+# the kit's record of the files it wrote (pix3 kit --update) and the template the project came from
+.pix3/*
+!.pix3/kit-manifest.json
+!.pix3/template.json
+# pix3 agent-setup: the MCP config names a file in this machine's home (~/.pix3/cdp-mcp.json);
+# an older one carried the CDP token itself
+.mcp.json
+.codex/config.toml

package/templates/base/files/index.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+    <title>{{PROJECT_NAME}}</title>
+    <style>
+      html,
+      body,
+      #app {
+        margin: 0;
+        width: 100%;
+        height: 100%;
+        overflow: hidden;
+        background: #000;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/base/files/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "editor": "pix3 editor",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "pix3 check",
+    "smoke": "pix3 smoke"
+  },
+  "dependencies": {
+    "@pix3/runtime": "{{PIX3_VERSION}}",
+    "lit": "^3.3.1",
+    "postprocessing": "^6.39.2",
+    "three": "~0.183.2"
+  },
+  "devDependencies": {
+    "@pix3/cli": "{{PIX3_VERSION}}",
+    "@pix3/editor-core": "{{PIX3_VERSION}}",
+    "@pix3/vite-plugin": "{{PIX3_VERSION}}",
+    "@types/three": "^0.183.1",
+    "typescript": "~5.8.3",
+    "vite": "^8.3.3"
+  }
+}

package/templates/base/files/src/main.ts

@@ -0,0 +1,3 @@
+import { startGame } from '@pix3/vite-plugin/player';
+
+void startGame('#app');

package/templates/base/files/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["vite/client"],
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "strict": true
+  },
+  "include": ["src", "scripts", "design/tests", "vite.config.ts"]
+}

package/templates/base/files/vite.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite';
+import { pix3 } from '@pix3/vite-plugin';
+
+// `npm run dev`: the game at /, the Pix3 editor at /__pix3/.
+// `npm run build`: dist/index.html, one self-contained file, plus dist/index.report.json (what it
+// weighs and why). pix3({ compress: true }) gzips the bundle into the page (about two thirds
+// off); pix3({ build: 'zip' }) makes a zip to host (not for file://).
+export default defineConfig({
+  plugins: [pix3()],
+});

package/dist/smoke/prebuilt/chunk-CBFYKDS7.mjs

@@ -1,2 +0,0 @@
-import { createRequire as __pix3CreateRequire } from 'node:module'; const require = __pix3CreateRequire(import.meta.url);
-import{a as l,oa as d}from"./chunk-VJHJ5BCO.mjs";import{pd as u}from"./chunk-P2CBRXPJ.mjs";var g=()=>{let n={addColorStop:()=>{}};return new Proxy({},{get(e,t){return t==="measureText"?r=>({width:r.length*10,actualBoundingBoxAscent:10,actualBoundingBoxDescent:3,actualBoundingBoxLeft:0,actualBoundingBoxRight:r.length*10}):t==="getImageData"?()=>({data:new Uint8ClampedArray(4),width:1,height:1}):typeof t=="string"&&t.startsWith("create")?()=>n:()=>{}},set:()=>!0})},x=()=>({style:{},src:"",crossOrigin:null,complete:!1,width:0,height:0,addEventListener:()=>{},removeEventListener:()=>{}}),m=()=>({createElement(n){if(n!=="canvas")throw new Error(`canvas-only document shim: createElement('${n}') is not provided`);return{width:1,height:1,style:{},getContext:e=>e==="2d"?g():null,addEventListener:()=>{},removeEventListener:()=>{}}},createElementNS(n,e){if(e!=="img")throw new Error(`canvas-only document shim: createElementNS('${e}') is not provided`);return x()}}),y=()=>typeof Reflect.get(globalThis,"document")<"u"?()=>{}:(Reflect.set(globalThis,"document",m()),()=>{Reflect.deleteProperty(globalThis,"document")});import{existsSync as h,readFileSync as p,statSync as w}from"node:fs";import{isAbsolute as v,join as R,relative as D,resolve as f}from"node:path";var i=class extends l{projectDir;transformText;constructor(e,t={}){super("/"),this.projectDir=f(e),this.transformText=t.transformText}pathOf(e){let t=this.normalize(e).replace(/^\/+/,"");return this.containedPath(t)}isProjectResource(e){let t=this.getScheme(e);return t===""||t==="res"}exists(e){let t=this.pathOf(e);if(!t||!h(t))return!1;try{return w(t).isFile()}catch{return!1}}async fetchText(e){let t=this.requirePath(e),r=p(t,"utf8");return this.transformText?this.transformText(r,t):r}async fetchBlob(e){return new Blob([new Uint8Array(p(this.requirePath(e)))])}containedPath(e){let t=decodeURIComponent(e.replace(/^\/+/,"")),r=f(R(this.projectDir,t)),c=D(this.projectDir,r);return c.startsWith("..")||v(c)?null:r}requirePath(e){let t=`res://${e.replace(/^\/+/,"")}`,r=this.containedPath(e);if(!r)throw new s(t,"resolves outside the project folder");if(!h(r))throw new s(t);return r}},s=class extends Error{resource;constructor(e,t="file not found"){super(`Missing resource ${e} (${t})`),this.name="MissingResourceError",this.resource=e}},o=class extends Error{resource;constructor(e){super(`Resource ${e} exists but is not decoded outside the browser`),this.name="ResourceNotDecodedError",this.resource=e}},a=class extends d{missingSet=new Set;disk;constructor(e){super(e),this.disk=e}get missing(){return[...this.missingSet]}async loadTexture(e,t){return this.require(e),new u}async loadAsset(e){throw this.require(e),new o(e)}async loadSpineAsset(e){throw this.require(e.skeletonPath),this.require(e.atlasPath),e.texturePath&&this.require(e.texturePath),new o(e.skeletonPath)}require(e){if(this.disk.isProjectResource(e)&&!this.disk.exists(e))throw this.missingSet.add(e),new s(e)}};export{g as a,y as b,i as c,s as d,o as e,a as f};