jet_ui 0.2.4

data/lib/generators/jet_ui/eject/eject_generator.rb

@@ -0,0 +1,376 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module JetUi
+  module Generators
+    class EjectGenerator < Rails::Generators::Base
+      def self.source_paths
+        [File.expand_path('../../../..', __dir__)]
+      end
+
+      desc <<~DESC
+        Copies one or more JetUi component source files into your application
+        so they can be customised locally. Ejected files take precedence over
+        the gem's built-in versions automatically — no extra configuration needed.
+
+        Available components: #{%w[accordion btn card clipboard divider drawer dropdown empty flash header icon list modal navbar pagy popover sidebar spinner stat stepper table tabs timeline tooltip turbo_confirm].join(', ')}
+
+        Examples:
+          rails generate jet_ui:eject btn
+          rails generate jet_ui:eject flash
+          rails generate jet_ui:eject modal drawer
+          rails generate jet_ui:eject btn --skip-test
+          rails generate jet_ui:eject btn --skip-preview
+          rails generate jet_ui:eject flash --skip-javascript
+          rails generate jet_ui:eject btn --skip-test --skip-preview
+      DESC
+
+      argument :components, type: :array, banner: 'component [component ...]',
+                            desc: 'One or more component names to eject (e.g. btn card)'
+
+      class_option :skip_test, type: :boolean, default: false,
+                               desc: 'Skip ejecting the component test file'
+
+      class_option :skip_preview, type: :boolean, default: false,
+                                  desc: 'Skip ejecting the ViewComponent preview file'
+
+      class_option :skip_javascript, type: :boolean, default: false,
+                                     desc: 'Skip ejecting the Stimulus controller JS file (for components that have one)'
+
+      MANIFEST = {
+        'btn' => {
+          files: [
+            { src: 'app/components/jet_ui/btn/component.rb',                                                    dest: 'app/components/jet_ui/btn/component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/btn.css',                                                     dest: 'app/assets/stylesheets/jet_ui/btn.css' },
+            { src: 'test/components/jet_ui/btn/component_test.rb',                                              dest: 'test/components/jet_ui/btn/component_test.rb',                           type: :test },
+            { src: 'test/components/previews/jet_ui/btn/component_preview.rb',                                  dest: 'test/components/previews/jet_ui/btn/component_preview.rb',               type: :preview }
+          ]
+        },
+        'card' => {
+          files: [
+            { src: 'app/components/jet_ui/card/component.rb',                                                   dest: 'app/components/jet_ui/card/component.rb' },
+            { src: 'app/components/jet_ui/card/header_component.rb',                                            dest: 'app/components/jet_ui/card/header_component.rb' },
+            { src: 'app/components/jet_ui/card/footer_component.rb',                                            dest: 'app/components/jet_ui/card/footer_component.rb' },
+            { src: 'app/components/jet_ui/card/body_component.rb',                                              dest: 'app/components/jet_ui/card/body_component.rb' },
+            { src: 'app/components/jet_ui/card/title_component.rb',                                             dest: 'app/components/jet_ui/card/title_component.rb' },
+            { src: 'app/components/jet_ui/card/subtitle_component.rb',                                          dest: 'app/components/jet_ui/card/subtitle_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/card.css',                                                    dest: 'app/assets/stylesheets/jet_ui/card.css' },
+            { src: 'test/components/jet_ui/card/component_test.rb',                                             dest: 'test/components/jet_ui/card/component_test.rb',                          type: :test },
+            { src: 'test/components/previews/jet_ui/card/component_preview.rb',                                 dest: 'test/components/previews/jet_ui/card/component_preview.rb',              type: :preview }
+          ]
+        },
+        'icon' => {
+          files: [
+            { src: 'app/components/jet_ui/icon/component.rb',                                                   dest: 'app/components/jet_ui/icon/component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/icon.css',                                                    dest: 'app/assets/stylesheets/jet_ui/icon.css' },
+            { src: 'test/components/jet_ui/icon/component_test.rb',                                             dest: 'test/components/jet_ui/icon/component_test.rb',                          type: :test },
+            { src: 'test/components/previews/jet_ui/icon/component_preview.rb',                                 dest: 'test/components/previews/jet_ui/icon/component_preview.rb',              type: :preview },
+            { src: 'test/components/previews/jet_ui/icon/component_preview/sizes.html.erb',                     dest: 'test/components/previews/jet_ui/icon/component_preview/sizes.html.erb',  type: :preview },
+            { src: 'test/components/previews/jet_ui/icon/component_preview/colors.html.erb',                    dest: 'test/components/previews/jet_ui/icon/component_preview/colors.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/icon/component_preview/catalog.html.erb',                   dest: 'test/components/previews/jet_ui/icon/component_preview/catalog.html.erb', type: :preview }
+          ]
+        },
+        'spinner' => {
+          files: [
+            { src: 'app/components/jet_ui/spinner/component.rb',                                                dest: 'app/components/jet_ui/spinner/component.rb' },
+            { src: 'test/components/jet_ui/spinner/component_test.rb',                                          dest: 'test/components/jet_ui/spinner/component_test.rb',                       type: :test },
+            { src: 'test/components/previews/jet_ui/spinner/component_preview.rb',                              dest: 'test/components/previews/jet_ui/spinner/component_preview.rb',           type: :preview },
+            { src: 'test/components/previews/jet_ui/spinner/component_preview/sizes.html.erb',                  dest: 'test/components/previews/jet_ui/spinner/component_preview/sizes.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/spinner/component_preview/colors.html.erb',                 dest: 'test/components/previews/jet_ui/spinner/component_preview/colors.html.erb', type: :preview }
+          ]
+        },
+        'avatar' => {
+          files: [
+            { src: 'app/components/jet_ui/avatar/component.rb',                                                 dest: 'app/components/jet_ui/avatar/component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/avatar.css',                                                  dest: 'app/assets/stylesheets/jet_ui/avatar.css' },
+            { src: 'test/components/jet_ui/avatar/component_test.rb',                                           dest: 'test/components/jet_ui/avatar/component_test.rb',                        type: :test },
+            { src: 'test/components/previews/jet_ui/avatar/component_preview.rb',                               dest: 'test/components/previews/jet_ui/avatar/component_preview.rb',            type: :preview },
+            { src: 'test/components/previews/jet_ui/avatar/component_preview/variants.html.erb',                dest: 'test/components/previews/jet_ui/avatar/component_preview/variants.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/avatar/component_preview/sizes.html.erb',                   dest: 'test/components/previews/jet_ui/avatar/component_preview/sizes.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/avatar/component_preview/states.html.erb',                  dest: 'test/components/previews/jet_ui/avatar/component_preview/states.html.erb', type: :preview }
+          ]
+        },
+        'breadcrumbs' => {
+          files: [
+            { src: 'app/components/jet_ui/breadcrumbs/component.rb',                                            dest: 'app/components/jet_ui/breadcrumbs/component.rb' },
+            { src: 'app/components/jet_ui/breadcrumbs/item_component.rb',                                       dest: 'app/components/jet_ui/breadcrumbs/item_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/breadcrumbs.css',                                             dest: 'app/assets/stylesheets/jet_ui/breadcrumbs.css' },
+            { src: 'test/components/jet_ui/breadcrumbs/component_test.rb',                                      dest: 'test/components/jet_ui/breadcrumbs/component_test.rb',                   type: :test },
+            { src: 'test/components/previews/jet_ui/breadcrumbs/component_preview.rb',                          dest: 'test/components/previews/jet_ui/breadcrumbs/component_preview.rb',       type: :preview },
+            { src: 'test/components/previews/jet_ui/breadcrumbs/component_preview/default.html.erb',            dest: 'test/components/previews/jet_ui/breadcrumbs/component_preview/default.html.erb', type: :preview }
+          ]
+        },
+        'tabs' => {
+          files: [
+            { src: 'app/components/jet_ui/tabs/component.rb',                                                   dest: 'app/components/jet_ui/tabs/component.rb' },
+            { src: 'app/components/jet_ui/tabs/item_component.rb',                                              dest: 'app/components/jet_ui/tabs/item_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/tabs.css',                                                    dest: 'app/assets/stylesheets/jet_ui/tabs.css' },
+            { src: 'test/components/jet_ui/tabs/component_test.rb',                                             dest: 'test/components/jet_ui/tabs/component_test.rb',                          type: :test },
+            { src: 'test/components/previews/jet_ui/tabs/component_preview.rb',                                 dest: 'test/components/previews/jet_ui/tabs/component_preview.rb',              type: :preview },
+            { src: 'test/components/previews/jet_ui/tabs/component_preview/pill.html.erb',                      dest: 'test/components/previews/jet_ui/tabs/component_preview/pill.html.erb',   type: :preview },
+            { src: 'test/components/previews/jet_ui/tabs/component_preview/underline.html.erb',                 dest: 'test/components/previews/jet_ui/tabs/component_preview/underline.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/tabs/component_preview/with_icons.html.erb',                dest: 'test/components/previews/jet_ui/tabs/component_preview/with_icons.html.erb', type: :preview }
+          ]
+        },
+        'empty' => {
+          files: [
+            { src: 'app/components/jet_ui/empty/component.rb',                                                  dest: 'app/components/jet_ui/empty/component.rb' },
+            { src: 'app/components/jet_ui/empty/title_component.rb',                                            dest: 'app/components/jet_ui/empty/title_component.rb' },
+            { src: 'app/components/jet_ui/empty/description_component.rb',                                      dest: 'app/components/jet_ui/empty/description_component.rb' },
+            { src: 'app/components/jet_ui/empty/icon_component.rb',                                             dest: 'app/components/jet_ui/empty/icon_component.rb' },
+            { src: 'app/components/jet_ui/empty/actions_component.rb',                                          dest: 'app/components/jet_ui/empty/actions_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/empty.css',                                                   dest: 'app/assets/stylesheets/jet_ui/empty.css' },
+            { src: 'test/components/jet_ui/empty/component_test.rb',                                            dest: 'test/components/jet_ui/empty/component_test.rb',                         type: :test },
+            { src: 'test/components/previews/jet_ui/empty/component_preview.rb',                                dest: 'test/components/previews/jet_ui/empty/component_preview.rb',             type: :preview },
+            { src: 'test/components/previews/jet_ui/empty/component_preview/with_actions.html.erb',             dest: 'test/components/previews/jet_ui/empty/component_preview/with_actions.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/empty/component_preview/without_actions.html.erb',          dest: 'test/components/previews/jet_ui/empty/component_preview/without_actions.html.erb', type: :preview }
+          ]
+        },
+        'pagy' => {
+          files: [
+            { src: 'app/components/jet_ui/pagy/component.rb',                                                     dest: 'app/components/jet_ui/pagy/component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/pagy.css',                                                      dest: 'app/assets/stylesheets/jet_ui/pagy.css' },
+            { src: 'test/components/jet_ui/pagy/component_test.rb',                                               dest: 'test/components/jet_ui/pagy/component_test.rb',                        type: :test },
+            { src: 'test/components/previews/jet_ui/pagy/component_preview.rb',                                   dest: 'test/components/previews/jet_ui/pagy/component_preview.rb',            type: :preview },
+            { src: 'test/components/previews/jet_ui/pagy/component_preview/default.html.erb',                     dest: 'test/components/previews/jet_ui/pagy/component_preview/default.html.erb', type: :preview }
+          ]
+        },
+        'table' => {
+          files: [
+            { src: 'app/components/jet_ui/table/component.rb',                                                    dest: 'app/components/jet_ui/table/component.rb' },
+            { src: 'app/components/jet_ui/table/thead_component.rb',                                              dest: 'app/components/jet_ui/table/thead_component.rb' },
+            { src: 'app/components/jet_ui/table/tbody_component.rb',                                              dest: 'app/components/jet_ui/table/tbody_component.rb' },
+            { src: 'app/components/jet_ui/table/tfoot_component.rb',                                              dest: 'app/components/jet_ui/table/tfoot_component.rb' },
+            { src: 'app/components/jet_ui/table/tr_component.rb',                                                 dest: 'app/components/jet_ui/table/tr_component.rb' },
+            { src: 'app/components/jet_ui/table/th_component.rb',                                                 dest: 'app/components/jet_ui/table/th_component.rb' },
+            { src: 'app/components/jet_ui/table/td_component.rb',                                                 dest: 'app/components/jet_ui/table/td_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/table.css',                                                     dest: 'app/assets/stylesheets/jet_ui/table.css' },
+            { src: 'test/components/jet_ui/table/component_test.rb',                                              dest: 'test/components/jet_ui/table/component_test.rb',                       type: :test },
+            { src: 'test/components/previews/jet_ui/table/component_preview.rb',                                  dest: 'test/components/previews/jet_ui/table/component_preview.rb',           type: :preview },
+            { src: 'test/components/previews/jet_ui/table/component_preview/default.html.erb',                    dest: 'test/components/previews/jet_ui/table/component_preview/default.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/table/component_preview/bordered.html.erb',                   dest: 'test/components/previews/jet_ui/table/component_preview/bordered.html.erb', type: :preview }
+          ]
+        },
+        'stepper' => {
+          files: [
+            { src: 'app/components/jet_ui/stepper/component.rb',                                                  dest: 'app/components/jet_ui/stepper/component.rb' },
+            { src: 'app/components/jet_ui/stepper/step_component.rb',                                             dest: 'app/components/jet_ui/stepper/step_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/stepper.css',                                                   dest: 'app/assets/stylesheets/jet_ui/stepper.css' },
+            { src: 'test/components/jet_ui/stepper/component_test.rb',                                            dest: 'test/components/jet_ui/stepper/component_test.rb',                     type: :test },
+            { src: 'test/components/previews/jet_ui/stepper/component_preview.rb',                                dest: 'test/components/previews/jet_ui/stepper/component_preview.rb',         type: :preview },
+            { src: 'test/components/previews/jet_ui/stepper/component_preview/basic.html.erb',                    dest: 'test/components/previews/jet_ui/stepper/component_preview/basic.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/stepper/component_preview/with_numbers.html.erb',             dest: 'test/components/previews/jet_ui/stepper/component_preview/with_numbers.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/stepper/component_preview/with_descriptions.html.erb',        dest: 'test/components/previews/jet_ui/stepper/component_preview/with_descriptions.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/stepper/component_preview/with_icons.html.erb',               dest: 'test/components/previews/jet_ui/stepper/component_preview/with_icons.html.erb', type: :preview }
+          ]
+        },
+        'timeline' => {
+          files: [
+            { src: 'app/components/jet_ui/timeline/component.rb',                                                 dest: 'app/components/jet_ui/timeline/component.rb' },
+            { src: 'app/components/jet_ui/timeline/item_component.rb',                                            dest: 'app/components/jet_ui/timeline/item_component.rb' },
+            { src: 'app/components/jet_ui/timeline/dot_component.rb',                                             dest: 'app/components/jet_ui/timeline/dot_component.rb' },
+            { src: 'app/components/jet_ui/timeline/content_component.rb',                                         dest: 'app/components/jet_ui/timeline/content_component.rb' },
+            { src: 'app/components/jet_ui/timeline/time_component.rb',                                            dest: 'app/components/jet_ui/timeline/time_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/timeline.css',                                                  dest: 'app/assets/stylesheets/jet_ui/timeline.css' },
+            { src: 'test/components/jet_ui/timeline/component_test.rb',                                           dest: 'test/components/jet_ui/timeline/component_test.rb',                     type: :test },
+            { src: 'test/components/previews/jet_ui/timeline/component_preview.rb',                               dest: 'test/components/previews/jet_ui/timeline/component_preview.rb',         type: :preview },
+            { src: 'test/components/previews/jet_ui/timeline/component_preview/default.html.erb',                 dest: 'test/components/previews/jet_ui/timeline/component_preview/default.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/timeline/component_preview/with_icons.html.erb',              dest: 'test/components/previews/jet_ui/timeline/component_preview/with_icons.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/timeline/component_preview/variants.html.erb',                dest: 'test/components/previews/jet_ui/timeline/component_preview/variants.html.erb', type: :preview }
+          ]
+        },
+        'divider' => {
+          files: [
+            { src: 'app/components/jet_ui/divider/component.rb',                                                  dest: 'app/components/jet_ui/divider/component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/divider.css',                                                   dest: 'app/assets/stylesheets/jet_ui/divider.css' },
+            { src: 'test/components/jet_ui/divider/component_test.rb',                                            dest: 'test/components/jet_ui/divider/component_test.rb',                      type: :test },
+            { src: 'test/components/previews/jet_ui/divider/component_preview.rb',                                dest: 'test/components/previews/jet_ui/divider/component_preview.rb',          type: :preview },
+            { src: 'test/components/previews/jet_ui/divider/component_preview/with_text.html.erb',                dest: 'test/components/previews/jet_ui/divider/component_preview/with_text.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/divider/component_preview/aligned.html.erb',                  dest: 'test/components/previews/jet_ui/divider/component_preview/aligned.html.erb', type: :preview }
+          ]
+        },
+        'flash' => {
+          files: [
+            { src: 'app/components/jet_ui/flash/component.rb',                                                   dest: 'app/components/jet_ui/flash/component.rb' },
+            { src: 'app/components/jet_ui/flash/component.html.erb',                                             dest: 'app/components/jet_ui/flash/component.html.erb' },
+            { src: 'app/assets/stylesheets/jet_ui/flash.css',                                                    dest: 'app/assets/stylesheets/jet_ui/flash.css' },
+            { src: 'app/assets/javascripts/jet_ui/flash_controller.js',                                          dest: 'app/assets/javascripts/jet_ui/flash_controller.js',                      type: :javascript },
+            { src: 'test/components/jet_ui/flash/component_test.rb',                                             dest: 'test/components/jet_ui/flash/component_test.rb',                         type: :test },
+            { src: 'test/components/previews/jet_ui/flash/component_preview.rb',                                 dest: 'test/components/previews/jet_ui/flash/component_preview.rb',             type: :preview }
+          ]
+        },
+        'list' => {
+          files: [
+            { src: 'app/components/jet_ui/list/component.rb',                                                   dest: 'app/components/jet_ui/list/component.rb' },
+            { src: 'app/components/jet_ui/list/item_component.rb',                                              dest: 'app/components/jet_ui/list/item_component.rb' },
+            { src: 'app/components/jet_ui/list/icon_component.rb',                                              dest: 'app/components/jet_ui/list/icon_component.rb' },
+            { src: 'app/components/jet_ui/list/content_component.rb',                                           dest: 'app/components/jet_ui/list/content_component.rb' },
+            { src: 'app/components/jet_ui/list/action_component.rb',                                            dest: 'app/components/jet_ui/list/action_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/list.css',                                                    dest: 'app/assets/stylesheets/jet_ui/list.css' },
+            { src: 'test/components/jet_ui/list/component_test.rb',                                             dest: 'test/components/jet_ui/list/component_test.rb',                          type: :test },
+            { src: 'test/components/previews/jet_ui/list/component_preview.rb',                                 dest: 'test/components/previews/jet_ui/list/component_preview.rb',              type: :preview },
+            { src: 'test/components/previews/jet_ui/list/component_preview/default.html.erb',                   dest: 'test/components/previews/jet_ui/list/component_preview/default.html.erb', type: :preview },
+            { src: 'test/components/previews/jet_ui/list/component_preview/divided.html.erb',                   dest: 'test/components/previews/jet_ui/list/component_preview/divided.html.erb', type: :preview }
+          ]
+        },
+        'accordion' => {
+          files: [
+            { src: 'app/components/jet_ui/accordion/component.rb',                                              dest: 'app/components/jet_ui/accordion/component.rb' },
+            { src: 'app/components/jet_ui/accordion/summary_component.rb',                                      dest: 'app/components/jet_ui/accordion/summary_component.rb' },
+            { src: 'app/components/jet_ui/accordion/body_component.rb',                                         dest: 'app/components/jet_ui/accordion/body_component.rb' },
+            { src: 'test/components/jet_ui/accordion/component_test.rb',                                        dest: 'test/components/jet_ui/accordion/component_test.rb',                     type: :test },
+            { src: 'test/components/previews/jet_ui/accordion/component_preview.rb',                            dest: 'test/components/previews/jet_ui/accordion/component_preview.rb',         type: :preview }
+          ]
+        },
+        'clipboard' => {
+          files: [
+            { src: 'app/components/jet_ui/clipboard/component.rb',                                              dest: 'app/components/jet_ui/clipboard/component.rb' },
+            { src: 'app/assets/javascripts/jet_ui/clipboard_controller.js',                                     dest: 'app/assets/javascripts/jet_ui/clipboard_controller.js',                  type: :javascript },
+            { src: 'test/components/jet_ui/clipboard/component_test.rb',                                        dest: 'test/components/jet_ui/clipboard/component_test.rb',                     type: :test },
+            { src: 'test/components/previews/jet_ui/clipboard/component_preview.rb',                            dest: 'test/components/previews/jet_ui/clipboard/component_preview.rb',         type: :preview }
+          ]
+        },
+        'sidebar' => {
+          files: [
+            { src: 'app/components/jet_ui/sidebar/component.rb',                                                dest: 'app/components/jet_ui/sidebar/component.rb' },
+            { src: 'app/components/jet_ui/sidebar/link_component.rb',                                           dest: 'app/components/jet_ui/sidebar/link_component.rb' },
+            { src: 'app/components/jet_ui/sidebar/menu_component.rb',                                           dest: 'app/components/jet_ui/sidebar/menu_component.rb' },
+            { src: 'app/components/jet_ui/sidebar/section_component.rb',                                        dest: 'app/components/jet_ui/sidebar/section_component.rb' },
+            { src: 'app/components/jet_ui/sidebar/title_component.rb',                                          dest: 'app/components/jet_ui/sidebar/title_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/sidebar.css',                                                 dest: 'app/assets/stylesheets/jet_ui/sidebar.css' },
+            { src: 'test/components/jet_ui/sidebar/component_test.rb',                                          dest: 'test/components/jet_ui/sidebar/component_test.rb',                      type: :test },
+            { src: 'test/components/previews/jet_ui/sidebar/component_preview.rb',                              dest: 'test/components/previews/jet_ui/sidebar/component_preview.rb',          type: :preview }
+          ]
+        },
+        'header' => {
+          files: [
+            { src: 'app/components/jet_ui/header/component.rb',                                                 dest: 'app/components/jet_ui/header/component.rb' },
+            { src: 'app/components/jet_ui/header/heading_component.rb',                                         dest: 'app/components/jet_ui/header/heading_component.rb' },
+            { src: 'app/components/jet_ui/header/title_component.rb',                                           dest: 'app/components/jet_ui/header/title_component.rb' },
+            { src: 'app/components/jet_ui/header/subtitle_component.rb',                                        dest: 'app/components/jet_ui/header/subtitle_component.rb' },
+            { src: 'app/components/jet_ui/header/actions_component.rb',                                         dest: 'app/components/jet_ui/header/actions_component.rb' },
+            { src: 'test/components/jet_ui/header/component_test.rb',                                           dest: 'test/components/jet_ui/header/component_test.rb',                       type: :test },
+            { src: 'test/components/previews/jet_ui/header/component_preview.rb',                               dest: 'test/components/previews/jet_ui/header/component_preview.rb',           type: :preview }
+          ]
+        },
+        'navbar' => {
+          files: [
+            { src: 'app/components/jet_ui/navbar/component.rb',                                                 dest: 'app/components/jet_ui/navbar/component.rb' },
+            { src: 'app/components/jet_ui/navbar/brand_component.rb',                                           dest: 'app/components/jet_ui/navbar/brand_component.rb' },
+            { src: 'app/components/jet_ui/navbar/content_component.rb',                                         dest: 'app/components/jet_ui/navbar/content_component.rb' },
+            { src: 'app/components/jet_ui/navbar/main_component.rb',                                            dest: 'app/components/jet_ui/navbar/main_component.rb' },
+            { src: 'app/components/jet_ui/navbar/actions_component.rb',                                         dest: 'app/components/jet_ui/navbar/actions_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/navbar.css',                                                  dest: 'app/assets/stylesheets/jet_ui/navbar.css' },
+            { src: 'test/components/jet_ui/navbar/component_test.rb',                                           dest: 'test/components/jet_ui/navbar/component_test.rb',                       type: :test },
+            { src: 'test/components/previews/jet_ui/navbar/component_preview.rb',                               dest: 'test/components/previews/jet_ui/navbar/component_preview.rb',           type: :preview }
+          ]
+        },
+        'modal' => {
+          files: [
+            { src: 'app/components/jet_ui/modal/component.rb',                                                  dest: 'app/components/jet_ui/modal/component.rb' },
+            { src: 'app/components/jet_ui/modal/header_component.rb',                                           dest: 'app/components/jet_ui/modal/header_component.rb' },
+            { src: 'app/components/jet_ui/modal/body_component.rb',                                             dest: 'app/components/jet_ui/modal/body_component.rb' },
+            { src: 'app/components/jet_ui/modal/footer_component.rb',                                           dest: 'app/components/jet_ui/modal/footer_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/modal.css',                                                   dest: 'app/assets/stylesheets/jet_ui/modal.css' },
+            { src: 'app/assets/javascripts/jet_ui/modal_controller.js',                                         dest: 'app/assets/javascripts/jet_ui/modal_controller.js',                     type: :javascript },
+            { src: 'app/assets/javascripts/jet_ui/modals_controller.js',                                        dest: 'app/assets/javascripts/jet_ui/modals_controller.js',                    type: :javascript },
+            { src: 'test/components/jet_ui/modal/component_test.rb',                                            dest: 'test/components/jet_ui/modal/component_test.rb',                        type: :test },
+            { src: 'test/components/previews/jet_ui/modal/component_preview.rb',                                dest: 'test/components/previews/jet_ui/modal/component_preview.rb',            type: :preview }
+          ]
+        },
+        'drawer' => {
+          files: [
+            { src: 'app/components/jet_ui/drawer/component.rb',                                                 dest: 'app/components/jet_ui/drawer/component.rb' },
+            { src: 'app/components/jet_ui/drawer/header_component.rb',                                          dest: 'app/components/jet_ui/drawer/header_component.rb' },
+            { src: 'app/components/jet_ui/drawer/body_component.rb',                                            dest: 'app/components/jet_ui/drawer/body_component.rb' },
+            { src: 'app/components/jet_ui/drawer/footer_component.rb',                                          dest: 'app/components/jet_ui/drawer/footer_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/drawer.css',                                                  dest: 'app/assets/stylesheets/jet_ui/drawer.css' },
+            { src: 'app/assets/javascripts/jet_ui/drawer_controller.js',                                        dest: 'app/assets/javascripts/jet_ui/drawer_controller.js',                    type: :javascript },
+            { src: 'app/assets/javascripts/jet_ui/drawers_controller.js',                                       dest: 'app/assets/javascripts/jet_ui/drawers_controller.js',                   type: :javascript },
+            { src: 'test/components/jet_ui/drawer/component_test.rb',                                           dest: 'test/components/jet_ui/drawer/component_test.rb',                       type: :test },
+            { src: 'test/components/previews/jet_ui/drawer/component_preview.rb',                               dest: 'test/components/previews/jet_ui/drawer/component_preview.rb',           type: :preview }
+          ]
+        },
+        'dropdown' => {
+          files: [
+            { src: 'app/components/jet_ui/dropdown/component.rb',                                               dest: 'app/components/jet_ui/dropdown/component.rb' },
+            { src: 'app/components/jet_ui/dropdown/trigger_component.rb',                                       dest: 'app/components/jet_ui/dropdown/trigger_component.rb' },
+            { src: 'app/components/jet_ui/dropdown/menu_component.rb',                                          dest: 'app/components/jet_ui/dropdown/menu_component.rb' },
+            { src: 'app/components/jet_ui/dropdown/link_component.rb',                                          dest: 'app/components/jet_ui/dropdown/link_component.rb' },
+            { src: 'app/components/jet_ui/dropdown/button_component.rb',                                        dest: 'app/components/jet_ui/dropdown/button_component.rb' },
+            { src: 'app/components/jet_ui/dropdown/title_component.rb',                                         dest: 'app/components/jet_ui/dropdown/title_component.rb' },
+            { src: 'app/components/jet_ui/dropdown/divider_component.rb',                                       dest: 'app/components/jet_ui/dropdown/divider_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/dropdown.css',                                                dest: 'app/assets/stylesheets/jet_ui/dropdown.css' },
+            { src: 'app/assets/javascripts/jet_ui/dropdown_controller.js',                                      dest: 'app/assets/javascripts/jet_ui/dropdown_controller.js',                  type: :javascript },
+            { src: 'test/components/jet_ui/dropdown/component_test.rb',                                         dest: 'test/components/jet_ui/dropdown/component_test.rb',                     type: :test },
+            { src: 'test/components/previews/jet_ui/dropdown/component_preview.rb',                             dest: 'test/components/previews/jet_ui/dropdown/component_preview.rb',         type: :preview }
+          ]
+        },
+        'tooltip' => {
+          files: [
+            { src: 'app/components/jet_ui/tooltip/component.rb',                                                dest: 'app/components/jet_ui/tooltip/component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/tooltip.css',                                                 dest: 'app/assets/stylesheets/jet_ui/tooltip.css' },
+            { src: 'app/assets/javascripts/jet_ui/tooltip_controller.js',                                       dest: 'app/assets/javascripts/jet_ui/tooltip_controller.js',                   type: :javascript },
+            { src: 'test/components/jet_ui/tooltip/component_test.rb',                                          dest: 'test/components/jet_ui/tooltip/component_test.rb',                      type: :test },
+            { src: 'test/components/previews/jet_ui/tooltip/component_preview.rb',                              dest: 'test/components/previews/jet_ui/tooltip/component_preview.rb',          type: :preview }
+          ]
+        },
+        'popover' => {
+          files: [
+            { src: 'app/components/jet_ui/popover/component.rb',                                                dest: 'app/components/jet_ui/popover/component.rb' },
+            { src: 'app/components/jet_ui/popover/trigger_component.rb',                                        dest: 'app/components/jet_ui/popover/trigger_component.rb' },
+            { src: 'app/components/jet_ui/popover/content_component.rb',                                        dest: 'app/components/jet_ui/popover/content_component.rb' },
+            { src: 'app/assets/stylesheets/jet_ui/popover.css',                                                 dest: 'app/assets/stylesheets/jet_ui/popover.css' },
+            { src: 'app/assets/javascripts/jet_ui/popover_controller.js',                                       dest: 'app/assets/javascripts/jet_ui/popover_controller.js',                   type: :javascript },
+            { src: 'test/components/jet_ui/popover/component_test.rb',                                          dest: 'test/components/jet_ui/popover/component_test.rb',                      type: :test },
+            { src: 'test/components/previews/jet_ui/popover/component_preview.rb',                              dest: 'test/components/previews/jet_ui/popover/component_preview.rb',          type: :preview }
+          ]
+        },
+        'turbo_confirm' => {
+          files: [
+            { src: 'app/components/jet_ui/turbo_confirm/component.rb',                                          dest: 'app/components/jet_ui/turbo_confirm/component.rb' },
+            { src: 'app/components/jet_ui/turbo_confirm/component.html.erb',                                    dest: 'app/components/jet_ui/turbo_confirm/component.html.erb' },
+            { src: 'app/assets/javascripts/jet_ui/turbo_confirm_controller.js', dest: 'app/assets/javascripts/jet_ui/turbo_confirm_controller.js', type: :javascript },
+            { src: 'test/components/jet_ui/turbo_confirm/component_test.rb',                                    dest: 'test/components/jet_ui/turbo_confirm/component_test.rb',                type: :test },
+            { src: 'test/components/previews/jet_ui/turbo_confirm/component_preview.rb',                        dest: 'test/components/previews/jet_ui/turbo_confirm/component_preview.rb',    type: :preview }
+          ]
+        }
+      }.freeze
+
+      def eject_components
+        unknown = components.map(&:downcase) - MANIFEST.keys
+        if unknown.any?
+          say "\nUnknown component(s): #{unknown.join(', ')}", :red
+          say "Available: #{MANIFEST.keys.join(', ')}\n", :red
+          exit 1
+        end
+
+        components.map(&:downcase).each do |name|
+          say "\nEjecting #{name}...", :cyan
+          MANIFEST[name][:files].each do |entry|
+            next if entry[:type] == :test       && options[:skip_test]
+            next if entry[:type] == :preview    && options[:skip_preview]
+            next if entry[:type] == :javascript && options[:skip_javascript]
+
+            copy_file entry[:src], entry[:dest]
+          end
+          say "  #{name} ejected.", :green
+        end
+      end
+
+      def show_summary
+        skipped = []
+        skipped << 'tests'      if options[:skip_test]
+        skipped << 'previews'   if options[:skip_preview]
+        skipped << 'javascript' if options[:skip_javascript]
+
+        say "\nDone! Ejected: #{components.map(&:downcase).join(', ')}", :green
+        say "  (skipped: #{skipped.join(', ')})" if skipped.any?
+        say "\nThe local files in app/components/jet_ui/ now take precedence over the gem."
+        say "Run your tests to confirm everything still works:\n"
+        say "  bundle exec rake test\n"
+      end
+    end
+  end
+end

data/lib/generators/jet_ui/install/USAGE

@@ -0,0 +1,11 @@
+Description:
+    Sets up JetUi in your Rails application.
+
+    - Injects the JetUi CSS import into your Tailwind entrypoint
+    - Registers JetUi Stimulus controllers via eagerLoadControllersFrom
+      (requires @hotwired/stimulus-loading, included in default Rails apps)
+
+    Safe to run multiple times — already-configured steps are skipped.
+
+Example:
+    rails generate jet_ui:install

data/lib/generators/jet_ui/install/install_generator.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module JetUi
+  module Generators
+    # Sets up JetUi in the host Rails application.
+    #
+    # Usage:
+    #   rails generate jet_ui:install
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      desc <<~DESC
+        Sets up JetUi in your Rails application.
+
+        1. CSS — Detects your Tailwind source file and injects a single @import
+           that covers all JetUi component stylesheets. New components added in
+           future gem updates are picked up automatically on the next CSS build.
+
+        2. JS — Adds eagerLoadControllersFrom("jet_ui", application) to your
+           Stimulus controllers index. All current and future JetUi Stimulus
+           controllers (flash, modal, etc.) are registered automatically when
+           you update the gem — no further changes needed.
+
+        Safe to run multiple times — already-configured steps are skipped.
+
+        Supported Tailwind source file locations:
+          app/assets/tailwind/application.css
+          app/assets/stylesheets/application.tailwind.css
+          app/assets/stylesheets/application.postcss.css
+
+        Example:
+          rails generate jet_ui:install
+      DESC
+
+      def inject_css
+        if (file = tailwind_source_file)
+          content = File.read(File.join(destination_root, file))
+          if content.include?('jet_ui')
+            say "  JetUi CSS already imported in #{file}", :yellow
+          else
+            # Tailwind CSS v4: import each file with an absolute path so the
+            # Tailwind CLI can process @apply directives at build time.
+            append_to_file file, tailwind_imports
+            say "  Injected JetUi imports into #{file}", :green
+          end
+        else
+          say '  Could not detect a Tailwind CSS source file.', :yellow
+          say '  Add the following to your Tailwind CSS source manually:', :yellow
+          say tailwind_imports, :yellow
+        end
+      end
+
+      def inject_js
+        path = File.join(destination_root, JS_CONTROLLERS_FILE)
+        unless File.exist?(path)
+          say '  No Stimulus controllers index found — skipping JS setup.', :yellow
+          say '  If you use Stimulus, add this line to your controllers index manually:', :yellow
+          say %(    eagerLoadControllersFrom("jet_ui", application)), :yellow
+          return
+        end
+
+        if File.read(path).include?('jet_ui')
+          say "  JetUi controllers already registered in #{JS_CONTROLLERS_FILE}", :yellow
+        else
+          insert_into_file JS_CONTROLLERS_FILE, after: /eagerLoadControllersFrom\("controllers".*\n/ do
+            %(eagerLoadControllersFrom("jet_ui", application)\n)
+          end
+          say "  Registered JetUi controllers in #{JS_CONTROLLERS_FILE}", :green
+        end
+      end
+
+      def show_usage
+        say "\nJetUi installed!\n", :green
+        say 'Add flash messages to your layout (e.g. app/views/layouts/application.html.erb):'
+        say %(  <%= jet_ui.flash(messages: flash) %>\n)
+        say 'Usage in your views:'
+        say %(  <%= jet_ui.btn variant: :default do %>Save<% end %>)
+        say %(  <%= jet_ui.card do %>)
+        say %(    <%= jet_ui.card_header do %>)
+        say %(      <%= jet_ui.card_title "Hello" %>)
+        say %(    <% end %>)
+        say %(    <%= jet_ui.card_body do %>Content<% end %>)
+        say %(  <% end %>\n)
+        say 'To eject a component for local customization:'
+        say '  rails generate jet_ui:eject btn'
+        say '  rails generate jet_ui:eject card'
+        say "  rails generate jet_ui:eject btn card\n"
+      end
+
+      JS_CONTROLLERS_FILE = 'app/javascript/controllers/index.js'
+
+      TAILWIND_SOURCE_FILES = %w[
+        app/assets/tailwind/application.css
+        app/assets/stylesheets/application.tailwind.css
+        app/assets/stylesheets/application.postcss.css
+      ].freeze
+
+      private
+
+      def tailwind_source_file
+        TAILWIND_SOURCE_FILES.find { |f| File.exist?(File.join(destination_root, f)) }
+      end
+
+      def gem_stylesheets_path
+        spec = begin
+          Gem::Specification.find_by_name('jet_ui')
+        rescue
+          nil
+        end
+        base = spec&.gem_dir || File.expand_path('../../../../..', __dir__)
+        File.join(base, 'app/assets/stylesheets')
+      end
+
+      def tailwind_imports
+        %(\n@import "#{File.join(gem_stylesheets_path, 'jet_ui.css')}";\n)
+      end
+    end
+  end
+end

data/lib/jet_ui/engine.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module JetUi
+  class Engine < ::Rails::Engine
+    config.autoload_paths << root.join('app/components')
+
+    initializer 'jet_ui.view_component' do |app|
+      if app.config.respond_to?(:view_component)
+        app.config.view_component.preview_paths ||= []
+        app.config.view_component.preview_paths << root.join('test/components/previews').to_s
+      end
+    end
+
+    initializer 'jet_ui.importmap', after: 'importmap' do |app|
+      if app.respond_to?(:importmap)
+        app.importmap.pin_all_from(
+          root.join('app/assets/javascripts/jet_ui'),
+          under: 'jet_ui'
+        )
+        app.config.importmap.paths << root.join('app/assets/javascripts')
+        app.config.importmap.cache_sweepers << root.join('app/assets/javascripts')
+      end
+    end
+
+    initializer 'jet_ui.helpers' do
+      require root.join('app/helpers/jet_ui_helper').to_s
+      ActiveSupport.on_load(:action_view) do
+        include JetUiHelper
+      end
+    end
+  end
+end

data/lib/jet_ui/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module JetUi
+  VERSION = '0.2.4'
+end

data/lib/jet_ui.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'view_component'
+require 'jet_ui/version'
+require 'jet_ui/engine'