@riebeckite/core 0.0.17 → 0.0.19

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

@@ -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 = 7;
+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_entry_reader.d.ts

@@ -11,4 +11,5 @@ export declare class ContentEntryReader {
     getEntries(): Promise<readonly ContentSourceEntry[]>;
     readText(logicalPath: string): Promise<string>;
     read(entry: ContentSourceEntry): Promise<string>;
+    clearReadCache(): void;
 }

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_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/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/plugin/plugin_lifecycle.d.ts

@@ -2,6 +2,7 @@ import type { Tracer } from "../observability.js";
 import type { RiebeckitePlugin } from "../types/plugin.js";
 import type { PluginLifecycleContext, PluginManifestContext } from "../types/plugin_context.js";
 export declare class PluginHookError extends Error {
+    readonly path?: string;
     constructor(pluginName: string, hookName: string, cause: unknown);
 }
 export declare function runPluginHook<TContext extends {

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

@@ -18,13 +18,36 @@ export type ContentAsset = {
 export type ContentManifestPluginAsset = PluginAsset & {
     path: string;
 };
+/**
+ * The standard `article.*` positions the article consumer recognizes.
+ *
+ * These constants are a convenience for Sites that prefer named references;
+ * writing the slot string inline (for example `name="article.metadata"`) stays
+ * the recommended, most readable form in TSX layouts.
+ */
+export declare const ARTICLE_SLOT: {
+    readonly header: "article.header";
+    readonly metadata: "article.metadata";
+    readonly aside: "article.aside";
+    readonly beforeContent: "article.before-content";
+    readonly afterContent: "article.after-content";
+    readonly footer: "article.footer";
+};
 /**
  * A semantic position in a Site-owned article layout.
  *
  * 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.header" | "article.metadata" | "article.aside" | "article.before-content" | "article.after-content" | "article.footer" | (string & {});
+export type ContentBodySlot = (typeof ARTICLE_SLOT)[keyof typeof ARTICLE_SLOT] | (string & {});
+/**
+ * A map of Plugin-provided HTML fragments keyed by slot name.
+ *
+ * The standard `article.*` names autocomplete while any custom slot name
+ * remains valid, so custom Plugins keep working. A slot is considered empty
+ * when its value is missing or whitespace-only.
+ */
+export type ContentBodySlots = Partial<Record<(typeof ARTICLE_SLOT)[keyof typeof ARTICLE_SLOT], string>> & Readonly<Record<string, string | undefined>>;
 /** Client entries and their explicitly public configuration. */
 export type ContentManifestPluginClientEntry = PluginClientEntry;
 export type ContentManifestEntry = {
@@ -77,6 +100,8 @@ export type ContentPublicLocation = {
 };
 export type FolderLocation = {
     pathname: string;
+    folder?: string;
+    language?: string;
 };
 export type PluginPageRoute = {
     pathname: string;
@@ -121,6 +146,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_page.d.ts

@@ -18,7 +18,11 @@ export type PluginPage = {
     language?: string;
 };
 export type PluginPageContext = PluginContext & {
-    /** The public manifest. Unpublished content is not exposed through pages. */
+    /**
+     * The resolved manifest. `manifest.entries` still contains `draft` and
+     * `scheduled` entries, so page output must read `publicEntries` (routable) or
+     * `discoverableEntries` (public only) instead of `entries`.
+     */
     manifest: ContentManifest;
     /** Request pathname, normalized to an absolute path. */
     pathname: string;

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

@@ -25,7 +25,7 @@ export type RenderableFeedEntry = ContentManifestEntry & {
     html?: string;
 };
 export type PluginSeoExtension = {
-    buildArticleSeo(config: ResolvedRiebeckiteConfig, permalink: string, post: PostContent, headTags?: readonly PluginHeadTag[]): 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;

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

@@ -9,6 +9,11 @@ export type ResolvedRiebeckiteConfig = {
      * relative to their application root.
      */
     buildDirectory?: string;
+    /**
+     * Directory for the built site. Host integrations resolve this relative to
+     * their application root.
+     */
+    outputDirectory?: string;
     site: Omit<Required<SiteConfig>, "feed"> & {
         feed: {
             title: string;

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.17",
+  "version": "0.0.19",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,7 +49,7 @@
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/test": "0.0.17"
+    "@riebeckite/test": "0.0.19"
   },
   "repository": {
     "type": "git",