phibelle-kit 1.0.13 → 1.0.15

package/dist/commands/clone-scene.js

@@ -1,10 +1,8 @@
 import chalk from "chalk";
 import * as path from "path";
-import { queryOnce } from "../lib/convex-client.js";
+import { queryOnce, BASE_URL } from "../lib/api/index.js";
 import { api } from "../convex/_generated/api.js";
-import { BASE_URL } from "../lib/public-env.js";
-import { sceneNameToFolder } from "../lib/file-system.js";
-import { setupSceneFiles, unpackageWithLogging } from "../lib/first-run-setup.js";
+import { sceneNameToFolder, setupSceneFiles, unpackageWithLogging } from "../lib/scene/index.js";
 /**
  * Clone: one-time fetch of scene data. Creates scene dir, writes scene.json,
  * sets up package.json/global.d.ts, unpacks scripts. No watcher, no opening folder.

package/dist/commands/watch-scene.js

@@ -1,15 +1,11 @@
 import chalk from "chalk";
 import * as path from "path";
 import * as fs from "fs";
-import { subscribeToQuery } from "../lib/convex-client.js";
+import { subscribeToQuery, BASE_URL } from "../lib/api/index.js";
 import { api } from "../convex/_generated/api.js";
-import { getSessionId } from "../lib/conf.js";
-import { findSceneDirBySceneId, sceneNameToFolder } from "../lib/file-system.js";
-import { unpackageScene } from "../lib/scene-packaging.js";
-import { createScriptWatcher } from "../lib/script-watcher.js";
-import { runFirstUpdateSetup } from "../lib/first-run-setup.js";
+import { getSessionId } from "../lib/auth/index.js";
+import { findSceneDirBySceneId, sceneNameToFolder, unpackageScene, createScriptWatcher, runFirstUpdateSetup, } from "../lib/scene/index.js";
 import { toErrorMessage } from "../lib/utils.js";
-import { BASE_URL } from "../lib/public-env.js";
 function createWatchCallbacks() {
     return {
         onPushed: (file) => console.log(chalk.green("  ✓ Pushed " + file + " to Convex")),

package/dist/index.js

@@ -2,7 +2,7 @@
 import chalk from "chalk";
 import { watchSceneCommand } from "./commands/watch-scene.js";
 import { cloneSceneCommand } from "./commands/clone-scene.js";
-import { waitForToken } from "./lib/wait-for-token.js";
+import { waitForToken } from "./lib/auth/wait-for-token.js";
 const USAGE = "  Usage: phibelle-kit clone <sceneId> | phibelle-kit watch <sceneId>";
 async function main() {
     const command = process.argv[2];

package/dist/lib/{convex-client.js → api/convex-client.js}

@@ -1,6 +1,6 @@
 import { ConvexClient } from "convex/browser";
 import { CONVEX_URL } from "./public-env.js";
-import { getStoredToken } from "./conf.js";
+import { getStoredToken } from "../auth/conf.js";
 if (!CONVEX_URL) {
     throw new Error("Missing CONVEX_URL environment variable. " +
         "Set it to your Convex deployment URL (e.g., from NEXT_PUBLIC_CONVEX_URL in your phibelle project)");
@@ -8,7 +8,7 @@ if (!CONVEX_URL) {
 export function createConvexClient() {
     const token = getStoredToken();
     if (!token) {
-        throw new Error("Not authenticated. Please run 'phibelle login' first.");
+        throw new Error("Not authenticated. Run your command again and complete the browser sign-in when prompted.");
     }
     const client = new ConvexClient(CONVEX_URL);
     client.setAuth(() => Promise.resolve(token));

package/dist/lib/api/index.d.ts

@@ -0,0 +1,2 @@
+export { createConvexClient, subscribeToQuery, queryOnce, mutateOnce } from "./convex-client.js";
+export { CONVEX_URL, BASE_URL } from "./public-env.js";

package/dist/lib/api/index.js

@@ -0,0 +1,2 @@
+export { createConvexClient, subscribeToQuery, queryOnce, mutateOnce } from "./convex-client.js";
+export { CONVEX_URL, BASE_URL } from "./public-env.js";

package/dist/lib/{conf.js → auth/conf.js}

@@ -3,14 +3,16 @@ import Conf from "conf";
 const CONFIG = new Conf({
     projectName: "phibelle-kit",
 });
+/** Auth token kept in memory only (session); never persisted for security. */
+let sessionToken;
 export function setToken(token) {
-    CONFIG.set("authToken", token);
+    sessionToken = token;
 }
 export function getStoredToken() {
-    return CONFIG.get("authToken");
+    return sessionToken;
 }
 export function clearToken() {
-    CONFIG.delete("authToken");
+    sessionToken = undefined;
 }
 /** Stable session ID for this CLI instance; used so we can skip re-unpack when we were the ones who saved. */
 export function getSessionId() {

package/dist/lib/auth/index.d.ts

@@ -0,0 +1,2 @@
+export { getStoredToken, setToken, clearToken, getSessionId } from "./conf.js";
+export { waitForToken } from "./wait-for-token.js";

package/dist/lib/auth/index.js

@@ -0,0 +1,2 @@
+export { getStoredToken, setToken, clearToken, getSessionId } from "./conf.js";
+export { waitForToken } from "./wait-for-token.js";

package/dist/lib/{wait-for-token.js → auth/wait-for-token.js}

@@ -1,6 +1,6 @@
 import http from "node:http";
 import { setToken } from "./conf.js";
-import { BASE_URL } from "./public-env.js";
+import { BASE_URL } from "../api/public-env.js";
 import open from "open";
 const PORT = 13131;
 export function waitForToken() {

package/dist/lib/{first-run-setup.d.ts → scene/first-run-setup.d.ts}

@@ -1,10 +1,5 @@
 import { type ScriptWatcher } from "./script-watcher.js";
-import type { Scene } from "./types.js";
-export type WatchCallbacks = {
-    onPushed: (file: string) => void;
-    onNewEntity: (engineId: number, fileName?: string) => void;
-    onError: (file: string, err: Error) => void;
-};
+import type { Scene, WatchCallbacks } from "../types.js";
 /** Create scene dir, write scene.json, setup package.json/global.d.ts; log install hint if needed. */
 export declare function setupSceneFiles(scene: Scene, sceneDir: string, ignoreHint?: boolean): void;
 /** Unpackage scene scripts; log success or hint on failure. */

package/dist/lib/{first-run-setup.js → scene/first-run-setup.js}

@@ -1,12 +1,12 @@
 import chalk from "chalk";
 import * as path from "path";
 import * as fs from "fs";
-import { BASE_URL } from "./public-env.js";
+import { BASE_URL } from "../api/public-env.js";
 import { createFolder } from "./file-system.js";
 import { unpackageScene } from "./scene-packaging.js";
 import { createScriptWatcher } from "./script-watcher.js";
-import { setupSceneDirectory, getInstallHint } from "../package/setup.js";
-import { toErrorMessage } from "./utils.js";
+import { setupSceneDirectory, getInstallHint } from "../../scene-setup/setup.js";
+import { toErrorMessage } from "../utils.js";
 const INSTALL_HINT_LABEL = "  ⚠ Install dependencies for types and intellisense:";
 /** Create scene dir, write scene.json, setup package.json/global.d.ts; log install hint if needed. */
 export function setupSceneFiles(scene, sceneDir, ignoreHint = false) {

package/dist/lib/scene/index.d.ts

@@ -0,0 +1,4 @@
+export { setupSceneFiles, unpackageWithLogging, runFirstUpdateSetup } from "./first-run-setup.js";
+export { createScriptWatcher, type ScriptWatcher } from "./script-watcher.js";
+export { findSceneDirBySceneId, sceneNameToFolder, getSceneAppDir, createFolder, folderExists, SCENE_APP_DIR, } from "./file-system.js";
+export { unpackageScene, entityNameToSlug, slugToEntityName, ENTITY_FOLDER_RE, ENTITY_SCRIPT_FILE, ENTITY_PROPERTIES_FILE, ENTITY_TRANSFORMS_FILE, SCENE_SCRIPT_FILE, SCENE_PROPERTIES_FILE, } from "./scene-packaging.js";

package/dist/lib/scene/index.js

@@ -0,0 +1,4 @@
+export { setupSceneFiles, unpackageWithLogging, runFirstUpdateSetup } from "./first-run-setup.js";
+export { createScriptWatcher } from "./script-watcher.js";
+export { findSceneDirBySceneId, sceneNameToFolder, getSceneAppDir, createFolder, folderExists, SCENE_APP_DIR, } from "./file-system.js";
+export { unpackageScene, entityNameToSlug, slugToEntityName, ENTITY_FOLDER_RE, ENTITY_SCRIPT_FILE, ENTITY_PROPERTIES_FILE, ENTITY_TRANSFORMS_FILE, SCENE_SCRIPT_FILE, SCENE_PROPERTIES_FILE, } from "./scene-packaging.js";

package/dist/lib/{scene-packaging.js → scene/scene-packaging.js}

@@ -1,9 +1,9 @@
 import * as fs from "fs/promises";
 import * as path from "path";
 import { getSceneAppDir } from "./file-system.js";
-import { queryOnce, mutateOnce } from "./convex-client.js";
-import { api } from "../convex/_generated/api.js";
-import { getSessionId } from "./conf.js";
+import { queryOnce, mutateOnce } from "../api/convex-client.js";
+import { api } from "../../convex/_generated/api.js";
+import { getSessionId } from "../auth/conf.js";
 /** Scene-level file names in app/. */
 export const SCENE_SCRIPT_FILE = "scene-script.tsx";
 export const SCENE_PROPERTIES_FILE = "scene-properties.json";

package/dist/lib/{script-watcher.d.ts → scene/script-watcher.d.ts}

@@ -1,9 +1,4 @@
 export type ScriptWatcher = {
     close: () => void;
 };
-export type WatchCallbacks = {
-    onPushed: (file: string) => void;
-    onNewEntity: (engineId: number, fileName?: string) => void;
-    onError: (file: string, err: Error) => void;
-};
 export declare function createScriptWatcher(sceneId: string, sceneDir: string, onPushed: (file: string) => void, onNewEntity: (engineId: number, fileName?: string) => void, onError: (file: string, err: Error) => void): ScriptWatcher;

package/dist/lib/types.d.ts

@@ -60,3 +60,9 @@ export type PhibelleScene = {
     };
     version: string;
 };
+/** Callbacks used by script watcher and first-run setup. */
+export type WatchCallbacks = {
+    onPushed: (file: string) => void;
+    onNewEntity: (engineId: number, fileName?: string) => void;
+    onError: (file: string, err: Error) => void;
+};

package/dist/scene-setup/npm-package.d.ts

@@ -1 +1 @@
-export declare const NPM_PACKAGE = "\n{\n  \"dependencies\": {\n    \"@react-three/drei\": \"^10.7.7\",\n    \"@react-three/fiber\": \"^9.5.0\",\n    \"@react-three/rapier\": \"^2.2.0\",\n    \"@react-three/uikit\": \"^1.0.61\",\n    \"react\": \"^19.1.1\",\n    \"react-dom\": \"19.1.1\",\n    \"three\": \"^0.179.1\"\n  }\n}\n";
+export declare const getNpmPackage: (sceneId: string) => string;

package/dist/scene-setup/npm-package.js

@@ -1,5 +1,8 @@
-export const NPM_PACKAGE = `
-{
+export const getNpmPackage = (sceneId) => {
+    return `{
+  "scripts": {
+    "watch": "npx phibelle-kit watch ${sceneId}"
+  },
   "dependencies": {
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.5.0",
@@ -9,5 +12,5 @@ export const NPM_PACKAGE = `
     "react-dom": "19.1.1",
     "three": "^0.179.1"
   }
-}
-`;
+}`;
+};

package/dist/scene-setup/setup.d.ts

@@ -1,15 +1,4 @@
-export type SetupResult = {
-    /** True if we created/updated package.json and user should run install */
+export declare function setupSceneDirectory(sceneDir: string, sceneId: string): {
     shouldPromptInstall: boolean;
 };
-/**
- * Ensures the scene directory has package.json, global.d.ts, and
- * node_modules/phibelle/index.d.ts so the IDE can resolve types.
- * Call this when the user watches a scene (e.g. from runFirstUpdateSetup).
- */
-export declare function setupSceneDirectory(sceneDir: string): SetupResult;
-/**
- * Returns the preferred package manager hint for the scene directory
- * (e.g. "pnpm install") based on lockfiles, or a generic message.
- */
 export declare function getInstallHint(sceneDir: string): string;

package/dist/scene-setup/setup.js

@@ -1,39 +1,38 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { NPM_PACKAGE } from "./npm-package.js";
+import { getNpmPackage } from "./npm-package.js";
 import { GLOBAL_MODULE } from "./global-module.js";
+import { AGENTS_MD } from "./agents-md.js";
+import { TSCONFIG_FILE } from "./tsconfig-file.js";
 const PACKAGE_JSON = "package.json";
 const GLOBAL_D_TS = "global.d.ts";
-/** One dependency we expect after install to detect if install was run */
+const AGENTS_MD_FILE = "AGENTS.md";
 const PROBE_DEP = "react";
-/**
- * Ensures the scene directory has package.json, global.d.ts, and
- * node_modules/phibelle/index.d.ts so the IDE can resolve types.
- * Call this when the user watches a scene (e.g. from runFirstUpdateSetup).
- */
-export function setupSceneDirectory(sceneDir) {
+export function setupSceneDirectory(sceneDir, sceneId) {
     const packagePath = path.join(sceneDir, PACKAGE_JSON);
     const globalDtsPath = path.join(sceneDir, GLOBAL_D_TS);
     let shouldPromptInstall = false;
-    // 1. Create package.json
-    const pkgJson = `${NPM_PACKAGE}\n`;
+    // 1. Create package.json and tscconfig.json
+    const pkgJson = `${getNpmPackage(sceneId)}\n`;
     if (!fs.existsSync(packagePath) || fs.readFileSync(packagePath, "utf8") !== pkgJson) {
         fs.writeFileSync(packagePath, pkgJson);
         shouldPromptInstall = true;
     }
+    const tscConfigPath = path.join(sceneDir, "tsconfig.json");
+    if (!fs.existsSync(tscConfigPath) || fs.readFileSync(tscConfigPath, "utf8") !== TSCONFIG_FILE) {
+        fs.writeFileSync(tscConfigPath, TSCONFIG_FILE);
+    }
     // 2. Write global.d.ts
     fs.writeFileSync(globalDtsPath, GLOBAL_MODULE.trimStart());
-    // 3. If node_modules doesn't have real deps yet, prompt install
+    // 3. Write AGENTS.md (engine documentation for AI agents and developers)
+    fs.writeFileSync(path.join(sceneDir, AGENTS_MD_FILE), AGENTS_MD.trimStart(), "utf8");
+    // 4. If node_modules doesn't have real deps yet, prompt install
     const probePath = path.join(sceneDir, "node_modules", PROBE_DEP, "package.json");
     if (!fs.existsSync(probePath)) {
         shouldPromptInstall = true;
     }
     return { shouldPromptInstall };
 }
-/**
- * Returns the preferred package manager hint for the scene directory
- * (e.g. "pnpm install") based on lockfiles, or a generic message.
- */
 export function getInstallHint(sceneDir) {
     const hasPnpm = fs.existsSync(path.join(sceneDir, "pnpm-lock.yaml"));
     const hasYarn = fs.existsSync(path.join(sceneDir, "yarn.lock"));

package/dist/scene-setup/tsconfig-file.d.ts

@@ -0,0 +1 @@
+export declare const TSCONFIG_FILE = "{\n  \"compilerOptions\": {\n    \"jsx\": \"react-jsx\"\n  },\n  \"include\": [\n    \"app/**/*.tsx\",\n    \"global.d.ts\"\n  ]\n}";

package/dist/scene-setup/tsconfig-file.js

@@ -0,0 +1,9 @@
+export const TSCONFIG_FILE = `{
+  "compilerOptions": {
+    "jsx": "react-jsx"
+  },
+  "include": [
+    "app/**/*.tsx",
+    "global.d.ts"
+  ]
+}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phibelle-kit",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "CLI tool for interacting with the Phibelle engine",
   "type": "module",
   "bin": {

package/dist/clone-scene.d.ts

@@ -1,5 +0,0 @@
-/**
- * Clone: one-time fetch of scene data. Creates scene dir, writes scene.json,
- * sets up package.json/global.d.ts, unpacks scripts. No watcher, no opening folder.
- */
-export declare function cloneSceneCommand(sceneId: string): Promise<void>;

package/dist/clone-scene.js

@@ -1,39 +0,0 @@
-import chalk from "chalk";
-import * as path from "path";
-import { queryOnce } from "./lib/convex-client.js";
-import { api } from "./convex/_generated/api.js";
-import { BASE_URL } from "./lib/public-env.js";
-import { sceneNameToFolder } from "./lib/file-system.js";
-import { setupSceneFiles, unpackageWithLogging } from "./lib/first-run-setup.js";
-/**
- * Clone: one-time fetch of scene data. Creates scene dir, writes scene.json,
- * sets up package.json/global.d.ts, unpacks scripts. No watcher, no opening folder.
- */
-export async function cloneSceneCommand(sceneId) {
-    console.log();
-    console.log(chalk.bold.cyan("  📥 Cloning scene..."));
-    console.log(chalk.gray(`  Scene ID: ${sceneId}`));
-    console.log();
-    const scene = await queryOnce(api.scenes.getById, {
-        id: sceneId,
-    });
-    if (scene === null) {
-        console.log(chalk.red("  ✖ Scene not found"));
-        console.log();
-        process.exit(1);
-    }
-    const sceneFolderName = sceneNameToFolder(scene.name);
-    const sceneDir = path.join(process.cwd(), sceneFolderName);
-    setupSceneFiles(scene, sceneDir, true);
-    await unpackageWithLogging(scene._id, sceneDir, "Edit the scene in the app once to create a scene file, then run clone again.");
-    console.log(chalk.green("  ✓ Cloned scene"));
-    console.log(chalk.white(`    Name: ${scene.name}`));
-    console.log(chalk.white(`    Path: ${sceneDir}`));
-    console.log(chalk.white("    Scene link: ") + chalk.cyan(`${BASE_URL}/editor?sceneId=${scene._id}`));
-    console.log();
-    console.log(chalk.gray("  Next steps:"));
-    console.log(chalk.gray("    1. ") + chalk.blueBright("cd ") + chalk.cyan(sceneFolderName) + chalk.gray(" to open the scene directory."));
-    console.log(chalk.gray("    2. ") + chalk.blueBright("npm install") + chalk.gray(" to install the dependencies."));
-    console.log(chalk.gray("    3. ") + chalk.blueBright("phibelle watch ") + chalk.cyan(sceneId) + chalk.gray(" to watch for changes and push edits."));
-    console.log();
-}

package/dist/commands/hello.d.ts

@@ -1 +0,0 @@
-export declare function helloCommand(): Promise<void>;

package/dist/commands/hello.js

@@ -1,10 +0,0 @@
-import chalk from "chalk";
-import { getStoredUsername } from "../lib/conf.js";
-export async function helloCommand() {
-    const username = getStoredUsername();
-    const greeting = username ? `Hello ${username}! 👋` : "Hello World! 👋";
-    console.log();
-    console.log(chalk.bold.magenta(`  ${greeting}`));
-    console.log(chalk.gray("  Phibelle CLI is working correctly."));
-    console.log();
-}

package/dist/commands/login.d.ts

@@ -1 +0,0 @@
-export declare function loginCommand(): Promise<void>;

package/dist/commands/login.js

@@ -1,75 +0,0 @@
-import chalk from "chalk";
-import * as readline from "readline/promises";
-import { BASE_URL } from "../lib/constants.js";
-import { CONFIG, getStoredToken } from "../lib/conf.js";
-async function fetchUsernameFromAPI(token) {
-    try {
-        const response = await fetch(`${BASE_URL}/api/cli/user-info`, {
-            method: "GET",
-            headers: {
-                Authorization: `Bearer ${token}`,
-            },
-        });
-        if (!response.ok) {
-            return null;
-        }
-        const data = await response.json();
-        return data.username || null;
-    }
-    catch (error) {
-        return null;
-    }
-}
-export async function loginCommand() {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    if (getStoredToken() !== undefined) {
-        console.log();
-        console.log(chalk.yellow("  You are already logged in. Please logout first."));
-        console.log();
-        rl.close();
-        return;
-    }
-    console.log();
-    console.log(chalk.bold.cyan("  🔐 Phibelle CLI Login"));
-    console.log();
-    console.log(chalk.gray("  To authenticate, follow these steps:"));
-    console.log();
-    console.log(chalk.white("  1. Open this URL in your browser:"));
-    console.log();
-    console.log(chalk.cyan(`     ${BASE_URL}/cli-token`));
-    console.log();
-    console.log(chalk.white("  2. Sign in if prompted"));
-    console.log(chalk.white("  3. Copy the token displayed on the page"));
-    console.log(chalk.white("  4. Paste it below"));
-    console.log();
-    const token = await rl.question(chalk.yellow("  Enter your token: "));
-    if (!token || token.trim() === "") {
-        console.log();
-        console.log(chalk.red("  ✖ No token provided. Login cancelled."));
-        console.log();
-        rl.close();
-        throw new Error("No token provided");
-    }
-    const trimmedToken = token.trim();
-    console.log(chalk.gray("  Fetching user information..."));
-    const username = await fetchUsernameFromAPI(trimmedToken);
-    if (username) {
-        CONFIG.set("username", username);
-    }
-    if (!username) {
-        console.log();
-        console.log(chalk.red("  ✖ Failed to fetch user information. Login cancelled."));
-        console.log();
-        rl.close();
-        throw new Error("Failed to fetch user information");
-    }
-    CONFIG.set("authToken", trimmedToken);
-    console.log();
-    console.log(chalk.green("  ✔ Successfully logged in!"));
-    console.log(chalk.gray("  Your token has been saved."));
-    console.log();
-    rl.close();
-}

package/dist/commands/logout.d.ts

@@ -1 +0,0 @@
-export declare function logoutCommand(): Promise<void>;

package/dist/commands/logout.js

@@ -1,16 +0,0 @@
-import chalk from "chalk";
-import { clearToken, getStoredToken } from "../lib/conf.js";
-export async function logoutCommand() {
-    const token = getStoredToken();
-    if (!token) {
-        console.log();
-        console.log(chalk.yellow("  ℹ You are not currently logged in."));
-        console.log();
-        return;
-    }
-    clearToken();
-    console.log();
-    console.log(chalk.green("  ✔ Successfully logged out!"));
-    console.log(chalk.gray("  Your token has been cleared."));
-    console.log();
-}

package/dist/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const isDev: boolean;
-export declare const BASE_URL: string;
-export declare const CONVEX_URL: string;
-export declare const PHIBELLE_MAIN_FOLDER: string;

package/dist/constants.js

@@ -1,6 +0,0 @@
-export const isDev = process.env.NODE_ENV === "development";
-import path from "node:path";
-import os from "node:os";
-export const BASE_URL = isDev ? "http://localhost:3131" : "https://phibelle.studio";
-export const CONVEX_URL = isDev ? "https://mellow-toad-676.convex.cloud" : "https://keen-dove-500.convex.cloud";
-export const PHIBELLE_MAIN_FOLDER = path.join(os.homedir(), ".phibelle/");

package/dist/lib/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const isDev: boolean;
-export declare const BASE_URL: string;
-export declare const CONVEX_URL: string;
-export declare const PHIBELLE_MAIN_FOLDER: string;

package/dist/lib/constants.js

@@ -1,6 +0,0 @@
-import path from "node:path";
-import os from "node:os";
-export const isDev = process.env.NODE_ENV === "development";
-export const BASE_URL = isDev ? "http://localhost:3131" : "https://phibelle.studio";
-export const CONVEX_URL = isDev ? "https://mellow-toad-676.convex.cloud" : "https://keen-dove-500.convex.cloud";
-export const PHIBELLE_MAIN_FOLDER = path.join(os.homedir(), ".phibelle/");

package/dist/lib/folder.d.ts

@@ -1,3 +0,0 @@
-export declare function openFolder(folderPath: string): void;
-export declare function folderExists(folderPath: string): boolean;
-export declare function createFolder(folderPath: string): void;

package/dist/lib/folder.js

@@ -1,33 +0,0 @@
-import { spawn } from "node:child_process";
-import os from "node:os";
-import * as fs from "fs";
-export function openFolder(folderPath) {
-    const platform = os.platform();
-    let command;
-    let args;
-    if (platform === "win32") {
-        command = "explorer.exe";
-        args = [folderPath];
-    }
-    else if (platform === "darwin") {
-        command = "open";
-        args = [folderPath];
-    }
-    else {
-        command = "xdg-open";
-        args = [folderPath];
-    }
-    const child = spawn(command, args, {
-        detached: true,
-        stdio: "ignore",
-    });
-    child.unref();
-}
-export function folderExists(folderPath) {
-    return fs.existsSync(folderPath);
-}
-export function createFolder(folderPath) {
-    if (!folderExists(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-    }
-}

package/dist/package/global-module.d.ts

@@ -1 +0,0 @@
-export declare const GLOBAL_MODULE = "\nimport type React from \"react\";\nimport type * as THREE_IMPORT from \"three\";\nimport type * as DREI_IMPORT from \"@react-three/drei\";\nimport type * as R3F_IMPORT from \"@react-three/fiber\";\nimport type * as UIKIT_IMPORT from \"@react-three/uikit\";\nimport type * as RAPIER_IMPORT from \"@react-three/rapier\";\n\ndeclare global {\n  const THREE: typeof THREE_IMPORT;\n  const DREI: typeof DREI_IMPORT;\n  const R3F: typeof R3F_IMPORT;\n  const UIKIT: typeof UIKIT_IMPORT;\n  const RAPIER: typeof RAPIER_IMPORT;\n\n  namespace PHI {\n    type Transform = {\n      position: THREE_IMPORT.Vector3;\n      rotation: THREE_IMPORT.Euler;\n      scale: THREE_IMPORT.Vector3;\n    };\n\n    type PropertyType = string;\n\n    type Property = {\n      name: string;\n      type: PropertyType;\n      value: unknown;\n    };\n\n    type EntityData = {\n      name: string;\n      engineId: number;\n      threeId?: number;\n      parentId?: number;\n      childrenIds: number[];\n      transform: Transform;\n      properties: Property[];\n    };\n\n    type GamepadInfo = {\n      connected: boolean;\n      buttonA: boolean;\n      buttonB: boolean;\n      buttonX: boolean;\n      buttonY: boolean;\n      joystick: [number, number];\n      joystickRight: [number, number];\n      RB: boolean;\n      LB: boolean;\n      RT: boolean;\n      LT: boolean;\n      start: boolean;\n      select: boolean;\n      up: boolean;\n      down: boolean;\n      left: boolean;\n      right: boolean;\n    };\n\n    type EngineMode = {\n      editMode: boolean;\n      playMode: boolean;\n    };\n\n    type SceneScriptState = {\n      sceneProperties: Record<string, unknown>;\n    };\n\n    type EntityRenderRegistry = Record<\n      string,\n      React.FC<{ entityData: EntityData }>\n    >;\n  }\n\n  const PHI: {\n    globalStore: Record<string, any>;\n\n    PROPERTY_TYPES: ReadonlyArray<{\n      type: PHI.PropertyType;\n      defaultValue: unknown;\n    }>;\n\n    phibelleResetSelectedEntityIds(): void;\n\n    useEntityThreeObject(\n      entityData: PHI.EntityData,\n      threeScene: THREE_IMPORT.Scene\n    ): THREE_IMPORT.Object3D | null;\n\n    useGamepad(): PHI.GamepadInfo;\n\n    usePlayModeFrame(\n      callback: (state: R3F_IMPORT.RootState, delta: number) => void\n    ): void;\n\n    useEngineMode(): PHI.EngineMode;\n\n    useSceneScriptStore(): PHI.SceneScriptState;\n    useSceneScriptStore<T>(\n      selector: (state: PHI.SceneScriptState) => T\n    ): T;\n\n    editEntities(\n      edits: Array<{ id: number; newData: Partial<PHI.EntityData> }>\n    ): void;\n\n    useEntity(entityId: number): { entityData: PHI.EntityData };\n\n    PhibelleRoot: React.FC<{\n      entityRenderRegistry: PHI.EntityRenderRegistry;\n    }>;\n  };\n}\n\nexport {};\n";

package/dist/package/global-module.js

@@ -1,117 +0,0 @@
-export const GLOBAL_MODULE = `
-import type React from "react";
-import type * as THREE_IMPORT from "three";
-import type * as DREI_IMPORT from "@react-three/drei";
-import type * as R3F_IMPORT from "@react-three/fiber";
-import type * as UIKIT_IMPORT from "@react-three/uikit";
-import type * as RAPIER_IMPORT from "@react-three/rapier";
-
-declare global {
-  const THREE: typeof THREE_IMPORT;
-  const DREI: typeof DREI_IMPORT;
-  const R3F: typeof R3F_IMPORT;
-  const UIKIT: typeof UIKIT_IMPORT;
-  const RAPIER: typeof RAPIER_IMPORT;
-
-  namespace PHI {
-    type Transform = {
-      position: THREE_IMPORT.Vector3;
-      rotation: THREE_IMPORT.Euler;
-      scale: THREE_IMPORT.Vector3;
-    };
-
-    type PropertyType = string;
-
-    type Property = {
-      name: string;
-      type: PropertyType;
-      value: unknown;
-    };
-
-    type EntityData = {
-      name: string;
-      engineId: number;
-      threeId?: number;
-      parentId?: number;
-      childrenIds: number[];
-      transform: Transform;
-      properties: Property[];
-    };
-
-    type GamepadInfo = {
-      connected: boolean;
-      buttonA: boolean;
-      buttonB: boolean;
-      buttonX: boolean;
-      buttonY: boolean;
-      joystick: [number, number];
-      joystickRight: [number, number];
-      RB: boolean;
-      LB: boolean;
-      RT: boolean;
-      LT: boolean;
-      start: boolean;
-      select: boolean;
-      up: boolean;
-      down: boolean;
-      left: boolean;
-      right: boolean;
-    };
-
-    type EngineMode = {
-      editMode: boolean;
-      playMode: boolean;
-    };
-
-    type SceneScriptState = {
-      sceneProperties: Record<string, unknown>;
-    };
-
-    type EntityRenderRegistry = Record<
-      string,
-      React.FC<{ entityData: EntityData }>
-    >;
-  }
-
-  const PHI: {
-    globalStore: Record<string, any>;
-
-    PROPERTY_TYPES: ReadonlyArray<{
-      type: PHI.PropertyType;
-      defaultValue: unknown;
-    }>;
-
-    phibelleResetSelectedEntityIds(): void;
-
-    useEntityThreeObject(
-      entityData: PHI.EntityData,
-      threeScene: THREE_IMPORT.Scene
-    ): THREE_IMPORT.Object3D | null;
-
-    useGamepad(): PHI.GamepadInfo;
-
-    usePlayModeFrame(
-      callback: (state: R3F_IMPORT.RootState, delta: number) => void
-    ): void;
-
-    useEngineMode(): PHI.EngineMode;
-
-    useSceneScriptStore(): PHI.SceneScriptState;
-    useSceneScriptStore<T>(
-      selector: (state: PHI.SceneScriptState) => T
-    ): T;
-
-    editEntities(
-      edits: Array<{ id: number; newData: Partial<PHI.EntityData> }>
-    ): void;
-
-    useEntity(entityId: number): { entityData: PHI.EntityData };
-
-    PhibelleRoot: React.FC<{
-      entityRenderRegistry: PHI.EntityRenderRegistry;
-    }>;
-  };
-}
-
-export {};
-`;

package/dist/package/npm-package.d.ts

@@ -1 +0,0 @@
-export declare const getNpmPackage: (sceneId: string) => string;

package/dist/package/npm-package.js

@@ -1,16 +0,0 @@
-export const getNpmPackage = (sceneId) => {
-    return `{
-  "scripts": {
-    "watch": "npx phibelle-kit watch ${sceneId}"
-  },
-  "dependencies": {
-    "@react-three/drei": "^10.7.7",
-    "@react-three/fiber": "^9.5.0",
-    "@react-three/rapier": "^2.2.0",
-    "@react-three/uikit": "^1.0.61",
-    "react": "^19.1.1",
-    "react-dom": "19.1.1",
-    "three": "^0.179.1"
-  }
-}`;
-};

package/dist/package/phibelle-module.d.ts

@@ -1 +0,0 @@
-export declare const PHIBELLE_MODULE = "\n// node_modules/phibelle/index.d.ts\nimport { RootState } from \"@react-three/fiber\";\nimport type * as THREE from \"three\";\n\ndeclare module \"phibelle\" {\n  // ----------------------------\n  // Global window store\n  // ----------------------------\n  export const globalStore: {\n    [key: string]: any;\n  };\n\n  // ----------------------------\n  // Types used by scripts\n  // ----------------------------\n  export type Transform = {\n    position: THREE.Vector3;\n    rotation: THREE.Euler;\n    scale: THREE.Vector3;\n  };\n\n  export type PropertyType = string;\n\n  export type Property = {\n    name: string;\n    type: PropertyType;\n    value: string | number | boolean | [number, number, number];\n  };\n\n  export type EntityData = {\n    name: string;\n    engineId: number;\n    threeId?: number;\n    parentId?: number;\n    childrenIds: number[];\n    transform: Transform;\n    properties: Property[];\n  };\n\n  export const PROPERTY_TYPES: ReadonlyArray<{\n    type: PropertyType;\n    defaultValue: unknown;\n  }>;\n\n  // ----------------------------\n  // Engine / editor functions\n  // ----------------------------\n  export function phibelleResetSelectedEntityIds(): void;\n\n  // ----------------------------\n  // Hooks exposed to scripts\n  // ----------------------------\n  export function useEntityThreeObject(\n    entityData: EntityData,\n    threeScene: THREE.Scene\n  ): THREE.Object3D | null;\n\n  export type GamepadInfo = {\n    connected: boolean;\n    buttonA: boolean;\n    buttonB: boolean;\n    buttonX: boolean;\n    buttonY: boolean;\n    joystick: [number, number];\n    joystickRight: [number, number];\n    RB: boolean;\n    LB: boolean;\n    RT: boolean;\n    LT: boolean;\n    start: boolean;\n    select: boolean;\n    up: boolean;\n    down: boolean;\n    left: boolean;\n    right: boolean;\n  };\n\n  export function useGamepad(): GamepadInfo;\n\n  export function usePlayModeFrame(\n    callback: (state: RootState, delta: number) => void\n  ): void;\n\n  export type EngineMode = {\n    editMode: boolean;\n    playMode: boolean;\n  };\n\n  export function useEngineMode(): EngineMode;\n\n  // Zustand-like store stub you generate\n  export type SceneScriptState = {\n    sceneProperties: Record<string, unknown>;\n  };\n\n  export function useSceneScriptStore(): SceneScriptState;\n  export function useSceneScriptStore<T>(\n    selector: (state: SceneScriptState) => T\n  ): T;\n\n  export function editEntities(\n    edits: Array<{ id: number; newData: Partial<EntityData> }>\n  ): void;\n\n  export function useEntity(entityId: number): { entityData: EntityData };\n\n  // ----------------------------\n  // Components\n  // ----------------------------\n  export type EntityRenderRegistry = Record<\n    string,\n    React.FC<{ entityData: EntityData }>\n  >;\n\n  export const PhibelleRoot: React.FC<{\n    entityRenderRegistry: EntityRenderRegistry;\n  }>;\n}\n\nexport {};\n";

package/dist/package/phibelle-module.js

@@ -1,122 +0,0 @@
-export const PHIBELLE_MODULE = `
-// node_modules/phibelle/index.d.ts
-import { RootState } from "@react-three/fiber";
-import type * as THREE from "three";
-
-declare module "phibelle" {
-  // ----------------------------
-  // Global window store
-  // ----------------------------
-  export const globalStore: {
-    [key: string]: any;
-  };
-
-  // ----------------------------
-  // Types used by scripts
-  // ----------------------------
-  export type Transform = {
-    position: THREE.Vector3;
-    rotation: THREE.Euler;
-    scale: THREE.Vector3;
-  };
-
-  export type PropertyType = string;
-
-  export type Property = {
-    name: string;
-    type: PropertyType;
-    value: string | number | boolean | [number, number, number];
-  };
-
-  export type EntityData = {
-    name: string;
-    engineId: number;
-    threeId?: number;
-    parentId?: number;
-    childrenIds: number[];
-    transform: Transform;
-    properties: Property[];
-  };
-
-  export const PROPERTY_TYPES: ReadonlyArray<{
-    type: PropertyType;
-    defaultValue: unknown;
-  }>;
-
-  // ----------------------------
-  // Engine / editor functions
-  // ----------------------------
-  export function phibelleResetSelectedEntityIds(): void;
-
-  // ----------------------------
-  // Hooks exposed to scripts
-  // ----------------------------
-  export function useEntityThreeObject(
-    entityData: EntityData,
-    threeScene: THREE.Scene
-  ): THREE.Object3D | null;
-
-  export type GamepadInfo = {
-    connected: boolean;
-    buttonA: boolean;
-    buttonB: boolean;
-    buttonX: boolean;
-    buttonY: boolean;
-    joystick: [number, number];
-    joystickRight: [number, number];
-    RB: boolean;
-    LB: boolean;
-    RT: boolean;
-    LT: boolean;
-    start: boolean;
-    select: boolean;
-    up: boolean;
-    down: boolean;
-    left: boolean;
-    right: boolean;
-  };
-
-  export function useGamepad(): GamepadInfo;
-
-  export function usePlayModeFrame(
-    callback: (state: RootState, delta: number) => void
-  ): void;
-
-  export type EngineMode = {
-    editMode: boolean;
-    playMode: boolean;
-  };
-
-  export function useEngineMode(): EngineMode;
-
-  // Zustand-like store stub you generate
-  export type SceneScriptState = {
-    sceneProperties: Record<string, unknown>;
-  };
-
-  export function useSceneScriptStore(): SceneScriptState;
-  export function useSceneScriptStore<T>(
-    selector: (state: SceneScriptState) => T
-  ): T;
-
-  export function editEntities(
-    edits: Array<{ id: number; newData: Partial<EntityData> }>
-  ): void;
-
-  export function useEntity(entityId: number): { entityData: EntityData };
-
-  // ----------------------------
-  // Components
-  // ----------------------------
-  export type EntityRenderRegistry = Record<
-    string,
-    React.FC<{ entityData: EntityData }>
-  >;
-
-  export const PhibelleRoot: React.FC<{
-    entityRenderRegistry: EntityRenderRegistry;
-  }>;
-}
-
-export {};
-`;

package/dist/package/setup.d.ts

@@ -1,4 +0,0 @@
-export declare function setupSceneDirectory(sceneDir: string, sceneId: string): {
-    shouldPromptInstall: boolean;
-};
-export declare function getInstallHint(sceneDir: string): string;

package/dist/package/setup.js

@@ -1,45 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { getNpmPackage } from "./npm-package.js";
-import { GLOBAL_MODULE } from "./global-module.js";
-import { AGENTS_MD } from "./agents-md.js";
-const PACKAGE_JSON = "package.json";
-const GLOBAL_D_TS = "global.d.ts";
-const AGENTS_MD_FILE = "AGENTS.md";
-const PROBE_DEP = "react";
-export function setupSceneDirectory(sceneDir, sceneId) {
-    const packagePath = path.join(sceneDir, PACKAGE_JSON);
-    const globalDtsPath = path.join(sceneDir, GLOBAL_D_TS);
-    let shouldPromptInstall = false;
-    // 1. Create package.json
-    const pkgJson = `${getNpmPackage(sceneId)}\n`;
-    if (!fs.existsSync(packagePath) || fs.readFileSync(packagePath, "utf8") !== pkgJson) {
-        fs.writeFileSync(packagePath, pkgJson);
-        shouldPromptInstall = true;
-    }
-    // 2. Write global.d.ts
-    fs.writeFileSync(globalDtsPath, GLOBAL_MODULE.trimStart());
-    // 3. Write AGENTS.md (engine documentation for AI agents and developers)
-    fs.writeFileSync(path.join(sceneDir, AGENTS_MD_FILE), AGENTS_MD.trimStart(), "utf8");
-    // 4. If node_modules doesn't have real deps yet, prompt install
-    const probePath = path.join(sceneDir, "node_modules", PROBE_DEP, "package.json");
-    if (!fs.existsSync(probePath)) {
-        shouldPromptInstall = true;
-    }
-    return { shouldPromptInstall };
-}
-export function getInstallHint(sceneDir) {
-    const hasPnpm = fs.existsSync(path.join(sceneDir, "pnpm-lock.yaml"));
-    const hasYarn = fs.existsSync(path.join(sceneDir, "yarn.lock"));
-    const hasBun = fs.existsSync(path.join(sceneDir, "bun.lockb"));
-    const hasNpm = fs.existsSync(path.join(sceneDir, "package-lock.json"));
-    if (hasPnpm)
-        return "pnpm install";
-    if (hasYarn)
-        return "yarn install";
-    if (hasBun)
-        return "bun install";
-    if (hasNpm)
-        return "npm install";
-    return "npm install (or pnpm / yarn / bun install)";
-}

package/dist/watch-scene.d.ts

@@ -1 +0,0 @@
-export declare function watchSceneCommand(sceneId: string): Promise<void>;

package/dist/watch-scene.js

@@ -1,103 +0,0 @@
-import chalk from "chalk";
-import * as path from "path";
-import * as fs from "fs";
-import { subscribeToQuery } from "./lib/convex-client.js";
-import { api } from "./convex/_generated/api.js";
-import { getSessionId } from "./lib/conf.js";
-import { findSceneDirBySceneId, sceneNameToFolder } from "./lib/file-system.js";
-import { unpackageScene } from "./lib/scene-packaging.js";
-import { createScriptWatcher } from "./lib/script-watcher.js";
-import { runFirstUpdateSetup } from "./lib/first-run-setup.js";
-import { toErrorMessage } from "./lib/utils.js";
-function createWatchCallbacks() {
-    return {
-        onPushed: (file) => console.log(chalk.green("  ✓ Pushed " + file + " to Convex")),
-        onNewEntity: (engineId) => console.log(chalk.green("  ✓ Created new entity " + engineId + " (entity-" + engineId + ".tsx)")),
-        onError: (file, err) => console.log(chalk.red("  ✖ Failed to push " + file + ": " + err.message)),
-    };
-}
-function startScriptWatcher(scene, sceneDir) {
-    const c = createWatchCallbacks();
-    return createScriptWatcher(scene._id, sceneDir, c.onPushed, c.onNewEntity, c.onError);
-}
-export async function watchSceneCommand(sceneId) {
-    console.log();
-    console.log(chalk.bold.cyan("  👀 Watching scene updates..."));
-    console.log(chalk.gray(`  Scene ID: ${sceneId}`));
-    console.log(chalk.gray("  Press Ctrl+C to stop"));
-    console.log();
-    let previousUpdatedAt = null;
-    let isFirstUpdate = true;
-    let scriptWatcher = null;
-    try {
-        const unsubscribe = subscribeToQuery(api.scenes.getById, { id: sceneId }, async (scene) => {
-            if (scene === null) {
-                if (isFirstUpdate) {
-                    console.log(chalk.red("  ✖ Scene not found"));
-                    console.log();
-                    process.exit(1);
-                }
-                return;
-            }
-            const currentUpdatedAt = scene.updatedAt;
-            const cwd = process.cwd();
-            const sceneDir = findSceneDirBySceneId(cwd, sceneId) ?? path.join(cwd, sceneNameToFolder(scene.name));
-            const manifestPath = path.join(sceneDir, "manifest.json");
-            const alreadyCloned = fs.existsSync(manifestPath);
-            if (isFirstUpdate) {
-                if (alreadyCloned) {
-                    fs.writeFileSync(path.join(sceneDir, "scene.json"), JSON.stringify(scene));
-                    scriptWatcher = startScriptWatcher(scene, sceneDir);
-                    console.log(chalk.green("  ✓ Watching scene (previously cloned)"));
-                    console.log(chalk.white(`    Name: ${scene.name}`));
-                    console.log(chalk.white(`    Dir: ${sceneDir}`));
-                    console.log(chalk.gray("  Press Ctrl+C to stop"));
-                    console.log();
-                }
-                else {
-                    scriptWatcher = await runFirstUpdateSetup(scene, sceneDir, createWatchCallbacks());
-                }
-                previousUpdatedAt = currentUpdatedAt;
-                isFirstUpdate = false;
-            }
-            else if (previousUpdatedAt !== null && currentUpdatedAt !== previousUpdatedAt) {
-                fs.writeFileSync(path.join(sceneDir, "scene.json"), JSON.stringify(scene));
-                console.log(chalk.green("  ✓ Scene updated"));
-                console.log(chalk.white(`    Timestamp: ${new Date(currentUpdatedAt).toLocaleString()}`));
-                const ourSessionId = getSessionId();
-                const weSaved = scene.lastModifiedSessionId != null && scene.lastModifiedSessionId === ourSessionId;
-                if (!weSaved) {
-                    scriptWatcher?.close();
-                    scriptWatcher = null;
-                    try {
-                        await unpackageScene(scene._id, sceneDir);
-                        console.log(chalk.green("  ✓ Re-unpackaged scene scripts (scene.tsx, entity-*.tsx, manifest.json)"));
-                        scriptWatcher = startScriptWatcher(scene, sceneDir);
-                    }
-                    catch (e) {
-                        console.log(chalk.yellow("  ⚠ Could not re-unpackage scene scripts: " + toErrorMessage(e)));
-                    }
-                }
-                console.log();
-                previousUpdatedAt = currentUpdatedAt;
-            }
-        });
-        process.on("SIGINT", () => {
-            console.log();
-            console.log(chalk.gray("  Unsubscribing..."));
-            scriptWatcher?.close();
-            scriptWatcher = null;
-            unsubscribe();
-            console.log(chalk.gray("  Goodbye! 👋"));
-            console.log();
-            process.exit(0);
-        });
-        await new Promise(() => { });
-    }
-    catch (error) {
-        console.log();
-        console.log(chalk.red(`  ✖ Error: ${toErrorMessage(error)}`));
-        console.log();
-        throw error;
-    }
-}