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

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

@@ -272,24 +272,28 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
         access: {
             selectConfiguratorRawAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null>;
             selectAdminRawAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null>;
             selectConfiguratorAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             }>;
             selectAdminAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
@@ -302,24 +306,28 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
             selectAdminConfigurationId: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, string>;
             getConfiguratorRawAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null;
             getAdminRawAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null;
             getConfiguratorAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             };
             getAdminAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
@@ -365,9 +373,9 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
                 selectIsViewMode: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, boolean>;
                 selectInitializationState: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").DomainContextInitializationState>;
                 selectComponentOptics: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, readonly import("../index.js").AnyDomainComponentOptic[]>;
-                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes<any, any, any, any, any>>;
+                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes>;
                 selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 }>;
@@ -407,9 +415,9 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
-                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 };
@@ -474,9 +482,9 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
                 selectIsViewMode: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, boolean>;
                 selectInitializationState: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").DomainContextInitializationState>;
                 selectComponentOptics: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, readonly import("../index.js").AnyDomainComponentOptic[]>;
-                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes<any, any, any, any, any>>;
+                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes>;
                 selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 }>;
@@ -516,9 +524,9 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
-                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 };
@@ -862,24 +870,28 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
         access: {
             selectConfiguratorRawAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null>;
             selectAdminRawAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null>;
             selectConfiguratorAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             }>;
             selectAdminAccessInfo: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
@@ -892,24 +904,28 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
             selectAdminConfigurationId: import("@salsita-ai/common/utils").Selector<import("./index.js").AccessSelectorState, string>;
             getConfiguratorRawAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null;
             getAdminRawAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null;
             getConfiguratorAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             };
             getAdminAccessInfo: () => {
                 raw: string;
+                access: import("@salsita-ai/contracts/api").AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
@@ -955,9 +971,9 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
                 selectIsViewMode: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, boolean>;
                 selectInitializationState: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").DomainContextInitializationState>;
                 selectComponentOptics: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, readonly import("../index.js").AnyDomainComponentOptic[]>;
-                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes<any, any, any, any, any>>;
+                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes>;
                 selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 }>;
@@ -997,9 +1013,9 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
-                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 };
@@ -1064,9 +1080,9 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
                 selectIsViewMode: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, boolean>;
                 selectInitializationState: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").DomainContextInitializationState>;
                 selectComponentOptics: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, readonly import("../index.js").AnyDomainComponentOptic[]>;
-                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes<any, any, any, any, any>>;
+                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, import("./index.js").ComponentReaderIndexes>;
                 selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<import("./index.js").DomainContextSelectorState, {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 }>;
@@ -1106,9 +1122,9 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
-                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
-                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 };

package/dist/domain/domain-runtime/errors/implementation-error-collector.d.ts

@@ -0,0 +1,19 @@
+import { type ImplementationError } from './implementation-error.js';
+/**
+ * Gathers the implementation errors of one application start. Checks that do not depend on each
+ * other run through `attempt`, so that the failure of one does not hide the failures of the others.
+ */
+export interface ImplementationErrorCollector {
+    /**
+     * Runs one independent check. An implementation error it throws is recorded and `fallback` is
+     * returned, so the checks after it still run. Anything else it throws propagates.
+     */
+    readonly attempt: <T>(check: () => T, fallback: T) => T;
+    readonly add: (error: ImplementationError) => void;
+    /**
+     * Throws the recorded errors as one {@link ImplementationErrors}, in the order they were
+     * recorded. Does nothing when there are none.
+     */
+    readonly throwIfAny: () => void;
+}
+export declare const createImplementationErrorCollector: () => ImplementationErrorCollector;

package/dist/domain/domain-runtime/errors/implementation-error-collector.js

@@ -0,0 +1 @@
+import{isImplementationError as r}from"./implementation-error.js";import{ImplementationErrors as t,isImplementationErrors as e}from"./implementation-errors.js";export const createImplementationErrorCollector=()=>{let o=[],n=r=>{o.push(r)};return{add:n,attempt:(t,o)=>{try{return t()}catch(t){if(e(t))return t.errors.forEach(n),o;if(r(t))return n(t),o;throw t}},throwIfAny:()=>{if(o.length>0)throw new t(o)}}};

package/dist/domain/domain-runtime/errors/implementation-error.d.ts

@@ -0,0 +1,46 @@
+/**
+ * What kind of mistake an {@link ImplementationError} reports. A host that shows the error, such as
+ * a webhook log, reads the code instead of parsing the message.
+ *
+ * - `MISSING_EXPORT`: a convention file exports nothing where its folder requires an export.
+ * - `INVALID_EXPORT`: a convention file exports a value that does not match its folder's contract.
+ * - `MISSING_IMPLEMENTATION`: the spec declares something that no project file implements.
+ * - `DUPLICATE_DEFINITION`: two files define what only one may define.
+ * - `INVALID_CONFIGURATION`: the application's configuration is incomplete or contradictory.
+ * - `STARTUP_FAILED`: project or SDK code threw while the application was starting.
+ */
+export type ImplementationErrorCode = 'MISSING_EXPORT' | 'INVALID_EXPORT' | 'MISSING_IMPLEMENTATION' | 'DUPLICATE_DEFINITION' | 'INVALID_CONFIGURATION' | 'STARTUP_FAILED';
+/** The parts an {@link ImplementationError} is made of. Its message is built from them. */
+export interface ImplementationErrorProps {
+    readonly code: ImplementationErrorCode;
+    /** Project-relative path of the file to fix, or `null` when the mistake belongs to no single file. */
+    readonly origin: string | null;
+    /** What went wrong, without the file name and without a full stop. */
+    readonly problem: string;
+    /** What the SDK requires at that place, when the mistake is a wrong value. */
+    readonly expected?: string;
+    /** What it found instead. It is part of the message only together with `expected`. */
+    readonly received?: string;
+    /** What the developer can do to fix it, as one or more full sentences. */
+    readonly fix: string;
+    /** What was thrown, when the error reports a failure of other code. */
+    readonly cause?: unknown;
+}
+/**
+ * A mistake in a project's implementation that stops its application from starting: a convention
+ * file with the wrong export, a definition made twice, a project file that throws.
+ *
+ * The checks the domain runtime runs on a project's files throw it, so that every host of the
+ * runtime (the web component, the editor, a webhook) can tell it from a defect of its own and report
+ * it in its own medium. `message` is the whole report as one text; the fields hold its parts.
+ */
+export declare class ImplementationError extends Error {
+    readonly code: ImplementationErrorCode;
+    readonly origin: string | null;
+    readonly problem: string;
+    readonly expected: string | null;
+    readonly received: string | null;
+    readonly fix: string;
+    constructor(props: ImplementationErrorProps);
+}
+export declare const isImplementationError: (error: unknown) => error is ImplementationError;

package/dist/domain/domain-runtime/errors/implementation-error.js

@@ -0,0 +1 @@
+export class ImplementationError extends Error{code;origin;problem;expected;received;fix;constructor(e){let i,r,o;super((i=null===e.origin?"":` in ${e.origin}`,r=void 0===e.received?"":`, but got ${e.received}`,o=void 0===e.expected?"":`: expected ${e.expected}${r}`,`${e.problem}${i}${o}. ${e.fix}`),void 0===e.cause?void 0:{cause:e.cause}),this.name="ImplementationError",this.code=e.code,this.origin=e.origin,this.problem=e.problem,this.expected=e.expected??null,this.received=e.received??null,this.fix=e.fix}}export const isImplementationError=e=>e instanceof ImplementationError;

package/dist/domain/domain-runtime/errors/implementation-errors.d.ts

@@ -0,0 +1,13 @@
+import type { ImplementationError } from './implementation-error.js';
+/**
+ * Every {@link ImplementationError} one start of an application found, reported together, so that a
+ * developer with four wrong files reads four errors instead of fixing them one reload at a time.
+ *
+ * The message of a list with one error is that error's message. The message of a longer list is a
+ * headline with the count, followed by one numbered line per error in the order of `errors`.
+ */
+export declare class ImplementationErrors extends Error {
+    readonly errors: readonly ImplementationError[];
+    constructor(errors: readonly ImplementationError[]);
+}
+export declare const isImplementationErrors: (error: unknown) => error is ImplementationErrors;

package/dist/domain/domain-runtime/errors/implementation-errors.js

@@ -0,0 +1 @@
+export class ImplementationErrors extends Error{errors;constructor(r){super((r=>{let[e]=r;return 1===r.length&&e?e.message:[`The application cannot start: ${r.length} implementation errors were found.`,...r.map((r,e)=>`${e+1}. ${r.message}`)].join("\n")})(r)),this.name="ImplementationErrors",this.errors=r}}export const isImplementationErrors=r=>r instanceof ImplementationErrors;

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

@@ -0,0 +1,4 @@
+export { type ImplementationErrorCode, type ImplementationErrorProps, ImplementationError, isImplementationError, } from './implementation-error.js';
+export { type ImplementationErrorCollector, createImplementationErrorCollector, } from './implementation-error-collector.js';
+export { ImplementationErrors, isImplementationErrors } from './implementation-errors.js';
+export { type StartupStage, toImplementationErrors } from './to-implementation-errors.js';

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

@@ -0,0 +1 @@
+export{ImplementationError,isImplementationError}from"./implementation-error.js";export{createImplementationErrorCollector}from"./implementation-error-collector.js";export{ImplementationErrors,isImplementationErrors}from"./implementation-errors.js";export{toImplementationErrors}from"./to-implementation-errors.js";

package/dist/domain/domain-runtime/errors/to-implementation-errors.d.ts

@@ -0,0 +1,10 @@
+import { ImplementationErrors } from './implementation-errors.js';
+/** The step of an application start during which a failure that the SDK did not raise itself was caught. */
+export type StartupStage = 'import' | 'initialize' | 'render';
+/**
+ * Turns whatever stopped an application from starting into a list of implementation errors, so that
+ * a host handles one shape. A list is passed through and a single implementation error becomes a
+ * list of one. Anything else, such as a project file that throws while it loads, becomes one
+ * `STARTUP_FAILED` error that names the stage and keeps what was thrown as its `cause`.
+ */
+export declare const toImplementationErrors: (error: unknown, stage: StartupStage) => ImplementationErrors;

package/dist/domain/domain-runtime/errors/to-implementation-errors.js

@@ -0,0 +1 @@
+import{ImplementationError as e,isImplementationError as i}from"./implementation-error.js";import{ImplementationErrors as t,isImplementationErrors as r}from"./implementation-errors.js";let n={import:"while its code was loading",initialize:"while its runtime was initializing",render:"while it was rendering"};export const toImplementationErrors=(o,a)=>r(o)?o:i(o)?new t([o]):new t([new e({code:"STARTUP_FAILED",origin:null,problem:`The application failed ${n[a]}: ${o instanceof Error?o.message:String(o)}`,fix:"Read the stack trace of the cause to find the file that threw, and fix the code it points to.",cause:o})]);

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

@@ -1,6 +1,7 @@
 export * from './domain-runtime.js';
 export * from './domain-context/index.js';
 export * from './domain-services/index.js';
+export { type ImplementationErrorCode, type ImplementationErrorProps, type StartupStage, ImplementationError, ImplementationErrors, isImplementationError, isImplementationErrors, toImplementationErrors, } from './errors/index.js';
 export * from './spec/index.js';
 export * from './environment/index.js';
 export * from './access/index.js';

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

@@ -1 +1 @@
-export*from"./domain-runtime.js";export*from"./domain-context/index.js";export*from"./domain-services/index.js";export*from"./spec/index.js";export*from"./environment/index.js";export*from"./access/index.js";export*from"./overrides/index.js";export*from"./loaded-data/index.js";export*from"./domain-data/index.js";export*from"./session-context/index.js";export*from"./web-component/index.js";
+export*from"./domain-runtime.js";export*from"./domain-context/index.js";export*from"./domain-services/index.js";export{ImplementationError,ImplementationErrors,isImplementationError,isImplementationErrors,toImplementationErrors}from"./errors/index.js";export*from"./spec/index.js";export*from"./environment/index.js";export*from"./access/index.js";export*from"./overrides/index.js";export*from"./loaded-data/index.js";export*from"./domain-data/index.js";export*from"./session-context/index.js";export*from"./web-component/index.js";

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

@@ -1,3 +1,14 @@
 import type { AnyApplicationConfig } from '../../application/index.js';
 import type { ApplicationSpec } from './types.js';
+/**
+ * Builds the runtime spec of an application from its config.
+ *
+ * Project files reach the config unchecked; this is where each one is held to its folder's
+ * contract. Every file is checked on its own, and all the files that break their contract are
+ * thrown together as one `ImplementationErrors`. Its errors are ordered by folder (handlers,
+ * elements, transformers, configurator components, admin components) and inside a folder by the
+ * order of the config's list. No spec is returned when a file is wrong, so nothing that reads the
+ * spec, such as the transformer selection, runs on a list with a file missing and reports the
+ * mistake a second time.
+ */
 export declare const initializeSpec: (config: AnyApplicationConfig) => ApplicationSpec;

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

@@ -1 +1 @@
-import{SessionRole as e}from"@salsita-ai/contracts/api";import{resolveComponentOpticModules as t,resolveElementModules as a,resolveHandlerModules as n,resolveImportedTransformers as o,resolveTransformerModules as i}from"./module-checks/index.js";export const initializeSpec=s=>{let r=s.adminDomain.presets[0];if(!r)throw Error("Cannot register application spec because admin preset is required.");let m=n(s.handlers),c=a(s.elements),d=(e=>{let t={};for(let a of e)t[a.name]=(void 0)??a.name;return t})(m),l=(e=>{let t={},a=0;for(let n of e)if("entity"===n.type||"layout"===n.type)t[n.name]=(void 0)??n.name;else{let e=`icon:${a}`;t[e]=(void 0)??`${e}:${n.elements.length}`,a+=1}return t})(c),p=i(s.transformers?.importedTransformers??[]),y=s.transformers?.specTransformers??[];return{version:s.version,dataConfig:s.dataSpec??null,chunks:s.chunks,publishedDataHash:s.publishedDataHash,initialPublishedData:s.initialPublishedData,canCreate:s.features?.acl?.canCreate??Object.values(e),enableAdminRelease:s.features?.enableAdminRelease??!1,textLanguages:s.domain.textLanguages??s.adminDomain.textLanguages??["en"],baseResourcesUrl:s.resources?.baseResourcesUrl??s.defaultEnvs?.resourcesUrl??"",configurator:{factory:s.domain.domainFactory,presets:s.domain.presets,aliasMap:s.domain.domainFactory.context.aliasMap,entityReflections:s.domain.domainFactory.context.entityReflections,$entityReflections:s.domain.domainFactory.context.$entityReflections,expressions:s.domain.domainFactory.context.expressions,actions:s.domain.domainFactory.context.actions,actionImplementations:s.domain.domainFactory.context.actionImplementations,allowedRootEntityTypes:s.domain.domainFactory.context.allowedRootEntityTypes,migrate:s.domain.domainFactory.context.migrate,componentOptics:t(s.domain.componentOptics),createTransformers:e=>o(p,y,e),navigationStates:s.navigation?.navigationStates??[],viewStates:s.navigation?.viewStates??[],toolStates:s.navigation?.toolStates??[],exportStates:s.navigation?.exportStates??[],handlers:m,handlerHashes:d,elements:c,elementHashes:l,appLoader:s.ui?.appLoader??"universal",preview:s.ui?.preview??"auto",alwaysExpand:s.ui?.alwaysExpand??!1,theme:s.ui?.theme??{},assistant:s.assistant??null,deploymentQueryDisabled:s.resources?.deploymentQueryDisabled??!1,prefetchTextureUrls:s.resources?.prefetchTextureUrls??[],modelVersion:s.domain.domainFactory.modelVersion},admin:{factory:s.adminDomain.domainFactory,modelVersion:s.adminDomain.domainFactory.modelVersion,aliasMap:s.adminDomain.domainFactory.context.aliasMap,entityReflections:s.adminDomain.domainFactory.context.entityReflections,$entityReflections:s.adminDomain.domainFactory.context.$entityReflections,expressions:s.adminDomain.domainFactory.context.expressions,actions:s.adminDomain.domainFactory.context.actions,actionImplementations:s.adminDomain.domainFactory.context.actionImplementations,allowedRootEntityTypes:s.adminDomain.domainFactory.context.allowedRootEntityTypes,migrate:s.adminDomain.domainFactory.context.migrate,preset:r,componentOptics:t(s.adminDomain.componentOptics),navigationStates:s.adminNavigation?.navigationStates??[],viewStates:s.adminNavigation?.viewStates??[],handlers:m,handlerHashes:d,elements:c,elementHashes:l}}};
+import{SessionRole as e}from"@salsita-ai/contracts/api";import{createImplementationErrorCollector as t}from"../errors/index.js";import{resolveComponentOpticModules as a,resolveElementModule as n,resolveHandlerModule as o,resolveImportedTransformers as i,resolveTransformerModule as s}from"./module-checks/index.js";let r=(e,t,a)=>e.flatMap(e=>a.attempt(()=>t(e),[]));export const initializeSpec=m=>{let c=m.adminDomain.presets[0];if(!c)throw Error("Cannot register application spec because admin preset is required.");let d=t(),l=r(m.handlers,o,d),p=r(m.elements,n,d),y=r(m.transformers?.importedTransformers??[],e=>[s(e)],d),u=r(m.domain.componentOptics,e=>a([e]),d),f=r(m.adminDomain.componentOptics,e=>a([e]),d);d.throwIfAny();let x=(e=>{let t={};for(let a of e)t[a.name]=(void 0)??a.name;return t})(l),g=(e=>{let t={},a=0;for(let n of e)if("entity"===n.type||"layout"===n.type)t[n.name]=(void 0)??n.name;else{let e=`icon:${a}`;t[e]=(void 0)??`${e}:${n.elements.length}`,a+=1}return t})(p),v=m.transformers?.specTransformers??[];return{version:m.version,dataConfig:m.dataSpec??null,chunks:m.chunks,publishedDataHash:m.publishedDataHash,initialPublishedData:m.initialPublishedData,canCreate:m.features?.acl?.canCreate??Object.values(e),enableAdminRelease:m.features?.enableAdminRelease??!1,textLanguages:m.domain.textLanguages??m.adminDomain.textLanguages??["en"],baseResourcesUrl:m.resources?.baseResourcesUrl??m.defaultEnvs?.resourcesUrl??"",configurator:{factory:m.domain.domainFactory,presets:m.domain.presets,aliasMap:m.domain.domainFactory.context.aliasMap,entityReflections:m.domain.domainFactory.context.entityReflections,$entityReflections:m.domain.domainFactory.context.$entityReflections,expressions:m.domain.domainFactory.context.expressions,actions:m.domain.domainFactory.context.actions,actionImplementations:m.domain.domainFactory.context.actionImplementations,allowedRootEntityTypes:m.domain.domainFactory.context.allowedRootEntityTypes,migrate:m.domain.domainFactory.context.migrate,componentOptics:u,createTransformers:e=>i(y,v,e),navigationStates:m.navigation?.navigationStates??[],viewStates:m.navigation?.viewStates??[],toolStates:m.navigation?.toolStates??[],exportStates:m.navigation?.exportStates??[],handlers:l,handlerHashes:x,elements:p,elementHashes:g,appLoader:m.ui?.appLoader??"universal",preview:m.ui?.preview??"auto",alwaysExpand:m.ui?.alwaysExpand??!1,theme:m.ui?.theme??{},assistant:m.assistant??null,deploymentQueryDisabled:m.resources?.deploymentQueryDisabled??!1,prefetchTextureUrls:m.resources?.prefetchTextureUrls??[],modelVersion:m.domain.domainFactory.modelVersion},admin:{factory:m.adminDomain.domainFactory,modelVersion:m.adminDomain.domainFactory.modelVersion,aliasMap:m.adminDomain.domainFactory.context.aliasMap,entityReflections:m.adminDomain.domainFactory.context.entityReflections,$entityReflections:m.adminDomain.domainFactory.context.$entityReflections,expressions:m.adminDomain.domainFactory.context.expressions,actions:m.adminDomain.domainFactory.context.actions,actionImplementations:m.adminDomain.domainFactory.context.actionImplementations,allowedRootEntityTypes:m.adminDomain.domainFactory.context.allowedRootEntityTypes,migrate:m.adminDomain.domainFactory.context.migrate,preset:c,componentOptics:f,navigationStates:m.adminNavigation?.navigationStates??[],viewStates:m.adminNavigation?.viewStates??[],handlers:l,handlerHashes:x,elements:p,elementHashes:g}}};

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

@@ -1,3 +1,4 @@
+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.
@@ -17,7 +18,13 @@ export interface ProjectModuleContract {
 }
 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>;
-export declare const createContractError: (origin: string, contract: ProjectModuleContract, received: unknown) => Error;
+/**
+ * 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.

package/dist/domain/domain-runtime/spec/module-checks/project-modules.js

@@ -1 +1 @@
-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=(e,r,t)=>Error(`Invalid default export in ${e}: expected ${r.expected}, but got ${(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)}`})(t)}. Every file in this folder is loaded by convention, so each one must default-export that shape. ${r.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.origin,r,i);n.push(i)}return n};
+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/resolve-action-modules.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as o}from"./project-modules.js";let i={expected:"an object of action implementations keyed by action name",fix:`Create it with phx.domain.implementActions({ ... }), ${e}.`},n=e=>"function"==typeof e;export const resolveActionModules=e=>e.reduce((e,r)=>{let c;if(!(o(c=r.exports)&&Object.values(c).every(n)))throw t(r.origin,i,r.exports);return{...e,...r.exports}},{});
+import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as o}from"./project-modules.js";let i={expected:"an object of action implementations keyed by action name",fix:`Create it with phx.domain.implementActions({ ... }), ${e}.`},n=e=>"function"==typeof e;export const resolveActionModules=e=>e.reduce((e,r)=>{let c;if(!(o(c=r.exports)&&Object.values(c).every(n)))throw t(r,i,r.exports);return{...e,...r.exports}},{});

package/dist/domain/domain-runtime/spec/module-checks/resolve-expression-modules.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as e,createContractError as o,isRecord as t}from"./project-modules.js";let i={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/), ${e}.`},r=e=>t(e)&&"function"==typeof e.evaluate,n=e=>t(e)&&Object.values(e).every(r);export const resolveExpressionModules=(e,r)=>{let s=new Map;return e.map(e=>{let p;if(!(t(p=e.exports)&&Object.values(p).every(n)))throw o(e.origin,i,e.exports);for(let[o,t]of Object.entries(e.exports))for(let i of r[o]??[o])for(let o of Object.keys(t)){let t=`${i}.${o}`,r=s.get(t);if(void 0!==r&&r!==e.origin)throw Error(`Duplicate expression ${t}: it is defined in both ${r} and ${e.origin}, which would make its value depend on file order. Keep one definition and remove the other.`);s.set(t,e.origin)}return{origin:e.origin,expressions:e.exports}})};
+import{SHARED_FOLDER_HINT as e,createContractError as o,isRecord as t}from"./project-modules.js";let i={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/), ${e}.`},r=e=>t(e)&&"function"==typeof e.evaluate,n=e=>t(e)&&Object.values(e).every(r);export const resolveExpressionModules=(e,r)=>{let s=new Map;return e.map(e=>{let p;if(!(t(p=e.exports)&&Object.values(p).every(n)))throw o(e,i,e.exports);for(let[o,t]of Object.entries(e.exports))for(let i of r[o]??[o])for(let o of Object.keys(t)){let t=`${i}.${o}`,r=s.get(t);if(void 0!==r&&r!==e.origin)throw Error(`Duplicate expression ${t}: it is defined in both ${r} and ${e.origin}, which would make its value depend on file order. Keep one definition and remove the other.`);s.set(t,e.origin)}return{origin:e.origin,expressions:e.exports}})};

package/dist/domain/domain-runtime/spec/module-checks/resolve-imported-transformers.d.ts

@@ -1,15 +1,13 @@
 import type { ImportedTransformer, SpecTransformer } from '../../../application/index.js';
-import type { $DomainEntity, DomainEntity } from '../../../core/index.js';
-import type { DomainContextSystems, Transformers } from '../../../domain-context/index.js';
+import type { AnyDomainContextSystems, Transformers } from '../../../domain-context/index.js';
 import { type ProjectModule } from './project-modules.js';
-type AnyImportedTransformer = ImportedTransformer<any, any, any, any, any, any, any>;
 /**
  * The transformer of one `src/transformers/` file, named after the file. The spec's `transformers` section
  * selects a plain-function export by that name; a transformer made with `build(name)` registers under its own.
  */
-export declare const resolveTransformerModule: (module: ProjectModule) => AnyImportedTransformer;
+export declare const resolveTransformerModule: (module: ProjectModule) => ImportedTransformer;
 /** Validates the `src/transformers/` files of an application config and names each after its file. */
-export declare const resolveTransformerModules: (modules: readonly ProjectModule[]) => readonly AnyImportedTransformer[];
+export declare const resolveTransformerModules: (modules: readonly ProjectModule[]) => readonly ImportedTransformer[];
 /**
  * Resolves imported transformer modules against spec transformer declarations.
  * Each imported transformer is registered/executed with the domain context,
@@ -17,6 +15,8 @@ export declare const resolveTransformerModules: (modules: readonly ProjectModule
  *
  * Used both when the runtime spec is initialized from the application config and at hot-reload time
  * (via domain-context subscription to registry changes).
+ *
+ * The transformers come from untyped project modules, so the context and the result have the open types of
+ * `AnyCreateTransformersFactory`, the slot of the runtime spec this function fills.
  */
-export declare const resolveImportedTransformers: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string>(importedTransformers: ReadonlyArray<ImportedTransformer<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>>, specTransformers: readonly SpecTransformer[], ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => Transformers<ENTITIES>;
-export {};
+export declare const resolveImportedTransformers: (importedTransformers: readonly ImportedTransformer[], specTransformers: readonly SpecTransformer[], ctx: AnyDomainContextSystems) => Transformers<any>;

package/dist/domain/domain-runtime/spec/module-checks/resolve-imported-transformers.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as r,createContractError as e,isRecord as t}from"./project-modules.js";let o={expected:"a transformer (a function of the domain context, or an object with a register method), or an array of them",fix:`Create it with phx.frontend.transformerBuilder, ${r}.`},n=r=>"function"==typeof r||t(r)&&"function"==typeof r.register;export const resolveTransformerModule=r=>{let t;if(!(Array.isArray(t=r.exports)?t.every(n):n(t)))throw e(r.origin,o,r.exports);return{name:r.origin.replace(/^.*\//,"").replace(/\.tsx?$/,""),transformer:r.exports}};export const resolveTransformerModules=r=>r.map(resolveTransformerModule);export const resolveImportedTransformers=(r,e,t)=>{let o=r.flatMap(({name:r,transformer:e})=>{if(Array.isArray(e))return e.map((e,o)=>{if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:`${r}[${o}]`};throw Error(`Transformer '${r}[${o}]' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)});if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:r};throw Error(`Transformer '${r}' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)}),n=[];for(let r of e){let e=o.find(e=>e.name===r.name);if(!e){let e=o.map(r=>r.name).filter(Boolean).join(", ");throw Error(`Transformer '${r.name}' not found in imported transformer files. Available transformers: ${e||"none"}`)}n.push({priority:r.priority??1/0,transformer:e.transformer,name:r.name})}return n};
+import{SHARED_FOLDER_HINT as r,createContractError as e,isRecord as t}from"./project-modules.js";let o={expected:"a transformer (a function of the domain context, or an object with a register method), or an array of them",fix:`Create it with phx.frontend.transformerBuilder, ${r}.`},n=r=>"function"==typeof r||t(r)&&"function"==typeof r.register;export const resolveTransformerModule=r=>{let t;if(!(Array.isArray(t=r.exports)?t.every(n):n(t)))throw e(r,o,r.exports);return{name:r.origin.replace(/^.*\//,"").replace(/\.tsx?$/,""),transformer:r.exports}};export const resolveTransformerModules=r=>r.map(resolveTransformerModule);export const resolveImportedTransformers=(r,e,t)=>{let o=r.flatMap(({name:r,transformer:e})=>{if(Array.isArray(e))return e.map((e,o)=>{if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:`${r}[${o}]`};throw Error(`Transformer '${r}[${o}]' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)});if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:r};throw Error(`Transformer '${r}' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)}),n=[];for(let r of e){let e=o.find(e=>e.name===r.name);if(!e){let e=o.map(r=>r.name).filter(Boolean).join(", ");throw Error(`Transformer '${r.name}' not found in imported transformer files. Available transformers: ${e||"none"}`)}n.push({priority:r.priority??1/0,transformer:e.transformer,name:r.name})}return n};

package/dist/domain/domain-runtime/spec/module-checks/resolve-invariant-modules.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as r}from"./project-modules.js";let o={expected:"an object of invariant lists keyed by entity type or alias",fix:`Create it with phx.domain.implementCustomInvariants({ ... }) (phx.domain.admin.implementCustomInvariants({ ... }) under src/admin/), ${e}.`},i=e=>r(e)&&"function"==typeof e.evaluate,n=e=>r(e)&&Object.values(e).every(e=>Array.isArray(e)&&e.every(i));export const resolveInvariantModules=e=>{let r={};for(let i of e){if(!n(i.exports))throw t(i.origin,o,i.exports);for(let[e,t]of Object.entries(i.exports))r[e]=[...r[e]??[],...t]}return r};
+import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as r}from"./project-modules.js";let o={expected:"an object of invariant lists keyed by entity type or alias",fix:`Create it with phx.domain.implementCustomInvariants({ ... }) (phx.domain.admin.implementCustomInvariants({ ... }) under src/admin/), ${e}.`},i=e=>r(e)&&"function"==typeof e.evaluate,n=e=>r(e)&&Object.values(e).every(e=>Array.isArray(e)&&e.every(i));export const resolveInvariantModules=e=>{let r={};for(let i of e){if(!n(i.exports))throw t(i,o,i.exports);for(let[e,t]of Object.entries(i.exports))r[e]=[...r[e]??[],...t]}return r};

package/dist/domain/extensions/attribute-switch.d.ts

@@ -1,5 +1,5 @@
 export declare const AttributeSwitchValueSchema: {
-    readonly type: ["string", "number", "boolean"];
+    readonly type: 'boolean';
 };
 export type AttributeSwitchComponentState = {
     readonly value: boolean;

package/dist/domain/extensions/attribute-switch.js

@@ -1 +1 @@
-import{SystemComponentBuilder as t}from"../core/index.js";export const AttributeSwitchValueSchema={type:["string","number","boolean"]};export const attributeSwitchComponent=t.component("attributeSwitch").withState({type:"object",properties:{value:AttributeSwitchValueSchema},tsType:"AttributeSwitchComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AttributeSwitchComponentState"}],required:["value"],additionalProperties:!1}).withWritableKeys(["value"]).build();
+import{SystemComponentBuilder as t}from"../core/index.js";export const AttributeSwitchValueSchema={type:"boolean"};export const attributeSwitchComponent=t.component("attributeSwitch").withState({type:"object",properties:{value:AttributeSwitchValueSchema},tsType:"AttributeSwitchComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AttributeSwitchComponentState"}],required:["value"],additionalProperties:!1}).withWritableKeys(["value"]).build();

package/dist/domain/extensions/canvas-config.d.ts

@@ -41,7 +41,7 @@ export type CanvasConfigComponentState = {
     /**
      * Can be "high-performance", "low-power" or "default"
      */
-    readonly powerPreference?: string | undefined;
+    readonly powerPreference?: 'high-performance' | 'low-power' | 'default' | undefined;
     /**
      * default is true.
      */

package/dist/domain/extensions/client-side-image.d.ts

@@ -1,10 +1,10 @@
-import { type Color } from '@salsita-ai/common/utils';
+import { type HexColor } from '@salsita-ai/common/utils';
 export type ClientSideImageComponentState = {
     readonly exportState: string;
     readonly width: number;
     readonly height: number;
     readonly fileFormat: 'PNG' | 'JPEG';
-    readonly backgroundColor?: Color;
+    readonly backgroundColor?: HexColor;
     readonly toolState: string;
     readonly viewState: string;
     readonly navigationState: string;

package/dist/domain/extensions/client-side-image.js

@@ -1 +1 @@
-import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const clientSideImageComponent=t.component("clientSideImage").withState({type:"object",tsType:"ClientSideImageComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ClientSideImageComponentState"}],properties:{exportState:{type:"string"},width:{type:"number"},height:{type:"number"},fileFormat:{type:"string",enum:["PNG","JPEG"]},backgroundColor:{type:"string",pattern:"^#[0-9a-fA-F]{6}$"},toolState:{type:"string"},viewState:{type:"string"},navigationState:{type:"string"}},required:["exportState","width","height","fileFormat","toolState","viewState","navigationState"],additionalProperties:!1}).build();export const isClientSideImageComponentSnapshot=e(clientSideImageComponent);
+import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const clientSideImageComponent=t.component("clientSideImage").withState({type:"object",tsType:"ClientSideImageComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ClientSideImageComponentState"}],properties:{exportState:{type:"string"},width:{type:"number"},height:{type:"number"},fileFormat:{type:"string",enum:["PNG","JPEG"]},backgroundColor:{type:"string",pattern:"^#[0-9a-fA-F]{6}$",tsType:"HexColor",import:[{module:"@salsita-ai/sdk/common/utils",member:"HexColor"}]},toolState:{type:"string"},viewState:{type:"string"},navigationState:{type:"string"}},required:["exportState","width","height","fileFormat","toolState","viewState","navigationState"],additionalProperties:!1}).build();export const isClientSideImageComponentSnapshot=e(clientSideImageComponent);

package/dist/domain/extensions/common/angle-indicator-schema.d.ts

@@ -71,9 +71,9 @@ export type AngleIndicatorBaseState = {
      */
     readonly labelFontStyle?: 'normal' | 'italic';
     /**
-     * Font weight, which can be a numeric value, 'normal', or 'bold'.
+     * Font weight: a number, or a keyword such as 'normal' or 'bold'.
      */
-    readonly labelFontWeight?: number | 'normal' | 'bold';
+    readonly labelFontWeight?: number | string;
     /**
      * Spacing between letters. Default is 0.
      */

package/dist/domain/extensions/common/dimension-indicator-schema.d.ts

@@ -119,10 +119,10 @@ export type DimensionIndicatorBaseState = {
      */
     readonly labelFontStyle?: 'normal' | 'italic';
     /**
-     * Font weight, which can be a numeric value, 'normal', or 'bold'.
+     * Font weight: a number, or a keyword such as 'normal' or 'bold'.
      * See https://protectwise.github.io/troika/troika-three-text/
      */
-    readonly labelFontWeight?: number | 'normal' | 'bold';
+    readonly labelFontWeight?: number | string;
     /**
      * Spacing between letters. Default is 0.
      * See https://protectwise.github.io/troika/troika-three-text/

package/dist/domain/extensions/editable-angle-indicator.d.ts

@@ -10,7 +10,7 @@ export type EditableAngleIndicatorComponentState = AngleIndicatorBaseState & Sce
     /**
      * An array of fixable violations. They will be ignored in the violation hint.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * The label of the input field.
      */

package/dist/domain/extensions/editable-distance-dimension-indicator.d.ts

@@ -10,7 +10,7 @@ export type EditableDistanceDimensionIndicatorComponentState = DimensionIndicato
     /**
      * An array of fixable violations. They will be ignored in the violation hint.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * The label of the input field.
      */

package/dist/domain/extensions/editable-offset-indicator.d.ts

@@ -13,7 +13,7 @@ export type EditableOffsetIndicatorComponentState = OffsetIndicatorComponentStat
     /**
      * Violation names to ignore when computing hints for the edit input.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * Label displayed on the edit input field.
      */

package/dist/domain/extensions/editable-offset-indicator.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as t}from"@salsita-ai/common/utils";import{SystemComponentBuilder as e,isSnapshotOfComponentType as i}from"../core/index.js";import{DimensionUnitSchema as n,UnitsConfigSchema as r}from"../dimensions/index.js";import{SceneHtmlOpacityProperties as o,SceneHtmlVisibilityProperties as a}from"../system-components/index.js";import{DimensionIndicatorBaseProperties as s,EditableIndicatorButtonVariantSchema as p}from"./common/index.js";export const editableOffsetIndicatorComponent=e.component("editableOffsetIndicator").withState({tsType:"EditableOffsetIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"EditableOffsetIndicatorComponentState"}],type:"object",properties:{...s,targetEntityOffsetAnchors:{type:"array",items:{type:"string"}},targetReferenceOffsetAnchors:{type:"array",items:{type:"string"}},referenceEntityIds:{type:"array",items:{type:"string"}},directionVector:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},additionalProperties:!1},directionVectorRelativeToEntityId:{type:"string"},maxDistance:{type:["number","null"]},minDistance:{type:["number","null"]},maxPerpendicularDistance:{type:["number","null"]},minPerpendicularDistance:{type:["number","null"]},visible:{type:"boolean"},force:{type:"boolean"},displayUnit:n,unitDisplayConfig:r,...o,...a,targetOffset:{type:"string"},fixableViolations:{type:"array",items:{type:"string"}},inputLabel:t,modalTitle:t,modalText:t,helperText:t,buttonVariant:p},required:["targetOffset","targetEntityOffsetAnchors","targetReferenceOffsetAnchors","directionVector"],additionalProperties:!1}).build();export const isEditableOffsetIndicatorSnapshot=i(editableOffsetIndicatorComponent);
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as t,SystemComponentBuilder as i,isSnapshotOfComponentType as n}from"../core/index.js";import{DimensionUnitSchema as r,UnitsConfigSchema as o}from"../dimensions/index.js";import{SceneHtmlOpacityProperties as a,SceneHtmlVisibilityProperties as s}from"../system-components/index.js";import{DimensionIndicatorBaseProperties as p,EditableIndicatorButtonVariantSchema as m}from"./common/index.js";export const editableOffsetIndicatorComponent=i.component("editableOffsetIndicator").withState({tsType:"EditableOffsetIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"EditableOffsetIndicatorComponentState"}],type:"object",properties:{...p,targetEntityOffsetAnchors:{type:"array",items:{type:"string"}},targetReferenceOffsetAnchors:{type:"array",items:{type:"string"}},referenceEntityIds:{type:["array","null"],items:t},directionVector:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},additionalProperties:!1},directionVectorRelativeToEntityId:{anyOf:[t,{type:"null"}]},maxDistance:{type:["number","null"]},minDistance:{type:["number","null"]},maxPerpendicularDistance:{type:["number","null"]},minPerpendicularDistance:{type:["number","null"]},visible:{type:"boolean"},force:{type:"boolean"},displayUnit:r,unitDisplayConfig:o,...a,...s,targetOffset:{type:"string"},fixableViolations:{type:"array",items:{type:"string"}},inputLabel:e,modalTitle:e,modalText:e,helperText:e,buttonVariant:m},required:["targetOffset","targetEntityOffsetAnchors","targetReferenceOffsetAnchors","directionVector"],additionalProperties:!1}).build();export const isEditableOffsetIndicatorSnapshot=n(editableOffsetIndicatorComponent);