shadcn_view_components 0.2.0

data/lib/generators/shadcn_view_components/install_generator.rb

@@ -0,0 +1,182 @@
+# typed: strict
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module ShadcnViewComponents
+  module Generators
+    module JavascriptDeliveryMode
+      extend T::Sig
+
+      MODES = %w[importmap bundler].freeze
+
+      sig { params(value: String).returns(String) }
+      def self.validate(value)
+        return value if MODES.include?(value)
+
+        Kernel.raise ArgumentError, "unknown JavaScript delivery mode #{value.inspect} (valid: #{MODES.join(', ')})"
+      end
+    end
+
+    # ホストアプリへのインストール手順を自動化する(06-theming-tailwind §5)。
+    #
+    # - tailwindcss-rails標準のTailwindエントリCSSにEngine CSSの @import 行を追記する
+    # - JS登録スニペットの追記を案内する
+    # - 冪等であること(二回実行で重複行を作らない)
+    class InstallGenerator < Rails::Generators::Base
+      extend T::Sig
+      include Thor::Actions
+
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :javascript, type: :string, default: "importmap",
+                                desc: "JavaScript delivery mode: importmap or bundler"
+
+      VENDORED_JAVASCRIPT_PATH = "vendor/shadcn_view_components/javascript"
+      TAILWIND_STYLESHEET_PATH = "app/assets/tailwind/application.css"
+
+      sig { void }
+      def append_stylesheets
+        JavascriptDeliveryMode.validate(T.cast(options["javascript"], String))
+        entry_path = File.expand_path(TAILWIND_STYLESHEET_PATH, destination_root)
+        unless File.file?(entry_path)
+          Kernel.raise Thor::Error,
+                       "#{TAILWIND_STYLESHEET_PATH} was not found. Run `bin/rails tailwindcss:install` first."
+        end
+
+        current = File.binread(entry_path)
+        normalized = stylesheet_with_directives(current)
+
+        create_file(TAILWIND_STYLESHEET_PATH, normalized, force: true) unless current == normalized
+      end
+
+      sig { void }
+      def install_javascript_package
+        return unless bundler_javascript?
+
+        # このdirectoryはgenerator管理。gem更新時に削除済みfileを残さず完全同期する。
+        if behavior == :revoke
+          empty_directory(VENDORED_JAVASCRIPT_PATH)
+        else
+          remove_dir(VENDORED_JAVASCRIPT_PATH)
+          directory(javascript_package_path, VENDORED_JAVASCRIPT_PATH, force: true)
+        end
+      end
+
+      sig { void }
+      def print_js_instructions
+        if bundler_javascript?
+          say <<~TEXT
+
+            Interactive components need Stimulus registration. The ESM package was
+            synchronized to #{VENDORED_JAVASCRIPT_PATH}. Add the repository-relative
+            package with your package manager:
+
+                pnpm add ./#{VENDORED_JAVASCRIPT_PATH}
+                # or: npm install ./#{VENDORED_JAVASCRIPT_PATH}
+
+            Then add to the bundled JavaScript entry point:
+
+                import { register } from "@supermomonga/shadcn-view-components"
+                register(application)
+          TEXT
+        else
+          say <<~TEXT
+
+            Interactive components need Stimulus registration. With importmap-rails
+            (auto-pinned by the engine), add to app/javascript/application.js:
+
+                import { register } from "@supermomonga/shadcn-view-components"
+                register(application)
+          TEXT
+        end
+      end
+
+      private
+
+      sig { params(contents: String).returns(String) }
+      def stylesheet_with_directives(contents)
+        newline = contents.include?("\r\n") ? "\r\n" : "\n"
+        lines = contents.lines(chomp: true).reject do |line|
+          managed_comment_line?(line) || animate_import_line?(line) || engine_import_line?(line)
+        end
+        insertion_index = directive_insertion_index(lines)
+        while insertion_index.positive? && lines.fetch(insertion_index - 1).empty?
+          lines.delete_at(insertion_index - 1)
+          insertion_index -= 1
+        end
+        lines.insert(insertion_index, animate_import, "", managed_comment, engine_import)
+
+        "#{lines.join(newline)}#{newline}"
+      end
+
+      sig { returns(String) }
+      def managed_comment
+        "/* shadcn_view_components */"
+      end
+
+      sig { returns(String) }
+      def animate_import
+        '@import "tw-animate-css";'
+      end
+
+      sig { returns(String) }
+      def engine_import
+        '@import "../builds/tailwind/shadcn_view_components";'
+      end
+
+      sig { params(line: String).returns(T::Boolean) }
+      def managed_comment_line?(line)
+        line.strip == managed_comment
+      end
+
+      sig { params(line: String).returns(T::Boolean) }
+      def animate_import_line?(line)
+        line.match?(/\A[ \t]*@import[ \t]+(["'])tw-animate-css\1[ \t]*;?[ \t]*\z/)
+      end
+
+      sig { params(line: String).returns(T::Boolean) }
+      def engine_import_line?(line)
+        line.match?(%r{\A[ \t]*@import[ \t]+(["'])\.\./builds/tailwind/shadcn_view_components\1[ \t]*;?[ \t]*\z})
+      end
+
+      sig { params(lines: T::Array[String]).returns(Integer) }
+      def directive_insertion_index(lines)
+        in_comment = T.let(false, T::Boolean)
+
+        lines.each_with_index do |line, index|
+          stripped = line.strip
+          if in_comment
+            in_comment = false if stripped.include?("*/")
+          elsif stripped.start_with?("/*")
+            in_comment = !stripped.include?("*/")
+          elsif !stripped.empty? && !prologue_directive?(stripped)
+            return index
+          end
+        end
+
+        lines.length
+      end
+
+      sig { params(line: String).returns(T::Boolean) }
+      def prologue_directive?(line)
+        line.match?(/\A@charset[ \t]+/) || line.match?(/\A@import(?:[ \t]+|\()/)
+      end
+
+      sig { returns(String) }
+      def gem_root
+        Gem.loaded_specs.fetch("shadcn_view_components").full_gem_path
+      end
+
+      sig { returns(String) }
+      def javascript_package_path
+        File.join(gem_root, "app", "assets", "javascripts", "shadcn")
+      end
+
+      sig { returns(T::Boolean) }
+      def bundler_javascript?
+        JavascriptDeliveryMode.validate(T.cast(options["javascript"], String)) == "bundler"
+      end
+    end
+  end
+end

data/lib/shadcn_view_components/classes.rb

@@ -0,0 +1,89 @@
+# typed: strict
+# frozen_string_literal: true
+
+require "tailwind_merge"
+
+module ShadcnViewComponents
+  # 契約(lib/shadcn_view_components/generated/contracts)を引いて、
+  # 事前解決済みの最終クラス文字列を返すランタイムヘルパ。
+  #
+  # Ruby側にマージロジックの再実装を持たないことが upstream との視覚的一致の要点であり、
+  # ここで行うのは (1) 組み合わせテーブルの辞書引き (2) 呼び出し元の追加クラスとの統合のみ。
+  module Classes
+    extend T::Sig
+
+    # NOTE: module_function はディレクティブ形式で使う(修飾子形式 + rest.kwargsは
+    # sorbet-runtimeの実行時検証がrest引数を誤バインドするため)
+
+    module_function
+
+    VariantValue = T.type_alias { T.nilable(T.any(Symbol, String)) }
+
+    MERGER = TailwindMerge::Merger.new
+
+    sig { params(component: Symbol).returns(T::Module[T.anything]) }
+    def contract_for(component)
+      constant_path = component.to_s.split("/").map do |segment|
+        ShadcnViewComponents::ComponentNaming.constant_name(segment)
+      end.join("::")
+      ShadcnViewComponents::Contracts.const_get(constant_path, false)
+    end
+
+    sig do
+      params(
+        component: Symbol,
+        extra: T.nilable(String),
+        options: T::Hash[Symbol, VariantValue]
+      ).returns(String)
+    end
+    def resolve(component, extra: nil, **options)
+      contract = contract_for(component)
+      defaults = T.cast(contract.const_get(:DEFAULTS), T::Hash[Symbol, Symbol])
+      normalized = {}
+      options.each do |prop, value|
+        normalized[prop] = normalize_option(component, prop, value) unless value.nil?
+      end
+      resolved = T.cast(T.unsafe(contract).combination(defaults.merge(normalized)), String)
+      # 追加クラスが無いときは事前解決済み文字列をそのまま返す(契約との完全一致を保証)。
+      # あるときのみ tailwind_merge で統合する(利用者の上書きが後勝ち)。
+      return resolved if extra.nil? || extra.empty?
+
+      MERGER.merge("#{resolved} #{extra}")
+    end
+
+    # バリアント値の正規化 + fail-fast検証(01-architecture §6.1)。
+    # 契約に存在しない値は静かにデフォルトへ落とさず ArgumentError。
+    sig { params(component: Symbol, prop: Symbol, value: T.untyped).returns(Symbol) }
+    def normalize_option(component, prop, value)
+      contract = contract_for(component)
+      values = variant_values(contract, prop)
+      invalid_variant_value!(contract, prop, value, values) unless value.is_a?(Symbol) || value.is_a?(String)
+
+      symbol = value.to_sym
+      invalid_variant_value!(contract, prop, value, values) unless values.include?(symbol)
+      symbol
+    end
+
+    sig { params(contract: T::Module[T.anything], prop: Symbol).returns(T::Array[Symbol]) }
+    def variant_values(contract, prop)
+      allowed = T.cast(contract.const_get(:VARIANTS), T::Hash[Symbol, T::Array[Symbol]])
+      allowed.fetch(prop) do
+        Kernel.raise ArgumentError, "unknown variant prop #{prop.inspect} for #{contract} (valid: #{allowed.keys.map(&:inspect).join(', ')})"
+      end
+    end
+
+    sig do
+      params(
+        contract: T::Module[T.anything],
+        prop: Symbol,
+        value: T.untyped,
+        values: T::Array[Symbol]
+      ).returns(T.noreturn)
+    end
+    def invalid_variant_value!(contract, prop, value, values)
+      Kernel.raise ArgumentError,
+                   "unknown variant value #{value.inspect} for #{prop} of #{contract} " \
+                   "(valid: #{values.map(&:inspect).join(', ')})"
+    end
+  end
+end

data/lib/shadcn_view_components/component_naming.rb

@@ -0,0 +1,21 @@
+# typed: strict
+# frozen_string_literal: true
+
+module ShadcnViewComponents
+  # file/contract名から、このgemが定義するcomponent定数名を決める。
+  # ActiveSupportのglobal inflectionには依存せず、頭字語の規則もここだけで管理する。
+  module ComponentNaming
+    extend T::Sig
+
+    CONSTANT_OVERRIDES = T.let({
+      "input_otp" => "InputOTP"
+    }.freeze, T::Hash[String, String])
+
+    sig { params(basename: String).returns(String) }
+    def self.constant_name(basename)
+      CONSTANT_OVERRIDES.fetch(basename) do
+        basename.split("_").map(&:capitalize).join
+      end
+    end
+  end
+end

data/lib/shadcn_view_components/contracts/calendar.rb

@@ -0,0 +1,95 @@
+# typed: strict
+# frozen_string_literal: true
+
+# calendar の個別契約(10-roadmap Phase 4 の個別評価ルート)。
+# upstream は react-day-picker の classNames 実行時合成(cn(defaultClassNames.*)
+# や String.raw)を行うため静的抽出の対象外。クラス文字列は tools/extractor と
+# 同一の cva + tailwind-merge で事前解決した値を手動で保守する。
+# upstream 再取得時はこの値の再計算が必要(rake shadcn:generate の対象外である点に注意)
+module ShadcnViewComponents
+  module Contracts
+    module Calendar
+      ROOT_SLOT = T.let("calendar", String)
+
+      DEFAULTS = T.let({}.freeze, T::Hash[Symbol, Symbol])
+
+      VARIANTS = T.let({}.freeze, T::Hash[Symbol, T::Array[Symbol]])
+
+      COMBINATIONS = T.let({
+        # 冒頭の flex 群は upstream ラッパー Calendar の className。upstream は
+        # md:flex-row で複数月を横並びにできるが、本実装は単月のみの描画のため
+        # 入れない(rdp-root は react-day-picker 内部クラスのためDOMには出ない)
+        {} => "relative flex flex-col gap-4 group/calendar bg-background p-2 " \
+              "[--cell-radius:var(--radius-md)] [--cell-size:--spacing(7)] " \
+              "in-data-[slot=card-content]:bg-transparent in-data-[slot=popover-content]:bg-transparent w-fit"
+      }.freeze, T::Hash[T::Hash[Symbol, Symbol], String])
+
+      SLOTS = T.let([
+        {
+          name: "calendar",
+          tag: "div",
+          static_attributes: {}.freeze,
+          dynamic_attributes: [].freeze
+        }.freeze
+      ].freeze, T::Array[T::Hash[Symbol, T.untyped]])
+
+      extend T::Sig
+
+      sig { params(options: T::Hash[Symbol, Symbol]).returns(String) }
+      module_function def combination(options)
+        COMBINATIONS.fetch(options)
+      end
+
+      module DayButton
+        # upstream は <Button variant="ghost" size="icon"> を土台に day 用クラスを
+        # tailwind-merge で合成する(size-8 は size-auto に、px-2.5 は icon サイズの
+        # 採用で消える)。px-2.5 等が残るとボタンの最小幅が --cell-size を超え、
+        # グリッドが upstream より膨らむ
+        ROOT_SLOT = T.let("calendar-day-button", String)
+
+        DEFAULTS = T.let({}.freeze, T::Hash[Symbol, Symbol])
+
+        VARIANTS = T.let({}.freeze, T::Hash[Symbol, T::Array[Symbol]])
+
+        COMBINATIONS = T.let({
+          {} => "group/button shrink-0 items-center justify-center rounded-lg border-transparent bg-clip-padding " \
+                "text-sm whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring " \
+                "focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px " \
+                "disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive " \
+                "aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 " \
+                "dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 " \
+                "[&_svg:not([class*='size-'])]:size-4 hover:bg-muted hover:text-foreground " \
+                "aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50 " \
+                "relative isolate z-10 flex " \
+                "aspect-square size-auto w-full min-w-(--cell-size) flex-col gap-1 border-0 leading-none " \
+                "font-normal group-data-[focused=true]/day:relative group-data-[focused=true]/day:z-10 " \
+                "group-data-[focused=true]/day:border-ring group-data-[focused=true]/day:ring-[3px] " \
+                "group-data-[focused=true]/day:ring-ring/50 data-[range-end=true]:rounded-(--cell-radius) " \
+                "data-[range-end=true]:rounded-r-(--cell-radius) data-[range-end=true]:bg-primary " \
+                "data-[range-end=true]:text-primary-foreground data-[range-middle=true]:rounded-none " \
+                "data-[range-middle=true]:bg-muted data-[range-middle=true]:text-foreground " \
+                "data-[range-start=true]:rounded-(--cell-radius) data-[range-start=true]:rounded-l-(--cell-radius) " \
+                "data-[range-start=true]:bg-primary data-[range-start=true]:text-primary-foreground " \
+                "data-[selected-single=true]:bg-primary data-[selected-single=true]:text-primary-foreground " \
+                "dark:hover:text-foreground [&>span]:text-xs [&>span]:opacity-70"
+        }.freeze, T::Hash[T::Hash[Symbol, Symbol], String])
+
+        SLOTS = T.let([
+          {
+            name: "calendar-day-button",
+            tag: "button",
+            static_attributes: {}.freeze,
+            dynamic_attributes: [].freeze
+          }.freeze
+        ].freeze, T::Array[T::Hash[Symbol, T.untyped]])
+
+        extend T::Sig
+
+        sig { params(options: T::Hash[Symbol, Symbol]).returns(String) }
+        module_function def combination(options)
+          COMBINATIONS.fetch(options)
+        end
+      end
+    end
+  end
+end

data/lib/shadcn_view_components/engine.rb

@@ -0,0 +1,56 @@
+# typed: strict
+# frozen_string_literal: true
+
+require "rails"
+
+module ShadcnViewComponents
+  class Engine < ::Rails::Engine
+    isolate_namespace ShadcnViewComponents
+
+    # Rails engineのcomponentはhost applicationとmain loaderを共有する。
+    # fallbackはRails既定のinflectorへ委譲し、このengineのinput_otp.rbだけを
+    # InputOTPへ写像することでhostの同名fileとActiveSupportの命名規則を変更しない。
+    class ComponentInflector
+      extend T::Sig
+
+      sig { params(delegate: T.untyped, input_otp_path: String).void }
+      def initialize(delegate:, input_otp_path:)
+        @delegate = T.let(delegate, T.untyped)
+        @input_otp_path = T.let(File.expand_path(input_otp_path), String)
+      end
+
+      sig { params(basename: String, abspath: String).returns(String) }
+      def camelize(basename, abspath)
+        return ShadcnViewComponents::ComponentNaming.constant_name(basename) if basename == "input_otp" && File.expand_path(abspath) == @input_otp_path
+
+        T.cast(@delegate.camelize(basename, abspath), String)
+      end
+
+      sig { params(overrides: T::Hash[String, String]).void }
+      def inflect(overrides)
+        @delegate.inflect(overrides)
+      end
+    end
+    private_constant :ComponentInflector
+
+    initializer "shadcn_view_components.inflector", before: :setup_main_autoloader do
+      loader = Rails.autoloaders.main
+      input_otp_path = ShadcnViewComponents::Engine.root.join("app/components/shadcn/input_otp.rb").to_s
+      loader.inflector = ComponentInflector.new(delegate: loader.inflector, input_otp_path: input_otp_path)
+    end
+
+    initializer "shadcn_view_components.assets" do |app|
+      root = ShadcnViewComponents::Engine.root
+      app.config.assets.paths << root.join("app/assets/javascripts")
+    end
+
+    # importmap-railsの標準engine統合に従い、map定義とcache監視対象を
+    # importmap本体のinitializerより前に追加する。未導入のhostでは何もしない。
+    initializer "shadcn_view_components.importmap", before: "importmap" do |app|
+      next unless app.config.respond_to?(:importmap)
+
+      app.config.importmap.paths << root.join("config/importmap.rb")
+      app.config.importmap.cache_sweepers << root.join("app/assets/javascripts")
+    end
+  end
+end

data/lib/shadcn_view_components/generated/contracts/accordion.rb

@@ -0,0 +1,112 @@
+# typed: strict
+# frozen_string_literal: true
+
+# !! AUTO-GENERATED by tools/extractor — DO NOT EDIT !!
+# Source: shadcn/ui base-nova "accordion" (item sha256: dff3a1ce2033aaaa1df6f499f6d9187de7a46572c62d19c71ec5ba375412b5f9)
+# Regenerate with: rake shadcn:generate
+
+module ShadcnViewComponents
+  module Contracts
+    module Accordion
+      ROOT_SLOT = T.let("accordion", String)
+
+      DEFAULTS = T.let({}.freeze, T::Hash[Symbol, Symbol])
+
+      VARIANTS = T.let({}.freeze, T::Hash[Symbol, T::Array[Symbol]])
+
+      # キーはソート済みpropペア。値は事前解決済みの最終クラス文字列
+      COMBINATIONS = T.let({
+        {} => "flex w-full flex-col"
+      }.freeze, T::Hash[T::Hash[Symbol, Symbol], String])
+
+      SLOTS = T.let([
+        { name: "accordion", tag: "AccordionPrimitive.Root", static_attributes: {}.freeze, dynamic_attributes: [].freeze }.freeze
+      ].freeze, T::Array[T::Hash[Symbol, T.untyped]])
+
+      extend T::Sig
+
+      sig { params(options: T::Hash[Symbol, Symbol]).returns(String) }
+      module_function def combination(options)
+        COMBINATIONS.fetch(options)
+      end
+      module Content
+      ROOT_SLOT = T.let("accordion-content", String)
+
+      # 契約クラスが属する要素の data-slot(ルートがラッパー構造の場合)
+      CLASSES_SLOT = T.let("", String)
+
+      DEFAULTS = T.let({}.freeze, T::Hash[Symbol, Symbol])
+
+      VARIANTS = T.let({}.freeze, T::Hash[Symbol, T::Array[Symbol]])
+
+      # キーはソート済みpropペア。値は事前解決済みの最終クラス文字列
+      COMBINATIONS = T.let({
+        {} => "h-(--accordion-panel-height) pt-0 pb-2.5 data-ending-style:h-0 data-starting-style:h-0 [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4"
+      }.freeze, T::Hash[T::Hash[Symbol, Symbol], String])
+
+      SLOTS = T.let([
+        { name: "accordion-content", tag: "AccordionPrimitive.Panel", static_attributes: { class: "overflow-hidden text-sm data-open:animate-accordion-down data-closed:animate-accordion-up" }.freeze, dynamic_attributes: [].freeze }.freeze
+      ].freeze, T::Array[T::Hash[Symbol, T.untyped]])
+
+      extend T::Sig
+
+      sig { params(options: T::Hash[Symbol, Symbol]).returns(String) }
+      module_function def combination(options)
+        COMBINATIONS.fetch(options)
+      end
+      end
+      module Item
+      ROOT_SLOT = T.let("accordion-item", String)
+
+      DEFAULTS = T.let({}.freeze, T::Hash[Symbol, Symbol])
+
+      VARIANTS = T.let({}.freeze, T::Hash[Symbol, T::Array[Symbol]])
+
+      # キーはソート済みpropペア。値は事前解決済みの最終クラス文字列
+      COMBINATIONS = T.let({
+        {} => "not-last:border-b"
+      }.freeze, T::Hash[T::Hash[Symbol, Symbol], String])
+
+      SLOTS = T.let([
+        { name: "accordion-item", tag: "AccordionPrimitive.Item", static_attributes: {}.freeze, dynamic_attributes: [].freeze }.freeze
+      ].freeze, T::Array[T::Hash[Symbol, T.untyped]])
+
+      extend T::Sig
+
+      sig { params(options: T::Hash[Symbol, Symbol]).returns(String) }
+      module_function def combination(options)
+        COMBINATIONS.fetch(options)
+      end
+      end
+      module Trigger
+      ROOT_SLOT = T.let("", String)
+
+      # 契約クラスが属する要素の data-slot(ルートがラッパー構造の場合)
+      CLASSES_SLOT = T.let("accordion-trigger", String)
+
+      DEFAULTS = T.let({}.freeze, T::Hash[Symbol, Symbol])
+
+      VARIANTS = T.let({}.freeze, T::Hash[Symbol, T::Array[Symbol]])
+
+      # キーはソート済みpropペア。値は事前解決済みの最終クラス文字列
+      COMBINATIONS = T.let({
+        {} => "group/accordion-trigger relative flex flex-1 items-start justify-between rounded-lg border border-transparent py-2.5 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:after:border-ring aria-disabled:pointer-events-none aria-disabled:opacity-50 **:data-[slot=accordion-trigger-icon]:ml-auto **:data-[slot=accordion-trigger-icon]:size-4 **:data-[slot=accordion-trigger-icon]:text-muted-foreground"
+      }.freeze, T::Hash[T::Hash[Symbol, Symbol], String])
+
+      SLOTS = T.let([
+        { name: "", tag: "AccordionPrimitive.Header", static_attributes: { class: "flex" }.freeze, dynamic_attributes: [].freeze }.freeze,
+        { name: "accordion-trigger", tag: "AccordionPrimitive.Trigger", static_attributes: {}.freeze, dynamic_attributes: [].freeze }.freeze,
+        { name: "accordion-trigger-icon", tag: "IconPlaceholder", static_attributes: { class: "pointer-events-none shrink-0 group-aria-expanded/accordion-trigger:hidden", hugeicons: "ArrowDown01Icon", lucide: "ChevronDownIcon", phosphor: "CaretDownIcon", remixicon: "RiArrowDownSLine", tabler: "IconChevronDown" }.freeze, dynamic_attributes: [].freeze }.freeze,
+        { name: "accordion-trigger-icon", tag: "IconPlaceholder", static_attributes: { class: "pointer-events-none hidden shrink-0 group-aria-expanded/accordion-trigger:inline", hugeicons: "ArrowUp01Icon", lucide: "ChevronUpIcon", phosphor: "CaretUpIcon", remixicon: "RiArrowUpSLine", tabler: "IconChevronUp" }.freeze, dynamic_attributes: [].freeze }.freeze
+      ].freeze, T::Array[T::Hash[Symbol, T.untyped]])
+
+      extend T::Sig
+
+      sig { params(options: T::Hash[Symbol, Symbol]).returns(String) }
+      module_function def combination(options)
+        COMBINATIONS.fetch(options)
+      end
+      end
+    end
+  end
+end