@quillmark/wasm 0.100.0 → 0.101.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## v0.101.0 - 2026-08-03
+
+- refactor(core): gate the raw-plate seam behind a feature, and fixes from review
+- docs(core): state the conform gate's codes instead of linking a private item
+- refactor(core): bind a live session to its quill so apply takes a Document
+- feat(quillmark): the facade names what the read and preview flows return
+- docs(content,wasm): density pass over the island channel's prose
+- feat(content,core,wasm)!: reach islands through the op vocabulary
+- refactor(core)!: `Payload` becomes a read view
+- refactor(core)!: collapse the schema-free field projection
+- refactor(core)!: fold `Quill`'s file queries into `FileTreeNode`
+- fix(core): repoint the doc references the `from_yaml` removal orphaned
+- refactor(quillmark): move the facade gate off the front page, and stop tests reaching past it
+- docs: migration guide for the 0.101 surface removals
+- refactor(core)!: drop the lossy `QuillConfig::from_yaml`
+- refactor(core)!: `Document::from_main_and_cards` becomes crate-internal
+- feat(quillmark): the facade covers authoring, and the examples enter through the bound door
+
+
 ## v0.100.0 - 2026-08-03
 
 A content field gets one resting form, and the last reserved `$` key with no

package/backends/pdfform/wasm.d.ts

@@ -240,13 +240,42 @@ export type LineOp =
 | { op: "setContainers"; line: number; containers: ContentContainer[] }
 | { op: "setContinues"; line: number; continues: boolean };
 
+/**
+ * An island edit: the only channel that reaches an island's payload, a table's
+ * cells or an image's url.
+ *
+ * Both ops move one island entry and leave the field's text and marks alone, so
+ * an island edit keeps every identity anchor in the field. That is why a table
+ * edit lowers to `applyChange` rather than `install`, which drops them all.
+ *
+ * `set` addresses an existing island by `id`; an `id` no island carries throws
+ * rather than passing silently. `insert` places a new island's slot at `at` (a
+ * post-delta USV position) together with its entry, so a slot never exists
+ * without an island behind it; its `id` must be non-empty and unused. Deleting
+ * an island needs no op: a `delta` that removes its slot drops the island.
+ *
+ * A `set` stores the `loss` it is given: nothing re-derives the class from the
+ * new `props`, so a write that changes what markdown can carry must say so.
+ *
+ * An island is *inline* (a slot inside a paragraph) unless its line says
+ * otherwise. A **block** island is one bundle of all three channels, in the
+ * order they apply: `delta` inserts the `\n` that opens the line, `islandOps`
+ * inserts the slot, `lineOps` tags the line `{ op: "setKind", kind: "island" }`.
+ * `{ op: "split" }` cannot open that line, since line ops run after island ops.
+ */
+export type IslandOp =
+| ({ op: "set" } & ContentIsland)
+| ({ op: "insert"; at: number } & ContentIsland);
+
 /**
  * A committed content edit bundle for `applyChange`: a text `delta` (default no
- * text change), then `lineOps`, then `markOps` (mark ranges are in post-delta
- * coordinates). Every field is optional.
+ * text change), then `islandOps`, then `lineOps`, then `markOps` (mark ranges
+ * are in final-text coordinates: every earlier channel applied). Every field is
+ * optional.
  */
 export interface ChangeBundle {
     delta?: Delta;
+    islandOps?: IslandOp[];
     lineOps?: LineOp[];
     markOps?: MarkOp[];
 }
@@ -722,11 +751,16 @@ export class Document {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr`, the editor splice: text delta first, then line ops, then mark
-     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * **Apply** a committed content edit `bundle`
+     * (`{ delta?, islandOps?, lineOps?, markOps? }`) at `addr`, the editor
+     * splice: text delta first, then island ops, then line ops, then mark ops
+     * (mark ranges in final-text coordinates), each all-or-nothing. An absent
      * `addr.field` targets the body, an absent `addr.card` the main card.
      *
+     * The island channel keeps a table or image edit on the op path: it moves
+     * the island alone, so the anchors elsewhere in the field survive an edit
+     * `install` would clear.
+     *
      * Throws on an out-of-range card, a field that is not richtext, a malformed
      * bundle, or an op that applies out of bounds (the value is unchanged on a
      * failed apply).

package/backends/pdfform/wasm_bg.js

@@ -251,11 +251,16 @@ export class Document {
         }
     }
     /**
-     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr`, the editor splice: text delta first, then line ops, then mark
-     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * **Apply** a committed content edit `bundle`
+     * (`{ delta?, islandOps?, lineOps?, markOps? }`) at `addr`, the editor
+     * splice: text delta first, then island ops, then line ops, then mark ops
+     * (mark ranges in final-text coordinates), each all-or-nothing. An absent
      * `addr.field` targets the body, an absent `addr.card` the main card.
      *
+     * The island channel keeps a table or image edit on the op path: it moves
+     * the island alone, so the anchors elsewhere in the field survive an edit
+     * `install` would clear.
+     *
      * Throws on an out-of-range card, a field that is not richtext, a malformed
      * bundle, or an op that applies out of bounds (the value is unchanged on a
      * failed apply).

package/backends/typst/wasm.d.ts

@@ -240,13 +240,42 @@ export type LineOp =
 | { op: "setContainers"; line: number; containers: ContentContainer[] }
 | { op: "setContinues"; line: number; continues: boolean };
 
+/**
+ * An island edit: the only channel that reaches an island's payload, a table's
+ * cells or an image's url.
+ *
+ * Both ops move one island entry and leave the field's text and marks alone, so
+ * an island edit keeps every identity anchor in the field. That is why a table
+ * edit lowers to `applyChange` rather than `install`, which drops them all.
+ *
+ * `set` addresses an existing island by `id`; an `id` no island carries throws
+ * rather than passing silently. `insert` places a new island's slot at `at` (a
+ * post-delta USV position) together with its entry, so a slot never exists
+ * without an island behind it; its `id` must be non-empty and unused. Deleting
+ * an island needs no op: a `delta` that removes its slot drops the island.
+ *
+ * A `set` stores the `loss` it is given: nothing re-derives the class from the
+ * new `props`, so a write that changes what markdown can carry must say so.
+ *
+ * An island is *inline* (a slot inside a paragraph) unless its line says
+ * otherwise. A **block** island is one bundle of all three channels, in the
+ * order they apply: `delta` inserts the `\n` that opens the line, `islandOps`
+ * inserts the slot, `lineOps` tags the line `{ op: "setKind", kind: "island" }`.
+ * `{ op: "split" }` cannot open that line, since line ops run after island ops.
+ */
+export type IslandOp =
+| ({ op: "set" } & ContentIsland)
+| ({ op: "insert"; at: number } & ContentIsland);
+
 /**
  * A committed content edit bundle for `applyChange`: a text `delta` (default no
- * text change), then `lineOps`, then `markOps` (mark ranges are in post-delta
- * coordinates). Every field is optional.
+ * text change), then `islandOps`, then `lineOps`, then `markOps` (mark ranges
+ * are in final-text coordinates: every earlier channel applied). Every field is
+ * optional.
  */
 export interface ChangeBundle {
     delta?: Delta;
+    islandOps?: IslandOp[];
     lineOps?: LineOp[];
     markOps?: MarkOp[];
 }
@@ -722,11 +751,16 @@ export class Document {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr`, the editor splice: text delta first, then line ops, then mark
-     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * **Apply** a committed content edit `bundle`
+     * (`{ delta?, islandOps?, lineOps?, markOps? }`) at `addr`, the editor
+     * splice: text delta first, then island ops, then line ops, then mark ops
+     * (mark ranges in final-text coordinates), each all-or-nothing. An absent
      * `addr.field` targets the body, an absent `addr.card` the main card.
      *
+     * The island channel keeps a table or image edit on the op path: it moves
+     * the island alone, so the anchors elsewhere in the field survive an edit
+     * `install` would clear.
+     *
      * Throws on an out-of-range card, a field that is not richtext, a malformed
      * bundle, or an op that applies out of bounds (the value is unchanged on a
      * failed apply).

package/backends/typst/wasm_bg.js

@@ -251,11 +251,16 @@ export class Document {
         }
     }
     /**
-     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr`, the editor splice: text delta first, then line ops, then mark
-     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * **Apply** a committed content edit `bundle`
+     * (`{ delta?, islandOps?, lineOps?, markOps? }`) at `addr`, the editor
+     * splice: text delta first, then island ops, then line ops, then mark ops
+     * (mark ranges in final-text coordinates), each all-or-nothing. An absent
      * `addr.field` targets the body, an absent `addr.card` the main card.
      *
+     * The island channel keeps a table or image edit on the op path: it moves
+     * the island alone, so the anchors elsewhere in the field survive an edit
+     * `install` would clear.
+     *
      * Throws on an out-of-range card, a field that is not richtext, a malformed
      * bundle, or an op that applies out of bounds (the value is unchanged on a
      * failed apply).

package/core/wasm.d.ts

@@ -240,13 +240,42 @@ export type LineOp =
 | { op: "setContainers"; line: number; containers: ContentContainer[] }
 | { op: "setContinues"; line: number; continues: boolean };
 
+/**
+ * An island edit: the only channel that reaches an island's payload, a table's
+ * cells or an image's url.
+ *
+ * Both ops move one island entry and leave the field's text and marks alone, so
+ * an island edit keeps every identity anchor in the field. That is why a table
+ * edit lowers to `applyChange` rather than `install`, which drops them all.
+ *
+ * `set` addresses an existing island by `id`; an `id` no island carries throws
+ * rather than passing silently. `insert` places a new island's slot at `at` (a
+ * post-delta USV position) together with its entry, so a slot never exists
+ * without an island behind it; its `id` must be non-empty and unused. Deleting
+ * an island needs no op: a `delta` that removes its slot drops the island.
+ *
+ * A `set` stores the `loss` it is given: nothing re-derives the class from the
+ * new `props`, so a write that changes what markdown can carry must say so.
+ *
+ * An island is *inline* (a slot inside a paragraph) unless its line says
+ * otherwise. A **block** island is one bundle of all three channels, in the
+ * order they apply: `delta` inserts the `\n` that opens the line, `islandOps`
+ * inserts the slot, `lineOps` tags the line `{ op: "setKind", kind: "island" }`.
+ * `{ op: "split" }` cannot open that line, since line ops run after island ops.
+ */
+export type IslandOp =
+| ({ op: "set" } & ContentIsland)
+| ({ op: "insert"; at: number } & ContentIsland);
+
 /**
  * A committed content edit bundle for `applyChange`: a text `delta` (default no
- * text change), then `lineOps`, then `markOps` (mark ranges are in post-delta
- * coordinates). Every field is optional.
+ * text change), then `islandOps`, then `lineOps`, then `markOps` (mark ranges
+ * are in final-text coordinates: every earlier channel applied). Every field is
+ * optional.
  */
 export interface ChangeBundle {
     delta?: Delta;
+    islandOps?: IslandOp[];
     lineOps?: LineOp[];
     markOps?: MarkOp[];
 }
@@ -470,11 +499,16 @@ export class Document {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr`, the editor splice: text delta first, then line ops, then mark
-     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * **Apply** a committed content edit `bundle`
+     * (`{ delta?, islandOps?, lineOps?, markOps? }`) at `addr`, the editor
+     * splice: text delta first, then island ops, then line ops, then mark ops
+     * (mark ranges in final-text coordinates), each all-or-nothing. An absent
      * `addr.field` targets the body, an absent `addr.card` the main card.
      *
+     * The island channel keeps a table or image edit on the op path: it moves
+     * the island alone, so the anchors elsewhere in the field survive an edit
+     * `install` would clear.
+     *
      * Throws on an out-of-range card, a field that is not richtext, a malformed
      * bundle, or an op that applies out of bounds (the value is unchanged on a
      * failed apply).

package/core/wasm_bg.js

@@ -251,11 +251,16 @@ export class Document {
         }
     }
     /**
-     * **Apply** a committed content edit `bundle` (`{ delta?, lineOps?, markOps? }`)
-     * at `addr`, the editor splice: text delta first, then line ops, then mark
-     * ops (mark ranges in final-text coordinates), each all-or-nothing. An absent
+     * **Apply** a committed content edit `bundle`
+     * (`{ delta?, islandOps?, lineOps?, markOps? }`) at `addr`, the editor
+     * splice: text delta first, then island ops, then line ops, then mark ops
+     * (mark ranges in final-text coordinates), each all-or-nothing. An absent
      * `addr.field` targets the body, an absent `addr.card` the main card.
      *
+     * The island channel keeps a table or image edit on the op path: it moves
+     * the island alone, so the anchors elsewhere in the field survive an edit
+     * `install` would clear.
+     *
      * Throws on an out-of-range card, a field that is not richtext, a malformed
      * bundle, or an op that applies out of bounds (the value is unchanged on a
      * failed apply).

package/package.json

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

package/runtime/runtime.d.ts

@@ -84,6 +84,7 @@ export type {
 	CardAddr,
 	Delta,
 	Assoc,
+	IslandOp,
 	LineOp,
 	MarkOp,
 	ChangeBundle,