@atlaskit/native-embeds-common 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1 +1,15 @@
 # @atlaskit/native-embeds-common
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies
+
+## 0.1.1
+
+### Patch Changes
+
+- [`71180287b9fed`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/71180287b9fed) -
+  pen inline prompt when ask rovo is clicked on a maui app and send the context to the api
+- Updated dependencies

package/dist/cjs/index.js

@@ -21,16 +21,46 @@ Object.defineProperty(exports, "DEFAULT_ALIGNMENT", {
     return _constants.DEFAULT_ALIGNMENT;
   }
 });
+Object.defineProperty(exports, "EDITOR_TOOLBAR_HANDLER_KEYS", {
+  enumerable: true,
+  get: function get() {
+    return _constants.EDITOR_TOOLBAR_HANDLER_KEYS;
+  }
+});
+Object.defineProperty(exports, "NATIVE_EMBED_PARAMETER_DEFAULTS", {
+  enumerable: true,
+  get: function get() {
+    return _constants.NATIVE_EMBED_PARAMETER_DEFAULTS;
+  }
+});
 Object.defineProperty(exports, "createEditorToolbarActions", {
   enumerable: true,
   get: function get() {
     return _utils.createEditorToolbarActions;
   }
 });
-Object.defineProperty(exports, "updateParameters", {
+Object.defineProperty(exports, "getParameter", {
+  enumerable: true,
+  get: function get() {
+    return _utils.getParameter;
+  }
+});
+Object.defineProperty(exports, "getParameters", {
+  enumerable: true,
+  get: function get() {
+    return _utils.getParameters;
+  }
+});
+Object.defineProperty(exports, "setParameter", {
+  enumerable: true,
+  get: function get() {
+    return _utils.setParameter;
+  }
+});
+Object.defineProperty(exports, "setParameters", {
   enumerable: true,
   get: function get() {
-    return _utils.updateParameters;
+    return _utils.setParameters;
   }
 });
 var _constants = require("./utils/constants");

package/dist/cjs/utils/constants.js

@@ -3,27 +3,39 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.DEFAULT_ALIGNMENT = exports.BUILTIN_TOOLBAR_KEYS = exports.ALIGNMENT_VALUES = void 0;
+exports.NATIVE_EMBED_PARAMETER_DEFAULTS = exports.EDITOR_TOOLBAR_HANDLER_KEYS = exports.DEFAULT_ALIGNMENT = exports.BUILTIN_TOOLBAR_KEYS = exports.ALIGNMENT_VALUES = void 0;
 // Alignment constants
 var ALIGNMENT_VALUES = exports.ALIGNMENT_VALUES = ['left', 'center', 'right', 'wrap-left', 'wrap-right'];
 var DEFAULT_ALIGNMENT = exports.DEFAULT_ALIGNMENT = 'center';
+var NATIVE_EMBED_PARAMETER_DEFAULTS = exports.NATIVE_EMBED_PARAMETER_DEFAULTS = {
+  url: undefined,
+  alwaysShowTitle: false,
+  alignment: DEFAULT_ALIGNMENT,
+  displayText: undefined,
+  height: 600,
+  width: undefined
+};
 
 /**
  * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
  *
- * Toolbar keys: REFRESH, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
+ * Toolbar keys: ASK_ROVO, REFRESH, EDIT, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
  * More Options dropdown keys: ALWAYS_SHOW_TITLE, SET_EMBED_TYPE, COPY_LINK, DELETE
  * Shared: SEPARATOR (usable in both)
  */
 var BUILTIN_TOOLBAR_KEYS = exports.BUILTIN_TOOLBAR_KEYS = {
+  ASK_ROVO: 'askRovo',
   REFRESH: 'refresh',
+  EDIT: 'edit',
   EMBED: 'embed',
   BORDER: 'border',
   ALIGNMENT: 'alignment',
   OPEN_IN_NEW_WINDOW: 'openInNewWindow',
+  EDIT_URL: 'editUrl',
   ALWAYS_SHOW_TITLE: 'alwaysShowTitle',
   SET_EMBED_TYPE: 'setEmbedType',
   COPY_LINK: 'copyLink',
   DELETE: 'delete',
   SEPARATOR: 'separator'
-};
+};
+var EDITOR_TOOLBAR_HANDLER_KEYS = exports.EDITOR_TOOLBAR_HANDLER_KEYS = ['onAlignmentClick', 'onAppearanceClick', 'onAskRovoClick', 'onCopyLinkClick', 'onChangeBorderClick', 'onDeleteClick', 'onEditUrlClick', 'onEditClick', 'onOpenInNewWindowClick', 'onRefreshClick', 'onSetEmbedTypeClick', 'onShowTitleClick'];

package/dist/cjs/utils/plugin-actions/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/utils/utils.js

@@ -4,25 +4,138 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.createEditorToolbarActions = void 0;
-exports.updateParameters = updateParameters;
+exports.getParameter = exports.createEditorToolbarActions = void 0;
+exports.getParameters = getParameters;
+exports.setParameters = exports.setParameter = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _constants = require("./constants");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var getMacroParamsRecord = function getMacroParamsRecord(parameters) {
+  if (!(parameters !== null && parameters !== void 0 && parameters.macroParams) || (0, _typeof2.default)(parameters.macroParams) !== 'object') {
+    return {};
+  }
+  return parameters.macroParams;
+};
+var unwrapMacroParamValue = function unwrapMacroParamValue(macroParamValue) {
+  if (macroParamValue && (0, _typeof2.default)(macroParamValue) === 'object' && 'value' in macroParamValue) {
+    return macroParamValue.value;
+  }
+  return macroParamValue;
+};
+var PARAMETER_VALIDATORS = {
+  alignment: function alignment(value) {
+    return _constants.ALIGNMENT_VALUES.includes(value);
+  }
+};
+var parseFromDefault = function parseFromDefault(defaultValue, value) {
+  if (typeof defaultValue === 'boolean') {
+    if (typeof value === 'boolean') {
+      return value;
+    }
+    if (value === 'true') {
+      return true;
+    }
+    if (value === 'false') {
+      return false;
+    }
+    return undefined;
+  }
+  if (typeof defaultValue === 'number') {
+    var parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+    return Number.isFinite(parsed) ? parsed : undefined;
+  }
+
+  // String-like values (including keys whose default is undefined, e.g. url/width)
+  return typeof value === 'string' ? value : undefined;
+};
+var serializeParameterValue = function serializeParameterValue(key, value) {
+  var validator = PARAMETER_VALIDATORS[key];
+  if (validator && !validator(value)) {
+    return undefined;
+  }
+  return value === undefined ? undefined : String(value);
+};
+var deserializeParameterValue = function deserializeParameterValue(key, value) {
+  var parsedValue = parseFromDefault(_constants.NATIVE_EMBED_PARAMETER_DEFAULTS[key], value);
+  var validator = PARAMETER_VALIDATORS[key];
+  if (parsedValue === undefined) {
+    return undefined;
+  }
+  if (validator && !validator(parsedValue)) {
+    return undefined;
+  }
+  return parsedValue;
+};
+
 /**
- * Generic utility to update parameters on a native embed extension node.
- * Preserves existing parameters and merges in the new ones.
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
  */
-function updateParameters(current, parameterUpdates) {
-  var existingParams = current.attrs && 'parameters' in current.attrs && (0, _typeof2.default)(current.attrs.parameters) === 'object' ? current.attrs.parameters : {};
-  return {
-    attrs: _objectSpread(_objectSpread({}, current.attrs), {}, {
-      parameters: _objectSpread(_objectSpread({}, existingParams), parameterUpdates)
-    })
-  };
+var getParameter = exports.getParameter = function getParameter(parameters, key) {
+  var macroParams = getMacroParamsRecord(parameters);
+  if (!(key in macroParams)) {
+    return _constants.NATIVE_EMBED_PARAMETER_DEFAULTS[key];
+  }
+  var value = unwrapMacroParamValue(macroParams[key]);
+  var parsedValue = deserializeParameterValue(key, value);
+  return parsedValue === undefined ? _constants.NATIVE_EMBED_PARAMETER_DEFAULTS[key] : parsedValue;
+};
+
+/**
+ * Gets native-embed parameters as resolved values.
+ * When key is provided, returns that single resolved value.
+ * When key is omitted, returns all resolved parameter values.
+ */
+
+function getParameters(parameters, key) {
+  if (key) {
+    return getParameter(parameters, key);
+  }
+  return Object.fromEntries(Object.keys(_constants.NATIVE_EMBED_PARAMETER_DEFAULTS).map(function (defaultKey) {
+    return [defaultKey, getParameter(parameters, defaultKey)];
+  }));
 }
 
+/**
+ * Sets a single key in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+var setParameter = exports.setParameter = function setParameter(parameters, update) {
+  return setParameters(parameters, update);
+};
+
+/**
+ * Sets multiple keys in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+var setParameters = exports.setParameters = function setParameters(parameters, updates) {
+  var currentParameters = parameters !== null && parameters !== void 0 ? parameters : {};
+  var currentMacroParams = getMacroParamsRecord(parameters);
+  var wrappedUpdates = Object.fromEntries(Object.entries(updates).map(function (_ref) {
+    var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
+      key = _ref2[0],
+      value = _ref2[1];
+    return [key, serializeParameterValue(key, value)];
+  }).filter(function (_ref3) {
+    var _ref4 = (0, _slicedToArray2.default)(_ref3, 2),
+      value = _ref4[1];
+    return value !== undefined;
+  }).map(function (_ref5) {
+    var _ref6 = (0, _slicedToArray2.default)(_ref5, 2),
+      key = _ref6[0],
+      value = _ref6[1];
+    return [key, {
+      value: value
+    }];
+  }));
+  return _objectSpread(_objectSpread({}, currentParameters), {}, {
+    macroParams: _objectSpread(_objectSpread({}, currentMacroParams), wrappedUpdates)
+  });
+};
+
 /**
  * Helper function to create a type-safe ManifestEditorToolbarActions config.
  * Automatically infers custom action keys from the customActions object.
@@ -36,6 +149,12 @@ function updateParameters(current, parameterUpdates) {
  *   items: ['refresh', 'myAction', 'separator'], // 'myAction' is type-checked
  *   moreItems: ['copyLink', 'myAction', 'separator', 'delete'], // 'myAction' is type-checked
  * });
+ *
+ * // Or without custom actions:
+ * const simpleConfig = createEditorToolbarActions({
+ *   items: ['alignment', 'separator', 'openInNewWindow', 'editUrl'],
+ *   moreItems: ['delete'],
+ * });
  * ```
  */
 var createEditorToolbarActions = exports.createEditorToolbarActions = function createEditorToolbarActions(config) {

package/dist/es2019/index.js

@@ -1,7 +1,9 @@
 // Re-export constants
-export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS } from './utils/constants';
+export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS, NATIVE_EMBED_PARAMETER_DEFAULTS } from './utils/constants';
 
 // Re-export types
 
+// Plugin actions types
+
 // Re-export utilities
-export { updateParameters, createEditorToolbarActions } from './utils/utils';
+export { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters } from './utils/utils';

package/dist/es2019/utils/constants.js

@@ -1,23 +1,35 @@
 // Alignment constants
 export const ALIGNMENT_VALUES = ['left', 'center', 'right', 'wrap-left', 'wrap-right'];
 export const DEFAULT_ALIGNMENT = 'center';
+export const NATIVE_EMBED_PARAMETER_DEFAULTS = {
+  url: undefined,
+  alwaysShowTitle: false,
+  alignment: DEFAULT_ALIGNMENT,
+  displayText: undefined,
+  height: 600,
+  width: undefined
+};
 
 /**
  * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
  *
- * Toolbar keys: REFRESH, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
+ * Toolbar keys: ASK_ROVO, REFRESH, EDIT, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
  * More Options dropdown keys: ALWAYS_SHOW_TITLE, SET_EMBED_TYPE, COPY_LINK, DELETE
  * Shared: SEPARATOR (usable in both)
  */
 export const BUILTIN_TOOLBAR_KEYS = {
+  ASK_ROVO: 'askRovo',
   REFRESH: 'refresh',
+  EDIT: 'edit',
   EMBED: 'embed',
   BORDER: 'border',
   ALIGNMENT: 'alignment',
   OPEN_IN_NEW_WINDOW: 'openInNewWindow',
+  EDIT_URL: 'editUrl',
   ALWAYS_SHOW_TITLE: 'alwaysShowTitle',
   SET_EMBED_TYPE: 'setEmbedType',
   COPY_LINK: 'copyLink',
   DELETE: 'delete',
   SEPARATOR: 'separator'
-};
+};
+export const EDITOR_TOOLBAR_HANDLER_KEYS = ['onAlignmentClick', 'onAppearanceClick', 'onAskRovoClick', 'onCopyLinkClick', 'onChangeBorderClick', 'onDeleteClick', 'onEditUrlClick', 'onEditClick', 'onOpenInNewWindowClick', 'onRefreshClick', 'onSetEmbedTypeClick', 'onShowTitleClick'];

package/dist/es2019/utils/plugin-actions/types.js

@@ -0,0 +1 @@
+export {};

package/dist/es2019/utils/utils.js

@@ -1,19 +1,112 @@
+import { ALIGNMENT_VALUES, NATIVE_EMBED_PARAMETER_DEFAULTS } from './constants';
+const getMacroParamsRecord = parameters => {
+  if (!(parameters !== null && parameters !== void 0 && parameters.macroParams) || typeof parameters.macroParams !== 'object') {
+    return {};
+  }
+  return parameters.macroParams;
+};
+const unwrapMacroParamValue = macroParamValue => {
+  if (macroParamValue && typeof macroParamValue === 'object' && 'value' in macroParamValue) {
+    return macroParamValue.value;
+  }
+  return macroParamValue;
+};
+const PARAMETER_VALIDATORS = {
+  alignment: value => ALIGNMENT_VALUES.includes(value)
+};
+const parseFromDefault = (defaultValue, value) => {
+  if (typeof defaultValue === 'boolean') {
+    if (typeof value === 'boolean') {
+      return value;
+    }
+    if (value === 'true') {
+      return true;
+    }
+    if (value === 'false') {
+      return false;
+    }
+    return undefined;
+  }
+  if (typeof defaultValue === 'number') {
+    const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+    return Number.isFinite(parsed) ? parsed : undefined;
+  }
+
+  // String-like values (including keys whose default is undefined, e.g. url/width)
+  return typeof value === 'string' ? value : undefined;
+};
+const serializeParameterValue = (key, value) => {
+  const validator = PARAMETER_VALIDATORS[key];
+  if (validator && !validator(value)) {
+    return undefined;
+  }
+  return value === undefined ? undefined : String(value);
+};
+const deserializeParameterValue = (key, value) => {
+  const parsedValue = parseFromDefault(NATIVE_EMBED_PARAMETER_DEFAULTS[key], value);
+  const validator = PARAMETER_VALIDATORS[key];
+  if (parsedValue === undefined) {
+    return undefined;
+  }
+  if (validator && !validator(parsedValue)) {
+    return undefined;
+  }
+  return parsedValue;
+};
+
 /**
- * Generic utility to update parameters on a native embed extension node.
- * Preserves existing parameters and merges in the new ones.
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
  */
-export function updateParameters(current, parameterUpdates) {
-  const existingParams = current.attrs && 'parameters' in current.attrs && typeof current.attrs.parameters === 'object' ? current.attrs.parameters : {};
+export const getParameter = (parameters, key) => {
+  const macroParams = getMacroParamsRecord(parameters);
+  if (!(key in macroParams)) {
+    return NATIVE_EMBED_PARAMETER_DEFAULTS[key];
+  }
+  const value = unwrapMacroParamValue(macroParams[key]);
+  const parsedValue = deserializeParameterValue(key, value);
+  return parsedValue === undefined ? NATIVE_EMBED_PARAMETER_DEFAULTS[key] : parsedValue;
+};
+
+/**
+ * Gets native-embed parameters as resolved values.
+ * When key is provided, returns that single resolved value.
+ * When key is omitted, returns all resolved parameter values.
+ */
+
+export function getParameters(parameters, key) {
+  if (key) {
+    return getParameter(parameters, key);
+  }
+  return Object.fromEntries(Object.keys(NATIVE_EMBED_PARAMETER_DEFAULTS).map(defaultKey => [defaultKey, getParameter(parameters, defaultKey)]));
+}
+
+/**
+ * Sets a single key in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export const setParameter = (parameters, update) => {
+  return setParameters(parameters, update);
+};
+
+/**
+ * Sets multiple keys in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export const setParameters = (parameters, updates) => {
+  const currentParameters = parameters !== null && parameters !== void 0 ? parameters : {};
+  const currentMacroParams = getMacroParamsRecord(parameters);
+  const wrappedUpdates = Object.fromEntries(Object.entries(updates).map(([key, value]) => [key, serializeParameterValue(key, value)]).filter(([, value]) => value !== undefined).map(([key, value]) => [key, {
+    value
+  }]));
   return {
-    attrs: {
-      ...current.attrs,
-      parameters: {
-        ...existingParams,
-        ...parameterUpdates
-      }
+    ...currentParameters,
+    macroParams: {
+      ...currentMacroParams,
+      ...wrappedUpdates
     }
   };
-}
+};
 
 /**
  * Helper function to create a type-safe ManifestEditorToolbarActions config.
@@ -28,6 +121,12 @@ export function updateParameters(current, parameterUpdates) {
  *   items: ['refresh', 'myAction', 'separator'], // 'myAction' is type-checked
  *   moreItems: ['copyLink', 'myAction', 'separator', 'delete'], // 'myAction' is type-checked
  * });
+ *
+ * // Or without custom actions:
+ * const simpleConfig = createEditorToolbarActions({
+ *   items: ['alignment', 'separator', 'openInNewWindow', 'editUrl'],
+ *   moreItems: ['delete'],
+ * });
  * ```
  */
 export const createEditorToolbarActions = config => config;

package/dist/esm/index.js

@@ -1,7 +1,9 @@
 // Re-export constants
-export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS } from './utils/constants';
+export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS, NATIVE_EMBED_PARAMETER_DEFAULTS } from './utils/constants';
 
 // Re-export types
 
+// Plugin actions types
+
 // Re-export utilities
-export { updateParameters, createEditorToolbarActions } from './utils/utils';
+export { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters } from './utils/utils';

package/dist/esm/utils/constants.js

@@ -1,23 +1,35 @@
 // Alignment constants
 export var ALIGNMENT_VALUES = ['left', 'center', 'right', 'wrap-left', 'wrap-right'];
 export var DEFAULT_ALIGNMENT = 'center';
+export var NATIVE_EMBED_PARAMETER_DEFAULTS = {
+  url: undefined,
+  alwaysShowTitle: false,
+  alignment: DEFAULT_ALIGNMENT,
+  displayText: undefined,
+  height: 600,
+  width: undefined
+};
 
 /**
  * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
  *
- * Toolbar keys: REFRESH, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
+ * Toolbar keys: ASK_ROVO, REFRESH, EDIT, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
  * More Options dropdown keys: ALWAYS_SHOW_TITLE, SET_EMBED_TYPE, COPY_LINK, DELETE
  * Shared: SEPARATOR (usable in both)
  */
 export var BUILTIN_TOOLBAR_KEYS = {
+  ASK_ROVO: 'askRovo',
   REFRESH: 'refresh',
+  EDIT: 'edit',
   EMBED: 'embed',
   BORDER: 'border',
   ALIGNMENT: 'alignment',
   OPEN_IN_NEW_WINDOW: 'openInNewWindow',
+  EDIT_URL: 'editUrl',
   ALWAYS_SHOW_TITLE: 'alwaysShowTitle',
   SET_EMBED_TYPE: 'setEmbedType',
   COPY_LINK: 'copyLink',
   DELETE: 'delete',
   SEPARATOR: 'separator'
-};
+};
+export var EDITOR_TOOLBAR_HANDLER_KEYS = ['onAlignmentClick', 'onAppearanceClick', 'onAskRovoClick', 'onCopyLinkClick', 'onChangeBorderClick', 'onDeleteClick', 'onEditUrlClick', 'onEditClick', 'onOpenInNewWindowClick', 'onRefreshClick', 'onSetEmbedTypeClick', 'onShowTitleClick'];

package/dist/esm/utils/plugin-actions/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/utils/utils.js

@@ -1,20 +1,132 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _typeof from "@babel/runtime/helpers/typeof";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { ALIGNMENT_VALUES, NATIVE_EMBED_PARAMETER_DEFAULTS } from './constants';
+var getMacroParamsRecord = function getMacroParamsRecord(parameters) {
+  if (!(parameters !== null && parameters !== void 0 && parameters.macroParams) || _typeof(parameters.macroParams) !== 'object') {
+    return {};
+  }
+  return parameters.macroParams;
+};
+var unwrapMacroParamValue = function unwrapMacroParamValue(macroParamValue) {
+  if (macroParamValue && _typeof(macroParamValue) === 'object' && 'value' in macroParamValue) {
+    return macroParamValue.value;
+  }
+  return macroParamValue;
+};
+var PARAMETER_VALIDATORS = {
+  alignment: function alignment(value) {
+    return ALIGNMENT_VALUES.includes(value);
+  }
+};
+var parseFromDefault = function parseFromDefault(defaultValue, value) {
+  if (typeof defaultValue === 'boolean') {
+    if (typeof value === 'boolean') {
+      return value;
+    }
+    if (value === 'true') {
+      return true;
+    }
+    if (value === 'false') {
+      return false;
+    }
+    return undefined;
+  }
+  if (typeof defaultValue === 'number') {
+    var parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+    return Number.isFinite(parsed) ? parsed : undefined;
+  }
+
+  // String-like values (including keys whose default is undefined, e.g. url/width)
+  return typeof value === 'string' ? value : undefined;
+};
+var serializeParameterValue = function serializeParameterValue(key, value) {
+  var validator = PARAMETER_VALIDATORS[key];
+  if (validator && !validator(value)) {
+    return undefined;
+  }
+  return value === undefined ? undefined : String(value);
+};
+var deserializeParameterValue = function deserializeParameterValue(key, value) {
+  var parsedValue = parseFromDefault(NATIVE_EMBED_PARAMETER_DEFAULTS[key], value);
+  var validator = PARAMETER_VALIDATORS[key];
+  if (parsedValue === undefined) {
+    return undefined;
+  }
+  if (validator && !validator(parsedValue)) {
+    return undefined;
+  }
+  return parsedValue;
+};
+
 /**
- * Generic utility to update parameters on a native embed extension node.
- * Preserves existing parameters and merges in the new ones.
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
  */
-export function updateParameters(current, parameterUpdates) {
-  var existingParams = current.attrs && 'parameters' in current.attrs && _typeof(current.attrs.parameters) === 'object' ? current.attrs.parameters : {};
-  return {
-    attrs: _objectSpread(_objectSpread({}, current.attrs), {}, {
-      parameters: _objectSpread(_objectSpread({}, existingParams), parameterUpdates)
-    })
-  };
+export var getParameter = function getParameter(parameters, key) {
+  var macroParams = getMacroParamsRecord(parameters);
+  if (!(key in macroParams)) {
+    return NATIVE_EMBED_PARAMETER_DEFAULTS[key];
+  }
+  var value = unwrapMacroParamValue(macroParams[key]);
+  var parsedValue = deserializeParameterValue(key, value);
+  return parsedValue === undefined ? NATIVE_EMBED_PARAMETER_DEFAULTS[key] : parsedValue;
+};
+
+/**
+ * Gets native-embed parameters as resolved values.
+ * When key is provided, returns that single resolved value.
+ * When key is omitted, returns all resolved parameter values.
+ */
+
+export function getParameters(parameters, key) {
+  if (key) {
+    return getParameter(parameters, key);
+  }
+  return Object.fromEntries(Object.keys(NATIVE_EMBED_PARAMETER_DEFAULTS).map(function (defaultKey) {
+    return [defaultKey, getParameter(parameters, defaultKey)];
+  }));
 }
 
+/**
+ * Sets a single key in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export var setParameter = function setParameter(parameters, update) {
+  return setParameters(parameters, update);
+};
+
+/**
+ * Sets multiple keys in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export var setParameters = function setParameters(parameters, updates) {
+  var currentParameters = parameters !== null && parameters !== void 0 ? parameters : {};
+  var currentMacroParams = getMacroParamsRecord(parameters);
+  var wrappedUpdates = Object.fromEntries(Object.entries(updates).map(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      key = _ref2[0],
+      value = _ref2[1];
+    return [key, serializeParameterValue(key, value)];
+  }).filter(function (_ref3) {
+    var _ref4 = _slicedToArray(_ref3, 2),
+      value = _ref4[1];
+    return value !== undefined;
+  }).map(function (_ref5) {
+    var _ref6 = _slicedToArray(_ref5, 2),
+      key = _ref6[0],
+      value = _ref6[1];
+    return [key, {
+      value: value
+    }];
+  }));
+  return _objectSpread(_objectSpread({}, currentParameters), {}, {
+    macroParams: _objectSpread(_objectSpread({}, currentMacroParams), wrappedUpdates)
+  });
+};
+
 /**
  * Helper function to create a type-safe ManifestEditorToolbarActions config.
  * Automatically infers custom action keys from the customActions object.
@@ -28,6 +140,12 @@ export function updateParameters(current, parameterUpdates) {
  *   items: ['refresh', 'myAction', 'separator'], // 'myAction' is type-checked
  *   moreItems: ['copyLink', 'myAction', 'separator', 'delete'], // 'myAction' is type-checked
  * });
+ *
+ * // Or without custom actions:
+ * const simpleConfig = createEditorToolbarActions({
+ *   items: ['alignment', 'separator', 'openInNewWindow', 'editUrl'],
+ *   moreItems: ['delete'],
+ * });
  * ```
  */
 export var createEditorToolbarActions = function createEditorToolbarActions(config) {

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
-export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS } from './utils/constants';
-export type { AlignmentValue, EditorToolbarButtonAction, EditorToolbarAction, BuiltinToolbarKey, ManifestEditorToolbarActions, } from './utils/types';
-export { updateParameters, createEditorToolbarActions } from './utils/utils';
+export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS, NATIVE_EMBED_PARAMETER_DEFAULTS, } from './utils/constants';
+export type { AlignmentValue, EditorToolbarButtonAction, EditorToolbarAction, EditorToolbarHandler, EditorToolbarHandlerContext, EditorToolbarHandlerKey, EditorToolbarHandlers, NativeEmbedAppearance, NativeEmbedParameterKey, NativeEmbedParameterValues, NativeEmbedParameterValue, NativeEmbedParameters, BuiltinToolbarKey, ManifestEditorToolbarActions, } from './utils/types';
+export type { CardToNativeEmbedNode, CardToNativeEmbedTransformOptions, CreateCardToNativeEmbedTransform, EditorPluginNativeEmbedsPlugin, NativeEmbedLayout, NativeEmbedTransformAttrs, } from './utils/plugin-actions/types';
+export { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters, } from './utils/utils';

package/dist/types/utils/constants.d.ts

@@ -1,21 +1,27 @@
+import type { NativeEmbedParameterValues } from './types';
 export declare const ALIGNMENT_VALUES: readonly ["left", "center", "right", "wrap-left", "wrap-right"];
 export declare const DEFAULT_ALIGNMENT: "center";
+export declare const NATIVE_EMBED_PARAMETER_DEFAULTS: NativeEmbedParameterValues;
 /**
  * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
  *
- * Toolbar keys: REFRESH, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
+ * Toolbar keys: ASK_ROVO, REFRESH, EDIT, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
  * More Options dropdown keys: ALWAYS_SHOW_TITLE, SET_EMBED_TYPE, COPY_LINK, DELETE
  * Shared: SEPARATOR (usable in both)
  */
 export declare const BUILTIN_TOOLBAR_KEYS: {
+    readonly ASK_ROVO: "askRovo";
     readonly REFRESH: "refresh";
+    readonly EDIT: "edit";
     readonly EMBED: "embed";
     readonly BORDER: "border";
     readonly ALIGNMENT: "alignment";
     readonly OPEN_IN_NEW_WINDOW: "openInNewWindow";
+    readonly EDIT_URL: "editUrl";
     readonly ALWAYS_SHOW_TITLE: "alwaysShowTitle";
     readonly SET_EMBED_TYPE: "setEmbedType";
     readonly COPY_LINK: "copyLink";
     readonly DELETE: "delete";
     readonly SEPARATOR: "separator";
 };
+export declare const EDITOR_TOOLBAR_HANDLER_KEYS: readonly ["onAlignmentClick", "onAppearanceClick", "onAskRovoClick", "onCopyLinkClick", "onChangeBorderClick", "onDeleteClick", "onEditUrlClick", "onEditClick", "onOpenInNewWindowClick", "onRefreshClick", "onSetEmbedTypeClick", "onShowTitleClick"];

package/dist/types/utils/plugin-actions/types.d.ts

@@ -0,0 +1,33 @@
+import type { Command, NextEditorPlugin } from '@atlaskit/editor-common/types';
+import type { Node, Schema } from '@atlaskit/editor-prosemirror/model';
+import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
+/** Accepted layout values from ADF schema (embedCard) */
+export type NativeEmbedLayout = 'wide' | 'full-width' | 'center' | 'wrap-right' | 'wrap-left' | 'align-end' | 'align-start';
+/** Input attrs for embedCard node (subset used by transform) */
+export interface NativeEmbedTransformAttrs {
+    layout?: NativeEmbedLayout;
+    originalHeight?: number | null;
+    originalWidth?: number | null;
+    url: string;
+    width?: number;
+}
+/** Type for cardToNativeEmbedNode - converts embed attrs to native embed Node */
+export type CardToNativeEmbedNode = (schema: Schema, attrs: NativeEmbedTransformAttrs) => Node | undefined;
+/** Type for createEmbedCardToNativeEmbedTransform - returns a Command */
+export type CreateCardToNativeEmbedTransform = (options?: CardToNativeEmbedTransformOptions) => Command;
+export interface CardToNativeEmbedTransformOptions {
+    /**
+     * Called before dispatch to allow the caller to augment the transaction
+     * (e.g. datasource stash, analytics, link metadata).
+     */
+    augmentTransaction?: (tr: Transaction, state: EditorState) => void;
+}
+/**
+ * Minimal plugin type for native embeds action integration.
+ */
+export type EditorPluginNativeEmbedsPlugin = NextEditorPlugin<'editorPluginNativeEmbeds', {
+    actions: {
+        cardToNativeEmbedNode: CardToNativeEmbedNode;
+        createCardToNativeEmbedTransform: CreateCardToNativeEmbedTransform;
+    };
+}>;

package/dist/types/utils/types.d.ts

@@ -1,7 +1,34 @@
 import type { ComponentType } from 'react';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
 import type { NewCoreIconProps } from '@atlaskit/icon';
-import type { ALIGNMENT_VALUES, BUILTIN_TOOLBAR_KEYS } from './constants';
-export type AlignmentValue = (typeof ALIGNMENT_VALUES)[number];
+import type { BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS } from './constants';
+export type AlignmentValue = 'left' | 'center' | 'right' | 'wrap-left' | 'wrap-right';
+export type NativeEmbedAppearance = 'url' | 'inline' | 'block' | 'embed';
+export type NativeEmbedParameterValues = {
+    alignment: AlignmentValue;
+    alwaysShowTitle: boolean;
+    displayText?: string;
+    height: number;
+    url?: string;
+    width?: number;
+};
+export type NativeEmbedParameterValue = {
+    value: string;
+};
+export type NativeEmbedParameters = {
+    macroParams?: {
+        alignment?: NativeEmbedParameterValue;
+        alwaysShowTitle?: NativeEmbedParameterValue;
+        displayText?: NativeEmbedParameterValue;
+        height?: NativeEmbedParameterValue;
+        url?: NativeEmbedParameterValue;
+        width?: NativeEmbedParameterValue;
+    };
+};
+export type NativeEmbedParameterKey = keyof NonNullable<NativeEmbedParameters['macroParams']>;
+export type EditorToolbarHandlerContext = {
+    editorApi?: PublicPluginAPI<[]>;
+};
 /**
  * A button action rendered in the editor floating toolbar.
  */
@@ -40,6 +67,30 @@ export type EditorToolbarButtonAction = {
  * Currently only supports buttons; dropdowns and separators can be added later.
  */
 export type EditorToolbarAction = EditorToolbarButtonAction;
+/**
+ * Handlers for built-in native embed floating toolbar actions.
+ * Can be defined in the manifest (editorToolbarHandlers) and are invoked
+ * by the editor plugin when the corresponding toolbar buttons are clicked.
+ * Handlers with context (e.g. onAlignmentClick, onAppearanceClick) receive
+ * an optional second parameter for the action-specific value.
+ */
+export type EditorToolbarHandlerKey = (typeof EDITOR_TOOLBAR_HANDLER_KEYS)[number];
+export type EditorToolbarHandlers = Partial<{
+    onAlignmentClick: (parameters: NativeEmbedParameterValues, alignment: AlignmentValue, context?: EditorToolbarHandlerContext) => void;
+    onAppearanceClick: (parameters: NativeEmbedParameterValues, appearance: NativeEmbedAppearance, context?: EditorToolbarHandlerContext) => void;
+    onAskRovoClick: (parameters: NativeEmbedParameterValues, context?: EditorToolbarHandlerContext) => void;
+    onChangeBorderClick: EditorToolbarHandler;
+    onCopyLinkClick: EditorToolbarHandler;
+    onDeleteClick: EditorToolbarHandler;
+    onEditClick: EditorToolbarHandler;
+    onEditUrlClick: EditorToolbarHandler;
+    onOpenInNewWindowClick: EditorToolbarHandler;
+    onRefreshClick: EditorToolbarHandler;
+    onSetEmbedTypeClick: EditorToolbarHandler;
+    onShowTitleClick: EditorToolbarHandler;
+}>;
+/** Base handler signature for contexts that don't have action-specific context. */
+export type EditorToolbarHandler = (parameters: NativeEmbedParameterValues, context?: EditorToolbarHandlerContext) => void;
 export type BuiltinToolbarKey = (typeof BUILTIN_TOOLBAR_KEYS)[keyof typeof BUILTIN_TOOLBAR_KEYS];
 /**
  * Configuration for editor toolbar actions in the manifest.
@@ -55,6 +106,12 @@ export type ManifestEditorToolbarActions<TCustomActions extends Record<string, E
      * These can be referenced in the `items` array alongside built-in keys.
      */
     customActions?: TCustomActions;
+    /**
+     * Handlers for built-in toolbar buttons.
+     * When a built-in button (e.g. ASK_ROVO, REFRESH) is clicked, the corresponding
+     * handler is invoked by the editor plugin.
+     */
+    editorToolbarHandlers?: EditorToolbarHandlers;
     /**
      * Ordered array of keys specifying which toolbar items to show and in what order.
      * The "More Options" dropdown is appended automatically based on `moreItems`.

package/dist/types/utils/utils.d.ts

@@ -1,13 +1,26 @@
-import type { ManifestEditorToolbarActions, EditorToolbarAction, BuiltinToolbarKey } from './types';
+import type { ManifestEditorToolbarActions, EditorToolbarAction, BuiltinToolbarKey, NativeEmbedParameterKey, NativeEmbedParameterValues, NativeEmbedParameters } from './types';
 /**
- * Generic utility to update parameters on a native embed extension node.
- * Preserves existing parameters and merges in the new ones.
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
  */
-export declare function updateParameters(current: {
-    attrs?: Record<string, unknown>;
-}, parameterUpdates: Record<string, unknown>): {
-    attrs: Record<string, unknown>;
-};
+export declare const getParameter: <TKey extends NativeEmbedParameterKey>(parameters: NativeEmbedParameters | undefined, key: TKey) => NativeEmbedParameterValues[TKey];
+/**
+ * Gets native-embed parameters as resolved values.
+ * When key is provided, returns that single resolved value.
+ * When key is omitted, returns all resolved parameter values.
+ */
+export declare function getParameters(parameters: NativeEmbedParameters | undefined): NativeEmbedParameterValues;
+export declare function getParameters<TKey extends NativeEmbedParameterKey>(parameters: NativeEmbedParameters | undefined, key: TKey): NativeEmbedParameterValues[TKey];
+/**
+ * Sets a single key in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export declare const setParameter: <TKey extends NativeEmbedParameterKey>(parameters: NativeEmbedParameters | undefined, update: Pick<NativeEmbedParameterValues, TKey>) => NativeEmbedParameters;
+/**
+ * Sets multiple keys in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export declare const setParameters: (parameters: NativeEmbedParameters | undefined, updates: Partial<NativeEmbedParameterValues>) => NativeEmbedParameters;
 /**
  * Helper function to create a type-safe ManifestEditorToolbarActions config.
  * Automatically infers custom action keys from the customActions object.
@@ -21,10 +34,16 @@ export declare function updateParameters(current: {
  *   items: ['refresh', 'myAction', 'separator'], // 'myAction' is type-checked
  *   moreItems: ['copyLink', 'myAction', 'separator', 'delete'], // 'myAction' is type-checked
  * });
+ *
+ * // Or without custom actions:
+ * const simpleConfig = createEditorToolbarActions({
+ *   items: ['alignment', 'separator', 'openInNewWindow', 'editUrl'],
+ *   moreItems: ['delete'],
+ * });
  * ```
  */
-export declare const createEditorToolbarActions: <const TCustomActions extends Record<string, EditorToolbarAction>>(config: {
-    customActions: TCustomActions;
+export declare const createEditorToolbarActions: <const TCustomActions extends Record<string, EditorToolbarAction> = Record<string, EditorToolbarAction>>(config: {
+    customActions?: TCustomActions;
     items: (BuiltinToolbarKey | keyof TCustomActions)[];
     moreItems?: (BuiltinToolbarKey | keyof TCustomActions)[];
 }) => ManifestEditorToolbarActions<TCustomActions>;

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

@@ -1,3 +1,4 @@
-export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS } from './utils/constants';
-export type { AlignmentValue, EditorToolbarButtonAction, EditorToolbarAction, BuiltinToolbarKey, ManifestEditorToolbarActions, } from './utils/types';
-export { updateParameters, createEditorToolbarActions } from './utils/utils';
+export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS, NATIVE_EMBED_PARAMETER_DEFAULTS, } from './utils/constants';
+export type { AlignmentValue, EditorToolbarButtonAction, EditorToolbarAction, EditorToolbarHandler, EditorToolbarHandlerContext, EditorToolbarHandlerKey, EditorToolbarHandlers, NativeEmbedAppearance, NativeEmbedParameterKey, NativeEmbedParameterValues, NativeEmbedParameterValue, NativeEmbedParameters, BuiltinToolbarKey, ManifestEditorToolbarActions, } from './utils/types';
+export type { CardToNativeEmbedNode, CardToNativeEmbedTransformOptions, CreateCardToNativeEmbedTransform, EditorPluginNativeEmbedsPlugin, NativeEmbedLayout, NativeEmbedTransformAttrs, } from './utils/plugin-actions/types';
+export { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters, } from './utils/utils';

package/dist/types-ts4.5/utils/constants.d.ts

@@ -1,3 +1,4 @@
+import type { NativeEmbedParameterValues } from './types';
 export declare const ALIGNMENT_VALUES: readonly [
     "left",
     "center",
@@ -6,22 +7,40 @@ export declare const ALIGNMENT_VALUES: readonly [
     "wrap-right"
 ];
 export declare const DEFAULT_ALIGNMENT: "center";
+export declare const NATIVE_EMBED_PARAMETER_DEFAULTS: NativeEmbedParameterValues;
 /**
  * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
  *
- * Toolbar keys: REFRESH, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
+ * Toolbar keys: ASK_ROVO, REFRESH, EDIT, EMBED, BORDER, ALIGNMENT, OPEN_IN_NEW_WINDOW
  * More Options dropdown keys: ALWAYS_SHOW_TITLE, SET_EMBED_TYPE, COPY_LINK, DELETE
  * Shared: SEPARATOR (usable in both)
  */
 export declare const BUILTIN_TOOLBAR_KEYS: {
+    readonly ASK_ROVO: "askRovo";
     readonly REFRESH: "refresh";
+    readonly EDIT: "edit";
     readonly EMBED: "embed";
     readonly BORDER: "border";
     readonly ALIGNMENT: "alignment";
     readonly OPEN_IN_NEW_WINDOW: "openInNewWindow";
+    readonly EDIT_URL: "editUrl";
     readonly ALWAYS_SHOW_TITLE: "alwaysShowTitle";
     readonly SET_EMBED_TYPE: "setEmbedType";
     readonly COPY_LINK: "copyLink";
     readonly DELETE: "delete";
     readonly SEPARATOR: "separator";
 };
+export declare const EDITOR_TOOLBAR_HANDLER_KEYS: readonly [
+    "onAlignmentClick",
+    "onAppearanceClick",
+    "onAskRovoClick",
+    "onCopyLinkClick",
+    "onChangeBorderClick",
+    "onDeleteClick",
+    "onEditUrlClick",
+    "onEditClick",
+    "onOpenInNewWindowClick",
+    "onRefreshClick",
+    "onSetEmbedTypeClick",
+    "onShowTitleClick"
+];

package/dist/types-ts4.5/utils/plugin-actions/types.d.ts

@@ -0,0 +1,33 @@
+import type { Command, NextEditorPlugin } from '@atlaskit/editor-common/types';
+import type { Node, Schema } from '@atlaskit/editor-prosemirror/model';
+import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
+/** Accepted layout values from ADF schema (embedCard) */
+export type NativeEmbedLayout = 'wide' | 'full-width' | 'center' | 'wrap-right' | 'wrap-left' | 'align-end' | 'align-start';
+/** Input attrs for embedCard node (subset used by transform) */
+export interface NativeEmbedTransformAttrs {
+    layout?: NativeEmbedLayout;
+    originalHeight?: number | null;
+    originalWidth?: number | null;
+    url: string;
+    width?: number;
+}
+/** Type for cardToNativeEmbedNode - converts embed attrs to native embed Node */
+export type CardToNativeEmbedNode = (schema: Schema, attrs: NativeEmbedTransformAttrs) => Node | undefined;
+/** Type for createEmbedCardToNativeEmbedTransform - returns a Command */
+export type CreateCardToNativeEmbedTransform = (options?: CardToNativeEmbedTransformOptions) => Command;
+export interface CardToNativeEmbedTransformOptions {
+    /**
+     * Called before dispatch to allow the caller to augment the transaction
+     * (e.g. datasource stash, analytics, link metadata).
+     */
+    augmentTransaction?: (tr: Transaction, state: EditorState) => void;
+}
+/**
+ * Minimal plugin type for native embeds action integration.
+ */
+export type EditorPluginNativeEmbedsPlugin = NextEditorPlugin<'editorPluginNativeEmbeds', {
+    actions: {
+        cardToNativeEmbedNode: CardToNativeEmbedNode;
+        createCardToNativeEmbedTransform: CreateCardToNativeEmbedTransform;
+    };
+}>;

package/dist/types-ts4.5/utils/types.d.ts

@@ -1,7 +1,35 @@
 import type { ComponentType } from 'react';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
 import type { NewCoreIconProps } from '@atlaskit/icon';
-import type { ALIGNMENT_VALUES, BUILTIN_TOOLBAR_KEYS } from './constants';
-export type AlignmentValue = (typeof ALIGNMENT_VALUES)[number];
+import type { BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS } from './constants';
+export type AlignmentValue = 'left' | 'center' | 'right' | 'wrap-left' | 'wrap-right';
+export type NativeEmbedAppearance = 'url' | 'inline' | 'block' | 'embed';
+export type NativeEmbedParameterValues = {
+    alignment: AlignmentValue;
+    alwaysShowTitle: boolean;
+    displayText?: string;
+    height: number;
+    url?: string;
+    width?: number;
+};
+export type NativeEmbedParameterValue = {
+    value: string;
+};
+export type NativeEmbedParameters = {
+    macroParams?: {
+        alignment?: NativeEmbedParameterValue;
+        alwaysShowTitle?: NativeEmbedParameterValue;
+        displayText?: NativeEmbedParameterValue;
+        height?: NativeEmbedParameterValue;
+        url?: NativeEmbedParameterValue;
+        width?: NativeEmbedParameterValue;
+    };
+};
+export type NativeEmbedParameterKey = keyof NonNullable<NativeEmbedParameters['macroParams']>;
+export type EditorToolbarHandlerContext = {
+    editorApi?: PublicPluginAPI<[
+    ]>;
+};
 /**
  * A button action rendered in the editor floating toolbar.
  */
@@ -40,6 +68,30 @@ export type EditorToolbarButtonAction = {
  * Currently only supports buttons; dropdowns and separators can be added later.
  */
 export type EditorToolbarAction = EditorToolbarButtonAction;
+/**
+ * Handlers for built-in native embed floating toolbar actions.
+ * Can be defined in the manifest (editorToolbarHandlers) and are invoked
+ * by the editor plugin when the corresponding toolbar buttons are clicked.
+ * Handlers with context (e.g. onAlignmentClick, onAppearanceClick) receive
+ * an optional second parameter for the action-specific value.
+ */
+export type EditorToolbarHandlerKey = (typeof EDITOR_TOOLBAR_HANDLER_KEYS)[number];
+export type EditorToolbarHandlers = Partial<{
+    onAlignmentClick: (parameters: NativeEmbedParameterValues, alignment: AlignmentValue, context?: EditorToolbarHandlerContext) => void;
+    onAppearanceClick: (parameters: NativeEmbedParameterValues, appearance: NativeEmbedAppearance, context?: EditorToolbarHandlerContext) => void;
+    onAskRovoClick: (parameters: NativeEmbedParameterValues, context?: EditorToolbarHandlerContext) => void;
+    onChangeBorderClick: EditorToolbarHandler;
+    onCopyLinkClick: EditorToolbarHandler;
+    onDeleteClick: EditorToolbarHandler;
+    onEditClick: EditorToolbarHandler;
+    onEditUrlClick: EditorToolbarHandler;
+    onOpenInNewWindowClick: EditorToolbarHandler;
+    onRefreshClick: EditorToolbarHandler;
+    onSetEmbedTypeClick: EditorToolbarHandler;
+    onShowTitleClick: EditorToolbarHandler;
+}>;
+/** Base handler signature for contexts that don't have action-specific context. */
+export type EditorToolbarHandler = (parameters: NativeEmbedParameterValues, context?: EditorToolbarHandlerContext) => void;
 export type BuiltinToolbarKey = (typeof BUILTIN_TOOLBAR_KEYS)[keyof typeof BUILTIN_TOOLBAR_KEYS];
 /**
  * Configuration for editor toolbar actions in the manifest.
@@ -55,6 +107,12 @@ export type ManifestEditorToolbarActions<TCustomActions extends Record<string, E
      * These can be referenced in the `items` array alongside built-in keys.
      */
     customActions?: TCustomActions;
+    /**
+     * Handlers for built-in toolbar buttons.
+     * When a built-in button (e.g. ASK_ROVO, REFRESH) is clicked, the corresponding
+     * handler is invoked by the editor plugin.
+     */
+    editorToolbarHandlers?: EditorToolbarHandlers;
     /**
      * Ordered array of keys specifying which toolbar items to show and in what order.
      * The "More Options" dropdown is appended automatically based on `moreItems`.

package/dist/types-ts4.5/utils/utils.d.ts

@@ -1,13 +1,26 @@
-import type { ManifestEditorToolbarActions, EditorToolbarAction, BuiltinToolbarKey } from './types';
+import type { ManifestEditorToolbarActions, EditorToolbarAction, BuiltinToolbarKey, NativeEmbedParameterKey, NativeEmbedParameterValues, NativeEmbedParameters } from './types';
 /**
- * Generic utility to update parameters on a native embed extension node.
- * Preserves existing parameters and merges in the new ones.
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
  */
-export declare function updateParameters(current: {
-    attrs?: Record<string, unknown>;
-}, parameterUpdates: Record<string, unknown>): {
-    attrs: Record<string, unknown>;
-};
+export declare const getParameter: <TKey extends NativeEmbedParameterKey>(parameters: NativeEmbedParameters | undefined, key: TKey) => NativeEmbedParameterValues[TKey];
+/**
+ * Gets native-embed parameters as resolved values.
+ * When key is provided, returns that single resolved value.
+ * When key is omitted, returns all resolved parameter values.
+ */
+export declare function getParameters(parameters: NativeEmbedParameters | undefined): NativeEmbedParameterValues;
+export declare function getParameters<TKey extends NativeEmbedParameterKey>(parameters: NativeEmbedParameters | undefined, key: TKey): NativeEmbedParameterValues[TKey];
+/**
+ * Sets a single key in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export declare const setParameter: <TKey extends NativeEmbedParameterKey>(parameters: NativeEmbedParameters | undefined, update: Pick<NativeEmbedParameterValues, TKey>) => NativeEmbedParameters;
+/**
+ * Sets multiple keys in parameters.macroParams using wrapped { value } format.
+ * Returns a new parameters object.
+ */
+export declare const setParameters: (parameters: NativeEmbedParameters | undefined, updates: Partial<NativeEmbedParameterValues>) => NativeEmbedParameters;
 /**
  * Helper function to create a type-safe ManifestEditorToolbarActions config.
  * Automatically infers custom action keys from the customActions object.
@@ -21,10 +34,16 @@ export declare function updateParameters(current: {
  *   items: ['refresh', 'myAction', 'separator'], // 'myAction' is type-checked
  *   moreItems: ['copyLink', 'myAction', 'separator', 'delete'], // 'myAction' is type-checked
  * });
+ *
+ * // Or without custom actions:
+ * const simpleConfig = createEditorToolbarActions({
+ *   items: ['alignment', 'separator', 'openInNewWindow', 'editUrl'],
+ *   moreItems: ['delete'],
+ * });
  * ```
  */
-export declare const createEditorToolbarActions: <const TCustomActions extends Record<string, EditorToolbarAction>>(config: {
-    customActions: TCustomActions;
+export declare const createEditorToolbarActions: <const TCustomActions extends Record<string, EditorToolbarAction> = Record<string, EditorToolbarAction>>(config: {
+    customActions?: TCustomActions;
     items: (BuiltinToolbarKey | keyof TCustomActions)[];
     moreItems?: (BuiltinToolbarKey | keyof TCustomActions)[];
 }) => ManifestEditorToolbarActions<TCustomActions>;

package/package.json

@@ -24,9 +24,11 @@
 	],
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
-		"@atlaskit/icon": "^32.0.0",
+		"@atlaskit/editor-common": "^112.4.0",
+		"@atlaskit/editor-prosemirror": "^7.3.0",
+		"@atlaskit/icon": "^33.0.0",
 		"@babel/runtime": "^7.0.0",
-		"@compiled/react": "^0.18.6"
+		"@compiled/react": "^0.20.0"
 	},
 	"peerDependencies": {
 		"react": "^18.2.0"
@@ -77,7 +79,7 @@
 		}
 	},
 	"name": "@atlaskit/native-embeds-common",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "A shared package for native embeds to be used across experiences and plugin",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",