phlex_kit 0.10.0 → 0.11.0

data/app/components/phlex_kit/typography/heading.rb

@@ -8,6 +8,9 @@ module PhlexKit
     # ruby_ui's level → default size mapping (h1 is big, h4 smaller); 5/6
     # extend the scale downward — HTML has h1–h6, so all six must map.
     LEVEL_SIZE = { "1" => "7", "2" => "6", "3" => "5", "4" => "4", "5" => "3", "6" => "2" }.freeze
+    # `as:` is dispatched dynamically (send) — whitelist so it can't reach
+    # arbitrary (including private) methods. Mirrors Separator/Marker.
+    AS_TAGS = %i[h1 h2 h3 h4 h5 h6 p span div].freeze
 
     # level: defaults to 1 so `Heading.new` is identical to `Heading.new(level: 1)`
     # (a nil default used to render h1 with the level-6 size — self-disagreeing).
@@ -18,7 +21,10 @@ module PhlexKit
         raise ArgumentError, "Invalid heading level: #{level.inspect} — valid: 1–6"
       end
       @level = level
-      @as = as
+      @as = as&.to_sym
+      if @as && !AS_TAGS.include?(@as)
+        raise ArgumentError, "unknown Heading as: #{@as.inspect} (use one of #{AS_TAGS.join(", ")})"
+      end
       @size = size
       @attrs = attrs
     end

data/app/components/phlex_kit/typography/list.rb

@@ -0,0 +1,22 @@
+module PhlexKit
+  # Prose list, ported from shadcn/ui's typography "list" style (ruby_ui's
+  # TypographyList). Renders a ul (or ol via as:) with the .pk-list styling
+  # that previously shipped as an orphaned utility class. Children are plain
+  # <li>s.
+  class List < BaseComponent
+    # `as:` is dispatched dynamically (send) — whitelist like Separator.
+    AS_TAGS = %i[ul ol].freeze
+
+    def initialize(as: :ul, **attrs)
+      @as = as.to_sym
+      unless AS_TAGS.include?(@as)
+        raise ArgumentError, "unknown List as: #{@as.inspect} (use one of #{AS_TAGS.join(", ")})"
+      end
+      @attrs = attrs
+    end
+
+    def view_template(&)
+      send(@as, **mix({ class: "pk-list" }, @attrs), &)
+    end
+  end
+end

data/app/components/phlex_kit/typography/text.rb

@@ -27,9 +27,15 @@ module PhlexKit
       bold: "pk-text-bold",
       muted: "pk-text-muted"
     }.freeze
+    # `as:` is dispatched dynamically (send) — whitelist so it can't reach
+    # arbitrary (including private) methods. Mirrors Separator/Marker.
+    AS_TAGS = %i[p span div label small strong em].freeze
 
     def initialize(as: :p, size: "3", weight: :regular, **attrs)
-      @as = as
+      @as = as.to_sym
+      unless AS_TAGS.include?(@as)
+        raise ArgumentError, "unknown Text as: #{@as.inspect} (use one of #{AS_TAGS.join(", ")})"
+      end
       @size = size.to_s
       @weight = weight.to_sym
       @attrs = attrs

data/lib/phlex_kit/base_component.rb

@@ -30,5 +30,18 @@ module PhlexKit
                         "valid: #{map.keys.map(&:inspect).join(", ")}"
       end
     end
+
+    # True when the caller supplied an accessible name in @attrs — via the
+    # aria: hash or flat aria_label/aria-label(ledby) keys. Components with a
+    # generated default label must skip it then: `mix` merges duplicate string
+    # attrs ("pagination Résultats") instead of overriding.
+    def aria_labelled?
+      aria = @attrs[:aria] || @attrs["aria"]
+      if aria.is_a?(Hash)
+        return true if %i[label labelledby].any? { |k| aria[k] || aria[k.to_s] }
+      end
+      [ :aria_label, "aria_label", "aria-label",
+        :aria_labelledby, "aria_labelledby", "aria-labelledby" ].any? { |k| @attrs[k] }
+    end
   end
 end

data/lib/phlex_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PhlexKit
-  VERSION = "0.10.0"
+  VERSION = "0.11.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phlex_kit
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Matt Kennedy
@@ -373,6 +373,7 @@ files:
 - app/components/phlex_kit/hover_card/hover_card_content.rb
 - app/components/phlex_kit/hover_card/hover_card_controller.js
 - app/components/phlex_kit/hover_card/hover_card_trigger.rb
+- app/components/phlex_kit/icon/icon.css
 - app/components/phlex_kit/icon/icon.rb
 - app/components/phlex_kit/input/input.css
 - app/components/phlex_kit/input/input.rb
@@ -587,6 +588,7 @@ files:
 - app/components/phlex_kit/typography/heading.rb
 - app/components/phlex_kit/typography/inline_code.rb
 - app/components/phlex_kit/typography/inline_link.rb
+- app/components/phlex_kit/typography/list.rb
 - app/components/phlex_kit/typography/text.rb
 - app/components/phlex_kit/typography/typography.css
 - app/javascript/phlex_kit/controllers/index.js