mindoodb-app-sdk 0.0.43 → 0.0.45

package/README.md

@@ -229,6 +229,32 @@ 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-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.
+
+```ts
+await session.drag.setProfile({
+  accepts: ["text/plain", "text/markdown", "application/json", "application/x-mindoo-document"],
+  onOver: (event) => {
+    const zone = document.elementFromPoint(event.x, event.y)?.closest("[data-drop-zone]");
+    return { accept: Boolean(zone), effect: zone ? "copy" : "forbidden" };
+  },
+  onDrop: (event) => {
+    console.log(event.items["text/markdown"]);
+  },
+});
+
+const unbind = session.drag.bindSource(cardEl, {
+  offers: () => [
+    { type: "text/plain", data: "Hello" },
+    { type: "text/markdown", data: "**Hello**" },
+  ],
+});
+```
+
+`bindSource` starts after an 8px mouse/pen move, or a 400ms long-press on touch (so lists can still scroll). You can also call `session.drag.start` yourself with a PNG `ArrayBuffer` preview. v1 is **copy-only** and **iframe-only**. Well-known types: `text/plain`, `text/markdown`, `application/json`, `application/x-mindoo-document`.
+
 ### Databases and capabilities
 
 Each database mapped to your app carries a set of **capabilities** that Haven controls. Your app should check capabilities before attempting operations and adapt its UI accordingly.
@@ -1573,6 +1599,10 @@ Connect options: `launchId?`, `targetOrigin?`, `connectTimeoutMs?`.
 | `closeSealedChannel(channelId)`       | `Promise<void>`                      |
 | `menus.show(input)`                   | `Promise<MindooDBAppShowMenuResult>` |
 | `menus.hide()`                        | `Promise<void>`                      |
+| `drag.setProfile(profile)`            | `Promise<void>`                      |
+| `drag.start(input)`                   | `Promise<MindooDBAppDragStartResult>` |
+| `drag.cancel()`                       | `Promise<void>`                      |
+| `drag.bindSource(el, options)`        | `() => void` (unbind)                |
 | `storage`                             | `MindooDBAppStorageApi`              |
 | `onThemeChange(listener)`             | `() => void` (unsubscribe)           |
 | `onViewportChange(listener)`          | `() => void` (unsubscribe)           |

package/dist/{chunk-7RAKZZA6.js → chunk-ZO7UE6B2.js}

@@ -1,3 +1,344 @@
+// src/drag.ts
+var MINDOODB_APP_MAX_DRAG_TYPES = 8;
+var MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES = 32 * 1024;
+var MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES = 256 * 1024;
+var MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE = 512;
+var DEFAULT_DRAG_LONG_PRESS_MS = 400;
+var DEFAULT_DRAG_POINTER_THRESHOLD_PX = 8;
+var MINIMAL_DRAG_PREVIEW_PNG = Uint8Array.from(
+  atob("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="),
+  (character) => character.charCodeAt(0)
+);
+var DRAG_TYPE_PATTERN = /^[a-z0-9][a-z0-9!#$&^_.+-]{0,126}\/[a-z0-9][a-z0-9!#$&^_.+-]{0,126}$/i;
+var MindooDBAppDragInputError = class extends Error {
+  name = "invalid-drag-input";
+  constructor(message) {
+    super(message);
+  }
+};
+function isMindooDBAppDragType(type) {
+  return DRAG_TYPE_PATTERN.test(type);
+}
+function utf8ByteLength(value) {
+  return new TextEncoder().encode(value).length;
+}
+function requireFiniteNumber(value, fieldPath) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new MindooDBAppDragInputError(`Expected ${fieldPath} to be a finite number.`);
+  }
+  return value;
+}
+function toPreviewArrayBuffer(value) {
+  if (value instanceof ArrayBuffer) {
+    return value.slice(0);
+  }
+  if (ArrayBuffer.isView(value)) {
+    return value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength);
+  }
+  return null;
+}
+function normalizeDragType(value, fieldPath) {
+  if (typeof value !== "string" || !isMindooDBAppDragType(value)) {
+    throw new MindooDBAppDragInputError(`Expected ${fieldPath} to be a MIME-like type string.`);
+  }
+  return value;
+}
+function normalizeOffers(value) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new MindooDBAppDragInputError("A drag must offer at least one type.");
+  }
+  if (value.length > MINDOODB_APP_MAX_DRAG_TYPES) {
+    throw new MindooDBAppDragInputError(
+      `A drag supports at most ${MINDOODB_APP_MAX_DRAG_TYPES} types.`
+    );
+  }
+  const seen = /* @__PURE__ */ new Set();
+  return value.map((entry, index) => {
+    if (!entry || typeof entry !== "object") {
+      throw new MindooDBAppDragInputError(`Expected offers[${index}] to be an object.`);
+    }
+    const candidate = entry;
+    const type = normalizeDragType(candidate.type, `offers[${index}].type`);
+    if (seen.has(type)) {
+      throw new MindooDBAppDragInputError(`Duplicate drag type "${type}".`);
+    }
+    seen.add(type);
+    if (typeof candidate.data !== "string") {
+      throw new MindooDBAppDragInputError(`Expected offers[${index}].data to be a string.`);
+    }
+    if (utf8ByteLength(candidate.data) > MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES) {
+      throw new MindooDBAppDragInputError(
+        `offers[${index}].data exceeds ${MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES} bytes.`
+      );
+    }
+    return { type, data: candidate.data };
+  });
+}
+function normalizeDragAccepts(value) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new MindooDBAppDragInputError("A drag profile must accept at least one type.");
+  }
+  if (value.length > MINDOODB_APP_MAX_DRAG_TYPES) {
+    throw new MindooDBAppDragInputError(
+      `A drag profile supports at most ${MINDOODB_APP_MAX_DRAG_TYPES} types.`
+    );
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const accepts = [];
+  value.forEach((entry, index) => {
+    const type = normalizeDragType(entry, `accepts[${index}]`);
+    if (seen.has(type)) {
+      return;
+    }
+    seen.add(type);
+    accepts.push(type);
+  });
+  return accepts;
+}
+function normalizePreview(value) {
+  if (!value || typeof value !== "object") {
+    throw new MindooDBAppDragInputError("A drag preview is required.");
+  }
+  const candidate = value;
+  const pngBuffer = toPreviewArrayBuffer(candidate.png);
+  if (!pngBuffer) {
+    throw new MindooDBAppDragInputError("preview.png must be an ArrayBuffer.");
+  }
+  if (pngBuffer.byteLength === 0 || pngBuffer.byteLength > MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES) {
+    throw new MindooDBAppDragInputError(
+      `preview.png must be between 1 and ${MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES} bytes.`
+    );
+  }
+  const width = requireFiniteNumber(candidate.width, "preview.width");
+  const height = requireFiniteNumber(candidate.height, "preview.height");
+  if (width <= 0 || height <= 0 || width > MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE * 4 || height > MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE * 4) {
+    throw new MindooDBAppDragInputError("preview width/height are out of range.");
+  }
+  return {
+    png: pngBuffer,
+    width,
+    height,
+    hotspotX: requireFiniteNumber(candidate.hotspotX, "preview.hotspotX"),
+    hotspotY: requireFiniteNumber(candidate.hotspotY, "preview.hotspotY")
+  };
+}
+function normalizeDragStartInput(value) {
+  if (!value || typeof value !== "object") {
+    throw new MindooDBAppDragInputError("drag.start requires a payload object.");
+  }
+  const candidate = value;
+  if (!candidate.pointer || typeof candidate.pointer !== "object") {
+    throw new MindooDBAppDragInputError("pointer is required.");
+  }
+  const pointer = candidate.pointer;
+  let allowedEffects;
+  if (candidate.allowedEffects !== void 0) {
+    if (!Array.isArray(candidate.allowedEffects) || candidate.allowedEffects.length === 0 || candidate.allowedEffects.some((effect) => effect !== "copy")) {
+      throw new MindooDBAppDragInputError('allowedEffects may only include "copy".');
+    }
+    allowedEffects = ["copy"];
+  }
+  return {
+    offers: normalizeOffers(candidate.offers),
+    preview: normalizePreview(candidate.preview),
+    pointer: {
+      x: requireFiniteNumber(pointer.x, "pointer.x"),
+      y: requireFiniteNumber(pointer.y, "pointer.y")
+    },
+    allowedEffects
+  };
+}
+function canvasToPng(canvas) {
+  if (typeof canvas.toBlob === "function") {
+    return new Promise((resolve, reject) => {
+      canvas.toBlob((blob) => {
+        if (!blob) {
+          reject(new Error("Could not encode the drag preview as PNG."));
+          return;
+        }
+        void blob.arrayBuffer().then(resolve, reject);
+      }, "image/png");
+    });
+  }
+  if (typeof canvas.toDataURL !== "function") {
+    return Promise.resolve(MINIMAL_DRAG_PREVIEW_PNG.buffer.slice(0));
+  }
+  const dataUrl = canvas.toDataURL("image/png");
+  const encoded = dataUrl.split(",")[1];
+  if (!encoded) {
+    return Promise.resolve(MINIMAL_DRAG_PREVIEW_PNG.buffer.slice(0));
+  }
+  const binary = atob(encoded);
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index += 1) {
+    bytes[index] = binary.charCodeAt(index);
+  }
+  return Promise.resolve(bytes.buffer);
+}
+function drawFallbackCard(element, width, height) {
+  if (typeof document === "undefined") {
+    return null;
+  }
+  const canvas = document.createElement("canvas");
+  canvas.width = width;
+  canvas.height = height;
+  const context = canvas.getContext("2d");
+  if (!context) {
+    return null;
+  }
+  context.fillStyle = "#1c2333";
+  context.fillRect(0, 0, width, height);
+  context.strokeStyle = "#6ea8fe";
+  context.strokeRect(0.5, 0.5, width - 1, height - 1);
+  context.fillStyle = "#f4f7fb";
+  context.font = "12px sans-serif";
+  const label = (element.textContent ?? "").replace(/\s+/g, " ").trim().slice(0, 48);
+  context.fillText(label || "Drag", 8, Math.min(20, height - 6));
+  return canvas;
+}
+function scaledPreviewSize(width, height) {
+  const safeWidth = Math.max(1, Math.round(width));
+  const safeHeight = Math.max(1, Math.round(height));
+  const scale = Math.min(1, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE / Math.max(safeWidth, safeHeight));
+  return {
+    width: Math.max(1, Math.round(safeWidth * scale)),
+    height: Math.max(1, Math.round(safeHeight * scale))
+  };
+}
+async function snapshotElementToPng(element) {
+  const bounds = element.getBoundingClientRect();
+  const size = scaledPreviewSize(bounds.width || 160, bounds.height || 72);
+  const canvas = drawFallbackCard(element, size.width, size.height);
+  const png = canvas ? await canvasToPng(canvas) : MINIMAL_DRAG_PREVIEW_PNG.buffer.slice(0);
+  if (png.byteLength > MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES) {
+    throw new MindooDBAppDragInputError(
+      `Drag preview exceeds ${MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES} bytes.`
+    );
+  }
+  return {
+    png,
+    width: size.width,
+    height: size.height,
+    hotspotX: size.width / 2,
+    hotspotY: size.height / 2
+  };
+}
+function pointerDistance(origin, event) {
+  const dx = event.clientX - origin.x;
+  const dy = event.clientY - origin.y;
+  return Math.hypot(dx, dy);
+}
+function readOffers(options) {
+  return typeof options.offers === "function" ? options.offers() : options.offers;
+}
+function readPreviewElement(source, options) {
+  if (!options.preview) {
+    return source;
+  }
+  return typeof options.preview === "function" ? options.preview() : options.preview;
+}
+function bindDragSource(element, options, start) {
+  const longPressMs = options.longPressMs ?? DEFAULT_DRAG_LONG_PRESS_MS;
+  const thresholdPx = options.pointerThresholdPx ?? DEFAULT_DRAG_POINTER_THRESHOLD_PX;
+  let active = null;
+  const reset = () => {
+    if (active?.timer != null) {
+      clearTimeout(active.timer);
+    }
+    active = null;
+  };
+  const beginHostDrag = async (event) => {
+    if (!active || active.started) {
+      return;
+    }
+    active.started = true;
+    if (active.timer != null) {
+      clearTimeout(active.timer);
+      active.timer = null;
+    }
+    const offers = readOffers(options);
+    if (offers.length === 0) {
+      reset();
+      return;
+    }
+    event.preventDefault();
+    const preview = await active.preview;
+    const hotX = event.clientX - element.getBoundingClientRect().left;
+    const hotY = event.clientY - element.getBoundingClientRect().top;
+    await start({
+      offers,
+      preview: {
+        ...preview,
+        hotspotX: hotX,
+        hotspotY: hotY
+      },
+      pointer: { x: event.clientX, y: event.clientY },
+      allowedEffects: ["copy"]
+    });
+  };
+  const onPointerDown = (event) => {
+    if (event.button !== 0) {
+      return;
+    }
+    reset();
+    const previewElement = readPreviewElement(element, options);
+    active = {
+      pointerId: event.pointerId,
+      origin: { x: event.clientX, y: event.clientY },
+      pointerType: event.pointerType,
+      preview: snapshotElementToPng(previewElement).catch(() => ({
+        png: MINIMAL_DRAG_PREVIEW_PNG.buffer.slice(0),
+        width: Math.max(1, Math.round(previewElement.getBoundingClientRect().width) || 160),
+        height: Math.max(1, Math.round(previewElement.getBoundingClientRect().height) || 72),
+        hotspotX: 0,
+        hotspotY: 0
+      })),
+      timer: null,
+      started: false
+    };
+    if (event.pointerType === "touch") {
+      active.timer = setTimeout(() => {
+        if (!active || active.started) {
+          return;
+        }
+        void beginHostDrag(event);
+      }, longPressMs);
+    }
+  };
+  const onPointerMove = (event) => {
+    if (!active || event.pointerId !== active.pointerId || active.started) {
+      return;
+    }
+    const distance = pointerDistance(active.origin, event);
+    if (active.pointerType === "touch") {
+      if (distance > thresholdPx) {
+        reset();
+      }
+      return;
+    }
+    if (distance >= thresholdPx) {
+      void beginHostDrag(event);
+    }
+  };
+  const onPointerUp = (event) => {
+    if (!active || event.pointerId !== active.pointerId) {
+      return;
+    }
+    reset();
+  };
+  element.addEventListener("pointerdown", onPointerDown);
+  window.addEventListener("pointermove", onPointerMove);
+  window.addEventListener("pointerup", onPointerUp);
+  window.addEventListener("pointercancel", onPointerUp);
+  return () => {
+    reset();
+    element.removeEventListener("pointerdown", onPointerDown);
+    window.removeEventListener("pointermove", onPointerMove);
+    window.removeEventListener("pointerup", onPointerUp);
+    window.removeEventListener("pointercancel", onPointerUp);
+  };
+}
+
 // src/hostShortcuts.ts
 var DEFAULT_HAVEN_HOST_SHORTCUTS = [
   { action: "open-workspace", code: "Enter", shiftKey: true, metaOrCtrl: true },
@@ -287,6 +628,15 @@ function isUiPreferencesChangedMessage(message) {
 function isLocaleChangedMessage(message) {
   return message.kind === "locale-changed";
 }
+function isDragOverMessage(message) {
+  return message.kind === "drag-over";
+}
+function isDragLeaveMessage(message) {
+  return message.kind === "drag-leave";
+}
+function isDragDropMessage(message) {
+  return message.kind === "drag-drop";
+}
 function toStreamError(message) {
   const error = new Error(message.error.message);
   error.name = message.error.code || "MindooDBAppBridgeStreamError";
@@ -1163,6 +1513,70 @@ var MindooDBAppDatabaseImpl = class {
     });
   }
 };
+var MindooDBAppDragApiImpl = class {
+  constructor(rpc) {
+    this.rpc = rpc;
+    this.rpc.addMessageListener((message) => {
+      if (isDragOverMessage(message)) {
+        const result = this.profile?.onOver?.({
+          x: message.x,
+          y: message.y,
+          types: message.types
+        });
+        const accept = result?.accept ?? true;
+        void this.rpc.call("drag.reportHover", {
+          accept,
+          effect: accept ? result?.effect ?? "copy" : "forbidden"
+        }).catch((error) => {
+          console.warn("[mindoodb-app-sdk] Could not report a drag hover.", error);
+        });
+        return;
+      }
+      if (isDragLeaveMessage(message)) {
+        this.profile?.onLeave?.();
+        return;
+      }
+      if (isDragDropMessage(message)) {
+        this.profile?.onDrop?.({
+          x: message.x,
+          y: message.y,
+          items: message.items
+        });
+      }
+    });
+  }
+  rpc;
+  profile = null;
+  unbindSources = /* @__PURE__ */ new Set();
+  async setProfile(profile) {
+    this.profile = profile;
+    await this.rpc.call("drag.setProfile", {
+      accepts: normalizeDragAccepts(profile.accepts)
+    });
+  }
+  async start(input) {
+    return await this.rpc.call(
+      "drag.start",
+      normalizeDragStartInput(input)
+    );
+  }
+  async cancel() {
+    await this.rpc.call("drag.cancel", {});
+  }
+  bindSource(element, options) {
+    const unbind = bindDragSource(element, options, (input) => this.start(input));
+    this.unbindSources.add(unbind);
+    return () => {
+      unbind();
+      this.unbindSources.delete(unbind);
+    };
+  }
+  dispose() {
+    this.unbindSources.forEach((unbind) => unbind());
+    this.unbindSources.clear();
+    this.profile = null;
+  }
+};
 var MindooDBAppSessionImpl = class {
   constructor(rpc, onDisconnect, hostShortcutsEnabled = true) {
     this.rpc = rpc;
@@ -1173,6 +1587,7 @@ var MindooDBAppSessionImpl = class {
         await this.rpc.call("menus.hide", {});
       }
     };
+    this.drag = new MindooDBAppDragApiImpl(this.rpc);
     this.storage = {
       snapshot: async (options) => await this.rpc.call("appStorage.snapshot", {
         prefixes: options?.prefixes
@@ -1221,6 +1636,7 @@ var MindooDBAppSessionImpl = class {
   rpc;
   onDisconnect;
   menus;
+  drag;
   storage;
   beforeCloseListeners = /* @__PURE__ */ new Set();
   hostShortcuts = DEFAULT_HAVEN_HOST_SHORTCUTS;
@@ -1363,6 +1779,7 @@ var MindooDBAppSessionImpl = class {
   /** Disconnects from the host and always disposes the underlying port client. */
   async disconnect() {
     this.stopHostShortcuts();
+    this.drag.dispose();
     try {
       await this.rpc.call("session.disconnect", {});
     } finally {
@@ -1415,6 +1832,19 @@ function createMindooDBAppBridge() {
 }
 
 export {
+  MINDOODB_APP_MAX_DRAG_TYPES,
+  MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES,
+  MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES,
+  MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE,
+  DEFAULT_DRAG_LONG_PRESS_MS,
+  DEFAULT_DRAG_POINTER_THRESHOLD_PX,
+  MINIMAL_DRAG_PREVIEW_PNG,
+  MindooDBAppDragInputError,
+  isMindooDBAppDragType,
+  normalizeDragAccepts,
+  normalizeDragStartInput,
+  snapshotElementToPng,
+  bindDragSource,
   DEFAULT_HAVEN_HOST_SHORTCUTS,
   matchHostShortcut,
   isHostShortcutAction,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge, b as MindooDBAppHostShortcutBinding, c as MindooDBAppHostShortcutAction, d as MindooDBAppHostingMode, e as MindooDBAppDatabase, f as MindooDBAppDocument, g as MindooDBAppRichTextSpan, h as MindooDBAppRichTextSnapshot } from './types-DALNnPXo.js';
-export { i as MINDOODB_APP_SEAL_SIGNING_DOMAIN, j as MindooDBAppAccessDecision, k as MindooDBAppAccessTier, l as MindooDBAppAttachmentApi, m as MindooDBAppAttachmentChunk, n as MindooDBAppAttachmentInfo, o as MindooDBAppAttachmentPreviewOptions, p as MindooDBAppAttachmentPreviewSession, q as MindooDBAppAutomergeChangesPatch, r as MindooDBAppAutomergeChangesSince, s as MindooDBAppAutomergeGetOptions, t as MindooDBAppAutomergePatchResult, u as MindooDBAppAutomergeSnapshot, v as MindooDBAppBridgeBeforeCloseAck, w as MindooDBAppBridgeBeforeCloseMessage, x as MindooDBAppBridgeConnectMessage, y as MindooDBAppBridgeConnectOptions, z as MindooDBAppBridgeConnectedMessage, A as MindooDBAppBridgeErrorPayload, B as MindooDBAppBridgeHandshakeErrorMessage, C as MindooDBAppBridgeLocaleChangedMessage, D as MindooDBAppBridgePortMessage, E as MindooDBAppBridgeQueryResultMessage, F as MindooDBAppBridgeRpcError, G as MindooDBAppBridgeRpcMessage, H as MindooDBAppBridgeRpcRequest, I as MindooDBAppBridgeRpcSuccess, J as MindooDBAppBridgeShortcutInvokedMessage, K as MindooDBAppBridgeShortcutsChangedMessage, L as MindooDBAppBridgeStreamAbortRequest, N as MindooDBAppBridgeStreamAck, O as MindooDBAppBridgeStreamCloseRequest, P as MindooDBAppBridgeStreamError, Q as MindooDBAppBridgeStreamMessage, R as MindooDBAppBridgeStreamOpenResult, S as MindooDBAppBridgeStreamReadRequest, T as MindooDBAppBridgeStreamWriteRequest, U as MindooDBAppBridgeThemeChangedMessage, V as MindooDBAppBridgeUiPreferencesChangedMessage, W as MindooDBAppBridgeViewChangedMessage, X as MindooDBAppBridgeViewportChangedMessage, Y as MindooDBAppCapability, Z as MindooDBAppConfiguredViewCategorizationStyle, _ as MindooDBAppConfiguredViewColumn, $ as MindooDBAppConfiguredViewColumnRole, a0 as MindooDBAppConfiguredViewExpressionMode, a1 as MindooDBAppConfiguredViewFieldExpression, a2 as MindooDBAppConfiguredViewFilterDefinition, a3 as MindooDBAppConfiguredViewFilterMode, a4 as MindooDBAppConfiguredViewFilterRule, a5 as MindooDBAppConfiguredViewFormulaExpression, a6 as MindooDBAppConfiguredViewFormulaFilterDefinition, a7 as MindooDBAppConfiguredViewPreviewMode, a8 as MindooDBAppConfiguredViewRuleFilterDefinition, a9 as MindooDBAppConfiguredViewRuleMatchMode, aa as MindooDBAppConfiguredViewRuleOperator, ab as MindooDBAppConfiguredViewValueExpression, ac as MindooDBAppCreateDocumentInput, ad as MindooDBAppCreateKeyInfo, ae as MindooDBAppCreateViewInput, af as MindooDBAppCreateViewNavigatorInput, ag as MindooDBAppDatabaseInfo, ah as MindooDBAppDirectoryApi, ai as MindooDBAppDirectoryEntry, aj as MindooDBAppDocumentApi, ak as MindooDBAppDocumentHeadCursorResult, al as MindooDBAppDocumentHistoryEntry, am as MindooDBAppDocumentListQuery, an as MindooDBAppDocumentListResult, ao as MindooDBAppDocumentQuery, ap as MindooDBAppDocumentRevisionId, aq as MindooDBAppDocumentScanPreset, ar as MindooDBAppDocumentSummary, as as MindooDBAppEntryAttachmentRef, at as MindooDBAppEntryProvenance, au as MindooDBAppExtractDocumentTextInput, av as MindooDBAppExtractDocumentTextResult, aw as MindooDBAppExtractTextFormat, ax as MindooDBAppExtractionSetup, ay as MindooDBAppFulltextSetup, az as MindooDBAppHistoricalDocument, aA as MindooDBAppHistoryQuery, aB as MindooDBAppHostTheme, aC as MindooDBAppIdentityApi, aD as MindooDBAppInaccessibleDocument, aE as MindooDBAppInaccessibleDocumentListQuery, aF as MindooDBAppInaccessibleDocumentListResult, aG as MindooDBAppJsonListDeletePatch, aH as MindooDBAppJsonListInsertPatch, aI as MindooDBAppJsonPatch, aJ as MindooDBAppJsonSetPatch, aK as MindooDBAppJsonTextMarkPatch, aL as MindooDBAppJsonTextSplicePatch, aM as MindooDBAppJsonTextUnmarkPatch, aN as MindooDBAppJsonUnsetPatch, aO as MindooDBAppLaunchContext, aP as MindooDBAppLiveQuerySubscription, aQ as MindooDBAppMenuAnchor, aR as MindooDBAppMenuApi, aS as MindooDBAppMenuCommandItem, aT as MindooDBAppMenuDismissReason, aU as MindooDBAppMenuDismissedResult, aV as MindooDBAppMenuItem, aW as MindooDBAppMenuKind, aX as MindooDBAppMenuPlacement, aY as MindooDBAppMenuPointAnchor, aZ as MindooDBAppMenuRect, a_ as MindooDBAppMenuRectAnchor, a$ as MindooDBAppMenuSelectionResult, b0 as MindooDBAppMenuSeparatorItem, b1 as MindooDBAppQueryCoverage, b2 as MindooDBAppQueryResult, b3 as MindooDBAppQueryRow, b4 as MindooDBAppQuerySortKey, b5 as MindooDBAppQueryTextClause, b6 as MindooDBAppReadableAttachmentStream, b7 as MindooDBAppRecipientOptions, b8 as MindooDBAppResolvedViewDefinition, b9 as MindooDBAppResolvedViewSource, ba as MindooDBAppRevisionPhase, bb as MindooDBAppRevisionVerification, bc as MindooDBAppRichTextBlockSpan, bd as MindooDBAppRichTextGetOptions, be as MindooDBAppRichTextImmutableString, bf as MindooDBAppRichTextMarkRange, bg as MindooDBAppRichTextMaterializeValue, bh as MindooDBAppRichTextPatch, bi as MindooDBAppRichTextScalar, bj as MindooDBAppRichTextSpliceStep, bk as MindooDBAppRichTextStep, bl as MindooDBAppRichTextStepPatch, bm as MindooDBAppRichTextTextSpan, bn as MindooDBAppRuntime, bo as MindooDBAppScanAttachmentOptions, bp as MindooDBAppScanAttachmentResult, bq as MindooDBAppScopedDocId, br as MindooDBAppScopedDocumentSummary, bs as MindooDBAppSealIntent, bt as MindooDBAppSealedChannelOpenInput, bu as MindooDBAppSealedChannelOpenResult, bv as MindooDBAppSealedChannelRequestInput, bw as MindooDBAppSession, bx as MindooDBAppShowMenuInput, by as MindooDBAppShowMenuResult, bz as MindooDBAppSignPreview, bA as MindooDBAppSignPreviewScope, bB as MindooDBAppSignStatementInput, bC as MindooDBAppSignStatementResult, bD as MindooDBAppStorageApi, bE as MindooDBAppTextEdit, bF as MindooDBAppTextPatch, bG as MindooDBAppThemeMode, bH as MindooDBAppTimestampApi, bI as MindooDBAppTimestampInput, bJ as MindooDBAppTimestampProvider, bK as MindooDBAppTimestampResult, bL as MindooDBAppUiPreferences, bM as MindooDBAppUpdateDocumentInput, bN as MindooDBAppViewCursorDocumentListResult, bO as MindooDBAppViewCursorResult, bP as MindooDBAppViewEntry, bQ as MindooDBAppViewEntryKind, bR as MindooDBAppViewNavigator, bS as MindooDBAppViewNavigatorExpansionState, bT as MindooDBAppViewNavigatorOpenOptions, bU as MindooDBAppViewNavigatorPageOptions, bV as MindooDBAppViewNavigatorPageResult, bW as MindooDBAppViewNavigatorRangeQuery, bX as MindooDBAppViewNavigatorSelectionState, bY as MindooDBAppViewUpdateStats, bZ as MindooDBAppViewport, b_ as MindooDBAppWritableAttachmentStream } from './types-DALNnPXo.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 } from './types-M3RwHErO.js';
+export { m as MINDOODB_APP_SEAL_SIGNING_DOMAIN, n as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, o as MindooDBAppAccessDecision, p as MindooDBAppAccessTier, q as MindooDBAppAttachmentApi, r as MindooDBAppAttachmentChunk, s as MindooDBAppAttachmentInfo, t as MindooDBAppAttachmentPreviewOptions, u as MindooDBAppAttachmentPreviewSession, v as MindooDBAppAutomergeChangesPatch, w as MindooDBAppAutomergeChangesSince, x as MindooDBAppAutomergeGetOptions, y as MindooDBAppAutomergePatchResult, z as MindooDBAppAutomergeSnapshot, A as MindooDBAppBridgeBeforeCloseAck, B as MindooDBAppBridgeBeforeCloseMessage, C as MindooDBAppBridgeConnectMessage, D as MindooDBAppBridgeConnectOptions, E as MindooDBAppBridgeConnectedMessage, F as MindooDBAppBridgeDragDropMessage, G as MindooDBAppBridgeDragLeaveMessage, H as MindooDBAppBridgeDragOverMessage, I as MindooDBAppBridgeErrorPayload, J as MindooDBAppBridgeHandshakeErrorMessage, K as MindooDBAppBridgeLocaleChangedMessage, L as MindooDBAppBridgePortMessage, N as MindooDBAppBridgeQueryResultMessage, O as MindooDBAppBridgeRpcError, P as MindooDBAppBridgeRpcMessage, Q as MindooDBAppBridgeRpcRequest, R as MindooDBAppBridgeRpcSuccess, S as MindooDBAppBridgeShortcutInvokedMessage, T as MindooDBAppBridgeShortcutsChangedMessage, U as MindooDBAppBridgeStreamAbortRequest, V as MindooDBAppBridgeStreamAck, W as MindooDBAppBridgeStreamCloseRequest, X as MindooDBAppBridgeStreamError, Y as MindooDBAppBridgeStreamMessage, Z as MindooDBAppBridgeStreamOpenResult, _ as MindooDBAppBridgeStreamReadRequest, $ as MindooDBAppBridgeStreamWriteRequest, a0 as MindooDBAppBridgeThemeChangedMessage, a1 as MindooDBAppBridgeUiPreferencesChangedMessage, a2 as MindooDBAppBridgeViewChangedMessage, a3 as MindooDBAppBridgeViewportChangedMessage, a4 as MindooDBAppCapability, a5 as MindooDBAppConfiguredViewCategorizationStyle, a6 as MindooDBAppConfiguredViewColumn, a7 as MindooDBAppConfiguredViewColumnRole, a8 as MindooDBAppConfiguredViewExpressionMode, a9 as MindooDBAppConfiguredViewFieldExpression, aa as MindooDBAppConfiguredViewFilterDefinition, ab as MindooDBAppConfiguredViewFilterMode, ac as MindooDBAppConfiguredViewFilterRule, ad as MindooDBAppConfiguredViewFormulaExpression, ae as MindooDBAppConfiguredViewFormulaFilterDefinition, af as MindooDBAppConfiguredViewPreviewMode, ag as MindooDBAppConfiguredViewRuleFilterDefinition, ah as MindooDBAppConfiguredViewRuleMatchMode, ai as MindooDBAppConfiguredViewRuleOperator, aj as MindooDBAppConfiguredViewValueExpression, ak as MindooDBAppCreateDocumentInput, al as MindooDBAppCreateKeyInfo, am as MindooDBAppCreateViewInput, an as MindooDBAppCreateViewNavigatorInput, ao as MindooDBAppDatabaseInfo, ap as MindooDBAppDirectoryApi, aq as MindooDBAppDirectoryEntry, ar as MindooDBAppDocumentApi, as as MindooDBAppDocumentHeadCursorResult, at as MindooDBAppDocumentHistoryEntry, au as MindooDBAppDocumentListQuery, av as MindooDBAppDocumentListResult, aw as MindooDBAppDocumentQuery, ax as MindooDBAppDocumentRevisionId, ay as MindooDBAppDocumentScanPreset, az as MindooDBAppDocumentSummary, aA as MindooDBAppDragApi, aB as MindooDBAppDragCancelReason, aC as MindooDBAppDragDropEvent, aD as MindooDBAppDragEffect, aE as MindooDBAppDragHoverResult, aF as MindooDBAppDragOffer, aG as MindooDBAppDragOverEvent, aH as MindooDBAppDragPointer, aI as MindooDBAppDragProfile, aJ as MindooDBAppEntryAttachmentRef, aK as MindooDBAppEntryProvenance, aL as MindooDBAppExtractDocumentTextInput, aM as MindooDBAppExtractDocumentTextResult, aN as MindooDBAppExtractTextFormat, aO as MindooDBAppExtractionSetup, aP as MindooDBAppFulltextSetup, aQ as MindooDBAppHistoricalDocument, aR as MindooDBAppHistoryQuery, aS as MindooDBAppHostTheme, aT as MindooDBAppIdentityApi, aU as MindooDBAppInaccessibleDocument, aV as MindooDBAppInaccessibleDocumentListQuery, aW as MindooDBAppInaccessibleDocumentListResult, aX as MindooDBAppJsonListDeletePatch, aY as MindooDBAppJsonListInsertPatch, aZ as MindooDBAppJsonPatch, a_ as MindooDBAppJsonSetPatch, a$ as MindooDBAppJsonTextMarkPatch, b0 as MindooDBAppJsonTextSplicePatch, b1 as MindooDBAppJsonTextUnmarkPatch, b2 as MindooDBAppJsonUnsetPatch, b3 as MindooDBAppLaunchContext, b4 as MindooDBAppLiveQuerySubscription, b5 as MindooDBAppMenuAnchor, b6 as MindooDBAppMenuApi, b7 as MindooDBAppMenuCommandItem, b8 as MindooDBAppMenuDismissReason, b9 as MindooDBAppMenuDismissedResult, ba as MindooDBAppMenuItem, bb as MindooDBAppMenuKind, bc as MindooDBAppMenuPlacement, bd as MindooDBAppMenuPointAnchor, be as MindooDBAppMenuRect, bf as MindooDBAppMenuRectAnchor, bg as MindooDBAppMenuSelectionResult, bh as MindooDBAppMenuSeparatorItem, bi as MindooDBAppQueryCoverage, bj as MindooDBAppQueryResult, bk as MindooDBAppQueryRow, bl as MindooDBAppQuerySortKey, bm as MindooDBAppQueryTextClause, bn as MindooDBAppReadableAttachmentStream, bo as MindooDBAppRecipientOptions, bp as MindooDBAppResolvedViewDefinition, bq as MindooDBAppResolvedViewSource, br as MindooDBAppRevisionPhase, bs as MindooDBAppRevisionVerification, bt as MindooDBAppRichTextBlockSpan, bu as MindooDBAppRichTextGetOptions, bv as MindooDBAppRichTextImmutableString, bw as MindooDBAppRichTextMarkRange, bx as MindooDBAppRichTextMaterializeValue, by as MindooDBAppRichTextPatch, bz as MindooDBAppRichTextScalar, bA as MindooDBAppRichTextSpliceStep, bB as MindooDBAppRichTextStep, bC as MindooDBAppRichTextStepPatch, bD as MindooDBAppRichTextTextSpan, bE as MindooDBAppRuntime, bF as MindooDBAppScanAttachmentOptions, bG as MindooDBAppScanAttachmentResult, bH as MindooDBAppScopedDocId, bI as MindooDBAppScopedDocumentSummary, bJ as MindooDBAppSealIntent, bK as MindooDBAppSealedChannelOpenInput, bL as MindooDBAppSealedChannelOpenResult, bM as MindooDBAppSealedChannelRequestInput, bN as MindooDBAppSession, bO as MindooDBAppShowMenuInput, bP as MindooDBAppShowMenuResult, bQ as MindooDBAppSignPreview, bR as MindooDBAppSignPreviewScope, bS as MindooDBAppSignStatementInput, bT as MindooDBAppSignStatementResult, bU as MindooDBAppStorageApi, bV as MindooDBAppTextEdit, bW as MindooDBAppTextPatch, bX as MindooDBAppThemeMode, bY as MindooDBAppTimestampApi, bZ as MindooDBAppTimestampInput, b_ as MindooDBAppTimestampProvider, b$ as MindooDBAppTimestampResult, c0 as MindooDBAppUiPreferences, c1 as MindooDBAppUpdateDocumentInput, c2 as MindooDBAppViewCursorDocumentListResult, c3 as MindooDBAppViewCursorResult, c4 as MindooDBAppViewEntry, c5 as MindooDBAppViewEntryKind, c6 as MindooDBAppViewNavigator, c7 as MindooDBAppViewNavigatorExpansionState, c8 as MindooDBAppViewNavigatorOpenOptions, c9 as MindooDBAppViewNavigatorPageOptions, ca as MindooDBAppViewNavigatorPageResult, cb as MindooDBAppViewNavigatorRangeQuery, cc as MindooDBAppViewNavigatorSelectionState, cd as MindooDBAppViewUpdateStats, ce as MindooDBAppViewport, cf as MindooDBAppWellKnownDragType, cg as MindooDBAppWritableAttachmentStream } from './types-M3RwHErO.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';
@@ -31,6 +31,57 @@ declare function abbreviateCanonicalName(value: string): string;
  */
 declare function expandAbbreviatedName(value: string): string;
 
+/**
+ * Client helpers for host-owned cross-iframe drag.
+ *
+ * Validation lives here so the SDK rejects bad `start` / `setProfile`
+ * payloads before they cross the bridge. Haven re-validates the same
+ * limits on untyped JSON. `bindDragSource` and `snapshotElementToPng`
+ * stay in the app document: Haven only ever receives PNG bytes and
+ * string snapshots.
+ *
+ * @module drag
+ */
+
+/** Maximum number of types in one profile or start payload. */
+declare const MINDOODB_APP_MAX_DRAG_TYPES = 8;
+/** Maximum UTF-8 size of one offer string. */
+declare const MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES: number;
+/** Maximum encoded PNG size for the host ghost. */
+declare const MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES: number;
+/** Longest CSS-pixel edge Haven will display for a ghost. */
+declare const MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE = 512;
+/** Touch hold before the host takes over. */
+declare const DEFAULT_DRAG_LONG_PRESS_MS = 400;
+/** Mouse/pen start distance, and touch scroll-cancel slop. */
+declare const DEFAULT_DRAG_POINTER_THRESHOLD_PX = 8;
+/**
+ * 1×1 PNG used when the browser cannot snapshot a node. Haven still
+ * sizes the ghost from `preview.width` / `preview.height`.
+ */
+declare const MINIMAL_DRAG_PREVIEW_PNG: Uint8Array<ArrayBuffer>;
+/** Structured validation failure. `name` is the bridge error code. */
+declare class MindooDBAppDragInputError extends Error {
+    name: string;
+    constructor(message: string);
+}
+/** True when `type` is a MIME-like token Haven will accept. */
+declare function isMindooDBAppDragType(type: string): boolean;
+/** Project and validate the `accepts` list sent with `drag.setProfile`. */
+declare function normalizeDragAccepts(value: unknown): string[];
+/** Project and validate a `drag.start` payload. */
+declare function normalizeDragStartInput(value: unknown): MindooDBAppDragStartInput;
+/**
+ * Snapshot an element in the app document. Failures fall back to a labeled
+ * card or a 1×1 PNG — Haven must never receive HTML.
+ */
+declare function snapshotElementToPng(element: HTMLElement): Promise<MindooDBAppDragPreview>;
+/**
+ * Start a host drag from a pointer gesture. Mouse/pen use a move threshold;
+ * touch waits for a long-press so lists can still scroll.
+ */
+declare function bindDragSource(element: HTMLElement, options: MindooDBAppDragBindSourceOptions, start: (input: MindooDBAppDragStartInput) => Promise<MindooDBAppDragStartResult>): () => void;
+
 /**
  * Drops memoised sessions so the next `connect()` performs a fresh handshake.
  *
@@ -306,4 +357,4 @@ 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_HAVEN_HOST_SHORTCUTS, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, MINDOODB_APP_HOSTING_QUERY_PARAM, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, MindooDBAppDatabase, MindooDBAppDocument, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, abbreviateCanonicalName, applyHostedDocumentOverscrollContain, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, matchHostShortcut, queryDocuments, readMindooDBAppHostingMode, releaseMindooDBAppBridgeSessions, sanitizeHostShortcutBindings };
+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, normalizeDragStartInput, queryDocuments, readMindooDBAppHostingMode, releaseMindooDBAppBridgeSessions, sanitizeHostShortcutBindings, snapshotElementToPng };

package/dist/index.js

@@ -1,13 +1,26 @@
 import {
+  DEFAULT_DRAG_LONG_PRESS_MS,
+  DEFAULT_DRAG_POINTER_THRESHOLD_PX,
   DEFAULT_HAVEN_HOST_SHORTCUTS,
+  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,
+  MindooDBAppDragInputError,
   applyHostedDocumentOverscrollContain,
+  bindDragSource,
   createMindooDBAppBridge,
   installHostShortcutCapture,
   isHostShortcutAction,
+  isMindooDBAppDragType,
   matchHostShortcut,
+  normalizeDragAccepts,
+  normalizeDragStartInput,
   releaseMindooDBAppBridgeSessions,
-  sanitizeHostShortcutBindings
-} from "./chunk-7RAKZZA6.js";
+  sanitizeHostShortcutBindings,
+  snapshotElementToPng
+} from "./chunk-ZO7UE6B2.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
@@ -20,6 +33,12 @@ import {
 } from "./chunk-LT4FK6LU.js";
 
 // src/types.ts
+var MINDOODB_APP_WELL_KNOWN_DRAG_TYPES = [
+  "text/plain",
+  "text/markdown",
+  "application/json",
+  "application/x-mindoo-document"
+];
 var MINDOODB_APP_SEAL_SIGNING_DOMAIN = "mindoodb-seal/v1";
 
 // src/attachmentPreview.ts
@@ -753,17 +772,27 @@ async function queryDocuments(db, filter, sortBy, options) {
   return db.query({ filter: expression, sortBy }, options);
 }
 export {
+  DEFAULT_DRAG_LONG_PRESS_MS,
+  DEFAULT_DRAG_POINTER_THRESHOLD_PX,
   DEFAULT_HAVEN_HOST_SHORTCUTS,
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
   MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
   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_SEAL_SIGNING_DOMAIN,
+  MINDOODB_APP_WELL_KNOWN_DRAG_TYPES,
+  MINIMAL_DRAG_PREVIEW_PNG,
+  MindooDBAppDragInputError,
   MindooDBRichTextHandle,
   MindooDBTextBuffer,
   abbreviateCanonicalName,
   applyHostedDocumentOverscrollContain,
+  bindDragSource,
   buildMindooDBAppBundleContentHashInput,
   canPreviewAttachment,
   createMindooDBAppBridge,
@@ -776,11 +805,15 @@ export {
   isHostShortcutAction,
   isHostedBundleRuntime,
   isMindooDBAppBundleHash,
+  isMindooDBAppDragType,
   matchHostShortcut,
+  normalizeDragAccepts,
+  normalizeDragStartInput,
   normalizeMindooDBAppBundlePath,
   queryDocuments,
   readMindooDBAppHostingMode,
   releaseMindooDBAppBridgeSessions,
   sanitizeHostShortcutBindings,
+  snapshotElementToPng,
   validateMindooDBAppBundleManifest
 };

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { af as MindooDBAppCreateViewNavigatorInput, bR as MindooDBAppViewNavigator, aO as MindooDBAppLaunchContext, ag as MindooDBAppDatabaseInfo, aj as MindooDBAppDocumentApi, bT as MindooDBAppViewNavigatorOpenOptions, l as MindooDBAppAttachmentApi, aC as MindooDBAppIdentityApi, bH as MindooDBAppTimestampApi, ah as MindooDBAppDirectoryApi, f as MindooDBAppDocument, ay as MindooDBAppFulltextSetup, ax as MindooDBAppExtractionSetup, a as MindooDBAppBridge, bw as MindooDBAppSession, H as MindooDBAppBridgeRpcRequest, aB as MindooDBAppHostTheme, bZ as MindooDBAppViewport, bL as MindooDBAppUiPreferences, b2 as MindooDBAppQueryResult, bY as MindooDBAppViewUpdateStats, D as MindooDBAppBridgePortMessage } from '../types-DALNnPXo.js';
+import { an as MindooDBAppCreateViewNavigatorInput, c6 as MindooDBAppViewNavigator, b3 as MindooDBAppLaunchContext, ao as MindooDBAppDatabaseInfo, ar as MindooDBAppDocumentApi, c8 as MindooDBAppViewNavigatorOpenOptions, q as MindooDBAppAttachmentApi, aT as MindooDBAppIdentityApi, bY as MindooDBAppTimestampApi, ap as MindooDBAppDirectoryApi, j as MindooDBAppDocument, aP as MindooDBAppFulltextSetup, aO as MindooDBAppExtractionSetup, e as MindooDBAppBridge, bN as MindooDBAppSession, Q as MindooDBAppBridgeRpcRequest, aS as MindooDBAppHostTheme, ce as MindooDBAppViewport, c0 as MindooDBAppUiPreferences, bj as MindooDBAppQueryResult, cd as MindooDBAppViewUpdateStats, L as MindooDBAppBridgePortMessage, c as MindooDBAppDragStartResult, aI as MindooDBAppDragProfile } from '../types-M3RwHErO.js';
 import * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 
@@ -115,6 +115,8 @@ interface MockMindooDBAppSessionController {
     emitLocaleChange(locale: string): void;
     /** Runs the app's `onBeforeClose` listeners, as the host does before a teardown. */
     emitBeforeClose(): Promise<void>;
+    resolveDrag(result: MindooDBAppDragStartResult): void;
+    getDragProfile(): MindooDBAppDragProfile | null;
 }
 
 declare function createMockMindooDBAppSession(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;

package/dist/testing/index.js

@@ -1,6 +1,6 @@
 import {
   releaseMindooDBAppBridgeSessions
-} from "../chunk-7RAKZZA6.js";
+} from "../chunk-ZO7UE6B2.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
@@ -1857,6 +1857,8 @@ function createMockSessionState(options = {}) {
   const databaseViewApis = /* @__PURE__ */ new Map();
   const sessionViews = /* @__PURE__ */ new Map();
   let activeMenuResolve = null;
+  let activeDragResolve = null;
+  let dragProfile = null;
   let databaseInfos = [];
   const openSealedChannels = /* @__PURE__ */ new Map();
   const appStorage = new Map(Object.entries(options.storage ?? {}));
@@ -1871,6 +1873,32 @@ function createMockSessionState(options = {}) {
       );
     }
   };
+  const drag = {
+    async setProfile(profile) {
+      dragProfile = profile;
+    },
+    async start(_input) {
+      if (activeDragResolve) {
+        activeDragResolve({
+          action: "cancelled",
+          reason: "replaced"
+        });
+      }
+      return await new Promise((resolve) => {
+        activeDragResolve = resolve;
+      });
+    },
+    async cancel() {
+      activeDragResolve?.({
+        action: "cancelled",
+        reason: "source_cancelled"
+      });
+      activeDragResolve = null;
+    },
+    bindSource() {
+      return () => void 0;
+    }
+  };
   const menus = {
     async show(_input) {
       if (activeMenuResolve) {
@@ -2023,6 +2051,7 @@ function createMockSessionState(options = {}) {
       return view;
     },
     menus,
+    drag,
     storage: {
       async snapshot(snapshotOptions) {
         const prefixes = snapshotOptions?.prefixes;
@@ -2146,6 +2175,13 @@ function createMockSessionState(options = {}) {
     },
     async emitBeforeClose() {
       await Promise.all([...beforeCloseListeners].map(async (listener) => listener()));
+    },
+    resolveDrag(result) {
+      activeDragResolve?.(result);
+      activeDragResolve = null;
+    },
+    getDragProfile() {
+      return dragProfile;
     }
   };
 }
@@ -2163,7 +2199,9 @@ function createMockMindooDBAppSession(options = {}) {
     emitViewportChange: state.emitViewportChange,
     emitUiPreferencesChange: state.emitUiPreferencesChange,
     emitLocaleChange: state.emitLocaleChange,
-    emitBeforeClose: state.emitBeforeClose
+    emitBeforeClose: state.emitBeforeClose,
+    resolveDrag: state.resolveDrag,
+    getDragProfile: state.getDragProfile
   };
 }
 function createMockMindooDBAppBridge(options = {}) {

package/dist/{types-DALNnPXo.d.ts → types-M3RwHErO.d.ts}

@@ -979,7 +979,7 @@ interface MindooDBAppBridgeShortcutInvokedMessage {
     action: MindooDBAppHostShortcutAction;
 }
 /** Any message that can travel across the dedicated bridge MessagePort. */
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage;
+type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage;
 /** Placement hint for a host-rendered overlay menu. */
 type MindooDBAppMenuPlacement = "auto" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "right-start" | "left-start";
 /** Semantic hint allowing Haven to tune menu behavior or styling. */
@@ -1053,6 +1053,125 @@ type MindooDBAppShowMenuResult = MindooDBAppMenuSelectionResult | MindooDBAppMen
  * data-only (no HTML/CSS/script crosses the bridge). Intended for
  * `runtime === "iframe"`; window-mode apps can usually render local menus.
  */
+/** Well-known copy payloads for host-owned cross-iframe drag. */
+declare const MINDOODB_APP_WELL_KNOWN_DRAG_TYPES: readonly ["text/plain", "text/markdown", "application/json", "application/x-mindoo-document"];
+/** One of the documented interchange types apps should prefer. */
+type MindooDBAppWellKnownDragType = (typeof MINDOODB_APP_WELL_KNOWN_DRAG_TYPES)[number];
+/** Copy is the only effect in v1. `forbidden` is a hover result, not an offer. */
+type MindooDBAppDragEffect = "copy" | "forbidden";
+/** One typed string snapshot offered at `drag.start`. */
+interface MindooDBAppDragOffer {
+    type: string;
+    data: string;
+}
+/** PNG ghost sent to Haven. Haven never receives HTML. */
+interface MindooDBAppDragPreview {
+    png: ArrayBuffer;
+    width: number;
+    height: number;
+    hotspotX: number;
+    hotspotY: number;
+}
+/** Iframe-viewport pointer at the moment the host should take over. */
+interface MindooDBAppDragPointer {
+    x: number;
+    y: number;
+}
+/** Input for a host-owned drag gesture. Iframe-only, copy-only. */
+interface MindooDBAppDragStartInput {
+    offers: MindooDBAppDragOffer[];
+    preview: MindooDBAppDragPreview;
+    pointer: MindooDBAppDragPointer;
+    allowedEffects?: Array<"copy">;
+}
+/** Why a host drag ended without a copy. */
+type MindooDBAppDragCancelReason = "escape" | "pointercancel" | "gap" | "replaced" | "hide" | "source_cancelled";
+/** Result of `session.drag.start`. */
+type MindooDBAppDragStartResult = {
+    action: "copied";
+} | {
+    action: "cancelled";
+    reason: MindooDBAppDragCancelReason;
+};
+/** Coordinates and offered types pushed to a potential drop target. */
+interface MindooDBAppDragOverEvent {
+    x: number;
+    y: number;
+    types: string[];
+}
+/** Target answer after hit-testing a `drag-over`. */
+interface MindooDBAppDragHoverResult {
+    accept: boolean;
+    effect?: MindooDBAppDragEffect;
+}
+/** Copy payloads delivered to the target on drop. */
+interface MindooDBAppDragDropEvent {
+    x: number;
+    y: number;
+    items: Record<string, string>;
+}
+/**
+ * What this launch can receive, plus in-app callbacks. `accepts` is sent to
+ * Haven; the callbacks stay in the SDK and run from host push events.
+ */
+interface MindooDBAppDragProfile {
+    accepts: string[];
+    onOver?: (event: MindooDBAppDragOverEvent) => MindooDBAppDragHoverResult | void;
+    onLeave?: () => void;
+    onDrop?: (event: MindooDBAppDragDropEvent) => void;
+}
+/** Options for `session.drag.bindSource`. */
+interface MindooDBAppDragBindSourceOptions {
+    offers: MindooDBAppDragOffer[] | (() => MindooDBAppDragOffer[]);
+    /** Touch only: hold this long before Haven takes over. Default 400. */
+    longPressMs?: number;
+    /** Mouse/pen move, or the scroll-cancel slop on touch. Default 8. */
+    pointerThresholdPx?: number;
+    /** Element to snapshot; defaults to the bound source element. */
+    preview?: HTMLElement | (() => HTMLElement);
+}
+/**
+ * Host-owned drag across iframe chicklets. Haven renders the ghost above
+ * every frame; apps only start the gesture and hit-test drops.
+ */
+interface MindooDBAppDragApi {
+    /** Tell Haven which types this launch can receive. */
+    setProfile(profile: MindooDBAppDragProfile): Promise<void>;
+    /**
+     * Hand the gesture to Haven. Resolves when the copy completes or the
+     * user cancels. Iframe-only.
+     */
+    start(input: MindooDBAppDragStartInput): Promise<MindooDBAppDragStartResult>;
+    /** Abort a gesture this app started. */
+    cancel(): Promise<void>;
+    /**
+     * Pointer helper: mouse/pen starts after a small move; touch starts after
+     * a long-press. Each element can be bound independently; the returned
+     * function unbinds only that element.
+     */
+    bindSource(element: HTMLElement, options: MindooDBAppDragBindSourceOptions): () => void;
+}
+/** Host → target: pointer is over this iframe. */
+interface MindooDBAppBridgeDragOverMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "drag-over";
+    x: number;
+    y: number;
+    types: string[];
+}
+/** Host → previous target: pointer left this iframe. */
+interface MindooDBAppBridgeDragLeaveMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "drag-leave";
+}
+/** Host → target: copy payloads for the types this launch accepts. */
+interface MindooDBAppBridgeDragDropMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "drag-drop";
+    x: number;
+    y: number;
+    items: Record<string, string>;
+}
 interface MindooDBAppMenuApi {
     /**
      * Show a host-rendered menu at the given anchor (iframe-relative
@@ -2191,6 +2310,8 @@ interface MindooDBAppSession {
      */
     openViewNavigator(viewId: string, options?: MindooDBAppViewNavigatorOpenOptions): Promise<MindooDBAppViewNavigator>;
     menus: MindooDBAppMenuApi;
+    /** Host-owned cross-iframe drag. Iframe-only; copy-only in v1. */
+    drag: MindooDBAppDragApi;
     /**
      * Host-backed key/value storage for this app registration. Usable in both hosting
      * modes; required in `"hosted"` mode, where `localStorage` throws.
@@ -2248,4 +2369,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppConfiguredViewColumnRole as $, type MindooDBAppBridgeErrorPayload as A, type MindooDBAppBridgeHandshakeErrorMessage as B, type MindooDBAppBridgeLocaleChangedMessage as C, type MindooDBAppBridgePortMessage as D, type MindooDBAppBridgeQueryResultMessage as E, type MindooDBAppBridgeRpcError as F, type MindooDBAppBridgeRpcMessage as G, type MindooDBAppBridgeRpcRequest as H, type MindooDBAppBridgeRpcSuccess as I, type MindooDBAppBridgeShortcutInvokedMessage as J, type MindooDBAppBridgeShortcutsChangedMessage as K, type MindooDBAppBridgeStreamAbortRequest as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppBridgeStreamAck as N, type MindooDBAppBridgeStreamCloseRequest as O, type MindooDBAppBridgeStreamError as P, type MindooDBAppBridgeStreamMessage as Q, type MindooDBAppBridgeStreamOpenResult as R, type MindooDBAppBridgeStreamReadRequest as S, type MindooDBAppBridgeStreamWriteRequest as T, type MindooDBAppBridgeThemeChangedMessage as U, type MindooDBAppBridgeUiPreferencesChangedMessage as V, type MindooDBAppBridgeViewChangedMessage as W, type MindooDBAppBridgeViewportChangedMessage as X, type MindooDBAppCapability as Y, type MindooDBAppConfiguredViewCategorizationStyle as Z, type MindooDBAppConfiguredViewColumn as _, type MindooDBAppBridge as a, type MindooDBAppMenuSelectionResult as a$, type MindooDBAppConfiguredViewExpressionMode as a0, type MindooDBAppConfiguredViewFieldExpression as a1, type MindooDBAppConfiguredViewFilterDefinition as a2, type MindooDBAppConfiguredViewFilterMode as a3, type MindooDBAppConfiguredViewFilterRule as a4, type MindooDBAppConfiguredViewFormulaExpression as a5, type MindooDBAppConfiguredViewFormulaFilterDefinition as a6, type MindooDBAppConfiguredViewPreviewMode as a7, type MindooDBAppConfiguredViewRuleFilterDefinition as a8, type MindooDBAppConfiguredViewRuleMatchMode as a9, type MindooDBAppHistoryQuery as aA, type MindooDBAppHostTheme as aB, type MindooDBAppIdentityApi as aC, type MindooDBAppInaccessibleDocument as aD, type MindooDBAppInaccessibleDocumentListQuery as aE, type MindooDBAppInaccessibleDocumentListResult as aF, type MindooDBAppJsonListDeletePatch as aG, type MindooDBAppJsonListInsertPatch as aH, type MindooDBAppJsonPatch as aI, type MindooDBAppJsonSetPatch as aJ, type MindooDBAppJsonTextMarkPatch as aK, type MindooDBAppJsonTextSplicePatch as aL, type MindooDBAppJsonTextUnmarkPatch as aM, type MindooDBAppJsonUnsetPatch as aN, type MindooDBAppLaunchContext as aO, type MindooDBAppLiveQuerySubscription as aP, type MindooDBAppMenuAnchor as aQ, type MindooDBAppMenuApi as aR, type MindooDBAppMenuCommandItem as aS, type MindooDBAppMenuDismissReason as aT, type MindooDBAppMenuDismissedResult as aU, type MindooDBAppMenuItem as aV, type MindooDBAppMenuKind as aW, type MindooDBAppMenuPlacement as aX, type MindooDBAppMenuPointAnchor as aY, type MindooDBAppMenuRect as aZ, type MindooDBAppMenuRectAnchor as a_, type MindooDBAppConfiguredViewRuleOperator as aa, type MindooDBAppConfiguredViewValueExpression as ab, type MindooDBAppCreateDocumentInput as ac, type MindooDBAppCreateKeyInfo as ad, type MindooDBAppCreateViewInput as ae, type MindooDBAppCreateViewNavigatorInput as af, type MindooDBAppDatabaseInfo as ag, type MindooDBAppDirectoryApi as ah, type MindooDBAppDirectoryEntry as ai, type MindooDBAppDocumentApi as aj, type MindooDBAppDocumentHeadCursorResult as ak, type MindooDBAppDocumentHistoryEntry as al, type MindooDBAppDocumentListQuery as am, type MindooDBAppDocumentListResult as an, type MindooDBAppDocumentQuery as ao, type MindooDBAppDocumentRevisionId as ap, type MindooDBAppDocumentScanPreset as aq, type MindooDBAppDocumentSummary as ar, type MindooDBAppEntryAttachmentRef as as, type MindooDBAppEntryProvenance as at, type MindooDBAppExtractDocumentTextInput as au, type MindooDBAppExtractDocumentTextResult as av, type MindooDBAppExtractTextFormat as aw, type MindooDBAppExtractionSetup as ax, type MindooDBAppFulltextSetup as ay, type MindooDBAppHistoricalDocument as az, type MindooDBAppHostShortcutBinding as b, type MindooDBAppMenuSeparatorItem as b0, type MindooDBAppQueryCoverage as b1, type MindooDBAppQueryResult as b2, type MindooDBAppQueryRow as b3, type MindooDBAppQuerySortKey as b4, type MindooDBAppQueryTextClause as b5, type MindooDBAppReadableAttachmentStream as b6, type MindooDBAppRecipientOptions as b7, type MindooDBAppResolvedViewDefinition as b8, type MindooDBAppResolvedViewSource as b9, type MindooDBAppSignPreviewScope as bA, type MindooDBAppSignStatementInput as bB, type MindooDBAppSignStatementResult as bC, type MindooDBAppStorageApi as bD, type MindooDBAppTextEdit as bE, type MindooDBAppTextPatch as bF, type MindooDBAppThemeMode as bG, type MindooDBAppTimestampApi as bH, type MindooDBAppTimestampInput as bI, type MindooDBAppTimestampProvider as bJ, type MindooDBAppTimestampResult as bK, type MindooDBAppUiPreferences as bL, type MindooDBAppUpdateDocumentInput as bM, type MindooDBAppViewCursorDocumentListResult as bN, type MindooDBAppViewCursorResult as bO, type MindooDBAppViewEntry as bP, type MindooDBAppViewEntryKind as bQ, type MindooDBAppViewNavigator as bR, type MindooDBAppViewNavigatorExpansionState as bS, type MindooDBAppViewNavigatorOpenOptions as bT, type MindooDBAppViewNavigatorPageOptions as bU, type MindooDBAppViewNavigatorPageResult as bV, type MindooDBAppViewNavigatorRangeQuery as bW, type MindooDBAppViewNavigatorSelectionState as bX, type MindooDBAppViewUpdateStats as bY, type MindooDBAppViewport as bZ, type MindooDBAppWritableAttachmentStream as b_, type MindooDBAppRevisionPhase as ba, type MindooDBAppRevisionVerification as bb, type MindooDBAppRichTextBlockSpan as bc, type MindooDBAppRichTextGetOptions as bd, type MindooDBAppRichTextImmutableString as be, type MindooDBAppRichTextMarkRange as bf, type MindooDBAppRichTextMaterializeValue as bg, type MindooDBAppRichTextPatch as bh, type MindooDBAppRichTextScalar as bi, type MindooDBAppRichTextSpliceStep as bj, type MindooDBAppRichTextStep as bk, type MindooDBAppRichTextStepPatch as bl, type MindooDBAppRichTextTextSpan as bm, type MindooDBAppRuntime as bn, type MindooDBAppScanAttachmentOptions as bo, type MindooDBAppScanAttachmentResult as bp, type MindooDBAppScopedDocId as bq, type MindooDBAppScopedDocumentSummary as br, type MindooDBAppSealIntent as bs, type MindooDBAppSealedChannelOpenInput as bt, type MindooDBAppSealedChannelOpenResult as bu, type MindooDBAppSealedChannelRequestInput as bv, type MindooDBAppSession as bw, type MindooDBAppShowMenuInput as bx, type MindooDBAppShowMenuResult as by, type MindooDBAppSignPreview as bz, type MindooDBAppHostShortcutAction as c, type MindooDBAppHostingMode as d, type MindooDBAppDatabase as e, type MindooDBAppDocument as f, type MindooDBAppRichTextSpan as g, type MindooDBAppRichTextSnapshot as h, MINDOODB_APP_SEAL_SIGNING_DOMAIN as i, type MindooDBAppAccessDecision as j, type MindooDBAppAccessTier as k, type MindooDBAppAttachmentApi as l, type MindooDBAppAttachmentChunk as m, type MindooDBAppAttachmentInfo as n, type MindooDBAppAttachmentPreviewOptions as o, type MindooDBAppAttachmentPreviewSession as p, type MindooDBAppAutomergeChangesPatch as q, type MindooDBAppAutomergeChangesSince as r, type MindooDBAppAutomergeGetOptions as s, type MindooDBAppAutomergePatchResult as t, type MindooDBAppAutomergeSnapshot as u, type MindooDBAppBridgeBeforeCloseAck as v, type MindooDBAppBridgeBeforeCloseMessage as w, type MindooDBAppBridgeConnectMessage as x, type MindooDBAppBridgeConnectOptions as y, type MindooDBAppBridgeConnectedMessage as z };
+export { type MindooDBAppBridgeStreamWriteRequest as $, type MindooDBAppBridgeBeforeCloseAck as A, type MindooDBAppBridgeBeforeCloseMessage as B, type MindooDBAppBridgeConnectMessage as C, type MindooDBAppBridgeConnectOptions as D, type MindooDBAppBridgeConnectedMessage as E, type MindooDBAppBridgeDragDropMessage as F, type MindooDBAppBridgeDragLeaveMessage as G, type MindooDBAppBridgeDragOverMessage as H, type MindooDBAppBridgeErrorPayload as I, type MindooDBAppBridgeHandshakeErrorMessage as J, type MindooDBAppBridgeLocaleChangedMessage as K, type MindooDBAppBridgePortMessage as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppBridgeQueryResultMessage as N, type MindooDBAppBridgeRpcError as O, type MindooDBAppBridgeRpcMessage as P, type MindooDBAppBridgeRpcRequest as Q, type MindooDBAppBridgeRpcSuccess as R, type MindooDBAppBridgeShortcutInvokedMessage as S, type MindooDBAppBridgeShortcutsChangedMessage as T, type MindooDBAppBridgeStreamAbortRequest as U, type MindooDBAppBridgeStreamAck as V, type MindooDBAppBridgeStreamCloseRequest as W, type MindooDBAppBridgeStreamError as X, type MindooDBAppBridgeStreamMessage as Y, type MindooDBAppBridgeStreamOpenResult as Z, type MindooDBAppBridgeStreamReadRequest as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppJsonTextMarkPatch as a$, type MindooDBAppBridgeThemeChangedMessage as a0, type MindooDBAppBridgeUiPreferencesChangedMessage as a1, type MindooDBAppBridgeViewChangedMessage as a2, type MindooDBAppBridgeViewportChangedMessage as a3, type MindooDBAppCapability as a4, type MindooDBAppConfiguredViewCategorizationStyle as a5, type MindooDBAppConfiguredViewColumn as a6, type MindooDBAppConfiguredViewColumnRole as a7, type MindooDBAppConfiguredViewExpressionMode as a8, type MindooDBAppConfiguredViewFieldExpression as a9, type MindooDBAppDragApi as aA, type MindooDBAppDragCancelReason as aB, type MindooDBAppDragDropEvent as aC, type MindooDBAppDragEffect as aD, type MindooDBAppDragHoverResult as aE, type MindooDBAppDragOffer as aF, type MindooDBAppDragOverEvent as aG, type MindooDBAppDragPointer as aH, type MindooDBAppDragProfile as aI, type MindooDBAppEntryAttachmentRef as aJ, type MindooDBAppEntryProvenance as aK, type MindooDBAppExtractDocumentTextInput as aL, type MindooDBAppExtractDocumentTextResult as aM, type MindooDBAppExtractTextFormat as aN, type MindooDBAppExtractionSetup as aO, type MindooDBAppFulltextSetup as aP, type MindooDBAppHistoricalDocument as aQ, type MindooDBAppHistoryQuery as aR, type MindooDBAppHostTheme as aS, type MindooDBAppIdentityApi as aT, type MindooDBAppInaccessibleDocument as aU, type MindooDBAppInaccessibleDocumentListQuery as aV, type MindooDBAppInaccessibleDocumentListResult as aW, type MindooDBAppJsonListDeletePatch as aX, type MindooDBAppJsonListInsertPatch as aY, type MindooDBAppJsonPatch as aZ, type MindooDBAppJsonSetPatch as a_, type MindooDBAppConfiguredViewFilterDefinition as aa, type MindooDBAppConfiguredViewFilterMode as ab, type MindooDBAppConfiguredViewFilterRule as ac, type MindooDBAppConfiguredViewFormulaExpression as ad, type MindooDBAppConfiguredViewFormulaFilterDefinition as ae, type MindooDBAppConfiguredViewPreviewMode as af, type MindooDBAppConfiguredViewRuleFilterDefinition as ag, type MindooDBAppConfiguredViewRuleMatchMode as ah, type MindooDBAppConfiguredViewRuleOperator as ai, type MindooDBAppConfiguredViewValueExpression as aj, type MindooDBAppCreateDocumentInput as ak, type MindooDBAppCreateKeyInfo as al, type MindooDBAppCreateViewInput as am, type MindooDBAppCreateViewNavigatorInput as an, type MindooDBAppDatabaseInfo as ao, type MindooDBAppDirectoryApi as ap, type MindooDBAppDirectoryEntry as aq, type MindooDBAppDocumentApi as ar, type MindooDBAppDocumentHeadCursorResult as as, type MindooDBAppDocumentHistoryEntry as at, type MindooDBAppDocumentListQuery as au, type MindooDBAppDocumentListResult as av, type MindooDBAppDocumentQuery as aw, type MindooDBAppDocumentRevisionId as ax, type MindooDBAppDocumentScanPreset as ay, type MindooDBAppDocumentSummary as az, type MindooDBAppDragStartInput as b, type MindooDBAppTimestampResult as b$, type MindooDBAppJsonTextSplicePatch as b0, type MindooDBAppJsonTextUnmarkPatch as b1, type MindooDBAppJsonUnsetPatch as b2, type MindooDBAppLaunchContext as b3, type MindooDBAppLiveQuerySubscription as b4, type MindooDBAppMenuAnchor as b5, type MindooDBAppMenuApi as b6, type MindooDBAppMenuCommandItem as b7, type MindooDBAppMenuDismissReason as b8, type MindooDBAppMenuDismissedResult as b9, type MindooDBAppRichTextSpliceStep as bA, type MindooDBAppRichTextStep as bB, type MindooDBAppRichTextStepPatch as bC, type MindooDBAppRichTextTextSpan as bD, type MindooDBAppRuntime as bE, type MindooDBAppScanAttachmentOptions as bF, type MindooDBAppScanAttachmentResult as bG, type MindooDBAppScopedDocId as bH, type MindooDBAppScopedDocumentSummary as bI, type MindooDBAppSealIntent as bJ, type MindooDBAppSealedChannelOpenInput as bK, type MindooDBAppSealedChannelOpenResult as bL, type MindooDBAppSealedChannelRequestInput as bM, type MindooDBAppSession as bN, type MindooDBAppShowMenuInput as bO, type MindooDBAppShowMenuResult as bP, type MindooDBAppSignPreview as bQ, type MindooDBAppSignPreviewScope as bR, type MindooDBAppSignStatementInput as bS, type MindooDBAppSignStatementResult as bT, type MindooDBAppStorageApi as bU, type MindooDBAppTextEdit as bV, type MindooDBAppTextPatch as bW, type MindooDBAppThemeMode as bX, type MindooDBAppTimestampApi as bY, type MindooDBAppTimestampInput as bZ, type MindooDBAppTimestampProvider as b_, type MindooDBAppMenuItem as ba, type MindooDBAppMenuKind as bb, type MindooDBAppMenuPlacement as bc, type MindooDBAppMenuPointAnchor as bd, type MindooDBAppMenuRect as be, type MindooDBAppMenuRectAnchor as bf, type MindooDBAppMenuSelectionResult as bg, type MindooDBAppMenuSeparatorItem as bh, type MindooDBAppQueryCoverage as bi, type MindooDBAppQueryResult as bj, type MindooDBAppQueryRow as bk, type MindooDBAppQuerySortKey as bl, type MindooDBAppQueryTextClause as bm, type MindooDBAppReadableAttachmentStream as bn, type MindooDBAppRecipientOptions as bo, type MindooDBAppResolvedViewDefinition as bp, type MindooDBAppResolvedViewSource as bq, type MindooDBAppRevisionPhase as br, type MindooDBAppRevisionVerification as bs, type MindooDBAppRichTextBlockSpan as bt, type MindooDBAppRichTextGetOptions as bu, type MindooDBAppRichTextImmutableString as bv, type MindooDBAppRichTextMarkRange as bw, type MindooDBAppRichTextMaterializeValue as bx, type MindooDBAppRichTextPatch as by, type MindooDBAppRichTextScalar as bz, type MindooDBAppDragStartResult as c, type MindooDBAppUiPreferences as c0, type MindooDBAppUpdateDocumentInput as c1, type MindooDBAppViewCursorDocumentListResult as c2, type MindooDBAppViewCursorResult as c3, type MindooDBAppViewEntry as c4, type MindooDBAppViewEntryKind as c5, type MindooDBAppViewNavigator as c6, type MindooDBAppViewNavigatorExpansionState as c7, type MindooDBAppViewNavigatorOpenOptions as c8, type MindooDBAppViewNavigatorPageOptions as c9, type MindooDBAppViewNavigatorPageResult as ca, type MindooDBAppViewNavigatorRangeQuery as cb, type MindooDBAppViewNavigatorSelectionState as cc, type MindooDBAppViewUpdateStats as cd, type MindooDBAppViewport as ce, type MindooDBAppWellKnownDragType as cf, type MindooDBAppWritableAttachmentStream as cg, type MindooDBAppDragPreview as d, type MindooDBAppBridge as e, type MindooDBAppHostShortcutBinding as f, type MindooDBAppHostShortcutAction as g, type MindooDBAppHostingMode as h, type MindooDBAppDatabase as i, type MindooDBAppDocument as j, type MindooDBAppRichTextSpan as k, type MindooDBAppRichTextSnapshot as l, MINDOODB_APP_SEAL_SIGNING_DOMAIN as m, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as n, type MindooDBAppAccessDecision as o, type MindooDBAppAccessTier as p, type MindooDBAppAttachmentApi as q, type MindooDBAppAttachmentChunk as r, type MindooDBAppAttachmentInfo as s, type MindooDBAppAttachmentPreviewOptions as t, type MindooDBAppAttachmentPreviewSession as u, type MindooDBAppAutomergeChangesPatch as v, type MindooDBAppAutomergeChangesSince as w, type MindooDBAppAutomergeGetOptions as x, type MindooDBAppAutomergePatchResult as y, type MindooDBAppAutomergeSnapshot as z };

package/dist/vite/index.d.ts

@@ -35,6 +35,7 @@ interface HavenBundleVitePlugin {
     name: string;
     apply: "build";
     configResolved: (config: ResolvedViteConfig) => void;
+    writeBundle: () => Promise<void>;
     closeBundle: () => Promise<void>;
 }
 /**

package/dist/vite/index.js

@@ -8,7 +8,7 @@ import {
 
 // src/vite/index.ts
 import { createHash } from "crypto";
-import { readdir, readFile, writeFile } from "fs/promises";
+import { access, readdir, readFile, writeFile } from "fs/promises";
 import path from "path";
 
 // src/vite/zip.ts
@@ -155,6 +155,14 @@ var DEFAULT_EXCLUDED_ROOT_FILES = /* @__PURE__ */ new Set([
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME
 ]);
 var WORKBOX_RUNTIME_PATTERN = /^workbox-[a-z0-9]+\.js(\.map)?$/i;
+async function directoryExists(dir) {
+  try {
+    await access(dir);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function sha256(data) {
   return `sha256-${createHash("sha256").update(data).digest("hex")}`;
 }
@@ -223,66 +231,80 @@ async function readPackageMetadata(root) {
 }
 function havenBundle(options = {}) {
   let resolvedConfig = null;
+  let emitted = false;
+  async function emitBundle() {
+    if (emitted) {
+      return;
+    }
+    if (!resolvedConfig) {
+      throw new Error("[haven-bundle] Plugin ran without a resolved Vite config.");
+    }
+    const outDir = path.resolve(resolvedConfig.root, resolvedConfig.build.outDir);
+    if (!await directoryExists(outDir)) {
+      return;
+    }
+    const allPaths = await collectFiles(outDir);
+    const bundlePaths = allPaths.filter((candidate) => !isExcluded(candidate, options));
+    if (!bundlePaths.length) {
+      throw new Error(`[haven-bundle] No bundle files found in "${outDir}".`);
+    }
+    const entry = resolveEntryPath(bundlePaths, options.entry);
+    const packageMetadata = await readPackageMetadata(resolvedConfig.root);
+    const appId = options.appId ?? packageMetadata.name;
+    const version = options.version ?? packageMetadata.version;
+    if (!appId) {
+      throw new Error("[haven-bundle] Unable to determine appId \u2014 pass it explicitly.");
+    }
+    if (!version) {
+      throw new Error("[haven-bundle] Unable to determine version \u2014 pass it explicitly.");
+    }
+    const files = [];
+    const archiveEntries = [];
+    for (const relativePath of bundlePaths) {
+      const data = await readFile(path.join(outDir, relativePath));
+      files.push({ path: relativePath, hash: sha256(data), size: data.byteLength });
+      archiveEntries.push({ path: relativePath, data });
+    }
+    const archive = createZipArchive(archiveEntries);
+    const manifest = {
+      format: MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
+      formatVersion: MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
+      appId,
+      version,
+      entry,
+      archive: {
+        path: MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
+        hash: sha256(archive),
+        size: archive.byteLength
+      },
+      contentHash: sha256(buildMindooDBAppBundleContentHashInput(files)),
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      files
+    };
+    await writeFile(path.join(outDir, MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME), archive);
+    await writeFile(
+      path.join(outDir, MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME),
+      `${JSON.stringify(manifest, null, 2)}
+`,
+      "utf8"
+    );
+    const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
+    console.log(
+      `[haven-bundle] ${files.length} files (${(totalBytes / 1024 / 1024).toFixed(2)} MB) \u2192 ${MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME} (${(archive.byteLength / 1024 / 1024).toFixed(2)} MB), contentHash ${manifest.contentHash.slice(7, 19)}`
+    );
+    emitted = true;
+  }
   return {
     name: "haven-bundle",
     apply: "build",
     configResolved(config) {
       resolvedConfig = config;
     },
+    async writeBundle() {
+      await emitBundle();
+    },
     async closeBundle() {
-      if (!resolvedConfig) {
-        throw new Error("[haven-bundle] Plugin ran without a resolved Vite config.");
-      }
-      const outDir = path.resolve(resolvedConfig.root, resolvedConfig.build.outDir);
-      const allPaths = await collectFiles(outDir);
-      const bundlePaths = allPaths.filter((candidate) => !isExcluded(candidate, options));
-      if (!bundlePaths.length) {
-        throw new Error(`[haven-bundle] No bundle files found in "${outDir}".`);
-      }
-      const entry = resolveEntryPath(bundlePaths, options.entry);
-      const packageMetadata = await readPackageMetadata(resolvedConfig.root);
-      const appId = options.appId ?? packageMetadata.name;
-      const version = options.version ?? packageMetadata.version;
-      if (!appId) {
-        throw new Error("[haven-bundle] Unable to determine appId \u2014 pass it explicitly.");
-      }
-      if (!version) {
-        throw new Error("[haven-bundle] Unable to determine version \u2014 pass it explicitly.");
-      }
-      const files = [];
-      const archiveEntries = [];
-      for (const relativePath of bundlePaths) {
-        const data = await readFile(path.join(outDir, relativePath));
-        files.push({ path: relativePath, hash: sha256(data), size: data.byteLength });
-        archiveEntries.push({ path: relativePath, data });
-      }
-      const archive = createZipArchive(archiveEntries);
-      const manifest = {
-        format: MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
-        formatVersion: MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
-        appId,
-        version,
-        entry,
-        archive: {
-          path: MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
-          hash: sha256(archive),
-          size: archive.byteLength
-        },
-        contentHash: sha256(buildMindooDBAppBundleContentHashInput(files)),
-        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        files
-      };
-      await writeFile(path.join(outDir, MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME), archive);
-      await writeFile(
-        path.join(outDir, MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME),
-        `${JSON.stringify(manifest, null, 2)}
-`,
-        "utf8"
-      );
-      const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
-      console.log(
-        `[haven-bundle] ${files.length} files (${(totalBytes / 1024 / 1024).toFixed(2)} MB) \u2192 ${MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME} (${(archive.byteLength / 1024 / 1024).toFixed(2)} MB), contentHash ${manifest.contentHash.slice(7, 19)}`
-      );
+      await emitBundle();
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "engines": {
     "node": ">=22.13.0"
   },
@@ -59,6 +59,7 @@
     "@automerge/automerge": "^3.3.2",
     "mindoodb": "^0.0.58",
     "@types/node": "25.5.0",
+    "jsdom": "^29.0.1",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"