@salsita-ai/sdk 0.50.0-develop.a49722158a → 0.50.0-develop.a8cf9ffd01

package/dist/docs/dimensions/selection-controls/list-selector.mdx

@@ -229,19 +229,7 @@ components:
         layout: 'universal'
         miniSidebar: true
         availableLocales:
-          - cs
-          - da
-          - de
-          - en-AU
-          - en-GB
           - en
-          - es
-          - fr
-          - it
-          - nl
-          - pt
-          - ro
-          - tr
     propertyPage:
       default:
         children:
@@ -365,8 +353,6 @@ components:
 ### ./src/invariants/scene.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Scene: {
     widthTooLarge: s => {

package/dist/docs/dimensions/selection-controls/toggle-selector.mdx

@@ -226,19 +226,7 @@ components:
         layout: 'universal'
         miniSidebar: true
         availableLocales:
-          - cs
-          - da
-          - de
-          - en-AU
-          - en-GB
           - en
-          - es
-          - fr
-          - it
-          - nl
-          - pt
-          - ro
-          - tr
     propertyPage:
       default:
         children:
@@ -359,8 +347,6 @@ components:
 ### ./src/invariants/scene.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Scene: {
     widthTooLarge: s => {

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

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

package/dist/docs/drag-and-drop/hotspot-handle.mdx

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

package/dist/docs/drag-and-drop/no-selection.mdx

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

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

@@ -384,7 +384,6 @@ components:
 
 ```ts
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```
@@ -397,8 +396,6 @@ import { useEffect } from 'react'
 import { getDraggableSurfaceKey } from '@salsita-ai/sdk/configurator'
 import { dragHandleComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createOnConfiguratorReadyProvider(({ children }: { children?: React.ReactNode }) => {
   const ctx = phx.frontend.useDomain()
 

package/dist/docs/drag-and-drop/room-planner.mdx

@@ -777,7 +777,7 @@ components:
         autoRotate: true
       # Back-to-back snap: the dragged cabinet's back snaps onto another
       # cabinet's back face (the snapPlane below). autoRotate orients it
-      # 180° so the two cabinets face away from each other. Same Moduline
+      # 180° so the two cabinets face away from each other. This is the
       # shape that drives the within-MTV bug when the target is flush
       # against a wall — AutoSnap puts the dragged cabinet behind the
       # wall, Pass 1 within clamps it back into the room, and Pass 2
@@ -969,8 +969,6 @@ import { BoxGeometry, Mesh, MeshStandardMaterial } from 'three'
 
 import { memoEval, sceneEntityObjectComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const CubeSize = 1000
 
 const ApplianceWidth = 600
@@ -1026,8 +1024,6 @@ export default [
 ### ./src/expressions/cabinet.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   LowerCabinet: {
     $sceneId: cabinet => cabinet.$scene.id,
@@ -1046,8 +1042,6 @@ export default phx.domain.implementCustomExpressions({
 ```ts
 import { dragHandleComponent } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 const MIN_UPPER_Y = 1000
 
 export default phx.frontend.transformerBuilder.when

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

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

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

@@ -604,8 +604,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

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,10 +49,9 @@ 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. Both also take 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 both controls modify state of the configuration, they allow 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
 
@@ -62,11 +59,11 @@ Lastly as both `sceneEntityDeleteFab` and `sceneEntityAddFab` are controls that
 
 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:
 
-- `min`, `max` - the range of the angle or distance where the control is visible
-- `minOpacity` - the opacity of the control when the camera is out of the range (default is `0.15`)
+- `min`, `max` (both required) - the range of the angle or distance where the control is visible
+- `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 +78,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
 
@@ -131,6 +128,10 @@ components:
           - non-existent
 ```
 
+### Your own FABs
+
+The FABs are the entity elements `DeleteEntityFab` and `AddEntityFab`. A project replaces their look by registering its own with `phx.frontend.createDeleteEntityFab` or `phx.frontend.createAddEntityFab`; the spec's settings and positions above still apply. The delete FAB's replacement gets `onDelete`, `disabled` and `disabledHint`; the add FAB's reads its recipes with `phx.frontend.useGroupedRecipeOptions`. See [Configurator Interface → In-Scene Controls](?path=/docs/phoenix-configurator-interface--docs#in-scene-controls).
+
 ## Example
 
 Here you can see the live example!
@@ -147,7 +148,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
@@ -389,7 +390,6 @@ invariants:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -454,8 +454,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-14T18:30:44.640Z",
+  "generatedAt": "2026-10-24T05:47:45.258Z",
   "categories": [
     {
       "name": "Phoenix",
@@ -236,7 +236,7 @@
         },
         {
           "title": "SDK Builder Workflow",
-          "description": "An SDK-builder workspace lets you build one configurator from the application spec and develop and deploy it from your terminal. You don't need a repository, a CI pipeline, project keys or a...",
+          "description": "An SDK-builder workspace lets you build configurators from application specs and develop and deploy them from your terminal. You don't need a repository, a CI pipeline, project keys or a development...",
           "path": "docs/phoenix/sdk-builder-workflow.mdx",
           "category": [
             "Phoenix",
@@ -296,7 +296,7 @@
         },
         {
           "title": "Webhooks",
-          "description": "To support project specific finalization workflows, authentication and custom integrations, platform provides a way to define webhooks. These webhooks are deployed on aws lambda and can be triggered...",
+          "description": "To support project specific finalization workflows, authentication and custom integrations, the platform runs a project webhook: one bundle, deployed as a cloud function (AWS Lambda), that the...",
           "path": "docs/phoenix/webhooks.mdx",
           "category": [
             "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",