tint_me 1.0.0

data/lib/tint_me.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+require_relative "tint_me/version"
+
+# TIntMe - Functional terminal text styling with composable ANSI colors and effects
+#
+# TIntMe provides an elegant, functional API for terminal text styling using ANSI escape codes.
+# It features immutable Style objects that can be composed using the >> operator, supporting
+# standard colors, hex values, and comprehensive text effects.
+#
+# @example Basic styling
+#   require "tint_me"
+#
+#   # Create styles
+#   red = TIntMe[foreground: :red]
+#   bold = TIntMe[bold: true]
+#
+#   # Apply styling
+#   puts red.call("Error!")
+#   puts bold["Important"]
+#
+# @example Style composition
+#   base = TIntMe[foreground: :blue]
+#   emphasis = TIntMe[bold: true, underline: true]
+#   styled = base >> emphasis
+#   puts styled.call("Highlighted text")
+#
+# @example Hex colors
+#   custom = TIntMe[foreground: "#FF6B35", background: "#F7931E"]
+#   puts custom.call("Custom colors")
+#
+# @see Style
+# @see Style#initialize
+# @author OZAWA Sakuro
+module TIntMe
+  # Setup Zeitwerk loader
+  loader = Zeitwerk::Loader.for_gem
+  loader.inflector.inflect(
+    "tint_me" => "TIntMe",
+    "sgr_builder" => "SGRBuilder"
+  )
+  loader.ignore("#{__dir__}/tint_me/version.rb")
+  loader.setup
+
+  # Shortcut method to create a Style instance with the given options
+  #
+  # This is a convenience method that passes all arguments directly to Style.new.
+  # Accepts the same keyword arguments as Style#initialize.
+  #
+  # @return [Style] A new Style instance
+  # @see Style#initialize
+  # @example Basic usage
+  #   blue = TIntMe[foreground: :blue]
+  #   bold_red = TIntMe[foreground: :red, bold: true]
+  #   puts blue.call("Hello")  # => blue "Hello"
+  # @example Immediate styling
+  #   puts TIntMe[foreground: :green, italic: true]["Success!"]
+  def self.[](...)
+    Style.new(...)
+  end
+end

data/mise.toml

@@ -0,0 +1,5 @@
+[tools]
+ruby = "3.2"
+
+[env]
+_.path = ["bin", "exe"]

data/sig/tint_me.rbs

@@ -0,0 +1,61 @@
+module TIntMe
+  VERSION: String
+
+  # Creates a new Style instance with the given options
+  def self.[]: (
+    ?foreground: Style::color_value?,
+    ?background: Style::color_value?,
+    ?bold: Style::boolean_value?,
+    ?faint: Style::boolean_value?,
+    ?italic: Style::boolean_value?,
+    ?underline: Style::underline_value?,
+    ?overline: Style::boolean_value?,
+    ?blink: Style::boolean_value?,
+    ?inverse: Style::boolean_value?,
+    ?conceal: Style::boolean_value?
+  ) -> Style
+
+  class Style
+    type color_value = :red | :green | :blue | :cyan | :yellow | :magenta | :gray | :white | :black | :default | :reset | String
+    type underline_value = bool | :double | :reset
+    type boolean_value = bool | :reset
+    type style_attribute = :red | :green | :blue | :cyan | :yellow | :magenta | :gray | :white | :black |
+                          :underline | :double_underline | :overline | :bold | :faint | :blink | :italic | :inverse | :conceal |
+                          String | nil
+
+    attr_reader foreground: color_value?
+    attr_reader background: color_value?
+    attr_reader bold: boolean_value?
+    attr_reader faint: boolean_value?
+    attr_reader italic: boolean_value?
+    attr_reader underline: underline_value?
+    attr_reader overline: boolean_value?
+    attr_reader blink: boolean_value?
+    attr_reader inverse: boolean_value?
+    attr_reader conceal: boolean_value?
+
+    def initialize: (
+      ?foreground: color_value?,
+      ?background: color_value?,
+      ?bold: boolean_value?,
+      ?faint: boolean_value?,
+      ?italic: boolean_value?,
+      ?underline: underline_value?,
+      ?overline: boolean_value?,
+      ?blink: boolean_value?,
+      ?inverse: boolean_value?,
+      ?conceal: boolean_value?
+    ) -> void
+
+    def call: (String text) -> String
+
+    alias [] call
+
+    def >>: (Style other) -> Style
+
+    private
+
+    def compose_attribute: ((color_value | underline_value | boolean_value)?, (color_value | underline_value | boolean_value)?) -> (color_value | underline_value | boolean_value)?
+
+  end
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: tint_me
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- OZAWA Sakuro
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: dry-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: |
+  A Ruby library for terminal text styling with ANSI colors and effects.
+  Provides an elegant, functional API with immutable style objects that can be
+  composed using the >> operator. Supports standard colors, hex values,
+  and comprehensive text effects including bold, faint, italic, underline,
+  overline, blink, inverse, and concealed text. Features type-safe argument
+  validation using dry-schema and dry-types.
+email:
+- 10973+sakuro@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop_todo.yml"
+- ".serena/project.yml"
+- ".simplecov"
+- ".yardopts"
+- AGENTS.md
+- CHANGELOG.md
+- CLAUDE.md
+- LICENSE.txt
+- README.md
+- RELEASING.md
+- Rakefile
+- benchmark/2025-09-08-style-caching-optimization/01_baseline_results.txt
+- benchmark/2025-09-08-style-caching-optimization/02_with_full_caching_results.txt
+- benchmark/2025-09-08-style-caching-optimization/03_prefix_only_caching_results.txt
+- benchmark/2025-09-08-style-caching-optimization/04_baseline_vs_optimized_analysis.txt
+- benchmark/2025-09-08-style-caching-optimization/05_caching_approaches_comparison.txt
+- benchmark/2025-09-08-style-caching-optimization/06_append_operator_results.txt
+- benchmark/2025-09-08-style-caching-optimization/07_string_concatenation_comparison.txt
+- benchmark/2025-09-08-style-caching-optimization/08_with_freeze_optimization_results.txt
+- benchmark/2025-09-08-style-caching-optimization/09_freeze_optimization_analysis.txt
+- benchmark/2025-09-08-style-caching-optimization/10_constant_access_results.txt
+- benchmark/2025-09-08-style-caching-optimization/11_constant_vs_cache_analysis.txt
+- benchmark/2025-09-08-style-caching-optimization/12_empty_prefix_analysis.txt
+- benchmark/2025-09-08-style-caching-optimization/13_nil_check_optimization_results.txt
+- benchmark/2025-09-08-style-caching-optimization/14_nil_vs_empty_check_analysis.txt
+- benchmark/2025-09-08-style-caching-optimization/README.md
+- benchmark/2025-09-08-style-caching-optimization/benchmark_script.rb
+- docs/agents/git-pr.md
+- docs/agents/languages.md
+- docs/agents/rubocop.md
+- lib/tint_me.rb
+- lib/tint_me/error.rb
+- lib/tint_me/sgr_builder.rb
+- lib/tint_me/style.rb
+- lib/tint_me/style/schema.rb
+- lib/tint_me/style/types.rb
+- lib/tint_me/version.rb
+- mise.toml
+- sig/tint_me.rbs
+homepage: https://github.com/sakuro/tint_me
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/sakuro/tint_me
+  source_code_uri: https://github.com/sakuro/tint_me.git
+  changelog_uri: https://github.com/sakuro/tint_me/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.9
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Functional terminal text styling with composable ANSI colors and effects
+test_files: []