@rtif-sdk/core 1.0.0

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { Document, Block, Span, Position, Selection } from './model.js';
+export { RtifError } from './error.js';
+export type { RtifErrorCode } from './error.js';
+export type { Operation, InsertText, DeleteText, SplitBlock, MergeBlock, SetBlockAttrs, SetBlockType, SetSpanMarks, SetMeta, } from './operations.js';
+export { apply } from './apply.js';
+export type { ApplyResult } from './apply.js';
+export { normalizeSpans, marksEqual } from './normalize.js';
+export { resolve, blockTextLength, docLength } from './resolve.js';
+export type { ResolvedPosition } from './resolve.js';
+export { validate } from './validate.js';
+export type { ValidationResult, ValidationError } from './validate.js';
+export { getMarksAtOffset, getMarksInRange, getBlockAtOffset } from './queries.js';
+export type { RangeMarksResult } from './queries.js';
+export { createMarkSerializerRegistry } from './serialization.js';
+export type { MarkSerializer, MarkSerializerRegistry, SerializationFormat, } from './serialization.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,YAAY,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Error types
+export { RtifError } from './error.js';
+// Core functions
+export { apply } from './apply.js';
+export { normalizeSpans, marksEqual } from './normalize.js';
+export { resolve, blockTextLength, docLength } from './resolve.js';
+export { validate } from './validate.js';
+export { getMarksAtOffset, getMarksInRange, getBlockAtOffset } from './queries.js';
+// Serialization contracts
+export { createMarkSerializerRegistry } from './serialization.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgBvC,iBAAiB;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGnF,0BAA0B;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Core RTIF data model types.
+ * See SPEC.md §2 for full specification.
+ */
+/** Root document container */
+export interface Document {
+    /** Spec version for forward compatibility */
+    version: 1;
+    /** Ordered list of content blocks */
+    blocks: Block[];
+    /**
+     * Global metadata (optional).
+     * Plugins may store data here (e.g., document-level settings).
+     * Core ignores unknown keys.
+     */
+    meta?: Record<string, unknown>;
+}
+/** A line-level container (paragraph, heading, list item, etc.) */
+export interface Block {
+    /** Unique ID, generated once, stable across edits */
+    id: string;
+    /**
+     * Block type. Core only knows "text".
+     * Plugins register additional types via the BlockType registry.
+     */
+    type: string;
+    /** Inline content within the block */
+    spans: Span[];
+    /**
+     * Block-level attributes (optional).
+     * Plugins use this for heading level, list depth, indentation, etc.
+     */
+    attrs?: Record<string, unknown>;
+}
+/** A contiguous run of characters sharing the same set of format marks */
+export interface Span {
+    /** The raw text content */
+    text: string;
+    /**
+     * Set of active format marks on this span.
+     * Core defines no built-in marks — they are all plugin-provided.
+     * An empty object (or omitted) means plain, unformatted text.
+     */
+    marks?: Record<string, unknown>;
+}
+/** A single point in the document (absolute character offset, 0-indexed) */
+export interface Position {
+    offset: number;
+}
+/**
+ * A selection defined by anchor (where the user started) and focus (cursor).
+ * When anchor.offset === focus.offset, this is a collapsed cursor (caret).
+ */
+export interface Selection {
+    anchor: Position;
+    focus: Position;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,6CAA6C;IAC7C,OAAO,EAAE,CAAC,CAAC;IAEX,qCAAqC;IACrC,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,mEAAmE;AACnE,MAAM,WAAW,KAAK;IACpB,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,0EAA0E;AAC1E,MAAM,WAAW,IAAI;IACnB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB"}

package/dist/model.js

@@ -0,0 +1,6 @@
+/**
+ * Core RTIF data model types.
+ * See SPEC.md §2 for full specification.
+ */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/normalize.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Span normalization — ensures documents are always in canonical form.
+ * See SPEC.md §3.3 for specification.
+ */
+import type { Span } from './model.js';
+/**
+ * Check if two mark objects are deeply equal.
+ * Treats `undefined` and `{}` as equivalent (both mean "no marks").
+ *
+ * @param a - First marks object
+ * @param b - Second marks object
+ * @returns true if marks are semantically equal
+ *
+ * @example
+ * ```ts
+ * marksEqual({ bold: true }, { bold: true }); // => true
+ * marksEqual(undefined, {});                  // => true
+ * marksEqual({ bold: true }, { italic: true }); // => false
+ * ```
+ */
+export declare function marksEqual(a: Record<string, unknown> | undefined, b: Record<string, unknown> | undefined): boolean;
+/**
+ * Normalize an array of spans:
+ * 1. Adjacent spans with identical marks are merged into one.
+ * 2. Empty spans (text === "") are removed.
+ * 3. If the result is empty, returns one span: `{ text: "" }`.
+ *
+ * This guarantees two semantically identical documents have identical JSON.
+ *
+ * @param spans - The spans to normalize
+ * @returns A new normalized array of spans
+ *
+ * @example
+ * ```ts
+ * normalizeSpans([{ text: 'a' }, { text: 'b' }]);
+ * // => [{ text: 'ab' }]
+ * ```
+ */
+export declare function normalizeSpans(spans: ReadonlyArray<Span>): Span[];
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACtC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACrC,OAAO,CAKT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CA+BjE"}

package/dist/normalize.js

@@ -0,0 +1,74 @@
+/**
+ * Span normalization — ensures documents are always in canonical form.
+ * See SPEC.md §3.3 for specification.
+ */
+/**
+ * Check if two mark objects are deeply equal.
+ * Treats `undefined` and `{}` as equivalent (both mean "no marks").
+ *
+ * @param a - First marks object
+ * @param b - Second marks object
+ * @returns true if marks are semantically equal
+ *
+ * @example
+ * ```ts
+ * marksEqual({ bold: true }, { bold: true }); // => true
+ * marksEqual(undefined, {});                  // => true
+ * marksEqual({ bold: true }, { italic: true }); // => false
+ * ```
+ */
+export function marksEqual(a, b) {
+    const aKeys = Object.keys(a ?? {});
+    const bKeys = Object.keys(b ?? {});
+    if (aKeys.length !== bKeys.length)
+        return false;
+    return aKeys.every((key) => (a ?? {})[key] === (b ?? {})[key]);
+}
+/**
+ * Normalize an array of spans:
+ * 1. Adjacent spans with identical marks are merged into one.
+ * 2. Empty spans (text === "") are removed.
+ * 3. If the result is empty, returns one span: `{ text: "" }`.
+ *
+ * This guarantees two semantically identical documents have identical JSON.
+ *
+ * @param spans - The spans to normalize
+ * @returns A new normalized array of spans
+ *
+ * @example
+ * ```ts
+ * normalizeSpans([{ text: 'a' }, { text: 'b' }]);
+ * // => [{ text: 'ab' }]
+ * ```
+ */
+export function normalizeSpans(spans) {
+    const result = [];
+    for (const span of spans) {
+        if (span.text === '')
+            continue;
+        const prev = result[result.length - 1];
+        if (prev && marksEqual(prev.marks, span.marks)) {
+            // Merge into previous span (create new object, don't mutate)
+            result[result.length - 1] = {
+                text: prev.text + span.text,
+                ...(prev.marks && Object.keys(prev.marks).length > 0
+                    ? { marks: { ...prev.marks } }
+                    : {}),
+            };
+        }
+        else {
+            // Copy span to avoid mutation
+            result.push({
+                text: span.text,
+                ...(span.marks && Object.keys(span.marks).length > 0
+                    ? { marks: { ...span.marks } }
+                    : {}),
+            });
+        }
+    }
+    if (result.length === 0) {
+        return [{ text: '' }];
+    }
+    return result;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CACxB,CAAsC,EACtC,CAAsC;IAEtC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,MAAM,GAAW,EAAE,CAAC;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE;YAAE,SAAS;QAE/B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,6DAA6D;YAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;gBAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;gBAC3B,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;oBAClD,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE;oBAC9B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,8BAA8B;YAC9B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;oBAClD,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE;oBAC9B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/operations.d.ts

@@ -0,0 +1,90 @@
+/**
+ * RTIF operation types — the complete set of document mutations.
+ * See SPEC.md §3.1 for full specification.
+ */
+/** Insert characters at a position */
+export interface InsertText {
+    type: 'insert_text';
+    offset: number;
+    text: string;
+}
+/** Delete a range of characters [offset, offset + count) */
+export interface DeleteText {
+    type: 'delete_text';
+    offset: number;
+    count: number;
+    /** Deleted text stored for undo. Populated by the engine, not the caller. */
+    _deleted?: string;
+}
+/**
+ * Split a block at a position, creating a new block after it.
+ * This is what "pressing Enter" produces.
+ */
+export interface SplitBlock {
+    type: 'split_block';
+    offset: number;
+    /** ID for the newly created block. Generated by engine if omitted. */
+    newBlockId?: string;
+    /** Original type of the merged block. Populated by merge_block inverse. */
+    _mergedBlockType?: string;
+    /** Original attrs of the merged block. Populated by merge_block inverse. */
+    _mergedBlockAttrs?: Record<string, unknown>;
+}
+/**
+ * Merge a block with the previous block.
+ * This is what "pressing Backspace at the start of a block" produces.
+ */
+export interface MergeBlock {
+    type: 'merge_block';
+    /** ID of the block being merged into the previous one */
+    blockId: string;
+}
+/**
+ * Set/update block-level attributes.
+ * Shallow merge with existing attrs. Set a key to `null` to remove it.
+ */
+export interface SetBlockAttrs {
+    type: 'set_block_attrs';
+    blockId: string;
+    attrs: Record<string, unknown>;
+    /** Previous attrs stored for undo. Populated by engine. */
+    _prevAttrs?: Record<string, unknown>;
+}
+/**
+ * Change a block's type (e.g., "text" → "heading").
+ * The block retains its id, spans, and attrs — only `type` changes.
+ */
+export interface SetBlockType {
+    type: 'set_block_type';
+    blockId: string;
+    /** The new block type string */
+    blockType: string;
+    /** Previous type stored for undo. Populated by apply(). */
+    _prevType?: string;
+}
+/**
+ * Apply/remove marks on a range of text [offset, offset + count).
+ * Internally triggers span splitting/merging as needed.
+ */
+export interface SetSpanMarks {
+    type: 'set_span_marks';
+    offset: number;
+    count: number;
+    /**
+     * Marks to set (shallow merge per span).
+     * Set a mark key to `null` to remove it.
+     */
+    marks: Record<string, unknown>;
+}
+/**
+ * Set document-level metadata.
+ * Shallow merge. Set key to `null` to remove.
+ */
+export interface SetMeta {
+    type: 'set_meta';
+    meta: Record<string, unknown>;
+    _prevMeta?: Record<string, unknown>;
+}
+/** Union of all operation types */
+export type Operation = InsertText | DeleteText | SplitBlock | MergeBlock | SetBlockAttrs | SetBlockType | SetSpanMarks | SetMeta;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,mCAAmC;AACnC,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,OAAO,CAAC"}

package/dist/operations.js

@@ -0,0 +1,6 @@
+/**
+ * RTIF operation types — the complete set of document mutations.
+ * See SPEC.md §3.1 for full specification.
+ */
+export {};
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/queries.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Document query utilities — read-only queries against document state.
+ * Used by engine and platform implementations for toolbar state, accessibility, etc.
+ */
+import type { Block, Document } from './model.js';
+/** Result of querying marks across a text range */
+export interface RangeMarksResult {
+    /** Marks active across the entire range with identical values */
+    readonly common: Record<string, unknown>;
+    /** Mark keys present in some spans but not all, or with differing values */
+    readonly mixed: readonly string[];
+}
+/**
+ * Get the formatting marks at a specific document offset.
+ *
+ * At span boundaries, returns the marks of the preceding span
+ * (consistent with `insert_text` mark inheritance behavior).
+ *
+ * @param doc - The document to query
+ * @param offset - Absolute character offset
+ * @returns A copy of the marks at that position (empty object if no marks)
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is invalid
+ *
+ * @example
+ * ```ts
+ * // Given: [{ text: 'bold', marks: { bold: true } }, { text: 'plain' }]
+ * getMarksAtOffset(doc, 2); // => { bold: true }
+ * getMarksAtOffset(doc, 5); // => {}
+ * ```
+ */
+export declare function getMarksAtOffset(doc: Document, offset: number): Record<string, unknown>;
+/**
+ * Get the marks across a text range, identifying which are common and which are mixed.
+ *
+ * Supports cross-block ranges. Virtual `\n` separators between blocks
+ * contribute no marks and are skipped.
+ *
+ * @param doc - The document to query
+ * @param offset - Start of the range (absolute offset)
+ * @param count - Number of characters in the range
+ * @returns Common marks (same across all spans) and mixed mark keys
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is invalid
+ * @throws {RtifError} INVALID_COUNT if count is negative or range exceeds document
+ *
+ * @example
+ * ```ts
+ * // Given: [{ text: 'bo', marks: { bold: true } }, { text: 'th', marks: { bold: true, italic: true } }]
+ * getMarksInRange(doc, 0, 4);
+ * // => { common: { bold: true }, mixed: ['italic'] }
+ * ```
+ */
+export declare function getMarksInRange(doc: Document, offset: number, count: number): RangeMarksResult;
+/**
+ * Get the block containing a specific document offset.
+ *
+ * @param doc - The document to query
+ * @param offset - Absolute character offset
+ * @returns The block at that offset
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is invalid
+ *
+ * @example
+ * ```ts
+ * const block = getBlockAtOffset(doc, 0);
+ * // => { id: 'b1', type: 'text', spans: [...] }
+ * ```
+ */
+export declare function getBlockAtOffset(doc: Document, offset: number): Block;
+//# sourceMappingURL=queries.d.ts.map

package/dist/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIlD,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,gBAAgB,CA0FlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAGrE"}

package/dist/queries.js

@@ -0,0 +1,159 @@
+/**
+ * Document query utilities — read-only queries against document state.
+ * Used by engine and platform implementations for toolbar state, accessibility, etc.
+ */
+import { RtifError } from './error.js';
+import { resolve, blockTextLength, docLength } from './resolve.js';
+/**
+ * Get the formatting marks at a specific document offset.
+ *
+ * At span boundaries, returns the marks of the preceding span
+ * (consistent with `insert_text` mark inheritance behavior).
+ *
+ * @param doc - The document to query
+ * @param offset - Absolute character offset
+ * @returns A copy of the marks at that position (empty object if no marks)
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is invalid
+ *
+ * @example
+ * ```ts
+ * // Given: [{ text: 'bold', marks: { bold: true } }, { text: 'plain' }]
+ * getMarksAtOffset(doc, 2); // => { bold: true }
+ * getMarksAtOffset(doc, 5); // => {}
+ * ```
+ */
+export function getMarksAtOffset(doc, offset) {
+    const { blockIndex, localOffset } = resolve(doc, offset);
+    const block = doc.blocks[blockIndex];
+    // Empty block — single span with no text
+    if (block.spans.length === 1 && block.spans[0].text === '') {
+        return { ...(block.spans[0].marks ?? {}) };
+    }
+    let pos = 0;
+    for (const span of block.spans) {
+        const spanEnd = pos + span.text.length;
+        // Inside this span, or at its trailing boundary
+        if (localOffset <= spanEnd) {
+            return { ...(span.marks ?? {}) };
+        }
+        pos = spanEnd;
+    }
+    // Fallback: end of block (shouldn't reach here if resolve is correct)
+    const lastSpan = block.spans[block.spans.length - 1];
+    return { ...(lastSpan.marks ?? {}) };
+}
+/**
+ * Get the marks across a text range, identifying which are common and which are mixed.
+ *
+ * Supports cross-block ranges. Virtual `\n` separators between blocks
+ * contribute no marks and are skipped.
+ *
+ * @param doc - The document to query
+ * @param offset - Start of the range (absolute offset)
+ * @param count - Number of characters in the range
+ * @returns Common marks (same across all spans) and mixed mark keys
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is invalid
+ * @throws {RtifError} INVALID_COUNT if count is negative or range exceeds document
+ *
+ * @example
+ * ```ts
+ * // Given: [{ text: 'bo', marks: { bold: true } }, { text: 'th', marks: { bold: true, italic: true } }]
+ * getMarksInRange(doc, 0, 4);
+ * // => { common: { bold: true }, mixed: ['italic'] }
+ * ```
+ */
+export function getMarksInRange(doc, offset, count) {
+    if (count < 0) {
+        throw new RtifError('INVALID_COUNT', `Count ${count} is negative`);
+    }
+    if (count === 0) {
+        const marks = getMarksAtOffset(doc, offset);
+        return { common: marks, mixed: [] };
+    }
+    const totalLen = docLength(doc);
+    if (offset < 0 || offset > totalLen) {
+        throw new RtifError('OFFSET_OUT_OF_RANGE', `Offset ${offset} out of range`);
+    }
+    if (offset + count > totalLen) {
+        throw new RtifError('INVALID_COUNT', `Range [${offset}, ${offset + count}) exceeds document length ${totalLen}`);
+    }
+    const start = resolve(doc, offset);
+    // Collect mark objects from each span (or span fragment) in the range
+    const allMarkSets = [];
+    let remaining = count;
+    let blockIdx = start.blockIndex;
+    let localPos = start.localOffset;
+    while (remaining > 0 && blockIdx < doc.blocks.length) {
+        const block = doc.blocks[blockIdx];
+        const blockLen = blockTextLength(block);
+        const available = blockLen - localPos;
+        const consume = Math.min(remaining, available);
+        if (consume > 0) {
+            // Walk spans in this block, collecting marks for the overlapping portion
+            let spanPos = 0;
+            for (const span of block.spans) {
+                const spanEnd = spanPos + span.text.length;
+                if (spanEnd <= localPos) {
+                    spanPos = spanEnd;
+                    continue;
+                }
+                if (spanPos >= localPos + consume)
+                    break;
+                allMarkSets.push(span.marks ?? {});
+                spanPos = spanEnd;
+            }
+        }
+        remaining -= consume;
+        // Account for virtual \n between blocks
+        if (remaining > 0 && blockIdx < doc.blocks.length - 1) {
+            remaining -= 1;
+            blockIdx++;
+            localPos = 0;
+        }
+        else {
+            break;
+        }
+    }
+    if (allMarkSets.length === 0) {
+        return { common: {}, mixed: [] };
+    }
+    // Collect all unique mark keys across every span
+    const allKeys = new Set();
+    for (const marks of allMarkSets) {
+        for (const key of Object.keys(marks)) {
+            allKeys.add(key);
+        }
+    }
+    const common = {};
+    const mixed = [];
+    for (const key of allKeys) {
+        const firstValue = allMarkSets[0][key];
+        const isCommon = allMarkSets.every((marks) => key in marks && marks[key] === firstValue);
+        if (isCommon) {
+            common[key] = firstValue;
+        }
+        else {
+            mixed.push(key);
+        }
+    }
+    return { common, mixed };
+}
+/**
+ * Get the block containing a specific document offset.
+ *
+ * @param doc - The document to query
+ * @param offset - Absolute character offset
+ * @returns The block at that offset
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is invalid
+ *
+ * @example
+ * ```ts
+ * const block = getBlockAtOffset(doc, 0);
+ * // => { id: 'b1', type: 'text', spans: [...] }
+ * ```
+ */
+export function getBlockAtOffset(doc, offset) {
+    const { blockIndex } = resolve(doc, offset);
+    return doc.blocks[blockIndex];
+}
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"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"}

package/dist/resolve.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Offset resolution — converts absolute offsets to block-local coordinates.
+ * See SPEC.md §2.4 for specification.
+ */
+import type { Block, Document } from './model.js';
+export interface ResolvedPosition {
+    /** Index of the block containing this offset */
+    readonly blockIndex: number;
+    /** Character offset within the block */
+    readonly localOffset: number;
+}
+/**
+ * Compute the text length of a block (sum of all span text lengths).
+ *
+ * @param block - The block to measure
+ * @returns Total character count across all spans
+ *
+ * @example
+ * ```ts
+ * blockTextLength({ id: 'b1', type: 'text', spans: [{ text: 'hello' }] });
+ * // => 5
+ * ```
+ */
+export declare function blockTextLength(block: Block): number;
+/**
+ * Compute the total document length (all block text + virtual newlines between blocks).
+ *
+ * @param doc - The document to measure
+ * @returns Total character count including virtual newline separators
+ *
+ * @example
+ * ```ts
+ * docLength({ version: 1, blocks: [
+ *   { id: 'b1', type: 'text', spans: [{ text: 'hello' }] },
+ *   { id: 'b2', type: 'text', spans: [{ text: 'world' }] },
+ * ] });
+ * // => 11  (5 + 1 + 5)
+ * ```
+ */
+export declare function docLength(doc: Document): number;
+/**
+ * Resolve an absolute document offset to a block index and local offset.
+ *
+ * Walks blocks, subtracting lengths (including the +1 separator per block
+ * boundary), until the offset lands inside a block.
+ *
+ * @param doc - The document to resolve against
+ * @param offset - Absolute character offset from document start
+ * @returns Block index and character offset within that block
+ * @throws {RtifError} OFFSET_OUT_OF_RANGE if offset is negative or exceeds document length
+ *
+ * @example
+ * ```ts
+ * const { blockIndex, localOffset } = resolve(doc, 5);
+ * ```
+ */
+export declare function resolve(doc: Document, offset: number): ResolvedPosition;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAMpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAO/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAqCvE"}