@salsita-ai/sdk 0.50.0-develop.b5468d6828 → 0.50.0-develop.b5d443db78

package/dist/domain/spec/runtime/model/configurator-model-runtime.d.ts

@@ -0,0 +1,33 @@
+import { Branded } from '@salsita-ai/common/utils';
+import { type $DomainEntity, $DomainEntityReflection, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '../../../core/index.js';
+import { DomainBuilder } from '../../../domain-builder/index.js';
+import type { Expressions } from '../../expressions/index.js';
+import type { RuntimeDataSchemas, RuntimeModelVersion, RuntimeResolvedVersions } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+import type { SpecCodeMap } from '../spec-code/index.js';
+type AnyEntity = DomainEntity<string>;
+type AnyAliases = Record<string, AnyEntity>;
+type AnyData = Record<string, unknown>;
+type Any$Map = Record<AnyEntity['type'], $DomainEntity<AnyEntity>>;
+type AnyDomainBuilder = DomainBuilder<AnyEntity, AnyEntity, AnyAliases, Any$Map, AnyData, AnyData, AnyData>;
+interface ConfiguratorModelRuntimeSpec {
+    readonly dataSchemas: RuntimeDataSchemas;
+    readonly expressions: Expressions;
+    readonly latestModel: RuntimeModelVersion;
+    readonly resolvedVersions: RuntimeResolvedVersions;
+}
+interface ConfiguratorModelRuntimeFields {
+    readonly entities: Record<string, DomainEntityReflection<AnyEntity>>;
+    readonly aliasReflections: Record<string, RawAliasReflection<AnyEntity>>;
+    readonly commonTypeReflections: Record<string, SchemaReflection<unknown>>;
+    readonly aliases: Record<string, readonly string[]>;
+    readonly $entityReflections: Record<string, $DomainEntityReflection<$DomainEntity<AnyEntity>>>;
+    readonly rootEntityTypes: readonly string[];
+    readonly modelVersion: number;
+    readonly domainBuilder: AnyDomainBuilder;
+    readonly schemaChanged: boolean;
+}
+export type ConfiguratorModelRuntime = Branded<'ConfiguratorModelRuntime', ConfiguratorModelRuntimeFields>;
+export declare const isConfiguratorModelSchemaCompatible: (prev: ConfiguratorModelRuntimeSpec, curr: ConfiguratorModelRuntimeSpec) => boolean;
+export declare const ConfiguratorModelRuntime: (domainSpec: ConfiguratorModelRuntimeSpec, referenceStore: RuntimeReferenceStore, code: SpecCodeMap | undefined) => ConfiguratorModelRuntime;
+export {};

package/dist/domain/spec/runtime/model/configurator-model-runtime.js

@@ -0,0 +1 @@
+import e from"lodash-es/isEqual.js";import{Branded as t}from"@salsita-ai/common/utils";import{$DomainEntityReflection as s,DomainEntityReflection as o,RawAliasReflection as i,SchemaReflection as n}from"../../../core/index.js";import{DomainBuilder as r}from"../../../domain-builder/index.js";import{evaluateReflectionConstants as a,findReflectionConstants as m}from"../expressions/index.js";let l=e=>({latestVersion:e.resolvedVersions.latestVersion,versionedModels:e.resolvedVersions.versionedModels.map(e=>({version:e.version,key:e.key,isLatest:e.isLatest,migrationFile:e.migrationFile}))}),p=e=>{let t=[];for(let[s,o]of e.expressions.entityExpressions)t.push({entityType:String(s),shapeGroups:o.shapeGroups.map(String),expressionNamesByGroup:o.shapeGroups.map(t=>{let s=e.expressions.expressions.get(t);return{group:String(t),names:s?[...s.keys()].map(String):[]}}),constants:[...m(e.expressions,String(s))??[]].map(([e,t])=>[String(e),t])});return t};export const isConfiguratorModelSchemaCompatible=(t,s)=>e(t.latestModel.entitySchemas.map(e=>e.shapeSchema),s.latestModel.entitySchemas.map(e=>e.shapeSchema))&&e([...t.latestModel.aliases],[...s.latestModel.aliases])&&e([...t.latestModel.commonTypes],[...s.latestModel.commonTypes])&&e(l(t),l(s))&&e(p(t),p(s))&&e(t.dataSchemas,s.dataSchemas);let d=e=>{let{latestModel:t,resolvedVersions:m,dataSchemas:l,expressions:p}=e.domainSpec,d={};for(let e of t.entitySchemas)d[String(e.entityType)]=new o(String(e.entityType),[e.shapeSchema]);let c={};for(let[e,s]of t.commonTypes){let t=s.runtimeSchema;c[String(e)]=new n(String(e),t)}let S=[...t.aliases],u={},g={};for(let[e,t]of S){let s=t.map(e=>d[String(e)]),o=new i(String(e),s);u[String(e)]=o,g[String(e)]=o.types}let h={};for(let o of t.entityTypes){let t=String(o),i=p.entityExpressions.get(o),n=[];if(i)for(let e of i.shapeGroups){let t=p.expressions.get(e);t&&n.push(...t.keys())}h[t]=new s(t,n,a(p,t,e.code))}let y=S.map(([e])=>String(e)).includes("RootEntity")?"RootEntity":"AnyDomainEntity",f=u[y]?.types??[],x=m.latestVersion,M=l.publishedData.runtimeSchema,b=l.sessionData.runtimeSchema,T=l.frontendData.runtimeSchema,v=l.backendData?.runtimeSchema,C=r.from(d,g,h,f,x,M,b,T,v,!1);return{entities:d,aliasReflections:u,commonTypeReflections:c,aliases:g,$entityReflections:h,rootEntityTypes:f,modelVersion:x,domainBuilder:C}};export const ConfiguratorModelRuntime=(e,s,o)=>{let i=s.createBuilder("modelRuntime:configurator",{build:d,getKey:()=>"singleton",compare:(e,t)=>e.code===t.code&&isConfiguratorModelSchemaCompatible(e.domainSpec,t.domainSpec)}).build({domainSpec:e,code:o});return t({...i.output,schemaChanged:i.changed})};

package/dist/domain/spec/runtime/model/index.d.ts

@@ -0,0 +1,2 @@
+export { AdminModelRuntime } from './admin-model-runtime.js';
+export { ConfiguratorModelRuntime, isConfiguratorModelSchemaCompatible } from './configurator-model-runtime.js';

package/dist/domain/spec/runtime/model/index.js

@@ -0,0 +1 @@
+export{AdminModelRuntime}from"./admin-model-runtime.js";export{ConfiguratorModelRuntime,isConfiguratorModelSchemaCompatible}from"./configurator-model-runtime.js";

package/dist/domain/spec/runtime/optics/build-sdk-optic.d.ts

@@ -0,0 +1,7 @@
+import { type ComponentEntry, type ComponentImplementation } from '../../components/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime } from '../model/index.js';
+import { type SpecCodeMap } from '../spec-code/index.js';
+import type { ComponentOptic } from './built-component-optic.js';
+export declare const buildSdkOptic: (entry: ComponentEntry, impl: ComponentImplementation & {
+    readonly kind: 'sdk';
+}, aliasMap: Record<string, readonly string[]>, configuratorModel: AdminModelRuntime | ConfiguratorModelRuntime, code: SpecCodeMap | undefined) => ComponentOptic;

package/dist/domain/spec/runtime/optics/build-sdk-optic.js

@@ -0,0 +1 @@
+import{Branded as t}from"@salsita-ai/common/utils";import{createAdminCustomPageRead as e,createAdminCustomSidebarRead as o,createAdminDataPageRead as i,createAdminDataTableSidebarRead as n,createAdminNavigationPanelRead as a,createAdminPresetCategoryPageRead as r,createAdminPresetCategorySelectionRead as s,createAdminPresetCategorySelectionWrite as m,createAdminPresetCategorySidebarRead as c,createAdminPresetListPageRead as p,createAdminPresetSidebarRead as d,createAdminRecipeCollectionPageRead as l,createAdminRecipeSidebarRead as f}from"../../../application/index.js";import{componentsByName as u}from"../../../available-system-components/index.js";import{DomainComponentOpticBuilder as h,composedOfComponent as g,createEmptyWrite as y,createMultipleCompositionRead as w,createMultipleReferenceRead as S,createMultipleReferenceWrite as N,createSingleCompositionRead as v,createSingleReferenceRead as x,createSingleReferenceWrite as A,referenceComponent as b}from"../../../core/index.js";import{adminSidebarComponent as j,attributeSelectionComponent as k,navigationPageComponent as O,navigationPanelListComponent as F}from"../../../system-components/index.js";import{FILTER_CRITERION_KEYS as R,isSdkCodeRef as $}from"../../components/index.js";import{specCodeComponentKey as E,specCodeFilterId as T}from"../../runtime-spec/index.js";import{resolveSpecCode as D}from"../spec-code/index.js";let K=new Map([["reference",b],["composedOf",g],["adminSidebar",j],["attributeSelection",k],["navigationPage",O],["navigationPanelList",F]]),M={createAdminCustomPageRead:e,createAdminCustomSidebarRead:o,createAdminDataPageRead:i,createAdminDataTableSidebarRead:n,createAdminNavigationPanelRead:a,createAdminPresetCategoryPageRead:r,createAdminPresetCategorySelectionRead:s,createAdminPresetCategorySelectionWrite:m,createAdminPresetCategorySidebarRead:c,createAdminPresetListPageRead:p,createAdminPresetSidebarRead:d,createAdminRecipeCollectionPageRead:l,createAdminRecipeSidebarRead:f,createEmptyWrite:y,createMultipleCompositionRead:w,createMultipleReferenceRead:S,createMultipleReferenceWrite:N,createSingleCompositionRead:v,createSingleReferenceRead:x,createSingleReferenceWrite:A},P=(t,e)=>{let o=M[t.sdkFunction];if("function"!=typeof o)throw Error(`SDK factory function "${t.sdkFunction}" not found. The spec names a factory that the factory map of build-sdk-optic.ts does not list. Add the factory to that map.`);return o(...t.params.map(t=>{if($(t)){let o=e.entities[t.$codeRef]??e.aliasReflections[t.$codeRef];if(!o)throw Error(`Reflection "${t.$codeRef}" not found in ModelRuntime. This is a bug — the target was validated at parse time.`);return o}return t}))};export const buildSdkOptic=(e,o,i,n,a)=>{let r=h.from(i),s=u.get(e.componentName)??K.get(e.componentName);if(!s)throw Error(`SDK component "${e.componentName}" not found. This is a bug — the component was validated at parse time.`);let m=r.withComponent(s,e.instanceName,!0),c=e.isAlias?m.withAlias(String(e.typeOrAlias)):m.withEntity(String(e.typeOrAlias)),p=E(String(e.typeOrAlias),String(e.instanceName),e.componentName);for(let[t,e]of o.filters.items.entries()){if("root"===e.kind){let t=e.target,o=e=>e[t];c=c.withFilter(o);continue}let o={};for(let i of R){let n=e[i];void 0!==n&&("dynamic"===n.kind?o[i]=t=>t[n.target]:"eval"===n.kind?o[i]=D(a,T(p,t,i,n.code),n.code):o[i]=n.value)}c=c.withGradualFilter(o)}let d=P(o.readFactory,n),l=P(o.writeFactory,n),f=c.attach(d,l);return t({typeOrAlias:String(e.typeOrAlias),componentName:e.componentName,instanceName:String(e.instanceName),optic:f})};

package/dist/domain/spec/runtime/optics/build-user-bound-optic.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentEntry, ComponentImplementation } from '../../components/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime } from '../model/index.js';
+import { type SpecCodeMap } from '../spec-code/index.js';
+import type { ComponentOptic } from './built-component-optic.js';
+export declare const buildUserBoundOptic: (entry: ComponentEntry, impl: ComponentImplementation & {
+    readonly kind: 'userBound';
+}, model: AdminModelRuntime | ConfiguratorModelRuntime, code: SpecCodeMap | undefined) => ComponentOptic | undefined;

package/dist/domain/spec/runtime/optics/build-user-bound-optic.js

@@ -0,0 +1 @@
+import{match as e}from"ts-pattern";import{Branded as t}from"@salsita-ai/common/utils";import{componentsByName as i}from"../../../available-system-components/index.js";import{DomainComponentOpticBuilder as n,assertBoolean as r,assertNumber as o,assertString as a}from"../../../core/index.js";import{specCodeComponentKey as s,specCodeFilterId as l}from"../../runtime-spec/index.js";import{generateMemoEvalPlanRuntime as m}from"../expressions/index.js";import{resolveSpecCode as d}from"../spec-code/index.js";let p=(e,t,i)=>{if("dynamic"===e.kind){let t=e.target;return e=>e[t]}if("eval"===e.kind){let n=l(i.componentKey,i.branch,t,e.code);return d(i.code,n,e.code)}return e.value},c=(e,t)=>{let i={};for(let[n,r]of Object.entries(e))"kind"!==n&&void 0!==r&&(i[n]=p(r,n,t));return i},f={assertString:a,assertNumber:o,assertBoolean:r},h=(e,t)=>{let i=t.commonTypeReflections[e]??t.entities[e]??t.aliasReflections[e];if(!i)throw Error(`Reflection "${e}" not found in ModelRuntime for write assertion. This is a bug — the type was resolved at parse time.`);return i},u=(e,t)=>{let i=t.entities[e]??t.aliasReflections[e];if(!i)throw Error(`Entity reflection "${e}" not found in ModelRuntime for write assertion. This is a bug — the type was resolved at parse time.`);return i},w=(t,i,n)=>e(t).with({kind:"primitive"},({assertFn:e})=>typeof i==("assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string")).with({kind:"declaredType"},({typeName:e})=>h(e,n).is(i)).with({kind:"declaredTypeId"},({referencedType:e})=>u(e,n).isId(i)).with({kind:"literal"},({value:e})=>i===e).with({kind:"anyOf"},({assertions:e})=>e.some(e=>w(e,i,n))).with({kind:"none"},()=>!0).exhaustive(),y=(t,i,n)=>{e(t).with({kind:"primitive"},({assertFn:e})=>{f[e](i)}).with({kind:"declaredType"},({typeName:e})=>{h(e,n).assert(i)}).with({kind:"declaredTypeId"},({referencedType:e})=>{u(e,n).assertId(i)}).with({kind:"literal"},e=>{if(!w(e,i,n))throw Error(`Expected value to match its declared schema but got ${i}`)}).with({kind:"anyOf"},e=>{if(!w(e,i,n))throw Error(`Expected value to match one of its declared schemas but got ${i}`)}).with({kind:"none"},()=>{}).exhaustive()};export const buildUserBoundOptic=(e,r,o,a)=>{let l,d=(l=o.aliases,n.from(l)),p=i.get(e.componentName);if(!p)return void console.warn(`[ComponentOptic] Unknown component: ${e.componentName}`);let f=d.withComponent(p,e.instanceName,!0),h=e.isAlias?f.withAlias(String(e.typeOrAlias)):f.withEntity(String(e.typeOrAlias)),u=s(String(e.typeOrAlias),String(e.instanceName),e.componentName);for(let[e,t]of r.filters.items.entries()){if("root"===t.kind){let e=t.target,i=t=>t[e];h=h.withFilter(i);continue}h=h.withGradualFilter(c(t,{componentKey:u,branch:e,code:a}))}let w=m(r.plan,u,a),k="composite"===r.implementation.kind?r.implementation.writeBindings:[],g=k.length>0?e=>{let t={};for(let i of k)y(i.assertion,e[i.propKey],o),t[i.entityField]=e[i.propKey];return t}:()=>({}),v=h.attach(w,g);return t({typeOrAlias:String(e.typeOrAlias),componentName:e.componentName,instanceName:String(e.instanceName),optic:v})};

package/dist/domain/spec/runtime/optics/built-component-optic.d.ts

@@ -0,0 +1,11 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { DomainComponentOptic, SystemComponentTypeConstraint } from '../../../core/index.js';
+/** A component optic of any project, for any component type. */
+export type AnyComponentOptic = DomainComponentOptic<any, any, any, any, any, any, SystemComponentTypeConstraint>;
+/** A single built component optic with its identifying metadata. */
+export type ComponentOptic = Branded<'ComponentOptic', {
+    readonly typeOrAlias: string;
+    readonly componentName: string;
+    readonly instanceName: string;
+    readonly optic: AnyComponentOptic;
+}>;

package/dist/domain/spec/runtime/optics/built-component-optic.js

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

package/dist/domain/spec/runtime/optics/component-optic.d.ts

@@ -0,0 +1,26 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ComponentEntry } from '../../components/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime } from '../model/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+import type { SpecCodeMap } from '../spec-code/index.js';
+import type { ComponentOptic } from './built-component-optic.js';
+/** Collection of built component optics with change tracking. */
+export type ComponentOptics = Branded<'ComponentOptics', {
+    readonly optics: readonly ComponentOptic[];
+    readonly changed: boolean;
+}>;
+interface ComponentOpticsProps {
+    readonly referenceScope: string;
+    readonly components: readonly ComponentEntry[];
+    readonly modelRuntime: AdminModelRuntime | ConfiguratorModelRuntime;
+    /** The domain's map of the generated code module, which holds the entries' `$eval` code. */
+    readonly code: SpecCodeMap | undefined;
+}
+/**
+ * Builds component optics from the unified ComponentEntry[] on ApplicationSpec.
+ * Dispatches on `entry.implementation.kind` — userBound (YAML) or sdk (factory-based).
+ * Uses RuntimeReferenceStore to preserve each optic reference by
+ * `typeOrAlias::componentName::instanceName`.
+ */
+export declare const ComponentOptics: (referenceStore: RuntimeReferenceStore, props: ComponentOpticsProps) => ComponentOptics;
+export {};

package/dist/domain/spec/runtime/optics/component-optic.js

@@ -0,0 +1 @@
+import e from"lodash-es/isEqual.js";import{match as t}from"ts-pattern";import{Branded as o}from"@salsita-ai/common/utils";import{buildSdkOptic as i}from"./build-sdk-optic.js";import{buildUserBoundOptic as n}from"./build-user-bound-optic.js";export const ComponentOptics=(t,i)=>{let n=t.createBuilder(i.referenceScope,{build:({entry:e,modelRuntime:t,code:o})=>m(e,t,o),getKey:({entry:e})=>`${e.implementation.kind}::${e.typeOrAlias}::${e.componentName}::${e.instanceName}`,compare:(t,o)=>t.modelRuntime.domainBuilder===o.modelRuntime.domainBuilder&&t.code===o.code&&e(t.entry.implementation,o.entry.implementation)}),d=[],r=new Set,l=!1;for(let e of i.components){let t={entry:e,modelRuntime:i.modelRuntime,code:i.code},o=n.build(t);o.output&&d.push(o.output),r.add(n.getKey(t)),o.changed&&(l=!0)}return n.cleanup(r)&&(l=!0),o({optics:d,changed:l})};let m=(e,o,m)=>t(e.implementation).with({kind:"userBound"},t=>n(e,t,o,m)).with({kind:"sdk"},t=>i(e,t,o.aliases,o,m)).exhaustive();

package/dist/domain/spec/runtime/optics/index.d.ts

@@ -0,0 +1,2 @@
+export type { ComponentOptic } from './built-component-optic.js';
+export { ComponentOptics } from './component-optic.js';

package/dist/domain/spec/runtime/optics/index.js

@@ -0,0 +1 @@
+export{ComponentOptics}from"./component-optic.js";

package/dist/domain/spec/runtime/runtime-reference-store.d.ts

@@ -0,0 +1,46 @@
+interface BuilderOptions<T, R> {
+    readonly build: (input: T) => R;
+    readonly getKey: (input: T) => string;
+    readonly compare: (previous: T, current: T) => boolean;
+}
+/**
+ * A scoped builder that stabilizes the outputs for one application-spec concern.
+ * Builds individual items, reusing the previous output when its input is equivalent.
+ * Call `cleanup()` after processing all items to remove references that are no longer active.
+ */
+export interface ScopedBuilder<T, R> {
+    /** Build or retrieve a stable item. Returns the output and whether its reference changed. */
+    readonly build: (input: T) => {
+        readonly output: R;
+        readonly changed: boolean;
+    };
+    /** Remove references for keys not in the provided set. Returns true if any were removed. */
+    readonly cleanup: (activeKeys: ReadonlySet<string>) => boolean;
+    /** Extract the store key for an input (same function as provided in options). */
+    readonly getKey: (input: T) => string;
+}
+/**
+ * Preserves generated object references between sequential application-spec builds.
+ * Each named scope owns the previous inputs and outputs for one parsing or runtime concern.
+ * Equivalent inputs reuse the previous output reference; changed inputs replace it and report
+ * `changed: true` so consumers can reconcile only the affected runtime registrations.
+ *
+ * Thread one `RuntimeReferenceStore` through the full parse and runtime-generation pipeline.
+ * The store is stateful pipeline infrastructure, not an optional performance cache.
+ */
+export declare class RuntimeReferenceStore {
+    private readonly scopes;
+    /**
+     * Creates a builder for one reference-stability scope.
+     * Calling with the same scope name returns a builder backed by the same stored references.
+     *
+     * @param scope - Unique scope name (for example `componentOptics` or `transformers`)
+     * @param options.build - Builds a single output from an input
+     * @param options.getKey - Extracts the stable identity of an input within the scope
+     * @param options.compare - Returns true when the previous output reference can be reused
+     */
+    createBuilder<T, R>(scope: string, options: BuilderOptions<T, R>): ScopedBuilder<T, R>;
+    /** Clears all stored references. Use when the pipeline must force a complete rebuild. */
+    clear(): void;
+}
+export {};

package/dist/domain/spec/runtime/runtime-reference-store.js

@@ -0,0 +1 @@
+export class RuntimeReferenceStore{scopes=new Map;createBuilder(e,t){let{build:s,getKey:r,compare:l}=t;this.scopes.has(e)||this.scopes.set(e,new Map);let u=this.scopes.get(e);return{build:e=>{let t=r(e),c=u.get(t);if(c&&l(c.input,e))return{output:c.output,changed:!1};let o=s(e);return u.set(t,{input:e,output:o}),{output:o,changed:!0}},cleanup:e=>{let t=!1;for(let s of u.keys())e.has(s)||(u.delete(s),t=!0);return t},getKey:r}}clear(){for(let e of this.scopes.values())e.clear()}}

package/dist/domain/spec/runtime/sections/actions-runtime.d.ts

@@ -0,0 +1,14 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ActionDefinitions } from '../../../core/index.js';
+import type { Actions } from '../../sections/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+/**
+ * The declared actions as the runtime spec slice holds them, with change tracking: the definitions
+ * are rebuilt only when their declaration changes, so a hot reload of an unrelated section keeps
+ * the action system's compiled validators.
+ */
+export type ActionsRuntime = Branded<'ActionsRuntime', {
+    readonly definitions: ActionDefinitions;
+    readonly changed: boolean;
+}>;
+export declare const ActionsRuntime: (actions: Actions, referenceStore: RuntimeReferenceStore) => ActionsRuntime;

package/dist/domain/spec/runtime/sections/assistant-runtime.d.ts

@@ -0,0 +1,10 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { AssistantResolvedManifest } from '../../sections/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+/** Resolved assistant manifest with change tracking, carried to the runtime spec on hot reload. */
+export type AssistantRuntime = Branded<'AssistantRuntime', {
+    readonly assistant: AssistantResolvedManifest | null;
+    readonly changed: boolean;
+}>;
+export declare const AssistantRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore) => AssistantRuntime;

package/dist/domain/spec/runtime/sections/data-runtime.d.ts

@@ -0,0 +1,13 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+type ParsedDataSpecEntries = RuntimeSpec['dataSpec']['entries'];
+type ParsedChunks = RuntimeSpec['dataSpec']['chunks'];
+export type DataRuntime = Branded<'DataRuntime', {
+    readonly dataSpec: ParsedDataSpecEntries;
+    readonly chunks: ParsedChunks;
+    readonly publishedDataHash: string;
+    readonly changed: boolean;
+}>;
+export declare const DataRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore) => DataRuntime;
+export {};

package/dist/domain/spec/runtime/sections/index.d.ts

@@ -0,0 +1,6 @@
+export { ActionsRuntime } from './actions-runtime.js';
+export { AssistantRuntime } from './assistant-runtime.js';
+export { DataRuntime } from './data-runtime.js';
+export { PresetRuntime } from './preset-runtime.js';
+export { ThemeRuntime } from './theme-runtime.js';
+export { TransformersRuntime } from './transformers-runtime.js';

package/dist/domain/spec/runtime/sections/index.js

@@ -0,0 +1 @@
+export{ActionsRuntime}from"./actions-runtime.js";export{AssistantRuntime}from"./assistant-runtime.js";export{DataRuntime}from"./data-runtime.js";export{PresetRuntime}from"./preset-runtime.js";export{ThemeRuntime}from"./theme-runtime.js";export{TransformersRuntime}from"./transformers-runtime.js";

package/dist/domain/spec/runtime/sections/preset-runtime.d.ts

@@ -0,0 +1,20 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { DomainEntity, ProductPreset } from '../../../core/index.js';
+import type { SpecPreset } from '../../model/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+type AnyProductPreset = ProductPreset<DomainEntity<string>, DomainEntity<string>>;
+/** Collection of runtime presets with change tracking. */
+export type PresetRuntime = Branded<'PresetRuntime', {
+    readonly presets: readonly AnyProductPreset[];
+    readonly changed: boolean;
+}>;
+interface PresetRuntimeProps {
+    readonly referenceScope: string;
+    readonly presets: readonly SpecPreset[];
+}
+/**
+ * Builds preset runtime objects with per-item reference stability.
+ * Unchanged presets reuse previous references across rebuilds.
+ */
+export declare const PresetRuntime: (referenceStore: RuntimeReferenceStore, props: PresetRuntimeProps) => PresetRuntime;
+export {};

package/dist/domain/spec/runtime/sections/theme-runtime.d.ts

@@ -0,0 +1,10 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+/** Resolved theme spec with change tracking — no UI deps, just preset + options. */
+export type ThemeRuntime = Branded<'ThemeRuntime', {
+    readonly preset: string;
+    readonly options: Readonly<Record<string, unknown>>;
+    readonly changed: boolean;
+}>;
+export declare const ThemeRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore) => ThemeRuntime;

package/dist/domain/spec/runtime/sections/transformers-runtime.d.ts

@@ -0,0 +1,19 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ImportedTransformer } from '../../../application/index.js';
+import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+/**
+ * Runtime section for transformers. Combines two sources of truth:
+ * - `importedTransformers` — factory functions from src/transformers/*.ts
+ * - `spec.configurator.transformers` — the name/priority list from YAML
+ *
+ * The `changed` flag flips true when either the imported function identity OR
+ * the spec entry (name + priority) differs from the previous build. Used to
+ * decide whether to push a fresh `createTransformers` factory into the registry.
+ */
+export type TransformersRuntime = Branded<'TransformersRuntime', {
+    readonly importedTransformers: readonly ImportedTransformer[];
+    readonly specTransformers: RuntimeSpec['configurator']['transformers'];
+    readonly changed: boolean;
+}>;
+export declare const TransformersRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore, importedTransformers: readonly ImportedTransformer[]) => TransformersRuntime;

package/dist/domain/spec/runtime/spec-code/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './spec-code-module.js';
+export * from './resolve-spec-code.js';

package/dist/domain/spec/runtime/spec-code/index.js

@@ -0,0 +1 @@
+export*from"./resolve-spec-code.js";

package/dist/domain/spec/runtime/spec-code/resolve-spec-code.d.ts

@@ -0,0 +1,18 @@
+import type { SelfAccessor } from '../../enhanced-json/index.js';
+import type { SpecCodeId } from '../../runtime-spec/index.js';
+import type { SpecCodeMap } from './spec-code-module.js';
+/**
+ * A piece of YAML code ready to run: it takes the `$` view of the entity it runs on, or nothing when
+ * the code does not read `self` (a constant).
+ */
+export type ResolvedSpecCode = (self?: SelfAccessor) => unknown;
+/**
+ * The function for one piece of YAML code: the closure the generated code module holds under `id`,
+ * or the text compiled with `new Function` when there is no module (the editor, which rebuilds from
+ * YAML it has no generated module for) or the module has no such id.
+ *
+ * The module must come from the same generation as the spec. An id carries a hash of its code, so a
+ * module from another generation does not hold the ids of code that changed since: such code is
+ * compiled from the spec's text, never run from an old closure.
+ */
+export declare const resolveSpecCode: (code: SpecCodeMap | undefined, id: SpecCodeId, source: string) => ResolvedSpecCode;

package/dist/domain/spec/runtime/spec-code/resolve-spec-code.js

@@ -0,0 +1 @@
+export const resolveSpecCode=(e,o,r)=>{let t=e?.[o];return void 0!==t?t:Function("self",`return (${r})`)};

package/dist/domain/spec/runtime/spec-code/spec-code-module.d.ts

@@ -0,0 +1,17 @@
+import type { SpecCodeId } from '../../runtime-spec/index.js';
+/**
+ * One closure of the generated `.phoenix/spec-code.ts`. Each closure there is typed by the entity it
+ * runs on, so the map accepts any parameter type; the runtime calls every closure with the entity's
+ * `$` view, or with nothing when the code does not read `self`.
+ */
+export type SpecCode = (self: never) => unknown;
+/** The closures of one domain, keyed by spec code id. */
+export type SpecCodeMap = Readonly<Record<SpecCodeId, SpecCode>>;
+/**
+ * The generated `.phoenix/spec-code.ts` module: the code written in YAML, one map per domain. The
+ * runtime looks code up here by id and compiles the text only for an id the module does not hold.
+ */
+export interface SpecCodeModule {
+    readonly configurator: SpecCodeMap;
+    readonly admin: SpecCodeMap;
+}

package/dist/domain/spec/runtime/spec-code/spec-code-module.js

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

package/dist/domain/spec/runtime/spec-runtime.d.ts

@@ -0,0 +1,21 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { RuntimeSpec } from '../runtime-spec/index.js';
+import { AdminSpecRuntime } from './admin-runtime/index.js';
+import { ConfiguratorSpecRuntime } from './configurator-runtime/index.js';
+import type { RuntimeReferenceStore } from './runtime-reference-store.js';
+import type { SpecCodeModule } from './spec-code/index.js';
+/**
+ * The sections of both domains that the spec alone determines, without a project module: each
+ * domain's model and the data of its `phx.domain` factories.
+ *
+ * An application is built in two steps in one reference store. This is the first: it runs before
+ * the project's modules load, because they call the `phx.domain` factories while they are evaluated.
+ * The second, `ApplicationRuntime` with the loaded modules, builds the same sections through the
+ * same functions, so it returns the same objects: `phx.domain.model.X` is the reflection the
+ * application's domain validates with.
+ */
+export type SpecRuntime = Branded<'SpecRuntime', {
+    readonly configurator: ConfiguratorSpecRuntime;
+    readonly admin: AdminSpecRuntime;
+}>;
+export declare const SpecRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore, specCode: SpecCodeModule | undefined) => SpecRuntime;

package/dist/domain/spec/runtime/spec-runtime.js

@@ -0,0 +1 @@
+import{Branded as i}from"@salsita-ai/common/utils";import{AdminSpecRuntime as o}from"./admin-runtime/index.js";import{ConfiguratorSpecRuntime as r}from"./configurator-runtime/index.js";export const SpecRuntime=(m,n,t)=>i({configurator:r(m,n,t?.configurator),admin:o(m,n,t?.admin)});

package/dist/domain/spec/runtime-spec/decode-runtime-spec.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeSpec } from './runtime-spec.js';
+/**
+ * Reads the JSON text of `.phoenix/application-spec.json` back into the runtime spec that
+ * `encodeRuntimeSpec` wrote: one `JSON.parse`, then each listed array back into its Map or Set.
+ *
+ * Throws when the text is not a runtime spec artifact, or when it was written in another format
+ * version than this SDK reads; `phoenix sync` writes the artifact again in the right one.
+ */
+export declare const decodeRuntimeSpec: (text: string) => RuntimeSpec;

package/dist/domain/spec/runtime-spec/decode-runtime-spec.js

@@ -0,0 +1 @@
+import{RUNTIME_SPEC_FORMAT_VERSION as e}from"./encoded-runtime-spec.js";let t="Run `phoenix sync` to write it again with the SDK the project uses.",r=e=>"object"==typeof e&&null!==e,i=e=>Error(`Cannot read .phoenix/application-spec.json: its ${e.kind} at ${JSON.stringify(e.path)} is not where the file says it is, so the file was changed after it was written. ${t}`),o=(e,t)=>{let o=e,n="spec";for(let e of t.path)o=r(o)?o[n]:void 0,n=e;let s=r(o)?o[n]:void 0;if(!r(o)||!Array.isArray(s))throw i(t);o[n]="Map"===t.kind?new Map(s.map(e=>{if(!Array.isArray(e)||2!==e.length)throw i(t);return[e[0],e[1]]})):new Set(s)};export const decodeRuntimeSpec=i=>{let n=JSON.parse(i);if(!(r(n)&&"number"==typeof n.format&&Array.isArray(n.collections)&&"spec"in n))throw Error(`Cannot read .phoenix/application-spec.json: it is not a runtime spec written by \`phoenix sync\` or \`phoenix build\`. ${t}`);if(n.format!==e)throw Error(`Cannot read .phoenix/application-spec.json: it is written in format version ${n.format}, and this SDK reads format version ${e}, so it was written by another version of the SDK. ${t}`);let s={spec:n.spec};for(let e of n.collections)o(s,e);return s.spec};

package/dist/domain/spec/runtime-spec/encode-runtime-spec.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeSpec } from './runtime-spec.js';
+/**
+ * Writes a runtime spec as the JSON text of `.phoenix/application-spec.json`, which
+ * `decodeRuntimeSpec` reads back. Maps and Sets become arrays listed in `collections`, properties
+ * whose value is `undefined` are left out, and the document carries the format version. The text
+ * is the same for the same spec, so an unchanged spec leaves the file unchanged.
+ */
+export declare const encodeRuntimeSpec: (spec: RuntimeSpec) => string;

package/dist/domain/spec/runtime-spec/encode-runtime-spec.js

@@ -0,0 +1 @@
+import{RUNTIME_SPEC_FORMAT_VERSION as t}from"./encoded-runtime-spec.js";let e=(t,e)=>Error(`Cannot write .phoenix/application-spec.json: the parsed spec holds ${e} at ${JSON.stringify(t.path)}, which the runtime spec cannot hold. The runtime spec holds only plain data, Maps and Sets, so the parser produced a value it should not have. Report this to the Phoenix team with the YAML that declares this value.`),o=(t,e,o)=>{t.path.push(e);let n=r(t,o);return t.path.pop(),n},r=(t,r)=>{let n;if(null===r||"string"==typeof r||"boolean"==typeof r)return r;if("number"==typeof r){if(!Number.isFinite(r))throw e(t,`the number ${r}`);return r}if("object"!=typeof r)throw e(t,`a value of type ${typeof r}`);if(r instanceof Map){let e=[...r].map(([e,r],n)=>{t.path.push(n);let p=[o(t,0,e),o(t,1,r)];return t.path.pop(),p});return t.collections.push({kind:"Map",path:[...t.path]}),e}if(r instanceof Set){let e=[...r].map((e,r)=>o(t,r,e));return t.collections.push({kind:"Set",path:[...t.path]}),e}if(Array.isArray(r))return r.map((r,n)=>{if(void 0===r)throw e(t,`undefined as item ${n} of an array`);return o(t,n,r)});if((n=Object.getPrototypeOf(r))!==Object.prototype&&null!==n)throw e(t,`an instance of ${r.constructor.name}`);let p={};for(let[e,n]of Object.entries(r))void 0!==n&&(p[e]=o(t,e,n));return p};export const encodeRuntimeSpec=e=>{let o={path:[],collections:[]},n=r(o,e);return JSON.stringify({format:t,collections:o.collections,spec:n})};

package/dist/domain/spec/runtime-spec/encoded-runtime-spec.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The version of the JSON format `encodeRuntimeSpec` writes. Raise it with every change to the
+ * format or to the shape of `RuntimeSpec` once a released SDK has written the current version, so
+ * that `decodeRuntimeSpec` refuses an artifact an older or newer SDK wrote instead of building a
+ * runtime from data it does not understand.
+ */
+export declare const RUNTIME_SPEC_FORMAT_VERSION = 1;
+/** One step from a value into a part of it: an object key or an array index. */
+export type RuntimeSpecPathSegment = string | number;
+/**
+ * A Map or Set of the runtime spec, which JSON cannot hold: it is written as an array (a Map as its
+ * `[key, value]` entries), and `path` leads from the spec to that array. Paths into a Map run
+ * through its entries, so `[..., 2, 1]` is the value of its third entry.
+ */
+export interface EncodedCollection {
+    readonly kind: 'Map' | 'Set';
+    readonly path: readonly RuntimeSpecPathSegment[];
+}
+/**
+ * The JSON document of `.phoenix/application-spec.json`. `spec` is the runtime spec with every Map
+ * and Set written as an array, and `collections` lists those arrays, inner ones before the ones
+ * that hold them, so a decoder turns them back in that order without walking the whole spec.
+ */
+export interface EncodedRuntimeSpec {
+    readonly format: number;
+    readonly collections: readonly EncodedCollection[];
+    readonly spec: unknown;
+}

package/dist/domain/spec/runtime-spec/encoded-runtime-spec.js

@@ -0,0 +1 @@
+export const RUNTIME_SPEC_FORMAT_VERSION=1;

package/dist/domain/spec/runtime-spec/index.d.ts

@@ -0,0 +1,4 @@
+export { decodeRuntimeSpec } from './decode-runtime-spec.js';
+export { encodeRuntimeSpec } from './encode-runtime-spec.js';
+export { type RuntimeAdminSpec, type RuntimeAssistantSpec, type RuntimeConfiguratorSpec, type RuntimeDataSchemaEntry, type RuntimeDataSchemas, type RuntimeDataSpec, type RuntimeEntitySchema, type RuntimeInfra, type RuntimeLatestModelVersion, type RuntimeModelVersion, type RuntimeResolvedModelVersion, type RuntimeResolvedVersions, type RuntimeShapeSchema, type RuntimeSpec, toRuntimeSpec, } from './runtime-spec.js';
+export { type SpecCodeId, specCodeComponentKey, specCodeEvalIds, specCodeExpressionKey, specCodeFilterId, } from './spec-code-id.js';

package/dist/domain/spec/runtime-spec/index.js

@@ -0,0 +1 @@
+export{decodeRuntimeSpec}from"./decode-runtime-spec.js";export{encodeRuntimeSpec}from"./encode-runtime-spec.js";export{toRuntimeSpec}from"./runtime-spec.js";export{specCodeComponentKey,specCodeEvalIds,specCodeExpressionKey,specCodeFilterId}from"./spec-code-id.js";