@airmark/quiver 0.18.0 → 0.20.0

package/README.md

@@ -74,7 +74,6 @@ quills/
     <x.y.z>/
       Quill.yaml
       plate.typ
-      example.md
       assets/
       packages/
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airmark/quiver",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Airmark Quiver — Air Force and DAF document Quills for Quillmark.",
   "type": "module",
   "exports": {
@@ -16,11 +16,12 @@
     "node": ">=24"
   },
   "devDependencies": {
-    "@quillmark/quiver": "^0.7.0",
-    "@quillmark/wasm": "^0.78.0"
+    "@quillmark/quiver": "^0.11.0",
+    "@quillmark/wasm": "^0.80.0"
   },
   "scripts": {
-    "test": "node --test quiver.test.js",
+    "test": "quiver test",
+    "preview": "quiver preview",
     "release:patch": "npm version patch -m \"chore(release): %s\" && git push --follow-tags",
     "release:minor": "npm version minor -m \"chore(release): %s\" && git push --follow-tags"
   },

package/quills/af4141/0.1.0/Quill.yaml

@@ -3,7 +3,6 @@ quill:
   version: 0.1.0
   backend: typst
   plate_file: plate.typ
-  example_file: example.md
   description: "AF Form 4141 — Individual's Record of Duties and Experience, Ground Environment Personnel"
 
 main:
@@ -28,7 +27,7 @@ main:
       type: string
       description: Commander's authentication entry on page 1.
 
-leaf_kinds:
+card_kinds:
   experience:
     description: Each card represents one row in the Record of Experience table. Rows fill page 1 (up to 16 rows) then page 2 (up to 21 rows), for a maximum of 37 rows.
     ui:

package/quills/af4141/0.1.0/plate.typ

@@ -35,14 +35,14 @@
 #if "grade" in data { vals.insert("commonforms_text_p1_3", data.grade) }
 #if "commanders_auth" in data { vals.insert("commonforms_text_p1_116", data.commanders_auth) }
 
-// --- Experience table rows from LEAVES ---
+// --- Experience table rows from CARDS ---
 // The form supports 16 rows on page 1 and 21 rows on page 2 (37 total).
 // Overflow rows are silently ignored.
 #let max-rows = 37
 #{
   let row = 0
-  for card in data.LEAVES {
-    if card.KIND == "experience" {
+  for card in data.CARDS {
+    if card.CARD == "experience" {
       if row < max-rows {
         for (col, key) in col-keys.enumerate() {
           let value = form-cell(card.at(key, default: none))

package/quills/daf1206/0.1.0/Quill.yaml

@@ -3,7 +3,6 @@ quill:
   version: 0.1.0
   backend: typst
   plate_file: plate.typ
-  example_file: example.md
   description: "DAF Form 1206 — Nomination for Award"
 
 main:
@@ -39,7 +38,7 @@ main:
     unit_commander_rank_name_and_telephone:
       type: string
 
-leaf_kinds:
+card_kinds:
   accomplishments_continued:
     description: Optional. Add this card only when page 2 overflow is required. Use the card body for continued bullets. Rank/name on page 2 matches the main nominee line automatically.
     ui:

package/quills/daf1206/0.1.0/plate.typ

@@ -38,8 +38,8 @@
 }
 
 #let continued-key = "SPECIFIC_ACCOMPLISHMENTS_Use_Performance_Statements_IAW_DAFMAN_362806_Continued"
-#for card in data.LEAVES {
-  if card.KIND == "accomplishments_continued" and continued-key not in vals and "BODY" in card {
+#for card in data.CARDS {
+  if card.CARD == "accomplishments_continued" and continued-key not in vals and "BODY" in card {
     vals.insert(continued-key, card.BODY)
   }
 }

package/quills/daf4392/0.1.0/Quill.yaml

@@ -3,7 +3,6 @@ quill:
   version: 0.1.0
   backend: typst
   plate_file: plate.typ
-  example_file: example.md
   description: "DAF Form 4392 - Pre-Departure Safety Briefing (Page 2)"
 
 main:
@@ -81,7 +80,7 @@ main:
       type: string
       description: "Put in your Emergency Contact's Phone Number."
 
-leaf_kinds:
+card_kinds:
   itinerary:
     description: "Each card represents one row in the travel itinerary table. Up to 10 rows are supported."
     ui:

package/quills/daf4392/0.1.0/plate.typ

@@ -29,14 +29,14 @@
 #tf(40pt, 100pt)[#show-date(data.at("departure_date", default: none))]
 #tf(123pt, 100pt)[#data.at("final_destination", default: "")]
 
-// Itinerary Rows (via LEAVES)
+// Itinerary Rows (via CARDS)
 #{
   let row = 0
   let dy-start = 160pt
   let dy-step = 40pt
-  if "LEAVES" in data {
-    for card in data.LEAVES {
-      if card.KIND == "itinerary" and row < 10 {
+  if "CARDS" in data {
+    for card in data.CARDS {
+      if card.CARD == "itinerary" and row < 10 {
         let dy = dy-start + (row * dy-step)
         tf(80pt, dy)[#show-date(card.at("date", default: none))]
         tf(135pt, dy)[#card.at("departure_point", default: "")]

package/quills/usaf_memo/0.2.0/Quill.yaml

@@ -3,7 +3,6 @@ quill:
   version: 0.2.0
   backend: typst
   plate_file: plate.typ
-  example_file: example.md
   description: U.S. Air Force and Space Force Official Memorandum
 
 main:
@@ -25,7 +24,7 @@ main:
 
     memo_from:
       type: array
-      required: true
+      default: []
       example:
         - ORG/SYMBOL
         - Organization Name
@@ -33,7 +32,7 @@ main:
         - City ST 12345-6789
       ui:
         group: Addressing
-      description: If recipients are on the same installation, use only the office symbol. For recipients on other installations, include the full mailing address to enable return correspondence.
+      description: "If recipients are on the same installation, use only the office symbol. For recipients on other installations, include the full mailing address to enable return correspondence. Omit entirely to produce a Memorandum for Record (no MEMO FROM line)."
 
     subject:
       type: string
@@ -182,7 +181,7 @@ main:
         compact: true
       description: "Optional marking appended after double slash (e.g. NF with classification CUI renders as CUI//NF). Leave blank to show only the classification with no //."
 
-leaf_kinds:
+card_kinds:
   indorsement:
     description: Chain of routing endorsements. Each endorsement block adds an official response or forwarding action to the original memo.
     ui:

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

@@ -31,7 +31,6 @@
 ) = {
   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")
   assert(
     memo_style in ("usaf", "daf"),
     message: "memo_style must be \"usaf\" or \"daf\"",
@@ -147,7 +146,7 @@
 
   render-date-section(actual_date, memo-style: memo_style)
   render-for-section(memo_for, memo_for_cols)
-  render-from-section(memo_from)
+  if not falsey(memo_from) { render-from-section(memo_from) }
   render-subject-section(subject)
   render-references-section(references)
 

package/quills/usaf_memo/0.2.0/packages/tonguetoquill-usaf-memo/src/primitives.typ

@@ -98,9 +98,9 @@
     "  ",
     align(left)[
       #if type(recipients) == array {
-        create-auto-grid(recipients, column-gutter: spacing.tab, cols: cols)
+        create-auto-grid(recipients.map(upper), column-gutter: spacing.tab, cols: cols)
       } else {
-        recipients
+        upper(recipients)
       }
     ],
   )
@@ -353,7 +353,9 @@
       (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)
+    // AFH 33-337: a single attachment is not numbered; numbering applies to two or more.
+    let numbering-style = if attachment-count == 1 { none } else { "1." }
+    render-backmatter-section(attachments, section-label, numbering-style: numbering-style, continuation-label: continuation-label)
   }
 
   if cc != none and cc.len() > 0 {

package/quills/usaf_memo/0.2.0/plate.typ

@@ -21,8 +21,8 @@
   // Receiver information
   memo_for: data.memo_for,
 
-  // Sender information
-  memo_from: data.memo_from,
+  // Sender information (omitted for Memorandum for Record)
+  ..if data.at("memo_from", default: ()).len() > 0 { (memo_from: data.memo_from) },
 
   // Subject line
   subject: data.subject,
@@ -69,9 +69,9 @@
   ..if "attachments" in data { (attachments: data.attachments) },
 )
 
-// Indorsements - iterate through LEAVES array and filter by KIND type
-#for (i, card) in data.LEAVES.enumerate() {
-  if card.KIND == "indorsement" {
+// Indorsements - iterate through CARDS array and filter by CARD tag
+#for (i, card) in data.CARDS.enumerate() {
+  if card.CARD == "indorsement" {
     // The quillmark helper leaves an unset/whitespace-only markdown body as
     // the empty string `""`; only non-empty bodies are eval'd into content.
     // Pass truly empty content (`[]`) in the empty case so indorsement can

package/quills/af4141/0.1.0/example.md

@@ -1,86 +0,0 @@
----
-QUILL: af4141@0.1
-# EDIT: Full name in Last, First, Middle Initial format
-name: "LAST, FIRST M."
-# EDIT: Unit of assignment (e.g., "1 ACCS/DOT", "726 ACS/MOC")
-unit: "UNIT/SYMBOL"
-# EDIT: Current grade or CCC level (e.g., "SSgt", "GS-12", "3")
-grade: "GRADE"
-# EDIT: Commander's authentication entry — often a commander's name/signature block or "Verified by unit commander"
-commanders_auth: ""
----
-
-<!-- ═══════════════════════════════════════════════════════════════
-     RECORD OF EXPERIENCE LEAVES
-     Each card below becomes one row in the experience table.
-     Page 1 holds up to 16 rows; Page 2 holds up to 21 rows (37 max).
-
-     Required reportable actions include:
-       • Initial/subsequent duty assignment
-       • Written and/or positional upgrade evaluations
-       • Certification events (Mission Ready, Senior Director, etc.)
-       • Downgrade or decertification
-       • PCS/PCA departure
-       • Temporary duty of significant duration
-       • Any other commander-directed entry
-
-     Leave blank any columns that do not apply to a given entry.
-═══════════════════════════════════════════════════════════════ -->
-
-<!-- Example 1: Initial assignment to a unit -->
----
-KIND: experience
-date: 2025-01-15
-action: "Assigned to 1 ACCS/DOT as Weapons Director"
-written_grade: ""
-written_grade_date: 2025-01-15
-positional_grade: ""
-positional_grade_date: 2025-01-15
-auth_or_remarks: "Initial assignment"
----
-
-<!-- Example 2: Written upgrade evaluation -->
----
-KIND: experience
-date: 2025-03-15
-action: "Completed written upgrade evaluation for 3-Level"
-written_grade: "3"
-written_grade_date: 2025-03-15
-positional_grade: ""
-positional_grade_date: 2025-03-15
-auth_or_remarks: "Per AFMAN 13-1CRCV1"
----
-
-<!-- Example 3: Positional (live-environment) upgrade / certification -->
----
-KIND: experience
-date: 2025-06-20
-action: "Certified Mission Ready — positional upgrade"
-written_grade: ""
-written_grade_date: 2025-06-20
-positional_grade: "4"
-positional_grade_date: 2025-06-20
-auth_or_remarks: "SSgt Jones, T.R."
----
-
-<!-- Example 4: Combined written + positional upgrade (both columns filled) -->
----
-KIND: experience
-date: 2025-08-01
-action: "Upgrade evaluation — written and positional"
-written_grade: "4"
-written_grade_date: 2025-08-01
-positional_grade: "4"
-positional_grade_date: 2025-08-01
-auth_or_remarks: "Verified by unit commander"
----
-
-<!-- Example 5: PCS departure — no written/positional grade; omit grade dates (or use "") -->
----
-KIND: experience
-date: 2025-09-01
-action: "PCS to 726 ACS/MOC, Tinker AFB OK"
-written_grade: ""
-positional_grade: ""
-auth_or_remarks: "Outprocessed 1 ACCS/DOT"
----

package/quills/daf1206/0.1.0/example.md

@@ -1,23 +0,0 @@
----
-QUILL: daf1206@0.1.0
-award: "CY2018 Stripes for Exceptional Performers II Board"
-category_if_applicable: "Senior Master Sgt"
-award_period: "N/A"
-rankname_of_nominee: "Smith, John Q., SMSgt"
-majcom_fldcom_foa_or_dru: "MAJCOM of Assignment"
-dafsc_duty_title: "3F071/NCOIC, 123rd Force Support Squadron"
-nominees_telephone_dsn_commercial: "DSN XXXX-XXXX, Comm (XXX) XXX-XXXX"
-unit_office_symbol_street_address_base_state_zip: "123 FSS/FMSPD, Someplace AFB, CO XXXXX"
-unit_commander_rank_name_and_telephone: "Lt Col Jane C. Doe, DSN XXX-XXXXXXX, Comm (XXX) XXX-XXXX"
----
-
-Use this main body for page 1 accomplishments.
-- Keep bullet format.
-- Replace all placeholder values.
-
----
-KIND: accomplishments_continued
----
-
-Use this card body only if page 2 overflow is needed.
-- Add continuation bullets here.

package/quills/daf4392/0.1.0/example.md

@@ -1,34 +0,0 @@
----
-QUILL: daf4392
-
-transportation_mode: "other"
-departure_date: 2026-03-26
-final_destination: "123 Sesame St, Fake City, MS"
-notes: "Visiting Donald Duck over 3 day weekend."
-organization: "333 TRS"
-briefed_date: 2026-03-25
-briefee_name: "Doe, Jane"
-briefee_grade: "O-1"
-briefer_name: ""
-briefer_grade: ""
-emergency_contact_name: "John Doe"
-emergency_contact_phone: "999-999-9999"
----
-
----
-KIND: itinerary
-date: 2026-03-26
-departure_point: "Biloxi, MS"
-arrival_point: "Fake City, MS"
-rest_length: "2 days"
-mileage: "250"
----
-
----
-KIND: itinerary
-date: 2026-03-29
-departure_point: "Fake City, MS"
-arrival_point: "Biloxi, MS"
-rest_length: "0"
-mileage: "0"
----

package/quills/usaf_memo/0.2.0/example.md

@@ -1,56 +0,0 @@
----
-# Essential 
-#===========
-QUILL: usaf_memo@0.2.0
-letterhead_title: DEPARTMENT OF THE AIR FORCE
-letterhead_caption:
-  - HEADQUARTERS YOUR UNIT NAME
-date: 2504-10-05
-memo_for:
-  - ORG/SYMBOL  # Organization/office symbol in UPPERCASE
-  # - DISTRIBUTION  # For numerous recipients, use 'DISTRIBUTION' and list them below
-memo_from:
-  - ORG/SYMBOL
-  - Organization Name 
-  - 123 Street Ave 
-  - City ST 12345-6789
-subject: Subject of the Memorandum 
-
-# Optional
-#===========
-references:
-  - AFM 33-326, 31 July 2019, Preparing Official Communications
-cc:
-  - ORG/SYMBOL
-distribution:
-  - 1st ORG/SYMBOL
-attachments:
-  - Attachment description, YYYY MMM DD
-signature_block:
-  - FIRST M. LAST, Rank, USAF
-  - Duty Title
-tag_line: Aim High
-classification: UNCLASSIFIED
----
-
-The `usaf_memo` Quill package takes care of all 33-337 formatting details. Focus on the content.
-
-**Numbering** Top-level paragraphs like this one are automatically numbered. NEVER manually number your paragraphs.
-
-- Use bullets for hierarchical paragraph nesting. These are automatically numbered or lettered as well.
-  - Up to five levels of paragraphs are supported
-
-Do not include a complimentary close (e.g. "Respectfully,") in official memorandums.
-
----
-KIND: indorsement
-for: ORG/SYMBOL
-format: standard
-from: ORG/SYMBOL
-action: undecided
-signature_block:
-  - FIRST M. LAST, Rank, USAF
-  - Duty Title
----
-
-This body and the metdata above are an indorsement card. Multiple or no indorsements leaves can be used.