blume 2.1.0 → 2.1.2

package/dist/types/search/sync/typesense.d.ts

@@ -1,14 +1,18 @@
 import type { TypesenseOptions } from "../adapters/typesense.ts";
 import type { SearchRecord } from "../documents.ts";
 /** The adapter options the sync reads (the public `apiKey` is never used). */
-export type TypesenseSyncConfig = Pick<TypesenseOptions, "collection" | "host" | "port" | "protocol">;
+export type TypesenseSyncConfig = Pick<TypesenseOptions, "collection" | "host" | "locale" | "port" | "protocol">;
 /**
- * Import the search records into a Typesense collection. Uses the admin key
- * from `TYPESENSE_ADMIN_API_KEY`. Throws on a missing key so the caller can
- * warn.
+ * Import the search records into Typesense. Uses the admin key from
+ * `TYPESENSE_ADMIN_API_KEY`. Throws on a missing key so the caller can warn.
  *
- * The collection is dropped and recreated on each sync so that pages deleted or
- * renamed since the last sync don't linger as stale search hits that 404 when
- * clicked (an upsert alone never removes them).
+ * `collection` names an alias. Each sync imports every record into a new
+ * collection (`<collection>_<timestamp>`), points the alias at it, then drops
+ * the collection it replaced: searches keep reading the previous collection
+ * until the new one is complete, pages deleted or renamed since the last sync
+ * don't linger as stale hits that 404 when clicked, and a sync that fails
+ * leaves the previous collection serving. A collection named `collection`
+ * itself, from a sync before the alias existed, is dropped just before the
+ * alias takes its name, since Typesense won't let the two share one.
  */
 export declare const syncTypesense: (records: SearchRecord[], config: TypesenseSyncConfig) => Promise<void>;

package/dist/types/seo/jsonld.d.ts

@@ -11,7 +11,7 @@ export interface PostalAddressIdentity {
 }
 /**
  * `seo.organization`: the organization behind the site, emitted on every page
- * as an `Organization` node the WebSite and article nodes cite as publisher.
+ * as an `Organization` node the WebSite and page nodes cite as publisher.
  */
 export interface OrganizationIdentity {
     address?: PostalAddressIdentity;
@@ -62,6 +62,12 @@ export interface StructuredDataInput {
     description?: string;
     /** Page route, e.g. `/blog/post`. */
     route: string;
+    /**
+     * The route of this page's homepage: the navigation tree root
+     * (`navigation.root` — `/fr` for a locale, `/docs` under a `basePath`,
+     * `/v1.0` in an archived version). Defaults to `/`.
+     */
+    homeRoute?: string;
     /** Deployment base (`import.meta.env.BASE_URL`); prefixed onto absolute URLs. */
     base?: string;
     /** Content type — `blog` and `changelog` map to richer article types. */
@@ -96,10 +102,9 @@ export declare const toIso: (value: DateInput | undefined) => string | undefined
 /**
  * Build a schema.org JSON-LD `@graph` for a page: site identity (the WebSite,
  * plus the configured Organization everywhere and the SoftwareApplication on
- * the homepage), the page as an article, and its breadcrumb trail. Returns
- * null when there is nothing useful to emit (e.g. the homepage without a
- * configured site). URLs are absolute when `siteUrl` is set, otherwise
- * route-relative.
+ * the homepage), the page itself (a WebPage on the homepage, an article
+ * elsewhere), and an article's breadcrumb trail. URLs are absolute when
+ * `siteUrl` is set, otherwise route-relative.
  */
-export declare const buildStructuredData: (input: StructuredDataInput) => JsonLdNode | null;
+export declare const buildStructuredData: (input: StructuredDataInput) => JsonLdNode;
 export {};

package/dist/types/sources/contentful.d.ts

@@ -13,10 +13,20 @@ export interface ContentfulOptions extends SharedSourceOptions {
      * / `sys.updatedAt`.
      */
     fields?: SourceFieldMap;
+    /**
+     * Delivery API host name. Defaults to `cdn.contentful.com`; a space with
+     * EU data residency reads from `cdn.eu.contentful.com`.
+     */
+    host?: string;
     /** Locale code to fetch; omit for the space's default locale. */
     locale?: string;
     /** Extra query parameters for the entries request (`"fields.section": "sdk"`). */
     params?: Record<string, string>;
+    /**
+     * Preview API host name for `--preview`. Defaults to
+     * `preview.contentful.com` (`preview.eu.contentful.com` in the EU).
+     */
+    previewHost?: string;
     /** Space id. */
     space: string;
 }
@@ -29,11 +39,14 @@ export declare const contentfulOptionsSchema: z.ZodObject<{
         body: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         lastModified: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodString>;
         slug: z.ZodOptional<z.ZodString>;
         title: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    host: z.ZodOptional<z.ZodString>;
     locale: z.ZodOptional<z.ZodString>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    previewHost: z.ZodOptional<z.ZodString>;
     space: z.ZodString;
 }, z.core.$strict>;
 export type ContentfulAdapter = AdapterDescriptor<"contentful", ContentfulOptions>;
@@ -48,11 +61,14 @@ export declare const contentfulAdapterSchema: z.ZodObject<{
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
+        host: z.ZodOptional<z.ZodString>;
         locale: z.ZodOptional<z.ZodString>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        previewHost: z.ZodOptional<z.ZodString>;
         space: z.ZodString;
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;

package/dist/types/sources/github-releases.d.ts

@@ -3,7 +3,12 @@ import type { AdapterDescriptor } from "../core/adapter.ts";
 import type { SharedSourceOptions } from "./shared.ts";
 /** Options for {@link githubReleases}. */
 export interface GithubReleasesOptions extends SharedSourceOptions {
-    /** Include draft releases (needs a token with repo write access). */
+    /**
+     * The GitHub REST API base URL. Defaults to `https://api.github.com`; a
+     * GitHub Enterprise Server's is `https://<host>/api/v3`.
+     */
+    baseUrl?: string;
+    /** Include draft releases, tagged `Draft` (needs a token with repo write access). */
     drafts?: boolean;
     /** Cap the number of releases materialized, newest-first. Defaults to 100. */
     limit?: number;
@@ -17,6 +22,7 @@ export interface GithubReleasesOptions extends SharedSourceOptions {
 export declare const githubReleasesOptionsSchema: z.ZodObject<{
     pollInterval: z.ZodOptional<z.ZodNumber>;
     prefix: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodOptional<z.ZodString>;
     drafts: z.ZodOptional<z.ZodBoolean>;
     limit: z.ZodOptional<z.ZodNumber>;
     owner: z.ZodString;
@@ -29,6 +35,7 @@ export declare const githubReleasesAdapterSchema: z.ZodObject<{
     options: z.ZodObject<{
         pollInterval: z.ZodOptional<z.ZodNumber>;
         prefix: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
         drafts: z.ZodOptional<z.ZodBoolean>;
         limit: z.ZodOptional<z.ZodNumber>;
         owner: z.ZodString;

package/dist/types/sources/notion.d.ts

@@ -7,6 +7,12 @@ export interface NotionOptions extends SharedSourceOptions {
     concurrency?: number;
     /** Notion database id. */
     database: string;
+    /**
+     * Read text typed in Notion as MDX, so components and Markdown in it
+     * render. Anyone who can edit the database can then run code at build
+     * time. Default false: text renders as written.
+     */
+    mdx?: boolean;
     /** Notion property names mapped onto Blume meta. */
     properties?: {
         /** Property holding the page description. */
@@ -28,6 +34,7 @@ export declare const notionOptionsSchema: z.ZodObject<{
     prefix: z.ZodOptional<z.ZodString>;
     concurrency: z.ZodOptional<z.ZodNumber>;
     database: z.ZodString;
+    mdx: z.ZodOptional<z.ZodBoolean>;
     properties: z.ZodOptional<z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         order: z.ZodOptional<z.ZodString>;
@@ -45,6 +52,7 @@ export declare const notionAdapterSchema: z.ZodObject<{
         prefix: z.ZodOptional<z.ZodString>;
         concurrency: z.ZodOptional<z.ZodNumber>;
         database: z.ZodString;
+        mdx: z.ZodOptional<z.ZodBoolean>;
         properties: z.ZodOptional<z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             order: z.ZodOptional<z.ZodString>;

package/dist/types/sources/payload.d.ts

@@ -32,6 +32,7 @@ export declare const payloadOptionsSchema: z.ZodObject<{
         body: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         lastModified: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodString>;
         slug: z.ZodOptional<z.ZodString>;
         title: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
@@ -51,6 +52,7 @@ export declare const payloadAdapterSchema: z.ZodObject<{
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;

package/dist/types/sources/registry.d.ts

@@ -46,6 +46,7 @@ declare const sourceAdapterUnion: z.ZodDiscriminatedUnion<readonly [z.ZodObject<
     options: z.ZodObject<{
         pollInterval: z.ZodOptional<z.ZodNumber>;
         prefix: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
         drafts: z.ZodOptional<z.ZodBoolean>;
         limit: z.ZodOptional<z.ZodNumber>;
         owner: z.ZodString;
@@ -80,6 +81,7 @@ declare const sourceAdapterUnion: z.ZodDiscriminatedUnion<readonly [z.ZodObject<
         prefix: z.ZodOptional<z.ZodString>;
         concurrency: z.ZodOptional<z.ZodNumber>;
         database: z.ZodString;
+        mdx: z.ZodOptional<z.ZodBoolean>;
         properties: z.ZodOptional<z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             order: z.ZodOptional<z.ZodString>;
@@ -102,11 +104,14 @@ declare const sourceAdapterUnion: z.ZodDiscriminatedUnion<readonly [z.ZodObject<
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
+        host: z.ZodOptional<z.ZodString>;
         locale: z.ZodOptional<z.ZodString>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        previewHost: z.ZodOptional<z.ZodString>;
         space: z.ZodString;
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
@@ -123,6 +128,7 @@ declare const sourceAdapterUnion: z.ZodDiscriminatedUnion<readonly [z.ZodObject<
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -141,6 +147,7 @@ declare const sourceAdapterUnion: z.ZodDiscriminatedUnion<readonly [z.ZodObject<
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -214,6 +221,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
     options: z.ZodObject<{
         pollInterval: z.ZodOptional<z.ZodNumber>;
         prefix: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
         drafts: z.ZodOptional<z.ZodBoolean>;
         limit: z.ZodOptional<z.ZodNumber>;
         owner: z.ZodString;
@@ -248,6 +256,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         prefix: z.ZodOptional<z.ZodString>;
         concurrency: z.ZodOptional<z.ZodNumber>;
         database: z.ZodString;
+        mdx: z.ZodOptional<z.ZodBoolean>;
         properties: z.ZodOptional<z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             order: z.ZodOptional<z.ZodString>;
@@ -270,11 +279,14 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
+        host: z.ZodOptional<z.ZodString>;
         locale: z.ZodOptional<z.ZodString>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        previewHost: z.ZodOptional<z.ZodString>;
         space: z.ZodString;
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
@@ -291,6 +303,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -309,6 +322,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -369,6 +383,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         repo: string;
         pollInterval?: number | undefined;
         prefix?: string | undefined;
+        baseUrl?: string | undefined;
         drafts?: boolean | undefined;
         limit?: number | undefined;
         prereleases?: boolean | undefined;
@@ -401,6 +416,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         pollInterval?: number | undefined;
         prefix?: string | undefined;
         concurrency?: number | undefined;
+        mdx?: boolean | undefined;
         properties?: {
             description?: string | undefined;
             order?: string | undefined;
@@ -424,11 +440,14 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
+        host?: string | undefined;
         locale?: string | undefined;
         params?: Record<string, string> | undefined;
+        previewHost?: string | undefined;
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
@@ -445,6 +464,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -463,6 +483,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -522,6 +543,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         repo: string;
         pollInterval?: number | undefined;
         prefix?: string | undefined;
+        baseUrl?: string | undefined;
         drafts?: boolean | undefined;
         limit?: number | undefined;
         prereleases?: boolean | undefined;
@@ -554,6 +576,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         pollInterval?: number | undefined;
         prefix?: string | undefined;
         concurrency?: number | undefined;
+        mdx?: boolean | undefined;
         properties?: {
             description?: string | undefined;
             order?: string | undefined;
@@ -577,11 +600,14 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
+        host?: string | undefined;
         locale?: string | undefined;
         params?: Record<string, string> | undefined;
+        previewHost?: string | undefined;
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
@@ -598,6 +624,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -616,6 +643,7 @@ export declare const resolvedSourceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -680,6 +708,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         repo: string;
         pollInterval?: number | undefined;
         prefix?: string | undefined;
+        baseUrl?: string | undefined;
         drafts?: boolean | undefined;
         limit?: number | undefined;
         prereleases?: boolean | undefined;
@@ -712,6 +741,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         pollInterval?: number | undefined;
         prefix?: string | undefined;
         concurrency?: number | undefined;
+        mdx?: boolean | undefined;
         properties?: {
             description?: string | undefined;
             order?: string | undefined;
@@ -735,11 +765,14 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
+        host?: string | undefined;
         locale?: string | undefined;
         params?: Record<string, string> | undefined;
+        previewHost?: string | undefined;
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
@@ -756,6 +789,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -774,6 +808,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -833,6 +868,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         repo: string;
         pollInterval?: number | undefined;
         prefix?: string | undefined;
+        baseUrl?: string | undefined;
         drafts?: boolean | undefined;
         limit?: number | undefined;
         prereleases?: boolean | undefined;
@@ -865,6 +901,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         pollInterval?: number | undefined;
         prefix?: string | undefined;
         concurrency?: number | undefined;
+        mdx?: boolean | undefined;
         properties?: {
             description?: string | undefined;
             order?: string | undefined;
@@ -888,11 +925,14 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
+        host?: string | undefined;
         locale?: string | undefined;
         params?: Record<string, string> | undefined;
+        previewHost?: string | undefined;
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
@@ -909,6 +949,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -927,6 +968,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -984,6 +1026,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
     options: z.ZodObject<{
         pollInterval: z.ZodOptional<z.ZodNumber>;
         prefix: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
         drafts: z.ZodOptional<z.ZodBoolean>;
         limit: z.ZodOptional<z.ZodNumber>;
         owner: z.ZodString;
@@ -1018,6 +1061,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         prefix: z.ZodOptional<z.ZodString>;
         concurrency: z.ZodOptional<z.ZodNumber>;
         database: z.ZodString;
+        mdx: z.ZodOptional<z.ZodBoolean>;
         properties: z.ZodOptional<z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             order: z.ZodOptional<z.ZodString>;
@@ -1040,11 +1084,14 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
+        host: z.ZodOptional<z.ZodString>;
         locale: z.ZodOptional<z.ZodString>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        previewHost: z.ZodOptional<z.ZodString>;
         space: z.ZodString;
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
@@ -1061,6 +1108,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -1079,6 +1127,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -1139,6 +1188,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         repo: string;
         pollInterval?: number | undefined;
         prefix?: string | undefined;
+        baseUrl?: string | undefined;
         drafts?: boolean | undefined;
         limit?: number | undefined;
         prereleases?: boolean | undefined;
@@ -1171,6 +1221,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         pollInterval?: number | undefined;
         prefix?: string | undefined;
         concurrency?: number | undefined;
+        mdx?: boolean | undefined;
         properties?: {
             description?: string | undefined;
             order?: string | undefined;
@@ -1194,11 +1245,14 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
+        host?: string | undefined;
         locale?: string | undefined;
         params?: Record<string, string> | undefined;
+        previewHost?: string | undefined;
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
@@ -1215,6 +1269,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -1233,6 +1288,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -1292,6 +1348,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         repo: string;
         pollInterval?: number | undefined;
         prefix?: string | undefined;
+        baseUrl?: string | undefined;
         drafts?: boolean | undefined;
         limit?: number | undefined;
         prereleases?: boolean | undefined;
@@ -1324,6 +1381,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
         pollInterval?: number | undefined;
         prefix?: string | undefined;
         concurrency?: number | undefined;
+        mdx?: boolean | undefined;
         properties?: {
             description?: string | undefined;
             order?: string | undefined;
@@ -1347,11 +1405,14 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
+        host?: string | undefined;
         locale?: string | undefined;
         params?: Record<string, string> | undefined;
+        previewHost?: string | undefined;
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
@@ -1368,6 +1429,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;
@@ -1386,6 +1448,7 @@ export declare const contentSourcesSchema: z.ZodArray<z.ZodPipe<z.ZodCustom<{
             body?: string | undefined;
             description?: string | undefined;
             lastModified?: string | undefined;
+            order?: string | undefined;
             slug?: string | undefined;
             title?: string | undefined;
         } | undefined;

package/dist/types/sources/shared.d.ts

@@ -29,6 +29,8 @@ export interface SourceFieldMap {
     description?: string;
     /** Field holding the last-modified date. */
     lastModified?: string;
+    /** Field holding the sidebar order (a number). No default: unset, none is read. */
+    order?: string;
     /** Field holding the page slug. */
     slug?: string;
     /** Field holding the page title. */
@@ -39,6 +41,7 @@ export declare const sourceFieldMapSchema: z.ZodObject<{
     body: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     lastModified: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodString>;
     slug: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;

package/dist/types/sources/strapi.d.ts

@@ -27,6 +27,7 @@ export declare const strapiOptionsSchema: z.ZodObject<{
         body: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         lastModified: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodString>;
         slug: z.ZodOptional<z.ZodString>;
         title: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
@@ -46,6 +47,7 @@ export declare const strapiAdapterSchema: z.ZodObject<{
             body: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             lastModified: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;

package/docs/01-quickstart.mdx

@@ -15,8 +15,10 @@ Go from an empty folder to a running docs site in a few commands. Blume needs **
     `blume init` asks a few questions — where to create the project, what your
     docs site is called, which template, and where your content lives — then
     scaffolds the minimum surface: a content folder, a config file, and a
-    `package.json` with `dev` and `build` scripts. It installs the dependencies
-    with the package manager that ran it. Pass `--yes` to skip the prompts and
+    `package.json` with `dev`, `build`, and `doctor` scripts, plus a
+    `.gitignore` that keeps `node_modules/`, the generated `.blume/`, `dist/`,
+    and `.env.local` (where local secrets go) out of version control. It
+    installs the dependencies with the package manager that ran it. Pass `--yes` to skip the prompts and
     take the defaults, or `--no-install` to only write the files.
 
     ```package-install