@salsita-ai/sdk 0.50.0-develop.ed1806b910 → 0.50.0-develop.eeaf6c4605

package/dist/domain/spec/json-schema.js

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

package/dist/domain/spec/markers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './component-prop-target.js';
+export * from './eval-marker.js';
+export * from './msg-marker.js';

package/dist/domain/spec/markers/index.js

@@ -0,0 +1 @@
+export*from"./component-prop-target.js";export*from"./eval-marker.js";export*from"./msg-marker.js";

package/dist/domain/spec/markers/msg-marker.d.ts

@@ -0,0 +1,28 @@
+import type { MessageDescriptor } from '@lingui/core';
+import { z } from 'zod';
+/** Key literal for the `$msg` marker in raw YAML. */
+export declare const MSG_MARKER_KEY: '$msg';
+/** Key literal for the optional `$msgId` qualifier on `$msg`. */
+export declare const MSG_ID_MARKER_KEY: '$msgId';
+/**
+ * YAML marker produced by `$msg: 'text'` / `$msg: 'text', $msgId: 'id'` entries.
+ * `$msgId` is a qualifier on `$msg`, not a standalone marker.
+ */
+export interface MsgMarker {
+    readonly $msg: string;
+    readonly $msgId?: string;
+}
+/** Zod decoder for {@link MsgMarker}. Strict — rejects extra keys. */
+export declare const msgMarkerSchema: z.ZodObject<{
+    $msg: z.ZodString;
+    $msgId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    $msg: string;
+    $msgId?: string | undefined;
+}, {
+    $msg: string;
+    $msgId?: string | undefined;
+}>;
+/** Structural type guard for {@link MsgMarker}. */
+export declare const isMsgMarker: (value: unknown) => value is MsgMarker;
+export declare const createMessageDescriptor: (marker: MsgMarker) => MessageDescriptor;

package/dist/domain/spec/markers/msg-marker.js

@@ -0,0 +1 @@
+import{generateMessageId as s}from"@lingui/message-utils/generateMessageId";import{z as e}from"zod";export const MSG_MARKER_KEY="$msg";export const MSG_ID_MARKER_KEY="$msgId";export const msgMarkerSchema=e.object({$msg:e.string(),$msgId:e.string().optional()}).strict();export const isMsgMarker=s=>msgMarkerSchema.safeParse(s).success;export const createMessageDescriptor=e=>({id:e.$msgId??s(e.$msg),message:e.$msg});

package/dist/domain/spec/model/aliases.d.ts

@@ -0,0 +1,9 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { AliasName, EntityTypeName } from './names/index.js';
+/**
+ * Flattened alias map — each alias name maps to the concrete entity types it resolves to.
+ * Nested aliases (e.g. AllLegs → [SteelLegs, LegsOak] where SteelLegs is itself an alias)
+ * are fully resolved to leaf entity types. Includes the synthetic "AnyDomainEntity" alias
+ * that maps to all entity types in the version. `application-spec` exports it as `Aliases`.
+ */
+export type SpecAliases = Branded<'Aliases', ReadonlyMap<AliasName, readonly EntityTypeName[]>>;

package/dist/domain/spec/model/aliases.js

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

package/dist/domain/spec/model/common-types.d.ts

@@ -0,0 +1,15 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EnhancedJsonSchemaType } from '../../core/index.js';
+import type { JsonSchema } from '../json-schema.js';
+/** A single common type definition with both enhanced schema (for type inference) and resolved runtime schema. */
+export type CommonType = Branded<'CommonType', {
+    readonly name: string;
+    readonly schema: EnhancedJsonSchemaType;
+    readonly runtimeSchema: JsonSchema;
+}>;
+/**
+ * Branded map of common type name to CommonType.
+ * Entries are in topo-sorted order (dependencies before dependents),
+ * so iterating the map yields types in valid emission order.
+ */
+export type CommonTypes = Branded<'CommonTypes', ReadonlyMap<string, CommonType>>;

package/dist/domain/spec/model/common-types.js

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

package/dist/domain/spec/model/defaults.d.ts

@@ -0,0 +1,33 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EnhancedJsonValue } from '../enhanced-json/index.js';
+import type { EntityTypeName, ShapePropertyName } from './names/index.js';
+/**
+ * A map of shape property names to their default values inside a single entity block.
+ * Raw YAML values — markers intact — keyed by a validated {@link ShapePropertyName}.
+ * Codegen emits these as-is via `stringifyEnhancedJsonValue`; at run time
+ * `createRecipeFactory` makes the generated `createRecipe` factory from them.
+ */
+export type DefaultEntries = Readonly<Record<ShapePropertyName, EnhancedJsonValue>>;
+/**
+ * Validated defaults map — source keys confirmed to exist in `model.latest`,
+ * property names confirmed to exist on the (effective) shape of the entity
+ * or on every alias member's effective shape, values type-checked against the
+ * relaxed entity shape (all properties optional). Alias-keyed defaults are
+ * flattened here to concrete entity entries so downstream codegen only serialises
+ * a runtime-ready per-entity map.
+ *
+ * A source key may state part of a shape, but the flattened entry of a concrete
+ * entity type states every property of its shape: `createRecipeFactory` validates
+ * each entry as a whole entity when the generated module loads. An entity type
+ * with no entry has no defaults and is not checked.
+ *
+ * Values are raw `EnhancedJsonValue` so codegen can emit them via
+ * `stringifyEnhancedJsonValue` with `$msg` markers preserved.
+ *
+ * **Deprecated feature.** The whole defaults surface is retained for legacy parity.
+ * New specs should express initial values as `$data` entries. When the merged map is
+ * non-empty, the factory emits a `DEFAULTS_DEPRECATED` warning.
+ */
+export type Defaults = Branded<'Defaults', {
+    readonly entries: Readonly<Record<EntityTypeName, DefaultEntries>>;
+}>;

package/dist/domain/spec/model/defaults.js

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

package/dist/domain/spec/model/entity-types.d.ts

@@ -0,0 +1,8 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EntityTypeName } from './names/index.js';
+/**
+ * Validated list of entity type names declared in a model version (e.g. [Table, TopCircle, Legs3D]).
+ * Entity types are the concrete domain objects that can be instantiated in the configurator.
+ * Each name must be unique PascalCase.
+ */
+export type EntityTypes = Branded<'EntityTypes', readonly EntityTypeName[]>;

package/dist/domain/spec/model/entity-types.js

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

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

@@ -0,0 +1,7 @@
+export type * from './aliases.js';
+export type * from './common-types.js';
+export type * from './defaults.js';
+export type * from './entity-types.js';
+export type * from './model-version-key.js';
+export type * from './names/index.js';
+export type * from './presets.js';

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

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

package/dist/domain/spec/model/model-version-key.d.ts

@@ -0,0 +1,3 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** Branded string for a model version key ("latest", "v1", "v2", etc.). */
+export type ModelVersionKey = Branded<'ModelVersionKey', string>;

package/dist/domain/spec/model/model-version-key.js

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

package/dist/domain/spec/model/names/action-name.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded action name: camelCase without a prefix (e.g. "movePartBy", "swapCabinets"). An action is
+ * a named domain operation, so its name doubles as the key of its implementation and of its
+ * generated types.
+ */
+export type ActionName = Branded<'ActionName', string>;

package/dist/domain/spec/model/names/action-name.js

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

package/dist/domain/spec/model/names/alias-name.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded PascalCase alias name (e.g. "RootEntity", "AllLegs").
+ * Aliases group entity types so that shapes, expressions, and rules can target
+ * multiple entities at once. "RootEntity" is required in every model version.
+ */
+export type AliasName = Branded<'AliasName', string>;

package/dist/domain/spec/model/names/alias-name.js

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

package/dist/domain/spec/model/names/entity-or-alias-name.d.ts

@@ -0,0 +1,8 @@
+import type { AliasName } from './alias-name.js';
+import type { EntityTypeName } from './entity-type-name.js';
+/**
+ * A PascalCase name that identifies either a concrete entity type (e.g. "Table")
+ * or an alias group (e.g. "RootEntity"). Used as shape keys since shapes
+ * can be defined for both entity types and aliases.
+ */
+export type EntityOrAliasName = EntityTypeName | AliasName;

package/dist/domain/spec/model/names/entity-or-alias-name.js

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

package/dist/domain/spec/model/names/entity-type-name.d.ts

@@ -0,0 +1,8 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded PascalCase entity type name (e.g. "Table", "TopCircle", "Legs3D").
+ * Entity types are the concrete domain objects declared in a model version.
+ * Each entity type can have shapes, be referenced by aliases, and be instantiated
+ * in the configurator at runtime.
+ */
+export type EntityTypeName = Branded<'EntityTypeName', string>;

package/dist/domain/spec/model/names/entity-type-name.js

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

package/dist/domain/spec/model/names/expression-name.d.ts

@@ -0,0 +1,6 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded expression name starting with $ followed by camelCase (e.g. "$price", "$isValid", "$availableColors").
+ * Expressions are computed properties on entities — their names are prefixed with $ to distinguish them from shape properties.
+ */
+export type ExpressionName = Branded<'ExpressionName', string>;

package/dist/domain/spec/model/names/expression-name.js

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

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

@@ -0,0 +1,9 @@
+export type * from './action-name.js';
+export type * from './alias-name.js';
+export type * from './entity-or-alias-name.js';
+export type * from './entity-type-name.js';
+export type * from './expression-name.js';
+export type * from './instance-name.js';
+export type * from './invariant-name.js';
+export type * from './shape-property-name.js';
+export type * from './violation-type-name.js';

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

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

package/dist/domain/spec/model/names/instance-name.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded component instance name.
+ * User-declared names must start with a letter (e.g. "default", "body", "main").
+ * SDK-derived names may include `$` prefix and `.` separators (e.g. "$top", "Table.$top").
+ */
+export type InstanceName = Branded<'InstanceName', string>;

package/dist/domain/spec/model/names/instance-name.js

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

package/dist/domain/spec/model/names/invariant-name.d.ts

@@ -0,0 +1,3 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** A camelCase identifier for an invariant implementation declared in YAML. */
+export type InvariantName = Branded<'InvariantName', string>;

package/dist/domain/spec/model/names/invariant-name.js

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

package/dist/domain/spec/model/names/shape-property-name.d.ts

@@ -0,0 +1,11 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded shape property name — the key under which an entity shape (or
+ * alias shape) declares a field, and the key under which `defaults:` attaches
+ * initial values. Must match /^[a-z]\w*$/: start with a lowercase letter,
+ * then word characters (letters, digits, underscore).
+ *
+ * Examples: `height`, `positionX`, `hoodId`. Rejected: `Height`, `$height`,
+ * `3D`, `height-px`.
+ */
+export type ShapePropertyName = Branded<'ShapePropertyName', string>;

package/dist/domain/spec/model/names/shape-property-name.js

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

package/dist/domain/spec/model/names/violation-type-name.d.ts

@@ -0,0 +1,3 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** A stable violation discriminator returned by an invariant. */
+export type ViolationTypeName = Branded<'ViolationTypeName', string>;

package/dist/domain/spec/model/names/violation-type-name.js

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

package/dist/domain/spec/model/presets.d.ts

@@ -0,0 +1,30 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * A single entity within a preset — id, type, and shape properties.
+ * Properties are validated against the entity's schema from ConfigurationSchema.
+ */
+export type PresetEntity = Branded<'PresetEntity', {
+    readonly id: string;
+    readonly type: string;
+    readonly properties: Readonly<Record<string, unknown>>;
+}>;
+/**
+ * A single parsed preset — the root entity type, initial entities, and optional metadata.
+ * Represents one initial configuration state for a configurator deployment. `application-spec`
+ * exports it as `Preset`.
+ */
+export type SpecPreset = Branded<'Preset', {
+    readonly rootEntityType: string;
+    readonly initialDomainEntities: readonly PresetEntity[];
+    readonly name?: string;
+    readonly description?: string;
+    readonly img?: string;
+    readonly imgAlt?: string;
+    readonly detailTitle?: string;
+    readonly detailDescription?: string;
+    readonly tags?: readonly string[];
+}>;
+/** All parsed presets for a parsed configurator or admin model. */
+export type Presets = Branded<'Presets', {
+    readonly presets: readonly SpecPreset[];
+}>;

package/dist/domain/spec/model/presets.js

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

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/element-registration.d.ts

@@ -1,7 +1,7 @@
 import type { SvgIconProps } from '@mui/material';
 import type { PropsWithChildren, ReactNode } from 'react';
 import type { ExtendedJsonSchema } from '@salsita-ai/common/utils';
-import type { DomainEntityId } from '../../../core/index.js';
+import type { DomainEntityId } from '../../core/index.js';
 import { type ProjectModule } from './project-modules.js';
 export interface PhoenixEntityElementProps {
     entityId: DomainEntityId<string>;

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/find-assistant-form-element-errors.d.ts

@@ -1,4 +1,4 @@
-import { ImplementationError } from '../../errors/index.js';
+import { ImplementationError } from '../errors/index.js';
 import type { ElementRegistration } from './element-registration.js';
 /**
  * The mistakes in pairing the project's assistant form elements with their components: an element

package/dist/domain/spec/modules/find-assistant-form-element-errors.js

@@ -0,0 +1 @@
+import{ImplementationError as e}from"../errors/index.js";export const findAssistantFormElementErrors=(t,n)=>{let s=n.flatMap(e=>"assistantFormElement"===e.type?[e.name]:[]),r=new Set(t.map(({name:e})=>e));return[...t.flatMap(({name:t})=>{let n=s.filter(e=>e===t).length;return 0===n?[new e({code:"MISSING_IMPLEMENTATION",origin:null,problem:`The assistant form element "${t}" declared under assistant.formElements has no component`,fix:`Add a file to src/elements/ that default-exports phx.frontend.createAssistantFormElement('${t}', Component), or remove the element from the YAML.`})]:n>1?[new e({code:"DUPLICATE_DEFINITION",origin:null,problem:`The assistant form element "${t}" is registered by ${n} files in src/elements/`,fix:`Each element has one component. Keep one phx.frontend.createAssistantFormElement('${t}', …) and remove the others.`})]:[]}),...[...new Set(s)].filter(e=>!r.has(e)).map(t=>new e({code:"MISSING_IMPLEMENTATION",origin:null,problem:`A file in src/elements/ registers the assistant form element "${t}", which assistant.formElements does not declare`,fix:`Declare "${t}" under assistant.formElements with its description, role and attributes, so the assistant knows the element, or remove the registration.`}))]};

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/index.d.ts

@@ -1,10 +1,9 @@
 export { type PhoenixEntityElementProps, type PhoenixEntityElementRegistration, type PhoenixLayoutElementRegistration, type PhoenixIconRegistration, type AssistantFormElementRegistration, type ElementRegistration, type CustomPhoenixEntityElementProps, type PhoenixLayoutElementDefinition, type PhoenixEntityElementDefinition, type CreateCustomPhoenixLayoutElement, type CreateCustomPhoenixEntityElement, createPhoenixLayoutElement, createPhoenixEntityElement, createCustomPhoenixLayoutElement, createCustomPhoenixEntityElement, createAssistantFormElement, resolveElementModule, resolveElementModules, } from './element-registration.js';
-export { type PhoenixHandlerDefinition, type SystemPhoenixHandlerDefinition, type PhoenixHandlerRegistration, type SystemPhoenixHandlerRegistration, type SystemPhoenixAsyncHandlerDefinition, type SystemPhoenixAsyncHandlerRegistration, type HandlerRegistration, type CreatePhoenixHandler, createPhoenixHandler, createSystemPhoenixHandler, createSystemPhoenixAsyncHandler, resolveHandlerModule, resolveHandlerModules, } from './handler-registration.js';
 export { findAssistantFormElementErrors } from './find-assistant-form-element-errors.js';
-export { type ProjectModule } from './project-modules.js';
+export { type PhoenixHandlerDefinition, type SystemPhoenixHandlerDefinition, type PhoenixHandlerRegistration, type SystemPhoenixHandlerRegistration, type SystemPhoenixAsyncHandlerDefinition, type SystemPhoenixAsyncHandlerRegistration, type HandlerRegistration, type CreatePhoenixHandler, createPhoenixHandler, createSystemPhoenixHandler, createSystemPhoenixAsyncHandler, resolveHandlerModule, resolveHandlerModules, } from './handler-registration.js';
+export { type ProjectModule, type ProjectModuleContract, SHARED_FOLDER_HINT, createContractError, isRecord, } from './project-modules.js';
 export { resolveActionModules } from './resolve-action-modules.js';
 export { resolveComponentOpticModules } from './resolve-component-optic-modules.js';
 export { type ValuedExpressions, mergeExpressionModules } from './merge-expression-modules.js';
 export { type ExpressionModule, resolveExpressionModules } from './resolve-expression-modules.js';
-export { resolveImportedTransformers, resolveTransformerModule, resolveTransformerModules, } from './resolve-imported-transformers.js';
 export { type AnyInvariant, resolveInvariantModules } from './resolve-invariant-modules.js';

package/dist/domain/spec/modules/index.js

@@ -0,0 +1 @@
+export{createPhoenixLayoutElement,createPhoenixEntityElement,createCustomPhoenixLayoutElement,createCustomPhoenixEntityElement,createAssistantFormElement,resolveElementModule,resolveElementModules}from"./element-registration.js";export{findAssistantFormElementErrors}from"./find-assistant-form-element-errors.js";export{createPhoenixHandler,createSystemPhoenixHandler,createSystemPhoenixAsyncHandler,resolveHandlerModule,resolveHandlerModules}from"./handler-registration.js";export{SHARED_FOLDER_HINT,createContractError,isRecord}from"./project-modules.js";export{resolveActionModules}from"./resolve-action-modules.js";export{resolveComponentOpticModules}from"./resolve-component-optic-modules.js";export{mergeExpressionModules}from"./merge-expression-modules.js";export{resolveExpressionModules}from"./resolve-expression-modules.js";export{resolveInvariantModules}from"./resolve-invariant-modules.js";

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/merge-expression-modules.d.ts

@@ -1,5 +1,5 @@
-import type { AnonymousExpression, AnyExpressions } from '../../../core/index.js';
-import { type ImplementationErrorCollector } from '../../errors/index.js';
+import type { AnonymousExpression, AnyExpressions } from '../../core/index.js';
+import { type ImplementationErrorCollector } from '../errors/index.js';
 import { type ProjectModule } from './project-modules.js';
 type AnyAnonymousExpression = AnonymousExpression<any, any, any, any, any, any, unknown>;
 type AliasMap = Readonly<Record<string, readonly string[]>>;

package/dist/domain/spec/modules/merge-expression-modules.js

@@ -0,0 +1 @@
+import{ImplementationError as e,ImplementationErrors as o,createImplementationErrorCollector as t}from"../errors/index.js";import{SHARED_FOLDER_HINT as i,createContractError as n,isRecord as r}from"./project-modules.js";let s={expected:"an object of expressions keyed by entity type or alias, then by expression name",fix:`Create it with phx.domain.implementCustomExpressions({ ... }) (phx.domain.admin.implementCustomExpressions({ ... }) under src/admin/), ${i}.`},a=e=>r(e)&&"function"==typeof e.evaluate,p=e=>r(e)&&Object.values(e).every(a);export const isExpressionExport=e=>r(e)&&Object.values(e).every(p);let l=(o,t,i)=>new e({code:"DUPLICATE_DEFINITION",origin:o,problem:`Duplicate expression ${t}`,fix:i}),d=(e,t,i,r)=>{if(!isExpressionExport(e.exports))throw n(e,s,e.exports);let a=[],p=new Map,d=[];for(let[o,n]of Object.entries(e.exports))for(let s of t[o]??[o])for(let[t,f]of Object.entries(n)){let n=`${s}.${t}`,h=p.get(n),m=i.get(n);r.get(s)?.has(t)?d.push(l(e.origin,n,"The application already gives it a value (an $eval, $msg or read in the spec, a relation, the $violations of its invariants, or a built-in expression of the SDK), so this implementation would be ignored. Remove it from the file, or declare the expression in the spec with a type and no value.")):void 0!==h?d.push(l(e.origin,n,`The file defines it on both ${h} and ${o}, so its value would depend on the order the definitions are merged in. Define it once, on the alias or on the entity type.`)):void 0!==m&&d.push(l(e.origin,n,`It is also defined in ${m}, so its value would depend on file order. Keep one definition and remove the other.`)),p.set(n,o),a.push({key:n,entityType:s,typeOrAlias:o,name:t,expression:f})}if(d.length>0)throw new o(d);return a};export const mergeExpressionModules=(e,o,i,n=new Map)=>{let r=i??t(),s=new Map,a={};for(let t of e)for(let{key:e,entityType:i,typeOrAlias:p,name:l,expression:f}of r.attempt(()=>d(t,o,s,n),[]))s.set(e,t.origin),a[i]={...a[i],[l]:{...f,origin:{name:l,typeOrAlias:p}}};return void 0===i&&r.throwIfAny(),a};

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/project-modules.d.ts

@@ -1,4 +1,4 @@
-import { ImplementationError } from '../../errors/index.js';
+import { ImplementationError } from '../errors/index.js';
 /**
  * The default export of one file in a project convention folder (`src/elements/`, `src/handlers/`,
  * `src/expressions/`, …), paired with the project-relative path it was imported from.

package/dist/domain/spec/modules/project-modules.js

@@ -0,0 +1 @@
+import{ImplementationError as e}from"../errors/index.js";export const SHARED_FOLDER_HINT="or move the file to an underscore-prefixed folder such as src/_shared/ when it is shared code";export const isRecord=e=>"object"==typeof e&&null!==e&&!Array.isArray(e);export const createContractError=(r,t,o)=>new e({code:void 0===r.exports?"MISSING_EXPORT":"INVALID_EXPORT",origin:r.origin,problem:"Invalid default export",expected:t.expected,received:(e=>{if(void 0===e)return"nothing (the file has no default export)";if(null===e)return"null";if("function"==typeof e)return e.name?`the function "${e.name}"`:"an anonymous function";if(Array.isArray(e))return`an array of ${e.length} item(s)`;if(isRecord(e)){let r=Object.keys(e);return r.length>0?`an object with the keys ${r.join(", ")}`:"an empty object"}return`the ${typeof e} ${JSON.stringify(e)}`})(o),fix:`Every file in this folder is loaded by convention, so each one must default-export that shape. ${t.fix}`});export const resolveListModule=(e,r,t)=>{let o=Array.isArray(e.exports)?e.exports:[e.exports],n=[];for(let i of o){if(!t(i))throw createContractError(e,r,i);n.push(i)}return n};

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/resolve-action-modules.d.ts

@@ -1,4 +1,4 @@
-import type { AnyActionImplementations } from '../../../core/index.js';
+import type { AnyActionImplementations } from '../../core/index.js';
 import { type ProjectModule } from './project-modules.js';
 /** Validates the `src/actions/` files and merges their implementations by action name; a later file wins. */
 export declare const resolveActionModules: (modules: readonly ProjectModule[]) => AnyActionImplementations;

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/resolve-component-optic-modules.d.ts

@@ -1,4 +1,4 @@
-import type { AnyDomainComponentOptic } from '../../../core/index.js';
+import type { AnyDomainComponentOptic } from '../../core/index.js';
 import { type ProjectModule } from './project-modules.js';
 /** Validates the `src/components/` files, or the optics a generated file lists, and flattens them. */
 export declare const resolveComponentOpticModules: (modules: readonly ProjectModule[]) => readonly AnyDomainComponentOptic[];

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/resolve-expression-modules.d.ts

@@ -1,4 +1,4 @@
-import type { AnonymousExpression } from '../../../core/index.js';
+import type { AnonymousExpression } from '../../core/index.js';
 import type { ProjectModule } from './project-modules.js';
 /** The expressions of one validated expression file, keyed by entity type or alias, then by expression name. */
 export interface ExpressionModule {

package/dist/domain/{domain-runtime/spec/module-checks → spec/modules}/resolve-invariant-modules.d.ts

@@ -1,4 +1,4 @@
-import type { Invariant } from '../../../core/index.js';
+import type { Invariant } from '../../core/index.js';
 import { type ProjectModule } from './project-modules.js';
 /** An invariant of any project: a file's default export does not carry the project's entity and data types. */
 export type AnyInvariant = Invariant<any, any, any, any, any, any, string>;

package/dist/domain/spec/phx/index.d.ts

@@ -0,0 +1 @@
+export { type Phx, createPhx } from './phx.js';

package/dist/domain/spec/phx/index.js

@@ -0,0 +1 @@
+export{createPhx}from"./phx.js";

package/dist/{application-spec/generate-application/implementations → domain/spec/phx}/phx-application-types.d.ts

@@ -1,4 +1,4 @@
-import { type EnumLike } from '#package/domain';
+import { type EnumLike } from '../../core/index.js';
 import type { RuntimeSpec } from '../runtime-spec/index.js';
 /**
  * The value of `phx.applicationTypes`: the application's version and published data hash, the JSON

package/dist/domain/spec/phx/phx-application-types.js

@@ -0,0 +1 @@
+import{EnumReflection as a}from"../../core/index.js";let t=(t,e)=>new a(t,{enum:[...e]});export const createPhxApplicationTypes=a=>{let{dataSchemas:e,states:i}=a.configurator;return{ApplicationVersion:a.appMetadata.applicationVersion,PublishedDataHash:e.publishedDataHash,PublishedData:e.publishedData.runtimeSchema,SessionData:e.sessionData.runtimeSchema,FrontendData:e.frontendData.runtimeSchema,BackendData:e.backendData?.runtimeSchema,FinalizeData:e.finalizeData.runtimeSchema,PrefetchedFinalizeData:e.prefetchedFinalizeData.runtimeSchema,FinalizeResult:e.finalizeResult.runtimeSchema,CallbackData:e.callbackData.runtimeSchema,NavigationState:t("NavigationState",i.navigationStates),ViewState:t("ViewState",i.viewStates),ToolState:t("ToolState",i.toolStates),ExportState:t("ExportState",i.exportStates),AdminNavigationState:t("AdminNavigationState",a.admin.states.navigationStates)}};

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

@@ -0,0 +1 @@
+import{createAssistantSetupHandlerFactory as a,createDataRowValidatorHandler as t,createMapPublishedChunkedDataHandlerFactory as e,createMapPublishedRevisionDataHandlerFactory as i,createSheetValidatorHandler as o}from"../../application/index.js";import{DomainComponentOpticBuilder as s,createActionFactory as n,createCustomExpressionFactory as r,createCustomInvariantFactory as m,createRecipeFactory as c}from"../../core/index.js";let l=a=>c(a.aliases,a.entityReflections,a.defaults);export const createPhxDomain=(c,p)=>({...c.model,implementCustomExpressions:r(),implementCustomInvariants:m()(c.factoryData.staticViolations),implementActions:n(),createAssistantSetupHandler:a(),attachComponent:s.from(c.factoryData.aliases),createRecipe:l(c.factoryData),admin:{...p.model,implementCustomExpressions:r(),implementCustomInvariants:m()(p.factoryData.staticViolations),attachComponent:s.from(p.factoryData.aliases),createMapPublishedRevisionDataHandler:i(),createMapPublishedChunkedDataHandler:e(),createDataRowValidatorHandler:t,createSheetValidatorHandler:o,createRecipe:l(p.factoryData)}});

package/dist/{application-spec/generate-application/implementations → domain/spec/phx}/phx-model.d.ts

@@ -1,6 +1,6 @@
-import type { Expressions } from '../../parse-application-files/index.js';
+import type { Expressions } from '../expressions/index.js';
 import type { RuntimeLatestModelVersion } from '../runtime-spec/index.js';
-import type { AdminModelRuntime, ConfiguratorModelRuntime, SpecCodeMap } from '../runtime/index.js';
+import { type AdminModelRuntime, type ConfiguratorModelRuntime, type SpecCodeMap } from '../runtime/index.js';
 /**
  * The reflections of one domain that project code reads from `phx.domain` (or `phx.domain.admin`):
  * `model` holds the entity, alias, common type and shape reflections, `enhancedModel` the enhanced

package/dist/domain/spec/phx/phx-model.js

@@ -0,0 +1 @@
+import{EnhancedAliasReflection as e,EnumReflection as t,SchemaReflection as n}from"../../core/index.js";import{evaluateReflectionConstants as r}from"../runtime/index.js";let o=e=>e,i=(e,r,i)=>{let l,s=o(i);return void 0!==(l=r.enum)&&l.length>0&&l.every(e=>"string"==typeof e)?new t(e,{...s,enum:[...r.enum]}):new n(e,s)};export const createPhxModel=(t,l,s)=>{let m={...l.entities,...l.aliasReflections};for(let[e,n]of t.latestModel.commonTypes)m[String(e)]=i(String(e),n.schema,n.runtimeSchema);for(let e of t.latestModel.shapes.values()){let t=`${String(e.name)}Shape`;m[t]=new n(t,o(e.runtimeSchema))}let a={};for(let[e,t]of Object.entries(l.$entityReflections))a[`$${e}`]=t;for(let[n,o]of t.latestModel.aliases){let i=String(n);a[`$${i}`]=new e(`$${i}`,o.map(String),r(t.expressions,i,s))}return{model:m,enhancedModel:a}};

package/dist/{application-spec/generate-application/implementations → domain/spec/phx}/phx.d.ts

@@ -1,6 +1,5 @@
-import type { RuntimeReferenceStore } from '../../caching/index.js';
 import type { RuntimeSpec } from '../runtime-spec/index.js';
-import { type SpecCodeModule } from '../runtime/index.js';
+import { type RuntimeReferenceStore, type SpecCodeModule } from '../runtime/index.js';
 import { type PhxApplicationTypes } from './phx-application-types.js';
 import { type PhxDomain } from './phx-domain.js';
 /** The `phx` values an application's project modules read while they load. */

package/dist/{application-spec/generate-application → domain/spec}/runtime/admin-runtime/admin-runtime.d.ts

@@ -1,14 +1,15 @@
 import { Branded } from '@salsita-ai/common/utils';
-import { type ImplementationErrorCollector, type ProjectModule } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
+import type { ImplementationErrorCollector } from '../../errors/index.js';
+import type { ProjectModule } from '../../modules/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import { ExpressionRuntime, type InvariantImplementations, type MissingExpression } from '../expressions/index.js';
 import type { FactoryDataRuntime } from '../factory-data/index.js';
 import { type MigrationModules, MigrationRuntime } from '../migrations/index.js';
-import { ComponentOptics } from '../sections/component-optic.js';
-import { ExpressionRuntime, type InvariantImplementations, type MissingExpression } from '../sections/expression-runtime.js';
-import { PresetRuntime } from '../sections/preset-runtime.js';
+import type { AdminModelRuntime } from '../model/index.js';
+import { ComponentOptics } from '../optics/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
+import { PresetRuntime } from '../sections/index.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
-import type { AdminModelRuntime } from './admin-model-runtime.js';
 import { AdminStatesRuntime } from './states-runtime.js';
 export type AdminRuntime = Branded<'AdminRuntime', {
     readonly modelRuntime: AdminModelRuntime;

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

@@ -0,0 +1 @@
+import{Branded as e}from"@salsita-ai/common/utils";import{Preset as t,PresetCategory as i,commonAdminCustomExpressions as s,commonAdminViolationExpressions as n}from"../../../admin-domain/index.js";import{ExpressionRuntime as r}from"../expressions/index.js";import{MigrationRuntime as o}from"../migrations/index.js";import{ComponentOptics as m}from"../optics/index.js";import{PresetRuntime as a}from"../sections/index.js";import{AdminSpecRuntime as p}from"./admin-spec-runtime.js";import{AdminStatesRuntime as u}from"./states-runtime.js";let f={Preset:[{evaluate:(e,i,s)=>{let r=s.domain.get$Entity(e,i);return t.assert(r),n.Preset.nameNotEmpty(r)}}]},d={PresetCategory:{$isDraft:{origin:{name:"$isDraft",typeOrAlias:"PresetCategory"},evaluate:(e,t,n)=>{let r=n.domain.get$Entity(e,t);return i.assert(r),s.PresetCategory.$isDraft(r)},meta:{}}}},l=new WeakMap;export const AdminRuntime=(t,i,s,n,c,g,x)=>{let{modelRuntime:R,factoryDataRuntime:j}=p(t,i,g),y=r(t.admin,i,s,"adminExpressionRuntime",((e,t)=>{if(0===Object.keys(e).length)return f;let i=l.get(t)??new WeakMap;l.set(t,i);let s=i.get(e);if(s)return s;let n={};for(let i of[f,e])for(let[e,s]of Object.entries(i))for(let i of t[e]??[e])n[i]=[...n[i]??[],...s];return i.set(e,n),n})(n,R.aliases),g,x,d),k=o(i,{referenceScope:"adminRuntime/migrationRuntime",resolvedVersions:t.admin.resolvedVersions,latestEntities:R.entities,migrationModules:c});return y.ok?{ok:!0,runtime:e({modelRuntime:R,componentOptics:m(i,{components:t.admin.components,referenceScope:"adminRuntime/componentOptics",modelRuntime:R,code:g}),expressionRuntime:y.runtime,presetRuntime:a(i,{referenceScope:"adminRuntime/presetRuntime",presets:t.admin.presets.presets}),statesRuntime:u(t,i),migrationRuntime:k,factoryDataRuntime:j})}:{ok:!1,missingExpressions:y.missing,missingMigrations:k.missingMigrations}};

package/dist/{application-spec/generate-application → domain/spec}/runtime/admin-runtime/admin-spec-runtime.d.ts

@@ -1,9 +1,9 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
 import { FactoryDataRuntime } from '../factory-data/index.js';
+import { AdminModelRuntime } from '../model/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
-import { AdminModelRuntime } from './admin-model-runtime.js';
 /**
  * The sections of the admin domain that the spec alone determines: its model and the data of its
  * `phx.domain.admin` factories. `AdminRuntime` builds its own from this function, so a build of

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

@@ -0,0 +1 @@
+import{Branded as a}from"@salsita-ai/common/utils";import{FactoryDataRuntime as t}from"../factory-data/index.js";import{AdminModelRuntime as i}from"../model/index.js";export const AdminSpecRuntime=(e,n,m)=>{let r=i(e.admin,e.configurator.dataSchemas,n,m);return a({modelRuntime:r,factoryDataRuntime:t(n,{referenceScope:"adminRuntime/factoryDataRuntime",invariants:e.admin.invariants,defaults:e.admin.defaults,aliases:r.aliases,entities:r.entities})})};

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

@@ -0,0 +1,2 @@
+export { AdminRuntime } from './admin-runtime.js';
+export { AdminSpecRuntime } from './admin-spec-runtime.js';

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

@@ -0,0 +1 @@
+export{AdminRuntime}from"./admin-runtime.js";export{AdminSpecRuntime}from"./admin-spec-runtime.js";

package/dist/{application-spec/generate-application → domain/spec}/runtime/admin-runtime/states-runtime.d.ts

@@ -1,6 +1,6 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 export type AdminStatesRuntime = Branded<'AdminStatesRuntime', {
     readonly navigationStates: readonly string[];
     readonly changed: boolean;

package/dist/{application-spec/generate-application → domain/spec}/runtime/application-runtime.d.ts

@@ -1,12 +1,14 @@
 import { Branded } from '@salsita-ai/common/utils';
-import { type ImplementationErrorCollector, type ImportedTransformer, type ProjectModule } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../caching/index.js';
+import type { ImportedTransformer } from '../../application/index.js';
+import { type ImplementationErrorCollector } from '../errors/index.js';
+import type { ProjectModule } from '../modules/index.js';
 import type { RuntimeSpec } from '../runtime-spec/index.js';
-import { AdminRuntime } from './admin-runtime/admin-runtime.js';
-import { ConfiguratorRuntime } from './configurator-runtime/configurator-runtime.js';
+import { AdminRuntime } from './admin-runtime/index.js';
+import { ConfiguratorRuntime } from './configurator-runtime/index.js';
+import type { InvariantImplementations, MissingExpression } from './expressions/index.js';
 import type { MigrationModules } from './migrations/index.js';
-import { DataRuntime } from './sections/data-runtime.js';
-import type { InvariantImplementations, MissingExpression } from './sections/expression-runtime.js';
+import type { RuntimeReferenceStore } from './runtime-reference-store.js';
+import { DataRuntime } from './sections/index.js';
 import type { SpecCodeModule } from './spec-code/index.js';
 /**
  * Runtime objects built from a RuntimeSpec.

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

@@ -0,0 +1 @@
+import{Branded as i}from"@salsita-ai/common/utils";import{createImplementationErrorCollector as n}from"../errors/index.js";import{AdminRuntime as o}from"./admin-runtime/index.js";import{ConfiguratorRuntime as s}from"./configurator-runtime/index.js";import{DataRuntime as r}from"./sections/index.js";export const ApplicationRuntime=(m,t,e,a,g,u=[],p={},d={},f,k)=>{let x=k??n(),c=s(m,t,e,a,g,d,f?.configurator,x),M=o(m,t,u,p,d,f?.admin,x);return(void 0===k&&x.throwIfAny(),c.ok&&M.ok)?{ok:!0,runtime:i({configurator:c.runtime,admin:M.runtime,data:r(m,t)})}:{ok:!1,missingExpressions:[...c.ok?[]:c.missingExpressions,...M.ok?[]:M.missingExpressions],missingMigrations:[...c.ok?c.runtime.migrationRuntime.missingMigrations:c.missingMigrations,...M.ok?M.runtime.migrationRuntime.missingMigrations:M.missingMigrations]}};

package/dist/{application-spec/generate-application → domain/spec}/runtime/application-spec-slice.d.ts

@@ -1,4 +1,6 @@
-import { type AnyActionImplementations, type AnyDomainComponentOptic, type ApplicationConfiguratorSpec, type ElementRegistration, type HandlerRegistration, type ApplicationSpec as RuntimeApplicationSpec } from '#package/domain';
+import type { AnyActionImplementations, AnyDomainComponentOptic } from '../../core/index.js';
+import { type ApplicationConfiguratorSpec, type ApplicationSpec as RuntimeApplicationSpec } from '../../domain-runtime/index.js';
+import type { ElementRegistration, HandlerRegistration } from '../modules/index.js';
 import type { RuntimeSpec } from '../runtime-spec/index.js';
 import type { ApplicationRuntime } from './application-runtime.js';
 type Theme = ApplicationConfiguratorSpec['theme'];

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

@@ -0,0 +1 @@
+import{resolveImportedTransformers as e}from"../../domain-runtime/index.js";export const customComponentOpticsOf=e=>e.filter(e=>!0!==e.generated);let t=(t,n)=>{let{runtime:s,modules:a,themePresets:i}=t,{configurator:o}=s,r=(e,t,s)=>e||void 0===n?t():s(n),l=a.handlers?.handlers??n?.handlers??[],m=a.handlers||void 0===n?((e,t,n)=>{let s={};for(let a of e)s[a.name]=t?.[a.name]??n?.[a.name]??a.name;return s})(l,a.handlers?.nameHashes,n?.handlerHashes):n.handlerHashes,c=a.elements?.elements??n?.elements??[],p=a.elements||void 0===n?((e,t,n)=>{let s={},a=0;for(let i of e)if("assistantFormElement"!==i.type)if("entity"===i.type||"layout"===i.type)s[i.name]=t?.[i.name]??n?.[i.name]??i.name;else{let e=`icon:${a}`;s[e]=t?.[e]??n?.[e]??`${e}:${i.elements.length}`,a+=1}return s})(c,a.elements?.nameHashes,n?.elementHashes):n.elementHashes,d=a.customComponentOptics??customComponentOpticsOf(n?.componentOptics??[]),u=r(o.componentOptics.changed||null!==a.customComponentOptics,()=>[...o.componentOptics.optics.map(e=>e.optic),...d],e=>e.componentOptics),{importedTransformers:h,specTransformers:g}=o.transformersRuntime;return{presets:r(o.presetRuntime.changed,()=>o.presetRuntime.presets,e=>e.presets),theme:r(o.themeRuntime.changed,()=>{var e;let t;return t=(Object.hasOwn(i,(e=o.themeRuntime).preset)?i[e.preset]:{})??{},Object.keys(e.options).length>0?{...t,...e.options}:t},e=>e.theme),assistant:r(o.assistantRuntime.changed,()=>o.assistantRuntime.assistant,e=>e.assistant),navigationStates:r(o.statesRuntime.changed,()=>o.statesRuntime.navigationStates,e=>e.navigationStates),viewStates:r(o.statesRuntime.changed,()=>o.statesRuntime.viewStates,e=>e.viewStates),toolStates:r(o.statesRuntime.changed,()=>o.statesRuntime.toolStates,e=>e.toolStates),exportStates:r(o.statesRuntime.changed,()=>o.statesRuntime.exportStates,e=>e.exportStates),componentOptics:u,createTransformers:r(o.transformersRuntime.changed,()=>t=>e(h,g,t),e=>e.createTransformers),handlers:l,handlerHashes:m,elements:c,elementHashes:p}},n=(e,t,n)=>{let{modelRuntime:s,expressionRuntime:a,actionsRuntime:i,migrationRuntime:o}=e.configurator,r=s.domainBuilder.withExpressions(a.merged).withActions(Object.values(i.definitions)).withActionImplementations(t),l=(n?r.withMigrate(o.migrate):r).build();return{modelVersion:l.context.modelVersion,factory:l,aliasMap:l.context.aliasMap,entityReflections:l.context.entityReflections,$entityReflections:l.context.$entityReflections,allowedRootEntityTypes:l.context.allowedRootEntityTypes,migrate:l.context.migrate}};export const applicationSpecSlice=e=>void 0===e.previous?(e=>{let{runtime:s,spec:a}=e,i=(e=>{let{runtime:s,modules:a,spec:i,defaultElements:o}=e,{expressionRuntime:r,actionsRuntime:l}=s.configurator,{ui:m}=i.configurator,c=i.infra.resourcesConfig,p=a.actionImplementations??{};return{...t(e,void 0),...n(s,p,!0),expressions:r.merged,actions:l.definitions,actionImplementations:p,defaultElements:o,appLoader:m.appLoader??"universal",preview:m.preview??"auto",alwaysExpand:m.alwaysExpand??!1,deploymentQueryDisabled:c?.deploymentQueryDisabled??!1,prefetchTextureUrls:c?.prefetchTextureUrls??[]}})(e),o=a.configurator.ui.textLanguages;return{version:a.appMetadata.applicationVersion,dataConfig:s.data.dataSpec,chunks:s.data.chunks,publishedDataHash:s.data.publishedDataHash,initialPublishedData:{},canCreate:[...a.infra.acl.canCreate],enableAdminRelease:a.appMetadata.enableAdminRelease,textLanguages:o&&o.length>0?o:["en"],baseResourcesUrl:a.infra.resourcesConfig?.baseResourcesUrl??e.environmentResourcesUrl??"",configurator:i,admin:((e,t)=>{let{modelRuntime:n,expressionRuntime:s,migrationRuntime:a,presetRuntime:i,componentOptics:o,statesRuntime:r}=e.runtime.admin,[l]=i.presets;if(void 0===l)throw Error("Cannot register application spec because admin preset is required.");let m=n.domainBuilder.withExpressions(s.merged).withMigrate(a.migrate).build();return{factory:m,modelVersion:m.modelVersion,aliasMap:m.context.aliasMap,entityReflections:m.context.entityReflections,$entityReflections:m.context.$entityReflections,expressions:m.context.expressions,actions:m.context.actions,actionImplementations:m.context.actionImplementations,allowedRootEntityTypes:m.context.allowedRootEntityTypes,migrate:m.context.migrate,preset:l,componentOptics:[...o.optics.map(e=>e.optic),...e.customAdminComponentOptics],navigationStates:r.navigationStates,viewStates:[],handlers:t.handlers,handlerHashes:t.handlerHashes,elements:t.elements,elementHashes:t.elementHashes}})(e,i)}})(e):{...e.previous,configurator:(e=>{let{runtime:s,modules:a,previous:i,model:o}=e,r=i.configurator,{expressionRuntime:l,actionsRuntime:m}=s.configurator,c=t(e,r),p=a.actionImplementations??r.actionImplementations;return"keep"===o?{...r,...c,expressions:l.changed?l.merged:r.expressions,actions:m.changed?m.definitions:r.actions,actionImplementations:p}:{...r,...c,...n(s,p,!1),expressions:l.merged,actions:m.definitions,actionImplementations:p}})(e)};