Add core Stroma functionality (#1)

Author: afuno

Appraisals

@@ -2,20 +2,56 @@
 
 appraise "rails-5.1" do
   gem "activesupport", "~> 5.1.0"
+
+  # warning: base64 was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "base64", ">= 0.2"
+
+  # warning: bigdecimal was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "bigdecimal", ">= 3.1"
+
+  # warning: mutex_m was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "mutex_m", ">= 0.3"
 end
 
 appraise "rails-5.2" do
   gem "activesupport", "~> 5.2.0"
+
+  # warning: base64 was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "base64", ">= 0.2"
+
+  # warning: bigdecimal was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "bigdecimal", ">= 3.1"
+
+  # warning: mutex_m was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "mutex_m", ">= 0.3"
 end
 
 appraise "rails-6.0" do
   gem "activesupport", "~> 6.0.0"
   gem "concurrent-ruby", "1.3.4"
+
+  # warning: base64 was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "base64", ">= 0.2"
+
+  # warning: bigdecimal was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "bigdecimal", ">= 3.1"
+
+  # warning: mutex_m was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "mutex_m", ">= 0.3"
 end
 
 appraise "rails-6.1" do
   gem "activesupport", "~> 6.1.0"
   gem "concurrent-ruby", "1.3.4"
+
+  # warning: base64 was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "base64", ">= 0.2"
+
+  # warning: bigdecimal was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "bigdecimal", ">= 3.1"
+
+  # warning: mutex_m was loaded from the standard library, but is not part of the default gems starting from Ruby 3.4.0.
+  gem "mutex_m", ">= 0.3"
 end
 
 appraise "rails-7.0" do

Gemfile.lock

@@ -124,6 +124,7 @@ PLATFORMS
 
 DEPENDENCIES
   appraisal (>= 2.5)
+  rake (>= 13.2)
   rspec (>= 3.13)
   servactory-rubocop (>= 0.9)
   stroma!

README.md

@@ -1,3 +1,114 @@
-# Stroma
+<h1 align="center">Stroma</h1>
 
-Soon
+<p align="center">
+  A foundation for building modular, extensible DSLs in Ruby.
+</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/stroma"><img src="https://img.shields.io/gem/v/stroma?logo=rubygems&logoColor=fff" alt="Gem version"></a>
+  <a href="https://github.com/servactory/stroma/releases"><img src="https://img.shields.io/github/release-date/servactory/stroma" alt="Release Date"></a>
+  <a href="https://rubygems.org/gems/stroma"><img src="https://img.shields.io/gem/dt/stroma" alt="Downloads"></a>
+  <a href="https://www.ruby-lang.org"><img src="https://img.shields.io/badge/Ruby-3.2+-red" alt="Ruby version"></a>
+</p>
+
+<!--
+## 📚 Documentation
+
+See [stroma.servactory.com](https://stroma.servactory.com) for documentation, including:
+
+- Architecture overview
+- Registry and DSL modules
+- Hooks and extensions
+- Settings hierarchy
+- API reference
+-->
+
+## 💡 Why Stroma?
+
+Building modular DSLs shouldn't require reinventing the wheel. Stroma provides a structured approach for library authors to compose DSL modules with:
+
+- 🔌 **Module Registration** - Register DSL modules at boot time, compose them into a unified interface
+- 🧱 **Structured Composition** - Include all registered modules automatically via single DSL entry point
+- 🏛️ **Inheritance Safe** - Per-class state isolation with automatic deep copying
+- 🪝 **Extension Hooks** - Optional before/after hooks for user customization
+- ⚙️ **Extension Settings** - Three-level hierarchical storage for extension configuration
+- 🔒 **Thread Safe** - Immutable registry after finalization, safe concurrent reads
+
+## 🧬 Concept
+
+Stroma is a foundation for library authors building DSL-driven frameworks (service objects, form objects, decorators, etc.).
+
+**Core lifecycle:**
+1. **Register** - Define DSL modules at boot time via `Stroma::Registry`
+2. **Compose** - Classes include `Stroma::DSL` to gain all registered modules automatically
+3. **Extend** (optional) - Users can add cross-cutting logic via `before`/`after` hooks
+
+## 🚀 Quick Start
+
+### Installation
+
+```ruby
+gem "stroma"
+```
+
+### Define your library's DSL
+
+```ruby
+module MyLib
+  module DSL
+    # Register DSL modules at load time
+    Stroma::Registry.register(:inputs, MyLib::Inputs::DSL)
+    Stroma::Registry.register(:actions, MyLib::Actions::DSL)
+    Stroma::Registry.finalize!
+
+    def self.included(base)
+      base.include(Stroma::DSL)
+    end
+  end
+end
+```
+
+### Create base class
+
+```ruby
+module MyLib
+  class Base
+    include MyLib::DSL
+  end
+end
+```
+
+### Usage
+
+```ruby
+class UserService < MyLib::Base
+  input :email, type: String
+
+  make :create_user
+
+  private
+
+  def create_user
+    # implementation
+  end
+end
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Check out our [Contributing Guide](https://github.com/servactory/stroma/blob/main/CONTRIBUTING.md) to get started.
+
+**Ways to contribute:**
+- 🐛 Report bugs and issues
+- 💡 Suggest new features
+- 📝 Improve documentation
+- 🧪 Add test cases
+- 🔧 Submit pull requests
+
+## 🙏 Acknowledgments
+
+Special thanks to all our [contributors](https://github.com/servactory/stroma/graphs/contributors)!
+
+## 📄 License
+
+Stroma is available as open source under the terms of the [MIT License](./LICENSE).

gemfiles/rails_5.1.gemfile

@@ -5,6 +5,8 @@
 source "https://rubygems.org"
 
 gem "activesupport", "~> 5.1.0"
-gem "railties", "~> 5.1.0"
+gem "base64", ">= 0.2"
+gem "bigdecimal", ">= 3.1"
+gem "mutex_m", ">= 0.3"
 
 gemspec path: "../"

gemfiles/rails_5.2.gemfile

@@ -5,6 +5,8 @@
 source "https://rubygems.org"
 
 gem "activesupport", "~> 5.2.0"
-gem "railties", "~> 5.2.0"
+gem "base64", ">= 0.2"
+gem "bigdecimal", ">= 3.1"
+gem "mutex_m", ">= 0.3"
 
 gemspec path: "../"

gemfiles/rails_6.0.gemfile

@@ -5,7 +5,9 @@
 source "https://rubygems.org"
 
 gem "activesupport", "~> 6.0.0"
+gem "base64", ">= 0.2"
+gem "bigdecimal", ">= 3.1"
 gem "concurrent-ruby", "1.3.4"
-gem "railties", "~> 6.0.0"
+gem "mutex_m", ">= 0.3"
 
 gemspec path: "../"

gemfiles/rails_6.1.gemfile

@@ -5,7 +5,9 @@
 source "https://rubygems.org"
 
 gem "activesupport", "~> 6.1.0"
+gem "base64", ">= 0.2"
+gem "bigdecimal", ">= 3.1"
 gem "concurrent-ruby", "1.3.4"
-gem "railties", "~> 6.1.0"
+gem "mutex_m", ">= 0.3"
 
 gemspec path: "../"

gemfiles/rails_7.0.gemfile

@@ -6,6 +6,5 @@ source "https://rubygems.org"
 
 gem "activesupport", "~> 7.0.0"
 gem "concurrent-ruby", "1.3.4"
-gem "railties", "~> 7.0.0"
 
 gemspec path: "../"

gemfiles/rails_7.1.gemfile

@@ -5,6 +5,5 @@
 source "https://rubygems.org"
 
 gem "activesupport", "~> 7.1.0"
-gem "railties", "~> 7.1.0"
 
 gemspec path: "../"

gemfiles/rails_7.2.gemfile

@@ -5,6 +5,5 @@
 source "https://rubygems.org"
 
 gem "activesupport", "~> 7.2.0"
-gem "railties", "~> 7.2.0"
 
 gemspec path: "../"