@airmark/quiver 0.32.2 → 0.34.0

package/quills/usaf_memo/0.3.0/packages/tonguetoquill-usaf-memo/src/frontmatter.typ

@@ -1,58 +1,54 @@
-// frontmatter.typ: Frontmatter show rule for USAF memorandum
-//
-// This module implements the frontmatter (heading section) of a USAF memorandum
-// per AFH 33-337 Chapter 14 "The Heading Section". It handles:
-// - Page setup with proper margins
-// - Letterhead rendering
-// - Date, MEMORANDUM FOR, FROM, SUBJECT, and References placement
-// - Classification markings in headers/footers
+// The memorandum's heading section, and the page setup the rest of the
+// document inherits: AFH 33-337 Chapter 14 "The Heading Section".
 
 #import "primitives.typ": *
 
 #let frontmatter(
   subject: none,
-  memo_for: none,
-  memo_from: none,
+  memo-for: none,
+  memo-from: none,
   date: none,
+  // Fill-in widget printed on the date line for an omitted `date`, in place of
+  // today's date. An indorsement header restating the memo then leaves the date
+  // out.
+  date-field: none,
   references: none,
-  letterhead_title: "DEPARTMENT OF THE AIR FORCE",
-  letterhead_caption: "[YOUR SQUADRON/UNIT NAME]",
-  letterhead_seal: none,
-  letterhead_seal_subtitle: none, // optional line under seal (9pt bold caps); ignored if no seal
-  letterhead_emblem: none, // optional image placed opposite the seal (right side)
-  letterhead_emblem_height: 1in, // emblem fit-box height; reduce for shorter emblems
-  letterhead_font: DEFAULT_LETTERHEAD_FONTS,
-  body_font: DEFAULT_BODY_FONTS,
-  font_size: 12pt,
-  memo_for_cols: 3,
-  classification_level: none,
+  letterhead-title: "DEPARTMENT OF THE AIR FORCE",
+  letterhead-caption: "[YOUR SQUADRON/UNIT NAME]",
+  letterhead-seal: none,
+  letterhead-seal-subtitle: none, // optional line under seal (9pt bold caps); ignored if no seal
+  letterhead-emblem: none, // optional image placed opposite the seal (right side)
+  letterhead-emblem-height: 1in, // emblem fit-box height; reduce for shorter emblems
+  letterhead-font: DEFAULT_LETTERHEAD_FONTS,
+  body-font: DEFAULT_BODY_FONTS,
+  font-size: 12pt,
+  memo-for-cols: 3,
+  classification-level: none,
   dissemination: none,
-  cui_controlled_by: none,
-  cui_category: none,
-  cui_limited_dissemination: none,
-  cui_poc: none,
-  footer_tag_line: none,
-  memo_style: "usaf",
+  cui-controlled-by: none,
+  cui-category: none,
+  cui-limited-dissemination: none,
+  cui-poc: none,
+  footer-tag-line: none,
+  memo-style: "usaf",
   it,
 ) = {
   assert(subject != none, message: "subject is required")
-  assert(memo_for != none, message: "memo_for is required")
+  assert(memo-for != none, message: "memo-for is required")
   assert(
-    memo_style in ("usaf", "daf"),
-    message: "memo_style must be \"usaf\" or \"daf\"",
+    memo-style in ("usaf", "daf"),
+    message: "memo-style must be \"usaf\" or \"daf\"",
   )
 
-  let actual_date = if date == none { datetime.today() } else { date }
+  let actual-date = if date != none { date } else if date-field != none { date-field } else { datetime.today() }
 
-  // The banner is `LEVEL` or `LEVEL//SUFFIX`. `classification_level` is an enum
-  // (a `str`), but `dissemination` is a `plaintext` field and so arrives as
-  // content, which `str + str` cannot absorb — the marking is assembled as
-  // content instead, keeping the suffix's glyphs click-navigable on every page
-  // the banner repeats on.
-  let classification_marking = if classification_level == none or type(classification_level) != str {
+  // The banner is `LEVEL` or `LEVEL//SUFFIX`. `classification-level` is an enum
+  // (a `str`), but `dissemination` may arrive as content, which `str + str`
+  // cannot absorb — so the marking is assembled as content instead.
+  let classification-marking = if classification-level == none or type(classification-level) != str {
     none
   } else {
-    let base = classification_level.trim()
+    let base = classification-level.trim()
     if base == "" {
       none
     } else if falsey(dissemination) {
@@ -66,42 +62,40 @@
       [#base#separator#box(upper(dissemination))]
     }
   }
-  let classification_color = get-classification-level-color(classification_level)
+  let classification-color = get-classification-level-color(classification-level)
 
   // Build the CUI designation indicator block (DoDM 5200.48, Table 1), shown
   // only for CUI when at least one indicator field is set. Rendered as a
   // bottom-right page-1 float (see placement below).
-  let cui_indicator = if (
-    classification_level != none
-    and type(classification_level) == str
-    and classification_level.trim().starts-with("CUI")
+  let cui-indicator = if (
+    classification-level != none
+    and type(classification-level) == str
+    and classification-level.trim().starts-with("CUI")
   ) {
-    // Each indicator is a `plaintext` field, so it arrives as content when set
-    // and as `""` when blank — `falsey` is the shape-agnostic presence test
-    // that the former `type(..) == str and ..trim() != ""` guard replaces.
+    // An indicator may arrive as content or as a `str`; `falsey` is the
+    // presence test that reads both shapes.
     let lines = ()
-    if not falsey(cui_controlled_by) {
-      lines.push([Controlled By: #cui_controlled_by])
+    if not falsey(cui-controlled-by) {
+      lines.push([Controlled By: #cui-controlled-by])
     }
-    if not falsey(cui_category) {
-      lines.push([CUI Category: #cui_category])
+    if not falsey(cui-category) {
+      lines.push([CUI Category: #cui-category])
     }
-    if not falsey(cui_limited_dissemination) {
-      lines.push([LDC: #upper(cui_limited_dissemination)])
+    if not falsey(cui-limited-dissemination) {
+      lines.push([LDC: #upper(cui-limited-dissemination)])
     }
-    if not falsey(cui_poc) {
-      lines.push([POC: #cui_poc])
+    if not falsey(cui-poc) {
+      lines.push([POC: #cui-poc])
     }
     if lines.len() > 0 { lines.join(linebreak()) } else { none }
   } else {
     none
   }
 
-  // Document-wide typography settings (inlined from configure())
   set par(leading: spacing.line, spacing: spacing.line, justify: false)
   set block(above: spacing.line, below: 0em, spacing: 0em)
-  set text(font: body_font, size: font_size, fallback: true)
-  show raw: set text(font: DEFAULT_MONO_FONTS)  // Static monospace face for inline code and code blocks
+  set text(font: body-font, size: font-size, fallback: true)
+  show raw: set text(font: DEFAULT_MONO_FONTS)
 
   set page(
     paper: "us-letter",
@@ -126,29 +120,29 @@
         )
       }
 
-      if classification_marking != none {
+      if classification-marking != none {
         place(
           top + center,
           dy: 0.375in,
-          text(12pt, font: DEFAULT_BODY_FONTS, fill: classification_color)[#strong(classification_marking)],
+          text(12pt, font: DEFAULT_BODY_FONTS, fill: classification-color)[#strong(classification-marking)],
         )
       }
     },
     footer: {
-      if classification_marking != none {
+      if classification-marking != none {
         place(
           bottom + center,
           dy: -.375in,
-          text(12pt, font: DEFAULT_BODY_FONTS, fill: classification_color)[#strong(classification_marking)],
+          text(12pt, font: DEFAULT_BODY_FONTS, fill: classification-color)[#strong(classification-marking)],
         )
       }
 
-      if not falsey(footer_tag_line) {
+      if not falsey(footer-tag-line) {
         place(
           bottom + center,
           dy: -0.625in,
           align(center)[
-            #text(fill: LETTERHEAD_COLOR, font: "cinzel", size: 15pt)[#footer_tag_line]
+            #text(fill: LETTERHEAD_COLOR, font: "Spectral SC", size: 15pt)[#footer-tag-line]
           ],
         )
       }
@@ -160,25 +154,25 @@
   // it (1) reserves flow space, raising page 1's effective bottom margin so body
   // text never overlaps it, and (2) stays pinned to page 1 — as the first flow
   // content it can never be bumped to page 2.
-  if cui_indicator != none {
+  if cui-indicator != none {
     context {
       // The box shrink-wraps to its widest line; `set align(left)` keeps the
       // text flush-left within it, overriding the `align(right)` the placement
       // below imposes.
-      let indicator_box = box({
+      let indicator-box = box({
         set text(font: DEFAULT_BODY_FONTS, size: 10pt)
         set par(leading: 0.4em, spacing: 0pt)
         set align(left)
-        cui_indicator
+        cui-indicator
       })
       // Reserve only the part of the block inside the text area (`reserved`):
       // float a box of that height, then `place` the full block inside it pushed
       // down by `overhang` so the surplus overflows into the edge band. (A bare
-      // `box(height: reserved, indicator_box)` overflows *upward* into the body
+      // `box(height: reserved, indicator-box)` overflows *upward* into the body
       // instead.) The inner `place` adds no size, so the box stays `reserved`
       // tall and the block's bottom lands 0.5in from the page edge.
       let overhang = spacing.margin - 0.5in
-      let reserved = measure(indicator_box).height - overhang
+      let reserved = measure(indicator-box).height - overhang
       place(
         bottom + right,
         float: true,
@@ -188,44 +182,44 @@
         // Minimum gap to the body's last line; the actual gap is larger when the
         // next paragraph can't fit above the block and breaks to the next page.
         clearance: spacing.line,
-        box(height: reserved, place(bottom + right, dy: overhang, indicator_box)),
+        box(height: reserved, place(bottom + right, dy: overhang, indicator-box)),
       )
     }
   }
 
   render-letterhead(
-    letterhead_title,
-    letterhead_caption,
-    letterhead_font,
-    letterhead-seal: letterhead_seal,
-    letterhead-seal-subtitle: letterhead_seal_subtitle,
-    letterhead-emblem: letterhead_emblem,
-    letterhead-emblem-height: letterhead_emblem_height,
+    letterhead-title,
+    letterhead-caption,
+    letterhead-font,
+    letterhead-seal: letterhead-seal,
+    letterhead-seal-subtitle: letterhead-seal-subtitle,
+    letterhead-emblem: letterhead-emblem,
+    letterhead-emblem-height: letterhead-emblem-height,
   )
 
   // AFH 33-337 "Date": "Place the date 1 inch from the right edge, 1.75 inches from the top"
   // Since we have a 1-inch top margin, we need (1.75in - margin) vertical space
   v(1.75in - spacing.margin)
 
-  // Measure and cache body line stride once for body line-count heuristics.
+  // Measure one line's stride once, under the typography just set, for the
+  // blank-line spacing the sections below and the body are laid out on.
   context {
     let one-line = measure(par(spacing: 0pt)[x]).height
-    let line-stride = measure(par(spacing: 0pt)[x#linebreak()x]).height - one-line
-    LINE_STRIDE.update(line-stride)
+    LINE_STRIDE.update(measure(par(spacing: 0pt)[x#linebreak()x]).height - one-line)
   }
 
   [#metadata((
     subject: subject,
-    original_date: actual_date,
-    original_from: first-or-value(memo_from),
-    body_font: body_font,
-    font_size: font_size,
-    memo_style: memo_style,
+    original-date: if date == none and date-field != none { none } else { actual-date },
+    original-from: first-or-value(memo-from),
+    body-font: body-font,
+    font-size: font-size,
+    memo-style: memo-style,
   )) <usaf-memo-config>]
 
-  render-date-section(actual_date, memo-style: memo_style)
-  render-for-section(memo_for, memo_for_cols)
-  if not falsey(memo_from) { render-from-section(memo_from) }
+  render-date-section(actual-date, memo-style: memo-style)
+  render-for-section(memo-for, memo-for-cols)
+  if not falsey(memo-from) { render-from-section(memo-from) }
   // Blank entries are dropped first so a stub `- ` left under `references:`
   // cannot pass as the lone reference and render an empty `()` after the subject.
   let refs = compact-references(references)

package/quills/usaf_memo/0.3.0/packages/tonguetoquill-usaf-memo/src/indorsement.typ

@@ -1,14 +1,8 @@
-// indorsement.typ: Indorsement rendering for USAF memorandum
+// An indorsement forwards a memorandum onward with the endorser's own
+// commentary and signature, per AFH 33-337 Chapter 14.
 //
-// This module implements indorsements (endorsements) per AFH 33-337 Chapter 14.
-// Indorsements are used to forward memorandums with additional commentary.
-// They follow the format: "1st Ind", "2d Ind", "3d Ind", etc.
-// Each indorsement includes its own body text and signature block.
-//
-// Note: When using #show: indorsement.with(...), the indorsement wraps the
-// entire remainder of the document. This works for a single indorsement at
-// the end of a file. For multiple indorsements, use the function call syntax:
-// #indorsement(...)[Body text...]
+// Call it as a function, `#indorsement(..)[Body]`. As a show rule it wraps the
+// whole remainder of the document, which leaves room for exactly one.
 
 #import "primitives.typ": *
 #import "body.typ": *
@@ -16,14 +10,17 @@
 #let indorsement(
   from: none,
   to: none,
-  signature_block: none,
-  signature_blank_lines: 4,
-  signing_field: none,
+  signature-block: none,
+  // An indorsement has a closing section of its own, so it takes an authority
+  // line on the same terms as the memorandum.
+  authority-line: none,
+  signature-blank-lines: 4,
+  signing-field: none,
   date: none,
   // Fill-in widget for an omitted `date`, anchored in the date slot of the
-  // indorsement header (see `date-placeholder-slot`). `none` leaves the slot
-  // blank.
-  date_field: none,
+  // indorsement header (see `date-placeholder-slot`). Without one the slot is
+  // ruled for a handwritten date.
+  date-field: none,
   // Format of indorsement: "standard" (same page), "informal" (no header), or "separate_page" (starts on new page)
   format: "standard",
   // Decision action. `none` (default) displays no action line at all.
@@ -35,10 +32,9 @@
   // in the chain) Approves / Disapproves, every coordinating official before
   // it Concurs / Nonconcurs. The caller owns this because only it can see
   // whether further indorsements follow.
-  approval_authority: false,
+  approval-authority: false,
   content,
-) = {
-  // Validate format parameter
+) = [#{
   assert(
     format in ("standard", "informal", "separate_page"),
     message: "format must be \"standard\", \"informal\", or \"separate_page\"",
@@ -50,62 +46,59 @@
   }
 
 
-  let actual_date = date
-  let ind_from = first-or-value(from)
-  let ind_for = to
+  let actual-date = date
+  let ind-from = first-or-value(from)
+  let ind-for = to
 
-  // An empty body (e.g. a KIND with only an action selected and no markdown
-  // body) collapses to zero rendered layout via render-body's filter. To
-  // make the "empty body takes no layout space" guarantee end-to-end, also
-  // suppress the spacing the surrounding code reserves *for* the body:
-  // the header→body gap (when no action is present) and the action→body
-  // trailing gap. Without this, an empty body still leaves an extra
-  // blank-line stride above the signature, pushing it off the AFH 33-337
-  // "fifth line below the last line of text" anchor.
-  // The plate calls indorsement with `[]` when the markdown body is empty
-  // or whitespace-only; comparing against `[]` reliably detects that.
-  let body_empty = content == []
+  // An empty body renders as zero layout through render-body's filter, so the
+  // spacing reserved *for* the body is suppressed too: the header→body gap
+  // (when no action is present) and the action→body trailing gap. Left in,
+  // they add a blank-line stride above the signature and push it off AFH
+  // 33-337's "fifth line below the last line of text" anchor.
+  //
+  // A caller with no body passes `[]`.
+  let body-empty = content == []
 
-  let effective_action = if action == none or type(action) != str or action.trim() == "" {
+  let effective-action = if action == none or type(action) != str or action.trim() == "" {
     none
   } else {
     action
   }
 
   if format != "informal" {
-    // Step the counter BEFORE the context block to avoid read-then-update loop
+    // Stepped outside the `context` below, which reads it: a step inside would
+    // read and update the same counter.
     counters.indorsement.step()
 
     context {
       let config = query(<usaf-memo-config>).first().value
-      let memo-style = config.at("memo_style", default: "usaf")
-      let original_subject = config.subject
-      let original_date = config.original_date
-      let original_from = config.original_from
+      let memo-style = config.at("memo-style", default: "usaf")
+      let original-subject = config.subject
+      let original-date = config.original-date
+      let original-from = config.original-from
 
-      // Read the counter value (already stepped above)
-      let indorsement_number = counters.indorsement.get().at(0, default: 1)
-      let indorsement_label = format-indorsement-number(indorsement_number)
+      let indorsement-number = counters.indorsement.get().at(0, default: 1)
+      let indorsement-label = format-indorsement-number(indorsement-number)
 
-      let ind_date = align(right)[#if actual_date != none { display-date(actual_date, memo-style: memo-style) } else { date-placeholder-slot(date_field) }]
+      let ind-date = align(right)[#if actual-date != none { display-date(actual-date, memo-style: memo-style) } else { date-placeholder-slot(field: date-field) }]
 
       // Separate-page header body: restates the original memo's identity (FROM,
       // date, subject) on its own line, since the indorsement no longer shares a
       // page with the action document. Rendered as a non-breakable, sticky unit
       // so it travels to the next page *with* the content it heads rather than
       // being stranded at the bottom of a page.
-      // `original_from` / `original_subject` are content fields, and a content
+      // `original-from` / `original-subject` are content fields, and a content
       // field lowers to a markup block whose newlines read as spaces in the
       // enclosing paragraph — mid-sentence that lands a stray space before the
       // following comma. `box` gives each its own paragraph context, where
       // Typst trims the edge spaces (the same treatment the inline reference
       // gets in `render-subject-section`), and keeps the phrase unbroken.
       let separate-page-body = block(breakable: false, sticky: true)[
-        #[#indorsement_label to #box(original_from), #display-date(original_date, memo-style: memo-style), #box(original_subject)]
+        #[#indorsement-label to #box(original-from), #if original-date != none [#display-date(original-date, memo-style: memo-style), ]#box(original-subject)]
         #blank-line()
-        #grid(columns: (auto, 1fr), ind_from, ind_date)
+        #grid(columns: (auto, 1fr), ind-from, ind-date)
         #blank-line()
-        #grid(columns: (auto, auto, 1fr), "MEMORANDUM FOR", "  ", ind_for)
+        #grid(columns: (auto, auto, 1fr), "MEMORANDUM FOR", "  ", ind-for)
       ]
 
       // Standard header: terse "Nth Ind, FROM    date" line, used when the
@@ -114,9 +107,9 @@
       // across a page boundary and never detach from the body/signature below.
       let standard-header = block(breakable: false, sticky: true)[
         #blank-line()
-        #grid(columns: (auto, 1fr), [#indorsement_label, #box(ind_from)], ind_date)
+        #grid(columns: (auto, 1fr), [#indorsement-label, #box(ind-from)], ind-date)
         #blank-line()
-        #grid(columns: (auto, auto, 1fr), "MEMORANDUM FOR", "  ", ind_for)
+        #grid(columns: (auto, auto, 1fr), "MEMORANDUM FOR", "  ", ind-for)
       ]
 
       if format == "separate_page" {
@@ -137,13 +130,7 @@
         // resolved position is at the top of its page, it was pushed; emit the
         // separate-page body (no extra pagebreak — we are already at page top).
         // Otherwise the header flows in place with the standard form.
-        let stride = {
-          let s = LINE_STRIDE.get()
-          if s == none {
-            let one-line = measure(par(spacing: 0pt)[x]).height
-            measure(par(spacing: 0pt)[x#linebreak()x]).height - one-line
-          } else { s }
-        }
+        let stride = line-stride()
         // here().position().y is the resolved flow position of this header. On a
         // continuation page the first content sits at the top margin; allow one
         // line stride of tolerance for baseline/rounding.
@@ -157,26 +144,31 @@
     }
     // Header→content gap. Skipped when there is neither an action line nor
     // body to follow — render-signature-block supplies its own 4-line gap.
-    if effective_action != none or not body_empty {
+    if effective-action != none or not body-empty {
       blank-line()
     }
   }
 
-  // Show action line only when an action decision is set (not `none`)
-  if effective_action != none {
+  if effective-action != none {
     render-action-line(
-      effective_action,
-      approval-authority: approval_authority,
-      trailing-blank-line: not body_empty,
+      effective-action,
+      approval-authority: approval-authority,
+      trailing-blank-line: not body-empty,
     )
   }
 
-  if not body_empty {
+  if not body-empty {
     context {
-      let memo-style = query(<usaf-memo-config>).first().value.at("memo_style", default: "usaf")
+      let memo-style = query(<usaf-memo-config>).first().value.at("memo-style", default: "usaf")
       render-body(content, memo-style: memo-style)
     }
   }
 
-  render-signature-block(signature_block, signature-blank-lines: signature_blank_lines, signing-field: signing_field)
-}
+  render-signature-block(
+    signature-block,
+    closing-line: format-authority-line(authority-line),
+    signature-blank-lines: signature-blank-lines,
+    signing-field: signing-field,
+  )
+  // Labelled so `mainmatter` can split the closing off the body; `split-closing`.
+}<usaf-memo-closing>]

package/quills/usaf_memo/0.3.0/packages/tonguetoquill-usaf-memo/src/lib.typ

@@ -1,52 +1,30 @@
-// lib.typ: Public API for USAF memorandum template
+// Public API of the USAF memorandum template, which typesets per AFH 33-337
+// "The Tongue and Quill" Chapter 14, "The Official Memorandum".
 //
-// This module provides a composable API for creating United States Air Force
-// memorandums that comply with AFH 33-337 "The Tongue and Quill" Chapter 14
-// "The Official Memorandum" formatting standards.
+// The four sections compose in document order: `frontmatter` and `mainmatter`
+// as show rules, `backmatter` and `indorsement` as functions, so any number of
+// indorsements may follow the memo they endorse.
 //
-// AFH 33-337 Chapter 14 specifies exact requirements for:
-// - Margins: 1 inch on all sides (§4)
-// - Font: 12pt Times New Roman (§5)
-// - Date placement: 1.75 inches from top, 1 inch from right (Date section)
-// - Heading elements: MEMORANDUM FOR, FROM, SUBJECT with 2-line spacing
-// - Paragraph numbering: Hierarchical 1., a., (1), (a) format (§2)
-// - Signature block: 4.5 inches from left, never orphaned (Signature Block section)
-// - Backmatter: Attachments, cc:, distribution with specific spacing
-//
-// Key features:
-// - Composable show rules for frontmatter and mainmatter
-// - Function-based backmatter and indorsements for correct ordering
-// - No global state - configuration flows through metadata
-// - Reusable primitives for common rendering tasks
-// - AFH 33-337 compliant formatting throughout
-//
-// Basic usage:
-//
-// #import "@preview/tonguetoquill-usaf-memo:3.0.0": frontmatter, mainmatter, backmatter, indorsement
+// #import "@preview/tonguetoquill-usaf-memo:5.0.0": (
+//   backmatter, frontmatter, indorsement, mainmatter,
+// )
 //
 // #show: frontmatter.with(
 //   subject: "Your Subject Here",
-//   memo_for: ("OFFICE/SYMBOL",),
-//   memo_from: ("YOUR/SYMBOL",),
-//   memo_style: "usaf", // "usaf" (default) or "daf"
+//   memo-for: ("OFFICE/SYMBOL",),
+//   memo-from: ("YOUR/SYMBOL",),
+//   memo-style: "usaf", // "usaf" (default) or "daf"
 // )
-//
 // #show: mainmatter
 //
-// Your memo body content here.
-// (USAF style auto-numbers per AFH 33-337; DAF style uses unnumbered
-// top-level paragraphs with fixed 0.5in first-line indentation)
+// Body paragraphs.
 //
-// #backmatter(
-//   signature_block: ("NAME, Rank, USAF", "Title"),
-//   attachments: (...),
-//   cc: (...),
-// )
+// #backmatter(signature-block: ("FIRST M. LAST, Maj, USAF", "Duty Title"))
 //
 // #indorsement(
 //   from: "ORG/SYMBOL",
 //   to: "RECIPIENT/SYMBOL",
-//   signature_block: ("NAME, Rank, USAF", "Title"),
+//   signature-block: ("FIRST M. LAST, Maj, USAF", "Duty Title"),
 // )[
 //   Indorsement content here.
 // ]

package/quills/usaf_memo/0.3.0/packages/tonguetoquill-usaf-memo/src/mainmatter.typ

@@ -1,27 +1,55 @@
-// mainmatter.typ: Mainmatter show rule for USAF memorandum
-//
-// This module implements the mainmatter (body text) of a USAF memorandum per
-// AFH 33-337 Chapter 14 "The Text of the Official Memorandum" (§1-12).
+// The memorandum body: AFH 33-337 "The Text of the Official Memorandum" §1-12.
 
 #import "body.typ": *
 
-/// Mainmatter show rule for USAF memorandum body content.
+/// Splits content at the first closing section: the part `render-body` numbers,
+/// and the part that reaches the page untouched.
 ///
-/// AFH 33-337 "The Text of the Official Memorandum" §1-12 requirements:
-/// - Begin text on second line below subject/references
-/// - Single-space text, double-space between paragraphs
-/// - Number and letter each paragraph/subparagraph
-/// - "A single paragraph is not numbered" (§2)
-/// - First paragraph flush left, never indented
+/// `render-body` rebuilds what it is given from a buffer of paragraphs, tables,
+/// and block quotes. A closing section through it loses the placement it is
+/// made of, and its surviving lines take body paragraph numbers. Applied as a
+/// show rule, `mainmatter` is handed those sections along with the body;
+/// `backmatter` and `indorsement` label their output to mark the boundary.
 ///
-/// Applies AFH 33-337 paragraph numbering and formatting to the main body
-/// of the memorandum. Automatically detects single vs. multiple paragraphs
-/// to comply with AFH 33-337 numbering requirements.
+/// Everything from the first marker on stays together, prose a caller wrote
+/// between two closing sections included.
 ///
-/// - content (content): The body content to render
+/// A marker is found on `it` itself, on a direct child, or inside the `styled`
+/// element that a `set` or `show` rule after `#show: mainmatter` wraps the
+/// remainder in; both halves come back under those styles. A marker a caller
+/// nested in a container of their own — a `block`, a `grid` cell — is not
+/// found. A closing section built in a code block or a loop is not nested:
+/// joining content extends the sequence on the left in place, so its marker
+/// stays a direct child.
+///
+/// - it (content): Content handed to `mainmatter`
+/// -> array: the body content and the closing content
+#let split-closing(it) = {
+  if it.at("label", default: none) == <usaf-memo-closing> { return ([], it) }
+  // `styled` is not a name in scope; its two fields identify it.
+  if it.has("child") and it.has("styles") {
+    let (body, closing) = split-closing(it.child)
+    let restyle = part => (it.func())(part, it.styles)
+    return (restyle(body), restyle(closing))
+  }
+  if not it.has("children") { return (it, []) }
+  let children = it.children
+  let boundary = children.position(child => child.at("label", default: none) == <usaf-memo-closing>)
+  if boundary == none { return (it, []) }
+  // `sum` over `join`: an empty half is `none` from a join and `[]` from this.
+  (children.slice(0, boundary).sum(default: []), children.slice(boundary).sum(default: []))
+}
+
+/// Show rule for the memorandum body, applying AFH 33-337 paragraph numbering
+/// in the style the frontmatter recorded.
+///
+/// - it (content): Body content
 /// -> content
-#let mainmatter(it) = context {
-  let config = query(<usaf-memo-config>).first().value
-  let memo-style = config.at("memo_style", default: "usaf")
-  render-body(it, memo-style: memo-style)
+#let mainmatter(it) = {
+  let (body, closing) = split-closing(it)
+  context {
+    let config = query(<usaf-memo-config>).first().value
+    render-body(body, memo-style: config.at("memo-style", default: "usaf"))
+  }
+  closing
 }