@adia-ai/web-components 0.0.4 → 0.0.5

package/components/pane/pane.a2ui.json

@@ -35,6 +35,16 @@
       "description": "Component property: resizable.",
       "type": "boolean",
       "default": false
+    },
+    "side": {
+      "description": "Opts a pane into horizontal-sibling chrome: suppresses the default\nfour-sided border and moves the resize grabber to the inner edge\n(right edge for `leading`, left edge for `trailing`). Also flips the\nresize-drag direction so `trailing` panes grow when dragged leftward.\nUnset keeps the pane-intrinsic chrome (full border, right-edge\ngrabber when resizable).\n",
+      "type": "string",
+      "enum": [
+        "",
+        "leading",
+        "trailing"
+      ],
+      "default": ""
     }
   },
   "required": [

package/components/pane/pane.css

@@ -54,6 +54,23 @@
     overflow: hidden;
   }
 
+  /* Side-aware border treatment.
+     `leading`  — pane sits at the leading edge of a horizontal row, so
+                  the only visual separator it needs is on its trailing
+                  edge (right in LTR).
+     `trailing` — mirror: only a leading-edge border (left in LTR).
+     Default (no side attr) keeps the full 4-sided border. */
+  :scope[side="leading"],
+  :scope[side="trailing"] {
+    border: none;
+  }
+  :scope[side="leading"] {
+    border-inline-end: 1px solid var(--pane-border);
+  }
+  :scope[side="trailing"] {
+    border-inline-start: 1px solid var(--pane-border);
+  }
+
   /* ── Pane header ── */
   > header {
     display: flex;
@@ -101,16 +118,23 @@
     display: none;
   }
 
-  /* Section header */
+  /* Section header — section's padding is the single source of horizontal inset;
+     content inside the section must not add its own padding. */
   > section > header {
     font-size: var(--pane-section-header-size);
     color: var(--pane-section-header-fg);
-    padding-bottom: var(--pane-gap-xs);
+    padding-bottom: var(--pane-col-gap);
     text-transform: uppercase;
     letter-spacing: 0.06em;
     font-weight: var(--pane-section-header-weight);
   }
 
+  /* Defensive: a data-col directly under a section inherits the section's inset;
+     adding its own padding would compound and misalign with the section header. */
+  > section > [data-col] {
+    padding: 0;
+  }
+
   /* Section divider between sections */
   > section + section {
     border-top: 1px solid var(--pane-border);
@@ -143,11 +167,16 @@
     border-bottom: none;
   }
 
-  /* ── Resize handle ── */
+  /* ── Resize handle ──
+     Default (no side) positions the grabber on the right edge. When
+     `side="trailing"` is set, flip the grabber to the left edge so it
+     sits on the pane's "inner" side (where it meets the sibling
+     content/pane in a horizontal row). `inset-inline-*` lets the rules
+     stay LTR/RTL-safe. */
   [slot="resize"] {
     position: absolute;
     top: 0;
-    right: 0;
+    inset-inline-end: 0;
     bottom: 0;
     width: var(--pane-resize-width);
     cursor: col-resize;
@@ -156,6 +185,11 @@
     z-index: 1;
   }
 
+  :scope[side="trailing"] > [slot="resize"] {
+    inset-inline-end: auto;
+    inset-inline-start: 0;
+  }
+
   [slot="resize"]:hover {
     background: var(--pane-resize-fg-hover);
   }

package/components/pane/pane.js

@@ -19,6 +19,12 @@
  *   resizable    — boolean, enables drag-to-resize (width)
  *   min-width    — minimum width when resizing (default: 200)
  *   max-width    — maximum width when resizing (default: 600)
+ *   side         — 'leading' | 'trailing' | '' (default). When set, the
+ *                  pane is treated as a horizontal sibling: the default
+ *                  four-sided border is suppressed, only the inner-edge
+ *                  border is drawn, the resize grabber moves to that
+ *                  inner edge, and the resize-drag direction flips so
+ *                  trailing panes grow when dragged leftward.
  *
  * JS API:
  *   pane.collapsed = true/false
@@ -33,6 +39,7 @@ class AdiaPane extends AdiaElement {
     resizable:  { type: Boolean, default: false, reflect: true },
     minWidth:   { type: Number,  default: 200, attribute: 'min-width', reflect: true },
     maxWidth:   { type: Number,  default: 9999, attribute: 'max-width', reflect: true },
+    side:       { type: String,  default: '', reflect: true },
   };
 
   static template = () => null;
@@ -116,7 +123,12 @@ class AdiaPane extends AdiaElement {
 
   #onResizeMove = (e) => {
     if (!this.#dragging) return;
-    const dx = e.clientX - this.#startX;
+    // For a trailing pane the grabber sits on the LEFT edge but the pane
+    // is anchored on the RIGHT side of its flex row — dragging leftward
+    // should GROW the pane (grabber moves further left = more width),
+    // not shrink it. Negate dx in that case.
+    const sign = this.side === 'trailing' ? -1 : 1;
+    const dx = (e.clientX - this.#startX) * sign;
     const w = Math.max(this.minWidth, Math.min(this.maxWidth, this.#startW + dx));
     this.style.width = `${w}px`;
   };

package/components/pane/pane.yaml

@@ -26,6 +26,18 @@ props:
     description: "Component property: resizable."
     type: boolean
     default: false
+  side:
+    description: |
+      Opts a pane into horizontal-sibling chrome: suppresses the default
+      four-sided border and moves the resize grabber to the inner edge
+      (right edge for `leading`, left edge for `trailing`). Also flips the
+      resize-drag direction so `trailing` panes grow when dragged leftward.
+      Unset keeps the pane-intrinsic chrome (full border, right-edge
+      grabber when resizable).
+    type: string
+    default: ""
+    enum: ["", leading, trailing]
+    reflect: true
 events: {}
 slots:
   header:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-components",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "AdiaUI web components — vanilla custom elements. A2UI runtime (renderer, registry, streams, wiring) lives in @adia-ai/a2ui-utils.",
   "type": "module",
   "exports": {

package/patterns/app-nav-group/app-nav-group.css

@@ -16,6 +16,9 @@
     --nav-group-bg-hover:      var(--a-bg-muted);
     --nav-group-icon-size:     calc(var(--nav-group-row-height) - var(--a-space-2));
     --nav-group-badge-size:    var(--a-ui-sm);
+
+    --nav-item-child-height:    var(--a-size-sm);
+    --nav-item-child-font:      var(--nav-group-font-size);
   }
 
   :scope {

package/patterns/app-shell/app-shell.a2ui.json

@@ -74,8 +74,20 @@
       "Command"
     ],
     "slots": {
+      "description": {
+        "description": "Secondary metadata inside any chrome bar. Muted + --a-ui-sm size."
+      },
       "default": {
         "description": "Author-supplied page DOM. Expected structure — aside[data-sidebar] for navigation, main for content, optional dialog[data-command] for Cmd+K."
+      },
+      "action": {
+        "description": "Trailing control cluster inside any chrome bar. The first [slot=\"action\"] child pushes itself (and siblings) to the end; subsequent siblings flow with gap. Coexists with legacy <span data-spacer> / <div data-actions> hooks for one release — new code should prefer slots."
+      },
+      "heading": {
+        "description": "Primary label inside any chrome bar. Medium-weight + strong fg."
+      },
+      "icon": {
+        "description": "Leading glyph inside any chrome bar — > main > header / footer and [data-sidebar] > header / footer. Muted color, flex-align."
       }
     },
     "states": [

package/patterns/app-shell/app-shell.yaml

@@ -39,6 +39,23 @@ slots:
     description: >-
       Author-supplied page DOM. Expected structure — aside[data-sidebar] for
       navigation, main for content, optional dialog[data-command] for Cmd+K.
+  icon:
+    description: >-
+      Leading glyph inside any chrome bar — > main > header / footer and
+      [data-sidebar] > header / footer. Muted color, flex-align.
+  heading:
+    description: >-
+      Primary label inside any chrome bar. Medium-weight + strong fg.
+  description:
+    description: >-
+      Secondary metadata inside any chrome bar. Muted + --a-ui-sm size.
+  action:
+    description: >-
+      Trailing control cluster inside any chrome bar. The first
+      [slot="action"] child pushes itself (and siblings) to the end;
+      subsequent siblings flow with gap. Coexists with legacy
+      <span data-spacer> / <div data-actions> hooks for one release —
+      new code should prefer slots.
 
 states:
   - name: idle

package/patterns/app-shell/css/app-shell.main.css

@@ -13,7 +13,19 @@ app-shell-ui > main {
 }
 
 /* ── Main > header (topbar) ──
-   Contains: sidebar toggle, breadcrumb, spacer, action buttons */
+   Contains: sidebar toggle, breadcrumb, spacer, action buttons.
+
+   Slot contract (shared with > main > footer and [data-sidebar] >
+   header/footer) — identical to card-ui / drawer-ui / adia-editor-ui:
+     [slot="icon"]        leading glyph
+     [slot="heading"]     primary label; strong weight + strong fg
+     [slot="description"] secondary metadata; muted fg + --a-ui-sm
+     [slot="action"]      trailing cluster; first pushes to end
+   The legacy data-sidebar-toggle / breadcrumb-ui / <span data-spacer>
+   / <div data-actions> hooks (see app-shell.helpers.css) remain
+   fully supported — slots are additive, not a replacement. Use slots
+   for simpler chrome surfaces; keep breadcrumb + data-actions for
+   docs-style shells where those conventions carry semantic weight. */
 app-shell-ui > main > header {
   display: flex;
   align-items: center;
@@ -25,6 +37,31 @@ app-shell-ui > main > header {
   flex-shrink: 0;
 }
 
+app-shell-ui > main > header > [slot="icon"] {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+  color: var(--page-header-fg-muted);
+}
+app-shell-ui > main > header > [slot="heading"] {
+  font-weight: var(--a-weight-medium);
+  color: var(--a-fg);
+}
+app-shell-ui > main > header > [slot="description"] {
+  color: var(--page-header-fg-muted);
+  font-size: var(--a-ui-sm);
+}
+app-shell-ui > main > header > [slot="action"] {
+  display: flex;
+  align-items: center;
+  gap: var(--page-actions-gap);
+  flex-shrink: 0;
+  margin-inline-start: auto;
+}
+app-shell-ui > main > header > [slot="action"] ~ [slot="action"] {
+  margin-inline-start: 0;
+}
+
 /* ── Main > section (scroll container) ──
    Wraps [data-content-root]. Scrolls vertically, hides scrollbar. */
 app-shell-ui > main > section {
@@ -39,7 +76,11 @@ app-shell-ui > main > section {
 app-shell-ui > main > section::-webkit-scrollbar { display: none; }
 
 /* ── Main > footer (status bar) ──
-   Last child auto-pushed to trailing edge via margin-inline-start: auto. */
+   Legacy pattern: last-child auto-pushed to trailing edge via
+   margin-inline-start: auto (works when authors use a simple
+   <span>…</span><span>version</span> shape).
+   Slot pattern: same icon / heading / description / action vocabulary
+   as > main > header (see comment block above). */
 app-shell-ui > main > footer {
   flex-shrink: 0;
   display: flex;
@@ -53,6 +94,34 @@ app-shell-ui > main > footer {
   color: var(--page-header-fg-muted);
 }
 
-app-shell-ui > main > footer > :last-child {
+/* Legacy: bare <span>…</span><span>version</span> shapes. Only kicks
+   in when NO slot="action" is present, so it doesn't fight the slot
+   rule below. */
+app-shell-ui > main > footer:not(:has(> [slot="action"])) > :last-child {
   margin-inline-start: auto;
 }
+
+app-shell-ui > main > footer > [slot="icon"] {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+  color: var(--page-header-fg-muted);
+}
+app-shell-ui > main > footer > [slot="heading"] {
+  font-weight: var(--a-weight-medium);
+  color: var(--a-fg);
+}
+app-shell-ui > main > footer > [slot="description"] {
+  color: var(--page-header-fg-muted);
+  font-size: var(--a-ui-sm);
+}
+app-shell-ui > main > footer > [slot="action"] {
+  display: flex;
+  align-items: center;
+  gap: var(--page-actions-gap);
+  flex-shrink: 0;
+  margin-inline-start: auto;
+}
+app-shell-ui > main > footer > [slot="action"] ~ [slot="action"] {
+  margin-inline-start: 0;
+}

package/patterns/app-shell/css/app-shell.sidebar.css

@@ -60,7 +60,13 @@
   width: var(--page-sidebar-width-trailing);
 }
 
-/* ── Sidebar header / footer ── */
+/* ── Sidebar header / footer ──
+   Share the same slot contract as > main > header/footer (see
+   app-shell.main.css top-of-file comment): icon / heading /
+   description / action. Sidebar chromes are typically single-child
+   (a workspace-select or user-select) so the slot rules rarely come
+   into play — but they stay consistent for authors that compose
+   richer sidebar chromes. */
 [data-sidebar] > header,
 [data-sidebar] > footer {
   display: flex;
@@ -83,6 +89,36 @@
   border-top: var(--page-border);
 }
 
+[data-sidebar] > header > [slot="icon"],
+[data-sidebar] > footer > [slot="icon"] {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+  color: var(--page-header-fg-muted);
+}
+[data-sidebar] > header > [slot="heading"],
+[data-sidebar] > footer > [slot="heading"] {
+  font-weight: var(--a-weight-medium);
+  color: var(--a-fg);
+}
+[data-sidebar] > header > [slot="description"],
+[data-sidebar] > footer > [slot="description"] {
+  color: var(--page-header-fg-muted);
+  font-size: var(--a-ui-sm);
+}
+[data-sidebar] > header > [slot="action"],
+[data-sidebar] > footer > [slot="action"] {
+  display: flex;
+  align-items: center;
+  gap: var(--page-actions-gap);
+  flex-shrink: 0;
+  margin-inline-start: auto;
+}
+[data-sidebar] > header > [slot="action"] ~ [slot="action"],
+[data-sidebar] > footer > [slot="action"] ~ [slot="action"] {
+  margin-inline-start: 0;
+}
+
 /* ── Sidebar section (scrollable body) ── */
 [data-sidebar] > section {
   flex: 1;

package/patterns/app-shell/css/app-shell.tokens.css

@@ -108,8 +108,6 @@
   --nav-item-trailing-border: var(--a-border-subtle);
   --nav-item-trailing-radius: var(--a-radius-sm);
   --nav-item-trailing-px:     var(--a-space-0-5);
-  --nav-item-child-height:    var(--a-size-sm);
-  --nav-item-child-font:      var(--a-ui-sm);
 
   /* Global icon size bump */
   --a-icon-size: 18px;