@acmekit/docs-ui 2.13.41

package/src/utils/set-obj-value.ts

@@ -0,0 +1,38 @@
+type Params = {
+  obj: Record<string, unknown>
+  value: unknown
+  path: string
+}
+
+export default function setObjValue({
+  obj,
+  value,
+  path,
+}: Params): Record<string, unknown> {
+  // split path by delimiter
+  const splitPath = path.split(".")
+  const targetKey = splitPath[0]
+
+  if (!Object.hasOwn(obj, targetKey)) {
+    obj[targetKey] = {}
+  }
+
+  if (splitPath.length === 1) {
+    obj[targetKey] = value
+    return obj
+  }
+
+  if (typeof obj[targetKey] !== "object") {
+    throw new Error(
+      `value of ${targetKey} is not an object, so can't set nested value`
+    )
+  }
+
+  setObjValue({
+    obj: obj[targetKey] as Record<string, unknown>,
+    value,
+    path: splitPath.slice(1).join("."),
+  })
+
+  return obj
+}

package/src/utils/sidebar-utils.ts

@@ -0,0 +1,129 @@
+import { Sidebar } from "../types"
+
+export const isSidebarItemLink = (
+  item: Sidebar.SidebarItem | undefined,
+  options?: {
+    checkRef?: boolean
+    checkExternal?: boolean
+  }
+): item is Sidebar.SidebarItemLink => {
+  const { checkRef = true, checkExternal = true } = options || {}
+
+  return (
+    item !== undefined &&
+    (item.type === "link" ||
+      (checkRef && item.type === "ref") ||
+      (checkExternal && item.type === "external"))
+  )
+}
+
+export const areSidebarItemsEqual = ({
+  itemA,
+  itemB,
+  compareTitles = true,
+}: {
+  itemA: Sidebar.SidebarItem
+  itemB: Sidebar.SidebarItem
+  compareTitles?: boolean
+}): boolean => {
+  if (itemA.type !== itemB.type) {
+    return false
+  }
+  // after this, we know that itemA and itemB have the same type
+  switch (itemA.type) {
+    case "separator":
+      return true
+    case "sidebar":
+      return (
+        itemA.sidebar_id === (itemB as Sidebar.SidebarItemSidebar).sidebar_id
+      )
+    case "category":
+    case "sub-category":
+      return compareTitles
+        ? itemA.title === (itemB as Sidebar.SidebarItemCategory).title
+        : false
+    case "link":
+    case "ref":
+    case "external": {
+      const hasSameTitle =
+        !compareTitles ||
+        itemA.title === (itemB as Sidebar.SidebarItemLink).title
+      const hasSamePath = itemA.path === (itemB as Sidebar.SidebarItemLink).path
+
+      return hasSameTitle && hasSamePath
+    }
+  }
+}
+
+export const findSidebarItem = ({
+  sidebarItems,
+  item,
+  checkChildren = true,
+  compareTitles = true,
+}: {
+  sidebarItems: Sidebar.SidebarItem[]
+  item: Sidebar.SidebarItem
+  checkChildren?: boolean
+  compareTitles?: boolean
+}): Sidebar.SidebarItem | undefined => {
+  let foundItem: Sidebar.SidebarItem | undefined
+  sidebarItems.some((i) => {
+    if (areSidebarItemsEqual({ itemA: i, itemB: item, compareTitles })) {
+      foundItem = i
+    } else if (checkChildren && "children" in i && i.children) {
+      foundItem = findSidebarItem({
+        sidebarItems: i.children,
+        item,
+        checkChildren,
+        compareTitles,
+      })
+    }
+
+    return foundItem !== undefined
+  })
+
+  return foundItem
+}
+
+export const getSidebarItemWithHistory = ({
+  sidebarItems,
+  item,
+  sidebarHistory = [],
+  checkChildren = true,
+  compareTitles = true,
+}: {
+  sidebarItems: Sidebar.SidebarItem[]
+  item: Sidebar.SidebarItem
+  sidebarHistory?: string[]
+  checkChildren?: boolean
+  compareTitles?: boolean
+}): {
+  item: Sidebar.SidebarItem | undefined
+  sidebarHistory: string[]
+} => {
+  let foundItem: Sidebar.SidebarItem | undefined
+  sidebarItems.some((i) => {
+    if (areSidebarItemsEqual({ itemA: i, itemB: item, compareTitles })) {
+      foundItem = i
+    } else if (checkChildren && "children" in i && i.children) {
+      const result = getSidebarItemWithHistory({
+        sidebarItems: i.children,
+        item,
+        checkChildren,
+        compareTitles,
+      })
+
+      if (result.item) {
+        foundItem = result.item
+        if (i.type === "sidebar") {
+          sidebarHistory.push(i.sidebar_id)
+        }
+        sidebarHistory.push(...result.sidebarHistory)
+      }
+    }
+
+    return foundItem !== undefined
+  })
+
+  return { item: foundItem, sidebarHistory }
+}