@tonguetoquill/collection 0.2.3 → 0.2.5-beta.1

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)[#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", default: "")]]

package/quills/taro/0.1.0/Quill.yaml

@@ -1,29 +1,29 @@
-Quill:
-  name: taro
-  version: 0.1.0
-  backend: typst
-  plate_file: plate.typ
-  example_file: example.md
-  description: A simple document template for testing
-
-fields:
-  author:
-    title: Author of document
-    type: string
-  ice_cream:
-    title: favorite ice cream flavor
-    type: string
-    default: taro
-  title:
-    title: title of document
-    type: string
-
-cards:
-  quotes:
-    title: Inspirational Quotes
-    description: A collection of quotes about taro ice cream
-    fields:
-      author:
-        title: Quote author
-        type: string
-        description: The person who said this quote
+Quill:
+  name: taro
+  version: 0.1.0
+  backend: typst
+  plate_file: plate.typ
+  example_file: example.md
+  description: A simple document template for testing
+
+fields:
+  author:
+    title: Author of document
+    type: string
+  ice_cream:
+    title: favorite ice cream flavor
+    type: string
+    default: taro
+  title:
+    title: title of document
+    type: string
+
+cards:
+  quotes:
+    title: Inspirational Quotes
+    description: A collection of quotes about taro ice cream
+    fields:
+      author:
+        title: Quote author
+        type: string
+        description: The person who said this quote

package/quills/taro/0.1.0/example.md

@@ -1,27 +1,27 @@
----
-QUILL: taro@0.1
-author: Nibs
-ice_cream: Taro
-title: "My Favorite Ice Cream Flavor"
----
-
-I love Taro ice cream for its subtly sweet, nutty flavor and creamy, earthy undertones that set it apart from more common flavors. Its unique purple hue and smooth texture make it both visually striking and deliciously comforting. Here are some quotes from satisfied customers:
-
-
----
-CARD: quotes
-author: Albert Einstein
----
-Without taro ice cream, life would be a mistake.
-
----
-CARD: quotes
-author: Friedrich Nietzsche
----
-He who has taro ice cream in his heart will never be alone.
-
----
-CARD: quotes
-author: Mark Twain
----
+---
+QUILL: taro@0.1
+author: Nibs
+ice_cream: Taro
+title: "My Favorite Ice Cream Flavor"
+---
+
+I love Taro ice cream for its subtly sweet, nutty flavor and creamy, earthy undertones that set it apart from more common flavors. Its unique purple hue and smooth texture make it both visually striking and deliciously comforting. Here are some quotes from satisfied customers:
+
+
+---
+CARD: quotes
+author: Albert Einstein
+---
+Without taro ice cream, life would be a mistake.
+
+---
+CARD: quotes
+author: Friedrich Nietzsche
+---
+He who has taro ice cream in his heart will never be alone.
+
+---
+CARD: quotes
+author: Mark Twain
+---
 The secret of getting ahead is getting started... with taro ice cream.

package/quills/taro/0.1.0/plate.typ

@@ -1,31 +1,31 @@
-#import "@local/quillmark-helper:0.1.0": data, eval-markup, parse-date
-
-#set text(font: "Figtree")
-
-// Advanced: Use show filter to color text
-#show regex("(?i)taro"): it => text(fill: purple)[#it]
-
-// Filters like `String` render to code mode automatically,
-#underline(data.title)
-
-// When using filters in markup mode,
-// add `#` before the template expression to enter code mode.
-*Author: #data.author*
-
-*Favorite Ice Cream: #data.ice_cream*__
-
-
-#eval-markup(data.BODY)
-
-// Present each sub-document programatically
-#for card in data.CARDS {
-  if card.CARD == "quotes" [
-    *#card.author*: _#eval-markup(card.BODY)_
-  ]
-}
-
-
-// Include an image with a dynamic asset
-#if "picture" in data {
-  image(data.picture)
-}
+#import "@local/quillmark-helper:0.1.0": data, eval-markup, parse-date
+
+#set text(font: "Figtree")
+
+// Advanced: Use show filter to color text
+#show regex("(?i)taro"): it => text(fill: purple)[#it]
+
+// Filters like `String` render to code mode automatically,
+#underline(data.title)
+
+// When using filters in markup mode,
+// add `#` before the template expression to enter code mode.
+*Author: #data.author*
+
+*Favorite Ice Cream: #data.ice_cream*__
+
+
+#eval-markup(data.BODY)
+
+// Present each sub-document programatically
+#for card in data.CARDS {
+  if card.CARD == "quotes" [
+    *#card.author*: _#eval-markup(card.BODY)_
+  ]
+}
+
+
+// Include an image with a dynamic asset
+#if "picture" in data {
+  image(data.picture)
+}

package/quills/usaf_memo/0.1.0/.quillignore

@@ -1,31 +1,31 @@
-# Example .quillignore for usaf_memo template
-# This demonstrates the .quillignore functionality
-
-# Ignore temporary and backup files
-*.tmp
-*.bak
-*~
-*.swp
-
-# Ignore build artifacts
-target/
-dist/
-build/
-
-# Ignore OS-specific files
-.DS_Store
-Thumbs.db
-desktop.ini
-
-# Ignore version control
-.git/
-.svn/
-
-# Ignore editor files
-.vscode/
-.idea/
-*.sublime-*
-
-# Ignore log files
-*.log
+# Example .quillignore for usaf_memo template
+# This demonstrates the .quillignore functionality
+
+# Ignore temporary and backup files
+*.tmp
+*.bak
+*~
+*.swp
+
+# Ignore build artifacts
+target/
+dist/
+build/
+
+# Ignore OS-specific files
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Ignore version control
+.git/
+.svn/
+
+# Ignore editor files
+.vscode/
+.idea/
+*.sublime-*
+
+# Ignore log files
+*.log
 logs/