@atlaskit/native-embeds-common 0.0.0 → 0.1.1

package/CHANGELOG.md

@@ -1 +1,9 @@
-# @atlaskit/native-embeds-common
+# @atlaskit/native-embeds-common
+
+## 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

@@ -9,10 +9,59 @@ Object.defineProperty(exports, "ALIGNMENT_VALUES", {
     return _constants.ALIGNMENT_VALUES;
   }
 });
+Object.defineProperty(exports, "BUILTIN_TOOLBAR_KEYS", {
+  enumerable: true,
+  get: function get() {
+    return _constants.BUILTIN_TOOLBAR_KEYS;
+  }
+});
 Object.defineProperty(exports, "DEFAULT_ALIGNMENT", {
   enumerable: true,
   get: function get() {
     return _constants.DEFAULT_ALIGNMENT;
   }
 });
-var _constants = require("./constants");
+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, "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.setParameters;
+  }
+});
+var _constants = require("./utils/constants");
+var _utils = require("./utils/utils");

package/dist/cjs/utils/constants.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+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,
+  height: 600,
+  width: undefined
+};
+
+/**
+ * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
+ *
+ * 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/types.js

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

package/dist/cjs/utils/utils.js

@@ -0,0 +1,162 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+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;
+};
+
+/**
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
+ */
+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.
+ *
+ * @example
+ * ```ts
+ * const config = createEditorToolbarActions({
+ *   customActions: {
+ *     myAction: { type: 'button', key: 'myAction', ... },
+ *   },
+ *   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) {
+  return config;
+};

package/dist/es2019/index.js

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

package/dist/es2019/utils/constants.js

@@ -0,0 +1,34 @@
+// 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,
+  height: 600,
+  width: undefined
+};
+
+/**
+ * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
+ *
+ * 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/types.js

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

package/dist/es2019/utils/utils.js

@@ -0,0 +1,132 @@
+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;
+};
+
+/**
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
+ */
+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 {
+    ...currentParameters,
+    macroParams: {
+      ...currentMacroParams,
+      ...wrappedUpdates
+    }
+  };
+};
+
+/**
+ * Helper function to create a type-safe ManifestEditorToolbarActions config.
+ * Automatically infers custom action keys from the customActions object.
+ *
+ * @example
+ * ```ts
+ * const config = createEditorToolbarActions({
+ *   customActions: {
+ *     myAction: { type: 'button', key: 'myAction', ... },
+ *   },
+ *   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 +1,7 @@
-export { DEFAULT_ALIGNMENT, ALIGNMENT_VALUES } from './constants';
+// Re-export constants
+export { ALIGNMENT_VALUES, DEFAULT_ALIGNMENT, BUILTIN_TOOLBAR_KEYS, EDITOR_TOOLBAR_HANDLER_KEYS, NATIVE_EMBED_PARAMETER_DEFAULTS } from './utils/constants';
+
+// Re-export types
+
+// Re-export utilities
+export { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters } from './utils/utils';

package/dist/esm/utils/constants.js

@@ -0,0 +1,34 @@
+// 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,
+  height: 600,
+  width: undefined
+};
+
+/**
+ * Built-in keys that can be referenced in the `items` and `moreItems` arrays.
+ *
+ * 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/types.js

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

package/dist/esm/utils/utils.js

@@ -0,0 +1,153 @@
+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;
+};
+
+/**
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
+ */
+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.
+ *
+ * @example
+ * ```ts
+ * const config = createEditorToolbarActions({
+ *   customActions: {
+ *     myAction: { type: 'button', key: 'myAction', ... },
+ *   },
+ *   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) {
+  return config;
+};

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
-export { type AlignmentValue } from './types';
-export { DEFAULT_ALIGNMENT, ALIGNMENT_VALUES } from './constants';
+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 { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters, } from './utils/utils';

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

@@ -0,0 +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: 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/types.d.ts

@@ -0,0 +1,134 @@
+import type { ComponentType } from 'react';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
+import type { NewCoreIconProps } from '@atlaskit/icon';
+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;
+    height: number;
+    url?: string;
+    width?: number;
+};
+export type NativeEmbedParameterValue = {
+    value: string;
+};
+export type NativeEmbedParameters = {
+    macroParams?: {
+        alignment?: NativeEmbedParameterValue;
+        alwaysShowTitle?: 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.
+ */
+export type EditorToolbarButtonAction = {
+    /**
+     * Whether this action is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Handler key that maps to the actionHandlers config in the editor plugin.
+     * When clicked, the plugin looks up actionHandlers[handlerKey] and invokes it.
+     */
+    handlerKey: string;
+    /**
+     * Icon component to display.
+     */
+    icon: ComponentType<NewCoreIconProps>;
+    /**
+     * Unique key for this action, used for React keys and test IDs.
+     */
+    key: string;
+    /**
+     * Button label (used for tooltip and accessibility).
+     */
+    label: string;
+    /**
+     * Whether to show the label as text next to the icon.
+     * @default false
+     */
+    showTitle?: boolean;
+    type: 'button';
+};
+/**
+ * Union type for editor toolbar actions.
+ * 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.
+ *
+ * Use `customActions` map + `items` array to mix custom and built-in actions.
+ *
+ * @typeParam TCustomActions - The type of the customActions record. Keys are automatically
+ * inferred and used to type-check the `items` array.
+ */
+export type ManifestEditorToolbarActions<TCustomActions extends Record<string, EditorToolbarAction> = Record<string, EditorToolbarAction>> = {
+    /**
+     * Custom action definitions, keyed by unique identifier.
+     * 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`.
+     *
+     * Can include:
+     * - Built-in keys: 'refresh', 'embed', 'border', 'alignment', 'openInNewWindow'
+     * - 'separator' for visual separators between groups
+     * - Custom keys defined in `customActions`
+     */
+    items?: (BuiltinToolbarKey | keyof TCustomActions)[];
+    /**
+     * Ordered array of keys specifying which items appear in the "More Options" dropdown.
+     * When provided with at least one item, a separator and the dropdown are automatically
+     * appended to the toolbar. When omitted, the default set of dropdown items is used.
+     *
+     * Can include:
+     * - Built-in keys: 'alwaysShowTitle', 'setEmbedType', 'copyLink', 'delete'
+     * - 'separator' for visual separators between groups
+     * - Custom keys defined in `customActions` (shared with the toolbar)
+     */
+    moreItems?: (BuiltinToolbarKey | keyof TCustomActions)[];
+};

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

@@ -0,0 +1,49 @@
+import type { ManifestEditorToolbarActions, EditorToolbarAction, BuiltinToolbarKey, NativeEmbedParameterKey, NativeEmbedParameterValues, NativeEmbedParameters } from './types';
+/**
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
+ */
+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.
+ *
+ * @example
+ * ```ts
+ * const config = createEditorToolbarActions({
+ *   customActions: {
+ *     myAction: { type: 'button', key: 'myAction', ... },
+ *   },
+ *   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> = 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,2 +1,3 @@
-export { type AlignmentValue } from './types';
-export { DEFAULT_ALIGNMENT, ALIGNMENT_VALUES } from './constants';
+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 { createEditorToolbarActions, getParameter, getParameters, setParameter, setParameters, } from './utils/utils';

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

@@ -0,0 +1,46 @@
+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: 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/types.d.ts

@@ -0,0 +1,135 @@
+import type { ComponentType } from 'react';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
+import type { NewCoreIconProps } from '@atlaskit/icon';
+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;
+    height: number;
+    url?: string;
+    width?: number;
+};
+export type NativeEmbedParameterValue = {
+    value: string;
+};
+export type NativeEmbedParameters = {
+    macroParams?: {
+        alignment?: NativeEmbedParameterValue;
+        alwaysShowTitle?: 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.
+ */
+export type EditorToolbarButtonAction = {
+    /**
+     * Whether this action is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Handler key that maps to the actionHandlers config in the editor plugin.
+     * When clicked, the plugin looks up actionHandlers[handlerKey] and invokes it.
+     */
+    handlerKey: string;
+    /**
+     * Icon component to display.
+     */
+    icon: ComponentType<NewCoreIconProps>;
+    /**
+     * Unique key for this action, used for React keys and test IDs.
+     */
+    key: string;
+    /**
+     * Button label (used for tooltip and accessibility).
+     */
+    label: string;
+    /**
+     * Whether to show the label as text next to the icon.
+     * @default false
+     */
+    showTitle?: boolean;
+    type: 'button';
+};
+/**
+ * Union type for editor toolbar actions.
+ * 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.
+ *
+ * Use `customActions` map + `items` array to mix custom and built-in actions.
+ *
+ * @typeParam TCustomActions - The type of the customActions record. Keys are automatically
+ * inferred and used to type-check the `items` array.
+ */
+export type ManifestEditorToolbarActions<TCustomActions extends Record<string, EditorToolbarAction> = Record<string, EditorToolbarAction>> = {
+    /**
+     * Custom action definitions, keyed by unique identifier.
+     * 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`.
+     *
+     * Can include:
+     * - Built-in keys: 'refresh', 'embed', 'border', 'alignment', 'openInNewWindow'
+     * - 'separator' for visual separators between groups
+     * - Custom keys defined in `customActions`
+     */
+    items?: (BuiltinToolbarKey | keyof TCustomActions)[];
+    /**
+     * Ordered array of keys specifying which items appear in the "More Options" dropdown.
+     * When provided with at least one item, a separator and the dropdown are automatically
+     * appended to the toolbar. When omitted, the default set of dropdown items is used.
+     *
+     * Can include:
+     * - Built-in keys: 'alwaysShowTitle', 'setEmbedType', 'copyLink', 'delete'
+     * - 'separator' for visual separators between groups
+     * - Custom keys defined in `customActions` (shared with the toolbar)
+     */
+    moreItems?: (BuiltinToolbarKey | keyof TCustomActions)[];
+};

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

@@ -0,0 +1,49 @@
+import type { ManifestEditorToolbarActions, EditorToolbarAction, BuiltinToolbarKey, NativeEmbedParameterKey, NativeEmbedParameterValues, NativeEmbedParameters } from './types';
+/**
+ * Reads a value from extension parameters.macroParams by key.
+ * Supports both wrapped ({ value }) and unwrapped values.
+ */
+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.
+ *
+ * @example
+ * ```ts
+ * const config = createEditorToolbarActions({
+ *   customActions: {
+ *     myAction: { type: 'button', key: 'myAction', ... },
+ *   },
+ *   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> = Record<string, EditorToolbarAction>>(config: {
+    customActions?: TCustomActions;
+    items: (BuiltinToolbarKey | keyof TCustomActions)[];
+    moreItems?: (BuiltinToolbarKey | keyof TCustomActions)[];
+}) => ManifestEditorToolbarActions<TCustomActions>;

package/package.json

@@ -24,8 +24,10 @@
 	],
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
+		"@atlaskit/editor-common": "^112.0.0",
+		"@atlaskit/icon": "^32.0.0",
 		"@babel/runtime": "^7.0.0",
-		"@compiled/react": "^0.18.6"
+		"@compiled/react": "^0.20.0"
 	},
 	"peerDependencies": {
 		"react": "^18.2.0"
@@ -76,7 +78,7 @@
 		}
 	},
 	"name": "@atlaskit/native-embeds-common",
-	"version": "0.0.0",
+	"version": "0.1.1",
 	"description": "A shared package for native embeds to be used across experiences and plugin",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",

package/dist/cjs/constants.js

@@ -1,12 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DEFAULT_ALIGNMENT = exports.ALIGNMENT_VALUES = void 0;
-var ALIGNMENT_VALUES = exports.ALIGNMENT_VALUES = ['left', 'center', 'right', 'wrap-left', 'wrap-right'];
-
-/** Alignment value for native embed extension parameters. Single source of truth. */
-
-/** Default alignment when not set in parameters. */
-var DEFAULT_ALIGNMENT = exports.DEFAULT_ALIGNMENT = 'center';

package/dist/cjs/types.js

@@ -1 +0,0 @@
-"use strict";

package/dist/es2019/constants.js

@@ -1,6 +0,0 @@
-export const ALIGNMENT_VALUES = ['left', 'center', 'right', 'wrap-left', 'wrap-right'];
-
-/** Alignment value for native embed extension parameters. Single source of truth. */
-
-/** Default alignment when not set in parameters. */
-export const DEFAULT_ALIGNMENT = 'center';

package/dist/esm/constants.js

@@ -1,6 +0,0 @@
-export var ALIGNMENT_VALUES = ['left', 'center', 'right', 'wrap-left', 'wrap-right'];
-
-/** Alignment value for native embed extension parameters. Single source of truth. */
-
-/** Default alignment when not set in parameters. */
-export var DEFAULT_ALIGNMENT = 'center';

package/dist/types/constants.d.ts

@@ -1,5 +0,0 @@
-export declare const ALIGNMENT_VALUES: readonly ["left", "center", "right", "wrap-left", "wrap-right"];
-/** Alignment value for native embed extension parameters. Single source of truth. */
-export type AlignmentValue = (typeof ALIGNMENT_VALUES)[number];
-/** Default alignment when not set in parameters. */
-export declare const DEFAULT_ALIGNMENT: AlignmentValue;

package/dist/types/types.d.ts

@@ -1 +0,0 @@
-export type { AlignmentValue } from './constants';

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

@@ -1,11 +0,0 @@
-export declare const ALIGNMENT_VALUES: readonly [
-    "left",
-    "center",
-    "right",
-    "wrap-left",
-    "wrap-right"
-];
-/** Alignment value for native embed extension parameters. Single source of truth. */
-export type AlignmentValue = (typeof ALIGNMENT_VALUES)[number];
-/** Default alignment when not set in parameters. */
-export declare const DEFAULT_ALIGNMENT: AlignmentValue;

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

@@ -1 +0,0 @@
-export type { AlignmentValue } from './constants';