@tonguetoquill/collection 0.1.19 → 0.2.1

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

@@ -0,0 +1,227 @@
+// Formalizer Engine – rendering engine
+// Renders pixel-perfect PDF form replicas from a PyMuPDF-extracted schema.
+
+/// Render a single field's content overlay.
+///
+/// - field-type (str): normalised lowercase type
+/// - value: user-supplied value for this field (or none)
+/// - width (length): field width
+/// - height (length): field height
+/// - field (dictionary): raw field entry from the schema
+#let render-field(field-type, value, width, height, field) = {
+  if field-type == "text" {
+    if value != none and str(value) != "" {
+      context {
+        let default-size = height * 0.6
+        let min-size = 6pt
+        let x-inset = 1.5pt
+        let m = measure(text(size: default-size, str(value)))
+        let scale = calc.min(1.0, (width - 2 * x-inset) / m.width)
+        let final-size = calc.max(min-size, default-size * scale)
+        box(
+          width: width,
+          height: height,
+          clip: true,
+          inset: (x: x-inset),
+          align(left + horizon, text(size: final-size, str(value))),
+        )
+      }
+    }
+  } else if field-type == "checkbox" {
+    if value == true {
+      box(
+        width: width,
+        height: height,
+        align(center + horizon, text(size: height * 0.8, "✓")),
+      )
+    }
+  } else if field-type == "radio" {
+    // value is true when this specific button is the selected one
+    // (resolved at group level before calling this helper)
+    if value == true {
+      let dot-r = calc.min(width, height) * 0.3
+      box(
+        width: width,
+        height: height,
+        align(center + horizon, circle(radius: dot-r, fill: black)),
+      )
+    }
+  } else if field-type == "combobox" or field-type == "listbox" {
+    let display = if value != none { str(value) } else { "" }
+    // Resolve export value → display label when options are present
+    if field.at("options", default: none) != none and value != none {
+      for opt in field.options {
+        if str(opt.at(0)) == str(value) {
+          display = str(opt.at(1))
+        }
+      }
+    }
+    if display != "" {
+      context {
+        let default-size = height * 0.6
+        let min-size = 6pt
+        let x-inset = 2pt
+        let m = measure(text(size: default-size, display))
+        let scale = calc.min(1.0, (width - 2 * x-inset) / m.width)
+        let final-size = calc.max(min-size, default-size * scale)
+        box(
+          width: width,
+          height: height,
+          clip: true,
+          inset: (x: x-inset),
+          align(left + horizon, text(size: final-size, display)),
+        )
+      }
+    }
+  }
+}
+
+/// Determine whether a single radio button should appear selected.
+///
+/// Strategy:
+///  1. If the field carries an `export_value` key, match against it.
+///  2. Otherwise fall back to matching the 0-based index within the group
+///     (stringified) against the supplied value.
+#let radio-button-selected(field, group-value, index-in-group) = {
+  if group-value == none { return false }
+  let ev = field.at("export_value", default: none)
+  if ev != none {
+    return str(ev) == str(group-value)
+  }
+  // Fallback: match against the stringified index
+  str(index-in-group) == str(group-value)
+}
+
+/// Draw a debug overlay rectangle with a label for a field.
+///
+/// - field-type (str): normalised lowercase type
+/// - name (str): field name
+/// - width (length): field width
+/// - height (length): field height
+#let debug-overlay(field-type, name, width, height) = {
+  let color = if field-type == "text" {
+    rgb(0, 0, 255, 40%)
+  } else if field-type == "checkbox" {
+    rgb(0, 128, 0, 40%)
+  } else if field-type == "radio" {
+    rgb(255, 165, 0, 40%)
+  } else if field-type == "combobox" {
+    rgb(128, 0, 128, 40%)
+  } else if field-type == "listbox" {
+    rgb(0, 128, 128, 40%)
+  } else {
+    rgb(128, 128, 128, 40%)
+  }
+
+  let stroke-color = if field-type == "text" {
+    rgb(0, 0, 255)
+  } else if field-type == "checkbox" {
+    rgb(0, 128, 0)
+  } else if field-type == "radio" {
+    rgb(255, 165, 0)
+  } else if field-type == "combobox" {
+    rgb(128, 0, 128)
+  } else if field-type == "listbox" {
+    rgb(0, 128, 128)
+  } else {
+    rgb(128, 128, 128)
+  }
+
+  // Insert zero-width spaces after _ and - so the label can wrap
+  let breakable-name = name.replace("_", "_\u{200B}").replace("-", "-\u{200B}")
+  let label = breakable-name + " [" + field-type + "]"
+
+  box(width: width, height: height, {
+    // Semi-transparent colored background
+    rect(width: 100%, height: 100%, fill: color, stroke: 0.5pt + stroke-color)
+    // Label in top-left — uses block so text wraps within field width
+    place(
+      top + left,
+      dx: 1pt,
+      dy: 1pt,
+      block(
+        width: calc.max(width - 2pt, 10pt),
+        fill: white,
+        inset: (x: 2pt, y: 1pt),
+        radius: 2pt,
+        stroke: 0.3pt + stroke-color,
+        breakable: false,
+        text(size: 5pt, fill: stroke-color, weight: "bold", label),
+      ),
+    )
+  })
+}
+
+/// Main entry point.
+///
+/// - schema (dictionary): result of `json("FIELDS.json")`
+/// - backgrounds (array): list of image paths / bytes, one per page
+/// - values (dictionary): field name → value; omit to render blank
+/// - debug (bool): when true, draw colored overlays on each field
+#let render-form(schema: none, backgrounds: (), values: (:), debug: false) = {
+  assert(schema != none, message: "render-form: `schema` is required")
+  assert(backgrounds.len() > 0, message: "render-form: `backgrounds` is required")
+  let pages = schema.pages
+  let fields = schema.fields
+
+  // Track how many radio buttons we have seen per group so far
+  let radio-counters = (:)
+
+  for (i, page-info) in pages.enumerate() {
+    let page-num = i + 1
+    let page-fields = fields.filter(f => f.page == page-num)
+
+    let bg = backgrounds.at(i)
+    let pw = page-info.width * 1pt
+    let ph = page-info.height * 1pt
+
+    page(
+      width: pw,
+      height: ph,
+      margin: 0pt,
+    )[
+      // Background image (the original PDF page rasterised as PNG)
+      #place(top + left, image(bg, width: pw, height: ph, fit: "stretch"))
+
+      // Field overlays
+      #for field in page-fields.filter(f => ("text", "checkbox", "radio", "combobox", "listbox").contains(lower(
+        f.type,
+      ))) {
+        let x = field.bbox.at(0) * 1pt
+        let y = field.bbox.at(1) * 1pt
+        let w = (field.bbox.at(2) - field.bbox.at(0)) * 1pt
+        let h = (field.bbox.at(3) - field.bbox.at(1)) * 1pt
+
+        let field-type = lower(field.type)
+        let val = values.at(field.name, default: none)
+
+        // --- Radio: resolve group-level value to per-button boolean ---
+        if field-type == "radio" {
+          let group-name = field.name
+          let idx = radio-counters.at(group-name, default: 0)
+          radio-counters.insert(group-name, idx + 1)
+          val = radio-button-selected(field, val, idx)
+        }
+
+        place(
+          top + left,
+          dx: x,
+          dy: y,
+          render-field(field-type, val, w, h, field),
+        )
+
+        if debug {
+          place(
+            top + left,
+            dx: x,
+            dy: y,
+            debug-overlay(field-type, field.name, w, h),
+          )
+        }
+
+        // Zero-width fence to break PDF viewer text-selection grouping
+        place(top + left, dx: x, dy: y, text(size: 0.001pt, "\u{FEFF}"))
+      }
+    ]
+  }
+}

package/quills/af4141/0.1.0/packages/typst-af4141/typst.toml

@@ -0,0 +1,7 @@
+[package]
+name = "typst-af4141"
+version = "0.1.0"
+entrypoint = "form.typ"
+authors = ["formalizer"]
+license = "Apache-2.0"
+description = "Fillable form package generated by formalizer"

package/quills/af4141/0.1.0/plate.typ

@@ -0,0 +1,48 @@
+#import "@local/quillmark-helper:0.1.0": data
+#import "@local/typst-af4141:0.1.0": form
+
+// Column order within each 7-field row group
+#let col-keys = (
+  "date",
+  "action",
+  "written_grade",
+  "written_grade_date",
+  "positional_grade",
+  "positional_grade_date",
+  "auth_or_remarks",
+)
+
+// Build the values dictionary for the form
+#let vals = (:)
+
+// --- Admin fields (page 1 header) ---
+#if "name" in data { vals.insert("commonforms_text_p1_1", data.name) }
+#if "unit" in data { vals.insert("commonforms_text_p1_2", data.unit) }
+#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 cards ---
+#{
+  let row = 0
+  for card in data.CARDS {
+    if card.CARD == "experience" {
+      for (col, key) in col-keys.enumerate() {
+        let value = card.at(key, default: "")
+        if value != "" {
+          let field-name = if row < 16 {
+            // Page 1: fields start at index 4, stride 7
+            "commonforms_text_p1_" + str(4 + row * 7 + col)
+          } else {
+            // Page 2: fields start at index 1, stride 7
+            "commonforms_text_p2_" + str(1 + (row - 16) * 7 + col)
+          }
+          vals.insert(field-name, value)
+        }
+      }
+      row = row + 1
+    }
+  }
+}
+
+// Render the form with assembled values
+#form(..vals)

package/quills/classic_resume/0.1.0/plate.typ

@@ -1,5 +1,5 @@
 #import "@local/quillmark-helper:0.1.0": data, eval-markup, parse-date
-#import "@preview/ttq-classic-resume:0.1.0": *
+#import "@local/ttq-classic-resume:0.1.0": *
 
 #show: resume
 

package/quills/cmu_letter/0.1.0/plate.typ

@@ -1,5 +1,5 @@
 #import "@local/quillmark-helper:0.1.0": data, eval-markup, parse-date
-#import "@preview/tonguetoquill-cmu-letter:0.1.0": backmatter, frontmatter, mainmatter
+#import "@local/tonguetoquill-cmu-letter:0.1.0": backmatter, frontmatter, mainmatter
 
 #show: frontmatter.with(
   wordmark: image("assets/cmu-wordmark.svg"),

package/quills/usaf_memo/0.1.0/plate.typ

@@ -1,5 +1,5 @@
 #import "@local/quillmark-helper:0.1.0": data, eval-markup, parse-date
-#import "@preview/tonguetoquill-usaf-memo:1.0.0": backmatter, frontmatter, indorsement, mainmatter
+#import "@local/tonguetoquill-usaf-memo:1.0.0": backmatter, frontmatter, indorsement, mainmatter
 
 // Frontmatter configuration
 #show: frontmatter.with(

package/quills/usaf_memo/0.2.0/plate.typ

@@ -1,5 +1,5 @@
 #import "@local/quillmark-helper:0.1.0": data, eval-markup, parse-date
-#import "@preview/tonguetoquill-usaf-memo:2.0.0": backmatter, frontmatter, indorsement, mainmatter
+#import "@local/tonguetoquill-usaf-memo:2.0.0": backmatter, frontmatter, indorsement, mainmatter
 
 // Frontmatter configuration
 #show: frontmatter.with(

package/templates/af4141.md

@@ -0,0 +1,88 @@
+---
+QUILL: af4141@0.1
+# EDIT: Full name in Last, First, Middle Initial format
+name: !fill "LAST, FIRST M."
+# EDIT: Unit of assignment (e.g., "1 ACCS/DOT", "726 ACS/MOC")
+unit: !fill "UNIT/SYMBOL"
+# EDIT: Current grade or CCC level (e.g., "SSgt", "GS-12", "3")
+grade: !fill "GRADE"
+# EDIT: Commander's authentication entry — often a commander's name/signature block or "Verified by unit commander"
+commanders_auth: !fill ""
+---
+
+<!-- ═══════════════════════════════════════════════════════════════
+     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: "15 Jan 2025"
+action: "Assigned to {:UNIT/SYMBOL:} as {:Duty Title:}"
+written_grade: ""
+written_grade_date: ""
+positional_grade: ""
+positional_grade_date: ""
+auth_or_remarks: "Initial assignment"
+---
+
+<!-- Example 2: Written upgrade evaluation -->
+---
+CARD: experience
+date: "{:DD Mon YYYY:}"
+action: "Completed written upgrade evaluation for {:position/level:}"
+written_grade: "{:1–5:}"
+written_grade_date: "{:DD Mon YYYY:}"
+positional_grade: ""
+positional_grade_date: ""
+auth_or_remarks: "Per {:AFMAN 13-1CRCV1 or applicable directive:}"
+---
+
+<!-- Example 3: Positional (live-environment) upgrade / certification -->
+---
+CARD: experience
+date: "{:DD Mon YYYY:}"
+action: "Certified {:Mission Ready / Senior Director / etc.:} — positional upgrade"
+written_grade: ""
+written_grade_date: ""
+positional_grade: "{:1–5:}"
+positional_grade_date: "{:DD Mon YYYY:}"
+auth_or_remarks: "{:Evaluator name or directive:}"
+---
+
+<!-- Example 4: Combined written + positional upgrade (both columns filled) -->
+---
+CARD: experience
+date: "{:DD Mon YYYY:}"
+action: "Upgrade evaluation — written and positional"
+written_grade: "{:1–5:}"
+written_grade_date: "{:DD Mon YYYY:}"
+positional_grade: "{:1–5:}"
+positional_grade_date: "{:DD Mon YYYY:}"
+auth_or_remarks: "{:Authentication / remarks:}"
+---
+
+<!-- Example 5: PCS departure — no grade columns needed -->
+---
+CARD: experience
+date: "{:DD Mon YYYY:}"
+action: "PCS to {:next unit/location:}"
+written_grade: ""
+written_grade_date: ""
+positional_grade: ""
+positional_grade_date: ""
+auth_or_remarks: "Outprocessed {:UNIT/SYMBOL:}"
+---

package/templates/loc.md

@@ -43,7 +43,7 @@ signature_block: SUBJECT FIRST M. LAST, RANK, USAF
 ---
 
 <!-- EDIT: First Indorsement: Subject acknowledges receipt of the LOC -->
-I acknowledge receipt and understanding of this letter on ________________ at ___________ hours. I understand that I have 3 duty days from the date I received this letter to provide a response and that I must include in my response any comments or documents I wish to be considered concerning this Letter of Counseling.
+I acknowledge receipt and understanding of this letter on {:date and time:}. I understand that I have 3 duty days from the date I received this letter to provide a response and that I must include in my response any comments or documents I wish to be considered concerning this Letter of Counseling.
 
 ---
 CARD: indorsement
@@ -76,4 +76,4 @@ date: "Date: _____________"
 ---
 
 <!-- EDIT: Fourth Indorsement: Subject acknowledges final decision -->
-I acknowledge receipt of the final decision regarding disposition of this Letter of Counseling on ____________ at __________ hours.
+I acknowledge receipt of the final decision regarding disposition of this Letter of Counseling on {:date and time:}.

package/templates/templates.json

@@ -40,5 +40,11 @@
 		"description": "USAF special pass request memorandum template",
 		"file": "pass_request.md",
 		"production": true
+	},
+	{
+		"name": "AF Form 4141",
+		"description": "Individual's Record of Duties and Experience, Ground Environment Personnel",
+		"file": "af4141.md",
+		"production": true
 	}
 ]