wiki-graph-core 0.3.1 → 0.4.0

package/dist/api/chapter/tree.js

@@ -0,0 +1,387 @@
+import {
+  collectChapterPathById,
+  formatChapterUri,
+  parseChapterUriPath
+} from "../../document/chapter/path.js";
+function appendChildToChapter(items, parentChapterId, child) {
+  for (const item of items) {
+    if (item.serialId === parentChapterId) {
+      item.children = [...item.children, child];
+      return true;
+    }
+    if (appendChildToChapter(item.children, parentChapterId, child)) {
+      return true;
+    }
+  }
+  return false;
+}
+function createChapterTreeApplyResult(oldMetas, newMetas) {
+  const moved = [];
+  const renamed = [];
+  let unchanged = 0;
+  for (const [chapterId, oldMeta] of oldMetas) {
+    const newMeta = newMetas.get(chapterId);
+    if (newMeta === void 0) {
+      continue;
+    }
+    const movedChapter = oldMeta.parentChapterId !== newMeta.parentChapterId || oldMeta.index !== newMeta.index;
+    const renamedChapter = oldMeta.title !== newMeta.title;
+    if (movedChapter) {
+      moved.push({
+        newUri: formatChapterUri(newMeta.path.join("/")),
+        newIndex: newMeta.index,
+        newPath: newMeta.path,
+        newParentUri: formatParentChapterUri(newMeta.path),
+        oldUri: formatChapterUri(oldMeta.path.join("/")),
+        oldIndex: oldMeta.index,
+        oldPath: oldMeta.path,
+        oldParentUri: formatParentChapterUri(oldMeta.path)
+      });
+    }
+    if (renamedChapter) {
+      renamed.push({
+        uri: formatChapterUri(newMeta.path.join("/")),
+        newTitle: newMeta.title,
+        oldTitle: oldMeta.title
+      });
+    }
+    if (!movedChapter && !renamedChapter) {
+      unchanged += 1;
+    }
+  }
+  return {
+    changed: moved.length > 0 || renamed.length > 0,
+    moved,
+    renamed,
+    unchanged
+  };
+}
+function formatParentChapterUri(path) {
+  const parentPath = path.slice(0, -1);
+  return parentPath.length === 0 ? null : formatChapterUri(parentPath.join("/"));
+}
+function createTocItemsFromChapterTree(tree, oldItems) {
+  const oldItemsById = /* @__PURE__ */ new Map();
+  const oldItemsByKey = /* @__PURE__ */ new Map();
+  const oldIds = /* @__PURE__ */ new Set();
+  for (const oldItem of oldItems) {
+    collectTocItemsById(oldItem, oldItemsById, oldItemsByKey, oldIds);
+  }
+  const seenIds = /* @__PURE__ */ new Set();
+  const items = tree.chapters.map(
+    (node) => createTocItemFromChapterTreeNode(
+      node,
+      oldItemsById,
+      oldItemsByKey,
+      seenIds,
+      []
+    )
+  );
+  const missingIds = [...oldIds].filter((id) => !seenIds.has(id));
+  if (missingIds.length > 0) {
+    throw new Error(
+      `Chapter tree is missing chapter URIs: ${missingIds.map((id) => {
+        const path = collectChapterPathById(oldItems, id);
+        return path === void 0 ? "<unresolved internal chapter>" : formatChapterUri(path);
+      }).join(", ")}.`
+    );
+  }
+  return { items };
+}
+function createTocItemFromChapterTreeNode(node, oldItemsById, oldItemsByKey, seenIds, expectedParentPath) {
+  const nodePath = parseChapterUriPath(node.uri);
+  if (nodePath === void 0) {
+    throw new Error(
+      `Chapter tree node URI must be a chapter URI: ${node.uri}.`
+    );
+  }
+  const pathParts = nodePath.split("/");
+  const actualParentPath = pathParts.slice(0, -1);
+  if (actualParentPath.join("/") !== expectedParentPath.join("/")) {
+    throw new Error(
+      `Chapter tree URI ${node.uri} does not match its JSON parent path.`
+    );
+  }
+  const key = pathParts.at(-1);
+  const oldItemByKey = key === void 0 ? void 0 : oldItemsByKey.get(key);
+  const nodeId = oldItemByKey?.serialId;
+  const oldItem = nodeId === void 0 ? void 0 : oldItemsById.get(nodeId);
+  if (nodeId === void 0 || oldItem === void 0) {
+    throw new Error(
+      `Chapter tree references unknown chapter URI: ${node.uri}.`
+    );
+  }
+  if (seenIds.has(nodeId)) {
+    throw new Error(`Chapter tree repeats chapter URI: ${node.uri}.`);
+  }
+  seenIds.add(nodeId);
+  const title = Object.prototype.hasOwnProperty.call(node, "title") ? normalizeTitle(node.title) : normalizeTitle(oldItem.title);
+  const item = {
+    children: node.children.map(
+      (child) => createTocItemFromChapterTreeNode(
+        child,
+        oldItemsById,
+        oldItemsByKey,
+        seenIds,
+        pathParts
+      )
+    ),
+    key: oldItem.key,
+    serialId: nodeId
+  };
+  if (title !== void 0) {
+    item.title = title;
+  }
+  return item;
+}
+function collectTocItemsById(item, itemsById, itemsByKey, ids) {
+  if (item.serialId !== void 0) {
+    itemsById.set(item.serialId, item);
+    ids.add(item.serialId);
+  }
+  if (item.key !== void 0) {
+    itemsByKey.set(item.key, item);
+  }
+  for (const child of item.children) {
+    collectTocItemsById(child, itemsById, itemsByKey, ids);
+  }
+}
+function collectTocItemMetas(items, parentChapterId = null, parentPath = []) {
+  const metas = /* @__PURE__ */ new Map();
+  items.forEach((item, index) => {
+    if (item.serialId === void 0) {
+      return;
+    }
+    const title = normalizeTitle(item.title) ?? null;
+    const key = item.key ?? `chapter-${item.serialId}`;
+    const path = [...parentPath, key];
+    metas.set(item.serialId, {
+      index,
+      parentChapterId,
+      path,
+      title
+    });
+    for (const [childId, childMeta] of collectTocItemMetas(
+      item.children,
+      item.serialId,
+      path
+    )) {
+      metas.set(childId, childMeta);
+    }
+  });
+  return metas;
+}
+function extractChapterItem(items, chapterId) {
+  const nextItems = [];
+  for (const item of items) {
+    if (item.serialId === chapterId) {
+      return {
+        item,
+        items: [...nextItems, ...items.slice(nextItems.length + 1)]
+      };
+    }
+    const childResult = extractChapterItem(item.children, chapterId);
+    if (childResult.item !== void 0) {
+      nextItems.push({
+        ...item,
+        children: childResult.items
+      });
+      nextItems.push(...items.slice(nextItems.length));
+      return {
+        item: childResult.item,
+        items: nextItems
+      };
+    }
+    nextItems.push(item);
+  }
+  return {
+    items: [...items]
+  };
+}
+function findChildContainer(items, parentChapterId) {
+  if (parentChapterId === void 0) {
+    return items;
+  }
+  for (const item of items) {
+    if (item.serialId === parentChapterId) {
+      return item.children;
+    }
+    const childContainer = findChildContainer(item.children, parentChapterId);
+    if (childContainer !== void 0) {
+      return childContainer;
+    }
+  }
+  return void 0;
+}
+function findChapterLocation(items, chapterId) {
+  return findChapterLocationInItems(items, chapterId);
+}
+function findChapterLocationInItems(items, chapterId, parentChapterId) {
+  for (const [index, item] of items.entries()) {
+    if (item.serialId === chapterId) {
+      return {
+        index,
+        parentChapterId,
+        siblings: items
+      };
+    }
+    const location = findChapterLocationInItems(
+      item.children,
+      chapterId,
+      item.serialId
+    );
+    if (location !== void 0) {
+      return location;
+    }
+  }
+  return void 0;
+}
+function insertMovedChapter(items, item, options) {
+  if (options.beforeChapterId !== void 0 || options.afterChapterId !== void 0) {
+    const targetChapterId = options.beforeChapterId ?? options.afterChapterId;
+    const location = findChapterLocation(items, targetChapterId);
+    if (location === void 0) {
+      throw new Error(`Target chapter ${targetChapterId} does not exist.`);
+    }
+    location.siblings.splice(
+      options.beforeChapterId === void 0 ? location.index + 1 : location.index,
+      0,
+      item
+    );
+    return;
+  }
+  const parentChapterId = options.root === true ? void 0 : options.parentChapterId !== void 0 ? options.parentChapterId : options.originalParentChapterId;
+  const container = findChildContainer(items, parentChapterId);
+  if (container === void 0) {
+    throw new Error(`Chapter ${parentChapterId} does not exist.`);
+  }
+  if (options.first === true) {
+    container.splice(0, 0, item);
+  } else {
+    container.push(item);
+  }
+}
+function rejectMoveIntoOwnSubtree(chapterId, item, options) {
+  const targetIds = [
+    options.parentChapterId,
+    options.beforeChapterId,
+    options.afterChapterId
+  ].filter((id) => id !== void 0);
+  for (const targetId of targetIds) {
+    if (targetId === chapterId || containsChapterId(item.children, targetId)) {
+      throw new Error(
+        `Cannot move chapter ${chapterId} into or next to its own descendant ${targetId}.`
+      );
+    }
+  }
+}
+function containsChapterId(items, chapterId) {
+  for (const item of items) {
+    if (item.serialId === chapterId || containsChapterId(item.children, chapterId)) {
+      return true;
+    }
+  }
+  return false;
+}
+function cloneTocItem(item) {
+  return {
+    children: item.children.map(cloneTocItem),
+    ...item.key === void 0 ? {} : { key: item.key },
+    ...item.serialId === void 0 ? {} : { serialId: item.serialId },
+    title: item.title
+  };
+}
+function toChapterTreeNode(item, parentPath) {
+  if (item.serialId === void 0) {
+    throw new Error("Internal error: normalized chapter tree has no id.");
+  }
+  const key = item.key ?? `chapter-${item.serialId}`;
+  const path = [...parentPath, key];
+  return {
+    children: item.children.flatMap((child) => toChapterTreeNodes(child, path)),
+    title: normalizeTitle(item.title) ?? null,
+    uri: formatChapterUri(path.join("/"))
+  };
+}
+function toChapterTreeNodes(item, parentPath = []) {
+  return item.serialId === void 0 ? item.children.flatMap((child) => toChapterTreeNodes(child, parentPath)) : [toChapterTreeNode(item, parentPath)];
+}
+function normalizeTitle(title) {
+  const normalized = title?.trim();
+  return normalized === void 0 || normalized === "" ? void 0 : normalized;
+}
+function removeChapterFromItems(items, chapterId, options) {
+  const nextItems = [];
+  let removed = false;
+  for (const item of items) {
+    if (item.serialId === chapterId) {
+      if (!options.recursive && item.children.length > 0) {
+        throw new Error(
+          `Chapter ${chapterId} has child chapters. Use --recursive to remove it and its descendants.`
+        );
+      }
+      collectChapterIds(item, options.removedChapterIds);
+      removed = true;
+      continue;
+    }
+    const childResult = removeChapterFromItems(
+      item.children,
+      chapterId,
+      options
+    );
+    nextItems.push({
+      ...item,
+      children: childResult.items
+    });
+    removed ||= childResult.removed;
+  }
+  return {
+    items: nextItems,
+    removed
+  };
+}
+function setChapterTitleInItems(items, chapterId, title) {
+  for (const item of items) {
+    if (item.serialId === chapterId) {
+      if (title === void 0) {
+        delete item.title;
+      } else {
+        item.title = title;
+      }
+      return true;
+    }
+    if (setChapterTitleInItems(item.children, chapterId, title)) {
+      return true;
+    }
+  }
+  return false;
+}
+function collectChapterIds(item, chapterIds) {
+  if (item.serialId !== void 0) {
+    if (Array.isArray(chapterIds)) {
+      chapterIds.push(item.serialId);
+    } else {
+      chapterIds.add(item.serialId);
+    }
+  }
+  for (const child of item.children) {
+    collectChapterIds(child, chapterIds);
+  }
+}
+export {
+  appendChildToChapter,
+  cloneTocItem,
+  collectChapterIds,
+  collectTocItemMetas,
+  createChapterTreeApplyResult,
+  createTocItemsFromChapterTree,
+  extractChapterItem,
+  findChapterLocation,
+  insertMovedChapter,
+  normalizeTitle,
+  rejectMoveIntoOwnSubtree,
+  removeChapterFromItems,
+  setChapterTitleInItems,
+  toChapterTreeNodes
+};
+//# sourceMappingURL=tree.js.map

package/dist/api/chapter/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/api/chapter/tree.ts"],"sourcesContent":["import type { TOC_FILE_VERSION, TocItem } from \"../../text/source/index.js\";\nimport {\n  collectChapterPathById,\n  formatChapterUri,\n  parseChapterUriPath,\n} from \"../../document/chapter/path.js\";\nimport type {\n  ChapterTreeApplyResult,\n  ChapterTreeInput,\n  ChapterTreeInputNode,\n  ChapterTreeMoveChange,\n  ChapterTreeNode,\n  ChapterTreeTitleChange,\n  MoveChapterOptions,\n} from \"./types.js\";\n\nexport function appendChildToChapter(\n  items: MutableTocItem[],\n  parentChapterId: number,\n  child: MutableTocItem,\n): boolean {\n  for (const item of items) {\n    if (item.serialId === parentChapterId) {\n      item.children = [...item.children, child];\n      return true;\n    }\n\n    if (appendChildToChapter(item.children, parentChapterId, child)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function createChapterTreeApplyResult(\n  oldMetas: Map<number, TocItemMeta>,\n  newMetas: Map<number, TocItemMeta>,\n): ChapterTreeApplyResult {\n  const moved: ChapterTreeMoveChange[] = [];\n  const renamed: ChapterTreeTitleChange[] = [];\n  let unchanged = 0;\n\n  for (const [chapterId, oldMeta] of oldMetas) {\n    const newMeta = newMetas.get(chapterId);\n\n    if (newMeta === undefined) {\n      continue;\n    }\n\n    const movedChapter =\n      oldMeta.parentChapterId !== newMeta.parentChapterId ||\n      oldMeta.index !== newMeta.index;\n    const renamedChapter = oldMeta.title !== newMeta.title;\n\n    if (movedChapter) {\n      moved.push({\n        newUri: formatChapterUri(newMeta.path.join(\"/\")),\n        newIndex: newMeta.index,\n        newPath: newMeta.path,\n        newParentUri: formatParentChapterUri(newMeta.path),\n        oldUri: formatChapterUri(oldMeta.path.join(\"/\")),\n        oldIndex: oldMeta.index,\n        oldPath: oldMeta.path,\n        oldParentUri: formatParentChapterUri(oldMeta.path),\n      });\n    }\n    if (renamedChapter) {\n      renamed.push({\n        uri: formatChapterUri(newMeta.path.join(\"/\")),\n        newTitle: newMeta.title,\n        oldTitle: oldMeta.title,\n      });\n    }\n    if (!movedChapter && !renamedChapter) {\n      unchanged += 1;\n    }\n  }\n\n  return {\n    changed: moved.length > 0 || renamed.length > 0,\n    moved,\n    renamed,\n    unchanged,\n  };\n}\n\nfunction formatParentChapterUri(path: readonly string[]): string | null {\n  const parentPath = path.slice(0, -1);\n\n  return parentPath.length === 0\n    ? null\n    : formatChapterUri(parentPath.join(\"/\"));\n}\n\nexport function createTocItemsFromChapterTree(\n  tree: ChapterTreeInput,\n  oldItems: readonly MutableTocItem[],\n): { readonly items: MutableTocItem[] } {\n  const oldItemsById = new Map<number, MutableTocItem>();\n  const oldItemsByKey = new Map<string, MutableTocItem>();\n  const oldIds = new Set<number>();\n\n  for (const oldItem of oldItems) {\n    collectTocItemsById(oldItem, oldItemsById, oldItemsByKey, oldIds);\n  }\n\n  const seenIds = new Set<number>();\n  const items = tree.chapters.map((node) =>\n    createTocItemFromChapterTreeNode(\n      node,\n      oldItemsById,\n      oldItemsByKey,\n      seenIds,\n      [],\n    ),\n  );\n  const missingIds = [...oldIds].filter((id) => !seenIds.has(id));\n\n  if (missingIds.length > 0) {\n    throw new Error(\n      `Chapter tree is missing chapter URIs: ${missingIds\n        .map((id) => {\n          const path = collectChapterPathById(oldItems, id);\n          return path === undefined\n            ? \"<unresolved internal chapter>\"\n            : formatChapterUri(path);\n        })\n        .join(\", \")}.`,\n    );\n  }\n\n  return { items };\n}\n\nfunction createTocItemFromChapterTreeNode(\n  node: ChapterTreeInputNode,\n  oldItemsById: Map<number, MutableTocItem>,\n  oldItemsByKey: Map<string, MutableTocItem>,\n  seenIds: Set<number>,\n  expectedParentPath: readonly string[],\n): MutableTocItem {\n  const nodePath = parseChapterUriPath(node.uri);\n\n  if (nodePath === undefined) {\n    throw new Error(\n      `Chapter tree node URI must be a chapter URI: ${node.uri}.`,\n    );\n  }\n  const pathParts = nodePath.split(\"/\");\n  const actualParentPath = pathParts.slice(0, -1);\n  if (actualParentPath.join(\"/\") !== expectedParentPath.join(\"/\")) {\n    throw new Error(\n      `Chapter tree URI ${node.uri} does not match its JSON parent path.`,\n    );\n  }\n  const key = pathParts.at(-1);\n  const oldItemByKey = key === undefined ? undefined : oldItemsByKey.get(key);\n  const nodeId = oldItemByKey?.serialId;\n  const oldItem = nodeId === undefined ? undefined : oldItemsById.get(nodeId);\n\n  if (nodeId === undefined || oldItem === undefined) {\n    throw new Error(\n      `Chapter tree references unknown chapter URI: ${node.uri}.`,\n    );\n  }\n  if (seenIds.has(nodeId)) {\n    throw new Error(`Chapter tree repeats chapter URI: ${node.uri}.`);\n  }\n  seenIds.add(nodeId);\n\n  const title = Object.prototype.hasOwnProperty.call(node, \"title\")\n    ? normalizeTitle(node.title)\n    : normalizeTitle(oldItem.title);\n  const item: MutableTocItem = {\n    children: node.children.map((child) =>\n      createTocItemFromChapterTreeNode(\n        child,\n        oldItemsById,\n        oldItemsByKey,\n        seenIds,\n        pathParts,\n      ),\n    ),\n    key: oldItem.key,\n    serialId: nodeId,\n  };\n\n  if (title !== undefined) {\n    item.title = title;\n  }\n\n  return item;\n}\n\nfunction collectTocItemsById(\n  item: MutableTocItem,\n  itemsById: Map<number, MutableTocItem>,\n  itemsByKey: Map<string, MutableTocItem>,\n  ids: Set<number>,\n): void {\n  if (item.serialId !== undefined) {\n    itemsById.set(item.serialId, item);\n    ids.add(item.serialId);\n  }\n  if (item.key !== undefined) {\n    itemsByKey.set(item.key, item);\n  }\n\n  for (const child of item.children) {\n    collectTocItemsById(child, itemsById, itemsByKey, ids);\n  }\n}\n\nexport function collectTocItemMetas(\n  items: readonly MutableTocItem[],\n  parentChapterId: number | null = null,\n  parentPath: readonly string[] = [],\n): Map<number, TocItemMeta> {\n  const metas = new Map<number, TocItemMeta>();\n\n  items.forEach((item, index) => {\n    if (item.serialId === undefined) {\n      return;\n    }\n\n    const title = normalizeTitle(item.title) ?? null;\n    const key = item.key ?? `chapter-${item.serialId}`;\n    const path = [...parentPath, key];\n\n    metas.set(item.serialId, {\n      index,\n      parentChapterId,\n      path,\n      title,\n    });\n\n    for (const [childId, childMeta] of collectTocItemMetas(\n      item.children,\n      item.serialId,\n      path,\n    )) {\n      metas.set(childId, childMeta);\n    }\n  });\n\n  return metas;\n}\n\nexport function extractChapterItem(\n  items: readonly MutableTocItem[],\n  chapterId: number,\n): {\n  readonly item?: MutableTocItem;\n  readonly items: MutableTocItem[];\n} {\n  const nextItems: MutableTocItem[] = [];\n\n  for (const item of items) {\n    if (item.serialId === chapterId) {\n      return {\n        item,\n        items: [...nextItems, ...items.slice(nextItems.length + 1)],\n      };\n    }\n\n    const childResult = extractChapterItem(item.children, chapterId);\n\n    if (childResult.item !== undefined) {\n      nextItems.push({\n        ...item,\n        children: childResult.items,\n      });\n      nextItems.push(...items.slice(nextItems.length));\n      return {\n        item: childResult.item,\n        items: nextItems,\n      };\n    }\n\n    nextItems.push(item);\n  }\n\n  return {\n    items: [...items],\n  };\n}\n\nfunction findChildContainer(\n  items: MutableTocItem[],\n  parentChapterId: number | undefined,\n): MutableTocItem[] | undefined {\n  if (parentChapterId === undefined) {\n    return items;\n  }\n\n  for (const item of items) {\n    if (item.serialId === parentChapterId) {\n      return item.children;\n    }\n\n    const childContainer = findChildContainer(item.children, parentChapterId);\n\n    if (childContainer !== undefined) {\n      return childContainer;\n    }\n  }\n\n  return undefined;\n}\n\nexport function findChapterLocation(\n  items: MutableTocItem[],\n  chapterId: number,\n):\n  | {\n      readonly index: number;\n      readonly parentChapterId?: number | undefined;\n      readonly siblings: MutableTocItem[];\n    }\n  | undefined {\n  return findChapterLocationInItems(items, chapterId);\n}\n\nfunction findChapterLocationInItems(\n  items: MutableTocItem[],\n  chapterId: number,\n  parentChapterId?: number,\n):\n  | {\n      readonly index: number;\n      readonly parentChapterId?: number | undefined;\n      readonly siblings: MutableTocItem[];\n    }\n  | undefined {\n  for (const [index, item] of items.entries()) {\n    if (item.serialId === chapterId) {\n      return {\n        index,\n        parentChapterId,\n        siblings: items,\n      };\n    }\n\n    const location = findChapterLocationInItems(\n      item.children,\n      chapterId,\n      item.serialId,\n    );\n\n    if (location !== undefined) {\n      return location;\n    }\n  }\n\n  return undefined;\n}\n\nexport function insertMovedChapter(\n  items: MutableTocItem[],\n  item: MutableTocItem,\n  options: MoveChapterOptions & {\n    readonly originalParentChapterId?: number | undefined;\n  },\n): void {\n  if (\n    options.beforeChapterId !== undefined ||\n    options.afterChapterId !== undefined\n  ) {\n    const targetChapterId = options.beforeChapterId ?? options.afterChapterId!;\n    const location = findChapterLocation(items, targetChapterId);\n\n    if (location === undefined) {\n      throw new Error(`Target chapter ${targetChapterId} does not exist.`);\n    }\n\n    location.siblings.splice(\n      options.beforeChapterId === undefined\n        ? location.index + 1\n        : location.index,\n      0,\n      item,\n    );\n    return;\n  }\n\n  const parentChapterId =\n    options.root === true\n      ? undefined\n      : options.parentChapterId !== undefined\n        ? options.parentChapterId\n        : options.originalParentChapterId;\n  const container = findChildContainer(items, parentChapterId);\n\n  if (container === undefined) {\n    throw new Error(`Chapter ${parentChapterId} does not exist.`);\n  }\n\n  if (options.first === true) {\n    container.splice(0, 0, item);\n  } else {\n    container.push(item);\n  }\n}\n\nexport function rejectMoveIntoOwnSubtree(\n  chapterId: number,\n  item: MutableTocItem,\n  options: MoveChapterOptions,\n): void {\n  const targetIds = [\n    options.parentChapterId,\n    options.beforeChapterId,\n    options.afterChapterId,\n  ].filter((id): id is number => id !== undefined);\n\n  for (const targetId of targetIds) {\n    if (targetId === chapterId || containsChapterId(item.children, targetId)) {\n      throw new Error(\n        `Cannot move chapter ${chapterId} into or next to its own descendant ${targetId}.`,\n      );\n    }\n  }\n}\n\nfunction containsChapterId(\n  items: readonly MutableTocItem[],\n  chapterId: number,\n): boolean {\n  for (const item of items) {\n    if (\n      item.serialId === chapterId ||\n      containsChapterId(item.children, chapterId)\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function cloneTocItem(item: TocItem): MutableTocItem {\n  return {\n    children: item.children.map(cloneTocItem),\n    ...(item.key === undefined ? {} : { key: item.key }),\n    ...(item.serialId === undefined ? {} : { serialId: item.serialId }),\n    title: item.title,\n  };\n}\n\nfunction toChapterTreeNode(\n  item: MutableTocItem,\n  parentPath: readonly string[],\n): ChapterTreeNode {\n  if (item.serialId === undefined) {\n    throw new Error(\"Internal error: normalized chapter tree has no id.\");\n  }\n  const key = item.key ?? `chapter-${item.serialId}`;\n  const path = [...parentPath, key];\n\n  return {\n    children: item.children.flatMap((child) => toChapterTreeNodes(child, path)),\n    title: normalizeTitle(item.title) ?? null,\n    uri: formatChapterUri(path.join(\"/\")),\n  };\n}\n\nexport function toChapterTreeNodes(\n  item: MutableTocItem,\n  parentPath: readonly string[] = [],\n): ChapterTreeNode[] {\n  return item.serialId === undefined\n    ? item.children.flatMap((child) => toChapterTreeNodes(child, parentPath))\n    : [toChapterTreeNode(item, parentPath)];\n}\n\nexport function normalizeTitle(\n  title: string | null | undefined,\n): string | undefined {\n  const normalized = title?.trim();\n\n  return normalized === undefined || normalized === \"\" ? undefined : normalized;\n}\n\nexport function removeChapterFromItems(\n  items: readonly MutableTocItem[],\n  chapterId: number,\n  options: {\n    readonly recursive: boolean;\n    readonly removedChapterIds: number[];\n  },\n): { readonly items: MutableTocItem[]; readonly removed: boolean } {\n  const nextItems: MutableTocItem[] = [];\n  let removed = false;\n\n  for (const item of items) {\n    if (item.serialId === chapterId) {\n      if (!options.recursive && item.children.length > 0) {\n        throw new Error(\n          `Chapter ${chapterId} has child chapters. Use --recursive to remove it and its descendants.`,\n        );\n      }\n\n      collectChapterIds(item, options.removedChapterIds);\n      removed = true;\n      continue;\n    }\n\n    const childResult = removeChapterFromItems(\n      item.children,\n      chapterId,\n      options,\n    );\n\n    nextItems.push({\n      ...item,\n      children: childResult.items,\n    });\n    removed ||= childResult.removed;\n  }\n\n  return {\n    items: nextItems,\n    removed,\n  };\n}\n\nexport function setChapterTitleInItems(\n  items: readonly MutableTocItem[],\n  chapterId: number,\n  title: string | undefined,\n): boolean {\n  for (const item of items) {\n    if (item.serialId === chapterId) {\n      if (title === undefined) {\n        delete item.title;\n      } else {\n        item.title = title;\n      }\n      return true;\n    }\n\n    if (setChapterTitleInItems(item.children, chapterId, title)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function collectChapterIds(\n  item: TocItem,\n  chapterIds: number[] | Set<number>,\n): void {\n  if (item.serialId !== undefined) {\n    if (Array.isArray(chapterIds)) {\n      chapterIds.push(item.serialId);\n    } else {\n      chapterIds.add(item.serialId);\n    }\n  }\n\n  for (const child of item.children) {\n    collectChapterIds(child, chapterIds);\n  }\n}\n\nexport interface MutableTocFile {\n  items: MutableTocItem[];\n  version: typeof TOC_FILE_VERSION;\n}\n\nexport interface MutableTocItem {\n  children: MutableTocItem[];\n  key?: string | undefined;\n  serialId?: number | undefined;\n  title?: string | null | undefined;\n}\n\ninterface TocItemMeta {\n  readonly index: number;\n  readonly parentChapterId: number | null;\n  readonly path: readonly string[];\n  readonly title: string | null;\n}\n"],"mappings":"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","names":[]}

package/dist/api/chapter/types.d.ts

@@ -0,0 +1,104 @@
+import { Language } from '../../runtime/common/language.js';
+import { WikiGraphScope } from '../../runtime/common/llm-scope.js';
+import { LLM } from '../../external/llm/client/core.js';
+import { ChapterStage, ChapterEntry } from '../../document/chapter/types.js';
+export { CHAPTER_STAGES, ChapterDetails, ChapterTree, ChapterTreeNode } from '../../document/chapter/types.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+
+interface ChapterTreeInput {
+    readonly chapters: readonly ChapterTreeInputNode[];
+}
+interface ChapterTreeInputNode {
+    readonly children: readonly ChapterTreeInputNode[];
+    readonly uri: string;
+    readonly title?: string | null | undefined;
+}
+interface ChapterTreeApplyResult {
+    readonly changed: boolean;
+    readonly moved: readonly ChapterTreeMoveChange[];
+    readonly renamed: readonly ChapterTreeTitleChange[];
+    readonly unchanged: number;
+}
+interface ChapterTreeMoveChange {
+    readonly newUri: string;
+    readonly newIndex: number;
+    readonly newPath: readonly string[];
+    readonly newParentUri: string | null;
+    readonly oldUri: string;
+    readonly oldIndex: number;
+    readonly oldPath: readonly string[];
+    readonly oldParentUri: string | null;
+}
+interface ChapterTreeTitleChange {
+    readonly uri: string;
+    readonly newTitle: string | null;
+    readonly oldTitle: string | null;
+}
+interface MoveChapterOptions {
+    readonly afterChapterId?: number;
+    readonly beforeChapterId?: number;
+    readonly first?: boolean;
+    readonly last?: boolean;
+    readonly parentChapterId?: number;
+    readonly root?: boolean;
+}
+interface AdvanceChapterStagesOptions {
+    readonly chapterId?: number;
+    readonly extractionPrompt?: string;
+    readonly llm: LLM<WikiGraphScope>;
+    readonly logDirPath?: string;
+    readonly onProgress?: AdvanceChapterStagesProgressCallback;
+    readonly targetStage: ChapterStage;
+    readonly userLanguage?: Language;
+}
+interface AdvanceChapterStagesProgressState {
+    readonly graphWords: number;
+    readonly summaryWords: number;
+    readonly totalGraphWords: number;
+    readonly totalSummaryWords: number;
+}
+type AdvanceChapterStagesProgressCallback = (event: AdvanceChapterStagesProgressEvent) => void | Promise<void>;
+type AdvanceChapterStagesProgressEvent = {
+    readonly type: "selected";
+    readonly state: AdvanceChapterStagesProgressState;
+    readonly targetStage: ChapterStage;
+    readonly totalChapters: number;
+} | {
+    readonly type: "skipped";
+    readonly chapter: ChapterEntry;
+    readonly reason: "planned";
+    readonly targetStage: ChapterStage;
+} | {
+    readonly type: "progress";
+    readonly state: AdvanceChapterStagesProgressState;
+    readonly targetStage: ChapterStage;
+} | {
+    readonly type: "started";
+    readonly chapter: ChapterEntry;
+    readonly step: "graph" | "summary";
+    readonly targetStage: ChapterStage;
+} | {
+    readonly type: "completed";
+    readonly chapter: ChapterEntry;
+    readonly step: "graph" | "summary";
+    readonly targetStage: ChapterStage;
+};
+interface AdvanceChapterStagesResult {
+    readonly advanced: readonly ChapterEntry[];
+    readonly pending: readonly ChapterEntry[];
+    readonly skipped: readonly ChapterEntry[];
+}
+interface MutableAdvanceProgressState {
+    addGraphWords(words: number): void;
+    addSummaryWords(words: number): void;
+    snapshot(): AdvanceChapterStagesProgressState;
+}
+interface AddChapterOptions {
+    readonly parentChapterId?: number;
+    readonly title?: string | null | undefined;
+}
+
+export { type AddChapterOptions, type AdvanceChapterStagesOptions, type AdvanceChapterStagesProgressCallback, type AdvanceChapterStagesProgressEvent, type AdvanceChapterStagesProgressState, type AdvanceChapterStagesResult, ChapterEntry, ChapterStage, type ChapterTreeApplyResult, type ChapterTreeInput, type ChapterTreeInputNode, type ChapterTreeMoveChange, type ChapterTreeTitleChange, type MoveChapterOptions, type MutableAdvanceProgressState };

package/dist/api/chapter/types.js

@@ -0,0 +1,5 @@
+import { CHAPTER_STAGES } from "../../document/chapter/index.js";
+export {
+  CHAPTER_STAGES
+};
+//# sourceMappingURL=types.js.map

package/dist/api/chapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/api/chapter/types.ts"],"sourcesContent":["import type { Language } from \"../../runtime/common/language.js\";\nimport type { WikiGraphScope } from \"../../runtime/common/llm-scope.js\";\nimport type { LLM } from \"../../external/llm/index.js\";\nexport { CHAPTER_STAGES } from \"../../document/chapter/index.js\";\nexport type {\n  ChapterDetails,\n  ChapterEntry,\n  ChapterStage,\n  ChapterTree,\n  ChapterTreeNode,\n} from \"../../document/chapter/index.js\";\nimport type {\n  ChapterEntry,\n  ChapterStage,\n} from \"../../document/chapter/index.js\";\n\nexport interface ChapterTreeInput {\n  readonly chapters: readonly ChapterTreeInputNode[];\n}\n\nexport interface ChapterTreeInputNode {\n  readonly children: readonly ChapterTreeInputNode[];\n  readonly uri: string;\n  readonly title?: string | null | undefined;\n}\n\nexport interface ChapterTreeApplyResult {\n  readonly changed: boolean;\n  readonly moved: readonly ChapterTreeMoveChange[];\n  readonly renamed: readonly ChapterTreeTitleChange[];\n  readonly unchanged: number;\n}\n\nexport interface ChapterTreeMoveChange {\n  readonly newUri: string;\n  readonly newIndex: number;\n  readonly newPath: readonly string[];\n  readonly newParentUri: string | null;\n  readonly oldUri: string;\n  readonly oldIndex: number;\n  readonly oldPath: readonly string[];\n  readonly oldParentUri: string | null;\n}\n\nexport interface ChapterTreeTitleChange {\n  readonly uri: string;\n  readonly newTitle: string | null;\n  readonly oldTitle: string | null;\n}\n\nexport interface MoveChapterOptions {\n  readonly afterChapterId?: number;\n  readonly beforeChapterId?: number;\n  readonly first?: boolean;\n  readonly last?: boolean;\n  readonly parentChapterId?: number;\n  readonly root?: boolean;\n}\n\nexport interface AdvanceChapterStagesOptions {\n  readonly chapterId?: number;\n  readonly extractionPrompt?: string;\n  readonly llm: LLM<WikiGraphScope>;\n  readonly logDirPath?: string;\n  readonly onProgress?: AdvanceChapterStagesProgressCallback;\n  readonly targetStage: ChapterStage;\n  readonly userLanguage?: Language;\n}\n\nexport interface AdvanceChapterStagesProgressState {\n  readonly graphWords: number;\n  readonly summaryWords: number;\n  readonly totalGraphWords: number;\n  readonly totalSummaryWords: number;\n}\n\nexport type AdvanceChapterStagesProgressCallback = (\n  event: AdvanceChapterStagesProgressEvent,\n) => void | Promise<void>;\n\nexport type AdvanceChapterStagesProgressEvent =\n  | {\n      readonly type: \"selected\";\n      readonly state: AdvanceChapterStagesProgressState;\n      readonly targetStage: ChapterStage;\n      readonly totalChapters: number;\n    }\n  | {\n      readonly type: \"skipped\";\n      readonly chapter: ChapterEntry;\n      readonly reason: \"planned\";\n      readonly targetStage: ChapterStage;\n    }\n  | {\n      readonly type: \"progress\";\n      readonly state: AdvanceChapterStagesProgressState;\n      readonly targetStage: ChapterStage;\n    }\n  | {\n      readonly type: \"started\";\n      readonly chapter: ChapterEntry;\n      readonly step: \"graph\" | \"summary\";\n      readonly targetStage: ChapterStage;\n    }\n  | {\n      readonly type: \"completed\";\n      readonly chapter: ChapterEntry;\n      readonly step: \"graph\" | \"summary\";\n      readonly targetStage: ChapterStage;\n    };\n\nexport interface AdvanceChapterStagesResult {\n  readonly advanced: readonly ChapterEntry[];\n  readonly pending: readonly ChapterEntry[];\n  readonly skipped: readonly ChapterEntry[];\n}\n\nexport interface MutableAdvanceProgressState {\n  addGraphWords(words: number): void;\n  addSummaryWords(words: number): void;\n  snapshot(): AdvanceChapterStagesProgressState;\n}\n\nexport interface AddChapterOptions {\n  readonly parentChapterId?: number;\n  readonly title?: string | null | undefined;\n}\n"],"mappings":"AAGA,SAAS,sBAAsB;","names":[]}

package/dist/api/chapter-build/index.d.ts

@@ -0,0 +1,42 @@
+export { buildChapterGraphArtifact, commitChapterGraphArtifact } from '../../graph/reading-build/artifact.js';
+export { readChapterBuildInput } from '../../graph/reading-build/input.js';
+export { BuildChapterGraphArtifactOptions, ChapterGraphBuildArtifact, GraphBuildParameterInput } from '../../graph/reading-build/types.js';
+export { buildChapterSummaryArtifact, buildChapterSummaryArtifactFromReadingGraphObjects, buildChapterSummaryArtifactFromSnapshot, commitChapterSummaryArtifact, snapshotChapterSummaryInput } from '../../text/summary-build/artifact.js';
+export { collectReaderText, readChapterSource, readSerialFragments } from '../../text/summary-build/source.js';
+export { BuildChapterSummaryArtifactOptions, ChapterSummaryInputSnapshot, SummaryInputSnapshotData } from '../../text/summary-build/types.js';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../document/chapter/types.js';
+import '../../external/llm/client/core.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+import '../../runtime/common/language.js';
+import '../../runtime/common/llm-scope.js';
+import '../../text/serial/options.js';
+import '../../text/reader/types.js';
+import '../../text/reader/attention/core.js';
+import '../../text/reader/chunk-batch/types.js';
+import '../../text/reader/segment/types.js';

package/dist/api/chapter-build/index.js

@@ -0,0 +1,3 @@
+export * from "../../graph/reading-build/index.js";
+export * from "../../text/summary-build/index.js";
+//# sourceMappingURL=index.js.map

package/dist/api/chapter-build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/api/chapter-build/index.ts"],"sourcesContent":["export * from \"../../graph/reading-build/index.js\";\nexport * from \"../../text/summary-build/index.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/api/chapter-build/types.d.ts

@@ -0,0 +1,37 @@
+export { BuildChapterGraphArtifactOptions, ChapterGraphBuildArtifact, GraphBuildParameterInput } from '../../graph/reading-build/types.js';
+export { BuildChapterSummaryArtifactOptions, ChapterSummaryInputSnapshot, SummaryInputSnapshotData } from '../../text/summary-build/types.js';
+import '../../external/llm/client/core.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+import '../../runtime/common/language.js';
+import '../../runtime/common/llm-scope.js';
+import '../../text/serial/options.js';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../text/reader/types.js';
+import '../../text/reader/attention/core.js';
+import '../../text/reader/chunk-batch/types.js';
+import '../../text/reader/segment/types.js';