rip-lang 3.13.119 → 3.13.121

package/docs/ui/collapsible.rip

@@ -0,0 +1,50 @@
+# Collapsible — accessible headless expand/collapse section
+#
+# Single open/close section. Simpler than Accordion (no item IDs,
+# no single/multiple mode). Exposes content dimensions as CSS
+# custom properties for animated expand/collapse. Ships zero CSS.
+#
+# Usage:
+#   Collapsible open <=> isOpen
+#     button $trigger: true, "Show details"
+#     div $content: true
+#       p "Hidden content here"
+
+export Collapsible = component
+  @open:: boolean := false
+  @disabled:: boolean := false
+
+  _ready := false
+
+  mounted: ->
+    _ready = true
+    trigger = @_root?.querySelector('[data-trigger]')
+    return unless trigger
+    trigger.addEventListener 'click', => @toggle() unless @disabled
+    trigger.addEventListener 'keydown', (e) =>
+      if e.key in ['Enter', ' '] and not @disabled
+        e.preventDefault()
+        @toggle()
+
+  toggle: ->
+    @open = not @open
+    @emit 'change', @open
+
+  ~>
+    return unless _ready
+    trigger = @_root?.querySelector('[data-trigger]')
+    content = @_root?.querySelector('[data-content]')
+    if trigger
+      trigger.setAttribute 'aria-expanded', !!@open
+      if @disabled then trigger.setAttribute 'aria-disabled', true else trigger.removeAttribute 'aria-disabled'
+      trigger.tabIndex = if @disabled then -1 else 0
+    if content
+      content.hidden = not @open
+      if @open
+        rect = content.getBoundingClientRect()
+        content.style.setProperty '--collapsible-height', "#{rect.height}px"
+        content.style.setProperty '--collapsible-width', "#{rect.width}px"
+
+  render
+    div ref: "_root", $open: @open?!, $disabled: @disabled?!
+      slot

package/docs/ui/combobox.rip

@@ -0,0 +1,130 @@
+# Combobox — accessible headless combobox (input + filterable listbox)
+#
+# Keyboard: ArrowDown/Up to navigate, Enter to select, Escape to close,
+#           typing filters the list via the @filter callback.
+#
+# Exposes $open on the wrapper, $highlighted on options.
+# Ships zero CSS — style entirely via attribute selectors in your stylesheet.
+#
+# Usage:
+#   Combobox query <=> searchText, items: fruits, @select: handleSelect, @filter: filterFn
+
+export Combobox = component
+  @query:: string := ""
+  @items:: any[] := []
+  @placeholder:: string := "Search..."
+  @disabled:: boolean := false
+  @autoHighlight:: boolean := true
+
+  open := false
+  highlightedIndex := -1
+  _listId =! "cb-#{Math.random().toString(36).slice(2, 8)}"
+
+  getItems: ->
+    return [] unless @_list
+    Array.from(@_list.querySelectorAll('[role="option"]'))
+
+  _scrollToItem: ->
+    @getItems()[highlightedIndex]?.scrollIntoView({ block: 'nearest' })
+
+  clear: ->
+    @query = ''
+    highlightedIndex = -1
+    @emit 'filter', ''
+
+  onInput: (e) ->
+    @query = e.target.value
+    open = true
+    highlightedIndex = if @autoHighlight and @items.length > 0 then 0 else -1
+    @emit 'filter', @query
+
+  onFocusin: -> @openMenu()
+
+  onFocusout: ->
+    setTimeout => @close() unless @_content?.contains(document.activeElement), 0
+
+  openMenu: ->
+    open = true
+    highlightedIndex = -1
+    @_input?.focus()
+
+  close: ->
+    open = false
+    highlightedIndex = -1
+    @_input?.focus()
+
+  _applyPlacement: ->
+    ARIA.position @_content, @_list, placement: 'bottom start', offset: 2, matchWidth: true
+
+  isDisabled: (item) -> item?.hasAttribute?('data-disabled')
+
+  selectIndex: (idx) ->
+    item = @getItems()[idx]
+    return unless item
+    return if @isDisabled(item)
+    val = item.dataset.value ?? item.textContent.trim()
+    @query = val
+    @emit 'select', val
+    @close()
+
+  _nextEnabled: (from, dir) ->
+    opts = @getItems()
+    len = opts.length
+    i = from
+    loop len
+      i = (i + dir) %% len
+      return i unless @isDisabled(opts[i])
+    from
+
+  _onKeydown: (e) ->
+    len = @getItems().length
+    ARIA.listNav e,
+      next:    => @openMenu() unless open; highlightedIndex = @_nextEnabled(highlightedIndex,  1); @_scrollToItem()
+      prev:    => @openMenu() unless open; highlightedIndex = @_nextEnabled(highlightedIndex, -1); @_scrollToItem()
+      first:   => highlightedIndex = 0;       @_scrollToItem()
+      last:    => highlightedIndex = len - 1; @_scrollToItem()
+      select:  => if highlightedIndex >= 0 then @selectIndex(highlightedIndex) else if len is 1 then @selectIndex(0)
+      dismiss: => if open then @close() else @query = ''
+      tab:     => @close()
+
+  ~>
+    if @_list
+      @_list.setAttribute 'popover', 'auto'
+      @_applyPlacement()
+    ARIA.bindPopover open, (=> @_list), ((isOpen) => open = isOpen), (=> @_input)
+
+  render
+    . ref: "_content", $open: open?!
+
+      # Text input
+      . style: "position:relative;display:inline-flex;align-items:center"
+        input ref: "_input", role: "combobox"
+          type: "text"
+          autocomplete: "off"
+          aria-expanded: !!open
+          aria-haspopup: "listbox"
+          aria-autocomplete: "list"
+          aria-controls: if open then _listId else undefined
+          aria-activedescendant: if highlightedIndex >= 0 then "#{_listId}-#{highlightedIndex}" else undefined
+          $disabled: @disabled?!
+          disabled: @disabled
+          placeholder: @placeholder
+          value: @query
+          @keydown: @_onKeydown
+        if @query
+          button aria-label: "Clear", $clear: true, @click: @clear
+            "✕"
+
+      # Listbox
+      div ref: "_list", id: _listId, role: "listbox", style: "position:fixed;margin:0;inset:auto"
+        $open: open?!
+        for item, idx in @items
+          div role: "option", tabindex: "-1", id: "#{_listId}-#{idx}"
+            $value: item
+            $highlighted: (idx is highlightedIndex)?!
+            @click: (=> @selectIndex(idx))
+            @mouseenter: (=> highlightedIndex = idx)
+            "#{item}"
+        if @items.length is 0 and @query
+          div role: "status", aria-live: "polite", $empty: true
+            "No results"

package/docs/ui/context-menu.rip

@@ -0,0 +1,88 @@
+# ContextMenu — accessible headless right-click menu
+#
+# Opens on contextmenu event (right-click) over the trigger area.
+# Keyboard navigation matches Menu. Ships zero CSS.
+#
+# Usage:
+#   ContextMenu @select: handleAction
+#     div $trigger: true
+#       p "Right-click this area"
+#     div $item: "cut", "Cut"
+#     div $item: "copy", "Copy"
+#     div $item: "paste", "Paste"
+
+export ContextMenu = component
+  @disabled:: boolean := false
+
+  open := false
+  highlightedIndex := -1
+  posX := 0
+  posY := 0
+
+  _menuItems ~=
+    return [] unless @_slot
+    Array.from(@_slot.querySelectorAll('[data-item]') or [])
+
+  _triggerEl ~=
+    return null unless @_slot
+    @_slot.querySelector('[data-trigger]')
+
+  _onContextMenu: (e) ->
+    return if @disabled
+    e.preventDefault()
+    posX = e.clientX
+    posY = e.clientY
+    open = true
+    highlightedIndex = 0
+    requestAnimationFrame =>
+      @_list?.querySelectorAll('[role="menuitem"]')[0]?.focus()
+
+  close: ->
+    open = false
+    highlightedIndex = -1
+
+  selectIndex: (idx) ->
+    item = _menuItems[idx]
+    return unless item
+    return if item.dataset.disabled?
+    @emit 'select', item.dataset.item
+    @close()
+
+  _focusItem: (idx) ->
+    highlightedIndex = idx
+    @_list?.querySelectorAll('[role="menuitem"]')[idx]?.focus()
+
+  _onKeydown: (e) ->
+    return unless _menuItems.length
+    len = _menuItems.length
+    ARIA.listNav e,
+      next:    => @_focusItem((highlightedIndex + 1) %% len)
+      prev:    => @_focusItem((highlightedIndex - 1) %% len)
+      first:   => @_focusItem(0)
+      last:    => @_focusItem(len - 1)
+      select:  => @selectIndex(highlightedIndex)
+      dismiss: => @close()
+      tab:     => @close()
+
+  ~> ARIA.popupDismiss open, (=> @_list), (=> @close())
+
+  render
+    . @contextmenu: @_onContextMenu
+
+      . ref: "_slot", style: "display:none"
+        slot
+
+      if _triggerEl
+        . innerHTML: _triggerEl.innerHTML
+
+      if open
+        div ref: "_list", role: "menu", $open: true, @keydown: @_onKeydown
+          style: "position:fixed;left:#{posX}px;top:#{posY}px;z-index:50"
+          for item, idx in _menuItems
+            div role: "menuitem", tabindex: "-1"
+              $highlighted: (idx is highlightedIndex)?!
+              $disabled: item.dataset.disabled?!
+              $value: item.dataset.item
+              @click: (=> @selectIndex(idx))
+              @mouseenter: (=> highlightedIndex = idx)
+              = item.textContent

package/docs/ui/date-picker.rip

@@ -0,0 +1,206 @@
+# DatePicker — accessible headless date picker with calendar
+#
+# A popover calendar for selecting a single date or a date range.
+# Set @range to true for range selection (value becomes [from, to]).
+# Keyboard: Arrow keys navigate days, Enter selects, Escape closes.
+# Ships zero CSS — style entirely via attribute selectors in your stylesheet.
+#
+# Usage:
+#   DatePicker value <=> selectedDate, placeholder: "Pick a date"
+#   DatePicker value <=> dateRange, range: true
+
+dpFmt = (d) ->
+  return '' unless d
+  m = String(d.getMonth() + 1).padStart(2, '0')
+  day = String(d.getDate()).padStart(2, '0')
+  "#{m}/#{day}/#{d.getFullYear()}"
+
+dpParse = (str) ->
+  return null unless str?.length is 10
+  parts = str.split('/')
+  return null unless parts.length is 3
+  [m, d, y] = parts.map Number
+  return null if isNaN(m) or isNaN(d) or isNaN(y)
+  dt = new Date(y, m - 1, d)
+  return null if dt.getMonth() isnt m - 1
+  dt
+
+dpSameDay = (a, b) ->
+  return false unless a and b
+  a.getFullYear() is b.getFullYear() and a.getMonth() is b.getMonth() and a.getDate() is b.getDate()
+
+dpInRange = (day, from, to) ->
+  return false unless day and from and to
+  t = day.getTime()
+  lo = Math.min(from.getTime(), to.getTime())
+  hi = Math.max(from.getTime(), to.getTime())
+  t >= lo and t <= hi
+
+export DatePicker = component
+  @value:: any := null
+  @placeholder:: string := "mm/dd/yyyy"
+  @disabled:: boolean := false
+  @range:: boolean := false
+  @firstDayOfWeek:: number := 0
+
+  open := false
+  viewMonth := new Date()
+  _rangeStart := null
+  _hoveredDay := null
+  _inputText := ''
+  _id =! "dp-#{Math.random().toString(36).slice(2, 8)}"
+
+  _dayNames =! ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa']
+
+  _daysInView ~=
+    yr = viewMonth.getFullYear()
+    mo = viewMonth.getMonth()
+    firstOfMonth = new Date(yr, mo, 1)
+    startDay = firstOfMonth.getDay()
+    offset = (startDay - @firstDayOfWeek + 7) %% 7
+    daysInMonth = new Date(yr, mo + 1, 0).getDate()
+    prevMonthDays = new Date(yr, mo, 0).getDate()
+    dayList = []
+    for n in [0...offset]
+      dayList.push { date: new Date(yr, mo - 1, prevMonthDays - offset + n + 1), outside: true }
+    for n in [1..daysInMonth]
+      dayList.push { date: new Date(yr, mo, n), outside: false }
+    trailing = (7 - dayList.length %% 7) %% 7
+    for n in [1..trailing]
+      dayList.push { date: new Date(yr, mo + 1, n), outside: true }
+    dayList
+
+  _displayText ~=
+    if @range
+      if Array.isArray(@value) and @value[0]
+        from = dpFmt(@value[0])
+        to = if @value[1] then dpFmt(@value[1]) else '...'
+        "#{from} – #{to}"
+      else
+        @placeholder
+    else
+      if @value then dpFmt(@value) else @placeholder
+
+  _monthLabel ~=
+    viewMonth.toLocaleDateString(undefined, { month: 'long', year: 'numeric' })
+
+  _today =! new Date()
+
+  _prevMonth: ->
+    viewMonth = new Date(viewMonth.getFullYear(), viewMonth.getMonth() - 1, 1)
+
+  _nextMonth: ->
+    viewMonth = new Date(viewMonth.getFullYear(), viewMonth.getMonth() + 1, 1)
+
+  _selectDay: (day) ->
+    return if @disabled
+    if @range
+      if _rangeStart and not dpSameDay(_rangeStart, day)
+        from = if _rangeStart < day then _rangeStart else day
+        to = if _rangeStart < day then day else _rangeStart
+        @value = [from, to]
+        _rangeStart = null
+        @emit 'change', @value
+        open = false
+      else
+        _rangeStart = day
+        @value = [day, null]
+    else
+      @value = day
+      @emit 'change', @value
+      open = false
+    _inputText = _displayText
+
+  _onInputChange: (e) ->
+    raw = e.target.value.replace(/[^\d\/]/g, '')
+    if raw.length <= 10
+      _inputText = raw
+    if raw.length is 10
+      dt = dpParse(raw)
+      if dt
+        @value = dt
+        viewMonth = new Date(dt.getFullYear(), dt.getMonth(), 1)
+        @emit 'change', @value
+
+  toggle: ->
+    return if @disabled
+    if open then @close() else @openPicker()
+
+  openPicker: ->
+    open = true
+    if @value and not @range
+      viewMonth = new Date(@value.getFullYear(), @value.getMonth(), 1)
+    else if @range and Array.isArray(@value) and @value[0]
+      viewMonth = new Date(@value[0].getFullYear(), @value[0].getMonth(), 1)
+    _inputText = _displayText
+    requestAnimationFrame => @_position()
+
+  close: ->
+    open = false
+    _rangeStart = null
+    _hoveredDay = null
+
+  _position: -> ARIA.positionBelow @_trigger, @_cal, 4, false
+
+  _onKeydown: (e) ->
+    switch e.key
+      when 'Escape'
+        e.preventDefault()
+        @close()
+        @_trigger?.focus()
+      when 'Enter', ' '
+        e.preventDefault()
+        @toggle() unless open
+
+  ~>
+    if open
+      onDown = (e) =>
+        unless @_trigger?.contains(e.target) or @_cal?.contains(e.target)
+          @close()
+      document.addEventListener 'mousedown', onDown
+      return -> document.removeEventListener 'mousedown', onDown
+
+  render
+    . $open: open?!, $disabled: @disabled?!, $range: @range?!
+
+      # Trigger
+      button ref: "_trigger", $trigger: true
+        aria-haspopup: "dialog"
+        aria-expanded: !!open
+        disabled: @disabled
+        @click: @toggle
+        @keydown: @_onKeydown
+        _displayText
+
+      # Calendar dropdown
+      if open
+        div ref: "_cal", role: "dialog", aria-label: "Date picker", $calendar: true
+          style: "position:fixed;z-index:50"
+
+          # Month navigation
+          . $header: true
+            button $prev: true, aria-label: "Previous month", @click: @_prevMonth
+              "‹"
+            span $month-label: true
+              _monthLabel
+            button $next: true, aria-label: "Next month", @click: @_nextMonth
+              "›"
+
+          # Day-of-week headers
+          . $weekdays: true
+            for dayName in _dayNames
+              span $weekday: true
+                dayName
+
+          # Day grid
+          . $days: true, role: "grid"
+            for entry, dIdx in _daysInView
+              button role: "gridcell", tabindex: "-1"
+                $outside: entry.outside?!
+                $today: dpSameDay(entry.date, _today)?!
+                $selected: (if @range then (Array.isArray(@value) and (dpSameDay(entry.date, @value[0]) or dpSameDay(entry.date, @value[1]))) else dpSameDay(entry.date, @value))?!
+                $in-range: (if @range then (if _rangeStart then dpInRange(entry.date, _rangeStart, _hoveredDay or _rangeStart) else if Array.isArray(@value) and @value[0] and @value[1] then dpInRange(entry.date, @value[0], @value[1]) else false) else false)?!
+                $range-start: (if @range and _rangeStart then dpSameDay(entry.date, _rangeStart) else false)?!
+                @click: (=> @_selectDay(entry.date))
+                @mouseenter: (=> _hoveredDay = entry.date)
+                entry.date.getDate()

package/docs/ui/dialog.rip

@@ -0,0 +1,60 @@
+# Dialog — accessible headless modal dialog
+#
+# Native `<dialog>` variant that uses `showModal()` for top-layer modality.
+# Restores focus to the previously focused element on close.
+# Auto-wires aria-labelledby (first h1-h6) and aria-describedby (first p).
+#
+# Exposes $open on the backdrop. Ships zero CSS.
+#
+# Usage:
+#   Dialog open <=> showDialog, @close: handleClose
+#     h2 "Title"
+#     p "Content"
+#     button @click: (=> showDialog = false), "Close"
+
+export Dialog = component
+  @open:: boolean := false
+  @dismissable:: boolean := true
+  @initialFocus:: any := null
+
+  _id =! "dlg-#{Math.random().toString(36).slice(2, 8)}"
+
+  ~>
+    ARIA.bindDialog @open, (=> @_dialog), ((isOpen) =>
+      if not isOpen and @open
+        @open = false
+        @emit 'close'
+    ), @dismissable
+
+  ~>
+    if @open
+      ARIA.lockScroll(this)
+      requestAnimationFrame =>
+        panel = @_dialog
+        if panel
+          ARIA.wireAria panel, _id
+          if @initialFocus
+            target = if typeof @initialFocus is 'string' then panel.querySelector(@initialFocus) else @initialFocus
+            target?.focus()
+          else
+            panel.querySelectorAll('a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])')?[0]?.focus()
+      return ->
+        ARIA.unlockScroll(this)
+
+  close: ->
+    @open = false
+    @emit 'close'
+
+  onKeydown: (e) ->
+    if e.key is 'Escape'
+      e.preventDefault()
+      @close() if @dismissable
+
+  onBackdropClick: (e) ->
+    if e.target is e.currentTarget and @dismissable
+      @_dialog?.close()
+
+  render
+    dialog ref: "_dialog", @click: @onBackdropClick, @keydown: @onKeydown
+      $open: @open?!
+      slot

package/docs/ui/drawer.rip

@@ -0,0 +1,58 @@
+# Drawer — accessible headless slide-out panel
+#
+# A Dialog variant that slides from an edge of the screen.
+# Supports dismiss on escape, click-outside, and optional swipe-to-close.
+# Ships zero CSS.
+#
+# Usage:
+#   Drawer open <=> showDrawer, side: "right"
+#     h2 "Settings"
+#     p "Panel content here"
+
+export Drawer = component
+  @open:: boolean := false
+  @side:: "top" | "right" | "bottom" | "left" := "right"
+  @dismissable:: boolean := true
+
+  _prevFocus = null
+  _id =! "drw-#{Math.random().toString(36).slice(2, 8)}"
+
+  ~>
+    ARIA.bindDialog @open, (=> @_dialog), ((isOpen) =>
+      if not isOpen and @open
+        @open = false
+        @emit 'close'
+    ), @dismissable
+
+  ~>
+    if @open
+      _prevFocus = document.activeElement
+      ARIA.lockScroll(this)
+      requestAnimationFrame =>
+        panel = @_dialog
+        if panel
+          ARIA.wireAria panel, _id
+          panel.querySelectorAll('a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])')?[0]?.focus()
+      return ->
+        ARIA.unlockScroll(this)
+        _prevFocus?.focus()
+
+  close: ->
+    @open = false
+    @emit 'close'
+
+  onKeydown: (e) ->
+    if e.key is 'Escape' and @dismissable
+      e.preventDefault()
+      @close()
+
+  onBackdropClick: (e) ->
+    if e.target is e.currentTarget and @dismissable
+      @_dialog?.close()
+
+  render
+    dialog ref: "_dialog", $open: @open?!, $side: @side
+      @click: @onBackdropClick
+      @keydown: @onKeydown
+      $side: @side
+      slot

package/docs/ui/editable-value.rip

@@ -0,0 +1,82 @@
+# EditableValue — accessible headless inline editable value
+#
+# Displays a value with an edit trigger. Clicking opens a popover form.
+# Emits 'save' on submit. Ships zero CSS.
+#
+# Usage:
+#   EditableValue @save: handleSave
+#     span $display: true
+#       "John Doe"
+#     div $editor: true
+#       input type: "text", value: name, @input: (e) => name = e.target.value
+
+export EditableValue = component
+  @disabled:: boolean := false
+
+  editing := false
+  saving := false
+
+  _onEdit: ->
+    return if @disabled
+    editing = true
+    requestAnimationFrame => @_position()
+
+  _onSave: ->
+    return if saving
+    saving = true
+    @emit 'save'
+    @close()
+
+  _onCancel: ->
+    editing = false
+    saving = false
+
+  close: ->
+    editing = false
+    saving = false
+
+  setSaving: (val) -> saving = val
+
+  _position: ->
+    display = @_root?.querySelector('[data-display]')
+    editor = @_root?.querySelector('[data-editor]')
+    return unless display and editor
+    @_root.style.position = 'relative'
+    dr = display.getBoundingClientRect()
+    cr = @_root.getBoundingClientRect()
+    editor.style.position = 'absolute'
+    editor.style.left = "0px"
+    editor.style.top = "#{dr.bottom - cr.top + 4}px"
+    editor.style.zIndex = '50'
+    editor.querySelector('input, textarea, select')?.focus()
+
+  ~>
+    _editing = editing                                 # track before any early return
+    display = @_root?.querySelector('[data-display]')
+    editor = @_root?.querySelector('[data-editor]')
+    return unless display and editor
+    editor.hidden = not _editing
+    if _editing
+      editor.setAttribute 'data-open', ''
+      onDown = (e) =>
+        unless @_root?.contains(e.target)
+          @_onCancel()
+      document.addEventListener 'mousedown', onDown
+      return -> document.removeEventListener 'mousedown', onDown
+    else
+      editor.removeAttribute 'data-open'
+
+  onKeydown: (e) ->
+    if e.key is 'Escape' and editing
+      e.preventDefault()
+      @_onCancel()
+    if e.key is 'Enter' and editing
+      e.preventDefault()
+      @_onSave()
+
+  render
+    div ref: "_root", $editing: editing?!, $disabled: @disabled?!, $saving: saving?!
+      slot
+      unless editing
+        button $edit-trigger: true, aria-label: "Edit", @click: @_onEdit
+          "✎"