RubyGems - inline_forms - Versions diffs - 8.1.21 → 8.1.42 - Mend

inline_forms 8.1.21 → 8.1.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (424) hide show

data/app/views/layouts/devise.html.erb CHANGED Viewed

@@ -6,6 +6,7 @@
     <title>
       <%= t('inline_forms.general.application_title') %> v<%= InlineForms::VERSION %>
     </title>
+    <%= stylesheet_link_tag "inline_forms_fonts" %>
     <%= stylesheet_link_tag "inline_forms/devise" %>
     <%= stylesheet_link_tag "inline_forms_devise" %>
     <%= csrf_meta_tags %>

data/app/views/layouts/inline_forms.html.erb CHANGED Viewed

@@ -1,16 +1,18 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="<%= I18n.locale %>">
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title><%= t('application_name') + " v" + InlineForms::VERSION -%></title>
     <%= stylesheet_link_tag "application" %>
+    <%= stylesheet_link_tag "inline_forms_fonts" %>
     <%= stylesheet_link_tag "inline_forms/inline_forms" %>
-    <%= stylesheet_link_tag "https://unpkg.com/trix@1.3.1/dist/trix.css" %>
+    <%= stylesheet_link_tag "trix" %>
+    <%= inline_forms_user_color_overrides_style %>
     <%= csrf_meta_tags %>
   </head>
-  <body>
+  <body class="<%= inline_forms_body_theme_class %>">
     <%= render "inline_forms/header" %>
     <%# Read string keys (FlashHash stores strings); avoid `notice`/`alert` helpers %>
     <%# so we do not depend on add_flash_types wiring in every layout context. %>
@@ -38,6 +40,7 @@
       import { Turbo } from "<%= asset_path('turbo.min.js') %>"
       window.Turbo = Turbo
     </script>
-    <%= javascript_include_tag "https://unpkg.com/trix@1.3.1/dist/trix.js" %>
+    <%# Trix 2 (vendored; no CDN). Self-registers its custom elements on load. %>
+    <%= javascript_include_tag "trix.min" %>
   </body>
 </html>

data/archived/README.md CHANGED Viewed

@@ -12,6 +12,8 @@ This directory is the **versioned archive** for inline_forms capabilities that a
 | `:tree`, `:move` | **Archived** | **7.7.0** | [`form_elements/tree/`](form_elements/tree/) — host `#children`, `#hash_tree_to_collection`, `#add_child` |
 | `:absence_list` | **Removed** (source not in repo) | **6.3.0** | See [CHANGELOG](../CHANGELOG.md#630---2026-05-03); vendor from git history or app copy |
 | `:ckeditor`, `:text_area_without_ckeditor` | **Archived** | **8.1.21** | [`form_elements/ckeditor/`](form_elements/ckeditor/) — use `:rich_text` or `:plain_text` / `:plain_text_area` |
+| `:question_list` | **Archived** | **8.1.30** | [`form_elements/question_list/`](form_elements/question_list/) — hardcoded host `Question` model |
+| `:dnsrecords` | **Archived** | **8.1.30** | [`form_elements/dns_records/`](form_elements/dns_records/) — host `a_records`/`djbdns_line` APIs |
 Programmatic registry: `InlineForms::ARCHIVED_FORM_ELEMENTS` in `lib/inline_forms.rb` (boot-time check if a model still declares an archived symbol).

data/archived/form_elements/dns_records/README.md ADDED Viewed

@@ -0,0 +1,25 @@
+# dns_records (archived)
+**Archived in gem version:** 8.1.30
+**Reason:** App-specific leftover from a DNS-admin application. The show helper calls `object.a_records`, `object.template_a_records` and `record.djbdns_line(name)` — host APIs no other app has. Edit and update were empty methods. Never registered in `FormElementRegistry::ENTRIES` (the helper methods are named `dnsrecords_*`, so the attribute-list symbol was `:dnsrecords`).
+## What it was
+| Method | Behavior |
+|--------|----------|
+| `dnsrecords_show` | One `djbdns_line` per A record, `<br/>`-joined, raw |
+| `dnsrecords_edit` | empty |
+| `dnsrecords_update` | empty |
+## Restore
+```bash
+cp archived/form_elements/dns_records/lib/inline_forms/form_elements/dns_records_helper.rb \
+   lib/inline_forms/form_elements/
+```
+Remove `:dnsrecords` from `InlineForms::ARCHIVED_FORM_ELEMENTS`. Your app must provide `a_records` / `template_a_records` returning objects with `djbdns_line(name)`.
+## Turbo
+Display-only; no Turbo concerns.

data/archived/form_elements/question_list/README.md ADDED Viewed

@@ -0,0 +1,25 @@
+# question_list (archived)
+**Archived in gem version:** 8.1.30
+**Reason:** App-specific leftover. The edit helper hardcodes a host `Question` model with a `subquestions` association (survey-style app), the show helper iterates a HABTM-ish collection of `_presentation`s, and the update writes `<attribute singular>_ids`. No example app ever exercised it, and it cannot render without that exact host schema.
+## What it was
+| Method | Behavior |
+|--------|----------|
+| `question_list_show` | `<ul>` of the association's `_presentation`s, each linking to inline edit |
+| `question_list_edit` | Static nested `<ul>` of ALL `Question.all` + `question.subquestions` (read-only markup, despite being the edit state) |
+| `question_list_update` | `object.<attr singular>_ids = params[attr].keys` |
+## Restore
+```bash
+cp archived/form_elements/question_list/lib/inline_forms/form_elements/question_list_helper.rb \
+   lib/inline_forms/form_elements/
+```
+Re-add `:question_list => :no_migration` to `FormElementRegistry::ENTRIES` and remove `:question_list` from `InlineForms::ARCHIVED_FORM_ELEMENTS`. Your app must define `Question` (with `subquestions`) and the HABTM association named by the attribute.
+## Turbo
+Pre-Turbo markup; the edit state renders no form inputs, so it never round-tripped through the 7.x UJS → Turbo migration. Expect to rework it if restored.

data/inline_forms.gemspec CHANGED Viewed

@@ -1,4 +1,5 @@
 # -*- encoding: utf-8 -*-
 $:.push File.expand_path("../lib", __FILE__)
 require "inline_forms/version"
 require "inline_forms/gem_files"
@@ -7,17 +8,17 @@ Gem::Specification.new do |s|
   s.name        = "inline_forms"
   s.version     = InlineForms::VERSION
   s.platform    = Gem::Platform::RUBY
-  s.authors     = ["Ace Suares", "Lemuel Boyce", "Manuel Ortega"]
-  s.email       = ["ace@suares.com"]
-  s.homepage    = %q{http://github.com/acesuares/inline_forms}
-  s.summary     = %q{Inline editing of forms for Rails 8.}
-  s.description = %q{Inline Forms eases setup of admin-style forms with inline editing. Field lists are declared on the model. Requires Rails 8.1.x, Ruby >= 4.0, and validation_hints ~> 8.}
-  s.licenses    = ["MIT"]
+  s.authors     = [ "Ace Suares", "Lemuel Boyce", "Manuel Ortega" ]
+  s.email       = [ "ace@suares.com" ]
+  s.homepage    = %q(http://github.com/acesuares/inline_forms)
+  s.summary     = %q(Inline editing of forms for Rails 8.)
+  s.description = %q(Inline Forms eases setup of admin-style forms with inline editing. Field lists are declared on the model. Requires Rails 8.1.x, Ruby >= 4.0, and validation_hints ~> 8.)
+  s.licenses    = [ "MIT" ]
   s.required_ruby_version = ">= 4.0.0"
   s.files      = InlineFormsGemFiles.gem_files(include_installer: false)
   s.test_files = s.files.grep(%r{^(test|spec|features)/})
-  s.require_paths = ["lib"]
+  s.require_paths = [ "lib" ]
   s.add_dependency("validation_hints", ">= 8.1.4", "< 9.0")
   s.add_dependency("rails", ">= 8.1", "< 8.2")

data/lib/generators/inline_forms_addto/USAGE CHANGED Viewed

@@ -13,6 +13,37 @@ Description:
     rejected. `_presentation`, `_list_order`, `_list_search`, and `_order` are
     skipped unless you pass `--replace`.
+Placement:
+    By default a new attribute_list row is inserted above the model's trailing
+    "metadata" block (its `:info` rows / created_at / updated_at, and a
+    `:header` directly above them) rather than at the very end, so an editable
+    field does not land inside the read-only info section. Override with:
+      --before=ATTR   insert the new row before an existing attribute
+      --after=ATTR    insert the new row after an existing attribute
+    If the named anchor is not found, the generator warns and falls back to the
+    default placement.
+Value-bearing form elements:
+    Choice elements (dropdown_with_values, dropdown_with_integers,
+    dropdown_with_values_with_stars, radio_button, check_box,
+    scale_with_integers, scale_with_values) need a values hash as the 3rd row
+    element. The generator inserts a placeholder `{ 1 => 'one', 2 => 'two' }`
+    and warns; edit it to your real values.
+Constraints and caveats:
+    - Additive only: the generated migration uses `add_column` / `add_reference`
+      (nullable, no default). Renaming, dropping, or making a column NOT NULL
+      (and the SQLite table-rebuild that would require) is out of scope; do
+      those by hand.
+    - Run `bundle exec rails db:migrate` after generating: the model row is
+      written immediately, but the column only exists once the migration runs.
+    - PaperTrail: versions recorded before this migration have no value for the
+      new column, so reverting an old record leaves the new column at its
+      default (nil), and the versions panel shows no history for it prior to
+      the migration.
 Example:
     rails generate inline_forms_addto User occupation:text_field birthdate:date organization:dropdown bio:rich_text

data/lib/generators/inline_forms_addto_generator.rb CHANGED Viewed

@@ -33,11 +33,27 @@ class InlineFormsAddtoGenerator < Rails::Generators::NamedBase
     INSTALL_TIME_ONLY_NAMES = %w[_no_model _no_migration _id _enabled].freeze
     REPLACE_ONLY_NAMES      = %w[_presentation _list_order _list_search _order].freeze
+    # Form elements that render a set of choices and therefore need a values
+    # hash as the 3rd element of their attribute_list row. Emitting the bare
+    # 2-element row for these raises at show time, so we insert a placeholder
+    # hash and warn the user to fill it in. Canonical list lives in InlineForms
+    # (shared with the schema GUI/preview).
+    VALUE_BEARING_ELEMENTS = InlineForms::VALUE_BEARING_FORM_ELEMENTS
+    # attribute_list rows whose form element (or name) marks the start of the
+    # trailing "metadata" block. The smart-default placement inserts new rows
+    # above this block instead of at the very end of the list.
+    METADATA_ROW_NAMES = %w[created_at updated_at].freeze
     argument :attributes, type: :array, banner: "[name:form_element]..."
     class_option :allow_unknown, type: :boolean, default: false,
                  desc: "Allow unknown field types (legacy behavior: comment generated lines instead of failing)."
     class_option :replace, type: :boolean, default: false,
                  desc: "Replace existing _presentation/_list_order/_list_search instead of skipping."
+    class_option :before, type: :string, default: nil,
+                 desc: "Insert the new attribute_list row before this existing attribute name."
+    class_option :after, type: :string, default: nil,
+                 desc: "Insert the new attribute_list row after this existing attribute name."
     source_root File.expand_path("inline_forms_addto/templates", __dir__)
@@ -94,6 +110,10 @@ class InlineFormsAddtoGenerator < Rails::Generators::NamedBase
         next if INSTALL_TIME_ONLY_NAMES.include?(attribute.name)
         next if REPLACE_ONLY_NAMES.include?(attribute.name)
         next unless attribute.migration?
+        # A :header is a display-only separator in the attribute list; it has
+        # no backing column, so it must not emit a migration line (otherwise
+        # `foo:header` created a pointless `foo` string column).
+        next if attribute.attribute_type == :header
         if attribute.column_type == :belongs_to
           @migration_lines << "    add_reference :#{table_name}, :#{attribute.name}, foreign_key: true\n"
@@ -106,7 +126,7 @@ class InlineFormsAddtoGenerator < Rails::Generators::NamedBase
       return if @migration_lines.empty?
       template "add_columns_migration.erb",
-               "db/migrate/#{time_stamp}_#{migration_file_basename}.rb"
+               "db/migrate/#{unique_time_stamp}_#{migration_file_basename}.rb"
     end
     def update_model
@@ -146,6 +166,20 @@ class InlineFormsAddtoGenerator < Rails::Generators::NamedBase
       end
     end
+    # Run last (Thor invokes public methods in definition order). The model
+    # row was injected above, but it references a column that does not exist
+    # until the generated migration is applied; rendering the model before
+    # then raises. Remind the user loudly. No-op when no migration was written
+    # (e.g. only has_many/rich_text/habtm additions).
+    def remind_to_migrate
+      return if @migration_lines.nil? || @migration_lines.empty?
+      say ""
+      say "  Next step: apply the generated migration before rendering #{model_class_name}:", :yellow
+      say "    bundle exec rails db:migrate", :yellow
+      say "  (the attribute_list row was added now, but its column only exists after migrating.)", :yellow
+    end
     private
     def model_file_name
@@ -204,43 +238,181 @@ class InlineFormsAddtoGenerator < Rails::Generators::NamedBase
     end
     # Inserts a new row into the existing `inline_forms_attribute_list`
-    # method. Falls back to appending a fresh method when the model has
-    # only `attr_writer :inline_forms_attribute_list` (inherited from
-    # `ApplicationRecord`) and no body.
+    # method. Falls back to appending a fresh method when the model has no
+    # generator-shaped list (e.g. only the inherited
+    # `attr_writer :inline_forms_attribute_list` and no body).
+    #
+    # Row-aware, not regex-greedy: we locate the `[` after
+    # `@inline_forms_attribute_list ||=` and bracket-depth scan to its
+    # matching `]`, so the edit survives `].freeze`, trailing comments, and
+    # any methods defined after the list. Placement honors `--after`/`--before`
+    # (by attribute name) and otherwise lands above the trailing metadata block
+    # (`:info` rows / created_at / updated_at, and a `:header` directly above
+    # them) instead of after it.
     def add_attribute_list_row!(attribute)
-      content = File.read(File.join(destination_root, model_file_path))
-      row = "      [ :#{attribute.name}, :#{attribute.attribute_type} ],\n"
+      path    = File.join(destination_root, model_file_path)
+      content = File.read(path)
-      if content.match?(/@inline_forms_attribute_list \|\|=\s*\[/)
-        if content.match?(/\[\s*:#{Regexp.escape(attribute.name)}\s*,/)
-          say_status :identical, "#{model_file_path}: row :#{attribute.name}", :blue
-          return
-        end
-        # Insert before the closing `]` of the array, keeping appended order.
-        # Match against the file's full text and write it back so we work
-        # around Thor's `gsub_file` block-arg quirk (the block sees only the
-        # full match, no $1/$2). MatchData captures are explicit here.
-        m = content.match(/(@inline_forms_attribute_list \|\|=\s*\[(?:.|\n)*?)(\n\s*\]\s*\n\s*end)/)
-        if m
-          replacement = m[1] + "\n" + row.chomp + m[2]
-          new_content = content.sub(m[0], replacement)
-          File.write(File.join(destination_root, model_file_path), new_content)
-          say_status :insert, "#{model_file_path}: row :#{attribute.name}", :green
-        else
-          say_status :warn, "#{model_file_path}: could not locate end of @inline_forms_attribute_list, skipping :#{attribute.name}", :yellow
-        end
-      else
+      # Idempotent: skip if a row for this attribute already exists anywhere.
+      if content.match?(/\[\s*:#{Regexp.escape(attribute.name)}\s*,/)
+        say_status :identical, "#{model_file_path}: row :#{attribute.name}", :blue
+        return
+      end
+      bounds = attribute_list_bounds(content)
+      unless bounds
         say_status :warn, "#{model_file_path}: no inline_forms_attribute_list found, appending a fresh method", :yellow
         body = <<~RUBY.gsub(/^/, "  ")
           def inline_forms_attribute_list
             @inline_forms_attribute_list ||= [
-              [ :#{attribute.name}, :#{attribute.attribute_type} ],
+              #{attribute_row_literal(attribute)},
             ]
           end
         RUBY
         inject_into_class model_file_path, model_class_name, body
+        return
+      end
+      warn_if_value_bearing!(attribute)
+      open_idx, close_idx = bounds
+      inner  = content[(open_idx + 1)...close_idx]
+      lines  = inner.lines
+      indent = detect_row_indent(lines)
+      new_line = "#{indent}#{attribute_row_literal(attribute)},\n"
+      insert_at, note = insertion_index(lines, attribute)
+      # Keep the array valid: ensure the row we insert after ends with a comma.
+      if insert_at.positive?
+        prev = lines[insert_at - 1]
+        if prev && prev.match?(/\S/) && !prev.match?(/,\s*\z/)
+          lines[insert_at - 1] = prev.sub(/(\S)(\s*)\z/, "\\1,\\2")
+        end
+      end
+      lines.insert(insert_at, new_line)
+      new_content = content[0..open_idx] + lines.join + content[close_idx..-1]
+      File.write(path, new_content)
+      say_status :insert, "#{model_file_path}: row :#{attribute.name}#{note}", :green
+    end
+    # Returns [open_bracket_index, close_bracket_index] for the
+    # `@inline_forms_attribute_list ||= [ ... ]` array literal, or nil when the
+    # model has no such list. Bracket-depth scan; nested `[ ]` (e.g. an
+    # options_disabled array inside a choice row) balances correctly.
+    def attribute_list_bounds(content)
+      m = content.match(/@inline_forms_attribute_list\s*\|\|=\s*\[/)
+      return nil unless m
+      open_idx = m.end(0) - 1 # index of the '[' itself
+      depth = 0
+      i = open_idx
+      while i < content.length
+        case content[i]
+        when "[" then depth += 1
+        when "]"
+          depth -= 1
+          return [ open_idx, i ] if depth.zero?
+        end
+        i += 1
+      end
+      nil
+    end
+    # Decide where the new row goes. Returns [line_index, status_note].
+    def insertion_index(lines, _attribute)
+      if (anchor = options[:after].to_s) != ""
+        idx = row_line_index(lines, anchor)
+        return [ idx + 1, " (after :#{anchor})" ] if idx
+        say_status :warn, "#{model_file_path}: --after #{anchor} not found; using default placement", :yellow
+      elsif (anchor = options[:before].to_s) != ""
+        idx = row_line_index(lines, anchor)
+        return [ idx, " (before :#{anchor})" ] if idx
+        say_status :warn, "#{model_file_path}: --before #{anchor} not found; using default placement", :yellow
+      end
+      if (meta = metadata_start_index(lines))
+        return [ meta, " (above metadata)" ]
+      end
+      [ last_row_index(lines) + 1, "" ]
+    end
+    def row_line_index(lines, name)
+      lines.index { |l| row_name(l) == name.to_s }
+    end
+    def row_name(line)
+      m = line.match(/\A\s*\[\s*:(\w+)\s*,/)
+      m && m[1]
+    end
+    def row_element(line)
+      m = line.match(/\A\s*\[\s*:\w+\s*,\s*:(\w+)/)
+      m && m[1]
+    end
+    # Index of the first row that starts the trailing metadata block. If a
+    # `:header` sits directly above that row, the header is treated as the
+    # block start (so the new field lands above the header, not between it and
+    # its info rows). nil when the list has no metadata block.
+    def metadata_start_index(lines)
+      first = nil
+      lines.each_with_index do |l, i|
+        if row_element(l) == "info" || METADATA_ROW_NAMES.include?(row_name(l))
+          first = i
+          break
+        end
+      end
+      return nil unless first
+      prev = first - 1
+      (prev >= 0 && row_element(lines[prev]) == "header") ? prev : first
+    end
+    def last_row_index(lines)
+      idx = nil
+      lines.each_with_index { |l, i| idx = i if row_name(l) }
+      idx || (lines.length - 1)
+    end
+    def detect_row_indent(lines)
+      lines.each do |l|
+        m = l.match(/\A(\s*)\[/)
+        return m[1] if m
+      end
+      "      " # 6 spaces, matching the create-time template
+    end
+    # `[ :name, :element ]`, or `[ :name, :element, { 1 => 'one', 2 => 'two' } ]`
+    # for value-bearing choice elements (a placeholder the user then edits).
+    def attribute_row_literal(attribute)
+      el = attribute.attribute_type
+      if VALUE_BEARING_ELEMENTS.include?(el)
+        "[ :#{attribute.name}, :#{el}, { 1 => 'one', 2 => 'two' } ]"
+      else
+        "[ :#{attribute.name}, :#{el} ]"
+      end
+    end
+    def warn_if_value_bearing!(attribute)
+      return unless VALUE_BEARING_ELEMENTS.include?(attribute.attribute_type)
+      say_status :warn,
+                 "#{model_file_path}: :#{attribute.name} is a #{attribute.attribute_type}; " \
+                 "edit the placeholder values hash { 1 => 'one', ... }",
+                 :yellow
+    end
+    def unique_time_stamp
+      base = Time.now.utc.strftime("%Y%m%d%H%M%S").to_i
+      dir  = File.join(destination_root, "db", "migrate")
+      existing = Dir.glob(File.join(dir, "*.rb")).filter_map do |f|
+        File.basename(f)[/\A(\d{14})/, 1]&.to_i
       end
+      [ base, (existing.max || 0) + 1 ].max.to_s.rjust(14, "0")
     end
     def replace_special!(attribute)

data/lib/generators/inline_forms_attribute_overrides.rb CHANGED Viewed

@@ -1,4 +1,5 @@
 # -*- encoding : utf-8 -*-
 require "rails/generators"
 require "rails/generators/generated_attribute"
 require "inline_forms"
@@ -106,11 +107,11 @@ Rails::Generators::GeneratedAttribute.class_eval do
   def migration?
     not ( column_type == :no_migration  ||
-        SPECIAL_GENERATOR_NAMES.include?(name) )
+        SPECIAL_GENERATOR_NAMES.include?(name))
   end
   def attribute?
     not ( SPECIAL_GENERATOR_NAMES.include?(name) ||
-        relation? )
+        relation?)
   end
 end

data/lib/generators/templates/application_record.rb CHANGED Viewed

@@ -8,7 +8,7 @@ class ApplicationRecord < ActiveRecord::Base
   # in the inline_forms versions panel as a meaningless "empty" row whose
   # Restore link reifies the same state (no-op). Excluding `:touch` here
   # suppresses that noise without affecting real attribute updates.
-  has_paper_trail on: [:create, :update, :destroy]
+  has_paper_trail on: [ :create, :update, :destroy ]
   attr_writer :inline_forms_attribute_list

data/lib/inline_forms/archived_form_elements.rb CHANGED Viewed

@@ -1,4 +1,5 @@
 # -*- encoding : utf-8 -*-
 module InlineForms
   class ArchivedFormElementError < StandardError; end
@@ -8,53 +9,65 @@ module InlineForms
     geo_code_curacao: {
       archived_in_version: "7.6.0",
       archive_path: "archived/form_elements/geo_code_curacao",
-      summary: "Curaçao street geocode (MySQL Zones/Buurten/Straatcode, jQuery autocomplete, UJS list_streets).",
+      summary: "Curaçao street geocode (MySQL Zones/Buurten/Straatcode, jQuery autocomplete, UJS list_streets)."
     },
     chicas_photo_list: {
       archived_in_version: "7.6.0",
       archive_path: "archived/form_elements/chicas",
-      summary: "Chicas app read-only member photo gallery (show-only).",
+      summary: "Chicas app read-only member photo gallery (show-only)."
     },
     chicas_family_photo_list: {
       archived_in_version: "7.6.0",
       archive_path: "archived/form_elements/chicas",
-      summary: "Chicas app read-only family member photo gallery (show-only).",
+      summary: "Chicas app read-only family member photo gallery (show-only)."
     },
     chicas_dropdown_with_family_members: {
       archived_in_version: "7.6.0",
       archive_path: "archived/form_elements/chicas",
-      summary: "Chicas client picker via family.clients; moves CarrierWave upload dir on update.",
+      summary: "Chicas client picker via family.clients; moves CarrierWave upload dir on update."
     },
     kansen_slider: {
       archived_in_version: "7.6.0",
       archive_path: "archived/form_elements/kansen_slider",
-      summary: "jQuery UI slider for integer-coded chance scale; uses model attribute_values.",
+      summary: "jQuery UI slider for integer-coded chance scale; uses model attribute_values."
     },
     tree: {
       archived_in_version: "7.7.0",
       archive_path: "archived/form_elements/tree",
-      summary: "Self-referential children list via parent.children; requires host tree APIs (see README).",
+      summary: "Self-referential children list via parent.children; requires host tree APIs (see README)."
     },
     move: {
       archived_in_version: "7.7.0",
       archive_path: "archived/form_elements/tree",
-      summary: "Reparent via hash_tree_to_collection + add_child (host must implement; pairs with :tree).",
+      summary: "Reparent via hash_tree_to_collection + add_child (host must implement; pairs with :tree)."
     },
     absence_list: {
       removed_in_version: "6.3.0",
       archive_path: nil,
-      summary: "Project-specific absence list UI; removed without a copy in this repo (see CHANGELOG 6.3.0).",
+      summary: "Project-specific absence list UI; removed without a copy in this repo (see CHANGELOG 6.3.0)."
     },
     ckeditor: {
       archived_in_version: "8.1.21",
       archive_path: "archived/form_elements/ckeditor",
-      summary: "Legacy CKEditor form element; use :rich_text (ActionText) instead.",
+      summary: "Legacy CKEditor form element; use :rich_text (ActionText) instead."
     },
     text_area_without_ckeditor: {
       archived_in_version: "8.1.21",
       archive_path: "archived/form_elements/ckeditor",
-      summary: "Legacy plain-text alias; use :plain_text or :plain_text_area instead.",
+      summary: "Legacy plain-text alias; use :plain_text or :plain_text_area instead."
+    },
+    question_list: {
+      archived_in_version: "8.1.30",
+      archive_path: "archived/form_elements/question_list",
+      summary: "Survey-app checklist hardcoding a host Question model with subquestions."
     },
+    # The helper methods were named dnsrecords_* (no underscore), so the
+    # attribute-list symbol in host apps was :dnsrecords.
+    dnsrecords: {
+      archived_in_version: "8.1.30",
+      archive_path: "archived/form_elements/dns_records",
+      summary: "DNS-admin display of djbdns A-record lines via host a_records/djbdns_line APIs."
+    }
   }.freeze
   def self.validate_no_archived_form_elements_for!(klass)