@riebeckite/core 0.0.13 → 0.0.14

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { defineConfig, isExcluded, isPublished, resolveConfig, resolveConfigModule, } from "./src/config.js";
+export { type ConfigDeprecationNotice, collectConfigDeprecationDiagnostics, } from "./src/config_deprecations.js";
 export { ConfigValidationError } from "./src/config_validation.js";
 export { ATTACHMENTS_BASE_PATH, attachmentUrl, getExtension, isAttachmentPath, isImagePath, isMarkdownPath, normalizeContentPath, } from "./src/content/attachment.js";
 export type { ContentBuildState, FingerprintedContentEntry, } from "./src/content/content_build_state.js";
@@ -23,6 +24,7 @@ export type { GraphEdge, GraphLayoutNode, LinkableGraphNode, RadialGraphLayoutOp
 export { buildGraphEdges, layoutRadialGraph, } from "./src/content/graph_layout.js";
 export { IMAGE_EXTENSIONS } from "./src/content/image_extensions.js";
 export { readOnlyContentGraph } from "./src/content/read_only_content_graph.js";
+export { createDeprecationDiagnostic, type DeprecationKind, type DeprecationNotice, formatDeprecationMessage, } from "./src/deprecation.js";
 export type { LogContext, Logger, LogLevel, Observability, ObservabilityValue, TraceAttributes, TraceEvent, Tracer, TraceSink, TraceSpan, } from "./src/observability.js";
 export { CompositeTraceSink, ConsoleLogger, NoopLogger, NoopTracer, SinkTracer, } from "./src/observability.js";
 export type { PipelineOptions } from "./src/pipeline.js";

package/dist/index.js

@@ -693,6 +693,46 @@ function globToRegExp(glob) {
   return new RegExp(`^${re}$`);
 }
 
+// src/deprecation.ts
+function createDeprecationDiagnostic(notice) {
+  return {
+    code: `deprecated-${notice.kind}`,
+    severity: "warning",
+    message: formatDeprecationMessage(notice),
+    target: notice.target,
+    suggestion: notice.replacement ? `Use ${notice.replacement}. ${notice.action}` : notice.action,
+    meta: { deprecation: notice }
+  };
+}
+function formatDeprecationMessage(notice) {
+  const lines = [
+    `Deprecated: ${notice.target}`,
+    `Deprecated since: ${notice.deprecatedSince}`
+  ];
+  if (notice.replacement) lines.push(`Use: ${notice.replacement}`);
+  lines.push(`Migration: ${notice.action}`);
+  if (notice.documentationUrl) lines.push(`See: ${notice.documentationUrl}`);
+  if (notice.removedIn) lines.push(`Removal planned: ${notice.removedIn}`);
+  return lines.join("\n");
+}
+
+// src/config_deprecations.ts
+var configDeprecations = [];
+function collectConfigDeprecationDiagnostics(config, notices = configDeprecations) {
+  return notices.filter((notice) => hasConfigPath(config, notice.path)).map(createDeprecationDiagnostic);
+}
+function hasConfigPath(config, path4) {
+  let value = config;
+  for (const segment of path4.split(".")) {
+    if (!isRecord2(value) || !(segment in value)) return false;
+    value = value[segment];
+  }
+  return value !== void 0;
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/content/image_extensions.ts
 var IMAGE_EXTENSIONS = [
   "png",
@@ -770,7 +810,7 @@ async function readContentBuildStateStatus(statePath) {
     }
     throw error;
   }
-  if (!isRecord2(parsed)) {
+  if (!isRecord3(parsed)) {
     return { kind: "invalid", path: statePath, reason: "invalid-shape" };
   }
   if (parsed.version !== CONTENT_BUILD_STATE_VERSION) {
@@ -810,19 +850,19 @@ function resolveContentBuildStatePath(config, contentDirectory) {
   );
 }
 function isContentBuildState(value) {
-  return isRecord2(value) && value.version === CONTENT_BUILD_STATE_VERSION && isContentBuildStateShape(value);
+  return isRecord3(value) && value.version === CONTENT_BUILD_STATE_VERSION && isContentBuildStateShape(value);
 }
 function isContentBuildStateShape(value) {
-  if (!isRecord2(value.entries) || !isRecord2(value.contentIndex)) return false;
+  if (!isRecord3(value.entries) || !isRecord3(value.contentIndex)) return false;
   return Object.values(value.entries).every(
-    (entry) => isRecord2(entry) && typeof entry.fingerprint === "string" && entry.fingerprint.length > 0 && Array.isArray(entry.dependencies) && entry.dependencies.every(
+    (entry) => isRecord3(entry) && typeof entry.fingerprint === "string" && entry.fingerprint.length > 0 && Array.isArray(entry.dependencies) && entry.dependencies.every(
       (dependency) => typeof dependency === "string"
     )
   ) && Object.values(value.contentIndex).every(
     (entry) => typeof entry === "string"
   );
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isNotFoundError(error) {
@@ -2831,7 +2871,8 @@ var ManifestBuilder = class {
       assets: [],
       clientEntries: [],
       diagnostics: [],
-      generatedOutputs: []
+      generatedOutputs: [],
+      pagePaths: []
     };
     return { ...manifest, graph: createContentGraph(manifest) };
   }
@@ -3032,6 +3073,9 @@ var ContentManager = class {
         this.locationResolver.populateRedirects(manifest, locations);
         await this.pluginRuntime.runManifestCreated(manifest, contentIndex);
         this.applyPublicView(manifest);
+        manifest.pagePaths = [
+          ...await this.pluginRuntime.getPagePaths(manifest, contentIndex)
+        ];
         manifest.assets = this.pluginRuntime.collectAssets();
         manifest.clientEntries = this.pluginRuntime.collectClientEntries();
         manifest.diagnostics = [
@@ -3333,8 +3377,10 @@ export {
   buildContentCollections,
   buildGraphEdges,
   calculateReadingTime,
+  collectConfigDeprecationDiagnostics,
   createClientEntry,
   createContentGraph,
+  createDeprecationDiagnostic,
   createPluginMemo,
   createStyleAsset,
   createUnavailableGeneratedOutputSink,
@@ -3347,6 +3393,7 @@ export {
   escapeScriptJson,
   extractFrontmatterAliases,
   fingerprintContentEntries,
+  formatDeprecationMessage,
   getContentSourceEntry,
   getExtension,
   getResolvedPluginMetadata,

package/dist/src/config_deprecations.d.ts

@@ -0,0 +1,8 @@
+import { type DeprecationNotice } from "./deprecation.js";
+import type { Diagnostic } from "./types/diagnostic.js";
+import type { RiebeckiteConfig } from "./types/riebeckite_config.js";
+export type ConfigDeprecationNotice = DeprecationNotice & {
+    readonly kind: "config";
+    readonly path: string;
+};
+export declare function collectConfigDeprecationDiagnostics(config: RiebeckiteConfig, notices?: readonly ConfigDeprecationNotice[]): Diagnostic[];

package/dist/src/deprecation.d.ts

@@ -0,0 +1,14 @@
+import type { Diagnostic } from "./types/diagnostic.js";
+export type DeprecationKind = "config" | "plugin-api" | "theme-api" | "cli" | "scaffold" | "package";
+export type DeprecationNotice = {
+    readonly kind: DeprecationKind;
+    readonly id: string;
+    readonly target: string;
+    readonly deprecatedSince: string;
+    readonly action: string;
+    readonly replacement?: string;
+    readonly documentationUrl?: string;
+    readonly removedIn?: string;
+};
+export declare function createDeprecationDiagnostic(notice: DeprecationNotice): Diagnostic;
+export declare function formatDeprecationMessage(notice: DeprecationNotice): string;

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

@@ -112,4 +112,5 @@ export type ContentManifest = {
     clientEntries: ContentManifestPluginClientEntry[];
     diagnostics: Diagnostic[];
     generatedOutputs: GeneratedOutput[];
+    pagePaths: string[];
 };

package/package.json

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