@airmark/quiver 0.27.0 → 0.28.0

package/README.md

@@ -1,7 +1,7 @@
 # @airmark/quiver
 
-A [Quillmark](https://github.com/nibsbin/quillmark) Source Quiver of Air Force
-and DAF official-document Quills, sourced from
+A [Quillmark](https://github.com/nibsbin/quillmark) source quiver of Air Force
+and DAF official-document quills, sourced from
 [tonguetoquill-collection](https://github.com/nibsbin/tonguetoquill-collection)
 and aligned to the current Quillmark spec.
 
@@ -20,28 +20,31 @@ and aligned to the current Quillmark spec.
 npm install @airmark/quiver @quillmark/quiver @quillmark/wasm
 ```
 
-This package ships only the Source Quiver assets (`Quiver.yaml` + `quills/`)
-and exposes no JavaScript API. All loading is performed by `@quillmark/quiver`,
-either from the on-disk package directory or from a packed archive fetched
-over HTTP.
+This package ships only the source-quiver assets (`Quiver.yaml` + `quills/`) and
+exposes no JavaScript API. Loading is `@quillmark/quiver`'s, rendering is
+`@quillmark/wasm`'s.
 
 ## Usage
 
-### Load from the exported directory
+### Load from the installed directory (Node)
 
-Resolve the package's `Quiver.yaml` via `import.meta.resolve` and hand it to
-`@quillmark/quiver`:
+Resolve this package's `Quiver.yaml` from your own module — your dependencies are
+reachable from you, not from the loader's install location — and hand its
+directory to `fromDir`:
 
 ```ts
-import { fileURLToPath } from 'node:url';
-import path from 'node:path';
-import { Quillmark, Document } from '@quillmark/wasm';
-import { Quiver } from '@quillmark/quiver/node';
+import { createRequire } from 'node:module';
+import { dirname } from 'node:path';
+import { Engine, init } from '@quillmark/wasm';
+import { fromDir } from '@quillmark/quiver/node';
 
-const quiverYaml = fileURLToPath(import.meta.resolve('@airmark/quiver/Quiver.yaml'));
-const quiver = await Quiver.fromDir(path.dirname(quiverYaml));
+// `init` is the only door to `Document`: there is no static export to reach early.
+const { Document } = await init();
+
+const root = dirname(createRequire(import.meta.url).resolve('@airmark/quiver/Quiver.yaml'));
+const quiver = await fromDir(root);
+const engine = new Engine();
 
-const engine = new Quillmark();
 const doc = Document.fromMarkdown(`~~~
 $quill: usaf_memo@0.2
 $kind: main
@@ -53,19 +56,31 @@ signature_block: ["FIRST M. LAST, Rank, USAF", "Duty Title"]
 
 Body of the memo.`);
 
-const quill = await quiver.getQuill(doc.quillRef, { engine });
-const { artifacts } = quill.render(doc, { format: 'pdf' });
+const quill = await quiver.getQuill(doc.quillRef);
+const { artifacts } = await engine.render(quill, doc, { format: 'pdf' });
 ```
 
-### Load a packed Quiver via HTTP
+A quill from `getQuill` is borrowed: every caller asking for that ref gets the
+same instance, so it is not yours to `free()`.
+
+### Load over HTTP (browser)
+
+A browser cannot read the source layout, so pack it at deploy time and serve the
+output as static files:
+
+```ts
+import { build } from '@quillmark/quiver/node'; // build step
+await build(root, './public/quivers/airmark');
+```
 
-Publish a packed Quiver archive (e.g. as a CDN or GitHub release asset) and
-load it in the browser or any fetch-capable runtime through `@quillmark/quiver`.
-See the upstream `@quillmark/quiver` docs for the packed-format and HTTP API.
+```ts
+import { Quiver } from '@quillmark/quiver'; // browser runtime
+const quiver = await Quiver.fromBuiltUrl('/quivers/airmark/');
+```
 
 ## Layout
 
-This package is a [Source Quiver](https://www.npmjs.com/package/@quillmark/quiver)
+This package is a [source quiver](https://www.npmjs.com/package/@quillmark/quiver)
 conforming to the canonical layout:
 
 ```
@@ -79,20 +94,53 @@ quills/
       packages/
 ```
 
-## Testing
+## Working on a quill
 
-`quiver.test.js` at the repo root runs the
-[`@quillmark/quiver/testing`](https://www.npmjs.com/package/@quillmark/quiver)
-suite under the built-in [`node:test`](https://nodejs.org/api/test.html) runner,
-validating each `(quill, version)` pair through the full load +
-`engine.quill(tree)` compile pipeline:
+Two verbs, and they answer different questions.
+
+Both verbs are [`quillkit`](https://www.npmjs.com/package/quillkit)'s, the quill
+author's toolchain. It resolves `@quillmark/quiver` and `@quillmark/wasm` out of
+this collection's own `node_modules`, so the versions pinned here are the format
+the quiver is packed in and the wasm the gate renders through.
+
+**Does it work?** `quillkit test` loads the collection with `fromDir`, compiles
+every quill, and renders each one's example document — the blueprint seeded from
+the `example:` values in `Quill.yaml`. It is the gate CI runs, so a validation
+failure surfaces here rather than on a consumer's build:
 
 ```bash
 npm install
 npm test
 ```
 
+The gate renders nothing the schema did not write, so the coverage is the
+`example:` block: a field with no example is a field no render exercises.
+
+**What is it like to use?** `npm run dev` is `quillkit studio`: it packs this
+quiver, serves the studio client over it, and repacks on every save — pick a
+quill, edit the seeded document, watch it paint, read the diagnostics. The
+client is quillkit's own, so there is nothing to install for it and nothing to
+keep in step.
+
+Reload to pick up a repack. Editing a quill into an invalid state is not a
+failure of the loop: it packs, and the client says what is wrong with that quill
+and where, while the others stay usable.
+
+The two verbs answer to different authorities. `quillkit test` renders through
+the wasm pinned here and is what CI blocks on; the client renders through the
+wasm it was built against, and nothing at runtime reconciles the two. The gate
+is authoritative, studio is advisory.
+
+`npm run site` writes the arrangement a deploy serves into `site/` — the client
+at the root, a built quiver at `quiver/` beneath it — without serving it. CI
+uploads that on every run, so a pull request — a fork's included — is reviewed
+by downloading the artifact and serving the directory.
+
+`main` is deployed to GitHub Pages by `.github/workflows/studio.yml`, which runs
+that same command and keeps the deploy here: nothing outside this repository
+holds `pages: write`.
+
 ## License
 
-Apache-2.0. Individual Quills carry their own licensing terms; see the
-`packages/` directory inside each Quill for upstream font and template licenses.
+Apache-2.0. Individual quills carry their own licensing terms; see the
+`packages/` directory inside each quill for upstream font and template licenses.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airmark/quiver",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Airmark Quiver — Air Force and DAF document Quills for Quillmark.",
   "type": "module",
   "exports": {
@@ -16,12 +16,14 @@
     "node": ">=24"
   },
   "devDependencies": {
-    "@quillmark/quiver": "0.15.0",
-    "@quillmark/wasm": "^0.91.0"
+    "@quillmark/quiver": "0.21.0",
+    "@quillmark/wasm": "^0.103.0",
+    "quillkit": "0.2.0"
   },
   "scripts": {
-    "test": "quiver test",
-    "preview": "quiver preview"
+    "test": "quillkit test",
+    "site": "quillkit site --out site",
+    "dev": "quillkit studio"
   },
   "keywords": [
     "quillmark",

package/quills/af4141/0.1.0/Quill.yaml

@@ -2,9 +2,11 @@ quill:
   name: af4141
   version: 0.1.0
   backend: typst
-  plate_file: plate.typ
   description: "AF Form 4141 — Individual's Record of Duties and Experience, Ground Environment Personnel"
 
+typst:
+  plate_file: plate.typ
+
 main:
   body:
     enabled: false
@@ -36,58 +38,66 @@ card_kinds:
     description: Each card represents one row in the Record of Experience table. Rows fill page 1 (up to 16 rows) then page 2 (up to 21 rows), for a maximum of 37 rows.
     ui:
       title: Record of Experience
+      groups: [record]
     body:
       enabled: false
     fields:
       date:
-        type: datetime
+        type: date
         default: ""
+        example: "2026-03-14"
         ui:
-          group: Record
+          group: record
         description: Date of the action (column A).
 
       action:
         type: string
         default: ""
+        example: Upgraded to 5-level; assumed ADO duties
         ui:
-          group: Record
+          group: record
         description: One type of action per line (column B).
 
       written_grade:
         type: string
         default: ""
+        example: "3"
         ui:
-          group: Record
+          group: record
           compact: true
         description: Written grade, if applicable (column C).
 
       written_grade_date:
-        type: datetime
+        type: date
         default: ""
+        example: "2026-02-28"
         ui:
-          group: Record
+          group: record
           compact: true
         description: Date of written grade (column D). Omit or leave blank when there is no written grade.
 
       positional_grade:
         type: string
         default: ""
+        example: "2"
         ui:
-          group: Record
+          group: record
           compact: true
         description: Positional grade, if applicable (column E).
 
       positional_grade_date:
-        type: datetime
+        type: date
         default: ""
+        example: "2026-03-14"
         ui:
-          group: Record
+          group: record
           compact: true
         description: Date of positional grade (column F). Omit or leave blank when there is no positional grade.
 
       auth_or_remarks:
         type: string
         default: ""
+        example: "J.A.D."
         ui:
-          group: Record
+          group: record
         description: Authentication or remarks entry (column G).

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

@@ -11,7 +11,15 @@
 /// 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()
+  // A date field's content is a single `text` element, and the string inside it
+  // is what decides the shrink, as a plain value's own does. Any other content
+  // (a styled label, a sequence) has no such string and counts as long, so only
+  // the dimension conditions apply.
+  let char-count = if type(display) == str {
+    display.len()
+  } else {
+    display.at("text", default: "0" * 99).len()
+  }
   char-count <= 10 or height < 20pt or aspect > 4.0
 }
 
@@ -81,8 +89,14 @@
 /// - 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)
+    if value != none {
+      // A date field arrives as content carrying its click-to-edit region, so it
+      // is placed as it stands; a plain string is placed only when non-empty.
+      if type(value) == content {
+        render-text-field(value, width, height, 1.5pt, 1pt)
+      } else if str(value) != "" {
+        render-text-field(str(value), width, height, 1.5pt, 1pt)
+      }
     }
   } else if field-type == "checkbox" {
     if value == true {

package/quills/af4141/0.1.0/plate.typ

@@ -3,13 +3,20 @@
 
 #set text(font: "NimbusRomNo9L")
 
-// `type: date` fields arrive as Typst `datetime`; PDF overlay expects strings.
-// Missing / blank dates: helper uses `none`; empty strings may also appear from input.
+// A `type: date` field lowers to a click-to-edit value object
+// `(value: datetime, display: closure)`; `display` is a stored closure on a dict
+// rather than a method, so it is called through parentheses, and the content it
+// returns carries the region that makes the glyphs clickable. A native datetime
+// is still accepted. Missing / blank dates arrive as `none`; empty strings may
+// also appear from input.
 #let form-cell(v) = {
+  let pattern = "[month padding:none]/[day padding:none]/[year]"
   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 if type(v) == dictionary {
+    (v.display)(pattern)
+  } else if type(v) == datetime {
+    v.display(pattern)
   } else {
     str(v)
   }

package/quills/daf1206/0.1.0/Quill.yaml

@@ -2,9 +2,11 @@ quill:
   name: daf1206
   version: 0.1.0
   backend: typst
-  plate_file: plate.typ
   description: "DAF Form 1206 — Nomination for Award"
 
+typst:
+  plate_file: plate.typ
+
 main:
   body:
     example: |

package/quills/daf4392/0.1.0/Quill.yaml

@@ -2,9 +2,11 @@ quill:
   name: daf4392
   version: 0.1.0
   backend: typst
-  plate_file: plate.typ
   description: "DAF Form 4392 - Pre-Departure Safety Briefing (Page 2)"
 
+typst:
+  plate_file: plate.typ
+
 main:
   body:
     enabled: false
@@ -16,7 +18,7 @@ main:
       description: "Matches the check box."
 
     departure_date:
-      type: datetime
+      type: date
       default: ""
       example: "2026-06-01"
       ui:
@@ -59,7 +61,7 @@ main:
       description: "Unit / Organization."
 
     briefed_date:
-      type: datetime
+      type: date
       default: ""
       example: "2026-05-22"
       ui:
@@ -96,41 +98,42 @@ card_kinds:
     description: "Each card represents one row in the travel itinerary table. Up to 10 rows are supported."
     ui:
       title: Proposed Travel Itinerary
+      groups: [itinerary_entry]
     body:
       enabled: false
     fields:
       date:
-        type: datetime
+        type: date
         default: ""
         ui:
-          group: Itinerary Entry
+          group: itinerary_entry
           compact: true
         description: "Date for the itinerary row."
       departure_point:
         type: string
         default: ""
         ui:
-          group: Itinerary Entry
+          group: itinerary_entry
           compact: true
         description: "Point of departure."
       arrival_point:
         type: string
         default: ""
         ui:
-          group: Itinerary Entry
+          group: itinerary_entry
           compact: true
         description: "Point of arrival."
       rest_length:
         type: string
         default: ""
         ui:
-          group: Itinerary Entry
+          group: itinerary_entry
           compact: true
         description: "Duration of stay at arrival point"
       mileage:
         type: string
         default: ""
         ui:
-          group: Itinerary Entry
+          group: itinerary_entry
           compact: true
         description: "Approximate mileage for this leg (leave blank if not applicable, e.g., flights)."

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

@@ -31,11 +31,22 @@
 }
 
 /// Format a date value for display as `DD Mon YYYY`.
+///
+/// Dispatches on the shape a date can arrive in:
+/// - dict: a Quillmark `date` field lowers to a click-to-edit value object
+///   `(value: datetime, display: closure)`. `display` is a stored closure on a
+///   dict rather than a method, so it is called through parentheses, and the
+///   content it returns carries the region that makes the glyphs clickable.
+/// - datetime: a native Typst datetime, from a plate building its own value.
+/// - str: shown as-is.
 #let format-date(value) = {
+  let pattern = "[day padding:zero] [month repr:short] [year]"
   if value == none {
     none
+  } else if type(value) == dictionary {
+    (value.display)(pattern)
   } else if type(value) == datetime {
-    value.display("[day padding:zero] [month repr:short] [year]")
+    value.display(pattern)
   } else if type(value) == str and value == "" {
     ""
   } else {
@@ -45,11 +56,17 @@
 
 /// Should this field shrink text to a single line rather than word-wrap?
 /// True for short/narrow fields with brief content (grades, ranks, dates).
-/// `display` may be a string or content; char-count is skipped for content.
 #let should-shrink-to-fit(display, width, height) = {
   let aspect = width / height
-  // content has no .len(); treat as "long" so only the dimension conditions apply
-  let char-count = if type(display) == str { display.len() } else { 99 }
+  // A date field's content is a single `text` element, and the string inside it
+  // is what decides the shrink, as a plain value's own does. Any other content
+  // (a styled label, a sequence) has no such string and counts as long, so only
+  // the dimension conditions apply.
+  let char-count = if type(display) == str {
+    display.len()
+  } else {
+    display.at("text", default: "0" * 99).len()
+  }
   char-count <= 10 or height < 20pt or aspect > 4.0
 }
 

package/quills/usaf_memo/0.2.0/Quill.yaml

@@ -2,10 +2,14 @@ quill:
   name: usaf_memo
   version: 0.2.0
   backend: typst
-  plate_file: plate.typ
   description: U.S. Air Force and Space Force Official Memorandum
 
+typst:
+  plate_file: plate.typ
+
 main:
+  ui:
+    groups: [addressing, letterhead, classification, additional]
   body:
     example: |
       The first paragraph. Top-level paragraphs are auto-numbered; do not add manual numbering.
@@ -20,7 +24,8 @@ main:
         - ORG1/SYMBOL
         - ORG2/SYMBOL
       ui:
-        group: Addressing
+        group: addressing
+        compact: true
       description: "Organization/office symbol in UPPERCASE. To address a specific person, add their rank and name in parentheses (e.g., 'ORG/SYMBOL (LT COL JANE DOE)'). For many recipients, enter 'SEE DISTRIBUTION' and list them in the Distribution field."
 
     memo_from:
@@ -34,14 +39,15 @@ main:
         - 123 Street Ave
         - City ST 12345-6789
       ui:
-        group: Addressing
+        group: addressing
+        compact: true
       description: "If recipients are on the same installation, use only the office symbol. For recipients on other installations, include the full mailing address to enable return correspondence. Omit entirely to produce a Memorandum for Record (no MEMO FROM line)."
 
     subject:
       type: string
       example: Subject of the Memorandum
       ui:
-        group: Addressing
+        group: addressing
       description: Be brief and clear. Capitalize the first letter of each word except articles, prepositions, and conjunctions. Include suspense dates in parentheses if applicable.
 
     signature_block:
@@ -52,14 +58,15 @@ main:
         - "FIRST M. LAST, Rank, USAF"
         - Duty Title
       ui:
-        group: Addressing
+        group: addressing
+        compact: true
       description: "Line 1: Name in UPPERCASE as signed, grade, and service. Line 2: Duty title."
 
     letterhead_title:
       type: string
       default: DEPARTMENT OF THE AIR FORCE
       ui:
-        group: Letterhead
+        group: letterhead
       description: Change only for Joint Commands or DoW agencies.
 
     letterhead_caption:
@@ -69,7 +76,7 @@ main:
       example:
         - HEADQUARTERS [UNIT NAME]
       ui:
-        group: Letterhead
+        group: letterhead
       description: The full organization name of your unit.
 
     letterhead_seal:
@@ -79,7 +86,7 @@ main:
         - dod
       default: dow
       ui:
-        group: Letterhead
+        group: letterhead
         compact: true
       description: Department of War (DoW) or Department of Defense (DoD) seal shown in the letterhead.
 
@@ -87,15 +94,16 @@ main:
       type: string
       default: ""
       ui:
-        group: Letterhead
+        group: letterhead
         compact: true
       description: Bold-caps line below the seal; blank to omit.
 
     tag_line:
-      type: markdown
+      type: richtext
+      inline: true
       default: ""
       ui:
-        group: Letterhead
+        group: letterhead
         compact: true
       description: "Organizational motto at the bottom of the page. Supports Markdown emphasis (e.g. *italics*, **bold**)."
 
@@ -110,7 +118,7 @@ main:
         - TOP SECRET
       default: ""
       ui:
-        group: Classification
+        group: classification
         compact: true
       description: "Select the classification marking shown in the header and footer banner. Unclassified documents typically omit this banner entirely — leave blank unless the document is CUI or classified. Mark per DAFI 16-1404 (DoDM 5200.48 for CUI) and applicable DoD guidance."
 
@@ -118,7 +126,7 @@ main:
       type: string
       default: ""
       ui:
-        group: Classification
+        group: classification
         compact: true
       description: "Banner dissemination suffix appended after double slash (e.g. 'NF' renders as CUI//NF in the header/footer). Leave blank for no suffix."
 
@@ -126,7 +134,7 @@ main:
       type: string
       default: ""
       ui:
-        group: Classification
+        group: classification
         compact: true
       description: "Office or organization that designated this information as CUI (e.g., 'SAF/AA'). Required by DoDM 5200.48 when classification is CUI."
 
@@ -134,7 +142,7 @@ main:
       type: string
       default: ""
       ui:
-        group: Classification
+        group: classification
         compact: true
       description: "CUI category from the DoD CUI Registry (e.g., 'Privacy/MED', 'CTI', 'PRVCY'). Leave blank to omit."
 
@@ -142,7 +150,7 @@ main:
       type: string
       default: ""
       ui:
-        group: Classification
+        group: classification
         compact: true
       description: "Limited dissemination control shown in the indicator block (e.g., 'FEDONLY', 'NOFORN'). Independent from the banner suffix above."
 
@@ -150,20 +158,21 @@ main:
       type: string
       default: ""
       ui:
-        group: Classification
+        group: classification
         compact: true
       description: "Point of contact for CUI questions (e.g., 'Capt J. Smith, DSN 555-1234, john.smith@us.af.mil'). Required by DoDM 5200.48 when classification is CUI."
 
     references:
       type: array
       items:
-        type: markdown
+        type: richtext
+        inline: true
       default: []
       example:
         - "AFMAN 33-326, 25 November 2011, *Preparing Official Communications*"
         - "AFI 33-360, *Publications and Forms Management*"
       ui:
-        group: Additional
+        group: additional
       description: "References, auto-lettered (a), (b), (c) per AFH 33-337. Cite each by organization, type, date, and title; italicize publication titles with *asterisks* (standard Markdown emphasis)."
 
     cc:
@@ -174,7 +183,7 @@ main:
       example:
         - Rank and Name, ORG/SYMBOL
       ui:
-        group: Additional
+        group: additional
       description: List office symbols of recipients to receive copies.
 
     distribution:
@@ -186,7 +195,7 @@ main:
         - ORG1/SYMBOL
         - ORG2/SYMBOL
       ui:
-        group: Additional
+        group: additional
       description: Complete list of recipients if 'SEE DISTRIBUTION' is used in the 'Memo For' field.
 
     attachments:
@@ -197,7 +206,7 @@ main:
       example:
         - Attachment description, YYYY MMM DD
       ui:
-        group: Additional
+        group: additional
       description: List attachments in the order they are mentioned in the memo. Briefly describe each; do not use 'as stated' or abbreviations.
 
     memo_style:
@@ -207,7 +216,7 @@ main:
         - daf
       default: usaf
       ui:
-        group: Additional
+        group: additional
         compact: true
       description: "USAF memorandum or DAF headquarters memorandum; DAF changes date format and body paragraph layout per AFH 33-337."
 
@@ -215,15 +224,15 @@ main:
       type: number
       default: 12
       ui:
-        group: Additional
+        group: additional
         compact: true
       description: Body text size in points; decimals allowed (e.g. 11.5).
 
     date:
-      type: datetime
+      type: date
       default: ""
       ui:
-        group: Additional
+        group: additional
         compact: true
       description: YYYY-MM-DD. Leave blank to use today's date.
 
@@ -232,18 +241,21 @@ card_kinds:
     description: Chain of routing endorsements. Each endorsement block adds an official response or forwarding action to the original memo.
     ui:
       title: Routing indorsement
+      groups: [addressing, additional]
     fields:
       from:
         type: string
         example: ORG/SYMBOL
         ui:
-          group: Addressing
+          group: addressing
+          compact: true
         description: Office symbol or Rank Name of the endorsing official.
       for:
         type: string
         example: ORG/SYMBOL
         ui:
-          group: Addressing
+          group: addressing
+          compact: true
         description: Office symbol or organization receiving the endorsed memo.
       signature_block:
         type: array
@@ -253,7 +265,8 @@ card_kinds:
           - "FIRST M. LAST, Rank, USAF"
           - Duty Title
         ui:
-          group: Addressing
+          group: addressing
+          compact: true
         description: "Line 1: Name in UPPERCASE as signed, grade, and service. Line 2: Duty title."
       format:
         type: string
@@ -263,7 +276,7 @@ card_kinds:
           - separate_page
         default: standard
         ui:
-          group: Additional
+          group: additional
           compact: true
         description: "'standard' (formal, same page), 'informal' (less formal routing), or 'separate_page' (begins on a new page)."
       action:
@@ -275,13 +288,13 @@ card_kinds:
           - disapprove
         default: ""
         ui:
-          group: Additional
+          group: additional
           compact: true
         description: "Action taken by the endorser. Leave blank to hide the Approve/Disapprove line entirely, 'undecided' to display the line with neither option circled, 'approve' or 'disapprove' to circle the selected option."
       date:
-        type: datetime
+        type: date
         default: ""
         ui:
-          group: Additional
+          group: additional
           compact: true
         description: "YYYY-MM-DD. Date the endorser signs/forwards the memo (per AFH 33-337 Ch. 14, this is distinct from the originating memo's date). Leave blank to render a fill-in line for the endorser to date by hand when signing."

package/quills/usaf_memo/0.2.0/packages/tonguetoquill-usaf-memo/src/utils.typ

@@ -89,10 +89,15 @@
 
 /// Formats a date for the memo heading.
 ///
-/// - String: shown as-is (use for fixed text like placeholders).
-/// - datetime: USAF style `DD Month YYYY`; DAF style `Month DD, YYYY`.
-///
-/// - date (str|datetime): Date to format for display
+/// Dispatches on the shape a date field can arrive in:
+/// - str: shown as-is (fixed text like a placeholder).
+/// - datetime: a native Typst datetime (e.g. `datetime.today()`) — USAF style
+///   `DD Month YYYY`, DAF style `Month DD, YYYY`.
+/// - dict: a Quillmark `date`/`datetime` field lowers to a click-to-edit value
+///   object `{ value: datetime, display: closure }`; `display` is a stored closure
+///   over `.display`, so call it through parentheses — a dict has no `.display` method.
+///
+/// - date (str | datetime | dict): Date to format for display
 /// - memo-style (str): `"usaf"` or `"daf"`
 /// -> content
 #let display-date(date, memo-style: "usaf") = {
@@ -108,7 +113,11 @@
     } else {
       "[day padding:none] [month repr:long] [year]"
     }
-    date.display(pattern)
+    if type(date) == datetime {
+      date.display(pattern)
+    } else {
+      (date.display)(pattern)
+    }
   }
 }
 

package/quills/usaf_memo/0.2.0/plate.typ

@@ -54,7 +54,10 @@
   memo_for_cols: 1,
 )
 
-// Mainmatter configuration
+// Mainmatter. The body's region needs no recovery step here: the package's
+// render-body rebuilds paragraphs through a state buffer (AFH 33-337
+// auto-numbering), but the rebuilt glyphs keep their spans, which is what
+// the backend reads regions from.
 #mainmatter[
   #data.at("$body")
 ]
@@ -63,7 +66,7 @@
 #backmatter(
   // Signature block
   signature_block: data.signature_block,
-  signing_field: signature-field("Signature"),
+  signing_field: signature-field("Signature", field: "signature_block"),
 
   // Optional cc
   ..if "cc" in data { (cc: data.cc) },
@@ -94,11 +97,20 @@
     } else {
       card_date
     }
+    // The card's `$path` prefix composes its canonical schema addresses
+    // (`$cards.indorsement.<n>.…`, per-kind ordinal) — the absolute loop
+    // index `i` is NOT that ordinal once kinds interleave, so it stays a
+    // widget-name suffix only. The card body's region rides its own glyph
+    // spans through the package rebuild, per-card because each card's body
+    // has its own backend-generated eval site.
     indorsement(
       from: card.at("from", default: ""),
       to: card.at("for", default: ""),
       signature_block: card.signature_block,
-      signing_field: signature-field("Ind_" + str(i) + "_Signature"),
+      signing_field: signature-field(
+        "Ind_" + str(i) + "_Signature",
+        field: card.at("$path") + "signature_block",
+      ),
       format: card.at("format", default: "standard"),
       date: resolved_date,
       ..if "action" in card { (action: card.action) },

package/quills/af4141/0.1.0/design/TASK.md

@@ -1,20 +0,0 @@
-I visually mapped out a bunch of fields on the form to the typst field names. The intent is to write a plate and field schema that interfaces with the Typst form and exposes an ergonomic API to the Quill consumer. See [Creating Quills](https://quillmark.readthedocs.io/en/latest/guides/creating-quills/) to learn how to write the field schema. 
-
-Note that the following field names are not authortative; use your discretion to name them ergonomically.
-
-## Admin Fields
-
-Name: `commonforms_text_p1_1`
-Unit: `commonforms_text_p1_2`
-Grade/CCC Level: `commonforms_text_p1_3`
-
-## Record of Experience table fields
-
-Date: `commonforms_text_p1_{4,7,18,...,109}` and `commonforms_text_p2_{1,8,15,...141}`
-Mandatory Actions to be Reported: `commonforms_text_p1_{5,12,19,...,110}` and `commonforms_text_p2_{2,9,16,...,142}`
-written_grade: `commonforms_text_p1_{6,13,...111}` and `commonforms_text_p2_{3,10,...,143}`
-writen_grade_date: `commonforms_text_p1_{7,14,...,112}` and `commonforms_text_p2_{4,11,144}`
-positional_grade: `commonforms_text_p1_{8,15,...,113}` and `commonforms_text_p2_{5,12,...,145}`
-positional_grade_date: `commonforms_text_p1_{9,...,114}` and
-`commonforms_text_p2_{6,...,145}`
-auth_or_remarks: `commonforms_text_p1_{10,...,115}` and `commonforms_text_p2_{7,...,146}`

package/quills/usaf_memo/0.2.0/.quillignore

@@ -1,31 +0,0 @@
-# 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/