@elliemae/ds-dropdownmenu-v2 3.46.0-rc.0 → 3.46.0-rc.10

package/dist/esm/exported-related/conversion-utils/conversionHelpers.js

@@ -0,0 +1,109 @@
+import * as React from "react";
+import { MENU_ITEMS_TYPES } from "@elliemae/ds-menu-button";
+const isItemSingleOptions = (option) => option.type === "single";
+const isItemActionOptions = (option) => option.type === "action";
+const isItemSingleWithSubmenuOptions = (option) => option.type === "singleWithSubmenu";
+const isItemCheckboxOptions = (option) => option.type === "checkbox";
+const isItemSubmenuOptions = (option) => option.type === "submenu";
+const isItemSeparatorOptions = (option) => option.type === "separator";
+const isItemSectionOptions = (option) => option.type === "section";
+const isItemSkeletonOptions = (option) => option.type === "skeleton";
+const convertActionOptToMenuButtonItem = (option) => ({
+  type: MENU_ITEMS_TYPES.ACTIVABLE_ITEM,
+  label: option.label,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId,
+  minWidth: option?.minWidth,
+  disabled: option.disabled || option.applyAriaDisabled,
+  onClick: option.onClick,
+  onKeyDown: option.onKeyDown
+});
+const convertSingleSelectionOptToMenuButtonItem = (option) => ({
+  type: MENU_ITEMS_TYPES.SINGLE_SELECT_ITEM,
+  label: option.label,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId,
+  minWidth: option?.minWidth,
+  disabled: option.disabled || option.applyAriaDisabled,
+  onClick: option.onClick,
+  onKeyDown: option.onKeyDown
+});
+const convertCheckboxOptToMenuButtonItem = (option) => ({
+  type: MENU_ITEMS_TYPES.MULTIPLE_SELECT_ITEM,
+  label: option.label,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId,
+  minWidth: option?.minWidth,
+  disabled: option.disabled || option.applyAriaDisabled,
+  onClick: option.onClick,
+  onKeyDown: option.onKeyDown
+});
+const convertSeparatorOptToMenuButtonItem = (option) => ({
+  type: MENU_ITEMS_TYPES.SEPARATOR,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId
+});
+const convertSectionOptToMenuButtonItem = (option) => ({
+  type: MENU_ITEMS_TYPES.GROUP,
+  label: option.label,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId,
+  minWidth: option?.minWidth
+});
+const convertSkeletonOptToMenuButtonItem = (option) => ({
+  type: MENU_ITEMS_TYPES.SKELETON_ITEM,
+  dsId: option.dsId,
+  minWidth: option?.minWidth
+});
+const convertSingleWithSubmenuOptToMenuButtonItem = (option, convFn) => ({
+  type: MENU_ITEMS_TYPES.SINGLE_SELECT_WITH_SUBMENU_ITEM,
+  label: option.label,
+  subitems: option.options.map(convFn),
+  maxHeight: option.maxHeight,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId,
+  minWidth: option?.minWidth,
+  disabled: option.disabled || option.applyAriaDisabled,
+  onClick: option.onClick,
+  onKeyDown: option.onKeyDown
+});
+const convertSubmenuOptToMenuButtonItem = (option, convFn) => ({
+  type: MENU_ITEMS_TYPES.WITH_SUBMENU_ITEM,
+  label: option.label,
+  subitems: option.options.map(convFn),
+  maxHeight: option.maxHeight,
+  // DSDropdownMenuT common items properties
+  dsId: option.dsId,
+  minWidth: option?.minWidth,
+  disabled: option.disabled || option.applyAriaDisabled,
+  onClick: option.onClick,
+  onKeyDown: option.onKeyDown
+});
+const convertDropdownItemToMenuButtonItem = (option) => {
+  if (isItemActionOptions(option)) return convertActionOptToMenuButtonItem(option);
+  if (isItemSingleOptions(option)) return convertSingleSelectionOptToMenuButtonItem(option);
+  if (isItemSingleWithSubmenuOptions(option))
+    return convertSingleWithSubmenuOptToMenuButtonItem(option, convertDropdownItemToMenuButtonItem);
+  if (isItemCheckboxOptions(option)) return convertCheckboxOptToMenuButtonItem(option);
+  if (isItemSubmenuOptions(option))
+    return convertSubmenuOptToMenuButtonItem(option, convertDropdownItemToMenuButtonItem);
+  if (isItemSeparatorOptions(option)) return convertSeparatorOptToMenuButtonItem(option);
+  if (isItemSectionOptions(option)) return convertSectionOptToMenuButtonItem(option);
+  if (isItemSkeletonOptions(option)) return convertSkeletonOptToMenuButtonItem(option);
+  throw new Error("Unknown item type");
+};
+export {
+  convertActionOptToMenuButtonItem,
+  convertCheckboxOptToMenuButtonItem,
+  convertDropdownItemToMenuButtonItem,
+  convertSectionOptToMenuButtonItem,
+  convertSeparatorOptToMenuButtonItem,
+  convertSingleSelectionOptToMenuButtonItem,
+  convertSingleWithSubmenuOptToMenuButtonItem,
+  convertSkeletonOptToMenuButtonItem,
+  convertSubmenuOptToMenuButtonItem,
+  isItemSectionOptions,
+  isItemSingleWithSubmenuOptions,
+  isItemSubmenuOptions
+};
+//# sourceMappingURL=conversionHelpers.js.map

package/dist/esm/exported-related/conversion-utils/conversionHelpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/exported-related/conversion-utils/conversionHelpers.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { type DSMenuButtonT, MENU_ITEMS_TYPES } from '@elliemae/ds-menu-button';\nimport { type DSDropdownMenuT } from '../../react-desc-prop-types.js';\n\n/**\n * Type guard to check if the option is of type ItemSingleOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemSingleOptions, false otherwise.\n */\nconst isItemSingleOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemSingleOptions =>\n  option.type === 'single';\n\n/**\n * Type guard to check if the option is of type ItemActionOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemActionOptions, false otherwise.\n */\nconst isItemActionOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemActionOptions =>\n  option.type === 'action';\n\n/**\n * Type guard to check if the option is of type ItemSingleWithSubmenuOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemSingleWithSubmenuOptions, false otherwise.\n */\nexport const isItemSingleWithSubmenuOptions = (\n  option: DSDropdownMenuT.Item,\n): option is DSDropdownMenuT.ItemSingleWithSubmenuOptions => option.type === 'singleWithSubmenu';\n\n/**\n * Type guard to check if the option is of type ItemCheckboxOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemCheckboxOptions, false otherwise.\n */\nconst isItemCheckboxOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemCheckboxOptions =>\n  option.type === 'checkbox';\n\n/**\n * Type guard to check if the option is of type ItemSubmenuOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemSubmenuOptions, false otherwise.\n */\nexport const isItemSubmenuOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemSubmenuOptions =>\n  option.type === 'submenu';\n\n/**\n * Type guard to check if the option is of type ItemSeparatorOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemSeparatorOptions, false otherwise.\n */\nconst isItemSeparatorOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemSeparatorOptions =>\n  option.type === 'separator';\n\n/**\n * Type guard to check if the option is of type ItemSectionOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemSectionOptions, false otherwise.\n */\nexport const isItemSectionOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemSectionOptions =>\n  option.type === 'section';\n\n/**\n * Type guard to check if the option is of type ItemSkeletonOptions.\n * @param option - The option to check.\n * @returns True if the option is of type ItemSkeletonOptions, false otherwise.\n */\nconst isItemSkeletonOptions = (option: DSDropdownMenuT.Item): option is DSDropdownMenuT.ItemSkeletonOptions =>\n  option.type === 'skeleton';\n\n/**\n * Converts ItemActionOptions to DSMenuButtonT.ActivableItem.\n * @param option - The ItemActionOptions to convert.\n * @returns The converted ActivableItem.\n */\nexport const convertActionOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemActionOptions,\n): DSMenuButtonT.ActivableItem => ({\n  type: MENU_ITEMS_TYPES.ACTIVABLE_ITEM,\n  label: option.label,\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n  disabled: option.disabled || option.applyAriaDisabled,\n  onClick: option.onClick,\n  onKeyDown: option.onKeyDown,\n});\n\n/**\n * Converts ItemSingleOptions to DSMenuButtonT.SingleSelectItem.\n * @param option - The ItemSingleWithSubmenuOptions to convert.\n * @returns The converted SingleSelectWithSubmenuItem.\n */\nexport const convertSingleSelectionOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemSingleOptions,\n): DSMenuButtonT.SingleSelectItem => ({\n  type: MENU_ITEMS_TYPES.SINGLE_SELECT_ITEM,\n  label: option.label,\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n  disabled: option.disabled || option.applyAriaDisabled,\n  onClick: option.onClick,\n  onKeyDown: option.onKeyDown,\n});\n\n/**\n * Converts ItemCheckboxOptions to DSMenuButtonT.MultipleSelectItem.\n * @param option - The ItemCheckboxOptions to convert.\n * @returns The converted MultipleSelectItem.\n */\nexport const convertCheckboxOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemCheckboxOptions,\n): DSMenuButtonT.MultipleSelectItem => ({\n  type: MENU_ITEMS_TYPES.MULTIPLE_SELECT_ITEM,\n  label: option.label,\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n  disabled: option.disabled || option.applyAriaDisabled,\n  onClick: option.onClick,\n  onKeyDown: option.onKeyDown,\n});\n\n/**\n * Converts ItemSeparatorOptions to DSMenuButtonT.SeparatorItem.\n * @param option - The ItemSeparatorOptions to convert.\n * @returns The converted SeparatorItem.\n */\nexport const convertSeparatorOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemSeparatorOptions,\n): DSMenuButtonT.SeparatorItem => ({\n  type: MENU_ITEMS_TYPES.SEPARATOR,\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n});\n\n/**\n * Converts ItemSectionOptions to DSMenuButtonT.GroupItem.\n * @param option - The ItemSectionOptions to convert.\n * @returns The converted GroupItem.\n */\nexport const convertSectionOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemSectionOptions,\n): DSMenuButtonT.GroupItem => ({\n  type: MENU_ITEMS_TYPES.GROUP,\n  label: option.label,\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n});\n\n/**\n * Converts ItemSkeletonOptions to DSMenuButtonT.SkeletonItem.\n * @param option - The ItemSkeletonOptions to convert.\n * @returns The converted SkeletonItem.\n */\nexport const convertSkeletonOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemSkeletonOptions,\n): DSMenuButtonT.SkeletonItem => ({\n  type: MENU_ITEMS_TYPES.SKELETON_ITEM,\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n});\n\n// ========================================================================================\n// WithSubmenu conversion requires iterating nested options\n// to avoid \"cannot use before defined\", we inject the conversion as second parameter\n// ========================================================================================\n/**\n * Converts ItemSingleWithSubmenuOptions to DSMenuButtonT.SingleSelectWithSubmenuItem.\n * @param option - The ItemSingleWithSubmenuOptions to convert.\n * @param convFn - The conversion function to convert nested options - required to avoid circular dependencies.\n * @returns The converted SingleSelectWithSubmenuItem.\n */\nexport const convertSingleWithSubmenuOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemSingleWithSubmenuOptions,\n  convFn: (option: DSDropdownMenuT.Item) => DSMenuButtonT.MenuItemInterface,\n): DSMenuButtonT.SingleSelectWithSubmenuItem => ({\n  type: MENU_ITEMS_TYPES.SINGLE_SELECT_WITH_SUBMENU_ITEM,\n  label: option.label,\n  subitems: option.options.map(convFn),\n  maxHeight: option.maxHeight as DSMenuButtonT.SingleSelectWithSubmenuItem['maxHeight'],\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n  disabled: option.disabled || option.applyAriaDisabled,\n  onClick: option.onClick,\n  onKeyDown: option.onKeyDown,\n});\n/**\n * Converts ItemSubmenuOptions to DSMenuButtonT.WithSubmenuItem.\n * @param option - The ItemSubmenuOptions to convert.\n * @param convFn - The conversion function to convert nested options - required to avoid circular dependencies.\n * @returns The converted WithSubmenuItem.\n */\nexport const convertSubmenuOptToMenuButtonItem = (\n  option: DSDropdownMenuT.ItemSubmenuOptions,\n  convFn: (option: DSDropdownMenuT.Item) => DSMenuButtonT.MenuItemInterface,\n): DSMenuButtonT.WithSubmenuItem => ({\n  type: MENU_ITEMS_TYPES.WITH_SUBMENU_ITEM,\n  label: option.label,\n  subitems: option.options.map(convFn),\n  maxHeight: option.maxHeight as DSMenuButtonT.WithSubmenuItem['maxHeight'],\n  // DSDropdownMenuT common items properties\n  dsId: option.dsId,\n  minWidth: option?.minWidth as DSMenuButtonT.ActivableItem['minWidth'],\n  disabled: option.disabled || option.applyAriaDisabled,\n  onClick: option.onClick,\n  onKeyDown: option.onKeyDown,\n});\n\n/**\n * Converts a DSDropdownMenuT.Item to a DSMenuButtonT.MenuItemInterface.\n * @param option - The DSDropdownMenuT.Item to convert.\n * @returns The converted MenuItemInterface.\n */\nexport const convertDropdownItemToMenuButtonItem = (option: DSDropdownMenuT.Item): DSMenuButtonT.MenuItemInterface => {\n  if (isItemActionOptions(option)) return convertActionOptToMenuButtonItem(option);\n  // single selections\n  if (isItemSingleOptions(option)) return convertSingleSelectionOptToMenuButtonItem(option);\n  if (isItemSingleWithSubmenuOptions(option))\n    return convertSingleWithSubmenuOptToMenuButtonItem(option, convertDropdownItemToMenuButtonItem);\n  // multiple selections\n  if (isItemCheckboxOptions(option)) return convertCheckboxOptToMenuButtonItem(option);\n  // DDV2 didn't support multiple selections with submenu so we don't need to handle it\n  // only submenu\n  if (isItemSubmenuOptions(option))\n    return convertSubmenuOptToMenuButtonItem(option, convertDropdownItemToMenuButtonItem);\n  // separators, groups and skeletons\n  if (isItemSeparatorOptions(option)) return convertSeparatorOptToMenuButtonItem(option);\n  if (isItemSectionOptions(option)) return convertSectionOptToMenuButtonItem(option);\n  if (isItemSkeletonOptions(option)) return convertSkeletonOptToMenuButtonItem(option);\n\n  throw new Error('Unknown item type');\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAA6B,wBAAwB;AAQrD,MAAM,sBAAsB,CAAC,WAC3B,OAAO,SAAS;AAOlB,MAAM,sBAAsB,CAAC,WAC3B,OAAO,SAAS;AAOX,MAAM,iCAAiC,CAC5C,WAC2D,OAAO,SAAS;AAO7E,MAAM,wBAAwB,CAAC,WAC7B,OAAO,SAAS;AAOX,MAAM,uBAAuB,CAAC,WACnC,OAAO,SAAS;AAOlB,MAAM,yBAAyB,CAAC,WAC9B,OAAO,SAAS;AAOX,MAAM,uBAAuB,CAAC,WACnC,OAAO,SAAS;AAOlB,MAAM,wBAAwB,CAAC,WAC7B,OAAO,SAAS;AAOX,MAAM,mCAAmC,CAC9C,YACiC;AAAA,EACjC,MAAM,iBAAiB;AAAA,EACvB,OAAO,OAAO;AAAA;AAAA,EAEd,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AAAA,EAClB,UAAU,OAAO,YAAY,OAAO;AAAA,EACpC,SAAS,OAAO;AAAA,EAChB,WAAW,OAAO;AACpB;AAOO,MAAM,4CAA4C,CACvD,YACoC;AAAA,EACpC,MAAM,iBAAiB;AAAA,EACvB,OAAO,OAAO;AAAA;AAAA,EAEd,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AAAA,EAClB,UAAU,OAAO,YAAY,OAAO;AAAA,EACpC,SAAS,OAAO;AAAA,EAChB,WAAW,OAAO;AACpB;AAOO,MAAM,qCAAqC,CAChD,YACsC;AAAA,EACtC,MAAM,iBAAiB;AAAA,EACvB,OAAO,OAAO;AAAA;AAAA,EAEd,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AAAA,EAClB,UAAU,OAAO,YAAY,OAAO;AAAA,EACpC,SAAS,OAAO;AAAA,EAChB,WAAW,OAAO;AACpB;AAOO,MAAM,sCAAsC,CACjD,YACiC;AAAA,EACjC,MAAM,iBAAiB;AAAA;AAAA,EAEvB,MAAM,OAAO;AACf;AAOO,MAAM,oCAAoC,CAC/C,YAC6B;AAAA,EAC7B,MAAM,iBAAiB;AAAA,EACvB,OAAO,OAAO;AAAA;AAAA,EAEd,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AACpB;AAOO,MAAM,qCAAqC,CAChD,YACgC;AAAA,EAChC,MAAM,iBAAiB;AAAA,EACvB,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AACpB;AAYO,MAAM,8CAA8C,CACzD,QACA,YAC+C;AAAA,EAC/C,MAAM,iBAAiB;AAAA,EACvB,OAAO,OAAO;AAAA,EACd,UAAU,OAAO,QAAQ,IAAI,MAAM;AAAA,EACnC,WAAW,OAAO;AAAA;AAAA,EAElB,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AAAA,EAClB,UAAU,OAAO,YAAY,OAAO;AAAA,EACpC,SAAS,OAAO;AAAA,EAChB,WAAW,OAAO;AACpB;AAOO,MAAM,oCAAoC,CAC/C,QACA,YACmC;AAAA,EACnC,MAAM,iBAAiB;AAAA,EACvB,OAAO,OAAO;AAAA,EACd,UAAU,OAAO,QAAQ,IAAI,MAAM;AAAA,EACnC,WAAW,OAAO;AAAA;AAAA,EAElB,MAAM,OAAO;AAAA,EACb,UAAU,QAAQ;AAAA,EAClB,UAAU,OAAO,YAAY,OAAO;AAAA,EACpC,SAAS,OAAO;AAAA,EAChB,WAAW,OAAO;AACpB;AAOO,MAAM,sCAAsC,CAAC,WAAkE;AACpH,MAAI,oBAAoB,MAAM,EAAG,QAAO,iCAAiC,MAAM;AAE/E,MAAI,oBAAoB,MAAM,EAAG,QAAO,0CAA0C,MAAM;AACxF,MAAI,+BAA+B,MAAM;AACvC,WAAO,4CAA4C,QAAQ,mCAAmC;AAEhG,MAAI,sBAAsB,MAAM,EAAG,QAAO,mCAAmC,MAAM;AAGnF,MAAI,qBAAqB,MAAM;AAC7B,WAAO,kCAAkC,QAAQ,mCAAmC;AAEtF,MAAI,uBAAuB,MAAM,EAAG,QAAO,oCAAoC,MAAM;AACrF,MAAI,qBAAqB,MAAM,EAAG,QAAO,kCAAkC,MAAM;AACjF,MAAI,sBAAsB,MAAM,EAAG,QAAO,mCAAmC,MAAM;AAEnF,QAAM,IAAI,MAAM,mBAAmB;AACrC;",
+  "names": []
+}

package/dist/esm/exported-related/conversion-utils/getHumanReadableWarnings.js

@@ -0,0 +1,29 @@
+import * as React from "react";
+const getHumanReadableWarnings = (report) => {
+  const warnings = [];
+  if (report.detectedLostsOnConversion.render) {
+    warnings.push(
+      `- Encountered "render" in one or more options - the menu-button component is stricter on underlying html structure due to required accessibility, the conversion will ignore the "render", if you need it and you are sure it's a11y compliant you can implement it with the item "ItemRenderer" menu-button property instead`
+    );
+  }
+  if (report.detectedLostsOnConversion.ellipsis) {
+    warnings.push(
+      `- Encountered "ellipsis" right addon in one or more options - new designs doesn't support "ellipsis" config and instead provide exclusively "chevron"`
+    );
+  }
+  if (report.didFillGroupForSingleSelection) {
+    warnings.push(
+      `- Single select without a "section" BUT there is no mixing with "multi select" - the conversion filled a placeholder group`
+    );
+  }
+  if (report.wasFilledWithSkeletonDueToEmptyArrays) {
+    warnings.push(
+      `- some options/sub-options were empty - the conversion filled them with skeleton items (no empty options are allowed, at most loading skeletons)`
+    );
+  }
+  return warnings;
+};
+export {
+  getHumanReadableWarnings
+};
+//# sourceMappingURL=getHumanReadableWarnings.js.map

package/dist/esm/exported-related/conversion-utils/getHumanReadableWarnings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/exported-related/conversion-utils/getHumanReadableWarnings.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { type DSDropdownV2BridgeT } from './types.js';\n\n/**\n * given the report, it will return a human readable list of warnings\n * @param report - The report to get the warnings from.\n * @returns A list of human readable warnings.\n */\nexport const getHumanReadableWarnings = (report: DSDropdownV2BridgeT.ReportMutableT): string[] => {\n  const warnings: string[] = [];\n  if (report.detectedLostsOnConversion.render) {\n    warnings.push(\n      `- Encountered \"render\" in one or more options - the menu-button component is stricter on underlying html structure due to required accessibility, the conversion will ignore the \"render\", if you need it and you are sure it's a11y compliant you can implement it with the item \"ItemRenderer\" menu-button property instead`,\n    );\n  }\n  if (report.detectedLostsOnConversion.ellipsis) {\n    warnings.push(\n      `- Encountered \"ellipsis\" right addon in one or more options - new designs doesn't support \"ellipsis\" config and instead provide exclusively \"chevron\"`,\n    );\n  }\n  if (report.didFillGroupForSingleSelection) {\n    warnings.push(\n      `- Single select without a \"section\" BUT there is no mixing with \"multi select\" - the conversion filled a placeholder group`,\n    );\n  }\n  if (report.wasFilledWithSkeletonDueToEmptyArrays) {\n    warnings.push(\n      `- some options/sub-options were empty - the conversion filled them with skeleton items (no empty options are allowed, at most loading skeletons)`,\n    );\n  }\n  return warnings;\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACOhB,MAAM,2BAA2B,CAAC,WAAyD;AAChG,QAAM,WAAqB,CAAC;AAC5B,MAAI,OAAO,0BAA0B,QAAQ;AAC3C,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,0BAA0B,UAAU;AAC7C,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,gCAAgC;AACzC,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,uCAAuC;AAChD,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/exported-related/conversion-utils/index.js

@@ -0,0 +1,84 @@
+import * as React from "react";
+import {
+  convertDropdownItemToMenuButtonItem,
+  isItemSectionOptions,
+  isItemSingleWithSubmenuOptions,
+  isItemSubmenuOptions
+} from "./conversionHelpers.js";
+import { getHumanReadableWarnings } from "./getHumanReadableWarnings.js";
+import { mutableUpdateReportPerIteration, mutableUpdateReportPostIteration } from "./reportMutableUpdatesHelpers.js";
+const checkIfOptionsCanBeConverted = (options) => {
+  const mutableReport = {
+    unrecoverableConversion: false,
+    needsGracefullRecovery: false,
+    wasFilledWithSkeletonDueToEmptyArrays: false,
+    didFillGroupForSingleSelection: false,
+    detectedLostsOnConversion: {
+      ellipsis: false,
+      render: false
+    },
+    mutableReportsPerParentMap: {
+      "__first-level-root": {
+        lastSectionIndex: void 0,
+        adjacentGroupsReport: [],
+        hasMultipleSelections: false,
+        hasSingleSelections: false,
+        hasGrouplessSingleSelections: false,
+        isSingleWithoutMultipleAtAll: false,
+        hasEmptyOptions: false,
+        requiresHierarchicalGrouping: false,
+        gracefullRecoveries: { fillGroupForSingleSelection: false, fillLoading: false }
+      }
+    },
+    humanReadableWarnings: []
+  };
+  options.every((option, index) => {
+    mutableUpdateReportPerIteration({ mutableReport, option, index, parentDsId: "__first-level-root" });
+    if (mutableReport.unrecoverableConversion) return false;
+    return true;
+  });
+  mutableUpdateReportPostIteration({ mutableReport, options });
+  mutableReport.humanReadableWarnings = getHumanReadableWarnings(mutableReport);
+  return mutableReport;
+};
+const convertOptionsRecursive = (options) => {
+  const convertedOptions = [];
+  const groups = [];
+  options.forEach((option) => {
+    const convertedOption = convertDropdownItemToMenuButtonItem(option);
+    if (isItemSingleWithSubmenuOptions(option) || isItemSubmenuOptions(option)) {
+      const subitems = convertOptionsRecursive(option.options);
+      const typecastedOption = convertedOption;
+      typecastedOption.subitems = subitems;
+    }
+    if (isItemSectionOptions(option)) {
+      const typecastedOption = convertedOption;
+      const subitems = [...typecastedOption.subitems ?? []];
+      groups.push({ ...typecastedOption, subitems });
+      return;
+    }
+    if (groups.length > 0) {
+      const lastGroup = groups[groups.length - 1];
+      lastGroup.subitems.push(convertedOption);
+      return;
+    }
+    if (option.type === "single" || option.type === "singleWithSubmenu") {
+      groups.push({ type: "group", subitems: [convertedOption], dsId: `filled-group-starting-from-${option.dsId}` });
+      return;
+    }
+    convertedOptions.push(convertedOption);
+  });
+  convertedOptions.push(...groups);
+  return convertedOptions;
+};
+const checkAndConvertOptions = (options) => {
+  const report = checkIfOptionsCanBeConverted(options);
+  if (report.unrecoverableConversion) throw new Error("DSDropdownV2Bridge - critical configuration issues");
+  const convertedOptions = convertOptionsRecursive(options);
+  return { convertedOptions, report };
+};
+export {
+  checkAndConvertOptions,
+  checkIfOptionsCanBeConverted
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/exported-related/conversion-utils/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/exported-related/conversion-utils/index.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { type DSMenuButtonT } from '@elliemae/ds-menu-button';\nimport { type DSDropdownMenuT } from '../../react-desc-prop-types.js';\nimport { type DSDropdownV2BridgeT } from './types.js';\nimport {\n  convertDropdownItemToMenuButtonItem,\n  isItemSectionOptions,\n  isItemSingleWithSubmenuOptions,\n  isItemSubmenuOptions,\n} from './conversionHelpers.js';\nimport { getHumanReadableWarnings } from './getHumanReadableWarnings.js';\nimport { mutableUpdateReportPerIteration, mutableUpdateReportPostIteration } from './reportMutableUpdatesHelpers.js';\n\nexport const checkIfOptionsCanBeConverted = (\n  options: DSDropdownV2BridgeT.InternalProps['options'],\n): DSDropdownV2BridgeT.ReportMutableT => {\n  // this bridge component is not able to automatically bridge some configurations\n  //  in scenario where the component is not able to bridge the configuration we:\n  //  A - throw an error if it's a critical configuration\n  //  B - warn the configuration will be ignored if it's not critical\n  // we are going to have to iterate over the options (and the tree-like but not really a DSTree) `options`\n  // we should iterate only once and track all the potential violation in one go for performance reasons\n\n  const mutableReport: DSDropdownV2BridgeT.ReportMutableT = {\n    unrecoverableConversion: false,\n    needsGracefullRecovery: false,\n    wasFilledWithSkeletonDueToEmptyArrays: false,\n    didFillGroupForSingleSelection: false,\n    detectedLostsOnConversion: {\n      ellipsis: false,\n      render: false,\n    },\n    mutableReportsPerParentMap: {\n      '__first-level-root': {\n        lastSectionIndex: undefined,\n        adjacentGroupsReport: [],\n        hasMultipleSelections: false,\n        hasSingleSelections: false,\n        hasGrouplessSingleSelections: false,\n        isSingleWithoutMultipleAtAll: false,\n        hasEmptyOptions: false,\n        requiresHierarchicalGrouping: false,\n        gracefullRecoveries: { fillGroupForSingleSelection: false, fillLoading: false },\n      },\n    },\n    humanReadableWarnings: [],\n  };\n  // *******************************************************************************************\n  // \"options\" iteration\n  // *******************************************************************************************\n  // using \"every\" to short-circuit the iteration if we detect an unrecoverable issue\n  options.every((option, index) => {\n    mutableUpdateReportPerIteration({ mutableReport, option, index, parentDsId: '__first-level-root' });\n    if (mutableReport.unrecoverableConversion) return false;\n    return true;\n  });\n  mutableUpdateReportPostIteration({ mutableReport, options });\n  mutableReport.humanReadableWarnings = getHumanReadableWarnings(mutableReport);\n  return mutableReport;\n};\n\ntype CheckAndConvertOptionsRT = {\n  convertedOptions: DSMenuButtonT.MenuItemInterface[];\n  report: DSDropdownV2BridgeT.ReportMutableT;\n};\ntype GroupItemWithSubItems = DSMenuButtonT.GroupItem & { subitems: DSMenuButtonT.MenuItemInterface[] };\n\n/**\n * Converts dropdown menu items to menu button items, handling nested structures and grouping (including filling for missing groups if single selections are present).\n * @param options - The dropdown menu items to convert.\n * @returns The converted menu button items.\n */\nconst convertOptionsRecursive = (\n  options: DSDropdownMenuT.Item[] | readonly DSDropdownMenuT.Item[],\n): DSMenuButtonT.MenuItemInterface[] => {\n  const convertedOptions: DSMenuButtonT.MenuItemInterface[] = [];\n  const groups: GroupItemWithSubItems[] = [];\n  options.forEach((option) => {\n    const convertedOption = convertDropdownItemToMenuButtonItem(option);\n    if (isItemSingleWithSubmenuOptions(option) || isItemSubmenuOptions(option)) {\n      // we need to iterate over the subitems found at option.options\n      const subitems = convertOptionsRecursive(option.options);\n      const typecastedOption = convertedOption as\n        | DSMenuButtonT.WithSubmenuItem\n        | DSMenuButtonT.SingleSelectWithSubmenuItem;\n      typecastedOption.subitems = subitems;\n    }\n    // we need to unwind the sections\n    // step 1 - if we encounter a new section, we start tracking a new group\n    if (isItemSectionOptions(option)) {\n      const typecastedOption = convertedOption as DSMenuButtonT.GroupItem;\n      // step 2 - we assure subitems property is present as an array (per new API contract)\n      const subitems = [...((typecastedOption as GroupItemWithSubItems).subitems ?? [])];\n      // step 3 - we add the group to the groups array\n      groups.push({ ...typecastedOption, subitems });\n      return;\n    }\n    // here we can be in three scenarios:\n    //  A - a \"section\" is present and we are adding items to it\n    if (groups.length > 0) {\n      const lastGroup = groups[groups.length - 1];\n      lastGroup.subitems.push(convertedOption);\n      return;\n    }\n    //  B - we encountered a single select without a \"section\" BUT there is no mixing with \"multi select\" and we need to fill a placeholder group\n    if (option.type === 'single' || option.type === 'singleWithSubmenu') {\n      groups.push({ type: 'group', subitems: [convertedOption], dsId: `filled-group-starting-from-${option.dsId}` });\n      return;\n    }\n    //  C - we are adding items to the root level\n    convertedOptions.push(convertedOption);\n  });\n  convertedOptions.push(...groups);\n  return convertedOptions;\n};\n\nexport const checkAndConvertOptions = (\n  options: DSDropdownV2BridgeT.InternalProps['options'],\n): CheckAndConvertOptionsRT => {\n  const report = checkIfOptionsCanBeConverted(options);\n  if (report.unrecoverableConversion) throw new Error('DSDropdownV2Bridge - critical configuration issues');\n\n  const convertedOptions: DSMenuButtonT.MenuItemInterface[] = convertOptionsRecursive(options);\n\n  return { convertedOptions, report };\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACGvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,iCAAiC,wCAAwC;AAE3E,MAAM,+BAA+B,CAC1C,YACuC;AAQvC,QAAM,gBAAoD;AAAA,IACxD,yBAAyB;AAAA,IACzB,wBAAwB;AAAA,IACxB,uCAAuC;AAAA,IACvC,gCAAgC;AAAA,IAChC,2BAA2B;AAAA,MACzB,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,4BAA4B;AAAA,MAC1B,sBAAsB;AAAA,QACpB,kBAAkB;AAAA,QAClB,sBAAsB,CAAC;AAAA,QACvB,uBAAuB;AAAA,QACvB,qBAAqB;AAAA,QACrB,8BAA8B;AAAA,QAC9B,8BAA8B;AAAA,QAC9B,iBAAiB;AAAA,QACjB,8BAA8B;AAAA,QAC9B,qBAAqB,EAAE,6BAA6B,OAAO,aAAa,MAAM;AAAA,MAChF;AAAA,IACF;AAAA,IACA,uBAAuB,CAAC;AAAA,EAC1B;AAKA,UAAQ,MAAM,CAAC,QAAQ,UAAU;AAC/B,oCAAgC,EAAE,eAAe,QAAQ,OAAO,YAAY,qBAAqB,CAAC;AAClG,QAAI,cAAc,wBAAyB,QAAO;AAClD,WAAO;AAAA,EACT,CAAC;AACD,mCAAiC,EAAE,eAAe,QAAQ,CAAC;AAC3D,gBAAc,wBAAwB,yBAAyB,aAAa;AAC5E,SAAO;AACT;AAaA,MAAM,0BAA0B,CAC9B,YACsC;AACtC,QAAM,mBAAsD,CAAC;AAC7D,QAAM,SAAkC,CAAC;AACzC,UAAQ,QAAQ,CAAC,WAAW;AAC1B,UAAM,kBAAkB,oCAAoC,MAAM;AAClE,QAAI,+BAA+B,MAAM,KAAK,qBAAqB,MAAM,GAAG;AAE1E,YAAM,WAAW,wBAAwB,OAAO,OAAO;AACvD,YAAM,mBAAmB;AAGzB,uBAAiB,WAAW;AAAA,IAC9B;AAGA,QAAI,qBAAqB,MAAM,GAAG;AAChC,YAAM,mBAAmB;AAEzB,YAAM,WAAW,CAAC,GAAK,iBAA2C,YAAY,CAAC,CAAE;AAEjF,aAAO,KAAK,EAAE,GAAG,kBAAkB,SAAS,CAAC;AAC7C;AAAA,IACF;AAGA,QAAI,OAAO,SAAS,GAAG;AACrB,YAAM,YAAY,OAAO,OAAO,SAAS,CAAC;AAC1C,gBAAU,SAAS,KAAK,eAAe;AACvC;AAAA,IACF;AAEA,QAAI,OAAO,SAAS,YAAY,OAAO,SAAS,qBAAqB;AACnE,aAAO,KAAK,EAAE,MAAM,SAAS,UAAU,CAAC,eAAe,GAAG,MAAM,8BAA8B,OAAO,IAAI,GAAG,CAAC;AAC7G;AAAA,IACF;AAEA,qBAAiB,KAAK,eAAe;AAAA,EACvC,CAAC;AACD,mBAAiB,KAAK,GAAG,MAAM;AAC/B,SAAO;AACT;AAEO,MAAM,yBAAyB,CACpC,YAC6B;AAC7B,QAAM,SAAS,6BAA6B,OAAO;AACnD,MAAI,OAAO,wBAAyB,OAAM,IAAI,MAAM,oDAAoD;AAExG,QAAM,mBAAsD,wBAAwB,OAAO;AAE3F,SAAO,EAAE,kBAAkB,OAAO;AACpC;",
+  "names": []
+}

package/dist/esm/exported-related/conversion-utils/reportMutableUpdatesHelpers.js

@@ -0,0 +1,69 @@
+import * as React from "react";
+const mutableUpdateReportPostIteration = (args) => {
+  const { mutableReport, option, options } = args;
+  let currentLevelReport = mutableReport.mutableReportsPerParentMap["__first-level-root"];
+  if (option !== void 0) {
+    currentLevelReport = mutableReport.mutableReportsPerParentMap[option.dsId];
+    currentLevelReport.hasEmptyOptions = (option.type === "submenu" || option.type === "singleWithSubmenu") && option.options.length === 0;
+  } else {
+    currentLevelReport.hasEmptyOptions = options?.length === 0;
+  }
+  currentLevelReport.isSingleWithoutMultipleAtAll = currentLevelReport.hasSingleSelections && !currentLevelReport.hasMultipleSelections;
+  currentLevelReport.requiresHierarchicalGrouping = Object.keys(currentLevelReport.adjacentGroupsReport).length > 0;
+  mutableReport.unrecoverableConversion = currentLevelReport.requiresHierarchicalGrouping;
+  currentLevelReport.gracefullRecoveries = {
+    fillGroupForSingleSelection: currentLevelReport.hasGrouplessSingleSelections && currentLevelReport.isSingleWithoutMultipleAtAll,
+    fillLoading: currentLevelReport.hasEmptyOptions
+  };
+  mutableReport.needsGracefullRecovery = Object.values(currentLevelReport.gracefullRecoveries).some((v) => v === true);
+  mutableReport.didFillGroupForSingleSelection = mutableReport.didFillGroupForSingleSelection || currentLevelReport.gracefullRecoveries.fillGroupForSingleSelection;
+  mutableReport.wasFilledWithSkeletonDueToEmptyArrays = mutableReport.wasFilledWithSkeletonDueToEmptyArrays || currentLevelReport.gracefullRecoveries.fillLoading;
+};
+const mutableUpdateReportPerIteration = (iteration) => {
+  const { mutableReport, option, index, parentDsId } = iteration;
+  if (option.type === "singleWithSubmenu" || option.type === "submenu") {
+    mutableReport.mutableReportsPerParentMap[option.dsId] = {
+      lastSectionIndex: void 0,
+      adjacentGroupsReport: [],
+      hasMultipleSelections: false,
+      hasSingleSelections: false,
+      hasGrouplessSingleSelections: false,
+      isSingleWithoutMultipleAtAll: false,
+      hasEmptyOptions: false,
+      requiresHierarchicalGrouping: false,
+      gracefullRecoveries: { fillGroupForSingleSelection: false, fillLoading: false }
+    };
+    option.options.every((subOption, subIndex) => {
+      mutableUpdateReportPerIteration({
+        mutableReport,
+        option: subOption,
+        index: subIndex,
+        parentDsId: option.dsId
+      });
+      if (mutableReport.unrecoverableConversion) return false;
+      return true;
+    });
+    mutableUpdateReportPostIteration({ mutableReport, option });
+  }
+  const currentLevelReport = mutableReport.mutableReportsPerParentMap[parentDsId];
+  if (option?.rightAddon === "ellipsis") mutableReport.detectedLostsOnConversion.ellipsis = true;
+  if (option?.render) mutableReport.detectedLostsOnConversion.render = true;
+  if (option.type === "section") {
+    if (currentLevelReport?.lastSectionIndex === index - 1) {
+      currentLevelReport.adjacentGroupsReport.push(option.dsId);
+    }
+    currentLevelReport.lastSectionIndex = index;
+  }
+  if (option.type === "single" || option.type === "singleWithSubmenu") {
+    currentLevelReport.hasSingleSelections = true;
+    if (currentLevelReport?.lastSectionIndex === void 0) {
+      currentLevelReport.hasGrouplessSingleSelections = true;
+    }
+  }
+  if (option.type === "checkbox") currentLevelReport.hasMultipleSelections = true;
+};
+export {
+  mutableUpdateReportPerIteration,
+  mutableUpdateReportPostIteration
+};
+//# sourceMappingURL=reportMutableUpdatesHelpers.js.map

package/dist/esm/exported-related/conversion-utils/reportMutableUpdatesHelpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/exported-related/conversion-utils/reportMutableUpdatesHelpers.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable complexity */\nimport { type DSDropdownMenuT } from '../../react-desc-prop-types.js';\nimport { type DSDropdownV2BridgeT } from './types.js';\n\n// *******************************************************************************************\n// other props related potential issues\n// *******************************************************************************************\n// Critical failure:\n// 1 - props.HeaderComp - We support text only as \"groups\" for A11y limitations,\n//    it's a critical failure in the sense that we can't bridge it automatically\n//      but developers should be able to recover manually\n// Potentially gracefully recoverables\n// 2 - props.isLoading - We can fill some skeletons items?\n// this function should be called after the \"options\" iteration and takes care of the post iteration report updates\nexport const mutableUpdateReportPostIteration = (args: {\n  mutableReport: DSDropdownV2BridgeT.ReportMutableT;\n  option?: DSDropdownMenuT.Item;\n  options?: DSDropdownV2BridgeT.InternalProps['options'];\n}): void => {\n  const { mutableReport, option, options } = args;\n  // root level\n  let currentLevelReport = mutableReport.mutableReportsPerParentMap['__first-level-root'];\n  if (option !== undefined) {\n    currentLevelReport = mutableReport.mutableReportsPerParentMap[option.dsId];\n    currentLevelReport.hasEmptyOptions =\n      (option.type === 'submenu' || option.type === 'singleWithSubmenu') && option.options.length === 0;\n  } else {\n    currentLevelReport.hasEmptyOptions = options?.length === 0;\n  }\n\n  currentLevelReport.isSingleWithoutMultipleAtAll =\n    currentLevelReport.hasSingleSelections && !currentLevelReport.hasMultipleSelections;\n\n  currentLevelReport.requiresHierarchicalGrouping = Object.keys(currentLevelReport.adjacentGroupsReport).length > 0;\n  mutableReport.unrecoverableConversion = currentLevelReport.requiresHierarchicalGrouping;\n\n  currentLevelReport.gracefullRecoveries = {\n    fillGroupForSingleSelection:\n      currentLevelReport.hasGrouplessSingleSelections && currentLevelReport.isSingleWithoutMultipleAtAll,\n    fillLoading: currentLevelReport.hasEmptyOptions,\n  };\n  mutableReport.needsGracefullRecovery = Object.values(currentLevelReport.gracefullRecoveries).some((v) => v === true);\n  mutableReport.didFillGroupForSingleSelection =\n    mutableReport.didFillGroupForSingleSelection || currentLevelReport.gracefullRecoveries.fillGroupForSingleSelection;\n  mutableReport.wasFilledWithSkeletonDueToEmptyArrays =\n    mutableReport.wasFilledWithSkeletonDueToEmptyArrays || currentLevelReport.gracefullRecoveries.fillLoading;\n};\n\n// *******************************************************************************************\n// \"options\" related potential issues\n// *******************************************************************************************\n// Critical failure:\n// 1 - Two \"groups\" in a row\n// 2 - \"single select\" not preeceded by a \"group\"\n\n// Potentially gracefully recoverables:\n// 3 - single select without a \"group\" BUT there is no mix/match with \"multi select\"\n//   - We can:\n//    1 - fill a placeholder group\n//    2 - move the single select to the top level (opinionated but options within a group should to be adjacent)\n// 4 - empty options - We can fill some skeletons items?\nexport const mutableUpdateReportPerIteration = (iteration: {\n  mutableReport: DSDropdownV2BridgeT.ReportMutableT;\n  option: DSDropdownMenuT.Item;\n  index: number;\n  parentDsId: string;\n}): void => {\n  const { mutableReport, option, index, parentDsId } = iteration;\n  // if we detect a single select with submenus OR a submenu, we need to generate a nested mutable report for it\n  if (option.type === 'singleWithSubmenu' || option.type === 'submenu') {\n    mutableReport.mutableReportsPerParentMap[option.dsId] = {\n      lastSectionIndex: undefined,\n      adjacentGroupsReport: [],\n      hasMultipleSelections: false,\n      hasSingleSelections: false,\n      hasGrouplessSingleSelections: false,\n      isSingleWithoutMultipleAtAll: false,\n      hasEmptyOptions: false,\n      requiresHierarchicalGrouping: false,\n      gracefullRecoveries: { fillGroupForSingleSelection: false, fillLoading: false },\n    };\n    option.options.every((subOption, subIndex) => {\n      mutableUpdateReportPerIteration({\n        mutableReport,\n        option: subOption,\n        index: subIndex,\n        parentDsId: option.dsId,\n      });\n      if (mutableReport.unrecoverableConversion) return false;\n\n      return true;\n    });\n    mutableUpdateReportPostIteration({ mutableReport, option });\n  }\n  const currentLevelReport = mutableReport.mutableReportsPerParentMap[parentDsId];\n  // @ts-expect-error - DDV2 doesn't offer typeguards and it's not the bridge's responsibility to enforce it\n  if (option?.rightAddon === 'ellipsis') mutableReport.detectedLostsOnConversion.ellipsis = true;\n  if (option?.render) mutableReport.detectedLostsOnConversion.render = true;\n  if (option.type === 'section') {\n    // Two \"groups\" in a row\n    if (currentLevelReport?.lastSectionIndex === index - 1) {\n      currentLevelReport.adjacentGroupsReport.push(option.dsId);\n    }\n    currentLevelReport.lastSectionIndex = index;\n  }\n\n  if (option.type === 'single' || option.type === 'singleWithSubmenu') {\n    // single select without a \"section\" BUT there is no mixing with \"multi select\" - We can fill a placeholder section?\n    currentLevelReport.hasSingleSelections = true;\n    if (currentLevelReport?.lastSectionIndex === undefined) {\n      currentLevelReport.hasGrouplessSingleSelections = true;\n    }\n  }\n  if (option.type === 'checkbox') currentLevelReport.hasMultipleSelections = true;\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACchB,MAAM,mCAAmC,CAAC,SAIrC;AACV,QAAM,EAAE,eAAe,QAAQ,QAAQ,IAAI;AAE3C,MAAI,qBAAqB,cAAc,2BAA2B,oBAAoB;AACtF,MAAI,WAAW,QAAW;AACxB,yBAAqB,cAAc,2BAA2B,OAAO,IAAI;AACzE,uBAAmB,mBAChB,OAAO,SAAS,aAAa,OAAO,SAAS,wBAAwB,OAAO,QAAQ,WAAW;AAAA,EACpG,OAAO;AACL,uBAAmB,kBAAkB,SAAS,WAAW;AAAA,EAC3D;AAEA,qBAAmB,+BACjB,mBAAmB,uBAAuB,CAAC,mBAAmB;AAEhE,qBAAmB,+BAA+B,OAAO,KAAK,mBAAmB,oBAAoB,EAAE,SAAS;AAChH,gBAAc,0BAA0B,mBAAmB;AAE3D,qBAAmB,sBAAsB;AAAA,IACvC,6BACE,mBAAmB,gCAAgC,mBAAmB;AAAA,IACxE,aAAa,mBAAmB;AAAA,EAClC;AACA,gBAAc,yBAAyB,OAAO,OAAO,mBAAmB,mBAAmB,EAAE,KAAK,CAAC,MAAM,MAAM,IAAI;AACnH,gBAAc,iCACZ,cAAc,kCAAkC,mBAAmB,oBAAoB;AACzF,gBAAc,wCACZ,cAAc,yCAAyC,mBAAmB,oBAAoB;AAClG;AAeO,MAAM,kCAAkC,CAAC,cAKpC;AACV,QAAM,EAAE,eAAe,QAAQ,OAAO,WAAW,IAAI;AAErD,MAAI,OAAO,SAAS,uBAAuB,OAAO,SAAS,WAAW;AACpE,kBAAc,2BAA2B,OAAO,IAAI,IAAI;AAAA,MACtD,kBAAkB;AAAA,MAClB,sBAAsB,CAAC;AAAA,MACvB,uBAAuB;AAAA,MACvB,qBAAqB;AAAA,MACrB,8BAA8B;AAAA,MAC9B,8BAA8B;AAAA,MAC9B,iBAAiB;AAAA,MACjB,8BAA8B;AAAA,MAC9B,qBAAqB,EAAE,6BAA6B,OAAO,aAAa,MAAM;AAAA,IAChF;AACA,WAAO,QAAQ,MAAM,CAAC,WAAW,aAAa;AAC5C,sCAAgC;AAAA,QAC9B;AAAA,QACA,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,YAAY,OAAO;AAAA,MACrB,CAAC;AACD,UAAI,cAAc,wBAAyB,QAAO;AAElD,aAAO;AAAA,IACT,CAAC;AACD,qCAAiC,EAAE,eAAe,OAAO,CAAC;AAAA,EAC5D;AACA,QAAM,qBAAqB,cAAc,2BAA2B,UAAU;AAE9E,MAAI,QAAQ,eAAe,WAAY,eAAc,0BAA0B,WAAW;AAC1F,MAAI,QAAQ,OAAQ,eAAc,0BAA0B,SAAS;AACrE,MAAI,OAAO,SAAS,WAAW;AAE7B,QAAI,oBAAoB,qBAAqB,QAAQ,GAAG;AACtD,yBAAmB,qBAAqB,KAAK,OAAO,IAAI;AAAA,IAC1D;AACA,uBAAmB,mBAAmB;AAAA,EACxC;AAEA,MAAI,OAAO,SAAS,YAAY,OAAO,SAAS,qBAAqB;AAEnE,uBAAmB,sBAAsB;AACzC,QAAI,oBAAoB,qBAAqB,QAAW;AACtD,yBAAmB,+BAA+B;AAAA,IACpD;AAAA,EACF;AACA,MAAI,OAAO,SAAS,WAAY,oBAAmB,wBAAwB;AAC7E;",
+  "names": []
+}

package/dist/esm/exported-related/conversion-utils/types.js

@@ -0,0 +1,2 @@
+import * as React from "react";
+//# sourceMappingURL=types.js.map

package/dist/esm/exported-related/conversion-utils/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n"],
+  "mappings": "AAAA,YAAY,WAAW;",
+  "names": []
+}

package/dist/esm/index.js

@@ -1,25 +1,31 @@
 import * as React from "react";
+import { checkAndConvertOptions } from "./exported-related/conversion-utils/index.js";
 import { DSDropdownMenuV2, DSDropdownMenuV2WithSchema } from "./DSDropdownMenu.js";
-import { DSDropdownMenuName, DSDropdownMenuSlots, DSDropdownMenuPlacements } from "./exported-related/index.js";
+import { DropdownMenuDataTestId } from "./DropdownMenuDataTestId.js";
+import { DSDropdownMenuName, DSDropdownMenuPlacements, DSDropdownMenuSlots } from "./exported-related/index.js";
 import {
+  defaultProps,
+  DSDropdownMenuV2PropTypes,
   actionOptionSchema,
-  singleOptionSchema,
   checkboxOptionSchema,
-  submenuOptionSchema,
-  singleWithSubmenuOptionSchema,
-  separatorOptionSchema,
+  optionTypesSchemas,
   sectionOptionSchema,
-  optionTypesSchemas
+  separatorOptionSchema,
+  singleOptionSchema,
+  singleWithSubmenuOptionSchema,
+  submenuOptionSchema
 } from "./react-desc-prop-types.js";
-import { DropdownMenuDataTestId } from "./DropdownMenuDataTestId.js";
 export {
   DSDropdownMenuName,
   DSDropdownMenuPlacements,
   DSDropdownMenuSlots,
   DSDropdownMenuV2,
+  defaultProps as DSDropdownMenuV2DefaultProps,
+  DSDropdownMenuV2PropTypes,
   DSDropdownMenuV2WithSchema,
   DropdownMenuDataTestId,
   actionOptionSchema,
+  checkAndConvertOptions,
   checkboxOptionSchema,
   optionTypesSchemas,
   sectionOptionSchema,

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/index.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type {} from '@xstyled/system';\n\nexport { DSDropdownMenuV2, DSDropdownMenuV2WithSchema } from './DSDropdownMenu.js';\nexport { DSDropdownMenuName, DSDropdownMenuSlots, DSDropdownMenuPlacements } from './exported-related/index.js';\nexport {\n  actionOptionSchema,\n  singleOptionSchema,\n  checkboxOptionSchema,\n  submenuOptionSchema,\n  singleWithSubmenuOptionSchema,\n  separatorOptionSchema,\n  sectionOptionSchema,\n  optionTypesSchemas,\n} from './react-desc-prop-types.js';\nexport type { DSDropdownMenuT } from './react-desc-prop-types.js';\nexport { DropdownMenuDataTestId } from './DropdownMenuDataTestId.js';\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACEvB,SAAS,kBAAkB,kCAAkC;AAC7D,SAAS,oBAAoB,qBAAqB,gCAAgC;AAClF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,8BAA8B;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type {} from '@xstyled/system';\n\nexport { checkAndConvertOptions } from './exported-related/conversion-utils/index.js';\nexport { DSDropdownMenuV2, DSDropdownMenuV2WithSchema } from './DSDropdownMenu.js';\nexport { DropdownMenuDataTestId } from './DropdownMenuDataTestId.js';\nexport { DSDropdownMenuName, DSDropdownMenuPlacements, DSDropdownMenuSlots } from './exported-related/index.js';\nexport {\n  defaultProps as DSDropdownMenuV2DefaultProps,\n  DSDropdownMenuV2PropTypes,\n  actionOptionSchema,\n  checkboxOptionSchema,\n  optionTypesSchemas,\n  sectionOptionSchema,\n  separatorOptionSchema,\n  singleOptionSchema,\n  singleWithSubmenuOptionSchema,\n  submenuOptionSchema,\n} from './react-desc-prop-types.js';\nexport type { DSDropdownMenuT } from './react-desc-prop-types.js';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACEvB,SAAS,8BAA8B;AACvC,SAAS,kBAAkB,kCAAkC;AAC7D,SAAS,8BAA8B;AACvC,SAAS,oBAAoB,0BAA0B,2BAA2B;AAClF;AAAA,EACkB;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
   "names": []
 }

package/dist/types/exported-related/conversion-utils/conversionHelpers.d.ts

@@ -0,0 +1,76 @@
+import { type DSMenuButtonT } from '@elliemae/ds-menu-button';
+import { type DSDropdownMenuT } from '../../react-desc-prop-types.js';
+/**
+ * Type guard to check if the option is of type ItemSingleWithSubmenuOptions.
+ * @param option - The option to check.
+ * @returns True if the option is of type ItemSingleWithSubmenuOptions, false otherwise.
+ */
+export declare const isItemSingleWithSubmenuOptions: (option: DSDropdownMenuT.Item) => option is DSDropdownMenuT.ItemSingleWithSubmenuOptions;
+/**
+ * Type guard to check if the option is of type ItemSubmenuOptions.
+ * @param option - The option to check.
+ * @returns True if the option is of type ItemSubmenuOptions, false otherwise.
+ */
+export declare const isItemSubmenuOptions: (option: DSDropdownMenuT.Item) => option is DSDropdownMenuT.ItemSubmenuOptions;
+/**
+ * Type guard to check if the option is of type ItemSectionOptions.
+ * @param option - The option to check.
+ * @returns True if the option is of type ItemSectionOptions, false otherwise.
+ */
+export declare const isItemSectionOptions: (option: DSDropdownMenuT.Item) => option is DSDropdownMenuT.ItemSectionOptions;
+/**
+ * Converts ItemActionOptions to DSMenuButtonT.ActivableItem.
+ * @param option - The ItemActionOptions to convert.
+ * @returns The converted ActivableItem.
+ */
+export declare const convertActionOptToMenuButtonItem: (option: DSDropdownMenuT.ItemActionOptions) => DSMenuButtonT.ActivableItem;
+/**
+ * Converts ItemSingleOptions to DSMenuButtonT.SingleSelectItem.
+ * @param option - The ItemSingleWithSubmenuOptions to convert.
+ * @returns The converted SingleSelectWithSubmenuItem.
+ */
+export declare const convertSingleSelectionOptToMenuButtonItem: (option: DSDropdownMenuT.ItemSingleOptions) => DSMenuButtonT.SingleSelectItem;
+/**
+ * Converts ItemCheckboxOptions to DSMenuButtonT.MultipleSelectItem.
+ * @param option - The ItemCheckboxOptions to convert.
+ * @returns The converted MultipleSelectItem.
+ */
+export declare const convertCheckboxOptToMenuButtonItem: (option: DSDropdownMenuT.ItemCheckboxOptions) => DSMenuButtonT.MultipleSelectItem;
+/**
+ * Converts ItemSeparatorOptions to DSMenuButtonT.SeparatorItem.
+ * @param option - The ItemSeparatorOptions to convert.
+ * @returns The converted SeparatorItem.
+ */
+export declare const convertSeparatorOptToMenuButtonItem: (option: DSDropdownMenuT.ItemSeparatorOptions) => DSMenuButtonT.SeparatorItem;
+/**
+ * Converts ItemSectionOptions to DSMenuButtonT.GroupItem.
+ * @param option - The ItemSectionOptions to convert.
+ * @returns The converted GroupItem.
+ */
+export declare const convertSectionOptToMenuButtonItem: (option: DSDropdownMenuT.ItemSectionOptions) => DSMenuButtonT.GroupItem;
+/**
+ * Converts ItemSkeletonOptions to DSMenuButtonT.SkeletonItem.
+ * @param option - The ItemSkeletonOptions to convert.
+ * @returns The converted SkeletonItem.
+ */
+export declare const convertSkeletonOptToMenuButtonItem: (option: DSDropdownMenuT.ItemSkeletonOptions) => DSMenuButtonT.SkeletonItem;
+/**
+ * Converts ItemSingleWithSubmenuOptions to DSMenuButtonT.SingleSelectWithSubmenuItem.
+ * @param option - The ItemSingleWithSubmenuOptions to convert.
+ * @param convFn - The conversion function to convert nested options - required to avoid circular dependencies.
+ * @returns The converted SingleSelectWithSubmenuItem.
+ */
+export declare const convertSingleWithSubmenuOptToMenuButtonItem: (option: DSDropdownMenuT.ItemSingleWithSubmenuOptions, convFn: (option: DSDropdownMenuT.Item) => DSMenuButtonT.MenuItemInterface) => DSMenuButtonT.SingleSelectWithSubmenuItem;
+/**
+ * Converts ItemSubmenuOptions to DSMenuButtonT.WithSubmenuItem.
+ * @param option - The ItemSubmenuOptions to convert.
+ * @param convFn - The conversion function to convert nested options - required to avoid circular dependencies.
+ * @returns The converted WithSubmenuItem.
+ */
+export declare const convertSubmenuOptToMenuButtonItem: (option: DSDropdownMenuT.ItemSubmenuOptions, convFn: (option: DSDropdownMenuT.Item) => DSMenuButtonT.MenuItemInterface) => DSMenuButtonT.WithSubmenuItem;
+/**
+ * Converts a DSDropdownMenuT.Item to a DSMenuButtonT.MenuItemInterface.
+ * @param option - The DSDropdownMenuT.Item to convert.
+ * @returns The converted MenuItemInterface.
+ */
+export declare const convertDropdownItemToMenuButtonItem: (option: DSDropdownMenuT.Item) => DSMenuButtonT.MenuItemInterface;

package/dist/types/exported-related/conversion-utils/getHumanReadableWarnings.d.ts

@@ -0,0 +1,7 @@
+import { type DSDropdownV2BridgeT } from './types.js';
+/**
+ * given the report, it will return a human readable list of warnings
+ * @param report - The report to get the warnings from.
+ * @returns A list of human readable warnings.
+ */
+export declare const getHumanReadableWarnings: (report: DSDropdownV2BridgeT.ReportMutableT) => string[];

package/dist/types/exported-related/conversion-utils/index.d.ts

@@ -0,0 +1,9 @@
+import { type DSMenuButtonT } from '@elliemae/ds-menu-button';
+import { type DSDropdownV2BridgeT } from './types.js';
+export declare const checkIfOptionsCanBeConverted: (options: DSDropdownV2BridgeT.InternalProps['options']) => DSDropdownV2BridgeT.ReportMutableT;
+type CheckAndConvertOptionsRT = {
+    convertedOptions: DSMenuButtonT.MenuItemInterface[];
+    report: DSDropdownV2BridgeT.ReportMutableT;
+};
+export declare const checkAndConvertOptions: (options: DSDropdownV2BridgeT.InternalProps['options']) => CheckAndConvertOptionsRT;
+export {};

package/dist/types/exported-related/conversion-utils/reportMutableUpdatesHelpers.d.ts

@@ -0,0 +1,13 @@
+import { type DSDropdownMenuT } from '../../react-desc-prop-types.js';
+import { type DSDropdownV2BridgeT } from './types.js';
+export declare const mutableUpdateReportPostIteration: (args: {
+    mutableReport: DSDropdownV2BridgeT.ReportMutableT;
+    option?: DSDropdownMenuT.Item;
+    options?: DSDropdownV2BridgeT.InternalProps['options'];
+}) => void;
+export declare const mutableUpdateReportPerIteration: (iteration: {
+    mutableReport: DSDropdownV2BridgeT.ReportMutableT;
+    option: DSDropdownMenuT.Item;
+    index: number;
+    parentDsId: string;
+}) => void;

package/dist/types/exported-related/conversion-utils/types.d.ts

@@ -0,0 +1,37 @@
+import type { DSDropdownMenuT } from '../../react-desc-prop-types.js';
+export declare namespace DSDropdownV2BridgeT {
+    type AdjacentGroupsReportT = string[];
+    type GracefullRecoveriesT = {
+        fillGroupForSingleSelection: boolean;
+        fillLoading: boolean;
+    };
+    type DsIdToValueMapT = Record<string, unknown>;
+    type ReportPerLevelT = {
+        lastSectionIndex?: number;
+        adjacentGroupsReport: AdjacentGroupsReportT;
+        hasMultipleSelections: boolean;
+        hasSingleSelections: boolean;
+        hasGrouplessSingleSelections: boolean;
+        isSingleWithoutMultipleAtAll: boolean;
+        hasEmptyOptions: boolean;
+        requiresHierarchicalGrouping: boolean;
+        gracefullRecoveries: GracefullRecoveriesT;
+    };
+    type ReportMutableT = {
+        unrecoverableConversion: boolean;
+        needsGracefullRecovery: boolean;
+        wasFilledWithSkeletonDueToEmptyArrays: boolean;
+        didFillGroupForSingleSelection: boolean;
+        detectedLostsOnConversion: {
+            ellipsis: boolean;
+            render: boolean;
+        };
+        mutableReportsPerParentMap: Record<string, ReportPerLevelT>;
+        humanReadableWarnings: string[];
+    };
+    type RequiredProps = DSDropdownMenuT.RequiredProps;
+    type DefaultProps = DSDropdownMenuT.DefaultProps;
+    type OptionalProps = DSDropdownMenuT.OptionalProps;
+    type Props = DSDropdownMenuT.Props;
+    type InternalProps = DSDropdownMenuT.InternalProps;
+}

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
+export { checkAndConvertOptions } from './exported-related/conversion-utils/index.js';
 export { DSDropdownMenuV2, DSDropdownMenuV2WithSchema } from './DSDropdownMenu.js';
-export { DSDropdownMenuName, DSDropdownMenuSlots, DSDropdownMenuPlacements } from './exported-related/index.js';
-export { actionOptionSchema, singleOptionSchema, checkboxOptionSchema, submenuOptionSchema, singleWithSubmenuOptionSchema, separatorOptionSchema, sectionOptionSchema, optionTypesSchemas, } from './react-desc-prop-types.js';
-export type { DSDropdownMenuT } from './react-desc-prop-types.js';
 export { DropdownMenuDataTestId } from './DropdownMenuDataTestId.js';
+export { DSDropdownMenuName, DSDropdownMenuPlacements, DSDropdownMenuSlots } from './exported-related/index.js';
+export { defaultProps as DSDropdownMenuV2DefaultProps, DSDropdownMenuV2PropTypes, actionOptionSchema, checkboxOptionSchema, optionTypesSchemas, sectionOptionSchema, separatorOptionSchema, singleOptionSchema, singleWithSubmenuOptionSchema, submenuOptionSchema, } from './react-desc-prop-types.js';
+export type { DSDropdownMenuT } from './react-desc-prop-types.js';