@salsita-ai/sdk 0.50.0-develop.ae52227c7e → 0.50.0-develop.aec0f535bf

package/dist/domain/spec/invariants/invariants.d.ts

@@ -0,0 +1,14 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { ComponentEntry } from '../components/index.js';
+import type { SpecExpression } from '../expressions/index.js';
+import type { EntityOrAliasName, InvariantName } from '../model/index.js';
+import type { SpecInvariant } from './invariant.js';
+/**
+ * Validated invariants and the expressions/components they contribute to the application spec.
+ * Entries retain their entity-or-alias declaration keys while artifacts expand to concrete entity types.
+ */
+export type Invariants = Branded<'Invariants', {
+    readonly entries: Readonly<Record<EntityOrAliasName, Readonly<Record<InvariantName, SpecInvariant>>>>;
+    readonly expressions: readonly SpecExpression[];
+    readonly components: readonly ComponentEntry[];
+}>;

package/dist/domain/spec/invariants/invariants.js

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

package/dist/domain/spec/json-schema.d.ts

@@ -0,0 +1,52 @@
+import type { JsonSchemaType } from '../core/index.js';
+/**
+ * Plain AJV-ready JSON Schema — the output of `toRuntimeSchema` in `application-spec`.
+ *
+ * Identical in structure to `EnhancedJsonSchemaType` except the Phoenix-only
+ * extensions (`tsType`, `import`, `references`) are gone; those are
+ * stripped by `stripCustomKeywords` before this type is produced. All `$ref`
+ * targets are local (`#/$defs/{name}`) — no external references remain. Shapes
+ * stored under `$defs` are themselves `JsonSchema`s.
+ *
+ * Use this type anywhere the runtime AJV shape is required (validators,
+ * serializers, migration tools). Schema producers (`Shapes`, `CommonTypes`,
+ * relation inference) keep using `EnhancedJsonSchemaType`.
+ */
+export interface JsonSchema {
+    readonly id?: string;
+    readonly $ref?: string;
+    readonly $schema?: string;
+    readonly $defs?: Readonly<Record<string, JsonSchema>>;
+    readonly title?: string;
+    readonly description?: string;
+    readonly default?: unknown;
+    readonly format?: string;
+    readonly multipleOf?: number;
+    readonly maximum?: number;
+    readonly exclusiveMaximum?: boolean;
+    readonly minimum?: number;
+    readonly exclusiveMinimum?: boolean;
+    readonly maxLength?: number;
+    readonly minLength?: number;
+    readonly pattern?: string;
+    readonly additionalItems?: boolean | JsonSchema;
+    readonly items?: JsonSchema | readonly JsonSchema[];
+    readonly maxItems?: number;
+    readonly minItems?: number;
+    readonly uniqueItems?: boolean;
+    readonly maxProperties?: number;
+    readonly minProperties?: number;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean | JsonSchema;
+    readonly definitions?: Readonly<Record<string, JsonSchema>>;
+    readonly properties?: Readonly<Record<string, JsonSchema>>;
+    readonly patternProperties?: Readonly<Record<string, JsonSchema>>;
+    readonly dependencies?: Readonly<Record<string, JsonSchema | readonly string[]>>;
+    readonly enum?: readonly unknown[];
+    readonly type?: JsonSchemaType | readonly JsonSchemaType[];
+    readonly allOf?: readonly JsonSchema[];
+    readonly anyOf?: readonly JsonSchema[];
+    readonly oneOf?: readonly JsonSchema[];
+    readonly not?: JsonSchema;
+    readonly [k: string]: unknown;
+}

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/spec/modules/element-registration.d.ts

@@ -0,0 +1,125 @@
+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 ProjectModule } from './project-modules.js';
+export interface PhoenixEntityElementProps {
+    entityId: DomainEntityId<string>;
+    children?: ReactNode;
+}
+export type PhoenixEntityElementRegistration = {
+    type: 'entity';
+    name: string;
+    element: (props: PhoenixEntityElementProps) => JSX.Element;
+};
+export type PhoenixLayoutElementRegistration = {
+    type: 'layout';
+    name: string;
+    element: (props: PropsWithChildren) => JSX.Element;
+};
+export type PhoenixIconRegistration = {
+    type: 'icon';
+    elements: ReadonlyArray<(props: SvgIconProps) => JSX.Element>;
+};
+/**
+ * The component of one of the project's own assistant form elements, registered under the name its
+ * YAML declares it by in `assistant.formElements`. The component's props depend on the element's
+ * role and are typed by `phx.frontend.createAssistantFormElement` from the YAML; the registration
+ * itself is untyped, since the panel validates an element's attributes against the very declaration
+ * its props are typed from.
+ */
+export type AssistantFormElementRegistration = {
+    type: 'assistantFormElement';
+    name: string;
+    element: (props: never) => ReactNode;
+};
+export type ElementRegistration = PhoenixEntityElementRegistration | PhoenixLayoutElementRegistration | PhoenixIconRegistration | AssistantFormElementRegistration;
+export interface CustomPhoenixEntityElementProps {
+    entityId: DomainEntityId<string>;
+    children?: ReactNode;
+}
+type SchemaOfPhoenixLayoutElement<SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+}> = {
+    type: 'object';
+    properties: {
+        kind: {
+            type: 'string';
+            enum: [SCHEMA['kind']];
+        };
+        props?: {
+            type: 'object';
+            properties: Record<keyof SCHEMA['props'], any>;
+        };
+    };
+} & ExtendedJsonSchema;
+export interface PhoenixLayoutElementDefinition<SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+}> {
+    schema: SchemaOfPhoenixLayoutElement<SCHEMA>;
+    component: React.FunctionComponent<SCHEMA['props'] & {
+        children?: ReactNode;
+    }>;
+}
+/**
+ * Returns the component of a built-in layout element definition; it registers nothing. A layout
+ * element reaches the runtime only through a registration in `elements` or `defaultElements`.
+ *
+ * @deprecated Register a layout element with `createCustomPhoenixLayoutElement(name, component)`;
+ * the built-in ones are in `defaultConfiguratorElements` and `defaultAdminElements`. This API will
+ * be removed in a future version.
+ */
+export declare const createPhoenixLayoutElement: <SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+} = never>(element: PhoenixLayoutElementDefinition<SCHEMA>) => import("react").FunctionComponent<SCHEMA["props"] & {
+    children?: ReactNode;
+}>;
+export declare const createCustomPhoenixLayoutElement: (name: string, element: (props: PropsWithChildren) => JSX.Element) => PhoenixLayoutElementRegistration;
+export type CreateCustomPhoenixLayoutElement = (name: string, element: (props: PropsWithChildren) => JSX.Element) => PhoenixLayoutElementRegistration;
+/** Registers a component as the assistant form element of the name. */
+export declare const createAssistantFormElement: (name: string, element: (props: never) => ReactNode) => AssistantFormElementRegistration;
+type SchemaOfPhoenixElement<SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+}> = {
+    type: 'object';
+    properties: {
+        kind: {
+            type: 'string';
+            enum: [SCHEMA['kind']];
+        };
+        props?: {
+            type: 'object';
+            properties: Record<keyof SCHEMA['props'], any>;
+        };
+    };
+} & ExtendedJsonSchema;
+export interface PhoenixEntityElementDefinition<SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+}> {
+    schema: SchemaOfPhoenixElement<SCHEMA>;
+    component: React.FunctionComponent<SCHEMA['props'] & CustomPhoenixEntityElementProps>;
+}
+/**
+ * Returns the component of a built-in entity element definition; it registers nothing. An entity
+ * element reaches the runtime only through a registration in `elements` or `defaultElements`.
+ *
+ * @deprecated Register an entity element with `createCustomPhoenixEntityElement(name, component)`;
+ * the built-in ones are in `defaultConfiguratorElements` and `defaultAdminElements`. This API will
+ * be removed in a future version.
+ */
+export declare const createPhoenixEntityElement: <SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+} = never>(element: PhoenixEntityElementDefinition<SCHEMA>) => import("react").FunctionComponent<SCHEMA["props"] & CustomPhoenixEntityElementProps>;
+export declare const createCustomPhoenixEntityElement: (name: string, element: (props: CustomPhoenixEntityElementProps) => JSX.Element) => PhoenixEntityElementRegistration;
+export type CreateCustomPhoenixEntityElement = (name: string, element: (props: CustomPhoenixEntityElementProps) => JSX.Element) => PhoenixEntityElementRegistration;
+/** The element registrations of one `src/elements/` file; the editor keys its per-file reload cache on this. */
+export declare const resolveElementModule: (module: ProjectModule) => readonly ElementRegistration[];
+/** Validates the `src/elements/` files of an application config and flattens their registrations. */
+export declare const resolveElementModules: (modules: readonly ProjectModule[]) => readonly ElementRegistration[];
+export {};

package/dist/domain/spec/modules/element-registration.js

@@ -0,0 +1 @@
+import{SHARED_FOLDER_HINT as e,isRecord as t,resolveListModule as o}from"./project-modules.js";export const createPhoenixLayoutElement=e=>e.component;export const createCustomPhoenixLayoutElement=(e,t)=>({type:"layout",name:e,element:t});export const createAssistantFormElement=(e,t)=>({type:"assistantFormElement",name:e,element:t});export const createPhoenixEntityElement=e=>e.component;export const createCustomPhoenixEntityElement=(e,t)=>({type:"entity",name:e,element:t});let n={expected:"an element registration, or an array of them",fix:`Create it with phx.frontend.createCustomPhoenixLayoutElement(...), phx.frontend.createCustomPhoenixEntityElement(...) or phx.frontend.createAssistantFormElement(...), ${e}.`},r=e=>!!t(e)&&("icon"===e.type?Array.isArray(e.elements):("entity"===e.type||"layout"===e.type||"assistantFormElement"===e.type)&&"string"==typeof e.name&&"function"==typeof e.element);export const resolveElementModule=e=>o(e,n,r);export const resolveElementModules=e=>e.flatMap(resolveElementModule);

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

@@ -0,0 +1,12 @@
+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
+ * the YAML declares under `assistant.formElements` that no file in `src/elements/` registers, or
+ * that two register, and a registration of a name the YAML does not declare. Spec parsing cannot
+ * see which name a file registers, so the application checks this when it starts and on every hot
+ * reload, on the registrations of all element files together.
+ */
+export declare const findAssistantFormElementErrors: (formElements: ReadonlyArray<{
+    readonly name: string;
+}>, elements: readonly ElementRegistration[]) => readonly ImplementationError[];

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/spec/modules/index.d.ts

@@ -0,0 +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 { findAssistantFormElementErrors } from './find-assistant-form-element-errors.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 { 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/spec/modules/merge-expression-modules.d.ts

@@ -0,0 +1,23 @@
+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[]>>;
+/** The expression names that already have a value, by entity type, so no project file may define them. */
+export type ValuedExpressions = ReadonlyMap<string, ReadonlySet<string>>;
+/** Whether a file's default export has the shape of the expressions folder contract. */
+export declare const isExpressionExport: (value: unknown) => value is Record<string, Record<string, AnyAnonymousExpression>>;
+/**
+ * Merges the `src/expressions/` files (or `src/admin/expressions/`) into the expressions of each
+ * entity type. It checks each file against the folder contract, rejects an expression that two
+ * files, or two keys of one file, define for one entity type after the aliases of `aliasMap` are
+ * expanded, and rejects an expression listed in `valued`, which the application gives a value
+ * already. Each accepted expression gets its `origin`: its name and the entity type or alias the
+ * file keys it by.
+ *
+ * Each file is checked on its own: a wrong file is recorded in `errors` with all its conflicts and
+ * left out, and the files after it still merge. Without `errors`, everything recorded is thrown at
+ * the end as one `ImplementationErrors`.
+ */
+export declare const mergeExpressionModules: (modules: readonly ProjectModule[], aliasMap: AliasMap, errors?: ImplementationErrorCollector, valued?: ValuedExpressions) => AnyExpressions;
+export {};

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/spec/modules/project-modules.d.ts

@@ -0,0 +1,32 @@
+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.
+ *
+ * Generated barrels and the editor's hot reload hand project code to the SDK in this shape, without
+ * inspecting it. Each folder's resolver then checks the export against the folder's contract, so an
+ * invalid file fails with an error naming it instead of an unrelated crash later.
+ */
+export interface ProjectModule {
+    readonly origin: string;
+    readonly exports: unknown;
+}
+/** What a convention folder requires of its files, in the words used by the contract error. */
+export interface ProjectModuleContract {
+    readonly expected: string;
+    readonly fix: string;
+}
+export declare const SHARED_FOLDER_HINT = "or move the file to an underscore-prefixed folder such as src/_shared/ when it is shared code";
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+/**
+ * The error of a file whose default export does not match its folder's contract. `received` is the
+ * value the message reports: the export itself, or the item of an array export that fails. The
+ * code is `MISSING_EXPORT` when the file has no default export at all, and `INVALID_EXPORT`
+ * otherwise, also when an item of an array export is `undefined`.
+ */
+export declare const createContractError: (module: ProjectModule, contract: ProjectModuleContract, received: unknown) => ImplementationError;
+/**
+ * Checks a file of a folder whose contract is one item or an array of them, and returns its items.
+ * The first item that fails the check is the value the error reports.
+ */
+export declare const resolveListModule: <Item>(module: ProjectModule, contract: ProjectModuleContract, isItem: (value: unknown) => value is Item) => readonly Item[];

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/spec/modules/resolve-action-modules.d.ts

@@ -0,0 +1,4 @@
+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;