@tonguetoquill/collection 0.2.3 → 0.2.5-beta.1

package/quills/usaf_memo/0.1.0/packages/tonguetoquill-usaf-memo/src/config.typ

@@ -1,63 +1,63 @@
-// config.typ: Configuration constants and defaults for USAF memorandum template
-//
-// This module defines core configuration values that implement AFH 33-337 Chapter 14
-// formatting requirements for official USAF memorandums.
-
-// =============================================================================
-// SPACING CONSTANTS
-// =============================================================================
-// AFH 33-337 specifies precise spacing requirements throughout Chapter 14
-
-#let spacing = (
-  line: .5em, // Internal line spacing for readability
-  line-height: .7em, // Base line height for spacing calculations
-  tab: 0.5in, // Tab stop for multi-column recipient alignment
-  margin: 1in, // AFH 33-337 §4: "Use 1-inch margins on the left, right and bottom"
-)
-
-// =============================================================================
-// TYPOGRAPHY DEFAULTS
-// =============================================================================
-// AFH 33-337 §5: "Use 12 point Times New Roman font for text"
-
-#let DEFAULT_LETTERHEAD_FONTS = ("Copperplate CC",)
-#let DEFAULT_BODY_FONTS = ("times new roman", "NimbusRomNo9L")  // AFH 33-337 §5: Times New Roman required
-#let LETTERHEAD_COLOR = rgb("#000099")  // Standard USAF blue for letterhead
-
-// =============================================================================
-// PARAGRAPH CONFIGURATION
-// =============================================================================
-// AFH 33-337 "The Text of the Official Memorandum" §2:
-// "Number and letter each paragraph and subparagraph"
-// Hierarchical numbering: 1., a., (1), (a), etc.
-
-#let paragraph-config = (
-  counter-prefix: "par-counter-",
-  // AFH 33-337 §2: Hierarchical paragraph numbering format
-  // Level 0: 1., 2., 3. | Level 1: a., b., c. | Level 2: (1), (2), (3) | Level 3: (a), (b), (c)
-  numbering-formats: ("1.", "a.", "(1)", "(a)", n => underline(str(n)), n => underline(str(n))),
-)
-
-// =============================================================================
-// COUNTERS
-// =============================================================================
-
-#let counters = (
-  indorsement: counter("indorsement"),
-)
-
-// =============================================================================
-// CLASSIFICATION COLORS
-// =============================================================================
-// AFH 33-337 §3: "Follow AFI 31-401, Information Security Program Management,
-// applicable executive orders and DoD guidance for the necessary markings on
-// classified correspondence."
-// Color values follow DoD standard classification marking colors
-// Source: https://security.stackexchange.com/questions/161829
-
-#let CLASSIFICATION_COLORS = (
-  "UNCLASSIFIED": rgb(0, 122, 51), // Forest green (#007A33)
-  "CONFIDENTIAL": rgb(0, 51, 160), // Deep blue (#0033A0)
-  "SECRET": rgb(200, 16, 46), // Crimson red (#C8102E)
-  "TOP SECRET": rgb(255, 103, 31), // Burnt orange (#FF671F)
-)
+// config.typ: Configuration constants and defaults for USAF memorandum template
+//
+// This module defines core configuration values that implement AFH 33-337 Chapter 14
+// formatting requirements for official USAF memorandums.
+
+// =============================================================================
+// SPACING CONSTANTS
+// =============================================================================
+// AFH 33-337 specifies precise spacing requirements throughout Chapter 14
+
+#let spacing = (
+  line: .5em, // Internal line spacing for readability
+  line-height: .7em, // Base line height for spacing calculations
+  tab: 0.5in, // Tab stop for multi-column recipient alignment
+  margin: 1in, // AFH 33-337 §4: "Use 1-inch margins on the left, right and bottom"
+)
+
+// =============================================================================
+// TYPOGRAPHY DEFAULTS
+// =============================================================================
+// AFH 33-337 §5: "Use 12 point Times New Roman font for text"
+
+#let DEFAULT_LETTERHEAD_FONTS = ("Copperplate CC",)
+#let DEFAULT_BODY_FONTS = ("times new roman", "NimbusRomNo9L")  // AFH 33-337 §5: Times New Roman required
+#let LETTERHEAD_COLOR = rgb("#000099")  // Standard USAF blue for letterhead
+
+// =============================================================================
+// PARAGRAPH CONFIGURATION
+// =============================================================================
+// AFH 33-337 "The Text of the Official Memorandum" §2:
+// "Number and letter each paragraph and subparagraph"
+// Hierarchical numbering: 1., a., (1), (a), etc.
+
+#let paragraph-config = (
+  counter-prefix: "par-counter-",
+  // AFH 33-337 §2: Hierarchical paragraph numbering format
+  // Level 0: 1., 2., 3. | Level 1: a., b., c. | Level 2: (1), (2), (3) | Level 3: (a), (b), (c)
+  numbering-formats: ("1.", "a.", "(1)", "(a)", n => underline(str(n)), n => underline(str(n))),
+)
+
+// =============================================================================
+// COUNTERS
+// =============================================================================
+
+#let counters = (
+  indorsement: counter("indorsement"),
+)
+
+// =============================================================================
+// CLASSIFICATION COLORS
+// =============================================================================
+// AFH 33-337 §3: "Follow AFI 31-401, Information Security Program Management,
+// applicable executive orders and DoD guidance for the necessary markings on
+// classified correspondence."
+// Color values follow DoD standard classification marking colors
+// Source: https://security.stackexchange.com/questions/161829
+
+#let CLASSIFICATION_COLORS = (
+  "UNCLASSIFIED": rgb(0, 122, 51), // Forest green (#007A33)
+  "CONFIDENTIAL": rgb(0, 51, 160), // Deep blue (#0033A0)
+  "SECRET": rgb(200, 16, 46), // Crimson red (#C8102E)
+  "TOP SECRET": rgb(255, 103, 31), // Burnt orange (#FF671F)
+)

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

@@ -1,114 +1,114 @@
-// 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
-
-#import "primitives.typ": *
-
-#let frontmatter(
-  subject: none,
-  memo_for: none,
-  memo_from: none,
-  date: none,
-  references: none,
-  letterhead_title: "DEPARTMENT OF THE AIR FORCE",
-  letterhead_caption: "[YOUR SQUADRON/UNIT NAME]",
-  letterhead_seal: none,
-  letterhead_font: DEFAULT_LETTERHEAD_FONTS,
-  body_font: DEFAULT_BODY_FONTS,
-  font_size: 12pt,
-  memo_for_cols: 3,
-  classification_level: none,
-  footer_tag_line: none,
-  auto_numbering: true,
-  it,
-) = {
-  assert(subject != none, message: "subject is required")
-  assert(memo_for != none, message: "memo_for is required")
-  assert(memo_from != none, message: "memo_from is required")
-
-  let actual_date = if date == none { datetime.today() } else { date }
-  let classification_color = get-classification-level-color(classification_level)
-
-  // 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)
-
-  set page(
-    paper: "us-letter",
-    // AFH 33-337 §4: "Use 1-inch margins on the left, right and bottom"
-    margin: (
-      left: spacing.margin,
-      right: spacing.margin,
-      top: spacing.margin,
-      bottom: spacing.margin,
-    ),
-    header: {
-      // AFH 33-337 "Page numbering" §12: "The first page of a memorandum is never numbered.
-      // Number the succeeding pages starting with page 2. Place page numbers 0.5-inch from
-      // the top of the page, flush with the right margin."
-      context if counter(page).get().first() > 1 {
-        place(
-          dy: +.5in,
-          block(
-            width: 100%,
-            align(right, text(12pt)[#counter(page).display()]),
-          ),
-        )
-      }
-
-      if classification_level != none {
-        place(
-          top + center,
-          dy: 0.375in,
-          text(12pt, font: DEFAULT_BODY_FONTS, fill: classification_color)[#strong(classification_level)],
-        )
-      }
-    },
-    footer: {
-      place(
-        bottom + center,
-        dy: -.375in,
-        text(12pt, font: DEFAULT_BODY_FONTS, fill: classification_color)[#strong(classification_level)],
-      )
-
-      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]
-          ],
-        )
-      }
-    },
-  )
-
-  render-letterhead(letterhead_title, letterhead_caption, letterhead_seal, letterhead_font)
-
-  // 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)
-
-  render-date-section(actual_date)
-  render-for-section(memo_for, memo_for_cols)
-  render-from-section(memo_from)
-  render-subject-section(subject)
-  render-references-section(references)
-
-  metadata((
-    subject: subject,
-    original_date: actual_date,
-    original_from: first-or-value(memo_from),
-    body_font: body_font,
-    font_size: font_size,
-    auto_numbering: auto_numbering,
-  ))
-
-  it
-}
+// 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
+
+#import "primitives.typ": *
+
+#let frontmatter(
+  subject: none,
+  memo_for: none,
+  memo_from: none,
+  date: none,
+  references: none,
+  letterhead_title: "DEPARTMENT OF THE AIR FORCE",
+  letterhead_caption: "[YOUR SQUADRON/UNIT NAME]",
+  letterhead_seal: none,
+  letterhead_font: DEFAULT_LETTERHEAD_FONTS,
+  body_font: DEFAULT_BODY_FONTS,
+  font_size: 12pt,
+  memo_for_cols: 3,
+  classification_level: none,
+  footer_tag_line: none,
+  auto_numbering: true,
+  it,
+) = {
+  assert(subject != none, message: "subject is required")
+  assert(memo_for != none, message: "memo_for is required")
+  assert(memo_from != none, message: "memo_from is required")
+
+  let actual_date = if date == none { datetime.today() } else { date }
+  let classification_color = get-classification-level-color(classification_level)
+
+  // 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)
+
+  set page(
+    paper: "us-letter",
+    // AFH 33-337 §4: "Use 1-inch margins on the left, right and bottom"
+    margin: (
+      left: spacing.margin,
+      right: spacing.margin,
+      top: spacing.margin,
+      bottom: spacing.margin,
+    ),
+    header: {
+      // AFH 33-337 "Page numbering" §12: "The first page of a memorandum is never numbered.
+      // Number the succeeding pages starting with page 2. Place page numbers 0.5-inch from
+      // the top of the page, flush with the right margin."
+      context if counter(page).get().first() > 1 {
+        place(
+          dy: +.5in,
+          block(
+            width: 100%,
+            align(right, text(12pt)[#counter(page).display()]),
+          ),
+        )
+      }
+
+      if classification_level != none {
+        place(
+          top + center,
+          dy: 0.375in,
+          text(12pt, font: DEFAULT_BODY_FONTS, fill: classification_color)[#strong(classification_level)],
+        )
+      }
+    },
+    footer: {
+      place(
+        bottom + center,
+        dy: -.375in,
+        text(12pt, font: DEFAULT_BODY_FONTS, fill: classification_color)[#strong(classification_level)],
+      )
+
+      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]
+          ],
+        )
+      }
+    },
+  )
+
+  render-letterhead(letterhead_title, letterhead_caption, letterhead_seal, letterhead_font)
+
+  // 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)
+
+  render-date-section(actual_date)
+  render-for-section(memo_for, memo_for_cols)
+  render-from-section(memo_from)
+  render-subject-section(subject)
+  render-references-section(references)
+
+  metadata((
+    subject: subject,
+    original_date: actual_date,
+    original_from: first-or-value(memo_from),
+    body_font: body_font,
+    font_size: font_size,
+    auto_numbering: auto_numbering,
+  ))
+
+  it
+}

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

@@ -1,118 +1,118 @@
-// 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,
-  attachments: none,
-  cc: none,
-  date: none,
-  // Format of indorsement: "standard" (same page), "informal" (no header), or "separate_page" (starts on new page)
-  format: "standard",
-  // Show the APPROVED / DISAPPROVED action line. Default: false.
-  show_action: false,
-  // Approval decision: none (no decision), "approved", or "disapproved".
-  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 = if date == none { datetime.today() } else { date }
-  let ind_from = first-or-value(from)
-  let ind_for = to
-
-  if format != "informal" {
-    // Step the counter BEFORE the context block to avoid read-then-update loop
-    counters.indorsement.step()
-
-    context {
-      let config = query(metadata).last().value
-      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)
-
-      if format == "separate_page" {
-        pagebreak()
-        [#indorsement_label to #original_from, #display-date(original_date), #original_subject]
-
-        blank-line()
-        grid(
-          columns: (auto, 1fr),
-          ind_from, align(right)[#display-date(actual_date)],
-        )
-
-        blank-line()
-        grid(
-          columns: (auto, auto, 1fr),
-          "MEMORANDUM FOR", "  ", ind_for,
-        )
-      } else {
-        blank-line()
-        grid(
-          columns: (auto, 1fr),
-          [#indorsement_label, #ind_from], align(right)[#display-date(actual_date)],
-        )
-
-        blank-line()
-        grid(
-          columns: (auto, auto, 1fr),
-          "MEMORANDUM FOR", "  ", ind_for,
-        )
-      }
-    }
-    blank-line()
-  }
-
-  // Show action line if explicitly requested or if an action decision is set
-  if show_action or action != none {
-    render-action-line(action)
-  }
-
-  render-body(content)
-
-  render-signature-block(signature_block, signature-blank-lines: signature_blank_lines)
-
-  if not falsey(attachments) {
-    calculate-backmatter-spacing(true)
-    let attachment-count = attachments.len()
-    let section-label = if attachment-count == 1 { "Attachment:" } else { str(attachment-count) + " Attachments:" }
-    let continuation-label = (
-      (if attachment-count == 1 { "Attachment" } else { str(attachment-count) + " Attachments" })
-        + " (listed on next page):"
-    )
-    render-backmatter-section(attachments, section-label, numbering-style: "1.", continuation-label: continuation-label)
-  }
-
-  if not falsey(cc) {
-    calculate-backmatter-spacing(falsey(attachments))
-    render-backmatter-section(cc, "cc:")
-  }
-}
+// 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,
+  attachments: none,
+  cc: none,
+  date: none,
+  // Format of indorsement: "standard" (same page), "informal" (no header), or "separate_page" (starts on new page)
+  format: "standard",
+  // Show the APPROVED / DISAPPROVED action line. Default: false.
+  show_action: false,
+  // Approval decision: none (no decision), "approved", or "disapproved".
+  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 = if date == none { datetime.today() } else { date }
+  let ind_from = first-or-value(from)
+  let ind_for = to
+
+  if format != "informal" {
+    // Step the counter BEFORE the context block to avoid read-then-update loop
+    counters.indorsement.step()
+
+    context {
+      let config = query(metadata).last().value
+      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)
+
+      if format == "separate_page" {
+        pagebreak()
+        [#indorsement_label to #original_from, #display-date(original_date), #original_subject]
+
+        blank-line()
+        grid(
+          columns: (auto, 1fr),
+          ind_from, align(right)[#display-date(actual_date)],
+        )
+
+        blank-line()
+        grid(
+          columns: (auto, auto, 1fr),
+          "MEMORANDUM FOR", "  ", ind_for,
+        )
+      } else {
+        blank-line()
+        grid(
+          columns: (auto, 1fr),
+          [#indorsement_label, #ind_from], align(right)[#display-date(actual_date)],
+        )
+
+        blank-line()
+        grid(
+          columns: (auto, auto, 1fr),
+          "MEMORANDUM FOR", "  ", ind_for,
+        )
+      }
+    }
+    blank-line()
+  }
+
+  // Show action line if explicitly requested or if an action decision is set
+  if show_action or action != none {
+    render-action-line(action)
+  }
+
+  render-body(content)
+
+  render-signature-block(signature_block, signature-blank-lines: signature_blank_lines)
+
+  if not falsey(attachments) {
+    calculate-backmatter-spacing(true)
+    let attachment-count = attachments.len()
+    let section-label = if attachment-count == 1 { "Attachment:" } else { str(attachment-count) + " Attachments:" }
+    let continuation-label = (
+      (if attachment-count == 1 { "Attachment" } else { str(attachment-count) + " Attachments" })
+        + " (listed on next page):"
+    )
+    render-backmatter-section(attachments, section-label, numbering-style: "1.", continuation-label: continuation-label)
+  }
+
+  if not falsey(cc) {
+    calculate-backmatter-spacing(falsey(attachments))
+    render-backmatter-section(cc, "cc:")
+  }
+}