mindoodb-app-sdk 0.0.49 → 0.0.51

package/README.md

@@ -229,6 +229,35 @@ Important constraints:
 - Call `session.menus.hide()` if your app needs to explicitly dismiss a pending host menu.
 - Host-rendered menus are intended for `runtime === "iframe"`. Window-mode apps can usually show local menus instead.
 
+### Host focus and notifications
+
+A click inside the iframe already asks Haven to focus this launch. Call `requestHostFocus()` when the app should take focus without a click.
+
+`hasHostFocus()` is true only when this launch is the surface the user is looking at: the focused tile on the active workspace page, or this launch open as a standalone runner. A background tile, another page, or another app is false. `onHostFocusChange()` fires when that answer changes, so a long task can decide whether to notify without polling.
+
+```ts
+const stop = session.onHostFocusChange((focused) => {
+  if (!focused) {
+    void session.notify({
+      id: "sync",
+      severity: "info",
+      text: "Sync finished",
+    });
+  }
+});
+
+await session.notify({
+  id: "progress",
+  severity: "info",
+  text: "10%",
+  durationMs: 1500,
+});
+```
+
+Show a notice when the app does not have host focus, or when a long task finishes and the user may have looked away. Do not notify while `hasHostFocus()` is true and the user is already looking at the app.
+
+Haven uses the app's registration label as the headline and ignores any title from the app. Pass the same `id` to update that notice in place. Omit `id` to add another notice. An id only matches notices from this launch. Omit `durationMs` and the notice stays until the user dismisses it or clicks it. A duration is clamped to about 1–8 seconds, which fits a short progress step such as "10%". Clicking the notice brings that launch back. The close button only dismisses it.
+
 ### Host-owned drag
 
 When two apps run as visible workspace chicklets, native HTML5 drag dies at the iframe boundary. The SDK therefore hands the gesture to Haven: the source starts it, Haven draws a PNG ghost above every frame, and the target hit-tests the drop.
@@ -458,7 +487,7 @@ A snapshot also carries `decryptionKeyId?: string` — the named shared key its
 
 - `set` -- assign top-level fields (shallow JSON merge).
 - `unset` -- remove top-level fields entirely.
-- `json` -- a **granular JSON patch** of `set` / `unset` / `listInsert` / `listDelete` operations applied at specific paths inside `document.data`, against a `baseHeads` version. See [Granular JSON edits](#granular-json-edits) below.
+- `json` -- a **granular JSON patch** of `set` / `unset` / `listInsert` / `listDelete` operations (plus text splices/marks and `counterIncrement`) applied at specific paths inside `document.data`, against a `baseHeads` version. See [Granular JSON edits](#granular-json-edits) and [Typed values](#typed-values-atomic-strings-counters-timestamps) below.
 - `text` -- one or more **granular text patches** applied to specific string paths. Each patch carries the `baseHeads` version it was authored against and is merged on the Haven side with any concurrent changes that arrived since. This is the recommended way to edit collaborative text fields like a markdown body. See [Collaborative text editing](#collaborative-text-editing) below.
 - `richText` -- one or more **rich-text span snapshots** for formatted-document fields (Word/.docx style). See [Collaborative rich-text editing](#collaborative-rich-text-editing) below.
 
@@ -614,6 +643,109 @@ Haven applies the patch causally at `baseHeads` and merges it with any concurren
 
 Patch flavors compose. `set`/`unset` (top-level fields), `json`, `text`, and `richText` can all appear in the same `documents.update()` call and are applied atomically to one new document revision. Prefer small, intentional operations over whole-document rewrites so MindooDB change tracking stays meaningful and Automerge produces cleaner merges.
 
+### Typed values: atomic strings, counters, timestamps
+
+`document.data` is JSON, and JSON has one kind of string and one kind of number. For collaborative data that is not enough, so the SDK adds three **typed values**. You create them with `MindooDBAppValue` and use them anywhere you write a value: `documents.create({ set })`, `documents.update({ set })`, and `set` / `listInsert` values of a JSON patch, also nested inside objects and arrays.
+
+```ts
+import { MindooDBAppValue } from "mindoodb-app-sdk";
+
+const task = await db.documents.create({
+  set: {
+    title: "Write release notes",                    // collaborative text
+    status: MindooDBAppValue.atomic("open"),          // atomic string
+    votes: MindooDBAppValue.counter(0),               // counter
+    dueAt: MindooDBAppValue.timestamp("2026-10-01T12:00:00Z"),
+    assignee: { userId: MindooDBAppValue.atomic("u-42"), name: "Ada" },
+  },
+});
+
+task.data.status; // "open"
+task.data.votes;  // 0
+task.data.dueAt;  // "2026-10-01T12:00:00.000Z"
+```
+
+| Helper | Use it for | Reads back as |
+|---|---|---|
+| `MindooDBAppValue.atomic(string)` | ids, status and enum values, URLs, hashes, stored text cursors | `string` |
+| `MindooDBAppValue.counter(initial = 0)` | tallies several people change: votes, likes, stock, seats | `number` |
+| `MindooDBAppValue.timestamp(Date \| ms \| ISO string)` | dates and times | ISO 8601 string (UTC, with ms) |
+
+Why they matter:
+
+- **Plain strings are collaborative text.** Concurrent edits are merged character by character, which is right for titles, notes and bodies. For a status that one user changes from `"open"` to `"closed"` while another changes it to `"blocked"`, text merging can produce a mix of both words. An **atomic** string is replaced as a whole: one of the two values wins. It is also cheaper to store.
+- **Plain numbers are last-writer-wins.** If two users both read `votes: 4` and each save `5`, one vote is lost. A **counter** sums concurrent increments, so the result is `6`.
+- **An ISO string written as a plain string is text**, not a date. A **timestamp** stays a date for everyone who reads the document.
+
+The helpers produce plain JSON (`{ "$mindoo": "atomic", "value": "open" }`), so the values pass the bridge unchanged, and Haven converts them into the matching collaborative type. The key `$mindoo` is reserved: an object carrying it must be one of these values, otherwise the write is rejected.
+
+Reads return plain JSON, so **a value keeps its type only if you write it again with the helper.** Writing `status: "done"` stores text; write `status: MindooDBAppValue.atomic("done")`. Haven's database browser keeps the type when a user edits such a field in the JSON view.
+
+#### Counters
+
+Create a counter once, then change it only with `counterIncrement`:
+
+```ts
+interface MindooDBAppJsonCounterIncrementPatch {
+  path: Array<string | number>;
+  delta: number; // safe integer, negative to decrement
+}
+
+await db.documents.update(docId, {
+  json: { counterIncrement: [{ path: ["votes"], delta: 1 }] },
+});
+```
+
+- Writing `MindooDBAppValue.counter(n)` or a plain number over an existing counter resets it. That is an assignment and does not merge with concurrent increments, so use it for creation and deliberate resets only.
+- `counterIncrement` on a missing field creates the counter with value `delta`. If two devices do that concurrently for the same field, only one creation survives, so create shared counters up front, ideally in `documents.create`.
+- `counterIncrement` on a plain number is rejected: the field is not a counter.
+- `counterIncrement` runs after the other operations of the same JSON patch, so a patch may create an object with `set` and increment a counter inside it.
+- In Haven's database browser a counter can be edited in the JSON view: the new value is saved as the difference to the loaded value, so increments made by others in the meantime are kept.
+
+### Text cursors (anchors for comments and highlights)
+
+An index like "character 120" breaks as soon as another user inserts text before it. A **text cursor** identifies a character instead of a position, so it keeps pointing at the same spot while the text around it changes. Use cursors for comment and review anchors, highlights, bookmarks, "continue reading here" markers or links into a long text.
+
+```ts
+// Anchor a comment to characters 120..134 of the body (end exclusive: 135).
+// The end cursor names the LAST character of the range, see below.
+const doc = await db.documents.get(docId);
+const { cursors } = await db.documents.getTextCursors(docId, ["body"], [120, 134], {
+  heads: doc!.heads, // the version the user selected in
+});
+await db.documents.update(docId, {
+  json: {
+    listInsert: [{
+      path: ["comments"],
+      index: 0,
+      values: [{
+        text: "Source?",
+        from: MindooDBAppValue.atomic(cursors[0]!),
+        to: MindooDBAppValue.atomic(cursors[1]!),
+      }],
+    }],
+  },
+});
+
+// Later, after other users edited the body
+const current = (await db.documents.get(docId))!;
+const comment = current.data.comments[0];
+const { positions } = await db.documents.resolveTextCursors(docId, ["body"], [comment.from, comment.to], {
+  heads: current.heads, // resolve in the version you are about to render
+});
+const [start, last] = positions;
+const quoted = current.data.body.slice(start, last + 1);
+```
+
+Details:
+
+- A cursor names the character at its index. Text inserted exactly at that index lands in front of the character, so the cursor moves right. For a range, anchor the start on its first character and the end on its **last** character, then add 1 after resolving. An end cursor on the character after the range would grow the range whenever someone types at its end.
+- `positions` accepts character indexes (clamped to the text length) and `"start"` / `"end"`. An `"end"` cursor stays at the end when text is appended.
+- A cursor whose character was deleted resolves to where the character used to be. `move: "before"` makes it resolve towards the start of the text instead of the end.
+- `heads` (or `revisionId`) creates or resolves cursors against that document version. Pass the heads your editor rendered from so positions the user selected are interpreted in the text they saw.
+- Cursors only work on collaborative text: plain strings and rich text. Atomic strings, numbers and missing fields are rejected. Store the cursor strings themselves as atomic strings.
+- Both calls need the `read` capability. The mock bridge from `mindoodb-app-sdk/testing` returns cursors that do not follow later edits; test anchoring behavior against Haven.
+
 ### Collaborative text editing
 
 MindooDB stores collaborative text fields as Automerge text CRDTs internally, but apps never touch Automerge directly -- the SDK bridge is JSON-only. Instead, your app describes text changes as **granular splice operations** against a known document version, and Haven applies and merges them on its side.
@@ -1060,6 +1192,18 @@ const setup = await db.getFulltextSetup(); // null when never configured
 - `attachments: true` indexes attachment text under the synthetic `_attachments` field using the host's extractors (Haven ships anydoc for Office/PDF/… plus plain-text extractors). Restrict a query to attachment content with `text: { query, fields: ["_attachments"] }`.
 - Changing the configuration (including `language`) rebuilds the index in the background; queries during the rebuild report `coverage: "rebuilding"`.
 
+**Making nested fields queryable** — `query()` only sees fields in the database's summary buffer. By default that is every top-level scalar or array of scalars up to 1 KB; nested objects and arrays of objects are skipped. Include what your list UIs need so they don't have to `documents.get` each document:
+
+```ts
+// Idempotent, synced via the `dbsetup` document. Requires the `update` capability.
+const current = await db.getSummarySetup(); // null = default auto-include
+const include = [...new Set([...(current?.include ?? []), "phases"])];
+await db.setSummarySetup({ ...current, include });
+```
+
+- `include` paths may be nested (`"meta.author"`) or non-scalar and bypass the size cap; `exclude` wins over both.
+- A change re-extracts all documents in the background; queries report `coverage: "rebuilding"` until the backfill finishes, so keep a fallback for missing fields.
+
 **Extracting text from bytes you already have** (requires `attachments`):
 
 ```ts
@@ -1636,6 +1780,10 @@ Connect options: `launchId?`, `targetOrigin?`, `connectTimeoutMs?`.
 | `closeSealedChannel(channelId)`       | `Promise<void>`                      |
 | `menus.show(input)`                   | `Promise<MindooDBAppShowMenuResult>` |
 | `menus.hide()`                        | `Promise<void>`                      |
+| `requestHostFocus()`                  | `Promise<void>`                      |
+| `hasHostFocus()`                      | `Promise<boolean>`                   |
+| `onHostFocusChange(listener)`         | `() => void` (unsubscribe)           |
+| `notify(input)`                       | `Promise<{ id: string }>`            |
 | `drag.setProfile(profile)`            | `Promise<void>`                      |
 | `drag.start(input)`                   | `Promise<MindooDBAppDragStartResult>` |
 | `drag.cancel()`                       | `Promise<void>`                      |
@@ -1670,6 +1818,8 @@ Host-kept key/value state, the only durable storage a hosted app has. See [Stora
 | `attachments`                | `MindooDBAppAttachmentApi`                     |
 | `getFulltextSetup()`         | `Promise<MindooDBAppFulltextSetup \| null>`    |
 | `setFulltextSetup(config)`   | `Promise<void>`                                |
+| `getSummarySetup()`          | `Promise<MindooDBAppSummarySetup \| null>`     |
+| `setSummarySetup(config)`    | `Promise<void>`                                |
 
 ### MindooDBAppDocumentApi
 

package/TESTING.md

@@ -107,6 +107,7 @@ Each database entry can provide:
 - `methods.views` for session-level `createView()` and `openView()` calls (overrides the default evaluating navigator)
 - `methods.attachments`
 - `fulltextSetup` — the initial config returned by `db.getFulltextSetup()`; `db.setFulltextSetup()` overwrites it for the lifetime of the handle. Use this to test your app's full-text bootstrap logic. Note the mock evaluates `text` query clauses regardless of this config.
+- `summarySetup` — the initial config returned by `db.getSummarySetup()`; `db.setSummarySetup()` overwrites it for the lifetime of the handle. The mock's `query()` reads seeded documents directly and ignores this config; use it to test your app's summary bootstrap logic.
 
 ### Evaluating VirtualViews
 

package/dist/{chunk-TPYDERAK.js → chunk-R76XXRJ6.js}

@@ -1,3 +1,45 @@
+// src/values.ts
+var MINDOODB_APP_VALUE_TAG = "$mindoo";
+var MindooDBAppValue = {
+  /**
+   * An atomic string for identifiers, status and enum values, URLs, hashes
+   * and stored text cursors. Plain strings are collaborative text, where two
+   * concurrent changes of `"open"` to `"closed"` and `"blocked"` can
+   * interleave into a mix of both words.
+   */
+  atomic(value) {
+    if (typeof value !== "string") {
+      throw new Error("MindooDBAppValue.atomic value must be a string");
+    }
+    return { $mindoo: "atomic", value };
+  },
+  /**
+   * A collaborative counter with an initial value (a safe integer). Create it
+   * once, then change it only with `json.counterIncrement`: writing a new
+   * counter is an assignment that does not merge with concurrent increments.
+   */
+  counter(value = 0) {
+    if (!Number.isSafeInteger(value)) {
+      throw new Error("MindooDBAppValue.counter value must be a safe integer");
+    }
+    return { $mindoo: "counter", value };
+  },
+  /** A timestamp from a `Date`, epoch milliseconds or an ISO 8601 string. */
+  timestamp(value) {
+    const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
+    if (typeof value === "string" && value.trim() === "" || Number.isNaN(date.getTime())) {
+      throw new Error(
+        "MindooDBAppValue.timestamp value must be a Date, epoch milliseconds or an ISO 8601 date-time string"
+      );
+    }
+    return { $mindoo: "timestamp", value: date.toISOString() };
+  },
+  /** Whether `value` is a tagged typed value (any kind). */
+  isTyped(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) && Object.prototype.hasOwnProperty.call(value, MINDOODB_APP_VALUE_TAG);
+  }
+};
+
 // src/drag.ts
 var MINDOODB_APP_MAX_DRAG_TYPES = 8;
 var MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES = 32 * 1024;
@@ -392,11 +434,13 @@ function bindDragSource(element, options, start, follow) {
 // src/hostShortcuts.ts
 var DEFAULT_HAVEN_HOST_SHORTCUTS = [
   { action: "open-workspace", code: "Enter", shiftKey: true, metaOrCtrl: true },
-  { action: "toggle-app-drawer", code: "Space", shiftKey: true, metaOrCtrl: true }
+  { action: "toggle-app-drawer", code: "Space", shiftKey: true, metaOrCtrl: true },
+  { action: "toggle-workspace-maximize", code: "KeyM", shiftKey: true, metaOrCtrl: true }
 ];
 var HOST_SHORTCUT_ACTIONS = /* @__PURE__ */ new Set([
   "open-workspace",
-  "toggle-app-drawer"
+  "toggle-app-drawer",
+  "toggle-workspace-maximize"
 ]);
 function normalizeShortcutCode(code) {
   return code === "NumpadEnter" ? "Enter" : code;
@@ -627,6 +671,21 @@ var PortRpcClient = class {
   }
 };
 
+// src/hostFocus.ts
+function installHostFocusCapture(options) {
+  const target = options.target ?? (typeof document === "undefined" ? void 0 : document);
+  if (!target) {
+    return () => void 0;
+  }
+  const onPointerDown = () => {
+    options.onPointerDown();
+  };
+  target.addEventListener("pointerdown", onPointerDown, true);
+  return () => {
+    target.removeEventListener("pointerdown", onPointerDown, true);
+  };
+}
+
 // src/client/createMindooDBAppBridge.ts
 var PROTOCOL2 = "mindoodb-app-bridge";
 var DEFAULT_CONNECT_TIMEOUT_MS = 1e4;
@@ -1226,6 +1285,23 @@ var MindooDBAppDatabaseImpl = class {
         path,
         revisionId: options?.revisionId
       }),
+      getTextCursors: async (docId, path, positions, options) => await this.rpc.call("documents.textCursors.get", {
+        databaseId: this.databaseId,
+        docId,
+        path,
+        positions,
+        heads: options?.heads,
+        move: options?.move,
+        revisionId: options?.revisionId
+      }),
+      resolveTextCursors: async (docId, path, cursors, options) => await this.rpc.call("documents.textCursors.resolve", {
+        databaseId: this.databaseId,
+        docId,
+        path,
+        cursors,
+        heads: options?.heads,
+        revisionId: options?.revisionId
+      }),
       getAutomergeSnapshot: async (docId, options) => await this.rpc.call("documents.automerge.getSnapshot", {
         databaseId: this.databaseId,
         docId,
@@ -1236,6 +1312,26 @@ var MindooDBAppDatabaseImpl = class {
         docId,
         patch
       }),
+      applyAutomergeChangesBatch: async (items) => {
+        if (items.length === 0) return [];
+        try {
+          return await this.rpc.call("documents.automerge.applyChangesBatch", {
+            databaseId: this.databaseId,
+            items
+          });
+        } catch (error) {
+          if (!isMethodNotFoundError(error)) throw error;
+          const results = [];
+          for (const item of items) {
+            results.push(await this.rpc.call("documents.automerge.applyChanges", {
+              databaseId: this.databaseId,
+              docId: item.docId,
+              patch: item.patch
+            }));
+          }
+          return results;
+        }
+      },
       create: async (input) => await this.rpc.call("documents.create", {
         databaseId: this.databaseId,
         input
@@ -1576,6 +1672,21 @@ var MindooDBAppDatabaseImpl = class {
       config
     });
   }
+  /** Reads the summary buffer configuration from the synced `dbsetup` document. */
+  async getSummarySetup() {
+    const result = await this.rpc.call(
+      "database.getSummarySetup",
+      { databaseId: this.databaseId }
+    );
+    return result.config;
+  }
+  /** Writes (or removes, with `null`) the summary buffer configuration. */
+  async setSummarySetup(config) {
+    await this.rpc.call("database.setSummarySetup", {
+      databaseId: this.databaseId,
+      config
+    });
+  }
 };
 var MindooDBAppDragApiImpl = class {
   constructor(rpc) {
@@ -1718,6 +1829,18 @@ var MindooDBAppSessionImpl = class {
         }
       }
     }) : () => void 0;
+    this.stopHostFocus = installHostFocusCapture({
+      onPointerDown: () => {
+        try {
+          this.rpc.postMessage({
+            protocol: PROTOCOL2,
+            kind: "workspace-focus-requested"
+          });
+        } catch (error) {
+          console.warn("[mindoodb-app-sdk] Could not request host focus.", error);
+        }
+      }
+    });
   }
   rpc;
   onDisconnect;
@@ -1727,6 +1850,7 @@ var MindooDBAppSessionImpl = class {
   beforeCloseListeners = /* @__PURE__ */ new Set();
   hostShortcuts = DEFAULT_HAVEN_HOST_SHORTCUTS;
   stopHostShortcuts;
+  stopHostFocus;
   /**
    * Lets every listener finish, then tells the host it may proceed.
    *
@@ -1862,6 +1986,27 @@ var MindooDBAppSessionImpl = class {
       }
     });
   }
+  /** Ask Haven to treat this launch as the focused surface. */
+  async requestHostFocus() {
+    await this.rpc.call("session.requestHostFocus", {});
+  }
+  /** Whether this launch is the surface the user is looking at. */
+  async hasHostFocus() {
+    const result = await this.rpc.call("session.hasHostFocus", {});
+    return result?.focused === true;
+  }
+  /** Fires when the host-focus answer for this launch changes. */
+  onHostFocusChange(listener) {
+    return this.rpc.addMessageListener((message) => {
+      if (message.kind === "host-focus-changed") {
+        listener(message.focused);
+      }
+    });
+  }
+  /** Ask Haven to show or update a notice for this launch. */
+  async notify(input) {
+    return await this.rpc.call("notifications.show", input);
+  }
   /** Register work to run before the host tears this launch down. */
   onBeforeClose(listener) {
     this.beforeCloseListeners.add(listener);
@@ -1872,6 +2017,7 @@ var MindooDBAppSessionImpl = class {
   /** Disconnects from the host and always disposes the underlying port client. */
   async disconnect() {
     this.stopHostShortcuts();
+    this.stopHostFocus();
     this.drag.dispose();
     try {
       await this.rpc.call("session.disconnect", {});
@@ -1925,6 +2071,8 @@ function createMindooDBAppBridge() {
 }
 
 export {
+  MINDOODB_APP_VALUE_TAG,
+  MindooDBAppValue,
   MINDOODB_APP_MAX_DRAG_TYPES,
   MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES,
   MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES,

package/dist/index.d.ts

@@ -1,10 +1,62 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppHostShortcutBinding, g as MindooDBAppHostShortcutAction, h as MindooDBAppHostingMode, i as MindooDBAppDatabase, j as MindooDBAppDocument, k as MindooDBAppRichTextSpan, l as MindooDBAppRichTextSnapshot } from './types-C-eyC839.js';
-export { m as MINDOODB_APP_DEFINITION_FILE_NAME, n as MINDOODB_APP_DEFINITION_FORMAT, o as MINDOODB_APP_DEFINITION_PERMISSIONS, p as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, q as MINDOODB_APP_DEFINITION_VERSION, r as MINDOODB_APP_SEAL_SIGNING_DOMAIN, s as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, t as MindooDBAppAccessDecision, u as MindooDBAppAccessTier, v as MindooDBAppAttachmentApi, w as MindooDBAppAttachmentChunk, x as MindooDBAppAttachmentInfo, y as MindooDBAppAttachmentPreviewOptions, z as MindooDBAppAttachmentPreviewSession, A as MindooDBAppAutomergeChangesPatch, B as MindooDBAppAutomergeChangesSince, C as MindooDBAppAutomergeGetOptions, D as MindooDBAppAutomergePatchResult, E as MindooDBAppAutomergeSnapshot, F as MindooDBAppBridgeBeforeCloseAck, G as MindooDBAppBridgeBeforeCloseMessage, H as MindooDBAppBridgeConnectMessage, I as MindooDBAppBridgeConnectOptions, J as MindooDBAppBridgeConnectedMessage, K as MindooDBAppBridgeDragDropMessage, L as MindooDBAppBridgeDragLeaveMessage, N as MindooDBAppBridgeDragOverMessage, O as MindooDBAppBridgeErrorPayload, P as MindooDBAppBridgeHandshakeErrorMessage, Q as MindooDBAppBridgeLocaleChangedMessage, R as MindooDBAppBridgePortMessage, S as MindooDBAppBridgeQueryResultMessage, T as MindooDBAppBridgeRpcError, U as MindooDBAppBridgeRpcMessage, V as MindooDBAppBridgeRpcRequest, W as MindooDBAppBridgeRpcSuccess, X as MindooDBAppBridgeShortcutInvokedMessage, Y as MindooDBAppBridgeShortcutsChangedMessage, Z as MindooDBAppBridgeStreamAbortRequest, _ as MindooDBAppBridgeStreamAck, $ as MindooDBAppBridgeStreamCloseRequest, a0 as MindooDBAppBridgeStreamError, a1 as MindooDBAppBridgeStreamMessage, a2 as MindooDBAppBridgeStreamOpenResult, a3 as MindooDBAppBridgeStreamReadRequest, a4 as MindooDBAppBridgeStreamWriteRequest, a5 as MindooDBAppBridgeThemeChangedMessage, a6 as MindooDBAppBridgeUiPreferencesChangedMessage, a7 as MindooDBAppBridgeViewChangedMessage, a8 as MindooDBAppBridgeViewportChangedMessage, a9 as MindooDBAppCapability, aa as MindooDBAppConfiguredViewCategorizationStyle, ab as MindooDBAppConfiguredViewColumn, ac as MindooDBAppConfiguredViewColumnRole, ad as MindooDBAppConfiguredViewExpressionMode, ae as MindooDBAppConfiguredViewFieldExpression, af as MindooDBAppConfiguredViewFilterDefinition, ag as MindooDBAppConfiguredViewFilterMode, ah as MindooDBAppConfiguredViewFilterRule, ai as MindooDBAppConfiguredViewFormulaExpression, aj as MindooDBAppConfiguredViewFormulaFilterDefinition, ak as MindooDBAppConfiguredViewPreviewMode, al as MindooDBAppConfiguredViewRuleFilterDefinition, am as MindooDBAppConfiguredViewRuleMatchMode, an as MindooDBAppConfiguredViewRuleOperator, ao as MindooDBAppConfiguredViewValueExpression, ap as MindooDBAppCreateDocumentInput, aq as MindooDBAppCreateKeyInfo, ar as MindooDBAppCreateViewInput, as as MindooDBAppCreateViewNavigatorInput, at as MindooDBAppDatabaseInfo, au as MindooDBAppDefinition, av as MindooDBAppDefinitionDatabase, aw as MindooDBAppDefinitionPermission, ax as MindooDBAppDefinitionRegistrationPermission, ay as MindooDBAppDefinitionValidation, az as MindooDBAppDirectoryApi, aA as MindooDBAppDirectoryEntry, aB as MindooDBAppDocumentApi, aC as MindooDBAppDocumentHeadCursorResult, aD as MindooDBAppDocumentHistoryEntry, aE as MindooDBAppDocumentListQuery, aF as MindooDBAppDocumentListResult, aG as MindooDBAppDocumentQuery, aH as MindooDBAppDocumentRevisionId, aI as MindooDBAppDocumentScanPreset, aJ as MindooDBAppDocumentSummary, aK as MindooDBAppDragApi, aL as MindooDBAppDragCancelReason, aM as MindooDBAppDragDropEvent, aN as MindooDBAppDragEffect, aO as MindooDBAppDragHoverResult, aP as MindooDBAppDragOffer, aQ as MindooDBAppDragOverEvent, aR as MindooDBAppDragPointer, aS as MindooDBAppDragProfile, aT as MindooDBAppEntryAttachmentRef, aU as MindooDBAppEntryProvenance, aV as MindooDBAppExtractDocumentTextInput, aW as MindooDBAppExtractDocumentTextResult, aX as MindooDBAppExtractTextFormat, aY as MindooDBAppExtractionSetup, aZ as MindooDBAppFulltextSetup, a_ as MindooDBAppHistoricalDocument, a$ as MindooDBAppHistoryQuery, b0 as MindooDBAppHostTheme, b1 as MindooDBAppIdentityApi, b2 as MindooDBAppInaccessibleDocument, b3 as MindooDBAppInaccessibleDocumentListQuery, b4 as MindooDBAppInaccessibleDocumentListResult, b5 as MindooDBAppJsonListDeletePatch, b6 as MindooDBAppJsonListInsertPatch, b7 as MindooDBAppJsonPatch, b8 as MindooDBAppJsonSetPatch, b9 as MindooDBAppJsonTextMarkPatch, ba as MindooDBAppJsonTextSplicePatch, bb as MindooDBAppJsonTextUnmarkPatch, bc as MindooDBAppJsonUnsetPatch, bd as MindooDBAppLaunchContext, be as MindooDBAppLiveQuerySubscription, bf as MindooDBAppMenuAnchor, bg as MindooDBAppMenuApi, bh as MindooDBAppMenuCommandItem, bi as MindooDBAppMenuDismissReason, bj as MindooDBAppMenuDismissedResult, bk as MindooDBAppMenuItem, bl as MindooDBAppMenuKind, bm as MindooDBAppMenuPlacement, bn as MindooDBAppMenuPointAnchor, bo as MindooDBAppMenuRect, bp as MindooDBAppMenuRectAnchor, bq as MindooDBAppMenuSelectionResult, br as MindooDBAppMenuSeparatorItem, bs as MindooDBAppProposeAppInput, bt as MindooDBAppProposeAppResult, bu as MindooDBAppQueryCoverage, bv as MindooDBAppQueryInclude, bw as MindooDBAppQueryIncludeCardinality, bx as MindooDBAppQueryIncludeSlots, by as MindooDBAppQueryResult, bz as MindooDBAppQueryRow, bA as MindooDBAppQuerySortKey, bB as MindooDBAppQueryTextClause, bC as MindooDBAppReadableAttachmentStream, bD as MindooDBAppRecipientOptions, bE as MindooDBAppResolvedViewDefinition, bF as MindooDBAppResolvedViewSource, bG as MindooDBAppRevisionPhase, bH as MindooDBAppRevisionVerification, bI as MindooDBAppRichTextBlockSpan, bJ as MindooDBAppRichTextGetOptions, bK as MindooDBAppRichTextImmutableString, bL as MindooDBAppRichTextMarkRange, bM as MindooDBAppRichTextMaterializeValue, bN as MindooDBAppRichTextPatch, bO as MindooDBAppRichTextScalar, bP as MindooDBAppRichTextSpliceStep, bQ as MindooDBAppRichTextStep, bR as MindooDBAppRichTextStepPatch, bS as MindooDBAppRichTextTextSpan, bT as MindooDBAppRuntime, bU as MindooDBAppScanAttachmentOptions, bV as MindooDBAppScanAttachmentResult, bW as MindooDBAppScopedDocId, bX as MindooDBAppScopedDocumentSummary, bY as MindooDBAppSealIntent, bZ as MindooDBAppSealedChannelOpenInput, b_ as MindooDBAppSealedChannelOpenResult, b$ as MindooDBAppSealedChannelRequestInput, c0 as MindooDBAppSession, c1 as MindooDBAppShowMenuInput, c2 as MindooDBAppShowMenuResult, c3 as MindooDBAppSignPreview, c4 as MindooDBAppSignPreviewScope, c5 as MindooDBAppSignStatementInput, c6 as MindooDBAppSignStatementResult, c7 as MindooDBAppStorageApi, c8 as MindooDBAppTextEdit, c9 as MindooDBAppTextPatch, ca as MindooDBAppThemeMode, cb as MindooDBAppTimestampApi, cc as MindooDBAppTimestampInput, cd as MindooDBAppTimestampProvider, ce as MindooDBAppTimestampResult, cf as MindooDBAppUiPreferences, cg as MindooDBAppUpdateDocumentInput, ch as MindooDBAppViewCursorDocumentListResult, ci as MindooDBAppViewCursorResult, cj as MindooDBAppViewEntry, ck as MindooDBAppViewEntryKind, cl as MindooDBAppViewNavigator, cm as MindooDBAppViewNavigatorExpansionState, cn as MindooDBAppViewNavigatorOpenOptions, co as MindooDBAppViewNavigatorPageOptions, cp as MindooDBAppViewNavigatorPageResult, cq as MindooDBAppViewNavigatorRangeQuery, cr as MindooDBAppViewNavigatorSelectionState, cs as MindooDBAppViewUpdateStats, ct as MindooDBAppViewport, cu as MindooDBAppWellKnownDragType, cv as MindooDBAppWritableAttachmentStream, cw as resolveMindooDBAppDefinitionUrl, cx as validateMindooDBAppDefinition } from './types-C-eyC839.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppHostShortcutBinding, g as MindooDBAppHostShortcutAction, h as MindooDBAppHostingMode, i as MindooDBAppDatabase, j as MindooDBAppDocument, k as MindooDBAppRichTextSpan, l as MindooDBAppRichTextSnapshot, m as MindooDBAppCreateDocumentInput } from './types-BLyV6Ejy.js';
+export { n as MINDOODB_APP_DEFINITION_FILE_NAME, o as MINDOODB_APP_DEFINITION_FORMAT, p as MINDOODB_APP_DEFINITION_PERMISSIONS, q as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, r as MINDOODB_APP_DEFINITION_VERSION, s as MINDOODB_APP_SEAL_SIGNING_DOMAIN, t as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, u as MindooDBAppAccessDecision, v as MindooDBAppAccessTier, w as MindooDBAppAttachmentApi, x as MindooDBAppAttachmentChunk, y as MindooDBAppAttachmentInfo, z as MindooDBAppAttachmentPreviewOptions, A as MindooDBAppAttachmentPreviewSession, B as MindooDBAppAutomergeChangesPatch, C as MindooDBAppAutomergeChangesSince, D as MindooDBAppAutomergeGetOptions, E as MindooDBAppAutomergePatchResult, F as MindooDBAppAutomergeSnapshot, G as MindooDBAppBridgeBeforeCloseAck, H as MindooDBAppBridgeBeforeCloseMessage, I as MindooDBAppBridgeConnectMessage, J as MindooDBAppBridgeConnectOptions, K as MindooDBAppBridgeConnectedMessage, L as MindooDBAppBridgeDragDropMessage, N as MindooDBAppBridgeDragLeaveMessage, O as MindooDBAppBridgeDragOverMessage, P as MindooDBAppBridgeErrorPayload, Q as MindooDBAppBridgeHandshakeErrorMessage, R as MindooDBAppBridgeHostFocusChangedMessage, S as MindooDBAppBridgeLocaleChangedMessage, T as MindooDBAppBridgePortMessage, U as MindooDBAppBridgeQueryResultMessage, V as MindooDBAppBridgeRpcError, W as MindooDBAppBridgeRpcMessage, X as MindooDBAppBridgeRpcRequest, Y as MindooDBAppBridgeRpcSuccess, Z as MindooDBAppBridgeShortcutInvokedMessage, _ as MindooDBAppBridgeShortcutsChangedMessage, $ as MindooDBAppBridgeStreamAbortRequest, a0 as MindooDBAppBridgeStreamAck, a1 as MindooDBAppBridgeStreamCloseRequest, a2 as MindooDBAppBridgeStreamError, a3 as MindooDBAppBridgeStreamMessage, a4 as MindooDBAppBridgeStreamOpenResult, a5 as MindooDBAppBridgeStreamReadRequest, a6 as MindooDBAppBridgeStreamWriteRequest, a7 as MindooDBAppBridgeThemeChangedMessage, a8 as MindooDBAppBridgeUiPreferencesChangedMessage, a9 as MindooDBAppBridgeViewChangedMessage, aa as MindooDBAppBridgeViewportChangedMessage, ab as MindooDBAppBridgeWorkspaceFocusRequestedMessage, ac as MindooDBAppCapability, ad as MindooDBAppConfiguredViewCategorizationStyle, ae as MindooDBAppConfiguredViewColumn, af as MindooDBAppConfiguredViewColumnRole, ag as MindooDBAppConfiguredViewExpressionMode, ah as MindooDBAppConfiguredViewFieldExpression, ai as MindooDBAppConfiguredViewFilterDefinition, aj as MindooDBAppConfiguredViewFilterMode, ak as MindooDBAppConfiguredViewFilterRule, al as MindooDBAppConfiguredViewFormulaExpression, am as MindooDBAppConfiguredViewFormulaFilterDefinition, an as MindooDBAppConfiguredViewPreviewMode, ao as MindooDBAppConfiguredViewRuleFilterDefinition, ap as MindooDBAppConfiguredViewRuleMatchMode, aq as MindooDBAppConfiguredViewRuleOperator, ar as MindooDBAppConfiguredViewValueExpression, as as MindooDBAppCreateKeyInfo, at as MindooDBAppCreateViewInput, au as MindooDBAppCreateViewNavigatorInput, av as MindooDBAppDatabaseInfo, aw as MindooDBAppDefinition, ax as MindooDBAppDefinitionDatabase, ay as MindooDBAppDefinitionPermission, az as MindooDBAppDefinitionRegistrationPermission, aA as MindooDBAppDefinitionValidation, aB as MindooDBAppDirectoryApi, aC as MindooDBAppDirectoryEntry, aD as MindooDBAppDocumentApi, aE as MindooDBAppDocumentHeadCursorResult, aF as MindooDBAppDocumentHistoryEntry, aG as MindooDBAppDocumentListQuery, aH as MindooDBAppDocumentListResult, aI as MindooDBAppDocumentQuery, aJ as MindooDBAppDocumentRevisionId, aK as MindooDBAppDocumentScanPreset, aL as MindooDBAppDocumentSummary, aM as MindooDBAppDragApi, aN as MindooDBAppDragCancelReason, aO as MindooDBAppDragDropEvent, aP as MindooDBAppDragEffect, aQ as MindooDBAppDragHoverResult, aR as MindooDBAppDragOffer, aS as MindooDBAppDragOverEvent, aT as MindooDBAppDragPointer, aU as MindooDBAppDragProfile, aV as MindooDBAppEntryAttachmentRef, aW as MindooDBAppEntryProvenance, aX as MindooDBAppExtractDocumentTextInput, aY as MindooDBAppExtractDocumentTextResult, aZ as MindooDBAppExtractTextFormat, a_ as MindooDBAppExtractionSetup, a$ as MindooDBAppFulltextSetup, b0 as MindooDBAppHistoricalDocument, b1 as MindooDBAppHistoryQuery, b2 as MindooDBAppHostTheme, b3 as MindooDBAppIdentityApi, b4 as MindooDBAppInaccessibleDocument, b5 as MindooDBAppInaccessibleDocumentListQuery, b6 as MindooDBAppInaccessibleDocumentListResult, b7 as MindooDBAppJsonCounterIncrementPatch, b8 as MindooDBAppJsonListDeletePatch, b9 as MindooDBAppJsonListInsertPatch, ba as MindooDBAppJsonPatch, bb as MindooDBAppJsonSetPatch, bc as MindooDBAppJsonTextMarkPatch, bd as MindooDBAppJsonTextSplicePatch, be as MindooDBAppJsonTextUnmarkPatch, bf as MindooDBAppJsonUnsetPatch, bg as MindooDBAppLaunchContext, bh as MindooDBAppLiveQuerySubscription, bi as MindooDBAppMenuAnchor, bj as MindooDBAppMenuApi, bk as MindooDBAppMenuCommandItem, bl as MindooDBAppMenuDismissReason, bm as MindooDBAppMenuDismissedResult, bn as MindooDBAppMenuItem, bo as MindooDBAppMenuKind, bp as MindooDBAppMenuPlacement, bq as MindooDBAppMenuPointAnchor, br as MindooDBAppMenuRect, bs as MindooDBAppMenuRectAnchor, bt as MindooDBAppMenuSelectionResult, bu as MindooDBAppMenuSeparatorItem, bv as MindooDBAppNotificationSeverity, bw as MindooDBAppNotifyInput, bx as MindooDBAppNotifyResult, by as MindooDBAppProposeAppInput, bz as MindooDBAppProposeAppResult, bA as MindooDBAppQueryCoverage, bB as MindooDBAppQueryInclude, bC as MindooDBAppQueryIncludeCardinality, bD as MindooDBAppQueryIncludeSlots, bE as MindooDBAppQueryResult, bF as MindooDBAppQueryRow, bG as MindooDBAppQuerySortKey, bH as MindooDBAppQueryTextClause, bI as MindooDBAppReadableAttachmentStream, bJ as MindooDBAppRecipientOptions, bK as MindooDBAppResolvedViewDefinition, bL as MindooDBAppResolvedViewSource, bM as MindooDBAppRevisionPhase, bN as MindooDBAppRevisionVerification, bO as MindooDBAppRichTextBlockSpan, bP as MindooDBAppRichTextGetOptions, bQ as MindooDBAppRichTextImmutableString, bR as MindooDBAppRichTextMarkRange, bS as MindooDBAppRichTextMaterializeValue, bT as MindooDBAppRichTextPatch, bU as MindooDBAppRichTextScalar, bV as MindooDBAppRichTextSpliceStep, bW as MindooDBAppRichTextStep, bX as MindooDBAppRichTextStepPatch, bY as MindooDBAppRichTextTextSpan, bZ as MindooDBAppRuntime, b_ as MindooDBAppScanAttachmentOptions, b$ as MindooDBAppScanAttachmentResult, c0 as MindooDBAppScopedDocId, c1 as MindooDBAppScopedDocumentSummary, c2 as MindooDBAppSealIntent, c3 as MindooDBAppSealedChannelOpenInput, c4 as MindooDBAppSealedChannelOpenResult, c5 as MindooDBAppSealedChannelRequestInput, c6 as MindooDBAppSession, c7 as MindooDBAppShowMenuInput, c8 as MindooDBAppShowMenuResult, c9 as MindooDBAppSignPreview, ca as MindooDBAppSignPreviewScope, cb as MindooDBAppSignStatementInput, cc as MindooDBAppSignStatementResult, cd as MindooDBAppStorageApi, ce as MindooDBAppSummarySetup, cf as MindooDBAppTextCursorOptions, cg as MindooDBAppTextCursorPosition, ch as MindooDBAppTextCursorPositionsResult, ci as MindooDBAppTextCursorsResult, cj as MindooDBAppTextEdit, ck as MindooDBAppTextPatch, cl as MindooDBAppThemeMode, cm as MindooDBAppTimestampApi, cn as MindooDBAppTimestampInput, co as MindooDBAppTimestampProvider, cp as MindooDBAppTimestampResult, cq as MindooDBAppUiPreferences, cr as MindooDBAppUpdateDocumentInput, cs as MindooDBAppViewCursorDocumentListResult, ct as MindooDBAppViewCursorResult, cu as MindooDBAppViewEntry, cv as MindooDBAppViewEntryKind, cw as MindooDBAppViewNavigator, cx as MindooDBAppViewNavigatorExpansionState, cy as MindooDBAppViewNavigatorOpenOptions, cz as MindooDBAppViewNavigatorPageOptions, cA as MindooDBAppViewNavigatorPageResult, cB as MindooDBAppViewNavigatorRangeQuery, cC as MindooDBAppViewNavigatorSelectionState, cD as MindooDBAppViewUpdateStats, cE as MindooDBAppViewport, cF as MindooDBAppWellKnownDragType, cG as MindooDBAppWritableAttachmentStream, cH as resolveMindooDBAppDefinitionUrl, cI as validateMindooDBAppDefinition } from './types-BLyV6Ejy.js';
 export { M as MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME, a as MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME, b as MINDOODB_APP_BUNDLE_MANIFEST_FORMAT, c as MINDOODB_APP_BUNDLE_MANIFEST_VERSION, d as MindooDBAppBundleArchive, e as MindooDBAppBundleFileEntry, f as MindooDBAppBundleHash, g as MindooDBAppBundleManifest, h as MindooDBAppBundleManifestValidation, i as buildMindooDBAppBundleContentHashInput, j as isMindooDBAppBundleHash, n as normalizeMindooDBAppBundlePath, v as validateMindooDBAppBundleManifest } from './appBundleManifest-B0xfpaXG.js';
 import { MindooDBAppBooleanExpression } from 'mindoodb-view-language';
 export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterDefinition, MindooDBAppViewCategoryChildrenPageRequest, MindooDBAppViewColumn, MindooDBAppViewColumnRole, MindooDBAppViewDefinition, MindooDBAppViewExpansionState, MindooDBAppViewExpressionBase, MindooDBAppViewExpressionDatePart, MindooDBAppViewExpressionOperation, MindooDBAppViewFieldExpression, MindooDBAppViewIfExpression, MindooDBAppViewLetExpression, MindooDBAppViewLiteralExpression, MindooDBAppViewLookupByPath, MindooDBAppViewOperationExpression, MindooDBAppViewOriginExpression, MindooDBAppViewPageRequest, MindooDBAppViewPageResult, MindooDBAppViewRow, MindooDBAppViewSortDirection, MindooDBAppViewTotalMode, MindooDBAppViewValueExpressionRef, MindooDBAppViewVariableExpression, createViewLanguage } from 'mindoodb-view-language';
 import { MindooDB, MindooQuerySortKey, MindooQueryOptions, MindooQueryResult } from 'mindoodb';
 
+/**
+ * Typed document values that plain JSON cannot express.
+ *
+ * Each helper returns a tagged plain object such as
+ * `{ $mindoo: "counter", value: 0 }`. Use it anywhere a value is written:
+ * `documents.create({ set })`, `documents.update({ set })`, JSON patch `set`
+ * and `listInsert` values, also nested inside objects and arrays. Haven turns
+ * the tags into the matching collaborative type. Reads return plain JSON:
+ * atomic strings as strings, counters as numbers, timestamps as ISO 8601
+ * strings.
+ *
+ * The object key `$mindoo` is reserved; an object carrying it must be one of
+ * these values, otherwise the write is rejected.
+ */
+/** Reserved object key that marks a typed value. */
+declare const MINDOODB_APP_VALUE_TAG = "$mindoo";
+/** A string that is replaced as a whole on concurrent writes. */
+interface MindooDBAppAtomicValue {
+    $mindoo: "atomic";
+    value: string;
+}
+/** A number whose concurrent increments are summed on merge. */
+interface MindooDBAppCounterValue {
+    $mindoo: "counter";
+    value: number;
+}
+/** A point in time: epoch milliseconds or an ISO 8601 date-time string. */
+interface MindooDBAppTimestampValue {
+    $mindoo: "timestamp";
+    value: number | string;
+}
+type MindooDBAppTypedValue = MindooDBAppAtomicValue | MindooDBAppCounterValue | MindooDBAppTimestampValue;
+declare const MindooDBAppValue: {
+    /**
+     * An atomic string for identifiers, status and enum values, URLs, hashes
+     * and stored text cursors. Plain strings are collaborative text, where two
+     * concurrent changes of `"open"` to `"closed"` and `"blocked"` can
+     * interleave into a mix of both words.
+     */
+    readonly atomic: (value: string) => MindooDBAppAtomicValue;
+    /**
+     * A collaborative counter with an initial value (a safe integer). Create it
+     * once, then change it only with `json.counterIncrement`: writing a new
+     * counter is an assignment that does not merge with concurrent increments.
+     */
+    readonly counter: (value?: number) => MindooDBAppCounterValue;
+    /** A timestamp from a `Date`, epoch milliseconds or an ISO 8601 string. */
+    readonly timestamp: (value: Date | number | string) => MindooDBAppTimestampValue;
+    /** Whether `value` is a tagged typed value (any kind). */
+    readonly isTyped: (value: unknown) => value is MindooDBAppTypedValue;
+};
+
 /**
  * Resolves whether Haven can render a built-in preview for an attachment.
  *
@@ -366,4 +418,16 @@ declare function createMindooDBTextBuffer(options: CreateMindooDBTextBufferOptio
  */
 declare function queryDocuments(db: Pick<MindooDB, "query">, filter: MindooDBAppBooleanExpression | string, sortBy?: MindooQuerySortKey[], options?: MindooQueryOptions): Promise<MindooQueryResult>;
 
-export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, DEFAULT_DRAG_LONG_PRESS_MS, DEFAULT_DRAG_POINTER_THRESHOLD_PX, DEFAULT_HAVEN_HOST_SHORTCUTS, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, MINDOODB_APP_HOSTING_QUERY_PARAM, MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE, MINDOODB_APP_MAX_DRAG_TYPES, MINIMAL_DRAG_PREVIEW_PNG, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, MindooDBAppDatabase, MindooDBAppDocument, MindooDBAppDragBindSourceOptions, MindooDBAppDragInputError, MindooDBAppDragPreview, MindooDBAppDragStartInput, MindooDBAppDragStartResult, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, abbreviateCanonicalName, applyHostedDocumentOverscrollContain, bindDragSource, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, isMindooDBAppDragType, matchHostShortcut, normalizeDragAccepts, normalizeDragPointerInput, normalizeDragStartInput, queryDocuments, readMindooDBAppHostingMode, releaseMindooDBAppBridgeSessions, sanitizeHostShortcutBindings, snapshotElementToPng };
+/**
+ * Copy the parent's named key onto a chunk create when the caller did not
+ * choose a key. Person-bound documents pass `recipients` explicitly.
+ */
+declare function inheritDocumentEncryption(parent: Pick<MindooDBAppDocument, "decryptionKeyId">, input: MindooDBAppCreateDocumentInput): MindooDBAppCreateDocumentInput;
+/**
+ * Watch every Word chunk that belongs to `parentId`.
+ * The listener receives the chunk ids currently visible, including chunks
+ * another person inserted.
+ */
+declare function watchWordChunks(database: MindooDBAppDatabase, parentId: string, listener: (docIds: string[]) => void): Promise<() => Promise<void>>;
+
+export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, DEFAULT_DRAG_LONG_PRESS_MS, DEFAULT_DRAG_POINTER_THRESHOLD_PX, DEFAULT_HAVEN_HOST_SHORTCUTS, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, MINDOODB_APP_HOSTING_QUERY_PARAM, MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE, MINDOODB_APP_MAX_DRAG_TYPES, MINDOODB_APP_VALUE_TAG, MINIMAL_DRAG_PREVIEW_PNG, type MindooDBAppAtomicValue, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, type MindooDBAppCounterValue, MindooDBAppCreateDocumentInput, MindooDBAppDatabase, MindooDBAppDocument, MindooDBAppDragBindSourceOptions, MindooDBAppDragInputError, MindooDBAppDragPreview, MindooDBAppDragStartInput, MindooDBAppDragStartResult, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, type MindooDBAppTimestampValue, type MindooDBAppTypedValue, MindooDBAppValue, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, abbreviateCanonicalName, applyHostedDocumentOverscrollContain, bindDragSource, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, inheritDocumentEncryption, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, isMindooDBAppDragType, matchHostShortcut, normalizeDragAccepts, normalizeDragPointerInput, normalizeDragStartInput, queryDocuments, readMindooDBAppHostingMode, releaseMindooDBAppBridgeSessions, sanitizeHostShortcutBindings, snapshotElementToPng, watchWordChunks };

package/dist/index.js

@@ -6,8 +6,10 @@ import {
   MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES,
   MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE,
   MINDOODB_APP_MAX_DRAG_TYPES,
+  MINDOODB_APP_VALUE_TAG,
   MINIMAL_DRAG_PREVIEW_PNG,
   MindooDBAppDragInputError,
+  MindooDBAppValue,
   applyHostedDocumentOverscrollContain,
   bindDragSource,
   createMindooDBAppBridge,
@@ -21,7 +23,7 @@ import {
   releaseMindooDBAppBridgeSessions,
   sanitizeHostShortcutBindings,
   snapshotElementToPng
-} from "./chunk-TPYDERAK.js";
+} from "./chunk-R76XXRJ6.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
@@ -1031,6 +1033,24 @@ async function queryDocuments(db, filter, sortBy, options) {
   const expression = typeof filter === "string" ? parseMindooDBFormulaBooleanExpression(filter) : filter;
   return db.query({ filter: expression, sortBy }, options);
 }
+
+// src/wordChunks.ts
+function inheritDocumentEncryption(parent, input) {
+  if (input.decryptionKeyId || input.recipients) return input;
+  if (!parent.decryptionKeyId) return input;
+  return { ...input, decryptionKeyId: parent.decryptionKeyId };
+}
+async function watchWordChunks(database, parentId, listener) {
+  const subscription = await database.documents.liveQuery(
+    {
+      filter: `v.and(v.eq(v.field("type"), "wordChunk"), v.eq(v.field("parentId"), ${JSON.stringify(parentId)}))`
+    },
+    (result) => {
+      listener(result.rows.map((row) => row.docId));
+    }
+  );
+  return () => subscription.dispose();
+}
 export {
   DEFAULT_DRAG_LONG_PRESS_MS,
   DEFAULT_DRAG_POINTER_THRESHOLD_PX,
@@ -1050,9 +1070,11 @@ export {
   MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE,
   MINDOODB_APP_MAX_DRAG_TYPES,
   MINDOODB_APP_SEAL_SIGNING_DOMAIN,
+  MINDOODB_APP_VALUE_TAG,
   MINDOODB_APP_WELL_KNOWN_DRAG_TYPES,
   MINIMAL_DRAG_PREVIEW_PNG,
   MindooDBAppDragInputError,
+  MindooDBAppValue,
   MindooDBRichTextHandle,
   MindooDBTextBuffer,
   abbreviateCanonicalName,
@@ -1065,6 +1087,7 @@ export {
   createMindooDBTextBuffer,
   createViewLanguage,
   expandAbbreviatedName,
+  inheritDocumentEncryption,
   installHavenStorageShim,
   installHostShortcutCapture,
   isHostShortcutAction,
@@ -1083,5 +1106,6 @@ export {
   sanitizeHostShortcutBindings,
   snapshotElementToPng,
   validateMindooDBAppBundleManifest,
-  validateMindooDBAppDefinition
+  validateMindooDBAppDefinition,
+  watchWordChunks
 };