Modernize inky-rb as a standalone v2.0.0 gem

.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [develop, master, main]
+  pull_request:
+
+jobs:
+  test:
+    name: Ruby ${{ matrix.ruby }} / Rails ${{ matrix.rails }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.2', '3.3', '3.4']
+        rails: ['7.1', '8.0', '8.1']
+        include:
+          - ruby: '4.0'
+            rails: '8.1'
+    env:
+      RAILS_VERSION: "~> ${{ matrix.rails }}.0"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake test
+
+  lint:
+    name: Rubocop and Sorbet
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '4.0'
+          bundler-cache: true
+      - name: Rubocop
+        run: bundle exec rubocop
+      - name: Sorbet
+        run: bundle exec srb tc

.gitignore

@@ -1,6 +1,5 @@
 *.swp
-pkg
-spec/_cases_output
-spec/test_app/log/*.log
-spec/test_app/tmp/
+/pkg/
+/tmp/
 Gemfile.lock
+sorbet/tapioca/

.rubocop.yml

@@ -1,160 +1,47 @@
 AllCops:
-  DisplayCopNames: true
-  TargetRubyVersion: 2.2
-# Relaxed.Ruby.Style
-
-Style/Alias:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylealias
-
-Style/BeginBlock:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylebeginblock
+  TargetRubyVersion: 3.2
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - 'sorbet/**/*'
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'lib/generators/inky/templates/**/*'
 
-Style/BlockDelimiters:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styleblockdelimiters
+Layout/LineLength:
+  Max: 160
+  Exclude:
+    - 'test/**/*'
 
 Style/Documentation:
   Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styledocumentation
-
-Layout/DotPosition:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styledotposition
-
-Style/DoubleNegation:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styledoublenegation
-
-Style/EndBlock:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styleendblock
-
-Style/FormatString:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styleformatstring
-
-Style/IfUnlessModifier:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styleifunlessmodifier
-
-Style/Lambda:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylelambda
-
-Style/ModuleFunction:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylemodulefunction
-
-Style/MultilineBlockChain:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylemultilineblockchain
-
-Style/NegatedIf:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylenegatedif
-
-Style/NegatedWhile:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylenegatedwhile
-
-Style/ParallelAssignment:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styleparallelassignment
-
-Style/PercentLiteralDelimiters:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylepercentliteraldelimiters
-
-Style/PerlBackrefs:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#styleperlbackrefs
-
-Style/Semicolon:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylesemicolon
-
-Style/SignalException:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylesignalexception
-
-Style/SingleLineBlockParams:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylesinglelineblockparams
-
-Style/SingleLineMethods:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylesinglelinemethods
-
-Layout/SpaceBeforeBlockBraces:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylespacebeforeblockbraces
-
-Layout/SpaceInsideParens:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylespaceinsideparens
-
-Style/SpecialGlobalVars:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylespecialglobalvars
-
-Style/StringLiterals:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylestringliterals
-
-Style/WhileUntilModifier:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylewhileuntilmodifier
-
-Lint/AmbiguousRegexpLiteral:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#lintambiguousregexpliteral
-
-Lint/AssignmentInCondition:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#lintassignmentincondition
 
-Metrics/AbcSize:
-  Enabled: false
+Style/FrozenStringLiteralComment:
+  Enabled: true
 
-Metrics/BlockNesting:
-  Enabled: false
+Metrics/BlockLength:
+  Exclude:
+    - 'test/**/*'
+    - 'inky.gemspec'
 
+# Test files: autofix only, relaxed metrics.
 Metrics/ClassLength:
-  Enabled: false
-
-Metrics/ModuleLength:
-  Enabled: false
-
-Metrics/CyclomaticComplexity:
-  Enabled: false
-
-Metrics/LineLength:
-  Enabled: false
+  Exclude:
+    - 'test/**/*'
 
 Metrics/MethodLength:
-  Enabled: false
-
-Metrics/ParameterLists:
-  Enabled: false
-
-Metrics/PerceivedComplexity:
-  Enabled: false
-
-# inky-rb gem specifics
-Lint/HandleExceptions:
   Exclude:
-    - 'Rakefile'
-    - 'lib/inky.rb'
+    - 'test/**/*'
 
-Metrics/BlockLength:
+Metrics/AbcSize:
   Exclude:
-    - 'Rakefile'
-    - 'spec/**/*.rb'
+    - 'test/**/*'
 
-Style/MutableConstant:
-  Enabled: false
+Naming/VariableNumber:
+  Exclude:
+    - 'test/**/*'
 
-Style/Encoding:
-  Enabled: false
+# Test classes share a file by component; that is intentional grouping.
+Style/ClassAndModuleChildren:
+  Exclude:
+    - 'test/**/*'

CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2026-06-11
+
+A full modernization. v2 is a generalist gem usable by any Rails project, with
+markup updated to 2026 email best practices.
+
+### Added
+
+- **Extensible component registry (open/closed).** Each component is now a class
+  (`Inky::Components::*`) inheriting from `Inky::Components::Base`. Register your
+  own tags with `Inky.configuration.register_component('my-tag', MyComponent)`;
+  custom components receive the matched Nokogiri node and full DOM access.
+- **`role="presentation"` on every generated layout table** for accessibility.
+- **MSO ghost tables/cells** around `<container>`, `<row>`/`<columns>`, so the
+  fluid-hybrid layout still renders as a grid in Outlook (Word engine).
+- **`container_width` configuration** (default `600`), settable globally or per
+  `Inky::Core.new(container_width:)`.
+- **Bulletproof `<button>`**: padding carried by the `<a>` so the whole button is
+  clickable.
+- **`mso-line-height-rule:exactly`** on `<spacer>` to stop Outlook inflating it.
+- **Multi-line `<raw>` support** (upstream PR #101).
+- **Sorbet `# typed: strict`** across `lib/`, with full signatures.
+- **Minitest suite** with golden-markup assertions (structural comparison:
+  whitespace, attribute and class ordering normalized) for every component, plus
+  error and edge cases and the Rails template-handler integration path.
+- **GitHub Actions CI**: Ruby 3.2/3.3/3.4/4.0 × Rails 7.1/8.0/8.1.
+
+### Changed
+
+- **Layout is now fluid-hybrid.** `<columns>` use `display:inline-block` with a
+  pixel `max-width` so columns stack naturally on small screens without a media
+  query, and are restored to a grid in Outlook via ghost cells. The `small-*`,
+  `large-*`, `first`, `last` classes are preserved for media-query enhancement.
+  Ghost-cell widths are `container_width × large / column_count`, capped at
+  `container_width`, with **no gutter model** (unlike 1.x where gutters came from
+  Foundation's CSS padding) — add padding inside columns for gutters.
+- Column content cells carry an inline `font-weight:normal;text-align:left`
+  reset, replacing the equivalent rule foundation-emails applied via CSS.
+- The install generator no longer emits Foundation's SCSS; it generates a
+  neutral modern mailer layout (MSO settings, color-scheme metas, `role="article"`).
+- All generated tables carry explicit `border="0" cellpadding="0" cellspacing="0"`
+  and inline `style` (no reliance on `!important` or `border-radius`, both stripped
+  by Orange.fr webmail).
+- Component classes are keyed by tag string in the registry; the constructor
+  `components:` option now maps tag strings to component classes.
+
+### Removed
+
+- **`foundation_emails` runtime dependency.** The gem no longer ships Foundation's
+  SCSS; styling is the application's responsibility (inline critical CSS, plus a
+  `<style>` block for media-query/dark-mode enhancement). To keep the previous
+  behavior, add `foundation_emails` to your own Gemfile and import its SCSS.
+- Legacy `gemfiles/` (Rails 3-6) and `.travis.yml`. CI is now GitHub Actions.
+
+### Compatibility
+
+- Ruby `>= 3.2` (tested up to 4.0).
+- Rails `>= 7.1` (tested up to 8.1).
+- Nokogiri `>= 1.16`.
+
+### Migration from 1.x
+
+- The generated markup changed. If you snapshot-test rendered emails, re-record
+  the snapshots.
+- If you relied on Foundation's SCSS classes for styling, add `foundation_emails`
+  to your Gemfile yourself, or provide your own styles for the preserved class
+  hooks (`.row`, `.columns`, `.button`, `.menu`, `.callout`, `.spacer`, ...).
+- Custom components previously passed as `components: { tag: 'tag-name' }` string
+  maps are replaced by the class-based registry. Use `register_component`.
+
+[2.0.0]: https://github.com/foundation/inky-rb/releases/tag/v2.0.0

Gemfile

@@ -1,7 +1,14 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in inky.gemspec
+# Specify the gem's runtime dependencies in inky.gemspec
 gemspec
 
-gem 'rspec-core'
-gem 'rspec-expectations'
+gem 'minitest', '~> 5.20'
+gem 'rails', ENV.fetch('RAILS_VERSION', '>= 7.1')
+gem 'rake', '~> 13.0'
+gem 'rubocop', '~> 1.60', require: false
+gem 'sorbet', '>= 0.5', require: false
+gem 'sorbet-static-and-runtime', '>= 0.5', require: false
+gem 'tapioca', '>= 0.13', require: false