blume 1.5.2 → 1.6.0

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

@@ -1,4 +1,43 @@
 import type { ExampleLookup } from "../core/types.ts";
+/**
+ * Downlevel Blume's MDX components to plain Markdown for agent-facing output
+ * (the `/<route>.md` mirror, llms-full.txt, MCP `get_page`). Each supported
+ * component has a serializer — its "toString" — that renders the same
+ * information as the Astro component, but as portable Markdown: `<TypeTable>`
+ * becomes a GFM table, `<Callout>` a blockquote, `<Steps>` an ordered list,
+ * `<Tabs>` labeled sections, `<YouTube>` a link.
+ *
+ * The transform is a position splice, not a re-stringify: the MDX source is
+ * parsed to MDAST (via Satteri, which stamps byte offsets on every node) and
+ * only the matched component ranges are replaced, so all surrounding Markdown
+ * stays byte-identical to what the author wrote. Anything the serializers
+ * can't faithfully convert — an unknown component, a prop bound to an import —
+ * is left as JSX, and fenced code that merely *shows* component markup is
+ * naturally untouched because it parses as a `code` node.
+ */
+/** Minimal structural MDAST types — we model only what this module reads. */
+interface Offset {
+    offset: number;
+}
+/** The structural slice of an mdast node the downlevel walk reads. */
+export interface MdastNode {
+    attributes?: MdxAttribute[];
+    children?: MdastNode[];
+    name?: string;
+    position?: {
+        end: Offset;
+        start: Offset;
+    };
+    type: string;
+}
+interface MdxAttribute {
+    name?: string;
+    type: string;
+    value?: string | {
+        type: string;
+        value: string;
+    } | null;
+}
 /**
  * A statically-recovered data value. Parsed front matter and evaluated
  * attribute literals are both plain data — scalars, dates, arrays, and
@@ -17,8 +56,27 @@ export interface ComponentMarkdownChild extends EvaluatedProps {
     /** The child's body, downleveled and dedented. */
     children: string;
 }
+/** One direct child of a component — a child component or prose — as Markdown. */
+export interface ComponentMarkdownBlock {
+    /**
+     * The child downleveled: a serializable component's rendering (through the
+     * registry, so a user override of that component applies), or — for prose,
+     * a component with no serializer, or one that declined — its source with
+     * any serializable descendants downleveled in place.
+     */
+    markdown: string;
+    /** The JSX name of a child component; `undefined` for prose. */
+    name?: string;
+}
 /** What a serializer receives for one component usage. */
 export interface ComponentMarkdownContext extends EvaluatedProps {
+    /**
+     * Every direct child of the element in document order, components and
+     * prose alike, each as a block of Markdown. For a container that is nothing
+     * but its contents — `<CardGroup>` — joining these with blank lines is the
+     * whole serializer.
+     */
+    childBlocks: () => ComponentMarkdownBlock[];
     /** Direct child components of `name`, each with evaluated props and body. */
     childComponents: (name: string) => ComponentMarkdownChild[];
     /** The element's body, downleveled and dedented (empty if self-closing). */
@@ -47,6 +105,27 @@ export type ComponentMarkdown = (context: ComponentMarkdownContext) => string |
 export declare const exampleComponentSerializers: (examples: ExampleLookup) => {
     Component: ({ props }: ComponentMarkdownContext) => string | null;
 };
+/** One downlevel pass's inputs: the source, registry, and page metadata. */
+/** What a downlevel walk needs: the serializers, the page's front matter, and the source its nodes were parsed from. */
+export interface DownlevelWalk {
+    frontmatter: Record<string, EvaluatedValue> | undefined;
+    registry: Record<string, ComponentMarkdown>;
+    source: string;
+}
+/** The serializer registry for a site: built-ins under a user's `ai.markdownComponents`. */
+export declare const componentRegistry: (components?: Record<string, ComponentMarkdown>) => Record<string, ComponentMarkdown>;
+/**
+ * Walk the tree collecting replacements. A replaced element's subtree is
+ * owned by its serializer (which downlevels its own children), so the walk
+ * doesn't descend into it; when a serializer declines, the walk continues
+ * inside so nested serializable components still convert.
+ */
+/**
+ * Downlevel one parsed component to the Markdown its serializer emits, or
+ * `null` when the node isn't a component, has no serializer, or its
+ * serializer declines. `walk.source` must be the text `node` was parsed from.
+ */
+export declare const downlevelComponentNode: (node: MdastNode, walk: DownlevelWalk) => string | null;
 /**
  * Downlevel supported components in an MDX source to plain Markdown. Sources
  * with no supported components — and sources Satteri can't parse as MDX, e.g.

package/dist/types/components/layout/nav-utils.d.ts

@@ -0,0 +1,60 @@
+import type { NavNode, NavTab } from "../../core/types.ts";
+/** A flat, ordered page reference used for previous/next pagination. */
+export interface FlatPage {
+    route: string;
+    label: string;
+    deprecated?: boolean;
+}
+/** A breadcrumb segment; `route` is absent for non-clickable group ancestors. */
+export interface Crumb {
+    label: string;
+    route?: string;
+}
+/** Flatten the sidebar tree into ordered internal page links. */
+export declare const flattenPages: (nodes: NavNode[]) => FlatPage[];
+/** Find the breadcrumb trail (group ancestors + page) for a route. */
+export declare const findBreadcrumbs: (nodes: NavNode[], route: string) => Crumb[];
+/**
+ * The tab whose `path` is the longest prefix of `route`. The root tab (`/`)
+ * acts as the fallback when no more specific tab matches.
+ */
+export declare const activeTabForRoute: (tabs: NavTab[], route: string) => NavTab | null;
+/**
+ * The tab to mark as the current one (`aria-current`) for `route`. Same
+ * longest-prefix match as {@link activeTabForRoute}, except inside an archived
+ * version tree: the root tab claims every archived route through its
+ * spans-everything fallback while its link points back at the current docs, so
+ * no tab is genuinely current there.
+ */
+export declare const currentTabForRoute: (tabs: NavTab[], route: string, root?: string) => NavTab | null;
+/**
+ * Scope the sidebar to the active tab's section. With tabs configured, a route
+ * under one tab shows only that tab's group — so a multi-section site (e.g.
+ * Adapters / API / AI tabs) drills each tab into its own pages instead of one
+ * global tree, the way Fumadocs' root folders do. On a route under no tab (or
+ * the root tab), the tab-owned groups are hidden so the root sidebar shows
+ * only pages that don't belong to a tab.
+ *
+ * `root` is the tree root (`Navigation.root`), localized and based like tab
+ * paths — under i18n or a `basePath` the root tab sits at `/en` or `/docs`,
+ * not `/`, and a bare-`/` comparison would misread it as a section tab (a
+ * root-level `(group)` folder's path is exactly that prefix, so the sidebar
+ * collapsed to that one group or blanked entirely). In an archived version
+ * tree the root is versionized (`/v1.0`) while tab paths stay in current-docs
+ * space, so root-tab checks use {@link isRootTab} containment, not equality:
+ * the root tab owns no group in a snapshot, and misreading it as a section
+ * tab blanked the archived sidebar.
+ *
+ * When a matched tab owns no sidebar group — a standalone page like the
+ * generated changelog timeline (`/changelog`), or a tab whose source produced
+ * no pages — the sidebar is empty. It must not fall back to the full tree: that
+ * would leak every *other* tab's section (e.g. the OpenAPI operations) onto the
+ * page. On a route under no tab, hiding the tab sections falls back to the full
+ * sidebar only when it would otherwise blank, so an un-tabbed route stays full.
+ */
+export declare const sidebarForRoute: (sidebar: NavNode[], tabs: NavTab[], route: string, root?: string) => NavNode[];
+/** Resolve previous/next pages around the current route. */
+export declare const getPagination: (flat: FlatPage[], route: string) => {
+    next: FlatPage | null;
+    prev: FlatPage | null;
+};

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

@@ -36,6 +36,15 @@ export declare const normalizeRoute: (input: string) => string;
  * other schemes (`mailto:`), fragments (`#x`), and relative paths are excluded.
  */
 export declare const isInternalPath: (target: string) => boolean;
+/**
+ * Whether a rendered link should open in a new tab: an absolute http(s) URL or
+ * a protocol-relative one (`//host/path`). Other schemes (`mailto:`, `tel:`)
+ * also leave the site but hand off to another application, where a `_blank`
+ * target only opens an empty tab beside it. The one predicate behind every
+ * chrome link, so a header action and a sidebar featured link treat the same
+ * href alike.
+ */
+export declare const isExternalUrl: (target: string) => boolean;
 /**
  * Idempotently prepend `basePath` to a root-relative route. A route already
  * equal to or nested under the base is returned unchanged, so authors who write

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

@@ -2,7 +2,7 @@ import type { AstroIntegration } from "astro";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { CodeTheme } from "../markdown/themes.ts";
 import type { FontSlug } from "../theme/fonts.ts";
-import type { OpenApiSource, OpenInChatProvider, SearchProvider, SidebarDisplay, SidebarItemConfig } from "./schema.ts";
+import type { GraphqlSource, OpenApiSource, OpenInChatProvider, SearchProvider, SidebarDisplay, SidebarItemConfig } from "./schema.ts";
 import type { ContentSource } from "./sources/types.ts";
 import type { StandardSchema } from "./standard-schema.ts";
 /**
@@ -195,6 +195,20 @@ export interface NotionSource {
     /** Status value treated as published; others map to `draft`. Defaults to `Published`. */
     publishedValue?: string;
 }
+/**
+ * An Obsidian vault, read in place. Wikilinks become route links and
+ * `%%comments%%` are stripped at load time, so the vault stays the source of
+ * truth — no export step and no generated notes in the repo.
+ */
+export interface ObsidianSource {
+    type: "obsidian";
+    /** Vault folder names to skip at any depth, in addition to dot-folders. */
+    exclude?: string[];
+    /** Namespaces this source's routes under `/<prefix>/`; e.g. `vault`. */
+    prefix?: string;
+    /** Vault directory, absolute or relative to the project root. */
+    vault: string;
+}
 /**
  * A user-provided {@link ContentSource} instance, passed straight through. This
  * is the extension point for adapters with custom serializers or any other
@@ -206,7 +220,7 @@ export interface CustomSource {
     source: ContentSource;
 }
 /** A single configured content source, discriminated by `type`. */
-export type ContentSourceInput = FilesystemSource | MdxRemoteSource | GithubReleasesSource | SanitySource | NotionSource | CustomSource;
+export type ContentSourceInput = FilesystemSource | MdxRemoteSource | GithubReleasesSource | SanitySource | NotionSource | ObsidianSource | CustomSource;
 /**
  * Where content lives and how it's discovered. When `sources` is omitted, the
  * top-level `root`/`include`/`exclude` desugar to one implicit filesystem
@@ -385,12 +399,27 @@ export type SidebarConfig = SidebarItemConfig[] | {
     /** Explicit sidebar nodes; omit to auto-generate from content. */
     items?: SidebarItemConfig[];
 };
+/** A plain header link, or the header's single call to action. */
+export interface HeaderAction {
+    /** Link target. An external href opens in a new tab. */
+    href: string;
+    /** Link label. */
+    label: string;
+}
 /** Header, sidebar, tabs, and switcher configuration. */
 export interface NavigationConfig {
+    /** Plain links in the header, left of the icon buttons. */
+    actions?: HeaderAction[];
+    /** The single primary call to action in the header, as a filled button. */
+    cta?: HeaderAction;
     /** Pinned links shown above the generated sidebar sections. */
     featured?: FeaturedLink[];
-    /** Show a GitHub repo link in the header (requires `github` configured). */
-    repo?: boolean;
+    /**
+     * The GitHub link in the header. `true` derives it from `github` (the
+     * default), `false` hides it, and an absolute URL points it anywhere on
+     * GitHub — an organization, say, when the docs repo itself is private.
+     */
+    repo?: boolean | string;
     /** Context switchers shown in the header (versions, languages, …). */
     selectors?: NavSelector[];
     /** Sidebar behavior and (optionally) an explicit sidebar tree. */
@@ -411,6 +440,11 @@ export interface RemoteFontInput {
     name: string;
     /** Which provider serves the family. Defaults to `google`. */
     provider?: "google" | "fontsource" | "bunny" | "fontshare";
+    /**
+     * Character subsets to load (`"latin"`, `"vietnamese"`, `"cyrillic"`, …).
+     * Defaults to `latin` plus whatever the configured locales need.
+     */
+    subsets?: string[];
     /** Weights (or variable ranges like `"100..900"`) to load. Defaults to `[400, 500, 600, 700]`. */
     weights?: (number | string)[];
 }
@@ -520,6 +554,12 @@ export interface SearchConfig {
     algolia?: AlgoliaSearch;
     /** Indexing behavior. */
     indexing?: {
+        /**
+         * Index fenced code (body and title) in the source-built search indexes —
+         * the client index, hosted syncs, and the MCP `search_docs` index.
+         * Defaults to `false`; Pagefind and Mixedbread index code regardless.
+         */
+        includeCodeBlocks?: boolean;
         /** Include pages marked `hidden` in the search index. Defaults to `false`. */
         includeHiddenPages?: boolean;
     };
@@ -609,6 +649,22 @@ export interface AskConfig {
 }
 /** What the `llms.txt`/`llms-full.txt` files include. */
 export interface LlmsTxtConfig {
+    /**
+     * Markdown placed after the title and summary in `llms.txt`, before the
+     * page sections — the llms.txt spec's "details" block. Use it to tell
+     * agents when to reach for the product and how to call it (a "When to use"
+     * heading, the install command, the package name). Blank values are
+     * dropped.
+     *
+     * ```ts
+     * ai: {
+     *   llmsTxt: {
+     *     details: "## When to use Acme\n\nUse Acme when…",
+     *   },
+     * }
+     * ```
+     */
+    details?: string;
     /** Emit `llms.txt` and `llms-full.txt`. Defaults to `true`. */
     enabled?: boolean;
     /**
@@ -969,6 +1025,65 @@ export interface OgConfig {
      */
     titles?: Record<string, string>;
 }
+/** A schema.org `PostalAddress`; give whichever parts apply. */
+export interface PostalAddressConfig {
+    /** Country name or ISO 3166-1 alpha-2 code (`"US"`). */
+    addressCountry?: string;
+    /** City or locality. */
+    addressLocality?: string;
+    /** State, province, or region. */
+    addressRegion?: string;
+    postalCode?: string;
+    streetAddress?: string;
+}
+/**
+ * The organization behind the site, emitted in every page's JSON-LD as an
+ * `Organization` node that the WebSite and article nodes cite as publisher.
+ * Contact details become a `ContactPoint` and the address a `PostalAddress` —
+ * the fields AI agents check to verify a business before recommending it.
+ * Requires `deployment.site` (the node needs an absolute identifier).
+ */
+export interface OrganizationConfig {
+    /** Postal address, emitted as a `PostalAddress` when any part is given. */
+    address?: PostalAddressConfig;
+    /** `ContactPoint.contactType` for the email/telephone. Defaults to `"customer support"`. */
+    contactType?: string;
+    /** Public contact email. */
+    email?: string;
+    /** Logo: an absolute URL or a root-relative path (`"/logo.svg"`). */
+    logo?: string;
+    /** Organization name. Defaults to the site title. */
+    name?: string;
+    /** Profile URLs that identify the organization (GitHub, X, LinkedIn, …). */
+    sameAs?: string[];
+    /** Public contact telephone number. */
+    telephone?: string;
+    /** Organization website. Defaults to the site origin. */
+    url?: string;
+}
+/**
+ * The product the site documents, emitted on the homepage as a
+ * `SoftwareApplication` JSON-LD node — the identity type that tells agents
+ * what the site is about. Requires `deployment.site`.
+ */
+export interface SoftwareConfig {
+    /** schema.org application category. Defaults to `"DeveloperApplication"`. */
+    applicationCategory?: string;
+    /** Product description. Defaults to the site description. */
+    description?: string;
+    /** License URL or SPDX identifier (`"MIT"`). */
+    license?: string;
+    /** Product name. Defaults to the site title. */
+    name?: string;
+    /** Supported platform(s), e.g. `"Node.js 22+"`. */
+    operatingSystem?: string;
+    /** Price, emitted as an `Offer`; `0` marks the software free. */
+    price?: number | string;
+    /** Currency of `price` (ISO 4217). Defaults to `"USD"`. */
+    priceCurrency?: string;
+    /** Package registry, repository, and profile URLs for the product. */
+    sameAs?: string[];
+}
 /** Discoverability: OG images, feeds, sitemap, robots, and structured data. */
 export interface SeoConfig {
     /**
@@ -980,12 +1095,39 @@ export interface SeoConfig {
     contentSignals?: ContentSignalsConfig;
     /** Per-page Open Graph image generation. */
     og?: OgConfig;
+    /**
+     * The organization behind the site, added to every page's JSON-LD as an
+     * `Organization` node with contact point and address.
+     *
+     * ```ts
+     * seo: {
+     *   organization: {
+     *     email: "hello@acme.com",
+     *     logo: "/logo.svg",
+     *     sameAs: ["https://github.com/acme", "https://x.com/acme"],
+     *   },
+     * }
+     * ```
+     */
+    organization?: OrganizationConfig;
     /** Generate robots.txt (with a Sitemap reference when available). Defaults to `true`. */
     robots?: boolean;
     /** RSS/Atom feeds. */
     rss?: RssConfig;
     /** Generate sitemap.xml (requires `deployment.site`). Defaults to `true`. */
     sitemap?: boolean;
+    /**
+     * The documented product, added to the homepage's JSON-LD as a
+     * `SoftwareApplication` node. `true` takes every default (name and
+     * description from the site); the object form fills in the rest.
+     *
+     * ```ts
+     * seo: {
+     *   software: { license: "MIT", operatingSystem: "Node.js 22+", price: 0 },
+     * }
+     * ```
+     */
+    software?: boolean | SoftwareConfig;
     /** Emit schema.org JSON-LD in each page's `<head>`. Defaults to `true`. */
     structuredData?: boolean;
     /**
@@ -1002,10 +1144,27 @@ export interface SeoConfig {
 }
 /** Source repository, powering "Edit this page" links and the header repo link. */
 export interface GithubConfig {
+    /**
+     * REST API base, for a `<GithubInfo>` card against an Enterprise instance.
+     * Derived from `host` when unset: `api.github.com` for github.com, an `api.`
+     * subdomain for an Enterprise Cloud data-residency tenant, and `/api/v3` for
+     * Enterprise Server. Must be an HTTP(S) URL, and is reduced to an origin plus
+     * its path — the repository route is appended to it.
+     */
+    api?: string;
     /** Default branch. Defaults to `main`. */
     branch?: string;
     /** Path from the repo root to the project root (for monorepos). */
     dir?: string;
+    /**
+     * Origin of the GitHub instance the repo lives on. Defaults to
+     * `https://github.com`; set it to an Enterprise host (for example
+     * `https://github.acme.com` or `https://acme.ghe.com`) so the header link,
+     * edit links, and the agent manifest point at that instance. Must be an
+     * HTTP(S) URL, and is reduced to its origin — every repo URL is built by
+     * appending to it.
+     */
+    host?: string;
     /** Repository owner (user or org). */
     owner: string;
     /** Repository name. */
@@ -1121,6 +1280,47 @@ export interface AsyncApiConfig extends ReferenceConfig {
     /** Where the reference mounts. Defaults to `/events`. */
     route?: string;
 }
+/**
+ * GraphQL reference. Blume lowers the schema — SDL text or an introspection
+ * JSON result, local or remote — into one real page per root field (grouped
+ * as Queries/Mutations/Subscriptions) plus one page per named type (Objects,
+ * Input Objects, Enums, Interfaces, Unions, Scalars), all in the sidebar,
+ * search, llms.txt, and OG. Always Blume-rendered — the embedded Scalar SPA
+ * reads OpenAPI documents only — so unlike the other reference blocks there
+ * is no `renderer` opt-out.
+ */
+export interface GraphqlConfig {
+    /**
+     * Code-sample languages shown per operation. Defaults to
+     * `["curl", "js", "python"]`.
+     */
+    codeSamples?: string[];
+    /** Turn the reference on. Defaults to `false`. */
+    enabled?: boolean;
+    /**
+     * URL of the live GraphQL endpoint the playground and code samples target —
+     * a schema, unlike an OpenAPI document, names no server. Applies to every
+     * source in the block; a per-source `endpoint` wins.
+     */
+    endpoint?: string;
+    /**
+     * The interactive "Try it" panel on operation pages. On by default; `false`
+     * hides it. The object form keeps it on and sets `proxy`, the CORS escape
+     * hatch the Send button routes requests through: a proxy URL, or `true` for
+     * the built-in `/_api-proxy` endpoint (which requires
+     * `deployment.output: "server"`).
+     */
+    playground?: boolean | {
+        enabled?: boolean;
+        proxy?: boolean | string;
+    };
+    /** Where the reference mounts. Defaults to `/graphql`. */
+    route?: string;
+    /** One or more schemas; each renders on its own route by default. */
+    sources?: GraphqlSource[];
+    /** Shorthand for a single source: `sources: [{ spec }]`. */
+    spec?: string;
+}
 /** `<Component />` example previews (the object form of `examples`). */
 export interface ExamplesConfig {
     /**
@@ -1279,6 +1479,8 @@ export interface BlumeConfig {
     frontmatter?: FrontmatterConfig;
     /** Source repository (Edit-this-page links and the header repo link). */
     github?: GithubConfig;
+    /** Native GraphQL reference (root fields and named types as real pages). */
+    graphql?: GraphqlConfig;
     /** Internationalization (opt-in multi-locale). */
     i18n?: I18nConfig;
     /** Image optimization: remote-host authorization for the image service. */

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

@@ -40,11 +40,13 @@ import type { Diagnostic } from "./types.ts";
  *   custom `ContentSource`). Omit `sources` and the top-level `root` becomes one
  *   implicit filesystem source.
  * - `navigation` — sidebar, header `tabs`, `selectors` (version/language/product
- *   switchers), pinned `featured` links, and the `repo` link toggle. Omit
- *   `sidebar` to generate it from the content tree.
+ *   switchers), pinned `featured` links, header `actions` and the one `cta`,
+ *   and the `repo` link (a toggle, or a URL). Omit `sidebar` to generate it
+ *   from the content tree.
  * - `redirects` — `{ from, to, status }` rules (301 by default).
- * - `github` — `{ owner, repo, branch, dir }`, powering "Edit this page" links
- *   and the header repo link.
+ * - `github` — `{ owner, repo, branch, dir, host, api }`, powering "Edit this
+ *   page" links and the header repo link; `host` points them at a GitHub
+ *   Enterprise instance, `api` overrides the REST base derived from it.
  *
  * **Appearance**
  * - `theme` — `accent` color, `fonts` (curated slugs, any provider family, or

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

@@ -1,3 +1,4 @@
+import type { StructuredDataIdentity } from "../seo/jsonld.ts";
 import type { FontHead } from "../theme/fonts.ts";
 import type { UIStrings } from "./i18n-ui.ts";
 import type { ResolvedConfig, SearchProvider } from "./schema.ts";
@@ -131,15 +132,36 @@ export interface BlumeDataConfig {
      * Which agent-discovery resources exist for the layout to advertise in every
      * page's `<head>` (`seo.agentReadability`, `ai.llmsTxt.enabled`) — the HTML
      * counterpart of the homepage-only HTTP `Link` header, for agents that enter
-     * on a deep page (see `ai/link-headers.ts`).
+     * on a deep page (see `ai/link-headers.ts`). `sitemap` (`seo.sitemap` with a
+     * `deployment.site`, the condition under which one is emitted) feeds the
+     * 404 page's recovery links rather than the head.
      */
     discovery: {
         agentReadability: boolean;
         llmsTxt: boolean;
+        sitemap: boolean;
     };
     favicon: BlumeFavicon;
     feedback: boolean;
+    /**
+     * Repo coordinates for content components that address the API or build
+     * their own repo links (`<GithubInfo>`, the OG card's footer slug), carrying
+     * `host`/`api` so an Enterprise instance is reachable; `null` when `github`
+     * is unset. The plain repository URL stays on `repoUrl`.
+     */
+    github: {
+        api: string;
+        host: string;
+        owner: string;
+        repo: string;
+    } | null;
     i18n: BlumeDataI18n | null;
+    /**
+     * Site identity for JSON-LD (`seo.organization`, `seo.software`), read by
+     * the layouts straight from the snapshot so custom pages get it without
+     * threading a prop; `null` when neither is configured.
+     */
+    identity: StructuredDataIdentity | null;
     /** `markdown.imageZoom`: click-to-zoom content images. */
     imageZoom: boolean;
     logo: BlumeLogo | null;

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

@@ -0,0 +1,35 @@
+/**
+ * Repository URL derivation for `config.github`.
+ *
+ * Every repo-derived link — the header mark, per-page edit links, the agent
+ * manifest's `repository` — is built from `host`, which defaults to github.com
+ * but accepts a GitHub Enterprise origin so self-hosted and data-resident
+ * installations get working links instead of ones pointing at the public site.
+ *
+ * The REST base is derived from the host unless `api` is set explicitly, since
+ * the two Enterprise flavors expose it differently: Enterprise Cloud with data
+ * residency serves it from an `api.` subdomain of the same host, Enterprise
+ * Server from `/api/v3` on the host itself.
+ *
+ * `host` arrives as a bare origin and `api` as an origin plus path, both with
+ * no trailing slash — the config schema normalizes them — so nothing here
+ * re-trims user input.
+ */
+import type { ResolvedConfig } from "./schema.ts";
+/** The resolved `github` block, which the config leaves optional. */
+export type GithubTarget = NonNullable<ResolvedConfig["github"]>;
+/** The public instance every `host` defaults to. */
+export declare const PUBLIC_HOST_URL = "https://github.com";
+/** The public instance's REST base. */
+export declare const PUBLIC_API_URL = "https://api.github.com";
+/** The repository's web URL, e.g. `https://github.com/acme/docs`. */
+export declare const repoUrl: (github: Pick<GithubTarget, "host" | "owner" | "repo">) => string;
+/** The base every edit link extends with a repo-relative path. */
+export declare const editBaseUrl: (github: Pick<GithubTarget, "branch" | "host" | "owner" | "repo">) => string;
+/**
+ * The REST API base for `host`. An explicit `api` always wins; otherwise
+ * github.com (and any subdomain of it, `www.` say) maps to api.github.com, a
+ * data-residency tenant to its `api.` subdomain, and anything else is treated
+ * as Enterprise Server (`/api/v3`).
+ */
+export declare const apiUrl: (github: Pick<GithubTarget, "api" | "host">) => string;

package/dist/types/core/i18n-ui.d.ts

@@ -26,6 +26,7 @@ declare const uiStringsObject: z.ZodObject<{
         generating: z.ZodDefault<z.ZodString>;
         openIn: z.ZodDefault<z.ZodString>;
         openInChat: z.ZodDefault<z.ZodString>;
+        openInChatPrompt: z.ZodDefault<z.ZodString>;
         scrollToTop: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     ask: z.ZodPrefault<z.ZodObject<{
@@ -79,6 +80,9 @@ declare const uiStringsObject: z.ZodObject<{
     notFound: z.ZodPrefault<z.ZodObject<{
         description: z.ZodDefault<z.ZodString>;
         home: z.ZodDefault<z.ZodString>;
+        llms: z.ZodDefault<z.ZodString>;
+        sitemap: z.ZodDefault<z.ZodString>;
+        suggestions: z.ZodDefault<z.ZodString>;
         title: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     page: z.ZodPrefault<z.ZodObject<{
@@ -134,6 +138,7 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         generating: z.ZodDefault<z.ZodString>;
         openIn: z.ZodDefault<z.ZodString>;
         openInChat: z.ZodDefault<z.ZodString>;
+        openInChatPrompt: z.ZodDefault<z.ZodString>;
         scrollToTop: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     ask: z.ZodPrefault<z.ZodObject<{
@@ -187,6 +192,9 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
     notFound: z.ZodPrefault<z.ZodObject<{
         description: z.ZodDefault<z.ZodString>;
         home: z.ZodDefault<z.ZodString>;
+        llms: z.ZodDefault<z.ZodString>;
+        sitemap: z.ZodDefault<z.ZodString>;
+        suggestions: z.ZodDefault<z.ZodString>;
         title: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     page: z.ZodPrefault<z.ZodObject<{