@salsita-ai/sdk 0.0.0-stage → 0.49.0-develop.cbee856178

package/dist/phoenix/services/spec-files.d.ts

@@ -0,0 +1,20 @@
+import type { MockTemplateDefinition } from '#package/editor';
+import { type Logger } from '../utils/index.js';
+export interface ParsedMockTemplate {
+    templateDefinition: MockTemplateDefinition;
+    errors: string[];
+}
+/**
+ * Parse a YAML string into a MockTemplateDefinition using Zod validation
+ */
+export declare const parseMockTemplateYaml: (content: string, fileName: string) => ParsedMockTemplate;
+export interface LoadMockTemplatesResult {
+    templates: MockTemplateDefinition[];
+    errors: string[];
+}
+/**
+ * Loads and parses mock template files from a given path pattern
+ */
+export declare const loadMockTemplates: (pathPattern: string, context?: {
+    readonly logger: Logger;
+}) => Promise<LoadMockTemplatesResult>;

package/dist/phoenix/services/spec-files.js

@@ -0,0 +1 @@
+import{readFile as e}from"fs/promises";import{globby as r}from"globby";import t from"yaml";import{z as o}from"zod";import{createLogger as n}from"../utils/index.js";let i=async t=>{let o=await r(t,{ignore:["**/__generated/**"]});return 0===o.length?[]:Promise.all(o.map(async r=>{let t=await e(r,"utf-8");return{fileName:r,content:t}}))},a=o.object({role:o.enum(["anonymous","user","admin","superadmin"]),data:o.record(o.unknown()),expirationTimeMs:o.number().optional()}),s=o.object({access:o.string(),description:o.string().optional()}),l=o.object({entities:o.array(o.record(o.unknown())),modelVersion:o.number(),rootEntityType:o.string(),description:o.string().optional()}),p=o.object({data:o.record(o.unknown()),description:o.string().optional()}),c=o.object({data:o.record(o.unknown()),description:o.string().optional()}),m=o.object({data:o.record(o.unknown()),description:o.string().optional()}),d=o.object({type:o.literal("preset"),description:o.string().optional()}),g=o.object({type:o.literal("recipe"),collection:o.string(),rootRecipeId:o.string().optional(),description:o.string().optional()}),u=o.union([d,g]),f=o.record(o.unknown()).optional(),b=o.object({key:o.string(),title:o.string(),description:o.string().optional(),order:o.number().optional(),session:a,access:s,configuration:l.optional(),publishedData:p.optional(),frontendData:c.optional(),backendData:m.optional(),embeddedView:u.optional(),webComponentProperties:f});export const parseMockTemplateYaml=(e,r)=>{try{let o=t.parse(e,{merge:!0});if(!o||"object"!=typeof o)return{templateDefinition:{},errors:[`Invalid YAML format in ${r}`]};let n=b.safeParse(o);if(!n.success){let e=n.error.errors.map(e=>{let t=e.path.join(".");return`${r}: ${t?`${t} - `:""}${e.message}`});return{templateDefinition:{},errors:e}}return{templateDefinition:n.data,errors:[]}}catch(e){return{templateDefinition:{},errors:[`Failed to parse YAML in ${r}: ${e instanceof Error?e.message:String(e)}`]}}};export const loadMockTemplates=async(e,r)=>{let t=r?.logger??n();try{let r=await i(e);if(0===r.length)return t.debug("No mock template files found"),{templates:[],errors:[]};let o=[],n=[];for(let e of r){let r=parseMockTemplateYaml(e.content,e.fileName);r.errors.length>0?n.push(...r.errors):o.push(r.templateDefinition)}return o.sort((e,r)=>{let t=e.order??1/0,o=r.order??1/0;return t-o}),n.length>0&&t.error(`Mock template parsing errors: ${n.join(", ")}`),{templates:o,errors:n}}catch(e){return t.error(`Failed to load mock templates: ${e instanceof Error?e.message:String(e)}`),{templates:[],errors:[e instanceof Error?e.message:String(e)]}}};

package/dist/phoenix/services/story-dev-marker.d.ts

@@ -0,0 +1,10 @@
+/** Location of the story-dev ownership marker relative to a story root. */
+export declare const STORY_DEV_MARKER_PATH = ".phoenix/story-dev.json";
+/** Identifies the live story-dev process and WebSocket endpoint for one story. */
+export interface StoryDevMarker {
+    readonly projectRoot: string;
+    readonly pid: number;
+    readonly port: number;
+}
+/** Reads a story marker only when it is valid and its owning process is still alive. */
+export declare const readActiveStoryDevMarker: (storyRoot: string) => Promise<StoryDevMarker | null>;

package/dist/phoenix/services/story-dev-marker.js

@@ -0,0 +1 @@
+import{readFile as r}from"node:fs/promises";import{join as o}from"node:path";export const STORY_DEV_MARKER_PATH=".phoenix/story-dev.json";export const readActiveStoryDevMarker=async t=>{try{let e=JSON.parse(await r(o(t,".phoenix/story-dev.json"),"utf-8"));return"object"==typeof e&&null!==e&&"projectRoot"in e&&"string"==typeof e.projectRoot&&"pid"in e&&"number"==typeof e.pid&&"port"in e&&"number"==typeof e.port&&(r=>{try{return process.kill(r,0),!0}catch(r){return!(r instanceof Error&&"code"in r&&"ESRCH"===r.code)}})(e.pid)?e:null}catch{return null}};

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

@@ -0,0 +1,17 @@
+import { type Logger } from '../utils/index.js';
+export interface SwcCompileProps {
+    readonly sourceDir?: string;
+    readonly outDir?: string;
+}
+export declare const compileWithSwc: (props?: SwcCompileProps, context?: {
+    readonly logger: Logger;
+}) => Promise<void>;
+/**
+ * Watch mode for SWC compilation
+ * Watches for changes in TypeScript files and non-compilable files
+ */
+export declare const watchWithSwc: (props?: SwcCompileProps, context?: {
+    readonly logger: Logger;
+}) => Promise<{
+    stop: () => Promise<void>;
+}>;

package/dist/phoenix/services/swc.js

@@ -0,0 +1,3 @@
+import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as i}from"fs/promises";import{globby as r}from"globby";import{dirname as c,relative as l,resolve as n}from"path";import{Subject as p}from"rxjs";import{watch as m}from"#package/watch";import{createLogger as w}from"../utils/index.js";let u=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[["@lingui/swc-plugin",{}]]}}}),d=async(e,t,a)=>{let i=process.cwd(),p=n(i,e),m=n(i,t),w=await r(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:p,ignore:["**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json"],absolute:!1}),u=0,d=0;for(let e of w)try{let t=n(p,e),a=n(m,e);await o(c(a),{recursive:!0}),await s(t,a),u++}catch(t){d++,console.error(`Failed to copy ${l(i,n(p,e))}:`,t)}if(d>0)throw Error(`Failed to copy ${d} file(s)`);u>0&&a.debug(`Copied ${u} non-compilable file(s)`)};export const compileWithSwc=async(s,p)=>{let{sourceDir:m="src",outDir:f="./node_modules/.phoenix"}=s??{},g=p?.logger??w(),h=process.cwd(),x=n(h,m),_=n(h,f);await t(_);let y=await r(["**/*.{ts,tsx}"],{cwd:x,ignore:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),b=u(),$=0,j=0;for(let t of y)try{let s=n(x,t),r=n(_,t.replace(/\.tsx?$/,".js")),l=await a(s,"utf-8"),p=await e(l,{...b,filename:s,sourceMaps:!0,outputPath:r});await o(c(r),{recursive:!0}),await i(r,p.code,"utf-8"),p.map&&await i(`${r}.map`,p.map,"utf-8"),$++}catch(e){j++,console.error(`Failed to compile ${l(h,n(x,t))}:`,e)}if(j>0)throw Error(`Failed to compile ${j} file(s)`);g.isDebug&&g.debug(`Compiled ${$} file(s) with swc`),await d(m,f,g)};let f=async(t,s,r)=>{let l=process.cwd(),p=n(l,s),m=n(l,r),w=u(),d=n(p,t),f=n(m,t.replace(/\.tsx?$/,".js")),g=await a(d,"utf-8"),h=await e(g,{...w,filename:d,sourceMaps:!0,outputPath:f});await o(c(f),{recursive:!0}),await i(f,h.code,"utf-8"),h.map&&await i(`${f}.map`,h.map,"utf-8")},g=async(e,t,a)=>{let i=process.cwd(),r=n(i,t),l=n(i,a),p=n(r,e),m=n(l,e);await o(c(m),{recursive:!0}),await s(p,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s="src",outDir:o="./node_modules/.phoenix"}=e??{},a=t?.logger??w(),i=n(process.cwd(),s);a.isDebug&&a.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o},t),a.isDebug&&a.success("Initial compilation complete");let r=new p,c=m(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:i,ignored:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return c.on("all",(e,t)=>{("change"===e||"add"===e)&&r.next({file:t,type:e})}),r.subscribe(async({file:e})=>{let t=l(i,n(i,e));try{e.match(/\.tsx?$/)?(await f(t,s,o),a.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await g(t,s,o),a.fileChanged(t))}catch(e){a.error(`Failed to process ${t}`),a.isDebug&&console.error(e)}}),a.isDebug&&console.log(`
+👀 Watching ${s} for changes...
+`),{stop:async()=>{await c.close(),a.isDebug&&a.info("SWC watcher stopped")}}};

package/dist/phoenix/services/vite-config.d.ts

@@ -0,0 +1,20 @@
+import { type InlineConfig } from 'vite';
+export type ViteLogSink = (level: 'info' | 'warn' | 'error', message: string) => void;
+export interface ViteLogSinkOptions {
+    /** Keep printing through Vite's own default logger (timestamps, [vite] tag, warnOnce dedup). */
+    readonly echo?: boolean;
+}
+export declare const setViteLogSink: (sink: ViteLogSink, options?: ViteLogSinkOptions) => void;
+/**
+ * Get the inline Vite configuration for Phoenix projects
+ */
+export declare const getViteDevConfig: (options?: {
+    readonly templateFiles?: readonly string[];
+}) => Promise<InlineConfig>;
+/**
+ * Get the inline Vite configuration for Phoenix projects
+ */
+export declare const getViteBuildConfigs: (options: {
+    enableEditor?: boolean;
+    templateFiles: readonly string[];
+}) => Promise<InlineConfig[]>;

package/dist/phoenix/services/vite-config.js

@@ -0,0 +1 @@
+import{lingui as e}from"@lingui/vite-plugin";import i from"@vitejs/plugin-react";import{mkdir as t,readFile as n,writeFile as r}from"fs/promises";import o from"lodash-es/camelCase.js";import{createRequire as a}from"node:module";import{dirname as s,resolve as m}from"path";import{createLogger as l}from"vite";import d from"vite-plugin-css-injected-by-js";import{isUsingLocalSdk as f}from"../utils/package-info.js";import{loadFrontendConfigModule as c}from"./frontend-config.js";import{phxCspNoncePlugin as p}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as g}from"./phx-global-isolation-plugin.js";let u=null;export const setViteLogSink=(e,i={})=>{u={sink:e,echo:i.echo??!1}};let h=["react","react-dom","three","@react-three/fiber","@react-three/drei","@react-three/postprocessing","its-fine","@emotion/react","@emotion/styled","@mui/material","@mui/system","@tanstack/react-query","rxjs"],S=e=>{let i=e.DEPLOYMENT_ID;if("string"!=typeof i)throw Error("DEPLOYMENT_ID is required in runtime config");return i};export const getViteDevConfig=async t=>{var n,r;let o,d,p=f(),y=c(),O=y.readRuntimeConfig(),b=y.frontendBuildConfig,D=Object.fromEntries((t?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...u&&{customLogger:(n=u.sink,r=u.echo,o=l(),{get hasWarned(){return o.hasWarned},info:(e,i)=>{n("info",e),r&&o.info(e,i)},warn:(e,i)=>{n("warn",e),r&&o.warn(e,i)},warnOnce:(e,i)=>{n("warn",e),r&&o.warnOnce(e,i)},error:(e,i)=>{n("error",e),r&&o.error(e,i)},clearScreen:e=>{r&&o.clearScreen(e)},hasErrorLogged:e=>o.hasErrorLogged(e)}),...u.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...p&&{entries:["index.html","admin.html",...t?.templateFiles??[]],force:!0}},...p&&{resolve:{alias:(d=a(m(process.cwd(),"package.json")),h.flatMap(e=>{try{let i=s(d.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[i({babel:{plugins:["macros"]}}),e(),{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=y.readRuntimeConfig(),t=y.frontendBuildConfig;return{...e,define:{...e.define,"phx.frontendEnv":JSON.stringify(i),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(t.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(t.gltfDecoder)}}}},g({getDeploymentId:()=>S(y.readRuntimeConfig())})],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(O),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(b.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(b.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...D}}},root:m(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async a=>{let l=c(),f=l.readRuntimeConfig(),u=l.frontendBuildConfig,h=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:a.templateFiles}.templateFiles],main:!0,format:"iife"},{name:"salsita-admin",entryFile:"./admin.ts",mainScriptPath:"./admin.ts",htmlFiles:["./admin.html"],main:!1,format:"iife"},{name:"salsita-embedded-admin",entryFile:"./embedded-admin.ts",mainScriptPath:"./embedded-admin.ts",htmlFiles:[],main:!1,format:"es"},{name:"salsita-embedded-configurator",entryFile:"./embedded-configurator.ts",mainScriptPath:"./embedded-configurator.ts",htmlFiles:[],main:!1,format:"es"}].map(c=>({plugins:[i({babel:{plugins:["macros"]}}),e(),d({useStrictCSP:!0}),p(),g({getDeploymentId:()=>S(l.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!c.htmlFiles.length)return;let e="iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`;for(let i of c.htmlFiles){if(c.main&&a.enableEditor&&"./index.html"===i)continue;let o=m("./.phoenix",i),l=m("./.phoenix/dist/frontend",i);await t(s(l),{recursive:!0});let d=(await n(o,"utf-8")).replace(c.mainScriptPath,e);await r(l,d,"utf-8")}}}],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:c.entryFile,name:o(c.name),formats:[c.format],fileName:()=>"iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${c.name}.[ext]`}},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(u.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(u.gltfDecoder)}}));return a.enableEditor?[...h,{plugins:[i({babel:{plugins:["macros"]}}),e(),d({useStrictCSP:!0}),p()],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,rollupOptions:{external:[]},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(u.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(u.gltfDecoder)}}]:h};

package/dist/phoenix/services/webhook-service/index.d.ts

@@ -0,0 +1,4 @@
+export { startWebhookService, type WebhookServiceOptions } from './webhook-service.js';
+export { createWebhookTunnelTransport } from './transport.js';
+export { readOrCreateTunnelSessionId } from './session.js';
+export type { TunnelHandle } from './tunnel.js';

package/dist/phoenix/services/webhook-service/index.js

@@ -0,0 +1 @@
+export{startWebhookService}from"./webhook-service.js";export{createWebhookTunnelTransport}from"./transport.js";export{readOrCreateTunnelSessionId}from"./session.js";

package/dist/phoenix/services/webhook-service/session.d.ts

@@ -0,0 +1,2 @@
+/** Read the checkout's stable tunnel identity, creating it on first use. */
+export declare const readOrCreateTunnelSessionId: (directory?: string) => Promise<string>;

package/dist/phoenix/services/webhook-service/session.js

@@ -0,0 +1,2 @@
+import{randomUUID as r}from"node:crypto";import{mkdir as e,readFile as o,writeFile as t}from"node:fs/promises";import{join as n}from"node:path";export const readOrCreateTunnelSessionId=async(i=".phoenix")=>{let a=n(i,"webhook-tunnel-session");try{let r=(await o(a,"utf8")).trim();if(r)return r}catch(r){if(!(r instanceof Error&&"code"in r&&"ENOENT"===r.code))throw r}let s=r();return await e(i,{recursive:!0}),await t(a,`${s}
+`),s};

package/dist/phoenix/services/webhook-service/transport.d.ts

@@ -0,0 +1,11 @@
+import { type DevelopmentCredential } from '../development-credential.js';
+import type { TunnelTransport } from './tunnel.js';
+interface WebhookTunnelTransportOptions {
+    readonly serverUrl: string;
+    readonly credential: DevelopmentCredential;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+}
+/** Create the generated-client adapter used by the Phoenix-owned tunnel lifecycle. */
+export declare const createWebhookTunnelTransport: ({ serverUrl, credential, projectSlug, environmentSlug, }: WebhookTunnelTransportOptions) => TunnelTransport;
+export {};

package/dist/phoenix/services/webhook-service/transport.js

@@ -0,0 +1 @@
+import{createApiBaseClient as e}from"#package/client";import{getDevelopmentHeaders as t}from"../development-credential.js";let o=(e,t)=>({ok:!1,status:t.status,message:e.message});export const createWebhookTunnelTransport=({serverUrl:a,credential:n,projectSlug:l,environmentSlug:r})=>{let s=e(a),p=t(n,{projectSlug:l,environmentSlug:r});return{poll:async({deploymentId:e,sessionId:t,signal:a})=>{let{data:n,error:l,response:r}=await s.POST("/deployments/{deploymentId}/webhook-tunnel/poll",{params:{path:{deploymentId:e}},body:{sessionId:t},headers:p,signal:a});return l?o(l,r):{ok:!0,value:n?.request??null}},respond:async({deploymentId:e,sessionId:t,requestId:a,status:n,headers:l,body:r,signal:d})=>{let{error:m,response:u}=await s.POST("/deployments/{deploymentId}/webhook-tunnel/respond",{params:{path:{deploymentId:e}},body:{sessionId:t,requestId:a,status:n,headers:l,body:r},headers:p,signal:d});return m?o(m,u):{ok:!0,value:void 0}}}};

package/dist/phoenix/services/webhook-service/tunnel.d.ts

@@ -0,0 +1,82 @@
+/** Connection state exposed to the Phoenix development UI. */
+export type TunnelClientStatus = 'waiting' | 'connected' | 'conflict' | 'error' | 'stopped';
+/** One locally processed request exposed to tunnel observers. */
+export interface TunnelRequestRecord {
+    readonly requestId: string;
+    readonly operation: string;
+    readonly method: string;
+    readonly url: string;
+    readonly startedAt: number;
+    readonly durationMs: number;
+    readonly outcome: 'served' | 'failed' | 'skipped-expired';
+    readonly responseStatus: number | null;
+    readonly requestBody: string | null;
+    readonly responseBody: string | null;
+    readonly error: string | null;
+}
+/** A webhook request claimed from the development tunnel. */
+export interface TunneledRequest {
+    readonly requestId: string;
+    readonly url: string;
+    readonly method: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: string | null;
+    readonly deadline: number;
+}
+/** Successful or rejected result returned by the injected tunnel transport. */
+export type TunnelTransportResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly status: number;
+    readonly message: string;
+};
+/** Inputs for one long-poll request. */
+export interface TunnelPollRequest {
+    readonly deploymentId: string;
+    readonly sessionId: string;
+    readonly signal: AbortSignal;
+}
+/** Inputs for returning one locally executed webhook response. */
+export interface TunnelRespondRequest {
+    readonly deploymentId: string;
+    readonly sessionId: string;
+    readonly requestId: string;
+    readonly status: number;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body: string;
+    readonly signal: AbortSignal;
+}
+/** Server boundary used by the package-independent tunnel lifecycle. */
+export interface TunnelTransport {
+    readonly poll: (request: TunnelPollRequest) => Promise<TunnelTransportResult<TunneledRequest | null>>;
+    readonly respond: (request: TunnelRespondRequest) => Promise<TunnelTransportResult<void>>;
+}
+/** Runtime inputs required to claim and serve a development webhook tunnel. */
+export interface TunnelOptions {
+    readonly transport: TunnelTransport;
+    readonly rejectionHint: string;
+    readonly environmentSlug: string;
+    readonly deploymentId: string;
+    readonly sessionId: string;
+    readonly bundle: string;
+    readonly handler: string;
+    readonly verbosity?: number;
+    readonly pollLoops?: number;
+    readonly onStatus?: (status: TunnelClientStatus, message?: string) => void;
+    readonly onRequest?: (record: TunnelRequestRecord) => void;
+}
+/** Lifecycle handle owned by the command that starts the tunnel. */
+export interface TunnelHandle {
+    readonly sessionId: string;
+    readonly stop: () => Promise<void>;
+    readonly stopped: Promise<void>;
+}
+/** A terminal server response that requires phoenix dev to stop. */
+export declare class TunnelTerminalError extends Error {
+    readonly kind: 'conflict' | 'rejected' | 'stale';
+    constructor(kind: 'conflict' | 'rejected' | 'stale', message: string);
+}
+/** Start parallel long-poll loops for one prepared development deployment. */
+export declare const startTunnel: (options: TunnelOptions) => TunnelHandle;

package/dist/phoenix/services/webhook-service/tunnel.js

@@ -0,0 +1 @@
+import{execute as e,getLogger as t,webhookLogContext as r}from"../../webhooks/index.js";export class TunnelTerminalError extends Error{kind;constructor(e,t){super(t),this.kind=e}}let n=async e=>{e.aborted||await new Promise(t=>{let r=()=>{clearTimeout(n),t()},n=setTimeout(()=>{e.removeEventListener("abort",r),t()},5e3);e.addEventListener("abort",r,{once:!0})})},o=e=>new URL(e.url,"http://webhook-tunnel.invalid").searchParams.get("o")??"finalize",s=async(t,n,o)=>{if(o.aborted)return null;let s=()=>void 0,a=new Promise(e=>{(s=()=>e(null),o.aborted)?s():o.addEventListener("abort",s,{once:!0})}),i=(async()=>{try{var o,s;let a=await r.run("webhook",()=>{let r;return e({lambdaPath:n.bundle,lambdaHandler:n.handler,esm:!1,event:(r=new URL(t.url,"http://webhook-tunnel.invalid"),{version:"2.0",routeKey:"$default",rawPath:r.pathname,rawQueryString:r.search,cookies:[],headers:t.headers,queryStringParameters:Object.fromEntries(r.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:t.method,path:r.pathname,protocol:"HTTP/1.1",sourceIp:"127.0.0.1",userAgent:"phoenix-webhook-tunnel"},requestId:t.requestId,routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:Date.now()},body:t.body??void 0,isBase64Encoded:!1}),verboseLevel:n.verbosity??0,timeoutMs:6e4})});if((o=a)&&"object"==typeof o&&"statusCode"in o&&"number"==typeof o.statusCode&&(!("headers"in o)||void 0===o.headers||(s=o.headers)&&"object"==typeof s&&Object.values(s).every(e=>"string"==typeof e)))return{status:a.statusCode,headers:a.headers,body:"string"==typeof a.body?a.body:JSON.stringify(a.body??""),error:null};return{status:200,body:JSON.stringify(a)??"",error:null}}catch(t){let e=t instanceof Error?t.message:String(t);return{status:500,body:JSON.stringify({message:e}),error:e}}})(),l=await Promise.race([i,a]);return o.removeEventListener("abort",s),l};export const startTunnel=e=>{let{transport:r,rejectionHint:a,environmentSlug:i,deploymentId:l,sessionId:d,pollLoops:u=2,onStatus:c,onRequest:h}=e,m=t(),f=new AbortController,p=!1,y=!1,w=!1,b=0,g=null,v=null,$=[],k=new Set,T=e=>void 0,q=new Promise((e,t)=>{T=t}),E=(e,t)=>{m.log(e,t)},I=(e,t)=>{try{c?.(e,t)}catch{}},S=e=>{try{h?.(e)}catch{}},P=e=>(g||(g=e,p=!0,f.abort(),E("error",e.message),I("conflict"===e.kind?"conflict":"error",e.message)),g),x=e=>{w=!0,E("warn",e),I("error",e)},W=()=>new TunnelTerminalError("conflict",`Webhook tunnel for environment ${i} (deployment ${l}) is owned by another phoenix dev session. Stop the other session and restart.`),R=e=>new TunnelTerminalError("rejected",`${e} ${a}`),D=async(e,t)=>{for(;!p;){try{let n=await r.respond({deploymentId:l,sessionId:d,requestId:e.requestId,status:t.status,headers:t.headers,body:t.body,signal:f.signal});if(n.ok)return;if(403===n.status)throw P(W());if(404===n.status)throw P(new TunnelTerminalError("stale",n.message));if(n.status<500)throw P(R(n.message));x(`Webhook tunnel response could not reach the server: ${n.message} Retrying in 5 seconds.`)}catch(e){if(e instanceof TunnelTerminalError)throw e;if(p)return;x(`Webhook tunnel response could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`)}await n(f.signal)}},L=e=>{let t=o(e),r=Date.now();w&&(b+=1),E("warn",`Tunneled ${t} request ${e.requestId} skipped because its deadline expired.`),S({requestId:e.requestId,operation:t,method:e.method,url:e.url,startedAt:r,durationMs:0,outcome:"skipped-expired",responseStatus:null,requestBody:e.body,responseBody:null,error:"Request deadline expired before phoenix dev picked it up."})},j=async t=>{let r=o(t),n=Date.now(),a=await s(t,e,f.signal);if(!a)return;let i=Date.now()-n,l=a.error?"failed":"served";E(a.error?"warn":"info",`Tunneled ${r} request ${t.requestId} ${l} in ${i}ms (status ${a.status}).`),S({requestId:t.requestId,operation:r,method:t.method,url:t.url,startedAt:n,durationMs:i,outcome:l,responseStatus:a.status,requestBody:t.body,responseBody:a.body,error:a.error}),await D(t,a)},O=()=>{for(;!p&&k.size<u;){let e=$.shift();if(!e)return;if(e.deadline<Date.now()){L(e);continue}let t=j(e);k.add(t),t.then(()=>{k.delete(t),O()},e=>{k.delete(t),T(e)})}},B=async e=>{let t=0;for(;!p;)try{let o=await r.poll({deploymentId:l,sessionId:d,signal:f.signal});if(!o.ok){if(409===o.status){if(y||t>=3)throw P(W());t+=1,0===e&&E("warn",`Webhook tunnel for environment ${i} is already claimed. Retrying in 5 seconds (${t}/3).`)}else if(403===o.status)throw P(R(o.message));else if(404===o.status)throw P(new TunnelTerminalError("stale",o.message));else if(o.status<500)throw P(R(o.message));else x(`Webhook tunnel poll failed: ${o.message} Retrying in 5 seconds.`);await n(f.signal);continue}t=0;let s=o.value,a=!!s&&s.deadline<Date.now();s&&a&&L(s),y||(y=!0,E("info",`Webhook tunnel connected for environment ${i} (deployment ${l}, session ${d}).`)),w&&(E("info",`Webhook tunnel reconnected${b>0?`; ${b} queued request(s) expired and were skipped during the interruption.`:"."}`),w=!1,b=0),I("connected"),s&&!a&&($.push(s),O())}catch(e){if(e instanceof TunnelTerminalError)throw e;if(p)return;x(`Webhook tunnel poll could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`),await n(f.signal)}};I("waiting");let C=Promise.race([Promise.all(Array.from({length:u},(e,t)=>B(t))).then(async()=>{await Promise.all(k)}),q]);return{sessionId:d,stop:()=>v||(p=!0,f.abort(),E("info",`Webhook tunnel stopped for environment ${i} (deployment ${l}).`),I("stopped"),v=C.catch(e=>{if(!(e instanceof TunnelTerminalError))throw e})),stopped:C}};

package/dist/phoenix/services/webhook-service/webhook-service.d.ts

@@ -0,0 +1,14 @@
+import { type TunnelClientStatus, type TunnelHandle, type TunnelRequestRecord, type TunnelTransport } from './tunnel.js';
+export interface WebhookServiceOptions {
+    readonly transport: TunnelTransport;
+    readonly rejectionHint: string;
+    readonly environmentSlug: string;
+    readonly deploymentId: string;
+    readonly sessionId: string;
+    readonly config?: string;
+    readonly experimental?: boolean;
+    readonly onStatus?: (status: TunnelClientStatus, message?: string) => void;
+    readonly onRequest?: (record: TunnelRequestRecord) => void;
+}
+/** Load the webhook bundle configuration and start its development tunnel. */
+export declare const startWebhookService: ({ transport, rejectionHint, environmentSlug, deploymentId, sessionId, config, experimental, onStatus, onRequest, }: WebhookServiceOptions) => Promise<TunnelHandle>;

package/dist/phoenix/services/webhook-service/webhook-service.js

@@ -0,0 +1 @@
+import{resolve as o}from"node:path";import{loadConfig as t}from"../../webhooks/index.js";import{startTunnel as e}from"./tunnel.js";export const startWebhookService=async({transport:r,rejectionHint:n,environmentSlug:i,deploymentId:m,sessionId:s,config:a,experimental:p=!1,onStatus:b,onRequest:c})=>{let{outDir:d,bundleName:f,handler:h,verbosity:l}=await t({config:a,experimental:p});return e({transport:r,rejectionHint:n,environmentSlug:i,deploymentId:m,sessionId:s,bundle:o(d,f),handler:h,verbosity:l,onStatus:b,onRequest:c})};

package/dist/phoenix/services/webhook-tunnel-monitor.d.ts

@@ -0,0 +1,63 @@
+import type { TunnelRequestRecord } from './webhook-service/tunnel.js';
+/** Connection state exposed to the editor's Webhook Tunnel panel. */
+export type TunnelStatus = 'waiting' | 'connected' | 'conflict' | 'error' | 'stopped';
+/** Current tunnel connection state retained by the development process. */
+export interface TunnelStatusState {
+    readonly status: TunnelStatus;
+    readonly serverUrl: string | null;
+    readonly deploymentId: string | null;
+    readonly sessionId: string | null;
+    readonly message: string | null;
+    readonly since: number;
+}
+/** Body-less request data sent in tunnel snapshots and live events. */
+export interface TunnelRequestSummary {
+    readonly seq: number;
+    readonly requestId: string;
+    readonly operation: string;
+    readonly method: string;
+    readonly url: string;
+    readonly startedAt: number;
+    readonly durationMs: number;
+    readonly outcome: 'served' | 'failed' | 'skipped-expired';
+    readonly responseStatus: number | null;
+    readonly error: string | null;
+}
+/** Sanitized request data retained for on-demand detail queries. */
+export interface TunnelRequestEntry extends TunnelRequestSummary {
+    readonly requestBody: string | null;
+    readonly responseBody: string | null;
+}
+/** Live tunnel update sent to connected editor clients. */
+export type TunnelEvent = {
+    readonly type: 'status';
+    readonly state: TunnelStatusState;
+} | {
+    readonly type: 'request';
+    readonly entry: TunnelRequestSummary;
+};
+interface TunnelStatusDetails {
+    readonly serverUrl?: string | null;
+    readonly deploymentId?: string | null;
+    readonly sessionId?: string | null;
+    readonly message?: string | null;
+}
+/**
+ * Bounded in-process tunnel history owned by `phoenix dev`.
+ *
+ * Payloads are sanitized before storage so secrets never cross the editor-server boundary.
+ */
+export declare class WebhookTunnelMonitor {
+    private readonly emitter;
+    private entries;
+    private seq;
+    private currentState;
+    constructor(serverUrl?: string | null);
+    setStatus(status: TunnelStatus, details?: TunnelStatusDetails): void;
+    record(record: TunnelRequestRecord): void;
+    state(): TunnelStatusState;
+    summaries(): readonly TunnelRequestSummary[];
+    entry(seq: number): TunnelRequestEntry | null;
+    subscribe(listener: (event: TunnelEvent) => void): () => void;
+}
+export {};

package/dist/phoenix/services/webhook-tunnel-monitor.js

@@ -0,0 +1 @@
+import{EventEmitter as e}from"node:events";let t="•••redacted•••",s=/token|secret|password|authorization|apikey|api_key/i,r=e=>Array.isArray(e)?e.map(r):null!==e&&"object"==typeof e?Object.fromEntries(Object.entries(e).map(([e,n])=>{if(s.test(e))return[e,null!==n&&"object"==typeof n?Array.isArray(n)?n.map(()=>t):Object.fromEntries(Object.keys(n).map(e=>[e,t])):t];return[e,r(n)]})):e,n=e=>{let s,n;if(null===e)return null;try{s=JSON.parse(e)}catch{return e.length<=2e4?e:`${e.slice(0,2e4)}… [truncated, ${e.length} chars total]`}try{n=JSON.stringify(r(s))}catch{n=JSON.stringify(t)}return n.length<=2e4?n:`${n.slice(0,2e4)}… [truncated, ${n.length} chars total]`},i=({requestBody:e,responseBody:t,...s})=>s;export class WebhookTunnelMonitor{emitter=new e().setMaxListeners(0);entries=[];seq=0;currentState;constructor(e=null){this.currentState={status:"waiting",serverUrl:e,deploymentId:null,sessionId:null,message:null,since:Date.now()}}setStatus(e,t={}){let s={status:e,serverUrl:void 0===t.serverUrl?this.currentState.serverUrl:t.serverUrl,deploymentId:void 0===t.deploymentId?this.currentState.deploymentId:t.deploymentId,sessionId:void 0===t.sessionId?this.currentState.sessionId:t.sessionId,message:t.message??null};(s.status!==this.currentState.status||s.serverUrl!==this.currentState.serverUrl||s.deploymentId!==this.currentState.deploymentId||s.sessionId!==this.currentState.sessionId||s.message!==this.currentState.message)&&(this.currentState={...s,since:Date.now()},this.emitter.emit("event",{type:"status",state:this.currentState}))}record(e){let t={...e,seq:++this.seq,requestBody:n(e.requestBody),responseBody:n(e.responseBody)};this.entries.push(t),this.entries.length>500&&(this.entries=this.entries.slice(-500)),this.emitter.emit("event",{type:"request",entry:i(t)})}state(){return this.currentState}summaries(){return this.entries.map(i)}entry(e){return this.entries.find(t=>t.seq===e)??null}subscribe(e){return this.emitter.on("event",e),()=>{this.emitter.off("event",e)}}}

package/dist/phoenix/story-scaffolding/generate-initial-story.d.ts

@@ -0,0 +1 @@
+export declare const generateInitialStory: (folderPath: string, componentName: string) => Promise<void>;

package/dist/phoenix/story-scaffolding/generate-initial-story.js

@@ -0,0 +1 @@
+import{join as t}from"path";import{syncExistingFolders as a,writeFilesIfNotExists as e}from"../utils/index.js";import{generateInitialDomainYaml as o,generateInitialMdx as n,generateInitialStoriesFile as i}from"./templates/index.js";export const generateInitialStory=async(r,s)=>{let m=t(r,"spec"),p=t(r,"src");await a(".",[r,m,p]),await e([{path:t(m,"domain.yaml"),content:o()},{path:t(r,`${s}.stories.tsx`),content:i(s)},{path:t(r,`${s}.mdx`),content:n(s)}])};

package/dist/phoenix/story-scaffolding/index.d.ts

@@ -0,0 +1 @@
+export { generateInitialStory } from './generate-initial-story.js';

package/dist/phoenix/story-scaffolding/index.js

@@ -0,0 +1 @@
+export{generateInitialStory}from"./generate-initial-story.js";

package/dist/phoenix/story-scaffolding/templates/generate-initial-domain-yaml.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generates a simple domain.yaml file
+ */
+export declare const generateInitialDomainYaml: () => string;

package/dist/phoenix/story-scaffolding/templates/generate-initial-domain-yaml.js

@@ -0,0 +1,63 @@
+export const generateInitialDomainYaml=()=>`model:
+  latest:
+    entityTypes:
+      - Scene
+      - Item
+    aliases:
+      RootEntity:
+        - Scene
+
+relations:
+  Scene:
+    $items:
+      kind: allOfType
+      target: Item
+      cardinality: 0-N
+      composedOf: true
+  Item:
+    $parent:
+      kind: allOfType
+      target: Scene
+      cardinality: 1-1
+      composedOf: false
+
+presets:
+  - rootEntityType: 'Scene'
+    initialDomainEntities:
+      - id: 'Scene-1'
+        type: 'Scene'
+      - id: 'Item-1'
+        type: 'Item'
+
+components:
+  Scene:
+    applicationConfig:
+      main:
+        layout: 'universal'
+        miniSidebar: true
+        splitSidebar: true
+  Item:
+    sceneEntityRemoteObject:
+      buckyball:
+        fileUrl: '/models/buckyball.glb'
+        objectName: 'BUCKYBALL'
+        dimensionUnit: 'm'
+    sceneEntityRemoteMaterialOverride:
+      buckyballMaterial:
+        fileUrl: '/models/buckyball.glb'
+        materialName: sampleMaterial
+        materialsToOverride:
+          - sampleMaterial
+        textureUrl: 'textures/water-silk/water-silk_BaseColor.jpg'
+        normalMapUrl: 'textures/water-silk/water-silk_Normal.jpg'
+        roughnessMapUrl: 'textures/water-silk/water-silk_Roughness.jpg'
+        aoMapUrl: 'textures/water-silk/water-silk_AmbientOcclusion.jpg'
+        aoMapIntensity: 3
+        normalScale: 6
+        bumpScale: 0
+        roughness: 1
+        metalness: 0.2
+        reflectivity: 0
+        transparent: false
+
+`;

package/dist/phoenix/story-scaffolding/templates/generate-initial-mdx.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generates the user documentation part of the MDX file (without Complete Implementation section)
+ */
+export declare const generateInitialMdx: (name: string) => string;

package/dist/phoenix/story-scaffolding/templates/generate-initial-mdx.js

@@ -0,0 +1,52 @@
+export const generateInitialMdx=e=>`import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as Story from './${e}.stories'
+
+<Meta of={Story} />
+
+# ${e}
+
+- [Use case](#use-case)
+- [Guide](#guide)
+- [Example](#example)
+- [Test cases](#test-cases)
+- [Complete Implementation](#complete-implementation)
+
+## Use case
+
+Describe the use case for this story. What problem does it solve? When should this pattern be used?
+
+## Guide
+
+Provide a step-by-step guide on how to implement this pattern.
+
+### Step 1 — Domain
+
+Explain the domain configuration needed:
+
+\`\`\`yaml
+# Add your domain YAML example here
+\`\`\`
+
+### Step 2 — Frontend (if needed)
+
+Explain any custom frontend components or hooks needed:
+
+\`\`\`tsx
+// Add your frontend code examples here
+\`\`\`
+
+## Example
+
+Interact with the example below:
+
+- Describe what users should try in the example
+- List key interactions to test
+
+<Canvas of={Story.Example} />
+
+## Test cases
+
+- List specific test cases that validate this implementation
+- Include edge cases and expected behaviors
+- Cover error states and boundary conditions`;

package/dist/phoenix/story-scaffolding/templates/generate-initial-stories-file.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generates the initial .stories.tsx file
+ */
+export declare const generateInitialStoriesFile: (name: string) => string;

package/dist/phoenix/story-scaffolding/templates/generate-initial-stories-file.js

@@ -0,0 +1,22 @@
+import{toPascalCase as e}from"../../utils/pascal-case.js";export const generateInitialStoriesFile=t=>{let o=e(t);return`import type { Meta, StoryObj } from '@storybook/react-vite'
+
+import { ExampleApp } from './.phoenix/${o}'
+
+const meta: Meta = {
+  title: 'New Examples / ${t}',
+  component: ExampleApp,
+  parameters: {
+    docs: {
+      story: {
+        inline: false,
+        iframeHeight: 700,
+      },
+    },
+  },
+} satisfies Meta<typeof ExampleApp>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+export const Example: Story = {}
+`};

package/dist/phoenix/story-scaffolding/templates/index.d.ts

@@ -0,0 +1,3 @@
+export { generateInitialDomainYaml } from './generate-initial-domain-yaml.js';
+export { generateInitialMdx } from './generate-initial-mdx.js';
+export { generateInitialStoriesFile } from './generate-initial-stories-file.js';

package/dist/phoenix/story-scaffolding/templates/index.js

@@ -0,0 +1 @@
+export{generateInitialDomainYaml}from"./generate-initial-domain-yaml.js";export{generateInitialMdx}from"./generate-initial-mdx.js";export{generateInitialStoriesFile}from"./generate-initial-stories-file.js";

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

@@ -0,0 +1 @@
+export { startTui, type TuiHandle } from './tui-app.js';

package/dist/phoenix/tui/index.js

@@ -0,0 +1 @@
+export{startTui}from"./tui-app.js";

package/dist/phoenix/tui/tui-app.d.ts

@@ -0,0 +1,13 @@
+import { type LogBus } from '../services/log-bus.js';
+export interface AppProps {
+    readonly bus: LogBus;
+    readonly onQuit: () => void;
+}
+/** Exported for ink-testing-library tests; production entry is startTui. */
+export declare const App: ({ bus, onQuit }: AppProps) => import("react/jsx-runtime").JSX.Element;
+export interface TuiHandle {
+    readonly unmount: () => void;
+}
+export declare const startTui: (bus: LogBus, options: {
+    readonly onQuit: () => void;
+}) => TuiHandle;

package/dist/phoenix/tui/tui-app.js

@@ -0,0 +1 @@
+import{jsx as e,jsxs as l}from"react/jsx-runtime";import{Box as r,Text as o,render as t,useInput as n,useStdin as i,useStdout as s}from"ink";import{useEffect as a,useRef as c,useState as u}from"react";import{LOG_STREAMS as h}from"../services/log-bus.js";import{entriesBehind as m,nextUnusedStream as p,paneForColumn as d,scrollAnchor as b,visibleSlice as w}from"./view-model.js";let g={spec:"cyan",browser:"magenta",webhook:"yellow",vite:"green",other:"gray"},f={1:"spec",2:"browser",3:"webhook",4:"vite",5:"other"},x="\x1b[?1000l\x1b[?1006l",v=/\x1b\[<(\d+);(\d+);\d+[Mm]/g,y=e=>({rows:e.rows||30,columns:e.columns||100}),$=({entry:r,showTag:t})=>l(o,{wrap:"truncate-end",children:[l(o,{color:"gray",children:[new Date(r.time).toISOString().slice(11,19)," "]}),t&&e(o,{color:g[r.stream],children:`[${r.stream}] `.padEnd(10)}),e(o,{color:"error"===r.level?"red":"warn"===r.level?"yellow":"debug"===r.level||"detail"===r.level?"gray":void 0,children:r.text})]}),k=({entries:t,height:n,width:i,stream:s,focused:a,anchor:c})=>{let u=Math.max(n-1,1),h=m(t,c,u),p=g[s];return l(r,{flexDirection:"column",width:i,height:n,overflow:"hidden",children:[e(o,{color:a?void 0:p,backgroundColor:a?p:void 0,bold:!0,children:` ${a?"● ":""}${s}${null!==c?` — ↑ ${h} newer`:""} `}),w(t,c,u).map((l,r)=>e($,{entry:l,showTag:!1},r))]})},D=({bus:t,view:n})=>l(r,{gap:2,children:[e(o,{bold:!0,inverse:"all"===n,children:"[a]ll"}),h.map((e,r)=>l(o,{bold:n===e,inverse:n===e,color:g[e],children:["[",r+1,"] ",e," (",t.count(e),")"]},e)),e(o,{bold:!0,inverse:"split"===n,children:"[s]plit"})]});export const App=({bus:t,onQuit:h})=>{let[,g]=u(0),[M,S]=u("all"),[T,j]=u(null),[q,A]=u(["spec","webhook"]),[C,P]=u([null,null]),[z,N]=u(0),[O,Q]=u(!0),U=c(!1),{stdout:E}=s(),{stdin:I}=i(),[B,F]=u(()=>y(E)),G=e=>{S(e),j(null),P(e=>e.map(()=>null))};a(()=>{let e=null,l=t.subscribe(()=>{U.current||(U.current=!0,e=setTimeout(()=>{U.current=!1,g(e=>e+1)},64))});g(e=>e+1);let r=()=>F(y(E));return E.on("resize",r),()=>{l(),E.off("resize",r),e&&clearTimeout(e)}},[t,E]);let H=Math.max(B.rows-4,3),J=Math.max(H-1,1),K="all"===M?t.all():"split"===M?null:t.forStream(M),L=(e,l)=>{if("split"===M){let r=l??z,o=q[r];void 0!==o&&P(l=>l.map((l,n)=>n===r?b(t.forStream(o),l,J,e):l))}else K&&j(l=>b(K,l,H,e))},R=c(()=>{});R.current=(e,l)=>{L(e,"split"===M?d(l,B.columns,q.length):void 0)},a(()=>{E.write(O?"\x1b[?1000h\x1b[?1006h":x)},[O,E]),a(()=>{if(!I)return;let e=e=>{for(let l of String(e).matchAll(v)){let e=Number(l[1]),r=Number(l[2]);64===e?R.current(3,r):65===e&&R.current(-3,r)}};return I.on("data",e),()=>{I.off("data",e),E.write(x)}},[I,E]),n((e,l)=>{"q"===e||l.ctrl&&"c"===e?h():"a"===e?G("all"):"s"===e?G("split"):"split"===M&&"r"===e?(A(e=>e.map((l,r)=>r===z?p(e,l):l)),P(e=>e.map((e,l)=>l===z?null:e))):"split"===M&&"+"===e?q.length>=3||(A(e=>[...e,p(e,e[e.length-1])]),P(e=>[...e,null])):"split"===M&&"-"===e?q.length<=2||(A(e=>e.slice(0,-1)),P(e=>e.slice(0,-1)),N(e=>Math.min(e,q.length-2))):"split"===M&&l.tab?N(e=>(e+1)%q.length):f[e]?G(f[e]):"m"===e?Q(e=>!e):l.upArrow?L(1):l.downArrow?L(-1):l.pageUp?L(H-1):l.pageDown?L(-(H-1)):"f"===e&&(j(null),P(e=>e.map(()=>null)))});let V=K?m(K,T,H):0,W="split"!==M&&null!==T,X=`${Math.floor(100/q.length)}%`,Y="split"===M?`Tab focus \xb7 r stream \xb7 +/- panes \xb7 wheel scrolls pane under cursor \xb7 f follow \xb7 m mouse:${O?"on":"off"} \xb7 q quit`:`1-5 pages \xb7 a all \xb7 s split \xb7 wheel/↑↓/PgUp/PgDn scroll \xb7 f follow \xb7 m mouse:${O?"on":"off"} \xb7 q quit`;return l(r,{flexDirection:"column",width:B.columns,height:B.rows,children:["split"===M?e(r,{gap:1,height:H,children:q.map((l,r)=>e(k,{entries:t.forStream(l),height:H,width:X,stream:l,focused:z===r,anchor:C[r]??null},r))}):e(r,{flexDirection:"column",height:H,children:w(K??[],T,H).map((l,r)=>e($,{entry:l,showTag:"all"===M},r))}),e(D,{bus:t,view:M}),e(r,{children:W?e(o,{color:"black",backgroundColor:"yellow",children:` ↑ scrolled — ${V} newer lines below \xb7 ↓/PgDn newer \xb7 f follow `}):e(o,{color:"gray",children:Y})})]})};export const startTui=(l,r)=>{let o=t(e(App,{bus:l,onQuit:r.onQuit}),{patchConsole:!1,exitOnCtrlC:!1}),n=()=>{process.stdout.write(x)};return process.once("exit",n),{unmount:()=>{o.unmount(),n()}}};

package/dist/phoenix/tui/view-model.d.ts

@@ -0,0 +1,28 @@
+import { type LogEntry, type LogStream } from '../services/log-bus.js';
+/**
+ * Scrollback anchor for one log viewport: null follows the tail; otherwise the
+ * seq of the bottom visible entry, so the view holds its position while new
+ * entries keep streaming into the list.
+ */
+export type ScrollAnchor = number | null;
+/**
+ * Index of the bottom visible entry for the given anchor. A follow anchor pins
+ * the newest entry; an anchored view finds the last entry at or before the
+ * anchor, falling back to a full first page when the anchored region has been
+ * trimmed out of the buffer.
+ */
+export declare const bottomIndexFor: (list: readonly LogEntry[], anchor: ScrollAnchor, viewportLines: number) => number;
+/**
+ * Move the anchor by delta entries (positive scrolls towards older entries).
+ * Clamps so the viewport never scrolls past the oldest full page, and snaps
+ * back to follow mode when the bottom reaches the newest entry.
+ */
+export declare const scrollAnchor: (list: readonly LogEntry[], anchor: ScrollAnchor, viewportLines: number, delta: number) => ScrollAnchor;
+/** The viewport slice ending at the anchored bottom entry. */
+export declare const visibleSlice: (list: readonly LogEntry[], anchor: ScrollAnchor, viewportLines: number) => readonly LogEntry[];
+/** How many newer entries lie below the anchored viewport. */
+export declare const entriesBehind: (list: readonly LogEntry[], anchor: ScrollAnchor, viewportLines: number) => number;
+/** Which of paneCount equal-width panes a 1-based terminal column falls into. */
+export declare const paneForColumn: (column: number, columns: number, paneCount: number) => number;
+/** The next stream after `from` (cycling) that no pane shows yet; `from` when all are taken. */
+export declare const nextUnusedStream: (used: readonly LogStream[], from: LogStream) => LogStream;

package/dist/phoenix/tui/view-model.js

@@ -0,0 +1 @@
+import{LOG_STREAMS as t}from"../services/log-bus.js";export const bottomIndexFor=(t,e,n)=>{if(null===e)return t.length-1;for(let n=t.length-1;n>=0;n--)if(t[n].seq<=e)return n;return Math.min(n-1,t.length-1)};export const scrollAnchor=(t,e,n,r)=>{if(0===t.length)return null;let o=Math.min(Math.max(bottomIndexFor(t,e,n)-r,Math.min(n-1,t.length-1)),t.length-1);return o>=t.length-1?null:t[o].seq};export const visibleSlice=(t,e,n)=>{let r=bottomIndexFor(t,e,n);return t.slice(Math.max(0,r+1-n),r+1)};export const entriesBehind=(t,e,n)=>t.length-1-bottomIndexFor(t,e,n);export const paneForColumn=(t,e,n)=>Math.min(n-1,Math.max(0,Math.floor((t-1)/(e/n))));export const nextUnusedStream=(e,n)=>{let r=t.indexOf(n);for(let n=1;n<=t.length;n++){let o=t[(r+n)%t.length];if(!e.includes(o))return o}return n};

package/dist/phoenix/utils/ask-question.d.ts

@@ -0,0 +1 @@
+export declare const askQuestion: (question: string) => Promise<string>;

package/dist/phoenix/utils/ask-question.js

@@ -0,0 +1 @@
+import e from"readline";export const askQuestion=r=>{let t=e.createInterface({input:process.stdin,output:process.stdout});return new Promise((e,o)=>{let s=!1;t.on("close",()=>{s||o(Error("The prompt was cancelled before an answer was entered."))}),t.question(r,r=>{s=!0,t.close(),e(r.trim())})})};

package/dist/phoenix/utils/changelog-parser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Changelog parsing utilities for PHX CLI
+ */
+export interface ChangelogVersion {
+    readonly version: string;
+    readonly content: string;
+    readonly lineStart: number;
+    readonly lineEnd: number;
+}
+export interface PaginatedVersions {
+    readonly versions: readonly ChangelogVersion[];
+    readonly totalPages: number;
+    readonly hasMore: boolean;
+    readonly currentPage: number;
+}
+/**
+ * Parse changelog content into structured versions
+ */
+export declare const parseChangelog: (content: string) => readonly ChangelogVersion[];
+/**
+ * Get the latest (first) version from parsed changelog
+ */
+export declare const getLatestVersion: (versions: readonly ChangelogVersion[]) => ChangelogVersion | undefined;
+/**
+ * Get a specific version by version string
+ */
+export declare const getVersion: (versions: readonly ChangelogVersion[], version: string) => ChangelogVersion | undefined;
+/**
+ * Paginate versions with configurable page size
+ */
+export declare const paginateVersions: (versions: readonly ChangelogVersion[], page: number, pageSize?: number) => PaginatedVersions;
+/**
+ * Get all version numbers from changelog
+ */
+export declare const getVersionNumbers: (versions: readonly ChangelogVersion[]) => readonly string[];