hakumi_components 0.1.13.pre → 0.1.14.pre

data/app/form_builders/hakumi/form_builder.rb

@@ -70,7 +70,7 @@ module Hakumi
     # @param options [Hash] Options for the select
     # @return [String] Rendered HTML
     def select(method, choices = nil, **options)
-      choices ||= []
+      choices ||= [] # steep:ignore UnannotatedEmptyCollection
       enhance_options_with_introspection!(method, options)
 
       # Get field configuration
@@ -96,7 +96,7 @@ module Hakumi
     # @param options [Hash] Options for the tree select
     # @return [String] Rendered HTML
     def tree_select(method, choices = nil, **options)
-      choices ||= []
+      choices ||= [] # steep:ignore UnannotatedEmptyCollection
       enhance_options_with_introspection!(method, options)
 
       # Get field configuration

data/app/javascript/hakumi_components/_controllers_manifest.js

@@ -0,0 +1,151 @@
+// Hakumi Components - Controller Manifest
+// Add new controllers here when creating new components
+
+// Admin & Layout
+import AdminPanelController from "./controllers/hakumi/admin_panel_controller.js"
+import AffixController from "./controllers/hakumi/affix_controller.js"
+import AnchorController from "./controllers/hakumi/anchor_controller.js"
+import BackTopController from "./controllers/hakumi/back_top_controller.js"
+import SplitterController from "./controllers/hakumi/splitter_controller.js"
+
+// Feedback
+import AlertController from "./controllers/hakumi/alert_controller.js"
+import DrawerController from "./controllers/hakumi/drawer_controller.js"
+import MessageController from "./controllers/hakumi/message_controller.js"
+import ModalController from "./controllers/hakumi/modal_controller.js"
+import ModalTriggerController from "./controllers/hakumi/modal_trigger_controller.js"
+import NotificationController from "./controllers/hakumi/notification_controller.js"
+import PopconfirmController from "./controllers/hakumi/popconfirm_controller.js"
+import PopoverController from "./controllers/hakumi/popover_controller.js"
+import ProgressController from "./controllers/hakumi/progress_controller.js"
+import SpinController from "./controllers/hakumi/spin_controller.js"
+import TooltipController from "./controllers/hakumi/tooltip_controller.js"
+import TourController from "./controllers/hakumi/tour_controller.js"
+
+// Data Display
+import AvatarTextController from "./controllers/hakumi/avatar_text_controller.js"
+import CalendarController from "./controllers/hakumi/calendar_controller.js"
+import CarouselController from "./controllers/hakumi/carousel_controller.js"
+import CollapseController from "./controllers/hakumi/collapse_controller.js"
+import ImageController from "./controllers/hakumi/image_controller.js"
+import QrCodeController from "./controllers/hakumi/qr_code_controller.js"
+import SegmentedController from "./controllers/hakumi/segmented_controller.js"
+import StatisticController from "./controllers/hakumi/statistic_controller.js"
+import TableController from "./controllers/hakumi/table_controller.js"
+import TabsController from "./controllers/hakumi/tabs_controller.js"
+import TagController from "./controllers/hakumi/tag_controller.js"
+import TagGroupController from "./controllers/hakumi/tag_group_controller.js"
+import TimelineController from "./controllers/hakumi/timeline_controller.js"
+import TreeController from "./controllers/hakumi/tree_controller.js"
+
+// Navigation
+import ButtonController from "./controllers/hakumi/button_controller.js"
+import DropdownController from "./controllers/hakumi/dropdown_controller.js"
+import FloatButtonGroupController from "./controllers/hakumi/float_button_group_controller.js"
+import MenuController from "./controllers/hakumi/menu_controller.js"
+import PaginationController from "./controllers/hakumi/pagination_controller.js"
+import StepsController from "./controllers/hakumi/steps_controller.js"
+
+// Form Controls
+import AutocompleteController from "./controllers/hakumi/autocomplete_controller.js"
+import CascaderController from "./controllers/hakumi/cascader_controller.js"
+import CheckboxController from "./controllers/hakumi/checkbox_controller.js"
+import CheckboxGroupController from "./controllers/hakumi/checkbox_group_controller.js"
+import ColorPickerController from "./controllers/hakumi/color_picker_controller.js"
+import DatePickerController from "./controllers/hakumi/date_picker_controller.js"
+import FormItemController from "./controllers/hakumi/form_item_controller.js"
+import InputController from "./controllers/hakumi/input_controller.js"
+import InputNumberController from "./controllers/hakumi/input_number_controller.js"
+import InputPasswordController from "./controllers/hakumi/input_password_controller.js"
+import InputTextareaController from "./controllers/hakumi/input_textarea_controller.js"
+import MentionsController from "./controllers/hakumi/mentions_controller.js"
+import RadioController from "./controllers/hakumi/radio_controller.js"
+import RateController from "./controllers/hakumi/rate_controller.js"
+import SelectController from "./controllers/hakumi/select_controller.js"
+import SliderController from "./controllers/hakumi/slider_controller.js"
+import SwitchController from "./controllers/hakumi/switch_controller.js"
+import TimePickerController from "./controllers/hakumi/time_picker_controller.js"
+import TransferController from "./controllers/hakumi/transfer_controller.js"
+import TreeSelectController from "./controllers/hakumi/tree_select_controller.js"
+import UploadController from "./controllers/hakumi/upload_controller.js"
+
+// Typography & Theme
+import ThemeController from "./controllers/hakumi/theme_controller.js"
+import TypographyController from "./controllers/hakumi/typography_controller.js"
+
+// Export controllers object
+export const controllers = {
+    // Admin & Layout
+    "hakumi--admin-panel": AdminPanelController,
+    "hakumi--affix": AffixController,
+    "hakumi--anchor": AnchorController,
+    "hakumi--back-top": BackTopController,
+    "hakumi--splitter": SplitterController,
+
+    // Feedback
+    "hakumi--alert": AlertController,
+    "hakumi--drawer": DrawerController,
+    "hakumi--message": MessageController,
+    "hakumi--modal": ModalController,
+    "hakumi--modal-trigger": ModalTriggerController,
+    "hakumi--notification": NotificationController,
+    "hakumi--popconfirm": PopconfirmController,
+    "hakumi--popover": PopoverController,
+    "hakumi--progress": ProgressController,
+    "hakumi--spin": SpinController,
+    "hakumi--tooltip": TooltipController,
+    "hakumi--tour": TourController,
+
+    // Data Display
+    "hakumi--avatar-text": AvatarTextController,
+    "hakumi--calendar": CalendarController,
+    "hakumi--carousel": CarouselController,
+    "hakumi--collapse": CollapseController,
+    "hakumi--image": ImageController,
+    "hakumi--qr-code": QrCodeController,
+    "hakumi--segmented": SegmentedController,
+    "hakumi--statistic": StatisticController,
+    "hakumi--table": TableController,
+    "hakumi--tabs": TabsController,
+    "hakumi--tag": TagController,
+    "hakumi--tag-group": TagGroupController,
+    "hakumi--timeline": TimelineController,
+    "hakumi--tree": TreeController,
+
+    // Navigation
+    "hakumi--button": ButtonController,
+    "hakumi--dropdown": DropdownController,
+    "hakumi--float-button-group": FloatButtonGroupController,
+    "hakumi--menu": MenuController,
+    "hakumi--pagination": PaginationController,
+    "hakumi--steps": StepsController,
+
+    // Form Controls
+    "hakumi--autocomplete": AutocompleteController,
+    "hakumi--cascader": CascaderController,
+    "hakumi--checkbox": CheckboxController,
+    "hakumi--checkbox-group": CheckboxGroupController,
+    "hakumi--color-picker": ColorPickerController,
+    "hakumi--date-picker": DatePickerController,
+    "hakumi--form-item": FormItemController,
+    "hakumi--input": InputController,
+    "hakumi--input-number": InputNumberController,
+    "hakumi--input-password": InputPasswordController,
+    "hakumi--input-textarea": InputTextareaController,
+    "hakumi--mentions": MentionsController,
+    "hakumi--radio": RadioController,
+    "hakumi--rate": RateController,
+    "hakumi--select": SelectController,
+    "hakumi--slider": SliderController,
+    "hakumi--switch": SwitchController,
+    "hakumi--time-picker": TimePickerController,
+    "hakumi--transfer": TransferController,
+    "hakumi--tree-select": TreeSelectController,
+    "hakumi--upload": UploadController,
+
+    // Typography & Theme
+    "hakumi--theme": ThemeController,
+    "hakumi--typography": TypographyController,
+}
+
+export default controllers

data/app/javascript/hakumi_components/controllers/hakumi/admin_panel_controller.js

@@ -1,5 +1,5 @@
 import RegistryController from "../base/registry_controller.js"
-import { Persistence } from "../../index.js"
+import { Persistence } from "../../core/persistence.js"
 const STATE_LABELS = {
   open: { true: "open", false: "closed" },
   visible: { true: "visible", false: "hidden" },

data/app/javascript/hakumi_components/controllers/hakumi/drawer_controller.js

@@ -1,5 +1,5 @@
 import RegistryController from "../base/registry_controller.js"
-import { ensureOverlayContainer } from "../../index.js"
+import { ensureOverlayContainer } from "../../core/overlay_container.js"
 
 export default class extends RegistryController {
     static targets = ["mask", "wrapper", "body"]

data/app/javascript/hakumi_components/controllers/hakumi/modal_controller.js

@@ -1,5 +1,5 @@
 import RegistryController from "../base/registry_controller.js"
-import { ensureOverlayContainer } from "../../index.js"
+import { ensureOverlayContainer } from "../../core/overlay_container.js"
 
 export default class extends RegistryController {
     static targets = ["mask", "wrapper"]

data/app/javascript/hakumi_components/controllers/hakumi/notification_controller.js

@@ -1,5 +1,5 @@
 import RegistryController from "../base/registry_controller.js"
-import { Persistence } from "../../index.js"
+import { Persistence } from "../../core/persistence.js"
 
 const DEFAULT_DURATION = 4.5
 const NOTICE_ANIMATION_MS = 200

data/app/javascript/hakumi_components/controllers/hakumi/theme_controller.js

@@ -1,5 +1,5 @@
 import RegistryController from "../base/registry_controller.js"
-import { Persistence } from "../../index.js"
+import { Persistence } from "../../core/persistence.js"
 
 export default class extends RegistryController {
     static values = {

data/app/javascript/hakumi_components/core/overlay_container.js

@@ -0,0 +1,22 @@
+// Create global overlay container for Modal, Drawer, etc.
+export const ensureOverlayContainer = () => {
+  if (typeof document === "undefined") return null
+
+  const existingContainer = document.getElementById("hakumi-overlay-root")
+  if (existingContainer) return existingContainer
+
+  const container = document.createElement("div")
+  container.id = "hakumi-overlay-root"
+  container.setAttribute("data-hakumi-overlay-container", "")
+
+  // Wait for DOM to be ready
+  if (document.body) {
+    document.body.appendChild(container)
+  } else {
+    document.addEventListener("DOMContentLoaded", () => {
+      document.body.appendChild(container)
+    })
+  }
+
+  return container
+}

data/app/javascript/hakumi_components/index.js

@@ -2,30 +2,9 @@ import { renderComponent } from "./core/render_component.js"
 import { register, unregister, get, list } from "./core/registry.js"
 import { ensureId } from "./core/dom.js"
 import { Persistence } from "./core/persistence.js"
+import { ensureOverlayContainer } from "./core/overlay_container.js"
 import DateHelper from "./utils/date_helper.js"
-
-// Create global overlay container for Modal, Drawer, etc.
-const ensureOverlayContainer = () => {
-    if (typeof document === "undefined") return null
-
-    const existingContainer = document.getElementById("hakumi-overlay-root")
-    if (existingContainer) return existingContainer
-
-    const container = document.createElement("div")
-    container.id = "hakumi-overlay-root"
-    container.setAttribute("data-hakumi-overlay-container", "")
-
-    // Wait for DOM to be ready
-    if (document.body) {
-        document.body.appendChild(container)
-    } else {
-        document.addEventListener("DOMContentLoaded", () => {
-            document.body.appendChild(container)
-        })
-    }
-
-    return container
-}
+import { controllers as hakumiControllers } from "./_controllers_manifest.js"
 
 export { renderComponent, register, unregister, get, list, ensureId, Persistence, ensureOverlayContainer, DateHelper }
 export { default as RegistryController } from "./controllers/base/registry_controller.js"
@@ -50,29 +29,20 @@ if (typeof window !== "undefined") {
 export const registerHakumiControllers = (application) => {
     if (!application) throw new Error("[HakumiComponents] Missing Stimulus application")
 
-    // Use eager loading for now - Vite will handle code-splitting via manual chunks
-    const controllers = import.meta.glob("./controllers/hakumi/**/*_controller.js", { eager: true })
-
-    const classes = Object.values(controllers).map((m) => m.default).filter(Boolean)
-
-    for (const C of classes) {
-        if (typeof C.mount === "function") {
+    // Call mount() on controllers that support it
+    for (const Controller of Object.values(hakumiControllers)) {
+        if (typeof Controller.mount === "function") {
             try {
-                C.mount()
+                Controller.mount()
             } catch (e) {
                 console.error("[HakumiComponents] mount() failed", e)
             }
         }
     }
 
-    Object.entries(controllers).forEach(([path, mod]) => {
-        const name = path
-            .replace("./controllers/", "")
-            .replace("_controller.js", "")
-            .replace(/\//g, "--")
-            .replace(/_/g, "-")
-
-        application.register(name, mod.default)
+    // Register all controllers with Stimulus
+    Object.entries(hakumiControllers).forEach(([name, Controller]) => {
+        application.register(name, Controller)
     })
 }
 

data/lib/generators/hakumi/install_generator.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module Hakumi
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path("templates", __dir__)
+
+    desc "Install Hakumi Components in your Rails application"
+
+    def add_npm_package
+      say "Adding @hakumi-dev/hakumi-components to package.json...", :green
+      run "yarn add @hakumi-dev/hakumi-components"
+    end
+
+    def setup_javascript
+      say "Setting up JavaScript...", :green
+
+      js_file = "app/javascript/controllers/index.js"
+
+      if File.exist?(js_file)
+        content = File.read(js_file)
+
+        unless content.include?("hakumi-components")
+          # Add import at the top
+          import_line = 'import { registerHakumiControllers } from "@hakumi-dev/hakumi-components"'
+
+          # Add registration after Stimulus setup
+          register_line = "registerHakumiControllers(application)"
+
+          # Insert import after other imports
+          if content.include?("import")
+            # Find the last import line and add after it
+            lines = content.split("\n")
+            last_import_index = lines.rindex { |line| line.start_with?("import ") }
+
+            if last_import_index
+              lines.insert(last_import_index + 1, import_line)
+              content = lines.join("\n")
+            end
+          else
+            content = "#{import_line}\n#{content}"
+          end
+
+          # Add registration at the end if not present
+          unless content.include?("registerHakumiControllers")
+            content += "\n#{register_line}\n"
+          end
+
+          File.write(js_file, content)
+          say "  Updated #{js_file}", :green
+        else
+          say "  #{js_file} already configured", :yellow
+        end
+      else
+        say "  Could not find #{js_file}. Please add manually:", :yellow
+        say '    import { registerHakumiControllers } from "@hakumi-dev/hakumi-components"'
+        say "    registerHakumiControllers(application)"
+      end
+    end
+
+    def setup_stylesheets
+      say "Setting up stylesheets...", :green
+
+      # Check for different stylesheet configurations
+      scss_files = [
+        "app/assets/stylesheets/application.scss",
+        "app/assets/stylesheets/application.css.scss",
+        "app/javascript/stylesheets/application.scss"
+      ]
+
+      css_files = [
+        "app/assets/stylesheets/application.css"
+      ]
+
+      scss_file = scss_files.find { |f| File.exist?(f) }
+      css_file = css_files.find { |f| File.exist?(f) }
+
+      if scss_file
+        content = File.read(scss_file)
+        import_line = '@import "@hakumi-dev/hakumi-components/styles";'
+
+        unless content.include?("hakumi-components")
+          File.write(scss_file, "#{import_line}\n#{content}")
+          say "  Updated #{scss_file}", :green
+        else
+          say "  #{scss_file} already configured", :yellow
+        end
+      elsif css_file
+        say "  Found CSS file. For full styling support, rename to .scss and add:", :yellow
+        say '    @import "@hakumi-dev/hakumi-components/styles";'
+      else
+        say "  Could not find stylesheet. Please add manually:", :yellow
+        say '    @import "@hakumi-dev/hakumi-components/styles";'
+      end
+    end
+
+    def setup_form_builder
+      say "Setting up FormBuilder...", :green
+
+      initializer_file = "config/initializers/hakumi_components.rb"
+
+      if File.exist?(initializer_file)
+        say "  #{initializer_file} already exists", :yellow
+      else
+        create_file initializer_file, <<~RUBY
+          # frozen_string_literal: true
+
+          # Configure default form builder for Hakumi Components
+          Rails.application.config.action_view.default_form_builder = Hakumi::FormBuilder
+        RUBY
+        say "  Created #{initializer_file}", :green
+      end
+    end
+
+    def show_post_install
+      say ""
+      say "=" * 60, :green
+      say "Hakumi Components installed successfully!", :green
+      say "=" * 60, :green
+      say ""
+      say "Next steps:"
+      say "  1. Restart your Rails server"
+      say "  2. Start using components in your views:"
+      say ""
+      say "     <%= render Hakumi::Button::Component.new(type: :primary) do %>"
+      say "       Click me"
+      say "     <% end %>"
+      say ""
+      say "Documentation: https://github.com/hakumi-dev/hakumi-components"
+      say ""
+    end
+  end
+end

data/lib/hakumi_components/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HakumiComponents
-  VERSION = "0.1.13.pre"
+  VERSION = "0.1.14.pre"
 end

data/sig/generators/hakumi/install_generator.rbs

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Hakumi
+  class InstallGenerator < Rails::Generators::Base
+    def add_npm_package: () -> void
+    def setup_javascript: () -> void
+    def setup_stylesheets: () -> void
+    def setup_form_builder: () -> void
+    def show_post_install: () -> void
+  end
+end

data/sig/hakumi/form_builder.rbs

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Hakumi
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    # Public methods - use untyped for options hash to avoid type conflicts with Rails
+    def text_field: (Symbol method, **untyped options) -> String
+    def password_field: (Symbol method, **untyped options) -> String
+    def text_area: (Symbol method, **untyped options) -> String
+    def number_field: (Symbol method, **untyped options) -> String
+    def radio_button: (Symbol method, untyped tag_value, **untyped options) -> String
+    def collection_radio_buttons: (Symbol method, untyped collection, untyped value_method, untyped text_method, **untyped options) -> String
+    def check_box: (Symbol method, **untyped options) -> String
+    def select: (Symbol method, untyped? choices, **untyped options) -> String
+    def tree_select: (Symbol method, untyped? choices, **untyped options) -> String
+    def date_picker: (Symbol method, **untyped options) -> String
+    def mentions_field: (Symbol method, **untyped options) -> String
+    def slider_field: (Symbol method, **untyped options) -> String
+    def rate_field: (Symbol method, **untyped options) -> String
+    def submit: (String? value, **untyped options) -> String
+
+    private
+
+    # Private helper methods
+    def enhance_options_with_introspection!: (Symbol method, Hash[Symbol, untyped] options) -> (Hash[Symbol, untyped] | nil)
+    def render_form_field: (Class component_class, Symbol method, **untyped options) -> String
+    def object_value: (Symbol method) -> untyped
+    def object_errors: (Symbol method) -> Array[String]
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hakumi_components
 version: !ruby/object:Gem::Version
-  version: 0.1.13.pre
+  version: 0.1.14.pre
 platform: ruby
 authors:
 - kb714
@@ -1109,6 +1109,7 @@ files:
 - app/components/hakumi/upload/component.rb
 - app/controllers/hakumi_components/components_controller.rb
 - app/form_builders/hakumi/form_builder.rb
+- app/javascript/hakumi_components/_controllers_manifest.js
 - app/javascript/hakumi_components/boot.js
 - app/javascript/hakumi_components/controllers/base/registry_controller.js
 - app/javascript/hakumi_components/controllers/hakumi/admin_panel_controller.js
@@ -1173,6 +1174,7 @@ files:
 - app/javascript/hakumi_components/controllers/hakumi/upload_controller.js
 - app/javascript/hakumi_components/core/config.js
 - app/javascript/hakumi_components/core/dom.js
+- app/javascript/hakumi_components/core/overlay_container.js
 - app/javascript/hakumi_components/core/persistence.js
 - app/javascript/hakumi_components/core/registry.js
 - app/javascript/hakumi_components/core/render_component.js
@@ -1276,6 +1278,7 @@ files:
 - app/views/hakumi_components/_tag.html.erb
 - app/views/hakumi_components/_timeline.html.erb
 - app/views/hakumi_components/_tree.html.erb
+- lib/generators/hakumi/install_generator.rb
 - lib/hakumi_components.rb
 - lib/hakumi_components/engine.rb
 - lib/hakumi_components/rails.rb
@@ -1284,6 +1287,7 @@ files:
 - lib/hakumi_components/version.rb
 - sig/action_view/tag_builder.rbs
 - sig/active_support/concern_patch.rbs
+- sig/generators/hakumi/install_generator.rbs
 - sig/hakumi/admin_panel/component.rbs
 - sig/hakumi/affix/component.rbs
 - sig/hakumi/alert/component.rbs
@@ -1326,6 +1330,7 @@ files:
 - sig/hakumi/float_button/group/component.rbs
 - sig/hakumi/float_button/group_cluster/component.rbs
 - sig/hakumi/form/item/component.rbs
+- sig/hakumi/form_builder.rbs
 - sig/hakumi/grid/col/component.rbs
 - sig/hakumi/grid/row/component.rbs
 - sig/hakumi/icon/component.rbs