@quillmark/wasm 0.85.0 → 0.86.0

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+## v0.86.0 - 2026-05-31
+
+Documents now render even when incomplete, the canonical card-yaml fence
+becomes a bare `~~~`, and the way placeholder/illustrative values are
+produced is reworked. This release also fixes two markdown→Typst
+conversion bugs and stamps a PDF `/Producer` field.
+
+### Breaking changes
+
+- **Bare `~~~` is now the canonical card-yaml fence** (was `~~~card-yaml`)
+  (#662). Existing `~~~card-yaml` documents still parse, but `to_markdown`
+  re-emits the bare `~~~` form, so a document's canonical bytes change on
+  its first re-emit (relevant if you content-hash or byte-compare emitted
+  markdown, or store blueprint goldens). A side effect: a column-zero
+  `~~~` fence in a prose body is now read as a card-yaml block — use a
+  backtick fence or a non-`card-yaml` info string (e.g. `~~~rust`) for a
+  literal code block. Full details and corpus-migration steps:
+  `docs/migrations/0.85-to-0.86.md`.
+- **`fill_blueprint()` removed** from `quillmark_core` and `quillmark`,
+  along with its re-exports (#657, #665). Callers no longer post-process a
+  blueprint string: fillable/illustrative documents come from
+  `QuillConfig::example()`, and the render path fills placeholders itself
+  (see below).
+
+### Behavioral changes
+
+- **Incomplete documents render instead of erroring** (#665). An absent
+  Must Fill field is no longer a render error. On the render path each
+  schema field resolves to its authored value, else its `default:`, else a
+  type-empty zero value — applied to the plate projection only, never
+  persisted to the document. Only malformed input stays fatal: a surviving
+  `<must-fill>` sentinel, or a value that won't coerce/validate.
+  `quill.form(doc)` still reports completeness independently of the render
+  gate.
+- **`default` vs `example` clarified** (#665, #663, #658). `default` is the
+  value most authors want and is interpolated when a field is omitted (an
+  authored value always wins); `example` documents a field's shape only and
+  never renders into output. Preview and illustrative fills now draw from a
+  field's `example:` when present, falling back to the leanest type-valid
+  value (`""`, `0`, `false`, `[]`, `{}`, first enum variant, empty body).
+
+### Markdown → Typst fixes (#661)
+
+- Code is now emitted as `#raw(...)` with a string literal instead of a
+  backtick fence. This fixes fenced or inline code whose content contained
+  a run of three-or-more backticks, which previously closed the block early
+  and rendered as markup.
+- Ordered-list start numbers are preserved — a list written `3.` / `4.` now
+  renders starting at 3 instead of restarting at 1.
+
+### New API
+
+- `QuillConfig::example()`, plus `example` getters on the Python and WASM
+  bindings (#665).
+- `quillmark_core::zero_value` — the single source of truth for a field's
+  type-minimal value, shared by blueprint emission and the render path
+  (#665).
+- `RenderOptions.producer` on the core, WASM, and Python render APIs (#656)
+  — overrides the PDF `/Info` `/Producer` string, which now defaults to
+  `Quillmark <version>` on every Typst-rendered PDF.
+
+### Other fixes
+
+- PDF rendering folds the `/Producer` stamp and the signature-field
+  AcroForm injection into a single incremental-update pass, preserving
+  Typst's `/Creator` (#656).
+- `usaf_memo`: the signature widget is now overlaid at the 4.5in signature
+  block (AFH 33-337) instead of the 1in left margin, and no longer consumes
+  layout flow that could push the block out of position (#660); empty
+  signature fields no longer carry the `APPEND_ONLY` flag (#654).
+

package/README.md

@@ -34,7 +34,7 @@ import { Document, Quillmark } from "@quillmark-test/wasm";
 const engine = new Quillmark();
 const quill = engine.quill(tree);
 
-const markdown = `~~~card-yaml
+const markdown = `~~~
 $quill: my_quill
 $kind: main
 title: My Document
@@ -316,12 +316,19 @@ try {
 
 ## Notes
 
-- Parsed markdown requires a root `~~~card-yaml` block with a
-  `$quill` system-metadata line. Empty input surfaces a dedicated
+- Parsed markdown requires a root `~~~` block (a bare three-tilde fence;
+  the legacy `~~~card-yaml` opener is still accepted but non-canonical)
+  with a `$quill` system-metadata line. Empty input surfaces a dedicated
   "Empty markdown input cannot be parsed" message.
 - QUILL mismatch during `quill.render(parsed)` is a warning (`quill::ref_mismatch`), not an error.
 - Output schema APIs are no longer engine-level in WASM.
 
+## Changelog
+
+See the [changelog](https://github.com/quillmark-org/quillmark/blob/main/CHANGELOG.md)
+and the [GitHub Releases](https://github.com/quillmark-org/quillmark/releases) page for
+release notes and version history.
+
 ## License
 
 Apache-2.0

package/bundler/wasm.d.ts

@@ -113,7 +113,8 @@ export interface QuillCardBody {
  * without a `default` is **Must Fill** (the blueprint carries a
  * `<must-fill>` sentinel and validation reports
  * `validation::must_fill_absent` if the field is absent at validate
- * time). There is no separate `required` axis.
+ * time — a non-fatal signal, since the render path zero-fills an absent
+ * field). There is no separate `required` axis.
  */
 export interface QuillFieldSchema {
     type: "string" | "number" | "integer" | "boolean" | "array" | "object" | "date" | "datetime" | "markdown";
@@ -234,6 +235,7 @@ export interface RenderOptions {
     format?: OutputFormat;
     ppi?: number;
     pages?: number[];
+    producer?: string;
 }
 
 export interface RenderResult {
@@ -427,6 +429,13 @@ export class Quill {
      */
     readonly backendId: string;
     readonly blueprint: string;
+    /**
+     * The `example` reference document — the illustrative "show me a
+     * filled-out one." Each field renders its `example:`, else its
+     * `default:`, else the type-empty zero value, with no `<must-fill>`
+     * sentinels. See `prose/canon/BLUEPRINT.md`.
+     */
+    readonly example: string;
     /**
      * Identity snapshot of the `quill:` section of `Quill.yaml`, plus
      * `supportedFormats` and any extra `quill:` keys.

package/bundler/wasm_bg.js

@@ -664,6 +664,29 @@ export class Quill {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * The `example` reference document — the illustrative "show me a
+     * filled-out one." Each field renders its `example:`, else its
+     * `default:`, else the type-empty zero value, with no `<must-fill>`
+     * sentinels. See `prose/canon/BLUEPRINT.md`.
+     * @returns {string}
+     */
+    get example() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.quill_example(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * The schema-aware form view of `doc`. Read-only snapshot at call time;
      * subsequent edits to `doc` require calling `form` again.

package/bundler/wasm_bg.wasm.d.ts

@@ -40,6 +40,7 @@ export const quill_backendId: (a: number, b: number) => void;
 export const quill_blankCard: (a: number, b: number, c: number, d: number) => void;
 export const quill_blankMain: (a: number, b: number) => void;
 export const quill_blueprint: (a: number, b: number) => void;
+export const quill_example: (a: number, b: number) => void;
 export const quill_form: (a: number, b: number, c: number) => void;
 export const quill_metadata: (a: number) => number;
 export const quill_open: (a: number, b: number, c: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.85.0",
+  "version": "0.86.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",
@@ -16,7 +16,8 @@
     "bundler/wasm_bg.js",
     "bundler/wasm_bg.wasm.d.ts",
     "bundler/wasm.js",
-    "bundler/wasm.d.ts"
+    "bundler/wasm.d.ts",
+    "CHANGELOG.md"
   ],
   "main": "./bundler/wasm.js",
   "module": "./bundler/wasm.js",