blume 2.0.3 → 2.1.1

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

@@ -26,7 +26,7 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             seoDescriptionSuffix: z.ZodDefault<z.ZodBoolean>;
             spec: z.ZodString;
         }, z.core.$strict>>>;
-        codeSamples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
         playground: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             proxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -50,14 +50,14 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
         spec?: string | undefined;
-    }, "spec">, {
+    }, "spec" | "overlays">, {
         expandSchemas: boolean;
         sources: {
             includeInLlms: boolean;
@@ -68,7 +68,7 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
@@ -81,6 +81,15 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
 }, 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>;
@@ -90,9 +99,18 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             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.ZodArray<z.ZodString>>;
+        codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
         playground: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             proxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -114,17 +132,25 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        auth?: {
+            method: "none" | "key" | "bearer" | "basic";
+            name?: string | undefined;
+        } | undefined;
         endpoint?: string | undefined;
         spec?: string | undefined;
-    }, "spec">, {
+    }, "spec" | "overlays">, {
         sources: {
             includeInLlms: boolean;
             includeInSearch: boolean;
@@ -133,14 +159,22 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        auth?: {
+            method: "none" | "key" | "bearer" | "basic";
+            name?: string | undefined;
+        } | undefined;
         endpoint?: string | undefined;
         spec?: string | undefined;
     }>>;
@@ -150,6 +184,7 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
     kind: z.ZodLiteral<"openapi">;
     options: z.ZodPipe<z.ZodObject<{
         expandSchemas: z.ZodDefault<z.ZodBoolean>;
+        overlays: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
             includeInLlms: z.ZodDefault<z.ZodBoolean>;
             includeInSearch: z.ZodDefault<z.ZodBoolean>;
@@ -158,8 +193,9 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             route: z.ZodOptional<z.ZodString>;
             seoDescriptionSuffix: z.ZodDefault<z.ZodBoolean>;
             spec: z.ZodString;
+            overlays: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>>;
-        codeSamples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
         playground: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             proxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -180,17 +216,19 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             noindex: boolean;
             seoDescriptionSuffix: boolean;
             spec: string;
+            overlays: string[];
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        overlays?: string[] | undefined;
         spec?: string | undefined;
-    }, "spec">, {
+    }, "spec" | "overlays">, {
         expandSchemas: boolean;
         sources: {
             includeInLlms: boolean;
@@ -198,15 +236,17 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             noindex: boolean;
             seoDescriptionSuffix: boolean;
             spec: string;
+            overlays: string[];
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        overlays?: string[] | undefined;
         spec?: string | undefined;
     }>>;
     requiredSecrets: z.ZodArray<z.ZodString>;
@@ -214,10 +254,12 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"scalar">;
     options: z.ZodPipe<z.ZodObject<{
+        overlays: z.ZodOptional<z.ZodArray<z.ZodString>>;
         route: z.ZodDefault<z.ZodString>;
         sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
             noindex: z.ZodDefault<z.ZodBoolean>;
+            overlays: z.ZodDefault<z.ZodArray<z.ZodString>>;
             route: z.ZodOptional<z.ZodString>;
             spec: z.ZodString;
         }, z.core.$strict>>>;
@@ -228,10 +270,12 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
         route: string;
         sources: {
             noindex: boolean;
+            overlays: string[];
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
         }[];
+        overlays?: string[] | undefined;
         spec?: string | undefined;
         theme?: string | undefined;
     }>>;
@@ -255,14 +299,14 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
         spec?: string | undefined;
-    }, "spec">;
+    }, "spec" | "overlays">;
     requiredSecrets: string[];
     runtimeDeps: string[];
 } | {
@@ -276,17 +320,25 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        auth?: {
+            method: "none" | "key" | "bearer" | "basic";
+            name?: string | undefined;
+        } | undefined;
         endpoint?: string | undefined;
         spec?: string | undefined;
-    }, "spec">;
+    }, "spec" | "overlays">;
     requiredSecrets: string[];
     runtimeDeps: string[];
 } | {
@@ -299,17 +351,19 @@ export declare const referenceAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[
             noindex: boolean;
             seoDescriptionSuffix: boolean;
             spec: string;
+            overlays: string[];
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        overlays?: string[] | undefined;
         spec?: string | undefined;
-    }, "spec">;
+    }, "spec" | "overlays">;
     requiredSecrets: string[];
     runtimeDeps: string[];
 }>>;
@@ -331,7 +385,7 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             seoDescriptionSuffix: z.ZodDefault<z.ZodBoolean>;
             spec: z.ZodString;
         }, z.core.$strict>>>;
-        codeSamples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
         playground: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             proxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -355,14 +409,14 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
         spec?: string | undefined;
-    }, "spec">, {
+    }, "spec" | "overlays">, {
         expandSchemas: boolean;
         sources: {
             includeInLlms: boolean;
@@ -373,7 +427,7 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
@@ -386,6 +440,15 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
 }, 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>;
@@ -395,9 +458,18 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             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.ZodArray<z.ZodString>>;
+        codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
         playground: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             proxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -419,17 +491,25 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        auth?: {
+            method: "none" | "key" | "bearer" | "basic";
+            name?: string | undefined;
+        } | undefined;
         endpoint?: string | undefined;
         spec?: string | undefined;
-    }, "spec">, {
+    }, "spec" | "overlays">, {
         sources: {
             includeInLlms: boolean;
             includeInSearch: boolean;
@@ -438,14 +518,22 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        auth?: {
+            method: "none" | "key" | "bearer" | "basic";
+            name?: string | undefined;
+        } | undefined;
         endpoint?: string | undefined;
         spec?: string | undefined;
     }>>;
@@ -455,6 +543,7 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
     kind: z.ZodLiteral<"openapi">;
     options: z.ZodPipe<z.ZodObject<{
         expandSchemas: z.ZodDefault<z.ZodBoolean>;
+        overlays: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
             includeInLlms: z.ZodDefault<z.ZodBoolean>;
             includeInSearch: z.ZodDefault<z.ZodBoolean>;
@@ -463,8 +552,9 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             route: z.ZodOptional<z.ZodString>;
             seoDescriptionSuffix: z.ZodDefault<z.ZodBoolean>;
             spec: z.ZodString;
+            overlays: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>>;
-        codeSamples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        codeSamples: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodString>]>>;
         playground: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             proxy: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -485,17 +575,19 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             noindex: boolean;
             seoDescriptionSuffix: boolean;
             spec: string;
+            overlays: string[];
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        overlays?: string[] | undefined;
         spec?: string | undefined;
-    }, "spec">, {
+    }, "spec" | "overlays">, {
         expandSchemas: boolean;
         sources: {
             includeInLlms: boolean;
@@ -503,15 +595,17 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             noindex: boolean;
             seoDescriptionSuffix: boolean;
             spec: string;
+            overlays: string[];
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        overlays?: string[] | undefined;
         spec?: string | undefined;
     }>>;
     requiredSecrets: z.ZodArray<z.ZodString>;
@@ -519,10 +613,12 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"scalar">;
     options: z.ZodPipe<z.ZodObject<{
+        overlays: z.ZodOptional<z.ZodArray<z.ZodString>>;
         route: z.ZodDefault<z.ZodString>;
         sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
             noindex: z.ZodDefault<z.ZodBoolean>;
+            overlays: z.ZodDefault<z.ZodArray<z.ZodString>>;
             route: z.ZodOptional<z.ZodString>;
             spec: z.ZodString;
         }, z.core.$strict>>>;
@@ -533,10 +629,12 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
         route: string;
         sources: {
             noindex: boolean;
+            overlays: string[];
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
         }[];
+        overlays?: string[] | undefined;
         spec?: string | undefined;
         theme?: string | undefined;
     }>>;
@@ -560,14 +658,14 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
         spec?: string | undefined;
-    }, "spec">;
+    }, "spec" | "overlays">;
     requiredSecrets: string[];
     runtimeDeps: string[];
 } | {
@@ -581,17 +679,25 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            auth?: {
+                method: "none" | "key" | "bearer" | "basic";
+                name?: string | undefined;
+            } | undefined;
             endpoint?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        auth?: {
+            method: "none" | "key" | "bearer" | "basic";
+            name?: string | undefined;
+        } | undefined;
         endpoint?: string | undefined;
         spec?: string | undefined;
-    }, "spec">;
+    }, "spec" | "overlays">;
     requiredSecrets: string[];
     runtimeDeps: string[];
 } | {
@@ -604,17 +710,19 @@ export declare const referenceConfigSchema: z.ZodDefault<z.ZodArray<z.ZodPipe<z.
             noindex: boolean;
             seoDescriptionSuffix: boolean;
             spec: string;
+            overlays: string[];
             label?: string | undefined;
             route?: string | undefined;
         }[];
-        codeSamples: string[];
+        codeSamples: false | string[];
         playground: {
             enabled: boolean;
             proxy: string | boolean;
         };
         route: string;
+        overlays?: string[] | undefined;
         spec?: string | undefined;
-    }, "spec">;
+    }, "spec" | "overlays">;
     requiredSecrets: string[];
     runtimeDeps: string[];
 }>>>>;

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

@@ -69,6 +69,7 @@ declare const adapterVariants: readonly [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";
@@ -141,6 +142,7 @@ export declare const resolvedSearchAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         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";
@@ -212,6 +214,7 @@ export declare const resolvedSearchAdapterSchema: z.ZodPipe<z.ZodDiscriminatedUn
         apiKey: string;
         collection: string;
         host: string;
+        locale?: string | undefined;
         port?: number | undefined;
         protocol?: "http" | "https" | undefined;
     };

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/documents.d.ts

@@ -23,6 +23,10 @@ export interface SearchDocument {
      * Filterable through the MCP tools' `filters` input.
      */
     facets?: Record<string, string>;
+    /** Frontmatter `search.boost`: the page's relevance multiplier, when set. */
+    boost?: number;
+    /** Frontmatter `search.keywords`: extra terms the page is found by. */
+    keywords?: string[];
 }
 /**
  * A record uploaded to a hosted search backend (Algolia, Orama Cloud,
@@ -45,6 +49,13 @@ export interface SearchRecord {
     version: string;
     /** Single faceting tag (the first frontmatter tag, when present). */
     tag?: string;
+    /**
+     * The page's relevance multiplier, 1 unless `search.boost` sets it: a
+     * ranking attribute every record carries, so the backend can sort by it.
+     */
+    boost: number;
+    /** Extra terms the page is found by (`search.keywords`). */
+    keywords?: string[];
 }
 interface BuildOptions {
     includeWhenDisabled?: boolean;
@@ -84,7 +95,7 @@ export declare const buildSearchDocuments: (project: BlumeProject, options?: Bui
 /**
  * Map per-page search documents to the flat record shape hosted backends
  * ingest. One record per page, keyed by route; the first tag becomes the
- * faceting `tag`.
+ * faceting `tag`, and every record carries a `boost` (1 by default).
  */
 export declare const toSearchRecords: (documents: SearchDocument[]) => SearchRecord[];
 export {};