@heroiclands/package-build 22.2.0 → 22.3.1

package/types/sohl/kb-passes.d.mts

@@ -17,59 +17,28 @@
  * @returns {string} The body with every tag resolved.
  */
 export function resolveApiLinks(body: string, symbols: Record<string, string>, apiBase: string): string;
-/**
- * Rewrites the relative links in a developer-doc body so they resolve on the
- * published site.
- *
- * Developer docs are authored to link one another and the source tree with
- * repository-relative paths, and neither target exists at the same path once
- * rendered. Each link is resolved against the doc's own location:
- *
- * - a `*.md` link landing inside the documentation tree becomes the published
- *   route, preserving any `#anchor`; a `README` is its directory's landing, so
- *   that segment is dropped.
- * - anything else — source, templates, a repository-root `*.md` — becomes its
- *   GitHub blob URL.
- *
- * Absolute URLs, anchor-only links, `mailto:` and site-root links are untouched.
- *
- * @param {string} body - The markdown body.
- * @param {string} docRel - The doc's path relative to the documentation tree.
- * @param {object} options - `{ repoRoot, docsSrc, docsRel, route, blob }`.
- * @returns {string} The body with every relative link rewritten.
- */
-export function rewriteRepoLinks(body: string, docRel: string, options: object): string;
 /**
  * The `sohl` knowledgebase pass bundle, built from its options.
  *
- * A pass bundle is two optional hooks the page renderer calls around wikilink
- * resolution, and the order matters:
- *
- * - `beforeLinks` runs on every page, before wikilinks resolve, because a
- *   `{@link}` tag may sit inside prose a wikilink also touches.
- * - `afterLinks` runs only on pages from an **extra tree** — the documentation
- *   tree — because repository-relative links are a property of how those pages
- *   are authored, not of content notes.
- *
- * Both run inside code-fence protection, so neither can rewrite a fenced example.
+ * A pass bundle is the hook the page renderer calls before wikilink
+ * resolution: `beforeLinks` runs on every page, before wikilinks resolve,
+ * because a `{@link}` tag may sit inside prose a wikilink also touches. It
+ * runs inside code-fence protection, so it cannot rewrite a fenced example.
  *
  * @param {object} options - Resolved from `site.passOptions`.
  * @param {string} [options.symbolMap] - Path to the TypeDoc symbol map,
  *   relative to `repoRoot`. Absent means no API links; present and unusable is
  *   a build failure.
  * @param {string} [options.apiBase] - Where the API documentation is served.
- * @param {string} [options.blob] - GitHub blob base for repository files.
  * @param {string} options.repoRoot - The repository root, for relative paths.
- * @returns {{beforeLinks: Function, afterLinks: Function}} The bundle.
+ * @returns {{beforeLinks: Function}} The bundle.
  * @throws {Error} When a configured `symbolMap` cannot be resolved, read,
  *   parsed, or is not a name → page object.
  */
 export function sohlKbPass(options: {
     symbolMap?: string | undefined;
     apiBase?: string | undefined;
-    blob?: string | undefined;
     repoRoot: string;
 }): {
     beforeLinks: Function;
-    afterLinks: Function;
 };