blume 2.1.0 → 2.1.1

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

@@ -342,6 +342,9 @@ export type SidebarItemConfig = string | {
 };
 /** The object form of `search`: the adapter plus its adapter-independent settings. */
 declare const searchOptionsSchema: z.ZodObject<{
+    analytics: z.ZodPrefault<z.ZodObject<{
+        queries: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     indexing: z.ZodPrefault<z.ZodObject<{
         includeCodeBlocks: z.ZodDefault<z.ZodBoolean>;
         includeHiddenPages: z.ZodDefault<z.ZodBoolean>;
@@ -407,6 +410,7 @@ declare const searchOptionsSchema: z.ZodObject<{
             apiKey: string;
             collection: string;
             host: string;
+            locale?: string | undefined;
             port?: number | undefined;
             protocol?: "http" | "https" | undefined;
         };
@@ -465,6 +469,7 @@ declare const searchOptionsSchema: 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";
@@ -536,6 +541,7 @@ declare const searchOptionsSchema: z.ZodObject<{
             apiKey: string;
             collection: string;
             host: string;
+            locale?: string | undefined;
             port?: number | undefined;
             protocol?: "http" | "https" | undefined;
         };
@@ -1337,6 +1343,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>]>>;
     basePath: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string | undefined>>;
+    changelog: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    }, z.core.$strict>>;
     consent: z.ZodPipe<z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"ethyca">;
         options: z.ZodObject<{
@@ -1451,6 +1461,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 repo: string;
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
+                baseUrl?: string | undefined;
                 drafts?: boolean | undefined;
                 limit?: number | undefined;
                 prereleases?: boolean | undefined;
@@ -1506,11 +1517,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     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[];
@@ -1527,6 +1541,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -1545,6 +1560,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -1604,6 +1620,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 repo: string;
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
+                baseUrl?: string | undefined;
                 drafts?: boolean | undefined;
                 limit?: number | undefined;
                 prereleases?: boolean | undefined;
@@ -1659,11 +1676,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     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[];
@@ -1680,6 +1700,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -1698,6 +1719,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -1755,6 +1777,7 @@ export declare const blumeConfigSchema: 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;
@@ -1811,11 +1834,14 @@ export declare const blumeConfigSchema: 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>;
@@ -1832,6 +1858,7 @@ export declare const blumeConfigSchema: 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>>;
@@ -1850,6 +1877,7 @@ export declare const blumeConfigSchema: 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>>;
@@ -1910,6 +1938,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 repo: string;
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
+                baseUrl?: string | undefined;
                 drafts?: boolean | undefined;
                 limit?: number | undefined;
                 prereleases?: boolean | undefined;
@@ -1965,11 +1994,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     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[];
@@ -1986,6 +2018,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2004,6 +2037,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2063,6 +2097,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 repo: string;
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
+                baseUrl?: string | undefined;
                 drafts?: boolean | undefined;
                 limit?: number | undefined;
                 prereleases?: boolean | undefined;
@@ -2118,11 +2153,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     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[];
@@ -2139,6 +2177,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2157,6 +2196,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2222,6 +2262,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 repo: string;
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
+                baseUrl?: string | undefined;
                 drafts?: boolean | undefined;
                 limit?: number | undefined;
                 prereleases?: boolean | undefined;
@@ -2277,11 +2318,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     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[];
@@ -2298,6 +2342,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2316,6 +2361,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2392,6 +2438,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 repo: string;
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
+                baseUrl?: string | undefined;
                 drafts?: boolean | undefined;
                 limit?: number | undefined;
                 prereleases?: boolean | undefined;
@@ -2447,11 +2494,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     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[];
@@ -2468,6 +2518,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2486,6 +2537,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                     body?: string | undefined;
                     description?: string | undefined;
                     lastModified?: string | undefined;
+                    order?: string | undefined;
                     slug?: string | undefined;
                     title?: string | undefined;
                 } | undefined;
@@ -2601,6 +2653,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 server: "server";
             }>>;
             site: z.ZodOptional<z.ZodURL>;
+            allowedDomains: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hostname: z.ZodOptional<z.ZodString>;
+                port: z.ZodOptional<z.ZodString>;
+                protocol: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         requiredSecrets: z.ZodArray<z.ZodString>;
         runtimeDeps: z.ZodArray<z.ZodString>;
@@ -2647,6 +2704,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
             base?: string | undefined;
             output?: "static" | "server" | undefined;
             site?: string | undefined;
+            allowedDomains?: {
+                hostname?: string | undefined;
+                port?: string | undefined;
+                protocol?: string | undefined;
+            }[] | undefined;
         };
         requiredSecrets: string[];
         runtimeDeps: string[];
@@ -2917,6 +2979,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
         options: z.ZodObject<{
             requests: z.ZodOptional<z.ZodNumber>;
             window: z.ZodOptional<z.ZodNumber>;
+            tokenEnv: z.ZodOptional<z.ZodString>;
+            urlEnv: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>;
         requiredSecrets: z.ZodArray<z.ZodString>;
         runtimeDeps: z.ZodArray<z.ZodString>;
@@ -2942,6 +3006,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
         options: {
             requests?: number | undefined;
             window?: number | undefined;
+            tokenEnv?: string | undefined;
+            urlEnv?: string | undefined;
         };
         requiredSecrets: string[];
         runtimeDeps: string[];
@@ -2967,6 +3033,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
         options: {
             requests?: number | undefined;
             window?: number | undefined;
+            tokenEnv?: string | undefined;
+            urlEnv?: string | undefined;
         };
         requiredSecrets: string[];
         runtimeDeps: string[];
@@ -3047,6 +3115,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"graphql">;
         options: z.ZodPipe<z.ZodObject<{
+            auth: z.ZodOptional<z.ZodObject<{
+                method: z.ZodEnum<{
+                    none: "none";
+                    key: "key";
+                    bearer: "bearer";
+                    basic: "basic";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
             endpoint: z.ZodOptional<z.ZodString>;
             sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 includeInLlms: z.ZodDefault<z.ZodBoolean>;
@@ -3056,6 +3133,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 route: z.ZodOptional<z.ZodString>;
                 seoDescriptionSuffix: z.ZodDefault<z.ZodBoolean>;
                 spec: z.ZodString;
+                auth: z.ZodOptional<z.ZodObject<{
+                    method: z.ZodEnum<{
+                        none: "none";
+                        key: "key";
+                        bearer: "bearer";
+                        basic: "basic";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
                 endpoint: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>>;
             codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
@@ -3080,6 +3166,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 spec: string;
                 label?: string | undefined;
                 route?: string | undefined;
+                auth?: {
+                    method: "none" | "key" | "bearer" | "basic";
+                    name?: string | undefined;
+                } | undefined;
                 endpoint?: string | undefined;
             }[];
             codeSamples: false | string[];
@@ -3088,6 +3178,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 proxy: string | boolean;
             };
             route: string;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
             spec?: string | undefined;
         }, "spec" | "overlays">, {
@@ -3099,6 +3193,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 spec: string;
                 label?: string | undefined;
                 route?: string | undefined;
+                auth?: {
+                    method: "none" | "key" | "bearer" | "basic";
+                    name?: string | undefined;
+                } | undefined;
                 endpoint?: string | undefined;
             }[];
             codeSamples: false | string[];
@@ -3107,6 +3205,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 proxy: string | boolean;
             };
             route: string;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
             spec?: string | undefined;
         }>>;
@@ -3252,6 +3354,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 spec: string;
                 label?: string | undefined;
                 route?: string | undefined;
+                auth?: {
+                    method: "none" | "key" | "bearer" | "basic";
+                    name?: string | undefined;
+                } | undefined;
                 endpoint?: string | undefined;
             }[];
             codeSamples: false | string[];
@@ -3260,6 +3366,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 proxy: string | boolean;
             };
             route: string;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
             spec?: string | undefined;
         }, "spec" | "overlays">;
@@ -3292,6 +3402,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         runtimeDeps: string[];
     }>>>>;
     search: z.ZodPrefault<z.ZodPipe<z.ZodPipe<z.ZodCustom<SearchConfigInput, SearchConfigInput>, z.ZodTransform<{
+        analytics?: {
+            queries?: boolean | undefined;
+        } | undefined;
         indexing?: {
             includeCodeBlocks?: boolean | undefined;
             includeHiddenPages?: boolean | undefined;
@@ -3303,6 +3416,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }[] | undefined;
         provider?: false | SearchAdapterInput | undefined;
     }, SearchConfigInput>>, z.ZodObject<{
+        analytics: z.ZodPrefault<z.ZodObject<{
+            queries: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
         indexing: z.ZodPrefault<z.ZodObject<{
             includeCodeBlocks: z.ZodDefault<z.ZodBoolean>;
             includeHiddenPages: z.ZodDefault<z.ZodBoolean>;
@@ -3368,6 +3484,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 apiKey: string;
                 collection: string;
                 host: string;
+                locale?: string | undefined;
                 port?: number | undefined;
                 protocol?: "http" | "https" | undefined;
             };
@@ -3426,6 +3543,7 @@ export declare const blumeConfigSchema: 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";
@@ -3497,6 +3615,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 apiKey: string;
                 collection: string;
                 host: string;
+                locale?: string | undefined;
                 port?: number | undefined;
                 protocol?: "http" | "https" | undefined;
             };

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

@@ -33,5 +33,8 @@ export declare const snapshotCache: (cacheDir: string) => SnapshotCache;
  * snapshot exists, serve it without fetching (cache-first dev). On fetch failure,
  * serve the last-known-good snapshot with a warning so a CMS/network outage
  * doesn't fail the build; if there is no snapshot either, surface a hard error.
+ * A `BlumeError` from the source (a missing SDK or token, checked before any
+ * request, or a misconfiguration) already names its cause, so without a
+ * snapshot it surfaces as itself rather than as a fetch failure.
  */
 export declare const loadWithCache: (name: string, cache: SnapshotCache, fetchEntries: () => Promise<SourceEntry[]>, refresh?: boolean) => Promise<SourceLoadResult>;

package/dist/types/core/sources/contentful-rich-text.d.ts

@@ -1,20 +1,29 @@
 /**
  * Contentful rich text → Markdown. Covers the block, inline, and mark types
  * the Rich Text editor emits; embedded entries fall through to a serializer
- * keyed by content type or are noted in a comment. Links to assets and
+ * keyed by content type or are noted in a comment, and a link to an entry
+ * points at its page when the source says it has one. Links to assets and
  * entries arrive unresolved from the Delivery API (`data.target` is a
  * `sys` link), so the source hands in resolvers over the response's
  * `includes`; a document the SDK already resolved (with `fields` inline)
  * lowers the same way.
  */
 import type { JsonObject } from "./json.ts";
-/** An asset's file as a Markdown image needs it. */
+/** An asset's file as a Markdown image or link needs it. */
 export interface ContentfulAsset {
+    /** The file's MIME type; an asset that isn't an image renders as a link. */
+    contentType?: string;
     description?: string;
+    fileName?: string;
     title?: string;
     url: string;
 }
 export interface ContentfulRichTextOptions {
+    /**
+     * The route of a linked entry's page; an entry hyperlink to an entry with
+     * none keeps only its text.
+     */
+    entryHref?: (entry: JsonObject) => string | undefined;
     /** Resolve an asset link (`data.target.sys.id`) to its file. */
     resolveAsset?: (id: string) => ContentfulAsset | null;
     /** Resolve an entry link to the entry (`sys` plus `fields`). */

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

@@ -1,3 +1,4 @@
+import type { ResolvedI18nConfig, ResolvedVersionsConfig } from "../schema.ts";
 import type { JsonObject } from "./json.ts";
 import type { RemoteFieldMap } from "./remote.ts";
 import type { ContentSource, SourceContext } from "./types.ts";
@@ -8,10 +9,24 @@ export interface ContentfulSourceOptions {
     space: string;
     /** Environment id; default `master`. */
     environment?: string;
+    /**
+     * Delivery API host name; default `cdn.contentful.com`. A space with EU
+     * data residency reads from `cdn.eu.contentful.com`.
+     */
+    host?: string;
+    /**
+     * Preview API host name for `--preview`; default `preview.contentful.com`
+     * (`preview.eu.contentful.com` for EU data residency).
+     */
+    previewHost?: string;
     /** The content type id whose entries become pages. */
     contentType: string;
     /** Locale code to fetch; omit for the space's default locale. */
     locale?: string;
+    /** The project's i18n config, which places an entry's route by its slug. */
+    i18n?: ResolvedI18nConfig;
+    /** The project's versions config, which places an entry's route by its slug. */
+    versions?: ResolvedVersionsConfig;
     /**
      * Field ids mapping an entry onto Blume meta + body. Paths resolve against
      * the entry's `fields`, with `sys` reachable as `sys.<key>`. Defaults:
@@ -35,6 +50,7 @@ export interface ContentfulSourceOptions {
  * Contentful content source. Pages through the Delivery API (the Preview API
  * under `--preview`), maps each entry's fields to frontmatter, and lowers its
  * rich text body to Markdown with the page's `includes` resolving asset and
- * entry links.
+ * entry links. An entry hyperlink to another of the source's entries links
+ * to that entry's page.
  */
 export declare const contentfulSource: (options: ContentfulSourceOptions, ctx?: SourceContext) => ContentSource;

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

@@ -9,6 +9,11 @@ import type { JsonObject } from "./json.ts";
 export interface LexicalOptions {
     /** The CMS origin a relative upload URL (`/media/x.png`) resolves against. */
     baseUrl?: string;
+    /**
+     * Called with the label of each node left out as a comment (a block with
+     * no serializer, a node type with no Markdown), so the source can warn.
+     */
+    onUnsupported?: (what: string) => void;
     /** Serializers for `block`/`inlineBlock` nodes, keyed by `fields.blockType`. */
     serializers?: Record<string, (fields: JsonObject) => string>;
 }

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

@@ -1,5 +1,6 @@
+import type { YAMLException } from "js-yaml";
 import type { ResolvedI18nConfig } from "../schema.ts";
-import type { Diagnostic, Heading, PageLink, PageRecord } from "../types.ts";
+import type { Diagnostic, ExampleUse, Heading, PageLink, PageRecord } from "../types.ts";
 import type { NormalizeContext, SourceEntry } from "./types.ts";
 /**
  * Slugify a content/route slug (Sanity, Notion, frontmatter `slug`). Heading
@@ -30,6 +31,16 @@ export declare const slugifyPath: (text: string) => string;
  * reports this instead of publishing a route that can never render.
  */
 export declare const unloadablePathDiagnostic: (path: string, file: string) => Diagnostic | undefined;
+/**
+ * The error for a content file whose front matter isn't valid YAML — most
+ * often an unquoted value holding `: `, which YAML reads as a nested mapping.
+ * Thrown out of a source's scan, it would fail every command with
+ * BLUME_INTERNAL; a source leaves the file out and reports this instead, like
+ * a page whose front matter fails the schema. js-yaml counts lines from the
+ * text after the opening `---`, which starts with the rest of that fence
+ * line, so its 0-based line is already the file's line minus one.
+ */
+export declare const frontmatterYamlDiagnostic: (error: YAMLException, file: string) => Diagnostic;
 export declare const HTML_COMMENT: RegExp;
 export declare const INLINE_CODE: RegExp;
 /** A heading whose trailing `{#id}` marker is unescaped — see `BARE_CURLY_MARKER`. */
@@ -37,6 +48,8 @@ export interface CurlyMarker {
     id: string;
     /** 1-based line of the heading (a setext heading's first text line) in the body. */
     line: number;
+    /** The braces as written (`{#id}`, `{ #id }`, `{: #id }`). */
+    marker: string;
 }
 /** Where a heading's text ends in the scanned text, for appending a marker. */
 export interface HeadingSite {
@@ -74,6 +87,12 @@ export declare const MD_IMAGE: RegExp;
 /** Column (0-based, within `matched`) where a link/image match's target starts. */
 export declare const targetOffsetIn: (matched: string, target: string, title: string | undefined) => number;
 export declare const extractLinks: (body: string, lineOffset?: number) => PageLink[];
+/**
+ * Every `<Component path>` in an `.mdx` body, with the 1-based position of its
+ * value; lines are shifted by `lineOffset`, as {@link extractLinks} does. Code
+ * blocks and inline code are skipped.
+ */
+export declare const extractExampleUses: (body: string, lineOffset?: number) => ExampleUse[];
 export declare const extractComponentTags: (body: string) => string[];
 /**
  * Height of the frontmatter block stripped from `raw` to produce `body` (0