@tiptap/extensions 3.23.6 → 3.24.0

package/dist/placeholder/index.cjs

@@ -20,15 +20,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/placeholder/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_DATA_ATTRIBUTE: () => DEFAULT_DATA_ATTRIBUTE,
   PLUGIN_KEY: () => PLUGIN_KEY,
   Placeholder: () => Placeholder,
   preparePlaceholderAttribute: () => preparePlaceholderAttribute
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/placeholder/constants.ts
+var import_state = require("@tiptap/pm/state");
+var DEFAULT_DATA_ATTRIBUTE = "placeholder";
+var PLUGIN_KEY = new import_state.PluginKey("tiptap__placeholder");
+var VIEWPORT_OVERSCAN_PX = 200;
+
 // src/placeholder/placeholder.ts
+var import_core2 = require("@tiptap/core");
+
+// src/placeholder/plugins/PlaceholderPlugin.ts
+var import_state2 = require("@tiptap/pm/state");
+
+// src/placeholder/utils/buildPlaceholderDecorations.ts
 var import_core = require("@tiptap/core");
-var import_state = require("@tiptap/pm/state");
 var import_view2 = require("@tiptap/pm/view");
 
 // src/placeholder/utils/createPlaceholderDecoration.ts
@@ -59,6 +71,81 @@ function createPlaceholderDecoration(options) {
   });
 }
 
+// src/placeholder/utils/buildPlaceholderDecorations.ts
+function buildPlaceholderDecorations({
+  editor,
+  options,
+  dataAttribute,
+  doc,
+  selection
+}) {
+  var _a, _b;
+  const active = editor.isEditable || !options.showOnlyWhenEditable;
+  if (!active) {
+    return null;
+  }
+  const { anchor } = selection;
+  const decorations = [];
+  const isEmptyDoc = editor.isEmpty;
+  const classes = {
+    emptyEditor: options.emptyEditorClass,
+    emptyNode: options.emptyNodeClass
+  };
+  const useResolvedPath = options.showOnlyCurrent && !options.includeChildren;
+  if (useResolvedPath) {
+    const resolved = doc.resolve(anchor);
+    const node = resolved.depth > 0 ? resolved.node(1) : resolved.nodeAfter;
+    const nodeStart = resolved.depth > 0 ? resolved.before(1) : anchor;
+    if (node && node.type.isTextblock && (0, import_core.isNodeEmpty)(node)) {
+      const hasAnchor = anchor >= nodeStart && anchor <= nodeStart + node.nodeSize;
+      decorations.push(
+        createPlaceholderDecoration({
+          editor,
+          isEmptyDoc,
+          dataAttribute,
+          hasAnchor,
+          placeholder: options.placeholder,
+          classes,
+          node,
+          pos: nodeStart
+        })
+      );
+    }
+  } else {
+    const pluginState = PLUGIN_KEY.getState(editor.state);
+    const from = (_a = pluginState == null ? void 0 : pluginState.topPos) != null ? _a : 0;
+    const to = (_b = pluginState == null ? void 0 : pluginState.bottomPos) != null ? _b : doc.content.size;
+    doc.nodesBetween(from, to, (node, pos) => {
+      const hasAnchor = anchor >= pos && anchor <= pos + node.nodeSize;
+      const isEmpty = !node.isLeaf && (0, import_core.isNodeEmpty)(node);
+      if (!node.type.isTextblock) {
+        return options.includeChildren;
+      }
+      if ((hasAnchor || !options.showOnlyCurrent) && isEmpty) {
+        decorations.push(
+          createPlaceholderDecoration({
+            editor,
+            isEmptyDoc,
+            dataAttribute,
+            hasAnchor,
+            placeholder: options.placeholder,
+            classes,
+            node,
+            pos
+          })
+        );
+      }
+      return options.includeChildren;
+    });
+  }
+  return import_view2.DecorationSet.create(doc, decorations);
+}
+
+// src/placeholder/utils/preparePlaceholderAttribute.ts
+function preparePlaceholderAttribute(attr) {
+  return attr.replace(/\s+/g, "-").replace(/[^a-zA-Z0-9-]/g, "").replace(/^[0-9-]+/, "").replace(/^-+/, "").toLowerCase();
+}
+
 // src/placeholder/utils/findScrollParent.ts
 function isScrollable(el) {
   const style = getComputedStyle(el);
@@ -99,8 +186,8 @@ function getViewportBoundaryPositions({
 }) {
   const editorRect = view.dom.getBoundingClientRect();
   const containerRect = scrollContainer ? getContainerRect(scrollContainer) : { top: 0, bottom: window.innerHeight };
-  const visibleTop = Math.max(editorRect.top, containerRect.top);
-  const visibleBottom = Math.min(editorRect.bottom, containerRect.bottom);
+  const visibleTop = Math.max(editorRect.top, containerRect.top) - VIEWPORT_OVERSCAN_PX;
+  const visibleBottom = Math.min(editorRect.bottom, containerRect.bottom) + VIEWPORT_OVERSCAN_PX;
   if (visibleTop >= visibleBottom) {
     return { top: 0, bottom: doc.content.size };
   }
@@ -114,34 +201,98 @@ function getViewportBoundaryPositions({
   };
 }
 
-// src/placeholder/utils/throttle.ts
-function throttle(fn, delay) {
-  let timer = null;
-  const call = ((...args) => {
-    if (timer) {
+// src/placeholder/utils/viewportTracking.ts
+var viewportPluginState = {
+  /**
+   * Initialises the viewport state with no known positions.
+   * @returns The initial viewport state.
+   */
+  init() {
+    return { topPos: null, bottomPos: null };
+  },
+  /**
+   * Updates the viewport state from incoming transactions.
+   * @param tr - The transaction being applied.
+   * @param prev - The previous viewport state.
+   * @returns The next viewport state.
+   */
+  apply(tr, prev) {
+    const meta = tr.getMeta(PLUGIN_KEY);
+    if (meta == null ? void 0 : meta.positions) {
+      return { topPos: meta.positions.top, bottomPos: meta.positions.bottom };
+    }
+    if (!tr.docChanged) {
+      return prev;
+    }
+    return {
+      topPos: prev.topPos !== null ? tr.mapping.map(prev.topPos) : null,
+      bottomPos: prev.bottomPos !== null ? tr.mapping.map(prev.bottomPos) : null
+    };
+  }
+};
+function createViewportPluginView(view) {
+  const scrollContainer = findScrollParent(view.dom);
+  const computeAndDispatch = () => {
+    const positions = getViewportBoundaryPositions({
+      view,
+      doc: view.state.doc,
+      scrollContainer
+    });
+    const prev = PLUGIN_KEY.getState(view.state);
+    if ((prev == null ? void 0 : prev.topPos) === positions.top && (prev == null ? void 0 : prev.bottomPos) === positions.bottom) {
       return;
     }
-    fn(...args);
-    timer = setTimeout(() => {
-      timer = null;
-    }, delay);
-  });
-  const cancel = () => {
-    if (timer) {
-      clearTimeout(timer);
-      timer = null;
+    const tr = view.state.tr.setMeta(PLUGIN_KEY, { positions });
+    view.dispatch(tr);
+  };
+  let frame = null;
+  let lastCompute = 0;
+  const MIN_SCROLL_INTERVAL = 150;
+  const scheduleFrame = () => {
+    if (frame !== null) return;
+    frame = requestAnimationFrame(() => {
+      frame = null;
+      const now = performance.now();
+      if (now - lastCompute >= MIN_SCROLL_INTERVAL) {
+        lastCompute = now;
+        computeAndDispatch();
+      } else {
+        scheduleFrame();
+      }
+    });
+  };
+  scrollContainer.addEventListener("scroll", scheduleFrame, { passive: true });
+  computeAndDispatch();
+  return {
+    update(_view, prevState) {
+      if (view.state.doc.content.size !== prevState.doc.content.size) {
+        scheduleFrame();
+      }
+    },
+    destroy: () => {
+      if (frame !== null) {
+        cancelAnimationFrame(frame);
+      }
+      scrollContainer.removeEventListener("scroll", scheduleFrame);
     }
   };
-  return { call, cancel };
 }
 
-// src/placeholder/placeholder.ts
-var DEFAULT_DATA_ATTRIBUTE = "placeholder";
-function preparePlaceholderAttribute(attr) {
-  return attr.replace(/\s+/g, "-").replace(/[^a-zA-Z0-9-]/g, "").replace(/^[0-9-]+/, "").replace(/^-+/, "").toLowerCase();
+// src/placeholder/plugins/PlaceholderPlugin.ts
+function createPlaceholderPlugin({ editor, options }) {
+  const dataAttribute = options.dataAttribute ? `data-${preparePlaceholderAttribute(options.dataAttribute)}` : `data-${DEFAULT_DATA_ATTRIBUTE}`;
+  return new import_state2.Plugin({
+    key: PLUGIN_KEY,
+    state: viewportPluginState,
+    view: createViewportPluginView,
+    props: {
+      decorations: ({ doc, selection }) => buildPlaceholderDecorations({ editor, options, dataAttribute, doc, selection })
+    }
+  });
 }
-var PLUGIN_KEY = new import_state.PluginKey("tiptap__placeholder");
-var Placeholder = import_core.Extension.create({
+
+// src/placeholder/placeholder.ts
+var Placeholder = import_core2.Extension.create({
   name: "placeholder",
   addOptions() {
     return {
@@ -155,136 +306,12 @@ var Placeholder = import_core.Extension.create({
     };
   },
   addProseMirrorPlugins() {
-    const dataAttribute = this.options.dataAttribute ? `data-${preparePlaceholderAttribute(this.options.dataAttribute)}` : `data-${DEFAULT_DATA_ATTRIBUTE}`;
-    return [
-      new import_state.Plugin({
-        state: {
-          init() {
-            return {
-              // null means "no viewport info yet" — decoration callback falls
-              // back to full document scan until the scroll handler fires.
-              topPos: null,
-              bottomPos: null
-            };
-          },
-          apply(tr, prev) {
-            const meta = tr.getMeta(PLUGIN_KEY);
-            if (meta == null ? void 0 : meta.positions) {
-              return {
-                topPos: meta.positions.top,
-                bottomPos: meta.positions.bottom
-              };
-            }
-            if (!tr.docChanged) {
-              return prev;
-            }
-            return {
-              topPos: prev.topPos !== null ? tr.mapping.map(prev.topPos) : null,
-              bottomPos: prev.bottomPos !== null ? tr.mapping.map(prev.bottomPos) : null
-            };
-          }
-        },
-        key: PLUGIN_KEY,
-        view(view) {
-          const scrollContainer = findScrollParent(view.dom);
-          const computeAndDispatch = () => {
-            const positions = getViewportBoundaryPositions({
-              view,
-              doc: view.state.doc,
-              scrollContainer
-            });
-            const prev = PLUGIN_KEY.getState(view.state);
-            if (prev.topPos === positions.top && prev.bottomPos === positions.bottom) {
-              return;
-            }
-            const tr = view.state.tr.setMeta(PLUGIN_KEY, { positions }).setMeta("tiptap__viewportUpdate", true);
-            view.dispatch(tr);
-          };
-          const { call: throttledUpdate, cancel: cancelThrottle } = throttle(computeAndDispatch, 250);
-          const scrollParent = scrollContainer;
-          scrollParent.addEventListener("scroll", throttledUpdate, { passive: true });
-          computeAndDispatch();
-          return {
-            update(_, prevState) {
-              if (view.state.doc.content.size !== prevState.doc.content.size) {
-                computeAndDispatch();
-              }
-            },
-            destroy: () => {
-              cancelThrottle();
-              scrollParent.removeEventListener("scroll", throttledUpdate);
-            }
-          };
-        },
-        props: {
-          decorations: ({ doc, selection }) => {
-            var _a, _b;
-            const active = this.editor.isEditable || !this.options.showOnlyWhenEditable;
-            if (!active) {
-              return null;
-            }
-            const { anchor } = selection;
-            const decorations = [];
-            const isEmptyDoc = this.editor.isEmpty;
-            const useResolvedPath = this.options.showOnlyCurrent && !this.options.includeChildren;
-            if (useResolvedPath) {
-              const resolved = doc.resolve(anchor);
-              if (resolved.depth > 0) {
-                const node = resolved.node(1);
-                const nodeStart = resolved.before(1);
-                if (node.type.isTextblock && (0, import_core.isNodeEmpty)(node)) {
-                  const hasAnchor = anchor >= nodeStart && anchor <= nodeStart + node.nodeSize;
-                  const decoration = createPlaceholderDecoration({
-                    node,
-                    dataAttribute,
-                    hasAnchor,
-                    placeholder: this.options.placeholder,
-                    classes: {
-                      emptyEditor: this.options.emptyEditorClass,
-                      emptyNode: this.options.emptyNodeClass
-                    },
-                    editor: this.editor,
-                    isEmptyDoc,
-                    pos: resolved.before(1)
-                  });
-                  decorations.push(decoration);
-                }
-              }
-            } else {
-              const pluginState = PLUGIN_KEY.getState(this.editor.state);
-              const from = (_a = pluginState.topPos) != null ? _a : 0;
-              const to = (_b = pluginState.bottomPos) != null ? _b : doc.content.size;
-              doc.nodesBetween(from, to, (node, pos) => {
-                const hasAnchor = anchor >= pos && anchor <= pos + node.nodeSize;
-                const isEmpty = !node.isLeaf && (0, import_core.isNodeEmpty)(node);
-                if (!node.type.isTextblock) {
-                  return this.options.includeChildren;
-                }
-                if ((hasAnchor || !this.options.showOnlyCurrent) && isEmpty) {
-                  const decoration = createPlaceholderDecoration({
-                    classes: { emptyEditor: this.options.emptyEditorClass, emptyNode: this.options.emptyNodeClass },
-                    editor: this.editor,
-                    isEmptyDoc,
-                    dataAttribute,
-                    hasAnchor,
-                    placeholder: this.options.placeholder,
-                    node,
-                    pos
-                  });
-                  decorations.push(decoration);
-                }
-                return this.options.includeChildren;
-              });
-            }
-            return import_view2.DecorationSet.create(doc, decorations);
-          }
-        }
-      })
-    ];
+    return [createPlaceholderPlugin({ editor: this.editor, options: this.options })];
   }
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_DATA_ATTRIBUTE,
   PLUGIN_KEY,
   Placeholder,
   preparePlaceholderAttribute

package/dist/placeholder/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/placeholder/index.ts","../../src/placeholder/placeholder.ts","../../src/placeholder/utils/createPlaceholderDecoration.ts","../../src/placeholder/utils/findScrollParent.ts","../../src/placeholder/utils/getViewportBoundaryPositions.ts","../../src/placeholder/utils/throttle.ts"],"sourcesContent":["export * from './placeholder.js'\nexport * from './types.js'\n","import { Extension, isNodeEmpty } from '@tiptap/core'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport type { Decoration } from '@tiptap/pm/view'\nimport { DecorationSet } from '@tiptap/pm/view'\n\nimport type { PlaceholderOptions } from './types.js'\nimport { createPlaceholderDecoration } from './utils/createPlaceholderDecoration.js'\nimport { findScrollParent } from './utils/findScrollParent.js'\nimport { getViewportBoundaryPositions } from './utils/getViewportBoundaryPositions.js'\nimport { throttle } from './utils/throttle.js'\n\n/**\n * The default data attribute label\n */\nconst DEFAULT_DATA_ATTRIBUTE = 'placeholder'\n\n/**\n * Prepares the placeholder attribute by ensuring it is properly formatted.\n * @param attr - The placeholder attribute string.\n * @returns The prepared placeholder attribute string.\n */\nexport function preparePlaceholderAttribute(attr: string): string {\n  return (\n    attr\n      // replace whitespace with dashes\n      .replace(/\\s+/g, '-')\n      // replace non-alphanumeric  characters\n      // or special chars like $, %, &, etc.\n      // but not dashes\n      .replace(/[^a-zA-Z0-9-]/g, '')\n      // and replace any numeric character at the start\n      .replace(/^[0-9-]+/, '')\n      // and finally replace any stray, leading dashes\n      .replace(/^-+/, '')\n      .toLowerCase()\n  )\n}\n\nexport const PLUGIN_KEY = new PluginKey('tiptap__placeholder')\n\n/**\n * This extension allows you to add a placeholder to your editor.\n * A placeholder is a text that appears when the editor or a node is empty.\n * @see https://www.tiptap.dev/api/extensions/placeholder\n */\nexport const Placeholder = Extension.create<PlaceholderOptions>({\n  name: 'placeholder',\n\n  addOptions() {\n    return {\n      emptyEditorClass: 'is-editor-empty',\n      emptyNodeClass: 'is-empty',\n      dataAttribute: DEFAULT_DATA_ATTRIBUTE,\n      placeholder: 'Write something …',\n      showOnlyWhenEditable: true,\n      showOnlyCurrent: true,\n      includeChildren: false,\n    }\n  },\n\n  addProseMirrorPlugins() {\n    const dataAttribute = this.options.dataAttribute\n      ? `data-${preparePlaceholderAttribute(this.options.dataAttribute)}`\n      : `data-${DEFAULT_DATA_ATTRIBUTE}`\n\n    return [\n      new Plugin({\n        state: {\n          init() {\n            return {\n              // null means \"no viewport info yet\" — decoration callback falls\n              // back to full document scan until the scroll handler fires.\n              topPos: null as number | null,\n              bottomPos: null as number | null,\n            }\n          },\n          apply(tr, prev) {\n            const meta = tr.getMeta(PLUGIN_KEY) as { positions?: { top: number; bottom: number } } | undefined\n\n            if (meta?.positions) {\n              return {\n                topPos: meta.positions.top,\n                bottomPos: meta.positions.bottom,\n              }\n            }\n\n            if (!tr.docChanged) {\n              return prev\n            }\n\n            // Preserve last known viewport positions across transactions.\n            // Without this, every keystroke resets back to a full document\n            // scan, defeating the viewport optimisation.\n            // Only map when we have actual positions — null means \"no viewport\n            // info yet\" and should stay null to fall back to full doc scan.\n            return {\n              topPos: prev.topPos !== null ? tr.mapping.map(prev.topPos) : null,\n              bottomPos: prev.bottomPos !== null ? tr.mapping.map(prev.bottomPos) : null,\n            }\n          },\n        },\n        key: PLUGIN_KEY,\n        view(view) {\n          const scrollContainer = findScrollParent(view.dom)\n\n          const computeAndDispatch = () => {\n            const positions = getViewportBoundaryPositions({\n              view,\n              doc: view.state.doc,\n              scrollContainer,\n            })\n\n            const prev = PLUGIN_KEY.getState(view.state)\n            if (prev.topPos === positions.top && prev.bottomPos === positions.bottom) {\n              return\n            }\n\n            const tr = view.state.tr\n              .setMeta(PLUGIN_KEY, { positions })\n              // Flag this transaction so the update() method can detect\n              // it and avoid re-entrant computation.\n              .setMeta('tiptap__viewportUpdate', true)\n            view.dispatch(tr)\n          }\n\n          const { call: throttledUpdate, cancel: cancelThrottle } = throttle(computeAndDispatch, 250)\n          const scrollParent = scrollContainer\n\n          scrollParent.addEventListener('scroll', throttledUpdate, { passive: true })\n\n          // Fire once to populate initial viewport (bypass throttle)\n          computeAndDispatch()\n\n          return {\n            update(_, prevState) {\n              // Skip re-entry: the dispatch inside computeAndDispatch would\n              // trigger this update again, but the doc didn't change so the\n              // size guard catches that. The meta flag is an extra safeguard.\n              if (view.state.doc.content.size !== prevState.doc.content.size) {\n                computeAndDispatch()\n              }\n            },\n            destroy: () => {\n              cancelThrottle()\n              scrollParent.removeEventListener('scroll', throttledUpdate)\n            },\n          }\n        },\n        props: {\n          decorations: ({ doc, selection }) => {\n            const active = this.editor.isEditable || !this.options.showOnlyWhenEditable\n\n            if (!active) {\n              return null\n            }\n\n            const { anchor } = selection\n            const decorations: Decoration[] = []\n            const isEmptyDoc = this.editor.isEmpty\n\n            const useResolvedPath = this.options.showOnlyCurrent && !this.options.includeChildren\n\n            if (useResolvedPath) {\n              const resolved = doc.resolve(anchor)\n\n              if (resolved.depth > 0) {\n                const node = resolved.node(1)\n                const nodeStart = resolved.before(1)\n\n                if (node.type.isTextblock && isNodeEmpty(node)) {\n                  const hasAnchor = anchor >= nodeStart && anchor <= nodeStart + node.nodeSize\n                  const decoration = createPlaceholderDecoration({\n                    node,\n                    dataAttribute,\n                    hasAnchor,\n                    placeholder: this.options.placeholder,\n                    classes: {\n                      emptyEditor: this.options.emptyEditorClass,\n                      emptyNode: this.options.emptyNodeClass,\n                    },\n                    editor: this.editor,\n                    isEmptyDoc,\n                    pos: resolved.before(1),\n                  })\n\n                  decorations.push(decoration)\n                }\n              }\n            } else {\n              const pluginState = PLUGIN_KEY.getState(this.editor.state)\n              const from = pluginState.topPos ?? 0\n              const to = pluginState.bottomPos ?? doc.content.size\n\n              doc.nodesBetween(from, to, (node, pos) => {\n                const hasAnchor = anchor >= pos && anchor <= pos + node.nodeSize\n                const isEmpty = !node.isLeaf && isNodeEmpty(node)\n\n                if (!node.type.isTextblock) {\n                  return this.options.includeChildren\n                }\n\n                if ((hasAnchor || !this.options.showOnlyCurrent) && isEmpty) {\n                  const decoration = createPlaceholderDecoration({\n                    classes: { emptyEditor: this.options.emptyEditorClass, emptyNode: this.options.emptyNodeClass },\n                    editor: this.editor,\n                    isEmptyDoc,\n                    dataAttribute,\n                    hasAnchor,\n                    placeholder: this.options.placeholder,\n                    node,\n                    pos,\n                  })\n                  decorations.push(decoration)\n                }\n\n                return this.options.includeChildren\n              })\n            }\n\n            return DecorationSet.create(doc, decorations)\n          },\n        },\n      }),\n    ]\n  },\n})\n","import type { Editor } from '@tiptap/core'\nimport type { Node } from '@tiptap/pm/model'\nimport { Decoration } from '@tiptap/pm/view'\n\nimport type { PlaceholderOptions } from '../types.js'\n\n/**\n * Creates a ProseMirror node decoration that applies a placeholder\n * CSS class and data attribute to an empty node.\n * @param options.editor - The editor instance\n * @param options.pos - The position of the node in the document\n * @param options.node - The ProseMirror node\n * @param options.isEmptyDoc - Whether the entire document is empty\n * @param options.hasAnchor - Whether the selection anchor is within the node\n * @param options.dataAttribute - The data attribute name (e.g. `data-placeholder`)\n * @param options.classes - CSS classes for empty nodes and the empty editor\n * @param options.placeholder - The placeholder text or a function that returns it\n * @returns A ProseMirror node decoration with placeholder classes and data attribute\n */\nexport function createPlaceholderDecoration(options: {\n  editor: Editor\n  pos: number\n  node: Node\n  isEmptyDoc: boolean\n  hasAnchor: boolean\n  dataAttribute: string\n  classes: {\n    emptyEditor: PlaceholderOptions['emptyEditorClass']\n    emptyNode: PlaceholderOptions['emptyNodeClass']\n  }\n  placeholder: PlaceholderOptions['placeholder']\n}) {\n  const {\n    editor,\n    placeholder,\n    dataAttribute,\n    pos,\n    node,\n    isEmptyDoc,\n    hasAnchor,\n    classes: { emptyNode, emptyEditor },\n  } = options\n  const classes = [emptyNode]\n\n  if (isEmptyDoc) {\n    classes.push(emptyEditor)\n  }\n\n  return Decoration.node(pos, pos + node.nodeSize, {\n    class: classes.join(' '),\n    [dataAttribute]:\n      typeof placeholder === 'function'\n        ? placeholder({\n            editor,\n            node,\n            pos,\n            hasAnchor,\n          })\n        : placeholder,\n  })\n}\n","/**\n * Checks if an element is scrollable by testing its overflow properties.\n * Elements with `overflow: hidden` or `overflow: clip` are intentionally\n * excluded — they clip content but don't emit scroll events.\n */\nfunction isScrollable(el: HTMLElement): boolean {\n  const style = getComputedStyle(el)\n  const overflow = `${style.overflow} ${style.overflowY} ${style.overflowX}`\n\n  return /auto|scroll|overlay/.test(overflow)\n}\n\nexport function findScrollParent(element: HTMLElement): HTMLElement | Window {\n  let el: HTMLElement | null = element\n\n  while (el) {\n    if (isScrollable(el)) {\n      return el\n    }\n\n    // Check if we hit a Shadow DOM boundary. If so, jump to the shadow host\n    // and continue traversing the light DOM.\n    const parent = el.parentElement\n    if (!parent) {\n      const root = el.getRootNode()\n      if (root instanceof ShadowRoot) {\n        el = root.host as HTMLElement\n        continue\n      }\n\n      return window\n    }\n\n    el = parent\n  }\n\n  return window\n}\n","import type { Node } from '@tiptap/pm/model'\nimport type { EditorView } from '@tiptap/pm/view'\n\nfunction getContainerRect(container: HTMLElement | Window): { top: number; bottom: number } {\n  if (container === window) {\n    return { top: 0, bottom: window.innerHeight }\n  }\n\n  return (container as HTMLElement).getBoundingClientRect()\n}\n\nexport function getViewportBoundaryPositions({\n  doc,\n  view,\n  scrollContainer,\n}: {\n  doc: Node\n  view: EditorView\n  scrollContainer?: HTMLElement | Window\n}) {\n  const editorRect = view.dom.getBoundingClientRect()\n  const containerRect = scrollContainer ? getContainerRect(scrollContainer) : { top: 0, bottom: window.innerHeight }\n\n  const visibleTop = Math.max(editorRect.top, containerRect.top)\n  const visibleBottom = Math.min(editorRect.bottom, containerRect.bottom)\n\n  if (visibleTop >= visibleBottom) {\n    // Editor is not visible — fall back to full document range\n    return { top: 0, bottom: doc.content.size }\n  }\n\n  // Pick the x-coordinate based on text direction. In LTR the content\n  // starts at the left edge; in RTL it starts at the right edge.\n  // Clamp to ensure the coordinate stays inside the editor bounds.\n  const isRTL = getComputedStyle(view.dom).direction === 'rtl'\n  const x = isRTL ? Math.max(editorRect.right - 2, editorRect.left + 2) : editorRect.left + 2\n\n  const topPos = view.posAtCoords({ left: x, top: visibleTop + 2 })\n  const bottomPos = view.posAtCoords({ left: x, top: visibleBottom - 2 })\n\n  return {\n    top: topPos ? topPos.pos : 0,\n    bottom: bottomPos ? bottomPos.pos : doc.content.size,\n  }\n}\n","export function throttle<T extends (...args: any[]) => void>(fn: T, delay: number): { call: T; cancel: () => void } {\n  let timer: ReturnType<typeof setTimeout> | null = null\n\n  const call = ((...args: any[]) => {\n    if (timer) {\n      return\n    }\n\n    // Leading-edge: fire immediately, then prevent subsequent calls\n    // until the timer fires and resets.\n    fn(...args)\n    timer = setTimeout(() => {\n      timer = null\n    }, delay)\n  }) as T\n\n  const cancel = () => {\n    if (timer) {\n      clearTimeout(timer)\n      timer = null\n    }\n  }\n\n  return { call, cancel }\n}\n"],"mappings":"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","names":["import_view"]}
+{"version":3,"sources":["../../src/placeholder/index.ts","../../src/placeholder/constants.ts","../../src/placeholder/placeholder.ts","../../src/placeholder/plugins/PlaceholderPlugin.ts","../../src/placeholder/utils/buildPlaceholderDecorations.ts","../../src/placeholder/utils/createPlaceholderDecoration.ts","../../src/placeholder/utils/preparePlaceholderAttribute.ts","../../src/placeholder/utils/findScrollParent.ts","../../src/placeholder/utils/getViewportBoundaryPositions.ts","../../src/placeholder/utils/viewportTracking.ts"],"sourcesContent":["export { DEFAULT_DATA_ATTRIBUTE, PLUGIN_KEY } from './constants.js'\nexport * from './placeholder.js'\nexport * from './types.js'\nexport { preparePlaceholderAttribute } from './utils/preparePlaceholderAttribute.js'\n","import { PluginKey } from '@tiptap/pm/state'\n\nimport type { ViewportState } from './types.js'\n\n/** The default data attribute label */\nexport const DEFAULT_DATA_ATTRIBUTE = 'placeholder'\n\n/** The plugin key used to store and read the placeholder viewport state */\nexport const PLUGIN_KEY = new PluginKey<ViewportState>('tiptap__placeholder')\n\n/**\n * Extra pixels added above and below the visible viewport when computing the\n * range of nodes to decorate. Decorating slightly beyond the fold means a\n * node already has its placeholder before it scrolls into view, which hides\n * the latency introduced by the throttled viewport recompute.\n */\nexport const VIEWPORT_OVERSCAN_PX = 200\n","import { Extension } from '@tiptap/core'\n\nimport { DEFAULT_DATA_ATTRIBUTE } from './constants.js'\nimport { createPlaceholderPlugin } from './plugins/PlaceholderPlugin.js'\nimport type { PlaceholderOptions } from './types.js'\n\n/**\n * This extension allows you to add a placeholder to your editor.\n * A placeholder is a text that appears when the editor or a node is empty.\n * @see https://www.tiptap.dev/api/extensions/placeholder\n */\nexport const Placeholder = Extension.create<PlaceholderOptions>({\n  name: 'placeholder',\n\n  addOptions() {\n    return {\n      emptyEditorClass: 'is-editor-empty',\n      emptyNodeClass: 'is-empty',\n      dataAttribute: DEFAULT_DATA_ATTRIBUTE,\n      placeholder: 'Write something …',\n      showOnlyWhenEditable: true,\n      showOnlyCurrent: true,\n      includeChildren: false,\n    }\n  },\n\n  addProseMirrorPlugins() {\n    return [createPlaceholderPlugin({ editor: this.editor, options: this.options })]\n  },\n})\n","import type { Editor } from '@tiptap/core'\nimport { Plugin } from '@tiptap/pm/state'\n\nimport { DEFAULT_DATA_ATTRIBUTE, PLUGIN_KEY } from '../constants.js'\nimport type { PlaceholderOptions } from '../types.js'\nimport { buildPlaceholderDecorations } from '../utils/buildPlaceholderDecorations.js'\nimport { preparePlaceholderAttribute } from '../utils/preparePlaceholderAttribute.js'\nimport { createViewportPluginView, viewportPluginState } from '../utils/viewportTracking.js'\n\nexport type CreatePluginOptions = {\n  editor: Editor\n  options: PlaceholderOptions\n}\n\n/**\n * Creates the ProseMirror plugin that renders placeholder decorations.\n * @param options.editor - The editor instance.\n * @param options.options - The resolved placeholder options.\n * @returns The configured placeholder plugin.\n */\nexport function createPlaceholderPlugin({ editor, options }: CreatePluginOptions) {\n  const dataAttribute = options.dataAttribute\n    ? `data-${preparePlaceholderAttribute(options.dataAttribute)}`\n    : `data-${DEFAULT_DATA_ATTRIBUTE}`\n\n  return new Plugin({\n    key: PLUGIN_KEY,\n    state: viewportPluginState,\n    view: createViewportPluginView,\n    props: {\n      decorations: ({ doc, selection }) =>\n        buildPlaceholderDecorations({ editor, options, dataAttribute, doc, selection }),\n    },\n  })\n}\n","import type { Editor } from '@tiptap/core'\nimport { isNodeEmpty } from '@tiptap/core'\nimport type { Node } from '@tiptap/pm/model'\nimport type { Selection } from '@tiptap/pm/state'\nimport type { Decoration } from '@tiptap/pm/view'\nimport { DecorationSet } from '@tiptap/pm/view'\n\nimport { PLUGIN_KEY } from '../constants.js'\nimport type { PlaceholderOptions } from '../types.js'\nimport { createPlaceholderDecoration } from './createPlaceholderDecoration.js'\n\n/**\n * Builds the placeholder decorations for the current document state.\n * @param options.editor - The editor instance.\n * @param options.options - The resolved placeholder options.\n * @param options.dataAttribute - The prepared `data-*` attribute name.\n * @param options.doc - The current document node.\n * @param options.selection - The current selection.\n * @returns A decoration set, or `null` when no placeholders should be shown.\n */\nexport function buildPlaceholderDecorations({\n  editor,\n  options,\n  dataAttribute,\n  doc,\n  selection,\n}: {\n  editor: Editor\n  options: PlaceholderOptions\n  dataAttribute: string\n  doc: Node\n  selection: Selection\n}): DecorationSet | null {\n  const active = editor.isEditable || !options.showOnlyWhenEditable\n\n  if (!active) {\n    return null\n  }\n\n  const { anchor } = selection\n  const decorations: Decoration[] = []\n  const isEmptyDoc = editor.isEmpty\n\n  const classes = {\n    emptyEditor: options.emptyEditorClass,\n    emptyNode: options.emptyNodeClass,\n  }\n\n  const useResolvedPath = options.showOnlyCurrent && !options.includeChildren\n\n  if (useResolvedPath) {\n    const resolved = doc.resolve(anchor)\n\n    // When the selection spans the whole document (e.g. an `AllSelection`\n    // after Cmd+A), the anchor resolves to the document level (depth 0). In\n    // that case the relevant textblock is the node directly after the\n    // position rather than an ancestor. otherwise the placeholder would\n    // disappear after selecting all and deleting.\n    const node = resolved.depth > 0 ? resolved.node(1) : resolved.nodeAfter\n    const nodeStart = resolved.depth > 0 ? resolved.before(1) : anchor\n\n    if (node && node.type.isTextblock && isNodeEmpty(node)) {\n      const hasAnchor = anchor >= nodeStart && anchor <= nodeStart + node.nodeSize\n\n      decorations.push(\n        createPlaceholderDecoration({\n          editor,\n          isEmptyDoc,\n          dataAttribute,\n          hasAnchor,\n          placeholder: options.placeholder,\n          classes,\n          node,\n          pos: nodeStart,\n        }),\n      )\n    }\n  } else {\n    const pluginState = PLUGIN_KEY.getState(editor.state)\n    const from = pluginState?.topPos ?? 0\n    const to = pluginState?.bottomPos ?? doc.content.size\n\n    doc.nodesBetween(from, to, (node, pos) => {\n      const hasAnchor = anchor >= pos && anchor <= pos + node.nodeSize\n      const isEmpty = !node.isLeaf && isNodeEmpty(node)\n\n      if (!node.type.isTextblock) {\n        return options.includeChildren\n      }\n\n      if ((hasAnchor || !options.showOnlyCurrent) && isEmpty) {\n        decorations.push(\n          createPlaceholderDecoration({\n            editor,\n            isEmptyDoc,\n            dataAttribute,\n            hasAnchor,\n            placeholder: options.placeholder,\n            classes,\n            node,\n            pos,\n          }),\n        )\n      }\n\n      return options.includeChildren\n    })\n  }\n\n  return DecorationSet.create(doc, decorations)\n}\n","import type { Editor } from '@tiptap/core'\nimport type { Node } from '@tiptap/pm/model'\nimport { Decoration } from '@tiptap/pm/view'\n\nimport type { PlaceholderOptions } from '../types.js'\n\n/**\n * Creates a ProseMirror node decoration that applies a placeholder\n * CSS class and data attribute to an empty node.\n * @param options.editor - The editor instance\n * @param options.pos - The position of the node in the document\n * @param options.node - The ProseMirror node\n * @param options.isEmptyDoc - Whether the entire document is empty\n * @param options.hasAnchor - Whether the selection anchor is within the node\n * @param options.dataAttribute - The data attribute name (e.g. `data-placeholder`)\n * @param options.classes - CSS classes for empty nodes and the empty editor\n * @param options.placeholder - The placeholder text or a function that returns it\n * @returns A ProseMirror node decoration with placeholder classes and data attribute\n */\nexport function createPlaceholderDecoration(options: {\n  editor: Editor\n  pos: number\n  node: Node\n  isEmptyDoc: boolean\n  hasAnchor: boolean\n  dataAttribute: string\n  classes: {\n    emptyEditor: PlaceholderOptions['emptyEditorClass']\n    emptyNode: PlaceholderOptions['emptyNodeClass']\n  }\n  placeholder: PlaceholderOptions['placeholder']\n}) {\n  const {\n    editor,\n    placeholder,\n    dataAttribute,\n    pos,\n    node,\n    isEmptyDoc,\n    hasAnchor,\n    classes: { emptyNode, emptyEditor },\n  } = options\n  const classes = [emptyNode]\n\n  if (isEmptyDoc) {\n    classes.push(emptyEditor)\n  }\n\n  return Decoration.node(pos, pos + node.nodeSize, {\n    class: classes.join(' '),\n    [dataAttribute]:\n      typeof placeholder === 'function'\n        ? placeholder({\n            editor,\n            node,\n            pos,\n            hasAnchor,\n          })\n        : placeholder,\n  })\n}\n","/**\n * Prepares the placeholder attribute by ensuring it is properly formatted.\n * @param attr - The placeholder attribute string.\n * @returns The prepared placeholder attribute string.\n */\nexport function preparePlaceholderAttribute(attr: string): string {\n  return (\n    attr\n      // replace whitespace with dashes\n      .replace(/\\s+/g, '-')\n      // replace non-alphanumeric  characters\n      // or special chars like $, %, &, etc.\n      // but not dashes\n      .replace(/[^a-zA-Z0-9-]/g, '')\n      // and replace any numeric character at the start\n      .replace(/^[0-9-]+/, '')\n      // and finally replace any stray, leading dashes\n      .replace(/^-+/, '')\n      .toLowerCase()\n  )\n}\n","/**\n * Checks if an element is scrollable by testing its overflow properties.\n * Elements with `overflow: hidden` or `overflow: clip` are intentionally\n * excluded — they clip content but don't emit scroll events.\n */\nfunction isScrollable(el: HTMLElement): boolean {\n  const style = getComputedStyle(el)\n  const overflow = `${style.overflow} ${style.overflowY} ${style.overflowX}`\n\n  return /auto|scroll|overlay/.test(overflow)\n}\n\nexport function findScrollParent(element: HTMLElement): HTMLElement | Window {\n  let el: HTMLElement | null = element\n\n  while (el) {\n    if (isScrollable(el)) {\n      return el\n    }\n\n    // Check if we hit a Shadow DOM boundary. If so, jump to the shadow host\n    // and continue traversing the light DOM.\n    const parent = el.parentElement\n    if (!parent) {\n      const root = el.getRootNode()\n      if (root instanceof ShadowRoot) {\n        el = root.host as HTMLElement\n        continue\n      }\n\n      return window\n    }\n\n    el = parent\n  }\n\n  return window\n}\n","import type { Node } from '@tiptap/pm/model'\nimport type { EditorView } from '@tiptap/pm/view'\n\nimport { VIEWPORT_OVERSCAN_PX } from '../constants.js'\n\nfunction getContainerRect(container: HTMLElement | Window): { top: number; bottom: number } {\n  if (container === window) {\n    return { top: 0, bottom: window.innerHeight }\n  }\n\n  return (container as HTMLElement).getBoundingClientRect()\n}\n\nexport function getViewportBoundaryPositions({\n  doc,\n  view,\n  scrollContainer,\n}: {\n  doc: Node\n  view: EditorView\n  scrollContainer?: HTMLElement | Window\n}) {\n  const editorRect = view.dom.getBoundingClientRect()\n  const containerRect = scrollContainer\n    ? getContainerRect(scrollContainer)\n    : { top: 0, bottom: window.innerHeight }\n\n  const visibleTop = Math.max(editorRect.top, containerRect.top) - VIEWPORT_OVERSCAN_PX\n  const visibleBottom = Math.min(editorRect.bottom, containerRect.bottom) + VIEWPORT_OVERSCAN_PX\n\n  if (visibleTop >= visibleBottom) {\n    // Editor is not visible — fall back to full document range\n    return { top: 0, bottom: doc.content.size }\n  }\n\n  // Pick the x-coordinate based on text direction. In LTR the content\n  // starts at the left edge; in RTL it starts at the right edge.\n  // Clamp to ensure the coordinate stays inside the editor bounds.\n  const isRTL = getComputedStyle(view.dom).direction === 'rtl'\n  const x = isRTL ? Math.max(editorRect.right - 2, editorRect.left + 2) : editorRect.left + 2\n\n  const topPos = view.posAtCoords({ left: x, top: visibleTop + 2 })\n  const bottomPos = view.posAtCoords({ left: x, top: visibleBottom - 2 })\n\n  return {\n    top: topPos ? topPos.pos : 0,\n    bottom: bottomPos ? bottomPos.pos : doc.content.size,\n  }\n}\n","import type { EditorState, PluginView, StateField, Transaction } from '@tiptap/pm/state'\nimport type { EditorView } from '@tiptap/pm/view'\n\nimport { PLUGIN_KEY } from '../constants.js'\nimport type { ViewportState } from '../types.js'\nimport { findScrollParent } from './findScrollParent.js'\nimport { getViewportBoundaryPositions } from './getViewportBoundaryPositions.js'\n\n/**\n * The plugin `state` config that tracks the visible viewport boundaries so the\n * decoration callback only scans the nodes currently on screen.\n */\nexport const viewportPluginState: StateField<ViewportState> = {\n  /**\n   * Initialises the viewport state with no known positions.\n   * @returns The initial viewport state.\n   */\n  init(): ViewportState {\n    return { topPos: null, bottomPos: null }\n  },\n\n  /**\n   * Updates the viewport state from incoming transactions.\n   * @param tr - The transaction being applied.\n   * @param prev - The previous viewport state.\n   * @returns The next viewport state.\n   */\n  apply(tr: Transaction, prev: ViewportState): ViewportState {\n    const meta = tr.getMeta(PLUGIN_KEY) as\n      | { positions?: { top: number; bottom: number } }\n      | undefined\n\n    if (meta?.positions) {\n      return { topPos: meta.positions.top, bottomPos: meta.positions.bottom }\n    }\n\n    if (!tr.docChanged) {\n      return prev\n    }\n\n    // Preserve last known viewport positions across transactions.\n    // Without this, every keystroke resets back to a full document\n    // scan, defeating the viewport optimisation.\n    // Only map when we have actual positions — null means \"no viewport\n    // info yet\" and should stay null to fall back to full doc scan.\n    return {\n      topPos: prev.topPos !== null ? tr.mapping.map(prev.topPos) : null,\n      bottomPos: prev.bottomPos !== null ? tr.mapping.map(prev.bottomPos) : null,\n    }\n  },\n}\n\n/**\n * Creates the plugin `view` that recomputes the visible viewport on scroll and\n * document size changes, dispatching the result into the plugin state.\n * @param view - The editor view the plugin is attached to.\n * @returns A plugin view with `update` and `destroy` handlers.\n */\nexport function createViewportPluginView(view: EditorView): PluginView {\n  const scrollContainer = findScrollParent(view.dom)\n\n  const computeAndDispatch = () => {\n    const positions = getViewportBoundaryPositions({\n      view,\n      doc: view.state.doc,\n      scrollContainer,\n    })\n\n    const prev = PLUGIN_KEY.getState(view.state)\n    if (prev?.topPos === positions.top && prev?.bottomPos === positions.bottom) {\n      return\n    }\n\n    const tr = view.state.tr.setMeta(PLUGIN_KEY, { positions })\n    view.dispatch(tr)\n  }\n\n  // rAF-based scheduler with interval guard (150ms → ~6–7 Hz) used by\n  // scroll events and update(). The overscan margin hides the extra\n  // latency. When the guard blocks, the callback reschedules itself so\n  // the trailing position is always captured.\n  let frame: number | null = null\n  let lastCompute = 0\n  const MIN_SCROLL_INTERVAL = 150\n\n  const scheduleFrame = () => {\n    if (frame !== null) return\n    frame = requestAnimationFrame(() => {\n      frame = null\n      const now = performance.now()\n      if (now - lastCompute >= MIN_SCROLL_INTERVAL) {\n        lastCompute = now\n        computeAndDispatch()\n      } else {\n        scheduleFrame()\n      }\n    })\n  }\n\n  scrollContainer.addEventListener('scroll', scheduleFrame, { passive: true })\n\n  // Fire once to populate initial viewport\n  computeAndDispatch()\n\n  return {\n    update(_view: EditorView, prevState: EditorState) {\n      if (view.state.doc.content.size !== prevState.doc.content.size) {\n        scheduleFrame()\n      }\n    },\n    destroy: () => {\n      if (frame !== null) {\n        cancelAnimationFrame(frame)\n      }\n      scrollContainer.removeEventListener('scroll', scheduleFrame)\n    },\n  }\n}\n"],"mappings":"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","names":["import_core","import_state","import_view"]}

package/dist/placeholder/index.d.cts

@@ -1,7 +1,16 @@
-import { Editor, Extension } from '@tiptap/core';
 import { PluginKey } from '@tiptap/pm/state';
+import { Editor, Extension } from '@tiptap/core';
 import { Node } from '@tiptap/pm/model';
 
+/**
+ * The viewport positions tracked by the placeholder plugin.
+ * `null` means "no viewport info yet" — the decoration callback falls back to
+ * a full document scan until the scroll handler fires.
+ */
+interface ViewportState {
+    topPos: number | null;
+    bottomPos: number | null;
+}
 interface PlaceholderOptions {
     /**
      * **The class name for the empty editor**
@@ -57,13 +66,11 @@ interface PlaceholderOptions {
     includeChildren: boolean;
 }
 
-/**
- * Prepares the placeholder attribute by ensuring it is properly formatted.
- * @param attr - The placeholder attribute string.
- * @returns The prepared placeholder attribute string.
- */
-declare function preparePlaceholderAttribute(attr: string): string;
-declare const PLUGIN_KEY: PluginKey<any>;
+/** The default data attribute label */
+declare const DEFAULT_DATA_ATTRIBUTE = "placeholder";
+/** The plugin key used to store and read the placeholder viewport state */
+declare const PLUGIN_KEY: PluginKey<ViewportState>;
+
 /**
  * This extension allows you to add a placeholder to your editor.
  * A placeholder is a text that appears when the editor or a node is empty.
@@ -71,4 +78,11 @@ declare const PLUGIN_KEY: PluginKey<any>;
  */
 declare const Placeholder: Extension<PlaceholderOptions, any>;
 
-export { PLUGIN_KEY, Placeholder, type PlaceholderOptions, preparePlaceholderAttribute };
+/**
+ * Prepares the placeholder attribute by ensuring it is properly formatted.
+ * @param attr - The placeholder attribute string.
+ * @returns The prepared placeholder attribute string.
+ */
+declare function preparePlaceholderAttribute(attr: string): string;
+
+export { DEFAULT_DATA_ATTRIBUTE, PLUGIN_KEY, Placeholder, type PlaceholderOptions, type ViewportState, preparePlaceholderAttribute };

package/dist/placeholder/index.d.ts

@@ -1,7 +1,16 @@
-import { Editor, Extension } from '@tiptap/core';
 import { PluginKey } from '@tiptap/pm/state';
+import { Editor, Extension } from '@tiptap/core';
 import { Node } from '@tiptap/pm/model';
 
+/**
+ * The viewport positions tracked by the placeholder plugin.
+ * `null` means "no viewport info yet" — the decoration callback falls back to
+ * a full document scan until the scroll handler fires.
+ */
+interface ViewportState {
+    topPos: number | null;
+    bottomPos: number | null;
+}
 interface PlaceholderOptions {
     /**
      * **The class name for the empty editor**
@@ -57,13 +66,11 @@ interface PlaceholderOptions {
     includeChildren: boolean;
 }
 
-/**
- * Prepares the placeholder attribute by ensuring it is properly formatted.
- * @param attr - The placeholder attribute string.
- * @returns The prepared placeholder attribute string.
- */
-declare function preparePlaceholderAttribute(attr: string): string;
-declare const PLUGIN_KEY: PluginKey<any>;
+/** The default data attribute label */
+declare const DEFAULT_DATA_ATTRIBUTE = "placeholder";
+/** The plugin key used to store and read the placeholder viewport state */
+declare const PLUGIN_KEY: PluginKey<ViewportState>;
+
 /**
  * This extension allows you to add a placeholder to your editor.
  * A placeholder is a text that appears when the editor or a node is empty.
@@ -71,4 +78,11 @@ declare const PLUGIN_KEY: PluginKey<any>;
  */
 declare const Placeholder: Extension<PlaceholderOptions, any>;
 
-export { PLUGIN_KEY, Placeholder, type PlaceholderOptions, preparePlaceholderAttribute };
+/**
+ * Prepares the placeholder attribute by ensuring it is properly formatted.
+ * @param attr - The placeholder attribute string.
+ * @returns The prepared placeholder attribute string.
+ */
+declare function preparePlaceholderAttribute(attr: string): string;
+
+export { DEFAULT_DATA_ATTRIBUTE, PLUGIN_KEY, Placeholder, type PlaceholderOptions, type ViewportState, preparePlaceholderAttribute };