@estiva-app/ui 0.12.3 → 0.12.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estiva-app/ui",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "description": "Estiva's design tokens (the contract) and a small set of primitives (a convenience) for every Estiva app.",
   "type": "module",
   "license": "MIT",

package/src/Button.stories.tsx

@@ -30,6 +30,35 @@ export const Disabled: Story = { args: { variant: 'primary', disabled: true } }
 export const WithAReason: Story = { args: { variant: 'primary', disabledReason: 'Sign in to add items' } }
 
 /** Every variant × size × icon × disabled combination on one canvas. */
+/* The box it is dropped into cannot change its height: a Button states `h-8`
+   (or `h-6` when small), and a stretching parent only stretches a child whose
+   height is `auto`. The row below says no `items-*` at all, which is the box
+   that drew an IconButton 228px tall — this stays 32. */
+export const InATallRow: Story = {
+  parameters: { controls: { disable: true } },
+  render: () => (
+    <div className="flex h-[260px] w-[240px] justify-center rounded-lg border border-border-subtle p-4">
+      <Button variant="outlined">Button</Button>
+    </div>
+  ),
+}
+
+/* And the caller says where it sits. This column asks for the left; a Button
+   carries no `align-self` of its own, so the left is what it gets. */
+export const InAColumnThatAsksForTheLeft: Story = {
+  parameters: { controls: { disable: true } },
+  render: () => (
+    <div className="flex w-[240px] flex-col items-start gap-2 rounded-lg border border-border-subtle p-4">
+      <Button variant="outlined" size="small">
+        Copy link
+      </Button>
+      <Button variant="outlined" size="small">
+        Pair with another Folder…
+      </Button>
+    </div>
+  ),
+}
+
 export const AllVariants: Story = {
   parameters: { controls: { disable: true } },
   render: () => (

package/src/Button.test.tsx

@@ -105,6 +105,24 @@ describe('Button', () => {
     expect(held).not.toHaveBeenCalled()
   })
 
+  /* jsdom computes no layout, so the class list is what a test can hold on to.
+     Both halves matter: the height is why a stretching parent cannot change
+     this button, and the absence of `align-self` is why its caller keeps the
+     say on where it sits. The pixels behind both were measured in Chrome on
+     2026-09-12 — 32px in a 260px row either way, and left in a column that
+     asks for the left. */
+  it('states its own height and no alignment of its own', () => {
+    const { rerender } = render(<Button>Default</Button>)
+    const defaultButton = screen.getByRole('button', { name: 'Default' })
+    expect(defaultButton.className).toContain('h-8')
+    expect(defaultButton.className).not.toContain('self-')
+
+    rerender(<Button size="small">Small</Button>)
+    const smallButton = screen.getByRole('button', { name: 'Small' })
+    expect(smallButton.className).toContain('h-6')
+    expect(smallButton.className).not.toContain('self-')
+  })
+
   it('passes native props through', () => {
     render(
       <Button form="f1" aria-pressed="true" data-x="y" className="mt-2">

package/src/Button.tsx

@@ -66,13 +66,18 @@ export function Button({
       focusableWhenDisabled={!!disabledReason}
       className={(state) =>
         cn(
-          // `self-center` for the same reason as IconButton's: a flex parent
-          // with no `items-*` stretches its children, and a button stretched to
-          // a column's height is not a button. `h-8` and `h-6` below set the
-          // height, and stretching overrode them. No caller in the suite wants
-          // a stretched one — checked across both apps and this package on
-          // 2026-09-11, and none passes `w-full` either.
-          'inline-flex items-center justify-center gap-1 rounded-md transition-colors font-sans font-medium self-center',
+          // No `self-center` here, deliberately — `IconButton` needs it and this
+          // does not, and the difference is the `h-8` / `h-6` on the next two
+          // lines. `align-items: stretch` only stretches a child whose cross
+          // size is `auto`; a Button always states its height, so a stretching
+          // parent cannot change it. Measured in Chrome on 2026-09-12, in the
+          // 260px row of Finding 49: 32px with `self-center` and 32px without.
+          // What the class DID do was override the caller on the other axis —
+          // in a column it beats the parent's `items-start`, which centred the
+          // four actions in Ship's `ProjectRail` and the trigger in five of
+          // this package's own story frames, each of which asks for the top.
+          // A control does not get to decide where its caller puts it.
+          'inline-flex items-center justify-center gap-1 rounded-md transition-colors font-sans font-medium',
           size === 'default' && 'h-8 text-btn-default',
           size === 'small' && 'h-6 text-btn-small',
           // Extra right padding beside a leading icon, for optical balance.

package/src/IconButton.tsx

@@ -54,6 +54,12 @@ export function IconButton({
           // happened here: a row with no `items-*` drew this 24 wide and 228
           // tall in Peek's TopicMoreMenu story (Katerina, 2026-09-11). A button
           // is the size of its icon and its padding, whatever box it lands in.
+          //
+          // This is the one of the two that needs it: an IconButton states no
+          // height, so its cross size is `auto` and a stretching parent takes
+          // it. Measured in the same 260px row on 2026-09-12: 24px with this
+          // class, 226px without. `Button` states `h-8`/`h-6`, so it cannot be
+          // stretched and carries no `self-center` — see the note there.
           'flex items-center justify-center p-1 rounded-lg transition-colors shrink-0 self-center cursor-pointer',
           !state.disabled && variant === 'primary' && 'bg-accent-primary hover:bg-accent-hover text-text-inverse',
           !state.disabled && variant === 'muted' && 'text-text-secondary hover:bg-bg-hover hover:text-text-primary',