cw_card_utils 0.1.11 → 0.2.1

data/lib/cw_card_utils.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# require_relative "crackling_wit/card_utils"
+
 require_relative "cw_card_utils/version"
 require_relative "cw_card_utils/curve_calculator"
 require_relative "cw_card_utils/decklist_parser"
@@ -7,18 +9,53 @@ require_relative "cw_card_utils/scryfall_cmc_data"
 require_relative "cw_card_utils/synergy_probability"
 require_relative "cw_card_utils/deck_comparator"
 
+##
+# Public: Top-level namespace for Card Utils.
+# 日本語: Card Utils のトップレベル名前空間です。
 module CwCardUtils
+  ##
+  # Public: Gem-specific error base class.
+  # 日本語: このライブラリ用の基本的なエラークラスです。
   class Error < StandardError; end
 
-  # Configuration for the library
+  # NOTE: Soft deprecation bridge to the new namespace
+  # Users can migrate to `CracklingWit::CardUtils`. All functionality remains.
+  module Bridge
+    module_function
+
+    def warn_once
+      return if @warned
+      @warned = true
+      warn("[cw_card_utils] DEPRECATION: Use `CracklingWit::CardUtils` instead of `CwCardUtils`. The old namespace will be removed in a future major release.")
+    rescue StandardError
+      # no-op in environments where warn is suppressed
+    end
+  end
+
+  # Public: Configuration for the library.
+  # 日本語: ライブラリの設定を行います。
   class << self
+    # Public: Overrides the global card data source.
+    # 日本語: グローバルなカードデータソースを上書きします。
+    #
+    # @param source [CwCardUtils::CardDataSource]
     attr_writer :card_data_source
 
+    # Public: Returns the global card data source used by parsers and models.
+    # 日本語: パーサやモデルが使用するグローバルなカードデータソースを返します。
+    #
+    # @return [CwCardUtils::CardDataSource]
     def card_data_source
       @card_data_source ||= ScryfallCmcData.instance
     end
 
+    # Public: Yields the module for configuration.
+    # 日本語: 設定用にモジュール自身をブロックに渡します。
+    #
+    # @yield [CwCardUtils]
+    # @return [void]
     def configure
+      Bridge.warn_once
       yield self if block_given?
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cw_card_utils
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.2.1
 platform: ruby
 authors:
 - Ryan Stenhouse
@@ -36,6 +36,8 @@ files:
 - README.md
 - Rakefile
 - data/scryfall.cards.cmc.json
+- lib/crackling_wit.rb
+- lib/crackling_wit/card_utils.rb
 - lib/cw_card_utils.rb
 - lib/cw_card_utils/curve_calculator.rb
 - lib/cw_card_utils/deck_comparator.rb
@@ -57,6 +59,7 @@ metadata:
   homepage_uri: https://cracklingwit.com
   source_code_uri: https://github.com/cracklingwit/card_utils
   changelog_uri: https://github.com/cracklingwit/card_utils/commits/main/
+  documentation_uri: https://card-utils.rdoc.cracklingwit.com
 rdoc_options: []
 require_paths:
 - lib