@riebeckite/core 0.0.16 → 0.0.18

package/dist/src/config.d.ts

@@ -4,5 +4,7 @@ import type { RiebeckiteConfig } from "./types/riebeckite_config.js";
 export declare function defineConfig(config: RiebeckiteConfig): RiebeckiteConfig;
 export declare function resolveConfigModule(configModule: unknown): ResolvedRiebeckiteConfig;
 export declare function resolveConfig(config: RiebeckiteConfig): ResolvedRiebeckiteConfig;
-export declare function isPublished(config: ResolvedRiebeckiteConfig, frontmatter: PostFrontmatter | undefined): boolean;
+export declare function isPublished(config: ResolvedRiebeckiteConfig, frontmatter: PostFrontmatter | undefined, options?: {
+    buildTime?: Date | string;
+}): boolean;
 export declare function isExcluded(patterns: readonly string[], relativePath: string): boolean;

package/dist/src/content/content_build_coordinator.d.ts

@@ -3,7 +3,7 @@ import type { ContentManifest, ContentManifestEntry } from "../types/content_man
 import { determineAffectedContent } from "./affected_content.js";
 import { type ContentBuildState, type FingerprintedContentEntry } from "./content_build_state.js";
 import { type ContentChangeSet } from "./content_change_set.js";
-import type { CachedContentDependency } from "./content_dependency_tracker.js";
+import { type CachedContentDependency } from "./content_dependency_tracker.js";
 import type { ContentSourceEntry } from "./content_source.js";
 import type { OutputDescriptor } from "./output_dependency.js";
 export type ContentBuildPreparation = {
@@ -12,6 +12,7 @@ export type ContentBuildPreparation = {
     readonly currentEntries: readonly FingerprintedContentEntry[];
     readonly currentContentAliases: ReadonlyMap<string, readonly string[]>;
     readonly currentContentIndex: Map<string, string>;
+    readonly currentContentIndexAmbiguities: ReadonlyMap<string, readonly string[]>;
     readonly changeSet: ContentChangeSet;
     readonly affectedContent: ReturnType<typeof determineAffectedContent>;
 };

package/dist/src/content/content_build_state.d.ts

@@ -1,7 +1,7 @@
 import type { ContentManifestEntry } from "../types/content_manifest.js";
 import type { ContentSourceEntry } from "./content_source.js";
 import type { OutputDescriptor } from "./output_dependency.js";
-export declare const CONTENT_BUILD_STATE_VERSION = 6;
+export declare const CONTENT_BUILD_STATE_VERSION = 8;
 /**
  * Build state lives under `<content directory>/.riebeckite`. That directory is
  * build-time state, not content, so content sources must exclude it from scans

package/dist/src/content/content_dependency_tracker.d.ts

@@ -1,4 +1,6 @@
 import type { ContentSource, ContentSourceContent } from "./content_source.js";
+export declare const LINK_INDEX_PREFIX = "index:";
+export declare const LINK_LOCATION_PREFIX = "location:";
 export type CachedContentDependency = {
     readonly kind: "content" | "file" | "link";
     readonly id: string;

package/dist/src/content/content_index_builder.d.ts

@@ -1,9 +1,13 @@
 import type { ContentSource, ContentSourceEntry } from "./content_source.js";
+export type ContentIndexBuild = {
+    readonly index: Map<string, string>;
+    readonly ambiguities: ReadonlyMap<string, readonly string[]>;
+};
 export declare class ContentIndexBuilder {
     private source;
     constructor(source: ContentSource);
-    build(contentEntries: readonly ContentSourceEntry[], read?: (entry: ContentSourceEntry) => Promise<import("./content_source.js").ContentSourceContent>): Promise<Map<string, string>>;
-    static buildFromAliases(contentEntries: readonly ContentSourceEntry[], aliasesByPath: ReadonlyMap<string, readonly string[]>): Map<string, string>;
+    build(contentEntries: readonly ContentSourceEntry[], read?: (entry: ContentSourceEntry) => Promise<import("./content_source.js").ContentSourceContent>): Promise<ContentIndexBuild>;
+    static buildFromAliases(contentEntries: readonly ContentSourceEntry[], aliasesByPath: ReadonlyMap<string, readonly string[]>): ContentIndexBuild;
     private indexContentEntry;
     private static indexContentEntryFromAliases;
 }

package/dist/src/content/content_language.d.ts

@@ -0,0 +1,3 @@
+import type { ContentManifestEntry } from "../types/content_manifest.js";
+export declare function getEntryLanguage(entry: ContentManifestEntry): string | undefined;
+export declare function selectEntriesByLanguage(entries: readonly ContentManifestEntry[], language: string | undefined): readonly ContentManifestEntry[];

package/dist/src/content/content_manager.d.ts

@@ -29,6 +29,7 @@ export declare class ContentManager {
     private manifestBuilder;
     private pluginRuntime;
     private contentIndex;
+    private contentIndexAmbiguities;
     private contentIndexPromise;
     private contentCache;
     private manifest;
@@ -51,6 +52,7 @@ export declare class ContentManager {
     getPost(slug: string): Promise<string>;
     getContentIndex(preparation?: ContentBuildPreparation): Promise<Map<string, string>>;
     getProcessedContent(slug: string): Promise<PostContent>;
+    private processContent;
     getManifest(options?: ContentBuildOptions): Promise<ContentManifest>;
     private buildManifest;
     build(options?: ContentBuildOptions): Promise<ContentManifest>;

package/dist/src/content/content_stable_id.d.ts

@@ -1,8 +1,5 @@
 import type { PostFrontmatter } from "../types/post_content.js";
 /**
- * Reads the optional, source-authored stable content ID.
- *
- * `id` is the canonical frontmatter field. `uid` is accepted only for
- * compatibility with existing content that used it before `id` was standard.
+ * Reads the optional, source-authored stable content ID from frontmatter.
  */
 export declare function resolveContentStableId(frontmatter: PostFrontmatter): string | undefined;

package/dist/src/content/file_system_content_source.d.ts

@@ -1,13 +1,22 @@
 import type { ContentSource, ContentSourceContent, ContentSourceEntry } from "./content_source.js";
 export declare const INTERNAL_CONTENT_IGNORE_PATTERNS: readonly [".git", ".git/**", ".github", ".github/**", ".obsidian", ".obsidian/**", "node_modules", "node_modules/**", "**/.DS_Store", "**/Thumbs.db", "**/desktop.ini"];
+export type ContentSourceExclusion = {
+    readonly path: string;
+    readonly pattern: string;
+};
+export type ContentSourceScan = {
+    readonly entries: readonly ContentSourceEntry[];
+    readonly exclusions: readonly ContentSourceExclusion[];
+};
 export declare class FileSystemContentSource implements ContentSource {
     private contentDirectory;
     private exclude;
     constructor(contentDirectory: string, exclude?: readonly string[]);
     scan(): Promise<readonly ContentSourceEntry[]>;
+    scanWithExclusions(): Promise<ContentSourceScan>;
     read(entry: ContentSourceEntry): Promise<ContentSourceContent>;
     private scanDirectory;
-    private isExcluded;
     private resolveFilePath;
 }
 export declare function isIgnoredContentPath(logicalPath: string, exclude?: readonly string[]): boolean;
+export declare function matchContentExcludePattern(logicalPath: string, exclude?: readonly string[]): string | undefined;

package/dist/src/content/folder_entry.d.ts

@@ -33,4 +33,4 @@ export type FolderLocationResolution = {
 export declare function resolveFolderEntry(manifest: ContentManifest, folder: string, options?: ResolveFolderEntryOptions): FolderEntryResolution;
 export declare function resolveFolderLocation(manifest: ContentManifest, folder: string): FolderLocationResolution;
 export declare function resolvePublicFolderLocation(manifest: ContentManifest, pathname: string): FolderLocationResolution;
-export declare function resolveGeneratedFolderLocation(manifest: ContentManifest, folder: string): string | null;
+export declare function resolveGeneratedFolderLocation(manifest: ContentManifest, folder: string, language?: string): string | null;

package/dist/src/content/manifest_builder.d.ts

@@ -3,5 +3,5 @@ import type { PostContent } from "../types/post_content.js";
 import type { ResolvedPublishingState } from "./publishing.js";
 export declare class ManifestBuilder {
     createEntry(slug: string, markdown: string, processed: PostContent, contentIndex: Map<string, string>, location: ContentPublicLocation, publishing: ResolvedPublishingState): ContentManifestEntry;
-    build(entries: ContentManifestEntry[], contentIndex: Map<string, string>): ContentManifest;
+    build(entries: ContentManifestEntry[], contentIndex: Map<string, string>, contentIndexAmbiguities?: ReadonlyMap<string, readonly string[]>): ContentManifest;
 }

package/dist/src/pipeline.d.ts

@@ -29,6 +29,7 @@ export declare class Pipeline {
     private reportContentDependencies;
     private getPermalink;
     private resolveLinkDependency;
+    private recordNoteLinkDependencies;
     private use;
     private createNoteEmbedRenderer;
     private resolvePlugins;

package/dist/src/plugin/plugin_lifecycle.d.ts

@@ -1,11 +1,14 @@
+import type { Tracer } from "../observability.js";
 import type { RiebeckitePlugin } from "../types/plugin.js";
 import type { PluginLifecycleContext, PluginManifestContext } from "../types/plugin_context.js";
-type LifecycleHookName = "setup" | "buildStart" | "buildEnd" | "dispose";
-export declare class PluginLifecycleError extends Error {
-    constructor(pluginName: string, hookName: LifecycleHookName, cause: unknown);
+export declare class PluginHookError extends Error {
+    readonly path?: string;
+    constructor(pluginName: string, hookName: string, cause: unknown);
 }
+export declare function runPluginHook<TContext extends {
+    tracer: Tracer;
+}, TResult>(plugin: RiebeckitePlugin, hookName: string, context: TContext, hook: (context: TContext) => TResult | Promise<TResult>): Promise<TResult>;
 export declare function runSetup(plugins: readonly RiebeckitePlugin[], createContext: (plugin: RiebeckitePlugin) => PluginLifecycleContext): Promise<void>;
 export declare function runBuildStart(plugins: readonly RiebeckitePlugin[], createContext: (plugin: RiebeckitePlugin) => PluginLifecycleContext): Promise<void>;
 export declare function runBuildEnd(plugins: readonly RiebeckitePlugin[], createContext: (plugin: RiebeckitePlugin) => PluginManifestContext): Promise<void>;
 export declare function runDispose(plugins: readonly RiebeckitePlugin[], createContext: (plugin: RiebeckitePlugin) => PluginLifecycleContext): Promise<void>;
-export {};

package/dist/src/plugin/plugin_runtime.d.ts

@@ -12,7 +12,7 @@ import type { PostContent } from "../types/post_content.js";
  * requested yet; the remaining values name the stage currently executing.
  * Once `started` is reached the lifecycle never runs again.
  */
-export type PluginBuildStage = "idle" | "setup" | "buildStart" | "onBuildStart" | "onConfigResolved" | "started";
+export type PluginBuildStage = "idle" | "setup" | "buildStart" | "onConfigResolved" | "started";
 export declare class PluginRuntime {
     private pipelineOptions;
     private buildLifecycle;
@@ -23,6 +23,7 @@ export declare class PluginRuntime {
     private generatedOutputs;
     private isBuildTime;
     private resolvedPlugins;
+    private pageDeclarations;
     constructor(pipelineOptions?: PipelineOptions);
     getDiagnostics(): Diagnostic[];
     getBuildStage(): PluginBuildStage;
@@ -30,7 +31,7 @@ export declare class PluginRuntime {
      * Starts the plugin build lifecycle exactly once, regardless of which public
      * entry point (content processing or location resolution) reaches it first.
      * Concurrent callers await the same run, so the ordered hooks
-     * (`setup` → `buildStart` → `onBuildStart` → `onConfigResolved`) are never
+     * (`setup` → `buildStart` → `onConfigResolved`) are never
      * duplicated and no caller proceeds before the lifecycle completes.
      */
     startBuild(contentIndex: Map<string, string>): Promise<void>;
@@ -61,6 +62,8 @@ export declare class PluginRuntime {
     getPagePaths(manifest: ContentManifest, contentIndex: Map<string, string>): Promise<readonly string[]>;
     getPageRoutes(manifest: ContentManifest, contentIndex: Map<string, string>): Promise<readonly PluginPageRoute[]>;
     getPageOutputs(manifest: ContentManifest, contentIndex: Map<string, string>): Promise<readonly OutputDescriptor[]>;
+    private getPageDeclarations;
+    private resolvePageDeclarations;
     getContentOutputDependencies(): readonly OutputDependency[];
     collectDiagnostics(contentIndex: Map<string, string>): Promise<Diagnostic[]>;
     private runBuildLifecycle;

package/dist/src/project/project_layout.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedRiebeckiteConfig } from "../types/resolved_riebeckite_config.js";
+/**
+ * Root directory for Riebeckite-managed persistent state: content build state,
+ * plugin cache, persistent content cache, and the SSG output cache. The root is
+ * reproducible and safe to remove; missing paths are not an error.
+ */
+export declare function resolveManagedStateRoot(config: ResolvedRiebeckiteConfig | undefined): string | undefined;
+/**
+ * Directory for the built site. Missing paths are not an error.
+ */
+export declare function resolveBuildOutputDirectory(config: ResolvedRiebeckiteConfig | undefined): string | undefined;

package/dist/src/types/content_manifest.d.ts

@@ -24,7 +24,7 @@ export type ContentManifestPluginAsset = PluginAsset & {
  * The standard article consumer recognizes the `article.*` positions below.
  * Other names remain valid so a custom Site can define its own layout slots.
  */
-export type ContentBodySlot = "article.after-header" | "article.after-meta" | "article.aside" | "article.before-content" | "article.after-content" | "article.footer" | (string & {});
+export type ContentBodySlot = "article.header" | "article.metadata" | "article.aside" | "article.before-content" | "article.after-content" | "article.footer" | (string & {});
 /** Client entries and their explicitly public configuration. */
 export type ContentManifestPluginClientEntry = PluginClientEntry;
 export type ContentManifestEntry = {
@@ -71,11 +71,14 @@ export type ContentRedirect = {
 export type ContentPublicLocation = {
     slug: string;
     permalink: string;
+    language?: string;
     redirects?: readonly ContentRedirect[];
     metadata?: Readonly<Record<string, string>>;
 };
 export type FolderLocation = {
     pathname: string;
+    folder?: string;
+    language?: string;
 };
 export type PluginPageRoute = {
     pathname: string;
@@ -90,9 +93,10 @@ export type ContentLocationInput = {
 export type ContentManifest = {
     entries: ContentManifestEntry[];
     /**
-     * Entries that pass the configured publish strategy. `entries` keeps every
-     * scanned note for backward compatibility; publishing plugins should read
-     * this view so unpublished notes never reach generated output.
+     * Entries that are routable and therefore get a generated page: `public`
+     * and `unlisted` notes. `entries` keeps every scanned note for backward
+     * compatibility; plugins that emit generated output should read this view
+     * so drafts and scheduled notes never reach generated output.
      */
     publicEntries: ContentManifestEntry[];
     /** Entries that may appear on discovery surfaces such as navigation, search, feeds, taxonomy, and public graphs. */
@@ -119,6 +123,13 @@ export type ContentManifest = {
     outgoingLinks: Map<string, ContentLink[]>;
     incomingLinks: Map<string, string[]>;
     contentIndex: Map<string, string>;
+    /**
+     * Lookup keys that matched more than one candidate, mapped to their
+     * candidates (sorted). These keys are intentionally absent from
+     * `contentIndex` so links stay unresolved instead of picking a target by
+     * discovery order. Used to report actionable ambiguity diagnostics.
+     */
+    contentIndexAmbiguities?: ReadonlyMap<string, readonly string[]>;
     graph: ContentGraph;
     assets: ContentManifestPluginAsset[];
     /**

package/dist/src/types/plugin.d.ts

@@ -59,8 +59,6 @@ export type RiebeckitePlugin<TOptions = unknown> = {
     onPostParsed?(context: PluginPostContext): void | Promise<void>;
     onPostProcessed?(context: PluginPostContext): void | Promise<void>;
     onManifestCreated?(context: PluginManifestContext): void | Promise<void>;
-    onBuildStart?(context: PluginContext): void | Promise<void>;
-    onBuildEnd?(context: PluginManifestContext): void | Promise<void>;
     extendMarkdownPipeline?(pipeline: MarkdownPipeline, context: MarkdownPipelineContext): void;
     extendHtmlPipeline?(pipeline: HtmlPipeline): void;
     addDiagnostics?(context: PluginContext): Diagnostic[] | Promise<Diagnostic[]>;

package/dist/src/types/plugin_page.d.ts

@@ -14,6 +14,8 @@ export type PluginPage = {
     description?: string;
     /** Optional document metadata rendered by the site's document frame. */
     headTags?: readonly PluginHeadTag[];
+    /** Language of the page when the page type resolved one. */
+    language?: string;
 };
 export type PluginPageContext = PluginContext & {
     /** The public manifest. Unpublished content is not exposed through pages. */

package/dist/src/types/plugin_seo.d.ts

@@ -1,4 +1,5 @@
 import type { ContentManifestEntry } from "./content_manifest.js";
+import type { PluginHeadTag } from "./plugin_head.js";
 import type { PostContent } from "./post_content.js";
 import type { ResolvedRiebeckiteConfig } from "./resolved_riebeckite_config.js";
 export type SeoMetadata = {
@@ -24,8 +25,8 @@ export type RenderableFeedEntry = ContentManifestEntry & {
     html?: string;
 };
 export type PluginSeoExtension = {
-    buildArticleSeo(config: ResolvedRiebeckiteConfig, permalink: string, post: PostContent): SeoMetadata;
-    buildWebsiteSeo(config: ResolvedRiebeckiteConfig, input: WebsiteSeoInput): SeoMetadata;
+    buildArticleSeo(config: ResolvedRiebeckiteConfig, permalink: string, post: PostContent, headTags?: readonly PluginHeadTag[], language?: string): SeoMetadata;
+    buildWebsiteSeo(config: ResolvedRiebeckiteConfig, input: WebsiteSeoInput, headTags?: readonly PluginHeadTag[]): SeoMetadata;
     buildAbsoluteUrl(config: ResolvedRiebeckiteConfig, pathOrUrl: string): string;
     buildPostUrl(config: ResolvedRiebeckiteConfig, permalink: string): string;
     getDescription(post: Pick<PostContent, "frontmatter" | "html">): string;

package/dist/src/types/post_content.d.ts

@@ -8,8 +8,6 @@ export type PostFrontmatter = Record<string, unknown> & {
      * this value survives a rename or public-location change.
      */
     id?: string;
-    /** @deprecated Use `id`. Read only as a compatibility fallback. */
-    uid?: string;
     title?: string;
     description?: string;
     date?: string | Date;

package/dist/src/types/resolved_riebeckite_config.d.ts

@@ -1,5 +1,4 @@
 import type { ContentSource } from "../content/content_source.js";
-import type { NavigationConfig } from "./navigation_config.js";
 import type { RiebeckitePlugin } from "./plugin.js";
 import type { PublishStrategy } from "./publish_strategy.js";
 import type { SiteConfig } from "./site_config.js";
@@ -10,8 +9,18 @@ export type ResolvedRiebeckiteConfig = {
      * relative to their application root.
      */
     buildDirectory?: string;
-    site: Required<SiteConfig>;
-    navigation: Required<NavigationConfig>;
+    /**
+     * Directory for the built site. Host integrations resolve this relative to
+     * their application root.
+     */
+    outputDirectory?: string;
+    site: Omit<Required<SiteConfig>, "feed"> & {
+        feed: {
+            title: string;
+            description: string;
+            language: string;
+        };
+    };
     content: {
         directory: string;
         source?: ContentSource;
@@ -20,11 +29,6 @@ export type ResolvedRiebeckiteConfig = {
             publishStrategy: PublishStrategy;
         };
     };
-    markdown: {
-        syntaxHighlight: {
-            theme: string;
-        };
-    };
     theme: Required<Omit<ThemeConfig, "tokens">> & {
         tokens: NonNullable<ThemeConfig["tokens"]>;
         styles: ThemeStyle[];

package/dist/src/types/riebeckite_config.d.ts

@@ -1,12 +1,10 @@
 import type { ContentSource } from "../content/content_source.js";
-import type { NavigationConfig } from "./navigation_config.js";
 import type { PluginInput } from "./plugin.js";
 import type { PublishStrategy } from "./publish_strategy.js";
 import type { SiteConfig } from "./site_config.js";
 import type { ThemeInput } from "./theme_config.js";
 export interface RiebeckiteConfig {
     site: SiteConfig;
-    navigation?: NavigationConfig;
     content?: {
         directory?: string;
         source?: ContentSource;
@@ -15,11 +13,6 @@ export interface RiebeckiteConfig {
             publishStrategy?: PublishStrategy;
         };
     };
-    markdown?: {
-        syntaxHighlight?: {
-            theme?: string;
-        };
-    };
     theme?: ThemeInput;
     plugins?: PluginInput[];
     cache?: {

package/dist/src/utils/error.d.ts

@@ -0,0 +1 @@
+export declare function attachErrorPath<T>(error: T, path: string): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/core",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,7 +49,7 @@
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/test": "0.0.16"
+    "@riebeckite/test": "0.0.18"
   },
   "repository": {
     "type": "git",

package/dist/src/types/navigation_config.d.ts

@@ -1,10 +0,0 @@
-export interface NavigationItem {
-    label: string;
-    href: string;
-    children?: readonly NavigationItem[];
-    external?: boolean;
-}
-export interface NavigationConfig {
-    header?: readonly NavigationItem[];
-    footer?: readonly NavigationItem[];
-}