@salsita-ai/sdk 0.50.0-develop.a4dde5f252 → 0.50.0-develop.a8cf9ffd01

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-runtime.d.ts

@@ -1,23 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.js';
-import { ComponentOptics } from '../sections/component-optic.js';
-import { type ExpressionImplementations, ExpressionRuntime, type MissingExpression } from '../sections/expression-runtime.js';
-import { PresetRuntime } from '../sections/preset-runtime.js';
-import { AdminModelRuntime } from './admin-model-runtime.js';
-import { AdminStatesRuntime } from './states-runtime.js';
-export type AdminRuntime = Branded<'AdminRuntime', {
-    readonly modelRuntime: AdminModelRuntime;
-    readonly componentOptics: ComponentOptics;
-    readonly expressionRuntime: ExpressionRuntime;
-    readonly presetRuntime: PresetRuntime;
-    readonly statesRuntime: AdminStatesRuntime;
-}>;
-export type AdminRuntimeResult = {
-    readonly ok: true;
-    readonly runtime: AdminRuntime;
-} | {
-    readonly ok: false;
-    readonly missingExpressions: readonly MissingExpression[];
-};
-export declare const AdminRuntime: (spec: ApplicationSpec, referenceStore: RuntimeReferenceStore, implementations?: ExpressionImplementations) => AdminRuntimeResult;

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-runtime.js

@@ -1 +0,0 @@
-import{Branded as e}from"@salsita-ai/common/utils";import{Preset as t,PresetCategory as i,commonAdminCustomExpressions as r,commonAdminViolationExpressions as s}from"#package/domain";import{ComponentOptics as n}from"../sections/component-optic.js";import{ExpressionRuntime as m}from"../sections/expression-runtime.js";import{PresetRuntime as o}from"../sections/preset-runtime.js";import{AdminModelRuntime as a}from"./admin-model-runtime.js";import{AdminStatesRuntime as p}from"./states-runtime.js";let c={Preset:[{evaluate:(e,i,r)=>{let n=r.domain.get$Entity(e,i);return t.assert(n),s.Preset.nameNotEmpty(n)}}]},u={PresetCategory:{$isDraft:{origin:{name:"$isDraft",typeOrAlias:"PresetCategory"},evaluate:(e,t,s)=>{let n=s.domain.get$Entity(e,t);return i.assert(n),r.PresetCategory.$isDraft(n)},meta:{}}}};export const AdminRuntime=(t,i,r={})=>{let s={...u};for(let[e,t]of Object.entries(r))s[e]={...s[e],...t};let f=a(t.admin,t.configurator.dataSchemas,i),d=m(t.admin,i,s,"adminExpressionRuntime",c);return d.ok?{ok:!0,runtime:e({modelRuntime:f,componentOptics:n(i,{components:t.admin.components,referenceScope:"adminRuntime/componentOptics",modelRuntime:f}),expressionRuntime:d.runtime,presetRuntime:o(i,{referenceScope:"adminRuntime/presetRuntime",presets:t.admin.presets.presets}),statesRuntime:p(t,i)})}:{ok:!1,missingExpressions:d.missing}};

package/dist/application-spec/generate-application/runtime/admin-runtime/states-runtime.d.ts

@@ -1,8 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.js';
-export type AdminStatesRuntime = Branded<'AdminStatesRuntime', {
-    readonly navigationStates: readonly string[];
-    readonly changed: boolean;
-}>;
-export declare const AdminStatesRuntime: (spec: ApplicationSpec, referenceStore: RuntimeReferenceStore) => AdminStatesRuntime;

package/dist/application-spec/generate-application/runtime/application-runtime.d.ts

@@ -1,35 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { ImportedTransformer } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../caching/index.js';
-import type { ApplicationSpec } from '../../parse-application-files/index.js';
-import { AdminRuntime } from './admin-runtime/admin-runtime.js';
-import { ConfiguratorRuntime } from './configurator-runtime/configurator-runtime.js';
-import { DataRuntime } from './sections/data-runtime.js';
-import type { ExpressionImplementations, InvariantImplementations, MissingExpression } from './sections/expression-runtime.js';
-type AnyImportedTransformer = ImportedTransformer<any, any, any, any, any, any, any>;
-/**
- * Runtime objects built from ApplicationSpec.
- * Domain-specific fields mirror ApplicationSpec configurator/admin nesting.
- */
-export type ApplicationRuntime = Branded<'ApplicationRuntime', {
-    readonly configurator: ConfiguratorRuntime;
-    readonly admin: AdminRuntime;
-    readonly data: DataRuntime;
-}>;
-export type ApplicationRuntimeResult = {
-    readonly ok: true;
-    readonly runtime: ApplicationRuntime;
-} | {
-    readonly ok: false;
-    readonly missingExpressions: readonly MissingExpression[];
-};
-/**
- * Builds an ApplicationRuntime from an ApplicationSpec.
- * A persistent RuntimeReferenceStore preserves per-item references and reports
- * section-level changes across rebuilds.
- * Each field on the result carries its own `changed` flag.
- *
- * Returns an error result when declared expressions are missing implementations.
- */
-export declare const ApplicationRuntime: (spec: ApplicationSpec, referenceStore: RuntimeReferenceStore, implementations: ExpressionImplementations, importedTransformers: readonly AnyImportedTransformer[], invariantImplementations?: InvariantImplementations, adminImplementations?: ExpressionImplementations) => ApplicationRuntimeResult;
-export {};

package/dist/application-spec/generate-application/runtime/application-runtime.js

@@ -1 +0,0 @@
-import{Branded as i}from"@salsita-ai/common/utils";import{AdminRuntime as r}from"./admin-runtime/admin-runtime.js";import{ConfiguratorRuntime as n}from"./configurator-runtime/configurator-runtime.js";import{DataRuntime as o}from"./sections/data-runtime.js";export const ApplicationRuntime=(s,t,m,e,u,a)=>{let p=n(s,t,m,e,u);if(!p.ok)return{ok:!1,missingExpressions:p.missingExpressions};let f=r(s,t,a);return f.ok?{ok:!0,runtime:i({configurator:p.runtime,admin:f.runtime,data:o(s,t)})}:{ok:!1,missingExpressions:f.missingExpressions}};

package/dist/application-spec/generate-application/runtime/configurator-runtime/configurator-model-runtime.d.ts

@@ -1,30 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import { type $DomainEntity, $DomainEntityReflection, DomainBuilder, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { DataSchemas, Expressions, ModelVersion, ResolvedVersions } from '../../../parse-application-files/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: DataSchemas;
-    readonly expressions: Expressions;
-    readonly latestModel: ModelVersion;
-    readonly resolvedVersions: ResolvedVersions;
-}
-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) => ConfiguratorModelRuntime;
-export {};

package/dist/application-spec/generate-application/runtime/configurator-runtime/configurator-model-runtime.js

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

package/dist/application-spec/generate-application/runtime/configurator-runtime/configurator-runtime.d.ts

@@ -1,34 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { ImportedTransformer } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.js';
-import { ActionsRuntime } from '../sections/actions-runtime.js';
-import { AssistantRuntime } from '../sections/assistant-runtime.js';
-import { ComponentOptics } from '../sections/component-optic.js';
-import { type ExpressionImplementations, ExpressionRuntime, type InvariantImplementations, type MissingExpression } from '../sections/expression-runtime.js';
-import { PresetRuntime } from '../sections/preset-runtime.js';
-import { ThemeRuntime } from '../sections/theme-runtime.js';
-import { TransformersRuntime } from '../sections/transformers-runtime.js';
-import { ConfiguratorModelRuntime } from './configurator-model-runtime.js';
-import { ConfiguratorStatesRuntime } from './states-runtime.js';
-type AnyImportedTransformer = ImportedTransformer<any, any, any, any, any, any, any>;
-export type ConfiguratorRuntime = Branded<'ConfiguratorRuntime', {
-    readonly modelRuntime: ConfiguratorModelRuntime;
-    readonly componentOptics: ComponentOptics;
-    readonly presetRuntime: PresetRuntime;
-    readonly statesRuntime: ConfiguratorStatesRuntime;
-    readonly expressionRuntime: ExpressionRuntime;
-    readonly themeRuntime: ThemeRuntime;
-    readonly transformersRuntime: TransformersRuntime;
-    readonly assistantRuntime: AssistantRuntime;
-    readonly actionsRuntime: ActionsRuntime;
-}>;
-export type ConfiguratorRuntimeResult = {
-    readonly ok: true;
-    readonly runtime: ConfiguratorRuntime;
-} | {
-    readonly ok: false;
-    readonly missingExpressions: readonly MissingExpression[];
-};
-export declare const ConfiguratorRuntime: (spec: ApplicationSpec, referenceStore: RuntimeReferenceStore, implementations: ExpressionImplementations, importedTransformers: readonly AnyImportedTransformer[], invariantImplementations?: InvariantImplementations) => ConfiguratorRuntimeResult;
-export {};

package/dist/application-spec/generate-application/runtime/configurator-runtime/configurator-runtime.js

@@ -1 +0,0 @@
-import{Branded as t}from"@salsita-ai/common/utils";import{ActionsRuntime as o}from"../sections/actions-runtime.js";import{AssistantRuntime as e}from"../sections/assistant-runtime.js";import{ComponentOptics as r}from"../sections/component-optic.js";import{ExpressionRuntime as s}from"../sections/expression-runtime.js";import{PresetRuntime as i}from"../sections/preset-runtime.js";import{ThemeRuntime as n}from"../sections/theme-runtime.js";import{TransformersRuntime as m}from"../sections/transformers-runtime.js";import{ConfiguratorModelRuntime as u}from"./configurator-model-runtime.js";import{ConfiguratorStatesRuntime as c}from"./states-runtime.js";export const ConfiguratorRuntime=(p,a,f,g,R)=>{let j=u(p.configurator,a),x=s(p.configurator,a,f,"configuratorExpressionRuntime",R);return x.ok?{ok:!0,runtime:t({modelRuntime:j,componentOptics:r(a,{components:p.configurator.components,referenceScope:"configuratorRuntime/componentOptics",modelRuntime:j}),presetRuntime:i(a,{referenceScope:"configuratorRuntime/presetRuntime",presets:p.configurator.presets.presets}),statesRuntime:c(p,a),expressionRuntime:x.runtime,themeRuntime:n(p,a),transformersRuntime:m(p,a,g),assistantRuntime:e(p,a),actionsRuntime:o(p.configurator.actions,a)})}:{ok:!1,missingExpressions:x.missing}};

package/dist/application-spec/generate-application/runtime/configurator-runtime/states-runtime.d.ts

@@ -1,11 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.js';
-export type ConfiguratorStatesRuntime = Branded<'ConfiguratorStatesRuntime', {
-    readonly navigationStates: readonly string[];
-    readonly viewStates: readonly string[];
-    readonly toolStates: readonly string[];
-    readonly exportStates: readonly string[];
-    readonly changed: boolean;
-}>;
-export declare const ConfiguratorStatesRuntime: (spec: ApplicationSpec, referenceStore: RuntimeReferenceStore) => ConfiguratorStatesRuntime;

package/dist/application-spec/generate-application/runtime/generate-runtime-instance.d.ts

@@ -1,2 +0,0 @@
-import { ApplicationInstance } from '../../core/index.js';
-export declare const generateRuntimeInstance: (applicationInstance: ApplicationInstance) => ApplicationInstance;

package/dist/application-spec/generate-application/runtime/generate-runtime-instance.js

@@ -1 +0,0 @@
-import{ApplicationInstance as e}from"../../core/index.js";export const generateRuntimeInstance=n=>e(n.applicationVersion);

package/dist/application-spec/generate-application/runtime/sections/actions-runtime.d.ts

@@ -1,14 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { ActionDefinitions } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Actions } from '../../../parse-application-files/index.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/application-spec/generate-application/runtime/sections/assistant-runtime.d.ts

@@ -1,10 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { AssistantResolvedManifest } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.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: ApplicationSpec, referenceStore: RuntimeReferenceStore) => AssistantRuntime;

package/dist/application-spec/generate-application/runtime/sections/build-sdk-optic.d.ts

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

package/dist/application-spec/generate-application/runtime/sections/build-sdk-optic.js

@@ -1 +0,0 @@
-import{Branded as e}from"@salsita-ai/common/utils";import{DomainComponentOpticBuilder as t,adminSidebarComponent as a,attributeSelectionComponent as i,componentsByName as r,composedOfComponent as n,navigationPageComponent as o,navigationPanelListComponent as d,referenceComponent as c}from"#package/domain";import*as m from"#package/domain";import{FILTER_CRITERION_KEYS as s,isSdkCodeRef as l}from"../../../parse-application-files/spec/index.js";let g=new Map([["reference",c],["composedOf",n],["adminSidebar",a],["attributeSelection",i],["navigationPage",o],["navigationPanelList",d]]),p={createAdminCustomPageRead:m.createAdminCustomPageRead,createAdminCustomSidebarRead:m.createAdminCustomSidebarRead,createAdminDataPageRead:m.createAdminDataPageRead,createAdminDataTableSidebarRead:m.createAdminDataTableSidebarRead,createAdminNavigationPanelRead:m.createAdminNavigationPanelRead,createAdminPresetCategoryPageRead:m.createAdminPresetCategoryPageRead,createAdminPresetCategorySelectionRead:m.createAdminPresetCategorySelectionRead,createAdminPresetCategorySelectionWrite:m.createAdminPresetCategorySelectionWrite,createAdminPresetCategorySidebarRead:m.createAdminPresetCategorySidebarRead,createAdminPresetListPageRead:m.createAdminPresetListPageRead,createAdminPresetSidebarRead:m.createAdminPresetSidebarRead,createAdminRecipeCollectionPageRead:m.createAdminRecipeCollectionPageRead,createAdminRecipeSidebarRead:m.createAdminRecipeSidebarRead},R=(e,t)=>{let a=p[e.sdkFunction]??m[e.sdkFunction];if("function"!=typeof a)throw Error(`SDK factory function "${e.sdkFunction}" not found. Make sure it is exported from the package.`);return a(...e.params.map(e=>{if(l(e)){let a=t.entities[e.$codeRef]??t.aliasReflections[e.$codeRef];if(!a)throw Error(`Reflection "${e.$codeRef}" not found in ModelRuntime. This is a bug — the target was validated at parse time.`);return a}return e}))};export const buildSdkOptic=(a,i,n,o)=>{let d=t.from(n),c=r.get(a.componentName)??g.get(a.componentName);if(!c)throw Error(`SDK component "${a.componentName}" not found. This is a bug — the component was validated at parse time.`);let m=d.withComponent(c,a.instanceName,!0),l=a.isAlias?m.withAlias(String(a.typeOrAlias)):m.withEntity(String(a.typeOrAlias));for(let e of i.filters.items){if("root"===e.kind){let t=e.target,a=e=>e[t];l=l.withFilter(a);continue}let t={};for(let a of s){let i=e[a];void 0!==i&&("dynamic"===i.kind?t[a]=e=>e[i.target]:"eval"===i.kind?t[a]=Function("self",`return (${i.code})`):t[a]=i.value)}l=l.withGradualFilter(t)}let p=R(i.readFactory,o),f=R(i.writeFactory,o),A=l.attach(p,f);return e({typeOrAlias:String(a.typeOrAlias),componentName:a.componentName,instanceName:String(a.instanceName),optic:A})};

package/dist/application-spec/generate-application/runtime/sections/build-user-bound-optic.d.ts

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

package/dist/application-spec/generate-application/runtime/sections/build-user-bound-optic.js

@@ -1 +0,0 @@
-import{match as e}from"ts-pattern";import{Branded as t}from"@salsita-ai/common/utils";import{DomainComponentOpticBuilder as i,assertBoolean as n,assertNumber as r,assertString as o,componentsByName as a}from"#package/domain";import{generateMemoEvalPlanRuntime as s}from"./generate-memo-eval-plan-runtime.js";let l=e=>{if("dynamic"===e.kind){let t=e.target;return e=>e[t]}return"eval"===e.kind?Function("self",`return (${e.code})`):e.value},d=e=>{let t={};for(let[i,n]of Object.entries(e))"kind"!==i&&void 0!==n&&(t[i]=l(n));return t},m={assertString:o,assertNumber:r,assertBoolean:n},p=(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},c=(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},f=(t,i,n)=>e(t).with({kind:"primitive"},({assertFn:e})=>typeof i==("assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string")).with({kind:"declaredType"},({typeName:e})=>p(e,n).is(i)).with({kind:"declaredTypeId"},({referencedType:e})=>c(e,n).isId(i)).with({kind:"literal"},({value:e})=>i===e).with({kind:"anyOf"},({assertions:e})=>e.some(e=>f(e,i,n))).with({kind:"none"},()=>!0).exhaustive(),h=(t,i,n)=>{e(t).with({kind:"primitive"},({assertFn:e})=>{m[e](i)}).with({kind:"declaredType"},({typeName:e})=>{p(e,n).assert(i)}).with({kind:"declaredTypeId"},({referencedType:e})=>{c(e,n).assertId(i)}).with({kind:"literal"},e=>{if(!f(e,i,n))throw Error(`Expected value to match its declared schema but got ${i}`)}).with({kind:"anyOf"},e=>{if(!f(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,n,r)=>{let o,l=(o=r.aliases,i.from(o)),m=a.get(e.componentName);if(!m)return void console.warn(`[ComponentOptic] Unknown component: ${e.componentName}`);let p=l.withComponent(m,e.instanceName,!0),c=e.isAlias?p.withAlias(String(e.typeOrAlias)):p.withEntity(String(e.typeOrAlias));for(let e of n.filters.items){if("root"===e.kind){let t=e.target,i=e=>e[t];c=c.withFilter(i);continue}c=c.withGradualFilter(d(e))}let f=s(n.plan),u="composite"===n.implementation.kind?n.implementation.writeBindings:[],w=u.length>0?e=>{let t={};for(let i of u)h(i.assertion,e[i.propKey],r),t[i.entityField]=e[i.propKey];return t}:()=>({}),y=c.attach(f,w);return t({typeOrAlias:String(e.typeOrAlias),componentName:e.componentName,instanceName:String(e.instanceName),optic:y})};

package/dist/application-spec/generate-application/runtime/sections/component-optic.d.ts

@@ -1,32 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import { type DomainComponentOptic, type SystemComponentTypeConstraint } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ComponentEntry } from '../../../parse-application-files/spec/index.js';
-import type { AdminModelRuntime } from '../admin-runtime/admin-model-runtime.js';
-import type { ConfiguratorModelRuntime } from '../configurator-runtime/configurator-model-runtime.js';
-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;
-}>;
-/** 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;
-}
-/**
- * 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/application-spec/generate-application/runtime/sections/component-optic.js

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

package/dist/application-spec/generate-application/runtime/sections/data-runtime.d.ts

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

package/dist/application-spec/generate-application/runtime/sections/expression-runtime.d.ts

@@ -1,46 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { DomainEntity, Expression as DomainExpression, Invariant as DomainInvariant } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Expressions, ModelVersion } from '../../../parse-application-files/index.js';
-type RuntimeData = Record<string, unknown>;
-type RuntimeEntity = DomainEntity<string>;
-type AnyExpression = DomainExpression<RuntimeEntity, RuntimeEntity, RuntimeData, RuntimeData, RuntimeData, RuntimeEntity, unknown>;
-type SdkInvariant = DomainInvariant<RuntimeEntity, RuntimeEntity, RuntimeData, RuntimeData, RuntimeData, RuntimeEntity, string>;
-/**
- * Flat, entity-keyed expression map stored in the runtime spec slice and derived into the
- * memoized table returned by `DomainContextSelectors.getDomainExpressions()`.
- */
-export type ExpressionImplementations = Record<DomainEntity<string>['type'], Record<string, AnyExpression>>;
-/** Invariant implementations keyed by their concrete entity type or alias declaration. */
-export type InvariantImplementations = Readonly<Record<string, readonly SdkInvariant[]>>;
-export type MissingExpression = {
-    readonly entityType: string;
-    readonly exprName: string;
-};
-export type ExpressionRuntime = Branded<'ExpressionRuntime', {
-    readonly merged: ExpressionImplementations;
-    readonly changed: boolean;
-}>;
-export type ExpressionRuntimeResult = {
-    readonly ok: true;
-    readonly runtime: ExpressionRuntime;
-} | {
-    readonly ok: false;
-    readonly missing: readonly MissingExpression[];
-};
-interface ExpressionRuntimeSpec {
-    readonly expressions: Expressions;
-    readonly latestModel: ModelVersion;
-}
-/**
- * Runtime section that produces the single merged expression map for the registry.
- *
- * Dispatches on `expression.implementation.kind`:
- * - `relation` / `violations` — calls the matching SDK factory with params + runtime context
- * - `user` — uses the dynamically imported impl from `src/expressions/*.ts`
- * - `value` — evaluates the parsed {@link MemoEvalPlan}; stabilized per
- *   {@link canonicalEnhancedJsonValueKey} so identical values reuse the same
- *   evaluator across rebuilds.
- */
-export declare const ExpressionRuntime: (spec: ExpressionRuntimeSpec, referenceStore: RuntimeReferenceStore, implementations: ExpressionImplementations, referenceScopePrefix: string, invariantImplementations?: InvariantImplementations) => ExpressionRuntimeResult;
-export {};

package/dist/application-spec/generate-application/runtime/sections/expression-runtime.js

@@ -1 +0,0 @@
-import e from"lodash-es/isEqual.js";import{Branded as t}from"@salsita-ai/common/utils";import{createRelationFactory as i}from"#package/domain";import{canonicalEnhancedJsonValueKey as a}from"../../../core/index.js";import{isSdkExpressionImplementation as n}from"../../../parse-application-files/spec/index.js";import{generateMemoEvalPlanRuntime as r}from"./generate-memo-eval-plan-runtime.js";let l={},o={relation:(e,t)=>i(e.aliasMap)(t[0]),violations:(e,t)=>{let i=t[0];if("object"!=typeof i||null===i||!("entityType"in i)||"string"!=typeof i.entityType)throw Error("Cannot create the violations expression because its entityType parameter is missing. The application spec is inconsistent; rebuild it from a valid invariants declaration.");let a=i.entityType,n=Object.entries(e.invariantImplementations).flatMap(([t,i])=>{let n=e.aliasMap[t];return t===a||n?.includes(a)?i:[]});return{origin:{name:"$violations",typeOrAlias:a},evaluate:(e,t,i)=>n.flatMap(a=>a.evaluate(e,t,i)),meta:{}}}},s=e=>{let t=r(e.plan);return{origin:{name:e.name,typeOrAlias:e.entityOrAlias},evaluate:(e,i,a)=>t(a.domain.get$Entity(e,i),i,a),meta:{}}},p=e=>({...(0,o[e.kind])({aliasMap:e.aliasMap,invariantImplementations:e.invariantImplementations},e.params),origin:{name:e.name,typeOrAlias:e.entityOrAlias}});export const ExpressionRuntime=(i,r,o,m,u=l)=>{let d={};for(let[e,t]of i.latestModel.aliases)d[String(e)]=t.map(String);let f=r.createBuilder(`${m}/sdk`,{build:p,getKey:e=>`sdk::${e.entityOrAlias}::${e.name}`,compare:(t,i)=>t.kind===i.kind&&e(t.params,i.params)&&e(t.aliasMap,i.aliasMap)&&("violations"!==i.kind||t.invariantImplementations===i.invariantImplementations)}),y=r.createBuilder(`${m}/user`,{build:e=>e.impl,getKey:e=>`user::${e.entityType}::${e.name}`,compare:(e,t)=>e.impl===t.impl}),g=r.createBuilder(`${m}/value`,{build:s,getKey:e=>`value::${e.entityOrAlias}::${e.name}`,compare:(e,t)=>e.valueKey===t.valueKey}),c={},v=!1,S=new Set,b=new Set,k=new Set;for(let[e,t]of i.expressions.expressions)for(let[,i]of t){let t=d[String(e)]??[String(e)];if(n(i.implementation)){let a={entityOrAlias:String(e),name:String(i.name),kind:i.implementation.kind,params:i.implementation.params,aliasMap:d,invariantImplementations:u},n=f.build(a);for(let e of(n.changed&&(v=!0),S.add(f.getKey(a)),t))c[e]||(c[e]={}),c[e][String(i.name)]=n.output;continue}if("value"===i.implementation.kind){let n=i.implementation.value,r={entityOrAlias:String(e),name:String(i.name),valueKey:a(n),plan:i.implementation.plan},l=g.build(r);for(let e of(l.changed&&(v=!0),k.add(g.getKey(r)),t))c[e]||(c[e]={}),c[e][String(i.name)]=l.output;continue}}for(let[e,t]of Object.entries(o))for(let[i,a]of Object.entries(t)){let t={entityType:e,name:i,impl:a},n=y.build(t);n.changed&&(v=!0),b.add(y.getKey(t)),c[e]||(c[e]={}),c[e][i]=n.output}f.cleanup(S)&&(v=!0),y.cleanup(b)&&(v=!0),g.cleanup(k)&&(v=!0);let x=[];for(let[e,t]of i.expressions.entityExpressions)for(let a of t.shapeGroups){let t=i.expressions.expressions.get(a);if(t)for(let[i]of t)c[String(e)]?.[String(i)]||x.push({entityType:String(e),exprName:String(i)})}return x.length>0?{ok:!1,missing:x}:{ok:!0,runtime:t({merged:c,changed:v})}};

package/dist/application-spec/generate-application/runtime/sections/generate-memo-eval-plan-runtime.d.ts

@@ -1,29 +0,0 @@
-import type { SelfAccessor } from '../../../core/index.js';
-import type { MemoEvalPlan } from '../../../parse-application-files/spec/index.js';
-/**
- * Runtime counterpart to
- * {@link ../../code/templates/domain-spec/generate-memo-eval-plan-code#generateMemoEvalPlanCode | generateMemoEvalPlanCode}.
- * Produces a `(self) => value` reader function that evaluates each dep against
- * `self` and splices the resulting values into the plan's template tree:
- *
- * - Static (no deps): evaluates the template once and returns a `() => cached`
- *   thunk — no allocation per call. (Codegen emits a zero-dep `memoEval` for the
- *   same case so contextual typing reaches the body; the stability contract is
- *   identical.)
- * - With deps: wraps the per-dep resolution in `memoEval` so equal dep arrays
- *   short-circuit to the cached body, matching codegen semantics exactly.
- *
- * Each `$eval` dep is compiled with `new Function('self', 'return (<code>)')`;
- * each `$target` dep reads `self[target]` verbatim. `$msg` markers inside the
- * template lower to `{ id?, message }` descriptors for i18n consumers.
- */
-type MemoEvalPlanRuntimeReader = (self: SelfAccessor, state?: unknown, ctx?: unknown) => unknown;
-export declare const generateMemoEvalPlanRuntime: (plan: MemoEvalPlan) => MemoEvalPlanRuntimeReader;
-/**
- * Runtime counterpart to
- * {@link ../../code/templates/domain-spec/generate-static-value-code#generateStaticValueCode | generateStaticValueCode}:
- * evaluates a self-free plan once to the plain value a module-level constant holds. Plans that read
- * `self` need an entity instance and are rejected.
- */
-export declare const evaluateStaticMemoEvalPlan: (plan: MemoEvalPlan) => unknown;
-export {};

package/dist/application-spec/generate-application/runtime/sections/generate-memo-eval-plan-runtime.js

@@ -1 +0,0 @@
-import{memoEval as e}from"#package/domain";import{createMessageDescriptor as t}from"../../../core/index.js";let r=(e,a)=>{if("literal"===e.kind)return e.value;if("slot"===e.kind)return a[e.depIndex];if("msg"===e.kind)return t(e.marker);if("array"===e.kind)return e.items.map(e=>r(e,a));let n={};for(let[t,l]of e.entries)n[t]=r(l,a);return n};export const generateMemoEvalPlanRuntime=t=>{if(0===t.deps.length){let e=r(t.template,[]);return()=>e}let a=t.deps.map(e=>{if("eval"===e.kind)return Function("self",`return (${e.code})`)});return e(e=>t.deps.map((t,r)=>"eval"===t.kind?a[r](e):Reflect.get(e,t.target)),(...e)=>r(t.template,e))};export const evaluateStaticMemoEvalPlan=e=>{if(e.usesSelf)throw Error("Cannot evaluate a plan that uses self as a static value. Filter self-dependent plans before evaluating constants.");let t=e.deps.map(e=>{if("read"===e.kind)throw Error(`Cannot evaluate the self-dependent read "${e.target}" as a static value. Filter self-dependent plans before evaluating constants.`);return Function(`return (${e.code})`)()});return r(e.template,t)};

package/dist/application-spec/generate-application/runtime/sections/index.d.ts

@@ -1,10 +0,0 @@
-export { ActionsRuntime } from './actions-runtime.js';
-export { AssistantRuntime } from './assistant-runtime.js';
-export { ComponentOptics, type ComponentOptic } from './component-optic.js';
-export { DataRuntime } from './data-runtime.js';
-export { ExpressionRuntime, type ExpressionImplementations, type InvariantImplementations, type MissingExpression, } from './expression-runtime.js';
-export { PresetRuntime } from './preset-runtime.js';
-export { ThemeRuntime } from './theme-runtime.js';
-export { TransformersRuntime } from './transformers-runtime.js';
-export { evaluateStaticMemoEvalPlan, generateMemoEvalPlanRuntime } from './generate-memo-eval-plan-runtime.js';
-export { evaluateReflectionConstants, findReflectionConstants } from './reflection-constants-runtime.js';

package/dist/application-spec/generate-application/runtime/sections/index.js

@@ -1 +0,0 @@
-export{ActionsRuntime}from"./actions-runtime.js";export{AssistantRuntime}from"./assistant-runtime.js";export{ComponentOptics}from"./component-optic.js";export{DataRuntime}from"./data-runtime.js";export{ExpressionRuntime}from"./expression-runtime.js";export{PresetRuntime}from"./preset-runtime.js";export{ThemeRuntime}from"./theme-runtime.js";export{TransformersRuntime}from"./transformers-runtime.js";export{evaluateStaticMemoEvalPlan,generateMemoEvalPlanRuntime}from"./generate-memo-eval-plan-runtime.js";export{evaluateReflectionConstants,findReflectionConstants}from"./reflection-constants-runtime.js";

package/dist/application-spec/generate-application/runtime/sections/preset-runtime.d.ts

@@ -1,20 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { DomainEntity, ProductPreset } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Preset } from '../../../parse-application-files/index.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 Preset[];
-}
-/**
- * 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/application-spec/generate-application/runtime/sections/reflection-constants-runtime.d.ts

@@ -1,8 +0,0 @@
-import type { ExpressionName, Expressions, MemoEvalPlan } from '../../../parse-application-files/index.js';
-/** The self-free `constants:` plans declared on one entity or alias, or `undefined` when it has none. */
-export declare const findReflectionConstants: (expressions: Expressions, entityOrAlias: string) => ReadonlyMap<ExpressionName, MemoEvalPlan> | undefined;
-/**
- * Runtime counterpart of the constants literal codegen passes to an enhanced reflection: the
- * entity's or alias's self-free `constants:` values evaluated once to plain values, keyed by name.
- */
-export declare const evaluateReflectionConstants: (expressions: Expressions, entityOrAlias: string) => Readonly<Record<string, unknown>>;

package/dist/application-spec/generate-application/runtime/sections/reflection-constants-runtime.js

@@ -1 +0,0 @@
-import{evaluateStaticMemoEvalPlan as t}from"./generate-memo-eval-plan-runtime.js";export const findReflectionConstants=(t,n)=>{for(let[e,o]of t.constants)if(String(e)===n)return o};export const evaluateReflectionConstants=(n,e)=>{let o=findReflectionConstants(n,e);return o?Object.fromEntries([...o].map(([n,e])=>[String(n),t(e)])):{}};

package/dist/application-spec/generate-application/runtime/sections/theme-runtime.d.ts

@@ -1,10 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.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: ApplicationSpec, referenceStore: RuntimeReferenceStore) => ThemeRuntime;

package/dist/application-spec/generate-application/runtime/sections/transformers-runtime.d.ts

@@ -1,21 +0,0 @@
-import { Branded } from '@salsita-ai/common/utils';
-import type { ImportedTransformer } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ApplicationSpec } from '../../../parse-application-files/index.js';
-type AnyImportedTransformer = ImportedTransformer<any, any, any, any, any, any, any>;
-/**
- * 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 AnyImportedTransformer[];
-    readonly specTransformers: ApplicationSpec['configurator']['transformers'];
-    readonly changed: boolean;
-}>;
-export declare const TransformersRuntime: (spec: ApplicationSpec, referenceStore: RuntimeReferenceStore, importedTransformers: readonly AnyImportedTransformer[]) => TransformersRuntime;
-export {};

package/dist/application-spec/parse-application-files/spec/components/component-entry.d.ts

@@ -1,98 +0,0 @@
-import type { Branded } from '@salsita-ai/common/utils';
-import type { MemoEvalPlan, MemoEvalPlanInput } from '../expressions/memo-eval-plan.js';
-import type { EntityOrAliasName, InstanceName } from '../model/index.js';
-import type { ComponentReadBinding, ComponentWriteBinding } from './bindings/index.js';
-import type { ComponentFilters } from './component-filter.js';
-/**
- * Root-level `$read` variant — the entire instance state is driven by a single
- * `$read` at the root (components.md §"Root-Level $read"). No `resolvedProps`
- * tree, no write bindings; the single validated `readBinding` carries the
- * target name and codegen emits `.attach(self => self.${readBinding.target}, …)`
- * without `memoEval`.
- */
-export interface RootReadImplementation {
-    readonly kind: 'rootRead';
-    readonly readBinding: ComponentReadBinding;
-}
-/**
- * Composite variant — per-property reads with optional writes. `resolvedProps`
- * is the instance props tree with `$read`/`$bind` lowered to
- * {@link ComponentPropTarget} structs; each entry in `readBindings` corresponds
- * to one target referenced from the tree. Codegen walks the tree and emits
- * `memoEval(self => [deps], (…params) => body)` when the tree has no inline
- * code, or `self => (body)` when it does. `writeBindings` carry per-prop write
- * targets — only valid on this variant (root-read never has writes).
- */
-export interface CompositeImplementation {
-    readonly kind: 'composite';
-    readonly resolvedProps: Readonly<Record<string, MemoEvalPlanInput>>;
-    readonly readBindings: readonly ComponentReadBinding[];
-    readonly writeBindings: readonly ComponentWriteBinding[];
-}
-/**
- * User-bound component — filters apply uniformly, read/write behavior is
- * carried in the discriminated {@link RootReadImplementation} |
- * {@link CompositeImplementation} union under `implementation`.
- * Root-read instances cannot carry write bindings by construction.
- *
- * `plan` is the shared {@link MemoEvalPlan} consumed by both codegen and
- * runtime to emit a `memoEval(…)` reader or a cached static reader. It
- * subsumes the old rootRead special case — a rootRead
- * instance is simply a plan with a single read dep + slot template.
- */
-interface UserBoundImplementation {
-    readonly kind: 'userBound';
-    readonly filters: ComponentFilters;
-    readonly plan: MemoEvalPlan;
-    readonly implementation: RootReadImplementation | CompositeImplementation;
-}
-/**
- * A parameter that should be emitted as an unquoted code reference in codegen
- * (e.g. an entity reflection variable like `Top`).
- * At runtime, the string value is resolved to the actual object (e.g. entity reflection).
- */
-export interface SdkCodeRef {
-    readonly $codeRef: string;
-}
-export declare const isSdkCodeRef: (value: unknown) => value is SdkCodeRef;
-export type SdkFactoryParam = SdkCodeRef | string | number | boolean | null | readonly SdkFactoryParam[] | {
-    readonly [key: string]: SdkFactoryParam;
-};
-/**
- * An SDK factory call — codegen emits the function name with params inlined,
- * runtime calls the function with resolved params (e.g. entity reflections).
- */
-export interface SdkFactory {
-    /** SDK function name to import and call (e.g. "createSingleReferenceRead"). */
-    readonly sdkFunction: string;
-    /** Positional params — string/number are quoted, SdkCodeRef emitted as variable references. */
-    readonly params: readonly SdkFactoryParam[];
-}
-/**
- * SDK-provided component — generic factory-based attachment.
- * The SDK provides read + write factory functions; codegen imports and calls them with params.
- * The component type itself comes from `ComponentEntry.componentName`.
- * Used for relation-derived components (reference, composition) and extensible for future SDK types.
- */
-interface SdkImplementation {
-    readonly kind: 'sdk';
-    readonly filters: ComponentFilters;
-    /** Factory that produces the read function for `.attach(readFn, writeFn)`. */
-    readonly readFactory: SdkFactory;
-    /** Factory that produces the write function for `.attach(readFn, writeFn)`. */
-    readonly writeFactory: SdkFactory;
-}
-/** Discriminated union — each variant carries the concrete typed params its builder needs. */
-export type ComponentImplementation = UserBoundImplementation | SdkImplementation;
-/**
- * A single component attachment on the domain spec.
- * Shared structure for user-declared and SDK-provided (relation-derived) components.
- */
-export type ComponentEntry = Branded<'ComponentEntry', {
-    readonly typeOrAlias: EntityOrAliasName;
-    readonly instanceName: InstanceName;
-    readonly isAlias: boolean;
-    readonly componentName: string;
-    readonly implementation: ComponentImplementation;
-}>;
-export {};