@stacksjs/components 0.2.63 → 0.2.67

package/dist/Accordion-pt8j917s.stx

@@ -0,0 +1,146 @@
+<script server>
+// Two modes (see stacksjs/stx#1703):
+//   1. Legacy prop API — pass `items={[{title, content}, …]}` for simple
+//      string-content accordions (kept for backward compatibility with
+//      existing visual snapshots and consumers).
+//   2. Slot API — drop `<AccordionItem title="…">` children for arbitrary
+//      content. Each AccordionItem renders its own header + content panel;
+//      this parent attaches click handlers and toggles content visibility.
+export const items = $props.items || []
+export const allowMultiple = $props.allowMultiple || false
+export const defaultOpen = $props.defaultOpen || []
+export const className = $props.className || ''
+
+export const accordionClasses = `divide-y divide-gray-200 dark:divide-gray-700 border border-gray-200 dark:border-gray-700 rounded-lg ${className}`.trim()
+export const headerClasses = `w-full flex items-center justify-between px-4 py-3 text-left font-medium text-gray-900 dark:text-gray-100 hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors duration-150 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 dark:focus:ring-offset-gray-900`.trim()
+export const iconClasses = `w-5 h-5 text-gray-500 dark:text-gray-400 transition-transform duration-200`.trim()
+export const contentClasses = `px-4 py-3 text-gray-700 dark:text-gray-300`.trim()
+export const hasPropItems = Array.isArray(items) && items.length > 0
+</script>
+
+<script client>
+const emit = defineEmits()
+const allowMultiple = {{ allowMultiple }}
+const hasPropItems = {{ hasPropItems }}
+const containerRef = useRef()
+const openItems = state({{ defaultOpen }})
+
+function findOwnItems() {
+  const root = containerRef.value
+  if (!root) return []
+  return Array.from(root.querySelectorAll('[data-stx-accordion-item]'))
+    .filter(item => item.closest('[data-stx-accordion]') === root)
+}
+
+onMount(() => {
+  if (hasPropItems) return  // legacy mode: server-rendered, no wiring needed
+  const items = findOwnItems()
+  items.forEach((item, idx) => {
+    const header = item.querySelector(':scope > [data-stx-accordion-header]')
+    if (header && !header.__stx_wired) {
+      header.__stx_wired = true
+      header.addEventListener('click', () => toggleItem(idx))
+      header.addEventListener('keydown', (e) => onHeaderKey(e, idx))
+    }
+  })
+})
+
+// Sync the open state into the DOM: show/hide content panels, update
+// aria-expanded on headers, rotate chevrons.
+effect(() => {
+  if (hasPropItems) return
+  const items = findOwnItems()
+  const open = openItems()
+  items.forEach((item, idx) => {
+    const isOpenItem = open.includes(idx)
+    const header = item.querySelector(':scope > [data-stx-accordion-header]')
+    const content = item.querySelector(':scope > [data-stx-accordion-content]')
+    const chevron = item.querySelector(':scope > [data-stx-accordion-header] [data-stx-accordion-chevron]')
+    if (header) header.setAttribute('aria-expanded', isOpenItem ? 'true' : 'false')
+    if (content) {
+      if (isOpenItem) content.removeAttribute('hidden')
+      else content.setAttribute('hidden', '')
+    }
+    if (chevron) chevron.style.transform = `rotate(${isOpenItem ? 180 : 0}deg)`
+  })
+})
+
+function toggleItem(index) {
+  const cur = openItems()
+  if (allowMultiple) {
+    openItems.set(cur.includes(index) ? cur.filter(i => i !== index) : [...cur, index])
+  }
+  else {
+    openItems.set(cur.includes(index) ? [] : [index])
+  }
+  emit('change', openItems())
+}
+
+function isOpen(index) {
+  return openItems().includes(index)
+}
+
+function onHeaderKey(event, index) {
+  const root = containerRef.value
+  if (!root) return
+  const buttons = root.querySelectorAll('button[data-stx-accordion-header], button[data-accordion-header]')
+  if (event.key === 'ArrowDown') {
+    event.preventDefault()
+    buttons[index + 1]?.focus()
+  }
+  else if (event.key === 'ArrowUp') {
+    event.preventDefault()
+    buttons[index - 1]?.focus()
+  }
+  else if (event.key === 'Home') {
+    event.preventDefault()
+    buttons[0]?.focus()
+  }
+  else if (event.key === 'End') {
+    event.preventDefault()
+    buttons[buttons.length - 1]?.focus()
+  }
+}
+
+defineExpose({ openItems, toggleItem })
+</script>
+
+<div x-ref="containerRef" data-stx-accordion class="{{ accordionClasses }}" role="region">
+  @if(hasPropItems)
+    @foreach(item in items)
+      <div>
+        <button
+          type="button"
+          data-accordion-header
+          class="{{ headerClasses }}"
+          @click="toggleItem({{ $loop.index }})"
+          @keydown="onHeaderKey($event, {{ $loop.index }})"
+          :aria-expanded="isOpen({{ $loop.index }}) ? 'true' : 'false'"
+          aria-controls="accordion-content-{{ $loop.index }}"
+        >
+          <span>{{ item.title }}</span>
+          <svg
+            class="{{ iconClasses }}"
+            :style="`transform: rotate(${isOpen({{ $loop.index }}) ? 180 : 0}deg)`"
+            fill="none"
+            viewBox="0 0 24 24"
+            stroke="currentColor"
+          >
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7" />
+          </svg>
+        </button>
+
+        <div
+          :show="isOpen({{ $loop.index }})"
+          id="accordion-content-{{ $loop.index }}"
+          class="{{ contentClasses }}"
+          role="region"
+        >
+          {!! item.content !!}
+        </div>
+      </div>
+    @endforeach
+  @else
+    <slot />
+  @endif
+</div>

package/dist/AccordionItem-hbhzx63p.stx

@@ -0,0 +1,37 @@
+<script server>
+// Slot wrapper that the parent <Accordion> discovers and wires up on mount.
+// Renders its own header button + content panel; the parent attaches click
+// handlers and toggles the content panel's `hidden` attribute as openItems
+// changes. Hard-coded styling here matches the legacy prop-mode markup so
+// snapshots compare cleanly in both modes. See stacksjs/stx#1703.
+export const title = $props.title || ''
+export const className = $props.className || ''
+
+const headerClasses = 'w-full flex items-center justify-between px-4 py-3 text-left font-medium text-gray-900 dark:text-gray-100 hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors duration-150 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 dark:focus:ring-offset-gray-900'
+const iconClasses = 'w-5 h-5 text-gray-500 dark:text-gray-400 transition-transform duration-200'
+const contentClasses = 'px-4 py-3 text-gray-700 dark:text-gray-300'
+</script>
+
+<div data-stx-accordion-item data-title="{{ title }}" class="{{ className }}">
+  <button
+    type="button"
+    data-stx-accordion-header
+    data-accordion-header
+    class="{{ headerClasses }}"
+    aria-expanded="false"
+  >
+    <span>{{ title }}</span>
+    <svg
+      data-stx-accordion-chevron
+      class="{{ iconClasses }}"
+      fill="none"
+      viewBox="0 0 24 24"
+      stroke="currentColor"
+    >
+      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7" />
+    </svg>
+  </button>
+  <div data-stx-accordion-content class="{{ contentClasses }}" role="region" hidden>
+    <slot />
+  </div>
+</div>

package/dist/{Checkbox-zgdmy3p5.stx → Checkbox-aqmq4cqv.stx}

@@ -26,7 +26,9 @@ export const inputId = `checkbox-${value || label}`
 const emit = defineEmits()
 const isDisabled = {{ disabled }}
 const isIndeterminate = {{ indeterminate }}
-const isChecked = state({{ checked }})
+// Reactive prop binding so the parent can drive `checked` via signals.
+// See stacksjs/stx#1704.
+const isChecked = useReactiveProp('checked', {{ checked }})
 
 function onInputChange(event) {
   if (isDisabled) {

package/dist/{Dialog-hczpexs4.stx → Dialog-y5rz2vrq.stx}

@@ -8,7 +8,11 @@ export const dialogClasses = `${baseClasses} ${className}`.trim()
 
 <script client>
 const emit = defineEmits()
-const isOpen = state({{ open }})
+// useReactiveProp wires `:open="parentSignal()"` from the parent into our
+// local `isOpen` signal — when the parent's signal changes, bindAttr
+// updates the root's `open` attribute, our MutationObserver picks it up,
+// and isOpen flips. See stacksjs/stx#1704.
+const isOpen = useReactiveProp('open', {{ open }})
 
 function close() {
   isOpen.set(false)

package/dist/{Drawer-xhevp5cw.stx → Drawer-hrz7qcyp.stx}

@@ -32,7 +32,10 @@ export const closeButtonClasses = `absolute top-0 ${closeButtonPosition[position
 
 <script client>
 const emit = defineEmits()
-const isOpen = state({{ open }})
+// useReactiveProp lets the parent drive `open` via signals
+// (`:open="drawerOpen()"`) instead of the prop being captured once.
+// See stacksjs/stx#1704.
+const isOpen = useReactiveProp('open', {{ open }})
 
 function close() {
   isOpen.set(false)

package/dist/Notification-03vfh3k6.stx

@@ -0,0 +1,117 @@
+<script server>
+// Initial defaults captured at render time. The client script wraps these
+// in signals so consumers can mutate them after mount (fetch-then-toast,
+// auto-dismiss, etc.). See stacksjs/stx#1692.
+export const initialShow = $props.show !== false
+export const initialTitle = $props.title || ''
+export const initialMessage = $props.message || ''
+export const initialType = $props.type || 'info'
+export const initialPosition = $props.position || 'top-right'
+export const initialDuration = Number($props.duration ?? 5000)
+export const className = $props.className || ''
+</script>
+
+<script client>
+const emit = defineEmits()
+
+const isVisible = state({{ initialShow }})
+const title = state({{ initialTitle }})
+const message = state({{ initialMessage }})
+const type = state({{ initialType }})
+const position = state({{ initialPosition }})
+const duration = state({{ initialDuration }})
+
+const typeColors = {
+  info: 'bg-blue-50 text-blue-900 dark:bg-blue-900 dark:text-blue-100',
+  success: 'bg-green-50 text-green-900 dark:bg-green-900 dark:text-green-100',
+  warning: 'bg-yellow-50 text-yellow-900 dark:bg-yellow-900 dark:text-yellow-100',
+  error: 'bg-red-50 text-red-900 dark:bg-red-900 dark:text-red-100',
+}
+
+const positions = {
+  'top-left': 'top-0 left-0',
+  'top-right': 'top-0 right-0',
+  'top-center': 'top-0 left-1/2 -translate-x-1/2',
+  'bottom-left': 'bottom-0 left-0',
+  'bottom-right': 'bottom-0 right-0',
+  'bottom-center': 'bottom-0 left-1/2 -translate-x-1/2',
+}
+
+const baseClasses = 'fixed z-50 m-4 max-w-md w-full pointer-events-auto rounded-lg p-4 shadow-lg ring-1 ring-black ring-opacity-5 transition-all'
+const extraClassName = {{ JSON.stringify(className) }}
+
+const notificationClasses = derived(() => {
+  const color = typeColors[type()] || typeColors.info
+  const pos = positions[position()] || positions['top-right']
+  return `${baseClasses} ${color} ${pos} ${extraClassName}`.trim()
+})
+
+let autoHideTimer = null
+function clearAutoHide() {
+  if (autoHideTimer) {
+    clearTimeout(autoHideTimer)
+    autoHideTimer = null
+  }
+}
+function scheduleAutoHide() {
+  clearAutoHide()
+  const d = duration()
+  if (d > 0 && isVisible()) {
+    autoHideTimer = setTimeout(() => close(), d)
+  }
+}
+
+function close() {
+  isVisible.set(false)
+  clearAutoHide()
+  emit('close')
+}
+
+function open(opts) {
+  if (opts && typeof opts === 'object') {
+    if (opts.title !== undefined) title.set(opts.title)
+    if (opts.message !== undefined) message.set(opts.message)
+    if (opts.type !== undefined) type.set(opts.type)
+    if (opts.position !== undefined) position.set(opts.position)
+    if (opts.duration !== undefined) duration.set(Number(opts.duration))
+  }
+  isVisible.set(true)
+  scheduleAutoHide()
+}
+
+onMount(() => {
+  if (isVisible()) scheduleAutoHide()
+})
+
+defineExpose({
+  open,
+  close,
+  isVisible,
+  title,
+  message,
+  type,
+  position,
+  duration,
+})
+</script>
+
+<div :if="isVisible()" :class="notificationClasses()" role="alert">
+  <div class="flex items-start">
+    <div class="flex-1">
+      <p :if="title()" class="text-sm font-medium" :text="title()"></p>
+      <p :if="message()" class="mt-1 text-sm" :class="title() ? 'opacity-90' : ''" :text="message()"></p>
+      <slot :if="!title() && !message()" />
+    </div>
+
+    <button
+      type="button"
+      @click="close()"
+      class="ml-4 inline-flex rounded-md focus:outline-none focus:ring-2 focus:ring-offset-2"
+    >
+      <span class="sr-only">Close</span>
+      <svg class="h-5 w-5" viewBox="0 0 20 20" fill="currentColor">
+        <path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd" />
+      </svg>
+    </button>
+  </div>
+</div>

package/dist/{NumberInput-drnvtqej.stx → NumberInput-g41gmd2c.stx}

@@ -37,7 +37,8 @@ const emit = defineEmits()
 const stepSize = {{ step }}
 const minVal = {{ min === undefined ? 'undefined' : min }}
 const maxVal = {{ max === undefined ? 'undefined' : max }}
-const inputValue = state({{ value }})
+// Reactive prop binding — parent can drive value via signals. See #1704.
+const inputValue = useReactiveProp('value', {{ value }}, { parse: (v) => v == null || v === '' ? '' : String(v) })
 
 function onInput(event) {
   inputValue.set(event.target.value)

package/dist/{Pagination-n3d31cns.stx → Pagination-wtgxmzey.stx}

@@ -17,7 +17,9 @@ export const iconClasses = `w-5 h-5`.trim()
 const emit = defineEmits()
 const totalPages = {{ totalPages }}
 const siblingCount = {{ siblingCount }}
-const page = state({{ currentPage }})
+// Reactive prop binding — parent can drive `current-page` via signals
+// (useful for URL-driven pagination via useSearchParams). See #1704.
+const page = useReactiveProp('current-page', {{ currentPage }})
 
 function goToPage(target) {
   if (target >= 1 && target <= totalPages && target !== page()) {

package/dist/{PasswordInput-n02x6053.stx → PasswordInput-4rsq1gwb.stx}

@@ -34,7 +34,8 @@ export const iconClasses = iconSizeClasses[size]
 <script client>
 const emit = defineEmits()
 const showPassword = state(false)
-const inputValue = state({{ value }})
+// Reactive prop binding — parent can drive value via signals. See #1704.
+const inputValue = useReactiveProp('value', {{ value }}, { parse: (v) => v == null ? '' : String(v) })
 
 function onInput(event) {
   inputValue.set(event.target.value)

package/dist/{Progress-yxcntr4x.stx → Progress-9dhakbh4.stx}

@@ -45,7 +45,8 @@ export const circularBarColor = color === 'primary' ? 'stroke-blue-600 dark:stro
 const max = {{ max }}
 const indeterminate = {{ indeterminate }}
 const circumference = {{ circumference }}
-const value = state({{ value }})
+// Reactive prop binding — parent can drive `value` via signals. See #1704.
+const value = useReactiveProp('value', {{ value }})
 
 const percentage = derived(() => Math.min(Math.max((value() / max) * 100, 0), 100))
 const percentLabel = derived(() => `${Math.round(percentage())}%`)

package/dist/{Radio-cgjv2hb2.stx → Radio-djtb5dpc.stx}

@@ -25,7 +25,8 @@ export const inputId = `radio-${value || label}`
 const emit = defineEmits()
 const isDisabled = {{ disabled }}
 const radioValue = {{ value }}
-const isChecked = state({{ checked }})
+// Reactive prop binding — parent can drive `checked` via signals. See #1704.
+const isChecked = useReactiveProp('checked', {{ checked }})
 
 function onInputChange(event) {
   if (isDisabled) {

package/dist/{Select-28y0pg83.stx → Select-1vnd0brz.stx}

@@ -27,7 +27,8 @@ export const selectId = `select-${value}`
 
 <script client>
 const emit = defineEmits()
-const selectedValue = state({{ value }})
+// Reactive prop binding — parent can drive `value` via signals. See #1704.
+const selectedValue = useReactiveProp('value', {{ value }}, { parse: (v) => v == null ? '' : String(v) })
 
 function onChange(event) {
   selectedValue.set(event.target.value)

package/dist/{SidebarSection-npt9h265.stx → SidebarSection-g195cb4f.stx}

@@ -37,7 +37,8 @@ export const labelClasses = variant === 'workspace' || variant === 'desktop'
 const emit = defineEmits()
 const sectionId = {{ id }}
 const collapsibleProp = {{ collapsible }}
-const isExpanded = state({{ expanded }})
+// Reactive prop binding — parent can drive `expanded` via signals. See #1704.
+const isExpanded = useReactiveProp('expanded', {{ expanded }})
 
 function onHeaderClick() {
   if (!collapsibleProp) return

package/dist/{Switch-r5t5w04w.stx → Switch-p1bcr9ks.stx}

@@ -26,7 +26,9 @@ const trackBase = {{ trackBaseClasses }}
 const trackDisabled = {{ trackDisabledClasses }}
 const thumbBase = {{ thumbBaseClasses }}
 const extraClass = {{ className }}
-const isChecked = state({{ checked }})
+// Reactive prop binding so the parent can drive `checked` via signals.
+// See stacksjs/stx#1704.
+const isChecked = useReactiveProp('checked', {{ checked }})
 
 function toggle() {
   if (isDisabled) return

package/dist/TabPanel-5htevsq6.stx

@@ -0,0 +1,25 @@
+<script server>
+// Slot wrapper that the parent <Tabs> discovers via DOM walk. The parent
+// reads `data-label` (and optional `data-icon`) to build the tab list and
+// toggles the `hidden` attribute as the active tab changes. Hidden by
+// default — the parent flips the active one visible after mount. See
+// stacksjs/stx#1703.
+export const label = $props.label || ''
+export const icon = $props.icon || ''
+export const className = $props.className || ''
+
+const baseClasses = 'p-4 focus:outline-none'
+export const panelClasses = `${baseClasses} ${className}`.trim()
+</script>
+
+<div
+  data-stx-tab-panel
+  data-label="{{ label }}"
+  data-icon="{{ icon }}"
+  class="{{ panelClasses }}"
+  role="tabpanel"
+  tabindex="0"
+  hidden
+>
+  <slot />
+</div>

package/dist/Tabs-79brys99.stx

@@ -0,0 +1,202 @@
+<script server>
+// Two modes (see stacksjs/stx#1703):
+//   1. Legacy prop API — pass `tabs={[{label, content, icon}, …]}` for
+//      simple string-content tabs (kept for backward compatibility with
+//      existing visual snapshots and consumers).
+//   2. Slot API — drop `<TabPanel label="…">` children for arbitrary
+//      content (components, forms, tables, etc.). The parent enumerates
+//      [data-stx-tab-panel] descendants on mount and builds the tab list
+//      dynamically.
+export const tabs = $props.tabs || []
+export const defaultTab = $props.defaultTab || 0
+export const orientation = $props.orientation || 'horizontal'
+export const variant = $props.variant || 'line'
+export const className = $props.className || ''
+
+const orientationClasses = {
+  horizontal: 'flex-col',
+  vertical: 'flex-row',
+}
+
+const tabListOrientationClasses = {
+  horizontal: 'flex-row border-b',
+  vertical: 'flex-col border-r',
+}
+
+const variantClasses = {
+  line: 'border-gray-200 dark:border-gray-700',
+  pills: 'gap-2 border-0 bg-gray-100 dark:bg-gray-800 p-1 rounded-lg',
+  enclosed: 'border-gray-200 dark:border-gray-700',
+}
+
+export const containerClasses = `flex ${orientationClasses[orientation]} ${className}`.trim()
+export const tabListClasses = `flex ${tabListOrientationClasses[orientation]} ${variantClasses[variant]}`.trim()
+export const tabPanelClasses = `p-4 focus:outline-none`.trim()
+// True when the parent passes a non-empty `tabs` array — switches to the
+// legacy render path so existing snapshots stay byte-identical.
+export const hasPropTabs = Array.isArray(tabs) && tabs.length > 0
+</script>
+
+<script client>
+const emit = defineEmits()
+const tabs = {{ tabs }}
+const variant = {{ variant }}
+const orientation = {{ orientation }}
+const hasPropTabs = {{ hasPropTabs }}
+const containerRef = useRef()
+// In slot mode, `discoveredTabs` is populated from child <TabPanel> data
+// attributes on mount. In prop mode, it mirrors the `tabs` prop so the
+// rendering loop works the same in both modes.
+const discoveredTabs = state(hasPropTabs ? tabs : [])
+const activeTab = state({{ defaultTab }})
+
+// Walk only direct descendants of THIS container (not nested Tabs').
+function findOwnPanels() {
+  const root = containerRef.value
+  if (!root) return []
+  // Closest ancestor with data-stx-tabs must be this container's root —
+  // protects against nested <Tabs> contamination.
+  return Array.from(root.querySelectorAll('[data-stx-tab-panel]'))
+    .filter(p => p.closest('[data-stx-tabs]') === root)
+}
+
+onMount(() => {
+  if (hasPropTabs) return  // legacy mode: prop array already in discoveredTabs
+  const panels = findOwnPanels()
+  const list = panels.map(p => ({
+    label: p.dataset.label || '',
+    icon: p.dataset.icon || '',
+  }))
+  discoveredTabs.set(list)
+})
+
+// In slot mode, toggle each panel's `hidden` attribute as activeTab changes.
+// Prop mode is handled inline by the @foreach loop's :show binding below.
+effect(() => {
+  if (hasPropTabs) return
+  const panels = findOwnPanels()
+  const idx = activeTab()
+  panels.forEach((p, i) => {
+    if (i === idx) p.removeAttribute('hidden')
+    else p.setAttribute('hidden', '')
+  })
+})
+
+function selectTab(index) {
+  activeTab.set(index)
+  const list = discoveredTabs()
+  emit('change', { index, tab: list[index] })
+}
+
+function isActive(index) {
+  return activeTab() === index
+}
+
+function getTabClasses(index) {
+  const isActiveTab = isActive(index)
+  const base = 'px-4 py-2 font-medium text-sm transition-colors duration-150 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 dark:focus:ring-offset-gray-900'
+  if (variant === 'line') {
+    const border = orientation === 'horizontal' ? 'border-b-2' : 'border-r-2'
+    return `${base} ${border} ${isActiveTab ? 'border-blue-500 text-blue-600 dark:text-blue-400' : 'border-transparent text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-200 hover:border-gray-300 dark:hover:border-gray-600'}`
+  }
+  if (variant === 'pills') {
+    return `${base} rounded-md ${isActiveTab ? 'bg-white dark:bg-gray-700 text-gray-900 dark:text-gray-100 shadow-sm' : 'text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-200'}`
+  }
+  if (variant === 'enclosed') {
+    const borders = orientation === 'horizontal' ? 'border-t border-l border-r rounded-t-md' : 'border-t border-l border-b rounded-l-md'
+    return `${base} ${borders} ${isActiveTab ? 'bg-white dark:bg-gray-800 border-gray-200 dark:border-gray-700 -mb-px' : 'bg-gray-50 dark:bg-gray-900 border-transparent hover:border-gray-200 dark:hover:border-gray-700'}`
+  }
+  return base
+}
+
+function onTabKey(event, index) {
+  const tabCount = discoveredTabs().length
+  let next = index
+  if (orientation === 'horizontal') {
+    if (event.key === 'ArrowRight') { event.preventDefault(); next = (index + 1) % tabCount }
+    else if (event.key === 'ArrowLeft') { event.preventDefault(); next = (index - 1 + tabCount) % tabCount }
+  }
+  else {
+    if (event.key === 'ArrowDown') { event.preventDefault(); next = (index + 1) % tabCount }
+    else if (event.key === 'ArrowUp') { event.preventDefault(); next = (index - 1 + tabCount) % tabCount }
+  }
+  if (event.key === 'Home') { event.preventDefault(); next = 0 }
+  else if (event.key === 'End') { event.preventDefault(); next = tabCount - 1 }
+  if (next !== index) {
+    selectTab(next)
+    document.getElementById(`tab-${next}`)?.focus()
+  }
+}
+
+defineExpose({ activeTab, selectTab })
+</script>
+
+<div x-ref="containerRef" data-stx-tabs class="{{ containerClasses }}">
+  <div
+    class="{{ tabListClasses }}"
+    role="tablist"
+    aria-orientation="{{ orientation }}"
+  >
+    @if(hasPropTabs)
+      {{-- Legacy mode: server-side iterate the prop tabs array. Buttons --}}
+      {{-- get static class names so existing visual snapshots stay      --}}
+      {{-- byte-identical.                                                 --}}
+      @foreach(tab in tabs)
+        <button
+          type="button"
+          :class="getTabClasses({{ $loop.index }})"
+          role="tab"
+          :aria-selected="isActive({{ $loop.index }}) ? 'true' : 'false'"
+          aria-controls="tab-panel-{{ $loop.index }}"
+          id="tab-{{ $loop.index }}"
+          :tabindex="isActive({{ $loop.index }}) ? '0' : '-1'"
+          @click="selectTab({{ $loop.index }})"
+          @keydown="onTabKey($event, {{ $loop.index }})"
+        >
+          @if(tab.icon)
+            <span class="inline-flex items-center gap-2">
+              <span x-html="{!! JSON.stringify(tab.icon) !!}"></span>
+              <span>{{ tab.label }}</span>
+            </span>
+          @else
+            {{ tab.label }}
+          @endif
+        </button>
+      @endforeach
+    @else
+      {{-- Slot mode: render the tab list dynamically from --}}
+      {{-- discoveredTabs() which is populated in onMount. --}}
+      <button
+        :for="(tab, idx) in discoveredTabs()"
+        :key="idx"
+        type="button"
+        x-class="getTabClasses(idx)"
+        role="tab"
+        :aria-selected="isActive(idx) ? 'true' : 'false'"
+        :tabindex="isActive(idx) ? 0 : -1"
+        @click="selectTab(idx)"
+        @keydown="onTabKey($event, idx)"
+      >
+        <span :if="tab.icon" class="inline-flex items-center gap-2" x-html="tab.icon"></span>
+        <span :text="tab.label"></span>
+      </button>
+    @endif
+  </div>
+
+  @if(hasPropTabs)
+    @foreach(tab in tabs)
+      <div
+        :show="isActive({{ $loop.index }})"
+        id="tab-panel-{{ $loop.index }}"
+        class="{{ tabPanelClasses }}"
+        role="tabpanel"
+        aria-labelledby="tab-{{ $loop.index }}"
+        tabindex="0"
+      >
+        {!! tab.content !!}
+      </div>
+    @endforeach
+  @else
+    <slot />
+  @endif
+</div>

package/dist/{TextInput-kf084763.stx → TextInput-g0vaz0pe.stx}

@@ -39,7 +39,10 @@ export const inputId = `input-${label}`
 
 <script client>
 const emit = defineEmits()
-const inputValue = state({{ value }})
+// Reactive prop binding so the parent can drive `value` via signals.
+// Parent listens to @input to push user changes back into its signal.
+// See stacksjs/stx#1704.
+const inputValue = useReactiveProp('value', {{ value }}, { parse: (v) => v == null ? '' : String(v) })
 
 function onInput(event) {
   inputValue.set(event.target.value)