diffwiki-core 0.7.0 → 0.8.0-rc.202607252154.25b2cb6

package/dist/index.d.cts

@@ -2,6 +2,10 @@ import { SearchDoc } from './bm25.cjs';
 export { RankableFields, rankDocs, tokenize } from './bm25.cjs';
 import { LogLevel, Logger } from '@logtape/logtape';
 
+/** Audience axis — who an article is for. Private is never published. Missing/invalid → 'public'. */
+type Audience = 'public' | 'private';
+/** Lifecycle axis — readiness. Draft is not yet published. Missing/invalid → 'published'. */
+type PublishStatus = 'draft' | 'published';
 type CollectionType = 'global' | 'repo' | 'external';
 interface CollectionEntry {
     name: string;
@@ -36,6 +40,48 @@ interface RepoConfig {
     /** Path to the wiki directory, relative to the repo root. */
     path: string;
 }
+/** A home-page card (VitePress-style): icon + title + subtitle linking into the site. */
+interface HomeCard {
+    /** Icon name from the curated home-card icon set; unknown/missing → no icon. */
+    icon?: string;
+    title: string;
+    subtitle?: string;
+    /** In-site path, e.g. "/getting-started". */
+    link: string;
+}
+/** Home-page customization from `diffwiki.yaml` → `site.home`. */
+interface SiteHome {
+    /** Line shown under the wordmark on the home page. */
+    tagline?: string;
+    /** Cards rendered below the search bar. */
+    cards?: HomeCard[];
+}
+/** Site-level config from `diffwiki.yaml` → `site`. */
+interface SiteConfig {
+    title?: string;
+    /** Logo override: path/URL to an image. Falls back to the built-in diffwiki mark. */
+    logo?: string;
+    /** Project repository URL for the top-nav GitHub link (NOT the "powered by" footer). */
+    repo?: string;
+    home?: SiteHome;
+}
+/** One collection declared in `diffwiki.yaml` → `collections[]`. */
+interface ProjectCollection {
+    name: string;
+    /** Content directory, relative to the project root. */
+    path: string;
+    /** Optional display order (ascending). Unset sorts after ordered ones, keeping list order. */
+    order?: number;
+}
+/**
+ * Normalised repo-root `diffwiki.yaml`. The extended form carries `site` +
+ * `collections[]`; the legacy `{ collection, path }` form is folded into a
+ * one-element `collections` by the parser.
+ */
+interface ProjectConfig {
+    site?: SiteConfig;
+    collections: ProjectCollection[];
+}
 /** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
 interface ArticleNode {
     /** Segment label — dir name for branches, filename-without-ext for leaves. */
@@ -47,6 +93,10 @@ interface ArticleNode {
      * leaves (the article) and on branches (the folder, navigable to its index).
      */
     slug?: string;
+    /** Audience, set only when 'private' (omitted for 'public'). */
+    audience?: Audience;
+    /** Lifecycle status, set only when 'draft' (omitted for 'published'). */
+    status?: PublishStatus;
     /** Branch only: nested nodes. */
     children?: ArticleNode[];
 }
@@ -56,6 +106,10 @@ interface ArticleContent {
     slug: string;
     title: string;
     tags: string[];
+    /** Audience from frontmatter ('public' when absent). */
+    audience: Audience;
+    /** Lifecycle status from frontmatter ('published' when absent). */
+    status: PublishStatus;
     /** Frontmatter-stripped body (md/mdx). */
     body: string;
     /** Absolute path to the file on disk. */
@@ -160,6 +214,10 @@ interface TreeNode {
     name: string;
     title?: string;
     path?: string;
+    /** Audience; present only when 'private' (drives the sidebar lock). */
+    audience?: Audience;
+    /** Lifecycle status; present only when 'draft' (drives the sidebar DRAFT tag). */
+    status?: PublishStatus;
     children?: TreeNode[];
     /** Set only on top-level collection rows: git branch/behind badge data. */
     meta?: NodeMeta;
@@ -168,8 +226,14 @@ interface CollectionInfo {
     name: string;
     type: CollectionType;
     path: string;
+    /** Display title from the collection's root index page frontmatter; falls back to `name` in the UI. */
+    title?: string;
     branch?: string;
     behind?: number;
+    /** Audience from the collection's root index page; present only when 'private'. */
+    audience?: Audience;
+    /** Lifecycle status from the collection's root index page; present only when 'draft'. */
+    status?: PublishStatus;
 }
 interface CollectionTree {
     collection: CollectionInfo;
@@ -185,6 +249,10 @@ interface DocData {
     slug: string;
     title: string;
     tags: string[];
+    /** Audience; present only when 'private'. */
+    audience?: Audience;
+    /** Lifecycle status; present only when 'draft'. */
+    status?: PublishStatus;
     html: string;
     toc: TocItem[];
     path: string;
@@ -307,11 +375,15 @@ interface ParsedArticle {
     title: string;
     tags: string[];
     created?: string;
+    audience: Audience;
+    status: PublishStatus;
     body: string;
 }
 interface SerializableArticle {
     title: string;
     tags: string[];
+    audience?: Audience;
+    status?: PublishStatus;
     body: string;
 }
 declare function parseArticle(raw: string): ParsedArticle;
@@ -387,6 +459,33 @@ interface CollectionGitStatus {
  */
 declare function collectionGitStatus(entry: CollectionEntry): Promise<CollectionGitStatus | undefined>;
 
+declare const PROJECT_CONFIG_FILE = "diffwiki.yaml";
+/**
+ * Read and normalise the repo-root `diffwiki.yaml`. Supports the extended form
+ * ({ site, collections[] }) AND the legacy single-collection form
+ * ({ collection, path }), folded into a one-element `collections`. Returns
+ * undefined when the file is absent (ENOENT); parse/other read errors propagate.
+ */
+declare function readProjectConfig(dir: string): Promise<ProjectConfig | undefined>;
+/**
+ * Resolve `diffwiki.yaml` collections into registry-shaped CollectionEntry[] with
+ * absolute paths (relative to the project root). Empty when no config / no
+ * collections. Used to seed an ephemeral registry for `preview` and the CI build.
+ */
+declare function resolveProjectCollections(dir: string): Promise<CollectionEntry[]>;
+/** The site block from `diffwiki.yaml`, or `{}` when absent. */
+declare function readSiteConfig(dir: string): Promise<SiteConfig>;
+/**
+ * Create a throwaway DIFFWIKI_HOME seeded with a registry built from the project's
+ * diffwiki.yaml collections, and return its path. This is the single mechanism
+ * both `diffwiki preview` and `diffwiki export --project` use to render a repo's
+ * own wiki without touching the global registry: seed a tmp home, point
+ * DIFFWIKI_HOME at it on the fly, and every downstream reader (listCollections,
+ * buildNavTree, buildSite) works unchanged. Throws when the config is missing or
+ * declares no collections. Callers own cleanup (`fs.rm(home, …)`).
+ */
+declare function seedProjectHome(dir: string): Promise<string>;
+
 /** Absolute working-tree root, or undefined when `cwd` is not inside a git repo. */
 declare function gitToplevel(cwd: string): Promise<string | undefined>;
 /**
@@ -436,7 +535,10 @@ interface FileTimestamps {
  */
 declare function fileTimestamps(absPath: string): Promise<FileTimestamps>;
 
-/** Map core article nodes to UI nav nodes, assigning each its route path. */
+/** Map core article nodes to UI nav nodes, assigning each its route path.
+ *  In static builds, private (audience) or draft (status) articles are dropped
+ *  entirely (no nav row, and — since routes + per-doc JSON derive from this tree
+ *  — no route/JSON). */
 declare function toTreeNodes(coll: string, nodes: ArticleNode[]): TreeNode[];
 declare function buildCollections(): Promise<CollectionInfo[]>;
 declare function buildNavTree(): Promise<CollectionTree[]>;
@@ -452,6 +554,14 @@ declare function buildNavTree(): Promise<CollectionTree[]>;
 declare function resolvePage(coll: string, slug: string, opts?: {
     include?: ReadonlySet<string>;
 }): Promise<PageData | null>;
+/**
+ * The site config for the current context, from `diffwiki.yaml` at
+ * `DIFFWIKI_PROJECT_DIR`. Returns `{}` when the env var is unset (the default
+ * runtime) or the file is missing/unreadable — the home page then falls back to
+ * collection pills. Consumed by the static exporter (site.json) and the live
+ * `getSite` server fn.
+ */
+declare function buildSite(): Promise<SiteConfig>;
 
 /**
  * Collection selection for `diffwiki export` — resolve which collection names to
@@ -640,6 +750,17 @@ declare function resolveLogLevel(env?: NodeJS.ProcessEnv): DiffwikiLogLevel;
  * is the relative path without extension. Dirs-first, then alpha (case-insensitive).
  */
 declare function buildArticleTree(relPaths: string[]): ArticleNode[];
+/**
+ * Read a collection's (or any directory's) audience + status from its index page
+ * (index.md / README). Each axis is present only at its non-default value
+ * (audience:'private' / status:'draft'), else absent. Cheap partial read — used
+ * to mark/skip whole collections the same way leaf articles are.
+ */
+declare function collectionMeta(collDir: string): Promise<{
+    title?: string;
+    audience?: Audience;
+    status?: PublishStatus;
+}>;
 /**
  * List the article tree of a collection. Walks the collection's registered
  * `entry.path` — so collections living OUTSIDE `~/.diffwiki/collections`
@@ -890,4 +1011,4 @@ declare function findEnabledPlugin(kind: PluginKind, name?: string): Promise<Plu
 /** Find a plugin record by name (regardless of enabled state). */
 declare function findPluginRecord(name: string): Promise<PluginRecord | undefined>;
 
-export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type FileTimestamps, type GraphEdge, type GraphNode, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, collectionDir, collectionGitStatus, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readRegistry, readRepoConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, search, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type Audience, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type FileTimestamps, type GraphEdge, type GraphNode, type HomeCard, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, PROJECT_CONFIG_FILE, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type ProjectCollection, type ProjectConfig, type PublishStatus, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type SiteConfig, type SiteHome, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSite, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };

package/dist/index.d.ts

@@ -2,6 +2,10 @@ import { SearchDoc } from './bm25.js';
 export { RankableFields, rankDocs, tokenize } from './bm25.js';
 import { LogLevel, Logger } from '@logtape/logtape';
 
+/** Audience axis — who an article is for. Private is never published. Missing/invalid → 'public'. */
+type Audience = 'public' | 'private';
+/** Lifecycle axis — readiness. Draft is not yet published. Missing/invalid → 'published'. */
+type PublishStatus = 'draft' | 'published';
 type CollectionType = 'global' | 'repo' | 'external';
 interface CollectionEntry {
     name: string;
@@ -36,6 +40,48 @@ interface RepoConfig {
     /** Path to the wiki directory, relative to the repo root. */
     path: string;
 }
+/** A home-page card (VitePress-style): icon + title + subtitle linking into the site. */
+interface HomeCard {
+    /** Icon name from the curated home-card icon set; unknown/missing → no icon. */
+    icon?: string;
+    title: string;
+    subtitle?: string;
+    /** In-site path, e.g. "/getting-started". */
+    link: string;
+}
+/** Home-page customization from `diffwiki.yaml` → `site.home`. */
+interface SiteHome {
+    /** Line shown under the wordmark on the home page. */
+    tagline?: string;
+    /** Cards rendered below the search bar. */
+    cards?: HomeCard[];
+}
+/** Site-level config from `diffwiki.yaml` → `site`. */
+interface SiteConfig {
+    title?: string;
+    /** Logo override: path/URL to an image. Falls back to the built-in diffwiki mark. */
+    logo?: string;
+    /** Project repository URL for the top-nav GitHub link (NOT the "powered by" footer). */
+    repo?: string;
+    home?: SiteHome;
+}
+/** One collection declared in `diffwiki.yaml` → `collections[]`. */
+interface ProjectCollection {
+    name: string;
+    /** Content directory, relative to the project root. */
+    path: string;
+    /** Optional display order (ascending). Unset sorts after ordered ones, keeping list order. */
+    order?: number;
+}
+/**
+ * Normalised repo-root `diffwiki.yaml`. The extended form carries `site` +
+ * `collections[]`; the legacy `{ collection, path }` form is folded into a
+ * one-element `collections` by the parser.
+ */
+interface ProjectConfig {
+    site?: SiteConfig;
+    collections: ProjectCollection[];
+}
 /** A node in a collection's article tree. Branches have `children`; leaves have `slug`. */
 interface ArticleNode {
     /** Segment label — dir name for branches, filename-without-ext for leaves. */
@@ -47,6 +93,10 @@ interface ArticleNode {
      * leaves (the article) and on branches (the folder, navigable to its index).
      */
     slug?: string;
+    /** Audience, set only when 'private' (omitted for 'public'). */
+    audience?: Audience;
+    /** Lifecycle status, set only when 'draft' (omitted for 'published'). */
+    status?: PublishStatus;
     /** Branch only: nested nodes. */
     children?: ArticleNode[];
 }
@@ -56,6 +106,10 @@ interface ArticleContent {
     slug: string;
     title: string;
     tags: string[];
+    /** Audience from frontmatter ('public' when absent). */
+    audience: Audience;
+    /** Lifecycle status from frontmatter ('published' when absent). */
+    status: PublishStatus;
     /** Frontmatter-stripped body (md/mdx). */
     body: string;
     /** Absolute path to the file on disk. */
@@ -160,6 +214,10 @@ interface TreeNode {
     name: string;
     title?: string;
     path?: string;
+    /** Audience; present only when 'private' (drives the sidebar lock). */
+    audience?: Audience;
+    /** Lifecycle status; present only when 'draft' (drives the sidebar DRAFT tag). */
+    status?: PublishStatus;
     children?: TreeNode[];
     /** Set only on top-level collection rows: git branch/behind badge data. */
     meta?: NodeMeta;
@@ -168,8 +226,14 @@ interface CollectionInfo {
     name: string;
     type: CollectionType;
     path: string;
+    /** Display title from the collection's root index page frontmatter; falls back to `name` in the UI. */
+    title?: string;
     branch?: string;
     behind?: number;
+    /** Audience from the collection's root index page; present only when 'private'. */
+    audience?: Audience;
+    /** Lifecycle status from the collection's root index page; present only when 'draft'. */
+    status?: PublishStatus;
 }
 interface CollectionTree {
     collection: CollectionInfo;
@@ -185,6 +249,10 @@ interface DocData {
     slug: string;
     title: string;
     tags: string[];
+    /** Audience; present only when 'private'. */
+    audience?: Audience;
+    /** Lifecycle status; present only when 'draft'. */
+    status?: PublishStatus;
     html: string;
     toc: TocItem[];
     path: string;
@@ -307,11 +375,15 @@ interface ParsedArticle {
     title: string;
     tags: string[];
     created?: string;
+    audience: Audience;
+    status: PublishStatus;
     body: string;
 }
 interface SerializableArticle {
     title: string;
     tags: string[];
+    audience?: Audience;
+    status?: PublishStatus;
     body: string;
 }
 declare function parseArticle(raw: string): ParsedArticle;
@@ -387,6 +459,33 @@ interface CollectionGitStatus {
  */
 declare function collectionGitStatus(entry: CollectionEntry): Promise<CollectionGitStatus | undefined>;
 
+declare const PROJECT_CONFIG_FILE = "diffwiki.yaml";
+/**
+ * Read and normalise the repo-root `diffwiki.yaml`. Supports the extended form
+ * ({ site, collections[] }) AND the legacy single-collection form
+ * ({ collection, path }), folded into a one-element `collections`. Returns
+ * undefined when the file is absent (ENOENT); parse/other read errors propagate.
+ */
+declare function readProjectConfig(dir: string): Promise<ProjectConfig | undefined>;
+/**
+ * Resolve `diffwiki.yaml` collections into registry-shaped CollectionEntry[] with
+ * absolute paths (relative to the project root). Empty when no config / no
+ * collections. Used to seed an ephemeral registry for `preview` and the CI build.
+ */
+declare function resolveProjectCollections(dir: string): Promise<CollectionEntry[]>;
+/** The site block from `diffwiki.yaml`, or `{}` when absent. */
+declare function readSiteConfig(dir: string): Promise<SiteConfig>;
+/**
+ * Create a throwaway DIFFWIKI_HOME seeded with a registry built from the project's
+ * diffwiki.yaml collections, and return its path. This is the single mechanism
+ * both `diffwiki preview` and `diffwiki export --project` use to render a repo's
+ * own wiki without touching the global registry: seed a tmp home, point
+ * DIFFWIKI_HOME at it on the fly, and every downstream reader (listCollections,
+ * buildNavTree, buildSite) works unchanged. Throws when the config is missing or
+ * declares no collections. Callers own cleanup (`fs.rm(home, …)`).
+ */
+declare function seedProjectHome(dir: string): Promise<string>;
+
 /** Absolute working-tree root, or undefined when `cwd` is not inside a git repo. */
 declare function gitToplevel(cwd: string): Promise<string | undefined>;
 /**
@@ -436,7 +535,10 @@ interface FileTimestamps {
  */
 declare function fileTimestamps(absPath: string): Promise<FileTimestamps>;
 
-/** Map core article nodes to UI nav nodes, assigning each its route path. */
+/** Map core article nodes to UI nav nodes, assigning each its route path.
+ *  In static builds, private (audience) or draft (status) articles are dropped
+ *  entirely (no nav row, and — since routes + per-doc JSON derive from this tree
+ *  — no route/JSON). */
 declare function toTreeNodes(coll: string, nodes: ArticleNode[]): TreeNode[];
 declare function buildCollections(): Promise<CollectionInfo[]>;
 declare function buildNavTree(): Promise<CollectionTree[]>;
@@ -452,6 +554,14 @@ declare function buildNavTree(): Promise<CollectionTree[]>;
 declare function resolvePage(coll: string, slug: string, opts?: {
     include?: ReadonlySet<string>;
 }): Promise<PageData | null>;
+/**
+ * The site config for the current context, from `diffwiki.yaml` at
+ * `DIFFWIKI_PROJECT_DIR`. Returns `{}` when the env var is unset (the default
+ * runtime) or the file is missing/unreadable — the home page then falls back to
+ * collection pills. Consumed by the static exporter (site.json) and the live
+ * `getSite` server fn.
+ */
+declare function buildSite(): Promise<SiteConfig>;
 
 /**
  * Collection selection for `diffwiki export` — resolve which collection names to
@@ -640,6 +750,17 @@ declare function resolveLogLevel(env?: NodeJS.ProcessEnv): DiffwikiLogLevel;
  * is the relative path without extension. Dirs-first, then alpha (case-insensitive).
  */
 declare function buildArticleTree(relPaths: string[]): ArticleNode[];
+/**
+ * Read a collection's (or any directory's) audience + status from its index page
+ * (index.md / README). Each axis is present only at its non-default value
+ * (audience:'private' / status:'draft'), else absent. Cheap partial read — used
+ * to mark/skip whole collections the same way leaf articles are.
+ */
+declare function collectionMeta(collDir: string): Promise<{
+    title?: string;
+    audience?: Audience;
+    status?: PublishStatus;
+}>;
 /**
  * List the article tree of a collection. Walks the collection's registered
  * `entry.path` — so collections living OUTSIDE `~/.diffwiki/collections`
@@ -890,4 +1011,4 @@ declare function findEnabledPlugin(kind: PluginKind, name?: string): Promise<Plu
 /** Find a plugin record by name (regardless of enabled state). */
 declare function findPluginRecord(name: string): Promise<PluginRecord | undefined>;
 
-export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type FileTimestamps, type GraphEdge, type GraphNode, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, collectionDir, collectionGitStatus, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readRegistry, readRepoConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, search, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, type Audience, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type FileTimestamps, type GraphEdge, type GraphNode, type HomeCard, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type LinkGraph, type ListingEntry, type LocalGraph, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, PROJECT_CONFIG_FILE, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type ProjectCollection, type ProjectConfig, type PublishStatus, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type SiteConfig, type SiteHome, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildLinkGraph, buildNavTree, buildSearchIndex, buildSite, collectionDir, collectionGitStatus, collectionMeta, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, invalidateLinkGraph, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, localGraph, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readProjectConfig, readRegistry, readRepoConfig, readSiteConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, resolveProjectCollections, search, seedProjectHome, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };