aeros 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e3b2cb46425e66779531efc5a9dceb58fec72624117670955cc67c8d1d96acb9
+  data.tar.gz: c7e1a6a35537ecec3e6abcc3fcb92102bf2c6482d035dcf1e5f3583281ef0232
+SHA512:
+  metadata.gz: 46eccf22886fa9abaf9f9c934d7db43056e936670021d69303d4b00c420bd73638ecb13be8e965fdd56806688f0219e19d6cfea8be7e0426ed7e9d553a998168
+  data.tar.gz: c0e763ed28d49f28109845222e63f0e292996e5e0b5a3f2ab59f8e41387461b5bddf367b2588d32db0150068b26bdafc657350c9903cfb69c14b9696d105f762

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Ben
+
+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,230 @@
+# Aeros - Rails Engine UI Component Library
+
+A Rails engine providing reusable UI components with Tailwind CSS styling and Stimulus controllers. Built with ViewComponent and designed for easy integration into Rails engines.
+
+## Components Library
+
+The Aeros gem provides the following components:
+
+### Form Components
+- **`Button`** - Styled button with variants (default, white, light, outline) and sizes (xsmall, small, large)
+- **`InputText`** - Text input field with wrapper and label support
+- **`InputPassword`** - Password input with show/hide toggle functionality
+- **`InputSelect`** - Styled select dropdown
+- **`InputWrapper`** - Wrapper component for form inputs with labels
+
+### Layout Components
+- **`Page`** - Page container component
+- **`Card`** - Card container with styling
+- **`Table`** - Styled table component
+- **`Dropdown`** - Interactive dropdown menu with Stimulus controller
+- **`Empty`** - Empty state component
+- **`Spinner`** - Loading spinner with size and variant options
+
+### Usage in Views
+
+```erb
+<%= ui("button", label: "Click me", variant: :default) %>
+<%= ui("input_text", name: "email", label: "Email") %>
+<%= ui("input_password", name: "password", label: "Password") %>
+<%= ui("card") do %>
+  <h2>Card content</h2>
+<% end %>
+```
+
+## Installation
+
+Add this line to your engine's Gemfile:
+
+```ruby
+gem "aeros", path: "../ui"  # or from a gem server
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+## Integration with Rails Engines
+
+The Aeros gem provides convenience helpers to quickly integrate it into your Rails engine.
+
+### 1. Engine Setup
+
+In your `lib/your_engine/engine.rb`:
+
+```ruby
+require "aeros"
+
+module YourEngine
+  class << self
+    attr_accessor :importmap
+  end
+
+  class Engine < ::Rails::Engine
+    isolate_namespace YourEngine
+
+    # Setup assets and importmap with Aeros gem integration
+    Aeros::EngineHelpers.setup_assets(self, namespace: YourEngine)
+    Aeros::EngineHelpers.setup_importmap(self, namespace: YourEngine)
+  end
+end
+```
+
+**What this does:**
+- Configures asset paths for your engine and the Aeros gem
+- Sets up importmap that automatically includes Aeros gem's JavaScript and components
+- Configures cache sweepers for development hot-reloading
+
+### 2. ApplicationViewComponent
+
+Create `app/components/your_engine/application_view_component.rb`:
+
+```ruby
+module YourEngine
+  class ApplicationViewComponent < Aeros::ApplicationViewComponent
+    def controller_name
+      # Override to use your engine's namespace for Stimulus controllers
+      name = self.class.name
+        .sub(/^YourEngine::/, "")
+        .sub(/::Component$/, "")
+        .underscore
+
+      "your-engine--#{name.gsub('/', '--').gsub('_', '-')}"
+    end
+  end
+end
+```
+
+**What this provides:**
+- All Aeros gem helper methods (stimulus_controller, stimulus_target, etc.)
+- TailwindMerge integration for CSS class merging
+- Style variants support via ViewComponentContrib
+- Dry::Initializer for clean option definitions
+
+### 3. Controller Loading
+
+In `app/javascript/your_engine/controllers/index.js`:
+
+```javascript
+import { application } from "your_engine/controllers/application";
+import { eagerLoadEngineControllersFrom } from "aeros/controllers/loader";
+
+// Load your engine's controllers
+eagerLoadEngineControllersFrom("your_engine/controllers", application);
+eagerLoadEngineControllersFrom("your_engine/components", application);
+
+// Load Aeros gem component controllers
+eagerLoadEngineControllersFrom("aeros/components", application);
+```
+
+**What this does:**
+- Uses the shared controller loader from Aeros gem
+- Automatically registers Stimulus controllers with correct naming conventions
+- Supports multiple namespaces (your engine + Aeros gem)
+
+### 4. Layout Integration
+
+In `app/views/layouts/your_engine/application.html.erb`:
+
+```erb
+<!DOCTYPE html>
+<html>
+  <head>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <!-- Include Aeros gem stylesheets -->
+    <%= stylesheet_link_tag "aeros/application", media: "all" %>
+    <%= stylesheet_link_tag "aeros/tailwind", media: "all" %>
+
+    <!-- Your engine's stylesheets -->
+    <%= stylesheet_link_tag "your_engine/application", media: "all" %>
+    <%= stylesheet_link_tag "your_engine/tailwind", media: "all" %>
+
+    <!-- Importmap with Aeros gem integration -->
+    <%= javascript_importmap_tags "your_engine/application", importmap: YourEngine.importmap %>
+  </head>
+  <body>
+    <%= yield %>
+  </body>
+</html>
+```
+
+### 5. Importmap Configuration
+
+In `config/importmap.rb`:
+
+```ruby
+pin "@hotwired/turbo-rails", to: "turbo.min.js"
+pin "your_engine/application"
+pin "@hotwired/stimulus", to: "stimulus.min.js"
+pin "@hotwired/stimulus-loading", to: "stimulus-loading.js"
+
+pin_all_from(
+  YourEngine::Engine.root.join("app/javascript/your_engine/controllers"),
+  under: "your_engine/controllers",
+)
+
+pin_all_from(
+  YourEngine::Engine.root.join("app/components/your_engine"),
+  under: "your_engine/components",
+  to: "your_engine"
+)
+```
+
+**Note:** Aeros gem's importmap is automatically included via `Aeros::EngineHelpers.setup_importmap`
+
+## Convenience Utilities
+
+### Ruby Helpers
+
+#### `Aeros::EngineHelpers.setup_assets(engine_class, namespace:)`
+Sets up asset paths for your engine with Propshaft/Sprockets support.
+
+#### `Aeros::EngineHelpers.setup_importmap(engine_class, namespace:)`
+Configures importmap with:
+- Your engine's importmap
+- Aeros gem's importmap (automatic)
+- Cache sweepers for development
+- Controller action integration
+
+### JavaScript Utilities
+
+#### `eagerLoadEngineControllersFrom(under, application)`
+Intelligent Stimulus controller loader for Rails engines that:
+- Parses importmap to find controllers
+- Registers with correct naming conventions (e.g., `aeros--button`, `your-engine--views--index`)
+- Handles both `controller.js` and `*_controller.js` naming
+- Supports multiple namespaces
+
+## Development
+
+### Running the Demo App
+
+```bash
+cd ui
+bin/rails server
+```
+
+### Watching Tailwind CSS
+
+```bash
+bundle exec rake app:aeros:tailwind_engine_watch
+```
+
+## Dependencies
+
+- Rails >= 8.0.3
+- importmap-rails ~> 2.2.2
+- turbo-rails ~> 2.0
+- stimulus-rails ~> 1.3
+- tailwindcss-rails ~> 4.3.0
+- view_component ~> 4.0
+- view_component-contrib ~> 0.2.5
+- dry-effects ~> 0.5.0
+- tailwind_merge ~> 1.3
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"

data/app/assets/stylesheets/aeros/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/assets/stylesheets/aeros/application.tailwind.css

@@ -0,0 +1,7 @@
+@import "tailwindcss";
+
+@layer base {
+  html {
+    @apply text-stone-700;
+  }
+}