@airmark/quiver 0.33.0 → 0.34.0

package/quills/classic_resume/0.0.1/Quill.yaml

@@ -11,6 +11,7 @@ typst:
 # heading, optional prose under it, and the rows that section holds. The rows
 # are the section's own, so an entry cannot land under the wrong heading.
 main:
+  description: "Your name and contacts head the page. Each section under them is a card, printed in the order the cards stand: add a card for every section you want."
   ui:
     groups: [identity, page]
   # Everything prints under a section heading, so main carries no body: a
@@ -20,32 +21,17 @@ main:
   fields:
     name:
       type: string
-      example: John Doe
       ui:
         group: identity
-      description: "Your name, set large at the top. It is the document's level 1 heading, and becomes the exported PDF's title and author."
+      description: "Your name as you want it read, set large at the top. It also titles the exported PDF."
 
     contacts:
       type: array
       items:
         type: string
-      example:
-        - john.doe@example.com
-        - (555) 123-4567
-        - github.com/johndoe
-        - linkedin.com/in/johndoe
-        - Pittsburgh, PA
       ui:
         group: identity
-      description: "The line under your name, one contact per line here, printed across the page separated by a diamond. Order them by how much you want them used."
-
-    link_contacts:
-      type: boolean
-      default: true
-      ui:
-        group: identity
-        compact: true
-      description: "Turn contacts that look like an email address, a web address or a phone number into live links in the PDF. Anything else — a city, a clearance level — is printed as written."
+      description: "How to reach you, one per line and the one you want used first: an email address, a phone number, a profile such as linkedin.com/in/you, a city. They print in that order across the page under your name, a diamond between each. An email address, a web address or a phone number becomes a live link in the PDF."
 
     paper:
       type: enum
@@ -64,7 +50,7 @@ main:
       ui:
         group: page
         compact: true
-      description: "Body text size in points; decimals allowed, such as 11.5. Along with the margin, this is the lever for fitting a resume onto one page — drop a half point before you drop a bullet."
+      description: "Body text size in points, such as 11 or 11.5. Along with the margin, this is the lever for fitting a resume onto one page — drop a half point before you drop a bullet."
 
     margin:
       type: number
@@ -75,51 +61,39 @@ main:
       description: "Page margin in inches, the same on all four sides. The layout is dense by design; below about 0.4 a printer starts clipping."
 
 
-# Each kind carries the same heading pair and optional prose under it. A blank
-# title prints the kind's usual heading, which the plate holds.
+# Each kind opens with the heading it prints. Its `default:` is the usual one,
+# so a new card shows the heading it will print, and an authored "" prints
+# none.
 card_kinds:
   summary:
     title: Summary
-    description: "A heading and prose under it. With a title of its own it is any section that is only prose — an objective, a statement of interest."
-    ui:
-      groups: [heading]
-    body:
-      example: |
-        Security engineer of eight years, most of it on detection pipelines other people have to keep running.
+    description: "Prose under a heading: a few lines on who you are and the work you want next. Retitled, it is any section that is only prose, such as an objective."
+    seed:
+      $body: An engineer. Likes climbing rocks and making useful things.
     fields:
       title:
         type: plaintext
         inline: true
-        default: ""
-        ui:
-          group: heading
-        description: &title_description "Printed in uppercase over a rule. Leave blank for the usual heading: Summary, Work Experience, Education, Projects, Skills or Certifications."
-      extra: &extra
-        type: richtext
-        inline: true
-        default: ""
-        ui:
-          group: heading
-          compact: true
-        description: "Qualifier set after the title in the same style, such as a date range or a clarifier. Italicize with *asterisks*. Leave blank for the usual case."
+        default: Summary
+        description: "Printed in uppercase over a rule. An empty title prints no heading, which sets the summary straight under your name."
 
   experience:
     title: Experience
     description: "Jobs, most recent first: employer and dates on the first line, role and location on the second, details under them."
-    ui:
-      groups: [heading]
-    body: &section_body
-      # Empty is a heading straight over its rows, which is the usual section.
-      example: ""
+    seed:
+      jobs:
+        - company: Employer
+          dates: Month YYYY – Present
+          role: Job Title
+          location: City, ST
+          details: |
+            - What you did, and what it changed.
     fields:
       title:
         type: plaintext
         inline: true
-        default: ""
-        ui:
-          group: heading
-        description: *title_description
-      extra: *extra
+        default: Work Experience
+        description: &title_description "Printed in uppercase over a rule. An empty title prints no heading."
       jobs:
         type: array
         items:
@@ -128,56 +102,43 @@ card_kinds:
             company:
               type: plaintext
               inline: true
-              example: Templar Archives Research Division
               description: "Set in bold at the left of the first line."
             dates: &dates
               type: plaintext
               inline: true
               default: ""
-              example: August 2024 – Present
-              description: "Set in bold at the right, opposite the name. Free text rather than a date, so a range reads as you write it: 'August 2024 – Present', 'December 2025'. Keep the form the same down the page."
+              description: "Set in bold at the right of the first line. Free text rather than a date, so a range reads as you write it: 'August 2024 – Present', 'December 2025'. Keep the form the same down the page."
             role:
               type: plaintext
               inline: true
               default: ""
-              example: Psionic Research Analyst
               description: "Your title, set in italics under the employer. Leave blank to omit."
             location: &location
               type: plaintext
               inline: true
               default: ""
-              example: Pittsburgh, PA
               description: "Set in italics at the right of the second line. 'Pittsburgh, PA', 'Remote'. Leave blank to omit; with the line's other half blank too, the second line is not printed."
             details: &details
               type: richtext
               default: ""
-              example: |
-                - What you did, and what came of it.
               description: "Set under the entry. Usually a bulleted list, one line each and strongest first; a sentence, *italics* and **bold** set as well, and a heading sets as a bold line. Leave blank for nothing under the entry."
-        example:
-          - company: Templar Archives Research Division
-            dates: August 2024 – Present
-            role: Psionic Research Analyst
-            location: Aiur
-            details: |
-              - Analyzed Khala disruption patterns, developing countermeasures to protect neural link infrastructure.
         description: "One row per job. A row is never split across a page break."
 
   education:
     title: Education
     description: "Schools, most recent first: school and date on the first line, degree and location on the second."
-    ui:
-      groups: [heading]
-    body: *section_body
+    seed:
+      schools:
+        - school: School
+          dates: Month YYYY
+          degree: Degree
+          location: City, ST
     fields:
       title:
         type: plaintext
         inline: true
-        default: ""
-        ui:
-          group: heading
+        default: Education
         description: *title_description
-      extra: *extra
       schools:
         type: array
         items:
@@ -186,83 +147,32 @@ card_kinds:
             school:
               type: plaintext
               inline: true
-              example: Carnegie Mellon University
               description: "Set in bold at the left of the first line."
-            dates:
-              <<: *dates
-              example: May 2024
+            dates: *dates
             degree:
               type: plaintext
               inline: true
               default: ""
-              example: BS, Data Science
               description: "Degree and field, set in italics under the school. Leave blank to omit."
             location: *location
             details:
               <<: *details
-              example: |
-                - Distinguished Graduate (top 10%).
               description: "Honors, activities, coursework, set under the entry. Most degrees need none."
-        example:
-          - school: Carnegie Mellon University
-            dates: December 2025
-            degree: Master of Information Technology Strategy
-            location: Pittsburgh, PA
         description: "One row per school or degree."
 
-  projects:
-    title: Projects
-    description: "Projects: name and link on the first line, details under them."
-    ui:
-      groups: [heading]
-    body: *section_body
-    fields:
-      title:
-        type: plaintext
-        inline: true
-        default: ""
-        ui:
-          group: heading
-        description: *title_description
-      extra: *extra
-      projects:
-        type: array
-        items:
-          type: object
-          properties:
-            name:
-              type: plaintext
-              inline: true
-              example: Quillmark
-              description: "Set in bold at the left."
-            url:
-              type: string
-              default: ""
-              example: https://github.com/nibsbin/quillmark
-              description: "Set small and italic at the right, and made a live link when it starts with http. Anything else is printed as written, so '<closed source>' stands in for a project with nothing to link. Leave blank to omit."
-            details: *details
-        example:
-          - name: Quillmark
-            url: https://github.com/nibsbin/quillmark
-            details: |
-              - Parameterization engine for typesetting documents from markdown.
-        description: "One row per project."
-
   skills:
     title: Skills
-    description: "Labelled lists of skills, filled across the columns and then down."
-    ui:
-      groups: [heading]
-    body: *section_body
+    description: "Skills in labelled groups, filled across the columns and then down."
+    seed:
+      skills:
+        - label: Category
+          items: Skill, Skill, Skill
     fields:
       title:
         type: plaintext
         inline: true
-        default: ""
-        ui:
-          group: heading
+        default: Skills
         description: *title_description
-      extra: *extra
       skills:
         type: array
         ui:
@@ -273,19 +183,11 @@ card_kinds:
             label:
               type: plaintext
               inline: true
-              example: Programming
-              description: "Set in bold on its own line above the text."
-            text:
+              description: "Set in bold, with its items on the line under it."
+            items:
               type: plaintext
               inline: true
-              example: Python, R, JS, Rust, PowerShell, CI/CD
-              title: Items
-              description: "The items under that label, usually comma separated. Printed as written — markup is the one thing a labeled row does not carry."
-        example:
-          - label: Programming
-            text: "Python, R, JS, C#, Rust, PowerShell, CI/CD"
-          - label: Cloud
-            text: "AWS EC2/S3, Helm, Docker, Serverless"
+              description: "Usually comma separated. Printed as written — markup is the one thing a labeled row does not carry."
         description: "One label and its items per row."
       columns: &columns
         type: integer
@@ -294,57 +196,79 @@ card_kinds:
           compact: true
         description: "Number of columns. Two suits items that run most of a line; three suits single words."
 
+  projects:
+    title: Projects
+    description: "Projects: name and link on the first line, details under them."
+    seed:
+      projects:
+        - name: Project
+          link: github.com/you/project
+          details: |
+            - What it does, and your part in it.
+    fields:
+      title:
+        type: plaintext
+        inline: true
+        default: Projects
+        description: *title_description
+      projects:
+        type: array
+        items:
+          type: object
+          properties:
+            name:
+              type: plaintext
+              inline: true
+              description: "Set in bold at the left."
+            link:
+              type: string
+              default: ""
+              description: "Where to see it, set small and italic at the right as written: github.com/you/project reads better than its https:// form. A web address becomes a live link; anything else, such as 'closed source', prints as written. Leave blank to omit."
+            details: *details
+        description: "One row per project."
+
   certifications:
     title: Certifications
-    description: "A list of certifications, filled across the columns and then down."
-    ui:
-      groups: [heading]
-    body: *section_body
+    description: "A list filled across the columns and then down. Retitled, it holds any short items: awards, languages, clearances."
+    seed:
+      items:
+        - Certification (ABBREVIATION)
     fields:
       title:
         type: plaintext
         inline: true
-        default: ""
-        ui:
-          group: heading
+        default: Certifications
         description: *title_description
-      extra: *extra
       items:
         type: array
         items:
           type: richtext
           inline: true
-        example:
-          - Offensive Security Certified Professional (OSCP)
-          - GIAC Cyber Threat Intelligence (GCTI)
         description: "One item per line. Keep each to a line at the column width. Italicize with *asterisks*."
       columns: *columns
 
   other:
     title: Other section
     description: "A section the kinds above do not name — volunteer work, military service, publications, a competition. Rows take the Experience shape with neutral names."
-    ui:
-      groups: [heading]
-    body: *section_body
+    seed:
+      title: Section Title
+      entries:
+        - heading: Entry
+          details: |
+            - What it was, and what came of it.
     fields:
       title:
         type: plaintext
         inline: true
-        example: Cyber Competition
-        ui:
-          group: heading
-        description: "Printed in uppercase over a rule. Other has no usual heading, so this one is yours to write."
-      extra: *extra
+        description: "Printed in uppercase over a rule. This section has no usual heading, so this one is yours to write."
       entries:
         type: array
-        default: []
         items:
           type: object
           properties:
             heading:
               type: plaintext
               inline: true
-              example: 1st in NCX 2023
               description: "Set in bold at the left of the first line."
             dates: *dates
             subtitle:
@@ -354,8 +278,4 @@ card_kinds:
               description: "Set in italics under the heading. Leave blank to omit."
             location: *location
             details: *details
-        example:
-          - heading: 1st in NCX 2023
-            details: |
-              - Developed strategies, defensive scripts, and exploits for the Cyber Combat event.
         description: "One row per item. A section that is only prose is a Summary with a title of its own."

package/quills/classic_resume/0.0.1/example.md

@@ -0,0 +1,111 @@
+~~~
+$quill: classic_resume
+$kind: main
+name: John Doe
+contacts:
+  - john.doe@example.com
+  - (555) 123-4567
+  - github.com/johndoe
+  - linkedin.com/in/johndoe
+  - Pittsburgh, PA
+paper: us-letter
+font_size: 11.5
+margin: 0.5
+~~~
+
+~~~
+$kind: summary
+~~~
+
+An engineer. Likes climbing rocks and making useful things.
+
+~~~
+$kind: certifications
+title: Active Certifications
+columns: 2
+items:
+- Offensive Security Certified Professional (OSCP)
+- GIAC Cyber Threat Intelligence (GCTI)
+- CompTIA CASP+, CySA+, Sec+, Net+, A+, Proj+
+- GIAC Machine Learning Engineer (GMLE)
+~~~
+
+~~~
+$kind: skills
+columns: 2
+skills:
+- label: Programming
+  items: Python, R, JS, C#, Rust, PowerShell, CI/CD
+- label: Data Science
+  items: ML/statistics, TensorFlow, AI Engineering
+- label: IT & Cybersecurity
+  items: AD DS, Splunk, Metasploit, Wireshark, Nessus
+- label: Cloud
+  items: AWS EC2/S3, Helm, Docker, Serverless
+~~~
+
+~~~
+$kind: experience
+jobs:
+- company: Templar Archives Research Division
+  dates: August 2024 – Present
+  role: Psionic Research Analyst
+  location: Aiur
+  details: |
+    - Analyzed Khala disruption patterns following Amon's corruption, developing countermeasures to protect remaining neural link infrastructure.
+    - Building automated threat detection pipelines using Khaydarin crystal arrays to monitor Void energy signatures across the sector.
+- company: Terran Dominion Ghost Academy
+  dates: May 2025 – July 2025
+  role: Covert Ops Trainee
+  location: Tarsonis (Remote)
+  details: |
+    - Developed tactical HUD displays for Ghost operatives integrating real-time Zerg hive cluster intelligence.
+- company: Raynor's Raiders
+  dates: January 2018 – June 2020
+  role: Combat Engineer
+  location: Mar Sara
+  details: |
+    - Administered Hyperion shipboard systems, SCV maintenance protocols, and bunker defense automation for 30,000+ colonists.
+~~~
+
+~~~
+$kind: education
+schools:
+- school: Carnegie Mellon University
+  dates: December 2025
+  degree: Master of Information Technology Strategy
+  location: Pittsburgh, PA
+- school: United States Air Force Academy
+  dates: May 2024
+  degree: BS, Data Science
+  location: Colorado Springs, CO
+  details: |
+    - Distinguished Graduate (top 10%); Chinese language minor (L2+/R1 on DLPT).
+~~~
+
+~~~
+$kind: other
+title: Cyber Competition
+entries:
+- heading: 1st in SANS Academy Cup 2024
+  details: |
+    - Competed as the Delogrand Web Exploit SME, solving SQLi, API, and HTTP packet crafting problems.
+- heading: 1st in NCX 2023
+  details: |
+    - Developed strategies, defensive scripts, and exploits for the Cyber Combat event.
+    - Analyzed logs with Bash and Python for the Data Analysis event.
+~~~
+
+~~~
+$kind: projects
+title: Selected Projects
+projects:
+- name: TongueToQuill
+  link: tonguetoquill.com
+  details: |
+    - Rich markdown editor for perfectly formatted USAF and USSF documents with Claude MCP integration.
+- name: Quillmark
+  link: github.com/nibsbin/quillmark
+  details: |
+    - Parameterization engine for generating arbitrarily typesetted documents from markdown content.
+~~~

package/quills/classic_resume/0.0.1/packages/ttq-classic-resume/src/components.typ

@@ -22,24 +22,56 @@
 }
 
 // Shared skeleton of `entry`: a grid of left/right aligned header cells
-// followed by an optional bulleted body, kept together on one page.
-#let _entry(cfg, cells, body) = {
-  v(cfg.entry-spacing)
-  block(breakable: false, {
-    grid(columns: (1fr, auto), row-gutter: cfg.leading, ..cells)
+// followed by an optional bulleted body, kept together on one page. The gutter
+// keeps a left cell that wraps off the right one.
+#let _entry(cfg, cells, body) = block(
+  above: cfg.leading + cfg.rule-spacing,
+  below: cfg.leading + cfg.entry-spacing,
+  breakable: false,
+  {
+    grid(columns: (1fr, auto), column-gutter: 1em, row-gutter: cfg.leading, ..cells)
     if body != none {
       _bulleted(cfg, body)
     }
-  })
-}
+  },
+)
+
+// Sets the contacts on as few lines as hold them, a separator between two on
+// one line. A line therefore breaks only between contacts, and never starts or
+// ends on a separator. The spaces around the separator are real ones, so text
+// copied out of the PDF keeps the contacts apart.
+#let _contact-lines(cfg, contacts) = layout(region => {
+  // The separator's ink is centred on the x-height, where a middle dot sits,
+  // whatever glyph and size it is set in.
+  let glyph = text(size: cfg.contact-separator-size, cfg.contact-separator)
+  let extent(top, bottom, body) = measure(text(top-edge: top, bottom-edge: bottom, body)).height
+  let centre = extent("bounds", "baseline", glyph) - extent("bounds", "bounds", glyph) / 2
+  let separator = [ #box(
+      baseline: centre - extent("x-height", "baseline", [x]) / 2,
+      inset: (x: cfg.contact-separator-padding),
+      glyph,
+    ) ]
+  let lines = ()
+  let current = ()
+  for contact in contacts {
+    if current.len() > 0 and measure((..current, contact).join(separator)).width > region.width {
+      lines.push(current)
+      current = ()
+    }
+    current.push(contact)
+  }
+  lines.push(current)
+  lines.map(it => it.join(separator)).join(linebreak())
+})
 
 /// Name and contact line at the top of the resume.
 ///
 /// The name becomes the level 1 heading of the document, and — unless `title`
-/// and `author` say otherwise — the title and author of the exported PDF.
-/// Contacts are separated by a diamond and, with `link-contacts` left on, email
-/// addresses, web addresses and phone numbers among them become links. Pass
-/// ready-made content instead of a string to opt a single contact out.
+/// and `author` say otherwise — the title and author of the exported PDF. A
+/// `none` or empty name prints no heading and leaves both unset. With
+/// `link-contacts` left on, email addresses, web addresses and phone numbers
+/// among the contacts become links. Pass ready-made content instead of a
+/// string to opt a single contact out.
 #let resume-header(
   name: "",
   contacts: (),
@@ -48,28 +80,28 @@
   author: auto,
 ) = {
   // Only the metadata that resolves to something is set, so that passing
-  // `none` leaves Typst's own default in place.
+  // `none` leaves Typst's own default in place. An author is text only.
   let metadata = (:)
   let title = if title == auto { name } else { title }
   let author = if author == auto { name } else { author }
   if title not in (none, "") { metadata.title = title }
-  if author not in (none, "") { metadata.author = author }
+  if type(author) == str and author != "" { metadata.author = author }
   set document(..metadata)
 
-  with-config(cfg => {
-    heading(level: 1, name)
-    v(cfg.entry-spacing)
-
-    // A box rather than spaces, so that the padding is a real length and the
-    // separator still cannot be split from the contacts on either side.
-    let separator = box(
-      inset: (x: cfg.contact-separator-padding),
-      text(size: cfg.contact-separator-size, cfg.contact-separator),
-    )
-    contacts
-      .map(contact => if link-contacts { auto-link(contact) } else { contact })
-      .join(separator)
-  })
+  let named = name not in (none, "")
+  if named or contacts.len() > 0 {
+    with-config(cfg => block(below: cfg.leading + cfg.header-spacing, {
+      if named {
+        heading(level: 1, name)
+      }
+      if contacts.len() > 0 {
+        block(
+          above: cfg.leading + cfg.entry-spacing,
+          _contact-lines(cfg, contacts.map(contact => if link-contacts { auto-link(contact) } else { contact })),
+        )
+      }
+    }))
+  }
 }
 
 /// Section title with a rule underneath it, such as `Work Experience`.
@@ -85,8 +117,9 @@
 ///
 /// `dated` puts `dates` opposite `heading` and an optional italic second line
 /// (`subtitle` / `location`). `linked` puts `url` opposite `heading`, small
-/// and italic, and drops the second line. `body` is ordinary Typst markup —
-/// most often a `- item` list, which picks up the square bullet of the template.
+/// and italic, and drops the second line; a `url` given as a string becomes a
+/// link where a contact would. `body` is ordinary Typst markup — most often a
+/// `- item` list, which picks up the square bullet of the template.
 #let entry(
   heading: "",
   form: "dated",
@@ -109,7 +142,7 @@
         style: "italic",
         url,
       )
-      if type(url) == str and url.starts-with("http") { link(url, label) } else { label }
+      auto-link(url, body: label)
     }
     (align(left, text(weight: "bold", heading)), align(right, annotation))
   } else {
@@ -163,8 +196,8 @@
     item
   }
 
-  with-config(cfg => {
-    v(cfg.entry-spacing)
+  with-config(cfg => block(
+    above: cfg.leading + cfg.rule-spacing,
     pad(
       // Line the items up with the bullets of the entries around them.
       left: cfg.marker-size + cfg.marker-indent,
@@ -176,6 +209,6 @@
         column-gutter: 1em,
         ..items.map(cell),
       ),
-    )
-  })
+    ),
+  ))
 }