blume 2.0.0 → 2.0.2

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

@@ -1,5 +1,5 @@
 import type { OramaDoc } from "../search/orama-index.ts";
-/** A chat message as posted by the Ask AI island (`{ role, content }`). */
+/** A chat message as posted by the assistant island (`{ role, content }`). */
 export interface AskMessage {
     content: string;
     role: string;
@@ -9,7 +9,7 @@ export interface AskPage {
     path?: string;
 }
 /**
- * The self-contained snapshot the grounded Ask AI endpoint imports. Bundles the
+ * The self-contained snapshot the assistant's grounded endpoint imports. Bundles the
  * search documents so retrieval works regardless of the configured search
  * provider and needs no filesystem access at request time. Serialized to
  * `generated/ask-data.json` and built by {@link buildAskData}.
@@ -23,9 +23,16 @@ export interface AskData {
     defaultLocale?: string;
     documents: OramaDoc[];
     site: string | null;
+    /**
+     * Present on a versioned site, whose documents then carry their `version`
+     * (`""` for the current docs): retrieval keeps to the version the reader
+     * is viewing — the current docs unless they're on an archived page — as
+     * the search dialog does.
+     */
+    versioned?: boolean;
 }
 /**
- * How much retrieved documentation a question carries (the `ai.ask.retrieval`
+ * How much retrieved documentation a question carries (the `ai.assistant.retrieval`
  * config). Every field falls back to the built-in default, so a partial object
  * only changes what it names. Injected characters dominate time-to-first-token
  * on a self-hosted backend, and the three knobs aren't interchangeable: the
@@ -49,7 +56,7 @@ export interface AskRetrievalOptions {
  *
  * Pages are indexed whole (one document each), so a naive head slice of a long
  * page returns its intro and misses sections below the fold — the exact failure
- * where "How does Ask AI work?" retrieves the right page but only sees its
+ * where "How does the assistant work?" retrieves the right page but only sees its
  * opening paragraph. This centers the window on the densest cluster of query
  * terms so the injected text is the part that actually answers the question.
  * Exported for testing; {@link createAskContext} is the runtime entry point.
@@ -81,7 +88,7 @@ export declare const parsePage: (content: string) => ParsedPage;
 /** {@link excerptPage} over a page parsed on the spot. Exported for testing. */
 export declare const sectionExcerpt: (content: string, query: string, max: number) => string;
 /**
- * Build the request-time grounding function for the Ask AI endpoint.
+ * Build the request-time grounding function for the assistant endpoint.
  *
  * Lexical retrieval over Orama (the same index/ranking the search dialog and MCP
  * server use). The index is built once and memoized across requests. Returns a
@@ -89,12 +96,12 @@ export declare const sectionExcerpt: (content: string, query: string, max: numbe
  * viewing — or `undefined` when there is nothing to ground on, so the endpoint
  * can fall back to its plain prompt.
  *
- * `options.instructions` (the `ai.ask.instructions` config) is appended after
+ * `options.instructions` (the `ai.assistant.instructions` config) is appended after
  * the base instruction rather than replacing it: the base carries the
  * functional contract (answer only from the excerpts, cite pages as Markdown
  * links) that the panel's citation rendering depends on.
  *
- * `options.retrieval` (the `ai.ask.retrieval` config) sizes how much
+ * `options.retrieval` (the `ai.assistant.retrieval` config) sizes how much
  * documentation each question carries; omitted fields keep today's defaults.
  */
 export declare const createAskContext: (data: AskData, options?: {

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

@@ -5,17 +5,17 @@ import type { AdapterDescriptor, JsonValue } from "../core/adapter.ts";
  * `reasoning` values minus `provider-default`, which is what omitting the
  * option means.
  */
-export declare const askReasoningLevels: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
+export declare const assistantReasoningLevels: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
 /** How much the model reasons before answering (an adapter's `reasoning`). */
-export type AskReasoning = (typeof askReasoningLevels)[number];
+export type AssistantReasoning = (typeof assistantReasoningLevels)[number];
 /**
  * The AI SDK's `providerOptions` shape, forwarded to `streamText` verbatim:
  * `{ [provider]: { [option]: value } }`. The escape hatch for model controls
  * Blume doesn't name, so a new provider knob never needs a Blume field.
  */
-export type AskProviderOptions = Record<string, Record<string, JsonValue>>;
-/** The options every Ask AI adapter accepts. */
-export interface AskAdapterOptions {
+export type AssistantProviderOptions = Record<string, Record<string, JsonValue>>;
+/** The options every assistant adapter accepts. */
+export interface AssistantAdapterOptions {
     /**
      * Name of the env var holding the provider's API key. Each adapter has its
      * own default; set this only to point at a different variable.
@@ -32,10 +32,10 @@ export interface AskAdapterOptions {
      * Options passed to `streamText` as its `providerOptions`, untouched, in the
      * AI SDK's own shape (`{ openai: { textVerbosity: "low" } }`, say).
      */
-    providerOptions?: AskProviderOptions;
+    providerOptions?: AssistantProviderOptions;
 }
 /** Options for {@link gateway}. */
-export interface AskGatewayOptions extends AskAdapterOptions {
+export interface AssistantGatewayOptions extends AssistantAdapterOptions {
     /** A `provider/model` id routed by the gateway. Defaults to `openai/gpt-5.5`. */
     model?: string;
     /**
@@ -44,9 +44,9 @@ export interface AskGatewayOptions extends AskAdapterOptions {
      * control (OpenAI's `reasoning_effort`, for example); the model has to
      * offer the level you pick. Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskGatewayAdapter = AdapterDescriptor<"gateway", AskGatewayOptions>;
+export type AssistantGatewayAdapter = AdapterDescriptor<"gateway", AssistantGatewayOptions>;
 export declare const gatewayAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"gateway">;
     options: z.ZodObject<{
@@ -67,14 +67,14 @@ export declare const gatewayAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through the Vercel AI Gateway (the default). `model` is a
+ * Route the assistant through the Vercel AI Gateway (the default). `model` is a
  * `provider/model` string; the key is `AI_GATEWAY_API_KEY`, or Vercel's OIDC
  * token when deployed there. Needs no provider SDK beyond the `ai` package
  * Blume ships.
  */
-export declare const gateway: (options?: AskGatewayOptions) => AskGatewayAdapter;
+export declare const gateway: (options?: AssistantGatewayOptions) => AssistantGatewayAdapter;
 /** Options for {@link openrouter}. */
-export interface AskOpenRouterOptions extends AskAdapterOptions {
+export interface AssistantOpenRouterOptions extends AssistantAdapterOptions {
     /** The OpenRouter model id (`anthropic/claude-sonnet-4-5`). */
     model: string;
     /**
@@ -82,9 +82,9 @@ export interface AskOpenRouterOptions extends AskAdapterOptions {
      * OpenRouter's `reasoning.effort`, because its provider ignores the AI
      * SDK's call-level option. Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskOpenRouterAdapter = AdapterDescriptor<"openrouter", AskOpenRouterOptions>;
+export type AssistantOpenRouterAdapter = AdapterDescriptor<"openrouter", AssistantOpenRouterOptions>;
 export declare const openrouterAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"openrouter">;
     options: z.ZodObject<{
@@ -105,12 +105,12 @@ export declare const openrouterAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through OpenRouter. Reads `OPENROUTER_API_KEY` and needs
+ * Route the assistant through OpenRouter. Reads `OPENROUTER_API_KEY` and needs
  * `@openrouter/ai-sdk-provider` installed in the project.
  */
-export declare const openrouter: (options: AskOpenRouterOptions) => AskOpenRouterAdapter;
+export declare const openrouter: (options: AssistantOpenRouterOptions) => AssistantOpenRouterAdapter;
 /** Options for {@link llmgateway}. */
-export interface AskLlmGatewayOptions extends AskAdapterOptions {
+export interface AssistantLlmGatewayOptions extends AssistantAdapterOptions {
     /** Overrides the preset endpoint (`https://api.llmgateway.io/v1`). */
     baseUrl?: string;
     /** The model id LLMGateway serves. */
@@ -119,9 +119,9 @@ export interface AskLlmGatewayOptions extends AskAdapterOptions {
      * How much the model reasons before answering, sent in the request as
      * `reasoning_effort`. Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskLlmGatewayAdapter = AdapterDescriptor<"llmgateway", AskLlmGatewayOptions>;
+export type AssistantLlmGatewayAdapter = AdapterDescriptor<"llmgateway", AssistantLlmGatewayOptions>;
 export declare const llmgatewayAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"llmgateway">;
     options: z.ZodObject<{
@@ -143,21 +143,21 @@ export declare const llmgatewayAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through LLMGateway's OpenAI-compatible endpoint. Reads
+ * Route the assistant through LLMGateway's OpenAI-compatible endpoint. Reads
  * `LLMGATEWAY_API_KEY` and needs `@ai-sdk/openai-compatible` installed.
  */
-export declare const llmgateway: (options: AskLlmGatewayOptions) => AskLlmGatewayAdapter;
+export declare const llmgateway: (options: AssistantLlmGatewayOptions) => AssistantLlmGatewayAdapter;
 /**
  * Options for {@link inkeep}. No `reasoning`: Inkeep runs its own QA pipeline
  * behind an OpenAI-compatible endpoint with no reasoning control.
  */
-export interface AskInkeepOptions extends AskAdapterOptions {
+export interface AssistantInkeepOptions extends AssistantAdapterOptions {
     /** Overrides the preset endpoint (`https://api.inkeep.com/v1`). */
     baseUrl?: string;
     /** The Inkeep QA model id. */
     model: string;
 }
-export type AskInkeepAdapter = AdapterDescriptor<"inkeep", AskInkeepOptions>;
+export type AssistantInkeepAdapter = AdapterDescriptor<"inkeep", AssistantInkeepOptions>;
 export declare const inkeepAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"inkeep">;
     options: z.ZodObject<{
@@ -175,9 +175,9 @@ export declare const inkeepAdapterSchema: z.ZodObject<{
  * dashboard, so Blume leaves it ungrounded and it takes no `reasoning`.
  * Reads `INKEEP_API_KEY` and needs `@ai-sdk/openai-compatible` installed.
  */
-export declare const inkeep: (options: AskInkeepOptions) => AskInkeepAdapter;
+export declare const inkeep: (options: AssistantInkeepOptions) => AssistantInkeepAdapter;
 /** Options for {@link openaiCompatible}. */
-export interface AskOpenAICompatibleOptions extends AskAdapterOptions {
+export interface AssistantOpenAICompatibleOptions extends AssistantAdapterOptions {
     /** Name of the env var holding the endpoint's API key. */
     apiKeyEnv: string;
     /** The endpoint's base URL (`https://my-gateway.example.com/v1`). */
@@ -191,9 +191,9 @@ export interface AskOpenAICompatibleOptions extends AskAdapterOptions {
      * `reasoning_effort`, so the endpoint has to accept that parameter.
      * Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskOpenAICompatibleAdapter = AdapterDescriptor<"openai-compatible", AskOpenAICompatibleOptions>;
+export type AssistantOpenAICompatibleAdapter = AdapterDescriptor<"openai-compatible", AssistantOpenAICompatibleOptions>;
 export declare const openaiCompatibleAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"openai-compatible">;
     options: z.ZodObject<{
@@ -216,28 +216,28 @@ export declare const openaiCompatibleAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through any OpenAI-compatible endpoint: supply its `baseUrl`,
+ * Route the assistant through any OpenAI-compatible endpoint: supply its `baseUrl`,
  * the `model` it serves, and the env var holding its key. Needs
  * `@ai-sdk/openai-compatible` installed.
  */
-export declare const openaiCompatible: (options: AskOpenAICompatibleOptions) => AskOpenAICompatibleAdapter;
-/** Which backend answers Ask AI: the value of `gateway()`, `openrouter()`, … */
-export type AskAdapter = AskGatewayAdapter | AskOpenRouterAdapter | AskLlmGatewayAdapter | AskInkeepAdapter | AskOpenAICompatibleAdapter;
+export declare const openaiCompatible: (options: AssistantOpenAICompatibleOptions) => AssistantOpenAICompatibleAdapter;
+/** Which backend answers the assistant: the value of `gateway()`, `openrouter()`, … */
+export type AssistantAdapter = AssistantGatewayAdapter | AssistantOpenRouterAdapter | AssistantLlmGatewayAdapter | AssistantInkeepAdapter | AssistantOpenAICompatibleAdapter;
 /**
- * Error params for `ai.ask`: a 1.x flat provider field (`model`, `apiKeyEnv`,
+ * Error params for `ai.assistant`: a 1.x flat provider field (`model`, `apiKeyEnv`,
  * `baseUrl`, `headers`, `reasoning`) names the adapter call it moves into —
  * the one the object's `provider` picks, 1.x string or descriptor — instead
  * of Zod's bare "Unrecognized key"; any other unknown key keeps its wording.
  */
-export declare const askMovedFieldsHint: {
+export declare const assistantMovedFieldsHint: {
     error: (issue: z.core.$ZodRawIssue) => string | undefined;
 };
 /**
- * `ai.ask.provider`: the descriptor an adapter factory returned, validated
+ * `ai.assistant.provider`: the descriptor an adapter factory returned, validated
  * against that adapter's own option schema. A value that isn't a descriptor
  * at all (a 1.x provider name) names the factory that replaced it.
  */
-export declare const askAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const assistantAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"gateway">;
     options: z.ZodObject<{
         model: z.ZodDefault<z.ZodString>;
@@ -324,11 +324,11 @@ export declare const askAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>], "kind">;
-/** A resolved (post-defaults) `ai.ask.provider` descriptor. */
-export type AskAdapterConfig = z.output<typeof askAdapterSchema>;
-export type AskAdapterKind = AskAdapterConfig["kind"];
-/** The provider when `ai.ask.provider` is unset: the gateway with its defaults. */
-export declare const DEFAULT_ASK_PROVIDER: AskAdapter;
+/** A resolved (post-defaults) `ai.assistant.provider` descriptor. */
+export type AssistantAdapterConfig = z.output<typeof assistantAdapterSchema>;
+export type AssistantAdapterKind = AssistantAdapterConfig["kind"];
+/** The provider when `ai.assistant.provider` is unset: the gateway with its defaults. */
+export declare const DEFAULT_ASSISTANT_PROVIDER: AssistantAdapter;
 /** The route fragments an adapter contributes to `askEndpointTemplate`. */
 export interface AskBackendTemplate {
     /**
@@ -357,12 +357,12 @@ export interface AskBackendTemplate {
 export interface AskBackend {
     /** Whether Blume grounds answers in the docs (Inkeep retrieves itself). */
     grounded: boolean;
-    kind: AskAdapterKind;
+    kind: AssistantAdapterKind;
     /** Human-readable adapter name for diagnostics ("AI Gateway"). */
     label: string;
     /** Appended to the missing-secret warning (an alternative credential, say). */
     secretNote?: string;
     template: AskBackendTemplate;
 }
-/** Resolve a parsed `ai.ask.provider` descriptor into its backend. */
-export declare const resolveAskBackend: (provider?: AskAdapterConfig) => AskBackend;
+/** Resolve a parsed `ai.assistant.provider` descriptor into its backend. */
+export declare const resolveAskBackend: (provider?: AssistantAdapterConfig) => AskBackend;

package/dist/types/ai/component-markdown.d.ts

@@ -149,10 +149,10 @@ export declare const downlevelComponentNode: (node: MdastNode, walk: DownlevelWa
  * over the built-ins: a same-name entry replaces the built-in serializer, and
  * one that always returns `null` effectively opts that component out.
  *
- * `frontmatter` is the page's parsed front-matter data. It is put in scope
- * when evaluating attribute expressions — so `prop={frontmatter.status}`
- * resolves the way it does when Astro renders the page — and handed to
- * serializers on their context.
+ * `frontmatter` is the page's parsed front-matter data. Attribute
+ * expressions that reference it — `prop={frontmatter.status}` — resolve the
+ * way they do when Astro renders the page, and it is handed to serializers on
+ * their context. Expressions are read as literal data, never executed.
  */
 export declare const downlevelComponents: (source: string, components?: Record<string, ComponentMarkdown>, frontmatter?: Record<string, EvaluatedValue>) => string;
 export {};

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

@@ -1,5 +1,5 @@
 /**
- * Ask AI provider adapters for `blume.config.ts`:
+ * Assistant provider adapters for `blume.config.ts`:
  *
  * ```ts
  * import { defineConfig } from "blume";
@@ -7,7 +7,7 @@
  *
  * export default defineConfig({
  *   ai: {
- *     ask: {
+ *     assistant: {
  *       enabled: true,
  *       provider: openrouter({ model: "anthropic/claude-sonnet-4-5" }),
  *     },
@@ -20,5 +20,5 @@
  * nothing here runs at request time.
  */
 export { gateway, inkeep, llmgateway, openaiCompatible, openrouter, } from "./ask.ts";
-export type { AskAdapter, AskAdapterOptions, AskGatewayAdapter, AskGatewayOptions, AskInkeepAdapter, AskInkeepOptions, AskLlmGatewayAdapter, AskLlmGatewayOptions, AskOpenAICompatibleAdapter, AskOpenAICompatibleOptions, AskOpenRouterAdapter, AskOpenRouterOptions, AskProviderOptions, AskReasoning, } from "./ask.ts";
+export type { AssistantAdapter, AssistantAdapterOptions, AssistantGatewayAdapter, AssistantGatewayOptions, AssistantInkeepAdapter, AssistantInkeepOptions, AssistantLlmGatewayAdapter, AssistantLlmGatewayOptions, AssistantOpenAICompatibleAdapter, AssistantOpenAICompatibleOptions, AssistantOpenRouterAdapter, AssistantOpenRouterOptions, AssistantProviderOptions, AssistantReasoning, } from "./ask.ts";
 export type { AdapterDescriptor } from "../core/adapter.ts";

package/dist/types/ai/openapi-components.d.ts

@@ -7,7 +7,7 @@ import type { OpenApiData } from "../openapi/model.ts";
  * the body plus one of these components, deliberately: the structured UI is the
  * component's job, and the prose stays Markdown so it indexes. That split is
  * right for the rendered page and lossy everywhere else — `<route>.md`,
- * llms-full.txt, MCP `get_page` and the Ask AI corpus all downlevel components
+ * llms-full.txt, MCP `get_page` and the assistant corpus all downlevel components
  * to Markdown, and these three had no serializer, so an operation page reached
  * an agent as its description followed by a bare tag. On a site whose reference
  * is most of the corpus, that is most of the corpus: measured on one 449-page

package/dist/types/ai/relative-links.d.ts

@@ -1,14 +1,19 @@
 import type { BlumeProject } from "../core/project-graph.ts";
 /**
- * Relative page links on the agent surfaces — the `.md`/`.mdx` mirrors,
+ * Page links on the agent surfaces — the `.md`/`.mdx` mirrors,
  * llms-full.txt, MCP `get_page` and `resources/read`. An agent resolves
  * `[Install](./install)` against the URL it fetched (`/guides.md`), so the
  * link lands on `/install`; the rendered page rewrites it to the route it
  * means (`markdown/relative-links.ts`), and the Markdown an agent reads gets
  * the same rewrite from the same resolver (`resolveRelativeHref`), so both
- * point at one page. Inline links and reference definitions are rewritten;
- * fenced and inline code, images, and anything not a relative page link are
- * left as written.
+ * point at one page. Root-relative page links (`[x](/guide)`,
+ * `<Card href="/guide">`) get what the rendered page gives them too: the
+ * `deployment.base` + `basePath` prefix (`markdown/base-links.ts`,
+ * `components/content/base-href.ts`) and, on a page in a prefixed locale,
+ * that locale's copy of the route when it is served
+ * (`components/layout/LocaleLinks.astro`). Inline links, component `href`s,
+ * and reference definitions are rewritten; fenced and inline code, images,
+ * asset links, and external URLs are left as written.
  */
 /** The page a Markdown text was written for. */
 export interface LinkedPage {

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

@@ -1,7 +1,7 @@
 import type { BlumeProject } from "../core/project-graph.ts";
 /**
  * Every serializer a project brings to a downlevel pass, layered once for all
- * the agent surfaces (`<route>.md`, llms-full.txt, the search and Ask AI
+ * the agent surfaces (`<route>.md`, llms-full.txt, the search and assistant
  * corpora): the built-in families that read project data — examples, then the
  * API reference — under the user's `agents.markdownComponents`, which is spread
  * last so an entry of the same name still wins. One layering, so a new family

package/dist/types/ai/static-expression.d.ts

@@ -0,0 +1,28 @@
+import type { EvaluatedValue } from "./component-markdown.ts";
+/**
+ * Read an MDX attribute expression (`prop={...}`) as literal data, without
+ * running it. The agent Markdown downleveler converts components on every
+ * page it is handed — plain `.md` pages Astro never executes, and content a
+ * CMS or a release feed supplies — so an expression is parsed, never
+ * evaluated: only data a reader could see by looking at it is recovered.
+ *
+ * Accepted: string, number, boolean, `null`, and `undefined` literals; array
+ * and object literals, nested; unary minus on a number; template literals
+ * whose substitutions are themselves accepted; and `frontmatter.<path>`
+ * member access (dot steps, or bracketed string and number literals),
+ * resolved against the page's front matter the way `prop={frontmatter.status}`
+ * resolves when Astro renders the page. Comments are skipped. Anything else —
+ * a call, an operator, a spread, a shorthand property, any other name — is
+ * not static, and the caller keeps the component's JSX as written.
+ */
+/** The outcome of reading an expression: its value, or `ok: false`. */
+export interface StaticExpressionResult {
+    ok: boolean;
+    value: EvaluatedValue;
+}
+/**
+ * Read `raw` — an attribute expression's source — as static data, with
+ * `frontmatter` (the page's front matter, when the caller has it) behind
+ * `frontmatter.<path>` references. Never executes anything.
+ */
+export declare const readStaticExpression: (raw: string, frontmatter?: Record<string, EvaluatedValue>) => StaticExpressionResult;

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

@@ -11,7 +11,7 @@ export type VisibilityAudience = "agents" | "web";
 export declare const applyAudienceVisibility: (markdown: string, audience: VisibilityAudience) => string;
 /**
  * Resolve `<Visibility>` blocks for agent-facing Markdown (llms-full.txt, the
- * `.md`/`.mdx` mirrors, MCP tools, Ask AI grounding): `for="web"` content is
+ * `.md`/`.mdx` mirrors, MCP tools, assistant grounding): `for="web"` content is
  * removed and `for="agents"` content is unwrapped.
  */
 export declare const applyAgentVisibility: (markdown: string) => string;

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

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import type { AdapterDescriptor } from "../core/adapter.ts";
+import type { HeadScript } from "./head.ts";
+/** The script Databuddy's install snippet loads. */
+export declare const DATABUDDY_SCRIPT_SRC = "https://cdn.databuddy.cc/databuddy.js";
+/** The options {@link databuddy} maps itself. */
+export interface DatabuddyNamedOptions {
+    /** Client ID, from the website's settings in the Databuddy dashboard. */
+    clientId: string;
+}
+/**
+ * Options for {@link databuddy}: the client ID plus any other tracker setting,
+ * forwarded as a `data-` attribute on the tag (`"track-web-vitals"` →
+ * `data-track-web-vitals`, `"track-errors"`, `"track-outgoing-links"`,
+ * `"api-url"`, …).
+ */
+export type DatabuddyOptions = DatabuddyNamedOptions & {
+    [setting: string]: string;
+};
+export declare const databuddyOptionsSchema: z.ZodObject<{
+    clientId: z.ZodString;
+}, z.core.$catchall<z.ZodString>>;
+export type DatabuddyAdapter = AdapterDescriptor<"databuddy", DatabuddyOptions>;
+export declare const databuddyAdapterSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"databuddy">;
+    options: z.ZodObject<{
+        clientId: z.ZodString;
+    }, z.core.$catchall<z.ZodString>>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Databuddy. The client ID is public — it's in the tag on every page.
+ */
+export declare const databuddy: (options: DatabuddyOptions) => DatabuddyAdapter;
+/**
+ * The async tag from the install instructions, with `clientId` as
+ * `data-client-id` and every other option as its own `data-` attribute. The
+ * tracker skips setup when `window.databuddy` already exists, so there is no
+ * queue stub. Databuddy's script tracks history changes on its own, so
+ * client-router navigations need no extra hook.
+ */
+export declare const databuddyHead: (options: DatabuddyOptions) => HeadScript[];

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

@@ -30,6 +30,8 @@ export { clearbit } from "./clearbit.ts";
 export type { ClearbitAdapter, ClearbitOptions } from "./clearbit.ts";
 export { cloudflare } from "./cloudflare.ts";
 export type { CloudflareAdapter, CloudflareOptions } from "./cloudflare.ts";
+export { databuddy } from "./databuddy.ts";
+export type { DatabuddyAdapter, DatabuddyOptions } from "./databuddy.ts";
 export { fathom } from "./fathom.ts";
 export type { FathomAdapter, FathomOptions } from "./fathom.ts";
 export { googleAnalytics } from "./google-analytics.ts";

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

@@ -35,6 +35,13 @@ export declare const analyticsAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     }, z.core.$catchall<z.ZodJSONSchema>>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"databuddy">;
+    options: z.ZodObject<{
+        clientId: z.ZodString;
+    }, z.core.$catchall<z.ZodString>>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"fathom">;
     options: z.ZodObject<{
@@ -197,6 +204,13 @@ export declare const analyticsConfigSchema: z.ZodDefault<z.ZodArray<z.ZodDiscrim
     }, z.core.$catchall<z.ZodJSONSchema>>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"databuddy">;
+    options: z.ZodObject<{
+        clientId: z.ZodString;
+    }, z.core.$catchall<z.ZodString>>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"fathom">;
     options: z.ZodObject<{

package/dist/types/cli/env.d.ts

@@ -8,5 +8,10 @@
  * these files at build time, so a value means the same thing to the pre-boot
  * content scan and the built site — including multi-line double-quoted values
  * (PEM keys), which a line-based parser silently truncates.
+ *
+ * `NODE_ENV` is never taken from these files: it picks the mode Vite and Astro
+ * run in, so a monorepo root `.env` that sets it for another app would turn
+ * every `blume build` into a development build (or `blume dev` into a
+ * production one).
  */
 export declare const loadEnvFiles: (startDir: string) => void;

package/dist/types/cli/init/scaffold.d.ts

@@ -33,6 +33,10 @@ export declare const STARTERS: {
             content: string;
             path: string;
         }[];
+        projectFiles: {
+            content: string;
+            path: string;
+        }[];
     };
     changelog: {
         configExtra: string;
@@ -71,6 +75,11 @@ export declare const commandsFor: (pm: PackageManager) => {
     exec: string;
     install: string;
 };
+/**
+ * The `cd` into the new project, quoting a directory a shell would split or
+ * expand: `blume init "my docs"` prints `cd "my docs"`, not `cd my docs`.
+ */
+export declare const cdCommand: (directory: string) => string;
 /**
  * Derive the package manager from an npm user-agent string (the first
  * `name/version` token of `npm_config_user_agent`), falling back to npm.
@@ -97,6 +106,12 @@ export declare const validateContentDir: (root: string, dir: string) => string |
 export declare const titleize: (raw: string) => string;
 /** The full `blume.config.ts` text for the chosen answers. */
 export declare const buildConfig: (answers: InitAnswers) => string;
+/**
+ * Whether `init` installs with pnpm into a folder that sits inside a pnpm
+ * workspace without being one of its packages. pnpm would install that
+ * workspace's own packages from there and exit 0, leaving `blume` uninstalled.
+ */
+export declare const outsidePnpmWorkspace: (root: string, answers: InitAnswers) => boolean;
 /**
  * The major version of the Yarn that ran `init`, read off the npm user agent
  * (`yarn/4.5.1 npm/? node/v22…`), or undefined when something else ran it.
@@ -108,9 +123,10 @@ export interface PlanEnvironment {
     userAgent?: string;
 }
 /**
- * What the project still needs from a workspace it joins, when `init` left
- * that workspace's config alone: pnpm's approval for esbuild's build script
- * (pnpm 10 and later fail the install without it), or Yarn Berry's
+ * What the project still needs from a workspace it sits in, when `init` left
+ * that workspace's config alone: a place in a pnpm workspace's `packages`
+ * (pnpm skips a folder it doesn't list), pnpm's approval for esbuild's build
+ * script (pnpm 10 and later fail the install without it), or Yarn Berry's
  * `node_modules` linker. Undefined when the workspace already has it, or the
  * project doesn't sit in one.
  */

package/dist/types/cli/init/starter-spec.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The OpenAPI document the `api` starter writes beside `blume.config.ts`, so a
+ * new project's first build reads a local file instead of depending on a
+ * third-party server. Small, but it exercises what a real reference renders:
+ * path and query parameters, request bodies, shared schemas, error responses,
+ * and bearer auth. Each operation's description is sized so its page's meta
+ * description, with the endpoint sentence Blume appends, fits the range
+ * `blume audit` checks.
+ */
+/** The starter spec as the `openapi.json` text `init` writes. */
+export declare const STARTER_OPENAPI_JSON: string;

package/dist/types/core/base-path.d.ts

@@ -51,6 +51,15 @@ export declare const isExternalUrl: (target: string) => boolean;
  * the base by hand (`/docs/x`) aren't double-prefixed to `/docs/docs/x`.
  */
 export declare const withBasePath: (basePath: string, route: string) => string;
+/**
+ * Mount a route Blume generates from content under `basePath`,
+ * unconditionally. {@link withBasePath} leaves a route that already starts
+ * with the base alone, which is right for a link an author based by hand but
+ * wrong for a content route: with `basePath: "/docs"`, `docs/guide.md` routes
+ * to `/docs/guide` before the base and publishes at `/docs/docs/guide`, not on
+ * top of the root `guide.md`.
+ */
+export declare const mountBasePath: (basePath: string, route: string) => string;
 /**
  * {@link withBasePath} for the composed `deployment.base` + `basePath` stack
  * (`/base` + `/docs` serves pages at `/base/docs/x`). The hand-written-base