voidable-hotwire 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '09176d0f946e22413a10e60cc115f7fc5d92ee30aa8477343a4c2c9d9043f2da'
+  data.tar.gz: b790ad2b9537a6de90980f60e5b48df4af1f29e6227cdd414c6c5babfc1a5f3d
+SHA512:
+  metadata.gz: 1ed8c258a20e8ba4edbd5ee3ecc944b97cc52dfabb0edf17e8e525d47ce013b1530b74a2726de3ecbe15952c8d93b7ff698ea44c8870c16f13afeb35ff67d923
+  data.tar.gz: f83d44be362c8d8398e9ad102ac3bcf55fb4830d999503ed85f32d0ef96620673d3586efa46a0dc0e71f5d6b2a089183b6ee4224aea6851f83f0e0b6aa0d67ea

data/LICENSE.md

@@ -0,0 +1,25 @@
+The MIT License (MIT)
+=====================
+
+Copyright © `2026` `Kaz Walker`
+
+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.

data/README.md

@@ -0,0 +1,60 @@
+# voidable-hotwire
+
+Rails integration for [Voidable UI](https://voidable.dev) web components with Hotwire (Stimulus + Turbo).
+
+## Installation
+
+Add to your Gemfile:
+
+    gem "voidable-hotwire"
+
+Run:
+
+    bundle install
+
+## Setup
+
+### With importmap-rails
+
+The gem automatically pins `@voidable/ui` and `@voidable/ui-hotwire` to your importmap.
+
+Register the Stimulus controller and start Turbo integration in your `application.js`:
+
+```js
+import { VoidEventController } from "@voidable/ui-hotwire"
+import { VoidTurbo } from "@voidable/ui-hotwire"
+import "@voidable/ui"
+
+application.register("void-event", VoidEventController)
+VoidTurbo.start()
+```
+
+### With jsbundling-rails
+
+Install the npm packages:
+
+    yarn add @voidable/ui @voidable/ui-hotwire
+
+### Theming
+
+Voidable components are devoid of style by design. You must provide a theme. The default theme is available via `@voidable/theme`:
+
+    @import "@voidable/theme";
+
+Or use a custom theme — any CSS that sets the `--void-*` custom properties will work. See [Theming](https://voidable.dev/getting-started/theming/) for details.
+
+## View helpers
+
+Use `void_attrs` to generate Stimulus data attributes:
+
+```erb
+<%= tag.void_button "Save", variant: "filled",
+      **void_attrs("void-click", "form#submit") %>
+
+<%= tag.void_input placeholder: "Search...",
+      **void_attrs("void-change", "search#filter") %>
+```
+
+## License
+
+MIT

data/lib/voidable/hotwire/engine.rb

@@ -0,0 +1,19 @@
+module Voidable
+  module Hotwire
+    class Engine < ::Rails::Engine
+      isolate_namespace Voidable::Hotwire
+
+      initializer "voidable-hotwire.importmap", before: "importmap" do |app|
+        if app.config.respond_to?(:importmap)
+          app.config.importmap.paths << Engine.root.join("config/importmap.rb")
+        end
+      end
+
+      initializer "voidable-hotwire.helpers" do
+        ActiveSupport.on_load(:action_view) do
+          include Voidable::Hotwire::Helpers
+        end
+      end
+    end
+  end
+end

data/lib/voidable/hotwire/helpers.rb

@@ -0,0 +1,25 @@
+module Voidable
+  module Hotwire
+    module Helpers
+      # Generates data attributes for wiring a Voidable component to Stimulus.
+      #
+      #   void_attrs("void-click", "form#submit")
+      #   # => { controller: "void-event", "void-event-events-value": "void-click",
+      #   #      action: "void-click->form#submit" }
+      #
+      def void_attrs(events, action = nil)
+        attrs = {
+          data: {
+            controller: "void-event",
+            "void-event-events-value": Array(events).join(",")
+          }
+        }
+        if action
+          event_list = Array(events)
+          attrs[:data][:action] = event_list.map { |e| "#{e}->#{action}" }.join(" ")
+        end
+        attrs
+      end
+    end
+  end
+end

data/lib/voidable/hotwire/version.rb

@@ -0,0 +1,5 @@
+module Voidable
+  module Hotwire
+    VERSION = "0.1.0"
+  end
+end

data/lib/voidable/hotwire.rb

@@ -0,0 +1,3 @@
+require_relative "hotwire/version"
+require_relative "hotwire/helpers"
+require_relative "hotwire/engine" if defined?(Rails::Engine)

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: voidable-hotwire
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaz Walker
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description: Provides a Rails engine, importmap pins, and view helpers for using Voidable
+  UI web components with Stimulus and Turbo.
+email:
+- the.kaz.walker@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- lib/voidable/hotwire.rb
+- lib/voidable/hotwire/engine.rb
+- lib/voidable/hotwire/helpers.rb
+- lib/voidable/hotwire/version.rb
+homepage: https://voidable.dev
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://voidable.dev
+  source_code_uri: https://github.com/VoidableUI/Voidable
+  changelog_uri: https://github.com/VoidableUI/Voidable/releases
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Rails integration for Voidable UI web components with Hotwire
+test_files: []