mindoodb-app-sdk 0.0.10 → 0.0.11

package/README.md

@@ -107,10 +107,31 @@ session.onViewportChange((viewport) => {
 const db = await session.openDatabase(ctx.databases[0]!.id);
 const result = await db.documents.list({ limit: 25 });
 console.log("Documents:", result.items);
+
+// 5. Open a Haven-configured view
+//
+// A "view" is a pre-built, categorized query that a Haven administrator
+// attaches to your app (think: a pivot table over one or more databases).
+// `ctx.views` is the list of views that were made available at launch time.
+// `openViewNavigator()` returns a stateful "cursor" over the view's rows
+// that you can page through and navigate entry by entry.
+if (ctx.views[0]) {
+  const viewNav = await session.openViewNavigator(ctx.views[0].id);
+
+  // Move the cursor to the first row and read a batch of visible entries.
+  await viewNav.gotoFirst();
+  const page = await viewNav.entriesForward({ limit: 50 });
+  console.log("View rows:", page.entries);
+
+  // Always dispose when you are done -- this frees the host-side navigator.
+  await viewNav.dispose();
+}
 ```
 
 When Haven launches your app it injects a `mindoodbAppLaunchId` query parameter into the URL. `connect()` reads it automatically -- no manual wiring needed.
 
+> New to views? They are optional. If your app only needs raw document access you can stop at step 4. The full navigator API (paging, category expand/collapse, selection, child lookups, dynamic app-defined views via `session.createViewNavigator()`) is documented in the [Virtual Views](#virtual-views) section below, and the [`mindoodb-app-example`](https://github.com/klehmann/mindoodb-app-example) repo shows an end-to-end UI built on top of it.
+
 ## Core concepts
 
 ### Launch context
@@ -443,12 +464,13 @@ Haven includes a **built-in file viewer** that your app can open for common atta
 |---|---|
 | `image` | All common image formats (JPEG, PNG, GIF, WebP, SVG, ...) |
 | `pdf` | PDF documents |
-| `text` | Plain text, Markdown, CSV, JSON, XML, YAML, SVG, log files |
+| `markdown` | Markdown rendered to HTML (.md, .markdown, .mdown, .mkd, .mkdn) |
+| `text` | Plain text, CSV, JSON, XML, YAML, SVG, log files |
 | `docx` | Microsoft Word (.docx) |
 | `pptx` | Microsoft PowerPoint (.pptx) |
 | `spreadsheet` | Microsoft Excel (.xls, .xlsx, .xlsm, .xlsb) |
-| `video` | Video files with embedded player (streaming + seek support) |
-| `audio` | Audio files with embedded player (streaming + seek support) |
+| `video` | Video files with embedded player, streaming + seek (.mp4, .m4v, .webm, .ogv, .ogg, plus any `video/*`) |
+| `audio` | Audio files with embedded player, streaming + seek (.mp3, .m4a, .wav, .aac, .oga, plus any `audio/*`) |
 
 **Open the Haven preview dialog:**
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge } from './types-Bh1Q2qGN.js';
-export { b as MindooDBAppAttachmentApi, c as MindooDBAppAttachmentChunk, d as MindooDBAppAttachmentInfo, e as MindooDBAppAttachmentPreviewOptions, f as MindooDBAppAttachmentPreviewSession, g as MindooDBAppBridgeConnectMessage, h as MindooDBAppBridgeConnectOptions, i as MindooDBAppBridgeConnectedMessage, j as MindooDBAppBridgeErrorPayload, k as MindooDBAppBridgePortMessage, l as MindooDBAppBridgeRpcError, m as MindooDBAppBridgeRpcMessage, n as MindooDBAppBridgeRpcRequest, o as MindooDBAppBridgeRpcSuccess, p as MindooDBAppBridgeStreamAbortRequest, q as MindooDBAppBridgeStreamAck, r as MindooDBAppBridgeStreamCloseRequest, s as MindooDBAppBridgeStreamError, t as MindooDBAppBridgeStreamMessage, u as MindooDBAppBridgeStreamOpenResult, v as MindooDBAppBridgeStreamReadRequest, w as MindooDBAppBridgeStreamWriteRequest, x as MindooDBAppBridgeThemeChangedMessage, y as MindooDBAppBridgeViewportChangedMessage, z as MindooDBAppCapability, A as MindooDBAppConfiguredViewCategorizationStyle, B as MindooDBAppConfiguredViewColumn, C as MindooDBAppConfiguredViewColumnRole, D as MindooDBAppConfiguredViewExpressionMode, E as MindooDBAppConfiguredViewFieldExpression, F as MindooDBAppConfiguredViewFilterDefinition, G as MindooDBAppConfiguredViewFilterMode, H as MindooDBAppConfiguredViewFilterRule, I as MindooDBAppConfiguredViewFormulaExpression, J as MindooDBAppConfiguredViewFormulaFilterDefinition, K as MindooDBAppConfiguredViewPreviewMode, L as MindooDBAppConfiguredViewRuleFilterDefinition, N as MindooDBAppConfiguredViewRuleMatchMode, O as MindooDBAppConfiguredViewRuleOperator, P as MindooDBAppConfiguredViewValueExpression, Q as MindooDBAppCreateDocumentInput, R as MindooDBAppCreateViewInput, S as MindooDBAppCreateViewNavigatorInput, T as MindooDBAppDatabase, U as MindooDBAppDatabaseInfo, V as MindooDBAppDocument, W as MindooDBAppDocumentApi, X as MindooDBAppDocumentHistoryEntry, Y as MindooDBAppDocumentListQuery, Z as MindooDBAppDocumentListResult, _ as MindooDBAppDocumentSummary, $ as MindooDBAppHistoricalDocument, a0 as MindooDBAppHistoryQuery, a1 as MindooDBAppHostTheme, a2 as MindooDBAppLaunchContext, a3 as MindooDBAppMenuAnchor, a4 as MindooDBAppMenuApi, a5 as MindooDBAppMenuCommandItem, a6 as MindooDBAppMenuDismissReason, a7 as MindooDBAppMenuDismissedResult, a8 as MindooDBAppMenuItem, a9 as MindooDBAppMenuKind, aa as MindooDBAppMenuPlacement, ab as MindooDBAppMenuPointAnchor, ac as MindooDBAppMenuRect, ad as MindooDBAppMenuRectAnchor, ae as MindooDBAppMenuSelectionResult, af as MindooDBAppMenuSeparatorItem, ag as MindooDBAppReadableAttachmentStream, ah as MindooDBAppResolvedViewDefinition, ai as MindooDBAppResolvedViewSource, aj as MindooDBAppRuntime, ak as MindooDBAppScopedDocId, al as MindooDBAppSession, am as MindooDBAppShowMenuInput, an as MindooDBAppShowMenuResult, ao as MindooDBAppThemeMode, ap as MindooDBAppUpdateDocumentInput, aq as MindooDBAppViewEntry, ar as MindooDBAppViewEntryKind, as as MindooDBAppViewNavigator, at as MindooDBAppViewNavigatorExpansionState, au as MindooDBAppViewNavigatorOpenOptions, av as MindooDBAppViewNavigatorPageOptions, aw as MindooDBAppViewNavigatorPageResult, ax as MindooDBAppViewNavigatorRangeQuery, ay as MindooDBAppViewNavigatorSelectionState, az as MindooDBAppViewport, aA as MindooDBAppWritableAttachmentStream } from './types-Bh1Q2qGN.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppBridge } from './types-vleeW9E5.js';
+export { b as MindooDBAppAttachmentApi, c as MindooDBAppAttachmentChunk, d as MindooDBAppAttachmentInfo, e as MindooDBAppAttachmentPreviewOptions, f as MindooDBAppAttachmentPreviewSession, g as MindooDBAppBridgeConnectMessage, h as MindooDBAppBridgeConnectOptions, i as MindooDBAppBridgeConnectedMessage, j as MindooDBAppBridgeErrorPayload, k as MindooDBAppBridgePortMessage, l as MindooDBAppBridgeRpcError, m as MindooDBAppBridgeRpcMessage, n as MindooDBAppBridgeRpcRequest, o as MindooDBAppBridgeRpcSuccess, p as MindooDBAppBridgeStreamAbortRequest, q as MindooDBAppBridgeStreamAck, r as MindooDBAppBridgeStreamCloseRequest, s as MindooDBAppBridgeStreamError, t as MindooDBAppBridgeStreamMessage, u as MindooDBAppBridgeStreamOpenResult, v as MindooDBAppBridgeStreamReadRequest, w as MindooDBAppBridgeStreamWriteRequest, x as MindooDBAppBridgeThemeChangedMessage, y as MindooDBAppBridgeUiPreferencesChangedMessage, z as MindooDBAppBridgeViewportChangedMessage, A as MindooDBAppCapability, B as MindooDBAppConfiguredViewCategorizationStyle, C as MindooDBAppConfiguredViewColumn, D as MindooDBAppConfiguredViewColumnRole, E as MindooDBAppConfiguredViewExpressionMode, F as MindooDBAppConfiguredViewFieldExpression, G as MindooDBAppConfiguredViewFilterDefinition, H as MindooDBAppConfiguredViewFilterMode, I as MindooDBAppConfiguredViewFilterRule, J as MindooDBAppConfiguredViewFormulaExpression, K as MindooDBAppConfiguredViewFormulaFilterDefinition, L as MindooDBAppConfiguredViewPreviewMode, N as MindooDBAppConfiguredViewRuleFilterDefinition, O as MindooDBAppConfiguredViewRuleMatchMode, P as MindooDBAppConfiguredViewRuleOperator, Q as MindooDBAppConfiguredViewValueExpression, R as MindooDBAppCreateDocumentInput, S as MindooDBAppCreateViewInput, T as MindooDBAppCreateViewNavigatorInput, U as MindooDBAppDatabase, V as MindooDBAppDatabaseInfo, W as MindooDBAppDocument, X as MindooDBAppDocumentApi, Y as MindooDBAppDocumentHistoryEntry, Z as MindooDBAppDocumentListQuery, _ as MindooDBAppDocumentListResult, $ as MindooDBAppDocumentSummary, a0 as MindooDBAppHistoricalDocument, a1 as MindooDBAppHistoryQuery, a2 as MindooDBAppHostTheme, a3 as MindooDBAppLaunchContext, a4 as MindooDBAppMenuAnchor, a5 as MindooDBAppMenuApi, a6 as MindooDBAppMenuCommandItem, a7 as MindooDBAppMenuDismissReason, a8 as MindooDBAppMenuDismissedResult, a9 as MindooDBAppMenuItem, aa as MindooDBAppMenuKind, ab as MindooDBAppMenuPlacement, ac as MindooDBAppMenuPointAnchor, ad as MindooDBAppMenuRect, ae as MindooDBAppMenuRectAnchor, af as MindooDBAppMenuSelectionResult, ag as MindooDBAppMenuSeparatorItem, ah as MindooDBAppReadableAttachmentStream, ai as MindooDBAppResolvedViewDefinition, aj as MindooDBAppResolvedViewSource, ak as MindooDBAppRuntime, al as MindooDBAppScopedDocId, am as MindooDBAppSession, an as MindooDBAppShowMenuInput, ao as MindooDBAppShowMenuResult, ap as MindooDBAppThemeMode, aq as MindooDBAppUiPreferences, ar as MindooDBAppUpdateDocumentInput, as as MindooDBAppViewEntry, at as MindooDBAppViewEntryKind, au as MindooDBAppViewNavigator, av as MindooDBAppViewNavigatorExpansionState, aw as MindooDBAppViewNavigatorOpenOptions, ax as MindooDBAppViewNavigatorPageOptions, ay as MindooDBAppViewNavigatorPageResult, az as MindooDBAppViewNavigatorRangeQuery, aA as MindooDBAppViewNavigatorSelectionState, aB as MindooDBAppViewport, aC as MindooDBAppWritableAttachmentStream } from './types-vleeW9E5.js';
 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

@@ -2,6 +2,9 @@
 function canPreviewAttachment(fileName, mimeType) {
   const normalizedMimeType = mimeType.toLowerCase();
   const normalizedFileName = fileName.toLowerCase();
+  if (normalizedMimeType === "text/markdown" || normalizedMimeType === "text/x-markdown" || normalizedMimeType === "application/markdown" || normalizedMimeType === "application/x-markdown" || normalizedFileName.endsWith(".md") || normalizedFileName.endsWith(".markdown") || normalizedFileName.endsWith(".mdown") || normalizedFileName.endsWith(".mkd") || normalizedFileName.endsWith(".mkdn")) {
+    return "markdown";
+  }
   if (normalizedMimeType.startsWith("image/")) {
     return "image";
   }
@@ -11,6 +14,12 @@ function canPreviewAttachment(fileName, mimeType) {
   if (normalizedMimeType.startsWith("audio/")) {
     return "audio";
   }
+  if (normalizedFileName.endsWith(".mp4") || normalizedFileName.endsWith(".m4v") || normalizedFileName.endsWith(".webm") || normalizedFileName.endsWith(".ogv") || normalizedFileName.endsWith(".ogg")) {
+    return "video";
+  }
+  if (normalizedFileName.endsWith(".m4a") || normalizedFileName.endsWith(".mp3") || normalizedFileName.endsWith(".wav") || normalizedFileName.endsWith(".aac") || normalizedFileName.endsWith(".oga")) {
+    return "audio";
+  }
   if (normalizedMimeType === "application/pdf" || normalizedFileName.endsWith(".pdf")) {
     return "pdf";
   }
@@ -23,7 +32,7 @@ function canPreviewAttachment(fileName, mimeType) {
   if (normalizedMimeType === "application/vnd.openxmlformats-officedocument.presentationml.presentation" || normalizedFileName.endsWith(".pptx")) {
     return "pptx";
   }
-  if (normalizedMimeType.startsWith("text/") || normalizedMimeType === "application/json" || normalizedMimeType === "application/xml" || normalizedMimeType === "image/svg+xml" || normalizedFileName.endsWith(".json") || normalizedFileName.endsWith(".txt") || normalizedFileName.endsWith(".md") || normalizedFileName.endsWith(".csv") || normalizedFileName.endsWith(".log") || normalizedFileName.endsWith(".xml") || normalizedFileName.endsWith(".yaml") || normalizedFileName.endsWith(".yml") || normalizedFileName.endsWith(".svg")) {
+  if (normalizedMimeType.startsWith("text/") || normalizedMimeType === "application/json" || normalizedMimeType === "application/xml" || normalizedMimeType === "image/svg+xml" || normalizedFileName.endsWith(".json") || normalizedFileName.endsWith(".txt") || normalizedFileName.endsWith(".csv") || normalizedFileName.endsWith(".log") || normalizedFileName.endsWith(".xml") || normalizedFileName.endsWith(".yaml") || normalizedFileName.endsWith(".yml") || normalizedFileName.endsWith(".svg")) {
     return "text";
   }
   return null;
@@ -240,6 +249,9 @@ function isThemeChangedMessage(message) {
 function isViewportChangedMessage(message) {
   return message.kind === "viewport-changed";
 }
+function isUiPreferencesChangedMessage(message) {
+  return message.kind === "ui-preferences-changed";
+}
 function toStreamError(message) {
   const error = new Error(message.error.message);
   error.name = message.error.code || "MindooDBAppBridgeStreamError";
@@ -765,6 +777,14 @@ var MindooDBAppSessionImpl = class {
       }
     });
   }
+  /** Subscribe to host-pushed embedded UI preference changes. */
+  onUiPreferencesChange(listener) {
+    return this.rpc.addMessageListener((message) => {
+      if (isUiPreferencesChangedMessage(message)) {
+        listener(message.uiPreferences);
+      }
+    });
+  }
   /** Disconnects from the host and always disposes the underlying port client. */
   async disconnect() {
     try {

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { a2 as MindooDBAppLaunchContext, U as MindooDBAppDatabaseInfo, W as MindooDBAppDocumentApi, S as MindooDBAppCreateViewNavigatorInput, as as MindooDBAppViewNavigator, au as MindooDBAppViewNavigatorOpenOptions, b as MindooDBAppAttachmentApi, a as MindooDBAppBridge, al as MindooDBAppSession, n as MindooDBAppBridgeRpcRequest, a1 as MindooDBAppHostTheme, az as MindooDBAppViewport, k as MindooDBAppBridgePortMessage } from '../types-Bh1Q2qGN.js';
+import { a3 as MindooDBAppLaunchContext, V as MindooDBAppDatabaseInfo, X as MindooDBAppDocumentApi, T as MindooDBAppCreateViewNavigatorInput, au as MindooDBAppViewNavigator, aw as MindooDBAppViewNavigatorOpenOptions, b as MindooDBAppAttachmentApi, a as MindooDBAppBridge, am as MindooDBAppSession, n as MindooDBAppBridgeRpcRequest, a2 as MindooDBAppHostTheme, aB as MindooDBAppViewport, aq as MindooDBAppUiPreferences, k as MindooDBAppBridgePortMessage } from '../types-vleeW9E5.js';
 import 'mindoodb-view-language';
 
 type MaybePromise<T> = T | Promise<T>;
@@ -29,6 +29,7 @@ interface MockMindooDBAppSessionController {
     setDatabases(definitions: MockMindooDBAppDatabaseDefinition[]): void;
     emitThemeChange(theme: MindooDBAppHostTheme): void;
     emitViewportChange(viewport: MindooDBAppViewport): void;
+    emitUiPreferencesChange(uiPreferences: MindooDBAppUiPreferences): void;
 }
 declare function createMockMindooDBAppSession(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;
 declare function createMockMindooDBAppBridge(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;
@@ -55,6 +56,7 @@ interface FakeBridgeHostController {
     dispose(): void;
     emitThemeChange(theme: MindooDBAppHostTheme): void;
     emitViewportChange(viewport: MindooDBAppViewport): void;
+    emitUiPreferencesChange(uiPreferences: MindooDBAppUiPreferences): void;
     postPortMessage(message: MindooDBAppBridgePortMessage, transfer?: Transferable[]): void;
     setRequestHandler(method: string, handler: FakeBridgeRequestHandler): void;
     clearRequestHandler(method: string): void;

package/dist/testing/index.js

@@ -18,6 +18,7 @@ function mergeLaunchContext(current, patch) {
       ...current,
       theme: { ...current.theme },
       viewport: current.viewport ? { ...current.viewport } : null,
+      uiPreferences: { ...current.uiPreferences },
       user: { ...current.user },
       launchParameters: { ...current.launchParameters },
       databases: current.databases.map((database) => ({
@@ -47,6 +48,7 @@ function mergeLaunchContext(current, patch) {
     ...patch,
     theme: patch.theme ? { ...current.theme, ...patch.theme } : { ...current.theme },
     viewport: patch.viewport === void 0 ? current.viewport ? { ...current.viewport } : null : patch.viewport ? { ...patch.viewport } : null,
+    uiPreferences: patch.uiPreferences ? { ...current.uiPreferences, ...patch.uiPreferences } : { ...current.uiPreferences },
     user: patch.user ? { ...current.user, ...patch.user } : { ...current.user },
     launchParameters: patch.launchParameters ? { ...current.launchParameters, ...patch.launchParameters } : { ...current.launchParameters },
     databases: patch.databases ? patch.databases.map((database) => ({
@@ -104,6 +106,9 @@ function createDefaultLaunchContext(patch) {
       width: 1024,
       height: 768
     },
+    uiPreferences: {
+      iosMultitaskingOptimized: false
+    },
     user: {
       id: "user-1",
       username: "Test User"
@@ -526,6 +531,7 @@ function createMockSessionState(options = {}) {
   let launchContext = createDefaultLaunchContext(options.launchContext);
   const themeListeners = /* @__PURE__ */ new Set();
   const viewportListeners = /* @__PURE__ */ new Set();
+  const uiPreferencesListeners = /* @__PURE__ */ new Set();
   const databaseHandles = /* @__PURE__ */ new Map();
   const databaseViewApis = /* @__PURE__ */ new Map();
   const sessionViews = /* @__PURE__ */ new Map();
@@ -634,6 +640,12 @@ function createMockSessionState(options = {}) {
         viewportListeners.delete(listener);
       };
     },
+    onUiPreferencesChange(listener) {
+      uiPreferencesListeners.add(listener);
+      return () => {
+        uiPreferencesListeners.delete(listener);
+      };
+    },
     async disconnect() {
       await options.onDisconnect?.();
     }
@@ -676,6 +688,10 @@ function createMockSessionState(options = {}) {
     emitViewportChange(viewport) {
       launchContext = mergeLaunchContext(launchContext, { viewport });
       viewportListeners.forEach((listener) => listener({ ...viewport }));
+    },
+    emitUiPreferencesChange(uiPreferences) {
+      launchContext = mergeLaunchContext(launchContext, { uiPreferences });
+      uiPreferencesListeners.forEach((listener) => listener({ ...launchContext.uiPreferences }));
     }
   };
 }
@@ -689,7 +705,8 @@ function createMockMindooDBAppSession(options = {}) {
     listDatabases: state.listDatabaseInfos,
     setDatabases: state.setDatabases,
     emitThemeChange: state.emitThemeChange,
-    emitViewportChange: state.emitViewportChange
+    emitViewportChange: state.emitViewportChange,
+    emitUiPreferencesChange: state.emitUiPreferencesChange
   };
 }
 function createMockMindooDBAppBridge(options = {}) {
@@ -1198,6 +1215,15 @@ function createFakeBridgeHost(options = {}) {
       };
       connectedPorts.forEach((port) => port.postMessage(payload));
     },
+    emitUiPreferencesChange(uiPreferences) {
+      state.emitUiPreferencesChange(uiPreferences);
+      const payload = {
+        protocol: PROTOCOL,
+        kind: "ui-preferences-changed",
+        uiPreferences
+      };
+      connectedPorts.forEach((port) => port.postMessage(payload));
+    },
     postPortMessage(message, transfer = []) {
       connectedPorts.forEach((port) => port.postMessage(message, transfer));
     },

package/dist/{types-Bh1Q2qGN.d.ts → types-vleeW9E5.d.ts}

@@ -14,6 +14,10 @@ interface MindooDBAppViewport {
     width: number;
     height: number;
 }
+/** Host-controlled UI preferences exposed to embedded apps. */
+interface MindooDBAppUiPreferences {
+    iosMultitaskingOptimized: boolean;
+}
 /** Saved categorization mode for Haven-managed view mappings delivered at launch time. */
 type MindooDBAppConfiguredViewCategorizationStyle = "document_then_category" | "category_then_document";
 /** Preferred preview layout for a Haven-managed view mapping. */
@@ -93,7 +97,7 @@ interface MindooDBAppResolvedViewDefinition {
 }
 /** Permission/capability flags exposed for a database binding inside the app session. */
 type MindooDBAppCapability = "read" | "create" | "update" | "delete" | "history" | "attachments" | "views";
-/** Metadata about the current app launch supplied by the Administrator host. */
+/** Metadata about the current app launch supplied by the Haven host. */
 interface MindooDBAppLaunchContext {
     appId: string;
     appInstanceId: string;
@@ -102,6 +106,7 @@ interface MindooDBAppLaunchContext {
     runtime: MindooDBAppRuntime;
     theme: MindooDBAppHostTheme;
     viewport: MindooDBAppViewport | null;
+    uiPreferences: MindooDBAppUiPreferences;
     tenantId?: string;
     preferredDatabaseId?: string;
     user: {
@@ -120,7 +125,7 @@ interface MindooDBAppAttachmentInfo {
     size: number;
 }
 /** Preview modes supported by the Haven-hosted attachment preview dialog. */
-type MindooDBAppAttachmentPreviewMode = "image" | "pdf" | "text" | "docx" | "pptx" | "spreadsheet" | "video" | "audio";
+type MindooDBAppAttachmentPreviewMode = "image" | "pdf" | "text" | "markdown" | "docx" | "pptx" | "spreadsheet" | "video" | "audio";
 /** Optional parameters for opening an attachment preview in Haven. */
 interface MindooDBAppAttachmentPreviewOptions {
     /** Historical snapshot timestamp previously obtained from `documents.history.getAtTimestamp()`. */
@@ -311,8 +316,14 @@ interface MindooDBAppBridgeViewportChangedMessage {
     kind: "viewport-changed";
     viewport: MindooDBAppViewport;
 }
+/** Host-pushed event emitted when host-controlled UI preferences change. */
+interface MindooDBAppBridgeUiPreferencesChangedMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "ui-preferences-changed";
+    uiPreferences: MindooDBAppUiPreferences;
+}
 /** Any message that can travel across the dedicated bridge MessagePort. */
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage;
+type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage;
 /** 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. */
@@ -552,6 +563,7 @@ interface MindooDBAppSession {
     menus: MindooDBAppMenuApi;
     onThemeChange(listener: (theme: MindooDBAppHostTheme) => void): () => void;
     onViewportChange(listener: (viewport: MindooDBAppViewport) => void): () => void;
+    onUiPreferencesChange(listener: (uiPreferences: MindooDBAppUiPreferences) => void): () => void;
     disconnect(): Promise<void>;
 }
 /** Root SDK bridge object used to establish a session. */
@@ -559,4 +571,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export type { MindooDBAppHistoricalDocument as $, MindooDBAppConfiguredViewCategorizationStyle as A, MindooDBAppConfiguredViewColumn as B, MindooDBAppConfiguredViewColumnRole as C, MindooDBAppConfiguredViewExpressionMode as D, MindooDBAppConfiguredViewFieldExpression as E, MindooDBAppConfiguredViewFilterDefinition as F, MindooDBAppConfiguredViewFilterMode as G, MindooDBAppConfiguredViewFilterRule as H, MindooDBAppConfiguredViewFormulaExpression as I, MindooDBAppConfiguredViewFormulaFilterDefinition as J, MindooDBAppConfiguredViewPreviewMode as K, MindooDBAppConfiguredViewRuleFilterDefinition as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewRuleMatchMode as N, MindooDBAppConfiguredViewRuleOperator as O, MindooDBAppConfiguredViewValueExpression as P, MindooDBAppCreateDocumentInput as Q, MindooDBAppCreateViewInput as R, MindooDBAppCreateViewNavigatorInput as S, MindooDBAppDatabase as T, MindooDBAppDatabaseInfo as U, MindooDBAppDocument as V, MindooDBAppDocumentApi as W, MindooDBAppDocumentHistoryEntry as X, MindooDBAppDocumentListQuery as Y, MindooDBAppDocumentListResult as Z, MindooDBAppDocumentSummary as _, MindooDBAppBridge as a, MindooDBAppHistoryQuery as a0, MindooDBAppHostTheme as a1, MindooDBAppLaunchContext as a2, MindooDBAppMenuAnchor as a3, MindooDBAppMenuApi as a4, MindooDBAppMenuCommandItem as a5, MindooDBAppMenuDismissReason as a6, MindooDBAppMenuDismissedResult as a7, MindooDBAppMenuItem as a8, MindooDBAppMenuKind as a9, MindooDBAppWritableAttachmentStream as aA, MindooDBAppMenuPlacement as aa, MindooDBAppMenuPointAnchor as ab, MindooDBAppMenuRect as ac, MindooDBAppMenuRectAnchor as ad, MindooDBAppMenuSelectionResult as ae, MindooDBAppMenuSeparatorItem as af, MindooDBAppReadableAttachmentStream as ag, MindooDBAppResolvedViewDefinition as ah, MindooDBAppResolvedViewSource as ai, MindooDBAppRuntime as aj, MindooDBAppScopedDocId as ak, MindooDBAppSession as al, MindooDBAppShowMenuInput as am, MindooDBAppShowMenuResult as an, MindooDBAppThemeMode as ao, MindooDBAppUpdateDocumentInput as ap, MindooDBAppViewEntry as aq, MindooDBAppViewEntryKind as ar, MindooDBAppViewNavigator as as, MindooDBAppViewNavigatorExpansionState as at, MindooDBAppViewNavigatorOpenOptions as au, MindooDBAppViewNavigatorPageOptions as av, MindooDBAppViewNavigatorPageResult as aw, MindooDBAppViewNavigatorRangeQuery as ax, MindooDBAppViewNavigatorSelectionState as ay, MindooDBAppViewport as az, MindooDBAppAttachmentApi as b, MindooDBAppAttachmentChunk as c, MindooDBAppAttachmentInfo as d, MindooDBAppAttachmentPreviewOptions as e, MindooDBAppAttachmentPreviewSession as f, MindooDBAppBridgeConnectMessage as g, MindooDBAppBridgeConnectOptions as h, MindooDBAppBridgeConnectedMessage as i, MindooDBAppBridgeErrorPayload as j, MindooDBAppBridgePortMessage as k, MindooDBAppBridgeRpcError as l, MindooDBAppBridgeRpcMessage as m, MindooDBAppBridgeRpcRequest as n, MindooDBAppBridgeRpcSuccess as o, MindooDBAppBridgeStreamAbortRequest as p, MindooDBAppBridgeStreamAck as q, MindooDBAppBridgeStreamCloseRequest as r, MindooDBAppBridgeStreamError as s, MindooDBAppBridgeStreamMessage as t, MindooDBAppBridgeStreamOpenResult as u, MindooDBAppBridgeStreamReadRequest as v, MindooDBAppBridgeStreamWriteRequest as w, MindooDBAppBridgeThemeChangedMessage as x, MindooDBAppBridgeViewportChangedMessage as y, MindooDBAppCapability as z };
+export type { MindooDBAppDocumentSummary as $, MindooDBAppCapability as A, MindooDBAppConfiguredViewCategorizationStyle as B, MindooDBAppConfiguredViewColumn as C, MindooDBAppConfiguredViewColumnRole as D, MindooDBAppConfiguredViewExpressionMode as E, MindooDBAppConfiguredViewFieldExpression as F, MindooDBAppConfiguredViewFilterDefinition as G, MindooDBAppConfiguredViewFilterMode as H, MindooDBAppConfiguredViewFilterRule as I, MindooDBAppConfiguredViewFormulaExpression as J, MindooDBAppConfiguredViewFormulaFilterDefinition as K, MindooDBAppConfiguredViewPreviewMode as L, MindooDBAppAttachmentPreviewMode as M, MindooDBAppConfiguredViewRuleFilterDefinition as N, MindooDBAppConfiguredViewRuleMatchMode as O, MindooDBAppConfiguredViewRuleOperator as P, MindooDBAppConfiguredViewValueExpression as Q, MindooDBAppCreateDocumentInput as R, MindooDBAppCreateViewInput as S, MindooDBAppCreateViewNavigatorInput as T, MindooDBAppDatabase as U, MindooDBAppDatabaseInfo as V, MindooDBAppDocument as W, MindooDBAppDocumentApi as X, MindooDBAppDocumentHistoryEntry as Y, MindooDBAppDocumentListQuery as Z, MindooDBAppDocumentListResult as _, MindooDBAppBridge as a, MindooDBAppHistoricalDocument as a0, MindooDBAppHistoryQuery as a1, MindooDBAppHostTheme as a2, MindooDBAppLaunchContext as a3, MindooDBAppMenuAnchor as a4, MindooDBAppMenuApi as a5, MindooDBAppMenuCommandItem as a6, MindooDBAppMenuDismissReason as a7, MindooDBAppMenuDismissedResult as a8, MindooDBAppMenuItem as a9, MindooDBAppViewNavigatorSelectionState as aA, MindooDBAppViewport as aB, MindooDBAppWritableAttachmentStream as aC, MindooDBAppMenuKind as aa, MindooDBAppMenuPlacement as ab, MindooDBAppMenuPointAnchor as ac, MindooDBAppMenuRect as ad, MindooDBAppMenuRectAnchor as ae, MindooDBAppMenuSelectionResult as af, MindooDBAppMenuSeparatorItem as ag, MindooDBAppReadableAttachmentStream as ah, MindooDBAppResolvedViewDefinition as ai, MindooDBAppResolvedViewSource as aj, MindooDBAppRuntime as ak, MindooDBAppScopedDocId as al, MindooDBAppSession as am, MindooDBAppShowMenuInput as an, MindooDBAppShowMenuResult as ao, MindooDBAppThemeMode as ap, MindooDBAppUiPreferences as aq, MindooDBAppUpdateDocumentInput as ar, MindooDBAppViewEntry as as, MindooDBAppViewEntryKind as at, MindooDBAppViewNavigator as au, MindooDBAppViewNavigatorExpansionState as av, MindooDBAppViewNavigatorOpenOptions as aw, MindooDBAppViewNavigatorPageOptions as ax, MindooDBAppViewNavigatorPageResult as ay, MindooDBAppViewNavigatorRangeQuery as az, MindooDBAppAttachmentApi as b, MindooDBAppAttachmentChunk as c, MindooDBAppAttachmentInfo as d, MindooDBAppAttachmentPreviewOptions as e, MindooDBAppAttachmentPreviewSession as f, MindooDBAppBridgeConnectMessage as g, MindooDBAppBridgeConnectOptions as h, MindooDBAppBridgeConnectedMessage as i, MindooDBAppBridgeErrorPayload as j, MindooDBAppBridgePortMessage as k, MindooDBAppBridgeRpcError as l, MindooDBAppBridgeRpcMessage as m, MindooDBAppBridgeRpcRequest as n, MindooDBAppBridgeRpcSuccess as o, MindooDBAppBridgeStreamAbortRequest as p, MindooDBAppBridgeStreamAck as q, MindooDBAppBridgeStreamCloseRequest as r, MindooDBAppBridgeStreamError as s, MindooDBAppBridgeStreamMessage as t, MindooDBAppBridgeStreamOpenResult as u, MindooDBAppBridgeStreamReadRequest as v, MindooDBAppBridgeStreamWriteRequest as w, MindooDBAppBridgeThemeChangedMessage as x, MindooDBAppBridgeUiPreferencesChangedMessage as y, MindooDBAppBridgeViewportChangedMessage as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "MindooDB app SDK for building apps that connect to the Haven host bridge",
   "license": "ISC",
   "author": "Mindoo GmbH",