@riebeckite/core 0.0.15 → 0.0.16

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export { getContentSourceEntry, readContentSourceEntry, } from "./src/content/co
 export { resolveContentStableId } from "./src/content/content_stable_id.js";
 export { FileSystemContentSource, INTERNAL_CONTENT_IGNORE_PATTERNS, isIgnoredContentPath, } from "./src/content/file_system_content_source.js";
 export type { FolderEntryCandidate, FolderEntryKind, FolderEntryResolution, FolderEntryScope, FolderLocationResolution, ResolveFolderEntryOptions, } from "./src/content/folder_entry.js";
-export { resolveFolderEntry, resolveFolderLocation, resolveGeneratedFolderLocation, } from "./src/content/folder_entry.js";
+export { resolveFolderEntry, resolveFolderLocation, resolveGeneratedFolderLocation, resolvePublicFolderLocation, } from "./src/content/folder_entry.js";
 export type { ForceGraphLayoutOptions, GraphEdge, GraphLayoutNode, LinkableGraphNode, RadialGraphLayoutOptions, } from "./src/content/graph_layout.js";
 export { buildGraphEdges, layoutForceGraph, layoutRadialGraph, } from "./src/content/graph_layout.js";
 export { IMAGE_EXTENSIONS } from "./src/content/image_extensions.js";
@@ -46,6 +46,7 @@ export type { Diagnostic, DiagnosticCode, DiagnosticSeverity, } from "./src/type
 export type { ContentAssetOutputInput, GeneratedOutput, GeneratedOutputContent, GeneratedOutputInput, GeneratedOutputSink, } from "./src/types/generated_output.js";
 export { createUnavailableGeneratedOutputSink, normalizeContentAssetOutputPath, normalizeGeneratedOutputPath, } from "./src/types/generated_output.js";
 export type { JsonValue } from "./src/types/json_value.js";
+export type { NavigationConfig, NavigationItem, } from "./src/types/navigation_config.js";
 export type { OutputDependency } from "./src/types/output_dependency.js";
 export type { PluginInput, ResolvedPluginMetadata, RiebeckitePlugin, } from "./src/types/plugin.js";
 export { definePlugin, getResolvedPluginMetadata, resolvePlugins, } from "./src/types/plugin.js";

package/dist/index.js

@@ -18,11 +18,55 @@ function validateConfigIssues(config) {
     return [{ path: "config", message: "Expected an object." }];
   }
   validateSite(value.site, issues);
+  validateNavigation(value.navigation, issues);
   validateContent(value.content, issues);
   validateTheme(value.theme, issues);
   validatePlugins(value.plugins, issues);
   return issues;
 }
+function validateNavigation(value, issues) {
+  if (value === void 0) return;
+  if (!isRecord(value)) {
+    issues.push({ path: "navigation", message: "Expected an object." });
+    return;
+  }
+  validateNavigationItems(value.header, "navigation.header", issues, /* @__PURE__ */ new Set());
+  validateNavigationItems(value.footer, "navigation.footer", issues, /* @__PURE__ */ new Set());
+}
+function validateNavigationItems(value, path5, issues, ancestors) {
+  if (value === void 0) return;
+  if (!Array.isArray(value)) {
+    issues.push({ path: path5, message: "Expected an array." });
+    return;
+  }
+  for (const [index, item] of value.entries()) {
+    const itemPath = `${path5}[${index}]`;
+    if (!isRecord(item)) {
+      issues.push({ path: itemPath, message: "Expected an object." });
+      continue;
+    }
+    if (ancestors.has(item)) {
+      issues.push({
+        path: itemPath,
+        message: "Navigation children must not be recursive."
+      });
+      continue;
+    }
+    validateRequiredString(item.label, `${itemPath}.label`, issues);
+    validateRequiredString(item.href, `${itemPath}.href`, issues);
+    validateOptionalBoolean(item.external, `${itemPath}.external`, issues);
+    if (item.children !== void 0) {
+      const nextAncestors = new Set(ancestors);
+      nextAncestors.add(item);
+      validateNavigationItems(
+        item.children,
+        `${itemPath}.children`,
+        issues,
+        nextAncestors
+      );
+    }
+  }
+}
 function validateSite(value, issues) {
   if (!isRecord(value)) {
     issues.push({ path: "site", message: "Expected an object." });
@@ -625,6 +669,10 @@ function resolveConfig(config) {
         language: config.site?.feed?.language ?? config.site?.locale ?? "en"
       }
     },
+    navigation: {
+      header: config.navigation?.header ?? [],
+      footer: config.navigation?.footer ?? []
+    },
     content: {
       directory: config.content?.directory ?? "../../content",
       source: config.content?.source,
@@ -3766,6 +3814,7 @@ var ManifestBuilder = class {
       permalink: location.permalink,
       publicLocation: location,
       title: getManifestTitle(slug, processed.frontmatter.title),
+      aliases: extractFrontmatterAliases(markdown),
       frontmatter: processed.frontmatter,
       publishing,
       html: processed.html,
@@ -3781,6 +3830,7 @@ var ManifestBuilder = class {
   build(entries, contentIndex) {
     const bySlug = new Map(entries.map((entry) => [entry.slug, entry]));
     const byContentId = createContentIdIndex(entries);
+    const byAlias = createAliasIndex(entries);
     const byPermalink = new Map(
       entries.map((entry) => [entry.permalink, entry])
     );
@@ -3808,6 +3858,7 @@ var ManifestBuilder = class {
       discoverableEntries: [...entries],
       bySlug,
       byContentId,
+      byAlias,
       byPermalink,
       byRoutablePermalink: new Map(byPermalink),
       redirects: /* @__PURE__ */ new Map(),
@@ -3828,6 +3879,14 @@ var ManifestBuilder = class {
     return { ...manifest, graph: createContentGraph(manifest) };
   }
 };
+function createAliasIndex(entries) {
+  const byAlias = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    for (const alias of entry.aliases ?? [])
+      appendToMap(byAlias, alias.toLowerCase(), entry);
+  }
+  return byAlias;
+}
 function createContentIdIndex(entries) {
   const byContentId = /* @__PURE__ */ new Map();
   for (const entry of entries) {
@@ -4603,6 +4662,7 @@ function cloneManifestEntry(entry) {
     ...entry,
     publicLocation: { ...entry.publicLocation },
     frontmatter: { ...entry.frontmatter },
+    aliases: [...entry.aliases ?? []],
     tags: [...entry.tags],
     links: entry.links.map((link) => ({ ...link })),
     backlinks: [...entry.backlinks],
@@ -4669,6 +4729,17 @@ function resolveFolderLocation(manifest, folder) {
   const location = manifest.folderLocations.get(normalizeFolder2(folder));
   return location ? { type: "generated", pathname: location.pathname } : { type: "none" };
 }
+function resolvePublicFolderLocation(manifest, pathname) {
+  const normalizedPathname = normalizePathname(pathname);
+  const entry = manifest.publicEntries.find(
+    (candidate) => normalizePathname(candidate.publicLocation.permalink) === normalizedPathname
+  );
+  if (entry) return { type: "content", entry };
+  const location = [...manifest.folderLocations.values()].find(
+    (candidate) => normalizePathname(candidate.pathname) === normalizedPathname
+  );
+  return location ? { type: "generated", pathname: location.pathname } : { type: "none" };
+}
 function resolveGeneratedFolderLocation(manifest, folder) {
   const normalizedFolder = normalizeFolder2(folder);
   if (!normalizedFolder) return null;
@@ -4701,6 +4772,10 @@ function isInScope(entry, scope) {
 function normalizeFolder2(folder) {
   return folder.split("/").filter(Boolean).join("/");
 }
+function normalizePathname(pathname) {
+  const segments = pathname.split("/").filter(Boolean);
+  return segments.length === 0 ? "/" : `/${segments.join("/")}`;
+}
 function parentPath(pathname, levels) {
   const segments = pathname.split("/").filter(Boolean);
   if (segments.length < levels) return null;
@@ -4909,6 +4984,7 @@ function createGraphEntry(entry, markdown, contentIndex, locations) {
     permalink: location.permalink,
     publicLocation: location,
     title: slug,
+    aliases: [],
     frontmatter: {},
     publishing: resolvePublishingState(
       {},
@@ -5052,6 +5128,7 @@ export {
   resolveFolderLocation,
   resolveGeneratedFolderLocation,
   resolvePlugins,
+  resolvePublicFolderLocation,
   resolvePublishingBuildTime,
   resolvePublishingState,
   serializePublicClientConfig,

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

@@ -32,4 +32,5 @@ 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;

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

@@ -37,6 +37,7 @@ export type ContentManifestEntry = {
     permalink: string;
     publicLocation: ContentPublicLocation;
     title: string;
+    aliases?: readonly string[];
     frontmatter: PostFrontmatter;
     publishing: ResolvedPublishingState;
     html: string;
@@ -99,6 +100,7 @@ export type ContentManifest = {
     bySlug: Map<string, ContentManifestEntry>;
     /** Contains only entries with an explicit source-authored content ID. */
     byContentId: Map<string, ContentManifestEntry>;
+    byAlias: Map<string, ContentManifestEntry[]>;
     byPermalink: Map<string, ContentManifestEntry>;
     /** Contains only routable entries: public and unlisted, excluding draft and scheduled-before entries. */
     byRoutablePermalink: Map<string, ContentManifestEntry>;

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

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

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

@@ -1,4 +1,5 @@
 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,6 +11,7 @@ export type ResolvedRiebeckiteConfig = {
      */
     buildDirectory?: string;
     site: Required<SiteConfig>;
+    navigation: Required<NavigationConfig>;
     content: {
         directory: string;
         source?: ContentSource;

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

@@ -1,10 +1,12 @@
 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;

package/package.json

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