@specglass/core 0.0.12 → 0.0.13

package/dist/config/defaults.js

@@ -21,8 +21,12 @@ export const DEFAULT_CONFIG = {
         footer: undefined,
         favicon: undefined,
         socialImage: undefined,
-        headerLinks: undefined,
+        headerLinks: [
+            { label: "Documentation", href: "/" },
+            { label: "API Reference", href: "/api-reference" },
+        ],
         colors: undefined,
+        socialLinks: undefined,
     },
     build: {
         outDir: "dist",

package/dist/config/schema.d.ts

@@ -180,6 +180,26 @@ export declare const configSchema: z.ZodObject<{
                 dark?: string | undefined;
             } | undefined;
         }>>;
+        /** Social/external links shown in the footer */
+        socialLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Display label for the link */
+            label: z.ZodString;
+            /** URL the link navigates to */
+            href: z.ZodString;
+            /** Optional icon identifier (e.g., 'github', 'twitter', 'discord') */
+            icon: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }, {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }>, "many">>;
+        /** Base URL for "Edit on GitHub" links. File path will be appended.
+         *  Example: "https://github.com/org/repo/edit/main/docs" */
+        editUrl: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         logo?: string | undefined;
         primaryColor?: string | undefined;
@@ -213,6 +233,12 @@ export declare const configSchema: z.ZodObject<{
                 dark?: string | undefined;
             } | undefined;
         } | undefined;
+        socialLinks?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        editUrl?: string | undefined;
     }, {
         logo?: string | undefined;
         primaryColor?: string | undefined;
@@ -246,6 +272,12 @@ export declare const configSchema: z.ZodObject<{
                 dark?: string | undefined;
             } | undefined;
         } | undefined;
+        socialLinks?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        editUrl?: string | undefined;
     }>>;
     /** Build output configuration */
     build: z.ZodOptional<z.ZodObject<{
@@ -305,6 +337,12 @@ export declare const configSchema: z.ZodObject<{
                 dark?: string | undefined;
             } | undefined;
         } | undefined;
+        socialLinks?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        editUrl?: string | undefined;
     } | undefined;
     build?: {
         outDir?: string | undefined;
@@ -358,6 +396,12 @@ export declare const configSchema: z.ZodObject<{
                 dark?: string | undefined;
             } | undefined;
         } | undefined;
+        socialLinks?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        editUrl?: string | undefined;
     } | undefined;
     build?: {
         outDir?: string | undefined;

package/dist/config/schema.js

@@ -20,6 +20,15 @@ const headerLinkSchema = z.object({
     /** URL the link navigates to */
     href: z.string(),
 });
+/** Schema for a social/external link shown in the footer */
+const socialLinkSchema = z.object({
+    /** Display label for the link */
+    label: z.string(),
+    /** URL the link navigates to */
+    href: z.string(),
+    /** Optional icon identifier (e.g., 'github', 'twitter', 'discord') */
+    icon: z.string().optional(),
+});
 /**
  * A color value that supports both light and dark modes.
  *
@@ -70,6 +79,11 @@ const themeSchema = z.object({
     headerLinks: z.array(headerLinkSchema).optional(),
     /** Semantic color tokens for CSS custom property theming */
     colors: colorsSchema.optional(),
+    /** Social/external links shown in the footer */
+    socialLinks: z.array(socialLinkSchema).optional(),
+    /** Base URL for "Edit on GitHub" links. File path will be appended.
+     *  Example: "https://github.com/org/repo/edit/main/docs" */
+    editUrl: z.string().url().optional(),
 });
 /** Schema for OpenAPI configuration */
 const openApiSchema = z.object({

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

@@ -37,6 +37,45 @@ function isAlreadyWrapped(parent) {
         return true;
     return false;
 }
+function parseMeta(meta, lang) {
+    const result = {
+        showLineNumbers: false,
+        isDiff: lang === "diff",
+        highlightLines: [],
+    };
+    if (!meta)
+        return result;
+    // Extract filename="..." or title="..."
+    const filenameMatch = meta.match(/(?:filename|title)=["']([^"']+)["']/);
+    if (filenameMatch) {
+        result.filename = filenameMatch[1];
+    }
+    // Check for showLineNumbers flag
+    if (/\bshowLineNumbers\b/.test(meta)) {
+        result.showLineNumbers = true;
+    }
+    // Check for diff flag
+    if (/\bdiff\b/.test(meta)) {
+        result.isDiff = true;
+    }
+    // Parse highlight ranges: {1,3-5,8}
+    const highlightMatch = meta.match(/\{([\d,\s-]+)\}/);
+    if (highlightMatch) {
+        const ranges = highlightMatch[1].split(",").map((s) => s.trim());
+        for (const range of ranges) {
+            if (range.includes("-")) {
+                const [start, end] = range.split("-").map(Number);
+                for (let i = start; i <= end; i++) {
+                    result.highlightLines.push(i);
+                }
+            }
+            else {
+                result.highlightLines.push(Number(range));
+            }
+        }
+    }
+    return result;
+}
 export function rehypeCodeBlocks() {
     return (tree) => {
         // Process in reverse to avoid index shifts when splicing
@@ -55,22 +94,64 @@ export function rehypeCodeBlocks() {
                 return;
             // Extract raw text for clipboard
             const rawCode = extractText(codeEl).trimEnd();
-            // Build wrapper: <div class="code-block code-block--fenced">
+            // Get language from class="language-xxx"
+            const codeClasses = Array.isArray(codeEl.properties?.className)
+                ? codeEl.properties.className
+                : [];
+            const langClass = codeClasses.find((c) => typeof c === "string" && c.startsWith("language-"));
+            const lang = langClass ? langClass.replace("language-", "") : "text";
+            // Parse meta string from Astro/Shiki
+            const meta = (node.properties?.["data-meta"] ??
+                codeEl.properties?.["data-meta"] ??
+                node.data?.meta);
+            const parsed = parseMeta(meta, lang);
+            // Build CSS classes for the wrapper
+            const wrapperClasses = ["code-block", "code-block--fenced"];
+            if (parsed.showLineNumbers)
+                wrapperClasses.push("code-block--line-numbers");
+            if (parsed.isDiff)
+                wrapperClasses.push("code-block--diff");
+            if (parsed.highlightLines.length > 0)
+                wrapperClasses.push("code-block--has-highlights");
+            // Build children: optional header + body
+            const children = [];
+            // Add filename header if present
+            if (parsed.filename) {
+                children.push({
+                    type: "element",
+                    tagName: "div",
+                    properties: { className: ["code-block-header"] },
+                    children: [
+                        {
+                            type: "element",
+                            tagName: "span",
+                            properties: { className: ["code-block-title"] },
+                            children: [{ type: "text", value: parsed.filename }],
+                        },
+                    ],
+                });
+            }
+            // Body
+            children.push({
+                type: "element",
+                tagName: "div",
+                properties: { className: ["code-block-body"] },
+                children: [node],
+            });
+            // Build wrapper div
             const wrapper = {
                 type: "element",
                 tagName: "div",
                 properties: {
-                    className: ["code-block", "code-block--fenced"],
+                    className: wrapperClasses,
                     "data-code": rawCode,
+                    ...(parsed.filename ? { "data-filename": parsed.filename } : {}),
+                    ...(parsed.showLineNumbers ? { "data-line-numbers": "" } : {}),
+                    ...(parsed.highlightLines.length > 0
+                        ? { "data-highlight": parsed.highlightLines.join(",") }
+                        : {}),
                 },
-                children: [
-                    {
-                        type: "element",
-                        tagName: "div",
-                        properties: { className: ["code-block-body"] },
-                        children: [node],
-                    },
-                ],
+                children,
             };
             replacements.push({ parent: parent, index, wrapper });
         });

package/dist/navigation/builder.js

@@ -97,6 +97,7 @@ async function buildItems(dirPath, slugPrefix) {
                 type: "external-link",
                 href: entry.href,
                 ...(entry.icon !== undefined && { icon: entry.icon }),
+                ...(entry.badge !== undefined && { badge: entry.badge }),
             });
             continue;
         }
@@ -112,6 +113,7 @@ async function buildItems(dirPath, slugPrefix) {
                 children,
                 ...(entry.collapsed !== undefined && { collapsed: entry.collapsed }),
                 ...(entry.icon !== undefined && { icon: entry.icon }),
+                ...(entry.badge !== undefined && { badge: entry.badge }),
             });
             continue;
         }
@@ -124,6 +126,7 @@ async function buildItems(dirPath, slugPrefix) {
                 slug: slugPrefix ? `${slugPrefix}/${fileSlug}` : fileSlug,
                 type: "page",
                 ...(entry.icon !== undefined && { icon: entry.icon }),
+                ...(entry.badge !== undefined && { badge: entry.badge }),
             });
         }
         // If no file or directory matches, skip silently (meta references a non-existent item)

package/dist/navigation/meta-parser.js

@@ -17,6 +17,7 @@ function normalizeEntry(key, value) {
         ...(value.icon !== undefined && { icon: value.icon }),
         ...(value.href !== undefined && { href: value.href }),
         ...(value.hidden !== undefined && { hidden: value.hidden }),
+        ...(value.badge !== undefined && { badge: value.badge }),
     };
 }
 /**

package/dist/navigation/meta-schema.d.ts

@@ -2,7 +2,7 @@ import { z } from "zod";
 /**
  * Zod schema for the object form of a `_meta.json` entry value.
  *
- * Supports: `title` (required), `collapsed`, `icon`, `href`, `hidden`.
+ * Supports: `title` (required), `collapsed`, `icon`, `href`, `hidden`, `badge`.
  */
 export declare const metaJsonEntryObjectSchema: z.ZodObject<{
     title: z.ZodString;
@@ -10,18 +10,21 @@ export declare const metaJsonEntryObjectSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodString>;
     href: z.ZodOptional<z.ZodString>;
     hidden: z.ZodOptional<z.ZodBoolean>;
+    badge: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     href?: string | undefined;
-    collapsed?: boolean | undefined;
     icon?: string | undefined;
+    collapsed?: boolean | undefined;
     hidden?: boolean | undefined;
+    badge?: string | undefined;
 }, {
     title: string;
     href?: string | undefined;
-    collapsed?: boolean | undefined;
     icon?: string | undefined;
+    collapsed?: boolean | undefined;
     hidden?: boolean | undefined;
+    badge?: string | undefined;
 }>;
 /**
  * Zod schema for a single `_meta.json` entry value.
@@ -35,18 +38,21 @@ export declare const metaJsonEntryValueSchema: z.ZodUnion<[z.ZodString, z.ZodObj
     icon: z.ZodOptional<z.ZodString>;
     href: z.ZodOptional<z.ZodString>;
     hidden: z.ZodOptional<z.ZodBoolean>;
+    badge: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     href?: string | undefined;
-    collapsed?: boolean | undefined;
     icon?: string | undefined;
+    collapsed?: boolean | undefined;
     hidden?: boolean | undefined;
+    badge?: string | undefined;
 }, {
     title: string;
     href?: string | undefined;
-    collapsed?: boolean | undefined;
     icon?: string | undefined;
+    collapsed?: boolean | undefined;
     hidden?: boolean | undefined;
+    badge?: string | undefined;
 }>]>;
 /**
  * Zod schema for a complete `_meta.json` file.
@@ -60,17 +66,20 @@ export declare const metaJsonSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodS
     icon: z.ZodOptional<z.ZodString>;
     href: z.ZodOptional<z.ZodString>;
     hidden: z.ZodOptional<z.ZodBoolean>;
+    badge: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     href?: string | undefined;
-    collapsed?: boolean | undefined;
     icon?: string | undefined;
+    collapsed?: boolean | undefined;
     hidden?: boolean | undefined;
+    badge?: string | undefined;
 }, {
     title: string;
     href?: string | undefined;
-    collapsed?: boolean | undefined;
     icon?: string | undefined;
+    collapsed?: boolean | undefined;
     hidden?: boolean | undefined;
+    badge?: string | undefined;
 }>]>>;
 export type MetaJsonSchemaInput = z.input<typeof metaJsonSchema>;

package/dist/navigation/meta-schema.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 /**
  * Zod schema for the object form of a `_meta.json` entry value.
  *
- * Supports: `title` (required), `collapsed`, `icon`, `href`, `hidden`.
+ * Supports: `title` (required), `collapsed`, `icon`, `href`, `hidden`, `badge`.
  */
 export const metaJsonEntryObjectSchema = z.object({
     title: z.string(),
@@ -10,6 +10,7 @@ export const metaJsonEntryObjectSchema = z.object({
     icon: z.string().optional(),
     href: z.string().optional(),
     hidden: z.boolean().optional(),
+    badge: z.string().optional(),
 });
 /**
  * Zod schema for a single `_meta.json` entry value.

package/dist/types/navigation.d.ts

@@ -22,6 +22,8 @@ export interface NavItem {
     href?: string;
     /** If true, item is excluded from the rendered tree */
     hidden?: boolean;
+    /** Optional badge label ("New", "Beta", "Deprecated", or custom string) */
+    badge?: string;
 }
 /**
  * The complete sidebar navigation tree.
@@ -41,6 +43,7 @@ export type MetaJsonEntryValue = string | {
     icon?: string;
     href?: string;
     hidden?: boolean;
+    badge?: string;
 };
 /**
  * A single parsed entry from `_meta.json`, preserving key order.
@@ -58,4 +61,6 @@ export interface MetaJsonEntry {
     href?: string;
     /** Whether to hide from navigation */
     hidden?: boolean;
+    /** Optional badge label */
+    badge?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specglass/core",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Astro integration, config system, content collections, and OpenAPI spec parsing for Specglass",
   "type": "module",
   "license": "MIT",