sun-sword 0.0.9 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac608a5b50200fae69d551c25b6abddc5355da222a1a8da739a7aba7c27fac03
-  data.tar.gz: 2d9fab48ea8cc5560198a23801e3424683b7a0c236df9b3b13a12bdde468cc29
+  metadata.gz: d07154e1285345a247e59933071b6c40906ed2e4fa3c61f95274cec3bbacebfe
+  data.tar.gz: 95b7cee97b1bb5b4505e5cbe39e4f756ca5b9f65eab6b560df067f74645e75df
 SHA512:
-  metadata.gz: 1ad02d8c6f6f1f92e2244754dc4fee44d2073af1f071dcb96b67ced1625a432aa4e142b8f06139aef3f491b5b48fee1b7bb3d3f064827e5998b6cae54211958c
-  data.tar.gz: 400165a8e6d7df364e0ea8ab835cef59cdcdf4ed2b1e707d6084605f2c17df99c5e93b948b47668ee48264bf90ef979ee8e203e8ab3494a0d268722df1057a7f
+  metadata.gz: 47fb75a4bd69a876903071cf4521d9332f3ac727ff7a839eefd81a939d5576768396786bc5d9176118bc63e90c5a7137063aa059b52640f17fef80c199d5535e
+  data.tar.gz: b1129c75fe08c8d8aaeb75f774dc828273653c648a6facb1e59b7899cc5b4e8e78898dbf58e475e44779fff6e29b9bc6e555e730ba7c04b01fd2897bf4a6b382

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in sun-sword.gemspec
+gemspec
+
+group :development, :test do
+  gem 'byebug'
+  gem 'rubocop-performance'
+  gem 'rubocop-rails-omakase', require: false
+end

data/Gemfile.lock

@@ -0,0 +1,193 @@
+PATH
+  remote: .
+  specs:
+    sun-sword (0.0.11)
+      activesupport (>= 7.1, < 8.1)
+      railties (>= 7.1, < 8.1)
+      thor (>= 1.2, < 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (8.0.2.1)
+      actionview (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      nokogiri (>= 1.8.5)
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+      useragent (~> 0.16)
+    actionview (8.0.2.1)
+      activesupport (= 8.0.2.1)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activesupport (8.0.2.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    ast (2.4.2)
+    base64 (0.3.0)
+    benchmark (0.4.1)
+    bigdecimal (3.2.3)
+    builder (3.3.0)
+    byebug (11.1.3)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.4)
+    crass (1.0.6)
+    date (3.4.1)
+    diff-lcs (1.5.1)
+    drb (2.2.3)
+    erb (5.0.2)
+    erubi (1.13.1)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.1)
+    irb (1.15.2)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.13.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    loofah (2.24.1)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    mini_portile2 (2.8.9)
+    minitest (5.25.5)
+    nokogiri (1.18.10)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm64-darwin)
+      racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.9.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.2)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.5.0)
+    psych (5.2.6)
+      date
+      stringio
+    racc (1.8.1)
+    rack (3.2.1)
+    rack-session (2.1.1)
+      base64 (>= 0.1.0)
+      rack (>= 3.0.0)
+    rack-test (2.2.0)
+      rack (>= 1.3)
+    rackup (2.2.1)
+      rack (>= 3)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    railties (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      irb (~> 1.13)
+      rackup (>= 1.0.0)
+      rake (>= 12.2)
+      thor (~> 1.0, >= 1.2.2)
+      zeitwerk (~> 2.6)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    rdoc (6.14.2)
+      erb
+      psych (>= 4.0.0)
+    regexp_parser (2.11.2)
+    reline (0.6.2)
+      io-console (~> 0.5)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.2)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.80.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.46.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.26.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+    rubocop-rails (2.33.3)
+      activesupport (>= 4.2.0)
+      lint_roller (~> 1.1)
+      rack (>= 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+    rubocop-rails-omakase (1.1.0)
+      rubocop (>= 1.72)
+      rubocop-performance (>= 1.24)
+      rubocop-rails (>= 2.30)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    stringio (3.1.7)
+    thor (1.4.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    uri (1.0.3)
+    useragent (0.16.11)
+    zeitwerk (2.7.3)
+
+PLATFORMS
+  arm64-darwin-23
+  ruby
+
+DEPENDENCIES
+  appraisal (~> 2.5)
+  bundler (~> 2.4)
+  byebug
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rubocop (~> 1.65)
+  rubocop-performance
+  rubocop-rails-omakase
+  sun-sword!
+
+BUNDLED WITH
+   2.5.18

data/README.md

@@ -1,8 +1,20 @@
 # SunSword
+Rails generators for a **modern frontend stack**: Vite, Tailwind (v4), Hotwire (Turbo + Stimulus), plus view scaffolds aligned with your domain.
+
 This gem provides helper interfaces and classes to assist in the construction of application with
 Clean Architecture, as described in [Robert Martin's seminal book](https://www.amazon.com/gp/product/0134494164).
 
+---
+## ✨ Features
+
+- **One-shot frontend setup**  
+  Installs and wires **Vite**, **Tailwind v4**, **Turbo**, **Stimulus**, HMR, and sensible defaults.
+- **Scaffolded views & components**  
+  Opinionated but flexible ERB views, partials, and Stimulus controllers.
+- **Clean integration with Rails 8 + Vite Ruby**  
+  Ships `vite.config.ts`, `config/vite.json`, `Procfile.dev`, `bin/watch`, and entrypoints.
 
+---
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -15,40 +27,45 @@ gem 'sun-sword'
 
 And then execute:
 ```bash
-    $ rails new kotaro_minami -d=postgresql -T --skip-javascript --skip-asset-pipeline
-    $ bundle install
-    $ rails generate rider_kick:init
-    $ rails generate rider_kick:clean_arch --setup
-    $ rails db:drop db:create db:migrate db:seed
     $ rails generate sun_sword:frontend
-    $ rubocop -a
+    $ rubocop -A
 ```
+---
 ## Usage
 ```bash
 Description:
      Clean Architecture CRUD generator
-     rails new kotaro_minami -d=postgresql -T --skip-javascript --skip-asset-pipeline
 
 Example:
-    To Generate Init:
-        bin/rails  generate rider_kick:init
-
-    To Generate Pattern:
-        bin/rails  generate rider_kick:clean_arch --setup
-
     To Generate Frontend:
+        bin/rails  generate sun_sword:init
         bin/rails  generate sun_sword:frontend --setup
         
     To Generate scaffold:
         bin/rails  generate sun_sword:scaffold Models::Contact actor:user
 ```
-
+---
+## Generated structure
+```text
+app/
+    frontend/
+      entrypoints/
+        application.js
+        stimulus.js
+      pages/
+        web.js
+        stimulus.js
+      stylesheets/
+        application.css   # Tailwind v4 style (@import, @plugin, @source)
+      assets/
+```
+---
 ## Philosophy
 
 The intention of this gem is to help you build applications that are built from the use case down,
 and decisions about I/O can be deferred until the last possible moment.
 
-## Clean Architecture
+### Clean Architecture
 This structure provides helper interfaces and classes to assist in the construction of application with Clean Architecture, as described in Robert Martin's seminal book.
 
 ```
@@ -65,7 +82,7 @@ This structure provides helper interfaces and classes to assist in the construct
     - use_cases (Just Usecase)
     - utils (Class Reusable)
 ```
-## Screaming architecture - use cases as an organisational principle
+### Screaming architecture - use cases as an organisational principle
 Uncle Bob suggests that your source code organisation should allow developers to easily find a listing of all use cases your application provides. Here's an example of how this might look in a this application.
 ```
 - app
@@ -93,4 +110,13 @@ Note that the use case name contains:
     # admin_fetch_info.rb [specific usecase]
     # fetch_info.rb [generic usecase] every role can access it
 ```
+---
+## Contributing
+
+- Fork & bundle install
+- ```bin/rails generate sun_sword:frontend --setup``` in a throwaway app to test changes
+- Add/adjust generator tests where possible
+- ```bundle exec rspec```
+- Open a PR 🎉
 
+See CONTRIBUTING.md for more.

data/lib/generators/sun_sword/USAGE

@@ -3,6 +3,7 @@ Description:
      rails new jendral_jack -d=postgresql -T --skip-javascript --skip-asset-pipeline
 
 Example:
+    bin/rails generate sun_sword:init
     bin/rails generate sun_sword:frontend --setup
     bin/rails generate sun_sword:scaffold contacts<check in db/structure>
 

data/lib/generators/sun_sword/frontend_generator.rb

@@ -49,6 +49,10 @@ module SunSword
         gem "turbo-rails"
         gem "stimulus-rails"
         gem "vite_rails"
+
+        group :development do
+          gem "listen"
+        end
       RUBY
       append_to_file('Gemfile', gem_dependencies)
       say 'Vite Rails gem added and bundle installed', :green
@@ -57,10 +61,9 @@ module SunSword
     def install_vite
       template 'package.json', 'package.json'
       run 'bundle exec vite install'
-      run 'yarn add -D sass vite-plugin-full-reload vite-plugin-ruby vite-plugin-stimulus-hmr'
-      run 'yarn add -D tailwindcss @tailwindcss/forms @tailwindcss/typography @tailwindcss/aspect-ratio @tailwindcss/forms @tailwindcss/line-clamp autoprefixer'
-      run 'yarn add -D eslint prettier eslint-plugin-prettier eslint-config-prettier eslint-plugin-tailwindcss path'
-      run 'yarn add @hotwired/stimulus @hotwired/turbo-rails stimulus-vite-helpers vite animejs stimulus-use'
+      run 'yarn add -D vite vite-plugin-full-reload vite-plugin-ruby vite-plugin-stimulus-hmr'
+      run 'yarn add  path stimulus-vite-helpers @hotwired/stimulus @hotwired/turbo-rails @tailwindcss/aspect-ratio @tailwindcss/forms @tailwindcss/line-clamp @tailwindcss/typography @tailwindcss/vite tailwindcss vite-plugin-rails autoprefixer'
+      run 'yarn add -D eslint prettier eslint-plugin-prettier eslint-config-prettier eslint-plugin-tailwindcss'
       say 'Vite installed successfully', :green
     end
 
@@ -68,8 +71,6 @@ module SunSword
       say 'Configuring Vite...'
 
       # Add a basic Vite configuration file to your Rails app
-      template 'tailwind.config.js', 'tailwind.config.js'
-      template 'postcss.config.js', 'postcss.config.js'
       template 'vite.config.ts.tt', 'vite.config.ts'
       template 'Procfile.dev', 'Procfile.dev'
       template 'bin/watch', 'bin/watch'

data/lib/generators/sun_sword/scaffold_generator.rb

@@ -201,21 +201,25 @@ module SunSword
     end
 
     def create_link_file
-      template 'views/components/menu/link.html.erb.tt', File.join('app/views/components/menu', "_link_to_#{@scope_path}.html.erb")
+      partial_path = File.join('app/views/components/menu', "_link_to_#{@scope_path}.html.erb")
+      template 'views/components/menu/link.html.erb.tt', partial_path unless File.exist?(partial_path)
+
+      sidebar = 'app/views/components/layouts/_sidebar.html.erb'
+      marker  = "                <%# generate_link %>\n"
       link_to = "                <li><%= render 'components/menu/#{"link_to_#{@scope_path}"}' %></li>\n"
-      inject_into_file 'app/views/components/layouts/_sidebar.html.erb', link_to, before: "                <%# generate_link %>\n"
+      inject_into_file(sidebar, link_to, before: marker) unless File.read(sidebar).include?(link_to)
+
       routes_file = 'config/routes.rb'
-      if !namespace_exists? && @route_scope_path.present?
-        scope_code = <<-RUBY
-  namespace :#{@route_scope_path} do
-  end
-        RUBY
-        insert_into_file routes_file, scope_code, after: "Rails.application.routes.draw do\n"
-      end
       if @route_scope_path.present?
-        inject_into_file routes_file, "    resources :#{@scope_path}\n", after: "namespace :#{@route_scope_path} do\n"
+        unless namespace_exists?
+          scope_code = "  namespace :#{@route_scope_path} do\n  end\n"
+          insert_into_file routes_file, scope_code, after: "Rails.application.routes.draw do\n" unless File.read(routes_file).include?(scope_code)
+        end
+        resource_line = "    resources :#{@scope_path}\n"
+        inject_into_file routes_file, resource_line, after: "namespace :#{@route_scope_path} do\n" unless File.read(routes_file).include?(resource_line)
       else
-        inject_into_file routes_file, "  resources :#{@scope_path}\n", after: "Rails.application.routes.draw do\n"
+        resource_line = "  resources :#{@scope_path}\n"
+        inject_into_file routes_file, resource_line, after: "Rails.application.routes.draw do\n" unless File.read(routes_file).include?(resource_line)
       end
     end
 
@@ -225,15 +229,29 @@ module SunSword
     end
 
     def strong_params
-      results = ''
-      @controllers.form_fields.each do |field|
-        if field.type.to_s.eql?('files')
-          results << "{ #{field.name}: [] }, "
+      # pakai controllers.form_fields kalau ada, kalau tidak jatuh ke kolom model (contract_fields)
+      raw_fields = @controllers&.form_fields || contract_fields
+
+      # normalisasi jadi pasangan [name, type]
+      pairs = raw_fields.map do |f|
+        if f.respond_to?(:name)
+          [f.name.to_s, f.type.to_s]
         else
-          results << ":#{field.name}, "
+          column_type = @model_class.columns_hash[f.to_s]&.type.to_s
+          [f.to_s, column_type.presence || 'string']
         end
       end
-      results[0..-2]
+
+      permitted = pairs.map do |name, type|
+        case type
+        when 'files' then "{ #{name}: [] }"  # multiple
+        when 'json', 'jsonb', 'hash' then "{ #{name}: {} }"
+        when 'array' then "{ #{name}: [] }"
+        else ":#{name}"
+        end
+      end
+
+      permitted.join(', ')
     end
   end
 end

data/lib/generators/sun_sword/templates_frontend/controllers/application_controller.rb.tt

@@ -34,6 +34,10 @@ class ApplicationController < ActionController::Base
 
   def set_layouts
     # "#{current_auth.user.role}/application"
-    'owner/application'
+    'application'
   end
+
+    def ensure_turbo_frame!
+      turbo_frame_request? || turbo_native_app?
+    end
 end

data/lib/generators/sun_sword/templates_frontend/frontend/entrypoints/application.js

@@ -5,7 +5,7 @@ import {stimulus} from "./stimulus"
 import WebController from "../pages/web"
 import SiteStimulusController from "../pages/stimulus.js"
 
-import "../stylesheets/application.scss"
+import "../stylesheets/application.css"
 console.log("Kotaro is here")
 console.log(window.location.hash.slice(1))