easyfaa 0.20.0 → 1.0.0

data/app/assets/stylesheets/easy/tokens.css

@@ -0,0 +1,11 @@
+/* The easy design system's tokens: every colour any easy app draws with, light and dark. The
+   dark ones follow the system unless the visitor picks a theme (data-theme on <html>). Plain hex:
+   every page has to work on old iPhones, Androids and Windows browsers. */
+:root{color-scheme:light;--color-bg:#ffffff;--color-surface-1:#f6f7f8;--color-surface-2:#f1f2f3;--color-surface-3:#e2e5e7;--color-text:#2c2f32;--color-text-2:#50575d;--color-text-muted:#636c74;--color-line:#c6cbcf;--color-primary:#1a70d0;--color-primary-strong:#12559f;--shadow-raise:0 1px 0 rgba(11,30,58,.10),0 1px 3px rgba(11,30,58,.12);--shadow-raise-hover:0 2px 0 rgba(11,30,58,.10),0 4px 10px rgba(11,30,58,.16);--shadow-sunk:inset 0 1px 2px rgba(11,30,58,.10);--color-on-primary:#ffffff;--color-primary-soft:#dfe5ff;--color-on-primary-soft:#215aa5;--color-ok:#19753e;--color-bad:#b3261e;--color-bad-bg:#fbe3e0;--color-bad-line:#ee9b93;--color-ok-bg:#d8f0dd;--color-ok-line:#87d29a;--color-warn:#7e6317;--color-warn-bg:#fff4d5;--color-warn-line:#ffde80;--color-engine-bg:#f3e6d8;--color-engine:#6f4219;--color-engine-line:#c08a57;--color-propeller-bg:#ece4f7;--color-propeller:#5b2a86;--color-propeller-line:#a47fd0;--color-appliance-bg:#d9f0ec;--color-appliance:#1b5e55;--color-appliance-line:#6fb3a8;--color-midnight:#0b1e3a;--color-sky:#5aa9e6;--color-focus:#1a70d0;--color-sky-band-top:#eaf3fb;--color-sky-band-bottom:#ffffff;}
+@media (prefers-color-scheme: dark){
+  :root:not([data-theme="light"]){color-scheme:dark;--color-bg:#131415;--color-surface-1:#202223;--color-surface-2:#2c2f32;--color-surface-3:#3d4347;--color-text:#f1f2f3;--color-text-2:#abb2b8;--color-text-muted:#8c96a0;--color-line:#50575d;--color-primary:#689dff;--color-primary-strong:#9dbfff;--shadow-raise:0 1px 0 rgba(0,0,0,.5),0 1px 3px rgba(0,0,0,.5);--shadow-raise-hover:0 2px 0 rgba(0,0,0,.5),0 4px 10px rgba(0,0,0,.6);--shadow-sunk:inset 0 1px 2px rgba(0,0,0,.45);--color-on-primary:#131415;--color-primary-soft:#1d3155;--color-on-primary-soft:#bccdff;--color-ok:#59c27a;--color-bad:#ff8a80;--color-bad-bg:#4a1d1a;--color-bad-line:#c4453a;--color-ok-bg:#173e24;--color-ok-line:#13924c;--color-warn:#ffd352;--color-warn-bg:#564415;--color-warn-line:#d2a511;--color-engine-bg:#3d2a1a;--color-engine:#e8c29c;--color-engine-line:#9a6a3a;--color-propeller-bg:#2e1f44;--color-propeller:#d6bdf2;--color-propeller-line:#7a55a8;--color-appliance-bg:#16332f;--color-appliance:#9fd9cf;--color-appliance-line:#3f8a7f;--color-midnight:#cfe3f6;--color-sky:#5aa9e6;--color-focus:#689dff;--color-sky-band-top:#0c2338;--color-sky-band-bottom:#131415;}
+}
+:root[data-theme="dark"]{color-scheme:dark;--color-bg:#131415;--color-surface-1:#202223;--color-surface-2:#2c2f32;--color-surface-3:#3d4347;--color-text:#f1f2f3;--color-text-2:#abb2b8;--color-text-muted:#8c96a0;--color-line:#50575d;--color-primary:#689dff;--color-primary-strong:#9dbfff;--shadow-raise:0 1px 0 rgba(0,0,0,.5),0 1px 3px rgba(0,0,0,.5);--shadow-raise-hover:0 2px 0 rgba(0,0,0,.5),0 4px 10px rgba(0,0,0,.6);--shadow-sunk:inset 0 1px 2px rgba(0,0,0,.45);--color-on-primary:#131415;--color-primary-soft:#1d3155;--color-on-primary-soft:#bccdff;--color-ok:#59c27a;--color-bad:#ff8a80;--color-bad-bg:#4a1d1a;--color-bad-line:#c4453a;--color-ok-bg:#173e24;--color-ok-line:#13924c;--color-warn:#ffd352;--color-warn-bg:#564415;--color-warn-line:#d2a511;--color-engine-bg:#3d2a1a;--color-engine:#e8c29c;--color-engine-line:#9a6a3a;--color-propeller-bg:#2e1f44;--color-propeller:#d6bdf2;--color-propeller-line:#7a55a8;--color-appliance-bg:#16332f;--color-appliance:#9fd9cf;--color-appliance-line:#3f8a7f;--color-midnight:#cfe3f6;--color-sky:#5aa9e6;--color-focus:#689dff;--color-sky-band-top:#0c2338;--color-sky-band-bottom:#131415;}
+/* The one width every page, its header and its footer are capped at: what an account's page reaches, its 280px
+   sidebar beside 64rem of content and its 32px gutters (1368px). */
+:root{--page-max:85.5rem}

data/app/controllers/easyfaa/errors_controller.rb

@@ -0,0 +1,41 @@
+module EasyFAA
+  # The pages every app shows for 400, 404, 422 and 500 (config.exceptions_app, set by the
+  # engine). Plain ActionController::Base, not the host's ApplicationController: a 500 is exactly
+  # the moment the database or a session might be what broke, so nothing here may depend on either.
+  class ErrorsController < ActionController::Base
+    layout 'easyfaa/errors'
+    before_action :set_site
+
+    # Heading and sentence by status.
+    MESSAGES = {
+      400 => ['Bad request', 'The request could not be understood.'],
+      404 => ['Page not found', 'You may have mistyped the address, or the page may have moved.'],
+      422 => ['Can’t process that', 'The change was rejected, often because a page had been ' \
+                                    'left open too long. Going back and trying again usually ' \
+                                    'fixes it.',],
+      500 => ['Something went wrong', 'We’ve been notified and are looking into it. Try again ' \
+                                      'in a moment.',],
+    }.freeze
+
+    # The page for the status the route names, whatever format was asked for.
+    def show
+      @status = params[:status].to_i
+      @heading, @message = MESSAGES.fetch @status, MESSAGES.fetch(500)
+      render status: @status, formats: :html
+    end
+
+    # The page shown while the app is down for maintenance.
+    def down
+      @heading = 'Down for maintenance'
+      @message = "#{@site_name} is being updated and will be back in a few minutes."
+      render :show, formats: :html
+    end
+
+  private
+
+    def set_site
+      # The app names the site for the request (EasyFAA.site).
+      @site_name, @site_url = EasyFAA.site.call request
+    end
+  end
+end

data/app/helpers/easyfaa/easy_helper.rb

@@ -0,0 +1,58 @@
+module EasyFAA
+  # The easy design system's icons, for every view of every app (EasyFAA::Engine): one sprite every
+  # page shares (app/assets/images/easy/sprite.svg), one file the browser keeps for a year rather
+  # than a copy in every page.
+  module EasyHelper
+    # How an AD reaches an aircraft, as its chip says it: the word, then its icon in the sprite.
+    LEVELS = {
+      'applies' => %w[Applies applies], 'may_apply' => ['May apply', 'maybe'],
+      'not_applying' => ['Doesn’t apply', 'none'], 'superseded' => %w[Superseded superseded],
+      'reaches' => %w[Affects applies],
+    }.freeze
+
+    # Where an icon is in the sprite: its address, then the icon's id after the #.
+    # @param name [String] "sun", "newest": its id in the sprite, without the i-.
+    # @param kind ["i", "s"] an icon of the design system's, or a social network's.
+    def easy_icon_href(name, kind = 'i') = "#{asset_path 'easy/sprite.svg'}##{kind}-#{name}"
+
+    # An icon, hidden from screen readers: the text beside it says what it is.
+    # @param href [String] easy_icon_href's answer, or a name in the sprite.
+    # @param class [String] the svg's classes, "i" for an icon drawn the size of the text around it.
+    def easy_icon(href, class: 'i')
+      href = easy_icon_href(href) unless href.include? '#'
+      # Both hrefs: the old Safaris every page is meant for read only xlink:href.
+      tag.svg(tag.use('xlink:href': href, href:), class:, aria: { hidden: true }, focusable: false)
+    end
+
+    # The × of what can be removed (removable-x), drawn, not typed: it stays a cross in any font.
+    def easy_x
+      tag.svg(tag.path(d: 'M1 1l10 10M11 1L1 11', stroke: 'currentColor', 'stroke-width': 2, 'stroke-linecap': 'round'),
+              viewBox: '0 0 12 12', width: 12, height: 12, aria: { hidden: true }, focusable: false)
+    end
+
+    # An AD's level on its card, the level's color behind its icon and word.
+    # @param level [String] "applies", "may_apply", "not_applying", "superseded" or "reaches".
+    def easy_level_chip(level)
+      word, icon = LEVELS.fetch level.to_s
+      tag.span safe_join([easy_icon(icon), word]), class: "level-chip #{level}"
+    end
+
+    # An email's fonts, for a style attribute: no stylesheet reaches an email, so every piece names its own.
+    # @param kind [:body, :heading] the system's font for words, or Outfit where it loads for a title.
+    def easy_mailer_font(kind = :body)
+      if kind == :heading
+        %(font-family:"Outfit","Helvetica Neue",Helvetica,Arial,sans-serif;)
+      else
+        %(font-family:-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;)
+      end
+    end
+
+    # An aircraft's avatar until it has a picture: its silhouette in a circle, like a contact's.
+    # @param name [String] AircraftAvatar.for's answer, "high-wing-tailwheel".
+    # @param size [Integer] the circle's width and height in pixels.
+    def easy_aircraft_avatar(name, size: 40)
+      icon = easy_icon easy_icon_href(name, 'a'), class: nil
+      tag.span icon, class: 'aircraft-avatar', style: "width:#{size}px;height:#{size}px"
+    end
+  end
+end

data/app/models/aircraft_avatar.rb

@@ -0,0 +1,61 @@
+# Which of the 20 aircraft avatars (sprite a-*, easy_aircraft_avatar) draws an aircraft before
+# anyone has a picture of it: from what the registry says it is, and for a single-engine airplane
+# from its make and model too (config/aircraft_avatars.yml), so a Cub, a 172 and a Bonanza differ.
+module AircraftAvatar
+  # The single-engine airplane families by make and model, in the order they are tried.
+  FAMILIES = YAML.load_file(File.expand_path('../../config/aircraft_avatars.yml', __dir__))
+                 .transform_values { Regexp.new(it.join('|'), Regexp::IGNORECASE) }.freeze
+
+  # The engine types that turn no propeller and no rotor of their own.
+  JETS = %w[turbo_jet turbo_fan].freeze
+
+  # The families a single turboprop keeps (an Air Tractor), rather than being drawn as one.
+  TURBOPROP_FAMILIES = %w[ag-plane fixed-wing-drone].freeze
+
+  # @param type [String] the registry's type of aircraft: "fixed_wing_single_engine", "rotorcraft"…
+  # @param engine [String, nil] the registry's type of engine: "reciprocating", "electric"…
+  # @param name [String, nil] its make and model, "Piper PA-18-150".
+  # @param engines [Integer, nil] how many engines its model has.
+  # @param seats [Integer, nil] how many seats its model has.
+  # @param airliner [Boolean] whether its model is an airliner (30 seats or more, or its freighter).
+  # @return [String] the avatar's name in the sprite, without its a-: "high-wing-tailwheel".
+  def self.for(type:, engine: nil, name: nil, engines: nil, seats: nil, airliner: false)
+    case type.to_s
+    when 'balloon', 'blimp' then 'balloon'
+    when 'glider' then 'glider'
+    when 'weight_shift_control' then 'trike'
+    when 'powered_parachute' then 'powered-parachute'
+    when 'hybrid_lift' then 'fixed-wing-drone'
+    when 'rotorcraft', 'gyroplane' then rotorcraft(engine, engines.to_i, seats.to_i)
+    when 'fixed_wing_multi_engine' then multi_engine(engine, airliner)
+    else single_engine engine, name.to_s
+    end
+  end
+
+  class << self
+  private
+
+    def rotorcraft(engine, engines, seats)
+      return 'multirotor-drone' if engine == 'electric'
+
+      engines > 1 || seats > 8 ? 'heavy-helicopter' : 'helicopter'
+    end
+
+    def multi_engine(engine, airliner)
+      return 'twin' unless JETS.include? engine
+
+      airliner ? 'airliner' : 'business-jet'
+    end
+
+    def single_engine(engine, name)
+      return 'business-jet' if JETS.include? engine
+
+      family = FAMILIES.find { |_, pattern| pattern.match?(name) }&.first
+      if family && (engine != 'turbo_prop' || TURBOPROP_FAMILIES.include?(family))
+        family
+      else
+        engine == 'turbo_prop' ? 'single-turboprop' : 'high-wing'
+      end
+    end
+  end
+end

data/app/views/easy/_ad_card.html.erb

@@ -0,0 +1,16 @@
+<%# locals: (number:, href:, subject: nil, title: nil, part: nil, level: nil, kind: nil, tie: nil, effective: nil, data: {}) -%>
+<%# One AD in an ad-card-list: its level, kind, tie and date, then its number and subject as a link over its title; what
+    else the page says of it is the block's (render layout: "easy/ad_card"). `part` is what of the aircraft it reaches
+    ("airframe", "engine", "propeller", "appliance"), `level` one of easy_level_chip's, `effective` a date. The card
+    carries its number as data-sort, for the button that flips a list (easy/report_sort). -%>
+<%= tag.li class: [ "ad-card", part, level ], data: { sort: number.to_s, **data } do %>
+  <div class="ad-card-top">
+    <%= easy_level_chip level if level %>
+    <% if kind %><span class="ad-card-kind"><%= kind %></span><% end %>
+    <% if tie %><span class="tie-chip"><%= tie %></span><% end %>
+    <% if effective %><span class="ad-card-effective">Effective <%= effective.strftime "%B %-d, %Y" %></span><% end %>
+  </div>
+  <% name = [ "AD #{number}", subject.presence ].compact.join(": ") -%>
+  <h4><%= link_to name, href %><% if title.present? %><span class="t"><%= title %></span><% end %></h4>
+  <%= yield %>
+<% end %>

data/app/views/easy/_ad_list.html.erb

@@ -0,0 +1,11 @@
+<%# locals: (none:, size:, any: true) -%>
+<%# A list of ADs (render layout: "easy/ad_list"): the block draws its cards (easy/ad_card), under the line that says
+    its switches and its search leave none, which easy/switches shows and hides. With no card at all it is one line
+    and no list. none: what to say then, "No AD affects N714AD through its propeller."; size: how many cards the
+    block draws; any: whether one shows as the page arrives, false when every one starts switched off. -%>
+<% if size.zero? %>
+  <p class="none-here"><%= none %></p>
+<% else %>
+  <p class="none-here js-none"<%= " hidden".html_safe if any %>>Nothing matches the filters above.</p>
+  <ol class="ad-card-list"><%= yield %></ol>
+<% end %>

data/app/views/easy/_flyer.html.erb

@@ -0,0 +1,10 @@
+<%# locals: (plane:, date: nil) -%>
+<%# A plane crossing the sky behind a hero, its trail behind it, flown by easy/flyer.js, which the page includes once,
+    with easy/konami.js, its easter egg.
+    plane: its icon in the sprite, "plane" (easyFAA's airliner), "small-plane" (easyAnnual's single engine) or
+    "twin-plane" (easyFAA's accidents' twin engine).
+    date: "2026-12-25", the day to fly on instead of the visitor's today, to see a holiday's colors. -%>
+<%= tag.div class: "sky js-sky", aria: { hidden: true }, data: { date: } do %>
+  <svg class="trail js-trail" focusable="false"></svg>
+  <span class="flyer js-flyer"><%= easy_icon plane %></span>
+<% end %>

data/app/views/easy/_logo.html.erb

@@ -0,0 +1,15 @@
+<%# locals: (name:, width:) -%>
+<%# An app’s logo, drawn inline so its plane can wiggle on hover and its ink follow the theme: the paper
+    plane, then "easy", then the rest of the name, which the app hands over as the paths of its letters
+    (render layout: "easy/logo"). Its width is the drawing’s, on a height of 56; it is shown 32 tall. -%>
+<svg class="logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 <%= width %> 56" width="<%= (width * 32 / 56.0).round %>" height="32" role="img" aria-label="<%= name %>">
+<g class="plane"><g transform="scale(0.875)"><g class="ink-stroke" stroke-width="2.5" stroke-linejoin="round">
+    <polygon points="60,8 4,30 25,37" fill="#ffffff"/>
+    <polygon points="60,8 25,37 31,57" fill="#cfe0f3"/>
+  </g>
+  <g stroke="#7a93b3" stroke-width="1.6" stroke-linecap="round">
+    <line x1="16" y1="28.5" x2="36" y2="21"/><line x1="21" y1="31.5" x2="44" y2="22.5"/><line x1="27" y1="33" x2="46" y2="25.5"/>
+  </g>
+  <path d="M10 44 C14 50 18 53 24 55" fill="none" class="ink-stroke" stroke-width="2" stroke-dasharray="3 3" stroke-linecap="round"/></g></g>
+<g class="ink"><path d="M79.43 43.199999999999996Q76.58 43.199999999999996 74.31 41.91Q72.04 40.62 70.72 38.364999999999995Q69.4 36.11 69.4 33.29Q69.4 30.479999999999997 70.695 28.244999999999997Q71.99 26.009999999999998 74.22 24.705Q76.45 23.399999999999995 79.19 23.399999999999995Q81.82 23.399999999999995 83.84 24.604999999999997Q85.86 25.809999999999995 87.015 27.919999999999995Q88.17 30.029999999999998 88.17 32.739999999999995Q88.17 33.14 88.12 33.599999999999994Q88.07 34.059999999999995 87.96000000000001 34.64H71.93V31.65H86.05L84.73 32.8Q84.71000000000001 30.889999999999997 84.04 29.54Q83.37 28.189999999999998 82.13 27.455Q80.89 26.719999999999995 79.12 26.719999999999995Q77.26 26.719999999999995 75.875 27.525Q74.49 28.33 73.725 29.769999999999996Q72.96 31.209999999999997 72.96 33.17999999999999Q72.96 35.169999999999995 73.76499999999999 36.669999999999995Q74.57 38.169999999999995 76.03999999999999 38.995Q77.51 39.82 79.44 39.82Q81.03 39.82 82.38 39.25Q83.73 38.68 84.67 37.56999999999999L86.98 39.91Q85.62 41.51 83.64500000000001 42.355Q81.67 43.199999999999996 79.43 43.199999999999996Z"/><path d="M100.17 43.199999999999996Q97.53999999999999 43.199999999999996 95.42999999999999 41.894999999999996Q93.32 40.589999999999996 92.095 38.355Q90.87 36.12 90.87 33.339999999999996Q90.87 30.529999999999998 92.095 28.29Q93.32 26.049999999999997 95.425 24.724999999999994Q97.53 23.399999999999995 100.15 23.399999999999995Q102.33 23.399999999999995 104.03 24.299999999999997Q105.72999999999999 25.199999999999996 106.76499999999999 26.789999999999996Q107.8 28.379999999999995 107.91 30.439999999999998V36.15Q107.78999999999999 38.209999999999994 106.77 39.80499999999999Q105.75 41.4 104.045 42.3Q102.34 43.199999999999996 100.17 43.199999999999996ZM100.75 39.79Q103.44 39.79 105.07499999999999 37.985Q106.71 36.18 106.71 33.309999999999995Q106.71 31.379999999999995 105.965 29.914999999999996Q105.22 28.449999999999996 103.875 27.629999999999995Q102.53 26.809999999999995 100.73 26.809999999999995Q98.92999999999999 26.809999999999995 97.55 27.639999999999997Q96.17 28.47 95.375 29.935Q94.58 31.4 94.58 33.3Q94.58 35.199999999999996 95.375 36.66499999999999Q96.17 38.129999999999995 97.56 38.959999999999994Q98.95 39.79 100.75 39.79ZM106.49 42.8V37.699999999999996L107.15 33.05L106.49 28.459999999999997V23.799999999999997H110.1V42.8Z"/><path d="M121.38 43.199999999999996Q119.81 43.199999999999996 118.375 42.78Q116.94 42.36 115.75 41.59Q114.56 40.82 113.67 39.739999999999995L115.98 37.419999999999995Q117.03 38.68 118.39500000000001 39.3Q119.76 39.919999999999995 121.45 39.919999999999995Q123.13 39.919999999999995 124.03999999999999 39.345Q124.95 38.769999999999996 124.95 37.709999999999994Q124.95 36.669999999999995 124.215 36.089999999999996Q123.48 35.51 122.315 35.135Q121.15 34.76 119.86 34.39Q118.57 34.019999999999996 117.405 33.419999999999995Q116.24 32.81999999999999 115.505 31.764999999999993Q114.77 30.709999999999997 114.77 28.999999999999996Q114.77 27.279999999999998 115.595 26.029999999999998Q116.42 24.779999999999998 117.935 24.089999999999996Q119.45 23.399999999999995 121.55 23.399999999999995Q123.78 23.399999999999995 125.525 24.189999999999998Q127.27 24.979999999999997 128.4 26.539999999999996L126.09 28.849999999999994Q125.26 27.79 124.09 27.235Q122.92 26.679999999999996 121.43 26.679999999999996Q119.88 26.679999999999996 119.05 27.229999999999997Q118.22 27.779999999999998 118.22 28.72Q118.22 29.669999999999995 118.955 30.199999999999996Q119.69 30.729999999999997 120.85499999999999 31.08Q122.02 31.429999999999996 123.31 31.809999999999995Q124.6 32.19 125.765 32.83Q126.93 33.47 127.665 34.55Q128.4 35.629999999999995 128.4 37.4Q128.4 40.07 126.505 41.635Q124.61 43.199999999999996 121.38 43.199999999999996Z"/><path d="M138.68 42.949999999999996 130.45000000000002 23.799999999999997H134.42000000000002L140.54000000000002 38.8H139.26000000000002L145.71 23.799999999999997H149.71L140.84 42.949999999999996ZM133.25 50.76 138.82000000000002 39.29 140.84 42.949999999999996 137.24 50.76Z"/><%= yield %></g>
+</svg>

data/app/views/easy/_modal.html.erb

@@ -0,0 +1,17 @@
+<%# locals: (id:, close:, title: nil, open: false, emoji: nil, classes: nil) -%>
+<%# A dialog over the page, rendered as a layout around what it holds (render layout: "easy/modal" do … end), which
+    always lets its reader out: its ×, Esc or a click around it (easy/modal.js, which the page includes once), or
+    without the script the × as a link. Shown when its address's #id names it, or open: true (drawn already open, say
+    once a form asked).
+    close: where the × leads, "#" for a dialog opened by its #id, the page without what opened it otherwise.
+    title: its heading; without one, what it holds gives its own, with the id "#{id}-title" (one per step, say).
+    classes: the app's own, beside modal, to style what it holds. -%>
+<%= tag.div id:, class: [ "modal", ("is-open" if open), classes ], role: "dialog",
+            aria: { modal: true, labelledby: "#{id}-title" } do %>
+  <div class="modal-box">
+    <%= link_to "×", close, class: "modal-x", aria: { label: "Close" } %>
+    <% if title %><h2 id="<%= id %>-title"><% if emoji %><span
+      aria-hidden="true"><%= emoji %></span> <% end %><%= title %></h2><% end %>
+    <%= yield %>
+  </div>
+<% end %>

data/app/views/easy/_part_tabs.html.erb

@@ -0,0 +1,24 @@
+<%# locals: (parts:) -%>
+<%# The parts of an aircraft as tabs over one section each (render layout: "easy/part_tabs"): the block draws what a
+    part's section holds, under its heading, and takes the part. Every page that lists ADs part by part is drawn with
+    it, so the tabs, the switches and the counts (easy/tabs, easy/switches) find the same page everywhere.
+    parts: [{ id: "engine", name: "Engine", icon: "engine", count: 12 }, …]; a part may also say dot: "Due now" for a
+    dot after its count, and aside: true to sit at the row's right end, as what is not a part does (Accidents): its
+    count is its own, never counted again from the ADs shown. -%>
+<ul class="part-tabs js-tabs">
+  <% parts.each_with_index do |part, index| %>
+    <%= tag.li class: ("part-tabs-records" if part[:aside]) do %>
+      <a href="#<%= part[:id] %>" class="<%= class_names part[:id], "is-on": index.zero? %>"><%= easy_icon part[:icon] %><%= part[:name]
+        %><% if part[:count] %><%= tag.span part[:count], class: class_names("n", "js-count": !part[:aside]) %><% end
+        %><% if part[:dot] %><span class="part-tabs-dot" title="<%= part[:dot] %>"></span><% end %></a>
+    <% end %>
+  <% end %>
+</ul>
+<% parts.each_with_index do |part, index| %>
+  <section id="<%= part[:id] %>" class="<%= class_names "part-tabs-panel", "is-off": index.positive? %>"
+           aria-labelledby="<%= part[:id] %>-h">
+    <h2 id="<%= part[:id] %>-h"><%= part[:name] %></h2>
+    <%= yield part %>
+  </section>
+<% end %>
+<%= javascript_include_tag "easy/tabs", defer: true %>

data/app/views/easy/_pin_code.html.erb

@@ -0,0 +1,10 @@
+<%# locals: (name:, id: nil, autofocus: false, label: "6-digit code") -%>
+<%# The 6-digit code emailed to sign in or to sign: one real field, so a pasted or autofilled code lands whole, drawn
+    over six slots by easy/pin_code.js, which the page includes once; without the script, the field itself shows.
+    name: the field's, "sign_in[pin]"; a code refused is the page's to mark, is-invalid on the .pin-code. -%>
+<div class="pin-code">
+  <%= tag.input type: "text", name:, id:, class: "pin-code-input", required: true, autofocus:,
+                autocomplete: "one-time-code", inputmode: "numeric", pattern: "[0-9]{6}", maxlength: 6, aria: { label: } %>
+  <div class="pin-code-slots"
+       aria-hidden="true"><span></span><span></span><span></span><span></span><span></span><span></span></div>
+</div>

data/app/views/easy/_report_head.html.erb

@@ -0,0 +1,28 @@
+<%# locals: (heading: nil, heading_id: nil, before: nil, switches_id: "switches", switches: [], after: nil, search: nil, search_label: search, sort_list: nil, sort_default: "newest") -%>
+<%# The head of a report or list: its heading, its switches (each { state:, css:, icon:, count:, label:, off: }), with the
+    sort button at their end, and a search. before and after go above and below the switches. sort_list is the list, or the lists, the
+    button flips by each row's data-sort (easy/report_sort); without it the page sorts by itself. Inside js-switches
+    the switches and the search show or hide the rows by their data-state (easy/switches), and the words searched are
+    marked in the rows left (easy/highlight). -%>
+<%= tag.section class: "report-head", data: { sort_list:, sort_default: (sort_default if sort_list) }.compact do %>
+  <% if heading %><%= tag.h2 heading, id: heading_id %><% end %>
+  <%= before %>
+  <% if switches.any? %>
+    <%= tag.ul class: "switches levels", id: switches_id do %>
+      <% switches.each do |item| %>
+        <%= tag.li class: item[:css], data: { state: item[:state], off: item[:off] }.compact do
+          %><% if item[:icon] %><%= easy_icon item[:icon] %><% end %><span class="n"><%= item[:count] %></span>
+          <%= item[:label] %><% end %>
+      <% end %>
+      <li class="sort-button-item" hidden><button type="button" class="sort-button js-sort"><%=
+        easy_icon sort_default %><span class="js-sort-label"><%= sort_default.capitalize %> first</span></button></li>
+    <% end %>
+  <% end %>
+  <%= after %>
+  <% if search %><label class="word-search report-search js-words" hidden><%= easy_icon "search" %><input
+    type="search" placeholder="<%= search %>" aria-label="<%= search_label %>" autocomplete="off"
+    spellcheck="false"></label><% end %>
+<% end %>
+<% if sort_list %><%= javascript_include_tag "easy/report_sort", defer: true %><% end %>
+<% if search %><%= javascript_include_tag "easy/highlight", defer: true %><% end %>
+<% if switches.any? || search %><%= javascript_include_tag "easy/switches", defer: true %><% end %>

data/app/views/easy/mailer/_button.html.erb

@@ -0,0 +1,10 @@
+<%# locals: (label:, href:, padding: "10px 28px 18px") -%>
+<%# A row of an email's card (easy/mailer/card) holding its one button: the blue pill, centered. padding: the room
+    around it, for a row with nothing over or under it. -%>
+<tr><td align="center" style="padding:<%= padding %>;">
+  <table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr>
+    <td style="background:#1a70d0;border-radius:24px;">
+      <a href="<%= href %>" style="display:inline-block;padding:14px 30px;<%= easy_mailer_font :heading %>font-size:17px;font-weight:600;color:#ffffff;text-decoration:none;border-radius:24px;"><%= label %></a>
+    </td>
+  </tr></table>
+</td></tr>

data/app/views/easy/mailer/_card.html.erb

@@ -0,0 +1,23 @@
+<%# locals: (title: nil, label: nil, note: nil, code: false) -%>
+<%# A card on an email's page (easy/mailer/frame): white and rounded, under a navy head that says what the email is
+    about when it has a title; the block draws its rows, each a <tr> (easy/mailer/text, easy/mailer/button). label:
+    the small words over the title, "A new AD may affect"; title: "N714AD"; note: a line under it; code: the title is
+    a code to type, drawn large, centered and selected whole by one click or tap. -%>
+<tr><td style="background:#ffffff;border:1px solid #c6cbcf;border-radius:18px;overflow:hidden;">
+  <table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
+    <% if title && code %>
+      <tr><td align="center" style="background:#0b1e3a;padding:30px 28px 30px;border-radius:17px 17px 0 0;">
+        <div style="<%= easy_mailer_font %>font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:#9fb6d4;margin:0 0 12px;"><%= label %></div>
+        <div style="<%= easy_mailer_font :heading %>font-size:56px;font-weight:700;letter-spacing:.14em;color:#ffffff;line-height:1;-webkit-user-select:all;user-select:all;"><%= title %></div>
+        <% if note %><div style="<%= easy_mailer_font %>font-size:15px;line-height:1.4;color:#cfe0f3;margin:14px 0 0;"><%= note %></div><% end %>
+      </td></tr>
+    <% elsif title %>
+      <tr><td style="background:#0b1e3a;padding:26px 28px;border-radius:17px 17px 0 0;">
+        <% if label %><div style="<%= easy_mailer_font %>font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:#9fb6d4;margin:0 0 6px;"><%= label %></div><% end %>
+        <div style="<%= easy_mailer_font :heading %>font-size:38px;font-weight:700;letter-spacing:.02em;color:#ffffff;line-height:1.1;"><%= title %></div>
+        <% if note %><div style="<%= easy_mailer_font %>font-size:17px;color:#dfe5ff;margin-top:6px;"><%= note %></div><% end %>
+      </td></tr>
+    <% end %>
+    <%= yield %>
+  </table>
+</td></tr>

data/app/views/easy/mailer/_code.html.erb

@@ -0,0 +1,28 @@
+<%# locals: (code:, brand:, site:, logo:, purpose:, lifetime:, ignore:, link: nil, link_label: nil, link_lede: nil, fine: nil) -%>
+<%# The email carrying a 6-digit code, the same from every easy app (its text twin: _code.text.erb): the logo, then a
+    card whose navy head holds the code large enough to read across the room, selected whole by one click or tap.
+    The code is plain digits next to the words "verification code", in the subject too ("123456 is your easyFAA
+    verification code"), with no other run of digits near it: what Apple Mail, iOS and Gmail look for to offer it to
+    the field that asks for it.
+    code: "123456"; brand: "easyFAA"; site: the app's address, under the card; logo: the URL of the brand's logo,
+    an inline attachment so it shows wherever the email is read; purpose: "to sign in", "to sign the airframe
+    logbook entry for N22196"; lifetime: "10 minutes"; ignore: what to do with an email nobody asked for.
+    link, link_label, link_lede: a button doing what the code does, the sentence above it, which names the code again as
+    the email's own does without one ("Type 123456 in the window you left open."); fine: under it (HTML). -%>
+<% page = { brand:, site:, logo:, title: "#{code} is your #{brand} verification code",
+           preview: "Your #{brand} verification code #{purpose}: #{code}" } %>
+<%= render layout: "easy/mailer/frame", locals: page do %>
+  <%= render layout: "easy/mailer/card", locals: { title: code, label: "Your #{brand} verification code", note: purpose.upcase_first, code: true } do %>
+    <% if link %>
+      <tr><td align="center" style="padding:22px 28px 8px;<%= easy_mailer_font %>font-size:16px;line-height:1.5;color:#2c2f32;"><%= link_lede %></td></tr>
+      <%= render "easy/mailer/button", label: link_label, href: link %>
+    <% else %>
+      <%# The code again, in a plain sentence: Mail offers a code it reads in running words to the field that asks. -%>
+      <tr><td align="center" style="padding:22px 28px 8px;<%= easy_mailer_font %>font-size:16px;line-height:1.5;color:#2c2f32;">Type <%= code %> in the window you left open.</td></tr>
+    <% end %>
+    <tr><td align="center" style="padding:0 28px 26px;<%= easy_mailer_font %>font-size:13px;line-height:1.5;color:#636c74;">
+      <% if fine %><%= fine %><br><% end %>
+      It works once, for <%= lifetime %>. <%= ignore %>
+    </td></tr>
+  <% end %>
+<% end %>

data/app/views/easy/mailer/_code.text.erb

@@ -0,0 +1,19 @@
+<%# locals: (code:, brand:, site:, purpose:, lifetime:, ignore:, logo: nil, link: nil, link_label: nil, link_lede: nil, fine: nil) -%>
+<%# The plain-text twin of _code.html.erb: the code first, on its own line beside the words "verification code". fine: plain text. -%>
+Your <%= brand %> verification code <%= purpose %>: <%= code %>
+<% if link %>
+
+<%= link_lede %>
+<%= link %>
+<% else %>
+
+Type <%= code %> in the window you left open.
+<% end %>
+<% if fine %>
+
+<%= fine %>
+<% end %>
+
+It works once, for <%= lifetime %>. <%= ignore %>
+
+<%= site %>

data/app/views/easy/mailer/_frame.html.erb

@@ -0,0 +1,35 @@
+<%# locals: (brand:, site:, logo:, title:, preview: nil, footer: nil) -%>
+<%# The page every easy app's email is drawn on (render layout: "easy/mailer/frame"): the brand's logo over what the
+    block draws, cards (easy/mailer/card) and rows of its own, then the site's address. Styled inline and laid out in
+    tables, as email clients need. brand: "easyFAA"; site: the app's address; logo: the URL of the brand's logo, an
+    inline attachment so it shows wherever the email is read; title: the page's; preview: what an inbox shows after
+    the subject; footer: what the last row says in place of the site's address (HTML). -%>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light">
+<meta name="supported-color-schemes" content="light">
+<meta name="format-detection" content="telephone=no, date=no, address=no">
+<title><%= title %></title>
+<link href="https://fonts.googleapis.com/css2?family=Outfit:wght@500;600;700&amp;display=swap" rel="stylesheet">
+</head>
+<body style="margin:0;padding:0;background:#f1f2f3;">
+<% if preview %><div style="display:none;max-height:0;overflow:hidden;opacity:0;"><%= preview %></div><% end %>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#f1f2f3;">
+  <tr><td align="center" style="padding:32px 16px;">
+    <table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="max-width:560px;">
+      <tr><td style="padding:0 4px 20px;">
+        <a href="<%= site %>" style="text-decoration:none;"><img
+          src="<%= logo %>" height="32" alt="<%= brand %>" style="display:block;border:0;height:32px;width:auto;"></a>
+      </td></tr>
+      <%= yield %>
+      <tr><td style="padding:18px 8px 0;<%= easy_mailer_font %>font-size:12px;line-height:1.5;color:#636c74;text-align:center;">
+        <%= footer || link_to(URI(site).host, site, style: "color:#636c74;") %>
+      </td></tr>
+    </table>
+  </td></tr>
+</table>
+</body>
+</html>

data/app/views/easy/mailer/_text.html.erb

@@ -0,0 +1,7 @@
+<%# locals: (small: false) -%>
+<%# A row of words in an email's card (easy/mailer/card): the block's paragraphs, or its fine print (small). -%>
+<% if small %>
+<tr><td style="padding:0 28px 26px;<%= easy_mailer_font %>font-size:13px;line-height:1.5;color:#636c74;"><%= yield %></td></tr>
+<% else %>
+<tr><td style="padding:12px 28px 8px;<%= easy_mailer_font %>font-size:16px;line-height:1.55;color:#2c2f32;"><%= yield %></td></tr>
+<% end %>

data/app/views/easyfaa/errors/show.html.erb

@@ -0,0 +1,17 @@
+<% content_for :title, "#{@heading} | #{@site_name}" %>
+<h1>
+  <svg viewBox="0 0 64 64" aria-hidden="true">
+    <g stroke="currentColor" stroke-width="2.5" stroke-linejoin="round">
+      <polygon points="60,8 4,30 25,37" fill="#ffffff"/>
+      <polygon points="60,8 25,37 31,57" fill="#cfe0f3"/>
+    </g>
+    <g stroke="#7a93b3" stroke-width="1.6" stroke-linecap="round">
+      <line x1="16" y1="28.5" x2="36" y2="21"/><line x1="21" y1="31.5" x2="44" y2="22.5"/>
+      <line x1="27" y1="33" x2="46" y2="25.5"/>
+    </g>
+    <path d="M10 44 C14 50 18 53 24 55" fill="none" stroke="currentColor" stroke-width="2" stroke-dasharray="3 3"
+          stroke-linecap="round"/>
+  </svg>
+  <%= @heading %>
+</h1>
+<p><%= @message %></p>

data/app/views/layouts/easy/site.html.erb

@@ -0,0 +1,55 @@
+<%# The page every easy app draws: an app's own layout fills the slots, then renders this one
+    (render template: "layouts/easy/site").
+    - :easy_head, its title, metas and links;
+    - :easy_stylesheets, its own stylesheets, after the shared ones;
+    - :body_class, the body's classes;
+    - :site_brand_url and :site_brand, where its logo goes and the logo;
+    - :site_nav, its links, sign in or out;
+    - :sky_band, any word, for the band under the header; then the page is wide;
+    - :page_class, the page's own classes beside page ("wide" for one that lays out its own widths);
+    - :site_footer, its footer's lines and links;
+    - :body_end, its scripts. -%>
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<%= yield :easy_head %>
+<%# The headings' face, asked for with the stylesheet rather than once it is read (easy/base.css). -%>
+<%= preload_link_tag asset_path("easy/outfit-latin.woff2"), as: "font", type: "font/woff2", crossorigin: "anonymous" %>
+<%= stylesheet_link_tag "easy/tokens", "easy/base", "easy/layout", "easy/components" %>
+<%= yield :easy_stylesheets %>
+<script>(function(){document.documentElement.className+=' has-js';try{var t=localStorage.getItem('theme');
+if(t==='dark'||t==='light'){document.documentElement.setAttribute('data-theme',t)}}catch(e){}})();</script>
+</head>
+<body class="<%= content_for(:body_class) %>">
+<a class="skip-link" href="#main">Skip to content</a>
+<header class="site-header">
+  <div class="page-width">
+    <%= link_to content_for(:site_brand_url) || "/", class: "site-brand" do %><%= yield :site_brand %><% end %>
+    <div>
+      <nav class="site-nav" aria-label="Site"><%= yield :site_nav %></nav>
+      <button type="button" class="theme-toggle js-theme" aria-pressed="false">
+        <%= easy_icon "sun", class: "i i-sun" %><%= easy_icon "moon", class: "i i-moon" %><span
+          class="theme-toggle-label">Dark theme</span>
+      </button>
+    </div>
+  </div>
+</header>
+<% if content_for?(:sky_band) %>
+<div class="sky-band"></div>
+<% end %>
+<main id="main"
+      class="page<%= " wide" if content_for?(:sky_band) %><%= " #{content_for(:page_class)}" if content_for?(:page_class) %>">
+<%= yield %>
+</main>
+<footer id="footer" class="site-footer">
+  <div class="site-footer-inner">
+<%= yield :site_footer %>
+  </div>
+</footer>
+<%# The header's theme button, and any theme radios a page draws. -%>
+<%= javascript_include_tag "easy/theme", defer: true %>
+<%= yield :body_end %>
+</body>
+</html>

data/app/views/layouts/easyfaa/errors.html.erb

@@ -0,0 +1,30 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<meta name="robots" content="noindex">
+<title><%= content_for(:title) || @site_name %></title>
+<style>
+:root{color-scheme:light;--bg:#ffffff;--ink:#15202e;--muted:#50575d;--primary:#1a70d0}
+@media (prefers-color-scheme: dark){
+  :root{color-scheme:dark;--bg:#131415;--ink:#f3f5f8;--muted:#abb2b8;--primary:#689dff}
+}
+*{box-sizing:border-box}
+body{margin:0;min-height:100svh;display:flex;flex-direction:column;align-items:center;justify-content:center;
+  background:var(--bg);color:var(--ink);
+  font:500 17px/1.5 system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;text-align:center;padding:40px 24px}
+a{color:var(--primary)}
+h1{display:flex;align-items:center;justify-content:center;font-size:clamp(1.5rem,5.5vw,2.25rem);margin:0}
+h1 svg{width:1.1em;height:1.1em;margin-right:0.3em;flex-shrink:0}
+p{color:var(--muted);margin:18px 0 0;max-width:32rem}
+footer{margin-top:40px;font-size:15px;color:var(--muted)}
+footer a{color:inherit;text-decoration:none}
+</style>
+</head>
+<body>
+<%= yield %>
+<footer><%= link_to @site_name, @site_url %></footer>
+</body>
+</html>

data/config/aircraft_avatars.yml

@@ -0,0 +1,26 @@
+# The single-engine airplane families easyFAA tells apart by make and model ("Cessna 172N",
+# "Piper PA-18-150", "Van's RV-8"), tried in this order, the first pattern found in the name
+# winning. A name no pattern finds is drawn high-wing, as the commonest. Case is ignored.
+fixed-wing-drone:
+  - v-?bat|zipline|\buav\b|\buas\b|unmanned|drone
+biplane:
+  - stearman|\bpt-?1[37]\b|\bn2s\b|pitts|\bs-?[12][abcs]?\b|waco|great lakes|starduster|skybolt|acro ?sport
+  - hatz|miniplane|christen|eagle ii|\bultimate\b|tiger moth|\bjungmann
+ag-plane:
+  - air tractor|\bat-?[3-8]\d\d|thrush|\bs-?2r|ag-?cat|g-?164|\bpa-?25|pawnee|\bpa-?36|ag ?(wagon|truck|husky)|\b188\b
+floatplane:
+  - \blake\b|\bla-?(4|250)|searey|sea rey|icon a5|seawind|\bg-?(21|44|73)\b|goose|widgeon|seabee|rc-?3\b|skimmer|catalina
+low-wing-tailwheel:
+  - \brv-?[3468]\b(?!a)|\bat-?6\b|\bt-?6\b|\bsnj\b|harvard|\bp-?51\b|mustang|\bpt-?(19|22|26)\b|\bextra\b|\bea-?300
+  - edge 540|\bgiles\b|\blaser\b|\bcap ?(10|21|23)|\bsu-?(26|29|31)\b|\bt-?28\b
+high-wing-tailwheel:
+  - \bj-?[2345]\b|\bpa-?(11|12|14|16|17|18|20)\b|cub|aeronca|champ|citabria|decathlon|scout|\b7[acegk]c|\b8kcab
+  - taylorcraft|\bbc-?12|cessna (a)?1(20|40|70|80|85|95)|\b(a)?185|maule|husky|\baviat\b|stinson|luscombe|kitfox|savage
+  - \bm-?[4-7]\b|helio|courier|\bdhc-?2\b|beaver|\bl-?(2|3|4|16|19)\b|bird ?dog|super ?cub|carbon ?cub|backcountry
+low-wing-retractable:
+  - mooney|\bm20|(beech|raytheon|textron|hawker).*\b[a-v]?(33|35|36)[a-z]?\b|bonanza|debonair|\bpa-?(24|28r|30|32r|39|46)\b|comanche|arrow|saratoga
+  - lance|\bt-?34\b|meridian|malibu|mirage|navion|\bm-?18|\bb-?24r|sierra|swift|\bgc-?1|viking|\b17-?3\d|bellanca 14
+low-wing:
+  - \bpa-?(28|32|38)\b|cherokee|warrior|archer|cadet|tomahawk|cirrus|\bsr-?2[02]|\bda-?(20|40)|diamond|katana
+  - \baa-?(1|5)|grumman|tiger|cheetah|traveler|musketeer|sundowner|\bbe-?23|\bc-?23\b|\brv-?\d+|ercoupe|aircoupe|\balon\b
+  - lancair|glasair|sonex|zenith|\bch-?[67]\d\d|tecnam|evektor|sportstar|\bsr-?20