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

package/dist/domain/spec/sections/assistant/form/assistant-form-element-name.js

@@ -0,0 +1,8 @@
+let e=new Set(`a abbr acronym address applet area article aside audio b base basefont bdi bdo big blink blockquote body br
+  button canvas caption center cite code col colgroup data datalist dd del details dfn dialog dir div dl dt em
+  embed fieldset figcaption figure font footer form frame frameset h1 h2 h3 h4 h5 h6 head header hgroup hr html
+  i iframe image img input ins kbd keygen label legend li link main map mark marquee math menu menuitem meta
+  meter nav nobr noembed noframes noscript object ol optgroup option output p param picture plaintext pre
+  progress q rb rp rt rtc ruby s samp script search section select slot small source span strike strong style
+  sub summary sup svg table tbody td template textarea tfoot th thead time title tr track tt u ul var video wbr
+  xmp`.split(/\s+/));export const ASSISTANT_FORM_NAME_PATTERN=/^[a-z][a-z0-9-]*$/;export const isHtmlElementName=t=>e.has(t);

package/dist/domain/spec/sections/assistant/form/assistant-form-elements.d.ts

@@ -0,0 +1,174 @@
+/**
+ * What an element of an assistant form collects: a `group` all its children, a `choice` exactly one
+ * of its options, a `choices` any number of them; an `option` is something to pick and an `input` a
+ * free value.
+ */
+export type AssistantFormRole = 'group' | 'choice' | 'choices' | 'option' | 'input';
+/** The type an attribute of a form element is validated and coerced to; the model writes every attribute as a string. */
+export interface AssistantFormAttribute {
+    readonly type: 'string' | 'number' | 'integer' | 'boolean';
+    /** The words a string, or the numbers a number, may be; a number's are written as text in the markup. */
+    readonly enum?: readonly (string | number)[];
+    /** A JSON Schema `pattern` a string attribute must match, such as a resource path or a `#rrggbb` color. */
+    readonly pattern?: string;
+    /** The bounds a number attribute must be within, as in JSON Schema. */
+    readonly minimum?: number;
+    readonly maximum?: number;
+    /** The bounds of a string attribute's length, as in JSON Schema. */
+    readonly minLength?: number;
+    readonly maxLength?: number;
+}
+/**
+ * An element the assistant can write inside a ```` ```form ```` fence of its reply to ask the user
+ * something. The panel renders it, and the SDK prompt lists it, so the model and the panel agree on
+ * one set of elements: the built-ins below, followed by the project's own, which its YAML declares
+ * under `assistant.formElements` with the fields up to `required`.
+ */
+export interface AssistantFormElementDescriptor {
+    /** The tag: lowercase, and never the name of an HTML element. */
+    readonly name: string;
+    readonly role: AssistantFormRole;
+    /** What the element is for, printed in the prompt after its signature. */
+    readonly description: string;
+    /**
+     * Attributes beyond the built-in `label`, in the order the prompt lists them. An option or an
+     * input that takes a `value` declares it like any other: by convention an option answers with
+     * it instead of its label, and an input starts with it.
+     */
+    readonly attributes: Readonly<Record<string, AssistantFormAttribute>>;
+    readonly required?: readonly string[];
+    /**
+     * An input the user answers with one action, such as a `confirm`: a form whose only question it
+     * is sends on that action, without a submit button, as a lone `choice` sends on the first pick.
+     */
+    readonly quick?: true;
+    /**
+     * The attributes an option can answer with besides `label`, in the order its component tries
+     * them. An option that declares them and has none of them, nor `label`, makes its form fail.
+     */
+    readonly identity?: readonly string[];
+}
+/** What an attribute's declaration makes of its value: one of its words, a string, a number or a boolean. */
+export type AssistantFormAttributeValue<ATTRIBUTE extends AssistantFormAttribute> = ATTRIBUTE extends {
+    readonly enum: readonly (infer WORD)[];
+} ? WORD : ATTRIBUTE['type'] extends 'string' ? string : ATTRIBUTE['type'] extends 'boolean' ? boolean : number;
+type RequiredAttributeName<DESCRIPTOR> = DESCRIPTOR extends {
+    readonly required: readonly (infer NAME)[];
+} ? NAME : never;
+/**
+ * The attributes a form element's component gets, typed from its descriptor: the declared ones,
+ * optional unless `required`. The form validates the markup against the same descriptor, so the
+ * component can rely on these types.
+ */
+export type AssistantFormElementAttributes<DESCRIPTOR extends AssistantFormElementDescriptor> = {
+    readonly [NAME in keyof DESCRIPTOR['attributes'] as NAME extends RequiredAttributeName<DESCRIPTOR> ? NAME : never]: AssistantFormAttributeValue<DESCRIPTOR['attributes'][NAME]>;
+} & {
+    readonly [NAME in keyof DESCRIPTOR['attributes'] as NAME extends RequiredAttributeName<DESCRIPTOR> ? never : NAME]?: AssistantFormAttributeValue<DESCRIPTOR['attributes'][NAME]>;
+};
+/** The elements every assistant form understands, in the order the prompt lists them. */
+export declare const ASSISTANT_BUILT_IN_FORM_ELEMENTS: readonly [{
+    readonly name: 'group';
+    readonly role: 'group';
+    readonly description: 'Puts related questions together under its label.';
+    readonly attributes: {};
+}, {
+    readonly name: 'choice';
+    readonly role: 'choice';
+    readonly description: 'The user picks exactly one of its options.';
+    readonly attributes: {};
+}, {
+    readonly name: 'choices';
+    readonly role: 'choices';
+    readonly description: 'The user picks any number of its options.';
+    readonly attributes: {};
+}, {
+    readonly name: 'reply';
+    readonly role: 'option';
+    readonly description: 'A short answer shown as a button.';
+    readonly attributes: {
+        readonly value: {
+            readonly type: 'string';
+        };
+    };
+}, {
+    readonly name: 'card';
+    readonly role: 'option';
+    readonly description: 'A tile with an optional picture over its label and a one-line `description`. `image` is a path you read on an `imageUrl` field. Without `value` or `label` it sends its `description`, or else its `image`.';
+    readonly attributes: {
+        readonly value: {
+            readonly type: 'string';
+        };
+        readonly description: {
+            readonly type: 'string';
+        };
+        readonly image: {
+            readonly type: 'string';
+            readonly pattern: string;
+        };
+    };
+    readonly identity: readonly ["value", "description", "image"];
+}, {
+    readonly name: 'swatch';
+    readonly role: 'option';
+    readonly description: 'A small tile of a color or a material, without text: its label shows on hover. `color` is `#rrggbb`, as on the `color` field of an option, and `image` a path you read on an `imageUrl` field. Without `value` or `label` it sends its `color`, or else its `image`.';
+    readonly attributes: {
+        readonly value: {
+            readonly type: 'string';
+        };
+        readonly color: {
+            readonly type: 'string';
+            readonly pattern: '^#[0-9a-fA-F]{6}$';
+        };
+        readonly image: {
+            readonly type: 'string';
+            readonly pattern: string;
+        };
+    };
+    readonly identity: readonly ["value", "color", "image"];
+}, {
+    readonly name: 'text';
+    readonly role: 'input';
+    readonly description: 'A single line the user types.';
+    readonly attributes: {
+        readonly value: {
+            readonly type: 'string';
+        };
+        readonly placeholder: {
+            readonly type: 'string';
+        };
+    };
+}, {
+    readonly name: 'number';
+    readonly role: 'input';
+    readonly description: 'A number the user types, with a slider when both `min` and `max` are given. The answer carries the `unit`, as in `Length: 240 cm`.';
+    readonly attributes: {
+        readonly value: {
+            readonly type: 'number';
+        };
+        readonly min: {
+            readonly type: 'number';
+        };
+        readonly max: {
+            readonly type: 'number';
+        };
+        readonly step: {
+            readonly type: 'number';
+        };
+        readonly unit: {
+            readonly type: 'string';
+        };
+    };
+}, {
+    readonly name: 'confirm';
+    readonly role: 'input';
+    readonly description: "A yes or no question, shown as two buttons. It answers with the user's own words for yes and no, such as `Yes` or `Ano`, and alone in a form it sends on the click.";
+    readonly attributes: {};
+    readonly quick: true;
+}];
+/** The name of a built-in form element. */
+export type AssistantBuiltInFormElementName = (typeof ASSISTANT_BUILT_IN_FORM_ELEMENTS)[number]['name'];
+/** The attributes the component of a built-in form element gets, typed from its descriptor. */
+export type AssistantBuiltInFormElementAttributes<NAME extends AssistantBuiltInFormElementName> = AssistantFormElementAttributes<Extract<(typeof ASSISTANT_BUILT_IN_FORM_ELEMENTS)[number], {
+    readonly name: NAME;
+}>>;
+export {};

package/dist/domain/spec/sections/assistant/form/assistant-form-elements.js

@@ -0,0 +1 @@
+import{ASSISTANT_RESOURCE_PATH_PATTERN as e}from"./assistant-resource-path.js";export const ASSISTANT_BUILT_IN_FORM_ELEMENTS=[{name:"group",role:"group",description:"Puts related questions together under its label.",attributes:{}},{name:"choice",role:"choice",description:"The user picks exactly one of its options.",attributes:{}},{name:"choices",role:"choices",description:"The user picks any number of its options.",attributes:{}},{name:"reply",role:"option",description:"A short answer shown as a button.",attributes:{value:{type:"string"}}},{name:"card",role:"option",description:"A tile with an optional picture over its label and a one-line `description`. `image` is a path you read on an `imageUrl` field. Without `value` or `label` it sends its `description`, or else its `image`.",attributes:{value:{type:"string"},description:{type:"string"},image:{type:"string",pattern:e}},identity:["value","description","image"]},{name:"swatch",role:"option",description:"A small tile of a color or a material, without text: its label shows on hover. `color` is `#rrggbb`, as on the `color` field of an option, and `image` a path you read on an `imageUrl` field. Without `value` or `label` it sends its `color`, or else its `image`.",attributes:{value:{type:"string"},color:{type:"string",pattern:"^#[0-9a-fA-F]{6}$"},image:{type:"string",pattern:e}},identity:["value","color","image"]},{name:"text",role:"input",description:"A single line the user types.",attributes:{value:{type:"string"},placeholder:{type:"string"}}},{name:"number",role:"input",description:"A number the user types, with a slider when both `min` and `max` are given. The answer carries the `unit`, as in `Length: 240 cm`.",attributes:{value:{type:"number"},min:{type:"number"},max:{type:"number"},step:{type:"number"},unit:{type:"string"}}},{name:"confirm",role:"input",description:"A yes or no question, shown as two buttons. It answers with the user's own words for yes and no, such as `Yes` or `Ano`, and alone in a form it sends on the click.",attributes:{},quick:!0}];

package/dist/domain/spec/sections/assistant/form/assistant-resource-path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A path into the project's resources, the kind stored on `imageUrl` fields: no scheme and no host,
+ * so resolving it never leaves the resources origin. A backslash, a control character or leading
+ * whitespace is refused too, because the URL parser reads a backslash as a slash and strips the
+ * others, which would turn `\\host` or ` //host` into an address on another host.
+ *
+ * Written as a JSON Schema `pattern`, so the `image` attribute of a form element applies the same
+ * rule as the images of a reply.
+ */
+export declare const ASSISTANT_RESOURCE_PATH_PATTERN: string;

package/dist/domain/spec/sections/assistant/form/assistant-resource-path.js

@@ -0,0 +1 @@
+export const ASSISTANT_RESOURCE_PATH_PATTERN=String.raw`^(?![a-zA-Z][a-zA-Z0-9+.-]*:)(?!//)[^\s\\\x00-\x1f][^\\\x00-\x1f]*$`;

package/dist/domain/spec/sections/assistant/form/index.d.ts

@@ -0,0 +1,4 @@
+export { ASSISTANT_FORM_NAME_PATTERN, isHtmlElementName } from './assistant-form-element-name.js';
+export { ASSISTANT_BUILT_IN_FORM_ELEMENTS } from './assistant-form-elements.js';
+export type { AssistantBuiltInFormElementAttributes, AssistantBuiltInFormElementName, AssistantFormAttribute, AssistantFormAttributeValue, AssistantFormElementAttributes, AssistantFormElementDescriptor, AssistantFormRole, } from './assistant-form-elements.js';
+export { ASSISTANT_RESOURCE_PATH_PATTERN } from './assistant-resource-path.js';

package/dist/domain/spec/sections/assistant/form/index.js

@@ -0,0 +1 @@
+export{ASSISTANT_FORM_NAME_PATTERN,isHtmlElementName}from"./assistant-form-element-name.js";export{ASSISTANT_BUILT_IN_FORM_ELEMENTS}from"./assistant-form-elements.js";export{ASSISTANT_RESOURCE_PATH_PATTERN}from"./assistant-resource-path.js";

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

@@ -0,0 +1,4 @@
+export { ASSISTANT_HINTS } from './assistant-manifest.js';
+export type { AssistantResolvedManifest, AssistantDeclaredField, AssistantDeclarations, AssistantDeclaredWrite, AssistantResolvedField, AssistantValueType, AssistantEdgeType, AssistantStates, AssistantWritableType, AssistantWritableField, AssistantResolvedRecipes, AssistantResolvedOptionsEdge, AssistantResolvedAction, AssistantResolvedActionResult, } from './assistant-resolved-manifest.js';
+export type { AssistantFieldSource, AssistantResolvedHint, AssistantRecipeGroup, AssistantFieldOptions, AssistantScreenshotView, AssistantManifest, } from './assistant-manifest.js';
+export * from './form/index.js';

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

@@ -0,0 +1 @@
+export{ASSISTANT_HINTS}from"./assistant-manifest.js";export*from"./form/index.js";

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

@@ -0,0 +1,23 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated published-data chunk name.
+ * Chunk names identify top-level partitions in generated `publishedData`. Data
+ * entries point to these names through their `chunk` field, and the parser adds
+ * the reserved `system` chunk when user chunks exist.
+ */
+export type ChunkName = Branded<'ChunkName', string>;
+/**
+ * A named partition of published data with a scope.
+ * `scope` is typically `'project'` (per-project data) or `'public'` (shared).
+ */
+export interface ChunkDefinition {
+    /** Visibility/storage scope used by runtime data publishing for this chunk. */
+    readonly scope: string;
+}
+/**
+ * Validated chunk definitions, keyed by chunk name.
+ * When any user-defined chunks are present, the reserved `system` chunk is
+ * auto-injected with `scope: 'public'` to carry admin presets/recipes schemas.
+ * When the input is empty, no system injection happens (mirrors domain-spec behavior).
+ */
+export type Chunks = Readonly<Record<ChunkName, ChunkDefinition>>;

package/dist/domain/spec/sections/data-spec/chunks.js

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

package/dist/domain/spec/sections/data-spec/custom-data-spec-entry.d.ts

@@ -0,0 +1,16 @@
+import type { DataCellValue, DataSchema } from '../../../core/index.js';
+/** Parsed `$data.custom` entry with validated definition and normalized row values. */
+export interface CustomDataSpecEntry {
+    /** Column/property schema for a custom data row, used by admin pages and published-data schemas. */
+    readonly definition: DataSchema;
+    /** Optional published-data chunk that receives this entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether data is manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default rows normalized to the same column order as `definition`. */
+    readonly values?: ReadonlyArray<readonly DataCellValue[]>;
+}

package/dist/domain/spec/sections/data-spec/custom-data-spec-entry.js

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

package/dist/domain/spec/sections/data-spec/data-entry-key.d.ts

@@ -0,0 +1,9 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated `$data` entry key.
+ * This is the stable identifier for a data collection declared under `$data.custom`
+ * or `$data.swatchOptions`. The same key is used when extending published data,
+ * wiring connected/generated admin pages, and linking explicit admin pages through
+ * `connectedDataEntry`.
+ */
+export type DataEntryKey = Branded<'DataEntryKey', string>;

package/dist/domain/spec/sections/data-spec/data-entry-key.js

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

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

@@ -0,0 +1,5 @@
+export type * from './chunks.js';
+export type * from './custom-data-spec-entry.js';
+export type * from './data-entry-key.js';
+export type * from './parsed-data-spec-entries.js';
+export type * from './swatch-data-spec-entry.js';

package/dist/domain/spec/sections/data-spec/index.js

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

package/dist/domain/spec/sections/data-spec/parsed-data-spec-entries.d.ts

@@ -0,0 +1,10 @@
+import type { CustomDataSpecEntry } from './custom-data-spec-entry.js';
+import type { DataEntryKey } from './data-entry-key.js';
+import type { SwatchDataSpecEntry } from './swatch-data-spec-entry.js';
+/** Validated `$data` entries grouped by their source section. */
+export interface ParsedDataSpecEntries {
+    /** Custom data entries with user-declared schemas. */
+    readonly custom: Readonly<Record<DataEntryKey, CustomDataSpecEntry>>;
+    /** Swatch data entries with the built-in swatch schema. */
+    readonly swatchOptions: Readonly<Record<DataEntryKey, SwatchDataSpecEntry>>;
+}

package/dist/domain/spec/sections/data-spec/parsed-data-spec-entries.js

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

package/dist/domain/spec/sections/data-spec/swatch-data-spec-entry.d.ts

@@ -0,0 +1,14 @@
+import type { CellValue } from '@salsita-ai/contracts/webhook';
+/** Parsed `$data.swatchOptions` entry using the fixed swatch data shape. */
+export interface SwatchDataSpecEntry {
+    /** Optional published-data chunk that receives this swatch entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether swatches are manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default swatch rows normalized to `SWATCH_DEFINITION` column order. */
+    readonly values?: ReadonlyArray<readonly CellValue[]>;
+}

package/dist/domain/spec/sections/data-spec/swatch-data-spec-entry.js

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

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

@@ -0,0 +1,10 @@
+export type * from './actions.js';
+export type * from './app-metadata.js';
+export type * from './application-version.js';
+export * from './assistant/index.js';
+export type * from './data-spec/index.js';
+export * from './infra/index.js';
+export type * from './state-value.js';
+export type * from './theme.js';
+export type * from './transformers.js';
+export type * from './ui.js';

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

@@ -0,0 +1 @@
+export*from"./assistant/index.js";export*from"./infra/index.js";

package/dist/domain/spec/sections/infra/acl.d.ts

@@ -0,0 +1,12 @@
+/** The roles of `acl.canCreate`: the users who may create a configuration. */
+export declare const aclRoles: readonly ['anonymous', 'user', 'admin', 'superadmin'];
+/** One role of {@link aclRoles}. */
+export type AclRole = (typeof aclRoles)[number];
+/**
+ * The parsed `acl` section of the application spec: the roles that may create a configuration,
+ * all four when the spec declares none. Code generation passes it to the generated configurator
+ * builder, and the runtime spec carries it to the application.
+ */
+export interface Acl {
+    readonly canCreate: readonly AclRole[];
+}

package/dist/domain/spec/sections/infra/acl.js

@@ -0,0 +1 @@
+export const aclRoles=["anonymous","user","admin","superadmin"];

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

@@ -0,0 +1,3 @@
+export * from './acl.js';
+export type * from './resource-entry.js';
+export type * from './resources-config.js';

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

@@ -0,0 +1 @@
+export*from"./acl.js";

package/dist/domain/spec/sections/infra/resource-entry.d.ts

@@ -0,0 +1,46 @@
+/** A resource that links to the configuration. */
+export interface ConfigurationLinkResource {
+    readonly type: 'ConfigurationLink';
+    readonly name: string;
+}
+/** A CSV document of the configuration, generated by the server or stored under `s3Key`. */
+export interface CsvResource {
+    readonly type: 'Csv';
+    readonly name: string;
+    readonly s3Key?: string;
+}
+/** A PDF document of the configuration, generated by the server or stored under `s3Key`. */
+export interface PdfResource {
+    readonly type: 'Pdf';
+    readonly name: string;
+    readonly s3Key?: string;
+}
+/** An image the client renders and uploads under `s3Key`. */
+export interface ClientGeneratedImageResource {
+    readonly type: 'Image';
+    readonly name: string;
+    readonly clientGenerated: true;
+    readonly s3Key: string;
+}
+/** An image that already exists at `url`. */
+export interface ExistingImageResource {
+    readonly type: 'Image';
+    readonly name: string;
+    readonly exists: true;
+    readonly url: string;
+}
+/** An image the server renders under `s3Key`. */
+export interface GeneratedImageResource {
+    readonly type: 'Image';
+    readonly name: string;
+    readonly s3Key: string;
+}
+/** One of the three kinds of image resource. */
+export type ImageResource = ClientGeneratedImageResource | ExistingImageResource | GeneratedImageResource;
+/**
+ * One entry of the `resources` section of the application spec: a generated or linked resource of a
+ * configuration. A name identifies one resource, so no two entries share a name. Code generation
+ * emits the entries as an array literal, and the union of their names is the type of a resource
+ * name in the project's webhook and frontend code.
+ */
+export type ResourceEntry = ConfigurationLinkResource | CsvResource | PdfResource | ImageResource;

package/dist/domain/spec/sections/infra/resource-entry.js

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

package/dist/domain/spec/sections/infra/resources-config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The parsed `resourcesConfig` section of the application spec: the host settings of the
+ * resources, such as the base resources URL and the texture URLs to prefetch. `domain` exports a
+ * different `ResourcesConfig`, the resources part of an application config.
+ */
+export interface SpecResourcesConfig {
+    readonly baseResourcesUrl?: string;
+    readonly prefetchTextureUrls?: readonly string[];
+    readonly deploymentQueryDisabled?: boolean;
+}

package/dist/domain/spec/sections/infra/resources-config.js

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

package/dist/domain/spec/sections/state-value.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded state value — a valid identifier used as a state enum entry
+ * (e.g. "Default", "overview", "detailView").
+ * Used across navigation, view, tool, and export state dimensions.
+ */
+export type StateValue = Branded<'StateValue', string>;

package/dist/domain/spec/sections/state-value.js

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

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

@@ -0,0 +1,10 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated theme configuration for the configurator UI.
+ * Preset identifies a built-in theme from getPhoenixThemes(),
+ * options provides partial overrides passed to the theme factory.
+ */
+export type Theme = Branded<'Theme', {
+    readonly preset: string;
+    readonly options: Readonly<Record<string, unknown>>;
+}>;

package/dist/domain/spec/sections/theme.js

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

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

@@ -0,0 +1,15 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** One declared transformer: the name its implementation is registered under, and its priority. */
+export interface TransformerEntry {
+    readonly name: string;
+    readonly priority?: number;
+}
+/**
+ * Validated transformer declarations. Each transformer is applied during
+ * domain state transitions to enforce business rules (e.g. "fixLegsForCircleTop").
+ * Every entry's name must match a file basename in `src/transformers/`
+ * (modulo case + dashes — kebab-case files and camelCase YAML names are
+ * treated as equivalent since runtime matching happens on the `.build('name')`
+ * label, not the filename). `application-spec` exports it as `Transformers`.
+ */
+export type SpecTransformers = Branded<'Transformers', readonly TransformerEntry[]>;

package/dist/domain/spec/sections/transformers.js

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

package/dist/domain/spec/sections/ui.d.ts

@@ -0,0 +1,12 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated UI configuration for the configurator.
+ * Controls preview behavior, expansion mode, and locale settings.
+ */
+export type Ui = Branded<'Ui', {
+    readonly preview?: 'always' | 'never' | 'auto' | 'hide';
+    readonly alwaysExpand?: boolean;
+    readonly appLoader?: 'legacy' | 'universal';
+    readonly availableLocales: readonly string[];
+    readonly textLanguages?: readonly string[];
+}>;

package/dist/domain/spec/sections/ui.js

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

package/dist/domain/system-components/child-entity-selection.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as t,SystemComponentBuilder as i}from"../core/index.js";import{recipeSchema as o}from"./common/recipes.js";export const childEntitySelectionComponent=i.component("childEntitySelection").withState({type:"object",tsType:"ChildEntitySelectionComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ChildEntitySelectionComponentState"}],properties:{value:t,options:{type:"array",items:{type:"object",properties:{label:e,description:e,img:e,recipes:{type:"array",items:o},keepChildren:{type:"boolean"}},required:["recipes","label"],additionalProperties:!0}}},required:["value","options"],additionalProperties:!1}).build();
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as t,SystemComponentBuilder as i}from"../core/index.js";import{recipeSchema as o}from"./common/recipes.js";export const childEntitySelectionComponent=i.component("childEntitySelection").withState({type:"object",tsType:"ChildEntitySelectionComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ChildEntitySelectionComponentState"}],properties:{value:t,options:{type:"array",items:{type:"object",properties:{label:e,description:e,img:e,recipes:{type:"array",items:o}},required:["recipes","label"],additionalProperties:!1}},keepChildren:{type:"boolean"}},required:["value","options"],additionalProperties:!1}).build();

package/dist/domain/system-components/common/scene-entity-control-schema.d.ts

@@ -115,6 +115,7 @@ declare const SceneHtmlOpacityPropertiesTmp: {
                 readonly type: 'number';
             };
         };
+        readonly required: readonly ['min', 'max'];
         readonly additionalProperties: false;
     };
     readonly polarAngleLimits: {
@@ -138,6 +139,7 @@ declare const SceneHtmlOpacityPropertiesTmp: {
                 readonly type: 'number';
             };
         };
+        readonly required: readonly ['min', 'max'];
         readonly additionalProperties: false;
     };
     readonly distanceLimits: {
@@ -161,6 +163,7 @@ declare const SceneHtmlOpacityPropertiesTmp: {
                 readonly type: 'number';
             };
         };
+        readonly required: readonly ['min', 'max'];
         readonly additionalProperties: false;
     };
     readonly minInteractiveOpacity: {

package/dist/domain/system-components/common/scene-entity-control-schema.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";let t={type:"object",tsType:"SceneEntityHtmlOpacityLimits",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityHtmlOpacityLimits"}],properties:{min:{type:"number"},max:{type:"number"},smoothZone:{type:"number"},minOpacity:{type:"number"}},additionalProperties:!1};export const SceneHtmlOpacityProperties={azimuthAngleLimits:t,polarAngleLimits:t,distanceLimits:t,minInteractiveOpacity:{type:"number"}};export const SceneHtmlPositionProperties={offsetX:{type:"number"},offsetY:{type:"number"},offsetZ:{type:"number"},screenOffsetHorizontal:{type:"number"},screenOffsetVertical:{type:"number"}};export const SceneHtmlVisibilityProperties={hideWhileDragging:{type:"boolean"},occlude:{type:"boolean"},showWhen:{type:"array",items:{type:"string",enum:["selected","unselected"]}}};export const SceneHtmlTooltipProperties={title:e,tooltipVisibility:{type:["string"],enum:["on-hover","forced","forced-when-still","hidden"]}};
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";let t={type:"object",tsType:"SceneEntityHtmlOpacityLimits",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityHtmlOpacityLimits"}],properties:{min:{type:"number"},max:{type:"number"},smoothZone:{type:"number"},minOpacity:{type:"number"}},required:["min","max"],additionalProperties:!1};export const SceneHtmlOpacityProperties={azimuthAngleLimits:t,polarAngleLimits:t,distanceLimits:t,minInteractiveOpacity:{type:"number"}};export const SceneHtmlPositionProperties={offsetX:{type:"number"},offsetY:{type:"number"},offsetZ:{type:"number"},screenOffsetHorizontal:{type:"number"},screenOffsetVertical:{type:"number"}};export const SceneHtmlVisibilityProperties={hideWhileDragging:{type:"boolean"},occlude:{type:"boolean"},showWhen:{type:"array",items:{type:"string",enum:["selected","unselected"]}}};export const SceneHtmlTooltipProperties={title:e,tooltipVisibility:{type:["string"],enum:["on-hover","forced","forced-when-still","hidden"]}};

package/dist/domain/system-components/phoenix-entity-elements/child-entity-card-selector.d.ts

@@ -23,9 +23,8 @@ export interface ChildEntityCardSelectorSchema {
          */
         readonly instanceName: string;
         /**
-         * Array of violation type names that should be treated as fixable errors.
-         * Options that only trigger these violation types will remain enabled but show warnings.
-         * Other violation types will disable the option completely.
+         * Violation types to leave out of an option's tooltip. An option that would cause a `fatal` or `fixable`
+         * violation stays disabled whatever its type; a transformer that repairs the violation makes the option selectable.
          */
         readonly fixableViolations?: readonly string[];
         /**

package/dist/domain/system-components/phoenix-entity-elements/child-entity-list-selector.d.ts

@@ -20,9 +20,8 @@ export interface ChildEntityListSelectorSchema {
          */
         readonly instanceName: string;
         /**
-         * Array of violation type names that should be treated as warnings rather than errors.
-         * Options that trigger only these violations will remain selectable but show warning tooltips.
-         * Options triggering other violations will be disabled completely.
+         * Violation types to leave out of an option's tooltip. An option that would cause a `fatal` or `fixable`
+         * violation stays disabled whatever its type; a transformer that repairs the violation makes the option selectable.
          */
         readonly fixableViolations?: readonly string[];
         /**

package/dist/domain/system-components/phoenix-entity-elements/child-entity-toggle-selector.d.ts

@@ -20,9 +20,8 @@ export interface ChildEntityToggleSelectorSchema {
          */
         readonly instanceName: string;
         /**
-         * Array of violation type names that should be treated as warnings rather than errors.
-         * Options that trigger only these violations will remain selectable but show warning tooltips.
-         * Options triggering other violations will be disabled completely.
+         * Violation types to leave out of an option's tooltip. An option that would cause a `fatal` or `fixable`
+         * violation stays disabled whatever its type; a transformer that repairs the violation makes the option selectable.
          */
         readonly fixableViolations?: readonly string[];
         /**

package/dist/domain/system-definitions.js

@@ -1 +1 @@
-import{availableSystemComponents as e}from"./available-system-components.js";import{availableDefinitions as t}from"./core/index.js";export const getAllPhxDefinitions=()=>[...t,...e.map(e=>{let{definitions:t,...n}=e.schema;return n}),...e.flatMap(e=>Object.values(e.schema.definitions??{}).map(t=>{if("object"==typeof t&&"tsType"in t)return t;throw Error(`Schema definition in a component ${e.name} is not an extended json schema! Add a tsType to the schema.`)}))].reduce((e,t)=>{if(!t.tsType)throw Error(`Schema definition is not an extended json schema! Add a tsType to the schema. ${JSON.stringify(t)}`);return e[t.tsType]=t,e},{});
+import{availableSystemComponents as e}from"./available-system-components/index.js";import{availableDefinitions as t}from"./core/index.js";export const getAllPhxDefinitions=()=>[...t,...e.map(e=>{let{definitions:t,...n}=e.schema;return n}),...e.flatMap(e=>Object.values(e.schema.definitions??{}).map(t=>{if("object"==typeof t&&"tsType"in t)return t;throw Error(`Schema definition in a component ${e.name} is not an extended json schema! Add a tsType to the schema.`)}))].reduce((e,t)=>{if(!t.tsType)throw Error(`Schema definition is not an extended json schema! Add a tsType to the schema. ${JSON.stringify(t)}`);return e[t.tsType]=t,e},{});

package/dist/domain/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { memoEval } from './memo-eval.js';
+export { withProfilerLabel } from './profiler-label.js';

package/dist/domain/utils/index.js

@@ -0,0 +1 @@
+export{memoEval}from"./memo-eval.js";export{withProfilerLabel}from"./profiler-label.js";