@elliemae/ds-left-navigation 3.80.0-next.58 → 3.80.0-next.60

package/dist/cjs/exported-related/conversion-utils/conversionConstants.js

@@ -0,0 +1,64 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var conversionConstants_exports = {};
+__export(conversionConstants_exports, {
+  DRILLDOWN_TYPES: () => DRILLDOWN_TYPES,
+  DROPPED_TYPE_CODES: () => DROPPED_TYPE_CODES,
+  HEADER_TYPES: () => HEADER_TYPES,
+  LEAF_TYPES: () => LEAF_TYPES,
+  NO_RAIL_TYPES: () => NO_RAIL_TYPES,
+  OUT_OF_THE_BOX_TYPES: () => OUT_OF_THE_BOX_TYPES,
+  getOwn: () => getOwn
+});
+module.exports = __toCommonJS(conversionConstants_exports);
+var React = __toESM(require("react"));
+var import_constants = require("../../constants/index.js");
+const DRILLDOWN_TYPES = [
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_CONTROLLED_DRILLDOWN,
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_UNCONTROLLED_DRILLDOWN
+];
+const LEAF_TYPES = [
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_LINK,
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_TEXT_LABEL,
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_WITH_DATE
+];
+const getOwn = (map, key) => Object.prototype.hasOwnProperty.call(map, key) ? map[key] : void 0;
+const HEADER_TYPES = [import_constants.ITEM_TYPES.LEFT_NAV_ITEM_HEADER, ...LEAF_TYPES];
+const OUT_OF_THE_BOX_TYPES = Object.values(import_constants.ITEM_TYPES);
+const NO_RAIL_TYPES = [
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_TEXT_LABEL,
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_WITH_DATE,
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_CONTROLLED_DRILLDOWN,
+  import_constants.ITEM_TYPES.LEFT_NAV_ITEM_UNCONTROLLED_DRILLDOWN
+];
+const DROPPED_TYPE_CODES = {
+  [import_constants.ITEM_TYPES.LEFT_NAV_ITEM_HEADER]: ["header-item-dropped", "Header items are not part of the list"],
+  [import_constants.ITEM_TYPES.LEFT_NAV_ITEM_SKELETON]: ["skeleton-dropped", "Skeleton items are not supported"]
+};
+//# sourceMappingURL=conversionConstants.js.map

package/dist/cjs/exported-related/conversion-utils/conversionConstants.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/conversionConstants.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { ITEM_TYPES } from '../../constants/index.js';\n\nexport const DRILLDOWN_TYPES: string[] = [\n  ITEM_TYPES.LEFT_NAV_ITEM_CONTROLLED_DRILLDOWN,\n  ITEM_TYPES.LEFT_NAV_ITEM_UNCONTROLLED_DRILLDOWN,\n];\nexport const LEAF_TYPES: string[] = [\n  ITEM_TYPES.LEFT_NAV_ITEM_LINK,\n  ITEM_TYPES.LEFT_NAV_ITEM_TEXT_LABEL,\n  ITEM_TYPES.LEFT_NAV_ITEM_WITH_DATE,\n];\n\n/**\n * Reads only own entries, so ids and types like \"constructor\" or \"toString\" do not resolve to inherited members.\n */\nexport const getOwn = <T>(map: Record<string, T>, key: string): T | undefined =>\n  Object.prototype.hasOwnProperty.call(map, key) ? map[key] : undefined;\n\n/**\n * The types a `HeaderComponent` can have and still be the tree header: a header, or a leaf when the header is only a link.\n */\nexport const HEADER_TYPES: string[] = [ITEM_TYPES.LEFT_NAV_ITEM_HEADER, ...LEAF_TYPES];\n\nexport const OUT_OF_THE_BOX_TYPES: string[] = Object.values(ITEM_TYPES);\n\n/**\n * LeftNavigation renders no `CollapsedComponent` for these types (it forces it to null), so they were never in its rail.\n */\nexport const NO_RAIL_TYPES: string[] = [\n  ITEM_TYPES.LEFT_NAV_ITEM_TEXT_LABEL,\n  ITEM_TYPES.LEFT_NAV_ITEM_WITH_DATE,\n  ITEM_TYPES.LEFT_NAV_ITEM_CONTROLLED_DRILLDOWN,\n  ITEM_TYPES.LEFT_NAV_ITEM_UNCONTROLLED_DRILLDOWN,\n];\n\nexport const DROPPED_TYPE_CODES = {\n  [ITEM_TYPES.LEFT_NAV_ITEM_HEADER]: ['header-item-dropped', 'Header items are not part of the list'],\n  [ITEM_TYPES.LEFT_NAV_ITEM_SKELETON]: ['skeleton-dropped', 'Skeleton items are not supported'],\n} as const;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAA2B;AAEpB,MAAM,kBAA4B;AAAA,EACvC,4BAAW;AAAA,EACX,4BAAW;AACb;AACO,MAAM,aAAuB;AAAA,EAClC,4BAAW;AAAA,EACX,4BAAW;AAAA,EACX,4BAAW;AACb;AAKO,MAAM,SAAS,CAAI,KAAwB,QAChD,OAAO,UAAU,eAAe,KAAK,KAAK,GAAG,IAAI,IAAI,GAAG,IAAI;AAKvD,MAAM,eAAyB,CAAC,4BAAW,sBAAsB,GAAG,UAAU;AAE9E,MAAM,uBAAiC,OAAO,OAAO,2BAAU;AAK/D,MAAM,gBAA0B;AAAA,EACrC,4BAAW;AAAA,EACX,4BAAW;AAAA,EACX,4BAAW;AAAA,EACX,4BAAW;AACb;AAEO,MAAM,qBAAqB;AAAA,EAChC,CAAC,4BAAW,oBAAoB,GAAG,CAAC,uBAAuB,uCAAuC;AAAA,EAClG,CAAC,4BAAW,sBAAsB,GAAG,CAAC,oBAAoB,kCAAkC;AAC9F;",
+  "names": []
+}

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

@@ -0,0 +1,192 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var conversionHelpers_exports = {};
+__export(conversionHelpers_exports, {
+  convertHeader: () => convertHeader,
+  convertList: () => convertList
+});
+module.exports = __toCommonJS(conversionHelpers_exports);
+var React = __toESM(require("react"));
+var import_ds_left_navigation_tree = require("@elliemae/ds-left-navigation-tree");
+var import_constants = require("../../constants/index.js");
+var import_conversionConstants = require("./conversionConstants.js");
+var import_convertItemOpts = require("./convertItemOpts.js");
+var import_report = require("./report.js");
+const convertCollapsed = (item, report) => {
+  if (!item.CollapsedComponent || import_conversionConstants.NO_RAIL_TYPES.includes(item.type ?? "")) return {};
+  (0, import_report.markLost)(report, {
+    code: "collapsed-component-ctx",
+    dsId: item.dsId ?? "",
+    message: "CollapsedComponent is kept, it only receives { item }"
+  });
+  return { CollapsedComponent: item.CollapsedComponent };
+};
+const joinSectionLabel = (label, rightSection) => typeof label === "string" && typeof rightSection === "string" ? `${label}, ${rightSection}` : label;
+const convertSubmenu = (item, args) => {
+  const { report, childrenByParentId, recurse } = args;
+  const dsId = item.dsId ?? "";
+  const children = (0, import_conversionConstants.getOwn)(childrenByParentId, dsId);
+  if (!children)
+    (0, import_report.markLost)(report, { code: "submenu-without-children", dsId, message: "No entry in childrenByParentId" });
+  return {
+    dsId,
+    type: import_ds_left_navigation_tree.LEFT_NAVIGATION_TREE_ITEM_TYPES.PARENT,
+    ...convertCollapsed(item, report),
+    itemOpts: { ...(0, import_convertItemOpts.convertItemOpts)({ item, report, kind: "submenu" }), items: recurse(children ?? []) }
+  };
+};
+const convertDrilldown = (item, args) => {
+  const { report, recurse } = args;
+  const dsId = item.dsId ?? "";
+  const { startOpened, isOpened, items = [] } = item.itemOpts ?? {};
+  const opts = (0, import_convertItemOpts.convertItemOpts)({ item, report, kind: "drilldown" });
+  const isControlled = item.type === import_constants.ITEM_TYPES.LEFT_NAV_ITEM_CONTROLLED_DRILLDOWN;
+  return {
+    dsId,
+    type: import_ds_left_navigation_tree.LEFT_NAVIGATION_TREE_ITEM_TYPES.PARENT,
+    ...convertCollapsed(item, report),
+    itemOpts: {
+      ...opts,
+      ...isControlled && { isOpened: !!isOpened },
+      ...!isControlled && startOpened !== void 0 && { startOpened },
+      items: recurse(items)
+    }
+  };
+};
+const convertOne = (item, args) => {
+  const { report } = args;
+  const dsId = item.dsId ?? "";
+  const { type } = item;
+  if (typeof type !== "string") {
+    (0, import_report.markLost)(report, {
+      code: "custom-component-dropped",
+      dsId,
+      message: "Items with a custom Component are not supported"
+    });
+    return null;
+  }
+  if (import_conversionConstants.LEAF_TYPES.includes(type)) {
+    return {
+      dsId,
+      type: import_ds_left_navigation_tree.LEFT_NAVIGATION_TREE_ITEM_TYPES.LEAF,
+      ...convertCollapsed(item, report),
+      itemOpts: (0, import_convertItemOpts.convertItemOpts)({ item, report, kind: "leaf" })
+    };
+  }
+  if (type === import_constants.ITEM_TYPES.LEFT_NAV_ITEM_SUBMENU) return convertSubmenu(item, args);
+  if (import_conversionConstants.DRILLDOWN_TYPES.includes(type)) return convertDrilldown(item, args);
+  const [code, message] = (0, import_conversionConstants.getOwn)(import_conversionConstants.DROPPED_TYPE_CODES, type) ?? [
+    "unknown-type-dropped",
+    `Type "${type}" is not out of the box`
+  ];
+  (0, import_report.markLost)(report, { code, dsId, message });
+  return null;
+};
+const convertSection = (item, report, items) => {
+  const { label, labelRightSection } = item.itemOpts ?? {};
+  const joinable = typeof label === "string" && typeof labelRightSection === "string";
+  const opts = (0, import_convertItemOpts.convertItemOpts)({ item, report, kind: "section", joinable });
+  return {
+    dsId: item.dsId ?? "",
+    type: import_ds_left_navigation_tree.LEFT_NAVIGATION_TREE_ITEM_TYPES.SECTION,
+    itemOpts: {
+      ...opts,
+      label: joinSectionLabel(label, labelRightSection),
+      items
+    }
+  };
+};
+const convertList = (args) => {
+  const { list, isRoot, report, ancestors = [] } = args;
+  const converted = [];
+  let sectionItems = null;
+  list.forEach((item) => {
+    const { type, dsId = "" } = item;
+    const isSection = type === import_constants.ITEM_TYPES.LEFT_NAV_ITEM_SECTION;
+    if (isSection || type === import_constants.ITEM_TYPES.LEFT_NAV_ITEM_SEPARATOR) {
+      if (!isRoot) {
+        (0, import_report.markLost)(report, {
+          code: "section-in-nested-list-dropped",
+          dsId,
+          message: "Sections and separators are only supported at the root level"
+        });
+        return;
+      }
+      sectionItems = isSection ? [] : null;
+      converted.push(sectionItems ? convertSection(item, report, sectionItems) : { dsId, type: import_ds_left_navigation_tree.LEFT_NAVIGATION_TREE_ITEM_TYPES.SEPARATOR });
+      return;
+    }
+    const ancestorKey = dsId || item;
+    const isOwnAncestor = ancestors.includes(ancestorKey);
+    const convertedItem = convertOne(item, {
+      report,
+      childrenByParentId: args.childrenByParentId,
+      recurse: (children) => isOwnAncestor ? [] : convertList({ ...args, list: children, isRoot: false, ancestors: [...ancestors, ancestorKey] })
+    });
+    if (!convertedItem) return;
+    if (sectionItems) sectionItems.push(convertedItem);
+    else converted.push(convertedItem);
+  });
+  return converted;
+};
+const convertHeader = (header, report) => {
+  if (header.type === import_constants.ITEM_TYPES.LEFT_NAV_ITEM_SKELETON) {
+    const [code, message] = import_conversionConstants.DROPPED_TYPE_CODES[import_constants.ITEM_TYPES.LEFT_NAV_ITEM_SKELETON];
+    (0, import_report.markLost)(report, { code, dsId: header.dsId ?? "", message });
+    return null;
+  }
+  if (typeof header.type !== "string" || !import_conversionConstants.OUT_OF_THE_BOX_TYPES.includes(header.type)) {
+    (0, import_report.markLost)(report, {
+      code: "custom-component-dropped",
+      dsId: header.dsId ?? "",
+      message: "A HeaderComponent with a custom Component is not supported"
+    });
+    return null;
+  }
+  if (!import_conversionConstants.HEADER_TYPES.includes(header.type)) {
+    (0, import_report.markLost)(report, {
+      code: "unknown-type-dropped",
+      dsId: header.dsId ?? "",
+      message: `A HeaderComponent of type "${header.type}" is not supported, use a header or a leaf type`
+    });
+    return null;
+  }
+  return {
+    dsId: header.dsId ?? "",
+    type: import_ds_left_navigation_tree.LEFT_NAVIGATION_TREE_ITEM_TYPES.LEAF,
+    ...convertCollapsed(header, report),
+    /** A header of a leaf type is drawn by LeftNavigation as that leaf (a with-date header shows its date), so it converts as one. */
+    itemOpts: (0, import_convertItemOpts.convertItemOpts)({
+      item: header,
+      report,
+      kind: header.type === import_constants.ITEM_TYPES.LEFT_NAV_ITEM_HEADER ? "header" : "leaf"
+    })
+  };
+};
+//# sourceMappingURL=conversionHelpers.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/conversionHelpers.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import {\n  LEFT_NAVIGATION_TREE_ITEM_TYPES as TREE_TYPES,\n  type DSLeftNavigationTreeT,\n} from '@elliemae/ds-left-navigation-tree';\nimport { ITEM_TYPES } from '../../constants/index.js';\nimport type { DSLeftNavigationT } from '../../react-desc-prop-types.js';\nimport {\n  DRILLDOWN_TYPES,\n  DROPPED_TYPE_CODES,\n  HEADER_TYPES,\n  LEAF_TYPES,\n  NO_RAIL_TYPES,\n  OUT_OF_THE_BOX_TYPES,\n  getOwn,\n} from './conversionConstants.js';\nimport { convertItemOpts } from './convertItemOpts.js';\nimport { markLost } from './report.js';\nimport type { DSLeftNavBridgeT } from './types.js';\n\ntype OldItemT = DSLeftNavigationT.GenericItemItemProps;\ntype NewItemT = DSLeftNavigationTreeT.Item;\ntype ReportT = DSLeftNavBridgeT.ReportMutableT;\n\ntype ConvertListArgsT = {\n  list: readonly OldItemT[];\n  isRoot: boolean;\n  /** The dsIds (or the items themselves, when they have none) of the submenus and drilldowns being expanded, to stop a branch that contains itself. */\n  ancestors?: readonly (string | OldItemT)[];\n  report: ReportT;\n  childrenByParentId: DSLeftNavBridgeT.ChildrenByParentIdT;\n};\n\nconst convertCollapsed = (item: OldItemT, report: ReportT): Partial<NewItemT> => {\n  if (!item.CollapsedComponent || NO_RAIL_TYPES.includes(item.type ?? '')) return {};\n  markLost(report, {\n    code: 'collapsed-component-ctx',\n    dsId: item.dsId ?? '',\n    message: 'CollapsedComponent is kept, it only receives { item }',\n  });\n  return { CollapsedComponent: item.CollapsedComponent as unknown as NewItemT['CollapsedComponent'] };\n};\n\nconst joinSectionLabel = (label: unknown, rightSection: unknown) =>\n  typeof label === 'string' && typeof rightSection === 'string' ? `${label}, ${rightSection}` : label;\n\ntype RecurseT = (children: readonly OldItemT[]) => NewItemT[];\n\nconst convertSubmenu = (item: OldItemT, args: ConvertOneArgsT): NewItemT => {\n  const { report, childrenByParentId, recurse } = args;\n  const dsId = item.dsId ?? '';\n  const children = getOwn(childrenByParentId, dsId);\n  if (!children)\n    markLost(report, { code: 'submenu-without-children', dsId, message: 'No entry in childrenByParentId' });\n  return {\n    dsId,\n    type: TREE_TYPES.PARENT,\n    ...convertCollapsed(item, report),\n    itemOpts: { ...convertItemOpts({ item, report, kind: 'submenu' }), items: recurse(children ?? []) },\n  };\n};\n\n/**\n * Both legacy drilldowns already open their children in place, so they map one to one to a tree parent. The open state\n * follows the legacy type: the controlled one reads only `isOpened` (closed when omitted), the uncontrolled one only\n * `startOpened`. The tree treats a parent as controlled when `isOpened` is defined, so each option is carried only where\n * LeftNavigation used it.\n */\nconst convertDrilldown = (item: OldItemT, args: ConvertOneArgsT): NewItemT => {\n  const { report, recurse } = args;\n  const dsId = item.dsId ?? '';\n  const { startOpened, isOpened, items = [] } = item.itemOpts ?? {};\n  const opts = convertItemOpts({ item, report, kind: 'drilldown' });\n  const isControlled = item.type === ITEM_TYPES.LEFT_NAV_ITEM_CONTROLLED_DRILLDOWN;\n  return {\n    dsId,\n    type: TREE_TYPES.PARENT,\n    ...convertCollapsed(item, report),\n    itemOpts: {\n      ...opts,\n      ...(isControlled && { isOpened: !!isOpened }),\n      ...(!isControlled && startOpened !== undefined && { startOpened }),\n      items: recurse(items),\n    },\n  };\n};\n\ntype ConvertOneArgsT = Omit<ConvertListArgsT, 'list' | 'isRoot'> & { recurse: RecurseT };\n\n/**\n * Converts one item that is neither a section nor a separator. Returns null when the tree cannot carry it over.\n */\nconst convertOne = (item: OldItemT, args: ConvertOneArgsT): NewItemT | null => {\n  const { report } = args;\n  const dsId = item.dsId ?? '';\n  const { type } = item;\n\n  if (typeof type !== 'string') {\n    markLost(report, {\n      code: 'custom-component-dropped',\n      dsId,\n      message: 'Items with a custom Component are not supported',\n    });\n    return null;\n  }\n  if (LEAF_TYPES.includes(type)) {\n    return {\n      dsId,\n      type: TREE_TYPES.LEAF,\n      ...convertCollapsed(item, report),\n      itemOpts: convertItemOpts({ item, report, kind: 'leaf' }),\n    };\n  }\n  if (type === ITEM_TYPES.LEFT_NAV_ITEM_SUBMENU) return convertSubmenu(item, args);\n  if (DRILLDOWN_TYPES.includes(type)) return convertDrilldown(item, args);\n  const [code, message] = getOwn(DROPPED_TYPE_CODES as Record<string, readonly [string, string]>, type) ?? [\n    'unknown-type-dropped',\n    `Type \"${type}\" is not out of the box`,\n  ];\n  markLost(report, { code: code as DSLeftNavBridgeT.LostCodeT, dsId, message });\n  return null;\n};\n\nconst convertSection = (item: OldItemT, report: ReportT, items: NewItemT[]): NewItemT => {\n  const { label, labelRightSection } = item.itemOpts ?? {};\n  const joinable = typeof label === 'string' && typeof labelRightSection === 'string';\n  const opts = convertItemOpts({ item, report, kind: 'section', joinable });\n  return {\n    dsId: item.dsId ?? '',\n    type: TREE_TYPES.SECTION,\n    itemOpts: {\n      ...opts,\n      label: joinSectionLabel(label, labelRightSection) as NonNullable<NewItemT['itemOpts']>['label'],\n      items,\n    },\n  };\n};\n\n/**\n * LeftNavigation lists are flat: a section is a label and the items that follow it belong to it until the next section or separator.\n * The tree holds the children of a section inside it, so the conversion groups them.\n */\nexport const convertList = (args: ConvertListArgsT): NewItemT[] => {\n  const { list, isRoot, report, ancestors = [] } = args;\n  const converted: NewItemT[] = [];\n  let sectionItems: NewItemT[] | null = null;\n\n  list.forEach((item) => {\n    const { type, dsId = '' } = item;\n    const isSection = type === ITEM_TYPES.LEFT_NAV_ITEM_SECTION;\n    if (isSection || type === ITEM_TYPES.LEFT_NAV_ITEM_SEPARATOR) {\n      if (!isRoot) {\n        markLost(report, {\n          code: 'section-in-nested-list-dropped',\n          dsId,\n          message: 'Sections and separators are only supported at the root level',\n        });\n        return;\n      }\n      sectionItems = isSection ? [] : null;\n      converted.push(sectionItems ? convertSection(item, report, sectionItems) : { dsId, type: TREE_TYPES.SEPARATOR });\n      return;\n    }\n    /** An item that is its own ancestor (by dsId, or by identity when it has none) would expand forever: its repeated branch stays empty and `duplicate-id` or `missing-id` reports it. */\n    const ancestorKey = dsId || item;\n    const isOwnAncestor = ancestors.includes(ancestorKey);\n    const convertedItem = convertOne(item, {\n      report,\n      childrenByParentId: args.childrenByParentId,\n      recurse: (children) =>\n        isOwnAncestor\n          ? []\n          : convertList({ ...args, list: children, isRoot: false, ancestors: [...ancestors, ancestorKey] }),\n    });\n    if (!convertedItem) return;\n    if (sectionItems) sectionItems.push(convertedItem);\n    else converted.push(convertedItem);\n  });\n  return converted;\n};\n\n/**\n * Returns null when the header cannot be carried over: a skeleton (the same policy as the items of the list), or a custom\n * `Component` (no type, or a type that is not out of the box).\n */\nexport const convertHeader = (header: OldItemT, report: ReportT): NewItemT | null => {\n  if (header.type === ITEM_TYPES.LEFT_NAV_ITEM_SKELETON) {\n    const [code, message] = DROPPED_TYPE_CODES[ITEM_TYPES.LEFT_NAV_ITEM_SKELETON];\n    markLost(report, { code, dsId: header.dsId ?? '', message });\n    return null;\n  }\n  if (typeof header.type !== 'string' || !OUT_OF_THE_BOX_TYPES.includes(header.type)) {\n    markLost(report, {\n      code: 'custom-component-dropped',\n      dsId: header.dsId ?? '',\n      message: 'A HeaderComponent with a custom Component is not supported',\n    });\n    return null;\n  }\n  if (!HEADER_TYPES.includes(header.type)) {\n    markLost(report, {\n      code: 'unknown-type-dropped',\n      dsId: header.dsId ?? '',\n      message: `A HeaderComponent of type \"${header.type}\" is not supported, use a header or a leaf type`,\n    });\n    return null;\n  }\n  return {\n    dsId: header.dsId ?? '',\n    type: TREE_TYPES.LEAF,\n    ...convertCollapsed(header, report),\n    /** A header of a leaf type is drawn by LeftNavigation as that leaf (a with-date header shows its date), so it converts as one. */\n    itemOpts: convertItemOpts({\n      item: header,\n      report,\n      kind: header.type === ITEM_TYPES.LEFT_NAV_ITEM_HEADER ? 'header' : 'leaf',\n    }),\n  };\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,qCAGO;AACP,uBAA2B;AAE3B,iCAQO;AACP,6BAAgC;AAChC,oBAAyB;AAgBzB,MAAM,mBAAmB,CAAC,MAAgB,WAAuC;AAC/E,MAAI,CAAC,KAAK,sBAAsB,yCAAc,SAAS,KAAK,QAAQ,EAAE,EAAG,QAAO,CAAC;AACjF,8BAAS,QAAQ;AAAA,IACf,MAAM;AAAA,IACN,MAAM,KAAK,QAAQ;AAAA,IACnB,SAAS;AAAA,EACX,CAAC;AACD,SAAO,EAAE,oBAAoB,KAAK,mBAAgE;AACpG;AAEA,MAAM,mBAAmB,CAAC,OAAgB,iBACxC,OAAO,UAAU,YAAY,OAAO,iBAAiB,WAAW,GAAG,KAAK,KAAK,YAAY,KAAK;AAIhG,MAAM,iBAAiB,CAAC,MAAgB,SAAoC;AAC1E,QAAM,EAAE,QAAQ,oBAAoB,QAAQ,IAAI;AAChD,QAAM,OAAO,KAAK,QAAQ;AAC1B,QAAM,eAAW,mCAAO,oBAAoB,IAAI;AAChD,MAAI,CAAC;AACH,gCAAS,QAAQ,EAAE,MAAM,4BAA4B,MAAM,SAAS,iCAAiC,CAAC;AACxG,SAAO;AAAA,IACL;AAAA,IACA,MAAM,+BAAAA,gCAAW;AAAA,IACjB,GAAG,iBAAiB,MAAM,MAAM;AAAA,IAChC,UAAU,EAAE,OAAG,wCAAgB,EAAE,MAAM,QAAQ,MAAM,UAAU,CAAC,GAAG,OAAO,QAAQ,YAAY,CAAC,CAAC,EAAE;AAAA,EACpG;AACF;AAQA,MAAM,mBAAmB,CAAC,MAAgB,SAAoC;AAC5E,QAAM,EAAE,QAAQ,QAAQ,IAAI;AAC5B,QAAM,OAAO,KAAK,QAAQ;AAC1B,QAAM,EAAE,aAAa,UAAU,QAAQ,CAAC,EAAE,IAAI,KAAK,YAAY,CAAC;AAChE,QAAM,WAAO,wCAAgB,EAAE,MAAM,QAAQ,MAAM,YAAY,CAAC;AAChE,QAAM,eAAe,KAAK,SAAS,4BAAW;AAC9C,SAAO;AAAA,IACL;AAAA,IACA,MAAM,+BAAAA,gCAAW;AAAA,IACjB,GAAG,iBAAiB,MAAM,MAAM;AAAA,IAChC,UAAU;AAAA,MACR,GAAG;AAAA,MACH,GAAI,gBAAgB,EAAE,UAAU,CAAC,CAAC,SAAS;AAAA,MAC3C,GAAI,CAAC,gBAAgB,gBAAgB,UAAa,EAAE,YAAY;AAAA,MAChE,OAAO,QAAQ,KAAK;AAAA,IACtB;AAAA,EACF;AACF;AAOA,MAAM,aAAa,CAAC,MAAgB,SAA2C;AAC7E,QAAM,EAAE,OAAO,IAAI;AACnB,QAAM,OAAO,KAAK,QAAQ;AAC1B,QAAM,EAAE,KAAK,IAAI;AAEjB,MAAI,OAAO,SAAS,UAAU;AAC5B,gCAAS,QAAQ;AAAA,MACf,MAAM;AAAA,MACN;AAAA,MACA,SAAS;AAAA,IACX,CAAC;AACD,WAAO;AAAA,EACT;AACA,MAAI,sCAAW,SAAS,IAAI,GAAG;AAC7B,WAAO;AAAA,MACL;AAAA,MACA,MAAM,+BAAAA,gCAAW;AAAA,MACjB,GAAG,iBAAiB,MAAM,MAAM;AAAA,MAChC,cAAU,wCAAgB,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC;AAAA,IAC1D;AAAA,EACF;AACA,MAAI,SAAS,4BAAW,sBAAuB,QAAO,eAAe,MAAM,IAAI;AAC/E,MAAI,2CAAgB,SAAS,IAAI,EAAG,QAAO,iBAAiB,MAAM,IAAI;AACtE,QAAM,CAAC,MAAM,OAAO,QAAI,mCAAO,+CAAiE,IAAI,KAAK;AAAA,IACvG;AAAA,IACA,SAAS,IAAI;AAAA,EACf;AACA,8BAAS,QAAQ,EAAE,MAA0C,MAAM,QAAQ,CAAC;AAC5E,SAAO;AACT;AAEA,MAAM,iBAAiB,CAAC,MAAgB,QAAiB,UAAgC;AACvF,QAAM,EAAE,OAAO,kBAAkB,IAAI,KAAK,YAAY,CAAC;AACvD,QAAM,WAAW,OAAO,UAAU,YAAY,OAAO,sBAAsB;AAC3E,QAAM,WAAO,wCAAgB,EAAE,MAAM,QAAQ,MAAM,WAAW,SAAS,CAAC;AACxE,SAAO;AAAA,IACL,MAAM,KAAK,QAAQ;AAAA,IACnB,MAAM,+BAAAA,gCAAW;AAAA,IACjB,UAAU;AAAA,MACR,GAAG;AAAA,MACH,OAAO,iBAAiB,OAAO,iBAAiB;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AACF;AAMO,MAAM,cAAc,CAAC,SAAuC;AACjE,QAAM,EAAE,MAAM,QAAQ,QAAQ,YAAY,CAAC,EAAE,IAAI;AACjD,QAAM,YAAwB,CAAC;AAC/B,MAAI,eAAkC;AAEtC,OAAK,QAAQ,CAAC,SAAS;AACrB,UAAM,EAAE,MAAM,OAAO,GAAG,IAAI;AAC5B,UAAM,YAAY,SAAS,4BAAW;AACtC,QAAI,aAAa,SAAS,4BAAW,yBAAyB;AAC5D,UAAI,CAAC,QAAQ;AACX,oCAAS,QAAQ;AAAA,UACf,MAAM;AAAA,UACN;AAAA,UACA,SAAS;AAAA,QACX,CAAC;AACD;AAAA,MACF;AACA,qBAAe,YAAY,CAAC,IAAI;AAChC,gBAAU,KAAK,eAAe,eAAe,MAAM,QAAQ,YAAY,IAAI,EAAE,MAAM,MAAM,+BAAAA,gCAAW,UAAU,CAAC;AAC/G;AAAA,IACF;AAEA,UAAM,cAAc,QAAQ;AAC5B,UAAM,gBAAgB,UAAU,SAAS,WAAW;AACpD,UAAM,gBAAgB,WAAW,MAAM;AAAA,MACrC;AAAA,MACA,oBAAoB,KAAK;AAAA,MACzB,SAAS,CAAC,aACR,gBACI,CAAC,IACD,YAAY,EAAE,GAAG,MAAM,MAAM,UAAU,QAAQ,OAAO,WAAW,CAAC,GAAG,WAAW,WAAW,EAAE,CAAC;AAAA,IACtG,CAAC;AACD,QAAI,CAAC,cAAe;AACpB,QAAI,aAAc,cAAa,KAAK,aAAa;AAAA,QAC5C,WAAU,KAAK,aAAa;AAAA,EACnC,CAAC;AACD,SAAO;AACT;AAMO,MAAM,gBAAgB,CAAC,QAAkB,WAAqC;AACnF,MAAI,OAAO,SAAS,4BAAW,wBAAwB;AACrD,UAAM,CAAC,MAAM,OAAO,IAAI,8CAAmB,4BAAW,sBAAsB;AAC5E,gCAAS,QAAQ,EAAE,MAAM,MAAM,OAAO,QAAQ,IAAI,QAAQ,CAAC;AAC3D,WAAO;AAAA,EACT;AACA,MAAI,OAAO,OAAO,SAAS,YAAY,CAAC,gDAAqB,SAAS,OAAO,IAAI,GAAG;AAClF,gCAAS,QAAQ;AAAA,MACf,MAAM;AAAA,MACN,MAAM,OAAO,QAAQ;AAAA,MACrB,SAAS;AAAA,IACX,CAAC;AACD,WAAO;AAAA,EACT;AACA,MAAI,CAAC,wCAAa,SAAS,OAAO,IAAI,GAAG;AACvC,gCAAS,QAAQ;AAAA,MACf,MAAM;AAAA,MACN,MAAM,OAAO,QAAQ;AAAA,MACrB,SAAS,8BAA8B,OAAO,IAAI;AAAA,IACpD,CAAC;AACD,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,OAAO,QAAQ;AAAA,IACrB,MAAM,+BAAAA,gCAAW;AAAA,IACjB,GAAG,iBAAiB,QAAQ,MAAM;AAAA;AAAA,IAElC,cAAU,wCAAgB;AAAA,MACxB,MAAM;AAAA,MACN;AAAA,MACA,MAAM,OAAO,SAAS,4BAAW,uBAAuB,WAAW;AAAA,IACrE,CAAC;AAAA,EACH;AACF;",
+  "names": ["TREE_TYPES"]
+}

package/dist/cjs/exported-related/conversion-utils/convertItemOpts.js

@@ -0,0 +1,187 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var convertItemOpts_exports = {};
+__export(convertItemOpts_exports, {
+  convertItemOpts: () => convertItemOpts
+});
+module.exports = __toCommonJS(convertItemOpts_exports);
+var React = __toESM(require("react"));
+var import_react = __toESM(require("react"));
+var import_constants = require("../../constants/index.js");
+var import_report = require("./report.js");
+const CONSUMER_SELECTABLE_TYPES = [import_constants.ITEM_TYPES.LEFT_NAV_ITEM_TEXT_LABEL, import_constants.ITEM_TYPES.LEFT_NAV_ITEM_WITH_DATE];
+const convertSelectable = (item) => {
+  const { selectable } = item.itemOpts ?? {};
+  return selectable !== void 0 && CONSUMER_SELECTABLE_TYPES.includes(item.type ?? "") ? { selectable } : {};
+};
+const KNOWN_OPTS = /* @__PURE__ */ new Set([
+  "label",
+  "labelBold",
+  "labelColor",
+  "labelOverflow",
+  "labelRightSection",
+  "selectable",
+  "focuseable",
+  "startOpened",
+  "isOpened",
+  "openable",
+  "closable",
+  "indent",
+  "LeftComponent",
+  "RightComponent",
+  "BottomComponent",
+  "ariaLabel",
+  "ariaRole",
+  "ariaLive",
+  "ariaExpanded",
+  "ariaDescribedBy",
+  "items",
+  "labelDataTestId",
+  "skeletonVariant"
+]);
+const DROPPED_OPTS = ["focuseable", "openable", "closable", "indent", "skeletonVariant", "labelDataTestId"];
+const ARIA_OPTS = ["ariaLabel", "ariaRole", "ariaLive", "ariaExpanded", "ariaDescribedBy"];
+const toRightComponent = (node) => (
+  // LeftNavigation shows labelRightSection as plain content, the tree renders it through RightComponent
+  function RightSection() {
+    return import_react.default.createElement(import_react.default.Fragment, null, node);
+  }
+);
+const EMPTY_CTX = {
+  leftNavProps: {},
+  selectedItem: null,
+  selectedParent: null
+};
+const carryRightComponent = (Old, rightSection) => function CarriedRightComponent({ item }) {
+  return import_react.default.createElement(
+    import_react.default.Fragment,
+    null,
+    rightSection,
+    Old ? import_react.default.createElement(Old, { item, ctx: EMPTY_CTX }) : null
+  );
+};
+const reportStyleLosses = (opts, dsId, report) => {
+  if (opts.labelOverflow === "truncate") {
+    (0, import_report.markLost)(report, {
+      code: "label-truncate-to-wrap",
+      dsId,
+      message: 'labelOverflow "truncate" is not supported, labels wrap'
+    });
+  }
+  if (opts.labelBold !== void 0 || opts.labelColor !== void 0) {
+    (0, import_report.markLost)(report, { code: "label-style-dropped", dsId, message: "labelBold and labelColor are not supported" });
+  }
+  if (ARIA_OPTS.some((key) => opts[key] !== void 0)) {
+    (0, import_report.markLost)(report, {
+      code: "aria-overrides-dropped",
+      dsId,
+      message: "aria overrides are not supported, the tree computes them"
+    });
+  }
+};
+const reportDroppedComponents = ({
+  item,
+  report,
+  carriesRight
+}) => {
+  const opts = item.itemOpts ?? {};
+  const dropped = [
+    opts.RightComponent && !carriesRight ? "RightComponent" : void 0,
+    opts.LeftComponent ? "LeftComponent" : void 0,
+    opts.BottomComponent ? "BottomComponent" : void 0
+  ].filter(Boolean);
+  if (dropped.length === 0) return;
+  (0, import_report.markLost)(report, {
+    code: "component-with-ctx-dropped",
+    dsId: item.dsId ?? "",
+    message: `Not supported: ${dropped.join(", ")}`
+  });
+};
+const droppedRightSection = (opts, joinable) => opts.labelRightSection !== void 0 && !joinable ? ["labelRightSection"] : [];
+const convertCarriedRightComponent = (args, carriesRight) => {
+  const { item, report, joinable = false } = args;
+  const opts = item.itemOpts ?? {};
+  (0, import_report.markLost)(report, {
+    code: "right-component-ctx",
+    dsId: item.dsId ?? "",
+    message: "RightComponent is kept, it only receives { item } and an empty ctx"
+  });
+  return {
+    RightComponent: carryRightComponent(opts.RightComponent, carriesRight ? opts.labelRightSection : void 0),
+    droppedOpts: carriesRight ? [] : droppedRightSection(opts, joinable)
+  };
+};
+const convertRightSection = (args) => {
+  const { item, report } = args;
+  const { labelRightSection } = item.itemOpts ?? {};
+  if (typeof labelRightSection !== "string") {
+    (0, import_report.markLost)(report, {
+      code: "right-component-ctx",
+      dsId: item.dsId ?? "",
+      message: "labelRightSection is not text, it is drawn as is: remove any control inside it"
+    });
+  }
+  return { RightComponent: toRightComponent(labelRightSection), droppedOpts: [] };
+};
+const convertRightSide = (args) => {
+  const { item, report, kind, joinable = false } = args;
+  const opts = item.itemOpts ?? {};
+  const carriesRight = kind === "leaf" || kind === "drilldown";
+  const carriesRightComponent = carriesRight || kind === "header";
+  reportDroppedComponents({ item, report, carriesRight: carriesRightComponent });
+  if (carriesRightComponent && opts.RightComponent) return convertCarriedRightComponent(args, carriesRight);
+  if (carriesRight && opts.labelRightSection !== void 0) return convertRightSection(args);
+  return { droppedOpts: droppedRightSection(opts, joinable) };
+};
+const convertItemOpts = (args) => {
+  const { item, report } = args;
+  const dsId = item.dsId ?? "";
+  const opts = item.itemOpts ?? {};
+  const converted = { ...convertSelectable(item) };
+  if (opts.label !== void 0) converted.label = opts.label;
+  if (opts.labelOverflow !== void 0 && opts.labelOverflow !== "truncate") {
+    converted.labelOverflow = opts.labelOverflow;
+  }
+  reportStyleLosses(opts, dsId, report);
+  const { RightComponent, droppedOpts: droppedRight } = convertRightSide(args);
+  if (RightComponent) converted.RightComponent = RightComponent;
+  const droppedSelectable = args.kind === "drilldown" && opts.selectable !== void 0 ? ["selectable"] : [];
+  const customKeys = Object.keys(opts).filter((key) => !KNOWN_OPTS.has(key) && opts[key] !== void 0);
+  const droppedOpts = [
+    ...droppedSelectable,
+    ...DROPPED_OPTS.filter((key) => opts[key] !== void 0),
+    ...customKeys,
+    ...droppedRight
+  ];
+  if (droppedOpts.length > 0) {
+    (0, import_report.markLost)(report, { code: "item-options-dropped", dsId, message: `Not supported: ${droppedOpts.join(", ")}` });
+  }
+  return converted;
+};
+//# sourceMappingURL=convertItemOpts.js.map

package/dist/cjs/exported-related/conversion-utils/convertItemOpts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/convertItemOpts.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import React from 'react';\nimport type { DSLeftNavigationTreeT } from '@elliemae/ds-left-navigation-tree';\nimport { ITEM_TYPES } from '../../constants/index.js';\nimport type { DSLeftNavigationT } from '../../react-desc-prop-types.js';\nimport { markLost } from './report.js';\nimport type { DSLeftNavBridgeT } from './types.js';\n\ntype OldItemT = DSLeftNavigationT.GenericItemItemProps;\ntype NewItemOptsT = DSLeftNavigationTreeT.ItemOpts;\ntype ReportT = DSLeftNavBridgeT.ReportMutableT;\ntype OldOptsT = OldItemT['itemOpts'];\ntype OldRightComponentPropsT = DSLeftNavigationT.ComponentProps;\n\n/**\n * LeftNavigation lets the consumer decide `selectable` only on these types. The others set it themselves (a link is always\n * selectable, a submenu, a header or a section follow their own state), so there is nothing to carry or to report.\n */\nconst CONSUMER_SELECTABLE_TYPES: string[] = [ITEM_TYPES.LEFT_NAV_ITEM_TEXT_LABEL, ITEM_TYPES.LEFT_NAV_ITEM_WITH_DATE];\n\nconst convertSelectable = (item: OldItemT): Pick<NewItemOptsT, 'selectable'> => {\n  const { selectable } = item.itemOpts ?? {};\n  return selectable !== undefined && CONSUMER_SELECTABLE_TYPES.includes(item.type ?? '') ? { selectable } : {};\n};\n\n/**\n * Every key LeftNavigation knows in `itemOpts`. `ItemOptsT` also accepts any other key, which the tree has no place for.\n */\nconst KNOWN_OPTS = new Set([\n  'label',\n  'labelBold',\n  'labelColor',\n  'labelOverflow',\n  'labelRightSection',\n  'selectable',\n  'focuseable',\n  'startOpened',\n  'isOpened',\n  'openable',\n  'closable',\n  'indent',\n  'LeftComponent',\n  'RightComponent',\n  'BottomComponent',\n  'ariaLabel',\n  'ariaRole',\n  'ariaLive',\n  'ariaExpanded',\n  'ariaDescribedBy',\n  'items',\n  'labelDataTestId',\n  'skeletonVariant',\n]);\n\nconst DROPPED_OPTS = ['focuseable', 'openable', 'closable', 'indent', 'skeletonVariant', 'labelDataTestId'] as const;\n\nconst ARIA_OPTS = ['ariaLabel', 'ariaRole', 'ariaLive', 'ariaExpanded', 'ariaDescribedBy'] as const;\n\nconst toRightComponent = (node: unknown): NewItemOptsT['RightComponent'] =>\n  // LeftNavigation shows labelRightSection as plain content, the tree renders it through RightComponent\n  function RightSection() {\n    return React.createElement(React.Fragment, null, node as React.ReactNode);\n  };\n\n/**\n * The tree gives its components `{ item }`, LeftNavigation gave `{ item, ctx }`. Components that read `ctx` get an empty one.\n */\nconst EMPTY_CTX = {\n  leftNavProps: {},\n  selectedItem: null,\n  selectedParent: null,\n} as unknown as OldRightComponentPropsT['ctx'];\n\n/**\n * LeftNavigation draws `labelRightSection` and then `RightComponent` on the right side of an item, the tree has one `RightComponent`.\n */\nconst carryRightComponent = (Old: OldOptsT['RightComponent'], rightSection: unknown): NewItemOptsT['RightComponent'] =>\n  function CarriedRightComponent({ item }) {\n    return React.createElement(\n      React.Fragment,\n      null,\n      rightSection as React.ReactNode,\n      Old\n        ? React.createElement(Old, { item: item as unknown as OldRightComponentPropsT['item'], ctx: EMPTY_CTX })\n        : null,\n    );\n  };\n\nconst reportStyleLosses = (opts: OldOptsT, dsId: string, report: ReportT) => {\n  if (opts.labelOverflow === 'truncate') {\n    markLost(report, {\n      code: 'label-truncate-to-wrap',\n      dsId,\n      message: 'labelOverflow \"truncate\" is not supported, labels wrap',\n    });\n  }\n  if (opts.labelBold !== undefined || opts.labelColor !== undefined) {\n    markLost(report, { code: 'label-style-dropped', dsId, message: 'labelBold and labelColor are not supported' });\n  }\n  if (ARIA_OPTS.some((key) => opts[key] !== undefined)) {\n    markLost(report, {\n      code: 'aria-overrides-dropped',\n      dsId,\n      message: 'aria overrides are not supported, the tree computes them',\n    });\n  }\n};\n\ntype ConvertItemOptsArgsT = {\n  item: OldItemT;\n  report: ReportT;\n  /**\n   * Leaves and drilldowns carry `RightComponent` and `labelRightSection`, the header only its `RightComponent`.\n   * Submenus and the header keep their right side only as the chevron, and the tree draws its own arrow, so it is dropped.\n   */\n  kind: 'leaf' | 'drilldown' | 'submenu' | 'header' | 'section';\n  /** The caller merges labelRightSection into the label (sections), so it is not lost. */\n  joinable?: boolean;\n};\n\ntype RightSideResultT = { RightComponent?: NewItemOptsT['RightComponent']; droppedOpts: string[] };\n\nconst reportDroppedComponents = ({\n  item,\n  report,\n  carriesRight,\n}: {\n  item: OldItemT;\n  report: ReportT;\n  carriesRight: boolean;\n}) => {\n  const opts = item.itemOpts ?? {};\n  const dropped = [\n    opts.RightComponent && !carriesRight ? 'RightComponent' : undefined,\n    opts.LeftComponent ? 'LeftComponent' : undefined,\n    opts.BottomComponent ? 'BottomComponent' : undefined,\n  ].filter(Boolean);\n  if (dropped.length === 0) return;\n  markLost(report, {\n    code: 'component-with-ctx-dropped',\n    dsId: item.dsId ?? '',\n    message: `Not supported: ${dropped.join(', ')}`,\n  });\n};\n\nconst droppedRightSection = (opts: OldOptsT, joinable: boolean) =>\n  opts.labelRightSection !== undefined && !joinable ? ['labelRightSection'] : [];\n\n/**\n * The header also draws its `RightComponent` (the tree renders it, LeftNavigation did), but never drew `labelRightSection`.\n */\nconst convertCarriedRightComponent = (args: ConvertItemOptsArgsT, carriesRight: boolean): RightSideResultT => {\n  const { item, report, joinable = false } = args;\n  const opts = item.itemOpts ?? {};\n  markLost(report, {\n    code: 'right-component-ctx',\n    dsId: item.dsId ?? '',\n    message: 'RightComponent is kept, it only receives { item } and an empty ctx',\n  });\n  return {\n    RightComponent: carryRightComponent(opts.RightComponent, carriesRight ? opts.labelRightSection : undefined),\n    droppedOpts: carriesRight ? [] : droppedRightSection(opts, joinable),\n  };\n};\n\n/**\n * A `labelRightSection` that is not text is drawn as is, so a control inside it would be a second focusable element in the\n * treeitem: the conversion keeps it and reports it, as it does with a carried `RightComponent`.\n */\nconst convertRightSection = (args: ConvertItemOptsArgsT): RightSideResultT => {\n  const { item, report } = args;\n  const { labelRightSection } = item.itemOpts ?? {};\n  if (typeof labelRightSection !== 'string') {\n    markLost(report, {\n      code: 'right-component-ctx',\n      dsId: item.dsId ?? '',\n      message: 'labelRightSection is not text, it is drawn as is: remove any control inside it',\n    });\n  }\n  return { RightComponent: toRightComponent(labelRightSection), droppedOpts: [] };\n};\n\n/**\n * The right side of an item: leaves and drilldowns keep `RightComponent` and `labelRightSection`, the header only its\n * `RightComponent`, the other kinds lose them.\n */\nconst convertRightSide = (args: ConvertItemOptsArgsT): RightSideResultT => {\n  const { item, report, kind, joinable = false } = args;\n  const opts = item.itemOpts ?? {};\n  const carriesRight = kind === 'leaf' || kind === 'drilldown';\n  const carriesRightComponent = carriesRight || kind === 'header';\n  reportDroppedComponents({ item, report, carriesRight: carriesRightComponent });\n  if (carriesRightComponent && opts.RightComponent) return convertCarriedRightComponent(args, carriesRight);\n  if (carriesRight && opts.labelRightSection !== undefined) return convertRightSection(args);\n  return { droppedOpts: droppedRightSection(opts, joinable) };\n};\n\n/**\n * Builds the tree item options shared by every converted type and records what could not be carried over.\n */\nexport const convertItemOpts = (args: ConvertItemOptsArgsT): NewItemOptsT => {\n  const { item, report } = args;\n  const dsId = item.dsId ?? '';\n  const opts = item.itemOpts ?? {};\n  const converted: NewItemOptsT = { ...convertSelectable(item) };\n  if (opts.label !== undefined) converted.label = opts.label;\n  if (opts.labelOverflow !== undefined && opts.labelOverflow !== 'truncate') {\n    converted.labelOverflow = opts.labelOverflow;\n  }\n  reportStyleLosses(opts, dsId, report);\n\n  const { RightComponent, droppedOpts: droppedRight } = convertRightSide(args);\n  if (RightComponent) converted.RightComponent = RightComponent;\n  /** LeftNavigation drilldowns keep the consumer's `selectable`, the tree has it on leaves only. */\n  const droppedSelectable = args.kind === 'drilldown' && opts.selectable !== undefined ? ['selectable'] : [];\n  const customKeys = Object.keys(opts).filter((key) => !KNOWN_OPTS.has(key) && opts[key] !== undefined);\n  const droppedOpts = [\n    ...droppedSelectable,\n    ...DROPPED_OPTS.filter((key) => opts[key] !== undefined),\n    ...customKeys,\n    ...droppedRight,\n  ];\n  if (droppedOpts.length > 0) {\n    markLost(report, { code: 'item-options-dropped', dsId, message: `Not supported: ${droppedOpts.join(', ')}` });\n  }\n  return converted;\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": "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",
+  "names": ["React"]
+}

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

@@ -0,0 +1,37 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var getHumanReadableWarnings_exports = {};
+__export(getHumanReadableWarnings_exports, {
+  getHumanReadableWarnings: () => getHumanReadableWarnings
+});
+module.exports = __toCommonJS(getHumanReadableWarnings_exports);
+var React = __toESM(require("react"));
+var import_lostCodes = require("./lostCodes.js");
+const getHumanReadableWarnings = (report) => Object.keys(import_lostCodes.WARNING_PER_LOST_CODE).filter((code) => report.detectedLostsOnConversion[code]).map((code) => import_lostCodes.WARNING_PER_LOST_CODE[code]);
+//# sourceMappingURL=getHumanReadableWarnings.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/getHumanReadableWarnings.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { WARNING_PER_LOST_CODE } from './lostCodes.js';\nimport type { DSLeftNavBridgeT } 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: DSLeftNavBridgeT.ReportMutableT): string[] =>\n  (Object.keys(WARNING_PER_LOST_CODE) as DSLeftNavBridgeT.LostCodeT[])\n    .filter((code) => report.detectedLostsOnConversion[code])\n    .map((code) => WARNING_PER_LOST_CODE[code]);\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAAsC;AAQ/B,MAAM,2BAA2B,CAAC,WACtC,OAAO,KAAK,sCAAqB,EAC/B,OAAO,CAAC,SAAS,OAAO,0BAA0B,IAAI,CAAC,EACvD,IAAI,CAAC,SAAS,uCAAsB,IAAI,CAAC;",
+  "names": []
+}