@airmark/quiver 0.28.0 → 0.29.0

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

@@ -0,0 +1,170 @@
+// indorsement.typ: Indorsement rendering for USAF memorandum
+//
+// 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...]
+
+#import "primitives.typ": *
+#import "body.typ": *
+
+#let indorsement(
+  from: none,
+  to: none,
+  signature_block: none,
+  signature_blank_lines: 4,
+  signing_field: none,
+  date: 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.
+  // Approval authority pair: "approve" or "disapprove" circles the selected
+  // option; "undecided" displays the pair with neither circled.
+  // Coordination pair: "concur" or "nonconcur" circles the selected option;
+  // "undecided_concur" displays the pair with neither circled.
+  action: none,
+  content,
+) = {
+  // Validate format parameter
+  assert(
+    format in ("standard", "informal", "separate_page"),
+    message: "format must be \"standard\", \"informal\", or \"separate_page\"",
+  )
+
+  if format != "informal" {
+    assert(from != none, message: "from is required")
+    assert(to != none, message: "to is required")
+  }
+
+
+  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 == []
+
+  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
+    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
+
+      // 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 ind_date = align(right)[#if actual_date != none { display-date(actual_date, memo-style: memo-style) } else { date-placeholder-line() }]
+
+      // 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
+      // 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)]
+        #blank-line()
+        #grid(columns: (auto, 1fr), ind_from, ind_date)
+        #blank-line()
+        #grid(columns: (auto, auto, 1fr), "MEMORANDUM FOR", "  ", ind_for)
+      ]
+
+      // Standard header: terse "Nth Ind, FROM    date" line, used when the
+      // indorsement stays on the same page as the action document. Same
+      // non-breakable + sticky treatment so the two header lines never split
+      // 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)
+        #blank-line()
+        #grid(columns: (auto, auto, 1fr), "MEMORANDUM FOR", "  ", ind_for)
+      ]
+
+      if format == "separate_page" {
+        // Explicit separate-page indorsement always begins on a fresh page.
+        pagebreak()
+        separate-page-body
+      } else {
+        // AFH 33-337: a standard indorsement that no longer fits on the action
+        // document's page moves to a separate page, where it carries the fuller
+        // separate-page identifying header (it has lost its visual link to the
+        // original). Auto-upgrade to that header when the indorsement is pushed
+        // to a new page, rather than printing the terse same-page header at the
+        // top of a continuation page where it no longer makes sense.
+        //
+        // Detection: because the header is a non-breakable, sticky unit, Typst
+        // moves it wholesale to the next page when it would not fit — so a
+        // pushed indorsement lands at the top content margin. If the header's
+        // 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 }
+        }
+        // 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.
+        let pushed-to-new-page = here().position().y <= spacing.margin + stride
+        if pushed-to-new-page {
+          separate-page-body
+        } else {
+          standard-header
+        }
+      }
+    }
+    // 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 {
+      blank-line()
+    }
+  }
+
+  // Show action line only when an action decision is set (not `none`)
+  if effective_action != none {
+    render-action-line(effective_action, trailing-blank-line: not body_empty)
+  }
+
+  if not body_empty {
+    context {
+      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)
+}

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

@@ -0,0 +1,57 @@
+// lib.typ: Public API for USAF memorandum template
+//
+// 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.
+//
+// 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
+//
+// #show: frontmatter.with(
+//   subject: "Your Subject Here",
+//   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)
+//
+// #backmatter(
+//   signature_block: ("NAME, Rank, USAF", "Title"),
+//   attachments: (...),
+//   cc: (...),
+// )
+//
+// #indorsement(
+//   from: "ORG/SYMBOL",
+//   to: "RECIPIENT/SYMBOL",
+//   signature_block: ("NAME, Rank, USAF", "Title"),
+// )[
+//   Indorsement content here.
+// ]
+
+#import "frontmatter.typ": frontmatter
+#import "mainmatter.typ": mainmatter
+#import "backmatter.typ": backmatter
+#import "indorsement.typ": indorsement

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

@@ -0,0 +1,27 @@
+// 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).
+
+#import "body.typ": *
+
+/// Mainmatter show rule for USAF memorandum body content.
+///
+/// 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
+///
+/// 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.
+///
+/// - content (content): The body content to render
+/// -> 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)
+}