docs-kit 1.2.1 → 1.4.0

data/lib/generators/docs_kit/install/migration.rb

@@ -14,14 +14,19 @@ module DocsKit
     # and hands back strings for whatever needs a human. A `nil` return means
     # "nothing to warn about".
     class Migration
-      attr_reader :to, :description
+      attr_reader :description
 
+      # Keeps `to` as a frozen String, so a migration list can be made
+      # Ractor-shareable without freezing Gem::Version's process-wide cached
+      # instances; #to hands back the Gem::Version.
       def initialize(to:, description:, &block)
-        @to = Gem::Version.new(to.to_s)
+        @to = -to.to_s
         @description = description
         @block = block
       end
 
+      def to = Gem::Version.new(@to)
+
       # Run the transform against the site. Returns the (possibly empty) list of
       # manual-cleanup warnings — never nil, so callers can flat-map safely.
       def call(root, generator)

data/lib/generators/docs_kit/install/migration_registry.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "../../../docs_kit/shareable"
 require_relative "migration"
 require_relative "migrations/v1_2_0"
 require_relative "../../../docs_kit/version"
@@ -24,21 +25,25 @@ module DocsKit
     # its transform in migrations/vX_Y_Z.rb.
     class MigrationRegistry
       def initialize(migrations = [])
-        @migrations = migrations.sort_by(&:to)
+        @migrations = migrations.sort_by(&:to).freeze
       end
 
-      # The registry the install generator runs during `--sync`.
-      def self.default
-        @default ||= new(MIGRATIONS)
-      end
+      # The registry the install generator runs during `--sync` (DEFAULT, below).
+      def self.default = DEFAULT
 
       # Ordered `Migration.new(to: "1.x.0", description: "...") { ... }` entries, one
       # per release that changes config knobs, routes, templates, or toolchain.
-      MIGRATIONS = [
-        Migration.new(to: "1.2.0", description: Migrations::V1_2_0::DESCRIPTION) do |root, _generator|
-          Migrations::V1_2_0.call(root)
-        end
-      ].freeze
+      # Shareable: each block is capture-free (its self is this class).
+      MIGRATIONS = DocsKit::Shareable.make(
+        [
+          Migration.new(to: "1.2.0", description: Migrations::V1_2_0::DESCRIPTION) do |root, _generator|
+            Migrations::V1_2_0.call(root)
+          end
+        ]
+      )
+
+      # Built at load from MIGRATIONS, never lazily (no first-call race).
+      DEFAULT = DocsKit::Shareable.make(new(MIGRATIONS))
 
       # The migrations a site last synced at `from_version` still needs, ascending
       # by version — those in `(from_version, upto]`. `upto` defaults to the

data/lib/generators/docs_kit/install/migrations/v1_2_0.rb

@@ -12,12 +12,14 @@ module DocsKit
       # handed back as a warning, and a newer value is left alone.
       module V1_2_0 # rubocop:disable Naming/ClassAndModuleCamelCase -- named after the release
         DESCRIPTION = "docs-kit 1.2: Ruby >= 3.3, Bun 1.4.2, Tailwind 4.3 / daisyUI 5.7 floors, Node 24 deploy"
-        MIN_RUBY = Gem::Version.new("3.3")
+        # A String: Gem::Version.new hands out process-wide cached instances,
+        # which a constant must not freeze. Compared via Gem::Version below.
+        MIN_RUBY = "3.3"
         BUN = { from: "1.3.2", to: "1.4.2" }.freeze
         PACKAGE_FLOORS = {
-          "tailwindcss" => { from: "^4.1.18", to: "^4.3.3" },
-          "@tailwindcss/cli" => { from: "^4.1.18", to: "^4.3.3" },
-          "daisyui" => { from: "^5.6.0", to: "^5.7.47" }
+          "tailwindcss" => { from: "^4.1.18", to: "^4.3.3" }.freeze,
+          "@tailwindcss/cli" => { from: "^4.1.18", to: "^4.3.3" }.freeze,
+          "daisyui" => { from: "^5.6.0", to: "^5.7.47" }.freeze
         }.freeze
         DEPLOY_CALL = %r{zoolutions/docs-kit/\.github/workflows/deploy\.yml@(\S+)}
 
@@ -112,7 +114,7 @@ module DocsKit
 
         def below_min_ruby?(value)
           version = version_of(value)
-          version ? version < MIN_RUBY : false
+          version ? version < Gem::Version.new(MIN_RUBY) : false
         end
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docs-kit
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Mikael Henriksson
@@ -179,6 +179,7 @@ files:
 - app/components/docs_ui/logo.rb
 - app/components/docs_ui/markdown.rb
 - app/components/docs_ui/markdown_action.rb
+- app/components/docs_ui/markdown_images.rb
 - app/components/docs_ui/meta_tags.rb
 - app/components/docs_ui/on_this_page.rb
 - app/components/docs_ui/open_api_operation.rb
@@ -234,9 +235,11 @@ files:
 - lib/docs_kit/search_index.rb
 - lib/docs_kit/search_index/snippet.rb
 - lib/docs_kit/seo_config.rb
+- lib/docs_kit/shareable.rb
 - lib/docs_kit/shortcut.rb
 - lib/docs_kit/snapshot.rb
 - lib/docs_kit/snapshot/entry.rb
+- lib/docs_kit/store.rb
 - lib/docs_kit/templates/new_site.rb
 - lib/docs_kit/topbar_link.rb
 - lib/docs_kit/version.rb