@salsita-ai/sdk 0.50.0-develop.b5468d6828 → 0.50.0-develop.b5d443db78

package/dist/docs/relations/child-nullable.mdx

@@ -260,8 +260,6 @@ components:
 ### ./src/expressions/hood.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Hood: {
     $hoodRecipes: () => {
@@ -324,8 +322,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/expressions/range.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $hoodRecipes: () => {

package/dist/docs/relations/child-required.mdx

@@ -260,8 +260,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $hoodRecipes: () => {

package/dist/docs/relations/collection-direct.mdx

@@ -291,8 +291,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {
@@ -402,8 +400,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/range.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Range: {
     minimumModuleCount: s => {

package/dist/docs/relations/collection-indirect.mdx

@@ -290,8 +290,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {
@@ -407,8 +405,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/range.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Range: {
     minimumModuleCount: s => {

package/dist/docs/relations/collection-multiple.mdx

@@ -301,8 +301,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Scene: {
     $firstRowRecipes: () => {

package/dist/docs/relations/cross-reference.mdx

@@ -341,8 +341,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {

package/dist/docs/relations/hierarchy.mdx

@@ -229,8 +229,6 @@ transformers:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Node: {
     $propertyPage: s => {

package/dist/docs/selection-and-highlight/canvas.mdx

@@ -169,7 +169,6 @@ presets:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/docs/selection-and-highlight/disable-highlight-per-object.mdx

@@ -309,7 +309,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/docs/selection-and-highlight/disable-highlight.mdx

@@ -178,7 +178,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/docs/selection-and-highlight/effects/outline.mdx

@@ -145,7 +145,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```
@@ -157,8 +156,6 @@ import { Environment } from '@react-three/drei'
 
 import { HoverOutline, Postprocessing, SelectionOutline } from '@salsita-ai/sdk/configurator'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createCustomPhoenixLayoutElement('CanvasEnvironment', () => {
   return (
     <>

package/dist/docs/selection-and-highlight/effects/overlay.mdx

@@ -144,7 +144,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```
@@ -156,8 +155,6 @@ import { Environment } from '@react-three/drei'
 
 import { LegacyHighlight, Postprocessing } from '@salsita-ai/sdk/configurator'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createCustomPhoenixLayoutElement('CanvasEnvironment', () => {
   return (
     <>

package/dist/docs/selection-and-highlight/fast-emissive-highlight.mdx

@@ -194,7 +194,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent, undefined, true)]
 ```
@@ -202,8 +201,6 @@ export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attac
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 const SurfaceSwatchMap = {
   Oak: {
     color: '#605F5D',

package/dist/docs/selection-and-highlight/group-highlighting.mdx

@@ -243,7 +243,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   ...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent),

package/dist/docs/selection-and-highlight/hierarchy.mdx

@@ -13,69 +13,81 @@ of transformers that will nail down the desired selection behavior and component
 The crucial things for this usecase are:
 
 - `createSelectParentOnDeselectionTransformer` is used to achieve selecting of the parent based on deselection
-- `createNavigationOnSelectionChangeTransformer` to navigate to entry states when entity is selected
-- `createResetSelectionOnNavigationTransformer` is used to disable selections in tabs where it should not apply
+- `when.entity([...]).selected({ insteadOf: [...] }).then.navigateTo(...)` to navigate to entry states when entity is selected
+- `when.navigated({ to: [...] }).then.deselect()` is used to disable selections in tabs where it should not apply
 - `.withGradualFilter` is used to show hotspots when their parent is selected
 
 Note: This is very complex use case, it is recommended to dive deeper into the codebase. This document covers just the basics.
 
 ## Code
 
-Register the selection fallback transformer (transformers start from 101 to run after the system transformers)
+Each transformer is the default export of a file in `src/transformers/`. The `transformers` section of the spec turns it on by the name passed to `build(...)`, or by the file name for a plain function such as `select-parent`. Without a `priority`, they run after the built-in transformers in the listed order (see [Transformers](?path=/docs/other-features-transformers--docs#transformer-pipeline)):
 
-```ts
-{
-    priority: 101,
-    transformer: createSelectParentOnDeselectionTransformer(ctx),
-}
+```yaml
+transformers:
+  - name: select-parent
+  - name: select-parent-from-monitor
+  - name: navigate-from-room
+  - name: navigate-from-console-group
+  - name: navigate-from-console-to-room
+  - name: navigate-from-console-to-group
+  - name: navigate-from-group-to-room
+  - name: reset-selection
 ```
 
-Configure the navigation details using
+Register the selection fallback transformer
 
 ```ts
-{
-    priority: 102,
-    transformer: transformer: createNavigationOnSelectionChangeTransformer(
-          'Room',
-          'Console',
-          NavigationStateTag.ConsoleShape,
-          ctx
-        ),
-}
+// src/transformers/select-parent.ts
+import { createSelectParentOnDeselectionTransformer } from '@salsita-ai/sdk/domain'
+
+export default createSelectParentOnDeselectionTransformer
 ```
 
-Setup states when selection is rest on navigation changes
+Configure the navigation details, one transformer per selection change, e.g. from the room to a console
 
 ```ts
-{
-    priority: 103,
-    transformer: createResetSelectionOnNavigationTransformer([NavigationStateTag.Colors, NavigationStateTag.RoomLayout], ctx),
-},
+// src/transformers/navigate-from-room.ts
+export default phx.frontend.transformerBuilder.when
+  .entity(['Console'])
+  .selected({ insteadOf: ['Room'] })
+  .then.navigateTo(phx.applicationTypes.NavigationState.ConsoleShape)
+  .build('navigate-from-room')
+```
 
+Setup states when selection is reset on navigation changes
+
+```ts
+// src/transformers/reset-selection.ts
+export default phx.frontend.transformerBuilder.when
+  .navigated({
+    to: [phx.applicationTypes.NavigationState.Colors, phx.applicationTypes.NavigationState.RoomLayout],
+  })
+  .then.deselect()
+  .build('reset-selection')
 ```
 
 Register the selection controls to be shown only if parent is selected
 
 ```tsx
- attachComponent
-        .withComponent(htmlHotspotComponent, 'main')
-        .withEntity('Monitor')
-        .withGradualFilter({
-          navigationStates: [NavigationStateTag.ConsoleMonitors],
-          selectedEntityIds: s => [s.$parent.id],
-        })
-        .attach(
-          memoEval(
-            s => [s.id],
-            id => ({
-              offsetX: 0,
-              offsetY: 500,
-              offsetZ: 1500,
-              unit: 'mm',
-              node: <SelectionHotspot id={id} />,
-            })
-          )
-        ),
+phx.domain.attachComponent
+  .withComponent(htmlHotspotComponent, 'main')
+  .withEntity('Monitor')
+  .withGradualFilter({
+    navigationStates: [phx.applicationTypes.NavigationState.ConsoleMonitors],
+    selectedEntityIds: s => [s.$parent.id, ...s.$parent.$monitors.map(m => m.id).filter(m => m !== s.id)],
+  })
+  .attach(
+    memoEval(
+      s => [s.id],
+      id => ({
+        offsetX: 0,
+        offsetY: 300,
+        offsetZ: 500,
+        node: <SelectionHotspot id={id} />,
+      })
+    )
+  )
 ```
 
 ## Example
@@ -328,7 +340,6 @@ import { entityHeaderComponent, htmlHotspotComponent, memoEval, sidebarTabsCompo
 
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
 import { getMonitorRenderingComponents } from '../../../../common/monitor-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   ...getConsoleRenderingComponents('Console', phx.domain.attachComponent),
@@ -480,8 +491,6 @@ export default [
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   ConsoleGroup: {
     $center: s => {
@@ -497,142 +506,82 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/transformers/navigate-from-console-group.ts
 
 ```ts
-import { createNavigationOnSelectionChangeTransformer } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return createNavigationOnSelectionChangeTransformer(
-    'ConsoleGroup',
-    'Console',
-    phx.applicationTypes.NavigationState.ConsoleShape,
-    ctx
-  )
-})
+export default phx.frontend.transformerBuilder.when
+  .entity(['Console'])
+  .selected({ insteadOf: ['ConsoleGroup'] })
+  .then.navigateTo(phx.applicationTypes.NavigationState.ConsoleShape)
+  .build('navigate-from-console-group')
 ```
 
 ### ./src/transformers/navigate-from-console-to-group.ts
 
 ```ts
-import { createNavigationOnSelectionChangeTransformer } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return createNavigationOnSelectionChangeTransformer(
-    'Console',
-    'ConsoleGroup',
-    phx.applicationTypes.NavigationState.Console,
-    ctx
-  )
-})
+export default phx.frontend.transformerBuilder.when
+  .entity(['ConsoleGroup'])
+  .selected({ insteadOf: ['Console'] })
+  .then.navigateTo(phx.applicationTypes.NavigationState.Console)
+  .build('navigate-from-console-to-group')
 ```
 
 ### ./src/transformers/navigate-from-console-to-room.ts
 
 ```ts
-import { createNavigationOnSelectionChangeTransformer } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return createNavigationOnSelectionChangeTransformer(
-    'Console',
-    'Room',
-    phx.applicationTypes.NavigationState.Console,
-    ctx
-  )
-})
+export default phx.frontend.transformerBuilder.when
+  .entity(['Room'])
+  .selected({ insteadOf: ['Console'] })
+  .then.navigateTo(phx.applicationTypes.NavigationState.Console)
+  .build('navigate-from-console-to-room')
 ```
 
 ### ./src/transformers/navigate-from-group-to-room.ts
 
 ```ts
-import { createNavigationOnSelectionChangeTransformer } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return createNavigationOnSelectionChangeTransformer(
-    'ConsoleGroup',
-    'Room',
-    phx.applicationTypes.NavigationState.Console,
-    ctx
-  )
-})
+export default phx.frontend.transformerBuilder.when
+  .entity(['Room'])
+  .selected({ insteadOf: ['ConsoleGroup'] })
+  .then.navigateTo(phx.applicationTypes.NavigationState.Console)
+  .build('navigate-from-group-to-room')
 ```
 
 ### ./src/transformers/navigate-from-room.ts
 
 ```ts
-import { createNavigationOnSelectionChangeTransformer } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return createNavigationOnSelectionChangeTransformer(
-    'Room',
-    'Console',
-    phx.applicationTypes.NavigationState.ConsoleShape,
-    ctx
-  )
-})
+export default phx.frontend.transformerBuilder.when
+  .entity(['Console'])
+  .selected({ insteadOf: ['Room'] })
+  .then.navigateTo(phx.applicationTypes.NavigationState.ConsoleShape)
+  .build('navigate-from-room')
 ```
 
 ### ./src/transformers/reset-selection.ts
 
 ```ts
-import { createResetSelectionOnNavigationTransformer } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return createResetSelectionOnNavigationTransformer(
-    [phx.applicationTypes.NavigationState.Colors, phx.applicationTypes.NavigationState.RoomLayout],
-    ctx
-  )
-})
+export default phx.frontend.transformerBuilder.when
+  .navigated({
+    to: [phx.applicationTypes.NavigationState.Colors, phx.applicationTypes.NavigationState.RoomLayout],
+  })
+  .then.deselect()
+  .build('reset-selection')
 ```
 
 ### ./src/transformers/select-parent-from-monitor.ts
 
 ```ts
-import { isNavigationUpdate } from '@salsita-ai/sdk/domain'
-
-import { phx } from '../../.phoenix/phx.js'
-
-export default phx.frontend.createTransformer(ctx => {
-  return (updates, state) => {
-    return updates.flatMap(update => {
-      if (!isNavigationUpdate(update)) {
-        return [update]
-      }
-
-      if (
-        (
-          [
-            phx.applicationTypes.NavigationState.ConsoleAccessories,
-            phx.applicationTypes.NavigationState.ConsoleShape,
-          ] as string[]
-        ).includes(update.writableState.activeState)
-      ) {
-        const selectedEntity = ctx.navigationSystem.getActiveSelectionState(state)
-
-        if (phx.domain.model.Monitor.isId(selectedEntity)) {
-          const parent = ctx.compositionProjections.getTree(state).map.get(selectedEntity)?.parent
-
-          if (parent) {
-            return [update, ctx.navigationSystem.getSelectUpdate(parent.id)]
-          }
-        }
-
-        return [update]
-      }
-
-      return [update]
-    })
-  }
-})
+export default phx.frontend.transformerBuilder.when
+  .navigated({
+    to: [phx.applicationTypes.NavigationState.ConsoleAccessories, phx.applicationTypes.NavigationState.ConsoleShape],
+  })
+  .then.select.entity(ctx => {
+    const oldState = ctx.getOldState()
+    const selectedEntity = ctx.domainContext.navigationSystem.getActiveSelectionState(oldState)
+
+    if (!phx.domain.model.Monitor.isId(selectedEntity)) {
+      return undefined
+    }
+
+    return ctx.domainContext.compositionProjections.getTree(oldState).map.get(selectedEntity)?.parent?.id
+  })
+  .build('select-parent-from-monitor')
 ```
 
 ### ./src/transformers/select-parent.ts

package/dist/docs/selection-and-highlight/hotspots.mdx

@@ -56,6 +56,8 @@ sceneEntitySelectHotspot:
 
 The `title` supplies the tooltip text. Tooltips appear on hover by default; `tooltipVisibility` can instead keep them visible continuously, while the camera is still, or hide them. The `showWhen` property controls visibility based on selection state. The default `['unselected']` hides hotspots once entities are selected, keeping the view clean. Setting it to `['selected', 'unselected']` keeps hotspots always visible.
 
+The hotspot is the entity element `SelectionHotspot`. A project replaces its look by registering its own with `phx.frontend.createSelectionHotspot`, which receives `onSelect`, the selection with its analytics event; the settings above still apply. See [Configurator Interface → In-Scene Controls](?path=/docs/phoenix-configurator-interface--docs#in-scene-controls).
+
 ## System Component Interfaces
 
 ```typescript
@@ -277,7 +279,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/domain/application/GetApplicationWrapperHandler.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentType } from 'react';
 import type { $DomainEntity, DomainEntity } from '../core/index.js';
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../domain-runtime/index.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../spec/index.js';
 import type { ApplicationConfig } from './application-config.js';
 export declare const createGetApplicationWrapperHandler: (fn: (ctx: ApplicationConfig<any, any, any, any, any, any, never, any, any, any, any, any, any, any, any, any>) => ComponentType) => SystemPhoenixHandlerRegistration<ApplicationConfig<any, any, any, any, any, any, never, any, any, any, any, any, any, any, any, any>, ComponentType>;
 export type CreateGetApplicationWrapperHandler = typeof createGetApplicationWrapperHandler;

package/dist/domain/application/GetThemeHandler.d.ts

@@ -1,5 +1,5 @@
 import type { ThemeOptions } from '@mui/material';
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../domain-runtime/index.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../spec/index.js';
 export declare const GetThemeHandlerName = "GetThemeHandler";
 export declare const createGetThemeHandler: (fn: () => ThemeOptions) => SystemPhoenixHandlerRegistration<void, ThemeOptions>;
 export type CreateGetThemeHandler = (fn: () => ThemeOptions) => SystemPhoenixHandlerRegistration<void, ThemeOptions>;

package/dist/domain/application/GetWebComponentOptions.d.ts

@@ -1,4 +1,4 @@
-import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../domain-runtime/index.js';
+import type { HandlerRegistration, SystemPhoenixHandlerRegistration } from '../spec/index.js';
 import type { WebComponentOptions } from './application-config.js';
 export declare const createGetWebComponentOptionsHandler: (fn: () => WebComponentOptions) => SystemPhoenixHandlerRegistration<undefined, WebComponentOptions>;
 export type CreateGetWebComponentOptionsHandler = (fn: () => WebComponentOptions) => SystemPhoenixHandlerRegistration<undefined, WebComponentOptions>;

package/dist/domain/application/application-config.d.ts

@@ -8,8 +8,7 @@ import type { CellValue } from '@salsita-ai/contracts/webhook';
 import type { AdminIntegrationService } from '#package/react-sdk';
 import type { $DomainEntity, DataCellValue, DataSchema, DomainEntity, DomainFactory, ProductPreset } from '../core/index.js';
 import type { AnalyticsSystem, RegistrableTransformer, TransformerFactory } from '../domain-context/index.js';
-import type { ElementRegistration, ProjectModule } from '../domain-runtime/index.js';
-import type { AssistantResolvedManifest } from './assistant/index.js';
+import type { AdminPagesSection, AssistantResolvedManifest, ElementRegistration, ProjectModule } from '../spec/index.js';
 import type { WebComponentEventDescriptor } from './web-component-event.js';
 import type { WebComponentPropertyDescriptor } from './web-component-property.js';
 type TransformerExport = ReturnType<TransformerFactory<any, any, any, any, any, any, any>> | RegistrableTransformer<any, any, any, any, any, any, any>;
@@ -55,30 +54,11 @@ export type DataSpec = {
 export type ChunksSpec = Readonly<Record<string, {
     readonly scope: string;
 }>>;
-export type AdminPagesSpec = {
-    readonly presets?: boolean | {
-        readonly categoryNavigationState?: string;
-        readonly presetNavigationState?: string;
-    };
-    readonly recipes?: ReadonlyArray<{
-        readonly name: string;
-        readonly navigationState?: string;
-    }>;
-    readonly pages?: ReadonlyArray<{
-        readonly key: string;
-        readonly title: string;
-        readonly icon?: string;
-        readonly navigationState?: string;
-        readonly entity?: string;
-        readonly component?: string;
-        readonly actionsComponent?: string;
-        readonly connectedDataEntry?: string;
-        readonly sidebar?: {
-            readonly title: string;
-            readonly component: string;
-        };
-    }>;
-};
+/**
+ * The admin pages of an application config: the `$adminPages` section of the application spec as
+ * written, which `createAdminPagesFromSpec` turns into admin pages; see {@link AdminPagesSection}.
+ */
+export type AdminPagesSpec = AdminPagesSection;
 type PersistenceConfig = {
     readonly type: 'server';
     /**

package/dist/domain/application/assistant/assistant-fields.d.ts

@@ -1,4 +1,4 @@
-import type { AssistantDeclaredField, AssistantResolvedField } from './assistant-resolved-manifest.js';
+import type { AssistantDeclaredField, AssistantResolvedField } from '../../spec/index.js';
 /** Combines the effective description with allowed string values. */
 export declare const describeAssistantValues: (description: string | undefined, values: readonly string[] | undefined) => string | undefined;
 /** Applies GraphQL field inheritance identically at parse time and after session narrowing. */

package/dist/domain/application/assistant/assistant-value-type.d.ts

@@ -1,5 +1,5 @@
 import { type GraphQLInputType, type GraphQLOutputType, GraphQLScalarType } from 'graphql';
-import type { AssistantValueType } from './assistant-resolved-manifest.js';
+import type { AssistantValueType } from '../../spec/index.js';
 /**
  * Opaque scalar for values the assistant schema does not type: objects, custom TypeScript types and
  * loose unions. A value is plain serializable data and passes through unchanged.

package/dist/domain/application/assistant/build-assistant-lenses.d.ts

@@ -1,6 +1,5 @@
 import { type GraphQLSchema } from 'graphql';
-import type { AssistantManifest } from './assistant-manifest.js';
-import type { AssistantResolvedManifest } from './assistant-resolved-manifest.js';
+import type { AssistantManifest, AssistantResolvedManifest } from '../../spec/index.js';
 /**
  * Generates the lens fragments of a resolved manifest for the execution schema compiled from it. A
  * declared lens becomes one fragment on `AnyDomainEntity`; one that session narrowing left without a

package/dist/domain/application/assistant/build-assistant-lenses.js

@@ -1,4 +1,4 @@
-import{NoUnusedFragmentsRule as e,parse as t,specifiedRules as i,validate as n}from"graphql";let s="AnyDomainEntity",r=[{name:"RecipeGroup",description:"A recipe group with its recipes, without their dry-runs.",selections:["groupId","name","description","recipes { ...Recipe }"]},{name:"Recipe",description:"A recipe without its dry-run.",selections:["key","name","description","imageUrl"]},{name:"FieldOption",description:"A value a field accepts, without its dry-run.",selections:["value","name","description","imageUrl","color"]},{name:"DryRun",description:"What a dry-run would do, with the ids of the entities it would change instead of the entities.",selections:["ok","deletedEntityIds","sideEffects","errors { type entityId message }","changedEntities { id }"]}],a=(e,t)=>0===t?e:`${e}__${t}`,l=e=>e.split("\n").map(e=>`# ${e}`.trimEnd()).join("\n"),o=(e,t,i)=>[`fragment ${e} on ${t} {`,...i.map(e=>`  ${e}`),"}"].join("\n"),p=(e,t,i)=>{let n=e=>"edge"===e.type.kind?`${e.name} { ${i} }`:e.name;return o(e,s,["id",...t.flatMap(({typeName:e,fields:t})=>e===s?t.map(n):[`... on ${e} {`,...t.map(e=>`  ${n(e)}`),"}"])])};export const buildAssistantLenses=(d,m)=>{let c=Object.entries(d.lenses).flatMap(([e,t])=>{let i=[s,...Object.keys(d.aliases).filter(e=>e!==s),...d.entityTypes].flatMap(t=>{let i=(d.fields[t]??[]).filter(t=>t.lenses?.includes(e));return i.length>0?[{typeName:t,fields:i}]:[]});return i.length>0?[{name:e,...t,conditions:i}]:[]}),$=r.filter(({name:e})=>void 0!==m.getType(e)),h=[...c.map(({name:e,description:t,maxDepth:i,conditions:n})=>{let s=n.some(({fields:e})=>e.some(e=>"edge"===e.type.kind));return`${l(s?`${t} ${`Nested relations carry the same selection up to ${i} ${1===i?"level":"levels"}, below that only \`id\`.`}`:t)}
+import{NoUnusedFragmentsRule as e,parse as t,specifiedRules as i,validate as n}from"graphql";let s="AnyDomainEntity",r=[{name:"RecipeGroup",description:"A recipe group with its recipes, without their dry-runs.",selections:["groupId","name","description","recipes { ...Recipe }"]},{name:"Recipe",description:"A recipe without its dry-run.",selections:["key","name","description","imageUrl"]},{name:"FieldOption",description:"A value a field accepts, without its dry-run.",selections:["value","name","description","imageUrl","color"]},{name:"DryRun",description:"What a dry-run would do, with the ids of the entities it would change instead of the entities.",selections:["ok","deletedEntityIds","sideEffects","warnings","errors { type entityId message }","changedEntities { id }"]}],a=(e,t)=>0===t?e:`${e}__${t}`,l=e=>e.split("\n").map(e=>`# ${e}`.trimEnd()).join("\n"),o=(e,t,i)=>[`fragment ${e} on ${t} {`,...i.map(e=>`  ${e}`),"}"].join("\n"),p=(e,t,i)=>{let n=e=>"edge"===e.type.kind?`${e.name} { ${i} }`:e.name;return o(e,s,["id",...t.flatMap(({typeName:e,fields:t})=>e===s?t.map(n):[`... on ${e} {`,...t.map(e=>`  ${n(e)}`),"}"])])};export const buildAssistantLenses=(d,m)=>{let c=Object.entries(d.lenses).flatMap(([e,t])=>{let i=[s,...Object.keys(d.aliases).filter(e=>e!==s),...d.entityTypes].flatMap(t=>{let i=(d.fields[t]??[]).filter(t=>t.lenses?.includes(e));return i.length>0?[{typeName:t,fields:i}]:[]});return i.length>0?[{name:e,...t,conditions:i}]:[]}),$=r.filter(({name:e})=>void 0!==m.getType(e)),h=[...c.map(({name:e,description:t,maxDepth:i,conditions:n})=>{let s=n.some(({fields:e})=>e.some(e=>"edge"===e.type.kind));return`${l(s?`${t} ${`Nested relations carry the same selection up to ${i} ${1===i?"level":"levels"}, below that only \`id\`.`}`:t)}
 ${p(e,n,`...${e}`)}`}),...$.map(({name:e,description:t,selections:i})=>`${l(t)}
 ${o(e,e,i)}`)].join("\n\n"),u=[...c.flatMap(({name:e,maxDepth:t,conditions:i})=>Array.from({length:t+1},(n,s)=>p(a(e,s),i,s<t?`...${a(e,s+1)}`:"id"))),...$.map(({name:e,selections:t})=>o(e,e,t))].join("\n\n");if(""!==u){let s=c.length>0?`entities { ${c.map(({name:e})=>`...${e}`).join(" ")} }`:"__typename",r=n(m,t(`${u}