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

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": []
+}

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

@@ -0,0 +1,95 @@
+"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 conversion_utils_exports = {};
+__export(conversion_utils_exports, {
+  checkAndConvertItems: () => checkAndConvertItems
+});
+module.exports = __toCommonJS(conversion_utils_exports);
+var React = __toESM(require("react"));
+var import_conversionConstants = require("./conversionConstants.js");
+var import_conversionHelpers = require("./conversionHelpers.js");
+var import_validateIds = require("./validateIds.js");
+var import_getHumanReadableWarnings = require("./getHumanReadableWarnings.js");
+var import_report = require("./report.js");
+const reportIgnoredHeaderContent = (dsId, childrenByParentId, report) => {
+  if (!dsId || !(0, import_conversionConstants.getOwn)(childrenByParentId, dsId)) return;
+  (0, import_report.markLost)(report, {
+    code: "header-content-dropped",
+    dsId,
+    message: "The header is the first leaf, so its list in childrenByParentId was ignored"
+  });
+};
+const convertHeaderPart = (args) => {
+  const { HeaderComponent, headerAsFirstLeaf, convertedItems, report, childrenByParentId } = args;
+  const result = {};
+  const header = HeaderComponent ? (0, import_conversionHelpers.convertHeader)(HeaderComponent, report) : null;
+  if (!HeaderComponent || !header) return result;
+  if (headerAsFirstLeaf) {
+    convertedItems.unshift(header);
+    reportIgnoredHeaderContent(HeaderComponent.dsId, childrenByParentId, report);
+    return result;
+  }
+  const headerContent = HeaderComponent.dsId ? (0, import_conversionConstants.getOwn)(childrenByParentId, HeaderComponent.dsId) : void 0;
+  if (!headerContent) {
+    (0, import_report.markLost)(report, {
+      code: "header-without-content",
+      dsId: HeaderComponent.dsId ?? "",
+      message: "No entry in childrenByParentId for the header, it is a disclosure with nothing to open"
+    });
+  }
+  return {
+    convertedHeader: header,
+    convertedHeaderItems: headerContent ? (0, import_conversionHelpers.convertList)({ list: headerContent, isRoot: true, report, childrenByParentId }) : []
+  };
+};
+const checkAndConvertItems = (items, options = {}) => {
+  const { childrenByParentId = {}, HeaderComponent, BodyHeaderComponent, headerAsFirstLeaf = false } = options;
+  const report = (0, import_report.createEmptyReport)();
+  const convertedItems = (0, import_conversionHelpers.convertList)({ list: items, isRoot: true, report, childrenByParentId });
+  const { convertedHeader, convertedHeaderItems } = convertHeaderPart({
+    HeaderComponent,
+    headerAsFirstLeaf,
+    convertedItems,
+    report,
+    childrenByParentId
+  });
+  (0, import_validateIds.reportIdProblems)(convertedItems, report, convertedHeader ? [convertedHeader.dsId] : []);
+  if (convertedHeaderItems)
+    (0, import_validateIds.reportIdProblems)(convertedHeaderItems, report, convertedHeader?.dsId ? [convertedHeader.dsId] : []);
+  if (BodyHeaderComponent) {
+    (0, import_report.markLost)(report, {
+      code: "body-header-dropped",
+      dsId: BodyHeaderComponent.dsId ?? "",
+      message: "BodyHeaderComponent is not supported, the submenu is the parent of its children"
+    });
+  }
+  report.humanReadableWarnings = (0, import_getHumanReadableWarnings.getHumanReadableWarnings)(report);
+  return { convertedItems, convertedHeader, convertedHeaderItems, report };
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/index.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { getOwn } from './conversionConstants.js';\nimport { convertHeader, convertList } from './conversionHelpers.js';\nimport { reportIdProblems } from './validateIds.js';\nimport { getHumanReadableWarnings } from './getHumanReadableWarnings.js';\nimport { createEmptyReport, markLost } from './report.js';\nimport type { DSLeftNavBridgeT } from './types.js';\nimport type { DSLeftNavigationT } from '../../react-desc-prop-types.js';\n\ntype ConvertHeaderPartArgsT = {\n  HeaderComponent?: DSLeftNavBridgeT.OptionsT['HeaderComponent'];\n  headerAsFirstLeaf: boolean;\n  convertedItems: DSLeftNavBridgeT.ResultT['convertedItems'];\n  report: DSLeftNavBridgeT.ReportMutableT;\n  childrenByParentId: DSLeftNavBridgeT.ChildrenByParentIdT;\n};\n\nconst reportIgnoredHeaderContent = (\n  dsId: string | undefined,\n  childrenByParentId: DSLeftNavBridgeT.ChildrenByParentIdT,\n  report: DSLeftNavBridgeT.ReportMutableT,\n) => {\n  if (!dsId || !getOwn(childrenByParentId, dsId)) return;\n  markLost(report, {\n    code: 'header-content-dropped',\n    dsId,\n    message: 'The header is the first leaf, so its list in childrenByParentId was ignored',\n  });\n};\n\nconst convertHeaderPart = (args: ConvertHeaderPartArgsT) => {\n  const { HeaderComponent, headerAsFirstLeaf, convertedItems, report, childrenByParentId } = args;\n  const result: Pick<DSLeftNavBridgeT.ResultT, 'convertedHeader' | 'convertedHeaderItems'> = {};\n  const header = HeaderComponent ? convertHeader(HeaderComponent, report) : null;\n  if (!HeaderComponent || !header) return result;\n  if (headerAsFirstLeaf) {\n    convertedItems.unshift(header);\n    reportIgnoredHeaderContent(HeaderComponent.dsId, childrenByParentId, report);\n    return result;\n  }\n  const headerContent = HeaderComponent.dsId ? getOwn(childrenByParentId, HeaderComponent.dsId) : undefined;\n  if (!headerContent) {\n    markLost(report, {\n      code: 'header-without-content',\n      dsId: HeaderComponent.dsId ?? '',\n      message: 'No entry in childrenByParentId for the header, it is a disclosure with nothing to open',\n    });\n  }\n  return {\n    convertedHeader: header,\n    convertedHeaderItems: headerContent\n      ? convertList({ list: headerContent, isRoot: true, report, childrenByParentId })\n      : [],\n  };\n};\n\n/**\n * Converts LeftNavigation items to DSLeftNavigationTree items and reports what the tree cannot carry over.\n * It is a migration aid, not a drop-in replacement: read `report.humanReadableWarnings` and `report.lostEntries`.\n * @param items - The LeftNavigation items (the flat list shown by the body).\n * @param options - Children of the submenus (`childrenByParentId`), and the `HeaderComponent` and `BodyHeaderComponent` props.\n * @returns The converted items and the report. `HeaderComponent` becomes `convertedHeader`, a disclosure, and\n * `convertedHeaderItems` is its content (the list under the header `dsId` in `childrenByParentId`) to pass as `items`\n * while it is open. A header that is only a link goes to the front of `convertedItems` with `headerAsFirstLeaf`.\n */\nexport const checkAndConvertItems = (\n  items: readonly DSLeftNavigationT.GenericItemItemProps[],\n  options: DSLeftNavBridgeT.OptionsT = {},\n): DSLeftNavBridgeT.ResultT => {\n  const { childrenByParentId = {}, HeaderComponent, BodyHeaderComponent, headerAsFirstLeaf = false } = options;\n  const report = createEmptyReport();\n  const convertedItems = convertList({ list: items, isRoot: true, report, childrenByParentId });\n  const { convertedHeader, convertedHeaderItems } = convertHeaderPart({\n    HeaderComponent,\n    headerAsFirstLeaf,\n    convertedItems,\n    report,\n    childrenByParentId,\n  });\n  /** The header and each list the consumer passes as `items` are one hierarchy for the tree, so each is validated with the header. */\n  reportIdProblems(convertedItems, report, convertedHeader ? [convertedHeader.dsId] : []);\n  if (convertedHeaderItems)\n    reportIdProblems(convertedHeaderItems, report, convertedHeader?.dsId ? [convertedHeader.dsId] : []);\n  if (BodyHeaderComponent) {\n    markLost(report, {\n      code: 'body-header-dropped',\n      dsId: BodyHeaderComponent.dsId ?? '',\n      message: 'BodyHeaderComponent is not supported, the submenu is the parent of its children',\n    });\n  }\n  report.humanReadableWarnings = getHumanReadableWarnings(report);\n  return { convertedItems, convertedHeader, convertedHeaderItems, report };\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,iCAAuB;AACvB,+BAA2C;AAC3C,yBAAiC;AACjC,sCAAyC;AACzC,oBAA4C;AAY5C,MAAM,6BAA6B,CACjC,MACA,oBACA,WACG;AACH,MAAI,CAAC,QAAQ,KAAC,mCAAO,oBAAoB,IAAI,EAAG;AAChD,8BAAS,QAAQ;AAAA,IACf,MAAM;AAAA,IACN;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AACH;AAEA,MAAM,oBAAoB,CAAC,SAAiC;AAC1D,QAAM,EAAE,iBAAiB,mBAAmB,gBAAgB,QAAQ,mBAAmB,IAAI;AAC3F,QAAM,SAAqF,CAAC;AAC5F,QAAM,SAAS,sBAAkB,wCAAc,iBAAiB,MAAM,IAAI;AAC1E,MAAI,CAAC,mBAAmB,CAAC,OAAQ,QAAO;AACxC,MAAI,mBAAmB;AACrB,mBAAe,QAAQ,MAAM;AAC7B,+BAA2B,gBAAgB,MAAM,oBAAoB,MAAM;AAC3E,WAAO;AAAA,EACT;AACA,QAAM,gBAAgB,gBAAgB,WAAO,mCAAO,oBAAoB,gBAAgB,IAAI,IAAI;AAChG,MAAI,CAAC,eAAe;AAClB,gCAAS,QAAQ;AAAA,MACf,MAAM;AAAA,MACN,MAAM,gBAAgB,QAAQ;AAAA,MAC9B,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,sBAAsB,oBAClB,sCAAY,EAAE,MAAM,eAAe,QAAQ,MAAM,QAAQ,mBAAmB,CAAC,IAC7E,CAAC;AAAA,EACP;AACF;AAWO,MAAM,uBAAuB,CAClC,OACA,UAAqC,CAAC,MACT;AAC7B,QAAM,EAAE,qBAAqB,CAAC,GAAG,iBAAiB,qBAAqB,oBAAoB,MAAM,IAAI;AACrG,QAAM,aAAS,iCAAkB;AACjC,QAAM,qBAAiB,sCAAY,EAAE,MAAM,OAAO,QAAQ,MAAM,QAAQ,mBAAmB,CAAC;AAC5F,QAAM,EAAE,iBAAiB,qBAAqB,IAAI,kBAAkB;AAAA,IAClE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,2CAAiB,gBAAgB,QAAQ,kBAAkB,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC;AACtF,MAAI;AACF,6CAAiB,sBAAsB,QAAQ,iBAAiB,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC;AACpG,MAAI,qBAAqB;AACvB,gCAAS,QAAQ;AAAA,MACf,MAAM;AAAA,MACN,MAAM,oBAAoB,QAAQ;AAAA,MAClC,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,SAAO,4BAAwB,0DAAyB,MAAM;AAC9D,SAAO,EAAE,gBAAgB,iBAAiB,sBAAsB,OAAO;AACzE;",
+  "names": []
+}

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

@@ -0,0 +1,55 @@
+"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 lostCodes_exports = {};
+__export(lostCodes_exports, {
+  WARNING_PER_LOST_CODE: () => WARNING_PER_LOST_CODE
+});
+module.exports = __toCommonJS(lostCodes_exports);
+var React = __toESM(require("react"));
+const WARNING_PER_LOST_CODE = {
+  "submenu-without-children": `- Encountered submenu items without an entry in "childrenByParentId" - the tree needs the children in the data, the conversion created an empty parent`,
+  "custom-component-dropped": `- Encountered items with a custom "Component" - a treeitem cannot hold arbitrary interactive content (WCAG 4.1.2), the conversion dropped them`,
+  "skeleton-dropped": `- Encountered skeleton items - loading states are not part of the tree, the conversion dropped them`,
+  "header-item-dropped": `- Encountered an item of type header inside "items" - the tree has one header disclosure, passed as "HeaderComponent", the conversion dropped it from the list`,
+  "header-content-dropped": `- Encountered "headerAsFirstLeaf" together with a list for the header in "childrenByParentId" - a header that is the first item of the list has nothing to open, the conversion ignored that list. Drop "headerAsFirstLeaf" to keep the header as a disclosure with its content`,
+  "header-without-content": `- Encountered a "HeaderComponent" without an entry in "childrenByParentId" - the tree header is a disclosure with nothing to open. If the header is only a link, pass "headerAsFirstLeaf" to make it the first item of the list`,
+  "right-component-ctx": `- Encountered "RightComponent" on a leaf, drilldown or header, or a "labelRightSection" that is not text - the conversion kept it, but the tree only gives it "{ item }" and an empty "ctx", so it must not read "ctx". The "item" it receives is the converted tree item (another type, with only the options the tree keeps), so it must not read legacy fields either. The conversion does not inspect what it draws: remove buttons, menus or any other control inside it before rendering the converted data, a treeitem cannot hold them`,
+  "body-header-dropped": `- Encountered "BodyHeaderComponent" - the tree shows the opened submenu as the parent of its children, the conversion ignored it`,
+  "component-with-ctx-dropped": `- Encountered "LeftComponent" or "BottomComponent", or a "RightComponent" on a submenu or section - the tree has no place for them (parents draw their own arrow), the conversion dropped them`,
+  "collapsed-component-ctx": `- Encountered "CollapsedComponent" - the conversion kept it as is, but the tree only gives it "{ item }" with the converted tree item (another type, with only the options the tree keeps), so it must not read "ctx" or legacy fields of the item`,
+  "label-style-dropped": `- Encountered "labelBold" or "labelColor" - state conveyed only by weight or color fails WCAG 1.3.1 and 1.4.1, the conversion dropped them`,
+  "label-truncate-to-wrap": `- Encountered "labelOverflow: truncate" - truncated labels need a hover tooltip (1.4.13) and hide text from users who zoom (1.4.10), the conversion uses "wrap"`,
+  "aria-overrides-dropped": `- Encountered "ariaLabel", "ariaRole", "ariaLive", "ariaExpanded" or "ariaDescribedBy" - the tree computes its own names and states, the conversion dropped them`,
+  "item-options-dropped": `- Encountered item options the tree does not have (selectable on a drilldown, focuseable, openable, closable, indent, skeletonVariant, labelDataTestId, any other key of itemOpts, or a non-text labelRightSection where it cannot be shown) - the conversion dropped them, see lostEntries for the list per item`,
+  "section-in-nested-list-dropped": `- Encountered a section or separator inside a submenu or drilldown - the tree supports them only at the root level, the conversion dropped them`,
+  "missing-id": `- Encountered items without a "dsId" - the tree finds every item by its "dsId", so each one needs its own; set it before using the converted items`,
+  "duplicate-id": `- Encountered the same "dsId" on more than one item of the converted hierarchy - the tree finds items by "dsId" across all levels, so a repeated one overwrites the other's label and parent; give each item a unique "dsId" (LeftNavigation only needed it unique inside the list that is shown)`,
+  "unknown-type-dropped": `- Encountered items with a type that is not out of the box, or a "HeaderComponent" that is not a header, link, text-label or with-date - the conversion dropped them`
+};
+//# sourceMappingURL=lostCodes.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/lostCodes.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["/**\n * Single source of truth for the codes of what the conversion cannot carry over: the type, the empty report and the warnings derive from it.\n */\nexport const WARNING_PER_LOST_CODE = {\n  'submenu-without-children': `- Encountered submenu items without an entry in \"childrenByParentId\" - the tree needs the children in the data, the conversion created an empty parent`,\n  'custom-component-dropped': `- Encountered items with a custom \"Component\" - a treeitem cannot hold arbitrary interactive content (WCAG 4.1.2), the conversion dropped them`,\n  'skeleton-dropped': `- Encountered skeleton items - loading states are not part of the tree, the conversion dropped them`,\n  'header-item-dropped': `- Encountered an item of type header inside \"items\" - the tree has one header disclosure, passed as \"HeaderComponent\", the conversion dropped it from the list`,\n  'header-content-dropped': `- Encountered \"headerAsFirstLeaf\" together with a list for the header in \"childrenByParentId\" - a header that is the first item of the list has nothing to open, the conversion ignored that list. Drop \"headerAsFirstLeaf\" to keep the header as a disclosure with its content`,\n  'header-without-content': `- Encountered a \"HeaderComponent\" without an entry in \"childrenByParentId\" - the tree header is a disclosure with nothing to open. If the header is only a link, pass \"headerAsFirstLeaf\" to make it the first item of the list`,\n  'right-component-ctx': `- Encountered \"RightComponent\" on a leaf, drilldown or header, or a \"labelRightSection\" that is not text - the conversion kept it, but the tree only gives it \"{ item }\" and an empty \"ctx\", so it must not read \"ctx\". The \"item\" it receives is the converted tree item (another type, with only the options the tree keeps), so it must not read legacy fields either. The conversion does not inspect what it draws: remove buttons, menus or any other control inside it before rendering the converted data, a treeitem cannot hold them`,\n  'body-header-dropped': `- Encountered \"BodyHeaderComponent\" - the tree shows the opened submenu as the parent of its children, the conversion ignored it`,\n  'component-with-ctx-dropped': `- Encountered \"LeftComponent\" or \"BottomComponent\", or a \"RightComponent\" on a submenu or section - the tree has no place for them (parents draw their own arrow), the conversion dropped them`,\n  'collapsed-component-ctx': `- Encountered \"CollapsedComponent\" - the conversion kept it as is, but the tree only gives it \"{ item }\" with the converted tree item (another type, with only the options the tree keeps), so it must not read \"ctx\" or legacy fields of the item`,\n  'label-style-dropped': `- Encountered \"labelBold\" or \"labelColor\" - state conveyed only by weight or color fails WCAG 1.3.1 and 1.4.1, the conversion dropped them`,\n  'label-truncate-to-wrap': `- Encountered \"labelOverflow: truncate\" - truncated labels need a hover tooltip (1.4.13) and hide text from users who zoom (1.4.10), the conversion uses \"wrap\"`,\n  'aria-overrides-dropped': `- Encountered \"ariaLabel\", \"ariaRole\", \"ariaLive\", \"ariaExpanded\" or \"ariaDescribedBy\" - the tree computes its own names and states, the conversion dropped them`,\n  'item-options-dropped': `- Encountered item options the tree does not have (selectable on a drilldown, focuseable, openable, closable, indent, skeletonVariant, labelDataTestId, any other key of itemOpts, or a non-text labelRightSection where it cannot be shown) - the conversion dropped them, see lostEntries for the list per item`,\n  'section-in-nested-list-dropped': `- Encountered a section or separator inside a submenu or drilldown - the tree supports them only at the root level, the conversion dropped them`,\n  'missing-id': `- Encountered items without a \"dsId\" - the tree finds every item by its \"dsId\", so each one needs its own; set it before using the converted items`,\n  'duplicate-id': `- Encountered the same \"dsId\" on more than one item of the converted hierarchy - the tree finds items by \"dsId\" across all levels, so a repeated one overwrites the other's label and parent; give each item a unique \"dsId\" (LeftNavigation only needed it unique inside the list that is shown)`,\n  'unknown-type-dropped': `- Encountered items with a type that is not out of the box, or a \"HeaderComponent\" that is not a header, link, text-label or with-date - the conversion dropped them`,\n} as const;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADGhB,MAAM,wBAAwB;AAAA,EACnC,4BAA4B;AAAA,EAC5B,4BAA4B;AAAA,EAC5B,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EACvB,0BAA0B;AAAA,EAC1B,0BAA0B;AAAA,EAC1B,uBAAuB;AAAA,EACvB,uBAAuB;AAAA,EACvB,8BAA8B;AAAA,EAC9B,2BAA2B;AAAA,EAC3B,uBAAuB;AAAA,EACvB,0BAA0B;AAAA,EAC1B,0BAA0B;AAAA,EAC1B,wBAAwB;AAAA,EACxB,kCAAkC;AAAA,EAClC,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,wBAAwB;AAC1B;",
+  "names": []
+}

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

@@ -0,0 +1,48 @@
+"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 report_exports = {};
+__export(report_exports, {
+  createEmptyReport: () => createEmptyReport,
+  markLost: () => markLost
+});
+module.exports = __toCommonJS(report_exports);
+var React = __toESM(require("react"));
+var import_lostCodes = require("./lostCodes.js");
+const createEmptyReport = () => ({
+  detectedLostsOnConversion: Object.fromEntries(
+    Object.keys(import_lostCodes.WARNING_PER_LOST_CODE).map((code) => [code, false])
+  ),
+  lostEntries: [],
+  humanReadableWarnings: []
+});
+const markLost = (report, entry) => {
+  report.detectedLostsOnConversion[entry.code] = true;
+  report.lostEntries.push(entry);
+};
+//# sourceMappingURL=report.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/report.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { WARNING_PER_LOST_CODE } from './lostCodes.js';\nimport type { DSLeftNavBridgeT } from './types.js';\n\nexport const createEmptyReport = (): DSLeftNavBridgeT.ReportMutableT => ({\n  detectedLostsOnConversion: Object.fromEntries(\n    Object.keys(WARNING_PER_LOST_CODE).map((code) => [code, false]),\n  ) as DSLeftNavBridgeT.ReportMutableT['detectedLostsOnConversion'],\n  lostEntries: [],\n  humanReadableWarnings: [],\n});\n\nexport const markLost = (report: DSLeftNavBridgeT.ReportMutableT, entry: DSLeftNavBridgeT.LostEntryT) => {\n  // eslint-disable-next-line no-param-reassign\n  report.detectedLostsOnConversion[entry.code] = true;\n  report.lostEntries.push(entry);\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAAsC;AAG/B,MAAM,oBAAoB,OAAwC;AAAA,EACvE,2BAA2B,OAAO;AAAA,IAChC,OAAO,KAAK,sCAAqB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;AAAA,EAChE;AAAA,EACA,aAAa,CAAC;AAAA,EACd,uBAAuB,CAAC;AAC1B;AAEO,MAAM,WAAW,CAAC,QAAyC,UAAuC;AAEvG,SAAO,0BAA0B,MAAM,IAAI,IAAI;AAC/C,SAAO,YAAY,KAAK,KAAK;AAC/B;",
+  "names": []
+}

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

@@ -0,0 +1,28 @@
+"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 __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 types_exports = {};
+module.exports = __toCommonJS(types_exports);
+var React = __toESM(require("react"));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/types.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import type { DSLeftNavigationTreeT } from '@elliemae/ds-left-navigation-tree';\nimport type { WARNING_PER_LOST_CODE } from './lostCodes.js';\nimport type { DSLeftNavigationT } from '../../react-desc-prop-types.js';\n\nexport declare namespace DSLeftNavBridgeT {\n  /**\n   * Each code is something LeftNavigation could do that the tree cannot carry over.\n   */\n  export type LostCodeT = keyof typeof WARNING_PER_LOST_CODE;\n\n  export type LostEntryT = {\n    code: LostCodeT;\n    dsId: string;\n    message: string;\n  };\n\n  export type ReportMutableT = {\n    detectedLostsOnConversion: Record<LostCodeT, boolean>;\n    lostEntries: LostEntryT[];\n    humanReadableWarnings: string[];\n  };\n\n  /**\n   * LeftNavigation keeps the hierarchy outside of the data: a submenu has no children in its item, the consumer swaps `items` when the submenu is opened.\n   * This map gives the bridge the lists the consumer swaps in, keyed by the submenu dsId.\n   */\n  export type ChildrenByParentIdT = Record<string, readonly DSLeftNavigationT.GenericItemItemProps[]>;\n\n  export type OptionsT = {\n    childrenByParentId?: ChildrenByParentIdT;\n    HeaderComponent?: DSLeftNavigationT.GenericItemItemProps;\n    BodyHeaderComponent?: DSLeftNavigationT.GenericItemItemProps;\n    /** The header is only a link, with nothing to open: it becomes the first item of the list instead of a disclosure. */\n    headerAsFirstLeaf?: boolean;\n  };\n\n  export type ResultT = {\n    convertedItems: DSLeftNavigationTreeT.Item[];\n    convertedHeader?: DSLeftNavigationTreeT.Item;\n    convertedHeaderItems?: DSLeftNavigationTreeT.Item[];\n    report: ReportMutableT;\n  };\n}\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;ACAA,YAAuB;",
+  "names": []
+}

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

@@ -0,0 +1,58 @@
+"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 validateIds_exports = {};
+__export(validateIds_exports, {
+  reportIdProblems: () => reportIdProblems
+});
+module.exports = __toCommonJS(validateIds_exports);
+var React = __toESM(require("react"));
+var import_report = require("./report.js");
+const collectIds = (items, ids = []) => {
+  items.forEach((item) => {
+    ids.push(item.dsId);
+    collectIds(item.itemOpts?.items ?? [], ids);
+  });
+  return ids;
+};
+const reportIdProblems = (items, report, extraIds = []) => {
+  const seen = /* @__PURE__ */ new Set();
+  const reported = /* @__PURE__ */ new Set();
+  [...extraIds, ...collectIds(items)].forEach((dsId) => {
+    if (!dsId) {
+      (0, import_report.markLost)(report, { code: "missing-id", dsId: "", message: "An item has no dsId" });
+      return;
+    }
+    if (seen.has(dsId) && !reported.has(dsId)) {
+      reported.add(dsId);
+      (0, import_report.markLost)(report, { code: "duplicate-id", dsId, message: "The dsId is used by more than one item" });
+    }
+    seen.add(dsId);
+  });
+};
+//# sourceMappingURL=validateIds.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/exported-related/conversion-utils/validateIds.ts", "../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import type { DSLeftNavigationTreeT } from '@elliemae/ds-left-navigation-tree';\nimport { markLost } from './report.js';\nimport type { DSLeftNavBridgeT } from './types.js';\n\ntype NewItemT = DSLeftNavigationTreeT.Item;\n\nconst collectIds = (items: readonly NewItemT[], ids: string[] = []): string[] => {\n  items.forEach((item) => {\n    ids.push(item.dsId);\n    collectIds(item.itemOpts?.items ?? [], ids);\n  });\n  return ids;\n};\n\n/**\n * The tree finds items by `dsId` across every level of the list it receives, LeftNavigation only needed them unique inside each list it showed.\n * Reports the items without one and the ids that repeat, once per repeated id.\n */\nexport const reportIdProblems = (\n  items: readonly NewItemT[],\n  report: DSLeftNavBridgeT.ReportMutableT,\n  extraIds: readonly string[] = [],\n) => {\n  const seen = new Set<string>();\n  const reported = new Set<string>();\n  [...extraIds, ...collectIds(items)].forEach((dsId) => {\n    if (!dsId) {\n      markLost(report, { code: 'missing-id', dsId: '', message: 'An item has no dsId' });\n      return;\n    }\n    if (seen.has(dsId) && !reported.has(dsId)) {\n      reported.add(dsId);\n      markLost(report, { code: 'duplicate-id', dsId, message: 'The dsId is used by more than one item' });\n    }\n    seen.add(dsId);\n  });\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADCvB,oBAAyB;AAKzB,MAAM,aAAa,CAAC,OAA4B,MAAgB,CAAC,MAAgB;AAC/E,QAAM,QAAQ,CAAC,SAAS;AACtB,QAAI,KAAK,KAAK,IAAI;AAClB,eAAW,KAAK,UAAU,SAAS,CAAC,GAAG,GAAG;AAAA,EAC5C,CAAC;AACD,SAAO;AACT;AAMO,MAAM,mBAAmB,CAC9B,OACA,QACA,WAA8B,CAAC,MAC5B;AACH,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,WAAW,oBAAI,IAAY;AACjC,GAAC,GAAG,UAAU,GAAG,WAAW,KAAK,CAAC,EAAE,QAAQ,CAAC,SAAS;AACpD,QAAI,CAAC,MAAM;AACT,kCAAS,QAAQ,EAAE,MAAM,cAAc,MAAM,IAAI,SAAS,sBAAsB,CAAC;AACjF;AAAA,IACF;AACA,QAAI,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,GAAG;AACzC,eAAS,IAAI,IAAI;AACjB,kCAAS,QAAQ,EAAE,MAAM,gBAAgB,MAAM,SAAS,yCAAyC,CAAC;AAAA,IACpG;AACA,SAAK,IAAI,IAAI;AAAA,EACf,CAAC;AACH;",
+  "names": []
+}