@payloadcms/ui 4.0.0-internal.21664f3 → 4.0.0-internal.2f0d313

package/dist/elements/Button/index.js

@@ -3,6 +3,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React, { Fragment } from 'react';
 import { ChevronIcon } from '../../icons/Chevron/index.js';
+import { ClipboardIcon } from '../../icons/Clipboard/index.js';
 import { EditIcon } from '../../icons/Edit/index.js';
 import { LinkIcon } from '../../icons/Link/index.js';
 import { PlusIcon } from '../../icons/Plus/index.js';
@@ -17,6 +18,7 @@ import './index.css';
 import { Tooltip } from '../Tooltip/index.js';
 const icons = {
   chevron: ChevronIcon,
+  clipboard: ClipboardIcon,
   edit: EditIcon,
   link: LinkIcon,
   plus: PlusIcon,

package/dist/elements/Button/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["React","Fragment","ChevronIcon","EditIcon","LinkIcon","PlusIcon","SpinnerIcon","SwapIcon","WriteIcon","XIcon","useTranslation","Link","Popup","Tooltip","icons","chevron","edit","link","plus","swap","write","x","baseClass","ButtonContents","children","icon","loading","showTooltip","tooltip","BuiltInIcon","undefined","isReactIcon","_jsxs","_jsx","className","show","size","Button","props","id","type","ariaLabel","buttonStyle","disabled","el","enableSubMenu","extraButtonProps","iconPosition","margin","newTab","onClick","onMouseDown","popupIconSize","ref","round","selected","SubMenuPopupContent","to","url","setShowTooltip","useState","t","isDisabled","classes","filter","Boolean","join","handleClick","event","preventDefault","styleClasses","buttonProps","onPointerEnter","onPointerLeave","rel","target","title","buttonElement","href","prefetch","Tag","button","buttonAriaLabel","buttonSize","horizontalAlign","noBackground","render","close","verticalAlign"],"sources":["../../../src/elements/Button/index.tsx"],"sourcesContent":["'use client'\nimport React, { Fragment } from 'react'\n\nimport type { Props } from './types.js'\n\nimport { ChevronIcon } from '../../icons/Chevron/index.js'\nimport { EditIcon } from '../../icons/Edit/index.js'\nimport { LinkIcon } from '../../icons/Link/index.js'\nimport { PlusIcon } from '../../icons/Plus/index.js'\nimport { SpinnerIcon } from '../../icons/Spinner/index.js'\nimport { SwapIcon } from '../../icons/Swap/index.js'\nimport { WriteIcon } from '../../icons/Write/index.js'\nimport { XIcon } from '../../icons/X/index.js'\nimport { useTranslation } from '../../providers/Translation/index.js'\nimport { Link } from '../Link/index.js'\nimport { Popup } from '../Popup/index.js'\nimport './index.css'\nimport { Tooltip } from '../Tooltip/index.js'\n\nconst icons = {\n  chevron: ChevronIcon,\n  edit: EditIcon,\n  link: LinkIcon,\n  plus: PlusIcon,\n  swap: SwapIcon,\n  write: WriteIcon,\n  x: XIcon,\n}\n\nconst baseClass = 'btn'\n\nexport const ButtonContents = ({ children, icon, loading, showTooltip, tooltip }) => {\n  const BuiltInIcon = typeof icon === 'string' ? icons[icon] : undefined\n  // Check if icon is a React element (including RSC payloads) - not a string icon name\n  const isReactIcon = icon && typeof icon !== 'string'\n\n  return (\n    <Fragment>\n      {tooltip && (\n        <Tooltip className={`${baseClass}__tooltip`} show={showTooltip}>\n          {tooltip}\n        </Tooltip>\n      )}\n      {loading && (\n        <span className={`${baseClass}__loading`}>\n          <SpinnerIcon />\n        </span>\n      )}\n      <span className={`${baseClass}__content`}>\n        {children && <span className={`${baseClass}__label`}>{children}</span>}\n        {icon && (\n          <span className={`${baseClass}__icon`}>\n            {isReactIcon && icon}\n            {BuiltInIcon && <BuiltInIcon size={24} />}\n          </span>\n        )}\n      </span>\n    </Fragment>\n  )\n}\n\nexport const Button: React.FC<Props> = (props) => {\n  const {\n    id,\n    type = 'button',\n    'aria-label': ariaLabel,\n    buttonStyle = 'primary',\n    children,\n    className,\n    disabled,\n    el = 'button',\n    enableSubMenu,\n    extraButtonProps = {},\n    icon,\n    iconPosition = 'right',\n    loading,\n    margin = true,\n    newTab,\n    onClick,\n    onMouseDown,\n    popupIconSize,\n    ref,\n    round,\n    selected,\n    size = 'medium',\n    SubMenuPopupContent,\n    to,\n    tooltip,\n    url,\n  } = props\n\n  const [showTooltip, setShowTooltip] = React.useState(false)\n  const { t } = useTranslation()\n\n  // Explicit `=== true` check preserves `false` for aria-disabled attribute.\n  // Using `disabled || loading` would treat `false` as falsy, omitting the attribute entirely.\n  const isDisabled = disabled === true || loading === true\n\n  const classes = [\n    baseClass,\n    className && className,\n    icon && `${baseClass}--icon`,\n    icon && !children && `${baseClass}--icon-only`,\n    size && `${baseClass}--size-${size}`,\n    icon && iconPosition && `${baseClass}--icon-position-${iconPosition}`,\n    tooltip && `${baseClass}--has-tooltip`,\n    !SubMenuPopupContent && `${baseClass}--withoutPopup`,\n    !margin && `${baseClass}--no-margin`,\n    loading && `${baseClass}--loading`,\n    icon && !children && `${baseClass}--icon-only`,\n  ]\n    .filter(Boolean)\n    .join(' ')\n\n  function handleClick(event) {\n    setShowTooltip(false)\n    if (type !== 'submit' && onClick) {\n      event.preventDefault()\n    }\n    if (onClick) {\n      onClick(event)\n    }\n  }\n\n  const styleClasses = [\n    buttonStyle && `${baseClass}--style-${buttonStyle}`,\n    isDisabled && `${baseClass}--disabled`,\n    round && `${baseClass}--round`,\n    selected && `${baseClass}--selected`,\n    SubMenuPopupContent ? `${baseClass}--withPopup` : `${baseClass}--withoutPopup`,\n  ]\n    .filter(Boolean)\n    .join(' ')\n\n  const buttonProps = {\n    id,\n    type,\n    'aria-disabled': isDisabled,\n    'aria-label': ariaLabel,\n    className: !SubMenuPopupContent ? [classes, styleClasses].join(' ') : classes,\n    disabled: isDisabled,\n    onClick: !isDisabled ? handleClick : undefined,\n    onMouseDown: !isDisabled ? onMouseDown : undefined,\n    onPointerEnter: tooltip ? () => setShowTooltip(true) : undefined,\n    onPointerLeave: tooltip ? () => setShowTooltip(false) : undefined,\n    rel: newTab ? 'noopener noreferrer' : undefined,\n    target: newTab ? '_blank' : undefined,\n    title: tooltip ? undefined : ariaLabel,\n    ...extraButtonProps,\n  }\n\n  let buttonElement\n\n  switch (el) {\n    case 'anchor':\n      buttonElement = (\n        <a\n          {...buttonProps}\n          href={!isDisabled ? url : undefined}\n          ref={ref as React.RefObject<HTMLAnchorElement>}\n        >\n          <ButtonContents icon={icon} loading={loading} showTooltip={showTooltip} tooltip={tooltip}>\n            {children}\n          </ButtonContents>\n        </a>\n      )\n      break\n\n    case 'link':\n      if (isDisabled) {\n        buttonElement = (\n          <div {...buttonProps}>\n            <ButtonContents\n              icon={icon}\n              loading={loading}\n              showTooltip={showTooltip}\n              tooltip={tooltip}\n            >\n              {children}\n            </ButtonContents>\n          </div>\n        )\n      }\n\n      buttonElement = (\n        <Link {...buttonProps} href={to || url} prefetch={false}>\n          <ButtonContents icon={icon} loading={loading} showTooltip={showTooltip} tooltip={tooltip}>\n            {children}\n          </ButtonContents>\n        </Link>\n      )\n\n      break\n\n    default:\n      const Tag = el // eslint-disable-line no-case-declarations\n\n      buttonElement = (\n        <Tag ref={ref} {...buttonProps}>\n          <ButtonContents icon={icon} loading={loading} showTooltip={showTooltip} tooltip={tooltip}>\n            {children}\n          </ButtonContents>\n        </Tag>\n      )\n      break\n  }\n  if (SubMenuPopupContent) {\n    return (\n      <div className={styleClasses}>\n        {buttonElement}\n        <Popup\n          button={<ChevronIcon size={popupIconSize} />}\n          buttonAriaLabel={t('general:moreOptions')}\n          buttonSize={size}\n          className={disabled && !enableSubMenu ? `${baseClass}--popup-disabled` : ''}\n          disabled={disabled && !enableSubMenu}\n          horizontalAlign=\"right\"\n          id={`${id}-popup`}\n          noBackground\n          render={({ close }) => SubMenuPopupContent({ close: () => close() })}\n          size=\"small\"\n          verticalAlign=\"bottom\"\n        />\n      </div>\n    )\n  }\n\n  return buttonElement\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"index.js","names":["React","Fragment","ChevronIcon","ClipboardIcon","EditIcon","LinkIcon","PlusIcon","SpinnerIcon","SwapIcon","WriteIcon","XIcon","useTranslation","Link","Popup","Tooltip","icons","chevron","clipboard","edit","link","plus","swap","write","x","baseClass","ButtonContents","children","icon","loading","showTooltip","tooltip","BuiltInIcon","undefined","isReactIcon","_jsxs","_jsx","className","show","size","Button","props","id","type","ariaLabel","buttonStyle","disabled","el","enableSubMenu","extraButtonProps","iconPosition","margin","newTab","onClick","onMouseDown","popupIconSize","ref","round","selected","SubMenuPopupContent","to","url","setShowTooltip","useState","t","isDisabled","classes","filter","Boolean","join","handleClick","event","preventDefault","styleClasses","buttonProps","onPointerEnter","onPointerLeave","rel","target","title","buttonElement","href","prefetch","Tag","button","buttonAriaLabel","buttonSize","horizontalAlign","noBackground","render","close","verticalAlign"],"sources":["../../../src/elements/Button/index.tsx"],"sourcesContent":["'use client'\nimport React, { Fragment } from 'react'\n\nimport type { Props } from './types.js'\n\nimport { ChevronIcon } from '../../icons/Chevron/index.js'\nimport { ClipboardIcon } from '../../icons/Clipboard/index.js'\nimport { EditIcon } from '../../icons/Edit/index.js'\nimport { LinkIcon } from '../../icons/Link/index.js'\nimport { PlusIcon } from '../../icons/Plus/index.js'\nimport { SpinnerIcon } from '../../icons/Spinner/index.js'\nimport { SwapIcon } from '../../icons/Swap/index.js'\nimport { WriteIcon } from '../../icons/Write/index.js'\nimport { XIcon } from '../../icons/X/index.js'\nimport { useTranslation } from '../../providers/Translation/index.js'\nimport { Link } from '../Link/index.js'\nimport { Popup } from '../Popup/index.js'\nimport './index.css'\nimport { Tooltip } from '../Tooltip/index.js'\n\nconst icons = {\n  chevron: ChevronIcon,\n  clipboard: ClipboardIcon,\n  edit: EditIcon,\n  link: LinkIcon,\n  plus: PlusIcon,\n  swap: SwapIcon,\n  write: WriteIcon,\n  x: XIcon,\n}\n\nconst baseClass = 'btn'\n\nexport const ButtonContents = ({ children, icon, loading, showTooltip, tooltip }) => {\n  const BuiltInIcon = typeof icon === 'string' ? icons[icon] : undefined\n  // Check if icon is a React element (including RSC payloads) - not a string icon name\n  const isReactIcon = icon && typeof icon !== 'string'\n\n  return (\n    <Fragment>\n      {tooltip && (\n        <Tooltip className={`${baseClass}__tooltip`} show={showTooltip}>\n          {tooltip}\n        </Tooltip>\n      )}\n      {loading && (\n        <span className={`${baseClass}__loading`}>\n          <SpinnerIcon />\n        </span>\n      )}\n      <span className={`${baseClass}__content`}>\n        {children && <span className={`${baseClass}__label`}>{children}</span>}\n        {icon && (\n          <span className={`${baseClass}__icon`}>\n            {isReactIcon && icon}\n            {BuiltInIcon && <BuiltInIcon size={24} />}\n          </span>\n        )}\n      </span>\n    </Fragment>\n  )\n}\n\nexport const Button: React.FC<Props> = (props) => {\n  const {\n    id,\n    type = 'button',\n    'aria-label': ariaLabel,\n    buttonStyle = 'primary',\n    children,\n    className,\n    disabled,\n    el = 'button',\n    enableSubMenu,\n    extraButtonProps = {},\n    icon,\n    iconPosition = 'right',\n    loading,\n    margin = true,\n    newTab,\n    onClick,\n    onMouseDown,\n    popupIconSize,\n    ref,\n    round,\n    selected,\n    size = 'medium',\n    SubMenuPopupContent,\n    to,\n    tooltip,\n    url,\n  } = props\n\n  const [showTooltip, setShowTooltip] = React.useState(false)\n  const { t } = useTranslation()\n\n  // Explicit `=== true` check preserves `false` for aria-disabled attribute.\n  // Using `disabled || loading` would treat `false` as falsy, omitting the attribute entirely.\n  const isDisabled = disabled === true || loading === true\n\n  const classes = [\n    baseClass,\n    className && className,\n    icon && `${baseClass}--icon`,\n    icon && !children && `${baseClass}--icon-only`,\n    size && `${baseClass}--size-${size}`,\n    icon && iconPosition && `${baseClass}--icon-position-${iconPosition}`,\n    tooltip && `${baseClass}--has-tooltip`,\n    !SubMenuPopupContent && `${baseClass}--withoutPopup`,\n    !margin && `${baseClass}--no-margin`,\n    loading && `${baseClass}--loading`,\n    icon && !children && `${baseClass}--icon-only`,\n  ]\n    .filter(Boolean)\n    .join(' ')\n\n  function handleClick(event) {\n    setShowTooltip(false)\n    if (type !== 'submit' && onClick) {\n      event.preventDefault()\n    }\n    if (onClick) {\n      onClick(event)\n    }\n  }\n\n  const styleClasses = [\n    buttonStyle && `${baseClass}--style-${buttonStyle}`,\n    isDisabled && `${baseClass}--disabled`,\n    round && `${baseClass}--round`,\n    selected && `${baseClass}--selected`,\n    SubMenuPopupContent ? `${baseClass}--withPopup` : `${baseClass}--withoutPopup`,\n  ]\n    .filter(Boolean)\n    .join(' ')\n\n  const buttonProps = {\n    id,\n    type,\n    'aria-disabled': isDisabled,\n    'aria-label': ariaLabel,\n    className: !SubMenuPopupContent ? [classes, styleClasses].join(' ') : classes,\n    disabled: isDisabled,\n    onClick: !isDisabled ? handleClick : undefined,\n    onMouseDown: !isDisabled ? onMouseDown : undefined,\n    onPointerEnter: tooltip ? () => setShowTooltip(true) : undefined,\n    onPointerLeave: tooltip ? () => setShowTooltip(false) : undefined,\n    rel: newTab ? 'noopener noreferrer' : undefined,\n    target: newTab ? '_blank' : undefined,\n    title: tooltip ? undefined : ariaLabel,\n    ...extraButtonProps,\n  }\n\n  let buttonElement\n\n  switch (el) {\n    case 'anchor':\n      buttonElement = (\n        <a\n          {...buttonProps}\n          href={!isDisabled ? url : undefined}\n          ref={ref as React.RefObject<HTMLAnchorElement>}\n        >\n          <ButtonContents icon={icon} loading={loading} showTooltip={showTooltip} tooltip={tooltip}>\n            {children}\n          </ButtonContents>\n        </a>\n      )\n      break\n\n    case 'link':\n      if (isDisabled) {\n        buttonElement = (\n          <div {...buttonProps}>\n            <ButtonContents\n              icon={icon}\n              loading={loading}\n              showTooltip={showTooltip}\n              tooltip={tooltip}\n            >\n              {children}\n            </ButtonContents>\n          </div>\n        )\n      }\n\n      buttonElement = (\n        <Link {...buttonProps} href={to || url} prefetch={false}>\n          <ButtonContents icon={icon} loading={loading} showTooltip={showTooltip} tooltip={tooltip}>\n            {children}\n          </ButtonContents>\n        </Link>\n      )\n\n      break\n\n    default:\n      const Tag = el // eslint-disable-line no-case-declarations\n\n      buttonElement = (\n        <Tag ref={ref} {...buttonProps}>\n          <ButtonContents icon={icon} loading={loading} showTooltip={showTooltip} tooltip={tooltip}>\n            {children}\n          </ButtonContents>\n        </Tag>\n      )\n      break\n  }\n  if (SubMenuPopupContent) {\n    return (\n      <div className={styleClasses}>\n        {buttonElement}\n        <Popup\n          button={<ChevronIcon size={popupIconSize} />}\n          buttonAriaLabel={t('general:moreOptions')}\n          buttonSize={size}\n          className={disabled && !enableSubMenu ? `${baseClass}--popup-disabled` : ''}\n          disabled={disabled && !enableSubMenu}\n          horizontalAlign=\"right\"\n          id={`${id}-popup`}\n          noBackground\n          render={({ close }) => SubMenuPopupContent({ close: () => close() })}\n          size=\"small\"\n          verticalAlign=\"bottom\"\n        />\n      </div>\n    )\n  }\n\n  return buttonElement\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/ClipboardAction/clipboardUtilities.d.ts

@@ -1,4 +1,11 @@
-import type { ClipboardCopyActionArgs, ClipboardPasteActionArgs } from './types.js';
+import type { ClipboardCopyActionArgs, ClipboardPasteActionArgs, ClipboardPasteEligibilityArgs } from './types.js';
+/**
+ * Whether the clipboard contents can be pasted into the target field.
+ *
+ * Returns `false` when the clipboard is empty or its schema is incompatible
+ * with the target. Used to disable paste actions when they would fail.
+ */
+export declare function canPasteClipboardData(args: ClipboardPasteEligibilityArgs): boolean;
 /**
  * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513
  */

package/dist/elements/ClipboardAction/clipboardUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboardUtilities.d.ts","sourceRoot":"","sources":["../../../src/elements/ClipboardAction/clipboardUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EAGzB,MAAM,YAAY,CAAA;AAMnB;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,GAAG,IAAI,CAc1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,IAAI,EAAE,SAAS,EACf,CAAC,EACD,GAAG,IAAI,EACR,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CA4B1C"}
+{"version":3,"file":"clipboardUtilities.d.ts","sourceRoot":"","sources":["../../../src/elements/ClipboardAction/clipboardUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EAGxB,6BAA6B,EAC9B,MAAM,YAAY,CAAA;AAyBnB;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAgBlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,GAAG,IAAI,CAc1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,IAAI,EAAE,SAAS,EACf,CAAC,EACD,GAAG,IAAI,EACR,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CAoB1C"}

package/dist/elements/ClipboardAction/clipboardUtilities.js

@@ -1,5 +1,43 @@
 import { isClipboardDataValid } from './isClipboardDataValid.js';
 const localStorageClipboardKey = '_payloadClipboard';
+/**
+ * Reads and parses the clipboard data from localStorage.
+ *
+ * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513
+ */
+function readClipboardData() {
+  try {
+    const jsonFromClipboard = localStorage.getItem(localStorageClipboardKey);
+    if (!jsonFromClipboard) {
+      return null;
+    }
+    return JSON.parse(jsonFromClipboard);
+  } catch (_err) {
+    return null;
+  }
+}
+/**
+ * Whether the clipboard contents can be pasted into the target field.
+ *
+ * Returns `false` when the clipboard is empty or its schema is incompatible
+ * with the target. Used to disable paste actions when they would fail.
+ */
+export function canPasteClipboardData(args) {
+  const dataToPaste = readClipboardData();
+  if (!dataToPaste) {
+    return false;
+  }
+  const {
+    path,
+    ...schemaArgs
+  } = args;
+  const dataToValidate = {
+    ...dataToPaste,
+    ...schemaArgs,
+    fieldPath: path
+  };
+  return isClipboardDataValid(dataToValidate);
+}
 /**
  * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513
  */
@@ -29,14 +67,8 @@ export function clipboardPaste({
   t,
   ...args
 }) {
-  let dataToPaste;
-  try {
-    const jsonFromClipboard = localStorage.getItem(localStorageClipboardKey);
-    if (!jsonFromClipboard) {
-      return t('error:invalidClipboardData');
-    }
-    dataToPaste = JSON.parse(jsonFromClipboard);
-  } catch (_err) {
+  const dataToPaste = readClipboardData();
+  if (!dataToPaste) {
     return t('error:invalidClipboardData');
   }
   const dataToValidate = {

package/dist/elements/ClipboardAction/clipboardUtilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboardUtilities.js","names":["isClipboardDataValid","localStorageClipboardKey","clipboardCopy","args","getDataToCopy","t","rest","dataToWrite","data","localStorage","setItem","JSON","stringify","_err","clipboardPaste","onPaste","path","fieldPath","dataToPaste","jsonFromClipboard","getItem","parse","dataToValidate"],"sources":["../../../src/elements/ClipboardAction/clipboardUtilities.ts"],"sourcesContent":["import type {\n  ClipboardCopyActionArgs,\n  ClipboardPasteActionArgs,\n  ClipboardPasteActionValidateArgs,\n  ClipboardPasteData,\n} from './types.js'\n\nimport { isClipboardDataValid } from './isClipboardDataValid.js'\n\nconst localStorageClipboardKey = '_payloadClipboard'\n\n/**\n * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nexport function clipboardCopy(args: ClipboardCopyActionArgs): string | true {\n  const { getDataToCopy, t, ...rest } = args\n\n  const dataToWrite = {\n    data: getDataToCopy(),\n    ...rest,\n  }\n\n  try {\n    localStorage.setItem(localStorageClipboardKey, JSON.stringify(dataToWrite))\n    return true\n  } catch (_err) {\n    return t('error:unableToCopy')\n  }\n}\n\n/**\n * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nexport function clipboardPaste({\n  onPaste,\n  path: fieldPath,\n  t,\n  ...args\n}: ClipboardPasteActionArgs): string | true {\n  let dataToPaste: ClipboardPasteData\n\n  try {\n    const jsonFromClipboard = localStorage.getItem(localStorageClipboardKey)\n\n    if (!jsonFromClipboard) {\n      return t('error:invalidClipboardData')\n    }\n\n    dataToPaste = JSON.parse(jsonFromClipboard)\n  } catch (_err) {\n    return t('error:invalidClipboardData')\n  }\n\n  const dataToValidate = {\n    ...dataToPaste,\n    ...args,\n    fieldPath,\n  } as ClipboardPasteActionValidateArgs\n\n  if (!isClipboardDataValid(dataToValidate)) {\n    return t('error:invalidClipboardData')\n  }\n\n  onPaste(dataToPaste)\n\n  return true\n}\n"],"mappings":"AAOA,SAASA,oBAAoB,QAAQ;AAErC,MAAMC,wBAAA,GAA2B;AAEjC;;;AAGA,OAAO,SAASC,cAAcC,IAA6B;EACzD,MAAM;IAAEC,aAAa;IAAEC,CAAC;IAAE,GAAGC;EAAA,CAAM,GAAGH,IAAA;EAEtC,MAAMI,WAAA,GAAc;IAClBC,IAAA,EAAMJ,aAAA;IACN,GAAGE;EACL;EAEA,IAAI;IACFG,YAAA,CAAaC,OAAO,CAACT,wBAAA,EAA0BU,IAAA,CAAKC,SAAS,CAACL,WAAA;IAC9D,OAAO;EACT,EAAE,OAAOM,IAAA,EAAM;IACb,OAAOR,CAAA,CAAE;EACX;AACF;AAEA;;;AAGA,OAAO,SAASS,eAAe;EAC7BC,OAAO;EACPC,IAAA,EAAMC,SAAS;EACfZ,CAAC;EACD,GAAGF;AAAA,CACsB;EACzB,IAAIe,WAAA;EAEJ,IAAI;IACF,MAAMC,iBAAA,GAAoBV,YAAA,CAAaW,OAAO,CAACnB,wBAAA;IAE/C,IAAI,CAACkB,iBAAA,EAAmB;MACtB,OAAOd,CAAA,CAAE;IACX;IAEAa,WAAA,GAAcP,IAAA,CAAKU,KAAK,CAACF,iBAAA;EAC3B,EAAE,OAAON,IAAA,EAAM;IACb,OAAOR,CAAA,CAAE;EACX;EAEA,MAAMiB,cAAA,GAAiB;IACrB,GAAGJ,WAAW;IACd,GAAGf,IAAI;IACPc;EACF;EAEA,IAAI,CAACjB,oBAAA,CAAqBsB,cAAA,GAAiB;IACzC,OAAOjB,CAAA,CAAE;EACX;EAEAU,OAAA,CAAQG,WAAA;EAER,OAAO;AACT","ignoreList":[]}
+{"version":3,"file":"clipboardUtilities.js","names":["isClipboardDataValid","localStorageClipboardKey","readClipboardData","jsonFromClipboard","localStorage","getItem","JSON","parse","_err","canPasteClipboardData","args","dataToPaste","path","schemaArgs","dataToValidate","fieldPath","clipboardCopy","getDataToCopy","t","rest","dataToWrite","data","setItem","stringify","clipboardPaste","onPaste"],"sources":["../../../src/elements/ClipboardAction/clipboardUtilities.ts"],"sourcesContent":["import type {\n  ClipboardCopyActionArgs,\n  ClipboardPasteActionArgs,\n  ClipboardPasteActionValidateArgs,\n  ClipboardPasteData,\n  ClipboardPasteEligibilityArgs,\n} from './types.js'\n\nimport { isClipboardDataValid } from './isClipboardDataValid.js'\n\nconst localStorageClipboardKey = '_payloadClipboard'\n\n/**\n * Reads and parses the clipboard data from localStorage.\n *\n * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nfunction readClipboardData(): ClipboardPasteData | null {\n  try {\n    const jsonFromClipboard = localStorage.getItem(localStorageClipboardKey)\n\n    if (!jsonFromClipboard) {\n      return null\n    }\n\n    return JSON.parse(jsonFromClipboard)\n  } catch (_err) {\n    return null\n  }\n}\n\n/**\n * Whether the clipboard contents can be pasted into the target field.\n *\n * Returns `false` when the clipboard is empty or its schema is incompatible\n * with the target. Used to disable paste actions when they would fail.\n */\nexport function canPasteClipboardData(args: ClipboardPasteEligibilityArgs): boolean {\n  const dataToPaste = readClipboardData()\n\n  if (!dataToPaste) {\n    return false\n  }\n\n  const { path, ...schemaArgs } = args\n\n  const dataToValidate = {\n    ...dataToPaste,\n    ...schemaArgs,\n    fieldPath: path,\n  } as ClipboardPasteActionValidateArgs\n\n  return isClipboardDataValid(dataToValidate)\n}\n\n/**\n * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nexport function clipboardCopy(args: ClipboardCopyActionArgs): string | true {\n  const { getDataToCopy, t, ...rest } = args\n\n  const dataToWrite = {\n    data: getDataToCopy(),\n    ...rest,\n  }\n\n  try {\n    localStorage.setItem(localStorageClipboardKey, JSON.stringify(dataToWrite))\n    return true\n  } catch (_err) {\n    return t('error:unableToCopy')\n  }\n}\n\n/**\n * @note This function doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nexport function clipboardPaste({\n  onPaste,\n  path: fieldPath,\n  t,\n  ...args\n}: ClipboardPasteActionArgs): string | true {\n  const dataToPaste = readClipboardData()\n\n  if (!dataToPaste) {\n    return t('error:invalidClipboardData')\n  }\n\n  const dataToValidate = {\n    ...dataToPaste,\n    ...args,\n    fieldPath,\n  } as ClipboardPasteActionValidateArgs\n\n  if (!isClipboardDataValid(dataToValidate)) {\n    return t('error:invalidClipboardData')\n  }\n\n  onPaste(dataToPaste)\n\n  return true\n}\n"],"mappings":"AAQA,SAASA,oBAAoB,QAAQ;AAErC,MAAMC,wBAAA,GAA2B;AAEjC;;;;;AAKA,SAASC,kBAAA;EACP,IAAI;IACF,MAAMC,iBAAA,GAAoBC,YAAA,CAAaC,OAAO,CAACJ,wBAAA;IAE/C,IAAI,CAACE,iBAAA,EAAmB;MACtB,OAAO;IACT;IAEA,OAAOG,IAAA,CAAKC,KAAK,CAACJ,iBAAA;EACpB,EAAE,OAAOK,IAAA,EAAM;IACb,OAAO;EACT;AACF;AAEA;;;;;;AAMA,OAAO,SAASC,sBAAsBC,IAAmC;EACvE,MAAMC,WAAA,GAAcT,iBAAA;EAEpB,IAAI,CAACS,WAAA,EAAa;IAChB,OAAO;EACT;EAEA,MAAM;IAAEC,IAAI;IAAE,GAAGC;EAAA,CAAY,GAAGH,IAAA;EAEhC,MAAMI,cAAA,GAAiB;IACrB,GAAGH,WAAW;IACd,GAAGE,UAAU;IACbE,SAAA,EAAWH;EACb;EAEA,OAAOZ,oBAAA,CAAqBc,cAAA;AAC9B;AAEA;;;AAGA,OAAO,SAASE,cAAcN,IAA6B;EACzD,MAAM;IAAEO,aAAa;IAAEC,CAAC;IAAE,GAAGC;EAAA,CAAM,GAAGT,IAAA;EAEtC,MAAMU,WAAA,GAAc;IAClBC,IAAA,EAAMJ,aAAA;IACN,GAAGE;EACL;EAEA,IAAI;IACFf,YAAA,CAAakB,OAAO,CAACrB,wBAAA,EAA0BK,IAAA,CAAKiB,SAAS,CAACH,WAAA;IAC9D,OAAO;EACT,EAAE,OAAOZ,IAAA,EAAM;IACb,OAAOU,CAAA,CAAE;EACX;AACF;AAEA;;;AAGA,OAAO,SAASM,eAAe;EAC7BC,OAAO;EACPb,IAAA,EAAMG,SAAS;EACfG,CAAC;EACD,GAAGR;AAAA,CACsB;EACzB,MAAMC,WAAA,GAAcT,iBAAA;EAEpB,IAAI,CAACS,WAAA,EAAa;IAChB,OAAOO,CAAA,CAAE;EACX;EAEA,MAAMJ,cAAA,GAAiB;IACrB,GAAGH,WAAW;IACd,GAAGD,IAAI;IACPK;EACF;EAEA,IAAI,CAACf,oBAAA,CAAqBc,cAAA,GAAiB;IACzC,OAAOI,CAAA,CAAE;EACX;EAEAO,OAAA,CAAQd,WAAA;EAER,OAAO;AACT","ignoreList":[]}

package/dist/elements/ClipboardAction/clipboardUtilities.spec.js

@@ -0,0 +1,120 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { canPasteClipboardData } from './clipboardUtilities.js';
+const localStorageClipboardKey = '_payloadClipboard';
+const textField = {
+  name: 'text',
+  type: 'text'
+};
+const numberField = {
+  name: 'num',
+  type: 'number'
+};
+const ctaBlock = {
+  slug: 'cta',
+  fields: [textField]
+};
+const otherBlock = {
+  slug: 'other',
+  fields: [numberField]
+};
+const arrayClipboard = {
+  type: 'array',
+  data: {
+    'items.0.text': {
+      valid: true,
+      value: 'hi'
+    }
+  },
+  fields: [textField],
+  path: 'items',
+  rowIndex: 0
+};
+const blocksClipboard = {
+  type: 'blocks',
+  blocks: [ctaBlock],
+  data: {
+    'layout.0.blockType': {
+      valid: true,
+      value: 'cta'
+    }
+  },
+  path: 'layout',
+  rowIndex: 0
+};
+class LocalStorageMock {
+  store = {};
+  clear() {
+    this.store = {};
+  }
+  getItem(key) {
+    return key in this.store ? this.store[key] : null;
+  }
+  removeItem(key) {
+    delete this.store[key];
+  }
+  setItem(key, value) {
+    this.store[key] = String(value);
+  }
+}
+describe('canPasteClipboardData', () => {
+  let localStorageMock;
+  beforeEach(() => {
+    localStorageMock = new LocalStorageMock();
+    vi.stubGlobal('localStorage', localStorageMock);
+  });
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+  const writeClipboard = data => {
+    localStorageMock.setItem(localStorageClipboardKey, JSON.stringify(data));
+  };
+  it('should return false when the clipboard is empty', () => {
+    expect(canPasteClipboardData({
+      path: 'items',
+      schemaFields: [textField]
+    })).toBe(false);
+  });
+  it('should return false when the clipboard contains invalid JSON', () => {
+    localStorageMock.setItem(localStorageClipboardKey, 'not-json');
+    expect(canPasteClipboardData({
+      path: 'items',
+      schemaFields: [textField]
+    })).toBe(false);
+  });
+  it('should return true for an array field with a matching schema', () => {
+    writeClipboard(arrayClipboard);
+    expect(canPasteClipboardData({
+      path: 'items',
+      schemaFields: [textField]
+    })).toBe(true);
+  });
+  it('should return false for an array field with an incompatible schema', () => {
+    writeClipboard(arrayClipboard);
+    expect(canPasteClipboardData({
+      path: 'items',
+      schemaFields: [numberField]
+    })).toBe(false);
+  });
+  it('should return true for a blocks field with a matching schema', () => {
+    writeClipboard(blocksClipboard);
+    expect(canPasteClipboardData({
+      path: 'layout',
+      schemaBlocks: [ctaBlock]
+    })).toBe(true);
+  });
+  it('should return false for a blocks field with an incompatible schema', () => {
+    writeClipboard(blocksClipboard);
+    expect(canPasteClipboardData({
+      path: 'layout',
+      schemaBlocks: [otherBlock]
+    })).toBe(false);
+  });
+  it('should return false when pasting array data into a blocks field', () => {
+    writeClipboard(arrayClipboard);
+    expect(canPasteClipboardData({
+      path: 'layout',
+      schemaBlocks: [ctaBlock]
+    })).toBe(false);
+  });
+});
+//# sourceMappingURL=clipboardUtilities.spec.js.map

package/dist/elements/ClipboardAction/clipboardUtilities.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardUtilities.spec.js","names":["afterEach","beforeEach","describe","expect","it","vi","canPasteClipboardData","localStorageClipboardKey","textField","name","type","numberField","ctaBlock","slug","fields","otherBlock","arrayClipboard","data","valid","value","path","rowIndex","blocksClipboard","blocks","LocalStorageMock","store","clear","getItem","key","removeItem","setItem","String","localStorageMock","stubGlobal","unstubAllGlobals","writeClipboard","JSON","stringify","schemaFields","toBe","schemaBlocks"],"sources":["../../../src/elements/ClipboardAction/clipboardUtilities.spec.ts"],"sourcesContent":["import type { ClientBlock, ClientField } from 'payload'\n\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\n\nimport type { ClipboardPasteData } from './types.js'\n\nimport { canPasteClipboardData } from './clipboardUtilities.js'\n\nconst localStorageClipboardKey = '_payloadClipboard'\n\nconst textField = { name: 'text', type: 'text' } as ClientField\nconst numberField = { name: 'num', type: 'number' } as ClientField\n\nconst ctaBlock = { slug: 'cta', fields: [textField] } as ClientBlock\nconst otherBlock = { slug: 'other', fields: [numberField] } as ClientBlock\n\nconst arrayClipboard: ClipboardPasteData = {\n  type: 'array',\n  data: { 'items.0.text': { valid: true, value: 'hi' } },\n  fields: [textField],\n  path: 'items',\n  rowIndex: 0,\n}\n\nconst blocksClipboard: ClipboardPasteData = {\n  type: 'blocks',\n  blocks: [ctaBlock],\n  data: { 'layout.0.blockType': { valid: true, value: 'cta' } },\n  path: 'layout',\n  rowIndex: 0,\n}\n\nclass LocalStorageMock {\n  private store: Record<string, string> = {}\n\n  clear() {\n    this.store = {}\n  }\n\n  getItem(key: string): null | string {\n    return key in this.store ? this.store[key] : null\n  }\n\n  removeItem(key: string) {\n    delete this.store[key]\n  }\n\n  setItem(key: string, value: string) {\n    this.store[key] = String(value)\n  }\n}\n\ndescribe('canPasteClipboardData', () => {\n  let localStorageMock: LocalStorageMock\n\n  beforeEach(() => {\n    localStorageMock = new LocalStorageMock()\n    vi.stubGlobal('localStorage', localStorageMock)\n  })\n\n  afterEach(() => {\n    vi.unstubAllGlobals()\n  })\n\n  const writeClipboard = (data: ClipboardPasteData) => {\n    localStorageMock.setItem(localStorageClipboardKey, JSON.stringify(data))\n  }\n\n  it('should return false when the clipboard is empty', () => {\n    expect(canPasteClipboardData({ path: 'items', schemaFields: [textField] })).toBe(false)\n  })\n\n  it('should return false when the clipboard contains invalid JSON', () => {\n    localStorageMock.setItem(localStorageClipboardKey, 'not-json')\n\n    expect(canPasteClipboardData({ path: 'items', schemaFields: [textField] })).toBe(false)\n  })\n\n  it('should return true for an array field with a matching schema', () => {\n    writeClipboard(arrayClipboard)\n\n    expect(canPasteClipboardData({ path: 'items', schemaFields: [textField] })).toBe(true)\n  })\n\n  it('should return false for an array field with an incompatible schema', () => {\n    writeClipboard(arrayClipboard)\n\n    expect(canPasteClipboardData({ path: 'items', schemaFields: [numberField] })).toBe(false)\n  })\n\n  it('should return true for a blocks field with a matching schema', () => {\n    writeClipboard(blocksClipboard)\n\n    expect(canPasteClipboardData({ path: 'layout', schemaBlocks: [ctaBlock] })).toBe(true)\n  })\n\n  it('should return false for a blocks field with an incompatible schema', () => {\n    writeClipboard(blocksClipboard)\n\n    expect(canPasteClipboardData({ path: 'layout', schemaBlocks: [otherBlock] })).toBe(false)\n  })\n\n  it('should return false when pasting array data into a blocks field', () => {\n    writeClipboard(arrayClipboard)\n\n    expect(canPasteClipboardData({ path: 'layout', schemaBlocks: [ctaBlock] })).toBe(false)\n  })\n})\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/ClipboardAction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/ClipboardAction/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEzD,OAAO,EAAE,KAAK,EAAE,EAAe,MAAM,OAAO,CAAA;AAG5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAQ9D,OAAO,aAAa,CAAA;AAIpB,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,MAAM,0BAA0B,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,SAAS,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,iBAAiB,CAAA;AAErB;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,KAAK,CA8FrC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/ClipboardAction/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEzD,OAAO,EAAE,KAAK,EAAE,EAAe,MAAM,OAAO,CAAA;AAG5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAS9D,OAAO,aAAa,CAAA;AAIpB,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,MAAM,0BAA0B,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,SAAS,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,iBAAiB,CAAA;AAErB;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,KAAK,CAyGrC,CAAA"}

package/dist/elements/ClipboardAction/index.js

@@ -9,6 +9,7 @@ import { MoreIcon } from '../../icons/More/index.js';
 import { useTranslation } from '../../providers/Translation/index.js';
 import { Popup, PopupList } from '../Popup/index.js';
 import { clipboardCopy, clipboardPaste } from './clipboardUtilities.js';
+import { useCanPasteClipboard } from './useCanPasteClipboard.js';
 import './index.css';
 const baseClass = 'clipboard-action';
 /**
@@ -30,6 +31,16 @@ export const ClipboardAction = ({
   const {
     t
   } = useTranslation();
+  const {
+    canPaste,
+    refresh
+  } = useCanPasteClipboard(rest.type === 'array' ? {
+    path,
+    schemaFields: rest.fields
+  } : {
+    path,
+    schemaBlocks: rest.blocks
+  });
   const classes = [`${baseClass}__popup`, className].filter(Boolean).join(' ');
   const handleCopy = useCallback(() => {
     const clipboardResult = clipboardCopy({
@@ -70,6 +81,11 @@ export const ClipboardAction = ({
     className: classes,
     disabled: disabled,
     horizontalAlign: "right",
+    onToggleOpen: active => {
+      if (active) {
+        refresh();
+      }
+    },
     render: ({
       close
     }) => /*#__PURE__*/_jsxs(PopupList.MenuItem, {
@@ -86,7 +102,7 @@ export const ClipboardAction = ({
         children: isRow ? t('general:copyRow') : t('general:copyField')
       }), /*#__PURE__*/_jsx(PopupList.Button, {
         className: pasteClassName,
-        disabled: !allowPaste,
+        disabled: !allowPaste || !canPaste,
         icon: /*#__PURE__*/_jsx(ClipboardIcon, {}),
         onClick: () => {
           void handlePaste();

package/dist/elements/ClipboardAction/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["useCallback","toast","ClipboardIcon","CopyIcon","MoreIcon","useTranslation","Popup","PopupList","clipboardCopy","clipboardPaste","baseClass","ClipboardAction","allowCopy","allowPaste","className","copyClassName","disabled","isRow","onPaste","pasteClassName","path","rest","t","classes","filter","Boolean","join","handleCopy","clipboardResult","error","success","handlePaste","type","schemaFields","fields","schemaBlocks","blocks","_jsx","button","buttonAriaLabel","buttonClassName","caret","horizontalAlign","render","close","_jsxs","MenuItem","Button","icon","size","onClick","verticalAlign"],"sources":["../../../src/elements/ClipboardAction/index.tsx"],"sourcesContent":["'use client'\n\nimport type { FormStateWithoutComponents } from 'payload'\n\nimport { type FC, useCallback } from 'react'\nimport { toast } from 'sonner'\n\nimport type { ClipboardCopyData, OnPasteFn } from './types.js'\n\nimport { ClipboardIcon } from '../../icons/Clipboard/index.js'\nimport { CopyIcon } from '../../icons/Copy/index.js'\nimport { MoreIcon } from '../../icons/More/index.js'\nimport { useTranslation } from '../../providers/Translation/index.js'\nimport { Popup, PopupList } from '../Popup/index.js'\nimport { clipboardCopy, clipboardPaste } from './clipboardUtilities.js'\nimport './index.css'\n\nconst baseClass = 'clipboard-action'\n\ntype Props = {\n  allowCopy?: boolean\n  allowPaste?: boolean\n  className?: string\n  copyClassName?: string\n  disabled?: boolean\n  getDataToCopy: () => FormStateWithoutComponents\n  isRow?: boolean\n  onPaste: OnPasteFn\n  pasteClassName?: string\n} & ClipboardCopyData\n\n/**\n * Menu actions for copying and pasting fields. Currently, this is only used in Arrays and Blocks.\n * @note This component doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nexport const ClipboardAction: FC<Props> = ({\n  allowCopy,\n  allowPaste,\n  className,\n  copyClassName,\n  disabled,\n  isRow,\n  onPaste,\n  pasteClassName,\n  path,\n  ...rest\n}) => {\n  const { t } = useTranslation()\n\n  const classes = [`${baseClass}__popup`, className].filter(Boolean).join(' ')\n\n  const handleCopy = useCallback(() => {\n    const clipboardResult = clipboardCopy({\n      path,\n      t,\n      ...rest,\n    })\n\n    if (typeof clipboardResult === 'string') {\n      toast.error(clipboardResult)\n    } else {\n      toast.success(t('general:copied'))\n    }\n  }, [t, rest, path])\n\n  const handlePaste = useCallback(() => {\n    const clipboardResult = clipboardPaste(\n      rest.type === 'array'\n        ? {\n            onPaste,\n            path,\n            schemaFields: rest.fields,\n            t,\n          }\n        : {\n            onPaste,\n            path,\n            schemaBlocks: rest.blocks,\n            t,\n          },\n    )\n\n    if (typeof clipboardResult === 'string') {\n      toast.error(clipboardResult)\n    }\n  }, [onPaste, rest, path, t])\n\n  if (!allowPaste && !allowCopy) {\n    return null\n  }\n\n  return (\n    <Popup\n      button={<MoreIcon />}\n      buttonAriaLabel={t('general:moreOptions')}\n      buttonClassName={`${baseClass}__button`}\n      caret={false}\n      className={classes}\n      disabled={disabled}\n      horizontalAlign=\"right\"\n      render={({ close }) => (\n        <PopupList.MenuItem>\n          <PopupList.Button\n            className={copyClassName}\n            disabled={!allowCopy}\n            icon={<CopyIcon size={24} />}\n            onClick={() => {\n              void handleCopy()\n              close()\n            }}\n          >\n            {isRow ? t('general:copyRow') : t('general:copyField')}\n          </PopupList.Button>\n          <PopupList.Button\n            className={pasteClassName}\n            disabled={!allowPaste}\n            icon={<ClipboardIcon />}\n            onClick={() => {\n              void handlePaste()\n              close()\n            }}\n          >\n            {isRow ? t('general:pasteRow') : t('general:pasteField')}\n          </PopupList.Button>\n        </PopupList.MenuItem>\n      )}\n      verticalAlign=\"bottom\"\n    />\n  )\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"index.js","names":["useCallback","toast","ClipboardIcon","CopyIcon","MoreIcon","useTranslation","Popup","PopupList","clipboardCopy","clipboardPaste","useCanPasteClipboard","baseClass","ClipboardAction","allowCopy","allowPaste","className","copyClassName","disabled","isRow","onPaste","pasteClassName","path","rest","t","canPaste","refresh","type","schemaFields","fields","schemaBlocks","blocks","classes","filter","Boolean","join","handleCopy","clipboardResult","error","success","handlePaste","_jsx","button","buttonAriaLabel","buttonClassName","caret","horizontalAlign","onToggleOpen","active","render","close","_jsxs","MenuItem","Button","icon","size","onClick","verticalAlign"],"sources":["../../../src/elements/ClipboardAction/index.tsx"],"sourcesContent":["'use client'\n\nimport type { FormStateWithoutComponents } from 'payload'\n\nimport { type FC, useCallback } from 'react'\nimport { toast } from 'sonner'\n\nimport type { ClipboardCopyData, OnPasteFn } from './types.js'\n\nimport { ClipboardIcon } from '../../icons/Clipboard/index.js'\nimport { CopyIcon } from '../../icons/Copy/index.js'\nimport { MoreIcon } from '../../icons/More/index.js'\nimport { useTranslation } from '../../providers/Translation/index.js'\nimport { Popup, PopupList } from '../Popup/index.js'\nimport { clipboardCopy, clipboardPaste } from './clipboardUtilities.js'\nimport { useCanPasteClipboard } from './useCanPasteClipboard.js'\nimport './index.css'\n\nconst baseClass = 'clipboard-action'\n\ntype Props = {\n  allowCopy?: boolean\n  allowPaste?: boolean\n  className?: string\n  copyClassName?: string\n  disabled?: boolean\n  getDataToCopy: () => FormStateWithoutComponents\n  isRow?: boolean\n  onPaste: OnPasteFn\n  pasteClassName?: string\n} & ClipboardCopyData\n\n/**\n * Menu actions for copying and pasting fields. Currently, this is only used in Arrays and Blocks.\n * @note This component doesn't use the Clipboard API, but localStorage. See rationale in #11513\n */\nexport const ClipboardAction: FC<Props> = ({\n  allowCopy,\n  allowPaste,\n  className,\n  copyClassName,\n  disabled,\n  isRow,\n  onPaste,\n  pasteClassName,\n  path,\n  ...rest\n}) => {\n  const { t } = useTranslation()\n\n  const { canPaste, refresh } = useCanPasteClipboard(\n    rest.type === 'array'\n      ? { path, schemaFields: rest.fields }\n      : { path, schemaBlocks: rest.blocks },\n  )\n\n  const classes = [`${baseClass}__popup`, className].filter(Boolean).join(' ')\n\n  const handleCopy = useCallback(() => {\n    const clipboardResult = clipboardCopy({\n      path,\n      t,\n      ...rest,\n    })\n\n    if (typeof clipboardResult === 'string') {\n      toast.error(clipboardResult)\n    } else {\n      toast.success(t('general:copied'))\n    }\n  }, [t, rest, path])\n\n  const handlePaste = useCallback(() => {\n    const clipboardResult = clipboardPaste(\n      rest.type === 'array'\n        ? {\n            onPaste,\n            path,\n            schemaFields: rest.fields,\n            t,\n          }\n        : {\n            onPaste,\n            path,\n            schemaBlocks: rest.blocks,\n            t,\n          },\n    )\n\n    if (typeof clipboardResult === 'string') {\n      toast.error(clipboardResult)\n    }\n  }, [onPaste, rest, path, t])\n\n  if (!allowPaste && !allowCopy) {\n    return null\n  }\n\n  return (\n    <Popup\n      button={<MoreIcon />}\n      buttonAriaLabel={t('general:moreOptions')}\n      buttonClassName={`${baseClass}__button`}\n      caret={false}\n      className={classes}\n      disabled={disabled}\n      horizontalAlign=\"right\"\n      onToggleOpen={(active) => {\n        if (active) {\n          refresh()\n        }\n      }}\n      render={({ close }) => (\n        <PopupList.MenuItem>\n          <PopupList.Button\n            className={copyClassName}\n            disabled={!allowCopy}\n            icon={<CopyIcon size={24} />}\n            onClick={() => {\n              void handleCopy()\n              close()\n            }}\n          >\n            {isRow ? t('general:copyRow') : t('general:copyField')}\n          </PopupList.Button>\n          <PopupList.Button\n            className={pasteClassName}\n            disabled={!allowPaste || !canPaste}\n            icon={<ClipboardIcon />}\n            onClick={() => {\n              void handlePaste()\n              close()\n            }}\n          >\n            {isRow ? t('general:pasteRow') : t('general:pasteField')}\n          </PopupList.Button>\n        </PopupList.MenuItem>\n      )}\n      verticalAlign=\"bottom\"\n    />\n  )\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/ClipboardAction/isClipboardDataValid.spec.js

@@ -0,0 +1,144 @@
+import { describe, expect, it } from 'vitest';
+import { isClipboardDataValid } from './isClipboardDataValid.js';
+const textField = {
+  name: 'text',
+  type: 'text'
+};
+const numberField = {
+  name: 'num',
+  type: 'number'
+};
+const renamedTextField = {
+  name: 'title',
+  type: 'text'
+};
+const subArrayField = {
+  name: 'sub',
+  type: 'array',
+  fields: [textField]
+};
+const subArrayFieldMismatch = {
+  name: 'sub',
+  type: 'array',
+  fields: [numberField]
+};
+const ctaBlock = {
+  slug: 'cta',
+  fields: [textField]
+};
+const otherBlock = {
+  slug: 'other',
+  fields: [numberField]
+};
+const baseData = {
+  'items.0.text': {
+    valid: true,
+    value: 'hi'
+  }
+};
+const buildArrayArgs = ({
+  fields,
+  schemaFields,
+  ...overrides
+}) => ({
+  type: 'array',
+  data: baseData,
+  fieldPath: 'items',
+  fields,
+  path: 'items',
+  rowIndex: 0,
+  schemaFields,
+  ...overrides
+});
+const buildBlocksArgs = ({
+  blocks,
+  schemaBlocks
+}) => ({
+  type: 'blocks',
+  blocks,
+  data: {
+    'layout.0.blockType': {
+      valid: true,
+      value: 'cta'
+    }
+  },
+  fieldPath: 'layout',
+  path: 'layout',
+  rowIndex: 0,
+  schemaBlocks
+});
+describe('isClipboardDataValid', () => {
+  it('should return false when data is undefined', () => {
+    expect(isClipboardDataValid(buildArrayArgs({
+      data: undefined,
+      fields: [textField],
+      schemaFields: [textField]
+    }))).toBe(false);
+  });
+  it('should return false when path is missing', () => {
+    expect(isClipboardDataValid(buildArrayArgs({
+      fields: [textField],
+      path: '',
+      schemaFields: [textField]
+    }))).toBe(false);
+  });
+  describe('array fields', () => {
+    it('should return true for a matching schema', () => {
+      expect(isClipboardDataValid(buildArrayArgs({
+        fields: [textField],
+        schemaFields: [textField]
+      }))).toBe(true);
+    });
+    it('should return false when field types differ', () => {
+      expect(isClipboardDataValid(buildArrayArgs({
+        fields: [textField],
+        schemaFields: [numberField]
+      }))).toBe(false);
+    });
+    it('should return false when field names differ', () => {
+      expect(isClipboardDataValid(buildArrayArgs({
+        fields: [textField],
+        schemaFields: [renamedTextField]
+      }))).toBe(false);
+    });
+    it('should return false when field counts differ', () => {
+      expect(isClipboardDataValid(buildArrayArgs({
+        fields: [textField],
+        schemaFields: [textField, numberField]
+      }))).toBe(false);
+    });
+    it('should return true for matching nested sub-fields', () => {
+      expect(isClipboardDataValid(buildArrayArgs({
+        fields: [subArrayField],
+        schemaFields: [subArrayField]
+      }))).toBe(true);
+    });
+    it('should return false for mismatching nested sub-fields', () => {
+      expect(isClipboardDataValid(buildArrayArgs({
+        fields: [subArrayField],
+        schemaFields: [subArrayFieldMismatch]
+      }))).toBe(false);
+    });
+  });
+  describe('blocks fields', () => {
+    it('should return true for a matching block schema', () => {
+      expect(isClipboardDataValid(buildBlocksArgs({
+        blocks: [ctaBlock],
+        schemaBlocks: [ctaBlock]
+      }))).toBe(true);
+    });
+    it('should return false when a copied block slug is not in the target config', () => {
+      expect(isClipboardDataValid(buildBlocksArgs({
+        blocks: [ctaBlock],
+        schemaBlocks: [otherBlock]
+      }))).toBe(false);
+    });
+    it('should return false when the target has no blocks configured', () => {
+      expect(isClipboardDataValid(buildBlocksArgs({
+        blocks: [ctaBlock],
+        schemaBlocks: []
+      }))).toBe(false);
+    });
+  });
+});
+//# sourceMappingURL=isClipboardDataValid.spec.js.map

package/dist/elements/ClipboardAction/isClipboardDataValid.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isClipboardDataValid.spec.js","names":["describe","expect","it","isClipboardDataValid","textField","name","type","numberField","renamedTextField","subArrayField","fields","subArrayFieldMismatch","ctaBlock","slug","otherBlock","baseData","valid","value","buildArrayArgs","schemaFields","overrides","data","fieldPath","path","rowIndex","buildBlocksArgs","blocks","schemaBlocks","undefined","toBe"],"sources":["../../../src/elements/ClipboardAction/isClipboardDataValid.spec.ts"],"sourcesContent":["import type { ClientBlock, ClientField } from 'payload'\n\nimport { describe, expect, it } from 'vitest'\n\nimport type { ClipboardPasteActionValidateArgs, ClipboardPasteData } from './types.js'\n\nimport { isClipboardDataValid } from './isClipboardDataValid.js'\n\nconst textField = { name: 'text', type: 'text' } as ClientField\nconst numberField = { name: 'num', type: 'number' } as ClientField\nconst renamedTextField = { name: 'title', type: 'text' } as ClientField\n\nconst subArrayField = { name: 'sub', type: 'array', fields: [textField] } as ClientField\nconst subArrayFieldMismatch = { name: 'sub', type: 'array', fields: [numberField] } as ClientField\n\nconst ctaBlock = { slug: 'cta', fields: [textField] } as ClientBlock\nconst otherBlock = { slug: 'other', fields: [numberField] } as ClientBlock\n\nconst baseData: ClipboardPasteData['data'] = { 'items.0.text': { valid: true, value: 'hi' } }\n\nconst buildArrayArgs = ({\n  fields,\n  schemaFields,\n  ...overrides\n}: {\n  fields: ClientField[]\n  schemaFields: ClientField[]\n} & Partial<ClipboardPasteActionValidateArgs>): ClipboardPasteActionValidateArgs =>\n  ({\n    type: 'array',\n    data: baseData,\n    fieldPath: 'items',\n    fields,\n    path: 'items',\n    rowIndex: 0,\n    schemaFields,\n    ...overrides,\n  }) as ClipboardPasteActionValidateArgs\n\nconst buildBlocksArgs = ({\n  blocks,\n  schemaBlocks,\n}: {\n  blocks: ClientBlock[]\n  schemaBlocks: ClientBlock[]\n}): ClipboardPasteActionValidateArgs =>\n  ({\n    type: 'blocks',\n    blocks,\n    data: { 'layout.0.blockType': { valid: true, value: 'cta' } },\n    fieldPath: 'layout',\n    path: 'layout',\n    rowIndex: 0,\n    schemaBlocks,\n  }) as ClipboardPasteActionValidateArgs\n\ndescribe('isClipboardDataValid', () => {\n  it('should return false when data is undefined', () => {\n    expect(\n      isClipboardDataValid(\n        buildArrayArgs({ data: undefined, fields: [textField], schemaFields: [textField] }),\n      ),\n    ).toBe(false)\n  })\n\n  it('should return false when path is missing', () => {\n    expect(\n      isClipboardDataValid(\n        buildArrayArgs({ fields: [textField], path: '', schemaFields: [textField] }),\n      ),\n    ).toBe(false)\n  })\n\n  describe('array fields', () => {\n    it('should return true for a matching schema', () => {\n      expect(\n        isClipboardDataValid(buildArrayArgs({ fields: [textField], schemaFields: [textField] })),\n      ).toBe(true)\n    })\n\n    it('should return false when field types differ', () => {\n      expect(\n        isClipboardDataValid(buildArrayArgs({ fields: [textField], schemaFields: [numberField] })),\n      ).toBe(false)\n    })\n\n    it('should return false when field names differ', () => {\n      expect(\n        isClipboardDataValid(\n          buildArrayArgs({ fields: [textField], schemaFields: [renamedTextField] }),\n        ),\n      ).toBe(false)\n    })\n\n    it('should return false when field counts differ', () => {\n      expect(\n        isClipboardDataValid(\n          buildArrayArgs({ fields: [textField], schemaFields: [textField, numberField] }),\n        ),\n      ).toBe(false)\n    })\n\n    it('should return true for matching nested sub-fields', () => {\n      expect(\n        isClipboardDataValid(\n          buildArrayArgs({ fields: [subArrayField], schemaFields: [subArrayField] }),\n        ),\n      ).toBe(true)\n    })\n\n    it('should return false for mismatching nested sub-fields', () => {\n      expect(\n        isClipboardDataValid(\n          buildArrayArgs({ fields: [subArrayField], schemaFields: [subArrayFieldMismatch] }),\n        ),\n      ).toBe(false)\n    })\n  })\n\n  describe('blocks fields', () => {\n    it('should return true for a matching block schema', () => {\n      expect(\n        isClipboardDataValid(buildBlocksArgs({ blocks: [ctaBlock], schemaBlocks: [ctaBlock] })),\n      ).toBe(true)\n    })\n\n    it('should return false when a copied block slug is not in the target config', () => {\n      expect(\n        isClipboardDataValid(buildBlocksArgs({ blocks: [ctaBlock], schemaBlocks: [otherBlock] })),\n      ).toBe(false)\n    })\n\n    it('should return false when the target has no blocks configured', () => {\n      expect(isClipboardDataValid(buildBlocksArgs({ blocks: [ctaBlock], schemaBlocks: [] }))).toBe(\n        false,\n      )\n    })\n  })\n})\n"],"mappings":"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","ignoreList":[]}

package/dist/elements/ClipboardAction/mergeFormStateFromClipboard.d.ts

@@ -11,4 +11,14 @@ export declare function mergeFormStateFromClipboard({ dataFromClipboard: clipboa
     path: string;
     rowIndex?: number;
 }): FormState;
+/**
+ * Inserts a new row at `rowIndex`, populated with clipboard data, without disturbing
+ * any existing rows. Existing rows at and after `rowIndex` are shifted down by one.
+ */
+export declare function insertRowFromClipboard({ dataFromClipboard: clipboardData, formState, path, rowIndex, }: {
+    dataFromClipboard: ClipboardPasteData;
+    formState: FormState;
+    path: string;
+    rowIndex: number;
+}): FormState;
 //# sourceMappingURL=mergeFormStateFromClipboard.d.ts.map

package/dist/elements/ClipboardAction/mergeFormStateFromClipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mergeFormStateFromClipboard.d.ts","sourceRoot":"","sources":["../../../src/elements/ClipboardAction/mergeFormStateFromClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAIpD,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,8BAyBA;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,iBAAiB,EAAE,aAAa,EAChC,SAAS,EACT,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,iBAAiB,EAAE,kBAAkB,CAAA;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,aA0IA"}
+{"version":3,"file":"mergeFormStateFromClipboard.d.ts","sourceRoot":"","sources":["../../../src/elements/ClipboardAction/mergeFormStateFromClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAO,MAAM,SAAS,CAAA;AAIzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAcpD,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,8BAyBA;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,iBAAiB,EAAE,aAAa,EAChC,SAAS,EACT,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,iBAAiB,EAAE,kBAAkB,CAAA;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,aA0IA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,iBAAiB,EAAE,aAAa,EAChC,SAAS,EACT,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,iBAAiB,EAAE,kBAAkB,CAAA;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,SAAS,CAqCZ"}