wiki-graph-core 0.3.1

package/dist/output/epub/model.d.ts

@@ -0,0 +1,24 @@
+import { BookMeta } from '../../source/meta.js';
+import { SourceAsset } from '../../source/types.js';
+import 'zod';
+
+interface EpubBook {
+    readonly cover: SourceAsset | undefined;
+    readonly meta: BookMeta;
+    readonly navXhtml: string;
+    readonly packageOpf: string;
+    readonly sections: readonly EpubSection[];
+}
+interface EpubNavItem {
+    readonly children: readonly EpubNavItem[];
+    readonly href: string | undefined;
+    readonly title: string;
+}
+interface EpubSection {
+    readonly href: string;
+    readonly id: string;
+    readonly title: string;
+    readonly xhtml: string;
+}
+
+export type { EpubBook, EpubNavItem, EpubSection };

package/dist/output/epub/model.js

@@ -0,0 +1 @@
+//# sourceMappingURL=model.js.map

package/dist/output/epub/model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/output/epub/navigation.d.ts

@@ -0,0 +1,10 @@
+import { BookMeta } from '../../source/meta.js';
+import { TocItem } from '../../source/toc.js';
+import { EpubSection, EpubNavItem } from './model.js';
+import 'zod';
+import '../../source/types.js';
+
+declare function buildNavItems(items: readonly TocItem[], sectionMap: ReadonlyMap<number, EpubSection>): EpubNavItem[];
+declare function createNavDocument(meta: BookMeta, language: string, items: readonly EpubNavItem[]): string;
+
+export { buildNavItems, createNavDocument };

package/dist/output/epub/navigation.js

@@ -0,0 +1,39 @@
+import { escapeXml } from "./shared.js";
+import { renderNavDocument } from "./templates.js";
+function buildNavItems(items, sectionMap) {
+  return items.map((item) => ({
+    children: buildNavItems(item.children, sectionMap),
+    href: item.serialId === void 0 ? void 0 : sectionMap.get(item.serialId)?.href,
+    title: item.title?.trim() || `Section ${item.serialId ?? 1}`
+  }));
+}
+function createNavDocument(meta, language, items) {
+  const title = meta.title?.trim() || "Untitled";
+  return renderNavDocument({
+    itemsMarkup: renderNavItems(items),
+    language,
+    title
+  });
+}
+function renderNavItems(items) {
+  if (items.length === 0) {
+    return "<ol></ol>";
+  }
+  return `<ol>
+${items.map((item) => renderNavItem(item, 1)).join("\n")}
+</ol>`;
+}
+function renderNavItem(item, depth) {
+  const indent = "  ".repeat(depth);
+  const label = item.href === void 0 ? `<span>${escapeXml(item.title)}</span>` : `<a href="${escapeXml(item.href)}">${escapeXml(item.title)}</a>`;
+  const children = item.children.length === 0 ? "" : `
+${indent}  <ol>
+${item.children.map((child) => renderNavItem(child, depth + 2)).join("\n")}
+${indent}  </ol>`;
+  return `${indent}<li>${label}${children}</li>`;
+}
+export {
+  buildNavItems,
+  createNavDocument
+};
+//# sourceMappingURL=navigation.js.map

package/dist/output/epub/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/navigation.ts"],"sourcesContent":["import type { BookMeta, TocItem } from \"../../source/index.js\";\n\nimport type { EpubNavItem, EpubSection } from \"./model.js\";\nimport { escapeXml } from \"./shared.js\";\nimport { renderNavDocument } from \"./templates.js\";\n\nexport function buildNavItems(\n  items: readonly TocItem[],\n  sectionMap: ReadonlyMap<number, EpubSection>,\n): EpubNavItem[] {\n  return items.map((item) => ({\n    children: buildNavItems(item.children, sectionMap),\n    href:\n      item.serialId === undefined\n        ? undefined\n        : sectionMap.get(item.serialId)?.href,\n    title: item.title?.trim() || `Section ${item.serialId ?? 1}`,\n  }));\n}\n\nexport function createNavDocument(\n  meta: BookMeta,\n  language: string,\n  items: readonly EpubNavItem[],\n): string {\n  const title = meta.title?.trim() || \"Untitled\";\n\n  return renderNavDocument({\n    itemsMarkup: renderNavItems(items),\n    language,\n    title,\n  });\n}\n\nfunction renderNavItems(items: readonly EpubNavItem[]): string {\n  if (items.length === 0) {\n    return \"<ol></ol>\";\n  }\n\n  return `<ol>\\n${items.map((item) => renderNavItem(item, 1)).join(\"\\n\")}\\n</ol>`;\n}\n\nfunction renderNavItem(item: EpubNavItem, depth: number): string {\n  const indent = \"  \".repeat(depth);\n  const label =\n    item.href === undefined\n      ? `<span>${escapeXml(item.title)}</span>`\n      : `<a href=\"${escapeXml(item.href)}\">${escapeXml(item.title)}</a>`;\n  const children =\n    item.children.length === 0\n      ? \"\"\n      : `\\n${indent}  <ol>\\n${item.children\n          .map((child) => renderNavItem(child, depth + 2))\n          .join(\"\\n\")}\\n${indent}  </ol>`;\n\n  return `${indent}<li>${label}${children}</li>`;\n}\n"],"mappings":"AAGA,SAAS,iBAAiB;AAC1B,SAAS,yBAAyB;AAE3B,SAAS,cACd,OACA,YACe;AACf,SAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IAC1B,UAAU,cAAc,KAAK,UAAU,UAAU;AAAA,IACjD,MACE,KAAK,aAAa,SACd,SACA,WAAW,IAAI,KAAK,QAAQ,GAAG;AAAA,IACrC,OAAO,KAAK,OAAO,KAAK,KAAK,WAAW,KAAK,YAAY,CAAC;AAAA,EAC5D,EAAE;AACJ;AAEO,SAAS,kBACd,MACA,UACA,OACQ;AACR,QAAM,QAAQ,KAAK,OAAO,KAAK,KAAK;AAEpC,SAAO,kBAAkB;AAAA,IACvB,aAAa,eAAe,KAAK;AAAA,IACjC;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,SAAS,eAAe,OAAuC;AAC7D,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,EAAS,MAAM,IAAI,CAAC,SAAS,cAAc,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA;AACxE;AAEA,SAAS,cAAc,MAAmB,OAAuB;AAC/D,QAAM,SAAS,KAAK,OAAO,KAAK;AAChC,QAAM,QACJ,KAAK,SAAS,SACV,SAAS,UAAU,KAAK,KAAK,CAAC,YAC9B,YAAY,UAAU,KAAK,IAAI,CAAC,KAAK,UAAU,KAAK,KAAK,CAAC;AAChE,QAAM,WACJ,KAAK,SAAS,WAAW,IACrB,KACA;AAAA,EAAK,MAAM;AAAA,EAAW,KAAK,SACxB,IAAI,CAAC,UAAU,cAAc,OAAO,QAAQ,CAAC,CAAC,EAC9C,KAAK,IAAI,CAAC;AAAA,EAAK,MAAM;AAE9B,SAAO,GAAG,MAAM,OAAO,KAAK,GAAG,QAAQ;AACzC;","names":[]}

package/dist/output/epub/package.d.ts

@@ -0,0 +1,17 @@
+import { BookMeta } from '../../source/meta.js';
+import { EpubSection } from './model.js';
+import 'zod';
+import '../../source/types.js';
+
+declare const EPUB_OUTPUT_VERSION = "3.0";
+declare function createPackageOpf(input: {
+    readonly coverImageHref: string | undefined;
+    readonly coverMediaType: string | undefined;
+    readonly coverPageHref: string | undefined;
+    readonly language: string;
+    readonly meta: BookMeta;
+    readonly modifiedAt: string;
+    readonly sections: readonly EpubSection[];
+}): string;
+
+export { EPUB_OUTPUT_VERSION, createPackageOpf };

package/dist/output/epub/package.js

@@ -0,0 +1,29 @@
+import { renderPackageOpf } from "./templates.js";
+const EPUB_OUTPUT_VERSION = "3.0";
+function createPackageOpf(input) {
+  const identifier = input.meta.identifier?.trim() || `urn:uuid:${crypto.randomUUID()}`;
+  const title = input.meta.title?.trim() || "Untitled";
+  return renderPackageOpf({
+    authors: input.meta.authors,
+    coverImageHref: input.coverImageHref,
+    coverMediaType: input.coverMediaType,
+    coverPageHref: input.coverPageHref,
+    description: input.meta.description,
+    identifier,
+    language: input.language,
+    modifiedAt: input.modifiedAt,
+    publishedAt: input.meta.publishedAt,
+    publisher: input.meta.publisher,
+    sections: input.sections.map((section) => ({
+      href: section.href,
+      id: section.id
+    })),
+    title,
+    version: EPUB_OUTPUT_VERSION
+  });
+}
+export {
+  EPUB_OUTPUT_VERSION,
+  createPackageOpf
+};
+//# sourceMappingURL=package.js.map

package/dist/output/epub/package.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/package.ts"],"sourcesContent":["import type { BookMeta } from \"../../source/index.js\";\n\nimport type { EpubSection } from \"./model.js\";\nimport { renderPackageOpf } from \"./templates.js\";\n\nexport const EPUB_OUTPUT_VERSION = \"3.0\";\n\nexport function createPackageOpf(input: {\n  readonly coverImageHref: string | undefined;\n  readonly coverMediaType: string | undefined;\n  readonly coverPageHref: string | undefined;\n  readonly language: string;\n  readonly meta: BookMeta;\n  readonly modifiedAt: string;\n  readonly sections: readonly EpubSection[];\n}): string {\n  const identifier =\n    input.meta.identifier?.trim() || `urn:uuid:${crypto.randomUUID()}`;\n  const title = input.meta.title?.trim() || \"Untitled\";\n\n  return renderPackageOpf({\n    authors: input.meta.authors,\n    coverImageHref: input.coverImageHref,\n    coverMediaType: input.coverMediaType,\n    coverPageHref: input.coverPageHref,\n    description: input.meta.description,\n    identifier,\n    language: input.language,\n    modifiedAt: input.modifiedAt,\n    publishedAt: input.meta.publishedAt,\n    publisher: input.meta.publisher,\n    sections: input.sections.map((section) => ({\n      href: section.href,\n      id: section.id,\n    })),\n    title,\n    version: EPUB_OUTPUT_VERSION,\n  });\n}\n"],"mappings":"AAGA,SAAS,wBAAwB;AAE1B,MAAM,sBAAsB;AAE5B,SAAS,iBAAiB,OAQtB;AACT,QAAM,aACJ,MAAM,KAAK,YAAY,KAAK,KAAK,YAAY,OAAO,WAAW,CAAC;AAClE,QAAM,QAAQ,MAAM,KAAK,OAAO,KAAK,KAAK;AAE1C,SAAO,iBAAiB;AAAA,IACtB,SAAS,MAAM,KAAK;AAAA,IACpB,gBAAgB,MAAM;AAAA,IACtB,gBAAgB,MAAM;AAAA,IACtB,eAAe,MAAM;AAAA,IACrB,aAAa,MAAM,KAAK;AAAA,IACxB;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,YAAY,MAAM;AAAA,IAClB,aAAa,MAAM,KAAK;AAAA,IACxB,WAAW,MAAM,KAAK;AAAA,IACtB,UAAU,MAAM,SAAS,IAAI,CAAC,aAAa;AAAA,MACzC,MAAM,QAAQ;AAAA,MACd,IAAI,QAAQ;AAAA,IACd,EAAE;AAAA,IACF;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AACH;","names":[]}

package/dist/output/epub/shared.d.ts

@@ -0,0 +1,4 @@
+declare function escapeXml(value: string): string;
+declare function normalizeLanguage(language: string | null): string;
+
+export { escapeXml, normalizeLanguage };

package/dist/output/epub/shared.js

@@ -0,0 +1,12 @@
+function escapeXml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+}
+function normalizeLanguage(language) {
+  const normalized = language?.trim();
+  return normalized === void 0 || normalized === "" ? "und" : normalized;
+}
+export {
+  escapeXml,
+  normalizeLanguage
+};
+//# sourceMappingURL=shared.js.map

package/dist/output/epub/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/shared.ts"],"sourcesContent":["export function escapeXml(value: string): string {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&apos;\");\n}\n\nexport function normalizeLanguage(language: string | null): string {\n  const normalized = language?.trim();\n\n  return normalized === undefined || normalized === \"\" ? \"und\" : normalized;\n}\n"],"mappings":"AAAO,SAAS,UAAU,OAAuB;AAC/C,SAAO,MACJ,WAAW,KAAK,OAAO,EACvB,WAAW,KAAK,MAAM,EACtB,WAAW,KAAK,MAAM,EACtB,WAAW,KAAK,QAAQ,EACxB,WAAW,KAAK,QAAQ;AAC7B;AAEO,SAAS,kBAAkB,UAAiC;AACjE,QAAM,aAAa,UAAU,KAAK;AAElC,SAAO,eAAe,UAAa,eAAe,KAAK,QAAQ;AACjE;","names":[]}

package/dist/output/epub/templates.d.ts

@@ -0,0 +1,35 @@
+declare function renderCoverPage(input: {
+    readonly coverImageHref: string;
+    readonly language: string;
+    readonly title: string;
+}): string;
+declare function renderNavDocument(input: {
+    readonly itemsMarkup: string;
+    readonly language: string;
+    readonly title: string;
+}): string;
+declare function renderPackageOpf(input: {
+    readonly authors: readonly string[];
+    readonly coverImageHref: string | undefined;
+    readonly coverMediaType: string | undefined;
+    readonly coverPageHref: string | undefined;
+    readonly description: string | null;
+    readonly identifier: string;
+    readonly language: string;
+    readonly modifiedAt: string;
+    readonly publishedAt: string | null;
+    readonly publisher: string | null;
+    readonly sections: readonly {
+        readonly href: string;
+        readonly id: string;
+    }[];
+    readonly title: string;
+    readonly version: string;
+}): string;
+declare function renderSectionDocument(input: {
+    readonly language: string;
+    readonly paragraphs: readonly string[];
+    readonly title: string;
+}): string;
+
+export { renderCoverPage, renderNavDocument, renderPackageOpf, renderSectionDocument };

package/dist/output/epub/templates.js

@@ -0,0 +1,26 @@
+import { resolveDataDirPath } from "../../common/data-dir.js";
+import { createEnv } from "../../common/template.js";
+let templateEnvironment;
+function getTemplateEnvironment() {
+  templateEnvironment ??= createEnv(resolveDataDirPath());
+  return templateEnvironment;
+}
+function renderCoverPage(input) {
+  return getTemplateEnvironment().render("output/epub/cover.xhtml", input);
+}
+function renderNavDocument(input) {
+  return getTemplateEnvironment().render("output/epub/nav.xhtml", input);
+}
+function renderPackageOpf(input) {
+  return getTemplateEnvironment().render("output/epub/package.opf.xml", input);
+}
+function renderSectionDocument(input) {
+  return getTemplateEnvironment().render("output/epub/section.xhtml", input);
+}
+export {
+  renderCoverPage,
+  renderNavDocument,
+  renderPackageOpf,
+  renderSectionDocument
+};
+//# sourceMappingURL=templates.js.map

package/dist/output/epub/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/templates.ts"],"sourcesContent":["import { resolveDataDirPath } from \"../../common/data-dir.js\";\nimport { createEnv } from \"../../common/template.js\";\n\nlet templateEnvironment: ReturnType<typeof createEnv> | undefined;\n\nfunction getTemplateEnvironment(): ReturnType<typeof createEnv> {\n  templateEnvironment ??= createEnv(resolveDataDirPath());\n\n  return templateEnvironment;\n}\n\nexport function renderCoverPage(input: {\n  readonly coverImageHref: string;\n  readonly language: string;\n  readonly title: string;\n}): string {\n  return getTemplateEnvironment().render(\"output/epub/cover.xhtml\", input);\n}\n\nexport function renderNavDocument(input: {\n  readonly itemsMarkup: string;\n  readonly language: string;\n  readonly title: string;\n}): string {\n  return getTemplateEnvironment().render(\"output/epub/nav.xhtml\", input);\n}\n\nexport function renderPackageOpf(input: {\n  readonly authors: readonly string[];\n  readonly coverImageHref: string | undefined;\n  readonly coverMediaType: string | undefined;\n  readonly coverPageHref: string | undefined;\n  readonly description: string | null;\n  readonly identifier: string;\n  readonly language: string;\n  readonly modifiedAt: string;\n  readonly publishedAt: string | null;\n  readonly publisher: string | null;\n  readonly sections: readonly {\n    readonly href: string;\n    readonly id: string;\n  }[];\n  readonly title: string;\n  readonly version: string;\n}): string {\n  return getTemplateEnvironment().render(\"output/epub/package.opf.xml\", input);\n}\n\nexport function renderSectionDocument(input: {\n  readonly language: string;\n  readonly paragraphs: readonly string[];\n  readonly title: string;\n}): string {\n  return getTemplateEnvironment().render(\"output/epub/section.xhtml\", input);\n}\n"],"mappings":"AAAA,SAAS,0BAA0B;AACnC,SAAS,iBAAiB;AAE1B,IAAI;AAEJ,SAAS,yBAAuD;AAC9D,0BAAwB,UAAU,mBAAmB,CAAC;AAEtD,SAAO;AACT;AAEO,SAAS,gBAAgB,OAIrB;AACT,SAAO,uBAAuB,EAAE,OAAO,2BAA2B,KAAK;AACzE;AAEO,SAAS,kBAAkB,OAIvB;AACT,SAAO,uBAAuB,EAAE,OAAO,yBAAyB,KAAK;AACvE;AAEO,SAAS,iBAAiB,OAiBtB;AACT,SAAO,uBAAuB,EAAE,OAAO,+BAA+B,KAAK;AAC7E;AAEO,SAAS,sBAAsB,OAI3B;AACT,SAAO,uBAAuB,EAAE,OAAO,6BAA6B,KAAK;AAC3E;","names":[]}

package/dist/output/index.d.ts

@@ -0,0 +1,14 @@
+export { WritePlainTextOptions, writePlainText } from './plain-text.js';
+export { WriteEpubOptions, writeEpub } from './epub/index.js';
+export { EPUB_OUTPUT_VERSION } from './epub/package.js';
+import '../document/document.js';
+import '../source/meta.js';
+import 'zod';
+import '../source/toc.js';
+import '../source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams.js';
+import '../document/types.js';
+import '../document/stores.js';
+import './epub/model.js';

package/dist/output/index.js

@@ -0,0 +1,11 @@
+import { writePlainText } from "./plain-text.js";
+import {
+  EPUB_OUTPUT_VERSION,
+  writeEpub
+} from "./epub/index.js";
+export {
+  EPUB_OUTPUT_VERSION,
+  writeEpub,
+  writePlainText
+};
+//# sourceMappingURL=index.js.map

package/dist/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/output/index.ts"],"sourcesContent":["export { writePlainText, type WritePlainTextOptions } from \"./plain-text.js\";\nexport {\n  EPUB_OUTPUT_VERSION,\n  writeEpub,\n  type WriteEpubOptions,\n} from \"./epub/index.js\";\n"],"mappings":"AAAA,SAAS,sBAAkD;AAC3D;AAAA,EACE;AAAA,EACA;AAAA,OAEK;","names":[]}

package/dist/output/plain-text.d.ts

@@ -0,0 +1,18 @@
+import { ReadonlyDocument } from '../document/document.js';
+import '../source/meta.js';
+import 'zod';
+import '../source/toc.js';
+import '../source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams.js';
+import '../document/types.js';
+import '../document/stores.js';
+
+interface WritePlainTextOptions {
+    readonly document: ReadonlyDocument;
+    readonly path: string;
+}
+declare function writePlainText(options: WritePlainTextOptions): Promise<void>;
+
+export { type WritePlainTextOptions, writePlainText };

package/dist/output/plain-text.js

@@ -0,0 +1,56 @@
+import { mkdir, writeFile } from "fs/promises";
+import { dirname } from "path";
+async function writePlainText(options) {
+  const text = await options.document.openSession(
+    async (document) => await buildPlainText(document)
+  );
+  await mkdir(dirname(options.path), { recursive: true });
+  await writeFile(options.path, text, "utf8");
+}
+async function buildPlainText(document) {
+  const toc = await document.readToc();
+  if (toc === void 0) {
+    throw new Error("Document TOC is missing");
+  }
+  const blocks = await renderTocItems(document, toc.items);
+  if (blocks.length === 0) {
+    return "";
+  }
+  return `${blocks.join("\n\n")}
+`;
+}
+async function renderTocItems(document, items) {
+  const blocks = [];
+  for (const item of items) {
+    const block = await renderTocItem(document, item);
+    if (block !== void 0) {
+      blocks.push(block);
+    }
+  }
+  return blocks;
+}
+async function renderTocItem(document, item) {
+  const parts = [item.title?.trim()].filter(
+    (value) => value !== void 0 && value !== ""
+  );
+  if (item.serialId !== void 0) {
+    const summary = await document.readSummary(item.serialId);
+    if (summary === void 0) {
+      throw new Error(
+        `Chapter ${item.serialId} summary is missing. Run \`wg wikg://local/job add --input <chapter-uri> --task reading-summary --accept-cost\` before export, or inspect the archive with \`wg <archive-uri>/chapter/tree get\`.`
+      );
+    }
+    if (summary.trim() !== "") {
+      parts.push(summary.trim());
+    }
+  }
+  const childBlocks = await renderTocItems(document, item.children);
+  if (parts.length === 0 && childBlocks.length === 0) {
+    return void 0;
+  }
+  return [...parts, ...childBlocks].join("\n\n");
+}
+export {
+  writePlainText
+};
+//# sourceMappingURL=plain-text.js.map

package/dist/output/plain-text.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/output/plain-text.ts"],"sourcesContent":["import { mkdir, writeFile } from \"fs/promises\";\nimport { dirname } from \"path\";\n\nimport type { ReadonlyDocument } from \"../document/index.js\";\nimport type { TocItem } from \"../source/index.js\";\n\nexport interface WritePlainTextOptions {\n  readonly document: ReadonlyDocument;\n  readonly path: string;\n}\n\nexport async function writePlainText(\n  options: WritePlainTextOptions,\n): Promise<void> {\n  const text = await options.document.openSession(\n    async (document) => await buildPlainText(document),\n  );\n\n  await mkdir(dirname(options.path), { recursive: true });\n  await writeFile(options.path, text, \"utf8\");\n}\n\nasync function buildPlainText(document: ReadonlyDocument): Promise<string> {\n  const toc = await document.readToc();\n\n  if (toc === undefined) {\n    throw new Error(\"Document TOC is missing\");\n  }\n\n  const blocks = await renderTocItems(document, toc.items);\n\n  if (blocks.length === 0) {\n    return \"\";\n  }\n\n  return `${blocks.join(\"\\n\\n\")}\\n`;\n}\n\nasync function renderTocItems(\n  document: ReadonlyDocument,\n  items: readonly TocItem[],\n): Promise<string[]> {\n  const blocks: string[] = [];\n\n  for (const item of items) {\n    const block = await renderTocItem(document, item);\n\n    if (block !== undefined) {\n      blocks.push(block);\n    }\n  }\n\n  return blocks;\n}\n\nasync function renderTocItem(\n  document: ReadonlyDocument,\n  item: TocItem,\n): Promise<string | undefined> {\n  const parts = [item.title?.trim()].filter(\n    (value): value is string => value !== undefined && value !== \"\",\n  );\n\n  if (item.serialId !== undefined) {\n    const summary = await document.readSummary(item.serialId);\n\n    if (summary === undefined) {\n      throw new Error(\n        `Chapter ${item.serialId} summary is missing. Run \\`wg wikg://local/job add --input <chapter-uri> --task reading-summary --accept-cost\\` before export, or inspect the archive with \\`wg <archive-uri>/chapter/tree get\\`.`,\n      );\n    }\n    if (summary.trim() !== \"\") {\n      parts.push(summary.trim());\n    }\n  }\n\n  const childBlocks = await renderTocItems(document, item.children);\n\n  if (parts.length === 0 && childBlocks.length === 0) {\n    return undefined;\n  }\n\n  return [...parts, ...childBlocks].join(\"\\n\\n\");\n}\n"],"mappings":"AAAA,SAAS,OAAO,iBAAiB;AACjC,SAAS,eAAe;AAUxB,eAAsB,eACpB,SACe;AACf,QAAM,OAAO,MAAM,QAAQ,SAAS;AAAA,IAClC,OAAO,aAAa,MAAM,eAAe,QAAQ;AAAA,EACnD;AAEA,QAAM,MAAM,QAAQ,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AACtD,QAAM,UAAU,QAAQ,MAAM,MAAM,MAAM;AAC5C;AAEA,eAAe,eAAe,UAA6C;AACzE,QAAM,MAAM,MAAM,SAAS,QAAQ;AAEnC,MAAI,QAAQ,QAAW;AACrB,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAEA,QAAM,SAAS,MAAM,eAAe,UAAU,IAAI,KAAK;AAEvD,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,OAAO,KAAK,MAAM,CAAC;AAAA;AAC/B;AAEA,eAAe,eACb,UACA,OACmB;AACnB,QAAM,SAAmB,CAAC;AAE1B,aAAW,QAAQ,OAAO;AACxB,UAAM,QAAQ,MAAM,cAAc,UAAU,IAAI;AAEhD,QAAI,UAAU,QAAW;AACvB,aAAO,KAAK,KAAK;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,eAAe,cACb,UACA,MAC6B;AAC7B,QAAM,QAAQ,CAAC,KAAK,OAAO,KAAK,CAAC,EAAE;AAAA,IACjC,CAAC,UAA2B,UAAU,UAAa,UAAU;AAAA,EAC/D;AAEA,MAAI,KAAK,aAAa,QAAW;AAC/B,UAAM,UAAU,MAAM,SAAS,YAAY,KAAK,QAAQ;AAExD,QAAI,YAAY,QAAW;AACzB,YAAM,IAAI;AAAA,QACR,WAAW,KAAK,QAAQ;AAAA,MAC1B;AAAA,IACF;AACA,QAAI,QAAQ,KAAK,MAAM,IAAI;AACzB,YAAM,KAAK,QAAQ,KAAK,CAAC;AAAA,IAC3B;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,eAAe,UAAU,KAAK,QAAQ;AAEhE,MAAI,MAAM,WAAW,KAAK,YAAY,WAAW,GAAG;AAClD,WAAO;AAAA,EACT;AAEA,SAAO,CAAC,GAAG,OAAO,GAAG,WAAW,EAAE,KAAK,MAAM;AAC/C;","names":[]}

package/dist/progress/index.d.ts

@@ -0,0 +1,3 @@
+export { CreateDigestProgressTrackerOptions, DigestProgressTracker, SerialProgressTracker, createDigestProgressTracker } from './tracker.js';
+export { ProgressReporter, createProgressReporter } from './reporter.js';
+export { DigestProgressEvent, SerialDiscoveryItem, SerialProgressEvent, SerialsDiscoveredEvent, WikiGraphOperation, WikiGraphProgressCallback, WikiGraphProgressEvent, WikiGraphProgressEventType } from './types.js';

package/dist/progress/index.js

@@ -0,0 +1,14 @@
+import {
+  createDigestProgressTracker,
+  DigestProgressTracker,
+  SerialProgressTracker
+} from "./tracker.js";
+import { createProgressReporter, ProgressReporter } from "./reporter.js";
+export {
+  DigestProgressTracker,
+  ProgressReporter,
+  SerialProgressTracker,
+  createDigestProgressTracker,
+  createProgressReporter
+};
+//# sourceMappingURL=index.js.map

package/dist/progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/progress/index.ts"],"sourcesContent":["export {\n  createDigestProgressTracker,\n  DigestProgressTracker,\n  SerialProgressTracker,\n  type CreateDigestProgressTrackerOptions,\n} from \"./tracker.js\";\nexport { createProgressReporter, ProgressReporter } from \"./reporter.js\";\nexport type {\n  DigestProgressEvent,\n  SerialDiscoveryItem,\n  SerialsDiscoveredEvent,\n  SerialProgressEvent,\n  WikiGraphOperation,\n  WikiGraphProgressCallback,\n  WikiGraphProgressEvent,\n  WikiGraphProgressEventType,\n} from \"./types.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,wBAAwB,wBAAwB;","names":[]}

package/dist/progress/reporter.d.ts

@@ -0,0 +1,10 @@
+import { WikiGraphOperation, WikiGraphProgressCallback, WikiGraphProgressEvent } from './types.js';
+
+declare class ProgressReporter {
+    #private;
+    constructor(operation: WikiGraphOperation, callback?: WikiGraphProgressCallback);
+    emit(event: WikiGraphProgressEvent): Promise<void>;
+}
+declare function createProgressReporter(operation: WikiGraphOperation, callback?: WikiGraphProgressCallback): ProgressReporter;
+
+export { ProgressReporter, createProgressReporter };

package/dist/progress/reporter.js

@@ -0,0 +1,79 @@
+import { getLogger } from "../common/logging.js";
+class ProgressReporter {
+  #callback;
+  #operation;
+  constructor(operation, callback) {
+    this.#callback = callback;
+    this.#operation = operation;
+  }
+  async emit(event) {
+    getLogger({
+      component: "progress",
+      eventType: event.type,
+      operation: this.#operation,
+      ...buildLogBindings(event)
+    }).info(buildLogMessage(event));
+    if (this.#callback === void 0) {
+      return;
+    }
+    try {
+      await this.#callback(event);
+    } catch (error) {
+      getLogger({
+        component: "progress",
+        operation: this.#operation
+      }).warn(
+        {
+          error: error instanceof Error ? { message: error.message, name: error.name } : String(error)
+        },
+        "Progress callback failed"
+      );
+    }
+  }
+}
+function createProgressReporter(operation, callback) {
+  return new ProgressReporter(operation, callback);
+}
+function buildLogBindings(event) {
+  switch (event.type) {
+    case "serials-discovered":
+      return {
+        available: Number(event.available),
+        serials: event.serials.length,
+        totalFragments: event.serials.reduce(
+          (sum, serial) => sum + (serial.fragments ?? 0),
+          0
+        ),
+        totalWords: event.serials.reduce(
+          (sum, serial) => sum + serial.words,
+          0
+        )
+      };
+    case "serial-progress":
+      return {
+        completedFragments: event.completedFragments,
+        completedWords: event.completedWords,
+        id: event.id
+      };
+    case "digest-progress":
+      return {
+        completedWords: event.completedWords,
+        totalWords: event.totalWords
+      };
+  }
+}
+function buildLogMessage(event) {
+  switch (event.type) {
+    case "serials-discovered":
+      return event.available ? `Discovered ${event.serials.length} serials` : "Serial discovery unavailable";
+    case "serial-progress":
+      return `Serial ${event.id} progressed`;
+    case "digest-progress":
+      return "Digest progressed";
+  }
+}
+export {
+  ProgressReporter,
+  createProgressReporter
+};
+//# sourceMappingURL=reporter.js.map

package/dist/progress/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/progress/reporter.ts"],"sourcesContent":["import { getLogger } from \"../common/logging.js\";\n\nimport type {\n  DigestProgressEvent,\n  SerialProgressEvent,\n  WikiGraphOperation,\n  WikiGraphProgressCallback,\n  WikiGraphProgressEvent,\n} from \"./types.js\";\n\nexport class ProgressReporter {\n  readonly #callback: WikiGraphProgressCallback | undefined;\n  readonly #operation: WikiGraphOperation;\n\n  public constructor(\n    operation: WikiGraphOperation,\n    callback?: WikiGraphProgressCallback,\n  ) {\n    this.#callback = callback;\n    this.#operation = operation;\n  }\n\n  public async emit(event: WikiGraphProgressEvent): Promise<void> {\n    getLogger({\n      component: \"progress\",\n      eventType: event.type,\n      operation: this.#operation,\n      ...buildLogBindings(event),\n    }).info(buildLogMessage(event));\n\n    if (this.#callback === undefined) {\n      return;\n    }\n\n    try {\n      await this.#callback(event);\n    } catch (error) {\n      getLogger({\n        component: \"progress\",\n        operation: this.#operation,\n      }).warn(\n        {\n          error:\n            error instanceof Error\n              ? { message: error.message, name: error.name }\n              : String(error),\n        },\n        \"Progress callback failed\",\n      );\n    }\n  }\n}\n\nexport function createProgressReporter(\n  operation: WikiGraphOperation,\n  callback?: WikiGraphProgressCallback,\n): ProgressReporter {\n  return new ProgressReporter(operation, callback);\n}\n\nfunction buildLogBindings(\n  event: WikiGraphProgressEvent,\n): Record<string, number> {\n  switch (event.type) {\n    case \"serials-discovered\":\n      return {\n        available: Number(event.available),\n        serials: event.serials.length,\n        totalFragments: event.serials.reduce(\n          (sum, serial) => sum + (serial.fragments ?? 0),\n          0,\n        ),\n        totalWords: event.serials.reduce(\n          (sum, serial) => sum + serial.words,\n          0,\n        ),\n      } satisfies Record<string, number>;\n    case \"serial-progress\":\n      return {\n        completedFragments: event.completedFragments,\n        completedWords: event.completedWords,\n        id: event.id,\n      } satisfies Record<keyof Omit<SerialProgressEvent, \"type\">, number>;\n    case \"digest-progress\":\n      return {\n        completedWords: event.completedWords,\n        totalWords: event.totalWords,\n      } satisfies Record<keyof Omit<DigestProgressEvent, \"type\">, number>;\n  }\n}\n\nfunction buildLogMessage(event: WikiGraphProgressEvent): string {\n  switch (event.type) {\n    case \"serials-discovered\":\n      return event.available\n        ? `Discovered ${event.serials.length} serials`\n        : \"Serial discovery unavailable\";\n    case \"serial-progress\":\n      return `Serial ${event.id} progressed`;\n    case \"digest-progress\":\n      return \"Digest progressed\";\n  }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAUnB,MAAM,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,EAEF,YACL,WACA,UACA;AACA,SAAK,YAAY;AACjB,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAa,KAAK,OAA8C;AAC9D,cAAU;AAAA,MACR,WAAW;AAAA,MACX,WAAW,MAAM;AAAA,MACjB,WAAW,KAAK;AAAA,MAChB,GAAG,iBAAiB,KAAK;AAAA,IAC3B,CAAC,EAAE,KAAK,gBAAgB,KAAK,CAAC;AAE9B,QAAI,KAAK,cAAc,QAAW;AAChC;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,UAAU,KAAK;AAAA,IAC5B,SAAS,OAAO;AACd,gBAAU;AAAA,QACR,WAAW;AAAA,QACX,WAAW,KAAK;AAAA,MAClB,CAAC,EAAE;AAAA,QACD;AAAA,UACE,OACE,iBAAiB,QACb,EAAE,SAAS,MAAM,SAAS,MAAM,MAAM,KAAK,IAC3C,OAAO,KAAK;AAAA,QACpB;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,uBACd,WACA,UACkB;AAClB,SAAO,IAAI,iBAAiB,WAAW,QAAQ;AACjD;AAEA,SAAS,iBACP,OACwB;AACxB,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,QACL,WAAW,OAAO,MAAM,SAAS;AAAA,QACjC,SAAS,MAAM,QAAQ;AAAA,QACvB,gBAAgB,MAAM,QAAQ;AAAA,UAC5B,CAAC,KAAK,WAAW,OAAO,OAAO,aAAa;AAAA,UAC5C;AAAA,QACF;AAAA,QACA,YAAY,MAAM,QAAQ;AAAA,UACxB,CAAC,KAAK,WAAW,MAAM,OAAO;AAAA,UAC9B;AAAA,QACF;AAAA,MACF;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,oBAAoB,MAAM;AAAA,QAC1B,gBAAgB,MAAM;AAAA,QACtB,IAAI,MAAM;AAAA,MACZ;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,gBAAgB,MAAM;AAAA,QACtB,YAAY,MAAM;AAAA,MACpB;AAAA,EACJ;AACF;AAEA,SAAS,gBAAgB,OAAuC;AAC9D,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,MAAM,YACT,cAAc,MAAM,QAAQ,MAAM,aAClC;AAAA,IACN,KAAK;AACH,aAAO,UAAU,MAAM,EAAE;AAAA,IAC3B,KAAK;AACH,aAAO;AAAA,EACX;AACF;","names":[]}

package/dist/progress/tracker.d.ts

@@ -0,0 +1,37 @@
+import { WikiGraphProgressCallback, WikiGraphOperation, SerialDiscoveryItem } from './types.js';
+
+interface CreateDigestProgressTrackerOptions {
+    readonly onProgress?: WikiGraphProgressCallback;
+    readonly operation: WikiGraphOperation;
+}
+declare class DigestProgressTracker {
+    #private;
+    constructor(options: CreateDigestProgressTrackerOptions);
+    createSerialTracker(input: {
+        readonly id: number;
+    }): SerialProgressTracker;
+    discoverSerials(serials: readonly SerialDiscoveryItem[]): Promise<void>;
+    markDiscoveryUnavailable(): Promise<void>;
+    completeSerial(input: {
+        readonly id: number;
+        readonly words: number;
+    }): Promise<void>;
+    emitSerialProgress(input: {
+        readonly completedFragments: number;
+        readonly completedWords: number;
+        readonly id: number;
+    }): Promise<void>;
+}
+declare class SerialProgressTracker {
+    #private;
+    constructor(digestTracker: DigestProgressTracker, id: number);
+    begin(_input?: {
+        readonly fragments: number;
+        readonly words: number;
+    }): Promise<void>;
+    advance(wordsCount: number): Promise<void>;
+    complete(finalWordsCount?: number): Promise<void>;
+}
+declare function createDigestProgressTracker(options: CreateDigestProgressTrackerOptions): DigestProgressTracker;
+
+export { type CreateDigestProgressTrackerOptions, DigestProgressTracker, SerialProgressTracker, createDigestProgressTracker };

package/dist/progress/tracker.js

@@ -0,0 +1,119 @@
+import { createProgressReporter } from "./reporter.js";
+class DigestProgressTracker {
+  #reporter;
+  #completedWords = 0;
+  #completedWordsBySerial = /* @__PURE__ */ new Map();
+  #totalWords = 0;
+  #discoverySettled = false;
+  constructor(options) {
+    this.#reporter = createProgressReporter(
+      options.operation,
+      options.onProgress
+    );
+  }
+  createSerialTracker(input) {
+    return new SerialProgressTracker(this, input.id);
+  }
+  async discoverSerials(serials) {
+    this.#ensureDiscoveryOpen();
+    this.#discoverySettled = true;
+    this.#totalWords = serials.reduce((sum, serial) => sum + serial.words, 0);
+    await this.#reporter.emit({
+      available: true,
+      serials,
+      type: "serials-discovered"
+    });
+    await this.#emitDigestProgress();
+  }
+  async markDiscoveryUnavailable() {
+    this.#ensureDiscoveryOpen();
+    this.#discoverySettled = true;
+    await this.#reporter.emit({
+      available: false,
+      serials: [],
+      type: "serials-discovered"
+    });
+  }
+  async completeSerial(input) {
+    const previousCompletedWords = this.#completedWordsBySerial.get(input.id) ?? 0;
+    if (input.words !== previousCompletedWords) {
+      this.#completedWordsBySerial.set(input.id, input.words);
+      this.#completedWords += input.words - previousCompletedWords;
+    }
+    const nextTotalWords = Math.max(
+      this.#totalWords,
+      this.#completedWords,
+      input.words
+    );
+    if (nextTotalWords === this.#totalWords && input.words === previousCompletedWords) {
+      return;
+    }
+    this.#totalWords = nextTotalWords;
+    await this.#emitDigestProgress();
+  }
+  async emitSerialProgress(input) {
+    await this.#reporter.emit({
+      completedFragments: input.completedFragments,
+      completedWords: input.completedWords,
+      id: input.id,
+      type: "serial-progress"
+    });
+  }
+  async #emitDigestProgress() {
+    await this.#reporter.emit({
+      completedWords: this.#completedWords,
+      totalWords: this.#totalWords,
+      type: "digest-progress"
+    });
+  }
+  #ensureDiscoveryOpen() {
+    if (this.#discoverySettled) {
+      throw new Error("Serial discovery has already been reported");
+    }
+  }
+}
+class SerialProgressTracker {
+  #completedFragments = 0;
+  #digestTracker;
+  #completedWords = 0;
+  #id;
+  constructor(digestTracker, id) {
+    this.#digestTracker = digestTracker;
+    this.#id = id;
+  }
+  async begin(_input) {
+  }
+  async advance(wordsCount) {
+    this.#completedWords += wordsCount;
+    this.#completedFragments += 1;
+    await this.#digestTracker.emitSerialProgress({
+      completedFragments: this.#completedFragments,
+      completedWords: this.#completedWords,
+      id: this.#id
+    });
+  }
+  async complete(finalWordsCount = 0) {
+    this.#completedWords += finalWordsCount;
+    if (finalWordsCount > 0) {
+      this.#completedFragments += 1;
+    }
+    await this.#digestTracker.emitSerialProgress({
+      completedFragments: this.#completedFragments,
+      completedWords: this.#completedWords,
+      id: this.#id
+    });
+    await this.#digestTracker.completeSerial({
+      id: this.#id,
+      words: this.#completedWords
+    });
+  }
+}
+function createDigestProgressTracker(options) {
+  return new DigestProgressTracker(options);
+}
+export {
+  DigestProgressTracker,
+  SerialProgressTracker,
+  createDigestProgressTracker
+};
+//# sourceMappingURL=tracker.js.map