@quillmark/wasm 0.117.0 → 0.118.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## v0.118.0 - 2026-09-30
+
+Upgrade path: [0.117 → 0.118](docs/migrations/0.117-to-0.118.md).
+
+### Kind seeds
+
+- feat(core,wasm,python)!: **a card kind declares `seed:`**, what
+  `seed_card` writes into a new card of that kind: the `$seed.<kind>` shape,
+  fields plus an optional `$body`. `seed_document()` carries each kind's seed,
+  and `schema()` emits it (WASM `QuillCardSchema.seed`). `CardSchema` gains a
+  public `seed` field. A document's `$seed.<kind>` replaces the kind's seed
+  whole, `$body` included, and `$seed.<kind>: {}` seeds nothing. A kind's
+  seed is checked as the card it makes and fails the load under
+  `quill::seed_*`, plus `quill::seed_redundant` for a seed that renders as the
+  unanswered field does; `main` declares none (`quill::invalid_card_schema`).
+  (#2016)
+
+### Document `$seed`
+
+- feat(core)!: **a document's `$seed` warns wherever the card it seeds
+  would**: an undeclared key below a seeded field
+  (`validation::unknown_field`), a cell outside its variant world
+  (`validation::out_of_variant`), a `$body` that is not a markdown string or
+  does not import (`validation::seed_overlay_shape`), and a seeded array past
+  its `max:` (`validation::cardinality`). `quillmark validate` fails a quill
+  whose `example.md` carries one. A `null` in `$seed.<kind>` commits nothing,
+  where the new card carried `field:`. (#2016)
+- refactor(cli): `quillmark validate` names `seed_document`'s output
+  `seeded` in its render report, where it said `seed`. (#2014)
+
+
 ## v0.117.0 - 2026-09-29
 
 Upgrade path: [0.116 → 0.117](docs/migrations/0.116-to-0.117.md).

package/README.md

@@ -223,8 +223,8 @@ values from the `Document` payload: there is no separate form-view projection.
 values are made up, pinned to the quill's `name@version`; `undefined` when
 the quill has no `example.md` at its root.
 
-`quill.seedDocument()` returns a starter document: one card per kind, each body
-empty, every field absent;
+`quill.seedDocument()` returns a starter document: one card per kind, each
+carrying the kind's `seed` from `Quill.yaml` and no other field;
 `quill.seedMain()` and `quill.seedCard(kind)` seed one card. All
 return the read `Card` shape of `doc.main` / `doc.cards`, which `doc.insertCard`
 accepts directly:

package/core/wasm.d.ts

@@ -461,6 +461,10 @@ export interface QuillCardSchema {
     fields: Record<string, QuillFieldSchema>;
     ui?: QuillCardUi;
     body?: QuillCardBody;
+    /** What `seedCard` writes into a new card of this kind where the
+     *  document's `$seed` carries no entry for it: the `$seed[kind]` shape, fields plus
+     *  an optional `$body`. Never present on `main`. */
+    seed?: Record<string, unknown>;
 }
 
 /**
@@ -840,19 +844,20 @@ export class Quill {
     parse(markdown: string): Document;
     /**
      * Seed a starter composable `Card` of the given kind (carries `$kind`),
-     * committing an optional per-kind seed `overlay`'s fields and `$body`
-     * (`overlay › absent`, body `overlay › empty`). `undefined` when
-     * `cardKind` is not declared in this quill's schema.
+     * committing an optional per-kind seed `overlay`'s fields and `$body` in
+     * place of the kind's own `seed`, else that seed's. `undefined` when `cardKind` is
+     * not declared in this quill's schema.
      *
      * Pass `document.seedOverlay(cardKind)` as `overlay` so a card added to a
      * template-derived document inherits its curated starting values; omit it
-     * for the bare schema seed.
+     * for a card carrying the kind's seed alone.
      */
     seedCard(card_kind: string, overlay: Record<string, unknown> | undefined): Card | undefined;
     /**
      * Seed a starter `Document` from the schema: the main card plus one instance
-     * of each composable card kind, each body empty and every field absent
-     * (interpolated at render as `default:`, else the field's blank).
+     * of each composable card kind, each carrying its kind's `seed` and every
+     * other field absent (interpolated at render as `default:`, else the
+     * field's blank).
      */
     seedDocument(): Document;
     /**

package/core/wasm.js

@@ -1367,13 +1367,13 @@ export class Quill {
     }
     /**
      * Seed a starter composable `Card` of the given kind (carries `$kind`),
-     * committing an optional per-kind seed `overlay`'s fields and `$body`
-     * (`overlay › absent`, body `overlay › empty`). `undefined` when
-     * `cardKind` is not declared in this quill's schema.
+     * committing an optional per-kind seed `overlay`'s fields and `$body` in
+     * place of the kind's own `seed`, else that seed's. `undefined` when `cardKind` is
+     * not declared in this quill's schema.
      *
      * Pass `document.seedOverlay(cardKind)` as `overlay` so a card added to a
      * template-derived document inherits its curated starting values; omit it
-     * for the bare schema seed.
+     * for a card carrying the kind's seed alone.
      * @param {string} card_kind
      * @param {Record<string, unknown> | undefined} overlay
      * @returns {Card | undefined}
@@ -1397,8 +1397,9 @@ export class Quill {
     }
     /**
      * Seed a starter `Document` from the schema: the main card plus one instance
-     * of each composable card kind, each body empty and every field absent
-     * (interpolated at render as `default:`, else the field's blank).
+     * of each composable card kind, each carrying its kind's `seed` and every
+     * other field absent (interpolated at render as `default:`, else the
+     * field's blank).
      * @returns {Document}
      */
     seedDocument() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.117.0",
+  "version": "0.118.0",
   "description": "WebAssembly bindings for Quillmark, a schema-driven document engine",
   "type": "module",
   "license": "Apache-2.0",

package/render/wasm.d.ts

@@ -472,6 +472,10 @@ export interface QuillCardSchema {
     fields: Record<string, QuillFieldSchema>;
     ui?: QuillCardUi;
     body?: QuillCardBody;
+    /** What `seedCard` writes into a new card of this kind where the
+     *  document's `$seed` carries no entry for it: the `$seed[kind]` shape, fields plus
+     *  an optional `$body`. Never present on `main`. */
+    seed?: Record<string, unknown>;
 }
 
 /**
@@ -1073,19 +1077,20 @@ export class Quill {
     parse(markdown: string): Document;
     /**
      * Seed a starter composable `Card` of the given kind (carries `$kind`),
-     * committing an optional per-kind seed `overlay`'s fields and `$body`
-     * (`overlay › absent`, body `overlay › empty`). `undefined` when
-     * `cardKind` is not declared in this quill's schema.
+     * committing an optional per-kind seed `overlay`'s fields and `$body` in
+     * place of the kind's own `seed`, else that seed's. `undefined` when `cardKind` is
+     * not declared in this quill's schema.
      *
      * Pass `document.seedOverlay(cardKind)` as `overlay` so a card added to a
      * template-derived document inherits its curated starting values; omit it
-     * for the bare schema seed.
+     * for a card carrying the kind's seed alone.
      */
     seedCard(card_kind: string, overlay: Record<string, unknown> | undefined): Card | undefined;
     /**
      * Seed a starter `Document` from the schema: the main card plus one instance
-     * of each composable card kind, each body empty and every field absent
-     * (interpolated at render as `default:`, else the field's blank).
+     * of each composable card kind, each carrying its kind's `seed` and every
+     * other field absent (interpolated at render as `default:`, else the
+     * field's blank).
      */
     seedDocument(): Document;
     /**

package/render/wasm.js

@@ -1688,13 +1688,13 @@ export class Quill {
     }
     /**
      * Seed a starter composable `Card` of the given kind (carries `$kind`),
-     * committing an optional per-kind seed `overlay`'s fields and `$body`
-     * (`overlay › absent`, body `overlay › empty`). `undefined` when
-     * `cardKind` is not declared in this quill's schema.
+     * committing an optional per-kind seed `overlay`'s fields and `$body` in
+     * place of the kind's own `seed`, else that seed's. `undefined` when `cardKind` is
+     * not declared in this quill's schema.
      *
      * Pass `document.seedOverlay(cardKind)` as `overlay` so a card added to a
      * template-derived document inherits its curated starting values; omit it
-     * for the bare schema seed.
+     * for a card carrying the kind's seed alone.
      * @param {string} card_kind
      * @param {Record<string, unknown> | undefined} overlay
      * @returns {Card | undefined}
@@ -1718,8 +1718,9 @@ export class Quill {
     }
     /**
      * Seed a starter `Document` from the schema: the main card plus one instance
-     * of each composable card kind, each body empty and every field absent
-     * (interpolated at render as `default:`, else the field's blank).
+     * of each composable card kind, each carrying its kind's `seed` and every
+     * other field absent (interpolated at render as `default:`, else the
+     * field's blank).
      * @returns {Document}
      */
     seedDocument() {