railpack 0.1.9 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ded6facd93278dbea656e9785d07a53b124d9d5477a99a34a362ee1120e91d33
-  data.tar.gz: f329ab2bfc29cf54fa6adb5b903236c195427c9fbaac794050ee9036ba0728ee
+  metadata.gz: f2b316c03702c30f4d6885d7a6f83b7e04e807e654a3c14452a40549a1a0120a
+  data.tar.gz: 52ab40983d2ca98f5729bfe38401aabffdd1b48cd509ab342f0f7696a2deb43c
 SHA512:
-  metadata.gz: de9a245524b519a480c2d2298ec3b73a7e5e11121a36e2438f209e6b27e044ba8edd0ec4a23f8db031ab39e6f3917a453db4bbbca61cddd39c0466541b40b1de
-  data.tar.gz: c1b8d47fcf4f8b0778a78e0b8025dd2e2f51fbbb416784701b265b1c2a93fa61515b3bb59f27c28aecec5596a4e239c69d7abe388ae47e2d24c8c6d69db234ee
+  metadata.gz: 29fdc731da308f0c928fc1a88e1381c95ec2f14ca5a43b2da6b99396b2e2b7281063412285c28244c1256910d5c73157023295b074c4056a8e0a0d2e49ee40f0
+  data.tar.gz: e5d47f045a11a4db727fc03c2c276b5aff6f2879a3f203b171f6eec2849533c1a3a93642d22adf9bad5a78a6f4ad58da077a9afaba21c1b7aca3ede01db8eb45

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-01-26
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 21tycoons LLC
+Copyright (c) 2026 21tycoons LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,31 +1,188 @@
 # Railpack 🎒
 
-Use webpack/esbuild/bun/rollup to manage JavaScript without the "asset pipeline" in your Rails app.
+**Multi-bundler asset pipeline for Rails** - Choose your bundler, unified Rails integration.
+
+## Features
+
+- 🚀 **Multiple Bundlers**: Bun, esbuild, Rollup, Webpack support
+- 🔧 **Unified API**: Same interface regardless of bundler
+- 🎯 **Rails Integration**: Seamless asset pipeline integration
+- ⚡ **Hot Module Replacement**: Development server with live reload
+- 🎣 **Event Hooks**: Build lifecycle callbacks
+- 📦 **Production Ready**: Optimized builds for all bundlers
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add to your Gemfile:
 
 ```ruby
 gem 'railpack'
 ```
 
-And then execute:
+## Configuration
+
+Create `config/railpack.yml`:
+
+```yaml
+# Choose your bundler
+bundler: bun  # or 'rollup', 'webpack', 'esbuild'
+
+# Global defaults
+default:
+  target: browser
+  format: esm
+  minify: false
+  sourcemap: false
+  entrypoint: "./app/javascript/application.js"
+  outdir: "app/assets/builds"
+
+# Bundler-specific config
+bun:
+  target: browser
+  format: esm
+
+# Environment overrides
+development:
+  sourcemap: true
+
+production:
+  minify: true
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Build for production
+rails railpack:build
+
+# Watch and rebuild during development
+rails railpack:watch
+
+# Install dependencies
+rails railpack:install
+
+# Check current bundler
+rails railpack:bundler
+```
+
+### Programmatic API
+
+```ruby
+# Build assets
+Railpack.build!
+
+# Watch for changes
+Railpack.watch
+
+# Install packages
+Railpack.install!
+
+# Add dependencies
+Railpack.add('lodash', 'axios')
+```
+
+### Rails Integration
+
+Railpack automatically integrates with Rails asset pipeline:
+
+```ruby
+# config/initializers/railpack.rb
+require 'railpack'
+
+# Override config at runtime
+Railpack.config.sourcemap = true
+
+# Setup logging
+Railpack.logger = Rails.logger
+
+# Build event hooks
+Railpack.on_build_complete do |result|
+  Rails.logger.info "Build completed: #{result[:success]}"
+end
+```
+
+## Supported Bundlers
 
-    $ bundle install
+### Bun (Default)
+- **Fast builds** - Lightning-quick bundling
+- **All-in-one** - Runtime, bundler, package manager
+- **Great DX** - Excellent development experience
 
-Or install it yourself as:
+### Rollup
+- **Tree shaking** - Optimal bundle sizes
+- **Plugin ecosystem** - Extensive customization
+- **ESM focus** - Modern module system
 
-    $ gem install railpack
+### Webpack
+- **Enterprise** - Battle-tested in production
+- **Feature-rich** - Extensive plugin ecosystem
+- **Legacy support** - Handles all module types
 
-## Still in Development
+### esbuild
+- **Speed demon** - 10-100x faster than alternatives
+- **Simple API** - Minimal configuration
+- **Modern features** - ESM, minification, sourcemaps
 
-NOT READY YET, FEEL FREE TO CONTRIBUTE. 👍
+## Switching Bundlers
+
+Change the `bundler` setting in `config/railpack.yml`:
+
+```yaml
+bundler: esbuild  # Switch to esbuild for speed
+```
+
+Or use esbuild:
+
+```yaml
+bundler: esbuild
+
+esbuild:
+  platform: browser
+  target: es2015
+  minify: true
+```
+
+Railpack handles the rest - same API, different bundler under the hood.
+
+## Development
+
+### Adding a New Bundler
+
+1. Create bundler class:
+```ruby
+# lib/railpack/bundlers/my_bundler.rb
+class Railpack::MyBundler < Railpack::Bundler
+  def commands
+    { build: "my-build", watch: "my-watch" }
+  end
+  
+  def build!(args = [])
+    execute!([commands[:build], *args])
+  end
+end
+```
+
+2. Register in Manager:
+```ruby
+BUNDLERS = {
+  'bun' => BunBundler,
+  'my' => MyBundler  # Add here
+}
+```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/21tycoons/railpack.
+1. Fork the repo
+2. Add your bundler implementation
+3. Update documentation
+4. Submit a PR
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+MIT License - see LICENSE.txt
+
+## Credits
+
+Built by 21tycoons LLC for the Rails community.

data/Rakefile

@@ -9,4 +9,8 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task default: :test
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/lib/railpack/bundler.rb

@@ -0,0 +1,42 @@
+module Railpack
+  class Bundler
+    attr_reader :config
+
+    def initialize(config)
+      @config = config
+    end
+
+    # Common interface all bundlers must implement
+    def build!(args = [])
+      raise NotImplementedError, "#{self.class.name} must implement #build!"
+    end
+
+    def watch(args = [])
+      raise NotImplementedError, "#{self.class.name} must implement #watch"
+    end
+
+    def install!(args = [])
+      raise NotImplementedError, "#{self.class.name} must implement #install!"
+    end
+
+    def name
+      self.class.name.split('::').last.sub('_bundler', '').downcase
+    end
+
+    def commands
+      raise NotImplementedError, "#{self.class.name} must implement #commands"
+    end
+
+    protected
+
+    def execute(command_array)
+      system(*command_array)
+    end
+
+    def execute!(command_array)
+      success = system(*command_array)
+      raise Error, "Command failed: #{command_array.join(' ')}" unless success
+      success
+    end
+  end
+end

data/lib/railpack/bundlers/bun_bundler.rb

@@ -0,0 +1,49 @@
+module Railpack
+  class BunBundler < Bundler
+    def commands
+      {
+        build: "bun run build",
+        watch: "bun run watch",
+        build_dev: "bun run build:development",
+        clean: "bun run clean",
+        install: "bun install",
+        add: "bun add",
+        remove: "bun remove",
+        exec: "bun",
+        version: "bun --version"
+      }
+    end
+
+    def build!(args = [])
+      execute!([commands[:build], *args])
+    end
+
+    def watch(args = [])
+      execute([commands[:watch], *args])
+    end
+
+    def install!(args = [])
+      execute!([commands[:install], *args])
+    end
+
+    def add(*packages)
+      execute([commands[:add], *packages])
+    end
+
+    def remove(*packages)
+      execute([commands[:remove], *packages])
+    end
+
+    def exec(*args)
+      execute([commands[:exec], *args])
+    end
+
+    def version
+      `#{commands[:version]}`.strip
+    end
+
+    def installed?
+      system("#{commands[:version]} > /dev/null 2>&1")
+    end
+  end
+end

data/lib/railpack/bundlers/esbuild_bundler.rb

@@ -0,0 +1,49 @@
+module Railpack
+  class EsbuildBundler < Bundler
+    def commands
+      {
+        build: "esbuild",
+        watch: "esbuild --watch",
+        build_dev: "esbuild",
+        clean: "rm -rf dist/",
+        install: "npm install",
+        add: "npm install",
+        remove: "npm uninstall",
+        exec: "node",
+        version: "esbuild --version"
+      }
+    end
+
+    def build!(args = [])
+      execute!([commands[:build], *args])
+    end
+
+    def watch(args = [])
+      execute([commands[:watch], *args])
+    end
+
+    def install!(args = [])
+      execute!([commands[:install], *args])
+    end
+
+    def add(*packages)
+      execute([commands[:add], *packages])
+    end
+
+    def remove(*packages)
+      execute([commands[:remove], *packages])
+    end
+
+    def exec(*args)
+      execute([commands[:exec], *args])
+    end
+
+    def version
+      `#{commands[:version]}`.strip
+    end
+
+    def installed?
+      system("#{commands[:version]} > /dev/null 2>&1")
+    end
+  end
+end

data/lib/railpack/config.rb

@@ -0,0 +1,155 @@
+require "yaml"
+
+module Railpack
+  class Config
+    class Error < StandardError; end
+
+    attr_reader :config
+
+    def initialize
+      @config = load_config
+    end
+
+    def current_env
+      if defined?(Rails) && Rails.respond_to?(:env)
+        Rails.env
+      else
+        :development
+      end
+    end
+
+    def for_environment(env = current_env)
+      base_config = @config["default"] || {}
+      bundler_config = bundler_config(env)
+      env_config = @config[env.to_s] || {}
+
+      # Merge: default <- bundler <- environment
+      deep_merge(deep_merge(base_config, bundler_config), env_config)
+    end
+
+    def bundler(env = current_env)
+      # Look directly in config to avoid circular dependency
+      env_config = @config[env.to_s] || {}
+      default_config = @config["default"] || {}
+      env_config['bundler'] || default_config['bundler'] || 'bun'
+    end
+
+    def bundler_config(env = current_env)
+      bundler_name = bundler(env)
+      @config[bundler_name] || {}
+    end
+
+    def method_missing(method, *args)
+      config_key = method.to_s
+      if method.end_with?('=')
+        # Setter - allow initializer to override config
+        key = config_key.chomp('=')
+        @config[current_env.to_s] ||= {}
+        @config[current_env.to_s][key] = args.first
+      else
+        # Getter - read from merged config
+        env = args.first || current_env
+        return for_environment(env)[config_key] if for_environment(env).key?(config_key)
+        super
+      end
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      config_key = method.to_s.chomp('=')
+      env = current_env
+      for_environment(env).key?(config_key) || super
+    end
+
+    # Build command flags from config
+    def build_flags(env = current_env)
+      cfg = for_environment(env)
+      flags = []
+
+      flags << "--target=#{cfg['target']}" if cfg['target']
+      flags << "--format=#{cfg['format']}" if cfg['format']
+      flags << "--minify" if cfg['minify']
+      flags << "--sourcemap" if cfg['sourcemap']
+      flags << "--splitting" if cfg['splitting']
+
+      flags
+    end
+
+    # Build command arguments
+    def build_args(env = current_env)
+      cfg = for_environment(env)
+      args = []
+
+      # Support multiple entrypoints or single entrypoint
+      entrypoints = cfg['entrypoints']
+      if entrypoints.is_a?(Array) && entrypoints.any?
+        args.concat(entrypoints)
+      elsif cfg['entrypoint'].is_a?(String) && !cfg['entrypoint'].empty?
+        args << cfg['entrypoint']
+      end
+
+      args << "--outdir=#{cfg['outdir']}" if cfg['outdir']
+      args.concat(build_flags(env))
+
+      args
+    end
+
+    private
+
+    def config_path
+      if defined?(Rails) && Rails.respond_to?(:root)
+        Rails.root.join("config", "railpack.yml")
+      else
+        Pathname.new("config/railpack.yml")
+      end
+    end
+
+    def load_config
+      if config_path.exist?
+        YAML.safe_load(File.read(config_path), aliases: true)
+      else
+        default_config
+      end
+    rescue Psych::SyntaxError => e
+      raise Error, "Invalid YAML in #{config_path}: #{e.message}"
+    end
+
+    def default_config
+      {
+        "default" => {
+          "bundler" => "bun",
+          "target" => "browser",
+          "format" => "esm",
+          "minify" => false,
+          "sourcemap" => false,
+          "entrypoint" => "./app/javascript/application.js",
+          "outdir" => "app/assets/builds"
+        },
+        "bun" => {
+          "target" => "browser",
+          "format" => "esm"
+        },
+        "esbuild" => {
+          "target" => "browser",
+          "format" => "esm",
+          "platform" => "browser"
+        },
+        "development" => {
+          "sourcemap" => true
+        },
+        "production" => {
+          "minify" => true
+        }
+      }
+    end
+
+    def deep_merge(hash1, hash2)
+      hash1.merge(hash2) do |key, old_val, new_val|
+        if old_val.is_a?(Hash) && new_val.is_a?(Hash)
+          deep_merge(old_val, new_val)
+        else
+          new_val
+        end
+      end
+    end
+  end
+end