mindoodb-app-sdk 0.0.53 → 0.0.54

package/README.md

@@ -22,26 +22,17 @@ A **MindooDB App** is any web application that uses this SDK to communicate with
 
 ## Architecture
 
-```
-┌─────────────────────────────────────────────────────────┐
-│  Haven (browser tab)                                    │
-│                                                         │
-│  ┌──────────────┐   ┌─────────────┐   ┌─────────────┐  │
-│  │  Haven UI    │──▶│ Bridge Host │──▶│  MindooDB    │  │
-│  │  (theme,     │   │  (RPC +     │   │  (encrypted  │  │
-│  │   viewport)  │   │   streams)  │   │   databases) │  │
-│  └──────────────┘   └──────┬──────┘   └─────────────┘  │
-│                            │                            │
-│              postMessage + MessagePort                  │
-│                            │                            │
-│  ┌─────────────────────────┼─────────────────────────┐  │
-│  │  Your App (sandboxed iframe / window)             │  │
-│  │                         │                         │  │
-│  │              ┌──────────▼──────────┐              │  │
-│  │              │  mindoodb-app-sdk   │              │  │
-│  │              └─────────────────────┘              │  │
-│  └───────────────────────────────────────────────────┘  │
-└─────────────────────────────────────────────────────────┘
+```mermaid
+flowchart TB
+  subgraph haven["Haven (browser tab)"]
+    direction TB
+    ui["Haven UI<br/>(theme, viewport)"] --> bridge["Bridge Host<br/>(RPC + streams)"]
+    bridge --> db["MindooDB<br/>(encrypted databases)"]
+    subgraph app["Your App (sandboxed iframe / window)"]
+      sdk["mindoodb-app-sdk"]
+    end
+    bridge -- "postMessage + MessagePort" --> sdk
+  end
 ```
 
 The bridge carries RPC calls (documents, views, database info), binary attachment streams, and push events (theme changes, viewport resizes) over a single `MessagePort`.
@@ -757,23 +748,11 @@ Two layers are available:
 
 The end-to-end flow is the same in both cases:
 
-```
-            ┌────────────────────────────────────────────────────┐
-  edit ───► │ App buffer (local string + pending splices)        │ ──► flush
-            └─────────────────────────┬──────────────────────────┘
-                                      │ documents.update({
-                                      │   text: [{ path, baseHeads, edits }]
-                                      │ })
-                                      ▼
-            ┌────────────────────────────────────────────────────┐
-            │ Haven applies edits at `baseHeads` and merges with │
-            │ concurrent changes via Automerge                   │
-            └─────────────────────────┬──────────────────────────┘
-                                      │ canonical merged document
-                                      ▼
-            ┌────────────────────────────────────────────────────┐
-            │ App reconciles its editor with the canonical text  │
-            └────────────────────────────────────────────────────┘
+```mermaid
+flowchart TB
+  edit(["edit"]) --> buffer["App buffer<br/>(local string + pending splices)"]
+  buffer -- "flush: documents.update({ text: [{ path, baseHeads, edits }] })" --> merge["Haven applies edits at baseHeads<br/>and merges with concurrent changes via Automerge"]
+  merge -- "canonical merged document" --> reconcile["App reconciles its editor<br/>with the canonical text"]
 ```
 
 #### Text patch shape
@@ -1003,24 +982,14 @@ If you must use binary sync, Haven decrypts the canonical document, merges incom
 
 Typical flow:
 
-```
-            ┌────────────────────────────────────────────────────┐
-  open  ──► │ getAutomergeSnapshot → load local replica          │
-            └─────────────────────────┬──────────────────────────┘
-                                      │
-  edit  ──► │ Local Automerge doc (or span edits applied locally)  │
-            └─────────────────────────┬──────────────────────────┘
-                                      │ getChangesSince(baseHeads)
-                                      ▼
-            ┌────────────────────────────────────────────────────┐
-  save  ──► │ applyAutomergeChanges({ baseHeads, replicaHeads,   │
-            │                       changes })                   │
-            └─────────────────────────┬──────────────────────────┘
-                                      │ Haven merges + persists
-                                      ▼
-            ┌────────────────────────────────────────────────────┐
-            │ Apply result.changesSince locally (or skip if empty) │
-            └────────────────────────────────────────────────────┘
+```mermaid
+flowchart TB
+  open(["open"]) --> snapshot["getAutomergeSnapshot<br/>→ load local replica"]
+  snapshot --> local["Local Automerge doc<br/>(or span edits applied locally)"]
+  editStep(["edit"]) --> local
+  local -- "getChangesSince(baseHeads)" --> apply["applyAutomergeChanges({<br/>baseHeads, replicaHeads, changes })"]
+  saveStep(["save"]) --> apply
+  apply -- "Haven merges + persists" --> result["Apply result.changesSince locally<br/>(or skip if empty)"]
 ```
 
 Bridge RPCs: `documents.automerge.getSnapshot` and `documents.automerge.applyChanges`.
@@ -1702,6 +1671,7 @@ What the page shows comes from the optional `listing` in `haven-app.json`. Haven
   "listing": {
     "summary": { "en": "Plan trips together.", "de": "Reisen gemeinsam planen." },
     "description": { "en": "First paragraph.\n\nSecond paragraph." },
+    "descriptionMarkdown": { "en": "**Plan** together.\n\n- Shared board\n- [Website](https://trips.example.com)" },
     "icon": "icon.svg",
     "screenshots": [{ "file": "screenshots/board.webp", "caption": { "en": "The trip board" } }],
     "publisher": { "name": "Mindoo GmbH", "url": "https://mindoo.de" }
@@ -1711,6 +1681,10 @@ What the page shows comes from the optional `listing` in `haven-app.json`. Haven
 
 Texts are a string or a per-locale map with an `en` fallback. Image paths are relative to the app origin or absolute `https:` URLs. The listing is display-only and grants nothing.
 
+Opening the app URL directly also puts share tags into `index.html` (`twitter:card` = `summary`, plus the Open Graph tags other apps read), with the app icon as the image. A production build takes the absolute URL from `publicUrl` in `haven-app.json`. `vite dev` uses the dev server's own origin instead, so `http://127.0.0.1:<port>/` previews against itself. Crawlers do not run the landing page's JavaScript, which is why the tags are in the HTML file.
+
+`description` is plain text. `descriptionMarkdown` is the same text with formatting, in a small Markdown subset: paragraphs, headings, bullet and numbered lists, `**bold**`, `_italic_`, `` `code` ``, `[text](https://…)`, `[text](mailto:…)` and bare `https://…` links. Links to any other scheme render as plain text. Readers that know `descriptionMarkdown` show it instead of `description`; older Haven versions ignore it, so set both if they matter. `listingMarkdownToPlainText()` derives the plain version. A publisher `url` (`https:` only) turns the publisher name into a link.
+
 For automated and manual tests use a separate test URL that frames the app with a mock host instead — see "Browser test host" in [`TESTING.md`](./TESTING.md). End users never see that page, and they never see mock data.
 
 ### Haven-hosted bundles

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 MindooDBAppHostShortcutBinding, g as MindooDBAppHostShortcutAction, h as MindooDBAppHostingMode, i as MindooDBAppDefinition, j as MindooDBAppDatabase, k as MindooDBAppDocument, l as MindooDBAppRichTextSpan, m as MindooDBAppRichTextSnapshot, n as MindooDBAppCreateDocumentInput } from './types-CsKw_niD.js';
-export { o as MINDOODB_APP_DEFINITION_FILE_NAME, p as MINDOODB_APP_DEFINITION_FORMAT, q as MINDOODB_APP_DEFINITION_PERMISSIONS, r as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, s as MINDOODB_APP_DEFINITION_VERSION, t as MINDOODB_APP_LISTING_DESCRIPTION_MAX, u as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, v as MINDOODB_APP_LISTING_SUMMARY_MAX, w as MINDOODB_APP_SEAL_SIGNING_DOMAIN, x as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, y as MindooDBAppAccessDecision, z as MindooDBAppAccessTier, A as MindooDBAppAttachmentApi, B as MindooDBAppAttachmentChunk, C as MindooDBAppAttachmentInfo, D as MindooDBAppAttachmentPreviewOptions, E as MindooDBAppAttachmentPreviewSession, F as MindooDBAppAutomergeChangesPatch, G as MindooDBAppAutomergeChangesSince, H as MindooDBAppAutomergeGetOptions, I as MindooDBAppAutomergePatchResult, J as MindooDBAppAutomergeSnapshot, K as MindooDBAppBridgeBeforeCloseAck, L as MindooDBAppBridgeBeforeCloseMessage, N as MindooDBAppBridgeConnectMessage, O as MindooDBAppBridgeConnectOptions, P as MindooDBAppBridgeConnectedMessage, Q as MindooDBAppBridgeDragDropMessage, R as MindooDBAppBridgeDragLeaveMessage, S as MindooDBAppBridgeDragOverMessage, T as MindooDBAppBridgeErrorPayload, U as MindooDBAppBridgeHandshakeErrorMessage, V as MindooDBAppBridgeHostFocusChangedMessage, W as MindooDBAppBridgeLocaleChangedMessage, X as MindooDBAppBridgePortMessage, Y as MindooDBAppBridgeQueryResultMessage, Z as MindooDBAppBridgeRpcError, _ as MindooDBAppBridgeRpcMessage, $ as MindooDBAppBridgeRpcRequest, a0 as MindooDBAppBridgeRpcSuccess, a1 as MindooDBAppBridgeShortcutInvokedMessage, a2 as MindooDBAppBridgeShortcutsChangedMessage, a3 as MindooDBAppBridgeStreamAbortRequest, a4 as MindooDBAppBridgeStreamAck, a5 as MindooDBAppBridgeStreamCloseRequest, a6 as MindooDBAppBridgeStreamError, a7 as MindooDBAppBridgeStreamMessage, a8 as MindooDBAppBridgeStreamOpenResult, a9 as MindooDBAppBridgeStreamReadRequest, aa as MindooDBAppBridgeStreamWriteRequest, ab as MindooDBAppBridgeThemeChangedMessage, ac as MindooDBAppBridgeUiPreferencesChangedMessage, ad as MindooDBAppBridgeViewChangedMessage, ae as MindooDBAppBridgeViewportChangedMessage, af as MindooDBAppBridgeWorkspaceFocusRequestedMessage, ag as MindooDBAppCapability, ah as MindooDBAppConfiguredViewCategorizationStyle, ai as MindooDBAppConfiguredViewColumn, aj as MindooDBAppConfiguredViewColumnRole, ak as MindooDBAppConfiguredViewExpressionMode, al as MindooDBAppConfiguredViewFieldExpression, am as MindooDBAppConfiguredViewFilterDefinition, an as MindooDBAppConfiguredViewFilterMode, ao as MindooDBAppConfiguredViewFilterRule, ap as MindooDBAppConfiguredViewFormulaExpression, aq as MindooDBAppConfiguredViewFormulaFilterDefinition, ar as MindooDBAppConfiguredViewPreviewMode, as as MindooDBAppConfiguredViewRuleFilterDefinition, at as MindooDBAppConfiguredViewRuleMatchMode, au as MindooDBAppConfiguredViewRuleOperator, av as MindooDBAppConfiguredViewValueExpression, aw as MindooDBAppCreateKeyInfo, ax as MindooDBAppCreateViewInput, ay as MindooDBAppCreateViewNavigatorInput, az as MindooDBAppDatabaseInfo, aA as MindooDBAppDefinitionDatabase, aB as MindooDBAppDefinitionListing, aC as MindooDBAppDefinitionPermission, aD as MindooDBAppDefinitionRegistrationPermission, aE as MindooDBAppDefinitionScreenshot, aF as MindooDBAppDefinitionValidation, aG as MindooDBAppDirectoryApi, aH as MindooDBAppDirectoryEntry, aI as MindooDBAppDocumentApi, aJ as MindooDBAppDocumentHeadCursorResult, aK as MindooDBAppDocumentHistoryEntry, aL as MindooDBAppDocumentListQuery, aM as MindooDBAppDocumentListResult, aN as MindooDBAppDocumentQuery, aO as MindooDBAppDocumentRevisionId, aP as MindooDBAppDocumentScanPreset, aQ as MindooDBAppDocumentSummary, aR as MindooDBAppDragApi, aS as MindooDBAppDragCancelReason, aT as MindooDBAppDragDropEvent, aU as MindooDBAppDragEffect, aV as MindooDBAppDragHoverResult, aW as MindooDBAppDragOffer, aX as MindooDBAppDragOverEvent, aY as MindooDBAppDragPointer, aZ as MindooDBAppDragProfile, a_ as MindooDBAppEntryAttachmentRef, a$ as MindooDBAppEntryProvenance, b0 as MindooDBAppExtractDocumentTextInput, b1 as MindooDBAppExtractDocumentTextResult, b2 as MindooDBAppExtractTextFormat, b3 as MindooDBAppExtractionSetup, b4 as MindooDBAppFulltextSetup, b5 as MindooDBAppHistoricalDocument, b6 as MindooDBAppHistoryQuery, b7 as MindooDBAppHostTheme, b8 as MindooDBAppIdentityApi, b9 as MindooDBAppInaccessibleDocument, ba as MindooDBAppInaccessibleDocumentListQuery, bb as MindooDBAppInaccessibleDocumentListResult, bc as MindooDBAppJsonCounterIncrementPatch, bd as MindooDBAppJsonListDeletePatch, be as MindooDBAppJsonListInsertPatch, bf as MindooDBAppJsonPatch, bg as MindooDBAppJsonSetPatch, bh as MindooDBAppJsonTextMarkPatch, bi as MindooDBAppJsonTextSplicePatch, bj as MindooDBAppJsonTextUnmarkPatch, bk as MindooDBAppJsonUnsetPatch, bl as MindooDBAppLaunchContext, bm as MindooDBAppLiveQuerySubscription, bn as MindooDBAppLocalizedText, bo as MindooDBAppMenuAnchor, bp as MindooDBAppMenuApi, bq as MindooDBAppMenuCommandItem, br as MindooDBAppMenuDismissReason, bs as MindooDBAppMenuDismissedResult, bt as MindooDBAppMenuItem, bu as MindooDBAppMenuKind, bv as MindooDBAppMenuPlacement, bw as MindooDBAppMenuPointAnchor, bx as MindooDBAppMenuRect, by as MindooDBAppMenuRectAnchor, bz as MindooDBAppMenuSelectionResult, bA as MindooDBAppMenuSeparatorItem, bB as MindooDBAppNotificationSeverity, bC as MindooDBAppNotifyInput, bD as MindooDBAppNotifyResult, bE as MindooDBAppProposeAppInput, bF as MindooDBAppProposeAppResult, bG as MindooDBAppQueryCoverage, bH as MindooDBAppQueryInclude, bI as MindooDBAppQueryIncludeCardinality, bJ as MindooDBAppQueryIncludeSlots, bK as MindooDBAppQueryResult, bL as MindooDBAppQueryRow, bM as MindooDBAppQuerySortKey, bN as MindooDBAppQueryTextClause, bO as MindooDBAppReadableAttachmentStream, bP as MindooDBAppRecipientOptions, bQ as MindooDBAppResolvedViewDefinition, bR as MindooDBAppResolvedViewSource, bS as MindooDBAppRevisionPhase, bT as MindooDBAppRevisionVerification, bU as MindooDBAppRichTextBlockSpan, bV as MindooDBAppRichTextGetOptions, bW as MindooDBAppRichTextImmutableString, bX as MindooDBAppRichTextMarkRange, bY as MindooDBAppRichTextMaterializeValue, bZ as MindooDBAppRichTextPatch, b_ as MindooDBAppRichTextScalar, b$ as MindooDBAppRichTextSpliceStep, c0 as MindooDBAppRichTextStep, c1 as MindooDBAppRichTextStepPatch, c2 as MindooDBAppRichTextTextSpan, c3 as MindooDBAppRuntime, c4 as MindooDBAppScanAttachmentOptions, c5 as MindooDBAppScanAttachmentResult, c6 as MindooDBAppScopedDocId, c7 as MindooDBAppScopedDocumentSummary, c8 as MindooDBAppSealIntent, c9 as MindooDBAppSealedChannelOpenInput, ca as MindooDBAppSealedChannelOpenResult, cb as MindooDBAppSealedChannelRequestInput, cc as MindooDBAppSession, cd as MindooDBAppShowMenuInput, ce as MindooDBAppShowMenuResult, cf as MindooDBAppSignPreview, cg as MindooDBAppSignPreviewScope, ch as MindooDBAppSignStatementInput, ci as MindooDBAppSignStatementResult, cj as MindooDBAppStorageApi, ck as MindooDBAppSummarySetup, cl as MindooDBAppTextCursorOptions, cm as MindooDBAppTextCursorPosition, cn as MindooDBAppTextCursorPositionsResult, co as MindooDBAppTextCursorsResult, cp as MindooDBAppTextEdit, cq as MindooDBAppTextPatch, cr as MindooDBAppThemeMode, cs as MindooDBAppTimestampApi, ct as MindooDBAppTimestampInput, cu as MindooDBAppTimestampProvider, cv as MindooDBAppTimestampResult, cw as MindooDBAppUiPreferences, cx as MindooDBAppUpdateDocumentInput, cy as MindooDBAppViewCursorDocumentListResult, cz as MindooDBAppViewCursorResult, cA as MindooDBAppViewEntry, cB as MindooDBAppViewEntryKind, cC as MindooDBAppViewNavigator, cD as MindooDBAppViewNavigatorExpansionState, cE as MindooDBAppViewNavigatorOpenOptions, cF as MindooDBAppViewNavigatorPageOptions, cG as MindooDBAppViewNavigatorPageResult, cH as MindooDBAppViewNavigatorRangeQuery, cI as MindooDBAppViewNavigatorSelectionState, cJ as MindooDBAppViewUpdateStats, cK as MindooDBAppViewport, cL as MindooDBAppWellKnownDragType, cM as MindooDBAppWritableAttachmentStream, cN as resolveMindooDBAppDefinitionUrl, cO as resolveMindooDBAppListingAssetUrl, cP as resolveMindooDBAppLocalizedText, cQ as validateMindooDBAppDefinition } from './types-CsKw_niD.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppHostShortcutBinding, g as MindooDBAppHostShortcutAction, h as MindooDBAppHostingMode, i as MindooDBAppDefinition, j as MindooDBAppDatabase, k as MindooDBAppDocument, l as MindooDBAppRichTextSpan, m as MindooDBAppRichTextSnapshot, n as MindooDBAppCreateDocumentInput } from './types-CX-o1Xyq.js';
+export { o as MINDOODB_APP_DEFINITION_FILE_NAME, p as MINDOODB_APP_DEFINITION_FORMAT, q as MINDOODB_APP_DEFINITION_PERMISSIONS, r as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, s as MINDOODB_APP_DEFINITION_VERSION, t as MINDOODB_APP_LISTING_DESCRIPTION_MAX, u as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, v as MINDOODB_APP_LISTING_SUMMARY_MAX, w as MINDOODB_APP_SEAL_SIGNING_DOMAIN, x as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, y as MindooDBAppAccessDecision, z as MindooDBAppAccessTier, A as MindooDBAppAttachmentApi, B as MindooDBAppAttachmentChunk, C as MindooDBAppAttachmentInfo, D as MindooDBAppAttachmentPreviewOptions, E as MindooDBAppAttachmentPreviewSession, F as MindooDBAppAutomergeChangesPatch, G as MindooDBAppAutomergeChangesSince, H as MindooDBAppAutomergeGetOptions, I as MindooDBAppAutomergePatchResult, J as MindooDBAppAutomergeSnapshot, K as MindooDBAppBridgeBeforeCloseAck, L as MindooDBAppBridgeBeforeCloseMessage, N as MindooDBAppBridgeConnectMessage, O as MindooDBAppBridgeConnectOptions, P as MindooDBAppBridgeConnectedMessage, Q as MindooDBAppBridgeDragDropMessage, R as MindooDBAppBridgeDragLeaveMessage, S as MindooDBAppBridgeDragOverMessage, T as MindooDBAppBridgeErrorPayload, U as MindooDBAppBridgeHandshakeErrorMessage, V as MindooDBAppBridgeHostFocusChangedMessage, W as MindooDBAppBridgeLocaleChangedMessage, X as MindooDBAppBridgePortMessage, Y as MindooDBAppBridgeQueryResultMessage, Z as MindooDBAppBridgeRpcError, _ as MindooDBAppBridgeRpcMessage, $ as MindooDBAppBridgeRpcRequest, a0 as MindooDBAppBridgeRpcSuccess, a1 as MindooDBAppBridgeShortcutInvokedMessage, a2 as MindooDBAppBridgeShortcutsChangedMessage, a3 as MindooDBAppBridgeStreamAbortRequest, a4 as MindooDBAppBridgeStreamAck, a5 as MindooDBAppBridgeStreamCloseRequest, a6 as MindooDBAppBridgeStreamError, a7 as MindooDBAppBridgeStreamMessage, a8 as MindooDBAppBridgeStreamOpenResult, a9 as MindooDBAppBridgeStreamReadRequest, aa as MindooDBAppBridgeStreamWriteRequest, ab as MindooDBAppBridgeThemeChangedMessage, ac as MindooDBAppBridgeUiPreferencesChangedMessage, ad as MindooDBAppBridgeViewChangedMessage, ae as MindooDBAppBridgeViewportChangedMessage, af as MindooDBAppBridgeWorkspaceFocusRequestedMessage, ag as MindooDBAppCapability, ah as MindooDBAppConfiguredViewCategorizationStyle, ai as MindooDBAppConfiguredViewColumn, aj as MindooDBAppConfiguredViewColumnRole, ak as MindooDBAppConfiguredViewExpressionMode, al as MindooDBAppConfiguredViewFieldExpression, am as MindooDBAppConfiguredViewFilterDefinition, an as MindooDBAppConfiguredViewFilterMode, ao as MindooDBAppConfiguredViewFilterRule, ap as MindooDBAppConfiguredViewFormulaExpression, aq as MindooDBAppConfiguredViewFormulaFilterDefinition, ar as MindooDBAppConfiguredViewPreviewMode, as as MindooDBAppConfiguredViewRuleFilterDefinition, at as MindooDBAppConfiguredViewRuleMatchMode, au as MindooDBAppConfiguredViewRuleOperator, av as MindooDBAppConfiguredViewValueExpression, aw as MindooDBAppCreateKeyInfo, ax as MindooDBAppCreateViewInput, ay as MindooDBAppCreateViewNavigatorInput, az as MindooDBAppDatabaseInfo, aA as MindooDBAppDefinitionDatabase, aB as MindooDBAppDefinitionListing, aC as MindooDBAppDefinitionPermission, aD as MindooDBAppDefinitionRegistrationPermission, aE as MindooDBAppDefinitionScreenshot, aF as MindooDBAppDefinitionValidation, aG as MindooDBAppDirectoryApi, aH as MindooDBAppDirectoryEntry, aI as MindooDBAppDocumentApi, aJ as MindooDBAppDocumentHeadCursorResult, aK as MindooDBAppDocumentHistoryEntry, aL as MindooDBAppDocumentListQuery, aM as MindooDBAppDocumentListResult, aN as MindooDBAppDocumentQuery, aO as MindooDBAppDocumentRevisionId, aP as MindooDBAppDocumentScanPreset, aQ as MindooDBAppDocumentSummary, aR as MindooDBAppDragApi, aS as MindooDBAppDragCancelReason, aT as MindooDBAppDragDropEvent, aU as MindooDBAppDragEffect, aV as MindooDBAppDragHoverResult, aW as MindooDBAppDragOffer, aX as MindooDBAppDragOverEvent, aY as MindooDBAppDragPointer, aZ as MindooDBAppDragProfile, a_ as MindooDBAppEntryAttachmentRef, a$ as MindooDBAppEntryProvenance, b0 as MindooDBAppExtractDocumentTextInput, b1 as MindooDBAppExtractDocumentTextResult, b2 as MindooDBAppExtractTextFormat, b3 as MindooDBAppExtractionSetup, b4 as MindooDBAppFulltextSetup, b5 as MindooDBAppHistoricalDocument, b6 as MindooDBAppHistoryQuery, b7 as MindooDBAppHostTheme, b8 as MindooDBAppIdentityApi, b9 as MindooDBAppInaccessibleDocument, ba as MindooDBAppInaccessibleDocumentListQuery, bb as MindooDBAppInaccessibleDocumentListResult, bc as MindooDBAppJsonCounterIncrementPatch, bd as MindooDBAppJsonListDeletePatch, be as MindooDBAppJsonListInsertPatch, bf as MindooDBAppJsonPatch, bg as MindooDBAppJsonSetPatch, bh as MindooDBAppJsonTextMarkPatch, bi as MindooDBAppJsonTextSplicePatch, bj as MindooDBAppJsonTextUnmarkPatch, bk as MindooDBAppJsonUnsetPatch, bl as MindooDBAppLaunchContext, bm as MindooDBAppLiveQuerySubscription, bn as MindooDBAppLocalizedText, bo as MindooDBAppMenuAnchor, bp as MindooDBAppMenuApi, bq as MindooDBAppMenuCommandItem, br as MindooDBAppMenuDismissReason, bs as MindooDBAppMenuDismissedResult, bt as MindooDBAppMenuItem, bu as MindooDBAppMenuKind, bv as MindooDBAppMenuPlacement, bw as MindooDBAppMenuPointAnchor, bx as MindooDBAppMenuRect, by as MindooDBAppMenuRectAnchor, bz as MindooDBAppMenuSelectionResult, bA as MindooDBAppMenuSeparatorItem, bB as MindooDBAppNotificationSeverity, bC as MindooDBAppNotifyInput, bD as MindooDBAppNotifyResult, bE as MindooDBAppProposeAppInput, bF as MindooDBAppProposeAppResult, bG as MindooDBAppQueryCoverage, bH as MindooDBAppQueryInclude, bI as MindooDBAppQueryIncludeCardinality, bJ as MindooDBAppQueryIncludeSlots, bK as MindooDBAppQueryResult, bL as MindooDBAppQueryRow, bM as MindooDBAppQuerySortKey, bN as MindooDBAppQueryTextClause, bO as MindooDBAppReadableAttachmentStream, bP as MindooDBAppRecipientOptions, bQ as MindooDBAppResolvedViewDefinition, bR as MindooDBAppResolvedViewSource, bS as MindooDBAppRevisionPhase, bT as MindooDBAppRevisionVerification, bU as MindooDBAppRichTextBlockSpan, bV as MindooDBAppRichTextGetOptions, bW as MindooDBAppRichTextImmutableString, bX as MindooDBAppRichTextMarkRange, bY as MindooDBAppRichTextMaterializeValue, bZ as MindooDBAppRichTextPatch, b_ as MindooDBAppRichTextScalar, b$ as MindooDBAppRichTextSpliceStep, c0 as MindooDBAppRichTextStep, c1 as MindooDBAppRichTextStepPatch, c2 as MindooDBAppRichTextTextSpan, c3 as MindooDBAppRuntime, c4 as MindooDBAppScanAttachmentOptions, c5 as MindooDBAppScanAttachmentResult, c6 as MindooDBAppScopedDocId, c7 as MindooDBAppScopedDocumentSummary, c8 as MindooDBAppSealIntent, c9 as MindooDBAppSealedChannelOpenInput, ca as MindooDBAppSealedChannelOpenResult, cb as MindooDBAppSealedChannelRequestInput, cc as MindooDBAppSession, cd as MindooDBAppShowMenuInput, ce as MindooDBAppShowMenuResult, cf as MindooDBAppSignPreview, cg as MindooDBAppSignPreviewScope, ch as MindooDBAppSignStatementInput, ci as MindooDBAppSignStatementResult, cj as MindooDBAppStorageApi, ck as MindooDBAppSummarySetup, cl as MindooDBAppTextCursorOptions, cm as MindooDBAppTextCursorPosition, cn as MindooDBAppTextCursorPositionsResult, co as MindooDBAppTextCursorsResult, cp as MindooDBAppTextEdit, cq as MindooDBAppTextPatch, cr as MindooDBAppThemeMode, cs as MindooDBAppTimestampApi, ct as MindooDBAppTimestampInput, cu as MindooDBAppTimestampProvider, cv as MindooDBAppTimestampResult, cw as MindooDBAppUiPreferences, cx as MindooDBAppUpdateDocumentInput, cy as MindooDBAppViewCursorDocumentListResult, cz as MindooDBAppViewCursorResult, cA as MindooDBAppViewEntry, cB as MindooDBAppViewEntryKind, cC as MindooDBAppViewNavigator, cD as MindooDBAppViewNavigatorExpansionState, cE as MindooDBAppViewNavigatorOpenOptions, cF as MindooDBAppViewNavigatorPageOptions, cG as MindooDBAppViewNavigatorPageResult, cH as MindooDBAppViewNavigatorRangeQuery, cI as MindooDBAppViewNavigatorSelectionState, cJ as MindooDBAppViewUpdateStats, cK as MindooDBAppViewport, cL as MindooDBAppWellKnownDragType, cM as MindooDBAppWritableAttachmentStream, cN as resolveMindooDBAppDefinitionUrl, cO as resolveMindooDBAppListingAssetUrl, cP as resolveMindooDBAppLocalizedText, cQ as validateMindooDBAppDefinition } from './types-CX-o1Xyq.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';
@@ -295,6 +295,64 @@ declare function buildHavenAppInstallUrl(appUrl: string, havenUrl?: string): str
  */
 declare function renderHavenAppLandingPage(options?: RenderHavenAppLandingPageOptions): Promise<HavenAppLandingPage>;
 
+/**
+ * The Markdown subset a publisher may use in `listing.descriptionMarkdown`.
+ *
+ * The text comes from a file on the publisher's server and is shown before anyone has
+ * agreed to install the app, so it is parsed into a small tree here and rendered with
+ * `createElement`/`textContent` (or Vue render functions) — never as HTML. What the
+ * subset knows:
+ *
+ * - paragraphs (blank lines), headings (`#`), bullet (`-`, `*`, `+`) and numbered lists
+ * - `**bold**`, `__bold__`, `*italic*`, `_italic_`, `` `code` ``, `\` escapes
+ * - `[text](https://…)`, `[text](mailto:…)` and bare `https://…` links
+ *
+ * Anything else stays literal text. Links are limited to `https:` and `mailto:` by
+ * {@link sanitizeListingHref}; a link with any other target renders as its text only.
+ *
+ * DOM-free on purpose, so Haven, the landing page and build scripts can share it.
+ */
+type ListingInline = {
+    type: "text";
+    text: string;
+} | {
+    type: "code";
+    text: string;
+} | {
+    type: "strong";
+    children: ListingInline[];
+} | {
+    type: "em";
+    children: ListingInline[];
+} | {
+    type: "link";
+    href: string;
+    children: ListingInline[];
+};
+type ListingBlock = {
+    type: "paragraph";
+    children: ListingInline[];
+} | {
+    type: "heading";
+    children: ListingInline[];
+} | {
+    type: "list";
+    ordered: boolean;
+    items: ListingInline[][];
+};
+/**
+ * `https:` and `mailto:` only. Embedded tab/LF/CR are stripped first, as browsers do,
+ * so `java\nscript:` cannot slip past the scheme check.
+ */
+declare function sanitizeListingHref(raw: string): string | null;
+/** Parses a description into blocks. Unknown syntax stays text; nothing is dropped. */
+declare function parseListingMarkdown(markdown: string): ListingBlock[];
+/**
+ * The same text for readers that only show plain paragraphs (`listing.description`):
+ * one paragraph per block and per list item, links as "text (url)".
+ */
+declare function listingMarkdownToPlainText(markdown: string): string;
+
 interface InstallHavenStorageShimOptions {
     /**
      * Key prefixes whose values are written through to the host and restored on the next
@@ -501,4 +559,4 @@ declare function inheritDocumentEncryption(parent: Pick<MindooDBAppDocument, "de
  */
 declare function watchWordChunks(database: MindooDBAppDatabase, parentId: string, listener: (docIds: string[]) => void): Promise<() => Promise<void>>;
 
-export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, DEFAULT_DRAG_LONG_PRESS_MS, DEFAULT_DRAG_POINTER_THRESHOLD_PX, DEFAULT_HAVEN_HOST_SHORTCUTS, DEFAULT_HAVEN_URL, type HavenAppLandingPage, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, MINDOODB_APP_HOSTING_QUERY_PARAM, MINDOODB_APP_LAUNCH_ID_QUERY_PARAM, MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE, MINDOODB_APP_MAX_DRAG_TYPES, MINDOODB_APP_VALUE_TAG, MINIMAL_DRAG_PREVIEW_PNG, type MindooDBAppAtomicValue, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, type MindooDBAppCounterValue, MindooDBAppCreateDocumentInput, MindooDBAppDatabase, MindooDBAppDefinition, MindooDBAppDocument, MindooDBAppDragBindSourceOptions, MindooDBAppDragInputError, MindooDBAppDragPreview, MindooDBAppDragStartInput, MindooDBAppDragStartResult, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, type MindooDBAppTimestampValue, type MindooDBAppTypedValue, MindooDBAppValue, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, type RenderHavenAppLandingPageOptions, abbreviateCanonicalName, applyHostedDocumentOverscrollContain, bindDragSource, buildHavenAppInstallUrl, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, inheritDocumentEncryption, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, isLaunchedByHaven, isMindooDBAppDragType, matchHostShortcut, normalizeDragAccepts, normalizeDragPointerInput, normalizeDragStartInput, queryDocuments, readMindooDBAppHostingMode, readMindooDBAppLaunchId, releaseMindooDBAppBridgeSessions, renderHavenAppLandingPage, resolveCurrentHavenAppUrl, sanitizeHostShortcutBindings, snapshotElementToPng, watchWordChunks };
+export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, DEFAULT_DRAG_LONG_PRESS_MS, DEFAULT_DRAG_POINTER_THRESHOLD_PX, DEFAULT_HAVEN_HOST_SHORTCUTS, DEFAULT_HAVEN_URL, type HavenAppLandingPage, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, type ListingBlock, type ListingInline, MINDOODB_APP_HOSTING_QUERY_PARAM, MINDOODB_APP_LAUNCH_ID_QUERY_PARAM, MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE, MINDOODB_APP_MAX_DRAG_TYPES, MINDOODB_APP_VALUE_TAG, MINIMAL_DRAG_PREVIEW_PNG, type MindooDBAppAtomicValue, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, type MindooDBAppCounterValue, MindooDBAppCreateDocumentInput, MindooDBAppDatabase, MindooDBAppDefinition, MindooDBAppDocument, MindooDBAppDragBindSourceOptions, MindooDBAppDragInputError, MindooDBAppDragPreview, MindooDBAppDragStartInput, MindooDBAppDragStartResult, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, type MindooDBAppTimestampValue, type MindooDBAppTypedValue, MindooDBAppValue, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, type RenderHavenAppLandingPageOptions, abbreviateCanonicalName, applyHostedDocumentOverscrollContain, bindDragSource, buildHavenAppInstallUrl, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, inheritDocumentEncryption, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, isLaunchedByHaven, isMindooDBAppDragType, listingMarkdownToPlainText, matchHostShortcut, normalizeDragAccepts, normalizeDragPointerInput, normalizeDragStartInput, parseListingMarkdown, queryDocuments, readMindooDBAppHostingMode, readMindooDBAppLaunchId, releaseMindooDBAppBridgeSessions, renderHavenAppLandingPage, resolveCurrentHavenAppUrl, sanitizeHostShortcutBindings, sanitizeListingHref, snapshotElementToPng, watchWordChunks };

package/dist/index.js

@@ -286,6 +286,13 @@ function readListing(value, errors) {
     errors
   );
   if (description) listing.description = description;
+  const descriptionMarkdown = readLocalizedText(
+    value.descriptionMarkdown,
+    "App definition listing.descriptionMarkdown",
+    MINDOODB_APP_LISTING_DESCRIPTION_MAX,
+    errors
+  );
+  if (descriptionMarkdown) listing.descriptionMarkdown = descriptionMarkdown;
   const icon = readListingAssetPath(value.icon, "App definition listing.icon", errors);
   if (icon) listing.icon = icon;
   if (value.screenshots !== void 0 && value.screenshots !== null) {
@@ -575,6 +582,212 @@ function isHostedBundleRuntime(search) {
   return readMindooDBAppHostingMode(search) === "hosted";
 }
 
+// src/listingMarkdown.ts
+var MAX_INLINE_DEPTH = 4;
+var HEADING = /^#{1,6}\s+(.*?)\s*#*\s*$/;
+var BULLET = /^[-*+]\s+(.*)$/;
+var ORDERED = /^\d{1,9}[.)]\s+(.*)$/;
+var ESCAPABLE = new Set("\\`*_[]()#+-.!<>".split(""));
+var BARE_URL_TRAILING_PUNCTUATION = /[.,;:!?)\]'"]+$/;
+function sanitizeListingHref(raw) {
+  const cleaned = raw.replace(/[\t\n\r]/g, "").trim();
+  if (!cleaned) {
+    return null;
+  }
+  try {
+    const url = new URL(cleaned);
+    if (url.protocol === "https:") {
+      return url.toString();
+    }
+    if (url.protocol === "mailto:" && url.pathname) {
+      return url.toString();
+    }
+  } catch {
+  }
+  return null;
+}
+function isWordCharacter(char) {
+  return char !== void 0 && /[\p{L}\p{N}]/u.test(char);
+}
+function pushText(nodes, text) {
+  if (!text) {
+    return;
+  }
+  const last = nodes[nodes.length - 1];
+  if (last?.type === "text") {
+    last.text += text;
+  } else {
+    nodes.push({ type: "text", text });
+  }
+}
+function findClosingDelimiter(text, from, delimiter) {
+  let index = text.indexOf(delimiter, from);
+  while (index !== -1) {
+    const before = text[index - 1];
+    const after = text[index + delimiter.length];
+    const closesAfterContent = index > from && before !== " " && before !== "\\";
+    const underscoreBoundary = delimiter[0] !== "_" || !isWordCharacter(after);
+    if (closesAfterContent && underscoreBoundary) {
+      return index;
+    }
+    index = text.indexOf(delimiter, index + 1);
+  }
+  return -1;
+}
+function findLinkTargetEnd(text, from) {
+  let open = 0;
+  for (let index = from; index < text.length; index += 1) {
+    const char = text[index];
+    if (char === "(") {
+      open += 1;
+    } else if (char === ")") {
+      if (open === 0) return index;
+      open -= 1;
+    } else if (char === " ") {
+      return -1;
+    }
+  }
+  return -1;
+}
+function parseInline(text, depth = 0) {
+  const nodes = [];
+  let index = 0;
+  while (index < text.length) {
+    const char = text[index];
+    if (char === "\\" && ESCAPABLE.has(text[index + 1] ?? "")) {
+      pushText(nodes, text[index + 1]);
+      index += 2;
+      continue;
+    }
+    if (char === "`") {
+      const end = text.indexOf("`", index + 1);
+      if (end > index + 1) {
+        nodes.push({ type: "code", text: text.slice(index + 1, end) });
+        index = end + 1;
+        continue;
+      }
+    }
+    if (depth < MAX_INLINE_DEPTH && (char === "*" || char === "_")) {
+      const strong = text[index + 1] === char;
+      const delimiter = strong ? char + char : char;
+      const next = text[index + delimiter.length];
+      const opens = next !== void 0 && next !== " " && (char !== "_" || !isWordCharacter(text[index - 1]));
+      if (opens) {
+        const end = findClosingDelimiter(text, index + delimiter.length, delimiter);
+        if (end !== -1) {
+          const children = parseInline(text.slice(index + delimiter.length, end), depth + 1);
+          nodes.push(strong ? { type: "strong", children } : { type: "em", children });
+          index = end + delimiter.length;
+          continue;
+        }
+      }
+    }
+    if (char === "[" && depth < MAX_INLINE_DEPTH) {
+      const labelEnd = text.indexOf("](", index + 1);
+      const urlEnd = labelEnd === -1 ? -1 : findLinkTargetEnd(text, labelEnd + 2);
+      if (labelEnd > index + 1 && urlEnd !== -1) {
+        const label = parseInline(text.slice(index + 1, labelEnd), depth + 1);
+        const href = sanitizeListingHref(text.slice(labelEnd + 2, urlEnd));
+        if (href) {
+          nodes.push({ type: "link", href, children: label });
+        } else {
+          nodes.push(...label);
+        }
+        index = urlEnd + 1;
+        continue;
+      }
+    }
+    if (char === "h" && text.startsWith("https://", index) && !isWordCharacter(text[index - 1])) {
+      let end = index;
+      while (end < text.length && !/\s/.test(text[end])) end += 1;
+      const candidate = text.slice(index, end).replace(BARE_URL_TRAILING_PUNCTUATION, "");
+      const href = sanitizeListingHref(candidate);
+      if (href) {
+        nodes.push({ type: "link", href, children: [{ type: "text", text: candidate }] });
+        index += candidate.length;
+        continue;
+      }
+    }
+    pushText(nodes, char);
+    index += 1;
+  }
+  return nodes;
+}
+function parseListingMarkdown(markdown) {
+  const blocks = [];
+  let paragraph = [];
+  let list = null;
+  const flushParagraph = () => {
+    if (paragraph.length) {
+      blocks.push({ type: "paragraph", children: parseInline(paragraph.join(" ")) });
+      paragraph = [];
+    }
+  };
+  const flushList = () => {
+    if (list) {
+      blocks.push({ type: "list", ordered: list.ordered, items: list.items.map((item) => parseInline(item)) });
+      list = null;
+    }
+  };
+  for (const rawLine of markdown.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line) {
+      flushParagraph();
+      flushList();
+      continue;
+    }
+    const heading = HEADING.exec(line);
+    const bullet = BULLET.exec(line);
+    const ordered = bullet ? null : ORDERED.exec(line);
+    if (heading) {
+      flushParagraph();
+      flushList();
+      blocks.push({ type: "heading", children: parseInline(heading[1]) });
+    } else if (bullet || ordered) {
+      flushParagraph();
+      const isOrdered = Boolean(ordered);
+      if (list && list.ordered !== isOrdered) {
+        flushList();
+      }
+      list ??= { ordered: isOrdered, items: [] };
+      list.items.push((bullet ?? ordered)[1]);
+    } else if (list) {
+      list.items[list.items.length - 1] += ` ${line}`;
+    } else {
+      paragraph.push(line);
+    }
+  }
+  flushParagraph();
+  flushList();
+  return blocks;
+}
+function inlineToPlainText(nodes) {
+  return nodes.map((node) => {
+    if (node.type === "text" || node.type === "code") {
+      return node.text;
+    }
+    const label = inlineToPlainText(node.children);
+    if (node.type !== "link") {
+      return label;
+    }
+    const target = node.href.replace(/^mailto:/, "").replace(/^https:\/\//, "").replace(/\/$/, "");
+    return label.includes(target) ? label : `${label} (${node.href.replace(/^mailto:/, "")})`;
+  }).join("");
+}
+function listingMarkdownToPlainText(markdown) {
+  const paragraphs = [];
+  for (const block of parseListingMarkdown(markdown)) {
+    if (block.type === "list") {
+      block.items.forEach((item, index) => {
+        paragraphs.push(`${block.ordered ? `${index + 1}.` : "\u2022"} ${inlineToPlainText(item)}`);
+      });
+    } else {
+      paragraphs.push(inlineToPlainText(block.children));
+    }
+  }
+  return paragraphs.filter((paragraph) => paragraph.trim()).join("\n\n");
+}
+
 // src/landing.ts
 var DEFAULT_HAVEN_URL = "https://haven.mindoodb.com";
 var APP_ICON_FALLBACKS = ["appicon.png", "appicon.webp", "appicon.svg"];
@@ -638,6 +851,43 @@ function el(tag, className, text) {
   if (text !== void 0) node.textContent = text;
   return node;
 }
+function externalLink(href) {
+  const link = el("a");
+  link.href = href;
+  link.rel = "noopener noreferrer";
+  link.target = "_blank";
+  return link;
+}
+function appendInline(parent, nodes) {
+  for (const node of nodes) {
+    if (node.type === "text") {
+      parent.append(node.text);
+    } else if (node.type === "code") {
+      parent.append(el("code", void 0, node.text));
+    } else {
+      const child = node.type === "link" ? externalLink(node.href) : el(node.type);
+      appendInline(child, node.children);
+      parent.append(child);
+    }
+  }
+}
+function renderMarkdownDescription(block, markdown) {
+  for (const entry of parseListingMarkdown(markdown)) {
+    if (entry.type === "list") {
+      const list = el(entry.ordered ? "ol" : "ul");
+      for (const item of entry.items) {
+        const li = el("li");
+        appendInline(li, item);
+        list.append(li);
+      }
+      block.append(list);
+    } else {
+      const node = el(entry.type === "heading" ? "h2" : "p");
+      appendInline(node, entry.children);
+      block.append(node);
+    }
+  }
+}
 var STYLE_ID = "mdb-landing-style";
 var STYLE = `
 .mdb-landing{--bg:#f4f6fb;--card:#fff;--text:#172033;--muted:#5b6478;--line:#e2e6ef;--accent:#1f3a8a;--accent-text:#fff;
@@ -657,7 +907,12 @@ var STYLE = `
 .mdb-landing__button:focus-visible{outline:3px solid var(--accent);outline-offset:3px}
 .mdb-landing__hint{margin:0;max-width:420px;color:var(--muted);font-size:14px}
 .mdb-landing__description{margin:32px 0 0}
-.mdb-landing__description p{margin:0 0 12px}
+.mdb-landing__description p,.mdb-landing__description ul,.mdb-landing__description ol{margin:0 0 12px}
+.mdb-landing__description ul,.mdb-landing__description ol{padding-left:22px}
+.mdb-landing__description li+li{margin-top:4px}
+.mdb-landing__description h2{margin:20px 0 8px;font-size:17px}
+.mdb-landing__description code{font:.92em ui-monospace,SFMono-Regular,Menlo,monospace;padding:1px 5px;border-radius:5px;background:var(--line)}
+.mdb-landing__description a,.mdb-landing__meta a{color:var(--accent)}
 .mdb-landing__shots-title{margin:32px 0 12px;font-size:15px;color:var(--muted);font-weight:600}
 .mdb-landing__shots{display:grid;grid-auto-flow:column;grid-auto-columns:min(78%,420px);gap:16px;overflow-x:auto;padding-bottom:8px;scroll-snap-type:x mandatory}
 .mdb-landing__shot{margin:0;scroll-snap-align:start}
@@ -706,11 +961,14 @@ async function renderHavenAppLandingPage(options = {}) {
   }
   const titles = el("div");
   titles.append(el("p", "mdb-landing__eyebrow", strings.eyebrow), el("h1", "mdb-landing__title", label));
-  const meta = [format(strings.from, { origin })];
+  const meta = el("p", "mdb-landing__meta");
   if (listing?.publisher) {
-    meta.unshift(format(strings.by, { publisher: listing.publisher.name }));
+    const [before, after = ""] = strings.by.split("{publisher}");
+    const name = listing.publisher.url ? Object.assign(externalLink(listing.publisher.url), { textContent: listing.publisher.name }) : listing.publisher.name;
+    meta.append(before ?? "", name, after, " \xB7 ");
   }
-  titles.append(el("p", "mdb-landing__meta", meta.join(" \xB7 ")));
+  meta.append(format(strings.from, { origin }));
+  titles.append(meta);
   head.append(titles);
   card.append(head);
   const summary = resolveMindooDBAppLocalizedText(listing?.summary, locale) || definition?.description || strings.fallbackSummary;
@@ -722,11 +980,16 @@ async function renderHavenAppLandingPage(options = {}) {
   button.dataset.testid = "haven-app-landing-install";
   cta.append(button, el("p", "mdb-landing__hint", format(strings.ctaHint, { label })));
   card.append(cta);
+  const descriptionMarkdown = resolveMindooDBAppLocalizedText(listing?.descriptionMarkdown, locale);
   const description = resolveMindooDBAppLocalizedText(listing?.description, locale);
-  if (description) {
+  if (descriptionMarkdown || description) {
     const block = el("section", "mdb-landing__description");
-    for (const paragraph of description.split(/\n\s*\n/)) {
-      if (paragraph.trim()) block.append(el("p", void 0, paragraph.trim()));
+    if (descriptionMarkdown) {
+      renderMarkdownDescription(block, descriptionMarkdown);
+    } else {
+      for (const paragraph of description.split(/\n\s*\n/)) {
+        if (paragraph.trim()) block.append(el("p", void 0, paragraph.trim()));
+      }
     }
     card.append(block);
   }
@@ -1461,11 +1724,13 @@ export {
   isLaunchedByHaven,
   isMindooDBAppBundleHash,
   isMindooDBAppDragType,
+  listingMarkdownToPlainText,
   matchHostShortcut,
   normalizeDragAccepts,
   normalizeDragPointerInput,
   normalizeDragStartInput,
   normalizeMindooDBAppBundlePath,
+  parseListingMarkdown,
   queryDocuments,
   readMindooDBAppHostingMode,
   readMindooDBAppLaunchId,
@@ -1476,6 +1741,7 @@ export {
   resolveMindooDBAppListingAssetUrl,
   resolveMindooDBAppLocalizedText,
   sanitizeHostShortcutBindings,
+  sanitizeListingHref,
   snapshotElementToPng,
   validateMindooDBAppBundleManifest,
   validateMindooDBAppDefinition,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { ay as MindooDBAppCreateViewNavigatorInput, cC as MindooDBAppViewNavigator, $ as MindooDBAppBridgeRpcRequest, b7 as MindooDBAppHostTheme, ag as MindooDBAppCapability, i as MindooDBAppDefinition, e as MindooDBAppBridge, cc as MindooDBAppSession, bE as MindooDBAppProposeAppInput, cK as MindooDBAppViewport, cw as MindooDBAppUiPreferences, bK as MindooDBAppQueryResult, cJ as MindooDBAppViewUpdateStats, X as MindooDBAppBridgePortMessage, bl as MindooDBAppLaunchContext, az as MindooDBAppDatabaseInfo, aI as MindooDBAppDocumentApi, cE as MindooDBAppViewNavigatorOpenOptions, A as MindooDBAppAttachmentApi, b8 as MindooDBAppIdentityApi, cs as MindooDBAppTimestampApi, aG as MindooDBAppDirectoryApi, k as MindooDBAppDocument, b4 as MindooDBAppFulltextSetup, b3 as MindooDBAppExtractionSetup, ck as MindooDBAppSummarySetup, bF as MindooDBAppProposeAppResult, c as MindooDBAppDragStartResult, aZ as MindooDBAppDragProfile } from '../types-CsKw_niD.js';
+import { ay as MindooDBAppCreateViewNavigatorInput, cC as MindooDBAppViewNavigator, $ as MindooDBAppBridgeRpcRequest, b7 as MindooDBAppHostTheme, ag as MindooDBAppCapability, i as MindooDBAppDefinition, e as MindooDBAppBridge, cc as MindooDBAppSession, bE as MindooDBAppProposeAppInput, cK as MindooDBAppViewport, cw as MindooDBAppUiPreferences, bK as MindooDBAppQueryResult, cJ as MindooDBAppViewUpdateStats, X as MindooDBAppBridgePortMessage, bl as MindooDBAppLaunchContext, az as MindooDBAppDatabaseInfo, aI as MindooDBAppDocumentApi, cE as MindooDBAppViewNavigatorOpenOptions, A as MindooDBAppAttachmentApi, b8 as MindooDBAppIdentityApi, cs as MindooDBAppTimestampApi, aG as MindooDBAppDirectoryApi, k as MindooDBAppDocument, b4 as MindooDBAppFulltextSetup, b3 as MindooDBAppExtractionSetup, ck as MindooDBAppSummarySetup, bF as MindooDBAppProposeAppResult, c as MindooDBAppDragStartResult, aZ as MindooDBAppDragProfile } from '../types-CX-o1Xyq.js';
 import * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 

package/dist/{types-CsKw_niD.d.ts → types-CX-o1Xyq.d.ts}

@@ -118,6 +118,13 @@ interface MindooDBAppDefinitionListing {
     summary?: MindooDBAppLocalizedText;
     /** Longer plain text. Blank lines separate paragraphs; no markup is rendered. */
     description?: MindooDBAppLocalizedText;
+    /**
+     * The same description with formatting: the Markdown subset of `listingMarkdown.ts`
+     * (paragraphs, headings, lists, bold/italic, code, `https:`/`mailto:` links).
+     * Readers that know this field show it instead of `description`; older ones ignore it
+     * and keep showing `description`, so set both when older Haven versions matter.
+     */
+    descriptionMarkdown?: MindooDBAppLocalizedText;
     /** Square icon, path relative to the app origin or an absolute `https:` URL. */
     icon?: string;
     screenshots?: MindooDBAppDefinitionScreenshot[];

package/dist/vite/index.d.ts

@@ -26,22 +26,35 @@ interface HavenBundleOptions {
 }
 interface ResolvedViteConfig {
     root: string;
+    command?: "build" | "serve";
     build: {
         outDir: string;
     };
+    server?: {
+        host?: string | boolean;
+        port?: number;
+    };
+}
+interface ShareHtmlContext {
+    filename?: string;
+    server?: {
+        resolvedUrls?: {
+            local?: string[];
+        } | null;
+    };
 }
 /** Structural subset of Vite's `Plugin`, so the SDK does not need to depend on Vite. */
 interface HavenBundleVitePlugin {
     name: string;
-    apply: "build";
+    /**
+     * Runs in dev and in build. The zip is still build-only; dev needs the same plugin so
+     * `index.html` carries the share tags while `vite dev` is serving it.
+     */
     configResolved: (config: ResolvedViteConfig) => void;
+    transformIndexHtml: (html: string, ctx: ShareHtmlContext) => Promise<string>;
     writeBundle: () => Promise<void>;
     closeBundle: () => Promise<void>;
 }
-/**
- * Emits `haven-bundle.json` and `haven-bundle.zip` next to the build output so a MindooDB
- * host can install and update the app from a URL.
- */
 declare function havenBundle(options?: HavenBundleOptions): HavenBundleVitePlugin;
 
 export { type HavenBundleOptions, type HavenBundleVitePlugin, havenBundle };

package/dist/vite/index.js

@@ -11,6 +11,127 @@ import { createHash } from "crypto";
 import { access, readdir, readFile, writeFile } from "fs/promises";
 import path from "path";
 
+// src/shareMeta.ts
+var SUMMARY_CARD = "summary";
+function escapeText(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeAttr(value) {
+  return escapeText(value).replace(/"/g, "&quot;").replace(/[\t\n\r]/g, " ");
+}
+function meta(attr, key, content) {
+  return `<meta ${attr}="${key}" content="${escapeAttr(content)}">`;
+}
+function localized(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return "";
+  }
+  const record = value;
+  if (typeof record.en === "string" && record.en.trim()) {
+    return record.en.trim();
+  }
+  for (const text of Object.values(record)) {
+    if (typeof text === "string" && text.trim()) {
+      return text.trim();
+    }
+  }
+  return "";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function havenAppPublicUrl(raw) {
+  if (!isRecord(raw)) {
+    return void 0;
+  }
+  return havenAppSharePageUrl(raw.publicUrl);
+}
+function havenAppSharePageUrl(value) {
+  if (typeof value !== "string" || !value.trim()) {
+    return void 0;
+  }
+  try {
+    const url = new URL(value.trim());
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return void 0;
+    }
+    return url.origin + "/";
+  } catch {
+    return void 0;
+  }
+}
+function absoluteRasterUrl(asset, pageUrl) {
+  if (/\.svg($|\?)/i.test(asset)) {
+    return void 0;
+  }
+  try {
+    const url = new URL(asset, pageUrl);
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return void 0;
+    }
+    return url.href;
+  } catch {
+    return void 0;
+  }
+}
+function havenAppShareMeta(raw, pageUrl) {
+  const page = havenAppSharePageUrl(pageUrl);
+  if (!isRecord(raw) || !page) {
+    return void 0;
+  }
+  const title = typeof raw.label === "string" ? raw.label.trim() : "";
+  if (!title) {
+    return void 0;
+  }
+  const listing = isRecord(raw.listing) ? raw.listing : void 0;
+  const summary = localized(listing?.summary);
+  const descriptionText = localized(listing?.description);
+  const description = summary || descriptionText.split(/\n\s*\n/)[0]?.trim() || (typeof raw.description === "string" ? raw.description.trim() : "");
+  const icon = typeof listing?.icon === "string" ? listing.icon.trim() : "";
+  const imageUrl = icon ? absoluteRasterUrl(icon, page) : void 0;
+  return { title, description, pageUrl: page, ...imageUrl ? { imageUrl } : {} };
+}
+function renderHavenAppShareMeta(metaData) {
+  const lines = [
+    "<!-- mindoodb-share -->",
+    meta("name", "description", metaData.description),
+    meta("property", "og:type", "website"),
+    meta("property", "og:title", metaData.title),
+    meta("property", "og:description", metaData.description),
+    meta("property", "og:url", metaData.pageUrl)
+  ];
+  if (metaData.imageUrl) {
+    lines.push(meta("property", "og:image", metaData.imageUrl), meta("property", "og:image:alt", metaData.title));
+  }
+  lines.push(
+    meta("name", "twitter:card", SUMMARY_CARD),
+    meta("name", "twitter:title", metaData.title),
+    meta("name", "twitter:description", metaData.description)
+  );
+  if (metaData.imageUrl) {
+    lines.push(meta("name", "twitter:image", metaData.imageUrl));
+  }
+  lines.push("<!-- /mindoodb-share -->");
+  return lines.filter((line) => !line.includes('content=""')).join("\n");
+}
+var TITLE_PATTERN = /<title>[^<]*<\/title>/i;
+function injectHavenAppShareMeta(html, metaData) {
+  if (html.includes("<!-- mindoodb-share -->")) {
+    return html;
+  }
+  const block = renderHavenAppShareMeta(metaData);
+  const titled = TITLE_PATTERN.test(html) ? html.replace(TITLE_PATTERN, `<title>${escapeText(metaData.title)}</title>`) : html;
+  const headEnd = titled.search(/<\/head>/i);
+  if (headEnd === -1) {
+    return titled;
+  }
+  return `${titled.slice(0, headEnd)}${block}
+${titled.slice(headEnd)}`;
+}
+
 // src/vite/zip.ts
 import { deflateRawSync } from "zlib";
 var CRC32_TABLE = (() => {
@@ -229,11 +350,26 @@ async function readPackageMetadata(root) {
     return { name: void 0, version: void 0 };
   }
 }
+function devPageUrl(config, ctx) {
+  const local = ctx.server?.resolvedUrls?.local ?? [];
+  const fromServer = havenAppSharePageUrl(local.find((url) => url.includes("127.0.0.1")) ?? local[0]);
+  if (fromServer) {
+    return fromServer;
+  }
+  const port = config.server?.port;
+  if (!port) {
+    return void 0;
+  }
+  const host = config.server?.host;
+  const hostname = !host || host === true || host === "0.0.0.0" ? "127.0.0.1" : host;
+  return havenAppSharePageUrl(`http://${hostname}:${port}/`);
+}
 function havenBundle(options = {}) {
   let resolvedConfig = null;
   let emitted = false;
+  let isBuild = true;
   async function emitBundle() {
-    if (emitted) {
+    if (!isBuild || emitted) {
       return;
     }
     if (!resolvedConfig) {
@@ -296,9 +432,27 @@ function havenBundle(options = {}) {
   }
   return {
     name: "haven-bundle",
-    apply: "build",
     configResolved(config) {
       resolvedConfig = config;
+      isBuild = config.command !== "serve";
+    },
+    async transformIndexHtml(html, ctx) {
+      if (!resolvedConfig || ctx.filename?.includes("__haven-test")) {
+        return html;
+      }
+      let raw;
+      try {
+        raw = JSON.parse(await readFile(path.join(resolvedConfig.root, "public", "haven-app.json"), "utf8"));
+      } catch {
+        return html;
+      }
+      const baked = havenAppPublicUrl(raw);
+      const pageUrl = resolvedConfig.command === "serve" ? devPageUrl(resolvedConfig, ctx) ?? baked : baked;
+      if (!pageUrl) {
+        return html;
+      }
+      const meta2 = havenAppShareMeta(raw, pageUrl);
+      return meta2 ? injectHavenAppShareMeta(html, meta2) : html;
     },
     async writeBundle() {
       await emitBundle();

package/package.json

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