@atlaskit/editor-common 110.15.0 → 110.15.2

package/dist/types-ts4.5/experiences/ExperienceCheckDomMutation.d.ts

@@ -0,0 +1,53 @@
+import type { ExperienceCheck, ExperienceCheckCallback, ExperienceCheckResult } from './ExperienceCheck';
+export type ExperienceDomMutationCheckOptions = {
+    mutations: MutationRecord[];
+};
+export type ExperienceCheckDomMutationObserveConfig = {
+    /**
+     * MutationObserver options specifying what types of mutations to observe
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe
+     */
+    options: MutationObserverInit;
+    /**
+     * Target element to observe for mutations
+     */
+    target: Node;
+};
+export type ExperienceCheckDomMutationConfig = {
+    /**
+     * Callback that returns the MutationObserver configuration
+     *
+     * This is a callback to ensure consumers make explicit, conscious decisions about:
+     * - What element to observe (performance: smaller scope = better performance)
+     * - What mutations to monitor (performance: fewer types = better performance)
+     *
+     * IMPORTANT: Return null if the target element cannot be found.
+     * This will immediately fail the experience with reason 'target-not-found'.
+     *
+     * Common patterns:
+     * - Safe fallback: { target: document.querySelector('[data-testid="toolbar"]') ?? document.body, options: {...} }
+     * - Explicit null: const target = document.querySelector('[data-testid="toolbar"]'); return target ? { target, options: {...} } : null;
+     */
+    observeConfig: () => ExperienceCheckDomMutationObserveConfig | null;
+    /**
+     * Callback invoked when DOM mutations are detected
+     * Return a result to complete the experience, or undefined to continue observing
+     */
+    onDomMutation: (options: ExperienceDomMutationCheckOptions) => ExperienceCheckResult | undefined;
+};
+/**
+ * Check for the completion of an experience based on DOM mutations
+ *
+ * Uses a MutationObserver to monitor DOM changes and invokes the provided
+ * callback when relevant mutations are detected.
+ *
+ * Will result in success or failure based on the outcome of the callback.
+ */
+export declare class ExperienceCheckDomMutation implements ExperienceCheck {
+    private mutationObserver;
+    private onDomMutation;
+    private observeConfig;
+    constructor({ onDomMutation, observeConfig }: ExperienceCheckDomMutationConfig);
+    start(callback: ExperienceCheckCallback): void;
+    stop(): void;
+}

package/dist/types-ts4.5/experiences/ExperienceCheckTimeout.d.ts

@@ -0,0 +1,13 @@
+import type { ExperienceCheck, ExperienceCheckCallback } from './ExperienceCheck';
+/**
+ * Check for the completion of an experience based on a timeout
+ *
+ * Will always result in failure after the timeout duration
+ */
+export declare class ExperienceCheckTimeout implements ExperienceCheck {
+    private timeoutId;
+    private maxDurationMs;
+    constructor(maxDurationMs: number);
+    start(callback: ExperienceCheckCallback): void;
+    stop(): void;
+}

package/dist/types-ts4.5/experiences/consts.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Built-in failure reasons for experience checks
+ *
+ * These are used by the various ExperienceCheck implementations to
+ * provide consistent, well-known failure reasons for analytics and debugging.
+ */
+export declare const EXPERIENCE_FAILURE_REASON: {
+    /**
+     * Experience timed out before completion
+     */
+    readonly TIMEOUT: "timeout";
+    /**
+     * Target element could not be found when starting DOM mutation observation
+     */
+    readonly DOM_MUTATION_TARGET_NOT_FOUND: "dom-mutation-target-not-found";
+    /**
+     * Error occurred during DOM mutation check execution
+     */
+    readonly DOM_MUTATION_CHECK_ERROR: "dom-mutation-check-error";
+};

package/dist/types-ts4.5/experiences/index.d.ts

@@ -0,0 +1,7 @@
+export { Experience } from './Experience';
+export { EXPERIENCE_FAILURE_REASON } from './consts';
+export { ExperienceCheckComposite } from './ExperienceCheckComposite';
+export { ExperienceCheckDomMutation } from './ExperienceCheckDomMutation';
+export { ExperienceCheckTimeout } from './ExperienceCheckTimeout';
+export type { ExperienceCheck, ExperienceCheckCallback, ExperienceCheckResult, } from './ExperienceCheck';
+export type { ExperienceCheckDomMutationConfig, ExperienceCheckDomMutationObserveConfig, ExperienceDomMutationCheckOptions, } from './ExperienceCheckDomMutation';

package/dist/types-ts4.5/ui/HoverLinkOverlay/index.d.ts

@@ -3,7 +3,17 @@
  * @jsx jsx
  */
 import React from 'react';
-import { jsx } from '@emotion/react';
-import type { HoverLinkOverlayProps } from './types';
-declare const HoverLinkOverlay: ({ children, isVisible, url, compactPadding, editorAnalyticsApi, view, onClick, showPanelButton, showPanelButtonIcon, }: React.PropsWithChildren<HoverLinkOverlayProps>) => jsx.JSX.Element;
+import { type EditorAnalyticsAPI } from '../../analytics';
+declare const HoverLinkOverlay: React.FC<React.HTMLAttributes<HTMLSpanElement> & {
+    compactPadding?: boolean;
+    editorAnalyticsApi?: EditorAnalyticsAPI;
+    isVisible?: boolean;
+    onClick?: (event: React.MouseEvent<HTMLAnchorElement>) => void;
+    showPanelButton?: boolean;
+    showPanelButtonIcon?: "panel" | "modal";
+    url: string;
+    view?: import("prosemirror-view").EditorView;
+} & {
+    children?: React.ReactNode | undefined;
+}>;
 export default HoverLinkOverlay;

package/experiences/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@atlaskit/editor-common/experiences",
+  "main": "../dist/cjs/experiences/index.js",
+  "module": "../dist/esm/experiences/index.js",
+  "module:es2019": "../dist/es2019/experiences/index.js",
+  "sideEffects": [
+    "**/*.compiled.css"
+  ],
+  "types": "../dist/types/experiences/index.d.ts",
+  "typesVersions": {
+    ">=4.5 <5.9": {
+      "*": [
+        "../dist/types-ts4.5/experiences/index.d.ts"
+      ]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "110.15.0",
+	"version": "110.15.2",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -54,7 +54,7 @@
 		"@atlaskit/icon": "^28.5.0",
 		"@atlaskit/icon-object": "^7.3.0",
 		"@atlaskit/link": "^3.2.0",
-		"@atlaskit/link-datasource": "^4.26.0",
+		"@atlaskit/link-datasource": "^4.27.0",
 		"@atlaskit/link-picker": "^3.16.0",
 		"@atlaskit/media-card": "^79.5.0",
 		"@atlaskit/media-client": "^35.5.0",
@@ -82,9 +82,10 @@
 		"@atlaskit/task-decision": "^19.2.0",
 		"@atlaskit/textfield": "^8.0.0",
 		"@atlaskit/theme": "^21.0.0",
-		"@atlaskit/tmp-editor-statsig": "^13.14.0",
+		"@atlaskit/tmp-editor-statsig": "^13.16.0",
 		"@atlaskit/tokens": "^7.0.0",
 		"@atlaskit/tooltip": "^20.6.0",
+		"@atlaskit/ufo": "^0.4.0",
 		"@atlaskit/width-detector": "^5.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.18.6",