blume 0.1.2 → 0.1.4

package/dist/types/core/i18n-ui.d.ts

@@ -94,6 +94,19 @@ declare const uiStringsObject: z.ZodObject<{
         label?: string | undefined;
         untranslated?: string | undefined;
     }>>;
+    notFound: z.ZodDefault<z.ZodObject<{
+        description: z.ZodDefault<z.ZodString>;
+        home: z.ZodDefault<z.ZodString>;
+        title: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        description: string;
+        home: string;
+    }, {
+        title?: string | undefined;
+        description?: string | undefined;
+        home?: string | undefined;
+    }>>;
     page: z.ZodDefault<z.ZodObject<{
         lastUpdated: z.ZodDefault<z.ZodString>;
         next: z.ZodDefault<z.ZodString>;
@@ -188,6 +201,11 @@ declare const uiStringsObject: z.ZodObject<{
     toc: {
         title: string;
     };
+    notFound: {
+        title: string;
+        description: string;
+        home: string;
+    };
 }, {
     actions?: {
         addToCursor?: string | undefined;
@@ -237,6 +255,11 @@ declare const uiStringsObject: z.ZodObject<{
     toc?: {
         title?: string | undefined;
     } | undefined;
+    notFound?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        home?: string | undefined;
+    } | undefined;
 }>;
 export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
     actions: z.ZodDefault<z.ZodObject<{
@@ -324,6 +347,19 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         label?: string | undefined;
         untranslated?: string | undefined;
     }>>;
+    notFound: z.ZodDefault<z.ZodObject<{
+        description: z.ZodDefault<z.ZodString>;
+        home: z.ZodDefault<z.ZodString>;
+        title: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        description: string;
+        home: string;
+    }, {
+        title?: string | undefined;
+        description?: string | undefined;
+        home?: string | undefined;
+    }>>;
     page: z.ZodDefault<z.ZodObject<{
         lastUpdated: z.ZodDefault<z.ZodString>;
         next: z.ZodDefault<z.ZodString>;
@@ -418,6 +454,11 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
     toc: {
         title: string;
     };
+    notFound: {
+        title: string;
+        description: string;
+        home: string;
+    };
 }, {
     actions?: {
         addToCursor?: string | undefined;
@@ -467,6 +508,11 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
     toc?: {
         title?: string | undefined;
     } | undefined;
+    notFound?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        home?: string | undefined;
+    } | undefined;
 }>>;
 /** A fully-resolved dictionary; every key present. */
 export type UIStrings = z.infer<typeof uiStringsObject>;

package/dist/types/core/schema.d.ts

@@ -57,13 +57,13 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         noindex: boolean;
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
     }, {
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
         noindex?: boolean | undefined;
     }>>;
@@ -106,8 +106,8 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     seo: {
         noindex: boolean;
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
     };
     sidebar: {
@@ -119,8 +119,8 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     };
     date?: string | undefined;
     title?: string | undefined;
-    icon?: string | undefined;
     description?: string | undefined;
+    icon?: string | undefined;
     changelog?: {
         date?: string | undefined;
         category?: string | undefined;
@@ -146,9 +146,9 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         exclude?: boolean | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    description?: string | undefined;
     hidden?: boolean | undefined;
     icon?: string | undefined;
-    description?: string | undefined;
     noindex?: boolean | undefined;
     changelog?: {
         date?: string | Date | undefined;
@@ -168,8 +168,8 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     rss?: boolean | undefined;
     seo?: {
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
         noindex?: boolean | undefined;
     } | undefined;
@@ -238,13 +238,13 @@ export declare const pageMetaSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         noindex: boolean;
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
     }, {
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
         noindex?: boolean | undefined;
     }>>;
@@ -287,8 +287,8 @@ export declare const pageMetaSchema: z.ZodObject<{
     seo: {
         noindex: boolean;
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
     };
     sidebar: {
@@ -300,8 +300,8 @@ export declare const pageMetaSchema: z.ZodObject<{
     };
     date?: string | undefined;
     title?: string | undefined;
-    icon?: string | undefined;
     description?: string | undefined;
+    icon?: string | undefined;
     changelog?: {
         date?: string | undefined;
         category?: string | undefined;
@@ -327,9 +327,9 @@ export declare const pageMetaSchema: z.ZodObject<{
         exclude?: boolean | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    description?: string | undefined;
     hidden?: boolean | undefined;
     icon?: string | undefined;
-    description?: string | undefined;
     noindex?: boolean | undefined;
     changelog?: {
         date?: string | Date | undefined;
@@ -349,8 +349,8 @@ export declare const pageMetaSchema: z.ZodObject<{
     rss?: boolean | undefined;
     seo?: {
         title?: string | undefined;
-        canonical?: string | undefined;
         description?: string | undefined;
+        canonical?: string | undefined;
         image?: string | undefined;
         noindex?: boolean | undefined;
     } | undefined;
@@ -551,14 +551,14 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     }, "strict", z.ZodTypeAny, {
         status?: string | undefined;
         title?: string | undefined;
-        order?: string | undefined;
         description?: string | undefined;
+        order?: string | undefined;
         slug?: string | undefined;
     }, {
         status?: string | undefined;
         title?: string | undefined;
-        order?: string | undefined;
         description?: string | undefined;
+        order?: string | undefined;
         slug?: string | undefined;
     }>>;
     /** Status value treated as published; others map to `draft`. Default `Published`. */
@@ -572,8 +572,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     properties?: {
         status?: string | undefined;
         title?: string | undefined;
-        order?: string | undefined;
         description?: string | undefined;
+        order?: string | undefined;
         slug?: string | undefined;
     } | undefined;
     publishedValue?: string | undefined;
@@ -585,8 +585,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     properties?: {
         status?: string | undefined;
         title?: string | undefined;
-        order?: string | undefined;
         description?: string | undefined;
+        order?: string | undefined;
         slug?: string | undefined;
     } | undefined;
     publishedValue?: string | undefined;
@@ -1195,14 +1195,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             }, {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             }>>;
             /** Status value treated as published; others map to `draft`. Default `Published`. */
@@ -1216,8 +1216,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             properties?: {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
@@ -1229,8 +1229,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             properties?: {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
@@ -1322,8 +1322,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             properties?: {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
@@ -1387,8 +1387,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             properties?: {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
@@ -1458,11 +1458,17 @@ export declare const blumeConfigSchema: z.ZodObject<{
     }>>;
     description: z.ZodOptional<z.ZodString>;
     /**
-     * Directory (relative to the project root) that `<Component path>` resolves
-     * live previews and their source against. Defaults to `examples`; point it
-     * elsewhere when examples live outside a top-level `examples/` — e.g. a
-     * registry layout like `registry/<pkg>`, where a `<Component path>` key is
-     * then relative to that directory.
+     * Where `<Component path>` resolves live previews and their source from,
+     * relative to the project root. Defaults to the `examples` directory; point
+     * it elsewhere when examples live outside a top-level `examples/`.
+     *
+     * May be a glob (anything with `*`/`?`/`[]`/`{}`/`!`), in which case only
+     * matching files are discovered and a `<Component path>` key is relative to
+     * the glob's static prefix. Use this for a registry layout that colocates
+     * component sources with their examples — `registry/<pkg>/**\/examples/*`
+     * targets just the examples, leaving the sources (which have no default
+     * export to wrap) out, so the registry needn't be forked into its own
+     * examples directory.
      */
     examples: z.ZodDefault<z.ZodString>;
     export: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
@@ -2117,14 +2123,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }, {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }>, "many">>;
             kind: z.ZodEnum<["dropdown", "language", "product", "version"]>;
@@ -2134,8 +2140,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[];
             kind: "version" | "dropdown" | "language" | "product";
@@ -2145,8 +2151,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }>, "many">>;
@@ -2173,14 +2179,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }, {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }>, "many">>;
             label: z.ZodString;
@@ -2192,8 +2198,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }, {
@@ -2203,8 +2209,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }>, "many">>;
@@ -2255,8 +2261,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[];
             kind: "version" | "dropdown" | "language" | "product";
@@ -2273,8 +2279,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -2327,8 +2333,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -2343,8 +2349,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -2806,8 +2812,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             properties?: {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
@@ -2980,8 +2986,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[];
             kind: "version" | "dropdown" | "language" | "product";
@@ -2998,8 +3004,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -3175,8 +3181,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             properties?: {
                 status?: string | undefined;
                 title?: string | undefined;
-                order?: string | undefined;
                 description?: string | undefined;
+                order?: string | undefined;
                 slug?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
@@ -3406,8 +3412,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -3422,8 +3428,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                icon?: string | undefined;
                 description?: string | undefined;
+                icon?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;

package/dist/types/core/types.d.ts

@@ -129,6 +129,12 @@ export type NavNode = {
     display?: SidebarDisplay;
     icon?: string;
     route?: string;
+    /**
+     * The group's URL path (its folder route prefix), even when the folder
+     * has no index page to link. Used to scope the sidebar to a tab's section;
+     * not a clickable link (that's `route`).
+     */
+    path?: string;
     collapsed?: boolean;
     children: NavNode[];
 };

package/docs/advanced/custom-pages.mdx

@@ -247,6 +247,44 @@ releases. When you want a layout that's fully yours,
 standard Astro project you own outright.
 :::
 
+## 404 page
+
+Blume ships a default **not found** page out of the box: a centered "404" message
+wrapped in the site chrome (header, search, theme), served for any unmatched URL.
+`blume build` writes it to `404.html`, which static hosts serve automatically, and
+`blume dev` shows it for unknown routes.
+
+To replace it with your own, add a `pages/404.astro`. It owns the `/404` route the
+same way `pages/changelog.astro` takes over the changelog — your page wins and the
+default is dropped. Build it like any other custom page, in `PageLayout` or
+`RootLayout`:
+
+```astro pages/404.astro lineNumbers
+---
+import PageLayout from "blume/components/layout/PageLayout.astro";
+import data from "blume:data";
+---
+
+<PageLayout
+  site={{ title: data.config.title, description: data.config.description }}
+  logo={data.config.logo}
+  navigation={data.navigation}
+  themeMode={data.config.theme.mode}
+  searchEnabled={data.config.search.enabled}
+  page={{ title: "Page not found", route: "/404" }}
+  noindex={true}
+>
+  <section class="mx-auto max-w-2xl px-6 py-24 text-center">
+    <h1>This page took a wrong turn</h1>
+    <a href="/">Back to home</a>
+  </section>
+</PageLayout>
+```
+
+To keep the default design but change its wording — including for other languages
+— override the `notFound` [UI strings](/docs/content/i18n) (`title`, `description`,
+`home`) via `i18n.ui`.
+
 ## Interactive pages
 
 Custom pages are ordinary Astro, so you can drop in React (or any framework)

package/docs/content/components.mdx

@@ -589,6 +589,26 @@ export default defineConfig({
 <Component path="file-list/basic" />
 ```
 
+`examples` can also be a glob (anything with `*`, `?`, `[]`, `{}`, or `!`). Only
+matching files are discovered, and `path` is relative to the glob's static prefix
+(the part before the first wildcard). This is for a registry that colocates each
+component's source with its example — point at just the examples so the sources,
+which have no default export to preview, aren't swept in:
+
+```ts
+// blume.config.ts
+export default defineConfig({
+  // registry/files-sdk/file-list/file-list.tsx — source, left out
+  // registry/files-sdk/file-list/examples/basic.tsx — discovered
+  examples: "registry/files-sdk/**/examples/*",
+});
+```
+
+```astro
+<!-- keyed relative to registry/files-sdk -->
+<Component path="file-list/examples/basic" />
+```
+
 <Component path="counter" />
 
 ```astro

package/docs/content/navigation.mdx

@@ -86,19 +86,27 @@ sidebar:
 
 ## Tabs
 
-Render top-level sections as tabs in the header, useful for separating, say, docs
-from an API reference. A tab is highlighted when the current route falls under
-its `path`:
+Render top-level sections as tabs in the header, useful for splitting a large
+site into distinct areas — say adapters, an API, and AI guides. A tab is
+highlighted when the current route falls under its `path`:
 
 ```ts blume.config.ts lineNumbers
 navigation: {
   tabs: [
-    { label: "Docs", path: "/", icon: "book-open" },
+    { label: "Adapters", path: "/adapters", icon: "plug" },
     { label: "API", path: "/api", icon: "rocket" },
+    { label: "AI", path: "/ai", icon: "sparkles" },
   ],
 }
 ```
 
+Tabs also **scope the sidebar**: when the current route falls under a tab's
+`path`, the sidebar shows only that section's pages — so `/adapters/*` lists the
+adapters and nothing else. The folder at a tab's `path` becomes the section, so
+this needs no extra config beyond the tabs themselves; structure your content
+into a folder per tab and point each tab at it. A route under no tab (or a tab
+whose `path` is `/`) shows the full sidebar.
+
 ## Explicit sidebar
 
 For full control, define `navigation.sidebar` in config. When it's set, Blume

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blume",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Documentation that's fast, AI-ready, and zero-config.",
   "keywords": [
     "astro",

package/src/astro/examples.ts

@@ -40,25 +40,62 @@ const FRAMEWORK_BY_EXT: Record<string, ExampleFramework> = {
 };
 
 // Captures the extension so we can strip it from the path key and pick the
-// framework. Kept in sync with the glob below.
+// framework. Kept in sync with the glob below — non-matching files a user glob
+// happens to sweep in (e.g. a registry's `.ts` sources) are dropped here.
 const EXAMPLE_FILE = /\.(?<ext>astro|jsx|svelte|tsx|vue)$/u;
 
+// Renderable example files when `examples` names a plain directory.
+const DEFAULT_EXAMPLE_GLOB = "**/*.{astro,jsx,svelte,tsx,vue}";
+
+// Glob magic that turns `examples` from a plain directory into a pattern. `()`,
+// `@`, and `+` are excluded so literal path segments (npm scopes, parens) keep
+// resolving as directories; the extglob leads `*?!` still trigger here.
+const GLOB_MAGIC = /[!*?[\]{}]/u;
+
+/**
+ * Split a glob into its static directory prefix and the remaining pattern, so
+ * discovered files can be keyed relative to that prefix (e.g.
+ * `registry/x/**\/examples/*` → `{ base: "registry/x", rest: "**\/examples/*" }`).
+ */
+const splitGlobBase = (pattern: string): { base: string; rest: string } => {
+  const segments = pattern.split("/");
+  const firstMagic = segments.findIndex((segment) => GLOB_MAGIC.test(segment));
+  if (firstMagic === -1) {
+    return { base: pattern, rest: "" };
+  }
+  return {
+    base: segments.slice(0, firstMagic).join("/"),
+    rest: segments.slice(firstMagic).join("/"),
+  };
+};
+
 /**
- * Discover preview examples under `<root>/<subdir>` (the `examples` config,
- * default `examples`). Every `.astro`/`.tsx`/`.jsx`/`.vue`/`.svelte` file
- * becomes addressable by `<Component path="...">`, where the path is the file's
- * location under that directory without its extension (e.g. `forms/login.tsx` →
- * `forms/login`). Discovery is path-based (a glob), so no example code is
- * executed. Framework examples carry a hydration mode (default `client:visible`,
- * overridable via `export const client`); `.astro` examples render statically
- * with no client directive.
+ * Discover preview examples for the `examples` config (default `examples`).
+ * Every `.astro`/`.tsx`/`.jsx`/`.vue`/`.svelte` file becomes addressable by
+ * `<Component path="...">`, where the path is the file's location without its
+ * extension (e.g. `forms/login.tsx` → `forms/login`).
+ *
+ * `pattern` is a directory by default, but may be a glob (anything with
+ * `*`/`?`/`[]`/`{}`/`!`) — then only matching files are discovered and each
+ * `<Component path>` key is relative to the glob's static prefix. This lets a
+ * registry layout that colocates component sources with their examples be
+ * targeted directly (e.g. `registry/<pkg>/**\/examples/*`) without the sources —
+ * which have no default export and so can't be wrapped — being swept in.
+ *
+ * Discovery is path-based (a glob), so no example code is executed. Framework
+ * examples carry a hydration mode (default `client:visible`, overridable via
+ * `export const client`); `.astro` examples render statically with no client
+ * directive.
  */
 export const discoverExamples = async (
   root: string,
-  subdir = "examples"
+  pattern = "examples"
 ): Promise<ExampleDiscovery> => {
-  const dir = join(root, subdir);
-  const matches = await glob(["**/*.{astro,jsx,svelte,tsx,vue}"], {
+  const { base, rest } = GLOB_MAGIC.test(pattern)
+    ? splitGlobBase(pattern)
+    : { base: pattern, rest: DEFAULT_EXAMPLE_GLOB };
+  const dir = join(root, base);
+  const matches = await glob([rest], {
     absolute: true,
     cwd: dir,
     onlyFiles: true,