@airmark/quiver 0.33.0 → 0.35.0

package/quills/classic_resume/{0.0.1 → 0.1.0}/Quill.yaml

@@ -1,6 +1,6 @@
 quill:
   name: classic_resume
-  version: 0.0.1
+  version: 0.1.0
   backend: typst
   description: Classic single-page resume
 
@@ -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, so a summary that is the first card sits 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: ""
+    description: "Jobs, most recent first: employer and dates on the first line, role and location on the second, details under them. Prose written under the card prints under the heading, ahead of the jobs."
+    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."
+        description: "One row per job. A row is kept to one page, unless it is taller than a page."
 
   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
+    description: "Schools, most recent first: school and date on the first line, degree and location on the second. Prose written under the card prints under the heading, ahead of the schools."
+    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. Prose written under the card prints under the heading, ahead of the groups."
+    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. Leave blank to print the items alone."
+            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. Prose written under the card prints under the heading, ahead of the projects."
+    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, an email address or a phone number 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. Prose written under the card prints under the heading, ahead of the list."
+    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
+    description: "A section the kinds above do not name — volunteer work, military service, publications, a competition. Rows take the Experience shape with neutral names. Prose written under the card prints under the heading, ahead of the rows."
+    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.1.0/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.
+~~~