blume 2.1.0 → 2.1.1

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

@@ -4,14 +4,22 @@ import type { SearchAdapter } from "./types.ts";
 /**
  * Connection details for a self-hosted or cloud Typesense node. The browser
  * queries the collection with the search-only `apiKey`; the build-time sync
- * recreates the collection with `TYPESENSE_ADMIN_API_KEY`, which never enters
- * the config.
+ * rebuilds it with `TYPESENSE_ADMIN_API_KEY`, which never enters the config.
  */
 export interface TypesenseNamedOptions {
     /** The search-only API key (public — it ships to the browser). */
     apiKey: string;
+    /** The alias the sync points at each new collection, and searches read. */
     collection: string;
     host: string;
+    /**
+     * The language Typesense tokenizes the text fields for, as a two-letter
+     * code (`ja`, `zh`, `ko`, `th`, …). Typesense's default tokenizer splits on
+     * spaces, so text in a script written without them — Chinese, Japanese,
+     * Thai — only matches from the start of a run. Omitted, the fields keep
+     * that default.
+     */
+    locale?: string;
     /** Defaults to 443. */
     port?: number;
     /** Defaults to `https`. */
@@ -29,6 +37,7 @@ export declare const typesenseOptionsSchema: z.ZodObject<{
     apiKey: z.ZodString;
     collection: z.ZodString;
     host: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
     port: z.ZodOptional<z.ZodNumber>;
     protocol: z.ZodOptional<z.ZodEnum<{
         http: "http";
@@ -36,7 +45,8 @@ export declare const typesenseOptionsSchema: z.ZodObject<{
     }>>;
 }, z.core.$catchall<z.ZodJSONSchema>>;
 /**
- * Hosted search on Typesense. Each `blume build` drops and recreates the
- * collection so deleted or renamed pages don't linger as stale hits.
+ * Hosted search on Typesense. Each `blume build` imports into a new
+ * collection and swaps the `collection` alias onto it, so deleted or renamed
+ * pages don't linger as stale hits and searches never read a partial index.
  */
 export declare const typesense: (options: TypesenseOptions) => TypesenseAdapter;

package/dist/types/search/build.d.ts

@@ -18,6 +18,8 @@
  * Pagefind/pagefind#1272; switch back to `writeFiles()` once a release ships
  * that fix.
  *
- * Returns the number of pages indexed.
+ * Returns the number of pages indexed: the index's own count, summed over its
+ * languages from `pagefind-entry.json`. `addDirectory`'s `page_count` counts
+ * every HTML file it read, including the ones kept out of the index.
  */
 export declare const buildSearchIndex: (outDir: string) => Promise<number>;

package/dist/types/search/orama-index.d.ts

@@ -35,11 +35,11 @@ export interface OramaDoc {
  * so ranking is identical wherever docs are queried. `locale` — the site's
  * `i18n.defaultLocale` — swaps in a word-segmenting tokenizer for every
  * non-Latin script, all of which Orama's default tokenizer reduces to zero
- * tokens; the tokenizer belongs to the database, so on a mixed-locale site it
- * applies to every document. That is safe in one direction only: Latin words
+ * tokens. A non-Latin default's tokenizer serves every page: Latin words
  * survive segmentation intact, so English pages on a segmented index stay
- * searchable, but non-Latin translations on a Latin-default index still
- * collapse to zero tokens.
+ * searchable. A Latin default keeps Orama's tokenizer for its Latin-script
+ * pages, and each page in a non-Latin locale (the Japanese and Hindi
+ * translations of an English site) is indexed with its own locale's tokenizer.
  */
 export declare const buildOramaIndex: (documents: OramaDoc[], locale?: string) => Promise<AnyOrama>;
 /** Optional exact-match filters applied to a query via Orama's `where`. */
@@ -65,10 +65,10 @@ export interface OramaQueryFilters {
  * `locale` to one language, `contentTypes` to a set of page types, `facets`
  * to documents carrying every requested `key:value` term.
  *
- * On a bigrammed index the strict pass runs first: a term is only meant to
- * match where its bigrams sit together, and scoring them independently lets a
- * page sharing a couple of windows outrank the page the term is about. Terms
- * spanning several words rarely appear in full on one page, so an empty strict
- * result falls back to the default pass rather than reporting no matches.
+ * On an index whose translations have tokenizers of their own, a query scoped
+ * to a locale is tokenized with that locale's tokenizer. An unscoped query
+ * searches each locale's pages with its own tokenizer, and the Latin-script
+ * pages with Orama's, then merges the matches by score: every search runs over
+ * the one index, so their scores share its term statistics.
  */
 export declare const queryOramaIndex: (db: AnyOrama, term: string, limit: number, filters?: OramaQueryFilters) => Promise<OramaDoc[]>;

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

@@ -9,8 +9,11 @@ export type AlgoliaSyncConfig = Pick<AlgoliaOptions, "appId" | "indexName">;
  *
  * Uses `replaceAllObjects`, which atomically replaces the index contents, so
  * pages deleted or renamed since the last sync don't linger as stale search
- * hits that 404 when clicked. Then adds `filterOnly(locale)` and
+ * hits that 404 when clicked. A page too long for one record is split across
+ * several (see {@link toObjects}). Then adds `filterOnly(locale)` and
  * `filterOnly(version)` to the index's `attributesForFaceting`, keeping any
- * the site declared itself, so the dialog's locale and version filters match.
+ * the site declared itself, so the dialog's locale and version filters match,
+ * and, once a page is split, `url` as the index's `attributeForDistinct`
+ * unless the site set its own.
  */
 export declare const syncAlgolia: (records: SearchRecord[], config: AlgoliaSyncConfig) => Promise<void>;

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

@@ -9,6 +9,8 @@ export interface SyncReporter {
  * After a build, upload the per-page records to the configured hosted adapter.
  * Reads secret admin keys from the environment; if a key (or option) is
  * missing the sync is skipped with a warning rather than failing the build —
- * CI may sync in a separate step.
+ * a local build has no secrets, and CI may sync in a separate step. Once the
+ * sync is set up, a failure fails the build (`BLUME_SEARCH_SYNC_FAILED`):
+ * the site would otherwise deploy against an index this build didn't update.
  */
 export declare const syncSearchProvider: (project: BlumeProject, reporter: SyncReporter) => Promise<void>;

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/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/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;
@@ -102,11 +103,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 +127,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 +146,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 +220,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;
@@ -270,11 +277,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 +301,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 +320,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 +381,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;
@@ -424,11 +437,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 +461,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 +480,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 +540,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;
@@ -577,11 +596,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 +620,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 +639,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 +704,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;
@@ -735,11 +760,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 +784,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 +803,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 +863,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;
@@ -888,11 +919,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 +943,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 +962,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 +1020,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;
@@ -1040,11 +1077,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 +1101,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 +1120,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 +1181,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;
@@ -1194,11 +1237,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 +1261,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 +1280,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 +1340,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;
@@ -1347,11 +1396,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 +1420,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 +1439,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