@rip-lang/ui 0.3.20 → 0.3.21

package/dialog.rip

@@ -0,0 +1,107 @@
+# Dialog — accessible headless modal dialog
+#
+# Traps focus, locks scroll, dismisses on Escape or click outside.
+# 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"
+
+dialogStack = []
+
+export Dialog = component
+  @open := false
+  @dismissable := true
+  @initialFocus := null
+
+  _prevFocus = null
+  _cleanupTrap = null
+  _scrollY = 0
+  _id =! "dlg-#{Math.random().toString(36).slice(2, 8)}"
+
+  _wireAria: ->
+    panel = @_panel
+    return unless panel
+    heading = panel.querySelector('h1,h2,h3,h4,h5,h6')
+    if heading
+      heading.id ?= "#{_id}-title"
+      panel.setAttribute 'aria-labelledby', heading.id
+    desc = panel.querySelector('p')
+    if desc
+      desc.id ?= "#{_id}-desc"
+      panel.setAttribute 'aria-describedby', desc.id
+
+  ~>
+    if @open
+      _prevFocus = document.activeElement
+      _scrollY = window.scrollY
+      dialogStack.push this
+      document.body.style.position = 'fixed'
+      document.body.style.top = "-#{_scrollY}px"
+      document.body.style.width = '100%'
+
+      setTimeout =>
+        panel = @_panel
+        if panel
+          @_wireAria()
+          if @initialFocus
+            target = if typeof @initialFocus is 'string' then panel.querySelector(@initialFocus) else @initialFocus
+            target?.focus()
+          else
+            focusable = panel.querySelectorAll 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])'
+            focusable[0]?.focus()
+          _cleanupTrap = (e) ->
+            return unless e.key is 'Tab'
+            list = Array.from(panel.querySelectorAll('a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])')).filter (f) -> f.offsetParent isnt null
+            return unless list.length
+            first = list[0]
+            last = list[list.length - 1]
+            if e.shiftKey
+              if document.activeElement is first then (e.preventDefault(); last.focus())
+            else
+              if document.activeElement is last then (e.preventDefault(); first.focus())
+          panel.addEventListener 'keydown', _cleanupTrap
+      , 0
+
+      return ->
+        idx = dialogStack.indexOf this
+        dialogStack.splice(idx, 1) if idx >= 0
+        document.body.style.position = '' unless dialogStack.length
+        document.body.style.top = '' unless dialogStack.length
+        document.body.style.width = '' unless dialogStack.length
+        window.scrollTo 0, _scrollY unless dialogStack.length
+        _prevFocus?.focus()
+    else
+      idx = dialogStack.indexOf this
+      dialogStack.splice(idx, 1) if idx >= 0
+      unless dialogStack.length
+        document.body.style.position = ''
+        document.body.style.top = ''
+        document.body.style.width = ''
+        window.scrollTo 0, _scrollY
+      _prevFocus?.focus()
+
+  close: ->
+    @open = false
+    @emit 'close'
+
+  onKeydown: (e) ->
+    if e.key is 'Escape' and dialogStack[dialogStack.length - 1] is this
+      e.preventDefault()
+      @close() if @dismissable
+
+  onBackdropClick: (e) ->
+    @close() if e.target is e.currentTarget and @dismissable
+
+  render
+    if @open
+      div ref: "_backdrop", $open: true,
+        @click: @onBackdropClick,
+        @keydown: @onKeydown
+        div ref: "_panel", role: "dialog", aria-modal: "true", tabindex: "-1"
+          slot

package/drawer.rip

@@ -0,0 +1,79 @@
+# 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 := false
+  @side := 'right'
+  @dismissable := true
+
+  _prevFocus = null
+  _scrollY = 0
+  _id =! "drw-#{Math.random().toString(36).slice(2, 8)}"
+
+  _wireAria: ->
+    panel = @_panel
+    return unless panel
+    heading = panel.querySelector('h1,h2,h3,h4,h5,h6')
+    if heading
+      heading.id ?= "#{_id}-title"
+      panel.setAttribute 'aria-labelledby', heading.id
+    desc = panel.querySelector('p')
+    if desc
+      desc.id ?= "#{_id}-desc"
+      panel.setAttribute 'aria-describedby', desc.id
+
+  ~>
+    if @open
+      _prevFocus = document.activeElement
+      document.body.style.overflow = 'hidden'
+
+      setTimeout =>
+        panel = @_panel
+        if panel
+          @_wireAria()
+          focusable = panel.querySelectorAll 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])'
+          focusable[0]?.focus()
+          @_trapHandler = (e) ->
+            return unless e.key is 'Tab'
+            list = Array.from(panel.querySelectorAll('a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])')).filter (f) -> f.offsetParent isnt null
+            return unless list.length
+            first = list[0]
+            last = list[list.length - 1]
+            if e.shiftKey
+              if document.activeElement is first then (e.preventDefault(); last.focus())
+            else
+              if document.activeElement is last then (e.preventDefault(); first.focus())
+          panel.addEventListener 'keydown', @_trapHandler
+      , 0
+    else
+      document.body.style.overflow = ''
+      _prevFocus?.focus()
+
+  close: ->
+    @open = false
+    @emit 'close'
+
+  onKeydown: (e) ->
+    if e.key is 'Escape' and @dismissable
+      e.preventDefault()
+      @close()
+
+  onBackdropClick: (e) ->
+    @close() if e.target is e.currentTarget and @dismissable
+
+  render
+    if @open
+      div ref: "_backdrop", $open: true, $side: @side
+        @click: @onBackdropClick
+        @keydown: @onKeydown
+        div ref: "_panel", role: "dialog", aria-modal: "true", tabindex: "-1"
+          $side: @side
+          slot

package/editable-value.rip

@@ -0,0 +1,80 @@
+# 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 := false
+
+  editing := false
+  saving := false
+
+  _onEdit: ->
+    return if @disabled
+    editing = true
+    requestAnimationFrame => @_position()
+
+  _onSave: ->
+    return if saving
+    saving = true
+    @emit 'save'
+
+  _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()
+
+  ~>
+    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
+          "✎"

package/field.rip

@@ -0,0 +1,53 @@
+# Field — accessible headless form field wrapper
+#
+# Associates a label, description, and error message with a form control.
+# Generates linked IDs for aria-labelledby/describedby/errormessage.
+# Ships zero CSS.
+#
+# Usage:
+#   Field label: "Email", error: errors.email
+#     Input value <=> email, type: "email"
+
+export Field = component
+  @label := ''
+  @description := ''
+  @error := ''
+  @disabled := false
+  @required := false
+
+  _id =! "fld-#{Math.random().toString(36).slice(2, 8)}"
+
+  mounted: ->
+    ctrl = @_root?.querySelector('input, select, textarea, button, [role]')
+    if ctrl
+      ctrl.setAttribute 'aria-labelledby', "#{_id}-label" if @label
+      ctrl.setAttribute 'aria-describedby', "#{_id}-desc" if @description
+      ctrl.setAttribute 'aria-errormessage', "#{_id}-err" if @error
+      ctrl.setAttribute 'aria-invalid', true if @error
+      ctrl.setAttribute 'aria-required', true if @required
+
+  ~>
+    ctrl = @_root?.querySelector('input, select, textarea, button, [role]')
+    return unless ctrl
+    if @error
+      ctrl.setAttribute 'aria-invalid', true
+      ctrl.setAttribute 'aria-errormessage', "#{_id}-err"
+    else
+      ctrl.removeAttribute 'aria-invalid'
+      ctrl.removeAttribute 'aria-errormessage'
+
+  render
+    div $disabled: @disabled?!, $invalid: @error?!
+      if @label
+        label id: "#{_id}-label", $label: true
+          @label
+          if @required
+            span $required: true, aria-hidden: "true"
+              " *"
+      slot
+      if @description and not @error
+        div id: "#{_id}-desc", $description: true
+          @description
+      if @error
+        div id: "#{_id}-err", role: "alert", $error: true
+          @error

package/fieldset.rip

@@ -0,0 +1,22 @@
+# Fieldset — accessible headless fieldset with legend
+#
+# Groups related fields with an optional legend. Disables all children
+# when @disabled is set. Ships zero CSS.
+#
+# Usage:
+#   Fieldset legend: "Shipping Address"
+#     Field label: "Street"
+#       Input value <=> street
+#     Field label: "City"
+#       Input value <=> city
+
+export Fieldset = component
+  @legend := ''
+  @disabled := false
+
+  render
+    fieldset disabled: @disabled, $disabled: @disabled?!
+      if @legend
+        legend $legend: true
+          @legend
+      slot

package/form.rip

@@ -0,0 +1,39 @@
+# Form — accessible headless form with validation and submission
+#
+# Wraps native <form> with submit handling, validation state, and
+# loading indicator support. Prevents default submission and emits
+# a 'submit' event. Ships zero CSS.
+#
+# Usage:
+#   Form @submit: handleSubmit
+#     Field label: "Name"
+#       Input value <=> name
+#     Button
+#       "Submit"
+
+export Form = component
+  @disabled := false
+
+  submitting := false
+  submitted := false
+  errors := {}
+
+  _onSubmit: (e) ->
+    e.preventDefault()
+    return if @disabled or submitting
+    submitting = true
+    submitted = true
+    @emit 'submit', { form: e.target }
+
+  setErrors: (errs) ->
+    errors = errs or {}
+
+  setSubmitting: (val) ->
+    submitting = val
+
+  render
+    form @submit: @_onSubmit, novalidate: true
+      $disabled: @disabled?!
+      $submitting: submitting?!
+      $submitted: submitted?!
+      slot