rori 0.1.0

data/lib/rori.rb

@@ -0,0 +1,180 @@
+require "rails"
+require "turbo-rails"
+require "stimulus-rails"
+require "importmap-rails"
+require "propshaft"
+require "haml"
+
+require "rori/version"
+require "rori/engine"
+
+# The desk: a niri-style window manager for Rails pages (tiled turbo-frame
+# windows, ⌘K palette and terminal, Ghostty themes). A Rails engine; see the
+# README for wiring it into a host app. Configure in an initializer:
+#
+#   Rori.configure do |desk|
+#     desk.records = %w[ User Project ]
+#     desk.hover_keys = true
+#   end
+module Rori
+  # Shown in the menubar and the <title> of the bare desk.
+  mattr_accessor :app_name, default: "Rori"
+
+  # Model class names whose most recent records are listed in ⌘K.
+  mattr_accessor :records, default: []
+  mattr_accessor :record_limit, default: 25
+
+  # Extra palette entries: callables returning Rori::Command(s), evaluated on
+  # every palette open (so they can list fresh data).
+  mattr_accessor :commands, default: []
+
+  # Server-side commands registered with `Rori.command`, by name.
+  Runnable = Data.define(:name, :confirm, :block) do
+    def label = I18n.t(name, scope: "rori.commands.custom")
+
+    def call = block.call
+  end
+  mattr_accessor :runnables, default: {}
+
+  # `Rori.notify` broadcasts here; every open desk subscribes (turbo_stream_from).
+  mattr_accessor :notifications_stream, default: "rori_notifications"
+
+  # Ghostty themes compiled by `bin/rails rori:themes:build`; both default to
+  # the ones bundled with the gem (paths resolve lazily, after boot).
+  mattr_writer :themes_directory, :themes_stylesheet
+  mattr_accessor :theme_cookie, default: "theme"
+
+  # The app's own Ghostty theme files (a directory, relative to Rails.root or
+  # absolute), listed alongside the bundled ones; same name replaces a bundled
+  # theme. No build step: their CSS is rendered into the shell.
+  mattr_accessor :themes_folder
+
+  # Optional background photos (off by default): a random one per page load,
+  # unless one is pinned (UI › Wallpaper › Pin).
+  mattr_accessor :wallpapers, default: false
+  mattr_writer :wallpapers_file
+  mattr_accessor :wallpaper_cookie, default: "wallpaper"
+  mattr_accessor :wallpaper_pin_cookie, default: "wallpaper_pin"
+
+  # UI › Menu bar (top | bottom) and the dismissible empty-desk hint.
+  mattr_accessor :bars_cookie, default: "bars"
+  mattr_accessor :hint_cookie, default: "hint"
+
+  # The app's own wallpapers: a folder in its asset path (e.g. "wallpapers" for
+  # app/assets/images/wallpapers). When set, its images replace the bundled
+  # Unsplash photos.
+  mattr_accessor :wallpapers_folder
+
+  def self.themes_directory = @@themes_directory || Engine.root.join("vendor/themes/ghostty")
+
+  def self.themes_stylesheet = @@themes_stylesheet || Engine.root.join("app/assets/stylesheets/rori/themes.css")
+
+  def self.wallpapers_file = @@wallpapers_file || Engine.root.join("vendor/wallpapers/unsplash.yml")
+
+  # The terminal (⌘K as a command line) opens with this bare key outside text
+  # fields — KeyboardEvent#code, like the keymap — and with `toggle_terminal`.
+  mattr_accessor :terminal_key, default: "Backquote"
+
+  # Keyboard: desk action (rori_controller.js#perform) → key chords, written as
+  # `KeyboardEvent#code` names joined with modifiers. `Mod` stands for
+  # `Rori.modifier` — Alt in the browser, where ⌘ combos belong to the browser;
+  # a native shell (e.g. Tauri) can switch to Meta. `Digit*` binds 1–9 to the
+  # nth workspace. Chords never fire inside text fields; Esc leaves the field.
+  MODIFIERS = { "Alt" => "⌥", "Meta" => "⌘", "Control" => "⌃" }.freeze
+  mattr_accessor :modifier, default: "Alt"
+
+  # The native shell (src-tauri) marks its webview's user agent; there ⌘ combos
+  # aren't taken by a browser, so pages rendered for it use `native_modifier`.
+  mattr_accessor :native_user_agent, default: "RoriApp"
+  mattr_accessor :native_modifier, default: "Meta"
+
+  # Per-modifier replacements for chords the platform already owns: with ⌘,
+  # ⌘C is Copy in the native Edit menu, which fires before the page sees it.
+  mattr_accessor :keymap_overrides, default: {
+    "Meta" => { center_column: %w[ Mod+Shift+KeyC ] }
+  }.freeze
+  mattr_accessor :keymap, default: {
+    focus_left: %w[ Mod+ArrowLeft Mod+KeyH ],
+    focus_right: %w[ Mod+ArrowRight Mod+KeyL ],
+    focus_up: %w[ Mod+ArrowUp Mod+KeyK ],
+    focus_down: %w[ Mod+ArrowDown Mod+KeyJ ],
+    move_left: %w[ Mod+Shift+ArrowLeft Mod+Shift+KeyH ],
+    move_right: %w[ Mod+Shift+ArrowRight Mod+Shift+KeyL ],
+    move_up: %w[ Mod+Shift+ArrowUp Mod+Shift+KeyK ],
+    move_down: %w[ Mod+Shift+ArrowDown Mod+Shift+KeyJ ],
+    switch_to_workspace: %w[ Mod+Digit* ],
+    move_to_workspace: %w[ Mod+Shift+Digit* ],
+    consume_left: %w[ Mod+BracketLeft ],
+    consume_right: %w[ Mod+BracketRight ],
+    cycle_width: %w[ Mod+KeyR ],
+    full_width: %w[ Mod+KeyF ],
+    center_column: %w[ Mod+KeyC ],
+    overview: %w[ Mod+KeyO ],
+    close_window: %w[ Mod+KeyW ],
+    reopen_window: %w[ Mod+Shift+KeyT ],
+    toggle_terminal: %w[ Mod+Backquote ],
+    shortcuts: %w[ Mod+Shift+Slash ]
+  }.freeze
+
+  # Bare keys (opt-in). Blender-style: once the pointer deliberately moves onto
+  # an inactive window, they act on that window without taking focus — even
+  # while you're typing in a field elsewhere — until the pointer rests for
+  # `hover_timeout` seconds, leaves, or another key is typed. Otherwise, when
+  # no field has focus, they act on the focused window.
+  # No hjkl/arrows here: they'd shadow text entry and page scrolling.
+  mattr_accessor :hover_keys, default: false
+  mattr_accessor :hover_timeout, default: 1.5
+  mattr_accessor :hover_keymap, default: {
+    close_window: %w[ KeyW ],
+    reopen_window: %w[ KeyU ],
+    cycle_width: %w[ KeyR ],
+    full_width: %w[ KeyF ],
+    center_column: %w[ KeyC ],
+    consume_left: %w[ BracketLeft ],
+    consume_right: %w[ BracketRight ],
+    move_left: %w[ Shift+KeyH ],
+    move_right: %w[ Shift+KeyL ],
+    switch_to_workspace: %w[ Digit* ],
+    move_to_workspace: %w[ Shift+Digit* ]
+  }.freeze
+
+  class << self
+    def configure = yield(self)
+
+    # A command that runs on the server, listed in ⌘K and the terminal under
+    # Run and labelled by `rori.commands.custom.<name>` in the app's locale:
+    #
+    #   rori.command :reindex_search, confirm: true do
+    #     SearchReindexJob.perform_later
+    #     "Reindexing…"
+    #   end
+    #
+    # The block runs inside the request, so hand slow work to a job (which can
+    # `Rori.notify` when it's done). A String it returns becomes the
+    # notification's text. `confirm: true` asks first: ↵ twice in ⌘K, y in the
+    # terminal.
+    def command(name, confirm: false, &block)
+      runnables[name.to_s] = Runnable.new(name: name.to_s, confirm:, block:)
+    end
+
+    # A notification in the corner of every open desk, e.g. from a job:
+    #   Rori.notify "Search reindexed", "1,204 records", kind: :success
+    def notify(title, body = nil, kind: :info) = Notification.new(title:, body:, kind:).broadcast
+
+    # The keymap with `Mod` spelled out, as rori_controller.js matches it.
+    def resolved_keymap(modifier = self.modifier)
+      raise ArgumentError, "Rori modifier must be one of #{MODIFIERS.keys.join(", ")}" unless MODIFIERS.key?(modifier)
+
+      keymap.merge(keymap_overrides.fetch(modifier, {}))
+        .transform_values { |chords| Array(chords).map { it.sub(/\AMod\+/, "#{modifier}+") } }
+    end
+
+    def modifier_symbol(modifier = self.modifier) = MODIFIERS.fetch(modifier)
+
+    def native?(user_agent) = user_agent.to_s.include?(native_user_agent)
+
+    def modifier_for(user_agent) = native?(user_agent) ? native_modifier : modifier
+
+    def resolved_hover_keymap = hover_keys ? hover_keymap : {}
+  end
+end

data/lib/tasks/rori.rake

@@ -0,0 +1,9 @@
+namespace :rori do
+  namespace :themes do
+    desc "Compile Rori.themes_directory (Ghostty themes) into Rori.themes_stylesheet"
+    task build: :environment do
+      Rori.themes_stylesheet.write(Rori::Theme.stylesheet)
+      puts "Wrote #{Rori::Theme.all.size} themes to #{Rori.themes_stylesheet.relative_path_from(Rails.root)}"
+    end
+  end
+end

data/vendor/themes/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2011 to Present Mark Badolato
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This license covers the iTerm-Color-Schemes repository collection of themes. 
+
+The copyright/license for each individual theme belongs to the author of that theme.

data/vendor/themes/ghostty/Catppuccin Latte

@@ -0,0 +1,22 @@
+palette = 0=#bcc0cc
+palette = 1=#d20f39
+palette = 2=#40a02b
+palette = 3=#df8e1d
+palette = 4=#1e66f5
+palette = 5=#ea76cb
+palette = 6=#179299
+palette = 7=#5c5f77
+palette = 8=#acb0be
+palette = 9=#e7103f
+palette = 10=#46b02f
+palette = 11=#e49931
+palette = 12=#3878f6
+palette = 13=#ef95d7
+palette = 14=#19a1a8
+palette = 15=#6c6f85
+background = #eff1f5
+foreground = #4c4f69
+cursor-color = #dc8a78
+cursor-text = #eff1f5
+selection-background = #dc8a78
+selection-foreground = #eff1f5

data/vendor/themes/ghostty/Catppuccin Mocha

@@ -0,0 +1,22 @@
+palette = 0=#45475a
+palette = 1=#f38ba8
+palette = 2=#a6e3a1
+palette = 3=#f9e2af
+palette = 4=#89b4fa
+palette = 5=#f5c2e7
+palette = 6=#94e2d5
+palette = 7=#bac2de
+palette = 8=#585b70
+palette = 9=#f7aec2
+palette = 10=#c2ecbf
+palette = 11=#fcd682
+palette = 12=#aeccfc
+palette = 13=#f398da
+palette = 14=#b1eae1
+palette = 15=#a6adc8
+background = #1e1e2e
+foreground = #cdd6f4
+cursor-color = #f5e0dc
+cursor-text = #1e1e2e
+selection-background = #f5e0dc
+selection-foreground = #1e1e2e

data/vendor/themes/ghostty/Everforest Dark Med

@@ -0,0 +1,22 @@
+palette = 0=#7a8478
+palette = 1=#e67e80
+palette = 2=#a7c080
+palette = 3=#dbbc7f
+palette = 4=#7fbbb3
+palette = 5=#d699b6
+palette = 6=#83c092
+palette = 7=#f2efdf
+palette = 8=#a6b0a0
+palette = 9=#f85552
+palette = 10=#8da101
+palette = 11=#dfa000
+palette = 12=#3a94c5
+palette = 13=#df69ba
+palette = 14=#35a77c
+palette = 15=#fffbef
+background = #232a2e
+foreground = #d3c6aa
+cursor-color = #e69875
+cursor-text = #543a48
+selection-background = #543a48
+selection-foreground = #d3c6aa

data/vendor/themes/ghostty/Flexoki Light

@@ -0,0 +1,22 @@
+palette = 0=#100f0f
+palette = 1=#af3029
+palette = 2=#66800b
+palette = 3=#ad8301
+palette = 4=#205ea6
+palette = 5=#a02f6f
+palette = 6=#24837b
+palette = 7=#6f6e69
+palette = 8=#b7b5ac
+palette = 9=#d14d41
+palette = 10=#879a39
+palette = 11=#d0a215
+palette = 12=#4385be
+palette = 13=#ce5d97
+palette = 14=#3aa99f
+palette = 15=#cecdc3
+background = #fffcf0
+foreground = #100f0f
+cursor-color = #100f0f
+cursor-text = #fffcf0
+selection-background = #cecdc3
+selection-foreground = #100f0f

data/vendor/themes/ghostty/GitHub Dark Dimmed

@@ -0,0 +1,22 @@
+palette = 0=#545d68
+palette = 1=#f47067
+palette = 2=#57ab5a
+palette = 3=#c69026
+palette = 4=#539bf5
+palette = 5=#b083f0
+palette = 6=#39c5cf
+palette = 7=#909dab
+palette = 8=#636e7b
+palette = 9=#ff938a
+palette = 10=#6bc46d
+palette = 11=#daaa3f
+palette = 12=#6cb6ff
+palette = 13=#dcbdfb
+palette = 14=#56d4dd
+palette = 15=#cdd9e5
+background = #22272e
+foreground = #adbac7
+cursor-color = #539bf5
+cursor-text = #93dbff
+selection-background = #adbac7
+selection-foreground = #22272e

data/vendor/themes/ghostty/Gruvbox Material Dark

@@ -0,0 +1,22 @@
+palette = 0=#282828
+palette = 1=#ea6962
+palette = 2=#a9b665
+palette = 3=#d8a657
+palette = 4=#7daea3
+palette = 5=#d3869b
+palette = 6=#89b482
+palette = 7=#d4be98
+palette = 8=#7c6f64
+palette = 9=#ea6962
+palette = 10=#a9b665
+palette = 11=#d8a657
+palette = 12=#7daea3
+palette = 13=#d3869b
+palette = 14=#89b482
+palette = 15=#ddc7a1
+background = #282828
+foreground = #d4be98
+cursor-color = #d4be98
+cursor-text = #282828
+selection-background = #d4be98
+selection-foreground = #282828

data/vendor/themes/ghostty/Kanagawa Wave

@@ -0,0 +1,22 @@
+palette = 0=#090618
+palette = 1=#c34043
+palette = 2=#76946a
+palette = 3=#c0a36e
+palette = 4=#7e9cd8
+palette = 5=#957fb8
+palette = 6=#6a9589
+palette = 7=#c8c093
+palette = 8=#727169
+palette = 9=#e82424
+palette = 10=#98bb6c
+palette = 11=#e6c384
+palette = 12=#7fb4ca
+palette = 13=#938aa9
+palette = 14=#7aa89f
+palette = 15=#dcd7ba
+background = #1f1f28
+foreground = #dcd7ba
+cursor-color = #dcd7ba
+cursor-text = #1f1f28
+selection-background = #dcd7ba
+selection-foreground = #1f1f28

data/vendor/themes/ghostty/Melange Dark

@@ -0,0 +1,22 @@
+palette = 0=#34302c
+palette = 1=#bd8183
+palette = 2=#78997a
+palette = 3=#e49b5d
+palette = 4=#7f91b2
+palette = 5=#b380b0
+palette = 6=#7b9695
+palette = 7=#c1a78e
+palette = 8=#867462
+palette = 9=#d47766
+palette = 10=#85b695
+palette = 11=#ebc06d
+palette = 12=#a3a9ce
+palette = 13=#cf9bc2
+palette = 14=#89b3b6
+palette = 15=#ece1d7
+background = #292522
+foreground = #ece1d7
+cursor-color = #ece1d7
+cursor-text = #292522
+selection-background = #ece1d7
+selection-foreground = #403a36

data/vendor/themes/ghostty/Nord

@@ -0,0 +1,22 @@
+palette = 0=#3b4252
+palette = 1=#bf616a
+palette = 2=#a3be8c
+palette = 3=#ebcb8b
+palette = 4=#81a1c1
+palette = 5=#b48ead
+palette = 6=#88c0d0
+palette = 7=#e5e9f0
+palette = 8=#596377
+palette = 9=#bf616a
+palette = 10=#a3be8c
+palette = 11=#ebcb8b
+palette = 12=#81a1c1
+palette = 13=#b48ead
+palette = 14=#8fbcbb
+palette = 15=#eceff4
+background = #2e3440
+foreground = #d8dee9
+cursor-color = #eceff4
+cursor-text = #282828
+selection-background = #eceff4
+selection-foreground = #4c566a

data/vendor/themes/ghostty/Rose Pine Dawn

@@ -0,0 +1,22 @@
+palette = 0=#f2e9e1
+palette = 1=#b4637a
+palette = 2=#286983
+palette = 3=#ea9d34
+palette = 4=#56949f
+palette = 5=#907aa9
+palette = 6=#d7827e
+palette = 7=#575279
+palette = 8=#9893a5
+palette = 9=#b4637a
+palette = 10=#286983
+palette = 11=#ea9d34
+palette = 12=#56949f
+palette = 13=#907aa9
+palette = 14=#d7827e
+palette = 15=#575279
+background = #faf4ed
+foreground = #575279
+cursor-color = #575279
+cursor-text = #faf4ed
+selection-background = #dfdad9
+selection-foreground = #575279

data/vendor/themes/ghostty/Rose Pine Moon

@@ -0,0 +1,22 @@
+palette = 0=#393552
+palette = 1=#eb6f92
+palette = 2=#3e8fb0
+palette = 3=#f6c177
+palette = 4=#9ccfd8
+palette = 5=#c4a7e7
+palette = 6=#ea9a97
+palette = 7=#e0def4
+palette = 8=#6e6a86
+palette = 9=#eb6f92
+palette = 10=#3e8fb0
+palette = 11=#f6c177
+palette = 12=#9ccfd8
+palette = 13=#c4a7e7
+palette = 14=#ea9a97
+palette = 15=#e0def4
+background = #232136
+foreground = #e0def4
+cursor-color = #e0def4
+cursor-text = #232136
+selection-background = #44415a
+selection-foreground = #e0def4

data/vendor/themes/ghostty/TokyoNight Storm

@@ -0,0 +1,22 @@
+palette = 0=#1d202f
+palette = 1=#f7768e
+palette = 2=#9ece6a
+palette = 3=#e0af68
+palette = 4=#7aa2f7
+palette = 5=#bb9af7
+palette = 6=#7dcfff
+palette = 7=#a9b1d6
+palette = 8=#4e5575
+palette = 9=#f7768e
+palette = 10=#9ece6a
+palette = 11=#e0af68
+palette = 12=#7aa2f7
+palette = 13=#bb9af7
+palette = 14=#7dcfff
+palette = 15=#c0caf5
+background = #24283b
+foreground = #c0caf5
+cursor-color = #c0caf5
+cursor-text = #1d202f
+selection-background = #364a82
+selection-foreground = #c0caf5

data/vendor/themes/ghostty/Tomorrow Night Eighties

@@ -0,0 +1,22 @@
+palette = 0=#000000
+palette = 1=#f2777a
+palette = 2=#99cc99
+palette = 3=#ffcc66
+palette = 4=#6699cc
+palette = 5=#cc99cc
+palette = 6=#66cccc
+palette = 7=#ffffff
+palette = 8=#595959
+palette = 9=#f2777a
+palette = 10=#99cc99
+palette = 11=#ffcc66
+palette = 12=#6699cc
+palette = 13=#cc99cc
+palette = 14=#66cccc
+palette = 15=#ffffff
+background = #2d2d2d
+foreground = #cccccc
+cursor-color = #cccccc
+cursor-text = #2d2d2d
+selection-background = #515151
+selection-foreground = #cccccc

data/vendor/themes/ghostty/Zenbones Light

@@ -0,0 +1,22 @@
+palette = 0=#f0edec
+palette = 1=#a8334c
+palette = 2=#4f6c31
+palette = 3=#944927
+palette = 4=#286486
+palette = 5=#88507d
+palette = 6=#3b8992
+palette = 7=#2c363c
+palette = 8=#b5a7a0
+palette = 9=#94253e
+palette = 10=#3f5a22
+palette = 11=#803d1c
+palette = 12=#1d5573
+palette = 13=#7b3b70
+palette = 14=#2b747c
+palette = 15=#4f5e68
+background = #f0edec
+foreground = #2c363c
+cursor-color = #2c363c
+cursor-text = #f0edec
+selection-background = #cbd9e3
+selection-foreground = #2c363c

data/vendor/wallpapers/unsplash.yml

@@ -0,0 +1,23 @@
+# Landscape photos from Unsplash, free to use under the Unsplash License
+# (https://unsplash.com/license; attribution appreciated, not required).
+# Hotlinked from images.unsplash.com, sized per request by Rori::Wallpaper.
+# Add an id (the part after "photo-" in an images.unsplash.com URL) to grow
+# the pool; keep them landscape and calm enough to sit behind windows.
+- 1418065460487-3e41a6c84dc5
+- 1426604966848-d7adac402bff
+- 1439066615861-d1af74d74000
+- 1441974231531-c6227db76b6e
+- 1447752875215-b2761acb3c5d
+- 1454496522488-7a8e488e8606
+- 1464822759023-fed622ff2c3b
+- 1465146344425-f00d5f5c8f07
+- 1469474968028-56623f02e42e
+- 1470071459604-3b5ec3a7fe05
+- 1470770841072-f978cf4d019e
+- 1476514525535-07fb3b4ae5f1
+- 1482192596544-9eb780fc7f66
+- 1493246507139-91e8fad9978e
+- 1501785888041-af3ef285b470
+- 1506744038136-46273834b3fb
+- 1507525428034-b723cf961d3e
+- 1519681393784-d120267933ba