blume 0.2.0 → 0.3.0

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

@@ -110,6 +110,22 @@ export interface BlumeDataConfig {
     structuredData: boolean;
     theme: ResolvedConfig["theme"];
     title: string;
+    /** Table-of-contents settings: whether to show it and the heading range. */
+    toc: ResolvedConfig["toc"];
+}
+/**
+ * The compact snapshot the layout serializes into the page for React island
+ * hooks (`blume/hooks`). Islands hydrate independently, so this is read from a
+ * `<script type="application/json" id="blume-client-data">` tag rather than
+ * React context.
+ */
+export interface BlumeClientData {
+    config: BlumeDataConfig;
+    navigation: Navigation;
+    page: {
+        route: string;
+        title: string;
+    };
 }
 /** The `blume:data` module a Blume site's custom pages import. */
 export interface BlumeData {

package/dist/types/core/define-components.d.ts

@@ -15,10 +15,17 @@ export interface IslandDescriptor {
 export type ComponentOverride = ComponentReference | IslandDescriptor;
 /** User-authored component overrides, grouped by surface. */
 export interface ComponentOverrides {
+    /**
+     * Interactive framework components made available in every `.mdx` page. Like
+     * `mdx`, but hydrated: entries default to `client: "visible"`. Shorthand for
+     * an `mdx` descriptor with a client mode, and the config-file equivalent of
+     * dropping a component in the `islands/` folder.
+     */
+    islands?: Record<string, ComponentOverride>;
+    /** Layout slot overrides (`Header`, `Sidebar`, `Footer`, ...). */
+    layout?: Record<string, ComponentOverride>;
     /** MDX component map overrides (`Callout`, `Card`, ...). */
     mdx?: Record<string, ComponentOverride>;
-    /** Layout slot overrides (`Header`, `Sidebar`, `Search`, ...). */
-    layout?: Record<string, ComponentOverride>;
 }
 /**
  * Identity helper for authoring `components.ts`. Provides type inference and a

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

@@ -6,10 +6,15 @@ export declare class BlumeError extends Error {
     constructor(diagnostic: Diagnostic);
 }
 export declare const createDiagnostic: (diagnostic: Diagnostic) => Diagnostic;
+/** The docs URL that explains a diagnostic code, if one is mapped. */
+export declare const resolveDocsUrl: (code: string) => string | undefined;
+/** Fill in `docsUrl` from the code map where a diagnostic doesn't set its own. */
+export declare const enrichDiagnostic: (diagnostic: Diagnostic) => Diagnostic;
 /** Convert a ZodError into Blume diagnostics, anchored to a file. */
 export declare const diagnosticsFromZod: (error: ZodError, options: {
     code: string;
     file?: string;
+    source?: string;
 }) => Diagnostic[];
 /** Format a single diagnostic for terminal output. */
 export declare const formatDiagnostic: (diagnostic: Diagnostic, root?: string) => string;