create-pixifact 0.1.3

package/README.md

@@ -0,0 +1,31 @@
+# create-pixifact
+
+Create a Bun-first Pixifact game project.
+
+## Usage
+
+```bash
+bun create pixifact my-game
+cd my-game
+bun install
+bun run dev
+```
+
+The generated project includes:
+
+- `pixifact.project.json`
+- a minimal Pixifact Scene pair
+- Vite project scripts
+- `pixifact` and `pixifact-cli` dependencies
+
+## Generated Scripts
+
+```bash
+bun run compile:scenes
+bun run dev
+bun run build
+```
+
+## Requirements
+
+- Bun

package/dist/createPixifactProject.d.ts

@@ -0,0 +1,11 @@
+export interface CreatePixifactProjectOptions {
+    cwd?: string;
+    name: string;
+    template?: 'minimal';
+}
+export interface CreatePixifactProjectResult {
+    name: string;
+    root: string;
+    template: 'minimal';
+}
+export declare function createPixifactProject(options: CreatePixifactProjectOptions): Promise<CreatePixifactProjectResult>;

package/dist/createPixifactProject.js

@@ -0,0 +1,68 @@
+import { cp, mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const defaultPort = 5177;
+function packageDirectory() {
+    const currentFile = fileURLToPath(import.meta.url);
+    const sourceDirectory = path.basename(path.dirname(currentFile));
+    return sourceDirectory === 'src' || sourceDirectory === 'dist'
+        ? path.resolve(currentFile, '../..')
+        : path.resolve(currentFile, '..');
+}
+function templateDirectory(template) {
+    return path.join(packageDirectory(), 'templates', template);
+}
+function projectDisplayName(name) {
+    return name
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+        .join(' ');
+}
+async function directoryIsEmpty(target) {
+    try {
+        const targetStat = await stat(target);
+        if (!targetStat.isDirectory()) {
+            throw new Error('Target path exists and is not a directory.');
+        }
+        return (await readdir(target)).length === 0;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return true;
+        }
+        throw error;
+    }
+}
+async function writeJson(filePath, value) {
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+export async function createPixifactProject(options) {
+    const template = options.template ?? 'minimal';
+    const cwd = options.cwd ?? process.cwd();
+    const projectRoot = path.resolve(cwd, options.name);
+    if (!(await directoryIsEmpty(projectRoot))) {
+        throw new Error('Target directory is not empty.');
+    }
+    await mkdir(projectRoot, { recursive: true });
+    await cp(templateDirectory(template), projectRoot, { recursive: true });
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    packageJson.name = options.name;
+    await writeJson(packageJsonPath, packageJson);
+    const projectJsonPath = path.join(projectRoot, 'pixifact.project.json');
+    const projectJson = JSON.parse(await readFile(projectJsonPath, 'utf8'));
+    projectJson.name = projectDisplayName(options.name);
+    projectJson.run = {
+        command: 'bun',
+        args: ['run', 'dev'],
+        cwd: '.',
+        url: `http://127.0.0.1:${defaultPort}`,
+    };
+    await writeJson(projectJsonPath, projectJson);
+    return {
+        name: options.name,
+        root: projectRoot,
+        template,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { createPixifactProject } from './createPixifactProject';
+export { createPixifactProject };

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env bun
+import { createPixifactProject } from './createPixifactProject';
+function usage() {
+    return [
+        'Usage:',
+        '  bun create pixifact <project-name>',
+        '',
+    ].join('\n');
+}
+const name = process.argv[2];
+if (!name || name === '--help' || name === '-h') {
+    process.stdout.write(usage());
+    process.exitCode = name ? 0 : 1;
+}
+else {
+    try {
+        const result = await createPixifactProject({ name });
+        process.stdout.write(`Created ${result.name} at ${result.root}\n`);
+        process.stdout.write(`Next: cd ${result.name} && bun install && bun run dev\n`);
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+export { createPixifactProject };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "create-pixifact",
+  "version": "0.1.3",
+  "description": "Create a Pixifact game project.",
+  "packageManager": "bun@1.3.13",
+  "type": "module",
+  "bin": {
+    "create-pixifact": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hxg2050/pixifact.git",
+    "directory": "packages/create-pixifact"
+  },
+  "keywords": [
+    "pixifact",
+    "create-pixifact",
+    "game",
+    "pixijs",
+    "scene"
+  ],
+  "author": "youxia <243802688@qq.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "bunx --no-install tsc -p tsconfig.build.json"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^5.3.3"
+  }
+}

package/templates/minimal/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Pixifact Game</title>
+  </head>
+  <body>
+    <div id="game"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/minimal/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "pixifact-minimal-game",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "compile:scenes": "pixifact compile-scenes --project-root .",
+    "dev": "bun run compile:scenes && vite . --host 127.0.0.1 --port 5177 --strictPort",
+    "build": "bun run compile:scenes && vite build . --config vite.config.ts"
+  },
+  "dependencies": {
+    "pixi.js": "8.18.1",
+    "pixifact": "^0.1.3"
+  },
+  "devDependencies": {
+    "pixifact-cli": "^0.1.3",
+    "typescript": "^5.3.3",
+    "vite": "^8.0.10"
+  }
+}

package/templates/minimal/pixifact.project.json

@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "name": "Pixifact Game",
+  "scenes": {
+    "mainMenu": "src/scenes/MainMenu.scene"
+  },
+  "run": {
+    "command": "bun",
+    "args": ["run", "dev"],
+    "cwd": ".",
+    "url": "http://127.0.0.1:5177"
+  }
+}

package/templates/minimal/src/main.ts

@@ -0,0 +1,22 @@
+import './styles.css';
+import 'pixifact:scenes';
+import { Application } from 'pixi.js';
+import { MainMenu } from './scenes/MainMenu';
+
+const root = document.querySelector<HTMLElement>('#game');
+if (!root) {
+    throw new Error('Missing #game root.');
+}
+
+const app = new Application();
+await app.init({
+    width: 960,
+    height: 540,
+    backgroundColor: 0x10131d,
+    antialias: true,
+    autoDensity: true,
+    resolution: Math.min(window.devicePixelRatio || 1, 2),
+});
+root.append(app.canvas);
+
+app.stage.addChild(new MainMenu());

package/templates/minimal/src/pixifact-env.d.ts

@@ -0,0 +1 @@
+declare module 'pixifact:scenes' {}

package/templates/minimal/src/scenes/MainMenu.scene

@@ -0,0 +1,8 @@
+<Scene name="MainMenu" width="960" height="540">
+  <Graphics id="background" shape="rect" width="960" height="540" fill="#10131d" />
+  <Graphics id="panel" shape="roundRect" x="260" y="148" width="440" height="244" radius="24" fill="#182033" strokeColor="#38bdf8" strokeWidth="2" strokeAlpha="0.72" />
+  <Text id="titleText" text="Pixifact Game" x="314" y="202" fontSize="44" fontWeight="700" fill="#f8fafc" />
+  <Text id="hintText" text="Edit src/scenes/MainMenu.scene, then run pixifact validate and compile." x="300" y="278" fontSize="18" fill="#cbd5e1" />
+  <Graphics id="startButtonBack" shape="roundRect" x="378" y="326" width="204" height="50" radius="14" fill="#2563eb" />
+  <Text id="startLabel" text="START" x="435" y="340" fontSize="20" fontWeight="700" fill="#ffffff" />
+</Scene>

package/templates/minimal/src/scenes/MainMenu.ts

@@ -0,0 +1,29 @@
+import { Container, Graphics, Text } from 'pixi.js';
+import { createEvent, event, part, scene } from 'pixifact/compiler';
+
+@scene()
+export class MainMenu extends Container {
+    @part()
+    protected declare startButtonBack: Graphics;
+
+    @part()
+    protected declare startLabel: Text;
+
+    @event()
+    readonly start = createEvent();
+
+    onMounted() {
+        this.startButtonBack.eventMode = 'static';
+        this.startButtonBack.cursor = 'pointer';
+        this.startButtonBack.on('pointertap', () => {
+            this.startLabel.text = 'READY';
+            this.start.emit();
+        });
+        this.startButtonBack.on('pointerover', () => {
+            this.startButtonBack.tint = 0xc7d2fe;
+        });
+        this.startButtonBack.on('pointerout', () => {
+            this.startButtonBack.tint = 0xffffff;
+        });
+    }
+}

package/templates/minimal/src/styles.css

@@ -0,0 +1,16 @@
+html,
+body,
+#game {
+    width: 100%;
+    height: 100%;
+    margin: 0;
+}
+
+body {
+    overflow: hidden;
+    background: #10131d;
+}
+
+canvas {
+    display: block;
+}

package/templates/minimal/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "strict": true,
+    "experimentalDecorators": true,
+    "useDefineForClassFields": true,
+    "lib": ["ESNext", "DOM"],
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/minimal/vite.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite';
+import { pixifactScenesPlugin } from 'pixifact/compiler-node';
+
+const projectRoot = new URL('.', import.meta.url);
+
+export default defineConfig({
+    plugins: [
+        pixifactScenesPlugin({ projectRoot }),
+    ],
+});