@tonguetoquill/collection 0.2.8 → 0.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonguetoquill/collection",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nibsbin/tonguetoquill-collection.git"
@@ -28,7 +28,8 @@
     "postversion": "git push --follow-tags",
     "release:patch": "npm version patch",
     "release:minor": "npm version minor",
-    "release:major": "npm version major"
+    "release:major": "npm version major",
+    "prerelease": "npm version prerelease --preid beta && npm publish --tag beta"
   },
   "publishConfig": {
     "access": "public"

package/quills/daf4392/0.1.0/Quill.yaml

@@ -0,0 +1,136 @@
+Quill:
+  name: daf4392
+  version: 0.1.0
+  backend: typst
+  plate_file: plate.typ
+  ui:
+    hide_body: true
+  example_file: example.md
+  description: "DAF Form 4392 - Pre-Departure Safety Briefing (Page 2)"
+
+fields:
+  transportation_mode:
+    title: Mode of Transportation
+    type: string
+    enum: [pmv, airplane, bus, train, motorcycle, other]
+    required: true
+    description: "Matches the check box."
+
+  departure_date:
+    title: Departure Date
+    type: string
+    required: true
+    ui:
+      compact: true
+    description: "Date of initial departure."
+
+  final_destination:
+    title: Final Destination
+    type: string
+    required: true
+    ui:
+      compact: true
+    description: "Final travel destination."
+
+  notes:
+    title: Notes
+    type: string
+    description: "Additional notes or remarks for the travel."
+
+  organization:
+    title: Organization
+    type: string
+    required: true
+    ui:
+      compact: true
+    description: "Unit / Organization conducting the brief."
+
+  briefed_date:
+    title: Date Briefed
+    type: string
+    required: true
+    ui:
+      compact: true
+    description: "Date the brief took place."
+
+  briefee_name:
+    title: Individual Receiving Brief (Name)
+    type: string
+    required: true
+    ui:
+      compact: true
+    description: "Name (Last, First) of the individual receiving the brief."
+
+  briefee_grade:
+    title: Individual Receiving Brief (Grade)
+    type: string
+    ui:
+      compact: true
+    description: "Grade of the individual receiving the brief."
+
+  briefer_name:
+    title: Briefer / Reviewer Name
+    type: string
+    ui:
+      compact: true
+    description: "Name (Last, First) of the briefer."
+
+  briefer_grade:
+    title: Briefer / Reviewer Grade
+    type: string
+    ui:
+      compact: true
+    description: "Grade of the briefer."
+
+  emergency_contact_name:
+    title: Emergency Contact Name
+    type: string
+    description: "Name of the emergency contact person at the bottom of the form."
+
+  emergency_contact_phone:
+    title: Emergency Contact Phone
+    type: string
+    description: "Phone number of the emergency contact person at the bottom of the form."
+
+cards:
+  itinerary:
+    title: Proposed Travel Itinerary
+    description: "Each card represents one row in the travel itinerary table. Up to 5 rows are supported."
+    ui:
+      hide_body: true
+    fields:
+      date:
+        title: Date
+        type: date
+        ui:
+          group: Itinerary Entry
+          compact: true
+        description: "Date for the itinerary row."
+      departure_point:
+        title: Departure Point
+        type: string
+        ui:
+          group: Itinerary Entry
+          compact: true
+        description: "Point of departure."
+      arrival_point:
+        title: Arrival Point
+        type: string
+        ui:
+          group: Itinerary Entry
+          compact: true
+        description: "Point of arrival."
+      rest_length:
+        title: Length of Rest Period
+        type: string
+        ui:
+          group: Itinerary Entry
+          compact: true
+        description: "Duration of rest period."
+      mileage:
+        title: Approximate Mileage
+        type: string
+        ui:
+          group: Itinerary Entry
+          compact: true
+        description: "Approximate mileage for this leg."

package/quills/daf4392/0.1.0/example.md

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

package/quills/daf4392/0.1.0/packages/daf4392page2_pkg/FIELDS.json

@@ -0,0 +1,9 @@
+{
+  "pages": [
+    {
+      "width": 612.0,
+      "height": 792.0
+    }
+  ],
+  "fields": []
+}

package/quills/daf4392/0.1.0/packages/daf4392page2_pkg/form.typ

@@ -0,0 +1,14 @@
+// form.typ (generated � do not edit)
+#import "lib.typ": render-form
+
+#let form(
+  debug: false,
+
+) = render-form(
+  schema: json("FIELDS.json"),
+  backgrounds: ("page1.png",),
+  values: (
+,
+  ),
+  debug: debug,
+)

package/quills/daf4392/0.1.0/packages/daf4392page2_pkg/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/daf4392/0.1.0/packages/daf4392page2_pkg/out/debug.typ

@@ -0,0 +1,4 @@
+// debug.typ (generated � renders form with debug overlays)
+#import "../form.typ": form
+
+#form(debug: true)

package/quills/daf4392/0.1.0/packages/daf4392page2_pkg/out/example.typ

@@ -0,0 +1,4 @@
+// example.typ (edit this file to fill the form)
+#import "../form.typ": form
+
+#form()

package/quills/daf4392/0.1.0/packages/daf4392page2_pkg/typst.toml

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

package/quills/daf4392/0.1.0/plate.typ

@@ -0,0 +1,60 @@
+#import "@local/quillmark-helper:0.1.0": data
+
+#set page(width: 8.5in, height: 11in, margin: 0in)
+#set text(font: "Arimo", size: 10pt)
+
+// Background
+#place(image("assets/page1.png", width: 100%, height: 100%))
+
+#let tf(dx, dy, content) = place(dx: dx, dy: dy, content)
+#let check(dx, dy, is_checked) = if is_checked { place(dx: dx, dy: dy, text(weight: "bold", size: 12pt)[✓]) }
+
+// Mode of Transportation
+#let mode = data.at("transportation_mode", default: "")
+#check(40pt, 67pt, mode == "pmv")
+#check(173pt, 67pt, mode == "airplane")
+#check(243pt, 67pt, mode == "bus")
+#check(286pt, 67pt, mode == "train")
+#check(336pt, 67pt, mode == "motorcycle")
+#check(411pt, 67pt, mode == "other")
+
+// Fields
+#tf(40pt, 100pt)[#data.at("departure_date", default: "")]
+#tf(120pt, 100pt)[#data.at("final_destination", default: "")]
+
+// Itinerary Rows (via CARDS)
+#{
+  let row = 0
+  let dy-start = 160pt
+  let dy-step = 40pt
+  if "CARDS" in data {
+    for card in data.CARDS {
+      if card.CARD == "itinerary" and row < 5 {
+        let dy = dy-start + (row * dy-step)
+        tf(80pt, dy)[#card.at("date", default: "")]
+        tf(135pt, dy)[#card.at("departure_point", default: "")]
+        tf(300pt, dy)[#card.at("arrival_point", default: "")]
+        tf(450pt, dy)[#card.at("rest_length", default: "")]
+        tf(515pt, dy)[#card.at("mileage", default: "")]
+        row = row + 1
+      }
+    }
+  }
+}
+
+// Notes
+#tf(40pt, 360pt)[#block(width: 530pt)[#data.at("notes", default: "")]]
+
+// Acknowledgements
+#tf(40pt, 420pt)[#data.at("organization", default: "")]
+#tf(500pt, 420pt)[#data.at("briefed_date", default: "")]
+
+#tf(40pt, 450pt)[#data.at("briefee_name", default: "")]
+#tf(270pt, 450pt)[#data.at("briefee_grade", default: "")]
+
+#tf(40pt, 480pt)[#data.at("briefer_name", default: "")]
+#tf(270pt, 480pt)[#data.at("briefer_grade", default: "")]
+
+// Emergency Contact
+#tf(40pt, 500pt)[#text(size: 16pt, weight: "bold")[EMERGENCY CONTACT]]
+#tf(40pt, 520pt)[#text(size: 12pt)[#data.at("emergency_contact_name", default: ""): #data.at("emergency_contact_phone", default: "")]]

package/templates/daf4392.md

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

package/templates/templates.json

@@ -46,5 +46,11 @@
 		"description": "Individual's Record of Duties and Experience, Ground Environment Personnel",
 		"file": "af4141.md",
 		"production": true
+	},
+	{
+		"name": "DAF Form 4392",
+		"description": "Pre-Departure Safety Briefing (Page 2)",
+		"file": "daf4392.md",
+		"production": true
 	}
 ]