@rtif-sdk/test-kit 1.0.0 → 1.2.0

package/dist/assertions.d.ts

@@ -3,11 +3,45 @@
  */
 import type { Document, Selection } from '@rtif-sdk/core';
 /**
- * Assert that two documents are structurally equal (ignoring block IDs).
+ * Options for `assertDocEqual`.
  */
-export declare function assertDocEqual(_actual: Document, _expected: Document): void;
+export interface DocEqualOptions {
+    /**
+     * When true, block IDs must also match.
+     * Default: false (block IDs are ignored).
+     */
+    compareIds?: boolean;
+}
+/**
+ * Assert that two documents are structurally equal.
+ *
+ * By default, block IDs are ignored — only block content (type, spans, attrs)
+ * and document-level properties (version, meta) are compared.
+ * Pass `{ compareIds: true }` to also require matching block IDs.
+ *
+ * @param actual - The actual document
+ * @param expected - The expected document
+ * @param options - Comparison options
+ * @throws {Error} If the documents are not structurally equal
+ *
+ * @example
+ * ```ts
+ * assertDocEqual(result.doc, expected);
+ * assertDocEqual(result.doc, expected, { compareIds: true });
+ * ```
+ */
+export declare function assertDocEqual(actual: Document, expected: Document, options?: DocEqualOptions): void;
 /**
  * Assert that two selections are equal.
+ *
+ * @param actual - The actual selection
+ * @param expected - The expected selection
+ * @throws {Error} If the selections differ
+ *
+ * @example
+ * ```ts
+ * assertSelectionEqual(engine.state.selection, sel(0, 5));
+ * ```
  */
 export declare function assertSelectionEqual(actual: Selection, expected: Selection): void;
 //# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI,CAG3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,CAUjF"}
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CA8BN;AA2ED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,CAUjF"}

package/dist/assertions.js

@@ -2,20 +2,151 @@
  * Custom test assertions for RTIF documents and selections.
  */
 /**
- * Assert that two documents are structurally equal (ignoring block IDs).
+ * Assert that two documents are structurally equal.
+ *
+ * By default, block IDs are ignored — only block content (type, spans, attrs)
+ * and document-level properties (version, meta) are compared.
+ * Pass `{ compareIds: true }` to also require matching block IDs.
+ *
+ * @param actual - The actual document
+ * @param expected - The expected document
+ * @param options - Comparison options
+ * @throws {Error} If the documents are not structurally equal
+ *
+ * @example
+ * ```ts
+ * assertDocEqual(result.doc, expected);
+ * assertDocEqual(result.doc, expected, { compareIds: true });
+ * ```
  */
-export function assertDocEqual(_actual, _expected) {
-    // TODO: Implement deep structural comparison
-    throw new Error('assertDocEqual() not yet implemented');
+export function assertDocEqual(actual, expected, options) {
+    const compareIds = options?.compareIds ?? false;
+    // Version
+    if (actual.version !== expected.version) {
+        throw new Error(`Document version mismatch: got ${String(actual.version)}, expected ${String(expected.version)}`);
+    }
+    // Block count
+    if (actual.blocks.length !== expected.blocks.length) {
+        throw new Error(`Block count mismatch: got ${String(actual.blocks.length)}, expected ${String(expected.blocks.length)}`);
+    }
+    // Blocks
+    for (let i = 0; i < expected.blocks.length; i++) {
+        const aBlock = actual.blocks[i];
+        const eBlock = expected.blocks[i];
+        assertBlockEqual(aBlock, eBlock, i, compareIds);
+    }
+    // Meta
+    if (!deepEqual(actual.meta, expected.meta)) {
+        throw new Error(`Document meta mismatch:\n  got:      ${JSON.stringify(actual.meta)}\n  expected: ${JSON.stringify(expected.meta)}`);
+    }
+}
+/**
+ * Assert that two blocks are structurally equal.
+ */
+function assertBlockEqual(actual, expected, index, compareIds) {
+    const prefix = `Block[${String(index)}]`;
+    // ID (optional)
+    if (compareIds && actual.id !== expected.id) {
+        throw new Error(`${prefix} id mismatch: got "${actual.id}", expected "${expected.id}"`);
+    }
+    // Type
+    if (actual.type !== expected.type) {
+        throw new Error(`${prefix} type mismatch: got "${actual.type}", expected "${expected.type}"`);
+    }
+    // Span count
+    if (actual.spans.length !== expected.spans.length) {
+        throw new Error(`${prefix} span count mismatch: got ${String(actual.spans.length)}, expected ${String(expected.spans.length)}\n` +
+            `  got:      ${JSON.stringify(actual.spans)}\n` +
+            `  expected: ${JSON.stringify(expected.spans)}`);
+    }
+    // Spans
+    for (let j = 0; j < expected.spans.length; j++) {
+        const aSpan = actual.spans[j];
+        const eSpan = expected.spans[j];
+        assertSpanEqual(aSpan, eSpan, index, j);
+    }
+    // Attrs
+    if (!deepEqual(normalizeAttrs(actual.attrs), normalizeAttrs(expected.attrs))) {
+        throw new Error(`${prefix} attrs mismatch:\n  got:      ${JSON.stringify(actual.attrs)}\n  expected: ${JSON.stringify(expected.attrs)}`);
+    }
+}
+/**
+ * Assert that two spans are structurally equal.
+ */
+function assertSpanEqual(actual, expected, blockIndex, spanIndex) {
+    const prefix = `Block[${String(blockIndex)}].Span[${String(spanIndex)}]`;
+    if (actual.text !== expected.text) {
+        throw new Error(`${prefix} text mismatch: got "${actual.text}", expected "${expected.text}"`);
+    }
+    if (!marksDeepEqual(actual.marks, expected.marks)) {
+        throw new Error(`${prefix} marks mismatch:\n  got:      ${JSON.stringify(actual.marks)}\n  expected: ${JSON.stringify(expected.marks)}`);
+    }
 }
 /**
  * Assert that two selections are equal.
+ *
+ * @param actual - The actual selection
+ * @param expected - The expected selection
+ * @throws {Error} If the selections differ
+ *
+ * @example
+ * ```ts
+ * assertSelectionEqual(engine.state.selection, sel(0, 5));
+ * ```
  */
 export function assertSelectionEqual(actual, expected) {
     if (actual.anchor.offset !== expected.anchor.offset ||
         actual.focus.offset !== expected.focus.offset) {
-        throw new Error(`Selection mismatch: got (${actual.anchor.offset}, ${actual.focus.offset}), ` +
-            `expected (${expected.anchor.offset}, ${expected.focus.offset})`);
+        throw new Error(`Selection mismatch: got (${String(actual.anchor.offset)}, ${String(actual.focus.offset)}), ` +
+            `expected (${String(expected.anchor.offset)}, ${String(expected.focus.offset)})`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Normalize attrs: treat undefined and empty object as equivalent (both → undefined).
+ */
+function normalizeAttrs(attrs) {
+    if (attrs === undefined)
+        return undefined;
+    if (Object.keys(attrs).length === 0)
+        return undefined;
+    return attrs;
+}
+/**
+ * Compare marks with RTIF semantics: undefined and {} are equal.
+ */
+function marksDeepEqual(a, b) {
+    const aNorm = a === undefined || Object.keys(a).length === 0 ? undefined : a;
+    const bNorm = b === undefined || Object.keys(b).length === 0 ? undefined : b;
+    return deepEqual(aNorm, bNorm);
+}
+/**
+ * Simple deep equality for JSON-serializable values.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (a === undefined || b === undefined)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a === 'object' && typeof b === 'object') {
+        const aObj = a;
+        const bObj = b;
+        const aKeys = Object.keys(aObj);
+        const bKeys = Object.keys(bObj);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        for (const key of aKeys) {
+            if (!deepEqual(aObj[key], bObj[key]))
+                return false;
+        }
+        return true;
     }
+    return false;
 }
 //# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAiB,EAAE,SAAmB;IACnE,6CAA6C;IAC7C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,QAAmB;IACzE,IACE,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM;QAC/C,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,EAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK;YAC3E,aAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CACnE,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"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"}

package/dist/builders.d.ts

@@ -1,25 +1,214 @@
 /**
- * Fluent document builders for tests.
- * See SPEC.md Appendix C for usage examples.
+ * Fluent document builders and fixture factories for RTIF tests.
+ *
+ * @example
+ * ```ts
+ * import { doc, span, sel, emptyDoc, textDoc } from '@rtif-sdk/test-kit';
+ *
+ * // Plain text block
+ * const d1 = doc().block('Hello').build();
+ *
+ * // Block with formatted spans
+ * const d2 = doc()
+ *   .block(span('Hello '), span('world', { bold: true }), span('!'))
+ *   .build();
+ *
+ * // Block with type, attrs, and custom ID
+ * const d3 = doc()
+ *   .block('Title').type('heading').attrs({ level: 1 }).id('h1')
+ *   .block('Body text')
+ *   .meta({ title: 'My Doc' })
+ *   .build();
+ *
+ * // Common fixtures
+ * const empty = emptyDoc();
+ * const simple = textDoc('hello');
+ * ```
  */
 import type { Document, Selection } from '@rtif-sdk/core';
-/** Builder for constructing test documents fluently */
+/**
+ * Input type for span content in `block()`.
+ * A plain string creates an unmarked span; a `SpanDef` carries marks.
+ */
+export type SpanInput = string | SpanDef;
+/**
+ * A span definition with text and optional marks.
+ * Created via the `span()` helper.
+ */
+export interface SpanDef {
+    readonly text: string;
+    readonly marks?: Record<string, unknown>;
+}
+/**
+ * Create a span definition with text and optional marks.
+ *
+ * @param text - The span text content
+ * @param marks - Optional formatting marks
+ * @returns A SpanDef for use in `DocumentBuilder.block()`
+ *
+ * @example
+ * ```ts
+ * span('hello')                        // plain text
+ * span('bold', { bold: true })         // bold text
+ * span('link', { link: { href: '…' }}) // link
+ * ```
+ */
+export declare function span(text: string, marks?: Record<string, unknown>): SpanDef;
+/** Builder for constructing test documents fluently. */
 export declare class DocumentBuilder {
-    private blocks;
+    private _blocks;
+    private _meta?;
     private nextId;
     /**
-     * Add a block with plain text, or text with marks.
+     * Add a block with one or more spans.
+     *
+     * When called with a single string, creates a plain text block.
+     * When called with `SpanInput` values (strings and/or `span()` results),
+     * each input becomes a span in the block.
+     *
+     * @param inputs - One or more span inputs (strings or SpanDefs)
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Hello')                                          // plain text
+     * doc().block(span('Hello '), span('world', { bold: true }))    // mixed
+     * doc().block('plain ', span('bold', { bold: true }), ' more')  // strings + spans
+     * ```
+     */
+    block(...inputs: SpanInput[]): this;
+    /**
+     * Set the block type on the last added block.
+     *
+     * @param blockType - The block type string (e.g., 'heading', 'code_block')
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Title').type('heading').build()
+     * ```
+     */
+    type(blockType: string): this;
+    /**
+     * Set block-level attributes on the last added block.
+     *
+     * @param blockAttrs - The attributes to set
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Title').type('heading').attrs({ level: 2 }).build()
+     * ```
+     */
+    attrs(blockAttrs: Record<string, unknown>): this;
+    /**
+     * Set a custom ID on the last added block.
      *
-     * Usage:
-     *   doc().block("Hello")
-     *   doc().block("Hello ", { bold: "world" })
+     * @param blockId - The block ID
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Hello').id('custom-id').build()
+     * ```
+     */
+    id(blockId: string): this;
+    /**
+     * Set document-level metadata.
+     *
+     * @param docMeta - The metadata key-value pairs
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Hello').meta({ title: 'My Doc', lang: 'en' }).build()
+     * ```
+     */
+    meta(docMeta: Record<string, unknown>): this;
+    /**
+     * Build the final Document.
+     *
+     * @returns A valid RTIF Document
      */
-    block(text: string, _marks?: Record<string, string>): this;
-    /** Build the final Document */
     build(): Document;
 }
-/** Create a new DocumentBuilder */
+/**
+ * Create a new DocumentBuilder.
+ *
+ * @returns A fresh DocumentBuilder
+ *
+ * @example
+ * ```ts
+ * const d = doc().block('Hello').block('World').build();
+ * ```
+ */
 export declare function doc(): DocumentBuilder;
-/** Create a Selection from anchor and focus offsets */
+/**
+ * Create a Selection from anchor and focus offsets.
+ *
+ * @param anchor - Anchor offset
+ * @param focus - Focus offset
+ * @returns A Selection object
+ *
+ * @example
+ * ```ts
+ * sel(0, 5)   // forward selection
+ * sel(5, 5)   // collapsed cursor at offset 5
+ * sel(10, 5)  // backward selection
+ * ```
+ */
 export declare function sel(anchor: number, focus: number): Selection;
+/**
+ * Create an empty document with a single empty block.
+ *
+ * @param blockId - Optional block ID (default: 'b1')
+ * @returns A Document with one empty text block
+ *
+ * @example
+ * ```ts
+ * const d = emptyDoc();
+ * // { version: 1, blocks: [{ id: 'b1', type: 'text', spans: [{ text: '' }] }] }
+ * ```
+ */
+export declare function emptyDoc(blockId?: string): Document;
+/**
+ * Create a document with a single text block.
+ *
+ * @param text - The block text content
+ * @param blockId - Optional block ID (default: 'b1')
+ * @returns A Document with one text block
+ *
+ * @example
+ * ```ts
+ * const d = textDoc('hello');
+ * const d2 = textDoc('hello', 'custom-id');
+ * ```
+ */
+export declare function textDoc(text: string, blockId?: string): Document;
+/**
+ * Create a document with multiple text blocks.
+ *
+ * @param texts - Array of text strings, one per block
+ * @returns A Document with blocks 'b1', 'b2', etc.
+ *
+ * @example
+ * ```ts
+ * const d = multiBlockDoc('hello', 'world');
+ * // Two blocks: b1="hello", b2="world"
+ * ```
+ */
+export declare function multiBlockDoc(...texts: string[]): Document;
+/**
+ * Extract plain text from a document, joining blocks with newlines.
+ *
+ * @param document - The RTIF document
+ * @returns Plain text representation
+ *
+ * @example
+ * ```ts
+ * const text = docText(engine.state.doc);
+ * // "hello\nworld"
+ * ```
+ */
+export declare function docText(document: Document): string;
 //# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAS,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjE,uDAAuD;AACvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAW1D,+BAA+B;IAC/B,KAAK,IAAI,QAAQ;CAUlB;AAED,mCAAmC;AACnC,wBAAgB,GAAG,IAAI,eAAe,CAErC;AAED,uDAAuD;AACvD,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAK5D"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAK3E;AAED,wDAAwD;AACxD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,KAAK,CAAC,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAyBnC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAS7B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAShD;;;;;;;;;;OAUG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASzB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5C;;;;OAIG;IACH,KAAK,IAAI,QAAQ;CAclB;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,IAAI,eAAe,CAErC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAK5D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,OAAO,SAAO,GAAG,QAAQ,CAKjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,QAAQ,CAK9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAY1D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAIlD"}

package/dist/builders.js

@@ -1,49 +1,302 @@
 /**
- * Fluent document builders for tests.
- * See SPEC.md Appendix C for usage examples.
+ * Fluent document builders and fixture factories for RTIF tests.
+ *
+ * @example
+ * ```ts
+ * import { doc, span, sel, emptyDoc, textDoc } from '@rtif-sdk/test-kit';
+ *
+ * // Plain text block
+ * const d1 = doc().block('Hello').build();
+ *
+ * // Block with formatted spans
+ * const d2 = doc()
+ *   .block(span('Hello '), span('world', { bold: true }), span('!'))
+ *   .build();
+ *
+ * // Block with type, attrs, and custom ID
+ * const d3 = doc()
+ *   .block('Title').type('heading').attrs({ level: 1 }).id('h1')
+ *   .block('Body text')
+ *   .meta({ title: 'My Doc' })
+ *   .build();
+ *
+ * // Common fixtures
+ * const empty = emptyDoc();
+ * const simple = textDoc('hello');
+ * ```
  */
-/** Builder for constructing test documents fluently */
+/**
+ * Create a span definition with text and optional marks.
+ *
+ * @param text - The span text content
+ * @param marks - Optional formatting marks
+ * @returns A SpanDef for use in `DocumentBuilder.block()`
+ *
+ * @example
+ * ```ts
+ * span('hello')                        // plain text
+ * span('bold', { bold: true })         // bold text
+ * span('link', { link: { href: '…' }}) // link
+ * ```
+ */
+export function span(text, marks) {
+    if (marks !== undefined) {
+        return { text, marks };
+    }
+    return { text };
+}
+/** Builder for constructing test documents fluently. */
 export class DocumentBuilder {
-    blocks = [];
+    _blocks = [];
+    _meta;
     nextId = 1;
     /**
-     * Add a block with plain text, or text with marks.
+     * Add a block with one or more spans.
+     *
+     * When called with a single string, creates a plain text block.
+     * When called with `SpanInput` values (strings and/or `span()` results),
+     * each input becomes a span in the block.
      *
-     * Usage:
-     *   doc().block("Hello")
-     *   doc().block("Hello ", { bold: "world" })
+     * @param inputs - One or more span inputs (strings or SpanDefs)
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Hello')                                          // plain text
+     * doc().block(span('Hello '), span('world', { bold: true }))    // mixed
+     * doc().block('plain ', span('bold', { bold: true }), ' more')  // strings + spans
+     * ```
      */
-    block(text, _marks) {
-        // TODO: Implement mark parsing from the shorthand format
-        // For now, creates a simple single-span block
-        this.blocks.push({
+    block(...inputs) {
+        const spans = inputs.map((input) => {
+            if (typeof input === 'string') {
+                return { text: input };
+            }
+            const s = { text: input.text };
+            if (input.marks !== undefined) {
+                s.marks = { ...input.marks };
+            }
+            return s;
+        });
+        // Default to an empty span if no inputs provided
+        if (spans.length === 0) {
+            spans.push({ text: '' });
+        }
+        this._blocks.push({
             id: `b${this.nextId++}`,
             type: 'text',
-            spans: [{ text }],
+            spans,
         });
         return this;
     }
-    /** Build the final Document */
+    /**
+     * Set the block type on the last added block.
+     *
+     * @param blockType - The block type string (e.g., 'heading', 'code_block')
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Title').type('heading').build()
+     * ```
+     */
+    type(blockType) {
+        const last = this._blocks[this._blocks.length - 1];
+        if (!last) {
+            throw new Error('type() must be called after block()');
+        }
+        last.type = blockType;
+        return this;
+    }
+    /**
+     * Set block-level attributes on the last added block.
+     *
+     * @param blockAttrs - The attributes to set
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Title').type('heading').attrs({ level: 2 }).build()
+     * ```
+     */
+    attrs(blockAttrs) {
+        const last = this._blocks[this._blocks.length - 1];
+        if (!last) {
+            throw new Error('attrs() must be called after block()');
+        }
+        last.attrs = { ...blockAttrs };
+        return this;
+    }
+    /**
+     * Set a custom ID on the last added block.
+     *
+     * @param blockId - The block ID
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Hello').id('custom-id').build()
+     * ```
+     */
+    id(blockId) {
+        const last = this._blocks[this._blocks.length - 1];
+        if (!last) {
+            throw new Error('id() must be called after block()');
+        }
+        last.id = blockId;
+        return this;
+    }
+    /**
+     * Set document-level metadata.
+     *
+     * @param docMeta - The metadata key-value pairs
+     * @returns The builder for chaining
+     *
+     * @example
+     * ```ts
+     * doc().block('Hello').meta({ title: 'My Doc', lang: 'en' }).build()
+     * ```
+     */
+    meta(docMeta) {
+        this._meta = { ...docMeta };
+        return this;
+    }
+    /**
+     * Build the final Document.
+     *
+     * @returns A valid RTIF Document
+     */
     build() {
-        if (this.blocks.length === 0) {
-            this.blocks.push({
+        if (this._blocks.length === 0) {
+            this._blocks.push({
                 id: 'b1',
                 type: 'text',
                 spans: [{ text: '' }],
             });
         }
-        return { version: 1, blocks: this.blocks };
+        const result = { version: 1, blocks: this._blocks };
+        if (this._meta !== undefined) {
+            result.meta = this._meta;
+        }
+        return result;
     }
 }
-/** Create a new DocumentBuilder */
+/**
+ * Create a new DocumentBuilder.
+ *
+ * @returns A fresh DocumentBuilder
+ *
+ * @example
+ * ```ts
+ * const d = doc().block('Hello').block('World').build();
+ * ```
+ */
 export function doc() {
     return new DocumentBuilder();
 }
-/** Create a Selection from anchor and focus offsets */
+/**
+ * Create a Selection from anchor and focus offsets.
+ *
+ * @param anchor - Anchor offset
+ * @param focus - Focus offset
+ * @returns A Selection object
+ *
+ * @example
+ * ```ts
+ * sel(0, 5)   // forward selection
+ * sel(5, 5)   // collapsed cursor at offset 5
+ * sel(10, 5)  // backward selection
+ * ```
+ */
 export function sel(anchor, focus) {
     return {
         anchor: { offset: anchor },
         focus: { offset: focus },
     };
 }
+// ---------------------------------------------------------------------------
+// Common Fixtures
+// ---------------------------------------------------------------------------
+/**
+ * Create an empty document with a single empty block.
+ *
+ * @param blockId - Optional block ID (default: 'b1')
+ * @returns A Document with one empty text block
+ *
+ * @example
+ * ```ts
+ * const d = emptyDoc();
+ * // { version: 1, blocks: [{ id: 'b1', type: 'text', spans: [{ text: '' }] }] }
+ * ```
+ */
+export function emptyDoc(blockId = 'b1') {
+    return {
+        version: 1,
+        blocks: [{ id: blockId, type: 'text', spans: [{ text: '' }] }],
+    };
+}
+/**
+ * Create a document with a single text block.
+ *
+ * @param text - The block text content
+ * @param blockId - Optional block ID (default: 'b1')
+ * @returns A Document with one text block
+ *
+ * @example
+ * ```ts
+ * const d = textDoc('hello');
+ * const d2 = textDoc('hello', 'custom-id');
+ * ```
+ */
+export function textDoc(text, blockId = 'b1') {
+    return {
+        version: 1,
+        blocks: [{ id: blockId, type: 'text', spans: [{ text }] }],
+    };
+}
+/**
+ * Create a document with multiple text blocks.
+ *
+ * @param texts - Array of text strings, one per block
+ * @returns A Document with blocks 'b1', 'b2', etc.
+ *
+ * @example
+ * ```ts
+ * const d = multiBlockDoc('hello', 'world');
+ * // Two blocks: b1="hello", b2="world"
+ * ```
+ */
+export function multiBlockDoc(...texts) {
+    if (texts.length === 0) {
+        return emptyDoc();
+    }
+    return {
+        version: 1,
+        blocks: texts.map((text, i) => ({
+            id: `b${i + 1}`,
+            type: 'text',
+            spans: [{ text }],
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract plain text from a document, joining blocks with newlines.
+ *
+ * @param document - The RTIF document
+ * @returns Plain text representation
+ *
+ * @example
+ * ```ts
+ * const text = docText(engine.state.doc);
+ * // "hello\nworld"
+ * ```
+ */
+export function docText(document) {
+    return document.blocks
+        .map((b) => b.spans.map((s) => s.text).join(''))
+        .join('\n');
+}
 //# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,uDAAuD;AACvD,MAAM,OAAO,eAAe;IAClB,MAAM,GAAY,EAAE,CAAC;IACrB,MAAM,GAAG,CAAC,CAAC;IAEnB;;;;;;OAMG;IACH,KAAK,CAAC,IAAY,EAAE,MAA+B;QACjD,yDAAyD;QACzD,8CAA8C;QAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,EAAE,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;aACtB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;CACF;AAED,mCAAmC;AACnC,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAa;IAC/C,OAAO;QACL,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QAC1B,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KACzB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { doc, sel, DocumentBuilder } from './builders.js';
+export { doc, sel, span, DocumentBuilder, emptyDoc, textDoc, multiBlockDoc, docText, } from './builders.js';
+export type { SpanInput, SpanDef } from './builders.js';
 export { assertDocEqual, assertSelectionEqual } from './assertions.js';
+export type { DocEqualOptions } from './assertions.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,OAAO,EACP,aAAa,EACb,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
-export { doc, sel, DocumentBuilder } from './builders.js';
+// Builders
+export { doc, sel, span, DocumentBuilder, emptyDoc, textDoc, multiBlockDoc, docText, } from './builders.js';
+// Assertions
 export { assertDocEqual, assertSelectionEqual } from './assertions.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,OAAO,EACP,aAAa,EACb,OAAO,GACR,MAAM,eAAe,CAAC;AAGvB,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtif-sdk/test-kit",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "RTIF shared test utilities, builders, and assertions",
   "author": "coryrobinson42@gmail.com",
   "type": "module",
@@ -12,10 +12,19 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "sideEffects": false,
-  "engines": { "node": ">=20.0.0" },
-  "keywords": ["rtif", "test-utilities", "rich-text", "editor-testing"],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "rtif",
+    "test-utilities",
+    "rich-text",
+    "editor-testing"
+  ],
   "scripts": {
     "build": "tsc --build tsconfig.build.json",
     "test": "vitest run",