radiant-docs 0.1.56 → 0.1.57

package/template/src/pages/[...slug].astro

@@ -99,6 +99,8 @@ export async function getStaticPaths(): Promise<GetStaticPathsResult> {
     const homeRoute: Route = {
       type: "mdx",
       slug: "/",
+      preferredSlug: "/",
+      routeIdentity: `mdx:${config.home}`,
       filePath: config.home,
       title:
         existingHomeRoute?.title ??
@@ -122,6 +124,20 @@ export async function getStaticPaths(): Promise<GetStaticPathsResult> {
         homePath: config.home,
       },
     });
+  } else {
+    const firstVisibleRoute = visibleRoutes[0];
+    if (firstVisibleRoute) {
+      paths.push({
+        params: { slug: "/" },
+        props: {
+          route: {
+            ...firstVisibleRoute,
+            slug: "/",
+            preferredSlug: "/",
+          },
+        },
+      });
+    }
   }
 
   return paths;

package/template/src/lib/code/shiki-theme-config.ts

@@ -1,16 +0,0 @@
-import { bundledThemes } from "shiki";
-
-export const DEFAULT_SHIKI_LIGHT_THEME = "github-light";
-export const DEFAULT_SHIKI_DARK_THEME = "github-dark";
-
-export type CodeSyntaxThemeByMode = {
-  light: string;
-  dark: string;
-};
-
-export const SHIKI_BUNDLED_THEME_NAMES = Object.keys(bundledThemes).sort();
-const SHIKI_BUNDLED_THEME_NAME_SET = new Set(SHIKI_BUNDLED_THEME_NAMES);
-
-export function isBundledShikiThemeName(value: string): boolean {
-  return SHIKI_BUNDLED_THEME_NAME_SET.has(value);
-}

package/template/src/lib/component-error.ts

@@ -1,202 +0,0 @@
-/**
- * Component validation utilities for user-facing MDX components.
- * All errors are tagged with [USER_ERROR] for proper error handling in runner.ts
- */
-
-/**
- * Derives the source MDX file path from an Astro URL pathname
- */
-function getSourceFile(pathname: string): string {
-  const pagePath = pathname
-    .replace(/^\/documentation\//, "") // Remove base path
-    .replace(/\/$/, ""); // Remove trailing slash
-  return `${pagePath}.mdx`;
-}
-
-/**
- * Formats a user-friendly error message with file location
- */
-function formatError(
-  componentName: string,
-  message: string,
-  sourceFile: string
-): string {
-  return `[USER_ERROR]: <${componentName}>: ${message} (in ${sourceFile})`;
-}
-
-/**
- * Validates that a prop value is one of the allowed values
- *
- * @example
- * validateEnum("Callout", "type", type, ["warning", "info", "tip"], Astro.url.pathname);
- */
-export function validateEnum<T extends string>(
-  componentName: string,
-  propName: string,
-  value: T,
-  validValues: readonly T[],
-  pathname: string
-): void {
-  if (!validValues.includes(value)) {
-    const sourceFile = getSourceFile(pathname);
-    throw new Error(
-      formatError(
-        componentName,
-        `Invalid prop ${propName}="${value}". Expected one of: ${validValues.join(
-          ", "
-        )}`,
-        sourceFile
-      )
-    );
-  }
-}
-
-/**
- * Validates that a required prop is provided and not empty
- *
- * @example
- * validateRequired("Step", "title", title, Astro.url.pathname);
- */
-export function validateRequired(
-  componentName: string,
-  propName: string,
-  value: unknown,
-  pathname: string
-): void {
-  if (value === undefined || value === null || value === "") {
-    const sourceFile = getSourceFile(pathname);
-    throw new Error(
-      formatError(
-        componentName,
-        `Missing required prop "${propName}"`,
-        sourceFile
-      )
-    );
-  }
-}
-
-/**
- * Validates that a prop is of the expected type
- *
- * @example
- * validateType("Accordion", "defaultOpen", defaultOpen, "boolean", Astro.url.pathname);
- */
-export function validateType(
-  componentName: string,
-  propName: string,
-  value: unknown,
-  expectedType:
-    | "string"
-    | "number"
-    | "boolean"
-    | "object"
-    | "array"
-    | readonly ("string" | "number" | "boolean" | "object" | "array")[],
-  pathname: string
-): void {
-  // Skip if undefined (optional props)
-  if (value === undefined) return;
-
-  const expectedTypes = Array.isArray(expectedType)
-    ? expectedType
-    : [expectedType];
-  const isValid = expectedTypes.some((type) =>
-    type === "array" ? Array.isArray(value) : typeof value === type
-  );
-
-  if (!isValid) {
-    const sourceFile = getSourceFile(pathname);
-    const actualType = Array.isArray(value) ? "array" : typeof value;
-    const expectedTypeLabel = expectedTypes.join(" or ");
-    throw new Error(
-      formatError(
-        componentName,
-        `Invalid prop "${propName}": expected ${expectedTypeLabel}, got ${actualType}`,
-        sourceFile
-      )
-    );
-  }
-}
-
-/**
- * Validates multiple props at once using a schema object
- *
- * @example
- * validateProps("Callout", Astro.props, {
- *   type: { enum: ["warning", "info", "tip", "danger", "success"] },
- *   title: { type: "string" },
- * }, Astro.url.pathname);
- */
-export type PropSchema = {
-  required?: boolean;
-  type?:
-    | "string"
-    | "number"
-    | "boolean"
-    | "object"
-    | "array"
-    | readonly ("string" | "number" | "boolean" | "object" | "array")[];
-  enum?: readonly string[];
-};
-
-/**
- * Validates that no unsupported props are passed to a component.
- */
-export function validateNoUnknownProps(
-  componentName: string,
-  props: Record<string, unknown>,
-  allowedProps: readonly string[],
-  pathname: string
-): void {
-  const allowed = new Set(allowedProps);
-  const unknownProps = Object.keys(props).filter((key) => !allowed.has(key));
-
-  if (unknownProps.length === 0) return;
-
-  const sourceFile = getSourceFile(pathname);
-  const unknownLabel = unknownProps.map((name) => `"${name}"`).join(", ");
-  const allowedLabel = allowedProps.map((name) => `"${name}"`).join(", ");
-  const propLabel = unknownProps.length === 1 ? "prop" : "props";
-  throw new Error(
-    formatError(
-      componentName,
-      `Unsupported ${propLabel}: ${unknownLabel}. Allowed props: ${allowedLabel}`,
-      sourceFile
-    )
-  );
-}
-
-export function validateProps(
-  componentName: string,
-  props: Record<string, unknown>,
-  schema: Record<string, PropSchema>,
-  pathname: string
-): void {
-  for (const [propName, rules] of Object.entries(schema)) {
-    const value = props[propName];
-
-    // Check required
-    if (rules.required) {
-      validateRequired(componentName, propName, value, pathname);
-    }
-
-    // Skip further checks if value is undefined (optional)
-    if (value === undefined) continue;
-
-    // Check type
-    if (rules.type) {
-      validateType(componentName, propName, value, rules.type, pathname);
-    }
-
-    // Check enum
-    if (rules.enum) {
-      validateEnum(
-        componentName,
-        propName,
-        value as string,
-        rules.enum,
-        pathname
-      );
-    }
-  }
-}

package/template/src/lib/frontmatter-schema.ts

@@ -1,10 +0,0 @@
-import { z } from "zod";
-
-// Frontmatter schema for MDX files.
-// `title` controls the rendered page title (not navigation labels).
-export const docsSchema = z
-  .object({
-    title: z.string().optional(),
-    description: z.string().optional(),
-  })
-  .passthrough();