jmapcloud-ng-types 2.0.13-qa.5 → 2.0.13-qa.7

package/index.ts

@@ -2,7 +2,7 @@ import type { JAppMessageService, JEventModule } from "jmapcloud-ng-core-types"
 
 // Re-exported so existing `import { JAppMessageService } from "jmapcloud-ng-types"`
 // callers keep resolving after the slice moved into ng-core-types.
-export type { JAppMessageService } from "jmapcloud-ng-core-types"
+export type { JAppMessageService, JAppRenderableMessage } from "jmapcloud-ng-core-types"
 
 export interface JAppState {
   panel: JAppPanelState

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jmapcloud-ng-types",
-  "version": "2.0.13-qa.5",
+  "version": "2.0.13-qa.7",
   "description": "JMap Cloud specific version of JMap Cloud NG types and interfaces",
   "main": "src/app.ts",
   "types": "ambient.d.ts",

package/public/app.d.ts

@@ -3346,6 +3346,19 @@ declare global {
          *
          * The optional onCancel callback is called when the cancel button is clicked.
          *
+         * Message content has three intended forms:
+         * - Plain text: `message: "Delete project foo?"`
+         * - Sanitized HTML string:
+         *   `message: { kind: "html", value: "Delete <b>foo</b>?", policy: "dialog" }`
+         *   This is especially useful with translated rich strings, for example:
+         *   `message: { kind: "html", value: JMap.Language.translate("project.delete.message", { projectName: "<b>My project</b>" }), policy: "dialog" }`
+         * - JSX / ReactNode:
+         *   `message: { kind: "node", value: <>Delete <strong>{project.name}</strong>?</> }`
+         *
+         * Plain text is the default. Prefer JSX / node
+         * content when formatting is needed; use HTML only for legacy rich
+         * string flows that still require sanitization at render time.
+         *
          * @param params message parameters
          * @example
          * ```ts

package/public/panel.d.ts

@@ -1,3 +1,4 @@
+import type { JAppRenderableMessage } from "jmapcloud-ng-core-types"
 export {}
 export interface JAppPanelActivationParams {
   ignoreConfirmationMessage?: boolean
@@ -9,7 +10,13 @@ export interface JAppPanelDeactivationParams extends JAppPanelActivationParams {
 
 export interface JAppPanelLeaveResponse {
   title: string
-  message: string
+  /**
+   * Same contract as confirm-message content:
+   * - bare `string` means plain text by default
+   * - rich HTML must be explicit and sanitized by the renderer
+   * - JSX / node content is preferred when formatting is needed
+   */
+  message: JAppRenderableMessage | string
 }
 
 export interface JAppPanel {