RubyGems - rori - Versions diffs - 0.1.0 - Mend

rori 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (86) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +25 -0
data/LICENSE +21 -0
data/README.md +279 -0
data/app/assets/stylesheets/rori/_init.css +79 -0
data/app/assets/stylesheets/rori/layout.css +162 -0
data/app/assets/stylesheets/rori/menubar.css +117 -0
data/app/assets/stylesheets/rori/notifications.css +120 -0
data/app/assets/stylesheets/rori/palette.css +114 -0
data/app/assets/stylesheets/rori/shortcuts.css +110 -0
data/app/assets/stylesheets/rori/terminal.css +98 -0
data/app/assets/stylesheets/rori/themes.css +156 -0
data/app/assets/stylesheets/rori/typing_badge.css +56 -0
data/app/assets/stylesheets/rori/wallpaper.css +52 -0
data/app/assets/stylesheets/rori/window.css +174 -0
data/app/controllers/concerns/rori/windowed.rb +15 -0
data/app/controllers/rori/commands/bars_controller.rb +9 -0
data/app/controllers/rori/commands/runs_controller.rb +22 -0
data/app/controllers/rori/commands/themes_controller.rb +9 -0
data/app/controllers/rori/commands/ui_controller.rb +9 -0
data/app/controllers/rori/commands/wallpapers_controller.rb +9 -0
data/app/controllers/rori/commands_controller.rb +7 -0
data/app/controllers/rori/desktops_controller.rb +7 -0
data/app/helpers/rori/assets_helper.rb +9 -0
data/app/helpers/rori/keymap_helper.rb +50 -0
data/app/helpers/rori/prefs_helper.rb +13 -0
data/app/helpers/rori/theme_helper.rb +14 -0
data/app/helpers/rori/wallpaper_helper.rb +19 -0
data/app/helpers/rori/window_helper.rb +36 -0
data/app/javascript/rori/clock_controller.js +18 -0
data/app/javascript/rori/command_index.js +84 -0
data/app/javascript/rori/fuzzy.js +50 -0
data/app/javascript/rori/index.js +21 -0
data/app/javascript/rori/notifications_controller.js +45 -0
data/app/javascript/rori/palette_controller.js +307 -0
data/app/javascript/rori/prefs_controller.js +68 -0
data/app/javascript/rori/rori_controller.js +996 -0
data/app/javascript/rori/terminal_controller.js +198 -0
data/app/javascript/rori/theme_controller.js +35 -0
data/app/javascript/rori/wallpaper_controller.js +67 -0
data/app/models/rori/command.rb +105 -0
data/app/models/rori/notification.rb +20 -0
data/app/models/rori/theme/color.rb +30 -0
data/app/models/rori/theme.rb +87 -0
data/app/models/rori/wallpaper.rb +54 -0
data/app/views/layouts/rori/_head.html.haml +2 -0
data/app/views/layouts/rori/shell.html.haml +97 -0
data/app/views/layouts/rori/window.html.haml +10 -0
data/app/views/rori/_menubar.html.haml +14 -0
data/app/views/rori/_notification.html.haml +9 -0
data/app/views/rori/_notifications.html.haml +10 -0
data/app/views/rori/_palette.html.haml +13 -0
data/app/views/rori/_shortcuts.html.haml +47 -0
data/app/views/rori/_terminal.html.haml +9 -0
data/app/views/rori/_wallpaper.html.haml +7 -0
data/app/views/rori/_wallpaper_credit.html.haml +3 -0
data/app/views/rori/_window.html.haml +15 -0
data/app/views/rori/commands/_command.html.haml +17 -0
data/app/views/rori/commands/index.html.haml +5 -0
data/app/views/rori/desktops/show.html.haml +1 -0
data/config/importmap.rb +3 -0
data/config/locales/rori.en.yml +133 -0
data/config/routes/rori.rb +13 -0
data/lib/generators/rori/install/install_generator.rb +67 -0
data/lib/generators/rori/install/templates/rori.rb.tt +22 -0
data/lib/rori/engine.rb +19 -0
data/lib/rori/version.rb +3 -0
data/lib/rori.rb +180 -0
data/lib/tasks/rori.rake +9 -0
data/vendor/themes/LICENSE +25 -0
data/vendor/themes/ghostty/Catppuccin Latte +22 -0
data/vendor/themes/ghostty/Catppuccin Mocha +22 -0
data/vendor/themes/ghostty/Everforest Dark Med +22 -0
data/vendor/themes/ghostty/Flexoki Light +22 -0
data/vendor/themes/ghostty/GitHub Dark Dimmed +22 -0
data/vendor/themes/ghostty/Gruvbox Material Dark +22 -0
data/vendor/themes/ghostty/Kanagawa Wave +22 -0
data/vendor/themes/ghostty/Melange Dark +22 -0
data/vendor/themes/ghostty/Nord +22 -0
data/vendor/themes/ghostty/Rose Pine Dawn +22 -0
data/vendor/themes/ghostty/Rose Pine Moon +22 -0
data/vendor/themes/ghostty/TokyoNight Storm +22 -0
data/vendor/themes/ghostty/Tomorrow Night Eighties +22 -0
data/vendor/themes/ghostty/Zenbones Light +22 -0
data/vendor/wallpapers/unsplash.yml +23 -0
metadata +219 -0

data/app/views/layouts/rori/shell.html.haml ADDED Viewed

@@ -0,0 +1,97 @@
+-# The desk shell: full page loads render the requested page as the first
+-# window. Apps add app-wide <head> tags (icons…) by overriding the
+-# layouts/rori/_head partial, and per page with `content_for :head`.
+!!!
+%html{ lang: I18n.locale, data: { theme: current_theme&.slug } }
+  %head
+    %title= windowed? ? window_title : Rori.app_name
+    %meta{ name: "viewport", content: "width=device-width,initial-scale=1" }
+    %meta{ name: "apple-mobile-web-app-capable", content: "yes" }
+    %meta{ name: "application-name", content: Rori.app_name }
+    %meta{ name: "mobile-web-app-capable", content: "yes" }
+    -# Turbo's hover-prefetch cache is keyed by URL alone and hands its response
+    -# to the next fetch of that URL, whatever frame asks. Window frames have
+    -# generated ids, so a page prefetched for `_top` or another window arrives
+    -# without the requesting frame and the window shows "missing frame".
+    %meta{ name: "turbo-prefetch", content: "false" }
+    = csrf_meta_tags
+    = csp_meta_tag
+    = render "layouts/rori/head"
+    = yield :head
+    = stylesheet_link_tag :app, "data-turbo-track": "reload"
+    = rori_stylesheet_link_tags "data-turbo-track": "reload"
+    = rori_local_themes_style_tag
+    = javascript_importmap_tags
+  %body{ class: rori_body_classes,
+    style: ("--rori-wallpaper: #{rori_wallpaper.css_image}" if rori_wallpaper),
+    data: { controller: "rori rori-palette rori-theme rori-wallpaper rori-terminal rori-prefs rori-notifications",
+    rori_notifications_url_value: rori_commands_runs_path,
+    rori_prefs_bars_cookie_value: Rori.bars_cookie,
+    rori_prefs_bars_value: rori_bars,
+    rori_prefs_hint_cookie_value: Rori.hint_cookie,
+    rori_theme_cookie_value: Rori.theme_cookie,
+    rori_wallpaper_cookie_value: Rori.wallpaper_cookie,
+    rori_wallpaper_mode_value: rori_wallpaper_mode,
+    rori_wallpaper_pin_cookie_value: Rori.wallpaper_pin_cookie,
+    rori_wallpaper_pool_value: (Rori::Wallpaper.all.to_json if rori_wallpaper),
+    rori_wallpaper_current_value: rori_wallpaper&.id,
+    rori_wallpaper_pinned_value: rori_wallpaper_pinned?.to_s,
+    rori_terminal_root_value: rori_commands_path,
+    rori_terminal_key_value: Rori.terminal_key,
+    rori_terminal_prompt_value: t("rori.terminal.prompt"),
+    rori_terminal_messages_value: t("rori.terminal.messages").to_json,
+    rori_palette_root_value: rori_commands_path,
+    rori_palette_confirm_value: t("rori.palette.confirm"),
+    rori_root_url_value: root_path,
+    rori_load_error_value: t("rori.window.load_error"),
+    rori_workspace_group_value: t("rori.commands.workspaces.group"),
+    rori_new_workspace_label_value: t("rori.commands.workspaces.new"),
+    rori_keymap_value: Rori.resolved_keymap(rori_modifier).to_json,
+    rori_native_value: rori_native?.to_s,
+    rori_hover_keymap_value: Rori.resolved_hover_keymap.to_json,
+    rori_hover_timeout_value: (Rori.hover_timeout * 1000).round,
+    rori_discard_prompt_value: t("rori.window.discard"),
+    action: ["keydown@window->rori#keydown",
+      "keydown@window->rori-palette#keydown",
+      "resize@window->rori#layout",
+      "pagehide@window->rori#save",
+      "message->rori#streamMessage:capture",
+      "turbo:before-stream-render@document->rori#streamRender",
+      "turbo:before-visit@document->rori#interceptVisit",
+      "keydown@window->rori-terminal#keydown",
+      "rori-command:run->rori#command",
+      "rori-command:source->rori#commandSource",
+      "rori-command:run->rori-theme#run",
+      "rori-command:preview->rori-theme#preview",
+      "rori-command:closed->rori-theme#revert",
+      "rori-command:run->rori-wallpaper#run",
+      "rori-command:preview->rori-wallpaper#preview",
+      "rori-command:closed->rori-wallpaper#revert",
+      "rori-command:run->rori-prefs#run",
+      "rori-command:preview->rori-prefs#preview",
+      "rori-command:closed->rori-prefs#revert",
+      "rori-command:run->rori-notifications#run",
+      "rori:open-shortcuts->rori-prefs#openShortcuts",
+      "rori:toggle-terminal->rori-terminal#toggle",
+      "rori:open-palette->rori-palette#open"].join(" ") } }
+    = render "rori/menubar"
+    %main.rori-viewport{ data: { rori_target: "viewport", action: "wheel->rori#wheel:!passive pointermove->rori#hover pointerleave->rori#unhover" } }
+      = render "rori/wallpaper"
+      = render "rori/wallpaper_credit" if rori_wallpaper
+      .rori-stack{ data: { rori_target: "stack" } }
+      -# Windows wait here until their page says where they go; modals stay here.
+      .rori-floating{ data: { rori_target: "floating" } }
+        - if windowed?
+          = render "rori/window", frame_id: "win_main", src: (request.fullpath if request.get?), body: safe_join([yield, window_meta_tag])
+        - else
+          = yield
+      -# Tags the window whose field has focus (rori/typing_badge.css, anchor positioning).
+      %span.rori-typing-badge.rori-typing-badge--side{ "aria-hidden": "true" }= t("rori.window.typing")
+      %span.rori-typing-badge.rori-typing-badge--inside{ "aria-hidden": "true" }= t("rori.window.typing")
+    = render "rori/terminal"
+    = render "rori/shortcuts"
+    = render "rori/palette"
+    = render "rori/notifications"
+    %template{ data: { rori_target: "template" } }
+      = render "rori/window"

data/app/views/layouts/rori/window.html.haml ADDED Viewed

@@ -0,0 +1,10 @@
+-# Frame responses: Turbo only reads the frame matching the request, so the
+-# page is wrapped in whatever window frame asked for it.
+!!!
+%html{ lang: I18n.locale }
+  %head
+    %title= window_title
+  %body
+    = turbo_frame_tag turbo_frame_request_id do
+      = yield
+      = window_meta_tag

data/app/views/rori/_menubar.html.haml ADDED Viewed

@@ -0,0 +1,14 @@
+-# The desk's one bar (UI › Menu bar moves it to the bottom edge).
+%header.rori-menubar
+  %span.rori-menubar__brand= Rori.app_name
+  %nav.rori-workspaces{ "aria-label": t(".workspaces"), data: { rori_target: "workspaces" } }
+  %nav.rori-minimap{ "aria-label": t(".columns"), data: { rori_target: "minimap" } }
+  %button.rori-menubar__search{ type: "button", data: { action: "rori-palette#open" } }
+    = t(".search")
+    %kbd ⌘K
+  - if (keys = rori_shortcut(:shortcuts))
+    %button.rori-menubar__shortcuts{ type: "button", title: t(".shortcuts"), "aria-label": t(".shortcuts"),
+      data: { action: "rori-prefs#openShortcuts" } }
+      %kbd= keys
+  %time.rori-menubar__clock{ data: { controller: "rori-clock" } }

data/app/views/rori/_notification.html.haml ADDED Viewed

@@ -0,0 +1,9 @@
+-# locals: (notification:)
+%article{ class: class_names("rori-notification", "rori-notification--#{notification.kind}", "rori-notification--sticky" => notification.sticky?),
+  role: notification.sticky? ? "alert" : "status",
+  data: { rori_notifications_target: "notification", action: "animationend->rori-notifications#expire" } }
+  %strong.rori-notification__title= notification.title
+  - if notification.body
+    %p.rori-notification__body= notification.body
+  %button.rori-notification__close{ type: "button", title: t(".dismiss"), "aria-label": t(".dismiss"),
+    data: { action: "rori-notifications#dismiss" } } ×

data/app/views/rori/_notifications.html.haml ADDED Viewed

@@ -0,0 +1,10 @@
+-# Corner notifications (rori-notifications, on <body>): `Rori.notify`
+-# broadcasts reach every open desk through this stream; a server-side
+-# command's result arrives in its run's response. A manual popover, so they
+-# sit in the top layer above modal windows too.
+= turbo_stream_from Rori.notifications_stream
+%section#rori-notifications.rori-notifications{ popover: "manual", "aria-label": t(".label"),
+  data: { rori_notifications_target: "stack" } }
+-# Shown when a run gets no answer (network down, server error page).
+%template{ data: { rori_notifications_target: "failure" } }
+  = render "rori/notification", notification: Rori::Notification.new(title: t(".failed"), kind: :error)

data/app/views/rori/_palette.html.haml ADDED Viewed

@@ -0,0 +1,13 @@
+%dialog.rori-palette{ "aria-label": t(".label"), data: { rori_palette_target: "dialog", action: "click->rori-palette#backdrop close->rori-palette#closed" } }
+  .rori-palette__field
+    %span.rori-palette__crumbs{ hidden: true, data: { rori_palette_target: "crumbs" } }
+    %input.rori-palette__input{ type: "search", placeholder: t(".placeholder"), autocomplete: "off", spellcheck: "false",
+      data: { "1p-ignore": true, rori_palette_target: "input", action: "input->rori-palette#filter keydown->rori-palette#navigate" } }
+  -# No src until the palette opens: it loads the root list (rori-palette's rootValue) on every open.
+  = turbo_frame_tag "commands", class: "rori-palette__results",
+    data: { rori_palette_target: "frame", action: "turbo:frame-load->rori-palette#loaded" }
+  %p.rori-palette__empty{ hidden: true, data: { rori_palette_target: "empty" } }= t(".empty")
+  %footer.rori-palette__hint= t(".hint_html")
+  -# Prototype for items of browser-provided lists (Rori::Command `source:`).
+  %template{ data: { rori_palette_target: "itemTemplate" } }
+    = render "rori/commands/command", command: Rori::Command.new(label: "", group: "")

data/app/views/rori/_shortcuts.html.haml ADDED Viewed

@@ -0,0 +1,47 @@
+-# Keyboard shortcuts, from the same keymap the desk matches (so ⌘ in the
+-# native app). Opened by the `shortcuts` action (Mod+?), the menu bar or ⌘K.
+%dialog.rori-shortcuts{ "aria-labelledby": "rori-shortcuts-title",
+  data: { rori_prefs_target: "shortcuts", action: "click->rori-prefs#shortcutsBackdrop" } }
+  %header.rori-shortcuts__head
+    %h2#rori-shortcuts-title= t(".title")
+    %button.rori-shortcuts__close{ type: "button", title: t(".close"), data: { action: "rori-prefs#closeShortcuts" } } ×
+  .rori-shortcuts__body
+    %section.rori-shortcuts__section
+      %h3= t(".sections.general")
+      %dl
+        %dt= t(".general.palette")
+        %dd
+          %kbd ⌘K
+        %dt= t(".general.terminal")
+        %dd
+          %kbd `
+        %dt= t(".general.leave_field")
+        %dd
+          %kbd esc
+        %dt= t(".general.empty_desk")
+        %dd
+          %kbd ␣
+          %kbd ↵
+    - rori_shortcut_sections.each do |section, rows|
+      %section.rori-shortcuts__section
+        %h3= t(section, scope: "rori.shortcuts.sections")
+        %dl
+          - rows.each do |action, keys|
+            %dt= t(action, scope: "rori.shortcuts.actions")
+            %dd
+              - keys.each do |key|
+                %kbd= key
+    - if (hover = rori_hover_shortcuts).any?
+      %section.rori-shortcuts__section
+        %h3= t(".sections.hover")
+        %p.rori-shortcuts__note= t(".hover_note")
+        %dl
+          - hover.each do |action, keys|
+            %dt= t(action, scope: "rori.shortcuts.actions")
+            %dd
+              - keys.each do |key|
+                %kbd= key
+  %footer.rori-shortcuts__foot
+    %label
+      %input{ type: "checkbox", data: { rori_prefs_target: "hintToggle", action: "rori-prefs#toggleHint" } }
+      = t(".show_hint")

data/app/views/rori/_terminal.html.haml ADDED Viewed

@@ -0,0 +1,9 @@
+-# Drop-down command line (rori-terminal, on <body>). data-rori-keys=off keeps
+-# desk shortcuts and hover keys out while you type here.
+%section.rori-terminal{ hidden: true, "aria-label": t(".label"), data: { rori_keys: "off", rori_terminal_target: "panel" } }
+  .rori-terminal__output{ "aria-live": "polite", data: { rori_terminal_target: "output" } }
+  %label.rori-terminal__line
+    %span.rori-terminal__prompt= t(".prompt")
+    %input.rori-terminal__input{ type: "text", autocomplete: "off", spellcheck: "false", "aria-label": t(".label"),
+      data: { "1p-ignore": true, rori_terminal_target: "input", action: "input->rori-terminal#suggest keydown->rori-terminal#navigate" } }
+  %ul.rori-terminal__suggestions{ data: { rori_terminal_target: "suggestions" } }

data/app/views/rori/_wallpaper.html.haml ADDED Viewed

@@ -0,0 +1,7 @@
+-# The empty-desk hint (dismissible; the shortcuts modal brings it back).
+.rori-wallpaper
+  %button.rori-wallpaper__dismiss{ type: "button", title: t(".dismiss"), data: { action: "rori-prefs#dismissHint" } } ×
+  %p.rori-wallpaper__title= t(".title")
+  %p.rori-wallpaper__hint= t(".hint_html")
+  - if (shortcuts = rori_shortcut(:shortcuts))
+    %p.rori-wallpaper__hint= t(".shortcuts_html", keys: shortcuts)

data/app/views/rori/_wallpaper_credit.html.haml ADDED Viewed

@@ -0,0 +1,3 @@
+-# The photo's credit, in the wallpaper's bottom-right corner (rori/wallpaper.css).
+= link_to t(".label"), rori_wallpaper.credit_url || "#", class: "rori-wallpaper-credit", target: "_blank", rel: "noopener",
+  hidden: rori_wallpaper.credit_url.nil?, data: { rori_wallpaper_target: "credit" }

data/app/views/rori/_window.html.haml ADDED Viewed

@@ -0,0 +1,15 @@
+-# locals: (frame_id: nil, src: nil, body: nil)
+-# Rendered once server-side for the page being loaded, and once inside a
+-# <template> the desk clones for every window it opens.
+%dialog.rori-win{ open: body.present?, tabindex: -1, data: { rori_target: "window",
+  action: "pointerdown->rori#focusWindow focusin->rori#focusWindow input->rori#markDirty change->rori#markDirty cancel->rori#cancel" } }
+  %header.rori-win__bar{ data: { action: "dblclick->rori#toggleFullWidth" } }
+    %button.rori-win__btn{ type: "button", title: t(".back"), disabled: true, data: { action: "rori#back", window_part: "back" } } ←
+    %span.rori-win__title{ data: { window_part: "title" } }
+    %span.rori-win__armed= t(".armed")
+    %button.rori-win__btn{ type: "button", title: t(".detach"), data: { action: "rori#detach" } } ↗
+    %button.rori-win__btn{ type: "button", title: t(".close"), data: { action: "rori#close" } } ×
+  .rori-win__body
+    = turbo_frame_tag frame_id, src: src, complete: src.present?, refresh: "morph",
+      data: { action: "turbo:frame-load->rori#frameLoaded turbo:frame-missing->rori#frameMissing" } do
+      = body

data/app/views/rori/commands/_command.html.haml ADDED Viewed

@@ -0,0 +1,17 @@
+-# locals: (command:)
+- shortcut = rori_shortcut(command.action)
+%li.rori-palette__item{ role: "option",
+  data: { rori_palette_target: "item", url: command.url, rori_action: command.action, param: command.param,
+    children: command.children, source: command.source, run: command.run, confirm: command.confirm || nil, shortcut: shortcut,
+    current: command.current || nil, search: "#{command.label} #{command.group}",
+    action: "click->rori-palette#pick mousemove->rori-palette#hover" } }
+  %span.rori-palette__label
+    = command.label
+    - if command.children || command.source
+      %span.rori-palette__more ›
+  - if shortcut
+    %kbd.rori-palette__shortcut= shortcut
+  %span.rori-palette__group
+    - if command.current
+      %span.rori-palette__check ✓
+    = command.group

data/app/views/rori/commands/index.html.haml ADDED Viewed

@@ -0,0 +1,5 @@
+-# Shared by every palette list (root and nested). The explicit partial path
+-# keeps namespaced controllers (Rori::Commands::…) from prefixing it.
+= turbo_frame_tag "commands" do
+  %ul.rori-palette__list{ role: "listbox", data: { rori_palette_target: "list" } }
+    = render partial: "rori/commands/command", collection: @commands, as: :command

data/app/views/rori/desktops/show.html.haml ADDED Viewed

	@@ -0,0 +1 @@
1	+ -# The blank desk: windows are restored or opened client-side (⌘K).

data/config/importmap.rb ADDED Viewed

@@ -0,0 +1,3 @@
+# The desk's Stimulus controllers; the host registers them with
+# `import { registerRori } from "rori"`.
+pin_all_from Rori::Engine.root.join("app/javascript/rori"), under: "rori"

data/config/locales/rori.en.yml ADDED Viewed

@@ -0,0 +1,133 @@
+# The desk's own copy. App-specific palette labels (desk.commands.routes)
+# stay in the app's locale files.
+en:
+  rori:
+    commands:
+      groups:
+        open: Open
+        rori: Desk
+        ui: UI
+        run: Run
+      actions:
+        overview: Toggle overview
+        reopen_window: Reopen closed window
+        new_workspace: New workspace
+        cycle_width: Cycle column width
+        full_width: Toggle full-width column
+        center_column: Center column
+        close_window: Close window
+        toggle_terminal: Toggle terminal
+        shortcuts: Keyboard shortcuts
+      ui:
+        label: UI
+        theme: Theme
+        wallpaper: Wallpaper
+        bars: Menu bar
+      bars:
+        top: Top
+        bottom: Bottom
+      wallpapers:
+        safe: Safe
+        cover: Cover menu bar
+        "off": "Off"
+        next: Next wallpaper
+        pin: Pin wallpaper
+      workspaces:
+        move: Move column to workspace…
+        group: Workspace
+        new: New workspace
+      themes:
+        pick: Pick theme…
+        default: Default
+        auto: Follows system
+        dark: Dark
+        light: Light
+      runs:
+        create:
+          done: Done
+          failed: Something went wrong. Check the server log.
+    menubar:
+      workspaces: Workspaces
+      search: Search or run a command…
+      columns: Columns
+      shortcuts: Keyboard shortcuts
+    wallpaper_credit:
+      label: Photo · Unsplash
+    wallpaper:
+      title: Nothing open
+      hint_html: "Press <kbd>⌘K</kbd>, <kbd>space</kbd> or <kbd>↵</kbd> to open a page or run a command."
+      # %{keys}: the chord bound to the shortcuts action (⌥? in a browser, ⌘? in the app).
+      shortcuts_html: "<kbd>%{keys}</kbd> shows every keyboard shortcut."
+      dismiss: Hide this hint (bring it back from the shortcuts)
+    shortcuts:
+      title: Keyboard shortcuts
+      close: Close
+      show_hint: Show the hint on an empty desk
+      hover_note: On the window under the pointer, or the focused one when no field has focus.
+      sections:
+        general: General
+        focus: Focus
+        move: Move column
+        workspaces: Workspaces
+        columns: Columns
+        windows: Windows
+        hover: Bare keys
+      general:
+        palette: Commands (⌘K)
+        terminal: Terminal
+        leave_field: Leave a text field
+        empty_desk: Commands, on an empty desk
+      actions:
+        focus_left: Left
+        focus_right: Right
+        focus_up: Up / previous workspace
+        focus_down: Down / next workspace
+        move_left: Left
+        move_right: Right
+        move_up: To the workspace above
+        move_down: To the workspace below
+        switch_to_workspace: Go to workspace
+        move_to_workspace: Move column to workspace and follow it
+        consume_left: Stack into the left column / unstack
+        consume_right: Stack into the right column / unstack
+        cycle_width: Cycle width
+        full_width: Full width
+        center_column: Centre
+        overview: Overview
+        close_window: Close
+        reopen_window: Reopen closed window
+        toggle_terminal: Terminal
+        shortcuts: This list
+    terminal:
+      label: Terminal
+      prompt: "desk ›"
+      # Passed to rori-terminal as one JSON value; %{…} are filled in there.
+      messages:
+        welcome: "Same commands as ⌘K, matched as whole paths: ui wallpaper cover, or just uthen (UI › Theme › Nord) · Tab completes · ↑↓ history · help · clear · esc or ` closes."
+        help: "Top level (anything nested is reachable by typing its path, even abbreviated):"
+        list: "%{path} ›"
+        empty: "  (nothing here)"
+        opened: "→ %{path}"
+        ran: "✓ %{path}"
+        confirm: "Run %{path}? y to confirm, anything else cancels."
+        cancelled: Cancelled.
+        no_match: "No match for “%{query}”."
+    palette:
+      label: Command palette
+      placeholder: Type a command or search…
+      empty: Nothing matches.
+      confirm: ↵ again to run
+      hint_html: "<kbd>↵</kbd> open · <kbd>⇧↵</kbd> in a new window · <kbd>⌫</kbd> back · <kbd>esc</kbd> close"
+    notifications:
+      label: Notifications
+      failed: The command couldn't be run.
+    notification:
+      dismiss: Dismiss
+    window:
+      back: Back
+      detach: Open in a new tab
+      close: Close
+      armed: keys → here
+      typing: "<input>"
+      discard: This window has unsaved changes. Close it anyway?
+      load_error: This page couldn't be shown in a window. Open it in a new tab (↗) to see what went wrong.

data/config/routes/rori.rb ADDED Viewed

@@ -0,0 +1,13 @@
+# The blank desk (Rori::DesktopsController) is mounted by the app, usually as `root`.
+namespace :rori do
+  resources :commands, only: :index
+  # Nested command lists, shared by ⌘K and the terminal.
+  namespace :commands do
+    resource :ui, only: :show, controller: "ui"
+    resources :themes, only: :index
+    resources :wallpapers, only: :index
+    resources :bars, only: :index
+    # Server-side commands (Rori.command).
+    resources :runs, only: :create
+  end
+end

data/lib/generators/rori/install/install_generator.rb ADDED Viewed

@@ -0,0 +1,67 @@
+require "rails/generators"
+module Rori
+  module Generators
+    # bin/rails g rori:install — wires a host app up for the desk. Idempotent:
+    # steps that find their line already in place skip themselves.
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Adds the rori initializer, Rori::Windowed, the desk's routes and its Stimulus controllers."
+      def create_initializer
+        template "rori.rb", "config/initializers/rori.rb"
+      end
+      def include_windowed
+        path = "app/controllers/application_controller.rb"
+        return say_status(:skip, "#{path} not found", :yellow) unless exist?(path)
+        return if read(path).include?("Rori::Windowed")
+        inject_into_class path, "ApplicationController", "  include Rori::Windowed\n\n"
+      end
+      def draw_routes
+        path = "config/routes.rb"
+        return say_status(:skip, "#{path} not found", :yellow) unless exist?(path)
+        routes = read(path)
+        route "draw :rori" unless routes.include?("draw :rori")
+        if routes.match?(/^\s*root\b/)
+          say_status :skip, "root route already set; the blank desk is rori/desktops#show", :yellow
+        else
+          route 'root "rori/desktops#show"'
+        end
+      end
+      def register_stimulus_controllers
+        path = "app/javascript/controllers/index.js"
+        return say_status(:skip, "#{path} not found; call registerRori(application) yourself", :yellow) unless exist?(path)
+        return if read(path).include?("registerRori")
+        append_to_file path, <<~JS
+          import { registerRori } from "rori"
+          registerRori(application)
+        JS
+      end
+      def next_steps
+        say <<~TEXT
+          rori is wired up. Next:
+            • Place the desk's CSS among your layers, e.g. in your first stylesheet:
+                @layer reset, base, rori, layout, components, utilities;
+            • Label pages for ⌘K under rori.commands.routes.<controller>.<action>
+              in your locale, and list models in config/initializers/rori.rb.
+            • Start the server and press ⌘K (or space on the empty desk).
+        TEXT
+      end
+      private
+        def exist?(path) = File.exist?(File.join(destination_root, path))
+        def read(path) = File.read(File.join(destination_root, path))
+    end
+  end
+end

data/lib/generators/rori/install/templates/rori.rb.tt ADDED Viewed

@@ -0,0 +1,22 @@
+# The desk (https://github.com/varyform/rori). Every option, with its
+# default, is documented in the gem's lib/rori.rb.
+Rori.configure do |rori|
+  rori.app_name = "<%= Rails.application.class.module_parent_name.titleize %>"
+  # Models whose most recently updated records are listed in ⌘K (each needs
+  # updated_at, a show route and a readable to_s).
+  # rori.records = %w[ User Project ]
+  # Blender-style bare keys on the window under the pointer.
+  # rori.hover_keys = true
+  # Background photos from Unsplash (or your own: rori.wallpapers_folder).
+  # rori.wallpapers = true
+  # A command that runs on the server, labelled by
+  # rori.commands.custom.reindex_search in your locale:
+  # rori.command :reindex_search, confirm: true do
+  #   SearchReindexJob.perform_later
+  #   "Reindexing…"
+  # end
+end

data/lib/rori/engine.rb ADDED Viewed

@@ -0,0 +1,19 @@
+module Rori
+  # Not isolated: the desk wraps the host app's own pages, so its controllers
+  # inherit the app's ApplicationController (which includes Rori::Windowed),
+  # its helpers join the app's, and its route file is drawn into the app's
+  # routes with `draw :desk` (engines add config/routes to the draw paths).
+  # Views, locales, rake tasks and app/assets come along the usual engine way.
+  class Engine < ::Rails::Engine
+    # Propshaft picks up app/assets; the Stimulus controllers live in
+    # app/javascript, which only the host app gets by default.
+    initializer "rori.assets" do |app|
+      app.config.assets.paths << root.join("app/javascript") if app.config.respond_to?(:assets)
+    end
+    initializer "rori.importmap", before: "importmap" do |app|
+      app.config.importmap.paths << root.join("config/importmap.rb")
+      app.config.importmap.cache_sweepers << root.join("app/javascript")
+    end
+  end
+end

data/lib/rori/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module Rori
+  VERSION = "0.1.0"
+end