@airmark/quiver 0.1.0

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

@@ -0,0 +1,270 @@
+// Formalizer Engine – rendering engine
+// Renders pixel-perfect PDF form replicas from a PyMuPDF-extracted schema.
+
+/// Global configuration for text rendering.
+/// Adjust these to change the overall form text appearance.
+#let FORM_MAX_TEXT_SIZE = 14pt
+#let FORM_MIN_TEXT_SIZE = 6pt
+#let FORM_MIN_CHARS_PER_LINE = 7
+
+/// 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
+
+    while current >= FORM_MIN_TEXT_SIZE {
+      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.width <= avail-w and m.height <= avail-h and char-m.width <= avail-w {
+        final-size = current
+        break
+      }
+      current = current - step
+    }
+
+    // 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,
+      height: height,
+      clip: true,
+      inset: (x: x-inset, y: y-inset),
+      align(left + vert-align, text(size: final-size, display)),
+    )
+  }
+}
+
+/// 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) != "" {
+      render-text-field(str(value), width, height, 1.5pt, 1pt)
+    }
+  } 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 != "" {
+      render-text-field(display, width, height, 2pt, 1pt)
+    }
+  }
+}
+
+/// 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,67 @@
+#import "@local/quillmark-helper:0.1.0": data
+#import "@local/typst-af4141:0.1.0": form
+
+#set text(font: ("NimbusRomNo9L", "Times New Roman", "serif"))
+
+// `type: date` fields arrive as Typst `datetime`; PDF overlay expects strings.
+// Missing / blank dates: helper uses `none`; empty strings may also appear from input.
+#let form-cell(v) = {
+  if v == none { "" }
+  else if type(v) == str and v == "" { "" }
+  else if type(v) == datetime {
+    v.display("[month padding:none]/[day padding:none]/[year]")
+  } else {
+    str(v)
+  }
+}
+
+// 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 ---
+// 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.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))
+          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/daf1206/0.1.0/Quill.yaml

@@ -0,0 +1,55 @@
+quill:
+  name: daf1206
+  version: 0.1.0
+  backend: typst
+  plate_file: plate.typ
+  example_file: example.md
+  description: "DAF Form 1206 — Nomination for Award"
+
+main:
+  ui:
+    hide_body: false
+  fields:
+    award:
+      title: Award Program
+      type: string
+    category_if_applicable:
+      title: Award Category
+      type: string
+      ui:
+        compact: true
+    award_period:
+      title: Award Period
+      type: string
+      ui:
+        compact: true
+    rankname_of_nominee:
+      title: Nominee Rank & Name
+      type: string
+      ui:
+        compact: true
+    majcom_fldcom_foa_or_dru:
+      title: Command (MAJCOM/FLDCOM/FOA/DRU)
+      type: string
+      ui:
+        compact: true
+    dafsc_duty_title:
+      title: DAFSC & Duty Title
+      type: string
+    nominees_telephone_dsn_commercial:
+      title: Nominee Phone
+      type: string
+    unit_office_symbol_street_address_base_state_zip:
+      title: Unit Mailing Address
+      type: string
+    unit_commander_rank_name_and_telephone:
+      title: Unit Commander
+      type: string
+
+cards:
+  accomplishments_continued:
+    title: Specific Accomplishments (Continued — Page 2)
+    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:
+      hide_body: false
+    fields: {}

package/quills/daf1206/0.1.0/example.md

@@ -0,0 +1,23 @@
+---
+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.
+
+---
+CARD: accomplishments_continued
+---
+
+Use this card body only if page 2 overflow is needed.
+- Add continuation bullets here.

package/quills/daf1206/0.1.0/packages/typst-daf1206/FIELDS.json

@@ -0,0 +1,158 @@
+{
+  "pages": [
+    {
+      "width": 612.0,
+      "height": 792.0
+    },
+    {
+      "width": 612.0,
+      "height": 792.0
+    }
+  ],
+  "fields": [
+    {
+      "name": "AWARD",
+      "type": "text",
+      "bbox": [
+        21.479999542236328,
+        30.5999755859375,
+        307.55999755859375,
+        46.79998779296875
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "CATEGORY If Applicable",
+      "type": "text",
+      "bbox": [
+        309.1199951171875,
+        30.719970703125,
+        423.3599853515625,
+        46.79998779296875
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "AWARD PERIOD",
+      "type": "text",
+      "bbox": [
+        424.9200134277344,
+        31.20001220703125,
+        593.4000244140625,
+        46.79998779296875
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "RANKNAME OF NOMINEE First Middle Initial Last",
+      "type": "text",
+      "bbox": [
+        21.360000610351562,
+        54.0,
+        348.8399963378906,
+        68.52001953125
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "MAJCOM FLDCOM FOA OR DRU",
+      "type": "text",
+      "bbox": [
+        350.1600036621094,
+        54.0,
+        593.52001953125,
+        68.52001953125
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "DAFSCDUTY TITLE",
+      "type": "text",
+      "bbox": [
+        21.479999542236328,
+        76.91998291015625,
+        286.9200134277344,
+        93.96002197265625
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "NOMINEES TELEPHONE  DSN  Commercial",
+      "type": "text",
+      "bbox": [
+        288.4800109863281,
+        76.91998291015625,
+        593.4000244140625,
+        93.96002197265625
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "UNITOFFICE SYMBOLSTREET ADDRESSBASESTATEZIP CODE",
+      "type": "text",
+      "bbox": [
+        21.360000610351562,
+        101.280029296875,
+        593.52001953125,
+        115.79998779296875
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "RANKNAME OF UNIT COMMANDER First Middle Initial LastCOMMANDERS TELEPHONE DSN  Commercial",
+      "type": "text",
+      "bbox": [
+        21.479999542236328,
+        123.3599853515625,
+        593.4000244140625,
+        139.20001220703125
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "SPECIFIC ACCOMPLISHMENTS Use Performance Statements IAW DAFMAN 362806",
+      "type": "text",
+      "bbox": [
+        22.079999923706055,
+        147.1199951171875,
+        592.7999877929688,
+        767.4000244140625
+      ],
+      "page": 1,
+      "options": null
+    },
+    {
+      "name": "RANKNAME OF NOMINEE First Middle Initial Last_2",
+      "type": "text",
+      "bbox": [
+        21.479999542236328,
+        36.84002685546875,
+        593.4000244140625,
+        54.84002685546875
+      ],
+      "page": 2,
+      "options": null
+    },
+    {
+      "name": "SPECIFIC ACCOMPLISHMENTS Use Performance Statements IAW DAFMAN 362806 Continued",
+      "type": "text",
+      "bbox": [
+        22.079999923706055,
+        62.8800048828125,
+        592.7999877929688,
+        769.2000122070312
+      ],
+      "page": 2,
+      "options": null
+    }
+  ]
+}

package/quills/daf1206/0.1.0/packages/typst-daf1206/form.typ

@@ -0,0 +1,36 @@
+// form.typ (generated — do not edit)
+#import "lib.typ": render-form
+
+#let form(
+  debug: false,
+  AWARD: "",  // text
+  CATEGORY_If_Applicable: "",  // text
+  AWARD_PERIOD: "",  // text
+  RANKNAME_OF_NOMINEE_First_Middle_Initial_Last: "",  // text
+  MAJCOM_FLDCOM_FOA_OR_DRU: "",  // text
+  DAFSCDUTY_TITLE: "",  // text
+  NOMINEES_TELEPHONE__DSN__Commercial: "",  // text
+  UNITOFFICE_SYMBOLSTREET_ADDRESSBASESTATEZIP_CODE: "",  // text
+  RANKNAME_OF_UNIT_COMMANDER_First_Middle_Initial_LastCOMMANDERS_TELEPHONE_DSN__Commercial: "",  // text
+  SPECIFIC_ACCOMPLISHMENTS_Use_Performance_Statements_IAW_DAFMAN_362806: "",  // text
+  RANKNAME_OF_NOMINEE_First_Middle_Initial_Last_2: "",  // text
+  SPECIFIC_ACCOMPLISHMENTS_Use_Performance_Statements_IAW_DAFMAN_362806_Continued: "",  // text
+) = render-form(
+  schema: json("FIELDS.json"),
+  backgrounds: ("page1.svg", "page2.svg",),
+  values: (
+    "AWARD": AWARD,
+    "CATEGORY If Applicable": CATEGORY_If_Applicable,
+    "AWARD PERIOD": AWARD_PERIOD,
+    "RANKNAME OF NOMINEE First Middle Initial Last": RANKNAME_OF_NOMINEE_First_Middle_Initial_Last,
+    "MAJCOM FLDCOM FOA OR DRU": MAJCOM_FLDCOM_FOA_OR_DRU,
+    "DAFSCDUTY TITLE": DAFSCDUTY_TITLE,
+    "NOMINEES TELEPHONE  DSN  Commercial": NOMINEES_TELEPHONE__DSN__Commercial,
+    "UNITOFFICE SYMBOLSTREET ADDRESSBASESTATEZIP CODE": UNITOFFICE_SYMBOLSTREET_ADDRESSBASESTATEZIP_CODE,
+    "RANKNAME OF UNIT COMMANDER First Middle Initial LastCOMMANDERS TELEPHONE DSN  Commercial": RANKNAME_OF_UNIT_COMMANDER_First_Middle_Initial_LastCOMMANDERS_TELEPHONE_DSN__Commercial,
+    "SPECIFIC ACCOMPLISHMENTS Use Performance Statements IAW DAFMAN 362806": SPECIFIC_ACCOMPLISHMENTS_Use_Performance_Statements_IAW_DAFMAN_362806,
+    "RANKNAME OF NOMINEE First Middle Initial Last_2": RANKNAME_OF_NOMINEE_First_Middle_Initial_Last_2,
+    "SPECIFIC ACCOMPLISHMENTS Use Performance Statements IAW DAFMAN 362806 Continued": SPECIFIC_ACCOMPLISHMENTS_Use_Performance_Statements_IAW_DAFMAN_362806_Continued,
+  ),
+  debug: debug,
+)