@kerfjs/ui 5.0.0-beta.62 → 5.0.0-beta.64

package/README.md

@@ -342,6 +342,10 @@ guidance, public hooks, and explicit geometry ownership; then concatenate its
 identity alongside each input when ids could collide. This makes a combined
 tool reason about both sides of a composition using one vocabulary without
 pretending app-local components are `@kerfjs/ui` exports.
+For a consumer UX demo, `@kerfjs/ui/catalog-projection` derives rows and
+relationships from that extension; `kerf-catalog-demo --write` emits a typed
+module and `--check` catches drift. See the [catalog guide](./docs/catalog.md)
+for repository base and source path configuration.
 
 Composition-aware consumers use
 [`component-composition-extension.schema.json`](./ai/component-composition-extension.schema.json),

package/ai/component-catalog-extension.schema.json

@@ -52,6 +52,14 @@
           "items": { "type": "string" },
           "uniqueItems": true
         },
+        "uses": {
+          "description": "Directly composed Kerf or consumer catalog entry ids.",
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "source": { "$ref": "#/$defs/repositoryPath" },
+        "demoSource": { "$ref": "#/$defs/repositoryPath" },
         "geometry": { "$ref": "#/$defs/geometry" },
         "documentation": { "type": "string", "minLength": 1 }
       },
@@ -74,6 +82,11 @@
     },
     "geometryOwner": {
       "enum": ["self", "parent", "child", "none", "conditional"]
+    },
+    "repositoryPath": {
+      "description": "A repository-relative POSIX path without traversal or empty segments.",
+      "type": "string",
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$"
     }
   }
 }

package/ai/component-catalog.json

@@ -1165,6 +1165,16 @@
           "import": "@kerfjs/ui/wire-workbench",
           "required": false,
           "stateAttributes": [
+            {
+              "name": "data-responsive-overlay-active",
+              "on": "kui-workbench__rail and kui-workbench__drawer",
+              "meaning": "Present while a panel's numeric responsiveOverlayAt threshold applies to the Workbench width; the same measurement drives overlay layout and collapsed-state transitions."
+            },
+            {
+              "name": "data-numeric-overlays",
+              "on": "kui-workbench",
+              "meaning": "Space-separated left, right, drawer, rail-open, and open tokens mirror numeric overlay state for local CSS invalidation. Absent when no numeric overlay is active."
+            },
             {
               "name": "data-handle-inset",
               "on": "kui-workbench__rail",
@@ -1206,7 +1216,8 @@
         "kui-workbench__panel-content",
         "kui-workbench__handle",
         "kui-workbench__handle-icon",
-        "kui-workbench__restore"
+        "kui-workbench__restore",
+        "kui-workbench__backdrop"
       ],
       "publicTokens": [
         "--kui-workbench-rail-width",
@@ -3102,7 +3113,7 @@
         "border": "self",
         "padding": "self",
         "notes": [
-          "Public resting background and border, hover border, and selected border tokens can be scoped to a row or its containing list without changing the default tones."
+          "Public resting, hover, and selected text, fill, and border tokens can be scoped to a row or its containing list without changing the default tones."
         ]
       },
       "delivery": {

package/ai/component-composition.json

@@ -1091,6 +1091,18 @@
         "helpers": ["wireWorkbench", "wireScrollDividers"],
         "obligations": [],
         "stateAttributes": [
+          {
+            "name": "data-responsive-overlay-active",
+            "on": "kui-workbench__rail and kui-workbench__drawer",
+            "helper": "wireWorkbench",
+            "meaning": "Present while a panel's numeric responsiveOverlayAt threshold applies to the Workbench width; the same measurement drives overlay layout and collapsed-state transitions."
+          },
+          {
+            "name": "data-numeric-overlays",
+            "on": "kui-workbench",
+            "helper": "wireWorkbench",
+            "meaning": "Space-separated left, right, drawer, rail-open, and open tokens mirror numeric overlay state for local CSS invalidation. Absent when no numeric overlay is active."
+          },
           {
             "name": "data-handle-inset",
             "on": "kui-workbench__rail",
@@ -1152,7 +1164,8 @@
           "kui-workbench__panel-content",
           "kui-workbench__handle",
           "kui-workbench__handle-icon",
-          "kui-workbench__restore"
+          "kui-workbench__restore",
+          "kui-workbench__backdrop"
         ],
         "publicTokens": [
           "--kui-workbench-rail-width",
@@ -2538,7 +2551,7 @@
           "border": "self",
           "padding": "self",
           "notes": [
-            "Public resting background and border, hover border, and selected border tokens can be scoped to a row or its containing list without changing the default tones."
+            "Public resting, hover, and selected text, fill, and border tokens can be scoped to a row or its containing list without changing the default tones."
           ]
         }
       },

package/ai/components/list-item.md

@@ -69,7 +69,7 @@ No wiring helper.
 
 Margin: self · border: self · padding: self (layout role: navigation). `self` means the component already owns it — do not add wrapper padding, margin, or borders around it.
 
-- Public resting background and border, hover border, and selected border tokens can be scoped to a row or its containing list without changing the default tones.
+- Public resting, hover, and selected text, fill, and border tokens can be scoped to a row or its containing list without changing the default tones.
 
 ## Accessibility
 

package/ai/components/workbench.md

@@ -76,6 +76,8 @@ Zones (a zone is bound to JSX only through its listed prop; never assume the zon
 
 **Wiring-owned state attributes** — never render, remove, or branch on these as app state:
 
+- `data-responsive-overlay-active` on `kui-workbench__rail and kui-workbench__drawer` (`wireWorkbench`): Present while a panel's numeric responsiveOverlayAt threshold applies to the Workbench width; the same measurement drives overlay layout and collapsed-state transitions.
+- `data-numeric-overlays` on `kui-workbench` (`wireWorkbench`): Space-separated left, right, drawer, rail-open, and open tokens mirror numeric overlay state for local CSS invalidation. Absent when no numeric overlay is active.
 - `data-handle-inset` on `kui-workbench__rail` (`wireWorkbench`): Written by the shared resize wiring when the work-area minimum or a parent clamp holds a rail's maximum near its size. It carries no Workbench styling; the Workbench handle stays at the rail's inner edge.
 - `data-resizing` on `kui-workbench__rail` (`wireWorkbench`): Present on a resizable rail or the drawer while a pointer drag resizes it.
 - `data-scroll-overflow` on `kui-pane__content of each panel and work-area Pane` (`wireScrollDividers`): The physical edges, in canonical t/r/b/l order, beyond which content is scrolled out of view; absent when nothing is hidden (content that fits never reports its far edges). Re-applied if a re-render drops it.
@@ -99,9 +101,9 @@ Margin: none · border: self · padding: child (layout role: structure). `self`
 
 The component owns its own styles. Configure it through its props and variants; do not override its internals.
 
-Public class hooks (select for layout placement only, never to change the component's look): `kui-workbench`, `kui-workbench__rail`, `kui-workbench__rail--left`, `kui-workbench__rail--right`, `kui-workbench__drawer`, `kui-workbench__center`, `kui-workbench__main`, `kui-workbench__panel-content`, `kui-workbench__handle`, `kui-workbench__handle-icon`, `kui-workbench__restore`.
+Public class hooks (select for layout placement only, never to change the component's look): `kui-workbench`, `kui-workbench__rail`, `kui-workbench__rail--left`, `kui-workbench__rail--right`, `kui-workbench__drawer`, `kui-workbench__center`, `kui-workbench__main`, `kui-workbench__panel-content`, `kui-workbench__handle`, `kui-workbench__handle-icon`, `kui-workbench__restore`, `kui-workbench__backdrop`.
 
-Never put `kui-workbench`, `kui-workbench__rail`, `kui-workbench__rail--left`, `kui-workbench__rail--right`, `kui-workbench__drawer`, `kui-workbench__center`, `kui-workbench__main`, `kui-workbench__panel-content`, `kui-workbench__handle`, `kui-workbench__handle-icon`, `kui-workbench__restore` on an element you write; render `Workbench` instead (`KUI-L103`).
+Never put `kui-workbench`, `kui-workbench__rail`, `kui-workbench__rail--left`, `kui-workbench__rail--right`, `kui-workbench__drawer`, `kui-workbench__center`, `kui-workbench__main`, `kui-workbench__panel-content`, `kui-workbench__handle`, `kui-workbench__handle-icon`, `kui-workbench__restore`, `kui-workbench__backdrop` on an element you write; render `Workbench` instead (`KUI-L103`).
 
 Public tokens it reads: `--kui-workbench-rail-width`, `--kui-workbench-drawer-height`, `--kui-workbench-popup-z`, `--kui-workbench-overlay-z`, `--kui-workbench-overlay-max-width`, `--kui-workbench-overlay-max-height`, `--kui-workbench-restore-inset`, `--kui-workbench-restore-z`, `--kui-workbench-overlay-dismiss-margin`. Set a token only where its public contract allows; prefer a prop.