@tonguetoquill/collection 0.2.6 → 0.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonguetoquill/collection",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nibsbin/tonguetoquill-collection.git"

package/quills/af4141/0.1.0/example.md

@@ -1,36 +1,88 @@
 ---
 QUILL: af4141@0.1
-name: "DOE, JOHN A."
-unit: "1 CACS/DOT"
-grade: "GS-13"
-commanders_auth: "Verified by unit commander"
+# 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 CARDS
+     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 -->
 ---
 CARD: experience
-date: "2025-01-15"
-action: "Assigned to 1 CACS/DOT as Weapons Director"
-written_grade: "3"
-written_grade_date: "2025-01-20"
-positional_grade: "3"
-positional_grade_date: "2025-01-20"
+date: "15 Jan 25"
+action: "Assigned to 1 ACCS/DOT as Weapons Director"
+written_grade: ""
+written_grade_date: ""
+positional_grade: ""
+positional_grade_date: ""
 auth_or_remarks: "Initial assignment"
 ---
 
+<!-- Example 2: Written upgrade evaluation -->
 ---
 CARD: experience
-date: "2025-06-01"
-action: "Completed WD upgrade evaluation — certified Mission Ready"
-written_grade: "5"
-written_grade_date: "2025-06-10"
-positional_grade: "5"
-positional_grade_date: "2025-06-10"
+date: "15 Mar 25"
+action: "Completed written upgrade evaluation for 3-Level"
+written_grade: "3"
+written_grade_date: "15 Mar 25"
+positional_grade: ""
+positional_grade_date: ""
 auth_or_remarks: "Per AFMAN 13-1CRCV1"
 ---
 
+<!-- Example 3: Positional (live-environment) upgrade / certification -->
+---
+CARD: experience
+date: "20 Jun 25"
+action: "Certified Mission Ready — positional upgrade"
+written_grade: ""
+written_grade_date: ""
+positional_grade: "4"
+positional_grade_date: "20 Jun 25"
+auth_or_remarks: "SSgt Jones, T.R."
+---
+
+<!-- Example 4: Combined written + positional upgrade (both columns filled) -->
 ---
 CARD: experience
-date: "2025-09-15"
-action: "PCS to 726 ACS/DOT"
-auth_or_remarks: "Outprocessed 1 CACS"
----
+date: "1 Aug 25"
+action: "Upgrade evaluation — written and positional"
+written_grade: "4"
+written_grade_date: "1 Aug 25"
+positional_grade: "4"
+positional_grade_date: "1 Aug 25"
+auth_or_remarks: "Verified by unit commander"
+---
+
+<!-- Example 5: PCS departure — no grade columns needed -->
+---
+CARD: experience
+date: "1 Sep 25"
+action: "PCS to 726 ACS/MOC, Tinker AFB OK"
+written_grade: ""
+written_grade_date: ""
+positional_grade: ""
+positional_grade_date: ""
+auth_or_remarks: "Outprocessed 1 ACCS/DOT"
+---

package/quills/af4141/0.1.0/packages/typst-af4141/lib.typ

@@ -7,29 +7,60 @@
 #let FORM_MIN_TEXT_SIZE = 6pt
 #let FORM_MIN_CHARS_PER_LINE = 7
 
-/// Render a text-like field with word-wrapping and shrink-to-fit.
+/// Should this field shrink text to a single line rather than word-wrap?
+/// True for short/narrow fields with brief content (grades, ranks, dates).
+#let should-shrink-to-fit(display, width, height) = {
+  let aspect = width / height
+  let char-count = display.len()
+  char-count <= 10 or height < 20pt or aspect > 4.0
+}
+
+/// Render a text-like field with shrink-to-fit and word-wrap fallback.
 #let render-text-field(display, width, height, x-inset, y-inset) = {
   set par(leading: 0.25em)
   context {
+    let avail-w = width - 2 * x-inset
+    let avail-h = height - 2 * y-inset
+    let shrink = should-shrink-to-fit(display, width, height)
+
     let final-size = FORM_MIN_TEXT_SIZE
     let current = FORM_MAX_TEXT_SIZE
     let step = 0.5pt
 
-    // Find the largest font size that fits both horizontally and vertically
-    // and optionally leaves enough room for a minimum number of characters
     while current >= FORM_MIN_TEXT_SIZE {
-      let m = measure(block(width: width - 2 * x-inset, text(size: current, display)))
+      let m = if shrink {
+        // Measure as a single line (no width constraint → no wrapping)
+        measure(text(size: current, display))
+      } else {
+        // Measure with wrapping within the available width
+        measure(block(width: avail-w, text(size: current, display)))
+      }
       let char-m = measure(text(size: current, "0" * FORM_MIN_CHARS_PER_LINE))
 
-      if m.height <= height - 2 * y-inset and char-m.width <= width - 2 * x-inset {
+      if m.width <= avail-w and m.height <= avail-h and char-m.width <= avail-w {
         final-size = current
         break
       }
       current = current - step
     }
-    // Alignment: center vertically if it's a short box (likely single line),
-    // otherwise top-align for multi-line paragraphs.
-    let vert-align = if height < 24pt { horizon } else { top }
+
+    // Fallback: if shrink-to-fit hit min size and still overflows,
+    // re-try with word-wrap enabled as a last resort.
+    if shrink and current < FORM_MIN_TEXT_SIZE {
+      current = FORM_MAX_TEXT_SIZE
+      while current >= FORM_MIN_TEXT_SIZE {
+        let m = measure(block(width: avail-w, text(size: current, display)))
+        let char-m = measure(text(size: current, "0" * FORM_MIN_CHARS_PER_LINE))
+        if m.height <= avail-h and char-m.width <= avail-w {
+          final-size = current
+          break
+        }
+        current = current - step
+      }
+    }
+
+    // Default to vertically centered. Only top-align for tall "text areas".
+    let vert-align = if height >= 40pt { top } else { horizon }
 
     box(
       width: width,

package/templates/af4141.md

@@ -30,7 +30,7 @@ commanders_auth: ""
 <!-- Example 1: Initial assignment to a unit -->
 ---
 CARD: experience
-date: "15 Jan 2025"
+date: "15 Jan 25"
 action: "Assigned to 1 ACCS/DOT as Weapons Director"
 written_grade: ""
 written_grade_date: ""
@@ -42,10 +42,10 @@ auth_or_remarks: "Initial assignment"
 <!-- Example 2: Written upgrade evaluation -->
 ---
 CARD: experience
-date: "15 Mar 2025"
+date: "15 Mar 25"
 action: "Completed written upgrade evaluation for 3-Level"
 written_grade: "3"
-written_grade_date: "15 Mar 2025"
+written_grade_date: "15 Mar 25"
 positional_grade: ""
 positional_grade_date: ""
 auth_or_remarks: "Per AFMAN 13-1CRCV1"
@@ -54,31 +54,31 @@ auth_or_remarks: "Per AFMAN 13-1CRCV1"
 <!-- Example 3: Positional (live-environment) upgrade / certification -->
 ---
 CARD: experience
-date: "20 Jun 2025"
+date: "20 Jun 25"
 action: "Certified Mission Ready — positional upgrade"
 written_grade: ""
 written_grade_date: ""
 positional_grade: "4"
-positional_grade_date: "20 Jun 2025"
+positional_grade_date: "20 Jun 25"
 auth_or_remarks: "SSgt Jones, T.R."
 ---
 
 <!-- Example 4: Combined written + positional upgrade (both columns filled) -->
 ---
 CARD: experience
-date: "01 Aug 2025"
+date: "1 Aug 25"
 action: "Upgrade evaluation — written and positional"
 written_grade: "4"
-written_grade_date: "01 Aug 2025"
+written_grade_date: "1 Aug 25"
 positional_grade: "4"
-positional_grade_date: "01 Aug 2025"
+positional_grade_date: "1 Aug 25"
 auth_or_remarks: "Verified by unit commander"
 ---
 
 <!-- Example 5: PCS departure — no grade columns needed -->
 ---
 CARD: experience
-date: "01 Sep 2025"
+date: "1 Sep 25"
 action: "PCS to 726 ACS/MOC, Tinker AFB OK"
 written_grade: ""
 written_grade_date: ""