@knime/product-features 6.1.1 → 6.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @knime/product-features
 
+## 6.2.0
+
+### Minor Changes
+
+- 96e525c: `embedding`: Add a new package that establishes the contract for embedding the workflow editor in a shadow root. This package also owns the declaration of features that are injected into the embedded application over the embedding boundary. For more information, refer to the README of the `embedding` package
+
+  `rfcErrors`: `toToast` keeps the error data in `meta.rfcError` (`RFC_ERROR_TOAST_META_KEY`), so the toast can be rebuilt where its component cannot be rendered.
+
+## 6.1.2
+
+### Patch Changes
+
+- Updated dependencies [d61ae48]
+  - @knime/kds-components@13.0.0
+  - @knime/kds-styles@13.0.0
+
 ## 6.1.1
 
 ### Patch Changes

package/README.md

@@ -23,18 +23,19 @@ Peer dependencies: `@knime/kds-components`, `@knime/kds-styles`, `@vueuse/core`,
 This package has **no root export** — import from one of the subpath entry
 points, so consumers only pull in the feature area they use:
 
-| Entry point                                  | Source                     | Contents                                                                    |
-| -------------------------------------------- | -------------------------- | --------------------------------------------------------------------------- |
-| `@knime/product-features/ai`                 | `src/ai`                   | AI assistant building blocks (`KdsPromptInput`)                             |
-| `@knime/product-features/analytics`          | `src/analytics`            | Typed analytics event builders ([README](src/analytics/README.md))          |
-| `@knime/product-features/auth-utils`         | `src/authUtils`            | KNIME Hub auth refresher and auth state ([README](src/authUtils/README.md)) |
-| `@knime/product-features/data-transfer`      | `src/dataTransfer`         | File upload/download progress panels and composables                        |
-| `@knime/product-features/data-transfer/core` | `src/dataTransfer/core.ts` | Framework-agnostic upload managers and upload client                        |
-| `@knime/product-features/embedding-sdk`      | `src/embeddingSDK`         | Host/guest messaging for embedding an application in an iframe              |
-| `@knime/product-features/nodes`              | `src/nodes`                | Node description tabs and node preview                                      |
-| `@knime/product-features/rfc-errors`         | `src/rfcErrors`            | RFC 9457 problem-details error handling and error toasts                    |
-| `@knime/product-features/toasts`             | `src/toasts`               | Toast notifications                                                         |
-| `@knime/product-features/versions`           | `src/versions`             | Version history and create-version form                                     |
+| Entry point                                  | Source                     | Contents                                                                               |
+| -------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------- |
+| `@knime/product-features/ai`                 | `src/ai`                   | AI assistant building blocks (`KdsPromptInput`)                                        |
+| `@knime/product-features/analytics`          | `src/analytics`            | Typed analytics event builders ([README](src/analytics/README.md))                     |
+| `@knime/product-features/auth-utils`         | `src/authUtils`            | KNIME Hub auth refresher and auth state ([README](src/authUtils/README.md))            |
+| `@knime/product-features/data-transfer`      | `src/dataTransfer`         | File upload/download progress panels and composables                                   |
+| `@knime/product-features/data-transfer/core` | `src/dataTransfer/core.ts` | Framework-agnostic upload managers and upload client                                   |
+| `@knime/product-features/embedding`          | `src/embedding`            | Contract for embedding the editor in a shadow root ([README](src/embedding/README.md)) |
+| `@knime/product-features/embedding-sdk`      | `src/embeddingSDK`         | Host/guest messaging for embedding an application in an iframe                         |
+| `@knime/product-features/nodes`              | `src/nodes`                | Node description tabs and node preview                                                 |
+| `@knime/product-features/rfc-errors`         | `src/rfcErrors`            | RFC 9457 problem-details error handling and error toasts                               |
+| `@knime/product-features/toasts`             | `src/toasts`               | Toast notifications                                                                    |
+| `@knime/product-features/versions`           | `src/versions`             | Version history and create-version form                                                |
 
 ```ts
 // ✅ import from a subpath

package/dist/dataTransfer.js

@@ -1,6 +1,6 @@
 import { t as _plugin_vue_export_helper_default } from "./_plugin-vue_export-helper-BOaGB7Aw.js";
 import { a as getFileExtension, c as promise_exports, l as sleep, r as formatFileSize, s as knimeFileFormats } from "./dist-htLRPkoq.js";
-import { t as rfcErrors } from "./rfcErrors-C59cEDGj.js";
+import { n as rfcErrors } from "./rfcErrors-CNWg8BiD.js";
 import { a as createUploadManager, c as API_BASE_URL, n as createUploadClient, o as createHttpClient, s as defaultConfig, t as createUploadStatusPoller } from "./core-CIwP11Fc.js";
 import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, normalizeClass, normalizeStyle, openBlock, ref, renderList, renderSlot, toDisplayString, unref, useId, useModel, vShow, watch, withCtx, withDirectives } from "vue";
 import { KdsBadge, KdsButton, KdsIcon, KdsLoadingSkeleton, KdsProgressBar, vKdsTooltip } from "@knime/kds-components";

package/dist/embedding.js

@@ -0,0 +1,74 @@
+import { n as rfcErrors, t as RFC_ERROR_TOAST_META_KEY } from "./rfcErrors-CNWg8BiD.js";
+//#region src/embedding/outlets/spaceExplorer.ts
+/**
+* Keep only the capabilities that this contract version knows.
+*/
+var resolveSpaceExplorerGuestCapabilities = (declared) => ({ ...declared.itemDrop && { itemDrop: true } });
+var resolveSpaceExplorerHostCapabilities = (declared) => ({ ...declared.revealItem && { revealItem: true } });
+//#endregion
+//#region src/embedding/outlets/index.ts
+var outletCapabilityResolvers = { spaceExplorer: {
+	guest: resolveSpaceExplorerGuestCapabilities,
+	host: resolveSpaceExplorerHostCapabilities
+} };
+//#endregion
+//#region src/embedding/capabilities.ts
+/**
+* Version of `@knime/product-features` that this build uses. Informational
+* only: logs, support, deprecation tracking. It never gates behavior.
+*/
+var contractVersion = "6.2.0";
+/**
+* Outlets that both sides declare. Capabilities that this contract version does not know are
+* dropped.
+*/
+var resolveOutlets = (guest, host) => {
+	const resolved = {};
+	for (const [name, resolvers] of Object.entries(outletCapabilityResolvers)) {
+		const guestDeclared = guest.outlets?.[name];
+		const hostDeclared = host.outlets?.[name];
+		if (guestDeclared && hostDeclared) resolved[name] = {
+			guest: resolvers.guest(guestDeclared),
+			host: resolvers.host(hostDeclared)
+		};
+	}
+	return resolved;
+};
+//#endregion
+//#region src/embedding/toasts.ts
+/**
+* Guest: turns a toast into data the host can render. An RFC error toast
+* keeps its error data. Any other component is dropped, because the host
+* cannot render a component from the guest's Vue runtime.
+*/
+var toHostToast = (toast) => {
+	const { component, meta, ...rest } = toast;
+	const rfcError = meta?.[RFC_ERROR_TOAST_META_KEY];
+	if (component && !rfcError) consola.warn("Embedding: dropped the component of a toast", toast);
+	return {
+		...rest,
+		...meta && { meta },
+		...rfcError && { rfcError }
+	};
+};
+/**
+* Host: turns a toast from the guest into a toast for its own
+* toast service context.
+*/
+var fromHostToast = (hostToast) => {
+	const { rfcError, ...toast } = hostToast;
+	if (!rfcError) return toast;
+	return {
+		...toast,
+		...rfcErrors.toToast({
+			headline: toast.headline ?? "",
+			rfcError: new rfcErrors.RFCError(rfcError.data),
+			canCopyToClipboard: rfcError.canCopyToClipboard,
+			serializeErrorForClipboard: rfcError.serializeErrorForClipboard
+		})
+	};
+};
+//#endregion
+export { contractVersion, fromHostToast, resolveOutlets, toHostToast };
+
+//# sourceMappingURL=embedding.js.map

package/dist/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.js","names":[],"sources":["../src/embedding/outlets/spaceExplorer.ts","../src/embedding/outlets/index.ts","../src/embedding/capabilities.ts","../src/embedding/toasts.ts"],"sourcesContent":["/**\n * An item that the space explorer drags onto the canvas.\n */\nexport type SpaceExplorerDragItem = {\n  spaceId: string;\n  itemId: string;\n  name: string;\n  type: string;\n};\n\n/**\n * Drags items from the space explorer onto the another container. This allows custom control\n * over rendering a drag preview and also running custom logic when an item is dropped onto another\n * container.\n */\nexport type SpaceExplorerItemDrop = {\n  start: (item: SpaceExplorerDragItem) => void;\n  /**\n   * When `accepts` is true, the space explorer hides its own drag ghost.\n   */\n  move: (clientX: number, clientY: number) => { accepts: boolean };\n  /**\n   * Resolves to whether the guest added the item.\n   */\n  end: (clientX: number, clientY: number) => Promise<boolean>;\n  cancel: () => void;\n};\n\n/**\n * Announced by the guest when the element the outlet will render to exists.\n */\nexport type SpaceExplorerOutletHandle = {\n  name: \"spaceExplorer\";\n  /**\n   * A stable, empty element. Must not be patched/removed by the guest\n   */\n  element: HTMLElement;\n  /**\n   * Present when both sides declare `itemDrop`.\n   */\n  itemDrop?: SpaceExplorerItemDrop;\n};\n\n/**\n * The space explorer's public api. Returned after `announce`ing the feature.\n */\nexport type SpaceExplorerFeatureAPI = {\n  /**\n   * Shows the item: its parent folder, with the item selected. Present when\n   * the host declares `revealItem`.\n   */\n  revealItem?: (item: { spaceId: string; itemId: string }) => void;\n};\n\n/**\n * Capabilities the space explorer expects the guest to implement\n */\nexport type SpaceExplorerGuestCapabilities = {\n  itemDrop?: true;\n};\n\n/**\n * Capabilities the space explorer of the host offers to the guest for public/direct usage\n * (all behavior is normally self-contained).\n */\nexport type SpaceExplorerHostCapabilities = {\n  revealItem?: true;\n};\n\n/**\n * Keep only the capabilities that this contract version knows.\n */\nexport const resolveSpaceExplorerGuestCapabilities = (\n  declared: SpaceExplorerGuestCapabilities,\n): SpaceExplorerGuestCapabilities => ({\n  ...(declared.itemDrop && { itemDrop: true }),\n});\n\nexport const resolveSpaceExplorerHostCapabilities = (\n  declared: SpaceExplorerHostCapabilities,\n): SpaceExplorerHostCapabilities => ({\n  ...(declared.revealItem && { revealItem: true }),\n});\n","import {\n  type SpaceExplorerFeatureAPI,\n  type SpaceExplorerGuestCapabilities,\n  type SpaceExplorerHostCapabilities,\n  type SpaceExplorerOutletHandle,\n  resolveSpaceExplorerGuestCapabilities,\n  resolveSpaceExplorerHostCapabilities,\n} from \"./spaceExplorer\";\n\n/**\n * Outlets the guest can expose (the editor in this case). Each outlet contains one feature of the host.\n */\nexport type OutletHandle = SpaceExplorerOutletHandle;\n\nexport type OutletName = OutletHandle[\"name\"];\n\nexport type OutletRegistry = {\n  spaceExplorer: SpaceExplorerFeatureAPI;\n};\n\nexport type GuestCapabilitiesForOutlet = {\n  spaceExplorer: SpaceExplorerGuestCapabilities;\n};\n\nexport type HostCapabilitiesForOutlet = {\n  spaceExplorer: SpaceExplorerHostCapabilities;\n};\n\nexport const outletCapabilityResolvers: {\n  [N in OutletName]: {\n    guest: (\n      declared: GuestCapabilitiesForOutlet[N],\n    ) => GuestCapabilitiesForOutlet[N];\n    host: (\n      declared: HostCapabilitiesForOutlet[N],\n    ) => HostCapabilitiesForOutlet[N];\n  };\n} = {\n  spaceExplorer: {\n    guest: resolveSpaceExplorerGuestCapabilities,\n    host: resolveSpaceExplorerHostCapabilities,\n  },\n};\n\nexport type {\n  SpaceExplorerDragItem,\n  SpaceExplorerFeatureAPI,\n  SpaceExplorerItemDrop,\n  SpaceExplorerOutletHandle,\n} from \"./spaceExplorer\";\n","import {\n  type GuestCapabilitiesForOutlet,\n  type HostCapabilitiesForOutlet,\n  type OutletName,\n  outletCapabilityResolvers,\n} from \"./outlets\";\n\n/**\n * Version of `@knime/product-features` that this build uses. Informational\n * only: logs, support, deprecation tracking. It never gates behavior.\n */\nexport const contractVersion: string = __PRODUCT_FEATURES_VERSION__;\n\n/**\n * Static declaration of the guest app. The host reads it before embedding.\n */\nexport type GuestCapabilities = {\n  contractVersion: string;\n  /**\n   * Outlets the guest declares and supports. The host does not send a feature\n   * for an outlet the guest does not support\n   */\n  outlets: Partial<GuestCapabilitiesForOutlet>;\n};\n\n/**\n * Static declaration of the host, passed as context for mounting the embedded guest\n */\nexport type HostCapabilities = {\n  contractVersion: string;\n  /**\n   * Outlets the host has features for. The guest does not render an outlet that the\n   * host cannot provide.\n   */\n  outlets: Partial<HostCapabilitiesForOutlet>;\n};\n\nexport type ResolvedOutlets = {\n  [N in OutletName]?: {\n    guest: GuestCapabilitiesForOutlet[N];\n    host: HostCapabilitiesForOutlet[N];\n  };\n};\n\n/**\n * Outlets that both sides declare. Capabilities that this contract version does not know are\n * dropped.\n */\nexport const resolveOutlets = (\n  guest: GuestCapabilities,\n  host: HostCapabilities,\n): ResolvedOutlets => {\n  const resolved: ResolvedOutlets = {};\n\n  for (const [name, resolvers] of Object.entries(outletCapabilityResolvers)) {\n    const guestDeclared = guest.outlets?.[name as OutletName];\n    const hostDeclared = host.outlets?.[name as OutletName];\n    if (guestDeclared && hostDeclared) {\n      resolved[name as OutletName] = {\n        guest: resolvers.guest(guestDeclared),\n        host: resolvers.host(hostDeclared),\n      };\n    }\n  }\n\n  return resolved;\n};\n","import {\n  type RFCErrorToastMeta,\n  RFC_ERROR_TOAST_META_KEY,\n  rfcErrors,\n} from \"../rfcErrors\";\nimport type { Toast } from \"../toasts\";\n\nimport type { HostToast } from \"./types\";\n\n/**\n * Guest: turns a toast into data the host can render. An RFC error toast\n * keeps its error data. Any other component is dropped, because the host\n * cannot render a component from the guest's Vue runtime.\n */\nexport const toHostToast = (toast: Toast): HostToast => {\n  const { component, meta, ...rest } = toast;\n  const rfcError = meta?.[RFC_ERROR_TOAST_META_KEY] as\n    RFCErrorToastMeta | undefined;\n\n  if (component && !rfcError) {\n    consola.warn(\"Embedding: dropped the component of a toast\", toast);\n  }\n\n  return {\n    ...rest,\n    ...(meta && { meta }),\n    ...(rfcError && { rfcError }),\n  };\n};\n\n/**\n * Host: turns a toast from the guest into a toast for its own\n * toast service context.\n */\nexport const fromHostToast = (hostToast: HostToast): Toast => {\n  const { rfcError, ...toast } = hostToast;\n\n  if (!rfcError) {\n    return toast;\n  }\n\n  return {\n    ...toast,\n    ...rfcErrors.toToast({\n      headline: toast.headline ?? \"\",\n      rfcError: new rfcErrors.RFCError(rfcError.data),\n      canCopyToClipboard: rfcError.canCopyToClipboard,\n      serializeErrorForClipboard: rfcError.serializeErrorForClipboard,\n    }),\n  };\n};\n"],"mappings":";;;;;AAwEA,IAAa,yCACX,cACoC,EACpC,GAAI,SAAS,YAAY,EAAE,UAAU,KAAK,EAC5C;AAEA,IAAa,wCACX,cACmC,EACnC,GAAI,SAAS,cAAc,EAAE,YAAY,KAAK,EAChD;;;ACtDA,IAAa,4BAST,EACF,eAAe;CACb,OAAO;CACP,MAAM;AACR,EACF;;;;;;;AC/BA,IAAa,kBAAA;;;;;AAqCb,IAAa,kBACX,OACA,SACoB;CACpB,MAAM,WAA4B,CAAC;CAEnC,KAAK,MAAM,CAAC,MAAM,cAAc,OAAO,QAAQ,yBAAyB,GAAG;EACzE,MAAM,gBAAgB,MAAM,UAAU;EACtC,MAAM,eAAe,KAAK,UAAU;EACpC,IAAI,iBAAiB,cACnB,SAAS,QAAsB;GAC7B,OAAO,UAAU,MAAM,aAAa;GACpC,MAAM,UAAU,KAAK,YAAY;EACnC;CAEJ;CAEA,OAAO;AACT;;;;;;;;ACpDA,IAAa,eAAe,UAA4B;CACtD,MAAM,EAAE,WAAW,MAAM,GAAG,SAAS;CACrC,MAAM,WAAW,OAAO;CAGxB,IAAI,aAAa,CAAC,UAChB,QAAQ,KAAK,+CAA+C,KAAK;CAGnE,OAAO;EACL,GAAG;EACH,GAAI,QAAQ,EAAE,KAAK;EACnB,GAAI,YAAY,EAAE,SAAS;CAC7B;AACF;;;;;AAMA,IAAa,iBAAiB,cAAgC;CAC5D,MAAM,EAAE,UAAU,GAAG,UAAU;CAE/B,IAAI,CAAC,UACH,OAAO;CAGT,OAAO;EACL,GAAG;EACH,GAAG,UAAU,QAAQ;GACnB,UAAU,MAAM,YAAY;GAC5B,UAAU,IAAI,UAAU,SAAS,SAAS,IAAI;GAC9C,oBAAoB,SAAS;GAC7B,4BAA4B,SAAS;EACvC,CAAC;CACH;AACF"}

package/dist/{rfcErrors-C59cEDGj.js → rfcErrors-CNWg8BiD.js}

@@ -125,6 +125,11 @@ var RFCError = class extends Error {
 //#endregion
 //#region src/rfcErrors/index.ts
 /**
+* Key in `Toast.meta` under which `toToast` keeps the error data, so the toast
+* can be rebuilt where its component cannot be rendered.
+*/
+var RFC_ERROR_TOAST_META_KEY = "rfcError";
+/**
 * Map to a toast template component compatible with an RFCError format
 */
 var toToast = ({ headline, rfcError, canCopyToClipboard = true, serializeErrorForClipboard = void 0 }) => {
@@ -138,7 +143,12 @@ var toToast = ({ headline, rfcError, canCopyToClipboard = true, serializeErrorFo
 			canCopyToClipboard,
 			serializeErrorForClipboard
 		}),
-		autoRemove: false
+		autoRemove: false,
+		meta: { [RFC_ERROR_TOAST_META_KEY]: {
+			data,
+			canCopyToClipboard,
+			serializeErrorForClipboard
+		} }
 	};
 };
 var isFetchError = (error) => {
@@ -167,6 +177,6 @@ var rfcErrors = {
 	RFCError
 };
 //#endregion
-export { rfcErrors as t };
+export { rfcErrors as n, RFC_ERROR_TOAST_META_KEY as t };
 
-//# sourceMappingURL=rfcErrors-C59cEDGj.js.map
+//# sourceMappingURL=rfcErrors-CNWg8BiD.js.map

package/dist/{rfcErrors-C59cEDGj.js.map → rfcErrors-CNWg8BiD.js.map}

@@ -1 +1 @@
-{"version":3,"file":"rfcErrors-C59cEDGj.js","names":[],"sources":["../src/rfcErrors/serializeRFCErrorData.ts","../src/rfcErrors/RFCErrorToastTemplate.vue","../src/rfcErrors/RFCErrorToastTemplate.vue","../src/rfcErrors/types.ts","../src/rfcErrors/index.ts"],"sourcesContent":["import type { RFCErrorData } from \"./types\";\n\nexport const serializeErrorForClipboard = (\n  error: RFCErrorData,\n  headline: string,\n  formatDate: (date: Date) => string,\n): string => {\n  let details = \"\";\n  if (error.details?.length) {\n    if (error.details.length > 1) {\n      const detailLines = error.details\n        .map((item) => `\\u2022 ${item}`)\n        .join(\"\\n\");\n      details = `\\n${detailLines}`;\n    } else {\n      details = error.details[0];\n    }\n  }\n\n  let errorText = `${headline}\\n\\n`;\n  errorText += `${error.title}\\n\\n`;\n  errorText += details ? `Details: ${details}\\n\\n` : \"\";\n\n  if (error.status !== undefined) {\n    errorText += `Status: ${error.status}\\n`;\n  }\n\n  if (error.date) {\n    errorText += `Date: ${formatDate(error.date)}\\n`;\n  }\n\n  if (error.requestId) {\n    errorText += `Request Id: ${error.requestId}\\n`;\n  }\n\n  if (error.errorId) {\n    errorText += `Error Id: ${error.errorId}\\n`;\n  }\n\n  if (error.stacktrace) {\n    errorText += \"------\\n\"; // separator\n    errorText += `Stacktrace:\\n\\n${error.stacktrace}\\n`;\n  }\n\n  return errorText;\n};\n","<script setup lang=\"ts\">\nimport { ref } from \"vue\";\nimport { useClipboard } from \"@vueuse/core\";\n\nimport { KdsButton } from \"@knime/kds-components\";\nimport { formatDateTimeString } from \"@knime/utils\";\n\nimport { serializeErrorForClipboard as defaultSerializeRFCErrorData } from \"./serializeRFCErrorData\";\nimport type { RFCErrorData } from \"./types\";\n\ntype Props = {\n  /**\n   * Toast headline shown in the toast title bar. Not rendered inside this\n   * template, but included when serializing the error to the clipboard.\n   */\n  headline: string;\n  /** Whether to show the \"Copy error to clipboard\" button. */\n  canCopyToClipboard?: boolean;\n  /**\n   * Custom serializer for the clipboard payload. Defaults to\n   * `serializeRFCErrorData` which formats the full error as text.\n   */\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n} & RFCErrorData;\n\nconst {\n  headline,\n  canCopyToClipboard = true,\n  serializeErrorForClipboard = defaultSerializeRFCErrorData,\n  ...rfcError\n} = defineProps<Props>();\n\nconst emits = defineEmits([\"showMore\"]);\n\nconst { copy, copied } = useClipboard({\n  copiedDuring: 3000,\n});\n\nconst hasDetails =\n  rfcError.details?.length ||\n  rfcError.status !== undefined ||\n  rfcError.date !== undefined ||\n  rfcError.requestId !== undefined ||\n  rfcError.errorId !== undefined;\n// don't show 'Show details' button if there are no details to show\nconst showDetails = ref(!hasDetails);\n\nconst formatDate = (date: Date): string =>\n  date ? formatDateTimeString(date.getTime()) : \"\";\n\nconst copyToClipboard = () => {\n  if (copied.value) {\n    return;\n  }\n  copy(serializeErrorForClipboard(rfcError, headline, formatDate)).catch(\n    (error) => {\n      consola.error(\"Failed to copy to clipboard\", { error });\n    },\n  );\n};\n\nconst onShowDetailsClicked = () => {\n  showDetails.value = true;\n  emits(\"showMore\");\n};\n</script>\n\n<template>\n  <div class=\"wrapper\">\n    <div class=\"title\">\n      {{ title }}\n    </div>\n    <div v-if=\"showDetails\">\n      <div v-if=\"details?.length\">\n        <strong>Details: </strong>\n        <template v-if=\"details.length === 1\">\n          {{ details[0] }}\n        </template>\n        <template v-else>\n          <ul class=\"details-list\">\n            <li v-for=\"(item, index) in details\" :key=\"index\">{{ item }}</li>\n          </ul>\n        </template>\n      </div>\n\n      <div v-if=\"status !== undefined\">\n        <strong>Status: </strong>{{ status }}\n      </div>\n      <div v-if=\"date\"><strong>Date: </strong>{{ formatDate(date) }}</div>\n      <div v-if=\"requestId\"><strong>Request id: </strong>{{ requestId }}</div>\n      <div v-if=\"errorId\"><strong>Error id: </strong>{{ errorId }}</div>\n      <div v-if=\"stacktrace && canCopyToClipboard\">\n        <strong>Stacktrace: </strong>Part of clipboard text\n      </div>\n    </div>\n    <div class=\"actions-wrapper\">\n      <KdsButton\n        v-if=\"!showDetails\"\n        data-testid=\"show-details\"\n        variant=\"transparent\"\n        label=\"Show details\"\n        size=\"xsmall\"\n        @click=\"onShowDetailsClicked\"\n      />\n      <KdsButton\n        v-if=\"canCopyToClipboard\"\n        data-testid=\"copy-to-clipboard\"\n        :label=\"copied ? 'Error was copied' : 'Copy error to clipboard'\"\n        :leading-icon=\"copied ? 'checkmark' : 'copy'\"\n        variant=\"transparent\"\n        size=\"xsmall\"\n        @click=\"copyToClipboard\"\n      />\n    </div>\n  </div>\n</template>\n\n<style scoped>\n.wrapper {\n  display: flex;\n  flex-direction: column;\n  gap: var(--kds-spacing-container-0-25x);\n  font: var(--kds-font-base-body-small);\n  color: var(--kds-color-text-and-icon-neutral);\n}\n\n.details-list {\n  padding-left: var(--kds-spacing-container-1-5x);\n  margin-top: var(--kds-spacing-container-0-37x);\n  margin-bottom: var(--kds-spacing-container-0-37x);\n}\n\n.actions-wrapper {\n  display: flex;\n  gap: var(--kds-spacing-container-0-5x);\n  align-items: center;\n}\n</style>\n","<script setup lang=\"ts\">\nimport { ref } from \"vue\";\nimport { useClipboard } from \"@vueuse/core\";\n\nimport { KdsButton } from \"@knime/kds-components\";\nimport { formatDateTimeString } from \"@knime/utils\";\n\nimport { serializeErrorForClipboard as defaultSerializeRFCErrorData } from \"./serializeRFCErrorData\";\nimport type { RFCErrorData } from \"./types\";\n\ntype Props = {\n  /**\n   * Toast headline shown in the toast title bar. Not rendered inside this\n   * template, but included when serializing the error to the clipboard.\n   */\n  headline: string;\n  /** Whether to show the \"Copy error to clipboard\" button. */\n  canCopyToClipboard?: boolean;\n  /**\n   * Custom serializer for the clipboard payload. Defaults to\n   * `serializeRFCErrorData` which formats the full error as text.\n   */\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n} & RFCErrorData;\n\nconst {\n  headline,\n  canCopyToClipboard = true,\n  serializeErrorForClipboard = defaultSerializeRFCErrorData,\n  ...rfcError\n} = defineProps<Props>();\n\nconst emits = defineEmits([\"showMore\"]);\n\nconst { copy, copied } = useClipboard({\n  copiedDuring: 3000,\n});\n\nconst hasDetails =\n  rfcError.details?.length ||\n  rfcError.status !== undefined ||\n  rfcError.date !== undefined ||\n  rfcError.requestId !== undefined ||\n  rfcError.errorId !== undefined;\n// don't show 'Show details' button if there are no details to show\nconst showDetails = ref(!hasDetails);\n\nconst formatDate = (date: Date): string =>\n  date ? formatDateTimeString(date.getTime()) : \"\";\n\nconst copyToClipboard = () => {\n  if (copied.value) {\n    return;\n  }\n  copy(serializeErrorForClipboard(rfcError, headline, formatDate)).catch(\n    (error) => {\n      consola.error(\"Failed to copy to clipboard\", { error });\n    },\n  );\n};\n\nconst onShowDetailsClicked = () => {\n  showDetails.value = true;\n  emits(\"showMore\");\n};\n</script>\n\n<template>\n  <div class=\"wrapper\">\n    <div class=\"title\">\n      {{ title }}\n    </div>\n    <div v-if=\"showDetails\">\n      <div v-if=\"details?.length\">\n        <strong>Details: </strong>\n        <template v-if=\"details.length === 1\">\n          {{ details[0] }}\n        </template>\n        <template v-else>\n          <ul class=\"details-list\">\n            <li v-for=\"(item, index) in details\" :key=\"index\">{{ item }}</li>\n          </ul>\n        </template>\n      </div>\n\n      <div v-if=\"status !== undefined\">\n        <strong>Status: </strong>{{ status }}\n      </div>\n      <div v-if=\"date\"><strong>Date: </strong>{{ formatDate(date) }}</div>\n      <div v-if=\"requestId\"><strong>Request id: </strong>{{ requestId }}</div>\n      <div v-if=\"errorId\"><strong>Error id: </strong>{{ errorId }}</div>\n      <div v-if=\"stacktrace && canCopyToClipboard\">\n        <strong>Stacktrace: </strong>Part of clipboard text\n      </div>\n    </div>\n    <div class=\"actions-wrapper\">\n      <KdsButton\n        v-if=\"!showDetails\"\n        data-testid=\"show-details\"\n        variant=\"transparent\"\n        label=\"Show details\"\n        size=\"xsmall\"\n        @click=\"onShowDetailsClicked\"\n      />\n      <KdsButton\n        v-if=\"canCopyToClipboard\"\n        data-testid=\"copy-to-clipboard\"\n        :label=\"copied ? 'Error was copied' : 'Copy error to clipboard'\"\n        :leading-icon=\"copied ? 'checkmark' : 'copy'\"\n        variant=\"transparent\"\n        size=\"xsmall\"\n        @click=\"copyToClipboard\"\n      />\n    </div>\n  </div>\n</template>\n\n<style scoped>\n.wrapper {\n  display: flex;\n  flex-direction: column;\n  gap: var(--kds-spacing-container-0-25x);\n  font: var(--kds-font-base-body-small);\n  color: var(--kds-color-text-and-icon-neutral);\n}\n\n.details-list {\n  padding-left: var(--kds-spacing-container-1-5x);\n  margin-top: var(--kds-spacing-container-0-37x);\n  margin-bottom: var(--kds-spacing-container-0-37x);\n}\n\n.actions-wrapper {\n  display: flex;\n  gap: var(--kds-spacing-container-0-5x);\n  align-items: center;\n}\n</style>\n","/**\n * Type based on an RFC-9457 error standard (https://www.rfc-editor.org/rfc/rfc9457)\n * Also see:\n * https://knime-com.atlassian.net/wiki/spaces/SPECS/pages/4126769212/API+Errors+Problem+Details\n */\nexport type RFCErrorData = {\n  /** Short human-readable summary of the error. */\n  title: string;\n  /** HTTP status code associated with the error. */\n  status?: number;\n  /** Date/time when the error occurred. */\n  date?: Date;\n  /** Additional human-readable detail messages. */\n  details?: string[];\n  /** Correlation id for the request that triggered the error. */\n  requestId?: string;\n  /**\n   * Id used to find an error in the Hub logs. Specially relevant\n   * when details of the error are not wanted to be exposed to the user.\n   */\n  errorId?: string;\n  /**\n   * Relevant only for the Analytics Platform, since the Hub does not expose\n   * stack traces.\n   */\n  stacktrace?: string;\n};\n\nexport class RFCError extends Error {\n  data: RFCErrorData;\n\n  constructor(data: RFCErrorData) {\n    super(data.title);\n    this.data = data;\n  }\n}\n\nexport type FetchError = {\n  response: {\n    headers: Headers;\n  };\n  statusCode: number;\n  data: {\n    title: string;\n    details: string[];\n  };\n};\n","import { h } from \"vue\";\n\nimport type { Toast } from \"../toasts\";\n\nimport RFCErrorToastTemplate from \"./RFCErrorToastTemplate.vue\";\nimport { type FetchError, RFCError, type RFCErrorData } from \"./types\";\n\n/**\n * Map to a toast template component compatible with an RFCError format\n */\nconst toToast = ({\n  headline,\n  rfcError,\n  canCopyToClipboard = true,\n  serializeErrorForClipboard = undefined,\n}: {\n  headline: string;\n  rfcError: RFCError;\n  canCopyToClipboard?: boolean;\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n}): Toast => {\n  const { data } = rfcError;\n\n  const rfcErrorToastContent = h(RFCErrorToastTemplate, {\n    headline,\n    ...data,\n    canCopyToClipboard,\n    serializeErrorForClipboard,\n  });\n\n  return {\n    type: \"error\",\n    headline,\n    component: rfcErrorToastContent,\n    autoRemove: false,\n  };\n};\n\nconst isFetchError = (error: unknown): error is FetchError => {\n  return (\n    error !== null &&\n    typeof error === \"object\" &&\n    \"response\" in error &&\n    \"statusCode\" in error &&\n    \"data\" in error\n  );\n};\n\n/**\n * Parse a generic request error to an `RFCError`.\n * When parsing is not possible it returns undefined.\n */\nconst tryParse = (error: unknown): RFCError | undefined => {\n  if (!isFetchError(error)) {\n    return undefined;\n  }\n\n  if (!error.response) {\n    return undefined;\n  }\n\n  const responseDate = error.response.headers.get(\"date\")\n    ? new Date(error.response.headers.get(\"date\")!)\n    : undefined;\n\n  const title =\n    typeof error.data === \"string\" ? error.data : (error.data?.title ?? \"\");\n\n  const rfcErrorData: RFCErrorData = {\n    title: title as string,\n    details: error.data?.details as string[] | undefined,\n    status: error.statusCode as number,\n    date: responseDate,\n    requestId: error.response.headers.get(\"x-request-id\") ?? undefined,\n    errorId: error.response.headers.get(\"x-error-id\") ?? undefined,\n  };\n\n  return new RFCError(rfcErrorData);\n};\n\nexport const rfcErrors = {\n  toToast,\n  tryParse,\n  RFCError,\n};\n"],"mappings":"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"}
+{"version":3,"file":"rfcErrors-CNWg8BiD.js","names":[],"sources":["../src/rfcErrors/serializeRFCErrorData.ts","../src/rfcErrors/RFCErrorToastTemplate.vue","../src/rfcErrors/RFCErrorToastTemplate.vue","../src/rfcErrors/types.ts","../src/rfcErrors/index.ts"],"sourcesContent":["import type { RFCErrorData } from \"./types\";\n\nexport const serializeErrorForClipboard = (\n  error: RFCErrorData,\n  headline: string,\n  formatDate: (date: Date) => string,\n): string => {\n  let details = \"\";\n  if (error.details?.length) {\n    if (error.details.length > 1) {\n      const detailLines = error.details\n        .map((item) => `\\u2022 ${item}`)\n        .join(\"\\n\");\n      details = `\\n${detailLines}`;\n    } else {\n      details = error.details[0];\n    }\n  }\n\n  let errorText = `${headline}\\n\\n`;\n  errorText += `${error.title}\\n\\n`;\n  errorText += details ? `Details: ${details}\\n\\n` : \"\";\n\n  if (error.status !== undefined) {\n    errorText += `Status: ${error.status}\\n`;\n  }\n\n  if (error.date) {\n    errorText += `Date: ${formatDate(error.date)}\\n`;\n  }\n\n  if (error.requestId) {\n    errorText += `Request Id: ${error.requestId}\\n`;\n  }\n\n  if (error.errorId) {\n    errorText += `Error Id: ${error.errorId}\\n`;\n  }\n\n  if (error.stacktrace) {\n    errorText += \"------\\n\"; // separator\n    errorText += `Stacktrace:\\n\\n${error.stacktrace}\\n`;\n  }\n\n  return errorText;\n};\n","<script setup lang=\"ts\">\nimport { ref } from \"vue\";\nimport { useClipboard } from \"@vueuse/core\";\n\nimport { KdsButton } from \"@knime/kds-components\";\nimport { formatDateTimeString } from \"@knime/utils\";\n\nimport { serializeErrorForClipboard as defaultSerializeRFCErrorData } from \"./serializeRFCErrorData\";\nimport type { RFCErrorData } from \"./types\";\n\ntype Props = {\n  /**\n   * Toast headline shown in the toast title bar. Not rendered inside this\n   * template, but included when serializing the error to the clipboard.\n   */\n  headline: string;\n  /** Whether to show the \"Copy error to clipboard\" button. */\n  canCopyToClipboard?: boolean;\n  /**\n   * Custom serializer for the clipboard payload. Defaults to\n   * `serializeRFCErrorData` which formats the full error as text.\n   */\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n} & RFCErrorData;\n\nconst {\n  headline,\n  canCopyToClipboard = true,\n  serializeErrorForClipboard = defaultSerializeRFCErrorData,\n  ...rfcError\n} = defineProps<Props>();\n\nconst emits = defineEmits([\"showMore\"]);\n\nconst { copy, copied } = useClipboard({\n  copiedDuring: 3000,\n});\n\nconst hasDetails =\n  rfcError.details?.length ||\n  rfcError.status !== undefined ||\n  rfcError.date !== undefined ||\n  rfcError.requestId !== undefined ||\n  rfcError.errorId !== undefined;\n// don't show 'Show details' button if there are no details to show\nconst showDetails = ref(!hasDetails);\n\nconst formatDate = (date: Date): string =>\n  date ? formatDateTimeString(date.getTime()) : \"\";\n\nconst copyToClipboard = () => {\n  if (copied.value) {\n    return;\n  }\n  copy(serializeErrorForClipboard(rfcError, headline, formatDate)).catch(\n    (error) => {\n      consola.error(\"Failed to copy to clipboard\", { error });\n    },\n  );\n};\n\nconst onShowDetailsClicked = () => {\n  showDetails.value = true;\n  emits(\"showMore\");\n};\n</script>\n\n<template>\n  <div class=\"wrapper\">\n    <div class=\"title\">\n      {{ title }}\n    </div>\n    <div v-if=\"showDetails\">\n      <div v-if=\"details?.length\">\n        <strong>Details: </strong>\n        <template v-if=\"details.length === 1\">\n          {{ details[0] }}\n        </template>\n        <template v-else>\n          <ul class=\"details-list\">\n            <li v-for=\"(item, index) in details\" :key=\"index\">{{ item }}</li>\n          </ul>\n        </template>\n      </div>\n\n      <div v-if=\"status !== undefined\">\n        <strong>Status: </strong>{{ status }}\n      </div>\n      <div v-if=\"date\"><strong>Date: </strong>{{ formatDate(date) }}</div>\n      <div v-if=\"requestId\"><strong>Request id: </strong>{{ requestId }}</div>\n      <div v-if=\"errorId\"><strong>Error id: </strong>{{ errorId }}</div>\n      <div v-if=\"stacktrace && canCopyToClipboard\">\n        <strong>Stacktrace: </strong>Part of clipboard text\n      </div>\n    </div>\n    <div class=\"actions-wrapper\">\n      <KdsButton\n        v-if=\"!showDetails\"\n        data-testid=\"show-details\"\n        variant=\"transparent\"\n        label=\"Show details\"\n        size=\"xsmall\"\n        @click=\"onShowDetailsClicked\"\n      />\n      <KdsButton\n        v-if=\"canCopyToClipboard\"\n        data-testid=\"copy-to-clipboard\"\n        :label=\"copied ? 'Error was copied' : 'Copy error to clipboard'\"\n        :leading-icon=\"copied ? 'checkmark' : 'copy'\"\n        variant=\"transparent\"\n        size=\"xsmall\"\n        @click=\"copyToClipboard\"\n      />\n    </div>\n  </div>\n</template>\n\n<style scoped>\n.wrapper {\n  display: flex;\n  flex-direction: column;\n  gap: var(--kds-spacing-container-0-25x);\n  font: var(--kds-font-base-body-small);\n  color: var(--kds-color-text-and-icon-neutral);\n}\n\n.details-list {\n  padding-left: var(--kds-spacing-container-1-5x);\n  margin-top: var(--kds-spacing-container-0-37x);\n  margin-bottom: var(--kds-spacing-container-0-37x);\n}\n\n.actions-wrapper {\n  display: flex;\n  gap: var(--kds-spacing-container-0-5x);\n  align-items: center;\n}\n</style>\n","<script setup lang=\"ts\">\nimport { ref } from \"vue\";\nimport { useClipboard } from \"@vueuse/core\";\n\nimport { KdsButton } from \"@knime/kds-components\";\nimport { formatDateTimeString } from \"@knime/utils\";\n\nimport { serializeErrorForClipboard as defaultSerializeRFCErrorData } from \"./serializeRFCErrorData\";\nimport type { RFCErrorData } from \"./types\";\n\ntype Props = {\n  /**\n   * Toast headline shown in the toast title bar. Not rendered inside this\n   * template, but included when serializing the error to the clipboard.\n   */\n  headline: string;\n  /** Whether to show the \"Copy error to clipboard\" button. */\n  canCopyToClipboard?: boolean;\n  /**\n   * Custom serializer for the clipboard payload. Defaults to\n   * `serializeRFCErrorData` which formats the full error as text.\n   */\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n} & RFCErrorData;\n\nconst {\n  headline,\n  canCopyToClipboard = true,\n  serializeErrorForClipboard = defaultSerializeRFCErrorData,\n  ...rfcError\n} = defineProps<Props>();\n\nconst emits = defineEmits([\"showMore\"]);\n\nconst { copy, copied } = useClipboard({\n  copiedDuring: 3000,\n});\n\nconst hasDetails =\n  rfcError.details?.length ||\n  rfcError.status !== undefined ||\n  rfcError.date !== undefined ||\n  rfcError.requestId !== undefined ||\n  rfcError.errorId !== undefined;\n// don't show 'Show details' button if there are no details to show\nconst showDetails = ref(!hasDetails);\n\nconst formatDate = (date: Date): string =>\n  date ? formatDateTimeString(date.getTime()) : \"\";\n\nconst copyToClipboard = () => {\n  if (copied.value) {\n    return;\n  }\n  copy(serializeErrorForClipboard(rfcError, headline, formatDate)).catch(\n    (error) => {\n      consola.error(\"Failed to copy to clipboard\", { error });\n    },\n  );\n};\n\nconst onShowDetailsClicked = () => {\n  showDetails.value = true;\n  emits(\"showMore\");\n};\n</script>\n\n<template>\n  <div class=\"wrapper\">\n    <div class=\"title\">\n      {{ title }}\n    </div>\n    <div v-if=\"showDetails\">\n      <div v-if=\"details?.length\">\n        <strong>Details: </strong>\n        <template v-if=\"details.length === 1\">\n          {{ details[0] }}\n        </template>\n        <template v-else>\n          <ul class=\"details-list\">\n            <li v-for=\"(item, index) in details\" :key=\"index\">{{ item }}</li>\n          </ul>\n        </template>\n      </div>\n\n      <div v-if=\"status !== undefined\">\n        <strong>Status: </strong>{{ status }}\n      </div>\n      <div v-if=\"date\"><strong>Date: </strong>{{ formatDate(date) }}</div>\n      <div v-if=\"requestId\"><strong>Request id: </strong>{{ requestId }}</div>\n      <div v-if=\"errorId\"><strong>Error id: </strong>{{ errorId }}</div>\n      <div v-if=\"stacktrace && canCopyToClipboard\">\n        <strong>Stacktrace: </strong>Part of clipboard text\n      </div>\n    </div>\n    <div class=\"actions-wrapper\">\n      <KdsButton\n        v-if=\"!showDetails\"\n        data-testid=\"show-details\"\n        variant=\"transparent\"\n        label=\"Show details\"\n        size=\"xsmall\"\n        @click=\"onShowDetailsClicked\"\n      />\n      <KdsButton\n        v-if=\"canCopyToClipboard\"\n        data-testid=\"copy-to-clipboard\"\n        :label=\"copied ? 'Error was copied' : 'Copy error to clipboard'\"\n        :leading-icon=\"copied ? 'checkmark' : 'copy'\"\n        variant=\"transparent\"\n        size=\"xsmall\"\n        @click=\"copyToClipboard\"\n      />\n    </div>\n  </div>\n</template>\n\n<style scoped>\n.wrapper {\n  display: flex;\n  flex-direction: column;\n  gap: var(--kds-spacing-container-0-25x);\n  font: var(--kds-font-base-body-small);\n  color: var(--kds-color-text-and-icon-neutral);\n}\n\n.details-list {\n  padding-left: var(--kds-spacing-container-1-5x);\n  margin-top: var(--kds-spacing-container-0-37x);\n  margin-bottom: var(--kds-spacing-container-0-37x);\n}\n\n.actions-wrapper {\n  display: flex;\n  gap: var(--kds-spacing-container-0-5x);\n  align-items: center;\n}\n</style>\n","/**\n * Type based on an RFC-9457 error standard (https://www.rfc-editor.org/rfc/rfc9457)\n * Also see:\n * https://knime-com.atlassian.net/wiki/spaces/SPECS/pages/4126769212/API+Errors+Problem+Details\n */\nexport type RFCErrorData = {\n  /** Short human-readable summary of the error. */\n  title: string;\n  /** HTTP status code associated with the error. */\n  status?: number;\n  /** Date/time when the error occurred. */\n  date?: Date;\n  /** Additional human-readable detail messages. */\n  details?: string[];\n  /** Correlation id for the request that triggered the error. */\n  requestId?: string;\n  /**\n   * Id used to find an error in the Hub logs. Specially relevant\n   * when details of the error are not wanted to be exposed to the user.\n   */\n  errorId?: string;\n  /**\n   * Relevant only for the Analytics Platform, since the Hub does not expose\n   * stack traces.\n   */\n  stacktrace?: string;\n};\n\nexport class RFCError extends Error {\n  data: RFCErrorData;\n\n  constructor(data: RFCErrorData) {\n    super(data.title);\n    this.data = data;\n  }\n}\n\nexport type FetchError = {\n  response: {\n    headers: Headers;\n  };\n  statusCode: number;\n  data: {\n    title: string;\n    details: string[];\n  };\n};\n","import { h } from \"vue\";\n\nimport type { Toast } from \"../toasts\";\n\nimport RFCErrorToastTemplate from \"./RFCErrorToastTemplate.vue\";\nimport { type FetchError, RFCError, type RFCErrorData } from \"./types\";\n\n/**\n * Key in `Toast.meta` under which `toToast` keeps the error data, so the toast\n * can be rebuilt where its component cannot be rendered.\n */\nexport const RFC_ERROR_TOAST_META_KEY = \"rfcError\";\n\nexport type RFCErrorToastMeta = {\n  data: RFCErrorData;\n  canCopyToClipboard?: boolean;\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n};\n\n/**\n * Map to a toast template component compatible with an RFCError format\n */\nconst toToast = ({\n  headline,\n  rfcError,\n  canCopyToClipboard = true,\n  serializeErrorForClipboard = undefined,\n}: {\n  headline: string;\n  rfcError: RFCError;\n  canCopyToClipboard?: boolean;\n  serializeErrorForClipboard?: (\n    error: RFCErrorData,\n    headline: string,\n    formatDate: (date: Date) => string,\n  ) => string;\n}): Toast => {\n  const { data } = rfcError;\n\n  const rfcErrorToastContent = h(RFCErrorToastTemplate, {\n    headline,\n    ...data,\n    canCopyToClipboard,\n    serializeErrorForClipboard,\n  });\n\n  return {\n    type: \"error\",\n    headline,\n    component: rfcErrorToastContent,\n    autoRemove: false,\n    meta: {\n      [RFC_ERROR_TOAST_META_KEY]: {\n        data,\n        canCopyToClipboard,\n        serializeErrorForClipboard,\n      } satisfies RFCErrorToastMeta,\n    },\n  };\n};\n\nconst isFetchError = (error: unknown): error is FetchError => {\n  return (\n    error !== null &&\n    typeof error === \"object\" &&\n    \"response\" in error &&\n    \"statusCode\" in error &&\n    \"data\" in error\n  );\n};\n\n/**\n * Parse a generic request error to an `RFCError`.\n * When parsing is not possible it returns undefined.\n */\nconst tryParse = (error: unknown): RFCError | undefined => {\n  if (!isFetchError(error)) {\n    return undefined;\n  }\n\n  if (!error.response) {\n    return undefined;\n  }\n\n  const responseDate = error.response.headers.get(\"date\")\n    ? new Date(error.response.headers.get(\"date\")!)\n    : undefined;\n\n  const title =\n    typeof error.data === \"string\" ? error.data : (error.data?.title ?? \"\");\n\n  const rfcErrorData: RFCErrorData = {\n    title: title as string,\n    details: error.data?.details as string[] | undefined,\n    status: error.statusCode as number,\n    date: responseDate,\n    requestId: error.response.headers.get(\"x-request-id\") ?? undefined,\n    errorId: error.response.headers.get(\"x-error-id\") ?? undefined,\n  };\n\n  return new RFCError(rfcErrorData);\n};\n\nexport const rfcErrors = {\n  toToast,\n  tryParse,\n  RFCError,\n};\n"],"mappings":"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"}

package/dist/rfcErrors.js

@@ -1,2 +1,2 @@
-import { t as rfcErrors } from "./rfcErrors-C59cEDGj.js";
-export { rfcErrors };
+import { n as rfcErrors, t as RFC_ERROR_TOAST_META_KEY } from "./rfcErrors-CNWg8BiD.js";
+export { RFC_ERROR_TOAST_META_KEY, rfcErrors };

package/dist/src/embedding/capabilities.d.ts

@@ -0,0 +1,40 @@
+import { GuestCapabilitiesForOutlet, HostCapabilitiesForOutlet, OutletName } from './outlets';
+/**
+ * Version of `@knime/product-features` that this build uses. Informational
+ * only: logs, support, deprecation tracking. It never gates behavior.
+ */
+export declare const contractVersion: string;
+/**
+ * Static declaration of the guest app. The host reads it before embedding.
+ */
+export type GuestCapabilities = {
+    contractVersion: string;
+    /**
+     * Outlets the guest declares and supports. The host does not send a feature
+     * for an outlet the guest does not support
+     */
+    outlets: Partial<GuestCapabilitiesForOutlet>;
+};
+/**
+ * Static declaration of the host, passed as context for mounting the embedded guest
+ */
+export type HostCapabilities = {
+    contractVersion: string;
+    /**
+     * Outlets the host has features for. The guest does not render an outlet that the
+     * host cannot provide.
+     */
+    outlets: Partial<HostCapabilitiesForOutlet>;
+};
+export type ResolvedOutlets = {
+    [N in OutletName]?: {
+        guest: GuestCapabilitiesForOutlet[N];
+        host: HostCapabilitiesForOutlet[N];
+    };
+};
+/**
+ * Outlets that both sides declare. Capabilities that this contract version does not know are
+ * dropped.
+ */
+export declare const resolveOutlets: (guest: GuestCapabilities, host: HostCapabilities) => ResolvedOutlets;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/src/embedding/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/embedding/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,UAAU,EAEhB,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAqC,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;KAC3B,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE;QAClB,KAAK,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;KACpC;CACF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,iBAAiB,EACxB,MAAM,gBAAgB,KACrB,eAeF,CAAC"}

package/dist/src/embedding/index.d.ts

@@ -0,0 +1,6 @@
+export { contractVersion, resolveOutlets } from './capabilities';
+export type { GuestCapabilities, HostCapabilities, ResolvedOutlets, } from './capabilities';
+export type { HostCapabilitiesForOutlet, OutletHandle, OutletName, OutletRegistry, SpaceExplorerDragItem, SpaceExplorerFeatureAPI, SpaceExplorerItemDrop, SpaceExplorerOutletHandle, } from './outlets';
+export { fromHostToast, toHostToast } from './toasts';
+export type { EmbeddedGuestAPI, EmbeddingContext, EmbeddingHostAPI, GuestEmbedModuleBootstrap, NavigationIntent, UserActivity, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/embedding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,yBAAyB,EACzB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/src/embedding/outlets/index.d.ts

@@ -0,0 +1,23 @@
+import { SpaceExplorerFeatureAPI, SpaceExplorerGuestCapabilities, SpaceExplorerHostCapabilities, SpaceExplorerOutletHandle } from './spaceExplorer';
+/**
+ * Outlets the guest can expose (the editor in this case). Each outlet contains one feature of the host.
+ */
+export type OutletHandle = SpaceExplorerOutletHandle;
+export type OutletName = OutletHandle["name"];
+export type OutletRegistry = {
+    spaceExplorer: SpaceExplorerFeatureAPI;
+};
+export type GuestCapabilitiesForOutlet = {
+    spaceExplorer: SpaceExplorerGuestCapabilities;
+};
+export type HostCapabilitiesForOutlet = {
+    spaceExplorer: SpaceExplorerHostCapabilities;
+};
+export declare const outletCapabilityResolvers: {
+    [N in OutletName]: {
+        guest: (declared: GuestCapabilitiesForOutlet[N]) => GuestCapabilitiesForOutlet[N];
+        host: (declared: HostCapabilitiesForOutlet[N]) => HostCapabilitiesForOutlet[N];
+    };
+};
+export type { SpaceExplorerDragItem, SpaceExplorerFeatureAPI, SpaceExplorerItemDrop, SpaceExplorerOutletHandle, } from './spaceExplorer';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/embedding/outlets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/embedding/outlets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAG/B,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,uBAAuB,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,aAAa,EAAE,8BAA8B,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,6BAA6B,CAAC;CAC9C,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE;KACrC,CAAC,IAAI,UAAU,GAAG;QACjB,KAAK,EAAE,CACL,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC,KACpC,0BAA0B,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,EAAE,CACJ,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,KACnC,yBAAyB,CAAC,CAAC,CAAC,CAAC;KACnC;CAMF,CAAC;AAEF,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/dist/src/embedding/outlets/spaceExplorer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * An item that the space explorer drags onto the canvas.
+ */
+export type SpaceExplorerDragItem = {
+    spaceId: string;
+    itemId: string;
+    name: string;
+    type: string;
+};
+/**
+ * Drags items from the space explorer onto the another container. This allows custom control
+ * over rendering a drag preview and also running custom logic when an item is dropped onto another
+ * container.
+ */
+export type SpaceExplorerItemDrop = {
+    start: (item: SpaceExplorerDragItem) => void;
+    /**
+     * When `accepts` is true, the space explorer hides its own drag ghost.
+     */
+    move: (clientX: number, clientY: number) => {
+        accepts: boolean;
+    };
+    /**
+     * Resolves to whether the guest added the item.
+     */
+    end: (clientX: number, clientY: number) => Promise<boolean>;
+    cancel: () => void;
+};
+/**
+ * Announced by the guest when the element the outlet will render to exists.
+ */
+export type SpaceExplorerOutletHandle = {
+    name: "spaceExplorer";
+    /**
+     * A stable, empty element. Must not be patched/removed by the guest
+     */
+    element: HTMLElement;
+    /**
+     * Present when both sides declare `itemDrop`.
+     */
+    itemDrop?: SpaceExplorerItemDrop;
+};
+/**
+ * The space explorer's public api. Returned after `announce`ing the feature.
+ */
+export type SpaceExplorerFeatureAPI = {
+    /**
+     * Shows the item: its parent folder, with the item selected. Present when
+     * the host declares `revealItem`.
+     */
+    revealItem?: (item: {
+        spaceId: string;
+        itemId: string;
+    }) => void;
+};
+/**
+ * Capabilities the space explorer expects the guest to implement
+ */
+export type SpaceExplorerGuestCapabilities = {
+    itemDrop?: true;
+};
+/**
+ * Capabilities the space explorer of the host offers to the guest for public/direct usage
+ * (all behavior is normally self-contained).
+ */
+export type SpaceExplorerHostCapabilities = {
+    revealItem?: true;
+};
+/**
+ * Keep only the capabilities that this contract version knows.
+ */
+export declare const resolveSpaceExplorerGuestCapabilities: (declared: SpaceExplorerGuestCapabilities) => SpaceExplorerGuestCapabilities;
+export declare const resolveSpaceExplorerHostCapabilities: (declared: SpaceExplorerHostCapabilities) => SpaceExplorerHostCapabilities;
+//# sourceMappingURL=spaceExplorer.d.ts.map

package/dist/src/embedding/outlets/spaceExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceExplorer.d.ts","sourceRoot":"","sources":["../../../../src/embedding/outlets/spaceExplorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC7C;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACjE;;OAEG;IACH,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,eAAe,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,CAAC,EAAE,IAAI,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qCAAqC,GAChD,UAAU,8BAA8B,KACvC,8BAED,CAAC;AAEH,eAAO,MAAM,oCAAoC,GAC/C,UAAU,6BAA6B,KACtC,6BAED,CAAC"}

package/dist/src/embedding/toasts.d.ts

@@ -0,0 +1,14 @@
+import { Toast } from '../toasts';
+import { HostToast } from './types';
+/**
+ * Guest: turns a toast into data the host can render. An RFC error toast
+ * keeps its error data. Any other component is dropped, because the host
+ * cannot render a component from the guest's Vue runtime.
+ */
+export declare const toHostToast: (toast: Toast) => HostToast;
+/**
+ * Host: turns a toast from the guest into a toast for its own
+ * toast service context.
+ */
+export declare const fromHostToast: (hostToast: HostToast) => Toast;
+//# sourceMappingURL=toasts.d.ts.map

package/dist/src/embedding/toasts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toasts.d.ts","sourceRoot":"","sources":["../../../src/embedding/toasts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,SAc1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,SAAS,KAAG,KAgBpD,CAAC"}

package/dist/src/embedding/types.d.ts

@@ -0,0 +1,131 @@
+import { RFCErrorToastMeta } from '../rfcErrors';
+import { Toast } from '../toasts';
+import { GuestCapabilities, HostCapabilities } from './capabilities';
+import { OutletHandle, OutletName, OutletRegistry } from './outlets';
+/**
+ * Data the host provisions before it mounts the guest.
+ */
+export type EmbeddingContext = {
+    /**
+     * URI of the WS connection.
+     */
+    wsConnectionUri: string;
+    /**
+     * URI of the HTTP endpoint to fetch resources from.
+     */
+    httpResourceUri: string;
+    /**
+     * Base URL of the Hub REST API.
+     */
+    restApiBaseUrl: string;
+    /**
+     * Id of the job that is loaded into the executor.
+     */
+    jobId: string;
+    /**
+     * Time in ms without user interaction after which the user is idle.
+     */
+    userIdleTimeout?: number;
+    analytics?: {
+        /**
+         * Whether the editor can send analytics events.
+         */
+        enabled: boolean;
+    };
+    /**
+     * Property bag containing assorted data that does not strictly belong to the stable
+     * emedding context, which should be a stable contract not changing often. Properties in here
+     * should be validated by the guest before being used. An example would be passing the theme data
+     */
+    customProperties?: Record<string, unknown>;
+};
+/**
+ * A toast as raw data.
+ */
+export type HostToast = Omit<Toast, "component"> & {
+    /**
+     * The host renders the content of an RFC 9457 error toast from this data.
+     */
+    rfcError?: RFCErrorToastMeta;
+};
+export type NavigationIntent = {
+    intent: "reload";
+} | {
+    intent: "go-to";
+    destination: "cloud-home";
+    openIn: "_blank" | "_self";
+} | {
+    intent: "navigate";
+    href: string;
+    openIn: "_blank" | "_self";
+};
+export type UserActivity = {
+    /**
+     * - `active`: the user interacts with the guest app and no background task runs.
+     * - `idle`: the user does not interact and no background task runs.
+     * - `background-task`: a background task runs, regardless of whatever the user does.
+     *   The host blocks page unload in this state.
+     */
+    state: "active" | "idle" | "background-task";
+    /**
+     * ISO 8601 timestamp.
+     */
+    lastActive: string;
+};
+/**
+ * API contract for Calls from the guest to the host.
+ */
+export type EmbeddingHostAPI = {
+    /**
+     * Resolves to the id of the toast.
+     */
+    showNotification: (toast: HostToast) => string;
+    clearNotification: (target: {
+        id: string;
+    } | {
+        deduplicationKey: string;
+    }) => void;
+    requestNavigation: (intent: NavigationIntent) => void;
+    reportActivity: (activity: UserActivity) => void;
+    /**
+     * Send when embedding failed to start.
+     */
+    reportFailure: (error: {
+        message: string;
+    }) => void;
+    trackAnalytics: (event: {
+        id: string;
+        data: unknown;
+    }) => void;
+    outlets: {
+        /**
+         * Returns the feature's API of the outlet right away, before the
+         * feature renders.
+         */
+        announce: <H extends OutletHandle>(handle: H) => OutletRegistry[H["name"]];
+        withdraw: (name: OutletName) => void;
+    };
+};
+/**
+ * Handle the host gets from a `mount`.
+ */
+export type EmbeddedGuestAPI = {
+    /**
+     * Cleanup ran inside the guest
+     */
+    teardown: () => Promise<void>;
+};
+type MountOptions = {
+    context: EmbeddingContext;
+    host: EmbeddingHostAPI;
+    hostCapabilities: HostCapabilities;
+};
+/**
+ * Contract for mounting a guest, by loading its entry module to embed
+ */
+export type GuestEmbedModuleBootstrap = {
+    capabilities: GuestCapabilities;
+    mount: (shadowRoot: ShadowRoot, options: MountOptions) => EmbeddedGuestAPI;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/embedding/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/embedding/types.ts"],"names":[],"mappings":"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"}

package/dist/src/rfcErrors/index.d.ts

@@ -1,5 +1,15 @@
 import { Toast } from '../toasts';
 import { RFCError, RFCErrorData } from './types';
+/**
+ * Key in `Toast.meta` under which `toToast` keeps the error data, so the toast
+ * can be rebuilt where its component cannot be rendered.
+ */
+export declare const RFC_ERROR_TOAST_META_KEY = "rfcError";
+export type RFCErrorToastMeta = {
+    data: RFCErrorData;
+    canCopyToClipboard?: boolean;
+    serializeErrorForClipboard?: (error: RFCErrorData, headline: string, formatDate: (date: Date) => string) => string;
+};
 export declare const rfcErrors: {
     toToast: ({ headline, rfcError, canCopyToClipboard, serializeErrorForClipboard, }: {
         headline: string;

package/dist/src/rfcErrors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rfcErrors/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAmB,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AA+EvE,eAAO,MAAM,SAAS;uFArEnB;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,QAAQ,CAAC;QACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,0BAA0B,CAAC,EAAE,CAC3B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,KAC/B,MAAM,CAAC;KACb,KAAG,KAAK;sBAgCgB,OAAO,KAAG,QAAQ,GAAG,SAAS;;CAgCtD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rfcErrors/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAmB,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B,CAAC,EAAE,CAC3B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,KAC/B,MAAM,CAAC;CACb,CAAC;AAsFF,eAAO,MAAM,SAAS;uFA5EnB;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,QAAQ,CAAC;QACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,0BAA0B,CAAC,EAAE,CAC3B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,KAC/B,MAAM,CAAC;KACb,KAAG,KAAK;sBAuCgB,OAAO,KAAG,QAAQ,GAAG,SAAS;;CAgCtD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knime/product-features",
-  "version": "6.1.1",
+  "version": "6.2.0",
   "description": "Package containing composition patterns of KDS Components and KNIME business logic",
   "repository": {
     "type": "git",
@@ -37,6 +37,10 @@
       "types": "./dist/src/dataTransfer/core.d.ts",
       "import": "./dist/dataTransfer/core.js"
     },
+    "./embedding": {
+      "types": "./dist/src/embedding/index.d.ts",
+      "import": "./dist/embedding.js"
+    },
     "./embedding-sdk": {
       "types": "./dist/src/embeddingSDK/index.d.ts",
       "import": "./dist/embeddingSDK.js"
@@ -63,8 +67,8 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@knime/kds-components": "^12.0.0",
-    "@knime/kds-styles": "^12.0.0",
+    "@knime/kds-components": "^13.0.0",
+    "@knime/kds-styles": "^13.0.0",
     "@vueuse/core": "^14.0.0",
     "es-toolkit": "^1.49.0",
     "ofetch": "^1.5.1",
@@ -75,8 +79,8 @@
     "consola": "^3.4.2"
   },
   "devDependencies": {
-    "@knime/kds-components": "^12.0.0",
-    "@knime/kds-styles": "^12.0.0",
+    "@knime/kds-components": "^13.0.2",
+    "@knime/kds-styles": "^13.0.2",
     "@storybook/addon-docs": "^10.6.2",
     "@storybook/vue3-vite": "^10.6.2",
     "@vitejs/plugin-vue": "^6.0.8",