@salsita-ai/sdk 0.50.0-develop.ae52227c7e → 0.50.0-develop.aec0f535bf

package/dist/phoenix/editor-server/trpc.d.ts

@@ -1,21 +1,11 @@
-import type { LogBus } from '../services/log-bus.js';
+import type { PhoenixApplication } from '../services/index.js';
 import type { PhoenixPubSub } from '../services/phoenix-pubsub.js';
-import type { VariantPreviewService } from '../services/variant-preview-service.js';
-import type { WebhookTunnelMonitor } from '../services/webhook-tunnel-monitor.js';
 import type { Logger } from '../utils/index.js';
 export type Context = {
     readonly projectRoot: string;
     readonly pubsub: PhoenixPubSub;
     readonly logger: Logger;
-    /** The session's variant comparison; absent where project files cannot be rewritten, such as story-dev. */
-    readonly variantPreviews: VariantPreviewService | undefined;
-    /** Bound to this dev session; absent for offline and story sessions. */
-    readonly prepareDeployment?: () => Promise<void>;
-    readonly storyMode?: boolean;
-    /** Dev-server log buffer backing the editor Logs panel; absent in story mode. */
-    readonly logBus?: LogBus;
-    /** Dev-process tunnel state backing the editor Webhook Tunnel panel. */
-    readonly tunnelMonitor?: WebhookTunnelMonitor;
+    readonly application: PhoenixApplication;
 };
 export declare const router: import("@trpc/server").TRPCRouterBuilder<{
     ctx: Context;

package/dist/phoenix/lingui/index.d.ts

@@ -0,0 +1 @@
+export { LINGUI_CONFIG_PATH, bootstrapLinguiCatalogs, compileLingui, extractAndCompileLingui } from './lingui.js';

package/dist/phoenix/lingui/index.js

@@ -0,0 +1 @@
+export{LINGUI_CONFIG_PATH,bootstrapLinguiCatalogs,compileLingui,extractAndCompileLingui}from"./lingui.js";

package/dist/phoenix/lingui/lingui.d.ts

@@ -0,0 +1,18 @@
+import { type Logger } from '../utils/index.js';
+/**
+ * The project's Lingui configuration, which sync generates, relative to the project root. The Lingui
+ * CLI is given this path and Vite loads its plugins from a fresh snapshot of this file, so a
+ * `.linguirc` that earlier SDK versions left in the project root is not read. The Lingui CLI searches
+ * the working directory instead only when the named file is missing; generation writes it with the rest
+ * of `.phoenix/` before Phoenix runs Lingui or Vite. Missing-catalog bootstrap compiles with a temporary
+ * copy that stages output while keeping every locale available for fallback reads.
+ */
+export declare const LINGUI_CONFIG_PATH = ".phoenix/.linguirc";
+interface LinguiCommandContext {
+    readonly logger: Logger;
+}
+export declare const compileLingui: (context: LinguiCommandContext) => Promise<void>;
+export declare const extractAndCompileLingui: (context: LinguiCommandContext) => Promise<void>;
+/** Creates only catalogs missing from a project's generated domain imports; continuous updates stay opt-in. */
+export declare const bootstrapLinguiCatalogs: (locales: readonly string[], context: LinguiCommandContext) => Promise<void>;
+export {};

package/dist/phoenix/lingui/lingui.js

@@ -0,0 +1 @@
+import{constants as i}from"node:fs";import{copyFile as a,mkdir as t,mkdtemp as e,readFile as o,rm as n,writeFile as s}from"node:fs/promises";import{dirname as r,join as l}from"node:path";import{exists as c,runSdkTool as g}from"../utils/index.js";export const LINGUI_CONFIG_PATH=".phoenix/.linguirc";let p=async i=>{await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract","--config",LINGUI_CONFIG_PATH],description:"Extracting i18n messages",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},i)};export const compileLingui=async i=>{await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile","--config",LINGUI_CONFIG_PATH],description:"Compiling i18n messages",quiet:!0},i)};export const extractAndCompileLingui=async i=>{await p(i),await compileLingui(i)};export const bootstrapLinguiCatalogs=async(p,m)=>{let u,f=(await Promise.all(p.map(async i=>await c(`src/locales/${i}/messages.ts`)?[]:[i]))).flat();if(0!==f.length)try{m.logger.info(`Bootstrapping missing i18n catalogs: ${f.join(", ")}`);let n=(await Promise.all(f.map(async i=>await c(`src/locales/${i}/messages.po`)?[]:[i]))).flat();n.length>0&&await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract","--config",LINGUI_CONFIG_PATH,"--locale",n.join(",")],description:"Extracting missing i18n catalogs",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},m);let p=JSON.parse(await o(LINGUI_CONFIG_PATH,"utf-8"));if("object"!=typeof p||null===p||Array.isArray(p))throw Error(`${LINGUI_CONFIG_PATH} is not a configuration object`);u=await e(".phoenix/lingui-bootstrap-");let N=l(u,".linguirc");for(let e of(await s(N,JSON.stringify({...p,catalogsMergePath:l(u,"compiled","{locale}","messages").replaceAll("\\","/")})),await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile","--config",N],description:"Compiling missing i18n catalogs",quiet:!0},m),f)){let o=l("src","locales",e,"messages.ts");await t(r(o),{recursive:!0}),await a(l(u,"compiled",e,"messages.ts"),o,i.COPYFILE_EXCL)}}catch(i){throw Error(`Cannot bootstrap i18n catalogs for ${f.join(", ")}: ${i instanceof Error?i.message:String(i)}. Fix the reported Lingui error and restart phoenix dev, or run phoenix sync to update all catalogs.`,{cause:i})}finally{void 0!==u&&await n(u,{recursive:!0,force:!0})}};

package/dist/phoenix/scripts/docs-utils.js

@@ -1 +1 @@
-import{existsSync as t,readFileSync as e,readdirSync as r,statSync as s}from"fs";import{convertPathToPattern as o,globby as i}from"globby";import{dirname as n,join as a,resolve as l}from"path";import{fileURLToPath as p}from"url";let c=n(p(import.meta.url));export const PROJECT_SDK_ROOT=l(c,"../../..");export const MONOREPO_ROOT=l(PROJECT_SDK_ROOT,"../../..");export const DIST_DOCS=a(PROJECT_SDK_ROOT,"dist/docs");let m=a(MONOREPO_ROOT,"packages/apps/storybook");export const STORYBOOK_SRC=a(m,"src");export const STORYBOOK_EXAMPLES=a(STORYBOOK_SRC,"examples");export const UI_SDK_SRC=a(PROJECT_SDK_ROOT,"src/ui-sdk");let u=a(m,".storybook/preview.tsx"),f=/order:\s*\[/;export const parseTopCategoriesFromPreview=t=>{let e=f.exec(t);if(!e)return[];let r=0,s=e.index+e[0].length-1,o=[],i="",n=!1,a="";for(;s<t.length;s++){let e=t[s];if("["===e&&!n){r++;continue}if("]"===e&&!n){if(0==--r)break;continue}if(1===r){if(("'"===e||'"'===e)&&!n){n=!0,a=e,i="";continue}if(e===a&&n){n=!1,"*"!==i&&o.push(i);continue}n&&(i+=e)}}return o};export const buildCategoryCaseMap=t=>new Map(t.map(t=>[t.toLowerCase(),t]));export const loadDocsConfig=()=>{let t=e(u,"utf-8"),r=parseTopCategoriesFromPreview(t),s=buildCategoryCaseMap(r);return{topCategories:r,caseMap:s}};export const discoverMdxFiles=async()=>i([`${o(STORYBOOK_SRC)}/**/*.mdx`,`${o(UI_SDK_SRC)}/**/*.mdx`],{absolute:!0});export const getSource=t=>t.startsWith(STORYBOOK_EXAMPLES)?"storybook-example":t.startsWith(STORYBOOK_SRC)?"storybook-root":t.startsWith(UI_SDK_SRC)?"ui-sdk":"unknown";let g=/<Meta\s+title=["']([^"']+)["']\s*\/?>/,x=/<Meta\s+of=\{(\w+)\}\s*\/?>/,h=/title:\s*['"]([^'"]+)['"]/;export const parseMdxTitle=t=>{let e=g.exec(t);return e?.[1]};export const parseStoriesTitle=t=>{let e=h.exec(t);return e?.[1]};export const resolveStoriesPath=(e,r)=>{let s=x.exec(r);if(!s)return;let o=s[1],i=r.match(RegExp(`import\\s+\\*\\s+as\\s+${o}\\s+from\\s+['"]([^'"]+)['"]`));if(!i?.[1])return;let a=l(n(e),i[1]);if(!a.endsWith(".tsx")&&!a.endsWith(".ts"))if(t(a+".tsx"))a+=".tsx";else{if(!t(a+".ts"))return;a+=".ts"}return t(a)?a:void 0};export const resolveTitle=(t,r)=>{let s=parseMdxTitle(r);if(s)return s;let o=resolveStoriesPath(t,r);if(!o)return;let i=e(o,"utf-8");return parseStoriesTitle(i)};export const findFirstParagraph=t=>{let e=t.split("\n"),r=[],s=!1,o=!1;for(let t of e){let e=t.trim();if(e.startsWith("```")){o=!o;continue}if(!(o||e.startsWith("- [")||e.startsWith("* [")||e.startsWith("#")||e.startsWith("<")||e.startsWith("{/*")||e.startsWith("|"))&&!e.startsWith(">")){if(""===e){if(s&&r.length>0)break;continue}s=!0,r.push(e)}}return r.length>0?r.join(" "):void 0};export const truncateAtWord=(t,e)=>{if(t.length<=e)return t;let r=t.slice(0,e),s=r.lastIndexOf(" ");return(s>0?r.slice(0,s):r)+"..."};export const extractDescription=t=>{let e=t.split("\n").filter(t=>!t.startsWith("import ")).filter(t=>!t.startsWith("<Meta")).filter(t=>!t.startsWith("<Canvas")).filter(t=>!t.startsWith("<Story")).filter(t=>!t.startsWith("<Controls")).filter(t=>!t.startsWith("<Markdown")).join("\n"),r=/^# .+$/m.exec(e),s=/^## .+$/m.exec(e),o=r?r.index+r[0].length:0,i=s?s.index:e.length,n=e.slice(o,i),a=findFirstParagraph(n);if(!a&&s){let t=e.slice(s.index+s[0].length),r=/^## .+$/m.exec(t),o=r?t.slice(0,r.index):t;a=findFirstParagraph(o)}return a?truncateAtWord(a,200):""};export const parseCategoryPath=t=>{let e=t.split(/\s*\/\s*/).map(t=>t.trim()).filter(Boolean);return 0===e.length?["Uncategorized"]:e};export const normalizeTopCategory=(t,e)=>e.get(t.toLowerCase())??t;export const slugify=t=>t.toLowerCase().replace(/&/g,"and").replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"");export const computeOutputPath=(t,e)=>{let r=t.slice(0,-1).map(slugify).join("/"),s=`${e}.mdx`;return r?`${r}/${s}`:s};export const resolveDocMeta=(t,e)=>{let r=parseCategoryPath(t),s=r[0],o=r[r.length-1];if(!s||!o)return;let i=[normalizeTopCategory(s,e),...r.slice(1)],n=slugify(o),a=computeOutputPath(i,n);return{title:t,lastSegment:o,normalizedSegments:i,docSlug:n,outputRelative:a}};let d=[/^import\s+\{[^}]*\}\s+from\s+['"]@storybook\/[^'"]+['"]\s*$/gm,/^import\s+\*\s+as\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.mdx[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\?raw['"]\s*$/gm,/^<Meta\s+[^>]*\/>\s*$/gm,/^<Canvas\s+[^>]*\/>\s*$/gm,/^<Story\s+[^>]*\/>\s*$/gm,/^<Controls\s+[^>]*\/>\s*$/gm,/^<Markdown>\{[^}]+\}<\/Markdown>\s*$/gm];export const stripStorybookImports=t=>{let e=t;for(let t of d)e=e.replace(t,"");return e.replace(/\n{3,}/g,"\n\n").trim()+"\n"};export const buildCategoryTree=(t,e,r)=>{let s=new Map,o=(t,e)=>{let r=t.get(e);return r||(r={name:e,docs:[],subcategories:new Map},t.set(e,r)),r};for(let e of t){let t=e.category,i=t[0];if(0===t.length||!i)continue;let n=o(s,normalizeTopCategory(i,r));if(1===t.length){n.docs.push(e);continue}let a=n;for(let e=1;e<t.length-1;e++){let r=t[e];r&&(a=o(a.subcategories,r))}a.docs.push(e)}let i=new Map(e.map((t,e)=>[t,e])),n=t=>({name:t.name,docs:t.docs,subcategories:Array.from(t.subcategories.values()).map(n)});return Array.from(s.values()).sort((t,e)=>(i.get(t.name)??999)-(i.get(e.name)??999)||t.name.localeCompare(e.name)).map(n)};export const getDirectorySizeBytes=t=>{let e=0;for(let o of r(t,{withFileTypes:!0})){let r=a(t,o.name);o.isDirectory()?e+=getDirectorySizeBytes(r):e+=s(r).size}return e};export const formatBytes=t=>{if(t<1024)return`${t} B`;let e=t/1024;if(e<1024)return`${e.toFixed(1)} KB`;let r=e/1024;return`${r.toFixed(1)} MB`};
+import{existsSync as t,readFileSync as e,readdirSync as r,statSync as s}from"fs";import{convertPathToPattern as o,globby as i}from"globby";import{dirname as n,join as a,resolve as l}from"path";import{fileURLToPath as p}from"url";let c=n(p(import.meta.url));export const PROJECT_SDK_ROOT=l(c,"../../..");export const MONOREPO_ROOT=l(PROJECT_SDK_ROOT,"../../..");export const DIST_DOCS=a(PROJECT_SDK_ROOT,"dist/docs");let m=a(MONOREPO_ROOT,"packages/apps/storybook");export const STORYBOOK_SRC=a(m,"src");export const STORYBOOK_EXAMPLES=a(STORYBOOK_SRC,"examples");export const UI_SDK_SRC=a(PROJECT_SDK_ROOT,"src/ui-sdk");let f=a(m,".storybook/preview.tsx"),u=/order:\s*\[/;export const parseTopCategoriesFromPreview=t=>{let e=u.exec(t);if(!e)return[];let r=0,s=e.index+e[0].length-1,o=[],i="",n=!1,a="";for(;s<t.length;s++){let e=t[s];if("["===e&&!n){r++;continue}if("]"===e&&!n){if(0==--r)break;continue}if(1===r){if(("'"===e||'"'===e)&&!n){n=!0,a=e,i="";continue}if(e===a&&n){n=!1,"*"!==i&&o.push(i);continue}n&&(i+=e)}}return o};export const buildCategoryCaseMap=t=>new Map(t.map(t=>[t.toLowerCase(),t]));export const loadDocsConfig=()=>{let t=e(f,"utf-8"),r=parseTopCategoriesFromPreview(t),s=buildCategoryCaseMap(r);return{topCategories:r,caseMap:s}};export const discoverMdxFiles=async()=>i([`${o(STORYBOOK_SRC)}/**/*.mdx`,`${o(UI_SDK_SRC)}/**/*.mdx`],{absolute:!0});export const getSource=t=>t.startsWith(STORYBOOK_EXAMPLES)?"storybook-example":t.startsWith(STORYBOOK_SRC)?"storybook-root":t.startsWith(UI_SDK_SRC)?"ui-sdk":"unknown";let g=/<Meta\s+title=["']([^"']+)["']\s*\/?>/,x=/<Meta\s+of=\{(\w+)\}\s*\/?>/,h=/title:\s*['"]([^'"]+)['"]/;export const parseMdxTitle=t=>{let e=g.exec(t);return e?.[1]};export const parseStoriesTitle=t=>{let e=h.exec(t);return e?.[1]};export const resolveStoriesPath=(e,r)=>{let s=x.exec(r);if(!s)return;let o=s[1],i=r.match(RegExp(`import\\s+\\*\\s+as\\s+${o}\\s+from\\s+['"]([^'"]+)['"]`));if(!i?.[1])return;let a=l(n(e),i[1]);if(!a.endsWith(".tsx")&&!a.endsWith(".ts"))if(t(a+".tsx"))a+=".tsx";else{if(!t(a+".ts"))return;a+=".ts"}return t(a)?a:void 0};export const resolveTitle=(t,r)=>{let s=parseMdxTitle(r);if(s)return s;let o=resolveStoriesPath(t,r);if(!o)return;let i=e(o,"utf-8");return parseStoriesTitle(i)};export const findFirstParagraph=t=>{let e=t.split("\n"),r=[],s=!1,o=!1;for(let t of e){let e=t.trim();if(e.startsWith("```")){o=!o;continue}if(!(o||e.startsWith("- [")||e.startsWith("* [")||e.startsWith("#")||e.startsWith("<")||e.startsWith("{/*")||e.startsWith("|"))&&!e.startsWith(">")){if(""===e){if(s&&r.length>0)break;continue}s=!0,r.push(e)}}return r.length>0?r.join(" "):void 0};export const truncateAtWord=(t,e)=>{if(t.length<=e)return t;let r=t.slice(0,e),s=r.lastIndexOf(" ");return(s>0?r.slice(0,s):r)+"..."};export const extractDescription=t=>{let e=t.split("\n").filter(t=>!t.startsWith("import ")).filter(t=>!t.startsWith("<Meta")).filter(t=>!t.startsWith("<Canvas")).filter(t=>!t.startsWith("<Story")).filter(t=>!t.startsWith("<Controls")).filter(t=>!t.startsWith("<Markdown")).join("\n"),r=/^# .+$/m.exec(e),s=/^## .+$/m.exec(e),o=r?r.index+r[0].length:0,i=s?s.index:e.length,n=e.slice(o,i),a=findFirstParagraph(n);if(!a&&s){let t=e.slice(s.index+s[0].length),r=/^## .+$/m.exec(t),o=r?t.slice(0,r.index):t;a=findFirstParagraph(o)}return a?truncateAtWord(a,200):""};export const parseCategoryPath=t=>{let e=t.split(/\s*\/\s*/).map(t=>t.trim()).filter(Boolean);return 0===e.length?["Uncategorized"]:e};export const normalizeTopCategory=(t,e)=>e.get(t.toLowerCase())??t;export const slugify=t=>t.toLowerCase().replace(/&/g,"and").replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"");export const computeOutputPath=(t,e)=>{let r=t.slice(0,-1).map(slugify).join("/"),s=`${e}.mdx`;return r?`${r}/${s}`:s};export const resolveDocMeta=(t,e)=>{let r=parseCategoryPath(t),s=r[0],o=r[r.length-1];if(!s||!o)return;let i=[normalizeTopCategory(s,e),...r.slice(1)],n=slugify(o),a=computeOutputPath(i,n);return{title:t,lastSegment:o,normalizedSegments:i,docSlug:n,outputRelative:a}};let d=[/^import\s+\{[^}]*\}\s+from\s+['"]@storybook\/[^'"]+['"]\s*$/gm,/^import\s+\*\s+as\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.mdx[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\?raw['"]\s*$/gm,/^<Meta\s+[^>]*\/>\s*$/gm,/^<Canvas\s+[^>]*\/>\s*$/gm,/^<Story\s+[^>]*\/>\s*$/gm,/^<Controls\s+[^>]*\/>\s*$/gm,/^<Markdown>\{[^}]+\}<\/Markdown>\s*$/gm],O=/^import\s+(?:type\s+)?\{\s*phx\s*\}\s+from\s+['"](?:\.\.\/)+\.phoenix\/phx\.js['"];?\s*$/;export const stripStorybookImports=t=>{let e=(t=>{let e=t.split("\n"),r=[];for(let[t,s]of e.entries()){if(O.test(s))continue;let o=e[t-1],i=(r.at(-1)??"").startsWith("```");""===s.trim()&&void 0!==o&&O.test(o)&&i||r.push(s)}return r.join("\n")})(t);for(let t of d)e=e.replace(t,"");return e.replace(/\n{3,}/g,"\n\n").trim()+"\n"};export const buildCategoryTree=(t,e,r)=>{let s=new Map,o=(t,e)=>{let r=t.get(e);return r||(r={name:e,docs:[],subcategories:new Map},t.set(e,r)),r};for(let e of t){let t=e.category,i=t[0];if(0===t.length||!i)continue;let n=o(s,normalizeTopCategory(i,r));if(1===t.length){n.docs.push(e);continue}let a=n;for(let e=1;e<t.length-1;e++){let r=t[e];r&&(a=o(a.subcategories,r))}a.docs.push(e)}let i=new Map(e.map((t,e)=>[t,e])),n=t=>({name:t.name,docs:t.docs,subcategories:Array.from(t.subcategories.values()).map(n)});return Array.from(s.values()).sort((t,e)=>(i.get(t.name)??999)-(i.get(e.name)??999)||t.name.localeCompare(e.name)).map(n)};export const getDirectorySizeBytes=t=>{let e=0;for(let o of r(t,{withFileTypes:!0})){let r=a(t,o.name);o.isDirectory()?e+=getDirectorySizeBytes(r):e+=s(r).size}return e};export const formatBytes=t=>{if(t<1024)return`${t} B`;let e=t/1024;if(e<1024)return`${e.toFixed(1)} KB`;let r=e/1024;return`${r.toFixed(1)} MB`};

package/dist/phoenix/services/application-spec-project-watcher.d.ts

@@ -1,23 +1,31 @@
 import { type ViteDevServer } from 'vite';
+import type { PageExperience } from '#package/application-spec';
 import type { Logger } from '../utils/index.js';
+import type { DeploymentPreparationService } from './deployment/index.js';
+import type { LinguiWatcher } from './lingui-watcher.js';
 import type { PhoenixPubSub } from './phoenix-pubsub.js';
+import type { PhoenixStore } from './phoenix-store.js';
 import type { VariantFileEdit } from './variant-file-session.js';
+export declare const WATCH_PATTERNS: string[];
+export declare const IGNORED_PATTERNS: string[];
 /** Configuration for {@link ApplicationSpecProjectWatcher}. */
 export interface ApplicationSpecProjectWatcherConfig {
     readonly pubsub: PhoenixPubSub;
     readonly logger: Logger;
-    readonly onRebuilt?: () => void;
-    readonly onViteServerChange?: (viteServer: ViteDevServer) => void;
     readonly sdkVersion: string;
     readonly projectSlug: string;
     readonly environmentSlug: string;
     readonly cliUseWorkspace?: boolean;
-    readonly name?: string;
-    readonly description?: string;
-    readonly enableEditor: boolean;
+    readonly pageExperience: PageExperience;
     readonly inlineTemplates: boolean;
     readonly useServer: boolean;
 }
+/** Services the watcher notifies after a rebuild; the store owns its replaceable Vite handle. */
+export interface ApplicationSpecProjectWatcherContext {
+    readonly store: PhoenixStore;
+    readonly linguiWatcher: LinguiWatcher | undefined;
+    readonly deploymentPreparation: DeploymentPreparationService | undefined;
+}
 /**
  * Application-spec project watcher with layered caching via {@link ApplicationSpecBuilder}:
  *
@@ -29,22 +37,21 @@ export interface ApplicationSpecProjectWatcherConfig {
  * Rebuilds are serialized via PromiseQueue(1).
  */
 export declare class ApplicationSpecProjectWatcher {
+    private readonly context;
     private watcher;
     private subscription;
     private readonly rebuildQueue;
     /** Each watcher event emits the changed source path; debounced + buffered into batches. */
     private readonly changeSubject$;
-    private viteServer;
     private readonly pubsub;
     private readonly logger;
-    private readonly onRebuilt?;
-    private readonly onViteServerChange?;
     private readonly builder;
     private readonly useServer;
+    private readonly agentMode;
     private isShuttingDown;
     private suspended;
     private readonly heldChanges;
-    constructor(config: ApplicationSpecProjectWatcherConfig);
+    constructor(config: ApplicationSpecProjectWatcherConfig, context: ApplicationSpecProjectWatcherContext);
     start(viteServer: ViteDevServer): void;
     /** Rebuilds a batch a variant comparison wrote, at once and without the server work of a source change. */
     applyVariantFiles(files: readonly VariantFileEdit[]): void;

package/dist/phoenix/services/application-spec-project-watcher.js

@@ -1,4 +1,4 @@
-import{resolve as e}from"path";import t from"promise-queue";import{Subject as i,buffer as s,debounceTime as r}from"rxjs";import{createServer as o,normalizePath as n}from"vite";import{watch as l}from"#package/watch";import{ApplicationSpecBuilder as h}from"../application-spec/application-spec-builder.js";import{logDiagnostics as a}from"../application-spec/metrics/index.js";import{syncTemplateFiles as c}from"../application-spec/template-files.js";import{buildWebhooks as u}from"../webhooks/index.js";import{getViteDevConfig as p}from"./vite-config.js";let g=["spec/**/*.{yaml,yml}","src/**/*.{ts,tsx,yaml,yml,json,html,css}","templates/*.html",".env",".env.generated"],d=["src/locales/**/*.{ts,tsx}",".phoenix/**"];export class ApplicationSpecProjectWatcher{watcher=null;subscription=null;rebuildQueue=new t(1,1/0);changeSubject$=new i;viteServer=null;pubsub;logger;onRebuilt;onViteServerChange;builder;useServer;isShuttingDown=!1;suspended=!1;heldChanges=new Set;constructor(e){this.pubsub=e.pubsub,this.logger=e.logger,this.onRebuilt=e.onRebuilt,this.onViteServerChange=e.onViteServerChange,this.builder=new h({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,name:e.name,description:e.description,enableEditor:e.enableEditor,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer}start(e){this.viteServer=e,this.setupFileWatcher(),this.setupRebuildSubscription()}applyVariantFiles(e){this.rebuildQueue.add(async()=>{this.isShuttingDown||await this.rebuild(new Set(e.map(e=>e.fileName)),!1,!0)})}suspend(){this.suspended=!0}resume(){for(let e of(this.suspended=!1,this.heldChanges))this.changeSubject$.next(e);this.heldChanges.clear()}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=l(g,{ignored:d,cwd:process.cwd(),persistent:!0,ignoreInitial:!1}),this.watcher.on("all",(e,t)=>{if("change"===e||"add"===e||"unlink"===e){if(this.suspended)return void this.heldChanges.add(t);this.logger.info(`
-📝 Detected ${e}: ${t}`),this.changeSubject$.next(t)}})}setupRebuildSubscription(){let e=this.changeSubject$.pipe(r(10));this.subscription=this.changeSubject$.pipe(s(e)).subscribe(e=>{let t=new Set(e),i=t.has(".env");this.rebuildQueue.add(async()=>{this.isShuttingDown||(this.logger.info(`
+import{mkdirSync as e}from"fs";import{resolve as t}from"path";import i from"promise-queue";import{Subject as s,buffer as r,debounceTime as o}from"rxjs";import{createServer as n,normalizePath as a}from"vite";import{watch as c}from"#package/watch";import{ApplicationSpecBuilder as l}from"../application-spec/application-spec-builder.js";import{logDiagnostics as h}from"../application-spec/metrics/index.js";import{syncTemplateFiles as u}from"../application-spec/template-files.js";import{buildWebhooks as p}from"../webhooks/index.js";import{getViteDevConfig as g}from"./vite-config.js";export const WATCH_PATTERNS=["package.json","spec/**/*.{yaml,yml}","src/**/*.{ts,tsx,yaml,yml,json,html,css}","templates/*.html",".env",".env.generated",".phoenix/.env.generated"];export const IGNORED_PATTERNS=["src/locales/**/*.{ts,tsx}",".phoenix/!(.env.generated)/**"];export class ApplicationSpecProjectWatcher{context;watcher=null;subscription=null;rebuildQueue=new i(1,1/0);changeSubject$=new s;pubsub;logger;builder;useServer;agentMode;isShuttingDown=!1;suspended=!1;heldChanges=new Set;constructor(e,t){this.context=t,this.pubsub=e.pubsub,this.logger=e.logger,this.builder=new l({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,pageExperience:e.pageExperience,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer,this.agentMode="agent"===e.pageExperience}start(e){this.context.store.viteServer$.next(e),this.setupFileWatcher(),this.setupRebuildSubscription()}applyVariantFiles(e){this.rebuildQueue.add(async()=>{this.isShuttingDown||await this.rebuild(new Set(e.map(e=>e.fileName)),!1,!0)})}suspend(){this.suspended=!0}resume(){for(let e of(this.suspended=!1,this.heldChanges))this.changeSubject$.next(e);this.heldChanges.clear()}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){e(t(process.cwd(),"src"),{recursive:!0}),this.watcher=c(WATCH_PATTERNS,{ignored:IGNORED_PATTERNS,cwd:process.cwd(),persistent:!0,ignoreInitial:!1}),this.watcher.on("all",(e,t)=>{if("change"===e||"add"===e||"unlink"===e){if(this.suspended)return void this.heldChanges.add(t);this.logger.info(`
+📝 Detected ${e}: ${t}`),this.changeSubject$.next(t)}})}setupRebuildSubscription(){let e=this.changeSubject$.pipe(o(10));this.subscription=this.changeSubject$.pipe(r(e)).subscribe(e=>{let t=new Set(e),i=t.has(".env");this.rebuildQueue.add(async()=>{this.isShuttingDown||(this.logger.info(`
 🔨 Rebuilding spec files...
-`),await this.rebuild(t,i,!1))})})}async rebuild(t,i,s){try{let r=this.viteServer;if(!r)throw Error("Cannot rebuild the project: the watcher has no Vite server yet, because it was not started. Start the watcher before applying files");let l=await c();if(this.isShuttingDown)return;let h=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(a(h.diagnostics,this.logger),!h.ok){for(let e of h.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:h.rawProjectFiles,projectRoot:process.cwd()});return}this.onRebuilt?.();let{application:g,changedFiles:d}=h,w=r.moduleGraph,b=Date.now(),f=new Set,m=process.cwd(),S=e=>{let t=w.getModulesByFile(n(e));if(t)for(let e of t)w.invalidateModule(e,f,b,!0)};for(let i of t)S(e(m,i));for(let t of d)S(e(m,`.phoenix/${t.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:g.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:g.applicationSpec.configurator.configurationSchema.hash}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await p({templateFiles:l});if(this.isShuttingDown)return;let t=await o(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.viteServer=t,this.onViteServerChange?.(t),this.logger.success("Vite server restarted (env changed)")}if(this.useServer&&!s){if(this.logger.step("Building webhooks"),await u({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js",preserveExistingOutput:!0}),this.isShuttingDown)return;this.logger.success("Webhooks rebuilt successfully")}this.logger.success("Project files rebuilt successfully")}catch(e){this.logger.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e)}}}
+`),await this.rebuild(t,i,!1))})})}async rebuild(e,i,s){try{let r=this.context.store.viteServer$.value;if(!r)throw Error("Cannot rebuild the project: the watcher has no Vite server yet, because it was not started. Start the watcher before applying files");let o=await u();if(this.isShuttingDown)return;let c=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(h(c.diagnostics,this.logger),!c.ok){for(let e of c.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:c.rawProjectFiles,projectRoot:process.cwd(),build:"failed"});return}let{application:l,changedFiles:d}=c;this.context.linguiWatcher?.trigger(),this.context.deploymentPreparation?.reportUnregisteredSpec(l.applicationSpec);let w=r.moduleGraph,f=Date.now(),b=new Set,m=process.cwd(),S=e=>{let t=w.getModulesByFile(a(e));if(t)for(let e of t)w.invalidateModule(e,b,f,!0)};for(let i of e)S(t(m,i));for(let e of d)S(t(m,`.phoenix/${e.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:l.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:l.applicationSpec.configurator.configurationSchema.hash,build:"ok"}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await g({templateFiles:o,agentMode:this.agentMode});if(this.isShuttingDown)return;let t=await n(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.context.store.viteServer$.next(t),this.logger.success("Vite server restarted (env changed)")}if(this.useServer&&!s){if(this.logger.step("Building webhooks"),await p({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js",preserveExistingOutput:!0}),this.isShuttingDown)return;this.logger.success("Webhooks rebuilt successfully")}this.logger.success("Project files rebuilt successfully")}catch(e){this.logger.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e)}}}

package/dist/phoenix/services/cli-credentials.d.ts

@@ -5,6 +5,7 @@ import { z } from 'zod';
 declare const ServerCredentials: z.ZodObject<{
     token: z.ZodString;
     userId: z.ZodString;
+    customerId: z.ZodOptional<z.ZodString>;
     customerSlug: z.ZodString;
     customerName: z.ZodString;
     studioUrl: z.ZodOptional<z.ZodString>;
@@ -12,6 +13,7 @@ declare const ServerCredentials: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     token: string;
     userId: string;
+    customerId?: string | undefined;
     customerSlug: string;
     customerName: string;
     studioUrl?: string | undefined;
@@ -19,6 +21,7 @@ declare const ServerCredentials: z.ZodObject<{
 }, {
     token: string;
     userId: string;
+    customerId?: string | undefined;
     customerSlug: string;
     customerName: string;
     studioUrl?: string | undefined;

package/dist/phoenix/services/cli-credentials.js

@@ -1,2 +1,2 @@
-import{chmod as e,mkdir as r,readFile as t,writeFile as s}from"node:fs/promises";import{homedir as n}from"node:os";import{dirname as a,join as i}from"node:path";import{z as o}from"zod";let l=o.object({token:o.string().min(1),userId:o.string(),customerSlug:o.string(),customerName:o.string(),studioUrl:o.string().optional(),createdAt:o.string()}),c=o.object({version:o.literal(1),servers:o.record(o.string(),l)}),d={version:1,servers:{}};export const getCredentialsPath=()=>process.env.PHOENIX_CREDENTIALS_FILE??i(n(),".phoenix","credentials.json");let u=e=>new URL(e).origin,g=async()=>{let e;try{e=await t(getCredentialsPath(),"utf8")}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code)return d;throw e}let r=c.safeParse((e=>{try{return JSON.parse(e)}catch{return null}})(e));if(!r.success)throw Error(`The credentials file ${getCredentialsPath()} is not valid. Delete it and run \`phoenix login\` again.`);return r.data},m=async t=>{let n=getCredentialsPath();return await r(a(n),{recursive:!0,mode:448}),await s(n,`${JSON.stringify(t,null,2)}
+import{chmod as e,mkdir as r,readFile as t,writeFile as s}from"node:fs/promises";import{homedir as n}from"node:os";import{dirname as i,join as o}from"node:path";import{z as a}from"zod";let l=a.object({token:a.string().min(1),userId:a.string(),customerId:a.string().uuid().optional(),customerSlug:a.string(),customerName:a.string(),studioUrl:a.string().optional(),createdAt:a.string()}),c=a.object({version:a.literal(1),servers:a.record(a.string(),l)}),d={version:1,servers:{}};export const getCredentialsPath=()=>process.env.PHOENIX_CREDENTIALS_FILE??o(n(),".phoenix","credentials.json");let u=e=>new URL(e).origin,g=async()=>{let e;try{e=await t(getCredentialsPath(),"utf8")}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code)return d;throw e}let r=c.safeParse((e=>{try{return JSON.parse(e)}catch{return null}})(e));if(!r.success)throw Error(`The credentials file ${getCredentialsPath()} is not valid. Delete it and run \`phoenix login\` again.`);return r.data},m=async t=>{let n=getCredentialsPath();return await r(i(n),{recursive:!0,mode:448}),await s(n,`${JSON.stringify(t,null,2)}
 `,{mode:384}),await e(n,384),n};export const getServerCredentials=async e=>(await g()).servers[u(e)]??null;export const saveServerCredentials=async(e,r)=>{let t=await g();return m({...t,servers:{...t.servers,[u(e)]:r}})};export const removeServerCredentials=async e=>{let r=await g(),{[u(e)]:t,...s}=r.servers;await m({...r,servers:s})};

package/dist/phoenix/services/cli-exit.d.ts

@@ -0,0 +1,5 @@
+type BeforeCliExit = (exitCode: number) => Promise<void>;
+export declare const setBeforeCliExit: (handler: BeforeCliExit) => (() => void);
+/** Gives the Phoenix CLI a chance to finish best-effort work, then preserves process.exit semantics. */
+export declare const exitCli: (exitCode: number) => Promise<never>;
+export {};

package/dist/phoenix/services/cli-exit.js

@@ -0,0 +1 @@
+let t=null;export const setBeforeCliExit=e=>(t=e,()=>{t===e&&(t=null)});export const exitCli=async e=>{try{await t?.(e)}finally{process.exit(e)}};

package/dist/phoenix/services/deployment/deployment-preparation-service.d.ts

@@ -0,0 +1,28 @@
+import type { ApplicationSpec } from '#package/application-spec';
+import type { Logger } from '../../utils/index.js';
+import type { DevelopmentCredential } from '../development-credential.js';
+import type { PhoenixStore } from '../phoenix-store.js';
+/** The deployment identity a server-backed dev session prepares and checks after rebuilds. */
+export interface DeploymentPreparationServiceProps {
+    readonly serverUrl: string;
+    readonly credential: DevelopmentCredential;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly sdkVersion: string;
+}
+export interface DeploymentPreparationServiceContext {
+    readonly logger: Logger;
+    readonly store: PhoenixStore;
+}
+/** Prepares the active dev deployment and reports spec changes that require a session restart. */
+export declare class DeploymentPreparationService {
+    private readonly props;
+    private readonly context;
+    constructor(props: DeploymentPreparationServiceProps, context: DeploymentPreparationServiceContext);
+    prepare(): Promise<void>;
+    prepareAtStartup(options: {
+        readonly skipUpload: boolean;
+        readonly debug: boolean;
+    }): Promise<void>;
+    reportUnregisteredSpec(applicationSpec: ApplicationSpec): Promise<void>;
+}

package/dist/phoenix/services/deployment/deployment-preparation-service.js

@@ -0,0 +1 @@
+import{mkdir as e}from"node:fs/promises";import{dirname as t}from"node:path";import{resolveGeneratedEnvFile as r}from"@salsita-ai/common/env";import{getDeploymentFingerprint as o}from"../../application-spec/index.js";import{prepareDevelopmentEnvironment as n}from"../prepare-development-environment.js";import{readGeneratedEnvMarkers as i}from"./generated-env-markers.js";export class DeploymentPreparationService{props;context;constructor(e,t){this.props=e,this.context=t}prepare(){return this.prepareAtStartup({skipUpload:!0,debug:!1})}async prepareAtStartup(o){let i=r(".");await e(t(i),{recursive:!0}),await n({serverUrl:this.props.serverUrl,projectSlug:this.props.projectSlug,environmentSlug:this.props.environmentSlug,credential:this.props.credential,outFile:i,skipUpload:o.skipUpload,overrideSchema:!0,debug:o.debug,projectVersion:this.props.sdkVersion},{logger:this.context.logger})}async reportUnregisteredSpec(e){try{let t=o(e),n=await i(r("."));if(!n||n.PHOENIX_DEPLOYMENT_FINGERPRINT===t)return void this.context.store.reportedFingerprint$.next(null);if(this.context.store.reportedFingerprint$.value===t)return;this.context.store.reportedFingerprint$.next(t),this.context.logger.error("The development deployment on the server still has the domain model and deployment settings it was prepared with, not the ones the spec now declares: a running phoenix dev cannot register a change, because its webhook tunnel and the preview stay bound to the deployment they started with. Restart phoenix dev to prepare the deployment again, then open the Preview address it prints rather than reloading a tab whose address has ?cid=, which loads a configuration saved with the earlier model.")}catch(e){this.context.logger.warn(`Could not compare the spec with the development deployment: ${e instanceof Error?e.message:String(e)}. After a domain model change, restart phoenix dev to register it.`)}}}

package/dist/phoenix/services/deployment/generated-env-markers.d.ts

@@ -0,0 +1,8 @@
+export interface GeneratedEnvMarkers {
+    readonly DEPLOYMENT_ID?: string;
+    readonly PHOENIX_PROJECT_SLUG?: string;
+    readonly PHOENIX_ENVIRONMENT_SLUG?: string;
+    readonly PHOENIX_SERVER_URL?: string;
+    readonly PHOENIX_DEPLOYMENT_FINGERPRINT?: string;
+}
+export declare const readGeneratedEnvMarkers: (outFile: string) => Promise<GeneratedEnvMarkers | null>;

package/dist/phoenix/services/deployment/generated-env-markers.js

@@ -0,0 +1 @@
+import{parse as E}from"dotenv";import{readFile as N}from"node:fs/promises";export const readGeneratedEnvMarkers=async r=>{try{let _=E(await N(r));return{DEPLOYMENT_ID:_.DEPLOYMENT_ID,PHOENIX_PROJECT_SLUG:_.PHOENIX_PROJECT_SLUG,PHOENIX_ENVIRONMENT_SLUG:_.PHOENIX_ENVIRONMENT_SLUG,PHOENIX_SERVER_URL:_.PHOENIX_SERVER_URL,PHOENIX_DEPLOYMENT_FINGERPRINT:_.PHOENIX_DEPLOYMENT_FINGERPRINT}}catch(E){if(E instanceof Error&&"code"in E&&"ENOENT"===E.code)return null;throw E}};

package/dist/phoenix/services/deployment/index.d.ts

@@ -0,0 +1,2 @@
+export { readGeneratedEnvMarkers } from './generated-env-markers.js';
+export { DeploymentPreparationService } from './deployment-preparation-service.js';

package/dist/phoenix/services/deployment/index.js

@@ -0,0 +1 @@
+export{readGeneratedEnvMarkers}from"./generated-env-markers.js";export{DeploymentPreparationService}from"./deployment-preparation-service.js";

package/dist/phoenix/services/dev-experience/dev-experience.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from '../../utils/index.js';
+/**
+ * What `phoenix dev` shows around the configurator in the browser.
+ *
+ * `editor` is the internal experience: the Phoenix editor, the detailed dev error pages and Vite's
+ * error overlay. `agent` is the experience of a project whose configurator an AI agent builds: the
+ * editor runs with its UI hidden, so the CLI's inspect commands still work, and every dev error lands
+ * on the "Agent at work" screen while the details go to the terminal logs the agent reads. `plain` is
+ * the configurator alone with the detailed dev error pages, for internal tooling such as asset captures.
+ */
+export type DevExperience = 'editor' | 'agent' | 'plain';
+/**
+ * How `phoenix dev` authenticated with the Phoenix server. Only a session as the signed-in Studio user
+ * runs in agent mode, and only when no editor setting is given; every internal setup keeps the editor.
+ */
+export type CredentialRoute = 'signed-in' | 'development-key' | 'local' | 'no-server';
+/** Inputs of {@link resolveDevExperience}: the explicit settings, unset when absent, and the credential route. */
+export interface ResolveDevExperienceInput {
+    /** `--editor` (true) or `--no-editor` (false). */
+    readonly cliEditor: boolean | undefined;
+    /** The `ENABLE_EDITOR` environment variable. */
+    readonly envEditor: boolean | undefined;
+    readonly route: CredentialRoute;
+}
+/**
+ * Agent mode comes from the credentials alone: the signed-in route gets it when neither `--editor`/`--no-editor`
+ * nor `ENABLE_EDITOR` is set. Those keep their meaning on every route: the editor, or the plain page.
+ */
+export declare const resolveDevExperience: (input: ResolveDevExperienceInput, context: {
+    readonly logger: Logger;
+}) => DevExperience;

package/dist/phoenix/services/dev-experience/dev-experience.js

@@ -0,0 +1 @@
+export const resolveDevExperience=(e,r)=>{let{cliEditor:t,envEditor:i,route:n}=e;if(void 0!==t)return r.logger.detail(`Editor enabled: ${t} (from CLI flag)`),t?"editor":"plain";if(void 0!==i)return r.logger.detail(`Editor enabled: ${i} (from environment variable)`),i?"editor":"plain";let o="signed-in"===n?"agent":"editor";return r.logger.detail("agent"===o?"Dev experience: agent mode, the editor running with its UI hidden (default for the signed-in route)":`Dev experience: editor (default for the ${n} route)`),o};

package/dist/phoenix/services/dev-experience/index.d.ts

@@ -0,0 +1,3 @@
+export { type CredentialRoute, type DevExperience, resolveDevExperience } from './dev-experience.js';
+export { readExplicitEditorSetting } from './read-explicit-editor-setting.js';
+export { resolveRegeneratedPageExperience } from './regenerated-page-experience.js';

package/dist/phoenix/services/dev-experience/index.js

@@ -0,0 +1 @@
+export{resolveDevExperience}from"./dev-experience.js";export{readExplicitEditorSetting}from"./read-explicit-editor-setting.js";export{resolveRegeneratedPageExperience}from"./regenerated-page-experience.js";

package/dist/phoenix/services/dev-experience/read-explicit-editor-setting.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The `ENABLE_EDITOR` a user set, from the process environment, the project's `.env` or the pnpm
+ * workspace root's `.env`, in that order, as the env reader takes it. The generated env file is left
+ * out on purpose: development preparation writes the server's `ENABLE_EDITOR=true` into it, and
+ * reading that back would turn every signed-in session after the first into an editor session.
+ */
+export declare const readExplicitEditorSetting: (projectRoot: string) => boolean | undefined;

package/dist/phoenix/services/dev-experience/read-explicit-editor-setting.js

@@ -0,0 +1 @@
+import{parse as t}from"dotenv";import{bool as r,cleanEnv as e}from"envalid";import{existsSync as o,readFileSync as E}from"fs";import{dirname as i,join as n}from"path";let p=r=>{let e=n(r,".env");return o(e)?t(E(e,"utf8")).ENABLE_EDITOR:void 0},m=t=>{if(o(n(t,"pnpm-workspace.yaml")))return t;let r=i(t);return r===t?void 0:m(r)};export const readExplicitEditorSetting=t=>{let o=m(t);return e({ENABLE_EDITOR:process.env.ENABLE_EDITOR??p(t)??(o&&o!==t?p(o):void 0)},{ENABLE_EDITOR:r({default:void 0})}).ENABLE_EDITOR};

package/dist/phoenix/services/dev-experience/regenerated-page-experience.d.ts

@@ -0,0 +1,24 @@
+import type { PageExperience } from '#package/application-spec';
+import type { Logger } from '../../utils/index.js';
+/** The editor settings {@link resolveRegeneratedPageExperience} weighs. */
+export interface RegeneratedPageExperienceInput {
+    /** `--editor` or `--no-editor`. */
+    readonly cliEditor: boolean | undefined;
+    /** `ENABLE_EDITOR` the user set in the environment or `.env`, the generated env file left out. */
+    readonly userEditor: boolean | undefined;
+    /**
+     * `ENABLE_EDITOR` as the env reader takes it, the generated env file first after the environment. A
+     * deploy build gets `false` there, and a signed-in dev session `true`.
+     */
+    readonly environmentEditor: boolean | undefined;
+}
+/**
+ * The page `phoenix sync`, `build` and `clean` regenerate. `--editor`/`--no-editor` decides first. An
+ * agent-mode page dev generated is kept unless the user set `ENABLE_EDITOR`, so running one while dev is
+ * in agent mode never puts the visible editor back in front of the client; the generated env file's
+ * `ENABLE_EDITOR=true` is not a choice there. Otherwise `ENABLE_EDITOR` decides as the env reader takes
+ * it, the generated env file before `.env`, as it does for a deploy build, and the editor is the default.
+ */
+export declare const resolveRegeneratedPageExperience: (input: RegeneratedPageExperienceInput, context: {
+    readonly logger: Logger;
+}) => PageExperience;

package/dist/phoenix/services/dev-experience/regenerated-page-experience.js

@@ -0,0 +1 @@
+import{existsSync as e,readFileSync as o}from"fs";let t=".phoenix/editor.tsx";export const resolveRegeneratedPageExperience=(i,r)=>{let{cliEditor:n,userEditor:d,environmentEditor:a}=i,l=(e,o)=>(r.logger.detail(`Page: ${e} (${o})`),e);return void 0!==n?l(n?"editor":"plain","from CLI flag"):e(t)&&o(t,"utf8").includes(" hideUi")?void 0===d?l("agent","keeps the agent-mode page phoenix dev generated"):l(d?"editor":"plain","from ENABLE_EDITOR in the environment or .env"):void 0===a?l("editor","default"):l(a?"editor":"plain","from ENABLE_EDITOR")};

package/dist/phoenix/services/index.d.ts

@@ -1,13 +1,15 @@
-export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
+export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecBuildStatus, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
 export { PhoenixPubSub } from './phoenix-pubsub.js';
 export { PhoenixStore } from './phoenix-store.js';
-export { PhoenixApplication } from './phoenix-application.js';
+export { DeploymentPreparationService, readGeneratedEnvMarkers } from './deployment/index.js';
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, type EditorServerHandle, } from './session/index.js';
 export { VariantFileSession } from './variant-file-session.js';
 export { VariantPreviewService } from './variant-preview-service.js';
 export { MockTemplateWatcher, type MockTemplateWatcherConfig } from './mock-template-watcher.js';
 export { ApplicationSpecProjectWatcher, type ApplicationSpecProjectWatcherConfig, } from './application-spec-project-watcher.js';
 export { ApplicationSpecStoryWatcher, type ApplicationSpecStoryWatcherConfig, } from './application-spec-story-watcher.js';
 export { LinguiWatcher, type LinguiWatcherConfig } from './lingui-watcher.js';
+export { bootstrapLinguiCatalogs, extractAndCompileLingui } from '../lingui/index.js';
 export { loadMockTemplates, parseMockTemplateYaml, type LoadMockTemplatesResult, type ParsedMockTemplate, } from './spec-files.js';
 export { LOG_STREAMS, LogBus, type LogEntry, type LogLevel, type LogPage, type LogQuery, type LogStream, } from './log-bus.js';
 export { createBusLogger, type CreateBusLoggerOptions } from './bus-logger.js';
@@ -18,6 +20,9 @@ export { STORY_DEV_MARKER_PATH, readActiveStoryDevMarker, type StoryDevMarker }
 export { composeDefaultBanner } from './phx-banner-plugin.js';
 export { getViteBuildConfigs, getViteDevConfig, setViteLogSink, type ViteLogSink, type ViteLogSinkOptions, } from './vite-config.js';
 export { getServerCredentials, removeServerCredentials, saveServerCredentials } from './cli-credentials.js';
+export { exitCli, setBeforeCliExit } from './cli-exit.js';
 export { createSourceArchive, extractSourceArchive } from './source-archive.js';
 export { resolveSignedInDevelopmentEnvironment } from './signed-in-development-environment.js';
+export { createTelemetryClient, resolveTelemetryCommand, type CommandTelemetryAttempt, type TelemetryAssociation, type TelemetryClient, type TelemetryCommand, } from './telemetry/index.js';
 export { DEFAULT_PHOENIX_REGION, PHOENIX_REGIONS, PUBLIC_PHOENIX_REGIONS, getRegionServerUrl, getRegionStudioUrl, } from './phoenix-regions.js';
+export { type CredentialRoute, type DevExperience, readExplicitEditorSetting, resolveDevExperience, resolveRegeneratedPageExperience, } from './dev-experience/index.js';

package/dist/phoenix/services/index.js

@@ -1 +1 @@
-export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{PhoenixApplication}from"./phoenix-application.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";
+export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{DeploymentPreparationService,readGeneratedEnvMarkers}from"./deployment/index.js";export{PhoenixApplication}from"./session/index.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{bootstrapLinguiCatalogs,extractAndCompileLingui}from"../lingui/index.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{exitCli,setBeforeCliExit}from"./cli-exit.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{createTelemetryClient,resolveTelemetryCommand}from"./telemetry/index.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";export{readExplicitEditorSetting,resolveDevExperience,resolveRegeneratedPageExperience}from"./dev-experience/index.js";

package/dist/phoenix/services/lingui-watcher.js

@@ -1 +1 @@
-import e from"promise-queue";import{Subject as t,buffer as i,debounceTime as s}from"rxjs";import{watch as r}from"#package/watch";import{compileLingui as n,extractAndCompileLingui as o}from"./lingui.js";let c=["src/**/*.{ts,tsx}","src/locales/**/*.po"],g=["src/locales/**/*.{ts,tsx}"];export class LinguiWatcher{watcher=null;subscription=null;runQueue=new e(1,1/0);changeSubject$=new t;logger;isShuttingDown=!1;constructor(e){this.logger=e.logger}start(){this.setupFileWatcher(),this.setupRunSubscription()}trigger(){this.changeSubject$.next("<codegen-rebuild>")}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=r(c,{ignored:g,cwd:process.cwd(),ignoreInitial:!0,persistent:!0}),this.watcher.on("all",(e,t)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.debug(`Lingui source ${e}: ${t}`),this.changeSubject$.next(t))}).on("error",e=>{this.logger.error(`Lingui watcher error: ${e instanceof Error?e.message:String(e)}`,e)})}setupRunSubscription(){let e=this.changeSubject$.pipe(s(200));this.subscription=this.changeSubject$.pipe(i(e)).subscribe(e=>{let t=e.some(e=>!e.endsWith(".po"));this.runQueue.add(async()=>{if(!this.isShuttingDown)try{t?(this.logger.info("Lingui sources changed, extracting and compiling i18n messages..."),await o({logger:this.logger})):(this.logger.info("Lingui catalogs changed, compiling i18n messages..."),await n({logger:this.logger}))}catch(e){this.logger.error(`Lingui update failed: ${e instanceof Error?e.message:String(e)}`,e)}})})}}
+import e from"promise-queue";import{Subject as i,buffer as t,debounceTime as s}from"rxjs";import{watch as r}from"#package/watch";import{compileLingui as n,extractAndCompileLingui as o}from"../lingui/index.js";let c=["src/**/*.{ts,tsx}","src/locales/**/*.po"],g=["src/locales/**/*.{ts,tsx}"];export class LinguiWatcher{watcher=null;subscription=null;runQueue=new e(1,1/0);changeSubject$=new i;logger;isShuttingDown=!1;constructor(e){this.logger=e.logger}start(){this.setupFileWatcher(),this.setupRunSubscription()}trigger(){this.changeSubject$.next("<codegen-rebuild>")}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=r(c,{ignored:g,cwd:process.cwd(),ignoreInitial:!0,persistent:!0}),this.watcher.on("all",(e,i)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.debug(`Lingui source ${e}: ${i}`),this.changeSubject$.next(i))}).on("error",e=>{this.logger.error(`Lingui watcher error: ${e instanceof Error?e.message:String(e)}`,e)})}setupRunSubscription(){let e=this.changeSubject$.pipe(s(200));this.subscription=this.changeSubject$.pipe(t(e)).subscribe(e=>{let i=e.some(e=>!e.endsWith(".po"));this.runQueue.add(async()=>{if(!this.isShuttingDown)try{i?(this.logger.info("Lingui sources changed, extracting and compiling i18n messages..."),await o({logger:this.logger})):(this.logger.info("Lingui catalogs changed, compiling i18n messages..."),await n({logger:this.logger}))}catch(e){this.logger.error(`Lingui update failed: ${e instanceof Error?e.message:String(e)}`,e)}})})}}

package/dist/phoenix/services/phoenix-pubsub.d.ts

@@ -1,11 +1,15 @@
 import { Subject } from 'rxjs';
 import type { RawProjectFiles } from '#package/application-spec';
 import type { MockTemplateDefinition } from '#package/editor';
+/** Whether the latest rebuild of the project files succeeded; an agent-mode page shows it on its badge. */
+export type SpecBuildStatus = 'ok' | 'failed';
 /** Batch of project files that changed on disk. */
 export interface SpecUpdateEvent {
     readonly rawProjectFiles: RawProjectFiles;
     readonly projectRoot: string;
     readonly configurationSchemaHash?: string;
+    /** How the rebuild this event reports went; absent when the event reports no rebuild. */
+    readonly build?: SpecBuildStatus;
 }
 /** Updated set of mock template definitions after a file change. */
 export interface MockTemplateUpdateEvent {

package/dist/phoenix/services/phoenix-store.d.ts

@@ -1,4 +1,5 @@
 import { BehaviorSubject } from 'rxjs';
+import type { ViteDevServer } from 'vite';
 /**
  * A frontend file script or standalone HTML proposal served from `.phoenix/variants/`.
  */
@@ -44,5 +45,7 @@ export interface VariantPreviewState {
  * editor server reaches it only through them. Events that carry no state stay on PhoenixPubSub.
  */
 export declare class PhoenixStore {
+    readonly viteServer$: BehaviorSubject<ViteDevServer | null>;
+    readonly reportedFingerprint$: BehaviorSubject<string | null>;
     readonly variantPreview$: BehaviorSubject<VariantPreviewState>;
 }

package/dist/phoenix/services/phoenix-store.js

@@ -1 +1 @@
-import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}
+import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{viteServer$=new e(null);reportedFingerprint$=new e(null);variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}

package/dist/phoenix/services/prepare-development-environment.js

@@ -1,2 +1,2 @@
-import{writeFile as e}from"node:fs/promises";import{createApiBaseClient as i}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as r,uploadFilesWithPresignedUrls as a}from"../utils/index.js";import{getDevelopmentCredentialHint as o,getDevelopmentHeaders as s}from"./development-credential.js";export const prepareDevelopmentEnvironment=async(n,l)=>{let{logger:p}=l,{projectSlug:d,environmentSlug:m,serverUrl:c,credential:h,outFile:v,skipUpload:f,overrideSchema:u,projectVersion:g}=n;p.step("Preparing development environment"),p.info(`Preparing development environment for project "${d}", environment "${m}"`);let E=i(c);p.debug(`Using server URL: ${c}`);let b=await t({skipUpload:f,logger:p});p.info("Preparing and activating the development deployment on the server...");let{data:P,error:$}=await E.POST("/environments/development/prepare",{body:{applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:u,configurationSchema:{version:b.schemaVersion,schema:b.schema},adminConfigurationSchema:b.adminSchema?{schema:b.adminSchema,version:b.adminSchemaVersion}:void 0,chat:b.chat,embeddings:b.embeddings,...b.assistant?{assistant:!0}:{},acl:{canCreate:b.aclCanCreate},privateFiles:[...b.assets.privateFilePaths],publicFiles:[...b.assets.publicFilePaths],sdkVersion:g},headers:s(h,{projectSlug:d,environmentSlug:m})});if($)throw Error(`Failed to prepare development deployment for ${d}/${m} on ${c}: ${$.message}. ${o(h,d)}`);if(!P)throw Error("No data returned from server while preparing the development deployment.");let{environmentVariables:y,privateUploadUrls:w,publicUploadUrls:F}=P;if(f)p.debug("Skipping file upload");else{p.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let i=e.replace("assets/private/",""),t=w[i];if(!t)throw Error(`No upload URL provided for private file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...b.assets.publicFilesFullPaths].map(e=>{let i=e.replace("assets/public/",""),t=F[i];if(!t)throw Error(`No upload URL provided for public file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:p})}try{await e(v,`${r({...y,PHOENIX_PROJECT_SLUG:d,PHOENIX_ENVIRONMENT_SLUG:m,PHOENIX_SERVER_URL:c})}
+import{writeFile as e}from"node:fs/promises";import{createApiBaseClient as i}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as r,uploadFilesWithPresignedUrls as a}from"../utils/index.js";import{getDevelopmentCredentialHint as o,getDevelopmentHeaders as s}from"./development-credential.js";export const prepareDevelopmentEnvironment=async(n,l)=>{let{logger:p}=l,{projectSlug:d,environmentSlug:m,serverUrl:c,credential:h,outFile:v,skipUpload:f,overrideSchema:u,projectVersion:E}=n;p.step("Preparing development environment"),p.info(`Preparing development environment for project "${d}", environment "${m}"`);let g=i(c);p.debug(`Using server URL: ${c}`);let P=await t({skipUpload:f,logger:p});p.info("Preparing and activating the development deployment on the server...");let{data:b,error:$}=await g.POST("/environments/development/prepare",{body:{applicationVersion:P.applicationVersion,publishedDataHash:P.publishedDataHash,useAuthHook:P.useAuthHook,overrideSchema:u,configurationSchema:{version:P.schemaVersion,schema:P.schema},adminConfigurationSchema:P.adminSchema?{schema:P.adminSchema,version:P.adminSchemaVersion}:void 0,chat:P.chat,embeddings:P.embeddings,...P.assistant?{assistant:!0}:{},acl:{canCreate:P.aclCanCreate},privateFiles:[...P.assets.privateFilePaths],publicFiles:[...P.assets.publicFilePaths],sdkVersion:E},headers:s(h,{projectSlug:d,environmentSlug:m})});if($)throw Error(`Failed to prepare development deployment for ${d}/${m} on ${c}: ${$.message}. ${o(h,d)}`);if(!b)throw Error("No data returned from server while preparing the development deployment.");let{environmentVariables:y,privateUploadUrls:N,publicUploadUrls:w}=b;if(f)p.debug("Skipping file upload");else{p.info("Uploading files to S3...");let e={privateFiles:[...P.assets.privateFilesFullPaths].map(e=>{let i=e.replace("assets/private/",""),t=N[i];if(!t)throw Error(`No upload URL provided for private file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...P.assets.publicFilesFullPaths].map(e=>{let i=e.replace("assets/public/",""),t=w[i];if(!t)throw Error(`No upload URL provided for public file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:p})}try{await e(v,`${r({...y,PHOENIX_PROJECT_SLUG:d,PHOENIX_ENVIRONMENT_SLUG:m,PHOENIX_SERVER_URL:c,PHOENIX_DEPLOYMENT_FINGERPRINT:P.fingerprint})}
 `),p.debug(`Environment variables written to ${v}`)}catch{throw Error(`Failed to write environment variables to file at ${v}, please verify you have write permissions to this location.`)}p.info(`Project: ${d}`),p.info(`Environment: ${m}`),p.info(`Deployment ID: ${y.DEPLOYMENT_ID}`),p.success("Development environment prepared successfully!")};

package/dist/phoenix/services/session/editor-server-handle.d.ts

@@ -0,0 +1,5 @@
+/** A session-owned editor transport, including the result of binding its port. */
+export interface EditorServerHandle {
+    readonly ready: Promise<void>;
+    readonly close: () => Promise<void>;
+}

package/dist/phoenix/services/session/editor-server-handle.js

@@ -0,0 +1 @@
+export{};

package/dist/phoenix/services/session/index.d.ts

@@ -0,0 +1,2 @@
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, } from './phoenix-application.js';
+export type { EditorServerHandle } from './editor-server-handle.js';

package/dist/phoenix/services/session/index.js

@@ -0,0 +1 @@
+export{PhoenixApplication}from"./phoenix-application.js";

package/dist/phoenix/services/session/phoenix-application.d.ts

@@ -0,0 +1,83 @@
+import { Subject } from 'rxjs';
+import { createServer } from 'vite';
+import { type Logger } from '../../utils/index.js';
+import { DeploymentPreparationService } from '../deployment/index.js';
+import type { DevExperience } from '../dev-experience/index.js';
+import { type DevelopmentCredential } from '../development-credential.js';
+import { LinguiWatcher } from '../lingui-watcher.js';
+import { LogBus } from '../log-bus.js';
+import { type BrowserConsoleEvent, PhoenixPubSub } from '../phoenix-pubsub.js';
+import { PhoenixStore } from '../phoenix-store.js';
+import { VariantPreviewService } from '../variant-preview-service.js';
+import { WebhookTunnelMonitor } from '../webhook-tunnel-monitor.js';
+import type { EditorServerHandle } from './editor-server-handle.js';
+/** Resolved inputs for one development session; the application constructs its service graph. */
+export interface PhoenixDevelopmentOptions {
+    readonly sdkVersion: string;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly cliUseWorkspace: boolean | undefined;
+    readonly devExperience: DevExperience;
+    readonly debug: boolean;
+    readonly withLingui: boolean;
+    readonly persistenceMode: string | undefined;
+    readonly force: boolean;
+    readonly serverUrl: string | undefined;
+    readonly credential: DevelopmentCredential | undefined;
+    readonly skipUpload: boolean;
+}
+export interface PhoenixApplicationProps {
+    readonly projectRoot: string;
+    readonly mode: 'dev' | 'story';
+    readonly development: PhoenixDevelopmentOptions | undefined;
+    readonly editorPort: number | undefined;
+}
+/** Host adapters for the editor transport and terminal presentation at lifecycle boundaries. */
+export interface PhoenixApplicationContext {
+    readonly logger: Logger;
+    readonly createEditorServer: (props: {
+        readonly port: number;
+        readonly application: PhoenixApplication;
+        readonly logger: Logger;
+        readonly debug: boolean;
+    }) => EditorServerHandle;
+    readonly onProjectPrepared: (logs: LogBus) => void;
+    readonly onStartupFailure: (error: unknown) => void;
+    readonly onBrowserConsole: (event: BrowserConsoleEvent, logs: LogBus) => void;
+}
+/** Composes, starts and closes one dev or story session, including resources acquired during a failed start. */
+export declare class PhoenixApplication {
+    private readonly props;
+    private readonly context;
+    readonly store: PhoenixStore;
+    readonly pubsub: PhoenixPubSub;
+    readonly failures$: Subject<Error>;
+    private readonly logsValue;
+    private readonly tunnelMonitorValue;
+    private readonly deploymentPreparationValue;
+    private variantPreviewsValue;
+    private linguiWatcherValue;
+    private projectWatcher;
+    private storyWatcher;
+    private mockTemplateWatcher;
+    private editorServer;
+    private webhookTunnel;
+    private browserConsoleSubscription;
+    private startPromise;
+    private closePromise;
+    constructor(props: PhoenixApplicationProps, context: PhoenixApplicationContext);
+    get logs(): LogBus | undefined;
+    get tunnelMonitor(): WebhookTunnelMonitor | undefined;
+    get deploymentPreparation(): DeploymentPreparationService | undefined;
+    get projectRoot(): string;
+    get mode(): 'dev' | 'story';
+    get variantPreviews(): VariantPreviewService | undefined;
+    get linguiWatcher(): LinguiWatcher | undefined;
+    start(): Promise<Awaited<ReturnType<typeof createServer>> | undefined>;
+    close(): Promise<void>;
+    private startSession;
+    private startEditor;
+    private startDevelopment;
+    private assertStarting;
+    private closeResources;
+}