@riebeckite/core 0.0.18 → 0.0.19

package/dist/index.d.ts

@@ -44,8 +44,8 @@ export type { CreatePluginMemoOptions, PluginMemo, } from "./src/plugin/plugin_m
 export { createPluginMemo, stableStringify, } from "./src/plugin/plugin_memo.js";
 export { resolveBuildOutputDirectory, resolveManagedStateRoot, } from "./src/project/project_layout.js";
 export type { ConfigValidationIssue, PluginOptionsValidator, } from "./src/types/config_validation.js";
-export type { ContentAsset, ContentBodySlot, ContentLink, ContentLinkKind, ContentLocationInput, ContentManifest, ContentManifestEntry, ContentManifestPluginClientEntry, ContentPublicLocation, ContentRedirect, FolderLocation, PluginPageRoute, } from "./src/types/content_manifest.js";
-export { appendContentBodySlot } from "./src/types/content_manifest.js";
+export type { ContentAsset, ContentBodySlot, ContentBodySlots, ContentLink, ContentLinkKind, ContentLocationInput, ContentManifest, ContentManifestEntry, ContentManifestPluginClientEntry, ContentPublicLocation, ContentRedirect, FolderLocation, PluginPageRoute, } from "./src/types/content_manifest.js";
+export { ARTICLE_SLOT, appendContentBodySlot, } from "./src/types/content_manifest.js";
 export type { Diagnostic, DiagnosticCode, DiagnosticSeverity, } from "./src/types/diagnostic.js";
 export type { ContentAssetOutputInput, GeneratedOutput, GeneratedOutputContent, GeneratedOutputInput, GeneratedOutputSink, } from "./src/types/generated_output.js";
 export { createUnavailableGeneratedOutputSink, normalizeContentAssetOutputPath, normalizeGeneratedOutputPath, } from "./src/types/generated_output.js";

package/dist/index.js

@@ -1766,7 +1766,14 @@ function createPersistentContentCache(options) {
           );
           return void 0;
         }
-        throw error;
+        logger?.warn(
+          "Persistent content cache entry could not be read and will be ignored.",
+          {
+            key,
+            error: error instanceof Error ? error.message : String(error)
+          }
+        );
+        return void 0;
       }
     },
     async set(key, value) {
@@ -1778,8 +1785,18 @@ function createPersistentContentCache(options) {
           "Persistent content cache values must be JSON serializable."
         );
       }
-      await writeAtomically(filePath, versionDir, serialized);
-      tracer?.event("persistentContentCache.write", { key });
+      try {
+        await writeAtomically(filePath, versionDir, serialized);
+        tracer?.event("persistentContentCache.write", { key });
+      } catch (error) {
+        logger?.warn(
+          "Persistent content cache entry could not be written and will be ignored.",
+          {
+            key,
+            error: error instanceof Error ? error.message : String(error)
+          }
+        );
+      }
     },
     async clear() {
       try {
@@ -3680,9 +3697,14 @@ var ContentEntryReader = class {
     if (cached) return cached;
     const content = this.source.read(entry).then(
       (value) => typeof value === "string" ? value : new TextDecoder().decode(value)
-    ).finally(() => this.texts.delete(entry.path));
-    this.texts.set(entry.path, content);
-    return content;
+    );
+    const retain = entry.path.endsWith(".md");
+    const tracked = retain ? content : content.finally(() => this.texts.delete(entry.path));
+    this.texts.set(entry.path, tracked);
+    return tracked;
+  }
+  clearReadCache() {
+    this.texts.clear();
   }
 };
 
@@ -4650,6 +4672,7 @@ var ContentManager = class {
     return { entries, contentIndex, diagnostics };
   }
   async dispose() {
+    this.entryReader.clearReadCache();
     if (!this.contentIndex) return;
     await this.pluginRuntime.dispose(this.contentIndex);
   }
@@ -5148,6 +5171,14 @@ function resolveBuildOutputDirectory(config) {
 }
 
 // src/types/content_manifest.ts
+var ARTICLE_SLOT = {
+  header: "article.header",
+  metadata: "article.metadata",
+  aside: "article.aside",
+  beforeContent: "article.before-content",
+  afterContent: "article.after-content",
+  footer: "article.footer"
+};
 function appendContentBodySlot(entry, slot, html) {
   if (!html.trim()) return;
   const previous = entry.bodySlots?.[slot];
@@ -5199,6 +5230,7 @@ function calculateReadingTime(html) {
   return Math.max(1, Math.ceil(cjkCharacters / 500 + latinWords / 220));
 }
 export {
+  ARTICLE_SLOT,
   ATTACHMENTS_BASE_PATH,
   CompositeTraceSink,
   ConfigValidationError,

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/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 = {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/core",
-  "version": "0.0.18",
+  "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.18"
+    "@riebeckite/test": "0.0.19"
   },
   "repository": {
     "type": "git",