@quillmark/quiver 0.4.0 → 0.4.1

package/PROGRAM.md

@@ -160,7 +160,7 @@ Important implications:
 - No engine quill registry in the JS binding; no `registerQuill`, `hasQuill`, or engine-level `render(doc)` in Quiver’s flow
 - Quiver owns mapping from canonical ref → in-memory tree → `Quill` instance
 - Cache optimization is in-process reuse of `Quill` instances, not registration checks
-- Path-based loading (`quill_from_path`) exists in **other** bindings only; in Node, Quiver reads files and assembles `tree` for `engine.quill(tree)` (see upstream `references/quillmark/docs/integration/javascript/api.md`)
+- Path-based loading (`quill_from_path`) exists in **other** bindings only; in Node, Quiver reads files and assembles `tree` for `engine.quill(tree)` (see the upstream `@quillmark/wasm` JS/WASM API docs)
 
 For advanced dynamic-asset behavior, defer to Quillmark’s JS/WASM docs; the default integration path here is `engine.quill` + `quill.render`.
 
@@ -414,7 +414,7 @@ class QuiverError extends Error {
 
 **No render wrapper.** Callers invoke `quill.render(doc, opts?)` (and `quill.open(doc)` when needed) after `getQuill()`. Quiver never mirrors Quillmark render APIs.
 
-**Internal (not exported):** `QuiverManifest` (runtime shape), `parseQuillRef`, in-flight coalescing state, source-vs-built layout detection.
+**Internal (not exported):** `BuiltManifest` (runtime shape), `parseQuillRef`, in-flight coalescing state, source-vs-built layout detection.
 
 Hot-path flow:
 ```ts
@@ -441,7 +441,7 @@ const result = quill.render(doc, { format: "pdf" });
   test runners wire their own loops against the main API.
 
 **Dependencies:**
-- Peer: `@quillmark/wasm@>=0.59.0-rc.2` with `Quillmark`, `Document.fromMarkdown`, `engine.quill(tree)`, and `quill.render(doc, opts?)` APIs.
+- Peer: `@quillmark/wasm@>=0.59.0` with `Quillmark`, `Document.fromMarkdown`, `engine.quill(tree)`, and `quill.render(doc, opts?)` APIs.
 - Runtime: `fflate ^0.8.2` for zip read/write (Node + browser)
 - Dev-only: `node:crypto` (MD5 hashing in `build()` — never reached at runtime)
 - No test-runner peer dependency; `/testing` uses `node:test` (built-in)
@@ -477,17 +477,6 @@ All V1 planner questions resolved; implementation plan can proceed against the s
 
 ---
 
-## References
-
-Local copies in this repo for `@quillmark/quiver` implementation:
-
-- `references/quillmark-registry/` — prior `@quillmark/registry` source and patterns to mine or replace
-- `references/quillmark/docs/integration/javascript/api.md` — JS/WASM API this package integrates with
-- `references/quillmark/prose/designs/WASM.md` — WASM binding shape
-- `references/quillmark/prose/taskings/quill_render_api.md` — upstream render API overhaul (cross-binding; use the JS/WASM sections for Node)
-
----
-
 ## Success Criteria
 
 - A team can author and validate a Source Quiver locally with fast filesystem loops

package/dist/engine-types.d.ts

@@ -1,18 +1,18 @@
 /**
- * Minimal structural types matching @quillmark/wasm >=0.57.0 (verified against 0.59.0-rc.2).
+ * Minimal structural types matching @quillmark/wasm >=0.59.0.
  *
  * Shape:
  *   class Quillmark { quill(tree: Map<string, Uint8Array>): Quill }
  *   class Quill     { render(doc, opts?): RenderResult; open(doc): RenderSession }
  *
- * Note: as of 0.59.0-rc.2 the first arg to render/open is a `Document` instance
- * (from `Document.fromMarkdown(...)`), not the old `ParsedDocument` interface.
- * Quiver keeps the arg typed as `unknown` so consumers of either shape (and
- * test doubles) satisfy the contract structurally.
+ * The first arg to `render`/`open` is a `Document` instance (from
+ * `Document.fromMarkdown(...)`). Quiver keeps the arg typed as `unknown` so
+ * consumers (and test doubles) satisfy the contract structurally without
+ * importing from @quillmark/wasm.
  *
- * These types are INTERNAL — never re-exported from index.ts. They exist so
- * quiver.ts never imports from @quillmark/wasm directly and so test doubles
- * can satisfy the contract without pulling the real WASM module.
+ * These types are re-exported from `index.ts` so consumers can type their
+ * own engine wrappers / test doubles against them. Quiver itself never
+ * imports from @quillmark/wasm directly.
  *
  * Call-site note: Quiver never invokes `render` or `open` itself; consumers do
  * after `getQuill()`. The loose `unknown` parameter typing is intentional.

package/dist/engine-types.js

@@ -1,18 +1,18 @@
 /**
- * Minimal structural types matching @quillmark/wasm >=0.57.0 (verified against 0.59.0-rc.2).
+ * Minimal structural types matching @quillmark/wasm >=0.59.0.
  *
  * Shape:
  *   class Quillmark { quill(tree: Map<string, Uint8Array>): Quill }
  *   class Quill     { render(doc, opts?): RenderResult; open(doc): RenderSession }
  *
- * Note: as of 0.59.0-rc.2 the first arg to render/open is a `Document` instance
- * (from `Document.fromMarkdown(...)`), not the old `ParsedDocument` interface.
- * Quiver keeps the arg typed as `unknown` so consumers of either shape (and
- * test doubles) satisfy the contract structurally.
+ * The first arg to `render`/`open` is a `Document` instance (from
+ * `Document.fromMarkdown(...)`). Quiver keeps the arg typed as `unknown` so
+ * consumers (and test doubles) satisfy the contract structurally without
+ * importing from @quillmark/wasm.
  *
- * These types are INTERNAL — never re-exported from index.ts. They exist so
- * quiver.ts never imports from @quillmark/wasm directly and so test doubles
- * can satisfy the contract without pulling the real WASM module.
+ * These types are re-exported from `index.ts` so consumers can type their
+ * own engine wrappers / test doubles against them. Quiver itself never
+ * imports from @quillmark/wasm directly.
  *
  * Call-site note: Quiver never invokes `render` or `open` itself; consumers do
  * after `getQuill()`. The loose `unknown` parameter typing is intentional.

package/dist/testing.d.ts

@@ -9,7 +9,7 @@
  *
  *   import { Quillmark } from "@quillmark/wasm";
  *   import { runQuiverTests } from "@quillmark/quiver/testing";
- *   const engine = await Quillmark.load();
+ *   const engine = new Quillmark();
  *   runQuiverTests(import.meta.url, engine);
  *
  * Run with `node --test`.

package/dist/testing.js

@@ -9,7 +9,7 @@
  *
  *   import { Quillmark } from "@quillmark/wasm";
  *   import { runQuiverTests } from "@quillmark/quiver/testing";
- *   const engine = await Quillmark.load();
+ *   const engine = new Quillmark();
  *   runQuiverTests(import.meta.url, engine);
  *
  * Run with `node --test`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/quiver",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Quiver registry and build tooling for Quillmark",
   "type": "module",
   "license": "MIT",