@intlayer/editor-react 9.6.0 → 9.7.1

package/dist/esm/EditorStateContext.mjs

@@ -3,7 +3,7 @@
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/EditorStateContext.tsx
+// src/EditorStateContext.tsx
 const EditorStateContext = createContext(null);
 const EditorStateProvider = ({ children, manager }) => /* @__PURE__ */ jsx(EditorStateContext.Provider, {
 	value: manager,
@@ -11,6 +11,5 @@ const EditorStateProvider = ({ children, manager }) => /* @__PURE__ */ jsx(Edito
 });
 const useEditorStateManager = () => useContext(EditorStateContext);
 
-//#endregion
 export { EditorStateProvider, useEditorStateManager };
 //# sourceMappingURL=EditorStateContext.mjs.map

package/dist/esm/FocusDictionaryContext.mjs

@@ -3,7 +3,7 @@
 import { useEditorStateManager } from "./EditorStateContext.mjs";
 import { useCallback, useEffect, useState } from "react";
 
-//#region src/FocusDictionaryContext.tsx
+// src/FocusDictionaryContext.tsx
 /**
 * Returns the content focused in the editor, shared with the client frame.
 */
@@ -23,6 +23,5 @@ const useFocusDictionary = () => {
 	};
 };
 
-//#endregion
 export { useFocusDictionary };
 //# sourceMappingURL=FocusDictionaryContext.mjs.map

package/dist/esm/index.mjs

@@ -1,15 +1,17 @@
-import { EditorStateProvider, useEditorStateManager } from "./EditorStateContext.mjs";
+import { useConfiguration } from "./ConfigurationContext.mjs";
 import { useDictionariesRecord, useDictionariesRecordActions } from "./DictionariesRecordContext.mjs";
-import { useCrossFrameState } from "./useCrossFrameState.mjs";
-import { useCrossURLPathState } from "./useCrossURLPathState.mjs";
 import { useEditedContent, useEditedContentActions } from "./EditedContentContext.mjs";
-import { useEditedContentPersistence } from "./useEditedContentPersistence.mjs";
-import { useEditorLocale } from "./useEditorLocale.mjs";
-import { useConfiguration } from "./ConfigurationContext.mjs";
 import { useEditorEnabled, useEditorPingClient } from "./EditorEnabledContext.mjs";
 import { EditorProvider } from "./EditorProvider.mjs";
+import { EditorStateProvider, useEditorStateManager } from "./EditorStateContext.mjs";
 import { useFocusDictionary } from "./FocusDictionaryContext.mjs";
+import { useCrossFrameState } from "./useCrossFrameState.mjs";
+import { useCrossURLPathState } from "./useCrossURLPathState.mjs";
+import { useEditedContentPersistence } from "./useEditedContentPersistence.mjs";
+import { useEditorLocale } from "./useEditorLocale.mjs";
 import { useFocusUnmergedDictionary } from "./useFocusUnmergedDictionary.mjs";
+import { FRAME_CONNECTION_TIMEOUT_MS, useFrameConnectionStatus } from "./useFrameConnectionStatus.mjs";
+import { FRAME_RECONNECTION_INTERVAL_MS, isApplicationReachable, useFrameReconnection } from "./useFrameReconnection.mjs";
 import { MessageKey } from "@intlayer/editor";
 
-export { EditorProvider, EditorStateProvider, MessageKey, useConfiguration, useCrossFrameState, useCrossURLPathState, useDictionariesRecord, useDictionariesRecordActions, useEditedContent, useEditedContentActions, useEditedContentPersistence, useEditorEnabled, useEditorLocale, useEditorPingClient, useEditorStateManager, useFocusDictionary, useFocusUnmergedDictionary };
+export { EditorProvider, EditorStateProvider, FRAME_CONNECTION_TIMEOUT_MS, FRAME_RECONNECTION_INTERVAL_MS, MessageKey, isApplicationReachable, useConfiguration, useCrossFrameState, useCrossURLPathState, useDictionariesRecord, useDictionariesRecordActions, useEditedContent, useEditedContentActions, useEditedContentPersistence, useEditorEnabled, useEditorLocale, useEditorPingClient, useEditorStateManager, useFocusDictionary, useFocusUnmergedDictionary, useFrameConnectionStatus, useFrameReconnection };

package/dist/esm/useCrossFrameState.mjs

@@ -3,7 +3,7 @@
 import { useEditorStateManager } from "./EditorStateContext.mjs";
 import { useEffect, useState } from "react";
 
-//#region src/useCrossFrameState.tsx
+// src/useCrossFrameState.tsx
 /**
 * Returns the latest value another frame posted under `key`.
 */
@@ -14,6 +14,5 @@ const useCrossFrameState = (key, initialValue) => {
 	return value;
 };
 
-//#endregion
 export { useCrossFrameState };
 //# sourceMappingURL=useCrossFrameState.mjs.map

package/dist/esm/useCrossURLPathState.mjs

@@ -3,12 +3,11 @@
 import { useCrossFrameState } from "./useCrossFrameState.mjs";
 import { MessageKey } from "@intlayer/editor";
 
-//#region src/useCrossURLPathState.tsx
+// src/useCrossURLPathState.tsx
 /**
 * Returns the path currently displayed by the client application.
 */
 const useCrossURLPathState = () => useCrossFrameState(MessageKey.INTLAYER_URL_CHANGE, void 0);
 
-//#endregion
 export { useCrossURLPathState };
 //# sourceMappingURL=useCrossURLPathState.mjs.map

package/dist/esm/useEditedContentPersistence.mjs

@@ -3,7 +3,7 @@
 import { useEditedContent } from "./EditedContentContext.mjs";
 import { useEffect } from "react";
 
-//#region src/useEditedContentPersistence.tsx
+// src/useEditedContentPersistence.tsx
 const EDITED_CONTENT_STORAGE_KEY = "INTLAYER_EDITED_CONTENT_CHANGED";
 /**
 * Persists the edited content in localStorage, and restores it on mount so
@@ -27,6 +27,5 @@ const useEditedContentPersistence = () => {
 	}, [editedContent]);
 };
 
-//#endregion
 export { useEditedContentPersistence };
 //# sourceMappingURL=useEditedContentPersistence.mjs.map

package/dist/esm/useEditorLocale.mjs

@@ -3,7 +3,7 @@
 import { useEditorStateManager } from "./EditorStateContext.mjs";
 import { useEffect, useState } from "react";
 
-//#region src/useEditorLocale.tsx
+// src/useEditorLocale.tsx
 const useEditorLocale = () => {
 	const manager = useEditorStateManager();
 	const [locale, setLocale] = useState(manager?.currentLocale.value);
@@ -16,6 +16,5 @@ const useEditorLocale = () => {
 	return locale;
 };
 
-//#endregion
 export { useEditorLocale };
 //# sourceMappingURL=useEditorLocale.mjs.map

package/dist/esm/useFocusUnmergedDictionary.mjs

@@ -1,12 +1,12 @@
 'use client';
 
 import { useDictionariesRecord } from "./DictionariesRecordContext.mjs";
-import { useEditorLocale } from "./useEditorLocale.mjs";
 import { useFocusDictionary } from "./FocusDictionaryContext.mjs";
+import { useEditorLocale } from "./useEditorLocale.mjs";
 import { useMemo } from "react";
 import { getContentNodeByKeyPath } from "@intlayer/core/dictionaryManipulator";
 
-//#region src/useFocusUnmergedDictionary.tsx
+// src/useFocusUnmergedDictionary.tsx
 /**
 * Converts merged keypath format to unmerged format.
 * Merged: [{type: "translation", key: "fr"}, {type: "object", key: "title"}]
@@ -45,6 +45,5 @@ const useFocusUnmergedDictionary = () => {
 	};
 };
 
-//#endregion
 export { useFocusUnmergedDictionary };
 //# sourceMappingURL=useFocusUnmergedDictionary.mjs.map

package/dist/esm/useFrameConnectionStatus.mjs

@@ -0,0 +1,41 @@
+'use client';
+
+import { useEditorEnabled } from "./EditorEnabledContext.mjs";
+import { useCallback, useEffect, useState } from "react";
+
+// src/useFrameConnectionStatus.ts
+/** Delay after a frame load before an unanswered handshake counts as failed. */
+const FRAME_CONNECTION_TIMEOUT_MS = 5e3;
+/**
+* Detects an application frame that never connects to the editor.
+* A frame blocked by the application's framing policy still fires `load` on
+* an empty error page that the parent cannot inspect, so the missing
+* handshake is the only signal available.
+*/
+const useFrameConnectionStatus = (timeoutMs = FRAME_CONNECTION_TIMEOUT_MS) => {
+	const { enabled } = useEditorEnabled();
+	const [loadCount, setLoadCount] = useState(0);
+	const [isTimedOut, setIsTimedOut] = useState(false);
+	useEffect(() => {
+		if (enabled || loadCount === 0) return;
+		const timeout = setTimeout(() => setIsTimedOut(true), timeoutMs);
+		return () => clearTimeout(timeout);
+	}, [
+		enabled,
+		loadCount,
+		timeoutMs
+	]);
+	const handleFrameLoad = useCallback(() => {
+		setIsTimedOut(false);
+		setLoadCount((count) => count + 1);
+	}, []);
+	const dismiss = useCallback(() => setIsTimedOut(false), []);
+	return {
+		isConnectionFailed: isTimedOut && !enabled,
+		handleFrameLoad,
+		dismiss
+	};
+};
+
+export { FRAME_CONNECTION_TIMEOUT_MS, useFrameConnectionStatus };
+//# sourceMappingURL=useFrameConnectionStatus.mjs.map

package/dist/esm/useFrameConnectionStatus.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrameConnectionStatus.mjs","names":[],"sources":["../../src/useFrameConnectionStatus.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useState } from 'react';\nimport { useEditorEnabled } from './EditorEnabledContext';\n\n/** Delay after a frame load before an unanswered handshake counts as failed. */\nexport const FRAME_CONNECTION_TIMEOUT_MS = 5_000;\n\nexport type FrameConnectionStatus = {\n  /**\n   * The frame loaded but its client never answered the handshake: the page\n   * refused to be framed (CSP `frame-ancestors`, `X-Frame-Options`), or it\n   * does not run the editor client.\n   */\n  isConnectionFailed: boolean;\n  /** To call on every `load` event of the application frame. */\n  handleFrameLoad: () => void;\n  /** Hides the failure until the next load. */\n  dismiss: () => void;\n};\n\n/**\n * Detects an application frame that never connects to the editor.\n * A frame blocked by the application's framing policy still fires `load` on\n * an empty error page that the parent cannot inspect, so the missing\n * handshake is the only signal available.\n */\nexport const useFrameConnectionStatus = (\n  timeoutMs: number = FRAME_CONNECTION_TIMEOUT_MS\n): FrameConnectionStatus => {\n  const { enabled } = useEditorEnabled();\n  const [loadCount, setLoadCount] = useState(0);\n  const [isTimedOut, setIsTimedOut] = useState(false);\n\n  useEffect(() => {\n    if (enabled || loadCount === 0) return;\n\n    const timeout = setTimeout(() => setIsTimedOut(true), timeoutMs);\n\n    return () => clearTimeout(timeout);\n  }, [enabled, loadCount, timeoutMs]);\n\n  const handleFrameLoad = useCallback(() => {\n    setIsTimedOut(false);\n    setLoadCount((count) => count + 1);\n  }, []);\n\n  const dismiss = useCallback(() => setIsTimedOut(false), []);\n\n  return {\n    isConnectionFailed: isTimedOut && !enabled,\n    handleFrameLoad,\n    dismiss,\n  };\n};\n"],"mappings":";;;;;;;AAMA,MAAa,8BAA8B;;;;;;;AAqB3C,MAAa,4BACX,YAAoB,gCACM;CAC1B,MAAM,EAAE,YAAY,iBAAiB;CACrC,MAAM,CAAC,WAAW,gBAAgB,SAAS,CAAC;CAC5C,MAAM,CAAC,YAAY,iBAAiB,SAAS,KAAK;CAElD,gBAAgB;EACd,IAAI,WAAW,cAAc,GAAG;EAEhC,MAAM,UAAU,iBAAiB,cAAc,IAAI,GAAG,SAAS;EAE/D,aAAa,aAAa,OAAO;CACnC,GAAG;EAAC;EAAS;EAAW;CAAS,CAAC;CAElC,MAAM,kBAAkB,kBAAkB;EACxC,cAAc,KAAK;EACnB,cAAc,UAAU,QAAQ,CAAC;CACnC,GAAG,CAAC,CAAC;CAEL,MAAM,UAAU,kBAAkB,cAAc,KAAK,GAAG,CAAC,CAAC;CAE1D,OAAO;EACL,oBAAoB,cAAc,CAAC;EACnC;EACA;CACF;AACF"}

package/dist/esm/useFrameReconnection.mjs

@@ -0,0 +1,59 @@
+'use client';
+
+import { useEffect, useRef } from "react";
+
+// src/useFrameReconnection.ts
+/** Delay between two probes of a disconnected application. */
+const FRAME_RECONNECTION_INTERVAL_MS = 3e3;
+/**
+* Whether the application answers. `no-cors` resolves on any HTTP answer and
+* only rejects on a network failure: the editor origin is rarely in the
+* application's CORS allowlist.
+*/
+const isApplicationReachable = (applicationURL) => fetch(applicationURL, {
+	method: "HEAD",
+	mode: "no-cors",
+	cache: "no-store"
+}).then(() => true).catch(() => false);
+/**
+* Reconnects a disconnected application frame: the frame is reloaded once
+* when the application still answers (e.g. it reloaded while its dev server
+* restarted), then each time it answers again after being unreachable.
+*/
+const useFrameReconnection = ({ applicationURL, isDisconnected, reloadFrame, intervalMs = FRAME_RECONNECTION_INTERVAL_MS }) => {
+	const hasReloadedRef = useRef(false);
+	const reloadFrameRef = useRef(reloadFrame);
+	reloadFrameRef.current = reloadFrame;
+	useEffect(() => {
+		if (!isDisconnected) {
+			hasReloadedRef.current = false;
+			return;
+		}
+		if (!applicationURL) return;
+		let isCancelled = false;
+		const probe = async () => {
+			const isReachable = await isApplicationReachable(applicationURL);
+			if (isCancelled) return;
+			if (!isReachable) {
+				hasReloadedRef.current = false;
+				return;
+			}
+			if (hasReloadedRef.current) return;
+			hasReloadedRef.current = true;
+			reloadFrameRef.current();
+		};
+		probe();
+		const interval = setInterval(() => void probe(), intervalMs);
+		return () => {
+			isCancelled = true;
+			clearInterval(interval);
+		};
+	}, [
+		applicationURL,
+		isDisconnected,
+		intervalMs
+	]);
+};
+
+export { FRAME_RECONNECTION_INTERVAL_MS, isApplicationReachable, useFrameReconnection };
+//# sourceMappingURL=useFrameReconnection.mjs.map

package/dist/esm/useFrameReconnection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrameReconnection.mjs","names":[],"sources":["../../src/useFrameReconnection.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef } from 'react';\n\n/** Delay between two probes of a disconnected application. */\nexport const FRAME_RECONNECTION_INTERVAL_MS = 3_000;\n\n/**\n * Whether the application answers. `no-cors` resolves on any HTTP answer and\n * only rejects on a network failure: the editor origin is rarely in the\n * application's CORS allowlist.\n */\nexport const isApplicationReachable = (\n  applicationURL: string\n): Promise<boolean> =>\n  fetch(applicationURL, { method: 'HEAD', mode: 'no-cors', cache: 'no-store' })\n    .then(() => true)\n    .catch(() => false);\n\nexport type FrameReconnectionOptions = {\n  applicationURL: string | undefined;\n  /** The frame lost (or never got) its connection to the editor. */\n  isDisconnected: boolean;\n  /** Reloads the application frame. */\n  reloadFrame: () => void;\n  intervalMs?: number;\n};\n\n/**\n * Reconnects a disconnected application frame: the frame is reloaded once\n * when the application still answers (e.g. it reloaded while its dev server\n * restarted), then each time it answers again after being unreachable.\n */\nexport const useFrameReconnection = ({\n  applicationURL,\n  isDisconnected,\n  reloadFrame,\n  intervalMs = FRAME_RECONNECTION_INTERVAL_MS,\n}: FrameReconnectionOptions): void => {\n  // Kept across probes: one reload per reachable period, so a frame that\n  // never connects (framing refused, editor disabled) is not reloaded forever\n  const hasReloadedRef = useRef(false);\n  const reloadFrameRef = useRef(reloadFrame);\n  reloadFrameRef.current = reloadFrame;\n\n  useEffect(() => {\n    if (!isDisconnected) {\n      hasReloadedRef.current = false;\n      return;\n    }\n\n    if (!applicationURL) return;\n\n    let isCancelled = false;\n\n    const probe = async () => {\n      const isReachable = await isApplicationReachable(applicationURL);\n\n      if (isCancelled) return;\n\n      if (!isReachable) {\n        hasReloadedRef.current = false;\n        return;\n      }\n\n      if (hasReloadedRef.current) return;\n\n      hasReloadedRef.current = true;\n      reloadFrameRef.current();\n    };\n\n    void probe();\n    const interval = setInterval(() => void probe(), intervalMs);\n\n    return () => {\n      isCancelled = true;\n      clearInterval(interval);\n    };\n  }, [applicationURL, isDisconnected, intervalMs]);\n};\n"],"mappings":";;;;;;AAKA,MAAa,iCAAiC;;;;;;AAO9C,MAAa,0BACX,mBAEA,MAAM,gBAAgB;CAAE,QAAQ;CAAQ,MAAM;CAAW,OAAO;AAAW,CAAC,CAAC,CAC1E,WAAW,IAAI,CAAC,CAChB,YAAY,KAAK;;;;;;AAgBtB,MAAa,wBAAwB,EACnC,gBACA,gBACA,aACA,aAAa,qCACuB;CAGpC,MAAM,iBAAiB,OAAO,KAAK;CACnC,MAAM,iBAAiB,OAAO,WAAW;CACzC,eAAe,UAAU;CAEzB,gBAAgB;EACd,IAAI,CAAC,gBAAgB;GACnB,eAAe,UAAU;GACzB;EACF;EAEA,IAAI,CAAC,gBAAgB;EAErB,IAAI,cAAc;EAElB,MAAM,QAAQ,YAAY;GACxB,MAAM,cAAc,MAAM,uBAAuB,cAAc;GAE/D,IAAI,aAAa;GAEjB,IAAI,CAAC,aAAa;IAChB,eAAe,UAAU;IACzB;GACF;GAEA,IAAI,eAAe,SAAS;GAE5B,eAAe,UAAU;GACzB,eAAe,QAAQ;EACzB;EAEA,AAAK,MAAM;EACX,MAAM,WAAW,kBAAkB,KAAK,MAAM,GAAG,UAAU;EAE3D,aAAa;GACX,cAAc;GACd,cAAc,QAAQ;EACxB;CACF,GAAG;EAAC;EAAgB;EAAgB;CAAU,CAAC;AACjD"}

package/dist/types/ConfigurationContext.d.ts

@@ -1,8 +1,6 @@
 import { IntlayerConfig } from "@intlayer/types/config";
-//#region src/ConfigurationContext.d.ts
 /**
  * Returns the Intlayer configuration held by the editor state manager.
  */
 export declare const useConfiguration: () => IntlayerConfig | undefined;
-//#endregion
 //# sourceMappingURL=ConfigurationContext.d.ts.map

package/dist/types/ConfigurationContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigurationContext.d.ts","names":[],"sources":["../../src/ConfigurationContext.tsx"],"mappings":";;;;;qBASa,wBAAuB"}
+{"version":3,"file":"ConfigurationContext.d.ts","names":[],"sources":["../../src/ConfigurationContext.tsx"],"mappings":";;;;qBASa,wBAAuB"}

package/dist/types/DictionariesRecordContext.d.ts

@@ -1,6 +1,5 @@
 import { DictionaryContent, DictionaryContent as DictionaryContent$1 } from "@intlayer/editor";
 import { Dictionary } from "@intlayer/types/dictionary";
-//#region src/DictionariesRecordContext.d.ts
 type DictionariesRecordStatesContextType = {
   localeDictionaries: DictionaryContent$1;
 };
@@ -10,6 +9,5 @@ type DictionariesRecordActionsContextType = {
 };
 export declare const useDictionariesRecord: () => DictionariesRecordStatesContextType & DictionariesRecordActionsContextType;
 export declare const useDictionariesRecordActions: () => DictionariesRecordActionsContextType;
-//#endregion
 export type { DictionaryContent };
 //# sourceMappingURL=DictionariesRecordContext.d.ts.map

package/dist/types/DictionariesRecordContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DictionariesRecordContext.d.ts","names":[],"sources":["../../src/DictionariesRecordContext.tsx"],"mappings":";;;KASK;EACH,oBAAoB;;KAEjB;EACH,wBAAwB,OAAO;EAC/B,sBAAsB,YAAY;;qBAGvB,6BAA4B,sCACvC;qBAgCW,oCACP"}
+{"version":3,"file":"DictionariesRecordContext.d.ts","names":["DictionaryContent"],"sources":["../../src/DictionariesRecordContext.tsx"],"mappings":";;KASK;EACH,oBAAoBA;;KAEjB;EACH,wBAAwB,OAAOA;EAC/B,sBAAsB,YAAY;;qBAGvB,6BAA4B,sCACvC;qBAgCW,oCACP"}

package/dist/types/EditedContentContext.d.ts

@@ -1,7 +1,6 @@
 import { DictionaryContent, DictionaryContent as DictionaryContent$1 } from "@intlayer/editor";
 import { ContentNode, Dictionary, LocalDictionaryId } from "@intlayer/types/dictionary";
 import { KeyPath } from "@intlayer/types/keyPath";
-//#region src/EditedContentContext.d.ts
 type EditedContentActionsContextType = {
   setEditedContentState: (editedContent: DictionaryContent$1) => void;
   setEditedDictionary: (dict: Dictionary) => void;
@@ -12,6 +11,10 @@ type EditedContentActionsContextType = {
   restoreEditedContent: (localDictionaryId: LocalDictionaryId) => void;
   getEditedContentValue: (localDictionaryIdOrKey: LocalDictionaryId | Dictionary['key'] | string, keyPath: KeyPath[]) => ContentNode | undefined;
 };
+/**
+ * Returns the edited content actions. Memoized on the manager so they can be
+ * used as effect dependencies without a compiler.
+ */
 export declare const useEditedContentActions: () => EditedContentActionsContextType;
 export declare const useEditedContent: () => {
   setEditedContentState: (editedContent: DictionaryContent$1) => void;
@@ -24,6 +27,5 @@ export declare const useEditedContent: () => {
   getEditedContentValue: (localDictionaryIdOrKey: LocalDictionaryId | Dictionary['key'] | string, keyPath: KeyPath[]) => ContentNode | undefined;
   editedContent: DictionaryContent$1;
 };
-//#endregion
 export type { DictionaryContent };
 //# sourceMappingURL=EditedContentContext.d.ts.map

package/dist/types/EditedContentContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditedContentContext.d.ts","names":[],"sources":["../../src/EditedContentContext.tsx"],"mappings":";;;;KAcK;EACH,wBAAwB,eAAe;EACvC,sBAAsB,MAAM;EAC5B,mBACE,mBAAmB,mBACnB,UAAU;EAEZ,mBACE,mBAAmB,mBACnB,UAAU,kBACV,UAAU,WACV;EAEF,sBACE,mBAAmB,mBACnB,QAAQ,gBACR,UAAU;EAEZ,sBACE,mBAAmB,mBACnB,SAAS;EAEX,uBAAuB,mBAAmB;EAC1C,wBACE,wBAAwB,oBAAoB,4BAC5C,SAAS,cACN;;qBAGM,+BAA8B;qBAwB9B;EApDY,wBAAC,eAAe;EAClB,sBAAC,MAAM;EACV,mBAChB,mBAAmB,mBACnB,UAAU;EAEM,mBAChB,mBAAmB,mBACnB,UAAU,kBACV,UAAU,WACV;EAEmB,sBACnB,mBAAmB,mBACnB,QAAQ,gBACR,UAAU;EAES,sBACnB,mBAAmB,mBACnB,SAAS;EAEW,uBAAC,mBAAmB;EACnB,wBACrB,wBAAwB,oBAAoB,4BAC5C,SAAS,cACN"}
+{"version":3,"file":"EditedContentContext.d.ts","names":["DictionaryContent"],"sources":["../../src/EditedContentContext.tsx"],"mappings":";;;KAcK;EACH,wBAAwB,eAAeA;EACvC,sBAAsB,MAAM;EAC5B,mBACE,mBAAmB,mBACnB,UAAU;EAEZ,mBACE,mBAAmB,mBACnB,UAAU,kBACV,UAAU,WACV;EAEF,sBACE,mBAAmB,mBACnB,QAAQ,gBACR,UAAU;EAEZ,sBACE,mBAAmB,mBACnB,SAAS;EAEX,uBAAuB,mBAAmB;EAC1C,wBACE,wBAAwB,oBAAoB,4BAC5C,SAAS,cACN;;;;;;qBAOM,+BAA8B;qBA2B9B;EA3DY,wBAAC,eAAeA;EAClB,sBAAC,MAAM;EACV,mBAChB,mBAAmB,mBACnB,UAAU;EAEM,mBAChB,mBAAmB,mBACnB,UAAU,kBACV,UAAU,WACV;EAEmB,sBACnB,mBAAmB,mBACnB,QAAQ,gBACR,UAAU;EAES,sBACnB,mBAAmB,mBACnB,SAAS;EAEW,uBAAC,mBAAmB;EACnB,wBACrB,wBAAwB,oBAAoB,4BAC5C,SAAS,cACN"}

package/dist/types/EditorEnabledContext.d.ts

@@ -1,4 +1,3 @@
-//#region src/EditorEnabledContext.d.ts
 export type EditorEnabledStateProps = {
   enabled: boolean;
 };
@@ -12,5 +11,4 @@ export declare const useEditorEnabled: () => EditorEnabledStateProps;
  * Use this as the onClick for an "Enable Editor" / reconnect button.
  */
 export declare const useEditorPingClient: () => (() => void);
-//#endregion
 //# sourceMappingURL=EditorEnabledContext.d.ts.map

package/dist/types/EditorEnabledContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorEnabledContext.d.ts","names":[],"sources":["../../src/EditorEnabledContext.tsx"],"mappings":";YAKY;EACV;;;;;;qBAOW,wBAAuB;;;;;qBAsBvB"}
+{"version":3,"file":"EditorEnabledContext.d.ts","names":[],"sources":["../../src/EditorEnabledContext.tsx"],"mappings":"A,YAKY;EACV;;;;;;qBAOW,wBAAuB;;;;;qBAsBvB"}

package/dist/types/EditorProvider.d.ts

@@ -1,6 +1,5 @@
 import { IntlayerConfig } from "@intlayer/types/config";
 import { FC, PropsWithChildren } from "react";
-//#region src/EditorProvider.d.ts
 export type EditorProviderProps = {
   configuration: Pick<IntlayerConfig, 'editor' | 'internationalization'>;
   postMessage: (data: any) => void;
@@ -11,5 +10,4 @@ export type EditorProviderProps = {
  * provides it to all descendants, and registers the Lit web components.
  */
 export declare const EditorProvider: FC<PropsWithChildren<EditorProviderProps>>;
-//#endregion
 //# sourceMappingURL=EditorProvider.d.ts.map

package/dist/types/EditorProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorProvider.d.ts","names":[],"sources":["../../src/EditorProvider.tsx"],"mappings":";;;YAYY;EACV,eAAe,KAAK;EACpB,cAAc;EACd;;;;;;qBAOW,gBAAgB,GAAG,kBAAkB"}
+{"version":3,"file":"EditorProvider.d.ts","names":[],"sources":["../../src/EditorProvider.tsx"],"mappings":";;YAYY;EACV,eAAe,KAAK;EACpB,cAAc;EACd;;;;;;qBAOW,gBAAgB,GAAG,kBAAkB"}

package/dist/types/EditorStateContext.d.ts

@@ -1,9 +1,7 @@
 import { EditorStateManager } from "@intlayer/editor";
 import { FC, PropsWithChildren } from "react";
-//#region src/EditorStateContext.d.ts
 export declare const EditorStateProvider: FC<PropsWithChildren<{
   manager: EditorStateManager;
 }>>;
 export declare const useEditorStateManager: () => EditorStateManager | null;
-//#endregion
 //# sourceMappingURL=EditorStateContext.d.ts.map

package/dist/types/EditorStateContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorStateContext.d.ts","names":[],"sources":["../../src/EditorStateContext.tsx"],"mappings":";;;qBAYa,qBAAqB,GAChC;EAAoB,SAAS;;qBAOlB,6BAA4B"}
+{"version":3,"file":"EditorStateContext.d.ts","names":[],"sources":["../../src/EditorStateContext.tsx"],"mappings":";;qBAYa,qBAAqB,GAChC;EAAoB,SAAS;;qBAOlB,6BAA4B"}

package/dist/types/FocusDictionaryContext.d.ts

@@ -1,6 +1,5 @@
 import { CrossFrameStateAction, FileContent, FileContent as FileContent$1 } from "@intlayer/editor";
 import { KeyPath } from "@intlayer/types/keyPath";
-//#region src/FocusDictionaryContext.d.ts
 export type FocusDictionaryActions = {
   /** Accepts a value or an updater — `setFocusedContent(prev => …)`. */
   setFocusedContent: (value: CrossFrameStateAction<FileContent$1 | null>) => void;
@@ -12,6 +11,5 @@ export type FocusDictionaryActions = {
 export declare const useFocusDictionary: () => FocusDictionaryActions & {
   focusedContent: FileContent$1 | null;
 };
-//#endregion
 export type { FileContent };
 //# sourceMappingURL=FocusDictionaryContext.d.ts.map

package/dist/types/FocusDictionaryContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FocusDictionaryContext.d.ts","names":[],"sources":["../../src/FocusDictionaryContext.tsx"],"mappings":";;;YASY;;EAEV,oBAAoB,OAAO,sBAAsB;EACjD,2BAA2B,SAAS;;;;;qBAMzB,0BAAyB;EACpC,gBAAgB"}
+{"version":3,"file":"FocusDictionaryContext.d.ts","names":["FileContent"],"sources":["../../src/FocusDictionaryContext.tsx"],"mappings":";;YASY;;EAEV,oBAAoB,OAAO,sBAAsBA;EACjD,2BAA2B,SAAS;;;;;qBAMzB,0BAAyB;EACpC,gBAAgBA"}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 import { useConfiguration } from "./ConfigurationContext.js";
-import { DictionaryContent as DictionaryContent$1, useDictionariesRecord, useDictionariesRecordActions } from "./DictionariesRecordContext.js";
+import { DictionaryContent, useDictionariesRecord, useDictionariesRecordActions } from "./DictionariesRecordContext.js";
 import { useEditedContent, useEditedContentActions } from "./EditedContentContext.js";
 import { EditorEnabledStateProps, useEditorEnabled, useEditorPingClient } from "./EditorEnabledContext.js";
 import { EditorProvider, EditorProviderProps } from "./EditorProvider.js";
@@ -10,5 +10,7 @@ import { useCrossURLPathState } from "./useCrossURLPathState.js";
 import { useEditedContentPersistence } from "./useEditedContentPersistence.js";
 import { useEditorLocale } from "./useEditorLocale.js";
 import { useFocusUnmergedDictionary } from "./useFocusUnmergedDictionary.js";
+import { FRAME_CONNECTION_TIMEOUT_MS, FrameConnectionStatus, useFrameConnectionStatus } from "./useFrameConnectionStatus.js";
+import { FRAME_RECONNECTION_INTERVAL_MS, FrameReconnectionOptions, isApplicationReachable, useFrameReconnection } from "./useFrameReconnection.js";
 import { MessageKey } from "@intlayer/editor";
-export { EditorEnabledStateProps, EditorProvider, EditorProviderProps, EditorStateProvider, type FileContent, FocusDictionaryActions, MessageKey, useConfiguration, useCrossFrameState, useCrossURLPathState, useDictionariesRecord, useDictionariesRecordActions, useEditedContent, useEditedContentActions, useEditedContentPersistence, useEditorEnabled, useEditorLocale, useEditorPingClient, useEditorStateManager, useFocusDictionary, useFocusUnmergedDictionary };
+export { type DictionaryContent, EditorEnabledStateProps, EditorProvider, EditorProviderProps, EditorStateProvider, FRAME_CONNECTION_TIMEOUT_MS, FRAME_RECONNECTION_INTERVAL_MS, type FileContent, FocusDictionaryActions, FrameConnectionStatus, FrameReconnectionOptions, MessageKey, isApplicationReachable, useConfiguration, useCrossFrameState, useCrossURLPathState, useDictionariesRecord, useDictionariesRecordActions, useEditedContent, useEditedContentActions, useEditedContentPersistence, useEditorEnabled, useEditorLocale, useEditorPingClient, useEditorStateManager, useFocusDictionary, useFocusUnmergedDictionary, useFrameConnectionStatus, useFrameReconnection };

package/dist/types/useCrossFrameState.d.ts

@@ -1,8 +1,6 @@
 import { MessageKey } from "@intlayer/editor";
-//#region src/useCrossFrameState.d.ts
 /**
  * Returns the latest value another frame posted under `key`.
  */
 export declare const useCrossFrameState: <Value>(key: `${MessageKey}`, initialValue: Value) => Value;
-//#endregion
 //# sourceMappingURL=useCrossFrameState.d.ts.map

package/dist/types/useCrossFrameState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCrossFrameState.d.ts","names":[],"sources":["../../src/useCrossFrameState.tsx"],"mappings":";;;;;qBASa,qBAAsB,OAAK,QAC9B,cAAY,cACN,UACb"}
+{"version":3,"file":"useCrossFrameState.d.ts","names":[],"sources":["../../src/useCrossFrameState.tsx"],"mappings":";;;;qBASa,qBAAsB,OAAK,QAC9B,cAAY,cACN,UACb"}

package/dist/types/useCrossURLPathState.d.ts

@@ -1,7 +1,5 @@
-//#region src/useCrossURLPathState.d.ts
 /**
  * Returns the path currently displayed by the client application.
  */
 export declare const useCrossURLPathState: () => string | undefined;
-//#endregion
 //# sourceMappingURL=useCrossURLPathState.d.ts.map

package/dist/types/useCrossURLPathState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCrossURLPathState.d.ts","names":[],"sources":["../../src/useCrossURLPathState.tsx"],"mappings":";;;;qBAQa"}
+{"version":3,"file":"useCrossURLPathState.d.ts","names":[],"sources":["../../src/useCrossURLPathState.tsx"],"mappings":";;;qBAQa"}

package/dist/types/useEditedContentPersistence.d.ts

@@ -1,8 +1,6 @@
-//#region src/useEditedContentPersistence.d.ts
 /**
  * Persists the edited content in localStorage, and restores it on mount so
  * unsaved edits survive a page reload.
  */
 export declare const useEditedContentPersistence: () => void;
-//#endregion
 //# sourceMappingURL=useEditedContentPersistence.d.ts.map

package/dist/types/useEditedContentPersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditedContentPersistence.d.ts","names":[],"sources":["../../src/useEditedContentPersistence.tsx"],"mappings":";;;;;qBAWa"}
+{"version":3,"file":"useEditedContentPersistence.d.ts","names":[],"sources":["../../src/useEditedContentPersistence.tsx"],"mappings":";;;;qBAWa"}

package/dist/types/useEditorLocale.d.ts

@@ -1,5 +1,3 @@
 import { Locale } from "@intlayer/types/allLocales";
-//#region src/useEditorLocale.d.ts
 export declare const useEditorLocale: () => Locale | undefined;
-//#endregion
 //# sourceMappingURL=useEditorLocale.d.ts.map

package/dist/types/useEditorLocale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditorLocale.d.ts","names":[],"sources":["../../src/useEditorLocale.tsx"],"mappings":";;qBAMa,uBAAsB"}
+{"version":3,"file":"useEditorLocale.d.ts","names":[],"sources":["../../src/useEditorLocale.tsx"],"mappings":";qBAMa,uBAAsB"}

package/dist/types/useFocusUnmergedDictionary.d.ts

@@ -1,10 +1,8 @@
 import { FileContent } from "./FocusDictionaryContext.js";
 import { KeyPath } from "@intlayer/types/keyPath";
-//#region src/useFocusUnmergedDictionary.d.ts
 export declare const useFocusUnmergedDictionary: () => {
   focusedContent: FileContent;
   setFocusedContent: (value: import("@intlayer/editor").CrossFrameStateAction<FileContent | null>) => void;
   setFocusedContentKeyPath: (keyPath: KeyPath[]) => void;
 };
-//#endregion
 //# sourceMappingURL=useFocusUnmergedDictionary.d.ts.map

package/dist/types/useFocusUnmergedDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFocusUnmergedDictionary.d.ts","names":[],"sources":["../../src/useFocusUnmergedDictionary.tsx"],"mappings":";;;qBA8Ca"}
+{"version":3,"file":"useFocusUnmergedDictionary.d.ts","names":[],"sources":["../../src/useFocusUnmergedDictionary.tsx"],"mappings":";;qBA8Ca"}

package/dist/types/useFrameConnectionStatus.d.ts

@@ -0,0 +1,22 @@
+/** Delay after a frame load before an unanswered handshake counts as failed. */
+export declare const FRAME_CONNECTION_TIMEOUT_MS = 5000;
+export type FrameConnectionStatus = {
+  /**
+   * The frame loaded but its client never answered the handshake: the page
+   * refused to be framed (CSP `frame-ancestors`, `X-Frame-Options`), or it
+   * does not run the editor client.
+   */
+  isConnectionFailed: boolean;
+  /** To call on every `load` event of the application frame. */
+  handleFrameLoad: () => void;
+  /** Hides the failure until the next load. */
+  dismiss: () => void;
+};
+/**
+ * Detects an application frame that never connects to the editor.
+ * A frame blocked by the application's framing policy still fires `load` on
+ * an empty error page that the parent cannot inspect, so the missing
+ * handshake is the only signal available.
+ */
+export declare const useFrameConnectionStatus: (timeoutMs?: number) => FrameConnectionStatus;
+//# sourceMappingURL=useFrameConnectionStatus.d.ts.map

package/dist/types/useFrameConnectionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrameConnectionStatus.d.ts","names":[],"sources":["../../src/useFrameConnectionStatus.ts"],"mappings":";qBAMa;YAED;;;;;;EAMV;;EAEA;;EAEA;;;;;;;;qBASW,2BAAwB,uBAElC"}

package/dist/types/useFrameReconnection.d.ts

@@ -0,0 +1,23 @@
+/** Delay between two probes of a disconnected application. */
+export declare const FRAME_RECONNECTION_INTERVAL_MS = 3000;
+/**
+ * Whether the application answers. `no-cors` resolves on any HTTP answer and
+ * only rejects on a network failure: the editor origin is rarely in the
+ * application's CORS allowlist.
+ */
+export declare const isApplicationReachable: (applicationURL: string) => Promise<boolean>;
+export type FrameReconnectionOptions = {
+  applicationURL: string | undefined;
+  /** The frame lost (or never got) its connection to the editor. */
+  isDisconnected: boolean;
+  /** Reloads the application frame. */
+  reloadFrame: () => void;
+  intervalMs?: number;
+};
+/**
+ * Reconnects a disconnected application frame: the frame is reloaded once
+ * when the application still answers (e.g. it reloaded while its dev server
+ * restarted), then each time it answers again after being unreachable.
+ */
+export declare const useFrameReconnection: ({ applicationURL, isDisconnected, reloadFrame, intervalMs }: FrameReconnectionOptions) => void;
+//# sourceMappingURL=useFrameReconnection.d.ts.map

package/dist/types/useFrameReconnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrameReconnection.d.ts","names":[],"sources":["../../src/useFrameReconnection.ts"],"mappings":";qBAKa;;;;;;qBAOA,yBAAsB,2BAEhC;YAKS;EACV;;EAEA;;EAEA;EACA;;;;;;;qBAQW,yBAAoB,gBAAA,gBAAA,aAAA,cAK9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/editor-react",
-  "version": "9.6.0",
+  "version": "9.7.1",
   "private": false,
   "description": "Provides the states, contexts, hooks and components to interact with the Intlayer editor for a React application",
   "keywords": [
@@ -71,13 +71,13 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/config": "9.6.0",
-    "@intlayer/core": "9.6.0",
-    "@intlayer/editor": "9.6.0",
-    "@intlayer/types": "9.6.0"
+    "@intlayer/config": "9.7.1",
+    "@intlayer/core": "9.7.1",
+    "@intlayer/editor": "9.7.1",
+    "@intlayer/types": "9.7.1"
   },
   "devDependencies": {
-    "@types/node": "^22",
+    "@types/node": "^26",
     "@types/react": ">=16.0.0",
     "@types/react-dom": ">=16.0.0",
     "@utils/ts-config": "1.0.4",
@@ -86,9 +86,9 @@
     "react": ">=16.0.0",
     "react-dom": ">=16.0.0",
     "rimraf": "6.1.3",
-    "tsdown": "0.23.0",
+    "tsdown": "0.23.4",
     "typescript": "7.0.2",
-    "vitest": "5.0.3"
+    "vitest": "5.1.0"
   },
   "peerDependencies": {
     "react": ">=16.0.0",