@specglass/core 0.0.2

package/dist/config/schema.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+/** Schema for a single OpenAPI spec source */
+const openApiSpecSchema = z.object({
+    /** Path to the OpenAPI spec file (relative to project root) */
+    path: z.string(),
+    /** Optional display name for this spec */
+    name: z.string().optional(),
+});
+/** Schema for sidebar configuration */
+const sidebarSchema = z.object({
+    /** Whether to show the sidebar on all pages */
+    enabled: z.boolean().optional(),
+    /** Whether sections are collapsed by default */
+    defaultCollapsed: z.boolean().optional(),
+});
+/** Schema for a header navigation link */
+const headerLinkSchema = z.object({
+    /** Display label for the link */
+    label: z.string(),
+    /** URL the link navigates to */
+    href: z.string(),
+});
+/**
+ * A color value that supports both light and dark modes.
+ *
+ * - String: applies as dark-mode override only (backward compat)
+ * - Object: explicit { light, dark } pair for full control
+ */
+const colorPairSchema = z.union([
+    z.string(),
+    z.object({
+        light: z.string().optional(),
+        dark: z.string().optional(),
+    }),
+]);
+/** Schema for semantic color tokens that map to CSS custom properties */
+const colorsSchema = z.object({
+    /** Primary brand color — applies to both modes */
+    primary: z.string().optional(),
+    /** Secondary/accent brand color — applies to both modes */
+    accent: z.string().optional(),
+    /** Page background color (light/dark pair or dark-only string) */
+    background: colorPairSchema.optional(),
+    /** Default text color (light/dark pair or dark-only string) */
+    foreground: colorPairSchema.optional(),
+    /** Muted/secondary text color (light/dark pair or dark-only string) */
+    muted: colorPairSchema.optional(),
+    /** Border color (light/dark pair or dark-only string) */
+    border: colorPairSchema.optional(),
+});
+/** Schema for theme configuration */
+const themeSchema = z.object({
+    /** Path to a custom logo image */
+    logo: z.string().optional(),
+    /** Primary brand color (CSS color value) — shorthand for colors.primary */
+    primaryColor: z.string().optional(),
+    /** Secondary/accent brand color (CSS color value) */
+    accentColor: z.string().optional(),
+    /** Font family for body text */
+    fontFamily: z.string().optional(),
+    /** Font family for code blocks */
+    codeFontFamily: z.string().optional(),
+    /** Footer text or copyright notice */
+    footer: z.string().optional(),
+    /** Path to favicon image (relative to public directory) */
+    favicon: z.string().optional(),
+    /** Path to social/OG image for link previews (relative to public directory) */
+    socialImage: z.string().optional(),
+    /** Header navigation links */
+    headerLinks: z.array(headerLinkSchema).optional(),
+    /** Semantic color tokens for CSS custom property theming */
+    colors: colorsSchema.optional(),
+});
+/** Schema for OpenAPI configuration */
+const openApiSchema = z.object({
+    /** Array of OpenAPI spec sources */
+    specs: z.array(openApiSpecSchema).optional(),
+});
+/** Schema for build configuration */
+const buildSchema = z.object({
+    /** Output directory for the build (relative to project root) */
+    outDir: z.string().optional(),
+});
+/**
+ * Complete specglass configuration schema.
+ * All top-level fields are optional with sensible defaults.
+ */
+export const configSchema = z.object({
+    /** Site metadata */
+    site: z
+        .object({
+        /** Site title displayed in header and browser tab */
+        title: z.string().optional(),
+        /** Site description for SEO meta tags */
+        description: z.string().optional(),
+        /** Base URL of the deployed docs site */
+        url: z.string().url().optional(),
+    })
+        .optional(),
+    /** Sidebar navigation configuration */
+    sidebar: sidebarSchema.optional(),
+    /** OpenAPI spec configuration for auto-generated API reference pages */
+    openapi: openApiSchema.optional(),
+    /** Default theme appearance configuration */
+    theme: themeSchema.optional(),
+    /** Build output configuration */
+    build: buildSchema.optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/content/frontmatter-schema.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+/**
+ * Zod schema for MDX content frontmatter.
+ *
+ * Required: title
+ * Optional: description, sidebar_label, sidebar_position, draft, custom
+ *
+ * Uses `.passthrough()` to allow Astro's internal fields (e.g., `_id`, `_collection`)
+ * through without validation errors.
+ */
+export declare const frontmatterSchema: z.ZodObject<{
+    /** Page title — required for all content pages */
+    title: z.ZodString;
+    /** Page description for SEO meta tags */
+    description: z.ZodOptional<z.ZodString>;
+    /** Custom sidebar label (overrides title in navigation) */
+    sidebar_label: z.ZodOptional<z.ZodString>;
+    /** Numeric position for sidebar ordering */
+    sidebar_position: z.ZodOptional<z.ZodNumber>;
+    /** When true, page is excluded from production builds */
+    draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** User-defined custom fields, namespaced to avoid collisions */
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** Page title — required for all content pages */
+    title: z.ZodString;
+    /** Page description for SEO meta tags */
+    description: z.ZodOptional<z.ZodString>;
+    /** Custom sidebar label (overrides title in navigation) */
+    sidebar_label: z.ZodOptional<z.ZodString>;
+    /** Numeric position for sidebar ordering */
+    sidebar_position: z.ZodOptional<z.ZodNumber>;
+    /** When true, page is excluded from production builds */
+    draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** User-defined custom fields, namespaced to avoid collisions */
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** Page title — required for all content pages */
+    title: z.ZodString;
+    /** Page description for SEO meta tags */
+    description: z.ZodOptional<z.ZodString>;
+    /** Custom sidebar label (overrides title in navigation) */
+    sidebar_label: z.ZodOptional<z.ZodString>;
+    /** Numeric position for sidebar ordering */
+    sidebar_position: z.ZodOptional<z.ZodNumber>;
+    /** When true, page is excluded from production builds */
+    draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** User-defined custom fields, namespaced to avoid collisions */
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Inferred TypeScript type for validated frontmatter */
+export type Frontmatter = z.infer<typeof frontmatterSchema>;
+//# sourceMappingURL=frontmatter-schema.d.ts.map

package/dist/content/frontmatter-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.d.ts","sourceRoot":"","sources":["../../src/content/frontmatter-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;IAE1B,kDAAkD;;IAGlD,yCAAyC;;IAGzC,2DAA2D;;IAG3D,4CAA4C;;IAG5C,yDAAyD;;IAGzD,iEAAiE;;;IAfjE,kDAAkD;;IAGlD,yCAAyC;;IAGzC,2DAA2D;;IAG3D,4CAA4C;;IAG5C,yDAAyD;;IAGzD,iEAAiE;;;IAfjE,kDAAkD;;IAGlD,yCAAyC;;IAGzC,2DAA2D;;IAG3D,4CAA4C;;IAG5C,yDAAyD;;IAGzD,iEAAiE;;gCAGrD,CAAC;AAEjB,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/content/frontmatter-schema.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/**
+ * Zod schema for MDX content frontmatter.
+ *
+ * Required: title
+ * Optional: description, sidebar_label, sidebar_position, draft, custom
+ *
+ * Uses `.passthrough()` to allow Astro's internal fields (e.g., `_id`, `_collection`)
+ * through without validation errors.
+ */
+export const frontmatterSchema = z
+    .object({
+    /** Page title — required for all content pages */
+    title: z.string().describe("Page title (required)"),
+    /** Page description for SEO meta tags */
+    description: z.string().optional(),
+    /** Custom sidebar label (overrides title in navigation) */
+    sidebar_label: z.string().optional(),
+    /** Numeric position for sidebar ordering */
+    sidebar_position: z.number().optional(),
+    /** When true, page is excluded from production builds */
+    draft: z.boolean().optional().default(false),
+    /** User-defined custom fields, namespaced to avoid collisions */
+    custom: z.record(z.unknown()).optional(),
+})
+    .passthrough();
+//# sourceMappingURL=frontmatter-schema.js.map

package/dist/content/frontmatter-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.js","sourceRoot":"","sources":["../../src/content/frontmatter-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,kDAAkD;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAEnD,yCAAyC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,2DAA2D;IAC3D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEpC,4CAA4C;IAC5C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEvC,yDAAyD;IACzD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE5C,iEAAiE;IACjE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/content/mdx-loader.d.ts

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { SpecglassError } from "../errors/specglass-error.js";
+/**
+ * Options for configuring the docs content collection.
+ */
+export interface DocsCollectionOptions {
+    /** Base directory for MDX content files, relative to Astro project root.
+     * @default "./src/content/docs"
+     */
+    contentDir?: string;
+}
+/**
+ * Defines the Astro Content Layer collection for MDX documentation pages.
+ *
+ * Uses Astro 5.x's `glob()` loader to read `.mdx` files from the content
+ * directory. Frontmatter is validated against the `frontmatterSchema` Zod schema.
+ *
+ * This function is meant to be used in the user's `src/content/config.ts`:
+ *
+ * @example
+ * ```ts
+ * // src/content/config.ts
+ * import { defineCollection } from "astro:content";
+ * import { defineDocsCollection } from "@specglass/core";
+ *
+ * export const collections = {
+ *   docs: defineCollection(defineDocsCollection()),
+ * };
+ * ```
+ *
+ * @param options - Optional configuration for the content directory
+ * @returns Collection configuration object for the docs collection
+ */
+export declare function defineDocsCollection(options?: DocsCollectionOptions): {
+    loader: import("astro/loaders").Loader;
+    schema: z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        sidebar_label: z.ZodOptional<z.ZodString>;
+        sidebar_position: z.ZodOptional<z.ZodNumber>;
+        draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        sidebar_label: z.ZodOptional<z.ZodString>;
+        sidebar_position: z.ZodOptional<z.ZodNumber>;
+        draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        sidebar_label: z.ZodOptional<z.ZodString>;
+        sidebar_position: z.ZodOptional<z.ZodNumber>;
+        draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">>;
+};
+/**
+ * Converts a content file path to a URL slug.
+ *
+ * Strips the `content/` prefix and `.mdx`/`.md` extension from the file path.
+ * Handles `index.mdx` by mapping it to the parent directory path.
+ *
+ * @param filePath - Content file path (e.g., `content/docs/getting-started.mdx`)
+ * @returns URL slug (e.g., `docs/getting-started`)
+ *
+ * @example
+ * ```ts
+ * getSlugFromFilePath("content/docs/getting-started.mdx")
+ * // => "docs/getting-started"
+ *
+ * getSlugFromFilePath("content/docs/guides/setup.mdx")
+ * // => "docs/guides/setup"
+ *
+ * getSlugFromFilePath("content/docs/index.mdx")
+ * // => "docs"
+ * ```
+ */
+export declare function getSlugFromFilePath(filePath: string): string;
+/**
+ * Wraps a Zod validation error into an `SpecglassError` with actionable context.
+ *
+ * Astro's Content Layer API handles Zod validation automatically, but this
+ * function provides an additional error wrapping layer for when we need to
+ * validate frontmatter outside of Astro's pipeline (e.g., in `specglass check`).
+ *
+ * @param zodError - The Zod validation error
+ * @param filePath - Path to the MDX file that failed validation
+ * @returns SpecglassError with FRONTMATTER_INVALID code and actionable hint
+ */
+export declare function wrapFrontmatterError(zodError: z.ZodError, filePath: string): SpecglassError;
+//# sourceMappingURL=mdx-loader.d.ts.map

package/dist/content/mdx-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-loader.d.ts","sourceRoot":"","sources":["../../src/content/mdx-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAOnE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EACpB,QAAQ,EAAE,MAAM,GACf,cAAc,CAuBhB"}

package/dist/content/mdx-loader.js

@@ -0,0 +1,97 @@
+import { glob } from "astro/loaders";
+import { frontmatterSchema } from "./frontmatter-schema.js";
+import { SpecglassError } from "../errors/specglass-error.js";
+/**
+ * Defines the Astro Content Layer collection for MDX documentation pages.
+ *
+ * Uses Astro 5.x's `glob()` loader to read `.mdx` files from the content
+ * directory. Frontmatter is validated against the `frontmatterSchema` Zod schema.
+ *
+ * This function is meant to be used in the user's `src/content/config.ts`:
+ *
+ * @example
+ * ```ts
+ * // src/content/config.ts
+ * import { defineCollection } from "astro:content";
+ * import { defineDocsCollection } from "@specglass/core";
+ *
+ * export const collections = {
+ *   docs: defineCollection(defineDocsCollection()),
+ * };
+ * ```
+ *
+ * @param options - Optional configuration for the content directory
+ * @returns Collection configuration object for the docs collection
+ */
+export function defineDocsCollection(options) {
+    const contentDir = options?.contentDir ?? "./src/content";
+    return {
+        loader: glob({ pattern: "docs/**/*.{mdx,md}", base: contentDir }),
+        schema: frontmatterSchema,
+    };
+}
+/**
+ * Converts a content file path to a URL slug.
+ *
+ * Strips the `content/` prefix and `.mdx`/`.md` extension from the file path.
+ * Handles `index.mdx` by mapping it to the parent directory path.
+ *
+ * @param filePath - Content file path (e.g., `content/docs/getting-started.mdx`)
+ * @returns URL slug (e.g., `docs/getting-started`)
+ *
+ * @example
+ * ```ts
+ * getSlugFromFilePath("content/docs/getting-started.mdx")
+ * // => "docs/getting-started"
+ *
+ * getSlugFromFilePath("content/docs/guides/setup.mdx")
+ * // => "docs/guides/setup"
+ *
+ * getSlugFromFilePath("content/docs/index.mdx")
+ * // => "docs"
+ * ```
+ */
+export function getSlugFromFilePath(filePath) {
+    // Normalize path separators
+    let slug = filePath.replace(/\\/g, "/");
+    // Strip leading content/ prefix
+    slug = slug.replace(/^content\//, "");
+    // Strip file extension (.mdx or .md)
+    slug = slug.replace(/\.(mdx|md)$/, "");
+    // Handle index files — map to parent directory
+    slug = slug.replace(/\/index$/, "");
+    // Handle root index (just "index" after stripping content/)
+    if (slug === "index") {
+        return "";
+    }
+    return slug;
+}
+/**
+ * Wraps a Zod validation error into an `SpecglassError` with actionable context.
+ *
+ * Astro's Content Layer API handles Zod validation automatically, but this
+ * function provides an additional error wrapping layer for when we need to
+ * validate frontmatter outside of Astro's pipeline (e.g., in `specglass check`).
+ *
+ * @param zodError - The Zod validation error
+ * @param filePath - Path to the MDX file that failed validation
+ * @returns SpecglassError with FRONTMATTER_INVALID code and actionable hint
+ */
+export function wrapFrontmatterError(zodError, filePath) {
+    const hints = zodError.issues.map((issue) => {
+        const fieldPath = issue.path.join(".") || "unknown";
+        if (issue.code === "invalid_type" && fieldPath === "title") {
+            return `Field 'title' is required — add \`title: "Page Title"\` to your frontmatter`;
+        }
+        else if (issue.code === "invalid_type") {
+            return `Field '${fieldPath}' expected ${issue.expected}, got ${issue.received}`;
+        }
+        return `Field '${fieldPath}': ${issue.message}`;
+    });
+    const issueCount = zodError.issues.length;
+    const summary = zodError.issues
+        .map((i) => `${i.path.join(".") || "unknown"}: ${i.message}`)
+        .join("; ");
+    return new SpecglassError(`Invalid frontmatter in ${filePath}: ${issueCount} error${issueCount > 1 ? "s" : ""} (${summary})`, "FRONTMATTER_INVALID", filePath, undefined, hints.join("\n"));
+}
+//# sourceMappingURL=mdx-loader.js.map

package/dist/content/mdx-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-loader.js","sourceRoot":"","sources":["../../src/content/mdx-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAY9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,eAAe,CAAC;IAE1D,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACjE,MAAM,EAAE,iBAAiB;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,4BAA4B;IAC5B,IAAI,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExC,gCAAgC;IAChC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAEtC,qCAAqC;IACrC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAEvC,+CAA+C;IAC/C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEpC,4DAA4D;IAC5D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAoB,EACpB,QAAgB;IAEhB,MAAM,KAAK,GAAa,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACpD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC3D,OAAO,6EAA6E,CAAC;QACvF,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACzC,OAAO,UAAU,SAAS,cAAe,KAA+B,CAAC,QAAQ,SAAU,KAA+B,CAAC,QAAQ,EAAE,CAAC;QACxI,CAAC;QACD,OAAO,UAAU,SAAS,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,IAAI,cAAc,CACvB,0BAA0B,QAAQ,KAAK,UAAU,SAAS,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,GAAG,EAClG,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CACjB,CAAC;AACJ,CAAC"}

package/dist/content/openapi-loader.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Astro Content Layer loader for OpenAPI specifications.
+ *
+ * Parses all configured OpenAPI specs and produces content entries
+ * (one per endpoint) for the Astro content collection. This loader
+ * always re-parses on every build invocation to ensure content is
+ * never stale (FR12 / AC5).
+ *
+ * @module
+ */
+import type { ApiEndpoint, ApiEndpointError, ParsedOpenApiSpec } from "../openapi/types.js";
+/** Config shape expected by the loader (subset of SpecglassConfig) */
+export interface OpenApiLoaderConfig {
+    specs?: Array<{
+        path: string;
+        name?: string;
+    }>;
+}
+/** A single content entry produced by the loader */
+export interface OpenApiContentEntry {
+    id: string;
+    data: ApiEndpoint;
+}
+/** Result of the OpenAPI content loading process */
+export interface OpenApiLoaderResult {
+    entries: OpenApiContentEntry[];
+    specs: ParsedOpenApiSpec[];
+    errors: ApiEndpointError[];
+}
+/**
+ * Load and transform all configured OpenAPI specs into content entries.
+ *
+ * Each endpoint becomes a content entry with ID format:
+ * `{specName}/{method}-{sanitizedPath}`
+ *
+ * @param config - OpenAPI loader configuration (from specglass config)
+ * @returns Content entries, parsed specs, and accumulated errors
+ */
+export declare function loadOpenApiContent(config: OpenApiLoaderConfig): Promise<OpenApiLoaderResult>;
+//# sourceMappingURL=openapi-loader.d.ts.map

package/dist/content/openapi-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-loader.d.ts","sourceRoot":"","sources":["../../src/content/openapi-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAmD9B"}

package/dist/content/openapi-loader.js

@@ -0,0 +1,58 @@
+/**
+ * Astro Content Layer loader for OpenAPI specifications.
+ *
+ * Parses all configured OpenAPI specs and produces content entries
+ * (one per endpoint) for the Astro content collection. This loader
+ * always re-parses on every build invocation to ensure content is
+ * never stale (FR12 / AC5).
+ *
+ * @module
+ */
+import { parseOpenApiSpec } from "../openapi/parser.js";
+/**
+ * Load and transform all configured OpenAPI specs into content entries.
+ *
+ * Each endpoint becomes a content entry with ID format:
+ * `{specName}/{method}-{sanitizedPath}`
+ *
+ * @param config - OpenAPI loader configuration (from specglass config)
+ * @returns Content entries, parsed specs, and accumulated errors
+ */
+export async function loadOpenApiContent(config) {
+    const specs = config.specs ?? [];
+    if (specs.length === 0) {
+        return { entries: [], specs: [], errors: [] };
+    }
+    const allEntries = [];
+    const allSpecs = [];
+    const allErrors = [];
+    for (const specConfig of specs) {
+        const specName = specConfig.name ?? "default";
+        let parsedSpec;
+        try {
+            parsedSpec = await parseOpenApiSpec(specConfig.path);
+        }
+        catch (error) {
+            // Log parse-level errors as warnings — don't fail the build
+            console.warn(`[specglass] Warning: Failed to parse OpenAPI spec "${specConfig.path}": ${error instanceof Error ? error.message : "Unknown error"}`);
+            continue;
+        }
+        allSpecs.push(parsedSpec);
+        allErrors.push(...parsedSpec.errors);
+        // Log per-endpoint errors as warnings
+        for (const endpointError of parsedSpec.errors) {
+            console.warn(`[specglass] Warning: Failed to transform ${endpointError.method.toUpperCase()} ${endpointError.path}: ${endpointError.reason}`);
+        }
+        // Produce content entries — one per endpoint
+        for (const endpoint of parsedSpec.endpoints) {
+            const sanitizedPath = endpoint.path
+                .replace(/^\//, "")
+                .replace(/\//g, "-")
+                .replace(/[{}]/g, "");
+            const id = `${specName}/${endpoint.method.toLowerCase()}-${sanitizedPath}`;
+            allEntries.push({ id, data: endpoint });
+        }
+    }
+    return { entries: allEntries, specs: allSpecs, errors: allErrors };
+}
+//# sourceMappingURL=openapi-loader.js.map

package/dist/content/openapi-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-loader.js","sourceRoot":"","sources":["../../src/content/openapi-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAyBxD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA2B;IAE3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAEjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,UAAU,GAA0B,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,MAAM,SAAS,GAAuB,EAAE,CAAC;IAEzC,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,IAAI,SAAS,CAAC;QAE9C,IAAI,UAA6B,CAAC;QAClC,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4DAA4D;YAC5D,OAAO,CAAC,IAAI,CACV,sDAAsD,UAAU,CAAC,IAAI,MACnE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAC3C,EAAE,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAErC,sCAAsC;QACtC,KAAK,MAAM,aAAa,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CACV,4CAA4C,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,aAAa,CAAC,IAAI,KAAK,aAAa,CAAC,MAAM,EAAE,CAChI,CAAC;QACJ,CAAC;QAED,6CAA6C;QAC7C,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI;iBAChC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;iBACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAExB,MAAM,EAAE,GAAG,GAAG,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,aAAa,EAAE,CAAC;YAE3E,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC"}

package/dist/content/rehype-code-blocks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Rehype plugin that enhances Shiki-rendered code blocks with metadata
+ * for the CopyButton client-side enhancer.
+ *
+ * Astro's Shiki integration renders fenced code blocks into <pre><code> HTML.
+ * This plugin:
+ * 1. Wraps each <pre> in a .code-block container div
+ * 2. Extracts raw code text into a data-code attribute for clipboard copy
+ * 3. Parses the meta string for title and highlight info
+ *
+ * The CopyButton and visual chrome are added client-side by code-block-enhancer.ts.
+ */
+import type { Root } from "hast";
+export declare function rehypeCodeBlocks(): (tree: Root) => void;
+//# sourceMappingURL=rehype-code-blocks.d.ts.map

package/dist/content/rehype-code-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-code-blocks.d.ts","sourceRoot":"","sources":["../../src/content/rehype-code-blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,MAAM,CAAC;AA4BhD,wBAAgB,gBAAgB,KACtB,MAAM,IAAI,UAgDnB"}

package/dist/content/rehype-code-blocks.js

@@ -0,0 +1,84 @@
+/**
+ * Rehype plugin that enhances Shiki-rendered code blocks with metadata
+ * for the CopyButton client-side enhancer.
+ *
+ * Astro's Shiki integration renders fenced code blocks into <pre><code> HTML.
+ * This plugin:
+ * 1. Wraps each <pre> in a .code-block container div
+ * 2. Extracts raw code text into a data-code attribute for clipboard copy
+ * 3. Parses the meta string for title and highlight info
+ *
+ * The CopyButton and visual chrome are added client-side by code-block-enhancer.ts.
+ */
+import { visit } from "unist-util-visit";
+/**
+ * Extract text content from a hast node tree recursively.
+ */
+function extractText(node) {
+    if (node.type === "text") {
+        return node.value;
+    }
+    if ("children" in node) {
+        return node.children.map(extractText).join("");
+    }
+    return "";
+}
+/**
+ * Check if a <pre> is already inside a .code-block wrapper
+ * (i.e., was rendered by the explicit <CodeBlock> Astro component).
+ */
+function isAlreadyWrapped(parent) {
+    if (!parent)
+        return false;
+    const classes = parent.properties?.className;
+    if (Array.isArray(classes) && classes.includes("code-block-body"))
+        return true;
+    if (typeof classes === "string" && classes.includes("code-block-body"))
+        return true;
+    return false;
+}
+export function rehypeCodeBlocks() {
+    return (tree) => {
+        // Process in reverse to avoid index shifts when splicing
+        const replacements = [];
+        visit(tree, "element", (node, index, parent) => {
+            if (node.tagName !== "pre")
+                return;
+            if (!parent || typeof index !== "number")
+                return;
+            // Skip if already inside a CodeBlock component wrapper
+            if (isAlreadyWrapped(parent))
+                return;
+            // Find the <code> child
+            const codeEl = node.children.find((child) => child.type === "element" && child.tagName === "code");
+            if (!codeEl)
+                return;
+            // Extract raw text for clipboard
+            const rawCode = extractText(codeEl).trimEnd();
+            // Build wrapper: <div class="code-block code-block--fenced">
+            const wrapper = {
+                type: "element",
+                tagName: "div",
+                properties: {
+                    className: ["code-block", "code-block--fenced"],
+                    "data-code": rawCode,
+                },
+                children: [
+                    {
+                        type: "element",
+                        tagName: "div",
+                        properties: { className: ["code-block-body"] },
+                        children: [node],
+                    },
+                ],
+            };
+            replacements.push({ parent: parent, index, wrapper });
+        });
+        // Apply replacements in reverse order to preserve indices
+        for (let i = replacements.length - 1; i >= 0; i--) {
+            const { parent, index, wrapper } = replacements[i];
+            parent.children.splice(index, 1, wrapper);
+        }
+    };
+}
+//# sourceMappingURL=rehype-code-blocks.js.map

package/dist/content/rehype-code-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-code-blocks.js","sourceRoot":"","sources":["../../src/content/rehype-code-blocks.ts"],"names":[],"mappings":"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"}

package/dist/errors/specglass-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Structured error class for all user-facing specglass errors.
+ * Provides actionable context: error code, file path, line number, and remediation hint.
+ */
+export declare class SpecglassError extends Error {
+    readonly code: string;
+    readonly filePath?: string | undefined;
+    readonly line?: number | undefined;
+    readonly hint?: string | undefined;
+    constructor(message: string, code: string, filePath?: string | undefined, line?: number | undefined, hint?: string | undefined);
+}
+//# sourceMappingURL=specglass-error.d.ts.map

package/dist/errors/specglass-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specglass-error.d.ts","sourceRoot":"","sources":["../../src/errors/specglass-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;aACZ,QAAQ,CAAC,EAAE,MAAM;aACjB,IAAI,CAAC,EAAE,MAAM;aACb,IAAI,CAAC,EAAE,MAAM;gBAJ7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC"}