formatic 0.2.11 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24e08479caf78b6670d6992c7b57f2ee23aec26b6aa953b9db7fdfa1184550de
-  data.tar.gz: 6cc0390bb4f70d25626ab040a83ce32bc404548bcc9fc6812c3da672f5c5af42
+  metadata.gz: 6e76d4fb54356f3c1617b84931834bb46e25dbdb8b9923d5449452c72a43fff5
+  data.tar.gz: aa825faad29917f0aaf406e849d50c4b202613d1853927e3d2236488e8a767c2
 SHA512:
-  metadata.gz: eb198f09b149e71aed3a351893018c69ec15f294ecb18a66ed8159c1f432c7ef0e7259f78f010a01315bf159def6b55315bd0d17af1e50c8882b81913e3f0eb9
-  data.tar.gz: 14fc1101af9bbc6eed611bfdc3672d44592771a88b0d6cb86b2770dd936846a77caf3c607b8afaca280e9425848eeee05149497111df3299304f6f71b7d4f391
+  metadata.gz: 1da9feda2b01a0e4154db1b2efb67904abf8a799c0c518caa83d135edb283e3b534342734acb2a24cf1fadb317e8cc09ecf7c802ee99c475caa339642a2e2fe8
+  data.tar.gz: d95a0967fe128dc408d3dd67e4ffc984b65b0b75362ed6b0b3e92bbde94d0fe61506b77bea87a1a5e79637824e96aa949a29f28cd8ff876f143653002674bced

data/CHANGELOG.md

@@ -1,4 +1,10 @@
-## [Unreleased]
+## [0.3.0] 2026-08-04
+
+- Make VS Code snippet symlinking atomic so concurrent app boots no longer race into `Errno::EEXIST`
+
+## [0.2.12] 2026-07-24
+
+- Add data attribute to every input
 
 ## [0.2.11] 2026-07-22
 

data/app/components/formatic/base.rb

@@ -66,6 +66,10 @@ module Formatic
       f.object.public_send(attribute_name) if f.object.respond_to?(attribute_name)
     end
 
+    def data
+      manual_data
+    end
+
     # ---------------------------
     # ActiveModel and Rails slugs
     # ---------------------------

data/app/components/formatic/file.rb

@@ -26,12 +26,22 @@ module Formatic
               <%- end -%>
             </div>
 
-            <%= f.file_field attribute_name, class: "js-formatic-file__input", direct_upload:, multiple:, accept:, data: { entries: entries_json } %>
+            <%= f.file_field attribute_name, class: "js-formatic-file__input", direct_upload:, multiple:, accept:, data: %>
+
+            <%- if (file = current_file) -%>
+              <div class="c-formatic-file__current">
+                <%= link_to 'Download', file, target: :_blank %>
+              </div>
+            <%- end -%>
           </div>
         <% end %>
       <% end %>
     ERB
 
+    def data
+      { entries: entries_json }.merge(manual_data)
+    end
+
     private
 
     def attachments
@@ -62,5 +72,15 @@ module Formatic
         }
       end.to_json
     end
+
+    # The currently attached file, if there is exactly one.
+    # Multiple files are not shown here, see `Formatic::Files`.
+    def current_file
+      return if multiple
+      return unless attachments.size == 1
+
+      attachment = attachments.first
+      attachment if attachment.present?
+    end
   end
 end

data/app/components/formatic/stepper.rb

@@ -20,6 +20,7 @@ module Formatic
                                   min: minimum,
                                   inputmode: :numeric,
                                   pattern: '-?[0-9]*',
+                                  data:,
                                   class: 'c-formatic-stepper__number js-formatic-stepper__number',
                                   placeholder: wrapper.placeholder,
                                 } %>

data/app/components/formatic/string.rb

@@ -33,6 +33,7 @@ module Formatic
     def input_options
       result = {
         placeholder: wrapper.placeholder,
+        data:,
         autofocus:,
         class: css_classes
       }

data/app/components/formatic/time.rb

@@ -24,11 +24,13 @@ module Formatic
                 <%= select_tag hour_attribute_name,
                               options_for_hour,
                               id: hour_input_id,
+                              data:,
                               class: 'c-formatic-time__select' %>
 
                 <%= select_tag minute_attribute_name,
                               options_for_minute,
                               id: minute_input_id,
+                              data:,
                               class: 'c-formatic-time__select' %>
               </div>
             <% end -%>

data/app/components/formatic/toggle.rb

@@ -18,7 +18,7 @@ module Formatic
           <% else %>
             <%= f.label attribute_name, nil, { for: dom_id } do |builder| %>
               <%
-                f.check_box(attribute_name, { id: dom_id, class: css_classes }) +
+                f.check_box(attribute_name, { id: dom_id, data:, class: css_classes }) +
                   content_tag(:i) +
                   content_tag(:div, human_attribute_name, class: 'c-formatic-toggle__label-caption-dummy') +
                   content_tag(:div, wrap.toggle_on, class: 'is-active') +

data/lib/formatic/engine.rb

@@ -28,8 +28,7 @@ module Formatic
         target = vscode_dir.join('formatic.code-snippets')
         source = Engine.root.join('vscode/formatic.code-snippets')
 
-        FileUtils.rm_f(target.to_s)
-        FileUtils.ln_s(source, target, force: true)
+        VscodeSnippets.install(target, source)
       end
     end
 
@@ -58,6 +57,8 @@ module Formatic
         require_relative '../../app/components/formatic/stepper'
         require_relative '../../app/components/formatic/textarea'
         require_relative '../../app/components/formatic/time'
+        require_relative '../../app/components/formatic/file'
+        require_relative '../../app/components/formatic/files'
       end
     end
   end

data/lib/formatic/templates/date.rb

@@ -25,17 +25,20 @@ module Formatic
                   <%= select_tag day_attribute_name,
                                  options_for_day,
                                  id: day_input_id,
+                                 data:,
                                  class: 'c-formatic-date__select js-formatic-date__day' %>
                 <% end %>
 
                 <%= select_tag month_attribute_name,
                                 options_for_month,
                                 id: month_input_id,
+                                data:,
                                 class: 'c-formatic-date__select js-formatic-date__month' %>
 
                 <%= select_tag year_attribute_name,
                                 options_for_year,
                                 id: year_input_id,
+                                data:,
                                 class: 'c-formatic-date__select js-formatic-date__year' %>
               </div>
               <% if calendar? %>

data/lib/formatic/templates/select.rb

@@ -17,7 +17,7 @@ module Formatic
                 </div>
               <% else %>
 
-                <%= f.select attribute_name, choices, {}, { class: ['c-formatic-select', 'js-formatic-select', ('is-autosubmit' if async_submit)] } %>
+                <%= f.select attribute_name, choices, {}, { data:, class: ['c-formatic-select', 'js-formatic-select', ('is-autosubmit' if async_submit)] } %>
 
               <% end %>
             </div>

data/lib/formatic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Formatic
-  VERSION = '0.2.11'
+  VERSION = '0.3.0'
 end

data/lib/formatic/vscode_snippets.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'tmpdir'
+
+module Formatic
+  # Installs the gem's VS Code snippets as a symlink inside the host
+  # application's `.vscode` directory.
+  #
+  # This runs in every process that boots the host application (Spring
+  # preloader, Puma workers, rake tasks, ...), so those processes race each
+  # other. A non-atomic remove-then-create (`FileUtils.ln_s(force: true)`)
+  # lets two processes both pass the "does it exist?" check before either
+  # creates the link, so one of them dies with `Errno::EEXIST` on
+  # `symlink(2)`.
+  #
+  # To stay race-free the link is created under a temporary name in the
+  # system temp directory and then `rename(2)`-ed over the target, which
+  # atomically replaces whatever is already there.
+  #
+  # NOTE: `Formatic::File` (a ViewComponent) shadows `File` inside this
+  # module, so we refer to Ruby's file class as `::File`.
+  module VscodeSnippets
+    class << self
+      def install(target, source)
+        target = target.to_s
+        source = source.to_s
+
+        return if already_linked?(target, source)
+
+        install_atomically(target, source)
+      end
+
+      private
+
+      def install_atomically(target, source)
+        tmp = ::File.join(Dir.tmpdir, "formatic-#{Process.pid}-#{Thread.current.object_id}.tmp")
+        FileUtils.rm_f(tmp)
+        ::File.symlink(source, tmp)
+        ::File.rename(tmp, target)
+      rescue Errno::EXDEV
+        replace(target, source)
+      ensure
+        FileUtils.rm_f(tmp) if tmp
+      end
+
+      def already_linked?(target, source)
+        ::File.symlink?(target) && ::File.readlink(target) == source
+      end
+
+      def replace(target, source)
+        FileUtils.rm_f(target)
+        ::File.symlink(source, target)
+      end
+    end
+  end
+end

data/lib/formatic.rb

@@ -9,6 +9,7 @@ require 'dry/initializer'
 require 'formatic/version'
 require 'formatic/css'
 require 'formatic/safe_join'
+require 'formatic/vscode_snippets'
 require 'formatic/templates/select'
 require 'formatic/templates/wrapper'
 require 'formatic/choices/countries'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: formatic
 version: !ruby/object:Gem::Version
-  version: 0.2.11
+  version: 0.3.0
 platform: ruby
 authors:
 - halo
@@ -198,6 +198,7 @@ files:
 - lib/formatic/templates/select.rb
 - lib/formatic/templates/wrapper.rb
 - lib/formatic/version.rb
+- lib/formatic/vscode_snippets.rb
 - lib/formatic/wrappers/alternative_attribute_name.rb
 - lib/formatic/wrappers/error_messages.rb
 - lib/formatic/wrappers/required.rb