odin-foundation 1.0.4 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e48cf0a0983a951cff7ce73bdc7855030d887ed1d42b2c6ad2d3fd7fe8a2183b
-  data.tar.gz: 85ee5230297ef6ae6a481c5b0fb56e7aa4df7aac789c12d06e617abfe821f985
+  metadata.gz: 73fe064a2bdc58380f03167913ebea10dce6c722a8b0b2b30703134b28f4ce2e
+  data.tar.gz: c60ca22db57be40b617169266dbd97c0e3e181674eaf1e5ec57796fc24729635
 SHA512:
-  metadata.gz: 9fb30a61553eb90ff2729e1c310b55a64ea349f58d46205c326d473783e3f12f793c79708e5d4fcf4041131fcf2d4ea77839c485507187ba398d63dbcde5b98a
-  data.tar.gz: 2c93ac612d779ad45d9fb749fcc6e01c21ee090f96d57f5c670a42bd87a9e8186a92867af6b132936f24620056ee2cd92d4bc7d84206dcbe12864b484bd68b76
+  metadata.gz: 3495932fb340947ca0bc35a381557d5b1bf55e18d50150b9117ae073965faeb2dac8f23eedbcc0fdf8058013288b819aa41da3cf1436418819bc941847018064
+  data.tar.gz: 2d01979d2e392f6ed40b84a2626b2056d9fda8b281f1cfe6978604f7ae0359b7882db6c2465555cc272337560b010fe1d018f2fcf773647ab0da126a296e0652

data/lib/odin/export.rb

@@ -17,7 +17,7 @@ module Odin
 
     # Convert OdinDocument to XML string
     def self.to_xml(doc, root: "root", preserve_types: false, preserve_modifiers: false)
-      # When preserving modifiers, always preserve types too (matches Java behavior)
+      # When preserving modifiers, always preserve types too
       preserve_types = true if preserve_modifiers
 
       xml = +%{<?xml version="1.0" encoding="UTF-8"?>\n}

data/lib/odin/forms/accessibility.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Odin
+  module Forms
+    # Pure helpers for generating accessible markup and computing WCAG contrast.
+    module Accessibility
+      module_function
+
+      # Unique, stable HTML element id for a field.
+      def generate_field_id(element_name, page_index)
+        "odin-field-#{page_index}-#{element_name}"
+      end
+
+      # A <label> associated with the given input id.
+      def field_label_html(label, input_id)
+        %(<label for="#{input_id}" class="odin-form-label">#{label}</label>)
+      end
+
+      # ARIA and id attributes for a field element.
+      def field_aria_attrs(element, page_index)
+        attrs = {
+          "id" => generate_field_id(element.name, page_index),
+          "aria-label" => element[:"aria-label"] || element[:label],
+        }
+        attrs["aria-required"] = "true" if element[:required]
+        attrs
+      end
+
+      # Wrap content in a <fieldset>/<legend> for grouped controls.
+      def field_group_html(_group_name, legend, content)
+        %(<fieldset class="odin-form-fieldset">) +
+          %(<legend class="odin-form-legend">#{legend}</legend>) +
+          content +
+          "</fieldset>"
+      end
+
+      # Skip-navigation link targeting the form content anchor.
+      def skip_link_html(form_title)
+        %(<a class="odin-form-sr-only odin-form-skip" href="#odin-form-content">) +
+          "Skip to #{form_title}" +
+          "</a>"
+      end
+
+      # Visually-hidden text that remains announced to screen readers.
+      def sr_only_html(text)
+        %(<span class="odin-form-sr-only">#{text}</span>)
+      end
+
+      # Field elements only, sorted by reading order (top-to-bottom, left-to-right).
+      def tab_order_sort(elements)
+        elements.select(&:field?).sort do |a, b|
+          ay = a[:y] || 0
+          by = b[:y] || 0
+          if ay != by
+            ay <=> by
+          else
+            (a[:x] || 0) <=> (b[:x] || 0)
+          end
+        end
+      end
+
+      # ── WCAG contrast ──────────────────────────────────────────────────────
+
+      def contrast_ratio(fg, bg)
+        l1 = relative_luminance(fg)
+        l2 = relative_luminance(bg)
+        lighter = [l1, l2].max
+        darker = [l1, l2].min
+        (lighter + 0.05) / (darker + 0.05)
+      end
+
+      def meets_contrast_aa(fg, bg, font_size)
+        ratio = contrast_ratio(fg, bg)
+        font_size >= 18 ? ratio >= 3.0 : ratio >= 4.5
+      end
+
+      def linearize(channel)
+        srgb = channel / 255.0
+        srgb <= 0.04045 ? srgb / 12.92 : (((srgb + 0.055) / 1.055)**2.4)
+      end
+
+      def parse_hex(hex)
+        clean = hex.start_with?("#") ? hex[1..] : hex
+        raise ArgumentError, %(Invalid hex colour: "#{hex}") unless clean.match?(/\A[0-9a-fA-F]{6}\z/)
+
+        [clean[0, 2].to_i(16), clean[2, 2].to_i(16), clean[4, 2].to_i(16)]
+      end
+
+      def relative_luminance(hex)
+        r, g, b = parse_hex(hex)
+        (0.2126 * linearize(r)) + (0.7152 * linearize(g)) + (0.0722 * linearize(b))
+      end
+    end
+  end
+end

data/lib/odin/forms/css.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Odin
+  module Forms
+    # Scoped CSS generation for the form HTML renderer.
+    module Css
+      module_function
+
+      # Base stylesheet scoped under .odin-form.
+      def generate_form_css
+        [
+          ".odin-form { position: relative; font-family: Helvetica, Arial, sans-serif; }",
+          ".odin-form-page { position: relative; background: white; overflow: hidden; box-sizing: border-box; margin: 0 auto; }",
+          ".odin-form-element { position: absolute; box-sizing: border-box; }",
+          ".odin-form-label { display: block; font-size: 8pt; color: #666; margin-bottom: 1px; }",
+          ".odin-form-input { width: 100%; height: 100%; box-sizing: border-box; border: 1px solid #999; padding: 2px 4px; font-family: inherit; font-size: inherit; background: transparent; }",
+          ".odin-form-input:focus { outline: 2px solid #34A3F5; border-color: #34A3F5; }",
+          ".odin-form-checkbox, .odin-form-radio { width: auto; height: auto; }",
+          ".odin-form-select { width: 100%; height: 100%; }",
+          ".odin-form-signature { border: none; border-bottom: 1px solid #000; background: transparent; }",
+          ".odin-form-fieldset { border: none; padding: 0; margin: 0; position: absolute; }",
+          ".odin-form-legend { font-size: 8pt; color: #666; }",
+          ".odin-form-sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0; }",
+          ".odin-form-skip:focus { position: static; width: auto; height: auto; clip: auto; overflow: visible; margin: 0; padding: 4px 8px; }",
+        ].join("\n")
+      end
+
+      # @media print block optimising the form for printing.
+      def generate_print_css
+        [
+          "@media print {",
+          "  .odin-form-page { page-break-after: always; margin: 0; box-shadow: none; }",
+          "  .odin-form-page:last-child { page-break-after: auto; }",
+          "  .odin-form-input { border: none; border-bottom: 1px solid #000; background: transparent; }",
+          "  .odin-form-skip { display: none; }",
+          "  .odin-form-sr-only { display: none; }",
+          "}",
+        ].join("\n")
+      end
+    end
+  end
+end