blume 0.1.3 → 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;
@@ -2123,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"]>;
@@ -2140,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";
@@ -2151,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">>;
@@ -2179,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;
@@ -2198,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;
         }, {
@@ -2209,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">>;
@@ -2261,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";
@@ -2279,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;
@@ -2333,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;
@@ -2349,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;
@@ -2812,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;
@@ -2986,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";
@@ -3004,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;
@@ -3181,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;
@@ -3412,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;
@@ -3428,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/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.3",
+  "version": "0.1.4",
   "description": "Documentation that's fast, AI-ready, and zero-config.",
   "keywords": [
     "astro",

package/src/astro/generate.ts

@@ -45,7 +45,7 @@ import { buildThemeCss } from "../theme/palette.ts";
 import { twoslashCss } from "../theme/twoslash.ts";
 import { discoverExamples } from "./examples.ts";
 import { discoverIslands } from "./islands.ts";
-import { customOgRoutes, discoverPages } from "./pages.ts";
+import { customOgRoutes, discoverPages, routeIsTaken } from "./pages.ts";
 import {
   askEndpointTemplate,
   astroConfigTemplate,
@@ -61,6 +61,7 @@ import {
   mcpEndpointTemplate,
   mcpPageFile,
   mixedbreadSearchEndpointTemplate,
+  notFoundPageTemplate,
   ogEndpointTemplate,
   rawMarkdownEndpointTemplate,
   rssEndpointTemplate,
@@ -786,6 +787,25 @@ const writeMcpFiles = async (
   ]);
 };
 
+/**
+ * Write the default 404 page at Astro's reserved `src/pages/404.astro` path so
+ * static builds emit `dist/404.html`. Skipped when the project already owns
+ * `/404` (a custom `pages/404.astro` or a `404.md` content page), letting it be
+ * fully overridden without a route collision; `pruneOrphans` then removes any
+ * previously-generated copy.
+ */
+const writeNotFoundPage = async (
+  write: (path: string, content: string) => Promise<boolean>,
+  srcDir: string,
+  pages: { pattern: string }[],
+  contentPages: { route: string }[]
+): Promise<void> => {
+  if (routeIsTaken(pages, contentPages, "/404")) {
+    return;
+  }
+  await write(join(srcDir, "pages", "404.astro"), notFoundPageTemplate());
+};
+
 export interface GenerateResult {
   /** Whether any structural file changed (config/page/content config). */
   structuralChange: boolean;
@@ -985,6 +1005,9 @@ export const generateRuntime = async (
     );
   }
 
+  // The default 404 page (`/404`), unless the project already owns the route.
+  await writeNotFoundPage(write, srcDir, pages, project.graph.pages);
+
   // The provider-specific client loader behind the `blume:search-client` alias
   // is always (re)generated so the alias resolves even when search is disabled.
   await write(searchClientPath, searchClientTemplate(config));

package/src/astro/pages.ts

@@ -27,6 +27,20 @@ export const discoverPages = async (
   });
 };
 
+/**
+ * Whether the project already owns `route` — through a custom `.astro` page
+ * (injected, so matched on `pattern`) or a content page (matched on `route`).
+ * Used to skip a generated default page (e.g. `/404`, `/changelog`) so a
+ * user-authored page overrides it without a route collision.
+ */
+export const routeIsTaken = (
+  pages: { pattern: string }[],
+  contentPages: { route: string }[],
+  route: string
+): boolean =>
+  pages.some((page) => page.pattern === route) ||
+  contentPages.some((page) => page.route === route);
+
 /** A custom-page route that should get a generated OG card. */
 export interface OgCustomRoute {
   /** `og/<slug>.png` path segment; `index` for the site root. */

package/src/astro/templates.ts

@@ -1188,6 +1188,54 @@ const canonical = base ? base + "/changelog" : null;
 `;
 };
 
+/**
+ * Generate `.blume/src/pages/404.astro`: the default not-found page. Rendered
+ * through `PageLayout` (header + search, no sidebar) so it stays consistent with
+ * the rest of the site, with copy pulled from the translatable `notFound` UI
+ * strings. Written at Astro's reserved `src/pages/404.astro` path so static
+ * builds emit `dist/404.html` and the dev server serves it for unmatched routes.
+ * Skipped by the generator when a user `pages/404.astro` already occupies the
+ * `/404` route, so projects can fully override it.
+ */
+export const notFoundPageTemplate = (): string => `---
+// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
+import PageLayout from "blume/components/layout/PageLayout.astro";
+import data from "../generated/data.json";
+
+export const prerender = true;
+
+const nf = data.ui.notFound;
+---
+
+<PageLayout
+  site={{ title: data.config.title, description: data.config.description }}
+  logo={data.config.logo}
+  favicon={data.config.favicon}
+  appleIcon={data.config.appleIcon}
+  banner={data.config.banner}
+  analytics={data.config.analytics}
+  navigation={data.navigation}
+  page={{ title: nf.title, route: "/404" }}
+  themeMode={data.config.theme.mode}
+  fontCssVars={data.fontCssVars}
+  searchEnabled={data.config.search.enabled}
+  ui={data.ui}
+  noindex={true}
+>
+  <div
+    class="mx-auto flex min-h-[60vh] max-w-2xl flex-col items-center justify-center gap-4 px-6 py-24 text-center"
+  >
+    <p class="text-6xl font-bold text-muted-foreground">404</p>
+    <h1 class="text-2xl font-semibold text-foreground">{nf.title}</h1>
+    <p class="text-muted-foreground">{nf.description}</p>
+    <a
+      class="mt-2 rounded-md bg-accent px-4 py-2 text-sm font-medium text-accent-foreground"
+      href="/">{nf.home}</a
+    >
+  </div>
+</PageLayout>
+`;
+
 /**
  * Generate `.blume/src/generated/components.ts`, which re-exports the user's
  * component overrides (or empty maps when no `components.ts` exists). Importing