@rtif-sdk/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cory Robinson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @rtif-sdk/core
+
+Zero-dependency core library for the RTIF (Rich Text Input Format) document model. Provides types, pure functions for applying operations, normalization, offset resolution, and validation.
+
+## Install
+
+```bash
+npm install @rtif-sdk/core
+```
+
+## Usage
+
+### Create a document
+
+```typescript
+import type { Document } from '@rtif-sdk/core';
+
+const doc: Document = {
+  version: 1,
+  blocks: [
+    { id: 'b1', type: 'text', spans: [{ text: 'Hello world' }] },
+  ],
+};
+```
+
+### Apply an operation
+
+```typescript
+import { apply } from '@rtif-sdk/core';
+
+const { doc: newDoc, inverse } = apply(doc, {
+  type: 'insert_text',
+  offset: 5,
+  text: ',',
+});
+// newDoc.blocks[0].spans[0].text === 'Hello, world'
+
+// Undo by applying the inverse
+const { doc: original } = apply(newDoc, inverse);
+```
+
+### Resolve offsets
+
+```typescript
+import { resolve, docLength } from '@rtif-sdk/core';
+
+const len = docLength(doc);      // total character count including virtual \n separators
+const pos = resolve(doc, 5);     // { blockIndex: 0, localOffset: 5 }
+```
+
+### Validate a document
+
+```typescript
+import { validate } from '@rtif-sdk/core';
+
+const result = validate(doc);
+if (!result.valid) {
+  console.error(result.errors);
+}
+```
+
+## Operations
+
+RTIF defines exactly 8 operation types: `insert_text`, `delete_text`, `split_block`, `merge_block`, `set_span_marks`, `set_block_attrs`, `set_block_type`, `set_meta`.
+
+Every operation is deterministic and invertible — `apply()` always returns the inverse operation for undo.
+
+## License
+
+MIT

package/dist/apply.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Operation application — the single pure function that transforms documents.
+ * See docs/spec/operations.md for specification.
+ */
+import type { Document } from './model.js';
+import type { Operation } from './operations.js';
+export interface ApplyResult {
+    /** The new document after applying the operation */
+    readonly doc: Document;
+    /** The inverse operation (for undo) */
+    readonly inverse: Operation;
+}
+/**
+ * Apply an operation to a document, returning the new document and its inverse.
+ *
+ * - Immutable: returns a new Document, never mutates in place.
+ * - Deterministic: same (doc, op) → same (doc', inverse) on every platform.
+ * - Normalizes affected blocks before returning.
+ *
+ * @param doc - The document to transform
+ * @param op - The operation to apply
+ * @returns The new document and the inverse operation
+ * @throws {RtifError} If the operation is invalid
+ *
+ * @example
+ * ```ts
+ * const { doc: newDoc, inverse } = apply(doc, { type: 'insert_text', offset: 0, text: 'hi' });
+ * ```
+ */
+export declare function apply(doc: Document, op: Operation): ApplyResult;
+//# sourceMappingURL=apply.d.ts.map

package/dist/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAS,QAAQ,EAAQ,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAsC,SAAS,EAAkE,MAAM,iBAAiB,CAAC;AAKrJ,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,GAAG,WAAW,CAmB/D"}