poetry-core 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72998473fe858b7965080423352da67d02f8cc6c35caf3bf53369f590808894d
-  data.tar.gz: ee168d90ba65226c1016ff00c857e782136a388d2d29cf19d4f0a35d6f330af1
+  metadata.gz: f9fa980bdf8c3d65b51511142615257e850e3ce355fda679dec434aa34e0e3d9
+  data.tar.gz: fb7a6d93fec947bcaa4934f70163679a0c0c196e54985012e821e6d1840b614f
 SHA512:
-  metadata.gz: 9c0a44e06ddadad7ff598f256ffc0134da027d3fb00e528228bda28f901a9d72758d29ed0aab0055b196df1d8fa8453aaa644f37301bde3ad36fb6a12c60290e
-  data.tar.gz: 56b8888668d81cc38c4ff5c78240fc57fd2ecc8370c22f59980055ada7c7d9d4a5dd5dcdb0ba5f5d79bba0f05a501956a35201c5a3f5d2b2aa537a0ebeb25eef
+  metadata.gz: aab549c214fc3ce8312692c3cca3cbf2daf0ee551fed9b9514a02110fe0d31542a5f8b8a972682bf0a11e53fcb99ef8f378453284151e6078ce532f83faf23a7
+  data.tar.gz: 8137bf971f7ececd840a190c61deba49fc29408fab30d9696b5f8ce7fd3b934db22585f3070fb0effff09532d1c0992b02831d4590b78cb3337e6aa2cb83a563

data/.gitattributes

@@ -0,0 +1,5 @@
+# GitHub language stats (Linguist): the vendored floating-ui dists and the
+# JS test suite are not this gem's source; without this the repo reads as
+# JavaScript instead of Ruby.
+app/javascript/poetry/core/vendor/** linguist-vendored
+test/javascript/** linguist-vendored

data/app/javascript/poetry/core/date_field_controller.js

@@ -27,7 +27,8 @@ const isApplePlatform = () => /iP(hone|ad|od)/.test(navigator.userAgent) ||
 
 const EDITABLE = {
   date: ["year", "month", "day"],
-  time: ["hour", "minute", "second", "dayPeriod"]
+  time: ["hour", "minute", "second", "dayPeriod"],
+  datetime: ["year", "month", "day", "hour", "minute", "second", "dayPeriod"]
 }
 
 export default class DateFieldController extends Controller {
@@ -109,8 +110,15 @@ export default class DateFieldController extends Controller {
 
   // --- build ---
 
+  // The native input's type is the contract: date, time, or (datetime-local)
+  // both runs in one row, joined by the locale's own separator.
   get #kind() {
-    return this.inputTarget.type === "time" ? "time" : "date"
+    const type = this.inputTarget.type
+
+    if (type === "time") return "time"
+    if (type === "datetime-local") return "datetime"
+
+    return "date"
   }
 
   #resolvedHourCycle() {
@@ -122,13 +130,15 @@ export default class DateFieldController extends Controller {
   }
 
   #formatterOptions() {
-    if (this.#kind === "date") return { year: "numeric", month: "numeric", day: "numeric" }
+    const date = { year: "numeric", month: "numeric", day: "numeric" }
+
+    if (this.#kind === "date") return date
 
     const options = { hour: "numeric", minute: "2-digit", hourCycle: this.#value.hourCycle }
 
     if (this.secondsValue) options.second = "2-digit"
 
-    return options
+    return this.#kind === "datetime" ? { ...date, ...options } : options
   }
 
   #buildSegments() {
@@ -145,7 +155,7 @@ export default class DateFieldController extends Controller {
 
     // RTL correctness: the time run is wrapped in LRI/PDI isolates so
     // minute:hour never renders reversed (harmless in LTR).
-    if (this.#kind === "time") fragment.appendChild(this.#literal("⁦"))
+    if (this.#kind !== "date") fragment.appendChild(this.#literal("⁦"))
 
     for (const part of parts) {
       const type = part.type === "dayperiod" ? "dayPeriod" : part.type
@@ -166,7 +176,7 @@ export default class DateFieldController extends Controller {
       }
     }
 
-    if (this.#kind === "time") fragment.appendChild(this.#literal("⁩"))
+    if (this.#kind !== "date") fragment.appendChild(this.#literal("⁩"))
 
     this.groupTarget.replaceChildren(fragment)
     this.#labelSegments()
@@ -268,7 +278,7 @@ export default class DateFieldController extends Controller {
   }
 
   #resolveDayPeriodNames() {
-    if (this.#kind !== "time" || !this.#value.twelveHour) return
+    if (this.#kind === "date" || !this.#value.twelveHour) return
 
     const formatter = new Intl.DateTimeFormat(this.#locale(), { hour: "numeric", hourCycle: this.#value.hourCycle })
     const nameAt = (hour) =>
@@ -283,16 +293,18 @@ export default class DateFieldController extends Controller {
     const raw = this.inputTarget.value
 
     if (this.#kind === "date") this.#value.setFromISODate(raw)
-    else this.#value.setFromISOTime(raw)
+    else if (this.#kind === "time") this.#value.setFromISOTime(raw)
+    else this.#value.setFromISODateTime(raw)
   }
 
   #placeholderFor(type) {
     const seed = new IncompleteDate(this.#value.hourCycle)
     const iso = this.placeholderValue
 
-    if (this.#kind === "date") {
-      if (!seed.setFromISODate(iso)) { seed.year = 2020; seed.month = 1; seed.day = 1 }
-    } else if (!seed.setFromISOTime(iso)) {
+    const [datePart, timePart] = this.#kind === "datetime" ? String(iso ?? "").split("T") : [iso, iso]
+
+    if (this.#kind !== "time" && !seed.setFromISODate(datePart)) { seed.year = 2020; seed.month = 1; seed.day = 1 }
+    if (this.#kind !== "date" && !seed.setFromISOTime(timePart)) {
       seed.setFromH23(12)
       seed.minute = 0
       seed.second = 0
@@ -542,7 +554,7 @@ export default class DateFieldController extends Controller {
   }
 
   #commitIfComplete() {
-    if (this.#kind === "date" && this.#value.isComplete(["year", "month", "day"]) &&
+    if (this.#kind !== "time" && this.#value.isComplete(["year", "month", "day"]) &&
         !this.#value.isValidDate()) return // Feb 31 mid-edit: hold the wire
 
     this.#syncInput()
@@ -551,7 +563,9 @@ export default class DateFieldController extends Controller {
   #syncInput() {
     const iso = this.#kind === "date"
       ? this.#value.toISODate()
-      : this.#value.toISOTime(this.secondsValue)
+      : this.#kind === "time"
+        ? this.#value.toISOTime(this.secondsValue)
+        : this.#value.toISODateTime(this.secondsValue)
     const next = iso ?? ""
 
     if (this.inputTarget.value === next) return

data/app/javascript/poetry/core/helpers/incomplete_date.js

@@ -289,6 +289,35 @@ export class IncompleteDate {
     this.second = match[3] === undefined ? null : Number(match[3])
     return true
   }
+
+  /**
+   * Fills every field from "YYYY-MM-DDTHH:MM(:SS)" - the datetime-local
+   * wire format (no zone, local wall time).
+   *
+   * @param {string | null} iso
+   * @returns {boolean} false (nothing touched) unless both halves parse
+   */
+  setFromISODateTime(iso) {
+    // A fractional-seconds tail is tolerated (some engines normalize the
+    // value with one) and dropped: the field edits whole seconds.
+    const match = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}(?::\d{2})?)(?:\.\d+)?$/.exec(iso ?? "")
+
+    if (!match) return false
+
+    return this.setFromISODate(match[1]) && this.setFromISOTime(match[2])
+  }
+
+  /**
+   * @param {boolean} [withSeconds=false]
+   * @returns {string | null} "YYYY-MM-DDTHH:MM(:SS)", or null while either
+   *   half is incomplete
+   */
+  toISODateTime(withSeconds = false) {
+    const date = this.toISODate()
+    const time = this.toISOTime(withSeconds)
+
+    return date && time ? `${date}T${time}` : null
+  }
 }
 
 function clampToLimits(value, min, max) {

data/lib/poetry/core/check.rb

@@ -796,13 +796,13 @@ module Poetry
           end
         end
 
-        def walk_prism(node, &block)
+        def walk_prism(node, &)
           return unless node
 
           yield node
           return unless node.respond_to?(:compact_child_nodes)
 
-          node.compact_child_nodes.each { |child| walk_prism(child, &block) }
+          node.compact_child_nodes.each { |child| walk_prism(child, &) }
         end
 
         # The block seam of a setter, both directions. A yieldless
@@ -1262,11 +1262,11 @@ module Poetry
           joined.empty? ? nil : joined
         end
 
-        def walk(node, &block)
+        def walk(node, &)
           return unless node
 
           yield node
-          node.child_nodes.compact.each { |child| walk(child, &block) } if node.respond_to?(:child_nodes)
+          node.child_nodes.compact.each { |child| walk(child, &) } if node.respond_to?(:child_nodes)
         end
       end
 

data/lib/poetry/core/css/template_classes.rb

@@ -75,9 +75,9 @@ module Poetry
                   "the herb gem is required for template class extraction - add `gem \"herb\"` to your Gemfile"
           end
 
-          def walk(node, &block)
+          def walk(node, &)
             yield node
-            node.child_nodes.compact.each { |child| walk(child, &block) } if node.respond_to?(:child_nodes)
+            node.child_nodes.compact.each { |child| walk(child, &) } if node.respond_to?(:child_nodes)
           end
 
           def class_attribute?(attribute)

data/lib/poetry/core/design_lint.rb

@@ -408,9 +408,9 @@ module Poetry
         end
       end
 
-      def each_table(node, &block)
+      def each_table(node, &)
         yield node if node.element? && node.tag == "table"
-        node.children.each { |child| each_table(child, &block) }
+        node.children.each { |child| each_table(child, &) }
       end
 
       def collect_badge_variants(node, variants)

data/lib/poetry/core/skill_text.rb

@@ -15,10 +15,16 @@ module Poetry
     #
     # @api private
     class SkillText < LlmsText
-      def initialize(registry:, families:, charts_registry: nil)
+      # @param registry [Registry] the component registry the skill describes
+      # @param families [Hash{String => Array<String>}] family name => component names
+      # @param charts_registry [Registry, nil] the charts registry, when the gem is present
+      # @param builder_family [String] the family whose reference carries the registry's
+      #   form_builder section (rules, method summaries, the f.input as: vocabulary)
+      def initialize(registry:, families:, charts_registry: nil, builder_family: "forms")
         super(registry: registry)
         @families = families
         @charts_registry = charts_registry
+        @builder_family = builder_family
       end
 
       # The installable file map, paths relative to .claude/skills/poetry/.
@@ -250,9 +256,32 @@ module Poetry
           not suggestions. Options are keywords; content is the block.
 
           #{sections(paths)}
+          #{builder_reference if family == @builder_family}
         MD
       end
 
+      # The registry's form_builder section rides the family that hosts the
+      # form controls: the builder's RULE lines, its method summaries, and
+      # the f.input as: vocabulary. A registry without one (charts, a host
+      # without the UI gem) contributes nothing.
+      def builder_reference
+        section = @registry.respond_to?(:form_builder) ? @registry.form_builder : nil
+        return "" unless section.is_a?(Hash) && section.any?
+
+        out = ["## Form builder (model-bound forms)", "",
+               "Inside `form_with(model:, builder:)` forms the builder derives label, hint, error, " \
+               "and aria from the model; these `RULE` lines bind there."]
+        rules = Array(section["rules"])
+        out << "" << rules.map { |rule| "- RULE: #{rule}" }.join("\n") if rules.any?
+        methods = section["methods"]
+        if methods.is_a?(Hash) && methods.any?
+          out << "" << "Methods:" << "" << methods.map { |name, summary| "- `#{name}` - #{summary}" }.join("\n")
+        end
+        types = Array(section["input_types"])
+        out << "" << "`f.input` `as:` values: #{types.join(", ")}" if types.any?
+        out.join("\n")
+      end
+
       # The blocks reference inlines every block's full source - the block
       # WITH source is the load-bearing agent path.
       def blocks_reference

data/lib/poetry/core/stimulus/merger.rb

@@ -86,7 +86,6 @@ module Poetry
         # while other data attributes are merged normally.
         #
         # @param hashes [Array<Hash>] One or more stimulus data hashes
-        # @param block [Proc] Optional block passed to Hash#merge for custom merge logic
         # @yield [key, existing, incoming] Hash#merge's conflict resolver for
         #   every key other than controller and action
         # @yieldreturn [Object] the value to keep
@@ -97,12 +96,12 @@ module Poetry
         #     { controller: "dropdown tooltip", target_value: "main" }
         #   )
         #   # => { controller: "dropdown tooltip", action: "click->dropdown#toggle", target_value: "main" }
-        def merge(*hashes, &block)
+        def merge(*hashes, &)
           hashes.flatten.compact.each_with_object({}.with_indifferent_access) do |hash, result|
             hash = hash.deep_dup.with_indifferent_access
             result[:controller] = merge_controllers(result[:controller], hash.delete(:controller))
             result[:action] = merge_actions(result[:action], hash.delete(:action))
-            result.merge!(hash, &block)
+            result.merge!(hash, &)
           end
         end
 

data/lib/poetry/core/version.rb

@@ -4,6 +4,6 @@ module Poetry
   module Core
     # The gem version. Every gem in the family carries the same version
     # and pins poetry-core to it exactly.
-    VERSION = "0.0.2"
+    VERSION = "0.0.3"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: poetry-core
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Matt Solt
@@ -73,6 +73,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitattributes"
 - CHANGELOG.md
 - DESIGN.md
 - LICENSE.txt
@@ -254,7 +255,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="