@salsita-ai/sdk 0.49.0 → 0.50.0-develop.032de0e554

package/dist/application-spec/core/eval-to-constant.d.ts

@@ -1,14 +0,0 @@
-import type { EvalExpressionParser } from './eval-expression-parser.js';
-type FoldedValue = string | number | boolean | null | undefined | readonly FoldedValue[] | {
-    readonly [key: string]: FoldedValue;
-};
-interface EvalToConstantSuccess {
-    readonly ok: true;
-    readonly value: FoldedValue;
-}
-interface EvalToConstantFailure {
-    readonly ok: false;
-}
-type EvalToConstantResult = EvalToConstantSuccess | EvalToConstantFailure;
-export declare const evalToConstant: (code: string, parseExpression: EvalExpressionParser) => EvalToConstantResult;
-export {};

package/dist/application-spec/generate-application/code/templates/agents-md.d.ts

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

package/dist/application-spec/generate-application/code/templates/agents-md.js

@@ -1,2 +0,0 @@
-import{sdkGuidanceSections as e}from"./common/sdk-content.js";export const generateAgentsMd=()=>`${[e.projectIntro,e.buildCommands,e.doNotEdit,"Phoenix SDK guidance lives in the `phoenix`, `phoenix-cli`, `phoenix-create-configurator`, `phoenix-feedback` and `phoenix-review` skills under `.claude/skills/` and `.agents/skills/`. Phoenix rewrites them on every sync, removes anything else inside their folders and removes other `phoenix`-prefixed skill folders, so to customise a skill, copy it to a folder whose name does not start with `phoenix`."].join("\n\n")}
-`;

package/dist/application-spec/generate-application/code/templates/common/sdk-content.d.ts

@@ -1,245 +0,0 @@
-/**
- * Documented Phoenix SDK guidance, one Markdown section per entry.
- *
- * The agent guidance shipped into generated projects — the starter `AGENTS.md` and the Phoenix-owned
- * agent skills — is composed from these sections, so each documented fact has exactly one home and
- * the generated files differ only in which sections they carry.
- */
-export declare const sdkGuidanceSections: {
-    /** Opening description of what a Phoenix configurator project is. */
-    readonly projectIntro: `## Phoenix Configurator Project
-
-Declarative 3D product configurator built with Phoenix SDK. Domain model defined in YAML, custom logic in TypeScript.`;
-    /** The three everyday `phoenix` package scripts. */
-    readonly buildCommands: `## Build Commands
-- \`pnpm phoenix build\` — Full production build
-- \`pnpm phoenix dev\` — Development mode with hot reload
-- \`pnpm phoenix sync\` — Sync generated files without full build`;
-    /** Where `phoenix dev` writes its log and how to read it. */
-    readonly devLogs: `## Dev Logs
-- \`pnpm phoenix dev\` writes all logs to \`.phoenix/phoenix-dev.log\`
-- Contains: spec parse errors, build errors, browser runtime errors, file watcher events
-- After making changes, always check the log for errors: \`tail -50 .phoenix/phoenix-dev.log\` or \`grep ERROR .phoenix/phoenix-dev.log\`
-- Rotated automatically at 10MB (\`.log.1\`, \`.log.2\` are older rotations)`;
-    /** What each top-level project folder holds. */
-    readonly projectStructure: `## Project Structure
-- \`spec/\` — Domain YAML specs (entities, relations, expressions, invariants, components, application config)
-- \`src/expressions/\` — Computed/derived entity properties (\`phx.domain.implementCustomExpressions()\`)
-- \`src/invariants/\` — Business rule constraints (\`phx.domain.implementCustomInvariants()\`)
-- \`src/transformers/\` — Automatic state fixers (\`phx.frontend.transformerBuilder\`)
-- \`src/components/\` — ECS system components (\`phx.domain.attachComponent.withEntity()\`)
-- \`src/elements/\` — Page-level React components (\`phx.frontend.createCustomPhoenixLayoutElement()\`)
-- \`src/handlers/\` — Event & lifecycle handlers
-- \`src/webhooks/\` — Server-side webhook handlers (\`phx.webhooks.*Builder\`)
-- \`src/migrations/\` — Schema version migrations (v*.ts)
-- \`src/locales/\` — Locale catalogs (authored .po sources; compiled .ts, do not edit)
-- \`src/admin/\` — Admin interface (mirrors main src/ structure)
-- \`src/_shared/\` — Shared utilities (NOT auto-imported, requires explicit imports)
-- \`.phoenix/\` — Auto-generated files (DO NOT EDIT)
-- \`public/\` — Static assets (3D models, textures, images, HDRI maps, fonts)
-- \`assets/\` — Uploadable resources (PDF templates, email assets)`;
-    /** The YAML-first, ECS, reactive-state principles a project follows. */
-    readonly architecturePrinciples: `## Architecture Principles
-- YAML-first: 99% of configuration in spec/*.yaml, custom code is last resort
-- ECS pattern: entities (domain objects) + components (behavior/UI) + systems (SDK runtime)
-- Reactive state: immutable domain state flows through RxJS pipelines
-- Data binding: \`$read\` (read-only), \`$write\` (write-only), \`$bind\` (bidirectional) connect components to domain
-- memoEval: all component implementations must use memoEval for stable object references`;
-    /** Expressions, invariants, transformers, components, webhooks, and filters at a glance. */
-    readonly keyPatterns: `## Key Patterns
-- Expressions = computed properties on entities (prefix: \`$\`), implemented per-entity in src/expressions/
-- Invariants = validation rules returning violations, static or dynamic
-- Transformers = auto-fixers maintaining consistency after state changes
-- Components defined in YAML with \`$read\`/\`$bind\` bindings, or custom in src/components/ using attachComponent builder
-- Webhooks = server-side finalization tasks (PDF, email, CSV, image rendering)
-- Filters = contextual component activation via navigationStates, viewStates, modes, selectedEntityIds`;
-    /** File and folder naming rules. */
-    readonly fileConventions: `## File Conventions
-- Components: PascalCase (.tsx)
-- Utilities: kebab-case (.ts)
-- Expressions: entity-name.ts
-- Migrations: v*.ts (sequential)
-- Specs: kebab-case.yaml
-- Underscore folders (_shared/, _utils/) are NOT auto-imported`;
-    /** The default-export rule of the SDK auto-import system. */
-    readonly exportRules: `## Export Rules
-All files in src/expressions/, src/invariants/, src/transformers/, src/components/, src/handlers/, src/webhooks/ MUST use default exports. Can be a single item or an array. Named exports are ignored by the SDK auto-import system.`;
-    /** Which components and handlers are bundled into the webhook. */
-    readonly webhookMembership: `## Webhook Membership
-- User-authored components, admin components, and handlers are frontend-only by default.
-- A handler that registers \`createMapPublishedRevisionDataHandler\`, \`createMapPublishedChunkedDataHandler\`, \`createDataRowValidatorHandler\`, or \`createSheetValidatorHandler\` is included in the webhook automatically.
-- To include another component or handler in the webhook, put \`'use webhook'\` as its first statement (leading comments are allowed).
-- A webhook-included file and its runtime local-import closure must not import browser SDK entrypoints (\`application\`, \`admin\`, \`configurator\`, \`editor\`, \`react\`, \`ui\`) or style/font/image assets. Spec parsing reports the unsafe import and inclusion reason as a diagnostic.
-- Keep browser rendering in an unpinned file. Move shared server-safe logic into a separate module when both frontend and webhook code need it.`;
-    /** Generated files a project must not edit. */
-    readonly doNotEdit: `## Do Not Edit
-- \`.phoenix/\` directory — completely regenerated on each build
-- \`tsconfig.json\`, \`eslint.config.js\`, \`prettier.config.js\`, \`.prettierignore\`, \`.linguirc\`, \`.nvmrc\`
-- \`src/locales/\` .ts files — compiled from .po files`;
-    /** How to find and read SDK documentation from the CLI. */
-    readonly sdkDocumentation: `## SDK Documentation
-
-Always search SDK docs for relevant examples before implementing Phoenix features.
-
-### Commands
-- \`pnpm phoenix docs\` — Full documentation index with descriptions
-- \`pnpm phoenix docs -s <term>\` — Search all doc content and metadata (case-insensitive)
-- \`pnpm phoenix docs --dir\` — Print the absolute docs directory for grep or ripgrep
-- \`pnpm phoenix docs -r <path>\` — Read specific doc (raw text to stdout)
-- \`pnpm phoenix docs -c <category>\` — List docs in a category
-- \`pnpm phoenix docs -l\` — List all doc paths with titles
-
-### Key Docs
-- \`docs/phoenix/getting-started.mdx\` — Setup, prerequisites, first project
-- \`docs/phoenix/quickstart.mdx\` — End-to-end tutorial building a configurator
-- \`docs/phoenix/domain-model.mdx\` — Entities, attributes, relations, specs
-- \`docs/phoenix/components.mdx\` — ECS pattern, YAML components, custom components
-- \`docs/phoenix/project-structure.mdx\` — Files, folders, conventions
-- \`docs/phoenix/best-practices.mdx\` — YAML-first, code patterns, common pitfalls
-- \`docs/phoenix/state-management.mdx\` — Reactive state, RxJS pipelines, data flow
-- \`docs/phoenix/expression-context.mdx\` — Expression API, context object, helpers
-- \`docs/phoenix/webhooks.mdx\` — Server-side finalization workflows
-- \`docs/phoenix/finalization.mdx\` — Finalization system, PDF/email/CSV generation
-- \`docs/phoenix/migrations.mdx\` — Schema versioning, migration files
-
-### Agent Workflow
-1. Find relevant docs by content: \`pnpm phoenix docs -s 'camera'\`
-2. Read matching doc: \`pnpm phoenix docs -r docs/3d-scene/cameras/transitions.mdx\`
-3. Search within a doc: \`pnpm phoenix docs -r <path> | grep "example"\`
-4. Search titles only as a fallback: \`pnpm phoenix docs -l | grep "camera"\`
-5. Search generated files directly when needed: \`grep -rn "camera" "$(pnpm phoenix docs --dir)"\`
-6. Browse a topic area: \`pnpm phoenix docs -c "Layouts"\``;
-    /** The `inspect:assets` glTF inspection command. */
-    readonly assetInspection: `## 3D Asset Inspection
-
-Run \`pnpm phoenix inspect:assets\` to discover all glTF/GLB files in \`public/\` and get a summary table. Use \`--file <path>\` for detailed single-file inspection.
-
-**When to use:** before writing YAML/code that references objectName, materialsToOverride, morphTargetInfluences, or object positioning.
-
-**What it shows per node:**
-- Name, type (Mesh/Light/Camera/Empty), children
-- Transform: \`pos=\`, \`rot=\`, \`scale=\` (only non-default values shown)
-- Per-node morph targets: \`morphs=Width,Height\`
-- Bounding box: \`bounds=WxHxD\` (width x height x depth in meters)
-- Origin placement: \`origin=center\`, \`bottom-center\`, \`top-center\`, \`bottom-corner\`, etc. with numerical offset
-
-**Use cases:**
-- Find exact node names for \`objectName\` in scene entity components
-- Find material names for \`materialsToOverride\`
-- Find morph target names for \`morphTargetInfluences\`
-- Check model dimensions (bounds) for positioning, dimension indicators, or invariants
-- Check origin placement to understand how models anchor (center vs bottom-center)
-- Use \`--json\` for programmatic access to all data
-
-**Flags:** \`--objects\`, \`--materials\`, \`--morphs\`, \`--animations\`, \`--json\``;
-    /** The `screenshot` command. */
-    readonly screenshotCli: `## Screenshot CLI
-
-Capture 3D canvas screenshots from a running dev server via \`pnpm phoenix screenshot\`.
-
-**Prerequisites:**
-1. \`phoenix dev\` must be running (starts the WebSocket server on port 3020)
-2. Configurator must be open in a browser (the browser does the actual rendering)
-
-**Options:**
-- \`--output, -o\` — Output file path (default: \`./screenshot.png\`)
-- \`--width, -w\` — Width in pixels (default: 1920)
-- \`--height\` — Height in pixels (default: 1080)
-- \`--format, -f\` — Image format: PNG or JPEG (default: PNG)
-- \`--port\` — WebSocket server port (default: 3020)
-
-**Example workflow:**
-1. Start dev server: \`pnpm phoenix dev\`
-2. Open configurator in browser (or via Playwright MCP)
-3. Take screenshot: \`pnpm phoenix screenshot -o ./render.png -w 2560 --height 1440\`
-
-**Use cases:** visual regression testing, generating product images, debugging 3D renders`;
-    /** The `inspect:state` command. */
-    readonly inspectState: `## Inspect: State
-
-Get the current editor runtime state as JSON via \`pnpm phoenix inspect:state\`.
-
-**Prerequisites:** same as screenshot (dev server running + browser open)
-
-**Options:**
-- \`--output, -o\` — Output file path (prints to stdout if omitted)
-- \`--sections, -s\` — Comma-separated: entities, navigation, validation (default: all)
-- \`--pretty\` — Pretty-print JSON (default: true)
-- \`--port\` — WebSocket server port (default: 3020)
-
-**Example:** \`pnpm phoenix inspect:state -o ./state.json -s entities,navigation\`
-
-**Lifecycle status:** Always included in response. Shows which systems are ready:
-- \`domainLoaded\` — domain data loaded
-- \`domainContextReady\` — domain context initialized (entities available)
-- \`configuratorReady\` — 3D configurator initialized
-- \`sessionAuthenticated\` — session service active
-- \`editorMode\` — editor mode enabled
-
-**Tips:** Use \`--sections\` to limit payload size. Pipe through \`head\`/\`tail\` for partial output (e.g., \`pnpm phoenix inspect:state | head -50\`).
-
-**Use cases:** AI agent context, debugging entity state, inspecting navigation/validation`;
-    /** The `inspect:data` command. */
-    readonly inspectData: `## Inspect: Data
-
-Get the current editor context data as JSON via \`pnpm phoenix inspect:data\`.
-
-**Prerequisites:** same as screenshot (dev server running + browser open)
-
-**Options:**
-- \`--output, -o\` — Output file path (prints to stdout if omitted)
-- \`--pretty\` — Pretty-print JSON (default: true)
-- \`--port\` — WebSocket server port (default: 3020)
-
-**Returns:** publishedData, frontendData, backendData, sessionData, accessData, webComponentProperties
-
-**Example:** \`pnpm phoenix inspect:data -o ./data.json\`
-
-**Tips:** Pipe through \`head\`/\`tail\` for partial output (e.g., \`pnpm phoenix inspect:data | head -30\`).
-
-**Use cases:** AI agent context, debugging published/session/access data`;
-    /** The `inspect:scene` command. */
-    readonly inspectScene: `## Inspect: Scene
-
-Get the current Three.js scene graph as JSON via \`pnpm phoenix inspect:scene\`.
-
-**Prerequisites:** same as screenshot (dev server running + browser open)
-
-**Options:**
-- \`--output, -o\` — Output file path (prints to stdout if omitted)
-- \`--pretty\` — Pretty-print JSON (default: true)
-- \`--port\` — WebSocket server port (default: 3020)
-
-**Returns:** Recursive scene tree with per-node: name, type, visible, position, rotation, scale, userData (entityId), and for meshes: geometry name, bounding box, material properties (color, metalness, roughness, opacity, textures), morph target influences. Lights include color, intensity, and type-specific properties.
-
-**Example:** \`pnpm phoenix inspect:scene -o ./scene.json\`
-
-**Tips:** Scene graphs can be large. Pipe through \`head\`/\`tail\` for partial output.
-
-**Use cases:** AI agent context, debugging 3D scene layout, inspecting materials and lighting`;
-    /** Browser automation setup for agents driving the 3D configurator. */
-    readonly playwrightMcpSetup: `## Playwright MCP Setup (for AI agents)
-
-To interact with the 3D configurator in a browser, Playwright MCP needs GPU-enabled flags for WebGL rendering. Add to \`~/.claude/.mcp.json\`:
-
-\`\`\`json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--headed",
-        "--launch-options",
-        "{\\"args\\":[\\"--use-gl=swiftshader\\",\\"--enable-webgl\\",\\"--ignore-gpu-blocklist\\"]}"
-      ]
-    }
-  }
-}
-\`\`\`
-
-Key flags:
-- \`--headed\` — visible browser (required for GPU rendering)
-- \`--use-gl=swiftshader\` — software GPU fallback for environments without a physical GPU
-- \`--enable-webgl\` + \`--ignore-gpu-blocklist\` — ensure WebGL is available`;
-};

package/dist/application-spec/generate-application/code/templates/common/sdk-content.js

@@ -1,67 +0,0 @@
-export const sdkGuidanceSections={projectIntro:`## Phoenix Configurator Project
-
-Declarative 3D product configurator built with Phoenix SDK. Domain model defined in YAML, custom logic in TypeScript.`,buildCommands:"## Build Commands\n- `pnpm phoenix build` — Full production build\n- `pnpm phoenix dev` — Development mode with hot reload\n- `pnpm phoenix sync` — Sync generated files without full build",devLogs:"## Dev Logs\n- `pnpm phoenix dev` writes all logs to `.phoenix/phoenix-dev.log`\n- Contains: spec parse errors, build errors, browser runtime errors, file watcher events\n- After making changes, always check the log for errors: `tail -50 .phoenix/phoenix-dev.log` or `grep ERROR .phoenix/phoenix-dev.log`\n- Rotated automatically at 10MB (`.log.1`, `.log.2` are older rotations)",projectStructure:"## Project Structure\n- `spec/` — Domain YAML specs (entities, relations, expressions, invariants, components, application config)\n- `src/expressions/` — Computed/derived entity properties (`phx.domain.implementCustomExpressions()`)\n- `src/invariants/` — Business rule constraints (`phx.domain.implementCustomInvariants()`)\n- `src/transformers/` — Automatic state fixers (`phx.frontend.transformerBuilder`)\n- `src/components/` — ECS system components (`phx.domain.attachComponent.withEntity()`)\n- `src/elements/` — Page-level React components (`phx.frontend.createCustomPhoenixLayoutElement()`)\n- `src/handlers/` — Event & lifecycle handlers\n- `src/webhooks/` — Server-side webhook handlers (`phx.webhooks.*Builder`)\n- `src/migrations/` — Schema version migrations (v*.ts)\n- `src/locales/` — Locale catalogs (authored .po sources; compiled .ts, do not edit)\n- `src/admin/` — Admin interface (mirrors main src/ structure)\n- `src/_shared/` — Shared utilities (NOT auto-imported, requires explicit imports)\n- `.phoenix/` — Auto-generated files (DO NOT EDIT)\n- `public/` — Static assets (3D models, textures, images, HDRI maps, fonts)\n- `assets/` — Uploadable resources (PDF templates, email assets)",architecturePrinciples:"## Architecture Principles\n- YAML-first: 99% of configuration in spec/*.yaml, custom code is last resort\n- ECS pattern: entities (domain objects) + components (behavior/UI) + systems (SDK runtime)\n- Reactive state: immutable domain state flows through RxJS pipelines\n- Data binding: `$read` (read-only), `$write` (write-only), `$bind` (bidirectional) connect components to domain\n- memoEval: all component implementations must use memoEval for stable object references",keyPatterns:"## Key Patterns\n- Expressions = computed properties on entities (prefix: `$`), implemented per-entity in src/expressions/\n- Invariants = validation rules returning violations, static or dynamic\n- Transformers = auto-fixers maintaining consistency after state changes\n- Components defined in YAML with `$read`/`$bind` bindings, or custom in src/components/ using attachComponent builder\n- Webhooks = server-side finalization tasks (PDF, email, CSV, image rendering)\n- Filters = contextual component activation via navigationStates, viewStates, modes, selectedEntityIds",fileConventions:`## File Conventions
-- Components: PascalCase (.tsx)
-- Utilities: kebab-case (.ts)
-- Expressions: entity-name.ts
-- Migrations: v*.ts (sequential)
-- Specs: kebab-case.yaml
-- Underscore folders (_shared/, _utils/) are NOT auto-imported`,exportRules:`## Export Rules
-All files in src/expressions/, src/invariants/, src/transformers/, src/components/, src/handlers/, src/webhooks/ MUST use default exports. Can be a single item or an array. Named exports are ignored by the SDK auto-import system.`,webhookMembership:"## Webhook Membership\n- User-authored components, admin components, and handlers are frontend-only by default.\n- A handler that registers `createMapPublishedRevisionDataHandler`, `createMapPublishedChunkedDataHandler`, `createDataRowValidatorHandler`, or `createSheetValidatorHandler` is included in the webhook automatically.\n- To include another component or handler in the webhook, put `'use webhook'` as its first statement (leading comments are allowed).\n- A webhook-included file and its runtime local-import closure must not import browser SDK entrypoints (`application`, `admin`, `configurator`, `editor`, `react`, `ui`) or style/font/image assets. Spec parsing reports the unsafe import and inclusion reason as a diagnostic.\n- Keep browser rendering in an unpinned file. Move shared server-safe logic into a separate module when both frontend and webhook code need it.",doNotEdit:"## Do Not Edit\n- `.phoenix/` directory — completely regenerated on each build\n- `tsconfig.json`, `eslint.config.js`, `prettier.config.js`, `.prettierignore`, `.linguirc`, `.nvmrc`\n- `src/locales/` .ts files — compiled from .po files",sdkDocumentation:'## SDK Documentation\n\nAlways search SDK docs for relevant examples before implementing Phoenix features.\n\n### Commands\n- `pnpm phoenix docs` — Full documentation index with descriptions\n- `pnpm phoenix docs -s <term>` — Search all doc content and metadata (case-insensitive)\n- `pnpm phoenix docs --dir` — Print the absolute docs directory for grep or ripgrep\n- `pnpm phoenix docs -r <path>` — Read specific doc (raw text to stdout)\n- `pnpm phoenix docs -c <category>` — List docs in a category\n- `pnpm phoenix docs -l` — List all doc paths with titles\n\n### Key Docs\n- `docs/phoenix/getting-started.mdx` — Setup, prerequisites, first project\n- `docs/phoenix/quickstart.mdx` — End-to-end tutorial building a configurator\n- `docs/phoenix/domain-model.mdx` — Entities, attributes, relations, specs\n- `docs/phoenix/components.mdx` — ECS pattern, YAML components, custom components\n- `docs/phoenix/project-structure.mdx` — Files, folders, conventions\n- `docs/phoenix/best-practices.mdx` — YAML-first, code patterns, common pitfalls\n- `docs/phoenix/state-management.mdx` — Reactive state, RxJS pipelines, data flow\n- `docs/phoenix/expression-context.mdx` — Expression API, context object, helpers\n- `docs/phoenix/webhooks.mdx` — Server-side finalization workflows\n- `docs/phoenix/finalization.mdx` — Finalization system, PDF/email/CSV generation\n- `docs/phoenix/migrations.mdx` — Schema versioning, migration files\n\n### Agent Workflow\n1. Find relevant docs by content: `pnpm phoenix docs -s \'camera\'`\n2. Read matching doc: `pnpm phoenix docs -r docs/3d-scene/cameras/transitions.mdx`\n3. Search within a doc: `pnpm phoenix docs -r <path> | grep "example"`\n4. Search titles only as a fallback: `pnpm phoenix docs -l | grep "camera"`\n5. Search generated files directly when needed: `grep -rn "camera" "$(pnpm phoenix docs --dir)"`\n6. Browse a topic area: `pnpm phoenix docs -c "Layouts"`',assetInspection:"## 3D Asset Inspection\n\nRun `pnpm phoenix inspect:assets` to discover all glTF/GLB files in `public/` and get a summary table. Use `--file <path>` for detailed single-file inspection.\n\n**When to use:** before writing YAML/code that references objectName, materialsToOverride, morphTargetInfluences, or object positioning.\n\n**What it shows per node:**\n- Name, type (Mesh/Light/Camera/Empty), children\n- Transform: `pos=`, `rot=`, `scale=` (only non-default values shown)\n- Per-node morph targets: `morphs=Width,Height`\n- Bounding box: `bounds=WxHxD` (width x height x depth in meters)\n- Origin placement: `origin=center`, `bottom-center`, `top-center`, `bottom-corner`, etc. with numerical offset\n\n**Use cases:**\n- Find exact node names for `objectName` in scene entity components\n- Find material names for `materialsToOverride`\n- Find morph target names for `morphTargetInfluences`\n- Check model dimensions (bounds) for positioning, dimension indicators, or invariants\n- Check origin placement to understand how models anchor (center vs bottom-center)\n- Use `--json` for programmatic access to all data\n\n**Flags:** `--objects`, `--materials`, `--morphs`, `--animations`, `--json`",screenshotCli:"## Screenshot CLI\n\nCapture 3D canvas screenshots from a running dev server via `pnpm phoenix screenshot`.\n\n**Prerequisites:**\n1. `phoenix dev` must be running (starts the WebSocket server on port 3020)\n2. Configurator must be open in a browser (the browser does the actual rendering)\n\n**Options:**\n- `--output, -o` — Output file path (default: `./screenshot.png`)\n- `--width, -w` — Width in pixels (default: 1920)\n- `--height` — Height in pixels (default: 1080)\n- `--format, -f` — Image format: PNG or JPEG (default: PNG)\n- `--port` — WebSocket server port (default: 3020)\n\n**Example workflow:**\n1. Start dev server: `pnpm phoenix dev`\n2. Open configurator in browser (or via Playwright MCP)\n3. Take screenshot: `pnpm phoenix screenshot -o ./render.png -w 2560 --height 1440`\n\n**Use cases:** visual regression testing, generating product images, debugging 3D renders",inspectState:"## Inspect: State\n\nGet the current editor runtime state as JSON via `pnpm phoenix inspect:state`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` — Output file path (prints to stdout if omitted)\n- `--sections, -s` — Comma-separated: entities, navigation, validation (default: all)\n- `--pretty` — Pretty-print JSON (default: true)\n- `--port` — WebSocket server port (default: 3020)\n\n**Example:** `pnpm phoenix inspect:state -o ./state.json -s entities,navigation`\n\n**Lifecycle status:** Always included in response. Shows which systems are ready:\n- `domainLoaded` — domain data loaded\n- `domainContextReady` — domain context initialized (entities available)\n- `configuratorReady` — 3D configurator initialized\n- `sessionAuthenticated` — session service active\n- `editorMode` — editor mode enabled\n\n**Tips:** Use `--sections` to limit payload size. Pipe through `head`/`tail` for partial output (e.g., `pnpm phoenix inspect:state | head -50`).\n\n**Use cases:** AI agent context, debugging entity state, inspecting navigation/validation",inspectData:`## Inspect: Data
-
-Get the current editor context data as JSON via \`pnpm phoenix inspect:data\`.
-
-**Prerequisites:** same as screenshot (dev server running + browser open)
-
-**Options:**
-- \`--output, -o\` — Output file path (prints to stdout if omitted)
-- \`--pretty\` — Pretty-print JSON (default: true)
-- \`--port\` — WebSocket server port (default: 3020)
-
-**Returns:** publishedData, frontendData, backendData, sessionData, accessData, webComponentProperties
-
-**Example:** \`pnpm phoenix inspect:data -o ./data.json\`
-
-**Tips:** Pipe through \`head\`/\`tail\` for partial output (e.g., \`pnpm phoenix inspect:data | head -30\`).
-
-**Use cases:** AI agent context, debugging published/session/access data`,inspectScene:`## Inspect: Scene
-
-Get the current Three.js scene graph as JSON via \`pnpm phoenix inspect:scene\`.
-
-**Prerequisites:** same as screenshot (dev server running + browser open)
-
-**Options:**
-- \`--output, -o\` — Output file path (prints to stdout if omitted)
-- \`--pretty\` — Pretty-print JSON (default: true)
-- \`--port\` — WebSocket server port (default: 3020)
-
-**Returns:** Recursive scene tree with per-node: name, type, visible, position, rotation, scale, userData (entityId), and for meshes: geometry name, bounding box, material properties (color, metalness, roughness, opacity, textures), morph target influences. Lights include color, intensity, and type-specific properties.
-
-**Example:** \`pnpm phoenix inspect:scene -o ./scene.json\`
-
-**Tips:** Scene graphs can be large. Pipe through \`head\`/\`tail\` for partial output.
-
-**Use cases:** AI agent context, debugging 3D scene layout, inspecting materials and lighting`,playwrightMcpSetup:`## Playwright MCP Setup (for AI agents)
-
-To interact with the 3D configurator in a browser, Playwright MCP needs GPU-enabled flags for WebGL rendering. Add to \`~/.claude/.mcp.json\`:
-
-\`\`\`json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--headed",
-        "--launch-options",
-        "{\\"args\\":[\\"--use-gl=swiftshader\\",\\"--enable-webgl\\",\\"--ignore-gpu-blocklist\\"]}"
-      ]
-    }
-  }
-}
-\`\`\`
-
-Key flags:
-- \`--headed\` — visible browser (required for GPU rendering)
-- \`--use-gl=swiftshader\` — software GPU fallback for environments without a physical GPU
-- \`--enable-webgl\` + \`--ignore-gpu-blocklist\` — ensure WebGL is available`};

package/dist/application-spec/generate-application/code/templates/env-ci.d.ts

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

package/dist/application-spec/generate-application/code/templates/env-ci.js

@@ -1,25 +0,0 @@
-export const generateApplicationSpecEnvCi=()=>`# CI Environment Configuration
-#
-# This file is used to initialize environment variables in CI pipelines with mock data.
-# It allows the frontend and webhooks to be built without requiring actual credentials.
-# These values are sufficient for builds. DEPLOYMENT_ID also supports local-storage runtime;
-# server-backed runtime operations still require real deployment credentials.
-#
-# To use: run 'pnpm run prepare:ci' to copy this file to .env
-
-# Frontend
-DEPLOYMENT_ID=will-not-work-but-will-initialize
-SERVER_URL=http://not.valid
-FRONTEND_URL=http://not.valid
-RESOURCES_URL=http://not.valid
-CLERK_PUBLISHABLE_KEY=will-not-work-but-will-initialize
-GTM_ID=GTM-XXXXXX
-DATADOG_CLIENT_TOKEN=XXXXXX
-DATADOG_SITE=XXX
-SERVICE_NAME=project-template
-
-# Webhook
-AWS_S3_PUBLIC_RESOURCES_BUCKET=private
-AWS_S3_PRIVATE_RESOURCES_BUCKET=public
-AWS_S3_RESOURCES_REGION=eu-central-1
-`;

package/dist/application-spec/generate-application/code/templates/env-example.d.ts

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

package/dist/application-spec/generate-application/code/templates/env-example.js

@@ -1,90 +0,0 @@
-export const generateApplicationSpecEnvExample=()=>`# This file documents developer-supplied Phoenix variables. Copy the values you
-# need into an untracked .env; never commit .env.
-# phoenix dev, deployment:prepare-dev, and deployment:prepare-local write
-# server-generated values to .env.generated; do not maintain them here.
-
-# ============================================================================
-# Development environment (phoenix dev and deployment:prepare-dev)
-# ============================================================================
-# Not needed when you are signed in with phoenix login. Otherwise create a
-# development environment in PHX Studio and paste its block here.
-#
-# SERVER_URL=http://localhost:3000
-# PROJECT_SLUG=<project-slug>
-# ENVIRONMENT_SLUG=<development-environment-slug>
-# DEVELOPMENT_KEY=<development-key>
-
-# ============================================================================
-# Shared-server access (deployment:prepare-local and CI commands only)
-# ============================================================================
-# Ask DevOps for these values when using the legacy prepare-local or CI flows.
-# SERVER_URL=https://phoenix.example.com
-# ENVIRONMENT_API_KEY=<shared-server-api-key>
-# PROJECT_KEY=<shared-server-project-key>
-# PROJECT_SLUG=<project-slug>
-# ENVIRONMENT_SLUG=<environment-slug>
-# LAMBDA_URL=http://localhost:8080
-
-# ============================================================================
-# Dev Configuration (phoenix dev)
-# ============================================================================
-# Override these to run multiple projects simultaneously.
-# Ports auto-increment if occupied, but setting explicit values avoids surprises.
-#
-# EDITOR_WS_PORT=3020
-# ENABLE_EDITOR=true
-# Enable Lingui extraction and compilation during dev. Phoenix warns when this is disabled.
-# WITH_LINGUI=false
-# DEBUG=false
-# FORCE_REBUILD=false
-# USE_APPLICATION_SPEC=true
-# IS_DEV=true
-#
-# Persistence mode controls how configurator state is stored.
-# Options: 'server' (default), 'local-storage', 'memory'
-# PERSISTENCE_MODE=server
-
-# deployment:prepare-dev and deployment:prepare-local output and behavior overrides:
-# OUT_FILE=.env.generated
-# SKIP_UPLOAD also applies to the deployment phoenix dev prepares at startup.
-# SKIP_UPLOAD=false
-# OVERRIDE_SCHEMA=true
-
-# ============================================================================
-# Project-Specific Environment Variables
-# ============================================================================
-# Additional environment variables can be defined in spec/application.yaml
-# under the 'env.frontend' and 'env.webhook' sections.
-#
-# These are useful for project-specific needs such as:
-# - Third-party API keys (e.g., salesforce)
-# - External service URLs
-# - Feature flags
-# - Custom configuration values
-#
-# Example in spec/application.yaml:
-#   env:
-#     frontend:
-#       SALESFORCE_CLIENT_ID:
-#         type: str
-#         devDefault: pk_test_xxx
-#     webhook:
-#       SALESFORCE_CLIENT_SECRET:
-#         type: str
-#       SALESFORCE_REDIRECT_URI:
-#         type: str
-#
-# These will be automatically validated and available in your code via
-# the generated frontend.config.ts and webhooks.config.ts files.
-#
-# IMPORTANT: If you add required custom environment variables (without defaults),
-# remember to also add them to .env.ci with mock values so CI builds can succeed.
-
-# ============================================================================
-# Generated environment
-# ============================================================================
-# Deployment variables (DEPLOYMENT_ID, RESOURCES_URL, and related values)
-# are auto-generated by the PHX server and written to .env.generated when you run
-# phoenix dev, deployment:prepare-dev, or deployment:prepare-local. Development
-# environment settings can be managed via PHX Studio.
-`;

package/dist/application-spec/generate-application/code/templates/nvmrc.d.ts

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

package/dist/application-spec/generate-application/code/templates/nvmrc.js

@@ -1,2 +0,0 @@
-export const generateApplicationSpecNvmrc=()=>`v24.14.1
-`;

package/dist/application-spec/generate-application/code/templates/package-json.d.ts

@@ -1,10 +0,0 @@
-interface GenerateApplicationSpecPackageJsonProps {
-    readonly sdkVersion: string;
-    readonly useWorkspace: boolean;
-    readonly useClerk?: boolean;
-    readonly name?: string;
-    readonly description?: string;
-    readonly existingContent?: string;
-}
-export declare const generateApplicationSpecPackageJson: (props: GenerateApplicationSpecPackageJsonProps) => string;
-export {};

package/dist/application-spec/generate-application/code/templates/package-json.js

@@ -1 +0,0 @@
-let e=["@salsita-ai/platform-project-sdk","@salsita-ai/platform-common","@salsita-ai/platform-contracts","@salsita-ai/common","@salsita-ai/contracts"],t=(e,t)=>e>t?1:e<t?-1:0,r={private:!0,type:"module",packageManager:"pnpm@11.1.3",engines:{node:"24.14.1",pnpm:"11.1.3"}},i={"babel-plugin-macros":"3.1.0",vite:"6.4.3","@vitejs/plugin-react":"5.2.0","@swc/cli":"0.8.1","@swc/core":"1.15.40",typescript:"npm:@typescript/typescript6@6.0.2","@lingui/cli":"5.9.5","@types/lodash-es":"4.17.12","@lingui/macro":"5.9.5","@lingui/swc-plugin":"5.11.0","@types/node":"24.12.2","@types/react":"18.3.8","@types/react-dom":"18.3.0","@types/three":"0.160.0","@typescript/native":"npm:typescript@7.0.2",envalid:"8.1.1",eslint:"9.39.4",prettier:"3.8.3",vitest:"4.1.11"},n={build:"phoenix build",clean:"phoenix clean",dev:"phoenix dev","dev:local":"phoenix dev --persistence local-storage",sync:"phoenix sync",check:"phoenix check",fix:"phoenix fix","verify:fix":"phoenix build && phoenix fix && phoenix check --types",test:"vitest --passWithNoTests run","test:watch":"vitest","prepare:ci":"phoenix prepare:ci","deployment:prepare-local":"phoenix deployment:prepare-local"},s=["environment:create","environment:list","deployment:register","deployment:register:skip","lint:check","prettify:check","ts:check","lint:fix","prettify:fix"],c=e=>"object"==typeof e&&null!==e&&!Array.isArray(e),o=e=>{if(!c(e))return;let t=[];for(let[r,i]of Object.entries(e)){if("string"!=typeof i)return;t.push([r,i])}return Object.fromEntries(t)},a=e=>e.replace(/^[\^~]/,""),p=(r,i)=>{let n={};for(let[e,t]of Object.entries(r))n[e]=a(t);if(i)for(let[e,t]of Object.entries(i))e in n||(n[e]=a(t));return Object.fromEntries(Object.entries(n).filter(([t])=>!e.includes(t)).sort(([e],[r])=>t(e,r)))};export const generateApplicationSpecPackageJson=e=>{let{sdkVersion:a,useWorkspace:l,useClerk:f=!1,name:m,description:d,existingContent:u}=e,y=(e=>{if(!e)return{};try{let t=JSON.parse(e);if(c(t))return t}catch{}return{}})(u),h=p({...f?{"@clerk/clerk-react":"5.61.8"}:{},"camera-controls":"2.4.2","lodash-es":"4.18.1",react:"18.3.1","react-dom":"18.3.1","@emotion/react":"11.11.3","@emotion/styled":"11.11.0","@mui/material":"5.15.5","@mui/system":"5.16.7","@lingui/core":"5.9.5","@lingui/react":"5.9.5",three:"0.160.1","@react-three/fiber":"8.15.16","@react-three/drei":"9.97.6","@react-three/postprocessing":"2.16.3",motion:"12.34.0","@tanstack/react-query":"5.100.14",rxjs:"7.8.2",uuid:"14.0.0","ts-pattern":"5.9.0","@salsita-ai/sdk":l?"workspace:^":a,zod:"3.25.76"},o(y.dependencies)),g=p(i,o(y.devDependencies)),x=((e,r)=>{let i={};for(let[t,r]of Object.entries(e))i[t]=r;if(r)for(let[e,t]of Object.entries(r))e in i||(i[e]=t);return Object.fromEntries(Object.entries(i).filter(([e])=>!s.includes(e)).sort(([e],[r])=>t(e,r)))})({...n,...l?{dev:"phoenix dev --local"}:{}},o(y.scripts)),v=y.name,b=m?m.toLowerCase().replace(/[^a-z0-9-]/g,"-"):"string"==typeof v?v:"project-name",j={...y,name:b,...r,scripts:x,dependencies:h,devDependencies:g};return void 0!==d&&(j.description=d),JSON.stringify(j,null,2)+"\n"};

package/dist/application-spec/generate-application/code/templates/phoenix-cli-skill.js

@@ -1 +0,0 @@
-import{renderAgentSkill as n}from"./common/agent-skill.js";import{sdkGuidanceSections as e}from"./common/sdk-content.js";export const generatePhoenixCliSkill=()=>n({name:"phoenix-cli",description:"Phoenix CLI tooling for building and inspecting this configurator, covering build, dev and sync commands, dev logs, glTF asset inspection, screenshots, runtime state, data and scene inspection, and Playwright MCP setup. Use when building, debugging build or runtime errors, checking 3D assets, or inspecting the running configurator.",sections:[e.buildCommands,e.devLogs,e.assetInspection,e.screenshotCli,e.inspectState,e.inspectData,e.inspectScene,e.playwrightMcpSetup]});

package/dist/application-spec/generate-application/code/templates/phoenix-create-configurator-skill.d.ts

@@ -1,3 +0,0 @@
-import { type AgentSkillReference } from './common/agent-skill.js';
-export declare const generatePhoenixCreateConfiguratorSkill: () => string;
-export declare const generatePhoenixCreateConfiguratorSkillReferences: () => readonly AgentSkillReference[];