@salsita-ai/sdk 0.50.0-develop.f101f4c3c9 → 0.50.0-develop.f354d3576d

package/dist/docs/drag-and-drop/snapping/label-matching-demo.mdx

@@ -314,8 +314,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const SourceSize = 400
 const sourceGeometry = new THREE.BoxGeometry(SourceSize, SourceSize, SourceSize)
 sourceGeometry.translate(0, SourceSize / 2, 0)

package/dist/docs/drag-and-drop/snapping/multi-snap-composition-demo.mdx

@@ -260,8 +260,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const WallThickness = 20
 const WallHeight = 400
 const WallLength = 3000

package/dist/docs/drag-and-drop/snapping/nested-entity-demo.mdx

@@ -308,8 +308,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 // Wall geometry
 const WallWidth = 20
 const WallHeight = 500

package/dist/docs/drag-and-drop/snapping/priority-demo.mdx

@@ -228,8 +228,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const DockSize = 500
 const DockHeight = 100
 

package/dist/docs/drag-and-drop/snapping/snap-axis-demo.mdx

@@ -313,8 +313,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const TableWidth = 2000
 const TableHeight = 400
 const TableDepth = 1000

package/dist/docs/drag-and-drop/snapping/snap-edge-demo.mdx

@@ -264,8 +264,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const TableWidth = 1000
 const TableHeight = 400
 const TableDepth = 600

package/dist/docs/drag-and-drop/snapping/snap-plane-demo.mdx

@@ -71,7 +71,6 @@ When an item's `offsetY` is a derived expression (read from a `$`-prefixed custo
 
 ```ts
 // src/expressions/item.ts
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Item: {
@@ -399,8 +398,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const WallWidth = 20
 const WallHeight = 500
 const WallDepth = 2000
@@ -492,8 +489,6 @@ export default [
 ### ./src/expressions/item.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 const ELEVATED_ZONE_START_Z = 1000
 const PLATFORM_HEIGHT = 300
 

package/dist/docs/drag-and-drop/snapping/snap-point-demo.mdx

@@ -214,8 +214,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const TableWidth = 1000
 const TableHeight = 400
 const TableDepth = 600

package/dist/docs/drag-and-drop/spatial-constraints/collision-system.mdx

@@ -266,8 +266,6 @@ import * as THREE from 'three'
 
 import { collisionGeometryComponent, memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const BlockHeight = 200
 
 const blueMaterial = new THREE.MeshStandardMaterial({ color: '#4a90d9' })

package/dist/docs/drag-and-drop/spatial-constraints/disjoint-and-within.mdx

@@ -364,8 +364,6 @@ import * as THREE from 'three'
 
 import { collisionGeometryComponent, memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const BlockHeight = 200
 
 const blueMaterial = new THREE.MeshStandardMaterial({ color: '#4a90d9' })
@@ -432,8 +430,6 @@ export default [
 ### ./src/expressions/block.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Block: {
     $sceneId: block => block.$scene.id,
@@ -448,8 +444,6 @@ import { msg } from '@lingui/core/macro'
 
 import type { Violation } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 /**
  * Wires declared `constraint` components into the invariant pipeline.
  * `evaluateConstraints` returns the predicates a Block currently violates

package/dist/docs/drag-and-drop/spatial-constraints/geometry-override.mdx

@@ -377,8 +377,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const SectionHeight = 200
 const MarkerSize = 250
 
@@ -445,8 +443,6 @@ import { msg } from '@lingui/core/macro'
 
 import type { Violation } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const DISJOINT_VIOLATION: Violation<'constraintDisjoint'> = {
   type: 'constraintDisjoint',
   severity: 'warning',

package/dist/docs/drag-and-drop/spatial-constraints/multiple-collision-meshes.mdx

@@ -578,8 +578,6 @@ import * as THREE from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const WoodColor = '#b27a3a'
 const WoodOpacity = 0.55
 
@@ -669,8 +667,6 @@ import { msg } from '@lingui/core/macro'
 
 import type { Violation } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const TOUCHES_VIOLATION: Violation<'constraintTouches'> = {
   type: 'constraintTouches',
   severity: 'warning',

package/dist/docs/drag-and-drop/spatial-constraints/touches.mdx

@@ -387,8 +387,6 @@ import * as THREE from 'three'
 
 import { collisionGeometryComponent, memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const BlockHeight = 200
 
 const blueMaterial = new THREE.MeshStandardMaterial({ color: '#4a90d9' })
@@ -464,8 +462,6 @@ import { msg } from '@lingui/core/macro'
 
 import type { Violation } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 /**
  * Wires declared `constraint` components into the invariant pipeline.
  * `evaluateConstraints` returns the predicates a Block currently violates

package/dist/docs/drag-and-drop/swap.mdx

@@ -380,7 +380,6 @@ import { collisionGeometryComponent, memoEval } from '@salsita-ai/sdk/domain'
 
 import { getConsoleOutlineGeometry, getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
 import { getMonitorRenderingComponents } from '../../../../common/monitor-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   ...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent),
@@ -409,7 +408,6 @@ import { useEffect } from 'react'
 import { dragHandleComponent, isDomainEntityId } from '@salsita-ai/sdk/domain'
 
 import { ConsoleWidth } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.frontend.createOnConfiguratorReadyProvider(({ children }: { children?: React.ReactNode }) => {
   const domainCtx = phx.frontend.useDomain()
@@ -546,8 +544,6 @@ export default phx.frontend.createOnConfiguratorReadyProvider(({ children }: { c
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Cluster: {
     $parent: s => {

package/dist/docs/fabs/basic.mdx

@@ -16,15 +16,13 @@ For this you can use the following on-scene controls:
 - `sceneEntityDeleteFab` - to delete an entity
 - `sceneEntityAddFab` - to add an entity using a recipe
 
-(or the `Object` variants of each: `sceneEntityObjectSelectHotspot`, `sceneEntityObjectDeleteFab`, `sceneEntityObjectAddFab`)
-
 Note that `sceneEntitySelectHotspot` is described in a [separate story](./?path=/docs/selection-highlight-hotspots--docs) and here we focus solely on the `sceneEntityDeleteFab` and `sceneEntityAddFab` controls.
 
 - Give every icon-only or otherwise unlabeled FAB a title so Phoenix shows a tooltip. Prefer a visible label when the action has room for one.
 
 ## Code
 
-Like any other on-scene control (fab or hotspot), the attached component lets you specify position of the control relative to the entity (or its object for the `Object` variants): `offsetX`, `offsetY` and `offsetZ` properties. The values are scaled by the unit specified in the `unit` property to the scene's coordinate space.
+Like any other on-scene control (fab or hotspot), the attached component lets you specify position of the control relative to the entity: `offsetX`, `offsetY` and `offsetZ` properties. The values are in the application's distance data unit, see [Dimension Data Unit](?path=/docs/dimensions-basic-concepts-dimension-data-unit--docs).
 
 ```yaml
 components:
@@ -51,13 +49,14 @@ Additionally, the on-scene controls support various dynamic visibility condition
   - `sceneEntityDeleteFab` - `['selected']`
   - `sceneEntityAddFab` - `['selected']`
 
-Both controls are represented by a floating action button that can optionally take a tooltip `title`, `label`, and PHX `icon` name. Both
-these properties are localizable. When specifying a `label` the button will be displayed in an "extended" variant (see the live example).
+Both controls are represented by a floating action button that can optionally take a tooltip `title` and a PHX `icon` name. `sceneEntityAddFab` also takes a `label`; `title` and `label` are localizable. When specifying a `label` the button will be displayed in an "extended" variant (see the live example).
 
-Lastly as both `sceneEntityDeleteFab` and `sceneEntityAddFab` are controls that modify state of the configuration, they allow filtering out of certain violation types so that the error message tooltip is not too crowded:
+Lastly as `sceneEntityAddFab` is a control that modifies state of the configuration, it allows filtering out of certain violation types so that the error message tooltip is not too crowded:
 
 - `hiddenViolations` - an array of violation types to hide from the error message tooltip
 
+In the spec, `label` and `hiddenViolations` are accepted by `sceneEntityAddFab` only: the `sceneEntityDeleteFab` schema rejects both.
+
 #### Limiting Visibility base on camera position
 
 All on-scene controls allow definition of `azimuthAngleLimits`, `polarAngleLimits` and `distanceLimits` properties to limit the visibility of the control based on the camera position. These properties optionally take an object with the following properties:
@@ -66,7 +65,7 @@ All on-scene controls allow definition of `azimuthAngleLimits`, `polarAngleLimit
 - `minOpacity` - the opacity of the control when the camera is out of the range (default is `0`)
 - `smoothZone` - zone that eats from both sides of the range, where the opacity is interpolated from `minOpacity` to `1.0` (default is `(max - min) / 8`)
 
-All three limits can be used separately or combined. The angle limits are in radians and the distance limits respect the `unit` defined on the component.
+All three limits can be used separately or combined. The angle limits are in radians and the distance limits are in the application's distance data unit, like the offsets.
 
 #### Displaying Tooltips
 
@@ -81,7 +80,7 @@ All on-scene controls allow definitions of `title` and `tooltipVisibility` prope
 
 ### Delete Fab
 
-The `sceneEntityDeleteFab` accepts `icon` to replace its built-in trash icon. Its `Object` variant keeps the built-in icon.
+The `sceneEntityDeleteFab` accepts `icon` to replace its built-in trash icon.
 
 ### Add Entity Fab
 
@@ -151,7 +150,7 @@ Here you can see the live example!
     - This should be disabled when there's 5 holes in the plate already.
     - Clicking it should directly add a new hole to the plate.
 - There should be a selection hotspot over each hole.
-- After selecting a hole through the hotspot, a delete button with `Trash` icon should appear.
+- After selecting a hole through the hotspot, a delete button with the `X` icon should appear.
   - This should be disabled for the top-right hole as that is a special glorified hole.
   - Clicking it should delete the selected hole and cause no errors in the console :-)
 - Toggle tooltip visibility to control the tooltip on the `+` Fab
@@ -393,7 +392,6 @@ invariants:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -458,8 +456,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     one54: s => s.$features.filter(phx.domain.model.Hole54.is).length === 1,

package/dist/docs/fabs/layout.mdx

@@ -346,7 +346,6 @@ invariants:
 
 ```ts
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```
@@ -356,8 +355,6 @@ export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attac
 ```tsx
 import { Paper, Typography } from '@mui/material'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createCustomPhoenixEntityElement('LabelHotspot', ({ entityId }) => (
   <Paper
     sx={{
@@ -375,8 +372,6 @@ export default phx.frontend.createCustomPhoenixEntityElement('LabelHotspot', ({
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   ConsoleUnit: {
     $newConsoleRecipes: () => {
@@ -396,8 +391,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Scene: {
     maxOneConsoleUnit: s => s.$consoleUnits.length <= 1,

package/dist/docs/index.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-10-16T14:45:34.655Z",
+  "generatedAt": "2026-10-21T13:20:47.807Z",
   "categories": [
     {
       "name": "Phoenix",
@@ -881,6 +881,100 @@
           ],
           "subcategories": []
         },
+        {
+          "name": "Gallery",
+          "docs": [
+            {
+              "title": "Ardent Compressor",
+              "description": "Quote an engineered product from a form, with no 3D model at all. An industrial compressor maker, Ardent Air, lets plant engineers size a rotary screw compressor and ask for a firm quote. The...",
+              "path": "docs/layouts/gallery/ardent-compressor.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Ardent Compressor"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Corvid Drone",
+              "description": "Build a pro tool in which an engineer configures a product and a client reads the result. A drone maker, Corvid Aero, has its engineers configure the K6 survey drone for each customer: the frame, the...",
+              "path": "docs/layouts/gallery/corvid-drone.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Corvid Drone"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Fenwick Window",
+              "description": "Show a made-to-measure product as the drawing a workshop would build it from. A joinery, Fenwick & Lowe, sells timber casement windows to order: the customer sets the overall size, the panes across,...",
+              "path": "docs/layouts/gallery/fenwick-window.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Fenwick Window"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Ferrule Bar Station",
+              "description": "Let a bar designer lay out a commercial bartender station and hand the result straight to the workshop. A fictional maker, Ferrule Barworks, sells stainless underbar stations built from modules: ice...",
+              "path": "docs/layouts/gallery/ferrule-bar-station.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Ferrule Bar Station"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Kestrel Kettle",
+              "description": "Sell a small product from one calm page that looks like the shop's own. A specialty-coffee shop, Aldermoor Coffee, sells its Kestrel pour-over kettle in three finishes, two handle woods and with or...",
+              "path": "docs/layouts/gallery/kestrel-kettle.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Kestrel Kettle"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Nightjar Guitar",
+              "description": "Walk a customer through a product one step at a time and end in an order. A custom guitar shop, Northfret, sells its Nightjar electric guitar through a five-step wizard: the body, the neck, the...",
+              "path": "docs/layouts/gallery/nightjar-guitar.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Nightjar Guitar"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Sunfold Solar",
+              "description": "Help a household decide on a system by showing what it would do for them. A solar installer, Sunfold, lets a homeowner plan panels and a battery for their roof: the roof's area and direction, the...",
+              "path": "docs/layouts/gallery/sunfold-solar.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Sunfold Solar"
+              ],
+              "source": "storybook-example"
+            },
+            {
+              "title": "Tidepool Aquascape",
+              "description": "Let a customer compose a product from pieces they add, change and take away, in a workspace that shows the result as they go. An aquascaping studio, Tidepool Studio, sells planted aquariums: the...",
+              "path": "docs/layouts/gallery/tidepool-aquascape.mdx",
+              "category": [
+                "Layouts",
+                "Gallery",
+                "Tidepool Aquascape"
+              ],
+              "source": "storybook-example"
+            }
+          ],
+          "subcategories": []
+        },
         {
           "name": "Header",
           "docs": [
@@ -1118,7 +1212,7 @@
         },
         {
           "title": "Text Input",
-          "description": "Describe the use case for this story. What problem does it solve? When should this pattern be used?",
+          "description": "Let the user type free text that becomes part of the configuration: a name for the design, an engraving on a heater panel, a signature on a guitar, a monogram on a bag. The text is stored in a string...",
           "path": "docs/controls/text-input.mdx",
           "category": [
             "Controls",
@@ -2785,7 +2879,7 @@
         },
         {
           "title": "Navigation Guard",
-          "description": "Describe the use case for this story. What problem does it solve? When should this pattern be used?",
+          "description": "Ask the user to confirm a navigation before it happens, when it would cost them work. A stepped configurator, such as a kitchen planner whose first step picks the room shape and whose later steps...",
           "path": "docs/complex-use-cases/navigation-guard.mdx",
           "category": [
             "Complex Use Cases",
@@ -2795,7 +2889,7 @@
         },
         {
           "title": "Navigation Reset Selection",
-          "description": "The `createResetSelectionOnNavigationTransformer` automatically deselects entities when the user navigates to specific steps. This clears the active selection when entering certain workflow phases,...",
+          "description": "A transformer built with `when.navigated({ to: [...] }).then.deselect()` automatically deselects entities when the user navigates to specific steps. This clears the active selection when entering...",
           "path": "docs/complex-use-cases/navigation-reset-selection.mdx",
           "category": [
             "Complex Use Cases",

package/dist/docs/integrations/lifecycle-providers.mdx

@@ -26,7 +26,6 @@ Read published data, authenticated session data, and web-component properties di
 ```tsx
 import { useWebComponentPropertyValue } from '@salsita-ai/sdk/react'
 
-import { phx } from '../../.phoenix/phx.js'
 import { webComponentProperties } from '../_shared/web-component-options.js'
 
 export default phx.frontend.createOnPublishedDataReadyProvider(({ children }) => {
@@ -49,8 +48,6 @@ The provider must render `children` when validation passes. Returning an empty f
 Use `createOnFrontendDataReadyProvider` to reject an unsupported combination of host inputs before Phoenix sends collected frontend data to the backend. Use `createOnBackendDataReadyProvider` to check a returned price list or permissions before the configurator initializes. Register each provider in its own `src/elements/` file, using the same `children` pattern as the published-data gate. The example's `LifecycleGate` is only a demonstration device; a real gate renders `children` as soon as its check passes.
 
 ```tsx
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createOnFrontendDataReadyProvider(({ children }) => {
   const frontendData = phx.frontend.useFrontendData()
 
@@ -335,7 +332,6 @@ export const webComponentProperties = {
 ```tsx
 import { useState } from 'react'
 
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 import { LifecycleLogPanel } from '../_shared/LifecycleLogPanel.js'
 import { resetLifecycleLog } from '../_shared/lifecycle-log.js'
@@ -358,7 +354,6 @@ export default phx.frontend.createOnApplicationStartProvider(({ children }) => {
 ### ./src/elements/OnBackendDataReady.tsx
 
 ```tsx
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 
 export default phx.frontend.createOnBackendDataReadyProvider(({ children }) => {
@@ -379,7 +374,6 @@ export default phx.frontend.createOnBackendDataReadyProvider(({ children }) => {
 ### ./src/elements/OnConfiguratorReady.tsx
 
 ```tsx
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 
 export default phx.frontend.createOnConfiguratorReadyProvider(({ children }) => {
@@ -400,7 +394,6 @@ export default phx.frontend.createOnConfiguratorReadyProvider(({ children }) =>
 ### ./src/elements/OnFrontendDataReady.tsx
 
 ```tsx
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 
 export default phx.frontend.createOnFrontendDataReadyProvider(({ children }) => {
@@ -423,7 +416,6 @@ export default phx.frontend.createOnFrontendDataReadyProvider(({ children }) =>
 ```tsx
 import { useWebComponentPropertyValue } from '@salsita-ai/sdk/react'
 
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 import { webComponentProperties } from '../_shared/web-component-options.js'
 
@@ -455,7 +447,6 @@ export default phx.frontend.createOnPublishedDataReadyProvider(({ children }) =>
 ```tsx
 import { useRoutingState } from '@salsita-ai/sdk/react'
 
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 
 export default phx.frontend.createOnRoutingReadyProvider(({ children }) => {
@@ -472,7 +463,6 @@ export default phx.frontend.createOnRoutingReadyProvider(({ children }) => {
 ### ./src/elements/OnSessionReady.tsx
 
 ```tsx
-import { phx } from '../../.phoenix/phx.js'
 import { LifecycleGate } from '../_shared/LifecycleGate.js'
 
 export default phx.frontend.createOnSessionReadyProvider(({ children }) => {
@@ -493,7 +483,6 @@ export default phx.frontend.createOnSessionReadyProvider(({ children }) => {
 ### ./src/handlers/collect-frontend-data.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
 import { appendLifecycleEntry } from '../_shared/lifecycle-log.js'
 
 export default phx.frontend.createCollectFrontendDataHandler(async () => {
@@ -506,7 +495,6 @@ export default phx.frontend.createCollectFrontendDataHandler(async () => {
 ### ./src/handlers/get-web-component-options.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
 import { webComponentProperties } from '../_shared/web-component-options.js'
 
 export default phx.frontend.createGetWebComponentOptionsHandler(() => ({

package/dist/docs/integrations/onloadprovider.mdx

@@ -65,7 +65,6 @@ import { customSummaryPageComponent, memoEval, propertyPageComponent } from '@sa
 
 import { MockSidebarOne } from '../../../../common/MockSidebar.js'
 import { MockSummary } from '../../../../common/MockSummary.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   phx.domain.attachComponent
@@ -103,8 +102,6 @@ import { useEffect, useState } from 'react'
 import { useRoutingState } from '@salsita-ai/sdk/react'
 import { Loader } from '@salsita-ai/sdk/ui'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createOnConfiguratorReadyProvider(({ children }) => {
   const [state, setState] = useState('loading')
 

package/dist/docs/integrations/webcomponent-api/basics.mdx

@@ -214,6 +214,8 @@ Properties use camelCase (`integrationMode`), while attributes use kebab-case (`
 
 Attributes are **write-only from the host's perspective**: setting an attribute (in HTML or via `setAttribute`) flows the value into the property, but the WC **never reflects property changes back to attributes**. To read the current value, always use the JavaScript property, not `getAttribute`.
 
+Boolean attributes (`readonly`, `expanded`, and a custom property whose `attributeParser` is `webComponentAttributeParsers.boolean`) follow the HTML convention: present without a value (`<salsita-configurator readonly>`, `setAttribute('readonly', '')`) or with their own name as the value (`readonly="readonly"`), they switch the property on. `"true"` and `"false"` work too; any other value is ignored with an error in the console. Removing the attribute resets the property to its default.
+
 Standard property to attribute mapping:
 
 | Property            | Attribute(s)                                               |
@@ -666,6 +668,8 @@ export const AddToCartButton = () => {
 }
 ```
 
+The example attaches this button as a legacy `finalizeButton` component; a new project declares `finalizeAction` components instead, see [Finalization](?path=/docs/phoenix-finalization--docs).
+
 ### Live preview
 
 ## Client-facing documentation
@@ -788,7 +792,6 @@ import {
 import { MockSidebarOne } from '../../../../common/MockSidebar.js'
 import { MockSummary } from '../../../../common/MockSummary.js'
 import { getMockChairComponents } from '../../../../common/mock-chair-model/mock-chair-model-components.js'
-import { phx } from '../../.phoenix/phx.js'
 import { webComponentEvents, webComponentProperties } from '../_shared/web-component-optionts.js'
 
 const pushToECommerce = (_accessToken: string, _cartId: string, _name: string, _price: number) =>
@@ -881,7 +884,6 @@ export default [
 ### ./src/handlers/get-webcomponent-options.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
 import { webComponentEvents, webComponentProperties } from '../_shared/web-component-optionts.js'
 
 export default phx.frontend.createGetWebComponentOptionsHandler(() => ({

package/dist/docs/integrations/webcomponent-api/preset-tags.mdx

@@ -139,7 +139,6 @@ presets:
 
 ```tsx
 import { getMockChairComponents } from '../../../../common/mock-chair-model/mock-chair-model-components.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getMockChairComponents('Scene', phx.domain.attachComponent)]
 ```