mindoodb-app-sdk 0.0.60 → 0.0.62

package/README.md

@@ -435,18 +435,55 @@ const embed = await session.embeds.open({
   componentKey: sheet.key,
   databaseId: "crm",
   docId: doc.id,
-  rect: panel.getBoundingClientRect(), // in this app's viewport
+  container: panel, // a positioned element; the component fills it
 });
-new ResizeObserver(() => void embed.setRect(panel.getBoundingClientRect())).observe(panel);
 const closed = await embed.closed; // { reason: "completed" | "cancelled" | "closed" | "error", result? }
 ```
 
-Haven lays the component's frame over the rectangle, above the host's frame, so the
-host cannot draw on top of it; hide it with `embed.setVisible(false)` while a dialog of
-the host should be visible. The first time a host embeds a component, Haven asks the user.
+The SDK puts a frame into `container`, so the component is part of the host's page: it
+scrolls, clips and resizes with it, and the host's menus and dialogs cover it like any
+other element. The frame holds a page from Haven's origin that loads the component and
+hands its connection to Haven, so the host cannot reach into the component or its data
+channel. Haven tells the SDK where the container is (for the component's own menus);
+the SDK follows the container's size and position by itself.
+
+**Unsaved changes.** A component reports whether it has changes it has not saved yet,
+and saves when its host asks:
+
+```ts
+// component
+watch(isDirty, (dirty) => void session.embedding.setDirty(dirty));
+session.embedding.onSaveRequest(() => saveFile()); // throw to report a failure
+
+// host, e.g. when the user closes the tab
+if (embed.dirty) {
+  const choice = await askSaveDiscardCancel();
+  if (choice === "cancel") return;
+  if (choice === "save") await embed.save(); // rejects with the component's error
+  await embed.close({ discard: choice === "discard" });
+} else {
+  await embed.close(); // the component may still flush (onBeforeClose)
+}
+```
+
+`embed.dirty` is `undefined` until the component reports anything, so a component that
+never does is closed without asking; `embed.onDirtyChange` lets the host mark it (e.g. a
+dot in its tab). `embed.save()` rejects with `unsupported` when the component has no save
+handler.
+
+Havens that predate this lay the component over the container instead, above the host's
+frame (`embed.placement === "overlay"`). The host then cannot draw on top of it: hide it
+with `embed.setVisible(false)` while a menu or dialog of the host should be visible.
+Without a `container`, pass `rect` (in this app's viewport) and keep it current with
+`embed.setRect` to get that overlay explicitly.
+
+The first time a host embeds a component, Haven asks the user.
 In tests, `createMockMindooDBAppSession({ components })` records embeds
 (`listEmbeds`, `closeEmbed`), and the `/__haven-test/` page draws a stand-in with
-Done/Cancel buttons.
+Done/Cancel buttons over the container. `createFakeBridgeHost({ embedFrameUrl })`
+answers like a current Haven, so the SDK frames that URL in the container. Both
+controllers simulate unsaved changes: `setEmbedDirty`, `failNextEmbedSave`, and for an
+app under test that is a component, `getEmbeddingDirty` and `requestEmbeddingSave`.
 
 ### Databases and capabilities
 

package/dist/{chunk-HJUDYIPR.js → chunk-QQRLEHFE.js}

@@ -1342,6 +1342,9 @@ import { parseMindooDBFormulaBooleanExpression } from "mindoodb-view-language";
 function isEmbedEventMessage(message) {
   return message.kind === "embed-event";
 }
+function isEmbeddingRequestMessage(message) {
+  return message.kind === "embedding-request";
+}
 function toRect(rect) {
   return {
     left: Number(rect.left) || 0,
@@ -1350,26 +1353,123 @@ function toRect(rect) {
     height: Math.max(0, Number(rect.height) || 0)
   };
 }
+function containerRect(container) {
+  const bounds = container.getBoundingClientRect();
+  return toRect({ left: bounds.left, top: bounds.top, width: bounds.width, height: bounds.height });
+}
+var ContainerTracker = class {
+  constructor(container, report) {
+    this.container = container;
+    this.report = report;
+    this.observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(this.schedule);
+    this.observer?.observe(container);
+    window.addEventListener("resize", this.schedule);
+    window.addEventListener("scroll", this.schedule, true);
+  }
+  container;
+  report;
+  frameRequest = null;
+  observer;
+  schedule = () => {
+    if (this.frameRequest !== null) {
+      return;
+    }
+    this.frameRequest = window.requestAnimationFrame(() => {
+      this.frameRequest = null;
+      this.report(containerRect(this.container));
+    });
+  };
+  dispose() {
+    this.observer?.disconnect();
+    window.removeEventListener("resize", this.schedule);
+    window.removeEventListener("scroll", this.schedule, true);
+    if (this.frameRequest !== null) {
+      window.cancelAnimationFrame(this.frameRequest);
+    }
+  }
+};
+function createComponentFrame(container, url, allow) {
+  const frame = container.ownerDocument.createElement("iframe");
+  frame.src = url;
+  if (allow) {
+    frame.setAttribute("allow", allow);
+  }
+  frame.setAttribute("referrerpolicy", "strict-origin-when-cross-origin");
+  frame.dataset.mindoodbEmbed = "";
+  Object.assign(frame.style, {
+    position: "absolute",
+    inset: "0",
+    width: "100%",
+    height: "100%",
+    border: "0",
+    display: "block"
+  });
+  container.appendChild(frame);
+  return frame;
+}
 var MindooDBAppEmbedImpl = class {
-  constructor(rpc, embedId, componentKey, databaseId, docId) {
+  constructor(rpc, embedId, componentKey, databaseId, docId, frame, container) {
     this.rpc = rpc;
     this.embedId = embedId;
     this.componentKey = componentKey;
     this.databaseId = databaseId;
     this.docId = docId;
+    this.frame = frame;
     this.closed = new Promise((resolve) => {
       this.resolveClosed = resolve;
     });
+    if (container) {
+      this.tracker = new ContainerTracker(container, (rect) => {
+        void this.setRect(rect).catch(() => {
+        });
+      });
+    }
   }
   rpc;
   embedId;
   componentKey;
   databaseId;
   docId;
+  frame;
   closed;
   resolveClosed;
   closedEvent = null;
   listeners = /* @__PURE__ */ new Set();
+  dirtyListeners = /* @__PURE__ */ new Set();
+  dirtyState = void 0;
+  tracker = null;
+  get placement() {
+    return this.frame ? "frame" : "overlay";
+  }
+  get dirty() {
+    return this.dirtyState;
+  }
+  onDirtyChange(listener) {
+    this.dirtyListeners.add(listener);
+    return () => {
+      this.dirtyListeners.delete(listener);
+    };
+  }
+  /** The component reported its unsaved-changes state. */
+  setDirtyState(dirty) {
+    if (this.closedEvent || this.dirtyState === dirty) {
+      return;
+    }
+    this.dirtyState = dirty;
+    this.dirtyListeners.forEach((listener) => {
+      try {
+        listener(dirty);
+      } catch (error) {
+        console.error("MindooDB embed dirty listener failed.", error);
+      }
+    });
+  }
+  async save() {
+    if (this.closedEvent) {
+      return;
+    }
+    await this.rpc.call("embeds.save", { embedId: this.embedId });
+  }
   async setRect(rect) {
     if (this.closedEvent) {
       return;
@@ -1380,11 +1480,18 @@ var MindooDBAppEmbedImpl = class {
     if (this.closedEvent) {
       return;
     }
+    if (this.frame) {
+      this.frame.style.visibility = visible ? "" : "hidden";
+      return;
+    }
     await this.rpc.call("embeds.setVisible", { embedId: this.embedId, visible: visible === true });
   }
-  async close() {
+  async close(options) {
     if (!this.closedEvent) {
-      await this.rpc.call("embeds.close", { embedId: this.embedId });
+      await this.rpc.call("embeds.close", {
+        embedId: this.embedId,
+        ...options?.discard ? { discard: true } : {}
+      });
     }
     return await this.closed;
   }
@@ -1405,6 +1512,9 @@ var MindooDBAppEmbedImpl = class {
       return;
     }
     this.closedEvent = event;
+    this.tracker?.dispose();
+    this.tracker = null;
+    this.frame?.remove();
     this.resolveClosed(event);
     this.listeners.forEach((listener) => {
       try {
@@ -1414,13 +1524,31 @@ var MindooDBAppEmbedImpl = class {
       }
     });
     this.listeners.clear();
+    this.dirtyListeners.clear();
   }
 };
 var MindooDBAppEmbedsClient = class {
   constructor(rpc) {
     this.rpc = rpc;
     this.stopListening = this.rpc.addMessageListener((message) => {
-      if (!isEmbedEventMessage(message) || message.event?.type !== "closed") {
+      if (isEmbeddingRequestMessage(message)) {
+        void this.answerRequest(message);
+        return;
+      }
+      if (!isEmbedEventMessage(message)) {
+        return;
+      }
+      if (message.event?.type === "dirty") {
+        const { embedId, dirty } = message.event;
+        const embed2 = this.open.get(embedId);
+        if (embed2) {
+          embed2.setDirtyState(dirty === true);
+        } else {
+          this.earlyDirty.set(embedId, dirty === true);
+        }
+        return;
+      }
+      if (message.event?.type !== "closed") {
         return;
       }
       const { type: _type, ...event } = message.event;
@@ -1442,16 +1570,28 @@ var MindooDBAppEmbedsClient = class {
     };
     this.embeds = {
       open: async (input) => {
+        const { container, rect, ...rest } = input;
+        const initialRect = container ? containerRect(container) : toRect(rect ?? { left: 0, top: 0, width: 0, height: 0 });
         const response = await this.rpc.call("embeds.open", {
-          input: { ...input, rect: toRect(input.rect) }
+          // `frame`: Haven hands back a page for the container instead of laying
+          // the component over this app. Havens that do not know it ignore it.
+          input: { ...rest, rect: initialRect, ...container ? { placement: "frame" } : {} }
         });
+        const frame = container && response.frame?.url ? createComponentFrame(container, response.frame.url, response.frame.allow) : null;
         const embed = new MindooDBAppEmbedImpl(
           this.rpc,
           response.embedId,
           input.componentKey,
           input.databaseId,
-          input.docId
+          input.docId,
+          frame,
+          container
         );
+        const earlyDirty = this.earlyDirty.get(embed.embedId);
+        if (earlyDirty !== void 0) {
+          this.earlyDirty.delete(embed.embedId);
+          embed.setDirtyState(earlyDirty);
+        }
         const early = this.early.get(embed.embedId);
         if (early) {
           this.early.delete(embed.embedId);
@@ -1474,6 +1614,17 @@ var MindooDBAppEmbedsClient = class {
           reason: "cancelled",
           ...message ? { message: String(message) } : {}
         });
+      },
+      setDirty: async (dirty) => {
+        await this.rpc.call("embedding.setDirty", { dirty: dirty === true });
+      },
+      onSaveRequest: (handler) => {
+        this.saveHandler = handler;
+        return () => {
+          if (this.saveHandler === handler) {
+            this.saveHandler = null;
+          }
+        };
       }
     };
   }
@@ -1484,7 +1635,29 @@ var MindooDBAppEmbedsClient = class {
   open = /* @__PURE__ */ new Map();
   /** Events that arrived before `embeds.open` resolved with their id. */
   early = /* @__PURE__ */ new Map();
+  earlyDirty = /* @__PURE__ */ new Map();
   stopListening;
+  /** This app as a component: what to do when its host asks it to save. */
+  saveHandler = null;
+  /** Runs the save handler and tells Haven how it went; Haven answers the host. */
+  async answerRequest(message) {
+    let response;
+    if (message.request !== "save" || !this.saveHandler) {
+      response = { ok: false, error: "unsupported" };
+    } else {
+      try {
+        await this.saveHandler();
+        response = { ok: true };
+      } catch (error) {
+        response = { ok: false, error: error instanceof Error ? error.message : String(error) };
+      }
+    }
+    try {
+      await this.rpc.call("embedding.respond", { requestId: message.requestId, ...response });
+    } catch (error) {
+      console.warn("[mindoodb-app-sdk] Could not answer the host's request.", error);
+    }
+  }
   dispose() {
     this.stopListening();
   }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppAgentToolErrorCode, g as MindooDBAppHostShortcutBinding, h as MindooDBAppHostShortcutAction, i as MindooDBAppHostingMode, j as MindooDBAppDefinition, k as MindooDBAppDatabase, l as MindooDBAppDocument, m as MindooDBAppRichTextSpan, n as MindooDBAppRichTextSnapshot, o as MindooDBAppCreateDocumentInput } from './types-D0Bsbd1G.js';
-export { p as MINDOODB_APP_ACCEPTS_MAX, q as MINDOODB_APP_COMPONENTS_MAX, r as MINDOODB_APP_DEFINITION_FILE_NAME, s as MINDOODB_APP_DEFINITION_FORMAT, t as MINDOODB_APP_DEFINITION_PERMISSIONS, u as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, v as MINDOODB_APP_DEFINITION_VERSION, w as MINDOODB_APP_LISTING_DESCRIPTION_MAX, x as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, y as MINDOODB_APP_LISTING_SUMMARY_MAX, z as MINDOODB_APP_SEAL_SIGNING_DOMAIN, A as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, B as MindooDBAppAcceptSpec, C as MindooDBAppAccessDecision, D as MindooDBAppAccessTier, E as MindooDBAppAgentApi, F as MindooDBAppAgentRegistration, G as MindooDBAppAgentTool, H as MindooDBAppAgentToolAnnotations, I as MindooDBAppAgentToolDescriptor, J as MindooDBAppAttachmentApi, K as MindooDBAppAttachmentChunk, L as MindooDBAppAttachmentInfo, N as MindooDBAppAttachmentPreviewOptions, O as MindooDBAppAttachmentPreviewSession, P as MindooDBAppAutomergeChangesPatch, Q as MindooDBAppAutomergeChangesSince, R as MindooDBAppAutomergeGetOptions, S as MindooDBAppAutomergePatchResult, T as MindooDBAppAutomergeSnapshot, U as MindooDBAppBridgeAgentInvokeMessage, V as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeBeforeCloseAck, X as MindooDBAppBridgeBeforeCloseMessage, Y as MindooDBAppBridgeConnectMessage, Z as MindooDBAppBridgeConnectOptions, _ as MindooDBAppBridgeConnectedMessage, $ as MindooDBAppBridgeDragDropMessage, a0 as MindooDBAppBridgeDragLeaveMessage, a1 as MindooDBAppBridgeDragOverMessage, a2 as MindooDBAppBridgeEmbedEventMessage, a3 as MindooDBAppBridgeErrorPayload, a4 as MindooDBAppBridgeHandshakeErrorMessage, a5 as MindooDBAppBridgeHostFocusChangedMessage, a6 as MindooDBAppBridgeIncomingContentMessage, a7 as MindooDBAppBridgeLocaleChangedMessage, a8 as MindooDBAppBridgePortMessage, a9 as MindooDBAppBridgeQueryResultMessage, aa as MindooDBAppBridgeRpcError, ab as MindooDBAppBridgeRpcMessage, ac as MindooDBAppBridgeRpcRequest, ad as MindooDBAppBridgeRpcSuccess, ae as MindooDBAppBridgeShortcutInvokedMessage, af as MindooDBAppBridgeShortcutsChangedMessage, ag as MindooDBAppBridgeStreamAbortRequest, ah as MindooDBAppBridgeStreamAck, ai as MindooDBAppBridgeStreamCloseRequest, aj as MindooDBAppBridgeStreamError, ak as MindooDBAppBridgeStreamMessage, al as MindooDBAppBridgeStreamOpenResult, am as MindooDBAppBridgeStreamReadRequest, an as MindooDBAppBridgeStreamWriteRequest, ao as MindooDBAppBridgeThemeChangedMessage, ap as MindooDBAppBridgeUiPreferencesChangedMessage, aq as MindooDBAppBridgeViewChangedMessage, ar as MindooDBAppBridgeViewportChangedMessage, as as MindooDBAppBridgeWorkspaceFocusRequestedMessage, at as MindooDBAppBrowserFeatures, au as MindooDBAppCapability, av as MindooDBAppComponentChildren, aw as MindooDBAppComponentFieldValue, ax as MindooDBAppComponentInfo, ay as MindooDBAppComponentIntent, az as MindooDBAppComponentQuery, aA as MindooDBAppComponentSpec, aB as MindooDBAppComponentsApi, aC as MindooDBAppConfiguredViewCategorizationStyle, aD as MindooDBAppConfiguredViewColumn, aE as MindooDBAppConfiguredViewColumnRole, aF as MindooDBAppConfiguredViewExpressionMode, aG as MindooDBAppConfiguredViewFieldExpression, aH as MindooDBAppConfiguredViewFilterDefinition, aI as MindooDBAppConfiguredViewFilterMode, aJ as MindooDBAppConfiguredViewFilterRule, aK as MindooDBAppConfiguredViewFormulaExpression, aL as MindooDBAppConfiguredViewFormulaFilterDefinition, aM as MindooDBAppConfiguredViewPreviewMode, aN as MindooDBAppConfiguredViewRuleFilterDefinition, aO as MindooDBAppConfiguredViewRuleMatchMode, aP as MindooDBAppConfiguredViewRuleOperator, aQ as MindooDBAppConfiguredViewValueExpression, aR as MindooDBAppCreateKeyInfo, aS as MindooDBAppCreateViewInput, aT as MindooDBAppCreateViewNavigatorInput, aU as MindooDBAppDatabaseInfo, aV as MindooDBAppDefinitionDatabase, aW as MindooDBAppDefinitionListing, aX as MindooDBAppDefinitionPermission, aY as MindooDBAppDefinitionRegistrationPermission, aZ as MindooDBAppDefinitionScreenshot, a_ as MindooDBAppDefinitionValidation, a$ as MindooDBAppDirectoryApi, b0 as MindooDBAppDirectoryEntry, b1 as MindooDBAppDocumentApi, b2 as MindooDBAppDocumentHeadCursorResult, b3 as MindooDBAppDocumentHistoryEntry, b4 as MindooDBAppDocumentListQuery, b5 as MindooDBAppDocumentListResult, b6 as MindooDBAppDocumentQuery, b7 as MindooDBAppDocumentRevisionId, b8 as MindooDBAppDocumentScanPreset, b9 as MindooDBAppDocumentSummary, ba as MindooDBAppDragApi, bb as MindooDBAppDragCancelReason, bc as MindooDBAppDragDropEvent, bd as MindooDBAppDragEffect, be as MindooDBAppDragHoverResult, bf as MindooDBAppDragOffer, bg as MindooDBAppDragOverEvent, bh as MindooDBAppDragPointer, bi as MindooDBAppDragProfile, bj as MindooDBAppEmbed, bk as MindooDBAppEmbedCloseReason, bl as MindooDBAppEmbedClosedEvent, bm as MindooDBAppEmbedContext, bn as MindooDBAppEmbedOpenInput, bo as MindooDBAppEmbedRect, bp as MindooDBAppEmbeddingApi, bq as MindooDBAppEmbedsApi, br as MindooDBAppEntryAttachmentRef, bs as MindooDBAppEntryProvenance, bt as MindooDBAppExtractDocumentTextInput, bu as MindooDBAppExtractDocumentTextResult, bv as MindooDBAppExtractTextFormat, bw as MindooDBAppExtractionSetup, bx as MindooDBAppFulltextSetup, by as MindooDBAppHistoricalDocument, bz as MindooDBAppHistoryQuery, bA as MindooDBAppHostTheme, bB as MindooDBAppIdentityApi, bC as MindooDBAppInaccessibleDocument, bD as MindooDBAppInaccessibleDocumentListQuery, bE as MindooDBAppInaccessibleDocumentListResult, bF as MindooDBAppIncomingContent, bG as MindooDBAppIncomingContentHandler, bH as MindooDBAppIncomingContentInfo, bI as MindooDBAppIncomingItem, bJ as MindooDBAppIncomingItemInfo, bK as MindooDBAppIncomingResult, bL as MindooDBAppIncomingSource, bM as MindooDBAppJsonCounterIncrementPatch, bN as MindooDBAppJsonListDeletePatch, bO as MindooDBAppJsonListInsertPatch, bP as MindooDBAppJsonPatch, bQ as MindooDBAppJsonSetPatch, bR as MindooDBAppJsonTextMarkPatch, bS as MindooDBAppJsonTextSplicePatch, bT as MindooDBAppJsonTextUnmarkPatch, bU as MindooDBAppJsonUnsetPatch, bV as MindooDBAppLaunchContext, bW as MindooDBAppListUsersOptions, bX as MindooDBAppListUsersPage, bY as MindooDBAppLiveQuerySubscription, bZ as MindooDBAppLocalizedText, b_ as MindooDBAppMenuAnchor, b$ as MindooDBAppMenuApi, c0 as MindooDBAppMenuCommandItem, c1 as MindooDBAppMenuDismissReason, c2 as MindooDBAppMenuDismissedResult, c3 as MindooDBAppMenuItem, c4 as MindooDBAppMenuKind, c5 as MindooDBAppMenuPlacement, c6 as MindooDBAppMenuPointAnchor, c7 as MindooDBAppMenuRect, c8 as MindooDBAppMenuRectAnchor, c9 as MindooDBAppMenuSelectionResult, ca as MindooDBAppMenuSeparatorItem, cb as MindooDBAppNotificationSeverity, cc as MindooDBAppNotifyInput, cd as MindooDBAppNotifyResult, ce as MindooDBAppProposeAppInput, cf as MindooDBAppProposeAppResult, cg as MindooDBAppQueryCoverage, ch as MindooDBAppQueryInclude, ci as MindooDBAppQueryIncludeCardinality, cj as MindooDBAppQueryIncludeSlots, ck as MindooDBAppQueryResult, cl as MindooDBAppQueryRow, cm as MindooDBAppQuerySortKey, cn as MindooDBAppQueryTextClause, co as MindooDBAppReadableAttachmentStream, cp as MindooDBAppRecipientOptions, cq as MindooDBAppResolvedViewDefinition, cr as MindooDBAppResolvedViewSource, cs as MindooDBAppRevisionPhase, ct as MindooDBAppRevisionVerification, cu as MindooDBAppRichTextBlockSpan, cv as MindooDBAppRichTextGetOptions, cw as MindooDBAppRichTextImmutableString, cx as MindooDBAppRichTextMarkRange, cy as MindooDBAppRichTextMaterializeValue, cz as MindooDBAppRichTextPatch, cA as MindooDBAppRichTextScalar, cB as MindooDBAppRichTextSpliceStep, cC as MindooDBAppRichTextStep, cD as MindooDBAppRichTextStepPatch, cE as MindooDBAppRichTextTextSpan, cF as MindooDBAppRuntime, cG as MindooDBAppScanAttachmentOptions, cH as MindooDBAppScanAttachmentResult, cI as MindooDBAppScopedDocId, cJ as MindooDBAppScopedDocumentSummary, cK as MindooDBAppSealIntent, cL as MindooDBAppSealedChannelOpenInput, cM as MindooDBAppSealedChannelOpenResult, cN as MindooDBAppSealedChannelRequestInput, cO as MindooDBAppSession, cP as MindooDBAppShowMenuInput, cQ as MindooDBAppShowMenuResult, cR as MindooDBAppSignPreview, cS as MindooDBAppSignPreviewScope, cT as MindooDBAppSignStatementInput, cU as MindooDBAppSignStatementResult, cV as MindooDBAppStorageApi, cW as MindooDBAppSummarySetup, cX as MindooDBAppTextCursorOptions, cY as MindooDBAppTextCursorPosition, cZ as MindooDBAppTextCursorPositionsResult, c_ as MindooDBAppTextCursorsResult, c$ as MindooDBAppTextEdit, d0 as MindooDBAppTextPatch, d1 as MindooDBAppThemeMode, d2 as MindooDBAppTimestampApi, d3 as MindooDBAppTimestampInput, d4 as MindooDBAppTimestampProvider, d5 as MindooDBAppTimestampResult, d6 as MindooDBAppUiPreferences, d7 as MindooDBAppUpdateDocumentInput, d8 as MindooDBAppViewCursorDocumentListResult, d9 as MindooDBAppViewCursorResult, da as MindooDBAppViewEntry, db as MindooDBAppViewEntryKind, dc as MindooDBAppViewNavigator, dd as MindooDBAppViewNavigatorExpansionState, de as MindooDBAppViewNavigatorOpenOptions, df as MindooDBAppViewNavigatorPageOptions, dg as MindooDBAppViewNavigatorPageResult, dh as MindooDBAppViewNavigatorRangeQuery, di as MindooDBAppViewNavigatorSelectionState, dj as MindooDBAppViewUpdateStats, dk as MindooDBAppViewport, dl as MindooDBAppWellKnownDragType, dm as MindooDBAppWritableAttachmentStream, dn as mindooDBAppAcceptMatchesType, dp as mindooDBAppComponentFieldsMatch, dq as resolveMindooDBAppDefinitionUrl, dr as resolveMindooDBAppListingAssetUrl, ds as resolveMindooDBAppLocalizedText, dt as validateMindooDBAppAccepts, du as validateMindooDBAppComponents, dv as validateMindooDBAppDefinition } from './types-D0Bsbd1G.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppAgentToolErrorCode, g as MindooDBAppHostShortcutBinding, h as MindooDBAppHostShortcutAction, i as MindooDBAppHostingMode, j as MindooDBAppDefinition, k as MindooDBAppDatabase, l as MindooDBAppDocument, m as MindooDBAppRichTextSpan, n as MindooDBAppRichTextSnapshot, o as MindooDBAppCreateDocumentInput } from './types-ClOh6z0L.js';
+export { p as MINDOODB_APP_ACCEPTS_MAX, q as MINDOODB_APP_COMPONENTS_MAX, r as MINDOODB_APP_DEFINITION_FILE_NAME, s as MINDOODB_APP_DEFINITION_FORMAT, t as MINDOODB_APP_DEFINITION_PERMISSIONS, u as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, v as MINDOODB_APP_DEFINITION_VERSION, w as MINDOODB_APP_LISTING_DESCRIPTION_MAX, x as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, y as MINDOODB_APP_LISTING_SUMMARY_MAX, z as MINDOODB_APP_SEAL_SIGNING_DOMAIN, A as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, B as MindooDBAppAcceptSpec, C as MindooDBAppAccessDecision, D as MindooDBAppAccessTier, E as MindooDBAppAgentApi, F as MindooDBAppAgentRegistration, G as MindooDBAppAgentTool, H as MindooDBAppAgentToolAnnotations, I as MindooDBAppAgentToolDescriptor, J as MindooDBAppAttachmentApi, K as MindooDBAppAttachmentChunk, L as MindooDBAppAttachmentInfo, N as MindooDBAppAttachmentPreviewOptions, O as MindooDBAppAttachmentPreviewSession, P as MindooDBAppAutomergeChangesPatch, Q as MindooDBAppAutomergeChangesSince, R as MindooDBAppAutomergeGetOptions, S as MindooDBAppAutomergePatchResult, T as MindooDBAppAutomergeSnapshot, U as MindooDBAppBridgeAgentInvokeMessage, V as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeBeforeCloseAck, X as MindooDBAppBridgeBeforeCloseMessage, Y as MindooDBAppBridgeConnectMessage, Z as MindooDBAppBridgeConnectOptions, _ as MindooDBAppBridgeConnectedMessage, $ as MindooDBAppBridgeDragDropMessage, a0 as MindooDBAppBridgeDragLeaveMessage, a1 as MindooDBAppBridgeDragOverMessage, a2 as MindooDBAppBridgeEmbedEventMessage, a3 as MindooDBAppBridgeEmbeddingRequestMessage, a4 as MindooDBAppBridgeErrorPayload, a5 as MindooDBAppBridgeHandshakeErrorMessage, a6 as MindooDBAppBridgeHostFocusChangedMessage, a7 as MindooDBAppBridgeIncomingContentMessage, a8 as MindooDBAppBridgeLocaleChangedMessage, a9 as MindooDBAppBridgePortMessage, aa as MindooDBAppBridgeQueryResultMessage, ab as MindooDBAppBridgeRpcError, ac as MindooDBAppBridgeRpcMessage, ad as MindooDBAppBridgeRpcRequest, ae as MindooDBAppBridgeRpcSuccess, af as MindooDBAppBridgeShortcutInvokedMessage, ag as MindooDBAppBridgeShortcutsChangedMessage, ah as MindooDBAppBridgeStreamAbortRequest, ai as MindooDBAppBridgeStreamAck, aj as MindooDBAppBridgeStreamCloseRequest, ak as MindooDBAppBridgeStreamError, al as MindooDBAppBridgeStreamMessage, am as MindooDBAppBridgeStreamOpenResult, an as MindooDBAppBridgeStreamReadRequest, ao as MindooDBAppBridgeStreamWriteRequest, ap as MindooDBAppBridgeThemeChangedMessage, aq as MindooDBAppBridgeUiPreferencesChangedMessage, ar as MindooDBAppBridgeViewChangedMessage, as as MindooDBAppBridgeViewportChangedMessage, at as MindooDBAppBridgeWorkspaceFocusRequestedMessage, au as MindooDBAppBrowserFeatures, av as MindooDBAppCapability, aw as MindooDBAppComponentChildren, ax as MindooDBAppComponentFieldValue, ay as MindooDBAppComponentInfo, az as MindooDBAppComponentIntent, aA as MindooDBAppComponentQuery, aB as MindooDBAppComponentSpec, aC as MindooDBAppComponentsApi, 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 MindooDBAppDefinitionDatabase, aX as MindooDBAppDefinitionListing, aY as MindooDBAppDefinitionPermission, aZ as MindooDBAppDefinitionRegistrationPermission, a_ as MindooDBAppDefinitionScreenshot, a$ as MindooDBAppDefinitionValidation, b0 as MindooDBAppDirectoryApi, b1 as MindooDBAppDirectoryEntry, b2 as MindooDBAppDocumentApi, b3 as MindooDBAppDocumentHeadCursorResult, b4 as MindooDBAppDocumentHistoryEntry, b5 as MindooDBAppDocumentListQuery, b6 as MindooDBAppDocumentListResult, b7 as MindooDBAppDocumentQuery, b8 as MindooDBAppDocumentRevisionId, b9 as MindooDBAppDocumentScanPreset, ba as MindooDBAppDocumentSummary, bb as MindooDBAppDragApi, bc as MindooDBAppDragCancelReason, bd as MindooDBAppDragDropEvent, be as MindooDBAppDragEffect, bf as MindooDBAppDragHoverResult, bg as MindooDBAppDragOffer, bh as MindooDBAppDragOverEvent, bi as MindooDBAppDragPointer, bj as MindooDBAppDragProfile, bk as MindooDBAppEmbed, bl as MindooDBAppEmbedCloseReason, bm as MindooDBAppEmbedClosedEvent, bn as MindooDBAppEmbedContext, bo as MindooDBAppEmbedDirtyEvent, bp as MindooDBAppEmbedOpenInput, bq as MindooDBAppEmbedRect, br as MindooDBAppEmbeddingApi, bs as MindooDBAppEmbedsApi, bt as MindooDBAppEntryAttachmentRef, bu as MindooDBAppEntryProvenance, bv as MindooDBAppExtractDocumentTextInput, bw as MindooDBAppExtractDocumentTextResult, bx as MindooDBAppExtractTextFormat, by as MindooDBAppExtractionSetup, bz as MindooDBAppFulltextSetup, bA as MindooDBAppHistoricalDocument, bB as MindooDBAppHistoryQuery, bC as MindooDBAppHostTheme, bD as MindooDBAppIdentityApi, bE as MindooDBAppInaccessibleDocument, bF as MindooDBAppInaccessibleDocumentListQuery, bG as MindooDBAppInaccessibleDocumentListResult, bH as MindooDBAppIncomingContent, bI as MindooDBAppIncomingContentHandler, bJ as MindooDBAppIncomingContentInfo, bK as MindooDBAppIncomingItem, bL as MindooDBAppIncomingItemInfo, bM as MindooDBAppIncomingResult, bN as MindooDBAppIncomingSource, bO as MindooDBAppJsonCounterIncrementPatch, bP as MindooDBAppJsonListDeletePatch, bQ as MindooDBAppJsonListInsertPatch, bR as MindooDBAppJsonPatch, bS as MindooDBAppJsonSetPatch, bT as MindooDBAppJsonTextMarkPatch, bU as MindooDBAppJsonTextSplicePatch, bV as MindooDBAppJsonTextUnmarkPatch, bW as MindooDBAppJsonUnsetPatch, bX as MindooDBAppLaunchContext, bY as MindooDBAppListUsersOptions, bZ as MindooDBAppListUsersPage, b_ as MindooDBAppLiveQuerySubscription, b$ as MindooDBAppLocalizedText, c0 as MindooDBAppMenuAnchor, c1 as MindooDBAppMenuApi, c2 as MindooDBAppMenuCommandItem, c3 as MindooDBAppMenuDismissReason, c4 as MindooDBAppMenuDismissedResult, c5 as MindooDBAppMenuItem, c6 as MindooDBAppMenuKind, c7 as MindooDBAppMenuPlacement, c8 as MindooDBAppMenuPointAnchor, c9 as MindooDBAppMenuRect, ca as MindooDBAppMenuRectAnchor, cb as MindooDBAppMenuSelectionResult, cc as MindooDBAppMenuSeparatorItem, cd as MindooDBAppNotificationSeverity, ce as MindooDBAppNotifyInput, cf as MindooDBAppNotifyResult, cg as MindooDBAppProposeAppInput, ch as MindooDBAppProposeAppResult, ci as MindooDBAppQueryCoverage, cj as MindooDBAppQueryInclude, ck as MindooDBAppQueryIncludeCardinality, cl as MindooDBAppQueryIncludeSlots, cm as MindooDBAppQueryResult, cn as MindooDBAppQueryRow, co as MindooDBAppQuerySortKey, cp as MindooDBAppQueryTextClause, cq as MindooDBAppReadableAttachmentStream, cr as MindooDBAppRecipientOptions, cs as MindooDBAppResolvedViewDefinition, ct as MindooDBAppResolvedViewSource, cu as MindooDBAppRevisionPhase, cv as MindooDBAppRevisionVerification, cw as MindooDBAppRichTextBlockSpan, cx as MindooDBAppRichTextGetOptions, cy as MindooDBAppRichTextImmutableString, cz as MindooDBAppRichTextMarkRange, cA as MindooDBAppRichTextMaterializeValue, cB as MindooDBAppRichTextPatch, cC as MindooDBAppRichTextScalar, cD as MindooDBAppRichTextSpliceStep, cE as MindooDBAppRichTextStep, cF as MindooDBAppRichTextStepPatch, cG as MindooDBAppRichTextTextSpan, cH as MindooDBAppRuntime, cI as MindooDBAppScanAttachmentOptions, cJ as MindooDBAppScanAttachmentResult, cK as MindooDBAppScopedDocId, cL as MindooDBAppScopedDocumentSummary, cM as MindooDBAppSealIntent, cN as MindooDBAppSealedChannelOpenInput, cO as MindooDBAppSealedChannelOpenResult, cP as MindooDBAppSealedChannelRequestInput, cQ as MindooDBAppSession, cR as MindooDBAppShowMenuInput, cS as MindooDBAppShowMenuResult, cT as MindooDBAppSignPreview, cU as MindooDBAppSignPreviewScope, cV as MindooDBAppSignStatementInput, cW as MindooDBAppSignStatementResult, cX as MindooDBAppStorageApi, cY as MindooDBAppSummarySetup, cZ as MindooDBAppTextCursorOptions, c_ as MindooDBAppTextCursorPosition, c$ as MindooDBAppTextCursorPositionsResult, d0 as MindooDBAppTextCursorsResult, d1 as MindooDBAppTextEdit, d2 as MindooDBAppTextPatch, d3 as MindooDBAppThemeMode, d4 as MindooDBAppTimestampApi, d5 as MindooDBAppTimestampInput, d6 as MindooDBAppTimestampProvider, d7 as MindooDBAppTimestampResult, d8 as MindooDBAppUiPreferences, d9 as MindooDBAppUpdateDocumentInput, da as MindooDBAppViewCursorDocumentListResult, db as MindooDBAppViewCursorResult, dc as MindooDBAppViewEntry, dd as MindooDBAppViewEntryKind, de as MindooDBAppViewNavigator, df as MindooDBAppViewNavigatorExpansionState, dg as MindooDBAppViewNavigatorOpenOptions, dh as MindooDBAppViewNavigatorPageOptions, di as MindooDBAppViewNavigatorPageResult, dj as MindooDBAppViewNavigatorRangeQuery, dk as MindooDBAppViewNavigatorSelectionState, dl as MindooDBAppViewUpdateStats, dm as MindooDBAppViewport, dn as MindooDBAppWellKnownDragType, dp as MindooDBAppWritableAttachmentStream, dq as mindooDBAppAcceptMatchesType, dr as mindooDBAppComponentFieldsMatch, ds as resolveMindooDBAppDefinitionUrl, dt as resolveMindooDBAppListingAssetUrl, du as resolveMindooDBAppLocalizedText, dv as validateMindooDBAppAccepts, dw as validateMindooDBAppComponents, dx as validateMindooDBAppDefinition } from './types-ClOh6z0L.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';

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   validateMindooDBAppAccepts,
   validateMindooDBAppComponents,
   validateMindooDBAppDefinition
-} from "./chunk-HJUDYIPR.js";
+} from "./chunk-QQRLEHFE.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { ax as MindooDBAppComponentInfo, bo as MindooDBAppEmbedRect, aT as MindooDBAppCreateViewNavigatorInput, dc as MindooDBAppViewNavigator, ac as MindooDBAppBridgeRpcRequest, bA as MindooDBAppHostTheme, au as MindooDBAppCapability, j as MindooDBAppDefinition, J as MindooDBAppAttachmentApi, e as MindooDBAppBridge, cO as MindooDBAppSession, ce as MindooDBAppProposeAppInput, dk as MindooDBAppViewport, d6 as MindooDBAppUiPreferences, ck as MindooDBAppQueryResult, dj as MindooDBAppViewUpdateStats, a8 as MindooDBAppBridgePortMessage, aU as MindooDBAppDatabaseInfo, bk as MindooDBAppEmbedCloseReason, a3 as MindooDBAppBridgeErrorPayload, bV as MindooDBAppLaunchContext, b1 as MindooDBAppDocumentApi, de as MindooDBAppViewNavigatorOpenOptions, bB as MindooDBAppIdentityApi, d2 as MindooDBAppTimestampApi, a$ as MindooDBAppDirectoryApi, l as MindooDBAppDocument, bx as MindooDBAppFulltextSetup, bw as MindooDBAppExtractionSetup, cW as MindooDBAppSummarySetup, cf as MindooDBAppProposeAppResult, bL as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bi as MindooDBAppDragProfile, bK as MindooDBAppIncomingResult } from '../types-D0Bsbd1G.js';
+import { ay as MindooDBAppComponentInfo, bq as MindooDBAppEmbedRect, aU as MindooDBAppCreateViewNavigatorInput, de as MindooDBAppViewNavigator, ad as MindooDBAppBridgeRpcRequest, bC as MindooDBAppHostTheme, av as MindooDBAppCapability, j as MindooDBAppDefinition, J as MindooDBAppAttachmentApi, e as MindooDBAppBridge, cQ as MindooDBAppSession, cg as MindooDBAppProposeAppInput, dm as MindooDBAppViewport, d8 as MindooDBAppUiPreferences, cm as MindooDBAppQueryResult, dl as MindooDBAppViewUpdateStats, a9 as MindooDBAppBridgePortMessage, aV as MindooDBAppDatabaseInfo, bl as MindooDBAppEmbedCloseReason, a4 as MindooDBAppBridgeErrorPayload, bX as MindooDBAppLaunchContext, b2 as MindooDBAppDocumentApi, dg as MindooDBAppViewNavigatorOpenOptions, bD as MindooDBAppIdentityApi, d4 as MindooDBAppTimestampApi, b0 as MindooDBAppDirectoryApi, l as MindooDBAppDocument, bz as MindooDBAppFulltextSetup, by as MindooDBAppExtractionSetup, cY as MindooDBAppSummarySetup, ch as MindooDBAppProposeAppResult, bN as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bj as MindooDBAppDragProfile, bM as MindooDBAppIncomingResult } from '../types-ClOh6z0L.js';
 import * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 
@@ -11,6 +11,8 @@ interface MockEmbedState {
     intent: "edit" | "view";
     rect: MindooDBAppEmbedRect;
     visible: boolean;
+    /** What the component last reported (`setEmbedDirty`); `undefined` until then. */
+    dirty?: boolean;
 }
 /** How an app running as an embedded component finished (`session.embedding`). */
 interface MockEmbeddingFinish {
@@ -342,6 +344,12 @@ interface CreateMockMindooDBAppSessionOptions {
     components?: MindooDBAppComponentInfo[];
     /** Called whenever the app opens, moves or closes an embed. */
     onEmbedChange?: (embeds: readonly MockEmbedState[]) => void;
+    /**
+     * Answer `embeds.open` with a `container` like a current Haven: with this page
+     * for the SDK to frame (e.g. `about:blank`). Without it the host behaves like an
+     * older Haven and the component is laid over the container.
+     */
+    embedFrameUrl?: string;
 }
 /**
  * Test usernames in Haven's canonical form: `CN=Test User 001/O=Test`, …
@@ -395,6 +403,14 @@ interface MockMindooDBAppSessionController {
     setComponents(components: MindooDBAppComponentInfo[]): void;
     /** For an app under test that runs as a component: its `session.embedding` call. */
     getEmbeddingFinish(): MockEmbeddingFinish | null;
+    /** As if the embedded component reported (un)saved changes; the app's embed follows. */
+    setEmbedDirty(embedId: string, dirty: boolean): void;
+    /** Makes the app's next `embed.save()` fail with this message. */
+    failNextEmbedSave(message: string): void;
+    /** For an app under test that runs as a component: its last `embedding.setDirty`. */
+    getEmbeddingDirty(): boolean | undefined;
+    /** For an app under test that runs as a component: asks it to save, as its host would. */
+    requestEmbeddingSave(): Promise<void>;
 }
 
 /** Content for `emitIncomingContent`. */
@@ -492,6 +508,17 @@ interface FakeBridgeHostController {
     closeEmbed(embedId: string, reason?: MindooDBAppEmbedCloseReason, result?: unknown): void;
     /** For an app under test that runs as a component: its `session.embedding` call. */
     getEmbeddingFinish(): MockEmbeddingFinish | null;
+    /** As if the embedded component reported (un)saved changes; pushes the `embed-event`. */
+    setEmbedDirty(embedId: string, dirty: boolean): void;
+    /** Makes the app's next `embed.save()` fail with this message. */
+    failNextEmbedSave(message: string): void;
+    /** For an app under test that runs as a component: its last `embedding.setDirty`. */
+    getEmbeddingDirty(): boolean | undefined;
+    /**
+     * For an app under test that runs as a component: pushes the host's save request
+     * over the port and resolves or rejects with the app's answer.
+     */
+    requestEmbeddingSave(): Promise<void>;
 }
 declare function createFakeBridgeHost(options?: CreateFakeBridgeHostOptions): FakeBridgeHostController;
 

package/dist/testing/index.js

@@ -4,7 +4,7 @@ import {
   mindooDBAppComponentFieldsMatch,
   pageUsers,
   releaseMindooDBAppBridgeSessions
-} from "../chunk-HJUDYIPR.js";
+} from "../chunk-QQRLEHFE.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
@@ -463,11 +463,22 @@ function createMockEmbedHost(options, getDatabase) {
   const embeds = /* @__PURE__ */ new Map();
   const handles = /* @__PURE__ */ new Map();
   const closedListeners = /* @__PURE__ */ new Set();
+  const dirtyListeners = /* @__PURE__ */ new Set();
+  let nextSaveError = null;
+  let embeddingDirty;
+  let saveRequestHandler = null;
   let embedCounter = 0;
   let embeddingFinish = null;
   function notifyChange() {
     options.onEmbedChange?.([...embeds.values()].map((entry) => ({ ...entry, rect: { ...entry.rect } })));
   }
+  function mockRect(input) {
+    if (input.rect) {
+      return { ...input.rect };
+    }
+    const bounds = input.container?.getBoundingClientRect();
+    return { left: bounds?.left ?? 0, top: bounds?.top ?? 0, width: bounds?.width ?? 0, height: bounds?.height ?? 0 };
+  }
   async function openEmbed(input) {
     const component = components.find((entry) => entry.key === input.componentKey);
     if (!component) {
@@ -492,7 +503,7 @@ function createMockEmbedHost(options, getDatabase) {
       databaseId: input.databaseId,
       docId: input.docId,
       intent,
-      rect: { ...input.rect },
+      rect: mockRect(input),
       visible: input.visible !== false
     });
     notifyChange();
@@ -526,7 +537,27 @@ function createMockEmbedHost(options, getDatabase) {
     componentKey;
     databaseId;
     docId;
+    placement = "overlay";
+    frame = null;
     closed;
+    dirty = void 0;
+    dirtyListeners = /* @__PURE__ */ new Set();
+    onDirtyChange(listener) {
+      this.dirtyListeners.add(listener);
+      return () => {
+        this.dirtyListeners.delete(listener);
+      };
+    }
+    setDirtyState(dirty) {
+      if (this.settled || this.dirty === dirty) {
+        return;
+      }
+      this.dirty = dirty;
+      this.dirtyListeners.forEach((listener) => listener(dirty));
+    }
+    async save() {
+      await saveEmbed(this.embedId);
+    }
     resolve;
     listeners = /* @__PURE__ */ new Set();
     settled = null;
@@ -536,7 +567,7 @@ function createMockEmbedHost(options, getDatabase) {
     async setVisible(visible) {
       setVisible(this.embedId, visible);
     }
-    async close() {
+    async close(_options) {
       closeEmbed(this.embedId, "closed");
       return await this.closed;
     }
@@ -566,6 +597,27 @@ function createMockEmbedHost(options, getDatabase) {
       notifyChange();
     }
   }
+  function setEmbedDirty(embedId, dirty) {
+    const entry = embeds.get(embedId);
+    if (!entry || entry.dirty === dirty) {
+      return;
+    }
+    entry.dirty = dirty;
+    handles.get(embedId)?.setDirtyState(dirty);
+    dirtyListeners.forEach((listener) => listener({ embedId, dirty }));
+    notifyChange();
+  }
+  async function saveEmbed(embedId) {
+    if (!embeds.has(embedId)) {
+      throw new Error("Unknown embed.");
+    }
+    const error = nextSaveError;
+    nextSaveError = null;
+    if (error) {
+      throw new Error(error);
+    }
+    setEmbedDirty(embedId, false);
+  }
   function setVisible(embedId, visible) {
     const entry = embeds.get(embedId);
     if (entry) {
@@ -596,6 +648,17 @@ function createMockEmbedHost(options, getDatabase) {
       },
       async cancel(message) {
         embeddingFinish = { reason: "cancelled", ...message ? { message } : {} };
+      },
+      async setDirty(dirty) {
+        embeddingDirty = dirty === true;
+      },
+      onSaveRequest(handler) {
+        saveRequestHandler = handler;
+        return () => {
+          if (saveRequestHandler === handler) {
+            saveRequestHandler = null;
+          }
+        };
       }
     },
     openEmbed,
@@ -619,6 +682,32 @@ function createMockEmbedHost(options, getDatabase) {
       return () => {
         closedListeners.delete(listener);
       };
+    },
+    setEmbedDirty,
+    onDirty(listener) {
+      dirtyListeners.add(listener);
+      return () => {
+        dirtyListeners.delete(listener);
+      };
+    },
+    saveEmbed,
+    failNextSave(message) {
+      nextSaveError = message;
+    },
+    getEmbeddingDirty() {
+      return embeddingDirty;
+    },
+    setEmbeddingDirty(dirty) {
+      embeddingDirty = dirty;
+    },
+    async requestEmbeddingSave() {
+      if (!saveRequestHandler) {
+        throw new Error("unsupported");
+      }
+      await saveRequestHandler();
+    },
+    setSaveRequestHandler(handler) {
+      saveRequestHandler = handler;
     }
   };
 }
@@ -4051,7 +4140,11 @@ function createMockMindooDBAppSession(options = {}) {
     listEmbeds: () => state.embedHost.listEmbeds(),
     closeEmbed: (embedId, reason, result) => state.embedHost.closeEmbed(embedId, reason, result),
     setComponents: (components) => state.embedHost.setComponents(components),
-    getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish()
+    getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish(),
+    setEmbedDirty: (embedId, dirty) => state.embedHost.setEmbedDirty(embedId, dirty),
+    failNextEmbedSave: (message) => state.embedHost.failNextSave(message),
+    getEmbeddingDirty: () => state.embedHost.getEmbeddingDirty(),
+    requestEmbeddingSave: () => state.embedHost.requestEmbeddingSave()
   };
 }
 function createMockMindooDBAppBridge(options = {}) {
@@ -4070,6 +4163,13 @@ function createFakeBridgeHost(options = {}) {
       (port) => port.postMessage({ protocol: PROTOCOL, kind: "embed-event", event: { type: "closed", ...event } })
     );
   });
+  state.embedHost.onDirty((event) => {
+    connectedPorts.forEach(
+      (port) => port.postMessage({ protocol: PROTOCOL, kind: "embed-event", event: { type: "dirty", ...event } })
+    );
+  });
+  const embeddingRequests = /* @__PURE__ */ new Map();
+  let embeddingRequestCounter = 0;
   const beforeCloseWaiters = /* @__PURE__ */ new Map();
   let beforeCloseCounter = 0;
   const viewSessions = /* @__PURE__ */ new Map();
@@ -4302,8 +4402,11 @@ function createFakeBridgeHost(options = {}) {
             params.query ?? void 0
           )
         };
-      case "embeds.open":
-        return { embedId: await state.embedHost.openEmbed(params.input) };
+      case "embeds.open": {
+        const input = params.input;
+        const embedId = await state.embedHost.openEmbed(input);
+        return input.placement === "frame" && options.embedFrameUrl ? { embedId, frame: { url: options.embedFrameUrl } } : { embedId };
+      }
       case "embeds.setRect":
         state.embedHost.setRect(String(params.embedId), params.rect);
         return { ok: true };
@@ -4313,6 +4416,22 @@ function createFakeBridgeHost(options = {}) {
       case "embeds.close":
         state.embedHost.closeEmbed(String(params.embedId), "closed");
         return { ok: true };
+      case "embeds.save":
+        await state.embedHost.saveEmbed(String(params.embedId));
+        return { ok: true };
+      case "embedding.setDirty":
+        state.embedHost.setEmbeddingDirty(params.dirty === true);
+        return { ok: true };
+      case "embedding.respond": {
+        const pending = embeddingRequests.get(String(params.requestId));
+        embeddingRequests.delete(String(params.requestId));
+        if (params.ok === true) {
+          pending?.resolve();
+        } else {
+          pending?.reject(new Error(typeof params.error === "string" ? params.error : "Save failed."));
+        }
+        return { ok: true };
+      }
       case "embedding.finish":
         state.embedHost.finishEmbedding({
           reason: params.reason === "cancelled" ? "cancelled" : "completed",
@@ -4927,6 +5046,19 @@ function createFakeBridgeHost(options = {}) {
     listEmbeds: () => state.embedHost.listEmbeds(),
     closeEmbed: (embedId, reason, result) => state.embedHost.closeEmbed(embedId, reason, result),
     getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish(),
+    setEmbedDirty: (embedId, dirty) => state.embedHost.setEmbedDirty(embedId, dirty),
+    failNextEmbedSave: (message) => state.embedHost.failNextSave(message),
+    getEmbeddingDirty: () => state.embedHost.getEmbeddingDirty(),
+    requestEmbeddingSave() {
+      embeddingRequestCounter += 1;
+      const requestId = `embedding-request-${embeddingRequestCounter}`;
+      return new Promise((resolve, reject) => {
+        embeddingRequests.set(requestId, { resolve, reject });
+        connectedPorts.forEach(
+          (port) => port.postMessage({ protocol: PROTOCOL, kind: "embedding-request", requestId, request: "save" })
+        );
+      });
+    },
     dispose() {
       restoreWindow();
       connectedPorts.forEach((port) => {

package/dist/{types-D0Bsbd1G.d.ts → types-ClOh6z0L.d.ts}

@@ -1621,8 +1621,23 @@ interface MindooDBAppEmbedOpenInput {
     docId: string;
     /** Default `edit`. `view` gives the component read access only. */
     intent?: "edit" | "view";
-    /** Where the component appears, in this app's viewport. */
-    rect: MindooDBAppEmbedRect;
+    /**
+     * The element to show the component in (recommended). The SDK puts a frame into
+     * it that fills it (`position: absolute; inset: 0`, so give the element a
+     * position), and the component then belongs to this app's page: it scrolls,
+     * clips and stacks with it, and this app's menus and dialogs cover it as usual.
+     * The frame holds a page of Haven's that loads the component, so this app never
+     * reaches into the component or its connection.
+     *
+     * Havens that predate this lay the component over the element instead; the SDK
+     * then keeps the rectangle in step with the element itself.
+     */
+    container?: HTMLElement;
+    /**
+     * Without `container`: where Haven lays the component over this app, in this
+     * app's viewport. Keep it current with `setRect`.
+     */
+    rect?: MindooDBAppEmbedRect;
     /** Default true. */
     visible?: boolean;
 }
@@ -1642,12 +1657,44 @@ interface MindooDBAppEmbed {
     readonly componentKey: string;
     readonly databaseId: string;
     readonly docId: string;
-    /** Move or resize; coordinates are in this app's viewport. */
+    /**
+     * `frame`: the component is a frame in `container` and stacks like any element
+     * of this page. `overlay`: Haven lays it over this page, above everything in it,
+     * so hide it (`setVisible(false)`) while a menu or dialog of this app would
+     * overlap it.
+     */
+    readonly placement: "frame" | "overlay";
+    /** The component's frame in `container` (`frame` placement), else null. */
+    readonly frame: HTMLIFrameElement | null;
+    /**
+     * Move or resize; coordinates are in this app's viewport. Not needed with a
+     * `container`, whose rectangle the SDK follows itself.
+     */
     setRect(rect: MindooDBAppEmbedRect): Promise<void>;
     /** Hide without closing, e.g. while a dialog of the host covers it. */
     setVisible(visible: boolean): Promise<void>;
-    /** Let the component save, then close it. Resolves with the closed event. */
-    close(): Promise<MindooDBAppEmbedClosedEvent>;
+    /**
+     * Whether the component has changes it has not saved yet, as it last reported
+     * (`session.embedding.setDirty`). `undefined` until it reports anything: a
+     * component that never does cannot tell, so close it without asking.
+     */
+    readonly dirty: boolean | undefined;
+    /** Called whenever the component reports a different `dirty` state. */
+    onDirtyChange(listener: (dirty: boolean) => void): () => void;
+    /**
+     * Asks the component to save its pending changes (`session.embedding.onSaveRequest`),
+     * e.g. after the user chose "Save" when closing it. Resolves once it saved; rejects
+     * with the component's error, or with `unsupported` when it does not save on request.
+     */
+    save(): Promise<void>;
+    /**
+     * Let the component save, then close it. Resolves with the closed event.
+     * `discard: true` closes without giving the component that chance, after the user
+     * chose not to keep its unsaved changes.
+     */
+    close(options?: {
+        discard?: boolean;
+    }): Promise<MindooDBAppEmbedClosedEvent>;
     /** Called once when the component closes, whoever closed it. */
     onClosed(listener: (event: MindooDBAppEmbedClosedEvent) => void): () => void;
     /** Settles with the closed event. */
@@ -1660,7 +1707,7 @@ interface MindooDBAppComponentsApi {
 /** Show another app's component inside this app. */
 interface MindooDBAppEmbedsApi {
     /**
-     * Shows the component over `rect`. Haven copies the root document and its
+     * Shows the component in `container` (or over `rect`). Haven copies the root document and its
      * children into a sandbox, runs the component against it and writes the changes
      * back to `databaseId`, which this app must be allowed to read and (for `edit`)
      * update. The first time, Haven asks the user to allow the pairing.
@@ -1676,16 +1723,41 @@ interface MindooDBAppEmbeddingApi {
     complete(result?: unknown): Promise<void>;
     /** Closes without a result, e.g. when the user cancels. */
     cancel(message?: string): Promise<void>;
+    /**
+     * Tells the host whether there are changes not saved yet, so it can mark the
+     * component (e.g. a dot in its tab) and ask before closing it. Report every change
+     * of the state; Haven passes the latest one on.
+     */
+    setDirty(dirty: boolean): Promise<void>;
+    /**
+     * Handles the host's request to save (`embed.save()`). Resolve once saved, throw to
+     * report why it failed. One handler at a time; returns the unregister function.
+     */
+    onSaveRequest(handler: () => void | Promise<void>): () => void;
+}
+/** Haven → component: the host asked for something (`embed.save()`). */
+interface MindooDBAppBridgeEmbeddingRequestMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "embedding-request";
+    requestId: string;
+    request: "save";
+}
+/** The component reported whether it has unsaved changes. */
+interface MindooDBAppEmbedDirtyEvent {
+    embedId: string;
+    dirty: boolean;
 }
 /** Host → app: something happened to an embed this app opened. */
 interface MindooDBAppBridgeEmbedEventMessage {
     protocol: "mindoodb-app-bridge";
     kind: "embed-event";
-    event: {
+    event: ({
         type: "closed";
-    } & MindooDBAppEmbedClosedEvent;
+    } & MindooDBAppEmbedClosedEvent) | ({
+        type: "dirty";
+    } & MindooDBAppEmbedDirtyEvent);
 }
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage | MindooDBAppBridgeIncomingContentMessage | MindooDBAppBridgeEmbedEventMessage;
+type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage | MindooDBAppBridgeIncomingContentMessage | MindooDBAppBridgeEmbedEventMessage | MindooDBAppBridgeEmbeddingRequestMessage;
 /** 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. */
@@ -3389,4 +3461,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppBridgeDragDropMessage as $, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as A, type MindooDBAppAcceptSpec as B, type MindooDBAppAccessDecision as C, type MindooDBAppAccessTier as D, type MindooDBAppAgentApi as E, type MindooDBAppAgentRegistration as F, type MindooDBAppAgentTool as G, type MindooDBAppAgentToolAnnotations as H, type MindooDBAppAgentToolDescriptor as I, type MindooDBAppAttachmentApi as J, type MindooDBAppAttachmentChunk as K, type MindooDBAppAttachmentInfo as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAttachmentPreviewOptions as N, type MindooDBAppAttachmentPreviewSession as O, type MindooDBAppAutomergeChangesPatch as P, type MindooDBAppAutomergeChangesSince as Q, type MindooDBAppAutomergeGetOptions as R, type MindooDBAppAutomergePatchResult as S, type MindooDBAppAutomergeSnapshot as T, type MindooDBAppBridgeAgentInvokeMessage as U, type MindooDBAppBridgeAgentResultMessage as V, type MindooDBAppBridgeBeforeCloseAck as W, type MindooDBAppBridgeBeforeCloseMessage as X, type MindooDBAppBridgeConnectMessage as Y, type MindooDBAppBridgeConnectOptions as Z, type MindooDBAppBridgeConnectedMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppDirectoryApi as a$, type MindooDBAppBridgeDragLeaveMessage as a0, type MindooDBAppBridgeDragOverMessage as a1, type MindooDBAppBridgeEmbedEventMessage as a2, type MindooDBAppBridgeErrorPayload as a3, type MindooDBAppBridgeHandshakeErrorMessage as a4, type MindooDBAppBridgeHostFocusChangedMessage as a5, type MindooDBAppBridgeIncomingContentMessage as a6, type MindooDBAppBridgeLocaleChangedMessage as a7, type MindooDBAppBridgePortMessage as a8, type MindooDBAppBridgeQueryResultMessage as a9, type MindooDBAppComponentSpec as aA, type MindooDBAppComponentsApi as aB, type MindooDBAppConfiguredViewCategorizationStyle as aC, type MindooDBAppConfiguredViewColumn as aD, type MindooDBAppConfiguredViewColumnRole as aE, type MindooDBAppConfiguredViewExpressionMode as aF, type MindooDBAppConfiguredViewFieldExpression as aG, type MindooDBAppConfiguredViewFilterDefinition as aH, type MindooDBAppConfiguredViewFilterMode as aI, type MindooDBAppConfiguredViewFilterRule as aJ, type MindooDBAppConfiguredViewFormulaExpression as aK, type MindooDBAppConfiguredViewFormulaFilterDefinition as aL, type MindooDBAppConfiguredViewPreviewMode as aM, type MindooDBAppConfiguredViewRuleFilterDefinition as aN, type MindooDBAppConfiguredViewRuleMatchMode as aO, type MindooDBAppConfiguredViewRuleOperator as aP, type MindooDBAppConfiguredViewValueExpression as aQ, type MindooDBAppCreateKeyInfo as aR, type MindooDBAppCreateViewInput as aS, type MindooDBAppCreateViewNavigatorInput as aT, type MindooDBAppDatabaseInfo as aU, type MindooDBAppDefinitionDatabase as aV, type MindooDBAppDefinitionListing as aW, type MindooDBAppDefinitionPermission as aX, type MindooDBAppDefinitionRegistrationPermission as aY, type MindooDBAppDefinitionScreenshot as aZ, type MindooDBAppDefinitionValidation as a_, type MindooDBAppBridgeRpcError as aa, type MindooDBAppBridgeRpcMessage as ab, type MindooDBAppBridgeRpcRequest as ac, type MindooDBAppBridgeRpcSuccess as ad, type MindooDBAppBridgeShortcutInvokedMessage as ae, type MindooDBAppBridgeShortcutsChangedMessage as af, type MindooDBAppBridgeStreamAbortRequest as ag, type MindooDBAppBridgeStreamAck as ah, type MindooDBAppBridgeStreamCloseRequest as ai, type MindooDBAppBridgeStreamError as aj, type MindooDBAppBridgeStreamMessage as ak, type MindooDBAppBridgeStreamOpenResult as al, type MindooDBAppBridgeStreamReadRequest as am, type MindooDBAppBridgeStreamWriteRequest as an, type MindooDBAppBridgeThemeChangedMessage as ao, type MindooDBAppBridgeUiPreferencesChangedMessage as ap, type MindooDBAppBridgeViewChangedMessage as aq, type MindooDBAppBridgeViewportChangedMessage as ar, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as as, type MindooDBAppBrowserFeatures as at, type MindooDBAppCapability as au, type MindooDBAppComponentChildren as av, type MindooDBAppComponentFieldValue as aw, type MindooDBAppComponentInfo as ax, type MindooDBAppComponentIntent as ay, type MindooDBAppComponentQuery as az, type MindooDBAppDragStartInput as b, type MindooDBAppMenuApi as b$, type MindooDBAppDirectoryEntry as b0, type MindooDBAppDocumentApi as b1, type MindooDBAppDocumentHeadCursorResult as b2, type MindooDBAppDocumentHistoryEntry as b3, type MindooDBAppDocumentListQuery as b4, type MindooDBAppDocumentListResult as b5, type MindooDBAppDocumentQuery as b6, type MindooDBAppDocumentRevisionId as b7, type MindooDBAppDocumentScanPreset as b8, type MindooDBAppDocumentSummary as b9, type MindooDBAppHostTheme as bA, type MindooDBAppIdentityApi as bB, type MindooDBAppInaccessibleDocument as bC, type MindooDBAppInaccessibleDocumentListQuery as bD, type MindooDBAppInaccessibleDocumentListResult as bE, type MindooDBAppIncomingContent as bF, type MindooDBAppIncomingContentHandler as bG, type MindooDBAppIncomingContentInfo as bH, type MindooDBAppIncomingItem as bI, type MindooDBAppIncomingItemInfo as bJ, type MindooDBAppIncomingResult as bK, type MindooDBAppIncomingSource as bL, type MindooDBAppJsonCounterIncrementPatch as bM, type MindooDBAppJsonListDeletePatch as bN, type MindooDBAppJsonListInsertPatch as bO, type MindooDBAppJsonPatch as bP, type MindooDBAppJsonSetPatch as bQ, type MindooDBAppJsonTextMarkPatch as bR, type MindooDBAppJsonTextSplicePatch as bS, type MindooDBAppJsonTextUnmarkPatch as bT, type MindooDBAppJsonUnsetPatch as bU, type MindooDBAppLaunchContext as bV, type MindooDBAppListUsersOptions as bW, type MindooDBAppListUsersPage as bX, type MindooDBAppLiveQuerySubscription as bY, type MindooDBAppLocalizedText as bZ, type MindooDBAppMenuAnchor as b_, type MindooDBAppDragApi as ba, type MindooDBAppDragCancelReason as bb, type MindooDBAppDragDropEvent as bc, type MindooDBAppDragEffect as bd, type MindooDBAppDragHoverResult as be, type MindooDBAppDragOffer as bf, type MindooDBAppDragOverEvent as bg, type MindooDBAppDragPointer as bh, type MindooDBAppDragProfile as bi, type MindooDBAppEmbed as bj, type MindooDBAppEmbedCloseReason as bk, type MindooDBAppEmbedClosedEvent as bl, type MindooDBAppEmbedContext as bm, type MindooDBAppEmbedOpenInput as bn, type MindooDBAppEmbedRect as bo, type MindooDBAppEmbeddingApi as bp, type MindooDBAppEmbedsApi as bq, type MindooDBAppEntryAttachmentRef as br, type MindooDBAppEntryProvenance as bs, type MindooDBAppExtractDocumentTextInput as bt, type MindooDBAppExtractDocumentTextResult as bu, type MindooDBAppExtractTextFormat as bv, type MindooDBAppExtractionSetup as bw, type MindooDBAppFulltextSetup as bx, type MindooDBAppHistoricalDocument as by, type MindooDBAppHistoryQuery as bz, type MindooDBAppDragStartResult as c, type MindooDBAppTextEdit as c$, type MindooDBAppMenuCommandItem as c0, type MindooDBAppMenuDismissReason as c1, type MindooDBAppMenuDismissedResult as c2, type MindooDBAppMenuItem as c3, type MindooDBAppMenuKind as c4, type MindooDBAppMenuPlacement as c5, type MindooDBAppMenuPointAnchor as c6, type MindooDBAppMenuRect as c7, type MindooDBAppMenuRectAnchor as c8, type MindooDBAppMenuSelectionResult as c9, type MindooDBAppRichTextScalar as cA, type MindooDBAppRichTextSpliceStep as cB, type MindooDBAppRichTextStep as cC, type MindooDBAppRichTextStepPatch as cD, type MindooDBAppRichTextTextSpan as cE, type MindooDBAppRuntime as cF, type MindooDBAppScanAttachmentOptions as cG, type MindooDBAppScanAttachmentResult as cH, type MindooDBAppScopedDocId as cI, type MindooDBAppScopedDocumentSummary as cJ, type MindooDBAppSealIntent as cK, type MindooDBAppSealedChannelOpenInput as cL, type MindooDBAppSealedChannelOpenResult as cM, type MindooDBAppSealedChannelRequestInput as cN, type MindooDBAppSession as cO, type MindooDBAppShowMenuInput as cP, type MindooDBAppShowMenuResult as cQ, type MindooDBAppSignPreview as cR, type MindooDBAppSignPreviewScope as cS, type MindooDBAppSignStatementInput as cT, type MindooDBAppSignStatementResult as cU, type MindooDBAppStorageApi as cV, type MindooDBAppSummarySetup as cW, type MindooDBAppTextCursorOptions as cX, type MindooDBAppTextCursorPosition as cY, type MindooDBAppTextCursorPositionsResult as cZ, type MindooDBAppTextCursorsResult as c_, type MindooDBAppMenuSeparatorItem as ca, type MindooDBAppNotificationSeverity as cb, type MindooDBAppNotifyInput as cc, type MindooDBAppNotifyResult as cd, type MindooDBAppProposeAppInput as ce, type MindooDBAppProposeAppResult as cf, type MindooDBAppQueryCoverage as cg, type MindooDBAppQueryInclude as ch, type MindooDBAppQueryIncludeCardinality as ci, type MindooDBAppQueryIncludeSlots as cj, type MindooDBAppQueryResult as ck, type MindooDBAppQueryRow as cl, type MindooDBAppQuerySortKey as cm, type MindooDBAppQueryTextClause as cn, type MindooDBAppReadableAttachmentStream as co, type MindooDBAppRecipientOptions as cp, type MindooDBAppResolvedViewDefinition as cq, type MindooDBAppResolvedViewSource as cr, type MindooDBAppRevisionPhase as cs, type MindooDBAppRevisionVerification as ct, type MindooDBAppRichTextBlockSpan as cu, type MindooDBAppRichTextGetOptions as cv, type MindooDBAppRichTextImmutableString as cw, type MindooDBAppRichTextMarkRange as cx, type MindooDBAppRichTextMaterializeValue as cy, type MindooDBAppRichTextPatch as cz, type MindooDBAppDragPreview as d, type MindooDBAppTextPatch as d0, type MindooDBAppThemeMode as d1, type MindooDBAppTimestampApi as d2, type MindooDBAppTimestampInput as d3, type MindooDBAppTimestampProvider as d4, type MindooDBAppTimestampResult as d5, type MindooDBAppUiPreferences as d6, type MindooDBAppUpdateDocumentInput as d7, type MindooDBAppViewCursorDocumentListResult as d8, type MindooDBAppViewCursorResult as d9, type MindooDBAppViewEntry as da, type MindooDBAppViewEntryKind as db, type MindooDBAppViewNavigator as dc, type MindooDBAppViewNavigatorExpansionState as dd, type MindooDBAppViewNavigatorOpenOptions as de, type MindooDBAppViewNavigatorPageOptions as df, type MindooDBAppViewNavigatorPageResult as dg, type MindooDBAppViewNavigatorRangeQuery as dh, type MindooDBAppViewNavigatorSelectionState as di, type MindooDBAppViewUpdateStats as dj, type MindooDBAppViewport as dk, type MindooDBAppWellKnownDragType as dl, type MindooDBAppWritableAttachmentStream as dm, mindooDBAppAcceptMatchesType as dn, mindooDBAppComponentFieldsMatch as dp, resolveMindooDBAppDefinitionUrl as dq, resolveMindooDBAppListingAssetUrl as dr, resolveMindooDBAppLocalizedText as ds, validateMindooDBAppAccepts as dt, validateMindooDBAppComponents as du, validateMindooDBAppDefinition as dv, type MindooDBAppBridge as e, type MindooDBAppAgentToolErrorCode as f, type MindooDBAppHostShortcutBinding as g, type MindooDBAppHostShortcutAction as h, type MindooDBAppHostingMode as i, type MindooDBAppDefinition as j, type MindooDBAppDatabase as k, type MindooDBAppDocument as l, type MindooDBAppRichTextSpan as m, type MindooDBAppRichTextSnapshot as n, type MindooDBAppCreateDocumentInput as o, MINDOODB_APP_ACCEPTS_MAX as p, MINDOODB_APP_COMPONENTS_MAX as q, MINDOODB_APP_DEFINITION_FILE_NAME as r, MINDOODB_APP_DEFINITION_FORMAT as s, MINDOODB_APP_DEFINITION_PERMISSIONS as t, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as u, MINDOODB_APP_DEFINITION_VERSION as v, MINDOODB_APP_LISTING_DESCRIPTION_MAX as w, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as x, MINDOODB_APP_LISTING_SUMMARY_MAX as y, MINDOODB_APP_SEAL_SIGNING_DOMAIN as z };
+export { type MindooDBAppBridgeDragDropMessage as $, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as A, type MindooDBAppAcceptSpec as B, type MindooDBAppAccessDecision as C, type MindooDBAppAccessTier as D, type MindooDBAppAgentApi as E, type MindooDBAppAgentRegistration as F, type MindooDBAppAgentTool as G, type MindooDBAppAgentToolAnnotations as H, type MindooDBAppAgentToolDescriptor as I, type MindooDBAppAttachmentApi as J, type MindooDBAppAttachmentChunk as K, type MindooDBAppAttachmentInfo as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAttachmentPreviewOptions as N, type MindooDBAppAttachmentPreviewSession as O, type MindooDBAppAutomergeChangesPatch as P, type MindooDBAppAutomergeChangesSince as Q, type MindooDBAppAutomergeGetOptions as R, type MindooDBAppAutomergePatchResult as S, type MindooDBAppAutomergeSnapshot as T, type MindooDBAppBridgeAgentInvokeMessage as U, type MindooDBAppBridgeAgentResultMessage as V, type MindooDBAppBridgeBeforeCloseAck as W, type MindooDBAppBridgeBeforeCloseMessage as X, type MindooDBAppBridgeConnectMessage as Y, type MindooDBAppBridgeConnectOptions as Z, type MindooDBAppBridgeConnectedMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppDefinitionValidation as a$, type MindooDBAppBridgeDragLeaveMessage as a0, type MindooDBAppBridgeDragOverMessage as a1, type MindooDBAppBridgeEmbedEventMessage as a2, type MindooDBAppBridgeEmbeddingRequestMessage as a3, type MindooDBAppBridgeErrorPayload as a4, type MindooDBAppBridgeHandshakeErrorMessage as a5, type MindooDBAppBridgeHostFocusChangedMessage as a6, type MindooDBAppBridgeIncomingContentMessage as a7, type MindooDBAppBridgeLocaleChangedMessage as a8, type MindooDBAppBridgePortMessage as a9, type MindooDBAppComponentQuery as aA, type MindooDBAppComponentSpec as aB, type MindooDBAppComponentsApi as aC, type MindooDBAppConfiguredViewCategorizationStyle as aD, type MindooDBAppConfiguredViewColumn as aE, type MindooDBAppConfiguredViewColumnRole as aF, type MindooDBAppConfiguredViewExpressionMode as aG, type MindooDBAppConfiguredViewFieldExpression as aH, type MindooDBAppConfiguredViewFilterDefinition as aI, type MindooDBAppConfiguredViewFilterMode as aJ, type MindooDBAppConfiguredViewFilterRule as aK, type MindooDBAppConfiguredViewFormulaExpression as aL, type MindooDBAppConfiguredViewFormulaFilterDefinition as aM, type MindooDBAppConfiguredViewPreviewMode as aN, type MindooDBAppConfiguredViewRuleFilterDefinition as aO, type MindooDBAppConfiguredViewRuleMatchMode as aP, type MindooDBAppConfiguredViewRuleOperator as aQ, type MindooDBAppConfiguredViewValueExpression as aR, type MindooDBAppCreateKeyInfo as aS, type MindooDBAppCreateViewInput as aT, type MindooDBAppCreateViewNavigatorInput as aU, type MindooDBAppDatabaseInfo as aV, type MindooDBAppDefinitionDatabase as aW, type MindooDBAppDefinitionListing as aX, type MindooDBAppDefinitionPermission as aY, type MindooDBAppDefinitionRegistrationPermission as aZ, type MindooDBAppDefinitionScreenshot as a_, type MindooDBAppBridgeQueryResultMessage as aa, type MindooDBAppBridgeRpcError as ab, type MindooDBAppBridgeRpcMessage as ac, type MindooDBAppBridgeRpcRequest as ad, type MindooDBAppBridgeRpcSuccess as ae, type MindooDBAppBridgeShortcutInvokedMessage as af, type MindooDBAppBridgeShortcutsChangedMessage as ag, type MindooDBAppBridgeStreamAbortRequest as ah, type MindooDBAppBridgeStreamAck as ai, type MindooDBAppBridgeStreamCloseRequest as aj, type MindooDBAppBridgeStreamError as ak, type MindooDBAppBridgeStreamMessage as al, type MindooDBAppBridgeStreamOpenResult as am, type MindooDBAppBridgeStreamReadRequest as an, type MindooDBAppBridgeStreamWriteRequest as ao, type MindooDBAppBridgeThemeChangedMessage as ap, type MindooDBAppBridgeUiPreferencesChangedMessage as aq, type MindooDBAppBridgeViewChangedMessage as ar, type MindooDBAppBridgeViewportChangedMessage as as, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as at, type MindooDBAppBrowserFeatures as au, type MindooDBAppCapability as av, type MindooDBAppComponentChildren as aw, type MindooDBAppComponentFieldValue as ax, type MindooDBAppComponentInfo as ay, type MindooDBAppComponentIntent as az, type MindooDBAppDragStartInput as b, type MindooDBAppLocalizedText as b$, type MindooDBAppDirectoryApi as b0, type MindooDBAppDirectoryEntry as b1, type MindooDBAppDocumentApi as b2, type MindooDBAppDocumentHeadCursorResult as b3, type MindooDBAppDocumentHistoryEntry as b4, type MindooDBAppDocumentListQuery as b5, type MindooDBAppDocumentListResult as b6, type MindooDBAppDocumentQuery as b7, type MindooDBAppDocumentRevisionId as b8, type MindooDBAppDocumentScanPreset as b9, type MindooDBAppHistoricalDocument as bA, type MindooDBAppHistoryQuery as bB, type MindooDBAppHostTheme as bC, type MindooDBAppIdentityApi as bD, type MindooDBAppInaccessibleDocument as bE, type MindooDBAppInaccessibleDocumentListQuery as bF, type MindooDBAppInaccessibleDocumentListResult as bG, type MindooDBAppIncomingContent as bH, type MindooDBAppIncomingContentHandler as bI, type MindooDBAppIncomingContentInfo as bJ, type MindooDBAppIncomingItem as bK, type MindooDBAppIncomingItemInfo as bL, type MindooDBAppIncomingResult as bM, type MindooDBAppIncomingSource as bN, type MindooDBAppJsonCounterIncrementPatch as bO, type MindooDBAppJsonListDeletePatch as bP, type MindooDBAppJsonListInsertPatch as bQ, type MindooDBAppJsonPatch as bR, type MindooDBAppJsonSetPatch as bS, type MindooDBAppJsonTextMarkPatch as bT, type MindooDBAppJsonTextSplicePatch as bU, type MindooDBAppJsonTextUnmarkPatch as bV, type MindooDBAppJsonUnsetPatch as bW, type MindooDBAppLaunchContext as bX, type MindooDBAppListUsersOptions as bY, type MindooDBAppListUsersPage as bZ, type MindooDBAppLiveQuerySubscription as b_, type MindooDBAppDocumentSummary as ba, type MindooDBAppDragApi as bb, type MindooDBAppDragCancelReason as bc, type MindooDBAppDragDropEvent as bd, type MindooDBAppDragEffect as be, type MindooDBAppDragHoverResult as bf, type MindooDBAppDragOffer as bg, type MindooDBAppDragOverEvent as bh, type MindooDBAppDragPointer as bi, type MindooDBAppDragProfile as bj, type MindooDBAppEmbed as bk, type MindooDBAppEmbedCloseReason as bl, type MindooDBAppEmbedClosedEvent as bm, type MindooDBAppEmbedContext as bn, type MindooDBAppEmbedDirtyEvent as bo, type MindooDBAppEmbedOpenInput as bp, type MindooDBAppEmbedRect as bq, type MindooDBAppEmbeddingApi as br, type MindooDBAppEmbedsApi as bs, type MindooDBAppEntryAttachmentRef as bt, type MindooDBAppEntryProvenance as bu, type MindooDBAppExtractDocumentTextInput as bv, type MindooDBAppExtractDocumentTextResult as bw, type MindooDBAppExtractTextFormat as bx, type MindooDBAppExtractionSetup as by, type MindooDBAppFulltextSetup as bz, type MindooDBAppDragStartResult as c, type MindooDBAppTextCursorPositionsResult as c$, type MindooDBAppMenuAnchor as c0, type MindooDBAppMenuApi as c1, type MindooDBAppMenuCommandItem as c2, type MindooDBAppMenuDismissReason as c3, type MindooDBAppMenuDismissedResult as c4, type MindooDBAppMenuItem as c5, type MindooDBAppMenuKind as c6, type MindooDBAppMenuPlacement as c7, type MindooDBAppMenuPointAnchor as c8, type MindooDBAppMenuRect as c9, type MindooDBAppRichTextMaterializeValue as cA, type MindooDBAppRichTextPatch as cB, type MindooDBAppRichTextScalar as cC, type MindooDBAppRichTextSpliceStep as cD, type MindooDBAppRichTextStep as cE, type MindooDBAppRichTextStepPatch as cF, type MindooDBAppRichTextTextSpan as cG, type MindooDBAppRuntime as cH, type MindooDBAppScanAttachmentOptions as cI, type MindooDBAppScanAttachmentResult as cJ, type MindooDBAppScopedDocId as cK, type MindooDBAppScopedDocumentSummary as cL, type MindooDBAppSealIntent as cM, type MindooDBAppSealedChannelOpenInput as cN, type MindooDBAppSealedChannelOpenResult as cO, type MindooDBAppSealedChannelRequestInput as cP, type MindooDBAppSession as cQ, type MindooDBAppShowMenuInput as cR, type MindooDBAppShowMenuResult as cS, type MindooDBAppSignPreview as cT, type MindooDBAppSignPreviewScope as cU, type MindooDBAppSignStatementInput as cV, type MindooDBAppSignStatementResult as cW, type MindooDBAppStorageApi as cX, type MindooDBAppSummarySetup as cY, type MindooDBAppTextCursorOptions as cZ, type MindooDBAppTextCursorPosition as c_, type MindooDBAppMenuRectAnchor as ca, type MindooDBAppMenuSelectionResult as cb, type MindooDBAppMenuSeparatorItem as cc, type MindooDBAppNotificationSeverity as cd, type MindooDBAppNotifyInput as ce, type MindooDBAppNotifyResult as cf, type MindooDBAppProposeAppInput as cg, type MindooDBAppProposeAppResult as ch, type MindooDBAppQueryCoverage as ci, type MindooDBAppQueryInclude as cj, type MindooDBAppQueryIncludeCardinality as ck, type MindooDBAppQueryIncludeSlots as cl, type MindooDBAppQueryResult as cm, type MindooDBAppQueryRow as cn, type MindooDBAppQuerySortKey as co, type MindooDBAppQueryTextClause as cp, type MindooDBAppReadableAttachmentStream as cq, type MindooDBAppRecipientOptions as cr, type MindooDBAppResolvedViewDefinition as cs, type MindooDBAppResolvedViewSource as ct, type MindooDBAppRevisionPhase as cu, type MindooDBAppRevisionVerification as cv, type MindooDBAppRichTextBlockSpan as cw, type MindooDBAppRichTextGetOptions as cx, type MindooDBAppRichTextImmutableString as cy, type MindooDBAppRichTextMarkRange as cz, type MindooDBAppDragPreview as d, type MindooDBAppTextCursorsResult as d0, type MindooDBAppTextEdit as d1, type MindooDBAppTextPatch as d2, type MindooDBAppThemeMode as d3, type MindooDBAppTimestampApi as d4, type MindooDBAppTimestampInput as d5, type MindooDBAppTimestampProvider as d6, type MindooDBAppTimestampResult as d7, type MindooDBAppUiPreferences as d8, type MindooDBAppUpdateDocumentInput as d9, type MindooDBAppViewCursorDocumentListResult as da, type MindooDBAppViewCursorResult as db, type MindooDBAppViewEntry as dc, type MindooDBAppViewEntryKind as dd, type MindooDBAppViewNavigator as de, type MindooDBAppViewNavigatorExpansionState as df, type MindooDBAppViewNavigatorOpenOptions as dg, type MindooDBAppViewNavigatorPageOptions as dh, type MindooDBAppViewNavigatorPageResult as di, type MindooDBAppViewNavigatorRangeQuery as dj, type MindooDBAppViewNavigatorSelectionState as dk, type MindooDBAppViewUpdateStats as dl, type MindooDBAppViewport as dm, type MindooDBAppWellKnownDragType as dn, type MindooDBAppWritableAttachmentStream as dp, mindooDBAppAcceptMatchesType as dq, mindooDBAppComponentFieldsMatch as dr, resolveMindooDBAppDefinitionUrl as ds, resolveMindooDBAppListingAssetUrl as dt, resolveMindooDBAppLocalizedText as du, validateMindooDBAppAccepts as dv, validateMindooDBAppComponents as dw, validateMindooDBAppDefinition as dx, type MindooDBAppBridge as e, type MindooDBAppAgentToolErrorCode as f, type MindooDBAppHostShortcutBinding as g, type MindooDBAppHostShortcutAction as h, type MindooDBAppHostingMode as i, type MindooDBAppDefinition as j, type MindooDBAppDatabase as k, type MindooDBAppDocument as l, type MindooDBAppRichTextSpan as m, type MindooDBAppRichTextSnapshot as n, type MindooDBAppCreateDocumentInput as o, MINDOODB_APP_ACCEPTS_MAX as p, MINDOODB_APP_COMPONENTS_MAX as q, MINDOODB_APP_DEFINITION_FILE_NAME as r, MINDOODB_APP_DEFINITION_FORMAT as s, MINDOODB_APP_DEFINITION_PERMISSIONS as t, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as u, MINDOODB_APP_DEFINITION_VERSION as v, MINDOODB_APP_LISTING_DESCRIPTION_MAX as w, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as x, MINDOODB_APP_LISTING_SUMMARY_MAX as y, MINDOODB_APP_SEAL_SIGNING_DOMAIN as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.60",
+  "version": "0.0.62",
   "engines": {
     "node": ">=22.13.0"
   },