view_component-props 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3a9ef2ac9995b693a38b9352a71240b91e50026d005b66ab3b1f39fd5ad8203
-  data.tar.gz: c1a0c06c0c6a4a81258bca63548350ebc207309fbbd693c34a2e943dcc86e4fb
+  metadata.gz: 66db72b53902a7010dba206cb9d972732d5444d6e8ed454cb1e429248afcb442
+  data.tar.gz: df3f86322a1e183f450a28eab858f095e3e044e0d571d987347036cec5a6f346
 SHA512:
-  metadata.gz: 1af707f75da83e05a6668558de0c9a6e6b3b276d79a4edb9074cb12a931285581f2b80bdb054fc937ccb7a6d38d0f53fe43177d700913b03ece23ca996d36b4e
-  data.tar.gz: 9feb6ae421a7af903e58ccff6357acc79e0e6787dbf239761fa80ca1d13ff14c66219ac187049b9770ffc6239d9d872eca30808c08b79a16e4b3012e5de4e7aa
+  metadata.gz: '084497d1655142ae2cc273faeaffe59308bbedf5957e6f724476074bd383c695c7c60067b67ade609da3bb900f25d1adee8fa3522ad3821381488fdf923fa1dd'
+  data.tar.gz: 124cb82395be740e128aebb5698edaceffd3aae227ece4087640e4fa4c6a8495f186391023eb726e2a5e58ba777c16ee1e86b22a194bf5961c0e9b8c7c9d24b2

data/CHANGELOG.md

@@ -7,7 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [X.X.X] - YYYY-MM-DD
 
-## [0.0.2] - 2026-05-29
+## [0.0.3] - 2026-05-30
+
+### Added
+
+- Dash-named entry file (`lib/view_component-props.rb`) so Bundler's default auto-require works for the published `view_component-props` gem name without a `require:` option
+
+### Fixed
+
+- `ViewComponentProps.install!` now prepends its initializer instead of redefining `ViewComponent::Base#initialize`. This keeps the native initializer in the ancestor chain, so `super()` resolves to `ViewComponent::Base#initialize` rather than falling through to `ActionView::Base#initialize` and raising `ArgumentError` when a component is instantiated.
+
+### Documentation
+
+- Expanded the README casters section into a reference table and documented the nil-handling semantics (a `nil` value is never passed to a caster)
 
 ## [0.0.1] - 2026-05-29
 

data/README.md

@@ -89,9 +89,30 @@ end
 
 ### Casters
 
-Built-in casters: `:integer`, `:float`, `:string`, `:symbol`, `:boolean`, `:array`, `:hash`, `:decimal`, `:date`, `:datetime`.
-
-A `nil` value is never cast and stays `nil`. Use `default:` or `fallback:` when you need a value for a missing or `nil` prop.
+Built-in casters:
+
+| Cast         | Coerces to                  | Notes                                                                       |
+| ------------ | --------------------------- | --------------------------------------------------------------------------- |
+| `:integer`   | `Integer`                   | Via `Integer(value)`; raises `CastError` on non-numeric input.              |
+| `:float`     | `Float`                     | Via `Float(value)`; raises `CastError` on non-numeric input.                |
+| `:string`    | `String`                    | Via `value.to_s`.                                                           |
+| `:symbol`    | `Symbol`                    | Via `value.to_sym`.                                                         |
+| `:boolean`   | `true` / `false`            | Uses `ActiveModel::Type::Boolean`, so `"0"`, `"false"`, `""` become `false`. |
+| `:array`     | `Array`                     | Via `Array(value)`, wrapping scalars in a one-element array.                |
+| `:hash`      | `Hash`                      | Returns hashes unchanged; otherwise calls `value.to_h`.                      |
+| `:decimal`   | `BigDecimal`                | Returns `BigDecimal` values unchanged; otherwise `BigDecimal(value.to_s)`.   |
+| `:date`      | `Date`                      | Returns `Date` values unchanged; otherwise `Date.parse(value.to_s)`.         |
+| `:datetime`  | `Time` / `ActiveSupport::TimeWithZone` | Returns `Time`/`DateTime` unchanged; otherwise parses via `Time.zone` (or `Time.parse` when no zone). |
+
+#### Nil handling
+
+A `nil` value is **never** passed to a caster — casting is short-circuited before the caster runs, so `nil` stays `nil`. This means casters don't need to be nil-safe, and a `nil` prop is never coerced into a placeholder like `""`, `0`, or `false`. Resolution order is:
+
+1. The key's value (or `default:` when the key is missing) is resolved.
+2. If that value is `nil` and a `fallback:` is defined, the fallback is resolved.
+3. Only a non-`nil` result is handed to the caster; a `nil` result passes through untouched (then triggers `required:` if set).
+
+Use `default:` or `fallback:` when you need a concrete value for a missing or `nil` prop. Note that fallbacks are resolved *before* casting, so a `fallback:` value is cast like any other value.
 
 Register custom casters in the configuration block:
 

data/lib/view_component-props.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "view_component_props"

data/lib/view_component_props/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ViewComponentProps
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/view_component_props.rb

@@ -12,18 +12,20 @@ require_relative "view_component_props/definable"
 require_relative "view_component_props/version"
 
 module ViewComponentProps
+  module Initializer
+    def initialize(props = {})
+      super()
+      setup_props_for(props)
+      after_initialize
+    end
+  end
+
   class << self
     def install!(target = ViewComponent::Base)
       return if target.include?(Definable)
 
       target.include(Definable)
-      target.class_eval do
-        def initialize(props = {})
-          super()
-          setup_props_for(props)
-          after_initialize
-        end
-      end
+      target.prepend(Initializer)
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: view_component-props
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Kinnell Shah
@@ -84,6 +84,7 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- lib/view_component-props.rb
 - lib/view_component_props.rb
 - lib/view_component_props/casters.rb
 - lib/view_component_props/casters/base.rb