@strapi/content-manager 0.0.0-next.965570e6e12a33ad098ddb3174a9750fddb03be2 → 0.0.0-next.96a532b33a712f19b498ed0a82a84752247cd899

package/dist/admin/preview/utils/fieldUtils.js

@@ -0,0 +1,107 @@
+'use strict';
+
+// Generic error class for preview field operations
+class PreviewFieldError extends Error {
+    constructor(messageKey){
+        super(messageKey);
+        this.name = 'PreviewFieldError';
+        this.messageKey = messageKey;
+    }
+}
+// Helper function to parse path with array indices and return clean attribute names
+const parsePathWithIndices = (path)=>{
+    // Split by dots, then parse array indices from each part. For example:
+    // input "components.4.field.relations.2.name"
+    // output [{name: "components", index: 4}, {name: "field"}, {name: "relations", index: 2}, {name: "name"}]
+    return path.split('.').map((part)=>{
+        const numericIndex = parseInt(part, 10);
+        if (!isNaN(numericIndex) && part === numericIndex.toString()) {
+            // This part is a pure numeric index, return it as an index for the previous part
+            return {
+                name: '',
+                index: numericIndex
+            };
+        }
+        return {
+            name: part
+        };
+    }).reduce((acc, part)=>{
+        if (part.name === '' && part.index !== undefined) {
+            // This is an index, attach it to the previous part
+            if (acc.length > 0) {
+                acc[acc.length - 1].index = part.index;
+            }
+        } else {
+            acc.push(part);
+        }
+        return acc;
+    }, []);
+};
+function getAttributeSchemaFromPath({ path, schema, components, document }) {
+    /**
+   * Create the function that will be recursively called.
+   * We don't do recursion on getAttributeSchemaFromPath itself because:
+   * - it takes a path string, not the parsed array that's better for recursion
+   * - even when several levels deep, we still need access to the root schema and components
+   */ const visitor = (currentPathParts, currentAttributes, currentData)=>{
+        const [currentPart, ...remainingParts] = currentPathParts;
+        // Get the data and schema for the current path
+        const currentAttribute = currentAttributes[currentPart.name];
+        if (!currentAttribute) {
+            throw new PreviewFieldError('INVALID_FIELD_PATH');
+        }
+        if (currentAttribute.type === 'relation') {
+            throw new PreviewFieldError('RELATIONS_NOT_HANDLED');
+        }
+        if (currentAttribute.type === 'component') {
+            const componentAttributes = components[currentAttribute.component].attributes;
+            if (currentAttribute.repeatable) {
+                // We must have the index, otherwise we don't know what data to use
+                if (currentPart.index === undefined) {
+                    throw new PreviewFieldError('INVALID_FIELD_PATH');
+                }
+                return visitor(remainingParts, componentAttributes, currentData[currentPart.name][currentPart.index]);
+            }
+            // Non repeatable component
+            return visitor(remainingParts, componentAttributes, currentData[currentPart.name]);
+        }
+        if (currentAttribute.type === 'dynamiczone') {
+            // We must have the index, otherwise we don't know what component we're dealing with
+            if (currentPart.index === undefined) {
+                throw new PreviewFieldError('INVALID_FIELD_PATH');
+            }
+            const componentData = currentData[currentPart.name][currentPart.index];
+            const componentAttributes = components[componentData.__component].attributes;
+            return visitor(remainingParts, componentAttributes, componentData);
+        }
+        // Plain regular field. It ends the recursion
+        return currentAttributes[currentPart.name];
+    };
+    return visitor(parsePathWithIndices(path), schema.attributes, document);
+}
+function parseFieldMetaData(strapiSource) {
+    const searchParams = new URLSearchParams(strapiSource);
+    const path = searchParams.get('path');
+    const type = searchParams.get('type');
+    const documentId = searchParams.get('documentId');
+    const locale = searchParams.get('locale');
+    const model = searchParams.get('model');
+    const kind = searchParams.get('kind');
+    if (!path || !type || !documentId || !model) {
+        return null;
+    }
+    return {
+        path,
+        type: type,
+        documentId,
+        locale: locale ?? null,
+        model: model,
+        kind: kind ? kind : undefined
+    };
+}
+
+exports.PreviewFieldError = PreviewFieldError;
+exports.getAttributeSchemaFromPath = getAttributeSchemaFromPath;
+exports.parseFieldMetaData = parseFieldMetaData;
+exports.parsePathWithIndices = parsePathWithIndices;
+//# sourceMappingURL=fieldUtils.js.map

package/dist/admin/preview/utils/fieldUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldUtils.js","sources":["../../../../admin/src/preview/utils/fieldUtils.ts"],"sourcesContent":["import { type FieldContentSourceMap } from '@strapi/admin/strapi-admin';\n\nimport type { PREVIEW_ERROR_MESSAGES } from './constants';\nimport type { PreviewContextValue } from '../pages/Preview';\nimport type { Modules, Schema, Struct, UID } from '@strapi/types';\n\ntype PreviewErrorMessage = keyof typeof PREVIEW_ERROR_MESSAGES;\n\n// Generic error class for preview field operations\nexport class PreviewFieldError extends Error {\n  public readonly messageKey: PreviewErrorMessage;\n\n  constructor(messageKey: PreviewErrorMessage) {\n    super(messageKey);\n    this.name = 'PreviewFieldError';\n    this.messageKey = messageKey;\n  }\n}\n\ntype PathPart = { name: string; index?: number };\n\n// Helper function to parse path with array indices and return clean attribute names\nexport const parsePathWithIndices = (path: string): PathPart[] => {\n  // Split by dots, then parse array indices from each part. For example:\n  // input \"components.4.field.relations.2.name\"\n  // output [{name: \"components\", index: 4}, {name: \"field\"}, {name: \"relations\", index: 2}, {name: \"name\"}]\n  return path\n    .split('.')\n    .map((part) => {\n      const numericIndex = parseInt(part, 10);\n      if (!isNaN(numericIndex) && part === numericIndex.toString()) {\n        // This part is a pure numeric index, return it as an index for the previous part\n        return { name: '', index: numericIndex };\n      }\n      return { name: part };\n    })\n    .reduce((acc: PathPart[], part) => {\n      if (part.name === '' && part.index !== undefined) {\n        // This is an index, attach it to the previous part\n        if (acc.length > 0) {\n          acc[acc.length - 1].index = part.index;\n        }\n      } else {\n        acc.push(part);\n      }\n      return acc;\n    }, []);\n};\n\nexport function getAttributeSchemaFromPath({\n  path,\n  schema,\n  components,\n  document,\n}: {\n  path: string;\n  schema: PreviewContextValue['schema'] | PreviewContextValue['components'][string];\n  components: PreviewContextValue['components'];\n  document: Modules.Documents.AnyDocument;\n}): Schema.Attribute.AnyAttribute {\n  /**\n   * Create the function that will be recursively called.\n   * We don't do recursion on getAttributeSchemaFromPath itself because:\n   * - it takes a path string, not the parsed array that's better for recursion\n   * - even when several levels deep, we still need access to the root schema and components\n   */\n  const visitor = (\n    currentPathParts: PathPart[],\n    currentAttributes: Schema.Attributes,\n    currentData: any\n  ): Schema.Attribute.AnyAttribute => {\n    const [currentPart, ...remainingParts] = currentPathParts;\n\n    // Get the data and schema for the current path\n    const currentAttribute = currentAttributes[currentPart.name];\n\n    if (!currentAttribute) {\n      throw new PreviewFieldError('INVALID_FIELD_PATH');\n    }\n\n    if (currentAttribute.type === 'relation') {\n      throw new PreviewFieldError('RELATIONS_NOT_HANDLED');\n    }\n\n    if (currentAttribute.type === 'component') {\n      const componentAttributes = components[currentAttribute.component].attributes;\n      if (currentAttribute.repeatable) {\n        // We must have the index, otherwise we don't know what data to use\n        if (currentPart.index === undefined) {\n          throw new PreviewFieldError('INVALID_FIELD_PATH');\n        }\n        return visitor(\n          remainingParts,\n          componentAttributes,\n          currentData[currentPart.name][currentPart.index]\n        );\n      }\n\n      // Non repeatable component\n      return visitor(remainingParts, componentAttributes, currentData[currentPart.name]);\n    }\n\n    if (currentAttribute.type === 'dynamiczone') {\n      // We must have the index, otherwise we don't know what component we're dealing with\n      if (currentPart.index === undefined) {\n        throw new PreviewFieldError('INVALID_FIELD_PATH');\n      }\n\n      const componentData = currentData[currentPart.name][currentPart.index];\n      const componentAttributes = components[componentData.__component].attributes;\n      return visitor(remainingParts, componentAttributes, componentData);\n    }\n\n    // Plain regular field. It ends the recursion\n    return currentAttributes[currentPart.name];\n  };\n\n  return visitor(parsePathWithIndices(path), schema.attributes, document);\n}\n\nexport function parseFieldMetaData(strapiSource: string): FieldContentSourceMap | null {\n  const searchParams = new URLSearchParams(strapiSource);\n  const path = searchParams.get('path');\n  const type = searchParams.get('type');\n  const documentId = searchParams.get('documentId');\n  const locale = searchParams.get('locale');\n  const model = searchParams.get('model');\n  const kind = searchParams.get('kind');\n\n  if (!path || !type || !documentId || !model) {\n    return null;\n  }\n\n  return {\n    path,\n    type: type as Schema.Attribute.AnyAttribute['type'],\n    documentId,\n    locale: locale ?? null,\n    model: model as UID.Schema | undefined,\n    kind: kind ? (kind as Struct.ContentTypeKind) : undefined,\n  };\n}\n"],"names":["PreviewFieldError","Error","constructor","messageKey","name","parsePathWithIndices","path","split","map","part","numericIndex","parseInt","isNaN","toString","index","reduce","acc","undefined","length","push","getAttributeSchemaFromPath","schema","components","document","visitor","currentPathParts","currentAttributes","currentData","currentPart","remainingParts","currentAttribute","type","componentAttributes","component","attributes","repeatable","componentData","__component","parseFieldMetaData","strapiSource","searchParams","URLSearchParams","get","documentId","locale","model","kind"],"mappings":"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"}

package/dist/admin/preview/utils/fieldUtils.mjs

@@ -0,0 +1,102 @@
+// Generic error class for preview field operations
+class PreviewFieldError extends Error {
+    constructor(messageKey){
+        super(messageKey);
+        this.name = 'PreviewFieldError';
+        this.messageKey = messageKey;
+    }
+}
+// Helper function to parse path with array indices and return clean attribute names
+const parsePathWithIndices = (path)=>{
+    // Split by dots, then parse array indices from each part. For example:
+    // input "components.4.field.relations.2.name"
+    // output [{name: "components", index: 4}, {name: "field"}, {name: "relations", index: 2}, {name: "name"}]
+    return path.split('.').map((part)=>{
+        const numericIndex = parseInt(part, 10);
+        if (!isNaN(numericIndex) && part === numericIndex.toString()) {
+            // This part is a pure numeric index, return it as an index for the previous part
+            return {
+                name: '',
+                index: numericIndex
+            };
+        }
+        return {
+            name: part
+        };
+    }).reduce((acc, part)=>{
+        if (part.name === '' && part.index !== undefined) {
+            // This is an index, attach it to the previous part
+            if (acc.length > 0) {
+                acc[acc.length - 1].index = part.index;
+            }
+        } else {
+            acc.push(part);
+        }
+        return acc;
+    }, []);
+};
+function getAttributeSchemaFromPath({ path, schema, components, document }) {
+    /**
+   * Create the function that will be recursively called.
+   * We don't do recursion on getAttributeSchemaFromPath itself because:
+   * - it takes a path string, not the parsed array that's better for recursion
+   * - even when several levels deep, we still need access to the root schema and components
+   */ const visitor = (currentPathParts, currentAttributes, currentData)=>{
+        const [currentPart, ...remainingParts] = currentPathParts;
+        // Get the data and schema for the current path
+        const currentAttribute = currentAttributes[currentPart.name];
+        if (!currentAttribute) {
+            throw new PreviewFieldError('INVALID_FIELD_PATH');
+        }
+        if (currentAttribute.type === 'relation') {
+            throw new PreviewFieldError('RELATIONS_NOT_HANDLED');
+        }
+        if (currentAttribute.type === 'component') {
+            const componentAttributes = components[currentAttribute.component].attributes;
+            if (currentAttribute.repeatable) {
+                // We must have the index, otherwise we don't know what data to use
+                if (currentPart.index === undefined) {
+                    throw new PreviewFieldError('INVALID_FIELD_PATH');
+                }
+                return visitor(remainingParts, componentAttributes, currentData[currentPart.name][currentPart.index]);
+            }
+            // Non repeatable component
+            return visitor(remainingParts, componentAttributes, currentData[currentPart.name]);
+        }
+        if (currentAttribute.type === 'dynamiczone') {
+            // We must have the index, otherwise we don't know what component we're dealing with
+            if (currentPart.index === undefined) {
+                throw new PreviewFieldError('INVALID_FIELD_PATH');
+            }
+            const componentData = currentData[currentPart.name][currentPart.index];
+            const componentAttributes = components[componentData.__component].attributes;
+            return visitor(remainingParts, componentAttributes, componentData);
+        }
+        // Plain regular field. It ends the recursion
+        return currentAttributes[currentPart.name];
+    };
+    return visitor(parsePathWithIndices(path), schema.attributes, document);
+}
+function parseFieldMetaData(strapiSource) {
+    const searchParams = new URLSearchParams(strapiSource);
+    const path = searchParams.get('path');
+    const type = searchParams.get('type');
+    const documentId = searchParams.get('documentId');
+    const locale = searchParams.get('locale');
+    const model = searchParams.get('model');
+    const kind = searchParams.get('kind');
+    if (!path || !type || !documentId || !model) {
+        return null;
+    }
+    return {
+        path,
+        type: type,
+        documentId,
+        locale: locale ?? null,
+        model: model,
+        kind: kind ? kind : undefined
+    };
+}
+
+export { PreviewFieldError, getAttributeSchemaFromPath, parseFieldMetaData, parsePathWithIndices };
+//# sourceMappingURL=fieldUtils.mjs.map

package/dist/admin/preview/utils/fieldUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldUtils.mjs","sources":["../../../../admin/src/preview/utils/fieldUtils.ts"],"sourcesContent":["import { type FieldContentSourceMap } from '@strapi/admin/strapi-admin';\n\nimport type { PREVIEW_ERROR_MESSAGES } from './constants';\nimport type { PreviewContextValue } from '../pages/Preview';\nimport type { Modules, Schema, Struct, UID } from '@strapi/types';\n\ntype PreviewErrorMessage = keyof typeof PREVIEW_ERROR_MESSAGES;\n\n// Generic error class for preview field operations\nexport class PreviewFieldError extends Error {\n  public readonly messageKey: PreviewErrorMessage;\n\n  constructor(messageKey: PreviewErrorMessage) {\n    super(messageKey);\n    this.name = 'PreviewFieldError';\n    this.messageKey = messageKey;\n  }\n}\n\ntype PathPart = { name: string; index?: number };\n\n// Helper function to parse path with array indices and return clean attribute names\nexport const parsePathWithIndices = (path: string): PathPart[] => {\n  // Split by dots, then parse array indices from each part. For example:\n  // input \"components.4.field.relations.2.name\"\n  // output [{name: \"components\", index: 4}, {name: \"field\"}, {name: \"relations\", index: 2}, {name: \"name\"}]\n  return path\n    .split('.')\n    .map((part) => {\n      const numericIndex = parseInt(part, 10);\n      if (!isNaN(numericIndex) && part === numericIndex.toString()) {\n        // This part is a pure numeric index, return it as an index for the previous part\n        return { name: '', index: numericIndex };\n      }\n      return { name: part };\n    })\n    .reduce((acc: PathPart[], part) => {\n      if (part.name === '' && part.index !== undefined) {\n        // This is an index, attach it to the previous part\n        if (acc.length > 0) {\n          acc[acc.length - 1].index = part.index;\n        }\n      } else {\n        acc.push(part);\n      }\n      return acc;\n    }, []);\n};\n\nexport function getAttributeSchemaFromPath({\n  path,\n  schema,\n  components,\n  document,\n}: {\n  path: string;\n  schema: PreviewContextValue['schema'] | PreviewContextValue['components'][string];\n  components: PreviewContextValue['components'];\n  document: Modules.Documents.AnyDocument;\n}): Schema.Attribute.AnyAttribute {\n  /**\n   * Create the function that will be recursively called.\n   * We don't do recursion on getAttributeSchemaFromPath itself because:\n   * - it takes a path string, not the parsed array that's better for recursion\n   * - even when several levels deep, we still need access to the root schema and components\n   */\n  const visitor = (\n    currentPathParts: PathPart[],\n    currentAttributes: Schema.Attributes,\n    currentData: any\n  ): Schema.Attribute.AnyAttribute => {\n    const [currentPart, ...remainingParts] = currentPathParts;\n\n    // Get the data and schema for the current path\n    const currentAttribute = currentAttributes[currentPart.name];\n\n    if (!currentAttribute) {\n      throw new PreviewFieldError('INVALID_FIELD_PATH');\n    }\n\n    if (currentAttribute.type === 'relation') {\n      throw new PreviewFieldError('RELATIONS_NOT_HANDLED');\n    }\n\n    if (currentAttribute.type === 'component') {\n      const componentAttributes = components[currentAttribute.component].attributes;\n      if (currentAttribute.repeatable) {\n        // We must have the index, otherwise we don't know what data to use\n        if (currentPart.index === undefined) {\n          throw new PreviewFieldError('INVALID_FIELD_PATH');\n        }\n        return visitor(\n          remainingParts,\n          componentAttributes,\n          currentData[currentPart.name][currentPart.index]\n        );\n      }\n\n      // Non repeatable component\n      return visitor(remainingParts, componentAttributes, currentData[currentPart.name]);\n    }\n\n    if (currentAttribute.type === 'dynamiczone') {\n      // We must have the index, otherwise we don't know what component we're dealing with\n      if (currentPart.index === undefined) {\n        throw new PreviewFieldError('INVALID_FIELD_PATH');\n      }\n\n      const componentData = currentData[currentPart.name][currentPart.index];\n      const componentAttributes = components[componentData.__component].attributes;\n      return visitor(remainingParts, componentAttributes, componentData);\n    }\n\n    // Plain regular field. It ends the recursion\n    return currentAttributes[currentPart.name];\n  };\n\n  return visitor(parsePathWithIndices(path), schema.attributes, document);\n}\n\nexport function parseFieldMetaData(strapiSource: string): FieldContentSourceMap | null {\n  const searchParams = new URLSearchParams(strapiSource);\n  const path = searchParams.get('path');\n  const type = searchParams.get('type');\n  const documentId = searchParams.get('documentId');\n  const locale = searchParams.get('locale');\n  const model = searchParams.get('model');\n  const kind = searchParams.get('kind');\n\n  if (!path || !type || !documentId || !model) {\n    return null;\n  }\n\n  return {\n    path,\n    type: type as Schema.Attribute.AnyAttribute['type'],\n    documentId,\n    locale: locale ?? null,\n    model: model as UID.Schema | undefined,\n    kind: kind ? (kind as Struct.ContentTypeKind) : undefined,\n  };\n}\n"],"names":["PreviewFieldError","Error","constructor","messageKey","name","parsePathWithIndices","path","split","map","part","numericIndex","parseInt","isNaN","toString","index","reduce","acc","undefined","length","push","getAttributeSchemaFromPath","schema","components","document","visitor","currentPathParts","currentAttributes","currentData","currentPart","remainingParts","currentAttribute","type","componentAttributes","component","attributes","repeatable","componentData","__component","parseFieldMetaData","strapiSource","searchParams","URLSearchParams","get","documentId","locale","model","kind"],"mappings":"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"}

package/dist/admin/preview/utils/previewScript.js

@@ -12,6 +12,8 @@
    * ---------------------------------------------------------------------------------------------*/ const HIGHLIGHT_PADDING = 2; // in pixels
     const HIGHLIGHT_HOVER_COLOR = window.STRAPI_HIGHLIGHT_HOVER_COLOR ?? '#4945ff'; // dark primary500
     const HIGHLIGHT_ACTIVE_COLOR = window.STRAPI_HIGHLIGHT_ACTIVE_COLOR ?? '#7b79ff'; // dark primary600
+    const HIGHLIGHT_STYLES_ID = 'strapi-preview-highlight-styles';
+    const DOUBLE_CLICK_TIMEOUT = 300; // milliseconds to wait for potential double-click
     const DISABLE_STEGA_DECODING = window.STRAPI_DISABLE_STEGA_DECODING ?? false;
     const SOURCE_ATTRIBUTE = 'data-strapi-source';
     const OVERLAY_ID = 'strapi-preview-overlay';
@@ -19,7 +21,8 @@
         STRAPI_FIELD_FOCUS: 'strapiFieldFocus',
         STRAPI_FIELD_BLUR: 'strapiFieldBlur',
         STRAPI_FIELD_CHANGE: 'strapiFieldChange',
-        STRAPI_FIELD_FOCUS_INTENT: 'strapiFieldFocusIntent'
+        STRAPI_FIELD_FOCUS_INTENT: 'strapiFieldFocusIntent',
+        STRAPI_FIELD_SINGLE_CLICK_HINT: 'strapiFieldSingleClickHint'
     };
     /**
    * Calling the function in no-run mode lets us retrieve the constants from other files and keep
@@ -38,6 +41,9 @@
             payload
         }, '*');
     };
+    const getElementsByPath = (path)=>{
+        return document.querySelectorAll(`[${SOURCE_ATTRIBUTE}*="path=${path}"]`);
+    };
     /* -----------------------------------------------------------------------------------------------
    * Functionality pieces
    * ---------------------------------------------------------------------------------------------*/ const setupStegaDOMObserver = async ()=>{
@@ -52,9 +58,10 @@
             const directTextContent = directTextNodes.map((node)=>node.textContent || '').join('');
             if (directTextContent) {
                 try {
+                    // TODO: check if we can call split instead of decode+clean
                     const result = stegaDecode(directTextContent);
-                    if (result) {
-                        element.setAttribute(SOURCE_ATTRIBUTE, result.key);
+                    if (result && 'strapiSource' in result) {
+                        element.setAttribute(SOURCE_ATTRIBUTE, result.strapiSource);
                         // Remove encoded part from DOM text content (to avoid breaking links for example)
                         directTextNodes.forEach((node)=>{
                             if (node.textContent) {
@@ -100,6 +107,37 @@
         });
         return observer;
     };
+    const createHighlightStyles = ()=>{
+        const existingStyles = document.getElementById(HIGHLIGHT_STYLES_ID);
+        // Remove existing styles to avoid duplicates
+        if (existingStyles) {
+            existingStyles.remove();
+        }
+        const styleElement = document.createElement('style');
+        styleElement.id = HIGHLIGHT_STYLES_ID;
+        styleElement.textContent = `
+      .strapi-highlight {
+        position: absolute;
+        outline: 2px solid transparent;
+        pointer-events: auto;
+        border-radius: 2px;
+        background-color: transparent;
+        will-change: transform;
+        transition: outline-color 0.1s ease-in-out;
+      }
+
+      .strapi-highlight:hover {
+        outline-color: ${HIGHLIGHT_HOVER_COLOR} !important;
+      }
+
+      .strapi-highlight.strapi-highlight-focused {
+        outline-color: ${HIGHLIGHT_ACTIVE_COLOR} !important;
+        outline-width: 3px !important;
+      }
+    `;
+        document.head.appendChild(styleElement);
+        return styleElement;
+    };
     const createOverlaySystem = ()=>{
         // Clean up before creating a new overlay so we can safely call previewScript multiple times
         window.__strapi_previewCleanup?.();
@@ -122,6 +160,7 @@
         const elementsToHighlight = new Map();
         const eventListeners = [];
         const focusedHighlights = [];
+        const pendingClicks = new Map(); // number is timeout id
         let focusedField = null;
         const drawHighlight = (target, highlight)=>{
             if (!highlight) return;
@@ -141,27 +180,57 @@
                 return;
             }
             const highlight = document.createElement('div');
-            highlight.style.cssText = `
-        position: absolute;
-        outline: 2px solid transparent;
-        pointer-events: none;
-        border-radius: 2px;
-        background-color: transparent;
-        will-change: transform;
-        transition: outline-color 0.1s ease-in-out;
-      `;
-            // Move hover detection to the underlying element
-            const mouseEnterHandler = ()=>{
-                if (!focusedHighlights.includes(highlight)) {
-                    highlight.style.outlineColor = HIGHLIGHT_HOVER_COLOR;
+            highlight.className = 'strapi-highlight';
+            const clickHandler = (event)=>{
+                // Skip if this is a re-dispatched event from our delayed handler to avoid infinite loops
+                if (event.__strapi_redispatched) {
+                    return;
                 }
-            };
-            const mouseLeaveHandler = ()=>{
-                if (!focusedHighlights.includes(highlight)) {
-                    highlight.style.outlineColor = 'transparent';
+                // Prevent the immediate action for interactive elements
+                event.preventDefault();
+                event.stopPropagation();
+                // Clear any existing timeout for this element
+                const existingTimeout = pendingClicks.get(element);
+                if (existingTimeout) {
+                    window.clearTimeout(existingTimeout);
+                    pendingClicks.delete(element);
                 }
+                // Set up a delayed single-click handler
+                const timeout = window.setTimeout(()=>{
+                    pendingClicks.delete(element);
+                    // Send single-click hint notification
+                    sendMessage(INTERNAL_EVENTS.STRAPI_FIELD_SINGLE_CLICK_HINT, null);
+                    // Re-trigger the click on the underlying element after the double-click timeout
+                    // Create a new event to dispatch with a marker to prevent re-handling
+                    const newEvent = new MouseEvent('click', {
+                        bubbles: true,
+                        cancelable: true,
+                        view: window,
+                        detail: 1,
+                        button: event.button,
+                        buttons: event.buttons,
+                        clientX: event.clientX,
+                        clientY: event.clientY,
+                        ctrlKey: event.ctrlKey,
+                        altKey: event.altKey,
+                        shiftKey: event.shiftKey,
+                        metaKey: event.metaKey
+                    });
+                    newEvent.__strapi_redispatched = true;
+                    element.dispatchEvent(newEvent);
+                }, DOUBLE_CLICK_TIMEOUT);
+                pendingClicks.set(element, timeout);
             };
-            const doubleClickHandler = ()=>{
+            const doubleClickHandler = (event)=>{
+                // Prevent the default behavior on double-click
+                event.preventDefault();
+                event.stopPropagation();
+                // Clear any pending single-click action
+                const existingTimeout = pendingClicks.get(element);
+                if (existingTimeout) {
+                    clearTimeout(existingTimeout);
+                    pendingClicks.delete(element);
+                }
                 const sourceAttribute = element.getAttribute(SOURCE_ATTRIBUTE);
                 if (sourceAttribute) {
                     const rect = element.getBoundingClientRect();
@@ -184,25 +253,20 @@
                     event.preventDefault();
                 }
             };
-            element.addEventListener('mouseenter', mouseEnterHandler);
-            element.addEventListener('mouseleave', mouseLeaveHandler);
-            element.addEventListener('dblclick', doubleClickHandler);
-            element.addEventListener('mousedown', mouseDownHandler);
+            highlight.addEventListener('click', clickHandler);
+            highlight.addEventListener('dblclick', doubleClickHandler);
+            highlight.addEventListener('mousedown', mouseDownHandler);
             // Store event listeners for cleanup
             eventListeners.push({
-                element,
-                type: 'mouseenter',
-                handler: mouseEnterHandler
+                element: highlight,
+                type: 'click',
+                handler: clickHandler
             }, {
-                element,
-                type: 'mouseleave',
-                handler: mouseLeaveHandler
-            }, {
-                element,
+                element: highlight,
                 type: 'dblclick',
                 handler: doubleClickHandler
             }, {
-                element,
+                element: highlight,
                 type: 'mousedown',
                 handler: mouseDownHandler
             });
@@ -213,15 +277,21 @@
         const removeHighlightForElement = (element)=>{
             const highlight = elementsToHighlight.get(element);
             if (!highlight) return;
+            // Clear any pending click timeout for this element
+            const pendingTimeout = pendingClicks.get(element);
+            if (pendingTimeout) {
+                window.clearTimeout(pendingTimeout);
+                pendingClicks.delete(element);
+            }
             highlight.remove();
             elementsToHighlight.delete(element);
-            // Remove event listeners for this element
-            const listenersToRemove = eventListeners.filter((listener)=>listener.element === element);
+            // Remove event listeners for this highlight
+            const listenersToRemove = eventListeners.filter((listener)=>listener.element === highlight);
             listenersToRemove.forEach(({ element, type, handler })=>{
                 element.removeEventListener(type, handler);
             });
-            // Mutate eventListeners to remove listeners for this element
-            eventListeners.splice(0, eventListeners.length, ...eventListeners.filter((listener)=>listener.element !== element));
+            // Mutate eventListeners to remove listeners for this highlight
+            eventListeners.splice(0, eventListeners.length, ...eventListeners.filter((listener)=>listener.element !== highlight));
         };
         // Process all existing elements with source attributes
         const initialElements = window.document.querySelectorAll(`[${SOURCE_ATTRIBUTE}]`);
@@ -245,7 +315,11 @@
             setFocusedField: (field)=>{
                 focusedField = field;
             },
-            getFocusedField: ()=>focusedField
+            getFocusedField: ()=>focusedField,
+            clearAllPendingClicks: ()=>{
+                pendingClicks.forEach((timeout)=>clearTimeout(timeout));
+                pendingClicks.clear();
+            }
         };
     };
     /**
@@ -364,8 +438,7 @@
             if (event.data.type === INTERNAL_EVENTS.STRAPI_FIELD_CHANGE) {
                 const { field, value } = event.data.payload;
                 if (!field) return;
-                const matchingElements = document.querySelectorAll(`[${SOURCE_ATTRIBUTE}="${field}"]`);
-                matchingElements.forEach((element)=>{
+                getElementsByPath(field).forEach((element)=>{
                     if (element instanceof HTMLElement) {
                         element.textContent = value || '';
                     }
@@ -380,17 +453,21 @@
                 if (!field) return;
                 // Clear existing focused highlights
                 highlightManager.focusedHighlights.forEach((highlight)=>{
-                    highlight.style.outlineColor = 'transparent';
+                    highlight.classList.remove('strapi-highlight-focused');
                 });
                 highlightManager.focusedHighlights.length = 0;
                 // Set new focused field and highlight matching elements
                 highlightManager.setFocusedField(field);
-                const matchingElements = document.querySelectorAll(`[${SOURCE_ATTRIBUTE}="${field}"]`);
-                matchingElements.forEach((element)=>{
+                getElementsByPath(field).forEach((element, index)=>{
+                    if (index === 0) {
+                        element.scrollIntoView({
+                            behavior: 'smooth',
+                            block: 'center'
+                        });
+                    }
                     const highlight = highlightManager.highlights[Array.from(highlightManager.elements).indexOf(element)];
                     if (highlight) {
-                        highlight.style.outlineColor = HIGHLIGHT_ACTIVE_COLOR;
-                        highlight.style.outlineWidth = '3px';
+                        highlight.classList.add('strapi-highlight-focused');
                         highlightManager.focusedHighlights.push(highlight);
                     }
                 });
@@ -401,8 +478,7 @@
                 const { field } = event.data.payload;
                 if (field !== highlightManager.getFocusedField()) return;
                 highlightManager.focusedHighlights.forEach((highlight)=>{
-                    highlight.style.outlineColor = 'transparent';
-                    highlight.style.outlineWidth = '2px';
+                    highlight.classList.remove('strapi-highlight-focused');
                 });
                 highlightManager.focusedHighlights.length = 0;
                 highlightManager.setFocusedField(null);
@@ -420,29 +496,37 @@
             messageEventListener
         ];
     };
-    const createCleanupSystem = (overlay, observers, scrollManager, eventHandlers)=>{
+    const createCleanupSystem = (overlay, observers, scrollManager, eventHandlers, highlightManager)=>{
         window.__strapi_previewCleanup = ()=>{
             observers.resizeObserver.disconnect();
             observers.highlightObserver.disconnect();
             observers.stegaObserver?.disconnect();
             // Clean up scroll listeners
             scrollManager.cleanup();
+            // Clear all pending click timeouts
+            highlightManager.clearAllPendingClicks();
             // Remove highlight event listeners
             eventHandlers.forEach(({ element, type, handler })=>{
                 element.removeEventListener(type, handler);
             });
+            // Clean up CSS styles
+            const existingStyles = document.getElementById(HIGHLIGHT_STYLES_ID);
+            if (existingStyles) {
+                existingStyles.remove();
+            }
             overlay.remove();
         };
     };
     /* -----------------------------------------------------------------------------------------------
    * Orchestration
    * ---------------------------------------------------------------------------------------------*/ setupStegaDOMObserver().then((stegaObserver)=>{
+        createHighlightStyles();
         const overlay = createOverlaySystem();
         const highlightManager = createHighlightManager(overlay);
         const observers = setupObservers(highlightManager, stegaObserver);
         const scrollManager = setupScrollManagement(highlightManager);
         const eventHandlers = setupEventHandlers(highlightManager);
-        createCleanupSystem(overlay, observers, scrollManager, eventHandlers);
+        createCleanupSystem(overlay, observers, scrollManager, eventHandlers, highlightManager);
     });
 };