shadcn_view_components 0.2.0

data/lib/shadcn_view_components/numeric_property_validation.rb

@@ -0,0 +1,124 @@
+# typed: strict
+# frozen_string_literal: true
+
+module ShadcnViewComponents
+  module NumericPropertyValidation
+    extend T::Sig
+
+    NUMBER_PATTERN = /\A[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?\z/
+    INTEGER_PATTERN = /\A[+-]?\d+\z/
+
+    module_function
+
+    sig do
+      params(
+        owner: String,
+        property: Symbol,
+        value: T.untyped,
+        definition: T::Hash[Symbol, T.untyped]
+      ).returns(T.nilable(T.any(Integer, Float)))
+    end
+    def normalize(owner:, property:, value:, definition:)
+      return nil if value.nil? && definition.fetch(:allow_nil, false)
+
+      number = finite_number(value, integer: definition.fetch(:integer, false))
+      invalid_property!(owner, property, value, definition) unless number
+      validate_bounds!(owner, property, value, number, definition)
+    end
+
+    sig do
+      params(value: T.untyped, integer: T::Boolean)
+        .returns(T.nilable(T.any(Integer, Float)))
+    end
+    def finite_number(value, integer:)
+      number = integer ? parse_integer(value) : parse_number(value)
+      return number if number.is_a?(Integer)
+
+      number if number&.finite?
+    end
+
+    sig { params(value: T.untyped).returns(T.nilable(Integer)) }
+    def parse_integer(value)
+      return value if value.is_a?(Integer)
+      return unless value.is_a?(String)
+
+      normalized = value.strip
+      normalized.to_i if INTEGER_PATTERN.match?(normalized)
+    end
+
+    sig { params(value: T.untyped).returns(T.nilable(T.any(Integer, Float))) }
+    def parse_number(value)
+      return value if value.is_a?(Integer) || value.is_a?(Float)
+      return unless value.is_a?(String)
+
+      normalized = value.strip
+      return normalized.to_i if INTEGER_PATTERN.match?(normalized)
+
+      normalized.to_f if NUMBER_PATTERN.match?(normalized)
+    end
+
+    sig do
+      params(
+        owner: String,
+        property: Symbol,
+        value: T.untyped,
+        number: T.any(Integer, Float),
+        definition: T::Hash[Symbol, T.untyped]
+      ).returns(T.any(Integer, Float))
+    end
+    def validate_bounds!(owner, property, value, number, definition)
+      minimum = T.cast(definition[:minimum], T.nilable(T.any(Integer, Float)))
+      maximum = T.cast(definition[:maximum], T.nilable(T.any(Integer, Float)))
+      too_small = below_minimum?(number, minimum, definition.fetch(:exclusive_minimum, false))
+      too_large = maximum && number > maximum
+      invalid_property!(owner, property, value, definition) if too_small || too_large
+      number
+    end
+
+    sig do
+      params(
+        number: T.any(Integer, Float),
+        minimum: T.nilable(T.any(Integer, Float)),
+        exclusive: T::Boolean
+      ).returns(T::Boolean)
+    end
+    def below_minimum?(number, minimum, exclusive)
+      return false unless minimum
+
+      exclusive ? number <= minimum : number < minimum
+    end
+
+    sig { params(definition: T::Hash[Symbol, T.untyped]).returns(String) }
+    def number_requirement(definition)
+      description = definition.fetch(:integer, false) ? "a finite integer" : "a finite number"
+      description += bounds_requirement(definition)
+      description += " or nil" if definition.fetch(:allow_nil, false)
+      description
+    end
+
+    sig { params(definition: T::Hash[Symbol, T.untyped]).returns(String) }
+    def bounds_requirement(definition)
+      minimum = definition[:minimum]
+      maximum = definition[:maximum]
+      return " between #{minimum} and #{maximum}" if minimum && maximum
+      return " less than or equal to #{maximum}" if maximum
+      return "" unless minimum
+
+      comparison = definition.fetch(:exclusive_minimum, false) ? "greater than" : "greater than or equal to"
+      " #{comparison} #{minimum}"
+    end
+
+    sig do
+      params(
+        owner: String,
+        property: Symbol,
+        value: T.untyped,
+        definition: T::Hash[Symbol, T.untyped]
+      ).returns(T.noreturn)
+    end
+    def invalid_property!(owner, property, value, definition)
+      requirement = number_requirement(definition)
+      Kernel.raise ArgumentError, "#{owner} #{property} must be #{requirement}, got #{value.inspect}"
+    end
+  end
+end

data/lib/shadcn_view_components/property_contract_definitions.rb

@@ -0,0 +1,92 @@
+# typed: strict
+# frozen_string_literal: true
+
+module ShadcnViewComponents
+  module PropertyContracts
+    DIRECTIONS = %w[ltr rtl].freeze
+    ORIENTATIONS = %w[horizontal vertical].freeze
+    TOGGLE_STATES = %w[off on].freeze
+
+    DEFINITIONS = T.let({
+      progress: {
+        value: { kind: :number, default: nil, allow_nil: true, minimum: 0, maximum: 100 }.freeze
+      }.freeze,
+      slider: {
+        min: { kind: :number, default: 0 }.freeze,
+        max: { kind: :number, default: 100 }.freeze,
+        step: { kind: :number, default: 1, minimum: 0, exclusive_minimum: true }.freeze,
+        value: { kind: :number, default: nil, allow_nil: true }.freeze,
+        orientation: { kind: :enum, default: "horizontal", values: ORIENTATIONS }.freeze
+      }.freeze,
+      "sheet/content": {
+        side: { kind: :enum, default: "right", values: %w[top right bottom left].freeze }.freeze
+      }.freeze,
+      "scroll_area/scrollbar": {
+        orientation: { kind: :enum, default: "vertical", values: ORIENTATIONS }.freeze
+      }.freeze,
+      tabs: {
+        orientation: { kind: :enum, default: "horizontal", values: ORIENTATIONS }.freeze
+      }.freeze,
+      carousel: {
+        orientation: { kind: :enum, default: "horizontal", values: ORIENTATIONS }.freeze,
+        direction: { kind: :enum, default: "ltr", values: DIRECTIONS }.freeze
+      }.freeze,
+      "resizable/panel_group": {
+        orientation: { kind: :enum, default: "horizontal", values: ORIENTATIONS }.freeze
+      }.freeze,
+      "resizable/handle": {
+        orientation: { kind: :enum, default: "vertical", values: ORIENTATIONS }.freeze
+      }.freeze,
+      separator: {
+        orientation: { kind: :enum, default: "horizontal", values: ORIENTATIONS }.freeze
+      }.freeze,
+      toggle: {
+        state: { kind: :enum, default: "off", values: TOGGLE_STATES }.freeze
+      }.freeze,
+      toggle_group: {
+        type: { kind: :enum, default: "multiple", values: %w[single multiple].freeze }.freeze,
+        spacing: { kind: :number, default: 2, minimum: 0 }.freeze
+      }.freeze,
+      "toggle_group/item": {
+        state: { kind: :enum, default: "off", values: TOGGLE_STATES }.freeze,
+        spacing: { kind: :number, default: 2, minimum: 0 }.freeze
+      }.freeze,
+      direction_provider: {
+        dir: { kind: :enum, default: "ltr", values: DIRECTIONS }.freeze
+      }.freeze,
+      sidebar: {
+        state: { kind: :enum, default: "open", values: %w[open closed].freeze }.freeze
+      }.freeze,
+      "sidebar/provider": {
+        state: { kind: :enum, default: "open", values: %w[open closed].freeze }.freeze
+      }.freeze,
+      "sidebar/menu_sub_button": {
+        size: { kind: :enum, default: "md", values: %w[sm md].freeze }.freeze
+      }.freeze,
+      "alert_dialog/content": {
+        size: { kind: :enum, default: "default", values: %w[default sm].freeze }.freeze
+      }.freeze,
+      avatar: {
+        size: { kind: :enum, default: "default", values: %w[default sm lg].freeze }.freeze
+      }.freeze,
+      switch: {
+        size: { kind: :enum, default: "default", values: %w[default sm].freeze }.freeze
+      }.freeze,
+      "select/trigger": {
+        size: { kind: :enum, default: "default", values: %w[default sm].freeze }.freeze
+      }.freeze,
+      native_select: {
+        size: { kind: :enum, default: "default", values: %w[default sm].freeze }.freeze
+      }.freeze,
+      aspect_ratio: {
+        ratio: { kind: :number, default: nil, allow_nil: true, minimum: 0, exclusive_minimum: true }.freeze
+      }.freeze,
+      input_otp: {
+        length: { kind: :number, default: 6, integer: true, minimum: 1 }.freeze
+      }.freeze,
+      "input_otp/slot": {
+        index: { kind: :number, default: 0, integer: true, minimum: 0 }.freeze
+      }.freeze
+    }.freeze, T::Hash[Symbol, T::Hash[Symbol, T::Hash[Symbol, T.untyped]]])
+  end
+end

data/lib/shadcn_view_components/property_contracts.rb

@@ -0,0 +1,42 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative "property_contract_definitions"
+require_relative "property_validation"
+
+module ShadcnViewComponents
+  # CVA由来のVARIANTSでは表現できない、Rails公開API固有の意味的なprop契約。
+  # data属性・ARIA・CSS値へ出す前に、この定義を唯一の値域として正規化する。
+  module PropertyContracts
+    extend T::Sig
+
+    module_function
+
+    sig { params(component: Symbol, property: Symbol).returns(T::Hash[Symbol, T.untyped]) }
+    def fetch(component, property)
+      properties = DEFINITIONS.fetch(component) do
+        Kernel.raise KeyError, "no property contract for #{component.inspect}"
+      end
+      properties.fetch(property) do
+        Kernel.raise KeyError, "no property contract for #{component.inspect}.#{property}"
+      end
+    end
+
+    sig { params(component: Symbol, property: Symbol).returns(T.untyped) }
+    def default(component, property)
+      fetch(component, property).fetch(:default)
+    end
+
+    sig do
+      params(
+        component: Symbol,
+        owner: String,
+        property: Symbol,
+        value: T.untyped
+      ).returns(T.untyped)
+    end
+    def normalize(component:, owner:, property:, value:)
+      PropertyValidation.normalize(owner:, property:, value:, definition: fetch(component, property))
+    end
+  end
+end

data/lib/shadcn_view_components/property_validation.rb

@@ -0,0 +1,55 @@
+# typed: strict
+# frozen_string_literal: true
+
+require_relative "numeric_property_validation"
+
+module ShadcnViewComponents
+  # PropertyContractsに宣言された列挙値・数値を、描画前に正規化する。
+  module PropertyValidation
+    extend T::Sig
+
+    module_function
+
+    sig do
+      params(
+        owner: String,
+        property: Symbol,
+        value: T.untyped,
+        definition: T::Hash[Symbol, T.untyped]
+      ).returns(T.untyped)
+    end
+    def normalize(owner:, property:, value:, definition:)
+      case definition.fetch(:kind)
+      when :enum
+        normalize_enum(owner, property, value, definition)
+      when :number
+        NumericPropertyValidation.normalize(owner:, property:, value:, definition:)
+      else
+        Kernel.raise KeyError, "unknown property contract kind for #{owner}.#{property}"
+      end
+    end
+
+    sig do
+      params(
+        owner: String,
+        property: Symbol,
+        value: T.untyped,
+        definition: T::Hash[Symbol, T.untyped]
+      ).returns(String)
+    end
+    def normalize_enum(owner, property, value, definition)
+      values = T.cast(definition.fetch(:values), T::Array[String])
+      invalid_property!(owner, property, value, "one of #{values.map(&:inspect).join(', ')}") unless value.is_a?(String) || value.is_a?(Symbol)
+
+      normalized = value.to_s
+      return normalized if values.include?(normalized)
+
+      invalid_property!(owner, property, value, "one of #{values.map(&:inspect).join(', ')}")
+    end
+
+    sig { params(owner: String, property: Symbol, value: T.untyped, requirement: String).returns(T.noreturn) }
+    def invalid_property!(owner, property, value, requirement)
+      Kernel.raise ArgumentError, "#{owner} #{property} must be #{requirement}, got #{value.inspect}"
+    end
+  end
+end

data/lib/shadcn_view_components/version.rb

@@ -0,0 +1,6 @@
+# typed: strict
+# frozen_string_literal: true
+
+module ShadcnViewComponents
+  VERSION = "0.2.0"
+end

data/lib/shadcn_view_components.rb

@@ -0,0 +1,21 @@
+# typed: strict
+# frozen_string_literal: true
+
+# 生成物(contracts/*.rb)の T.let / sig がロード時に評価されるため、
+# view_component と sorbet-runtime を最初に明示ロードする
+require "sorbet-runtime"
+require "tailwindcss-rails"
+require "view_component"
+
+require_relative "shadcn_view_components/version"
+require_relative "shadcn_view_components/component_naming"
+require_relative "shadcn_view_components/property_contracts"
+require_relative "shadcn_view_components/engine"
+require_relative "shadcn_view_components/classes"
+
+# 生成された契約モジュール(lib/shadcn_view_components/generated/contracts/*.rb)。
+# app/components の実装はこの定数のみを参照する(クラス文字列を手書きしない規約)。
+Dir[File.expand_path("shadcn_view_components/generated/contracts/*.rb", __dir__)].each { |path| require path }
+
+# 個別契約(静的抽出の対象外コンポーネント — calendar)
+require_relative "shadcn_view_components/contracts/calendar"