omarchy-ui 0.0.1-x86_64-linux → 0.0.2-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d11e68e81c3b65cc3b41b2dae80f301e7ffb3e29f44cfdde1495a92a6a562e8d
-  data.tar.gz: c7baff4c2f09d68dad37f3b0742c00d3abca2a661fa71f425443db9ae1850b85
+  metadata.gz: d8c832cd4301f1b237ef13b46fea6eed08cafdae66a1411eae88a887a59a5cf0
+  data.tar.gz: 60b933f9795e67a7b6c1ce2d8e90cb15716dbc9821250bbd8e85a4c7e840d1f1
 SHA512:
-  metadata.gz: 3f256ebcdcc59f1c4bf984900e8f0f1f51896c719f5b956677bb734be45139349d56ee6a05ee6d117c7d79fa325ca13348f0e9088317a49d8ac03829d9d3d3c6
-  data.tar.gz: dc8c3e1df89667cc9204218cb39b9c80ef50599cb78858041650202135a80a98424b08cdfe7932a6854f2e39de3e40a76e0e7466e8d0e8f35a73e7012830a994
+  metadata.gz: 415009fe051699cef4821e70e394dec94b883aa86dfd325a8c2e8afd38a7a3076c9ec21df6efea747ae791b715c5a5de92ef837ccef84f458683f49d805e295e
+  data.tar.gz: 3a017f0872adcec2dff15d35f03e7ac40a2d463dcee56a978e2e514aee187c804ecfce9e8573e3cf1b4312fad5364ec0686af3e7e9e6f7f9eab9ea09a45a1eab

data/README.md

@@ -3,10 +3,9 @@
 > **Experimental:** the API and packaging format are being validated with real Omarchy apps.
 > Pin the gem version for production projects and review release notes before upgrading.
 
-Omarchy UI is the official-style Ruby application framework for building native Omarchy
-interfaces. Ruby owns application state, events, tasks, commands, and models; a shared mruby
-runtime communicates with QML over a validated protocol. Applications do not need system Ruby
-and do not copy the framework runtime into every project.
+Omarchy UI is a Ruby framework for building native Omarchy applications. It provides reactive
+state, components, events, animation, tasks, commands, standalone windows, and shell plugin
+integration through one compact API.
 
 ```ruby
 require "omarchy_ui" unless Object.const_defined?(:OmarchyUI)
@@ -33,19 +32,9 @@ gem install omarchy-ui
 omarchy_ui new "My App"
 ```
 
-The gem includes the CLI, QML bridge, and a prebuilt mruby runtime with Omarchy UI embedded.
-Developers do not install mruby, compile the runtime, copy framework files, or require Ruby on
-machines that run a bundled application. Omarchy with Quickshell is the only host requirement.
-
-Framework maintainers can rebuild the pinned mruby 4.0 binary with:
-
-```bash
-./scripts/build-mruby-runtime.sh
-install -Dm755 build/runtime/omarchy-ui-runtime ~/.local/bin/omarchy-ui-runtime
-```
-
-The stripped prebuilt runtime is approximately 1.8 MB and embeds the Ruby framework, JSON, regular
-expressions, process support, and the native safe-command bridge.
+The gem contains everything required to create, launch, and bundle an application. Developers do
+not need to install a separate runtime or copy framework files. Bundled applications require only
+an Omarchy computer to run.
 
 ## Create and run an application
 
@@ -77,9 +66,8 @@ omarchy_ui bundle
 ./dist/my-app/run
 ```
 
-`bundle` copies the working application, framework QML bridge, and prebuilt mruby executable into
-`dist/<project-name>/`. The generated `run` launcher invokes Quickshell directly with the bundled
-runtime, so the destination computer does not need Ruby or the `omarchy-ui` gem.
+`bundle` creates a self-contained application under `dist/<project-name>/`. The generated `run`
+launcher works on another Omarchy computer without Ruby or the `omarchy-ui` gem.
 
 An Omarchy Shell plugin is a separate packaging mode. It requires `manifest.json` so the shell
 can discover its ID, entry points, bar placement, and lifecycle. For a project that intentionally
@@ -90,7 +78,7 @@ omarchy_ui validate path/to/plugin
 omarchy_ui push path/to/plugin
 ```
 
-`push` stages and validates the project, injects the shared QML bridge files, backs up an existing
+`push` stages and validates the project, adds the framework support files, backs up an existing
 installation, installs atomically, optionally enables it, and restarts Omarchy Shell. Use
 `--no-enable` or `--no-restart` when needed.
 
@@ -146,25 +134,13 @@ end
 
 State accepts protocol-safe values: `nil`, booleans, finite numbers, strings, arrays, and hashes
 with string/symbol keys. Bindings are reevaluated after changes and emit small property patches.
+Ruby blocks passed to `text`, `property`, or `bind` are reactive; no wrapper is required.
 `transaction` batches related state writes.
 
-Use `dynamic` when state changes the structure rather than only a property:
-
-```ruby
-dynamic id: :results, spacing: 8 do
-  if state.items.empty?
-    text "Nothing found"
-  else
-    state.items.each { |item| text item.fetch("name") }
-  end
-end
-```
-
 ## Common properties
 
 Every component supports `visible`, `enabled`, `opacity`, `scale`, `rotation`, `z`, `width`, and
-`height`. Component-specific properties are listed below. Names use Ruby `snake_case`; the QML
-bridge maps them to native property names.
+`height`. Component-specific properties are listed below. Property names use Ruby `snake_case`.
 
 ## Built-in component reference
 
@@ -227,7 +203,7 @@ Typical event payloads are:
 - `list_view` change/activate: value, index, and original item
 - `list_view` scroll: x and y offsets
 
-Only declared and subscribed events cross the QML/Ruby boundary.
+Only declared and subscribed events are delivered to application handlers.
 
 ## Bindings and properties
 
@@ -286,7 +262,7 @@ in_bounce, out_bounce, in_out_bounce
 ```
 
 All common numeric visual properties and declared numeric custom-adapter properties can be
-animated. Parallel property hashes become parallel QML animation tracks.
+animated. Properties in the same hash animate in parallel.
 
 ## Tasks and commands
 
@@ -296,10 +272,9 @@ every(5, immediate: true) { state.updated_at = Time.now.to_i }
 async { state.result = run_command(["uname", "-r"], timeout: 2).stdout.strip }
 ```
 
-`after`, `every`, and `async` return cancellable task objects. MRI uses worker threads; mruby
-uses cooperative ticks from the QML host. Command execution always takes an argv array and does
-not invoke a shell. Results expose `stdout`, `stderr`, `exitstatus`, and `success?`; timeout raises
-`OmarchyUI::CommandTimeout`.
+`after`, `every`, and `async` return cancellable task objects. Command execution always takes an
+argv array and does not invoke a shell. Results expose `stdout`, `stderr`, `exitstatus`, and
+`success?`; timeout raises `OmarchyUI::CommandTimeout`.
 
 ## Custom QML components
 
@@ -325,16 +300,11 @@ declared signals are forwarded to Ruby. A container adapter can expose an `Item`
 `contentHost`; framework children are parented into it automatically. See
 [the QML support matrix](docs/qml-support.md) and [Sparkline.qml](Components/Sparkline.qml).
 
-## Architecture and safety
-
-`Service.qml` supervises one long-lived mruby process and exchanges versioned NDJSON through
-stdin/stdout. `ControlNode.qml` recursively renders validated component nodes. Property changes
-send incremental patches; dynamic branches replace only affected children; animations run in
-QML. Closing a window or panel does not evaluate Ruby or QML received over the protocol.
+## Safety
 
-Component names, QML filenames, properties, events, IDs, effects, values, message sizes, and
-animation limits are validated. Commands use argv arrays without a shell. Applications and
-plugins still run with the current user's permissions.
+Component names, files, properties, events, IDs, effects, values, message sizes, and animation
+limits are validated. Commands use argv arrays without a shell. Applications and plugins run with
+the current user's permissions, so review third-party code before installing it.
 
 ## Omarchy Phone example
 
@@ -354,8 +324,8 @@ ruby script/benchmark.rb
 ```
 
 The suite covers state, bindings, repeated structures, event persistence, component schemas,
-animation tracks and sequences, tasks, command safety, mruby compatibility, standalone project
-generation, packaging, manifests, QML contracts, QML lint, and the phone backend.
+animation tracks and sequences, tasks, command safety, standalone project generation, packaging,
+manifests, component contracts, linting, and the phone backend.
 
 ## License
 

data/lib/omarchy_ui/cli.rb

@@ -31,6 +31,8 @@ module OmarchyUI
         @err.puts("Usage: omarchy_ui <new NAME|run FILE|launch FILE|bundle [DIRECTORY]|push [DIRECTORY]|validate [DIRECTORY]|version>")
         command.nil? ? 0 : 64
       end
+    rescue Interrupt
+      130
     rescue ArgumentError, SystemCallError, JSON::ParserError => error
       @err.puts("omarchy_ui: #{error.message}")
       1
@@ -64,7 +66,8 @@ module OmarchyUI
         environment = ENV.to_h.merge(
           "OMARCHY_UI_PROJECT_DIR" => project_dir,
           "OMARCHY_UI_RUBY_PROGRAM" => file,
-          "OMARCHY_UI_RUNTIME" => Runtime.executable
+          "OMARCHY_UI_RUNTIME" => Runtime.executable,
+          "QT_LOGGING_RULES" => qt_logging_rules
         )
         success = system(environment, "quickshell", "--path", File.join(runtime_dir, "App.qml"))
         return success ? 0 : ($?&.exitstatus || 1)
@@ -117,6 +120,7 @@ module OmarchyUI
         export OMARCHY_UI_RUNTIME="$app_dir/omarchy-ui-runtime"
         export OMARCHY_UI_PROJECT_DIR="$app_dir"
         export OMARCHY_UI_RUBY_PROGRAM="$app_dir/main.rb"
+        export QT_LOGGING_RULES="${QT_LOGGING_RULES:+$QT_LOGGING_RULES;}qt.qpa.services.warning=false"
         exec quickshell --path "$app_dir/App.qml"
       SH
       FileUtils.chmod(0o755, launcher)
@@ -127,6 +131,10 @@ module OmarchyUI
       raise
     end
 
+    def qt_logging_rules
+      [ENV["QT_LOGGING_RULES"], "qt.qpa.services.warning=false"].compact.reject(&:empty?).join(";")
+    end
+
     def push(arguments)
       enable = !arguments.delete("--no-enable")
       restart = !arguments.delete("--no-restart")

data/lib/omarchy_ui.rb

@@ -15,7 +15,7 @@ require_relative "omarchy_ui/project"
 require_relative "omarchy_ui/runtime"
 
 module OmarchyUI
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
   FRAMEWORK_ROOT = File.expand_path("..", __dir__)
 
   def self.plugin(&definition)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omarchy-ui
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: x86_64-linux
 authors:
 - Adam Moussa Ali
@@ -9,8 +9,7 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: A persistent Ruby runtime, reactive UI model, and safe QML renderer for
-  Omarchy.
+description: The application framework for building native Omarchy apps with Ruby.
 executables:
 - omarchy_ui
 extensions: []