blume 2.1.1 → 2.1.3

package/dist/cli/{chunk-w1r4vase.js → chunk-s0bdnc7v.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   asciiSlugify
-} from "./chunk-ehweg4fr.js";
+} from "./chunk-124fvmzq.js";
 
 // src/ai/site-skill.ts
 var NAME_MAX = 64;
@@ -15,4 +15,4 @@ var siteSkillName = (project) => {
 export { siteSkillName };
 
 //# debugId=D5EE89A8D7931D3164756E2164756E21
-//# sourceMappingURL=chunk-w1r4vase.js.map
+//# sourceMappingURL=chunk-s0bdnc7v.js.map

package/dist/cli/{chunk-fdrkhpjy.js → chunk-sc93apfs.js}

@@ -16,31 +16,31 @@ import {
   applyPlan,
   readExistingPackage,
   nextSteps
-} from "./chunk-ehweg4fr.js";
+} from "./chunk-124fvmzq.js";
 import"./chunk-zccbjcj0.js";
-import"./chunk-ep6nd0rn.js";
+import"./chunk-nbyvgnnm.js";
 import {
   commandMeta,
   logger
 } from "./index.js";
-import"./chunk-n0v7m8ry.js";
-import"./chunk-ncj7w596.js";
-import"./chunk-gb420vvz.js";
-import"./chunk-66w9j7p6.js";
-import"./chunk-54ztw1nj.js";
+import"./chunk-desvm72z.js";
+import"./chunk-0pmb4tr4.js";
+import"./chunk-dpy8qdjf.js";
+import"./chunk-ckrcm08h.js";
+import"./chunk-j1x92mx9.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-cm89scdv.js";
-import"./chunk-c1y538kd.js";
+import"./chunk-es8h0v3j.js";
+import"./chunk-dqhg54mr.js";
 import {
   eject
-} from "./chunk-313vnn40.js";
+} from "./chunk-k3gr1nm9.js";
 import {
   updatePackageScripts
-} from "./chunk-mrcccgnh.js";
+} from "./chunk-53jqw8z0.js";
 import {
   installDependencies
-} from "./chunk-3v3ffbrj.js";
-import"./chunk-w1r4vase.js";
+} from "./chunk-dhwtqnnd.js";
+import"./chunk-s0bdnc7v.js";
 
 // src/cli/commands/init.ts
 import * as clack from "@clack/prompts";
@@ -332,4 +332,4 @@ export {
 };
 
 //# debugId=937A77D93EDC0DE164756E2164756E21
-//# sourceMappingURL=chunk-fdrkhpjy.js.map
+//# sourceMappingURL=chunk-sc93apfs.js.map

package/dist/cli/{chunk-dzwehpy7.js → chunk-tfycddbt.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveRuntimeDir
-} from "./chunk-ehweg4fr.js";
+} from "./chunk-124fvmzq.js";
 import {
   logger
 } from "./index.js";
@@ -197,4 +197,4 @@ var refuseIfDevRunning = (root, action, options = {}) => {
 export { readDevLock, DevLockHeldError, acquireDevLock, updateDevLockPort, describeDevLock, refuseIfDevRunning };
 
 //# debugId=BA0F0BBCC7BD124F64756E2164756E21
-//# sourceMappingURL=chunk-dzwehpy7.js.map
+//# sourceMappingURL=chunk-tfycddbt.js.map

package/dist/cli/{chunk-3x6x3pph.js → chunk-twy7psdz.js}

@@ -4,11 +4,11 @@ import {
   discoverIslands,
   discoverExamples,
   missingDependencyDiagnostic
-} from "./chunk-66w9j7p6.js";
+} from "./chunk-ckrcm08h.js";
 import {
   discoverPages,
   navTargetRoutes
-} from "./chunk-ehweg4fr.js";
+} from "./chunk-124fvmzq.js";
 import {
   packageRoot,
   commandMeta,
@@ -23,20 +23,20 @@ import {
 import {
   ComponentOverridesError,
   analyzeComponentOverrides
-} from "./chunk-54ztw1nj.js";
+} from "./chunk-j1x92mx9.js";
 import {
   validateNavTargets,
   scanProject
-} from "./chunk-ncj7w596.js";
+} from "./chunk-0pmb4tr4.js";
 import"./chunk-zccbjcj0.js";
 import"./chunk-jq5n4avg.js";
 import {
   unregisteredSnapshotDiagnostics
-} from "./chunk-sds923fa.js";
+} from "./chunk-5cmts6dv.js";
 import {
   serverFeatures,
   checkRequiredSecrets
-} from "./chunk-t2m5j4pr.js";
+} from "./chunk-ms9z66nz.js";
 
 // src/cli/commands/doctor.ts
 import { readFileSync } from "node:fs";
@@ -167,4 +167,4 @@ export {
 };
 
 //# debugId=A6107CD821E0AA4B64756E2164756E21
-//# sourceMappingURL=chunk-3x6x3pph.js.map
+//# sourceMappingURL=chunk-twy7psdz.js.map

package/dist/cli/{chunk-e9q7a2ak.js → chunk-y4msrwm9.js}

@@ -3,7 +3,7 @@ import {
   resolveRuntimeDir,
   resolveProjectContext,
   loadConfig
-} from "./chunk-ehweg4fr.js";
+} from "./chunk-124fvmzq.js";
 import"./chunk-zccbjcj0.js";
 import {
   commandMeta,
@@ -11,24 +11,24 @@ import {
 } from "./index.js";
 import {
   readDevLock
-} from "./chunk-dzwehpy7.js";
-import"./chunk-gb420vvz.js";
+} from "./chunk-tfycddbt.js";
+import"./chunk-dpy8qdjf.js";
 import {
   refuseIfEjected
-} from "./chunk-mrcccgnh.js";
-import"./chunk-ep6nd0rn.js";
-import"./chunk-n0v7m8ry.js";
-import"./chunk-ncj7w596.js";
-import"./chunk-66w9j7p6.js";
-import"./chunk-54ztw1nj.js";
+} from "./chunk-53jqw8z0.js";
+import"./chunk-nbyvgnnm.js";
+import"./chunk-desvm72z.js";
+import"./chunk-0pmb4tr4.js";
+import"./chunk-ckrcm08h.js";
+import"./chunk-j1x92mx9.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-cm89scdv.js";
-import"./chunk-c1y538kd.js";
+import"./chunk-es8h0v3j.js";
+import"./chunk-dqhg54mr.js";
 import {
   prepareProject
-} from "./chunk-e8xw9qkh.js";
-import"./chunk-t2m5j4pr.js";
-import"./chunk-w1r4vase.js";
+} from "./chunk-297ajdcv.js";
+import"./chunk-ms9z66nz.js";
+import"./chunk-s0bdnc7v.js";
 
 // src/cli/commands/sync.ts
 import { rm } from "node:fs/promises";
@@ -74,4 +74,4 @@ export {
 };
 
 //# debugId=67B7B6A961A6206764756E2164756E21
-//# sourceMappingURL=chunk-e9q7a2ak.js.map
+//# sourceMappingURL=chunk-y4msrwm9.js.map

package/dist/cli/{chunk-tdqhyxfz.js → chunk-ydp3065p.js}

@@ -3,7 +3,7 @@ import {
   deployPlatform,
   resolveProjectContext,
   loadConfig
-} from "./chunk-ehweg4fr.js";
+} from "./chunk-124fvmzq.js";
 import"./chunk-zccbjcj0.js";
 import {
   commandMeta,
@@ -12,13 +12,13 @@ import {
 } from "./index.js";
 import {
   deployOutputDir
-} from "./chunk-gb420vvz.js";
+} from "./chunk-dpy8qdjf.js";
 import {
   parsePort
-} from "./chunk-j134vrp2.js";
+} from "./chunk-74wfhv79.js";
 import {
   refuseIfEjected
-} from "./chunk-mrcccgnh.js";
+} from "./chunk-53jqw8z0.js";
 
 // src/cli/commands/preview.ts
 import { existsSync } from "node:fs";
@@ -61,4 +61,4 @@ export {
 };
 
 //# debugId=062E50A4A26E603564756E2164756E21
-//# sourceMappingURL=chunk-tdqhyxfz.js.map
+//# sourceMappingURL=chunk-ydp3065p.js.map

package/dist/cli/index.js

@@ -690,24 +690,24 @@ var main = defineCommand({
     version: getBlumeVersion()
   },
   subCommands: {
-    add: lazyCommand(commandMeta.add, () => import("./chunk-kma9f6sf.js"), "addCommand"),
-    audit: lazyCommand(commandMeta.audit, () => import("./chunk-e6atmn4h.js"), "auditCommand"),
-    build: lazyCommand(commandMeta.build, () => import("./chunk-073rdvgb.js"), "buildCommand"),
-    check: lazyCommand(commandMeta.check, () => import("./chunk-nq1d20w2.js"), "checkCommand"),
-    dev: lazyCommand(commandMeta.dev, () => import("./chunk-7ppf1rva.js"), "devCommand"),
-    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-3x6x3pph.js"), "doctorCommand"),
-    eject: lazyCommand(commandMeta.eject, () => import("./chunk-hx3xqnk9.js"), "ejectCommand"),
-    eval: lazyCommand(commandMeta.eval, () => import("./chunk-htrwgabr.js"), "evalCommand"),
-    init: lazyCommand(commandMeta.init, () => import("./chunk-fdrkhpjy.js"), "initCommand"),
-    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-hebn0tpx.js"), "mcpStdioCommand"),
-    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-c887fj0s.js"), "migrateCommand"),
-    preview: lazyCommand(commandMeta.preview, () => import("./chunk-tdqhyxfz.js"), "previewCommand"),
-    skill: lazyCommand(commandMeta.skill, () => import("./chunk-tphac74f.js"), "skillCommand"),
-    sync: lazyCommand(commandMeta.sync, () => import("./chunk-e9q7a2ak.js"), "syncCommand"),
-    translate: lazyCommand(commandMeta.translate, () => import("./chunk-5vjtgs6e.js"), "translateCommand"),
-    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-8y2kmjv8.js"), "upgradeCommand"),
-    validate: lazyCommand(commandMeta.validate, () => import("./chunk-cfyg47zg.js"), "validateCommand"),
-    version: lazyCommand(commandMeta.version, () => import("./chunk-ft9vfys6.js"), "versionCommand")
+    add: lazyCommand(commandMeta.add, () => import("./chunk-1f882900.js"), "addCommand"),
+    audit: lazyCommand(commandMeta.audit, () => import("./chunk-32khwcb6.js"), "auditCommand"),
+    build: lazyCommand(commandMeta.build, () => import("./chunk-36bxs9c7.js"), "buildCommand"),
+    check: lazyCommand(commandMeta.check, () => import("./chunk-0w6hs479.js"), "checkCommand"),
+    dev: lazyCommand(commandMeta.dev, () => import("./chunk-gxtg6ed2.js"), "devCommand"),
+    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-twy7psdz.js"), "doctorCommand"),
+    eject: lazyCommand(commandMeta.eject, () => import("./chunk-gfc5fqvf.js"), "ejectCommand"),
+    eval: lazyCommand(commandMeta.eval, () => import("./chunk-bqxaqn5p.js"), "evalCommand"),
+    init: lazyCommand(commandMeta.init, () => import("./chunk-sc93apfs.js"), "initCommand"),
+    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-ave1wcbr.js"), "mcpStdioCommand"),
+    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-kdpzw38a.js"), "migrateCommand"),
+    preview: lazyCommand(commandMeta.preview, () => import("./chunk-ydp3065p.js"), "previewCommand"),
+    skill: lazyCommand(commandMeta.skill, () => import("./chunk-a57yh0h9.js"), "skillCommand"),
+    sync: lazyCommand(commandMeta.sync, () => import("./chunk-y4msrwm9.js"), "syncCommand"),
+    translate: lazyCommand(commandMeta.translate, () => import("./chunk-bxwhtvw8.js"), "translateCommand"),
+    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-hvcxng5f.js"), "upgradeCommand"),
+    validate: lazyCommand(commandMeta.validate, () => import("./chunk-60hz265r.js"), "validateCommand"),
+    version: lazyCommand(commandMeta.version, () => import("./chunk-58bt3hag.js"), "versionCommand")
   }
 });
 loadEnvFiles(process.cwd());

package/dist/types/ai/ask.d.ts

@@ -57,7 +57,8 @@ export interface AssistantGatewayOptions extends AssistantAdapterOptions {
      * How much the model reasons before answering. Sent as the AI SDK's
      * top-level `reasoning` option, which the gateway maps to the model's own
      * control (OpenAI's `reasoning_effort`, for example); the model has to
-     * offer the level you pick. Omitted keeps the model's default.
+     * offer the level you pick. Omitted keeps the model's default. Assistant
+     * only.
      */
     reasoning?: AssistantReasoning;
     /** Narration only: the speech model's voice. Defaults to `alloy`. */
@@ -91,30 +92,46 @@ export declare const gatewayAdapterSchema: z.ZodObject<{
  * Blume ships.
  */
 export declare const gateway: (options?: AssistantGatewayOptions) => AssistantGatewayAdapter;
+export declare const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 /** Options for {@link openai}. */
 export interface AssistantOpenAIOptions extends AssistantAdapterOptions {
+    /**
+     * Name of the env var holding the key. Defaults to `OPENAI_API_KEY`, except
+     * for narration with a `baseUrl`, which sends only a key named here.
+     */
+    apiKeyEnv?: string;
     /**
      * An OpenAI-compatible endpoint to call instead of OpenAI
      * (`https://llm.internal.example.com/v1`): a self-hosted model or an
      * internal gateway. The route then talks Chat Completions through
      * `@ai-sdk/openai-compatible`, and the docs tools are off unless
      * `ai.assistant.tools` turns them on, since the model may not call tools.
+     * For narration, a server with OpenAI's speech API (`/audio/speech`),
+     * called through `@ai-sdk/openai` and sent only the key `apiKeyEnv` names,
+     * if any.
      */
     baseUrl?: string;
-    /** The model id (`gpt-5.5`). */
+    /**
+     * Narration only: how the voice should sound, for speech models that take
+     * instructions ("Read calmly, like a teacher").
+     */
+    instructions?: string;
+    /** The model id (`gpt-5.5`, or a speech model like `gpt-4o-mini-tts`). */
     model: string;
     /**
      * The provider name the AI SDK reports, which a custom endpoint also reads
      * its `providerOptions` under. Defaults to `openai`, or `openai-compatible`
-     * with a `baseUrl`.
+     * with a `baseUrl`. Assistant only.
      */
     name?: string;
     /**
      * How much the model reasons before answering, sent as `reasoning_effort`;
      * with a `baseUrl`, the endpoint has to accept that parameter. Omitted
-     * keeps the model's default.
+     * keeps the model's default. Assistant only.
      */
     reasoning?: AssistantReasoning;
+    /** Narration only: the speech model's voice. Defaults to `alloy`. */
+    voice?: string;
 }
 export type AssistantOpenAIAdapter = AdapterDescriptor<"openai", AssistantOpenAIOptions>;
 export declare const openaiAdapterSchema: z.ZodObject<{
@@ -142,7 +159,9 @@ export declare const openaiAdapterSchema: z.ZodObject<{
  * Route the assistant to OpenAI, or to any OpenAI-compatible endpoint with
  * `baseUrl`. Reads `OPENAI_API_KEY` and needs `@ai-sdk/openai` installed; a
  * custom endpoint needs `@ai-sdk/openai-compatible` instead, since most
- * don't serve OpenAI's Responses API.
+ * don't serve OpenAI's Responses API. Narration generates audio with it
+ * through `@ai-sdk/openai` either way, and with a `baseUrl` sends only the key
+ * `apiKeyEnv` names.
  */
 export declare const openai: (options: AssistantOpenAIOptions) => AssistantOpenAIAdapter;
 /**

package/dist/types/analytics/clics.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import type { AdapterDescriptor } from "../core/adapter.ts";
+import type { HeadScript } from "./head.ts";
+/** The browser tracker in Clics' installation guide. */
+export declare const CLICS_SCRIPT_SRC = "https://clics.dev/tracker.js";
+/** Public project ID and optional tracker flags. */
+export interface ClicsOptions {
+    /** Project ID from Configure → Tracking in the Clics dashboard. */
+    projectId: string;
+    /** Include localhost and 127.0.0.1 in a production build's reports. */
+    allowLocalhost?: boolean;
+    /** Turn off automatic outbound-link events. */
+    disableOutboundLinks?: boolean;
+}
+export declare const clicsOptionsSchema: z.ZodObject<{
+    allowLocalhost: z.ZodOptional<z.ZodBoolean>;
+    disableOutboundLinks: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+}, z.core.$strict>;
+export type ClicsAdapter = AdapterDescriptor<"clics", ClicsOptions>;
+export declare const clicsAdapterSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"clics">;
+    options: z.ZodObject<{
+        allowLocalhost: z.ZodOptional<z.ZodBoolean>;
+        disableOutboundLinks: z.ZodOptional<z.ZodBoolean>;
+        projectId: z.ZodString;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+/** Clics website analytics. The project ID is public in the tracker tag. */
+export declare const clics: (options: ClicsOptions) => ClicsAdapter;
+/**
+ * The documented deferred tracker tag. Clics reads these attributes from
+ * `document.currentScript` and tracks history changes without a Blume hook.
+ */
+export declare const clicsHead: (options: ClicsOptions) => HeadScript[];

package/dist/types/analytics/index.d.ts

@@ -28,6 +28,8 @@ export { clarity } from "./clarity.ts";
 export type { ClarityAdapter, ClarityOptions } from "./clarity.ts";
 export { clearbit } from "./clearbit.ts";
 export type { ClearbitAdapter, ClearbitOptions } from "./clearbit.ts";
+export { clics } from "./clics.ts";
+export type { ClicsAdapter, ClicsOptions } from "./clics.ts";
 export { cloudflare } from "./cloudflare.ts";
 export type { CloudflareAdapter, CloudflareOptions } from "./cloudflare.ts";
 export { databuddy } from "./databuddy.ts";

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

@@ -28,6 +28,15 @@ export declare const analyticsAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"clics">;
+    options: z.ZodObject<{
+        allowLocalhost: z.ZodOptional<z.ZodBoolean>;
+        disableOutboundLinks: z.ZodOptional<z.ZodBoolean>;
+        projectId: z.ZodString;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"cloudflare">;
     options: z.ZodObject<{
@@ -204,6 +213,15 @@ export declare const analyticsConfigSchema: z.ZodDefault<z.ZodArray<z.ZodDiscrim
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"clics">;
+    options: z.ZodObject<{
+        allowLocalhost: z.ZodOptional<z.ZodBoolean>;
+        disableOutboundLinks: z.ZodOptional<z.ZodBoolean>;
+        projectId: z.ZodString;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"cloudflare">;
     options: z.ZodObject<{

package/dist/types/astro/integration.d.ts

@@ -43,6 +43,12 @@ export declare const showBlumeErrorOverlay: (diagnostics: Diagnostic[]) => void;
 export type BlumePageRoute = CustomPageRoute;
 export interface BlumeIntegrationOptions {
     pages: BlumePageRoute[];
+    /**
+     * Whether responses name Blume in `X-Powered-By` (see
+     * `core/powered-by.ts`): the dev server's, and the server-rendered ones of
+     * a build, through the runtime middleware. Defaults to `true`.
+     */
+    poweredBy?: boolean;
     /**
      * Page routes that have a raw-Markdown variant (the content manifest). The
      * hidden runtime leaves this out: the CLI publishes the live set through

package/dist/types/core/config-input.d.ts

@@ -1,5 +1,5 @@
 import type { AstroIntegration } from "astro";
-import type { AssistantAdapter, AssistantGatewayAdapter } from "../ai/ask.ts";
+import type { AssistantAdapter, AssistantGatewayAdapter, AssistantOpenAIAdapter } from "../ai/ask.ts";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { AnalyticsAdapter } from "../analytics/schema.ts";
 import type { CaptchaAdapter } from "../captcha/schema.ts";
@@ -1255,9 +1255,11 @@ export type NarrationConfig = boolean | {
     /**
      * Generate audio at build with a speech model:
      * `gateway({ model: "openai/tts-1-hd", voice: "alloy" })` from
-     * `blume/ai`. Without it, pages are read with browser voices.
+     * `blume/ai`, or `openai({ model, voice })` for OpenAI or, with a
+     * `baseUrl`, any OpenAI-compatible speech endpoint. Without it, pages
+     * are read with browser voices.
      */
-    provider?: AssistantGatewayAdapter;
+    provider?: AssistantGatewayAdapter | AssistantOpenAIAdapter;
 };
 /**
  * Opt-in custom frontmatter keys. Page frontmatter is strictly validated —
@@ -1430,6 +1432,8 @@ export interface BlumeConfig {
     narration?: NarrationConfig;
     /** Header, sidebar, tabs, and switchers. */
     navigation?: NavigationConfig;
+    /** Send `X-Powered-By: Blume` with responses. Defaults to `true`. */
+    poweredBy?: boolean;
     /**
      * Limit how often one reader (by IP address) can call the server routes —
      * the assistant, the API playground proxy, server-side search — with an

package/dist/types/core/powered-by.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The header that names Blume as the framework behind a response, sent unless
+ * `poweredBy` is `false`. The dev server and Blume's runtime middleware
+ * (`components/powered-by-middleware.ts`) send it, and so does every host
+ * for the built site: static hosts through `deploy/headers.ts`'s rules,
+ * server builds through each platform's own mechanism (`deploy/platforms`).
+ * It lives apart from those modules so the runtime middleware can import it
+ * without pulling in the deploy code.
+ */
+export declare const POWERED_BY_HEADERS: {
+    "X-Powered-By": string;
+};