@estiva-app/ui 0.35.2 → 0.37.0

package/registry.json

@@ -4,9 +4,9 @@
     "kind": "package",
     "repo": "estiva-ui",
     "package": "@estiva-app/ui",
-    "packageVersion": "0.35.2",
-    "exports": 87,
-    "typeExports": 96,
+    "packageVersion": "0.37.0",
+    "exports": 88,
+    "typeExports": 97,
     "files": null
   },
   "storybook": {
@@ -218,7 +218,20 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "components-attachmentcard--docs",
@@ -728,6 +741,10 @@
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -902,6 +919,22 @@
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        },
         {
           "id": "walking",
           "behaviour": "Moves through its items with the arrow keys"
@@ -1100,10 +1133,22 @@
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
         {
           "id": "focus",
           "behaviour": "Holds focus inside while open, and gives it back"
         },
+        {
+          "id": "scroll-lock",
+          "behaviour": "Stops the page behind it scrolling"
+        },
         {
           "id": "walking",
           "behaviour": "Moves through its items with the arrow keys"
@@ -1316,7 +1361,20 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "walking",
+          "behaviour": "Moves through its items with the arrow keys"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-commandpalette--docs",
@@ -1415,6 +1473,22 @@
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
+        {
+          "id": "scroll-lock",
+          "behaviour": "Stops the page behind it scrolling"
+        },
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
@@ -1710,7 +1784,12 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "inputs-editabletext--docs",
@@ -2483,7 +2562,20 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "inputs-chipinput--docs",
@@ -2568,10 +2660,18 @@
       ],
       "variants": [],
       "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
         {
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
         {
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
@@ -2583,6 +2683,10 @@
         {
           "id": "scroll-lock",
           "behaviour": "Stops the page behind it scrolling"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
         }
       ],
       "status": "stable",
@@ -2820,6 +2924,10 @@
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
         },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -2926,7 +3034,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-menuitem--docs",
@@ -3024,7 +3141,16 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-menu--docs",
@@ -3093,7 +3219,16 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-menu--docs",
@@ -3168,6 +3303,80 @@
         "text-center font-mono text-caption tabular-nums text-text-muted"
       ]
     },
+    {
+      "name": "Panel",
+      "repo": "estiva-ui",
+      "kind": "component",
+      "importPath": "@estiva-app/ui",
+      "sourceFile": "src/Panel.tsx",
+      "purpose": "A panel of a page: its name in a header, a body that scrolls whenever it is taller than the room it has, and a row fixed at the bottom when there is one.",
+      "purposeFrom": "page",
+      "props": [
+        {
+          "name": "title",
+          "takes": "anything",
+          "required": true,
+          "note": "The panel's name, in its header. A node for a title that is more than words."
+        },
+        {
+          "name": "chevron",
+          "takes": "true/false",
+          "required": false,
+          "note": "A chevron after the title, as `ContainerHeader` draws it."
+        },
+        {
+          "name": "actions",
+          "takes": "anything",
+          "required": false,
+          "note": "The panel's own actions, at the header's right — a `Toolbar` of `ToolbarButton`s, or one `IconButton`."
+        },
+        {
+          "name": "children",
+          "takes": "anything",
+          "required": true,
+          "note": "The body. It scrolls when it is taller than the panel."
+        },
+        {
+          "name": "footer",
+          "takes": "anything",
+          "required": false,
+          "note": "A row fixed under the body that never scrolls — a reply box."
+        },
+        {
+          "name": "bodyClassName",
+          "takes": "text",
+          "required": false,
+          "note": "The body's own box: its padding, gap and layout — `px-4 pt-3 pb-4`, `flex flex-col gap-2`."
+        },
+        {
+          "name": "bodyRef",
+          "takes": "Ref<HTMLDivElement>",
+          "required": false,
+          "note": "The body's scrolling box, for a panel that reads or drives its scroll: a thread that opens at its newest reply."
+        },
+        {
+          "name": "onBodyScroll",
+          "takes": "UIEventHandler<HTMLDivElement>",
+          "required": false,
+          "note": "Fires as the body scrolls."
+        },
+        {
+          "name": "className",
+          "takes": "text",
+          "required": false,
+          "note": "Placement only: a cap such as `max-h-[60%]` when it shares a column."
+        }
+      ],
+      "variants": [],
+      "ownsBehaviours": [],
+      "status": "stable",
+      "migrationStage": null,
+      "docsId": "layout-panel--docs",
+      "storyId": "layout-panel--default",
+      "docPage": "src/Panel.mdx",
+      "app": null,
+      "looks": []
+    },
     {
       "name": "Person",
       "repo": "estiva-ui",
@@ -3265,7 +3474,20 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "components-persontrigger--docs",
@@ -3399,6 +3621,10 @@
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
         },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -3494,6 +3720,10 @@
           "id": "press-outside",
           "behaviour": "Closes on a press outside"
         },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -3757,6 +3987,10 @@
         {
           "id": "base-ui",
           "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -3814,7 +4048,12 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "components-reactionpicker--docs",
@@ -3890,6 +4129,10 @@
           "id": "base-ui",
           "behaviour": "Is built on Base UI"
         },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        },
         {
           "id": "scroll",
           "behaviour": "Scrolls with our scrollbar"
@@ -4201,6 +4444,10 @@
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
         },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -4437,6 +4684,10 @@
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -4459,7 +4710,12 @@
       "purposeFrom": "page",
       "props": [],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "inputs-textarea--docs",
@@ -4615,7 +4871,24 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "feedback-toast--docs",
@@ -4701,6 +4974,10 @@
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -4800,7 +5077,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -4834,7 +5120,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -4920,7 +5215,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -4946,7 +5250,16 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -5041,7 +5354,28 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-tooltip--docs",
@@ -5193,6 +5527,22 @@
           "id": "base-ui",
           "behaviour": "Is built on Base UI"
         },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        },
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"

package/skill/estiva-ui.md

@@ -32,7 +32,8 @@ and when not to. Most of what gets asked for already exists somewhere.
    refuses a raw element, a rebuilt behaviour or a restyled part, and its error
    names the part to use.
 5. **An exception** carries its reason on the line above it. For the gate:
-   `// @estiva-escape: <reason>`, never `eslint-disable`. For the token lint:
+   `// @estiva-escape(<rule>): <reason>`, naming the one rule it keeps off,
+   never `eslint-disable`. For the token lint:
    `// eslint-disable-next-line <rule> -- @estiva-escape: <reason>`.
 
 ## Gotchas

package/src/AppShell.mdx

@@ -32,7 +32,8 @@ Layout only: no data, no routes.
 ## When not
 
 - Panels *inside* the content — lists beside conversations, side rails —
-  are layout components, not the shell's business.
+  are layout components, not the shell's business. A list beside the
+  content is **ListColumn**.
 - Mixing the pairs (a rail in the solid frame, a sidebar in the floating
   one) is possible but is a new design, not a port — take it to the
   designer first.