@salsita-ai/sdk 0.50.0-develop.db8514eccf → 0.50.0-develop.dd7119ab25

package/dist/domain/application/index.js

@@ -1 +1 @@
-export{findAssistantFieldOptions,readAssistantFieldOptions}from"./assistant-field-options.js";export{deleteEntityUpdateTag,findAssistantMutation,modifyEntityUpdateTag}from"./assistant-mutations.js";export{assistantAddedEntityIds,findAssistantRecipeGroups,prepareAssistantRecipeUpdates,readAssistantRecipeGroup}from"./assistant-recipe-groups.js";export{ConfiguratorBuilder}from"./configurator-builder.js";export*from"./admin-page-factories.js";export{createInitialPublishedData}from"./create-initial-published-data.js";export{resolveImportedTransformers}from"./resolve-imported-transformers.js";export{webComponentAttributeParsers,createWebComponentPropertyDescriptor}from"./web-component-property.js";export{createWebComponentEventDescriptor}from"./web-component-event.js";export{standardWebComponentProperties}from"./standard-properties.js";export{standardWebComponentEvents}from"./standard-events.js";export{ResourceBuilder}from"./resource-builder.js";export{createGetApplicationWrapperHandler,isGetApplicationWrapperHandler}from"./GetApplicationWrapperHandler.js";export{createGetThemeHandler,GetThemeHandlerName,isGetThemeHandler}from"./GetThemeHandler.js";export{createGetWebComponentOptionsHandler,isGetWebComponentOptionsHandler}from"./GetWebComponentOptions.js";export{createFinalizeAdminDomain}from"./published-data/create-finalize-admin-domain.js";export{FilterPublishedChunksHandlerName,isFilterPublishedChunksHandler}from"./published-data/FilterPublishedChunksHandler.js";export{mapPublishedData}from"./published-data/map-published-data.js";export{flattenTabData,mapDefaultValuesToRecords,mapPublishedChunkedData,SYSTEM_CHUNK_KEY,SYSTEM_CHUNK_SCOPE,SWATCH_DEFINITION}from"./published-data/map-published-chunked-data.js";export{buildLegendRows}from"./published-data/build-legend-data.js";export{formatFieldType,getFieldDescription}from"./published-data/format-field-type.js";export{mapDataToSheet}from"./published-data/map-data-to-sheet.js";export{validateRows}from"./published-data/validate-sheet-data.js";export{createDataRowValidatorHandler,DataRowValidatorHandlerName,isDataRowValidatorHandler}from"./published-data/DataRowValidatorHandler.js";export{createSheetValidatorHandler,SheetValidatorHandlerName,isSheetValidatorHandler}from"./published-data/SheetValidatorHandler.js";export{createMapPublishedRevisionDataHandler,createMapPublishedRevisionDataHandlerFactory,isMapPublishedRevisionDataHandler}from"./published-data/MapPublishedRevisionDataHandler.js";export{createMapPublishedChunkedDataHandler,createMapPublishedChunkedDataHandlerFactory,isMapPublishedChunkedDataHandler}from"./published-data/MapPublishedChunkedDataHandler.js";export{createPhoenixHandler,createSystemPhoenixHandler,createSystemPhoenixAsyncHandler}from"./handler-registration.js";export{createPhoenixLayoutElement,createPhoenixEntityElement,createCustomPhoenixLayoutElement,createCustomPhoenixEntityElement}from"./element-registration.js";
+export{findAssistantFieldOptions,readAssistantFieldOptions}from"./assistant-field-options.js";export{deleteEntityUpdateTag,findAssistantMutation,modifyEntityUpdateTag}from"./assistant-mutations.js";export{findAssistantRecipeGroups,prepareAssistantRecipeUpdates,readAssistantRecipeGroup}from"./assistant-recipe-groups.js";export{ConfiguratorBuilder}from"./configurator-builder.js";export*from"./admin-page-factories.js";export{createInitialPublishedData}from"./create-initial-published-data.js";export{webComponentAttributeParsers,createWebComponentPropertyDescriptor}from"./web-component-property.js";export{createWebComponentEventDescriptor}from"./web-component-event.js";export{standardWebComponentProperties}from"./standard-properties.js";export{standardWebComponentEvents}from"./standard-events.js";export{createGetApplicationWrapperHandler,isGetApplicationWrapperHandler}from"./GetApplicationWrapperHandler.js";export{createGetThemeHandler,GetThemeHandlerName,isGetThemeHandler}from"./GetThemeHandler.js";export{createGetWebComponentOptionsHandler,isGetWebComponentOptionsHandler}from"./GetWebComponentOptions.js";export{createFinalizeAdminDomain}from"./published-data/create-finalize-admin-domain.js";export{FilterPublishedChunksHandlerName,isFilterPublishedChunksHandler}from"./published-data/FilterPublishedChunksHandler.js";export{mapPublishedData}from"./published-data/map-published-data.js";export{flattenTabData,mapDefaultValuesToRecords,mapPublishedChunkedData,SYSTEM_CHUNK_KEY,SYSTEM_CHUNK_SCOPE,SWATCH_DEFINITION}from"./published-data/map-published-chunked-data.js";export{buildLegendRows}from"./published-data/build-legend-data.js";export{formatFieldType,getFieldDescription}from"./published-data/format-field-type.js";export{mapDataToSheet}from"./published-data/map-data-to-sheet.js";export{validateRows}from"./published-data/validate-sheet-data.js";export{createDataRowValidatorHandler,DataRowValidatorHandlerName,isDataRowValidatorHandler}from"./published-data/DataRowValidatorHandler.js";export{createSheetValidatorHandler,SheetValidatorHandlerName,isSheetValidatorHandler}from"./published-data/SheetValidatorHandler.js";export{createMapPublishedRevisionDataHandler,createMapPublishedRevisionDataHandlerFactory,isMapPublishedRevisionDataHandler}from"./published-data/MapPublishedRevisionDataHandler.js";export{createMapPublishedChunkedDataHandler,createMapPublishedChunkedDataHandlerFactory,isMapPublishedChunkedDataHandler}from"./published-data/MapPublishedChunkedDataHandler.js";export*from"./assistant/index.js";

package/dist/domain/application/published-data/DataRowValidatorHandler.d.ts

@@ -1,4 +1,4 @@
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../handler-registration.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../../domain-runtime/index.js';
 import type { DataRowValidator, DataRowValidatorProps, RowValidationMessage } from './validate-sheet-data.js';
 export declare const DataRowValidatorHandlerName = "DataRowValidator";
 export type DataRowValidatorResult = readonly RowValidationMessage[];

package/dist/domain/application/published-data/FilterPublishedChunksHandler.d.ts

@@ -1,3 +1,3 @@
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../handler-registration.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../../domain-runtime/index.js';
 export declare const FilterPublishedChunksHandlerName = "FilterPublishedChunks";
 export declare const isFilterPublishedChunksHandler: (handler: HandlerRegistration<any, any>) => handler is SystemPhoenixHandlerRegistration<void, readonly string[]>;

package/dist/domain/application/published-data/MapPublishedChunkedDataHandler.d.ts

@@ -1,6 +1,6 @@
 import type { SheetTabData } from '@salsita-ai/contracts/webhook';
 import type { $DomainEntity, DomainEntity, DomainState } from '../../core/index.js';
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../handler-registration.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../../domain-runtime/index.js';
 import type { ChunkedPublishedData } from './map-published-chunked-data.js';
 export type MapPublishedChunkedDataHandlerProps<ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>> = {
     readonly entities: DomainState<ADMIN_ENTITIES>['entities'];

package/dist/domain/application/published-data/MapPublishedRevisionDataHandler.d.ts

@@ -1,5 +1,5 @@
 import type { $DomainEntity, DomainEntity, DomainState } from '../../core/index.js';
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../handler-registration.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../../domain-runtime/index.js';
 export type MapPublishedRevisionDataHandlerProps<ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>> = {
     entities: DomainState<ADMIN_ENTITIES>['entities'];
     adminEntity: ADMIN_$MAP[ADMIN_ALLOWED_ROOT_ENTITIES['type']];

package/dist/domain/application/published-data/SheetValidatorHandler.d.ts

@@ -1,4 +1,4 @@
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../handler-registration.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../../domain-runtime/index.js';
 import type { SheetDataValidator, SheetValidationMessage, SheetValidatorProps } from './validate-sheet-data.js';
 export declare const SheetValidatorHandlerName = "SheetValidator";
 export type SheetValidatorResult = readonly SheetValidationMessage[];

package/dist/domain/application/published-data/build-legend-data.d.ts

@@ -1,4 +1,4 @@
-import type { DataSchema } from '../application-config.js';
+import type { DataSchema } from '../../core/index.js';
 export interface LegendRow {
     readonly field: string;
     readonly type: string;

package/dist/domain/application/published-data/create-finalize-admin-domain.d.ts

@@ -1,5 +1,4 @@
-import type { DomainFactory } from '../../core/index.js';
-import type { $DomainEntity, DomainEntity } from '../../core/model.js';
+import type { $DomainEntity, DomainEntity, DomainFactory } from '../../core/index.js';
 import type { DomainRuntime } from '../../domain-runtime/index.js';
 export interface AdminDomainContext<ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> {
     readonly adminDomainFactory: DomainFactory<ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;

package/dist/domain/application/published-data/format-field-type.d.ts

@@ -1,3 +1,3 @@
-import type { DataSchemaField } from '../application-config.js';
+import type { DataSchemaField } from '../../core/index.js';
 export declare const formatFieldType: (field: DataSchemaField) => string;
 export declare const getFieldDescription: (field: DataSchemaField) => string | undefined;

package/dist/domain/application/published-data/map-data-to-sheet.d.ts

@@ -1,5 +1,5 @@
 import type { CellValue, ColumnMeta } from '@salsita-ai/contracts/webhook';
-import type { DataCellValue, DataSchema } from '../application-config.js';
+import type { DataCellValue, DataSchema } from '../../core/index.js';
 import { type LegendRow } from './build-legend-data.js';
 export interface SheetData {
     readonly headers: readonly string[];

package/dist/domain/application/published-data/map-published-chunked-data.d.ts

@@ -1,6 +1,6 @@
 import { type SheetTabData } from '@salsita-ai/contracts/webhook';
-import type { DomainEntity } from '../../core/model.js';
-import type { ChunksSpec, DataCellValue, DataSchema, DataSpec } from '../application-config.js';
+import type { DataCellValue, DataSchema, DomainEntity } from '../../core/index.js';
+import type { ChunksSpec, DataSpec } from '../application-config.js';
 import { type DataRowValidator, type SheetDataValidator } from './validate-sheet-data.js';
 export { flattenTabData } from './flatten-tab-data.js';
 export declare const SYSTEM_CHUNK_KEY = "system";
@@ -16,4 +16,4 @@ export interface DataRowValidatorHandlers {
     readonly rowValidator?: DataRowValidator;
     readonly sheetValidator?: SheetDataValidator;
 }
-export declare const mapPublishedChunkedData: <ADMIN_ENTITIES extends DomainEntity<string>>(adminEntities: readonly ADMIN_ENTITIES[], dataSpec: DataSpec, chunksSpec: ChunksSpec, connectedSheetData?: Record<string, readonly SheetTabData[]>, customChunkedData?: ChunkedPublishedData, validators?: DataRowValidatorHandlers) => ChunkedPublishedData;
+export declare const mapPublishedChunkedData: (adminEntities: ReadonlyArray<DomainEntity<string>>, dataSpec: DataSpec, chunksSpec: ChunksSpec, connectedSheetData?: Record<string, readonly SheetTabData[]>, customChunkedData?: ChunkedPublishedData, validators?: DataRowValidatorHandlers) => ChunkedPublishedData;

package/dist/domain/application/published-data/map-published-data.d.ts

@@ -1,5 +1,8 @@
-import type { DomainFactory } from '../../core/index.js';
-import type { $DomainEntity, DomainEntity } from '../../core/model.js';
+import type { AnyDomainFactory, DomainEntity } from '../../core/index.js';
 import type { DomainRuntime } from '../../domain-runtime/index.js';
-import type { MapPublishedRevisionDataHandlerProps, MapPublishedRevisionDataResult } from './MapPublishedRevisionDataHandler.js';
-export declare const mapPublishedData: <ADMIN_ENTITIES extends DomainEntity<string> = never, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES = never, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>> = never, PUBLISHED_DATA extends Record<string, unknown> = never, SESSION_DATA extends Record<string, unknown> = never, FRONTEND_DATA extends Record<string, unknown> = never>(adminDomainFactory: DomainFactory<ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>, domainRuntime: DomainRuntime, mapPublishedDataHandler: (props: MapPublishedRevisionDataHandlerProps<ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP>) => MapPublishedRevisionDataResult<PUBLISHED_DATA>, rootEntityType: ADMIN_ALLOWED_ROOT_ENTITIES['type'], entities: readonly ADMIN_ENTITIES[]) => PUBLISHED_DATA;
+import type { MapPublishedRevisionDataHandlerProps } from './MapPublishedRevisionDataHandler.js';
+/**
+ * Finalizes the admin domain and maps its state to the published data of one revision: what the project's
+ * handler returns, with the common admin data on top.
+ */
+export declare const mapPublishedData: (adminDomainFactory: AnyDomainFactory, domainRuntime: DomainRuntime, mapPublishedDataHandler: (props: MapPublishedRevisionDataHandlerProps<any, any, any>) => Record<string, unknown>, rootEntityType: string, entities: ReadonlyArray<DomainEntity<string>>) => Record<string, unknown>;

package/dist/domain/application/published-data/validate-sheet-data.d.ts

@@ -1,4 +1,4 @@
-import type { DataSchema } from '../application-config.js';
+import type { DataSchema } from '../../core/index.js';
 /**
  * Severity of a data validation message. `error` blocks publishing (admin UI)
  * and aborts finalization (webhook); `warning` is surfaced to the admin in the

package/dist/domain/available-system-components.js

@@ -1 +1 @@
-import{violationsComponent as o}from"./invariants/violation-component.js";import{angleDimensionComponent as n,angleIndicatorComponent as t,applicationConfigComponent as e,attributeSelectionComponent as m,attributeSwitchComponent as s,autorotateCameraComponent as a,basicSidebarFooterComponent as p,boundingBoxComponent as i,boundingSphereComponent as r,cameraBasedHiddenEntityComponent as c,cameraBasedHiddenEntityObjectComponent as l,canvasConfigComponent as y,canvasCustomEnvironmentComponent as v,canvasPaddingComponent as f,canvasPresetEnvironmentComponent as j,childEntityRecipeHierarchyComponent as x,childEntityRecipesComponent as b,childEntitySelectionComponent as C,clientSideImageComponent as S,collisionBoxGeometryComponent as d,collisionGeometryComponent as h,collisionPointGeometryComponent as w,colorValueComponent as B,constraintComponent as M,customHeaderComponent as N,customSceneEntityComponent as g,customSidebarFooterComponent as k,detailComponent as q,dimensionIndicatorComponent as u,distanceDimensionComponent as z,distanceDimensionSelectComponent as A,dragHandleComponent as D,editableAngleIndicatorComponent as E,editableDistanceDimensionIndicatorComponent as F,editableOffsetIndicatorComponent as G,editableSizeIndicatorComponent as H,entityHeaderComponent as I,exitToolModeFabComponent as J,finalizeActionComponent as K,fitEntityOrthographicCameraComponent as L,fitEntityPerspectiveCameraComponent as O,fitRootOrthographicCameraComponent as P,fitRootPerspectiveCameraComponent as Q,fitSelectionOrthographicCameraComponent as R,fitSelectionPerspectiveCameraComponent as T,fixedHeaderComponent as U,floatingHeaderComponent as V,genericDimensionComponent as W,hiddenEntityComponent as X,hiddenHeaderComponent as Y,hiddenSidebarFooterComponent as Z,horizontalTabsComponent as $,hotspotDragHandleComponent as _,htmlHotspotComponent as oo,listSelectorDimensionIndicatorComponent as on,materialOverridePropertyTransitionComponent as ot,materialSwatchComponent as oe,multilingualTextValueComponent as om,navigationStepsComponent as os,offsetAnchorsComponent as oa,offsetComponent as op,offsetIndicatorComponent as oi,pivotPointComponent as or,priceComponent as oc,projectedEntitiesComponent as ol,propertyPageComponent as oy,readSidebarFooterComponent as ov,replaceEntityRecipeHierarchyComponent as of,replaceEntityRecipesComponent as oj,rotatableComponent as ox,rotationHandleComponent as ob,saveTemplateThumbnailComponent as oC,sceneEntityAddFabComponent as oS,sceneEntityAmbientLightComponent as od,sceneEntityAnimationComponent as oh,sceneEntityBoxObjectComponent as ow,sceneEntityControlComponent as oB,sceneEntityDeleteFabComponent as oM,sceneEntityDirectionalLightComponent as oN,sceneEntityFloorObjectComponent as og,sceneEntityLocalMaterialOverrideComponent as ok,sceneEntityNavigationHotspotComponent as oq,sceneEntityObjectClipComponent as ou,sceneEntityObjectComponent as oz,sceneEntityObjectGroupComponent as oA,sceneEntityObjectHtmlHotspotComponent as oD,sceneEntityObjectLocalMaterialOverrideComponent as oE,sceneEntityObjectPropertiesComponent as oF,sceneEntityObjectRemoteMaterialOverrideComponent as oG,sceneEntityObjectTextDecalComponent as oH,sceneEntityObjectTransmissiveMaterialOverrideComponent as oI,sceneEntityPointLightComponent as oJ,sceneEntityPropertiesComponent as oK,sceneEntityRectAreaLightComponent as oL,sceneEntityRemoteMaterialOverrideComponent as oO,sceneEntityRemoteObjectComponent as oP,sceneEntitySelectHotspotComponent as oQ,sceneEntitySpotLightComponent as oR,sceneEntityTransmissiveMaterialOverrideComponent as oT,sceneEntityWallObjectComponent as oU,selectableComponent as oV,sidebarTabsComponent as oW,simpleSummaryComponent as oX,sizeComponent as oY,sketchingComponent as oZ,sketchingDrawComponent as o$,sketchingEditComponent as o_,sketchingLineComponent as o0,sketchingRectangleComponent as o1,snapAxisComponent as o2,snapEdgeComponent as o3,snapPlaneComponent as o4,snapPointComponent as o5,staticOrthographicCameraComponent as o6,staticPerspectiveCameraComponent as o7,textValueComponent as o8,toolControlsComponent as o9,toolMenuFabComponent as no,toolbarComponent as nn,universalSidebarFooterComponent as nt,viewControlsComponent as ne}from"./system-components/index.js";import{otherActionComponent as nm}from"./system-components/other-action.js";export const availableSystemComponents=[e,oc,q,y,v,j,u,t,D,ob,ox,oZ,o$,o_,o0,o1,oP,oz,g,oU,og,ow,od,oN,oJ,oL,oR,oK,oF,oA,X,c,l,oO,ok,oG,oE,oI,oT,ot,oh,ou,oH,Q,P,O,L,T,R,o7,o6,a,i,r,or,o5,o3,o4,o2,d,h,w,M,oV,oo,oD,oB,oS,oM,oQ,oq,no,J,I,oy,nn,ne,o9,oW,$,os,K,nm,p,nt,ov,k,Z,f,V,N,U,Y,oj,of,b,x,oe,oa,oi,z,n,W,A,B,o8,om,m,s,C,oY,op,E,F,G,H,on,_,oX,S,oC,ol,o];export const componentsByName=new Map(availableSystemComponents.map(o=>[o.name,o]));
+import{violationsComponent as e}from"./core/index.js";import{angleIndicatorComponent as o,attributeSwitchComponent as n,autorotateCameraComponent as m,basicSidebarFooterComponent as s,cameraBasedHiddenEntityComponent as t,cameraBasedHiddenEntityObjectComponent as p,canvasConfigComponent as a,canvasCustomEnvironmentComponent as i,canvasPaddingComponent as r,canvasPresetEnvironmentComponent as x,childEntityRecipeHierarchyComponent as c,clientSideImageComponent as l,colorValueComponent as y,customHeaderComponent as d,customSidebarFooterComponent as f,dimensionIndicatorComponent as j,editableAngleIndicatorComponent as b,editableDistanceDimensionIndicatorComponent as v,editableOffsetIndicatorComponent as C,editableSizeIndicatorComponent as S,entityHeaderComponent as w,exitToolModeFabComponent as B,finalizeActionComponent as M,fitSelectionOrthographicCameraComponent as N,fitSelectionPerspectiveCameraComponent as g,fixedHeaderComponent as h,floatingHeaderComponent as k,hiddenHeaderComponent as q,hiddenSidebarFooterComponent as u,horizontalTabsComponent as z,htmlHotspotComponent as A,listSelectorDimensionIndicatorComponent as D,multilingualTextValueComponent as E,navigationStepsComponent as F,offsetAnchorsComponent as G,offsetComponent as H,offsetIndicatorComponent as I,otherActionComponent as J,propertyPageComponent as K,readSidebarFooterComponent as L,replaceEntityRecipeHierarchyComponent as O,rotatableComponent as P,rotationHandleComponent as Q,saveTemplateThumbnailComponent as R,sceneEntityAddFabComponent as T,sceneEntityAnimationComponent as U,sceneEntityControlComponent as V,sceneEntityDeleteFabComponent as W,sceneEntityFloorObjectComponent as X,sceneEntityNavigationHotspotComponent as Y,sceneEntityObjectHtmlHotspotComponent as Z,sceneEntitySelectHotspotComponent as $,sceneEntityWallObjectComponent as _,selectableComponent as ee,sidebarTabsComponent as eo,simpleSummaryComponent as en,sizeComponent as em,sketchingDrawComponent as es,sketchingEditComponent as et,textValueComponent as ep,toolControlsComponent as ea,toolMenuFabComponent as ei,toolbarComponent as er,universalSidebarFooterComponent as ex,viewControlsComponent as ec}from"./extensions/index.js";import{angleDimensionComponent as el,applicationConfigComponent as ey,attributeSelectionComponent as ed,boundingBoxComponent as ef,boundingSphereComponent as ej,childEntityRecipesComponent as eb,childEntitySelectionComponent as ev,collisionBoxGeometryComponent as eC,collisionGeometryComponent as eS,collisionPointGeometryComponent as ew,constraintComponent as eB,customSceneEntityComponent as eM,detailComponent as eN,distanceDimensionComponent as eg,distanceDimensionSelectComponent as eh,dragHandleComponent as ek,fitEntityOrthographicCameraComponent as eq,fitEntityPerspectiveCameraComponent as eu,fitRootOrthographicCameraComponent as ez,fitRootPerspectiveCameraComponent as eA,genericDimensionComponent as eD,hiddenEntityComponent as eE,hotspotDragHandleComponent as eF,materialOverridePropertyTransitionComponent as eG,materialSwatchComponent as eH,pivotPointComponent as eI,priceComponent as eJ,projectedEntitiesComponent as eK,replaceEntityRecipesComponent as eL,sceneEntityAmbientLightComponent as eO,sceneEntityBoxObjectComponent as eP,sceneEntityDirectionalLightComponent as eQ,sceneEntityLocalMaterialOverrideComponent as eR,sceneEntityObjectClipComponent as eT,sceneEntityObjectComponent as eU,sceneEntityObjectGroupComponent as eV,sceneEntityObjectLocalMaterialOverrideComponent as eW,sceneEntityObjectPropertiesComponent as eX,sceneEntityObjectRemoteMaterialOverrideComponent as eY,sceneEntityObjectTextDecalComponent as eZ,sceneEntityObjectTransmissiveMaterialOverrideComponent as e$,sceneEntityPointLightComponent as e_,sceneEntityPropertiesComponent as e0,sceneEntityRectAreaLightComponent as e1,sceneEntityRemoteMaterialOverrideComponent as e2,sceneEntityRemoteObjectComponent as e3,sceneEntitySpotLightComponent as e4,sceneEntityTransmissiveMaterialOverrideComponent as e5,sketchingComponent as e6,sketchingLineComponent as e7,sketchingRectangleComponent as e8,snapAxisComponent as e9,snapEdgeComponent as oe,snapPlaneComponent as oo,snapPointComponent as on,staticOrthographicCameraComponent as om,staticPerspectiveCameraComponent as os}from"./system-components/index.js";export const availableSystemComponents=[ey,eJ,eN,a,i,x,j,o,ek,Q,P,e6,es,et,e7,e8,e3,eU,eM,_,X,eP,eO,eQ,e_,e1,e4,e0,eX,eV,eE,t,p,e2,eR,eY,eW,e$,e5,eG,U,eT,eZ,eA,ez,eu,eq,g,N,os,om,m,ef,ej,eI,on,oe,oo,e9,eC,eS,ew,eB,ee,A,Z,V,T,W,$,Y,ei,B,w,K,er,ec,ea,eo,z,F,M,J,s,ex,L,f,u,r,k,d,h,q,eL,O,eb,c,eH,G,I,eg,el,eD,eh,y,ep,E,ed,n,ev,em,H,b,v,C,S,D,eF,en,l,R,eK,e];export const componentsByName=new Map(availableSystemComponents.map(e=>[e.name,e]));

package/dist/domain/core/action/action-factory.d.ts

@@ -0,0 +1,11 @@
+import type { DomainEntity } from '../model/index.js';
+import type { ActionImplementations, ActionTypes } from './action.js';
+/**
+ * Creates the `implementActions` factory the generated `domain-spec.ts` exposes as
+ * `phx.domain.implementActions`. A module in `src/actions/` implements any subset of the declared
+ * actions and gets each parameter and result typed from the spec; a name the spec does not declare
+ * is a type error, since its implementation would have to be `never`. The generated barrel lists
+ * the modules; `DomainBuilder.withActionModules` merges them, and domain initialization checks that
+ * every declared action is implemented.
+ */
+export declare const createActionFactory: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ACTION_TYPES extends ActionTypes, CONTEXT_EXTENSION = unknown, SYSTEMS = unknown>() => <IMPLEMENTATIONS extends Partial<ActionImplementations<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ACTION_TYPES, CONTEXT_EXTENSION, SYSTEMS>>>(implementations: IMPLEMENTATIONS & Readonly<Record<Exclude<keyof IMPLEMENTATIONS, keyof ACTION_TYPES>, never>>) => IMPLEMENTATIONS;

package/dist/domain/core/action/action.d.ts

@@ -0,0 +1,71 @@
+import type { ExtendedJsonSchema } from '@salsita-ai/common/utils';
+import type { StateUpdate, UpdateFactory } from '../component/index.js';
+import type { OpenExpressionContext } from '../expression/index.js';
+import type { DomainEntity } from '../model/index.js';
+import type { DomainState, IdSequence } from '../state/index.js';
+/**
+ * The parameter and result types of the actions an application declares under `actions`, keyed by
+ * action name. Codegen derives it from the spec; `ActionSystem.prepareAction` and the
+ * `implementActions` factory are typed against it.
+ */
+export type ActionTypes = Record<string, {
+    readonly params: unknown;
+    readonly result: unknown;
+}>;
+/**
+ * One action as the spec declares it, carried into the domain factory by the generated code:
+ * `params` is the AJV-ready object schema of its parameters, which `prepareAction` validates the
+ * arguments against before the implementation runs, and `description` says what the action does.
+ */
+export interface ActionDefinition {
+    readonly name: string;
+    readonly description?: string;
+    readonly params: ExtendedJsonSchema;
+}
+/** The declared actions of an application by name; empty when the spec declares none. */
+export type ActionDefinitions = Readonly<Record<string, ActionDefinition>>;
+/** The working state an action ran against and the state its applied updates produced. */
+export interface ActionStateChange<ENTITIES extends DomainEntity<string>> {
+    readonly previousState: DomainState<ENTITIES>;
+    readonly state: DomainState<ENTITIES>;
+}
+/**
+ * What one action prepares: the updates it wants applied, computed from the state it ran against,
+ * and how to read its result from the change they made, including whatever the transformers added.
+ * Nothing is staged or committed; the caller decides what to do with the updates.
+ */
+export interface PreparedAction<ENTITIES extends DomainEntity<string>, RESULT> {
+    readonly updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>;
+    readonly readResult: (change: ActionStateChange<ENTITIES>) => RESULT;
+}
+/**
+ * What an action implementation reads besides its parameters and the state. Core declares its own
+ * part: the expression context (core's part of it, and in `CONTEXT_EXTENSION` what whoever runs the
+ * action adds to it, such as the projections), an id sequence for entities the action creates, and
+ * the update factory typed for the application's entities. `SYSTEMS` is what whoever runs the action
+ * hands it as `systems`, such as the systems of the domain runtime. An action that reads only core's
+ * part leaves both parameters out.
+ */
+export interface OpenActionContext<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, CONTEXT_EXTENSION = unknown, SYSTEMS = unknown> {
+    readonly expressionContext: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>;
+    readonly systems: SYSTEMS;
+    readonly getIdSequence: () => IdSequence<ENTITIES>;
+    readonly updates: UpdateFactory<ENTITIES>;
+}
+/**
+ * The implementation of one declared action. It must not change anything itself; a thrown error
+ * fails the call, and its message reaches whoever asked for the action, so it says what went wrong
+ * and how to fix the request.
+ */
+export type ActionImplementation<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, PARAMS, RESULT, CONTEXT_EXTENSION = unknown, SYSTEMS = unknown> = (params: PARAMS, state: DomainState<ENTITIES>, context: OpenActionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION, SYSTEMS>) => PreparedAction<ENTITIES, RESULT>;
+/**
+ * One action implementation with its types erased. The two parameters of its context are erased
+ * too, so that an implementation written against a closed context is assignable to it.
+ */
+export type AnyActionImplementation = ActionImplementation<any, any, any, any, any, any, unknown, any, any>;
+/** The implementations of every declared action by name, as `DomainBuilder.withActionModules` merges them from `src/actions/`. */
+export type ActionImplementations<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ACTION_TYPES extends ActionTypes, CONTEXT_EXTENSION = unknown, SYSTEMS = unknown> = {
+    readonly [NAME in keyof ACTION_TYPES]: ActionImplementation<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ACTION_TYPES[NAME]['params'], ACTION_TYPES[NAME]['result'], CONTEXT_EXTENSION, SYSTEMS>;
+};
+/** The action implementations of an application with their types erased, as the runtime spec slice holds them. */
+export type AnyActionImplementations = Readonly<Record<string, AnyActionImplementation>>;

package/dist/domain/core/action/action.js

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

package/dist/domain/core/action/index.d.ts

@@ -0,0 +1,2 @@
+export * from './action-factory.js';
+export type * from './action.js';

package/dist/domain/core/action/index.js

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

package/dist/domain/core/component/component-reader-types.d.ts

@@ -0,0 +1,43 @@
+import type { ComponentInstance, EntityId, SystemComponentTypeConstraint } from '../model/index.js';
+import type { ComponentSystemFilterState, FilterMismatchReason } from './system-component-filter.js';
+/**
+ * Filter for reading a single attachment of a component on one entity.
+ *
+ * `instanceName` is optional: omit it only when the component is attached exactly once on the
+ * entity. If more than one instance matches, the single-read methods throw, in which case
+ * {@link ManyComponentFilter} should be used instead.
+ */
+export type OneComponentFilter<COMPONENT_TYPE extends SystemComponentTypeConstraint> = Omit<ComponentInstance<COMPONENT_TYPE>, 'instanceName'> & {
+    instanceName?: string;
+};
+/**
+ * Filter for reading any number of component attachments.
+ *
+ * Each provided field narrows the result; an omitted field matches everything. Passing a dynamic
+ * (`attachMany`) optic's base `instanceName` (e.g. `extentsY`) matches every compound instance it
+ * emits (`extentsY_a`, `extentsY_b`, ...), while passing an exact compound name matches only that
+ * one.
+ */
+export interface ManyComponentFilter<COMPONENT_TYPE extends SystemComponentTypeConstraint> {
+    readonly entityIds?: readonly EntityId[];
+    readonly componentTypes?: readonly COMPONENT_TYPE[];
+    readonly instanceNames?: readonly string[];
+}
+export type ComponentFilter<COMPONENT_TYPE extends SystemComponentTypeConstraint> = ManyComponentFilter<COMPONENT_TYPE> | OneComponentFilter<COMPONENT_TYPE>;
+/**
+ * Session context the component filters were evaluated against. Carried on
+ * {@link FilteredOutComponentSnapshot} because `modes`/`roles` mismatches compare against the
+ * expression context (not {@link ComponentSystemFilterState}), so without it a debugger could not
+ * tell what the "current" mode/role was at evaluation time.
+ */
+export interface FilteredOutFilterContext {
+    readonly mode: string;
+    readonly role: string;
+}
+export interface FilteredOutComponentSnapshot<COMPONENT_TYPE extends SystemComponentTypeConstraint> {
+    readonly componentInstance: ComponentInstance<COMPONENT_TYPE>;
+    readonly filteredOut: true;
+    readonly filterState: ComponentSystemFilterState;
+    readonly filterContext: FilteredOutFilterContext;
+    readonly mismatchReasons: readonly FilterMismatchReason[];
+}

package/dist/domain/core/component/component-reader-types.js

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

package/dist/domain/core/component/debug-state-component.d.ts

@@ -0,0 +1,14 @@
+import { type EntityId } from '../model/index.js';
+export type DebugStateComponentState = {
+    readonly enabled: boolean;
+};
+/**
+ * Component used to hold debug mode state for virtual scene entity. Use this only via NavigationSystem
+ */
+export declare const debugStateComponent: import("../index.js").SystemComponentType<"debugState", DebugStateComponentState, "enabled">;
+/**
+ * Component used to hold debug mode state for virtual scene entity. Use this only via NavigationSystem
+ */
+export type DebugStateComponent = typeof debugStateComponent;
+export declare const isDebugStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"debugState", DebugStateComponentState, "enabled">>;
+export declare const isSystemDebugStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"debugState", DebugStateComponentState, "enabled">>;

package/dist/domain/core/component/debug-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as e}from"../model/index.js";import{SystemComponentBuilder as t}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const debugStateComponent=t.component("debugState").withState({type:"object",properties:{enabled:{type:"boolean"}},required:["enabled"],additionalProperties:!1}).withWritableKeys(["enabled"]).build();export const isDebugStateComponentSnapshot=t=>e(t,"singleton",debugStateComponent);export const isSystemDebugStateComponentSnapshot=e(o,"singleton",debugStateComponent);

package/dist/domain/core/component/domain-component-optic.d.ts

@@ -0,0 +1,65 @@
+import { type CustomExpression, type OpenExpressionContext } from '../expression/index.js';
+import type { $DomainEntity, AliasMap, DomainEntity, EntityByType, StateOfComponent, SystemComponentType, SystemComponentTypeConstraint, WritableStateOfComponent } from '../model/index.js';
+import type { DomainState } from '../state/index.js';
+import { type ComponentSystemFilter, type NavigationFilterOptic } from './legacy-filter.js';
+import type { ComponentSystemFilterProps, GradualComponentSystemFilter } from './system-component-filter.js';
+/**
+ * The value a project states for one filter criterion: the value `ComponentSystemFilterProps`
+ * states for it, with an array read-only. `system-component-filter.ts` holds the same rule for the
+ * filter an optic carries; each file keeps its own copy so that the folder exports no new name.
+ */
+type FilterCriterion<KEY extends keyof ComponentSystemFilterProps> = [
+    Required<ComponentSystemFilterProps>[KEY]
+] extends [ReadonlyArray<infer ITEM>] ? readonly ITEM[] : Required<ComponentSystemFilterProps>[KEY];
+type CustomOpticAttach<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ENTITY extends ENTITIES, $ENTITY extends $DomainEntity<ENTITIES>, COMPONENT_TYPE extends SystemComponentTypeConstraint, CONTEXT_EXTENSION> = (read: CustomExpression<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, $ENTITY, StateOfComponent<COMPONENT_TYPE>, CONTEXT_EXTENSION>, write?: DomainComponentSimpleOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ENTITY, COMPONENT_TYPE, CONTEXT_EXTENSION>['write']) => DomainComponentSimpleOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ENTITY, COMPONENT_TYPE, CONTEXT_EXTENSION>;
+export interface DomainComponentSimpleOptic<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ENTITY extends ENTITIES, COMPONENT_TYPE extends SystemComponentTypeConstraint, CONTEXT_EXTENSION = unknown> {
+    readonly kind: 'simple';
+    readonly instanceName: string;
+    readonly componentType: COMPONENT_TYPE;
+    readonly entityTypes: ReadonlySet<ENTITIES['type']>;
+    readonly generated?: boolean;
+    readonly navigationFilters: ReadonlyArray<GradualComponentSystemFilter<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>>;
+    read(entityId: ENTITIES['id'], state: DomainState<ENTITIES>, ctx: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>): StateOfComponent<COMPONENT_TYPE>;
+    write(writableState: WritableStateOfComponent<COMPONENT_TYPE>): Partial<Omit<ENTITY, 'id' | 'type'>>;
+}
+export interface DomainComponentDynamicOptic<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, COMPONENT_TYPE extends SystemComponentTypeConstraint, CONTEXT_EXTENSION = unknown> {
+    readonly kind: 'dynamic';
+    readonly instanceName: string;
+    readonly componentType: COMPONENT_TYPE;
+    readonly entityTypes: ReadonlySet<ENTITIES['type']>;
+    readonly generated?: boolean;
+    readonly navigationFilters: ReadonlyArray<GradualComponentSystemFilter<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>>;
+    read(entityId: ENTITIES['id'], state: DomainState<ENTITIES>, ctx: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>): ReadonlyArray<StateOfComponent<COMPONENT_TYPE> & {
+        key: string;
+    }>;
+}
+export type DomainComponentOptic<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ENTITY extends ENTITIES, COMPONENT_TYPE extends SystemComponentTypeConstraint, CONTEXT_EXTENSION = unknown> = DomainComponentSimpleOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ENTITY, COMPONENT_TYPE, CONTEXT_EXTENSION> | DomainComponentDynamicOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, COMPONENT_TYPE, CONTEXT_EXTENSION>;
+export type AnyDomainComponentOptic = DomainComponentOptic<any, any, any, any, any, any, any>;
+export declare class DomainComponentOpticBuilder<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ALIASES extends Record<string, ENTITIES>, ENTITY extends ENTITIES, $ENTITY extends $DomainEntity<ENTITIES>, COMPONENT_TYPE extends SystemComponentTypeConstraint, CONTEXT_EXTENSION = unknown> {
+    private readonly aliasMap;
+    private readonly entityTypes;
+    private readonly componentType?;
+    private readonly instanceName?;
+    private readonly navigationFilters;
+    private readonly generated;
+    private readonly entityTypeOrAliasNames;
+    private constructor();
+    static from<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ALIASES extends Record<string, ENTITIES>, CONTEXT_EXTENSION = unknown>(aliasMap: AliasMap<ALIASES>): DomainComponentOpticBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, never, never, never, CONTEXT_EXTENSION>;
+    withEntity<TYPE extends ENTITIES['type']>(entityType: TYPE): DomainComponentOpticBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, ENTITY | EntityByType<ENTITIES, TYPE>, $ENTITY | $MAP[TYPE], COMPONENT_TYPE, CONTEXT_EXTENSION>;
+    withAlias<ALIAS extends keyof ALIASES & keyof $MAP>(alias: ALIAS): DomainComponentOpticBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, ENTITY | ALIASES[ALIAS], $ENTITY | $MAP[ALIAS], COMPONENT_TYPE, CONTEXT_EXTENSION>;
+    withComponent<NEW_COMPONENT_TYPE extends SystemComponentType<any, any, any>>(componentType: NEW_COMPONENT_TYPE, instanceName: string, generated?: boolean): DomainComponentOpticBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, ENTITY, $ENTITY, NEW_COMPONENT_TYPE, CONTEXT_EXTENSION>;
+    /**
+     * @deprecated Use withGradualFilter instead
+     */
+    withFilter(filter: ComponentSystemFilter | NavigationFilterOptic<ENTITIES, $ENTITY>): DomainComponentOpticBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, ENTITY, $ENTITY, COMPONENT_TYPE, CONTEXT_EXTENSION>;
+    withGradualFilter(filter: {
+        readonly [KEY in keyof ComponentSystemFilterProps]?: FilterCriterion<KEY> | CustomExpression<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, $ENTITY, FilterCriterion<KEY> | undefined, CONTEXT_EXTENSION>;
+    }): DomainComponentOpticBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, ENTITY, $ENTITY, COMPONENT_TYPE, CONTEXT_EXTENSION>;
+    private validate;
+    private _getProfilerLabel;
+    attach: CustomOpticAttach<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ENTITY, $ENTITY, COMPONENT_TYPE, CONTEXT_EXTENSION>;
+    attachMany: (read: (entity: $ENTITY, state: DomainState<ENTITIES>, ctx: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>) => ReadonlyArray<StateOfComponent<COMPONENT_TYPE> & {
+        key: string;
+    }>) => DomainComponentDynamicOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, COMPONENT_TYPE, CONTEXT_EXTENSION>;
+}
+export {};

package/dist/domain/core/component/domain-component-optic.js

@@ -0,0 +1,16 @@
+import{createCacheToken as t,getStickyCache as e}from"@salsita-ai/common/utils";import{withProfilerLabel as i}from"../../utils/profiler-label.js";import{createCustomExpression as n}from"../expression/index.js";let s={navigationStates:void 0,selectedEntityIds:void 0,hoveredEntityIds:void 0,draggedEntityIds:void 0,viewStates:void 0,toolStates:void 0,modes:void 0,roles:void 0,active:void 0,fullscreen:void 0,debug:void 0,viewports:void 0,exportedEntityIds:void 0,exportStates:void 0},a=(n,s)=>{let a=t(),o=i(s,n.read);return{...n,read:(t,i,n)=>{let s=e(i,a),r=s.get(t);if(r)return r;let l=o(t,i,n);return s.put(t,l),l}}};export class DomainComponentOpticBuilder{aliasMap;entityTypes;componentType;instanceName;navigationFilters;generated;entityTypeOrAliasNames;constructor(t,e,i,n,s=[],a=!1,o=[]){this.aliasMap=t,this.entityTypes=e,this.componentType=i,this.instanceName=n,this.navigationFilters=s,this.generated=a,this.entityTypeOrAliasNames=o}static from(t){return new DomainComponentOpticBuilder(t,[])}withEntity(t){return new DomainComponentOpticBuilder(this.aliasMap,[...this.entityTypes,t],this.componentType,this.instanceName,this.navigationFilters,this.generated,[...this.entityTypeOrAliasNames,t])}withAlias(t){return new DomainComponentOpticBuilder(this.aliasMap,[...this.entityTypes,...this.aliasMap[t]],this.componentType,this.instanceName,this.navigationFilters,this.generated,[...this.entityTypeOrAliasNames,String(t)])}withComponent(t,e,i=!1){return new DomainComponentOpticBuilder(this.aliasMap,this.entityTypes,t,e,this.navigationFilters,i,this.entityTypeOrAliasNames)}withFilter(i){if(console.warn(`Component ${this.componentType?.name}#${this.instanceName} on entity ${this.entityTypes.join(", ")} uses a legacy filter with full filter evaluation. This is a suboptimal variant and is deprecated in favor of per-criterion evaluation.
+
+  In your TS files, replace
+    withFilter()
+    ->
+    withGradualFilter()
+
+  In YAML, replace
+    $filter:
+      $read: $falseOrFilterExpression
+    ->
+    $filter:
+      active:
+        $read: $trueOrFalseExpression
+        # ... other eventual criteria
+  `),"function"==typeof i){let n=t(),a=t=>({evaluate:(s,a,o)=>{let r=e(a,n),l=r.get(s);if(!l){if(void 0===(l=i(o.domain.get$Entity(s,a),a)))throw Error(`Dynamic filter on component ${this.componentType?.name}.${this.instanceName} on entity ${s} returned 'undefined'. This is likely a bug in the component definition, check whether you are referencing a correct expression or field!`);r.put(s,l)}return"boolean"==typeof l?"active"===t?l:void 0:l[t]},meta:{}});return new DomainComponentOpticBuilder(this.aliasMap,this.entityTypes,this.componentType,this.instanceName,[...this.navigationFilters,{...s,navigationStates:a("navigationStates"),selectedEntityIds:a("selectedEntityIds"),hoveredEntityIds:a("hoveredEntityIds"),draggedEntityIds:a("draggedEntityIds"),viewStates:a("viewStates"),toolStates:a("toolStates"),modes:a("modes"),roles:a("roles"),active:a("active"),fullscreen:a("fullscreen"),debug:a("debug"),viewports:a("viewports")}],this.generated,this.entityTypeOrAliasNames)}return"boolean"==typeof i?new DomainComponentOpticBuilder(this.aliasMap,this.entityTypes,this.componentType,this.instanceName,[...this.navigationFilters,{...s,active:i}],this.generated,this.entityTypeOrAliasNames):new DomainComponentOpticBuilder(this.aliasMap,this.entityTypes,this.componentType,this.instanceName,[...this.navigationFilters,{...s,...i}],this.generated,this.entityTypeOrAliasNames)}withGradualFilter(t){let e=t=>"function"==typeof t?n(t,{}):t,i={navigationStates:e(t.navigationStates),selectedEntityIds:e(t.selectedEntityIds),hoveredEntityIds:e(t.hoveredEntityIds),draggedEntityIds:e(t.draggedEntityIds),exportedEntityIds:e(t.exportedEntityIds),viewStates:e(t.viewStates),toolStates:e(t.toolStates),exportStates:e(t.exportStates),modes:e(t.modes),roles:e(t.roles),active:e(t.active),fullscreen:e(t.fullscreen),debug:e(t.debug),viewports:e(t.viewports)};return new DomainComponentOpticBuilder(this.aliasMap,this.entityTypes,this.componentType,this.instanceName,[...this.navigationFilters,i],this.generated,this.entityTypeOrAliasNames)}validate(){if(!this.componentType||!this.instanceName)throw Error("Use withComponent before attaching");if(!this.entityTypes.length)throw Error("Use withEntity and/or withAlias before attaching")}_getProfilerLabel(){return[...this.entityTypeOrAliasNames,this.componentType.name,this.instanceName].join("_")}attach=(t,e)=>(this.validate(),a({kind:"simple",entityTypes:new Set(this.entityTypes),componentType:this.componentType,instanceName:this.instanceName,navigationFilters:this.navigationFilters,read:(e,i,n)=>t(n.domain.get$Entity(e,i),i,n),write:e??(()=>({})),generated:this.generated},this._getProfilerLabel()));attachMany=t=>(this.validate(),a({kind:"dynamic",entityTypes:new Set(this.entityTypes),componentType:this.componentType,instanceName:this.instanceName,navigationFilters:this.navigationFilters,read:(e,i,n)=>t(n.domain.get$Entity(e,i),i,n)},this._getProfilerLabel()))}

package/dist/domain/core/component/drag-state-component.d.ts

@@ -0,0 +1,16 @@
+import { type DomainEntityId, type EntityId } from '../model/index.js';
+export type DragStateComponentState = {
+    /** The entity currently being dragged in the scene, or `null` while nothing is dragged. */
+    readonly draggedEntityId: DomainEntityId<string> | null;
+};
+/**
+ * Component used to hold the drag state for the system virtual entity, so component filters can use
+ * the `draggedEntityIds` criterion. Written by the drag-and-drop system on drag start and end. Use this only via NavigationSystem
+ */
+export declare const dragStateComponent: import("../index.js").SystemComponentType<"dragState", DragStateComponentState, "draggedEntityId">;
+/**
+ * Component used to hold the drag state for the system virtual entity. Use this only via NavigationSystem
+ */
+export type DragStateComponent = typeof dragStateComponent;
+export declare const isDragStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"dragState", DragStateComponentState, "draggedEntityId">>;
+export declare const isSystemDragStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"dragState", DragStateComponentState, "draggedEntityId">>;

package/dist/domain/core/component/drag-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as t}from"../model/index.js";import{SystemComponentBuilder as e}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const dragStateComponent=e.component("dragState").withState({type:"object",properties:{draggedEntityId:{oneOf:[{type:"string"},{type:"null"}]}},required:["draggedEntityId"],additionalProperties:!1,tsType:"DragStateComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"DragStateComponentState"}]}).withWritableKeys(["draggedEntityId"]).build();export const isDragStateComponentSnapshot=e=>t(e,"singleton",dragStateComponent);export const isSystemDragStateComponentSnapshot=t(o,"singleton",dragStateComponent);

package/dist/domain/core/component/export-state-component.d.ts

@@ -0,0 +1,15 @@
+import { type DomainEntityId, type EntityId } from '../model/index.js';
+export type ExportStateComponentState = {
+    readonly activeState: string;
+    readonly exportedEntityId: DomainEntityId<string>;
+};
+/**
+ * Component used to hold tool state for system virtual entity. Use this only via NavigationSystem
+ */
+export declare const exportStateComponent: import("../index.js").SystemComponentType<"exportState", ExportStateComponentState, "activeState" | "exportedEntityId">;
+/**
+ * Component used to hold tool state for system virtual entity. Use this only via NavigationSystem
+ */
+export type ExportStateComponent = typeof exportStateComponent;
+export declare const isExportStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"exportState", ExportStateComponentState, "activeState" | "exportedEntityId">>;
+export declare const isSystemExportStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"exportState", ExportStateComponentState, "activeState" | "exportedEntityId">>;

package/dist/domain/core/component/export-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as t}from"../model/index.js";import{SystemComponentBuilder as e}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const exportStateComponent=e.component("exportState").withState({type:"object",properties:{activeState:{type:"string"},exportedEntityId:{oneOf:[{type:"string"},{type:"null"}]}},required:["activeState","exportedEntityId"],additionalProperties:!1}).withWritableKeys(["activeState","exportedEntityId"]).build();export const isExportStateComponentSnapshot=e=>t(e,"singleton",exportStateComponent);export const isSystemExportStateComponentSnapshot=t(o,"singleton",exportStateComponent);

package/dist/domain/core/component/fullscreen-state-component.d.ts

@@ -0,0 +1,14 @@
+import type { EntityId } from '../model/index.js';
+export type FullscreenStateComponentState = {
+    readonly enabled: boolean;
+};
+/**
+ * Component used to hold fullscren state for virtual scene entity. Use this only via NavigationSystem
+ */
+export declare const fullscreenStateComponent: import("../index.js").SystemComponentType<"fullscreenState", FullscreenStateComponentState, "enabled">;
+/**
+ * Component used to hold fullscren state for virtual scene entity. Use this only via NavigationSystem
+ */
+export type FullscreenStateComponent = typeof fullscreenStateComponent;
+export declare const isFullscreenStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"fullscreenState", FullscreenStateComponentState, "enabled">>;
+export declare const isSystemFullscreenStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"fullscreenState", FullscreenStateComponentState, "enabled">>;

package/dist/domain/core/component/fullscreen-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as e}from"../model/index.js";import{SystemComponentBuilder as t}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const fullscreenStateComponent=t.component("fullscreenState").withState({type:"object",properties:{enabled:{type:"boolean"}},required:["enabled"],additionalProperties:!1}).withWritableKeys(["enabled"]).build();export const isFullscreenStateComponentSnapshot=t=>e(t,"singleton",fullscreenStateComponent);export const isSystemFullscreenStateComponentSnapshot=e(o,"singleton",fullscreenStateComponent);

package/dist/domain/core/component/group-components-by-entity-id-and-name.d.ts

@@ -0,0 +1,8 @@
+import { type ComponentSnapshot, type EntityId, type SystemComponentTypeConstraint } from '../model/index.js';
+export type GroupedComponentSnapshots<COMPONENT_TYPE extends SystemComponentTypeConstraint> = {
+    [NAME in COMPONENT_TYPE['name']]: ReadonlyArray<ComponentSnapshot<Extract<COMPONENT_TYPE, {
+        name: NAME;
+    }>>> | undefined;
+};
+export declare const isEqualGroupedComponentSnapshots: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(a: GroupedComponentSnapshots<COMPONENT_TYPE>, b: GroupedComponentSnapshots<COMPONENT_TYPE>) => boolean;
+export declare const groupComponentsByEntityIdAndName: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(componentSnapshots: ReadonlyArray<ComponentSnapshot<COMPONENT_TYPE>>) => Map<EntityId, GroupedComponentSnapshots<COMPONENT_TYPE>>;

package/dist/domain/core/component/group-components-by-entity-id-and-name.js

@@ -0,0 +1 @@
+import{isArray as o,isShallowEqual as t}from"@salsita-ai/common/utils";import{areEqualComponentSnapshots as n,isEqualComponentSnapshot as e}from"../model/index.js";export const isEqualGroupedComponentSnapshots=(p,m)=>t(p,m,(t,p)=>t===p||void 0!==t&&void 0!==p&&(o(t)&&o(p)?n(t,p):!(o(t)||o(p))&&e(t,p)));export const groupComponentsByEntityIdAndName=o=>{let t=new Map;return o.forEach(o=>{let n=o.componentInstance.entityId,e=o.componentInstance.componentType.name,p=t.get(n);p||(p={},t.set(n,p));let m=p[e]??[];p[e]=m,m.push(o)}),t};

package/dist/domain/core/component/hover-state-component.d.ts

@@ -0,0 +1,14 @@
+import { type DomainEntityId, type EntityId } from '../model/index.js';
+export type HoverStateComponentState = {
+    readonly hoveredEntityId: DomainEntityId<string> | null;
+};
+/**
+ * Component used to hold hover state for system virtual entity. Use this only via NavigationSystem
+ */
+export declare const hoverStateComponent: import("../index.js").SystemComponentType<"hoverState", HoverStateComponentState, "hoveredEntityId">;
+/**
+ * Component used to hold hover state for system virtual entity. Use this only via NavigationSystem
+ */
+export type HoverStateComponent = typeof hoverStateComponent;
+export declare const isHoverStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"hoverState", HoverStateComponentState, "hoveredEntityId">>;
+export declare const isSystemHoverStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"hoverState", HoverStateComponentState, "hoveredEntityId">>;

package/dist/domain/core/component/hover-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as t}from"../model/index.js";import{SystemComponentBuilder as e}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const hoverStateComponent=e.component("hoverState").withState({type:"object",properties:{hoveredEntityId:{oneOf:[{type:"string"},{type:"null"}]}},required:["hoveredEntityId"],additionalProperties:!1,tsType:"HoverStateComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"HoverStateComponentState"}]}).withWritableKeys(["hoveredEntityId"]).build();export const isHoverStateComponentSnapshot=e=>t(e,"singleton",hoverStateComponent);export const isSystemHoverStateComponentSnapshot=t(o,"singleton",hoverStateComponent);

package/dist/domain/core/component/index.d.ts

@@ -0,0 +1,18 @@
+export type * from './component-reader-types.js';
+export * from './debug-state-component.js';
+export * from './domain-component-optic.js';
+export * from './drag-state-component.js';
+export * from './export-state-component.js';
+export * from './fullscreen-state-component.js';
+export * from './group-components-by-entity-id-and-name.js';
+export * from './hover-state-component.js';
+export * from './legacy-filter.js';
+export * from './navigation-state-component.js';
+export * from './selection-state-component.js';
+export * from './system-component-builder.js';
+export * from './system-component-filter.js';
+export * from './system-virtual-entity.js';
+export * from './tool-state-component.js';
+export * from './updates.js';
+export * from './view-state-component.js';
+export * from './viewport-state-component.js';

package/dist/domain/core/component/index.js

@@ -0,0 +1 @@
+export*from"./debug-state-component.js";export*from"./domain-component-optic.js";export*from"./drag-state-component.js";export*from"./export-state-component.js";export*from"./fullscreen-state-component.js";export*from"./group-components-by-entity-id-and-name.js";export*from"./hover-state-component.js";export*from"./legacy-filter.js";export*from"./navigation-state-component.js";export*from"./selection-state-component.js";export*from"./system-component-builder.js";export*from"./system-component-filter.js";export*from"./system-virtual-entity.js";export*from"./tool-state-component.js";export*from"./updates.js";export*from"./view-state-component.js";export*from"./viewport-state-component.js";