zaniah 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bad32e7fbe4f1abe64589fbc41d73f242c4ed3aeee9f760c67a4d205d0c8d8d7
-  data.tar.gz: b57324bacd30eeea83d04407f689e9ca47d79178d1f0228acf5396fa2ea27881
+  metadata.gz: 3a6d77e1edea911ee42064986e375f163213f45bedaeda9c6f3e409b42914cbd
+  data.tar.gz: 21970a583f79a01502abf982811820361a7628dc0ffffca0a2f308fa4852a6b7
 SHA512:
-  metadata.gz: 5bbf0bebdad77e095cb6faba2a614cf5129558dd10629c94f2e6ad9966f9cb50dfe32a37b551569cdcfb1ba74085d4c64a3667740ff1699fa7b8ce03c553ad4c
-  data.tar.gz: 9d2491ddb19ce68065497f484b9bba0aa4e026fa998a31e3bca3d7bd41f0ed6edd805f0096aefd28ce2b1acf9309f0b96785cbbce88d67ebea10526094060a2f
+  metadata.gz: 83d536f11608784994079181c05524fb3935cddf6076728967b78fc54b48ae91889c387efc047159f767dac8743ae5cb89f7c3497f75afa7b733133f6bc7e982
+  data.tar.gz: caa3b692cbe5435abc9571b0ccc3a09dc46db71c022a0ab2f80903dab7336c3818c3ae05ecc3ee6a0aa8ba657fb45bfa61a5218ec236546f229ba9d80614ace2

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.11.0 — 2026-09-25
+
+- Add segmented controls, alerts, hover cards, calendar and date-range inputs.
+- Add zoomable views, dockable workspaces, and editable property grids.
+- Add typed drag-and-drop across desktop backends with explicit move completion.
+
 ## 0.10.0 — 2026-09-24
 
 - Add Unicode bidirectional text layout, caret affinity, and Arabic joining.

data/docs/adr/021-dock-layout-tree.md

@@ -0,0 +1,33 @@
+# ADR 021: Represent dock layouts as a validated tree
+
+- Status: Accepted
+- Date: 2026-09-24
+
+## Context
+
+An application needs to save tabbed, split workspaces and restore them across
+sessions. Dragging a tab changes both its group and potentially the split tree.
+A fixed five-region dock cannot represent nested splits or stable panel identity.
+
+## Decision
+
+`UI::DockLayout` stores tab groups and binary splits with stable string IDs.
+`to_h` and `from_h` provide a plain-data round trip; parsing rejects duplicate
+IDs, empty groups, invalid active tabs, invalid orientations, and out-of-range
+ratios. `UI::DockWorkspace` derives visible panes from this model and reuses
+`UI::SplitPane` for dividers. Layout changes produce a new validated model.
+The application owns persistence and handles `on_detach` notifications; the
+component does not create windows.
+
+## Alternatives considered
+
+- A flat list of panels plus coordinates would make nested resizing and
+  restoration ambiguous.
+- Extending `DockPanel` would change its simple five-region contract.
+- Making detach automatically create windows would assume application policy.
+
+## Consequences
+
+Persisted layouts can be validated independently of rendering. Empty groups
+are pruned after a move. Applications can choose their own storage format and
+window ownership; they must keep panel IDs stable across releases.

data/docs/components.md

@@ -32,6 +32,7 @@ Zaniah::UI::Button.variants[:variant][:brand] = ->(theme) {
 | L0 | `Card` | `(*children)`, `child` | theme surface | group |
 | L0 | `Badge` | `(text, variant:)` | neutral/accent/success/warning/danger | text |
 | L0 | `Kbd` | `(keys, platform:)`; `.for(action, keymap:)` | OS shortcut notation, including multi-stroke bindings | text |
+| L0 | `Alert` | `(title, message:, variant:, action:, dismissible:, live:)`; `dismiss` | info/success/warning/danger; persistent until dismissed | alert when live, otherwise status |
 | L0 | `Avatar` | `(name, image:, size:)` | initials or PNG | image |
 | L0 | `Skeleton` | `(width:, height:)` | pulsing loading placeholder | progressbar/busy |
 | L0 | `EmptyState` | `(title, message:, icon:, action:)` | compositional | group |
@@ -42,6 +43,7 @@ Zaniah::UI::Button.variants[:variant][:brand] = ->(theme) {
 | L1 | `Checkbox` | `(label, value:, disabled:)`; `on_change` | true/false/mixed | checkbox |
 | L1 | `Radio` | `(label, value:, disabled:)`; `on_change` | selected/unselected | radio |
 | L1 | `RadioGroup` | `(options, value:)`; `on_change` | one selected value | radiogroup |
+| L1 | `SegmentedControl` | `(options, value:)`; `on_change` | mutually exclusive segments; arrows/Home/End | radiogroup/radio |
 | L1 | `Switch` | `(label, value:, disabled:)`; `on_change` | on/off | switch |
 | L1 | `Slider` | `(value:, min:, max:, step:, label:)`; `on_change` | pointer + arrow/Home/End/Page keys | slider |
 | L1 | `RangeSlider` | `(value: [low, high], ...)` | two thumbs | slider |
@@ -50,6 +52,7 @@ Zaniah::UI::Button.variants[:variant][:brand] = ->(theme) {
 | L1 | `Meter` | `(value:, low:, high:, optimum:)` | thresholds | meter |
 | L2 | `Tooltip` | `(text, anchor:, side:, open:)` | top/bottom/left/right | tooltip |
 | L2 | `Popover` | `(content, anchor:, side:, width:, height:, open:, modal:)` | flipped and viewport-clamped | group |
+| L2 | `HoverCard` | `(content, anchor:, open_delay:, close_delay:)` | hover or focus opens after a delay; non-modal | dialog |
 | L2 | `ContextMenu`, `Menu` | `(items, anchor:, open:)` | pointer + arrows/Home/End/Enter/Esc | menu/menuitem |
 | L2 | `MenuBar` | `(menus)` or `.from(app.menu_bar)` | declarative menu model or legacy pairs | menubar |
 | L2 | `Dropdown` | `(label, items:, value:)`; `on_change` | menu-backed | button |
@@ -63,6 +66,8 @@ Zaniah::UI::Button.variants[:variant][:brand] = ->(theme) {
 | L2 | `Combobox` | `(items, value:, label:, placeholder:, disabled:, matcher:)`; `on_change` | editable, filtered choices with highlighted matches | combobox |
 | L2 | `MultiSelect` | `(items, value:, label:, disabled:)`; `on_change` | multiple selected badges | listbox |
 | L2 | `DatePicker` | `(value, min:, max:, label:, disabled:)`; `on_change` | ISO date, day/week keyboard steps | combobox |
+| L2 | `Calendar` | `(value:, min:, max:, range:, week_start:, month_names:)`; `on_change` | arrow keys move days/weeks, Page keys move months, Enter selects | grid/gridcell |
+| L2 | `DateRangePicker` | `(value:, min:, max:, week_start:, month_names:)`; `on_change` | Calendar-backed start/end selection | combobox |
 | L2 | `TimePicker` | `(value, step:, label:, disabled:)`; `on_change` | 24-hour time, minute/hour keyboard steps | combobox |
 | L2 | `ColorPicker` | `(value, label:, swatches:, disabled:)`; `on_change` | hex input and swatches | combobox |
 | L3 | `Tabs` | `(items, selected:)`; `on_change` | arrows/Home/End | tab/tabpanel |
@@ -82,11 +87,14 @@ Zaniah::UI::Button.variants[:variant][:brand] = ->(theme) {
 | L3 | `SplitPane` | `(first, second, orientation:, ratio:, min:, max:)`; `on_change` | horizontal/vertical, draggable separator | group/separator |
 | L3 | `PaneGrid` | `(panes, columns:, rows:, divider_size:, minimum:, keyboard_step:)`; `replace`, `on_resize` | arbitrary resizable grid, stable pane IDs | group/separator |
 | L3 | `Resizable` | `(content, width:, height:, min_width:, min_height:, max_width:, max_height:)`; `on_resize` | drag or keyboard resize | group/separator |
+| L3 | `ZoomPanView` | `(content, zoom:, min_zoom:, max_zoom:)`; `fit`, `zoom_to`, `view_to_content` | drag to pan, pinch or Ctrl+wheel to zoom, `+`/`-`/`0` when focused | group |
 | L3 | `DockPanel` | `(center:, top:, right:, bottom:, left:)` | five-region layout | group |
+| L3 | `DockWorkspace` | `(layout, render:)`; `on_layout_change`, `on_detach`; `DockLayout.to_h`/`.from_h` | drag tabs to move/split, arrows select, Alt+arrows move, Ctrl+Shift+arrows split, Ctrl+Shift+D requests detach | tablist/tab/tabpanel/separator |
 | L3 | `ListView` | `(items, height:, row_height:, selected:)`; `on_select` | virtual rows and keyboard selection | list/listitem |
 | L4 | `Table`, `DataGrid` | `(rows, columns:, height:, selection:, row_key:)`; `on_sort`, `on_select`, `on_edit`, `on_copy`, `on_paste` | virtual rows, sorting, resizing, editing, typed clipboard hooks | table/row/cell |
 | L4 | `Grid` | `(rows:, columns:, row_height:, column_width:, frozen_rows:, frozen_columns:)`; `scroll_to`, range `selection`, `on_select`, `on_edit`, `on_fill`, `on_resize`, `on_copy`, `on_paste` | two-axis virtualization, frozen panes, visible-cell resize/fill and typed clipboard hooks | table |
 | L4 | `TreeView` | `(items, height:, selected:)`; `expand`, `collapse`, `replace`, `replace_children`, `invalidate`, lazy `children` proc | arrows/Home/End | tree/treeitem |
+| L4 | `PropertyGrid` | `(schema, values, height:, row_height:)`; `on_change`, `set` | typed existing controls, `Validation`, virtual rows | table/row/cell |
 | L5 | `Sparkline` | `(values, width:, height:, color:, label:)` | line + tooltip | image |
 | L5 | `LineChart`, `BarChart`, `StackedBarChart`, `AreaChart` | `(series, width:, height:, colors:, label:)`; `AreaChart(stacked:)` | shared axes, ticks, grid lines, color-keyed legend, tooltip | image |
 | L5 | `PieChart`, `DonutChart` | `(data, width:, height:, colors:, label:)` | slices, shared color-keyed legend, tooltip | image |
@@ -101,6 +109,28 @@ All input components are keyboard operable. Disabled controls remain visible but
 removed from focus traversal. Overlay components close on Esc; modal overlays restore
 the previous focus. See [TUI](tui.md) for terminal representations.
 
+`Calendar` and `DateRangePicker` use Ruby's `Date` and ISO 8601 strings. Pass
+`week_start: 0..6` (Sunday is 0) and twelve `month_names:` to localize the grid
+without an i18n dependency. A range picker returns a two-element array of dates;
+its second value is `nil` while the user is choosing the end. `HoverCard` accepts
+an element/component as its anchor to open on pointer hover or keyboard focus, or
+a `Point`/`Bounds` for positioned use. Its delays follow the window's injected clock.
+
+`ZoomPanView` uses content-local coordinates for `zoom_to` and `view_to_content`.
+Call `fit` after the first layout; it scales the content into the current viewport.
+Native macOS pinch emits `Input::Magnify`, while Ctrl+wheel provides a desktop fallback.
+
+`DockLayout` is a validated tree of tab groups and horizontal/vertical splits with
+stable string IDs. Use `DockLayout.tabs` and `.split` to build it, and persist
+`layout.to_h` in the application; `DockLayout.from_h` restores it. `DockWorkspace`
+passes the active panel ID to `render:` and emits a new layout on tab changes.
+`on_detach` is a notification only; the application decides whether to open a
+window and remove the panel. A pointer drop in the outer 20% of a group splits it.
+`PropertyGrid` schema entries use `key`, optional `label`, `type` (`text`,
+`textarea`, `number`, `boolean`, `select`, `color`, `date`, `time`), `options` for
+select, and an optional `Validation`. Invalid edits remain in the control while
+the last valid value is retained. Both components expose terminal fallbacks.
+
 `Combobox` and `CommandPalette` default to case-insensitive substring matching in
 input order. Pass `matcher:` to either component, or set a default with
 `Zaniah.configure { |config| config.matcher = matcher }`. A matcher implements

data/docs/native.md

@@ -70,6 +70,41 @@ applications. macOS also preserves arbitrary MIME types under reversible
 Wayland use their native format mechanisms. Native clipboard exchange still
 depends on a running desktop session and should be checked on each target OS.
 
+## Typed drag and drop
+
+An element can declare the MIME types it accepts and optionally offer a drag
+source. `on_drag_over` returns `:copy`, `:move`, `:link`, or `:none`; the chosen
+operation must be offered by the source. A drop carries `Clipboard::Content`,
+its logical window position, and the operation. File drops also emit the older
+`Input::FileDrop` event so existing listeners continue to work.
+Offering `:move` requires `on_move:` to remove the source data; it runs once
+after a successful move, or when an X11 target acknowledges the `DELETE` selection.
+
+```ruby
+target.on_drop(types: ["image/png", "text/plain"]) do |drop, _cx|
+  insert(drop.content)
+end
+target.on_drag_over { |drag, _cx| drag.accepts?("image/png") ? :copy : :none }
+source.draggable do |_mouse, _cx|
+  Zaniah::DragData.new(items: [Zaniah::Clipboard::Item.new("text/plain" => "hello")], operations: [:copy])
+end
+```
+
+Headless records the source in `drag_history`; tests may call `drag_over` and
+`complete_drag` to deliver it deterministically. macOS uses AppKit dragging
+sessions; X11 uses XDND (Ctrl requests copy, Shift move, Ctrl+Shift link when
+offered); Wayland uses `wl_data_device`. A target needs `on_drop` and a matching
+MIME type before it can accept a drag. Wayland cannot offer
+link-only drags because its standard data-device action set has only copy and
+move. All desktop protocols depend on another application accepting the MIME
+type and operation. Windows currently preserves file drops through
+`WM_DROPFILES` compatibility and also uses OLE `IDataObject`/`IDropTarget` and
+`IDropSource` for typed data and native drag sources. A preview image is used
+on macOS; Windows, X11, and Wayland currently use the native default cursor
+without a custom preview. TUI has no cross-process drag protocol and only the
+in-process Headless test path.
+X11 XDND proxy windows are not supported.
+
 ## Window state and decorations
 
 `window.frame` uses logical screen coordinates; `window.state.to_h` can be saved

data/docs/tui.md

@@ -8,25 +8,32 @@ tests and non-window integrations.
 | --- | --- |
 | Label, Badge, Avatar | text, `[badge]`, `(initials)` |
 | Kbd | textual shortcut, such as `Ctrl+Shift+P`; multiple strokes are space-separated |
+| Alert | persistent `! title: message`; dismissed alerts disappear, live alerts announce through accessibility |
 | Icon | Unicode check/close/search/menu/info/warning symbol; unlabeled unknown icons are omitted |
 | Divider, Card | `─`/`│` and box-drawing characters |
 | Skeleton, Spinner, ProgressBar, Meter | shade cells, `◌`, or a ten-cell progress track; animation jumps to its terminal state |
 | Button, IconButton, ToggleButton | `[ label ]`; disabled uses `( label )` |
 | Checkbox, Radio, Switch | `[x]`, `(o)`, `[on ]` |
+| SegmentedControl | `[A\|(B)\|C]`, with the selected segment in parentheses; arrows move selection |
 | Slider, RangeSlider | ten-cell track and numeric value/range |
 | Text inputs | `[value]`; password values are masked and validation errors have `!` |
 | Select, Combobox, MultiSelect | labeled brackets, filtered menu marker, or comma-separated selected values |
 | DatePicker, TimePicker, ColorPicker | labeled ISO date, 24-hour time, or hex color in brackets |
+| Calendar, DateRangePicker | month grid with selected day in `[dd]`; picker shows `[start – end]`, with `…` for an unfinished range |
 | Tooltip, Popover, Menu, MenuBar, Dropdown | status text or a box/menu with `>` selection marker; nested menus expose a Back row |
+| HoverCard | content text while open; hidden while closed; focus uses the same open delay as hover |
 | Tabs, Accordion, Collapsible | selected tab in brackets and `[+]`/`[-]` disclosure markers |
 | ScrollView, Scrollbar | clipped child content and `│`/`─` track |
 | Breadcrumb, Pagination, bars | slash-separated path, page status, space-separated content |
 | Modal, Dialog, Drawer, CommandPalette | box-drawing overlay; palette filters results and supports Up/Down/Enter; focus stays inside until dismissed |
 | SplitPane, PaneGrid, Resizable, DockPanel | `│`/`─` separators, resize corner, or ordered dock regions |
+| ZoomPanView | zoom percentage and content text; focused `+`/`-`/`0` changes zoom, but pointer panning has no cell equivalent |
+| DockWorkspace | active tab in parentheses inside `[tabs]`, split groups separated by `│` or `───`; arrows select, Alt+arrows move and Ctrl+Shift+arrows split without dragging |
 | ListView | visible rows with `>` on the selected item |
 | Toast | live status text |
 | Table, DataGrid | header and visible rows separated with `|` |
 | TreeView | indentation with `▸`/`▾` expansion markers |
+| PropertyGrid | up to 20 `label: value` rows, with `!` and the validation message on errors; Up/Down/Page keys move the virtual row selection |
 | Sparkline and all chart types | eight-level Unicode sparkline summary |
 | Form, FormField | labeled values, `!` errors, and a submit button |
 | CodeEditor | numbered logical lines; wrap, syntax colors, and inline IME underline degrade to plain cells |

data/examples/gallery.rb

@@ -57,19 +57,43 @@ module Gallery
       .child(Zaniah::Div.new.flex_row.gap(12).children([
         Zaniah::UI::DatePicker.new("2026-09-13"), Zaniah::UI::TimePicker.new("14:30"),
         Zaniah::UI::ColorPicker.new("#2563eb")]))
+    feedback_dates = Zaniah::Div.new.w_full.gap(12)
+      .child(Zaniah::Div.new.flex_row.items_center.gap(16).children([
+        Zaniah::UI::SegmentedControl.new([["Day", :day], ["Week", :week], ["Month", :month]], value: :week),
+        Zaniah::UI::DateRangePicker.new(value: ["2026-09-01", "2026-09-30"])]))
+      .child(Zaniah::UI::Alert.new("Export complete", message: "Your file is ready", variant: :success, dismissible: true))
+      .child(Zaniah::UI::Calendar.new(value: "2026-09-24", week_start: 1))
+    dock_layout = Zaniah::UI::DockLayout.split(id: :work, orientation: :horizontal, ratio: 0.42,
+      first: Zaniah::UI::DockLayout.tabs(id: :left, panels: %i[Files Search]),
+      second: Zaniah::UI::DockLayout.tabs(id: :right, panels: %i[Editor Preview]))
+    property_schema = [
+      {key: :title, label: "Title", type: :text},
+      {key: :count, label: "Count", type: :number},
+      {key: :visible, label: "Visible", type: :boolean}
+    ]
     workspaces = Zaniah::Div.new.w_full.gap(12)
       .child(Zaniah::Div.new.flex_row.gap(12).children([
         Zaniah::UI::SplitPane.new(Zaniah::UI::Label.new("Left pane"), Zaniah::UI::Label.new("Right pane")).w(300).h(100),
         Zaniah::UI::Resizable.new(Zaniah::UI::Label.new("Resize me"), width: 180, height: 100),
         Zaniah::UI::ListView.new(%w[Alpha Beta Gamma Delta], height: 100, selected: 1).w(180)]))
-      .child(Zaniah::UI::DockPanel.new(
-        center: Zaniah::UI::Label.new("Editor"), top: Zaniah::UI::StatusBar.new(Zaniah::UI::Label.new("Top", size: :sm)),
-        left: Zaniah::UI::Sidebar.new(Zaniah::UI::Label.new("Files", size: :sm), width: 90),
-        bottom: Zaniah::UI::StatusBar.new(Zaniah::UI::Label.new("Ready", size: :sm))).w(420).h(120))
+      .child(Zaniah::Div.new.flex_row.gap(12).children([
+        Zaniah::UI::DockPanel.new(
+          center: Zaniah::UI::Label.new("Editor"), top: Zaniah::UI::StatusBar.new(Zaniah::UI::Label.new("Top", size: :sm)),
+          left: Zaniah::UI::Sidebar.new(Zaniah::UI::Label.new("Files", size: :sm), width: 90),
+          bottom: Zaniah::UI::StatusBar.new(Zaniah::UI::Label.new("Ready", size: :sm))).w(420).h(120),
+        Zaniah::UI::ZoomPanView.new(Zaniah::Div.new.w(110).h(70).p(8).bg("#2563eb")
+          .child(Zaniah::UI::Label.new("Zoom / pan", size: :sm)), zoom: 1.3).w(180).h(120)
+      ]))
+      .child(Zaniah::Div.new.flex_row.gap(12).children([
+        Zaniah::UI::DockWorkspace.new(dock_layout,
+          render: ->(id) { Zaniah::Div.new.p(10).child(Zaniah::UI::Label.new("#{id} panel")) }).w(440).h(190),
+        Zaniah::UI::PropertyGrid.new(property_schema,
+          {title: "Workspace", count: 3, visible: true}, height: 190).w(340)
+      ]))
     editors = Zaniah::Div.new.w_full.flex_row.gap(12).children([
       Zaniah::UI::CodeEditor.new("def hello\n  :world\nend\n", language: :ruby).w(390).h(150),
       Zaniah::UI::RichText.new([{text: "Rich ", size: 20}, {text: "text", color: "#2563eb", size: 20}]).w(260)])
-    Zaniah::Div.new.h(2480).p(16).gap(12)
+    Zaniah::Div.new.h(3200).p(16).gap(12)
       .child(section("Foundation", foundation, height: 180))
       .child(section("Actions",
         Zaniah::UI::Button.new("Primary").icon(:check).on_click(&clicks),
@@ -94,7 +118,8 @@ module Gallery
       .child(section("Variants", variants, height: 285))
       .child(section("Data", data, height: 440))
       .child(section("Choice and pickers", choices, height: 210))
-      .child(section("Workspace layout", workspaces, height: 300))
+      .child(section("Feedback and dates", feedback_dates, height: 410))
+      .child(section("Workspace layout", workspaces, height: 530))
       .child(section("Editors", editors, height: 210))
       .child(section("Forms", Zaniah::UI::Form.new.field(name: :email, label: "Release email", value: "ruby@example.com", validation: validation).w(320), height: 150))
   end
@@ -110,6 +135,7 @@ module Gallery
     when /\Atoast-(info|success|warning|danger)\z/ then Zaniah::UI::Toast.new("Saved", variant: Regexp.last_match(1).to_sym)
     when "tooltip" then Zaniah::UI::Tooltip.new("Helpful text", anchor: anchor)
     when "popover" then Zaniah::UI::Popover.new(content, anchor: anchor)
+    when "hover-card" then Zaniah::UI::HoverCard.new(Zaniah::UI::Label.new("Keyboard shortcuts"), anchor: anchor).open
     when "menu" then Zaniah::UI::Menu.new(items, anchor: Zaniah::Point.new(anchor.x, anchor.bottom))
     when "context-menu" then Zaniah::UI::ContextMenu.new(items, anchor: Zaniah::Point.new(anchor.x, anchor.bottom))
     when "modal" then Zaniah::UI::Modal.new(content, title: "Modal")

data/lib/zaniah/clipboard.rb

@@ -37,4 +37,27 @@ module Zaniah
     class Content < Item
     end
   end
+
+  class DragData
+    OPERATIONS = %i[copy move link].freeze
+    attr_reader :items, :image, :operations, :on_move
+
+    def initialize(items:, image: nil, operations: [:copy], on_move: nil)
+      raise TypeError, "drag items must be an Array of Clipboard::Item" unless items.is_a?(Array) && !items.empty? && items.all? { |item| item.is_a?(Clipboard::Item) }
+      raise ArgumentError, "invalid drag operations" unless operations.is_a?(Array) && !operations.empty? && operations.all? { |operation| OPERATIONS.include?(operation) }
+      raise ArgumentError, "move operations require an on_move callback" if operations.include?(:move) && !on_move.respond_to?(:call)
+      @items, @image, @operations, @on_move = items.dup.freeze, image, operations.uniq.freeze, on_move
+      freeze
+    end
+
+    def types = @items.flat_map(&:types).uniq.freeze
+    def content(types: self.types)
+      raise TypeError, "drag types must be an Array" unless types.is_a?(Array)
+      formats = types.each_with_object({}) do |type, result|
+        item = @items.find { |entry| entry.types.include?(type) }
+        result[type] = item.fetch(type) if item
+      end
+      Clipboard::Content.new(formats)
+    end
+  end
 end

data/lib/zaniah/element.rb

@@ -105,9 +105,26 @@ module Zaniah
       define_method(method) { |value| style(**{property => value}) }
     end
 
-    %i[click hover drag scroll_wheel mouse_down mouse_up].each do |kind|
+    %i[click hover drag scroll_wheel magnify mouse_down mouse_up].each do |kind|
       define_method("on_#{kind}") { |&block| @handlers[kind] = block; self }
     end
+    def on_drop(types:, &block)
+      raise TypeError, "drop types must be an Array of MIME names" unless types.is_a?(Array) && !types.empty? && types.all? { |type| type.is_a?(String) && type.match?(%r{\A[^\s/]+/[^\s/]+\z}) }
+      raise ArgumentError, "drop handler required" unless block
+      @drop_types, @handlers[:drop] = types.uniq.freeze, block
+      self
+    end
+    def on_drag_over(&block)
+      raise ArgumentError, "drag-over handler required" unless block
+      @handlers[:drag_over] = block
+      self
+    end
+    def draggable(&block)
+      raise ArgumentError, "drag source required" unless block
+      @drag_source = block
+      self
+    end
+    def drop_types = @drop_types || []
 
     def request_layout(cx)
       @state = cx.state(@key, &@state_initializer) if @key && @state_initializer
@@ -159,8 +176,31 @@ module Zaniah
         @focus_handle.focusable = !@static_flags.include?(:disabled)
         cx.dispatcher.register_focus(@focus_handle)
       end
-      unless @handlers.empty? && !@tooltip && !@context_menu && !@style_set.interactive? && !@focus_handle && !@window_drag_region && !@window_control_kind
+      unless @handlers.empty? && !@tooltip && !@context_menu && !@style_set.interactive? && !@focus_handle && !@window_drag_region && !@window_control_kind && !@drag_source
         cx.dispatcher.hit(bounds, owner: self) do |event|
+          if @pending_drag && event.is_a?(Input::MouseMove)
+            original = @pending_drag
+            if (event.position.x - original.position.x).abs >= 4 || (event.position.y - original.position.y).abs >= 4
+              @pending_drag = nil
+              cx.dispatcher.release_mouse_capture
+              cx.window.begin_drag(@drag_source.call(original, cx), event: original)
+              next true
+            end
+          end
+          @pending_drag = nil if event.is_a?(Input::MouseUp)
+          if event.is_a?(Input::DragOver)
+            next false unless @handlers[:drop] && @drop_types.any? { |type| event.accepts?(type) }
+            operation = @handlers[:drag_over]&.call(event, cx)
+            operation ||= event.operations.first
+            operation = :none unless event.operations.include?(operation)
+            event.operation = operation
+            next operation != :none
+          end
+          if event.is_a?(Input::DataDrop)
+            next false unless @handlers[:drop] && @drop_types.any? { |type| event.content.types.include?(type) }
+            @handlers[:drop].call(event, cx)
+            next true
+          end
           if event.is_a?(Input::MouseDown) && event.button == :right && @context_menu
             cx.window.context_menu(@context_menu, position: event.position)
             next true
@@ -172,11 +212,16 @@ module Zaniah
           when Input::MouseMove then @dragging && @handlers.key?(:drag) ? :drag : :hover
           when Input::MouseUp then :mouse_up
           when Input::ScrollWheel then :scroll_wheel
+          when Input::Magnify then :magnify
           end
           handler = @handlers[kind]
           @dragging = true if event.is_a?(Input::MouseDown) && @handlers[:drag]
           @dragging = false if event.is_a?(Input::MouseUp)
           handler&.call(event, cx)
+          if event.is_a?(Input::MouseDown) && event.button == :left && @drag_source
+            @pending_drag = event
+            next :capture
+          end
           @dragging && event.is_a?(Input::MouseDown) ? :capture : !!handler || !!(@focus_handle && event.is_a?(Input::MouseDown)) || !!(@tooltip && event.is_a?(Input::MouseMove))
         end
       end

data/lib/zaniah/input/data_drop.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Zaniah
+  module Input
+    DataDrop = Data.define(:content, :position, :operation)
+
+    class DragOver
+      OPERATIONS = %i[copy move link none].freeze
+      attr_reader :types, :position, :operations, :operation
+
+      def initialize(types:, position:, operations: [:copy])
+        raise TypeError, "drag types must be an Array of MIME names" unless types.is_a?(Array) && types.all? { |type| type.is_a?(String) }
+        raise TypeError, "drag position must be a Point" unless position.is_a?(Point)
+        raise ArgumentError, "invalid drag operations" unless operations.is_a?(Array) && operations.all? { |operation| OPERATIONS.include?(operation) && operation != :none }
+        @types, @position, @operations, @operation = types.uniq.freeze, position, operations.uniq.freeze, :none
+      end
+
+      def accepts?(type) = @types.include?(type)
+      def operation=(value)
+        raise ArgumentError, "unsupported drag operation #{value.inspect}" unless value == :none || @operations.include?(value)
+        @operation = value
+      end
+    end
+  end
+end

data/lib/zaniah/input/dispatcher.rb

@@ -119,6 +119,7 @@ module Zaniah
         @focus_tree.clear
         @transforms.replace([Transform.identity])
       end
+      def release_mouse_capture = @capture = nil
       def hits = @hits.map { |bounds, _, owner, _, clip| Hit.new(clip ? bounds.intersect(clip) : bounds, owner) }.freeze
       def hit_regions = @hits.map { |bounds, _, owner, transform, clip| HitRegion.new(bounds, owner, transform, clip) }.freeze
 

data/lib/zaniah/input/keymap.rb

@@ -91,6 +91,27 @@ module Zaniah
             .bind("home", :first, context: "in_grid")
             .bind("end", :last, context: "in_grid")
             .bind("enter", :activate, context: "in_grid")
+            .bind("left", :previous_day, context: "in_calendar")
+            .bind("right", :next_day, context: "in_calendar")
+            .bind("up", :previous_week, context: "in_calendar")
+            .bind("down", :next_week, context: "in_calendar")
+            .bind("pageup", :previous_month, context: "in_calendar")
+            .bind("pagedown", :next_month, context: "in_calendar")
+            .bind("left", :previous_option, context: "in_dock")
+            .bind("right", :next_option, context: "in_dock")
+            .bind("home", :first, context: "in_dock")
+            .bind("end", :last, context: "in_dock")
+            .bind("alt-left", :move_previous, context: "in_dock")
+            .bind("alt-right", :move_next, context: "in_dock")
+            .bind("ctrl-shift-left", :split_left, context: "in_dock")
+            .bind("ctrl-shift-right", :split_right, context: "in_dock")
+            .bind("ctrl-shift-up", :split_top, context: "in_dock")
+            .bind("ctrl-shift-down", :split_bottom, context: "in_dock")
+            .bind("ctrl-shift-d", :detach, context: "in_dock")
+            .bind("+", :zoom_in, context: "in_zoom_pan && !in_text_field")
+            .bind("shift-=", :zoom_in, context: "in_zoom_pan && !in_text_field")
+            .bind("-", :zoom_out, context: "in_zoom_pan && !in_text_field")
+            .bind("0", :zoom_reset, context: "in_zoom_pan && !in_text_field")
             .bind("up", :previous_option, context: "in_combobox")
             .bind("down", :next_option, context: "in_combobox")
             .bind("home", :first, context: "in_combobox")

data/lib/zaniah/input/magnify.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Zaniah
+  module Input
+    Magnify = Data.define(:position, :delta, :phase)
+  end
+end

data/lib/zaniah/input.rb

@@ -7,8 +7,10 @@ require_relative "input/mouse_down"
 require_relative "input/mouse_up"
 require_relative "input/mouse_move"
 require_relative "input/scroll_wheel"
+require_relative "input/magnify"
 require_relative "input/composition"
 require_relative "input/file_drop"
+require_relative "input/data_drop"
 require_relative "input/keystroke"
 require_relative "input/context_predicate"
 require_relative "input/keymap"

data/lib/zaniah/platform/headless/window.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "uri"
+
 module Zaniah
   module Platform
     module Headless
@@ -9,7 +11,7 @@ module Zaniah
         include Appearance
         DEFAULT_CLEAR = "#181b20"
 
-        attr_reader :content_size, :scene, :device, :dispatcher, :scale_factor, :text_runs, :pointer_position, :cursor_style, :animator, :clock, :accessibility_tree, :accessibility_revision, :frame_stats, :last_root, :frame_number, :decorations, :transparent, :min_size, :resizable, :traffic_lights
+        attr_reader :content_size, :scene, :device, :dispatcher, :scale_factor, :text_runs, :pointer_position, :cursor_style, :animator, :clock, :accessibility_tree, :accessibility_revision, :frame_stats, :last_root, :frame_number, :decorations, :transparent, :min_size, :resizable, :traffic_lights, :drag_data, :drag_result, :drag_history
         attr_accessor :text_system, :ime_state, :title, :app, :devtools
 
         def initialize(width: 800, height: 600, title: "Zaniah UI", scale_factor: 1,
@@ -34,6 +36,7 @@ module Zaniah
           @window_frame = Bounds.new(0, 0, width, height)
           @maximized = @minimized = @fullscreen = @always_on_top = false
           @dirty, @closed, @pointer_down, @cursor_style = true, false, false, :arrow
+          @drag_history = []
         end
 
         def on_input(&block) = @on_input = block
@@ -80,6 +83,70 @@ module Zaniah
           write_clipboard([Clipboard::Item.new("text/plain" => value)])
           value
         end
+        def begin_drag(data, event: nil)
+          raise TypeError, "drag source must return DragData" unless data.is_a?(DragData)
+          @drag_data, @drag_result = data, nil
+          @drag_move_committed = false
+          @drag_history << [:begin, data, event].freeze
+          data
+        end
+
+        def drag_over(types:, position:, operations: [:copy])
+          event = Input::DragOver.new(types: types, position: position, operations: operations)
+          @dispatcher.mouse(event)
+          event.operation
+        end
+
+        def deliver_drop(content:, position:, operation: :copy, paths: nil)
+          raise TypeError, "drop content must be Clipboard::Content" unless content.is_a?(Clipboard::Content)
+          raise TypeError, "drop position must be a Point" unless position.is_a?(Point)
+          raise ArgumentError, "invalid drop operation" unless DragData::OPERATIONS.include?(operation)
+          handled = input(Input::DataDrop.new(content, position, operation))
+          paths ||= file_paths_in_drop(content)
+          input(Input::FileDrop.new(paths.freeze, position)) unless paths.empty?
+          handled ? operation : :none
+        end
+
+        def complete_drag(position:, operation: nil, content: nil)
+          raise Error, "no drag is active" unless @drag_data
+          data = @drag_data
+          operation ||= drag_over(types: data.types, position: position, operations: data.operations)
+          raise ArgumentError, "drag operation was not offered" unless operation == :none || data.operations.include?(operation)
+          operation = deliver_drop(content: content || data.content, position: position, operation: operation) unless operation == :none
+          finish_drag_source(operation, position: position)
+        end
+
+        def finish_drag_source(operation, position: nil)
+          raise ArgumentError, "drag operation was not offered" unless operation == :none || @drag_data&.operations&.include?(operation)
+          operation = :none if operation == :move && !commit_drag_move
+          @drag_result = operation
+          @drag_history << [:complete, operation, position].freeze
+          @drag_data = nil
+          operation
+        end
+
+        def commit_drag_move
+          return false unless @drag_data&.on_move
+          return true if @drag_move_committed
+          @drag_data.on_move.call
+          @drag_move_committed = true
+        rescue StandardError
+          false
+        end
+
+        def file_paths_in_drop(content)
+          source = content.formats["text/uri-list"]
+          return [] unless source
+          source.each_line.filter_map do |line|
+            next if line.start_with?("#") || line.strip.empty?
+            uri = URI.parse(line.strip)
+            next unless uri.scheme == "file" && [nil, "", "localhost"].include?(uri.host) && uri.query.nil? && uri.fragment.nil?
+            path = URI::DEFAULT_PARSER.unescape(uri.path).force_encoding(Encoding::UTF_8)
+            path if path.start_with?("/") && path.valid_encoding? && !path.include?("\0")
+          rescue URI::InvalidURIError
+            nil
+          end
+        end
         def set_cursor(style)
           raise ArgumentError, "unknown cursor #{style}" unless %i[arrow text pointer crosshair resize_horizontal resize_vertical].include?(style)
           return style if @cursor_style == style
@@ -224,7 +291,7 @@ module Zaniah
           @tooltip = nil if event.is_a?(Input::MouseDown) || event.is_a?(Input::KeyDown)
           @on_input&.call(event)
           @devtools&.handle_input(event)
-          if event.respond_to?(:position)
+          handled = if event.respond_to?(:position)
             @dispatcher.mouse(event)
           elsif event.is_a?(Input::KeyDown)
             @dispatcher.key(event.keystroke)
@@ -233,6 +300,7 @@ module Zaniah
           end
           @tooltip = nil if event.is_a?(Input::MouseMove) && !@tooltip_offered
           request_frame
+          handled
         end
 
         def offer_tooltip(text, position:, delay: 0.5)