blume 0.1.0 → 0.1.2

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

@@ -0,0 +1,500 @@
+import { z } from "zod";
+import { UI_PACKS } from "./ui-packs/index.ts";
+/**
+ * Translatable UI chrome strings.
+ *
+ * The schema is the single source of truth: each field's `.default()` is the
+ * English baseline, so `EN_UI = uiStringsSchema.parse({})`. Shipped packs and
+ * user overrides merge on top (see {@link resolveUIStrings}). Grouped by surface
+ * to keep the runtime payload and component props readable.
+ */
+declare const uiStringsObject: z.ZodObject<{
+    actions: z.ZodDefault<z.ZodObject<{
+        addToCursor: z.ZodDefault<z.ZodString>;
+        addToVscode: z.ZodDefault<z.ZodString>;
+        askAI: z.ZodDefault<z.ZodString>;
+        connectMcp: z.ZodDefault<z.ZodString>;
+        copied: z.ZodDefault<z.ZodString>;
+        copyClaudeCode: z.ZodDefault<z.ZodString>;
+        copyMarkdown: z.ZodDefault<z.ZodString>;
+        copyServerUrl: z.ZodDefault<z.ZodString>;
+        edit: z.ZodDefault<z.ZodString>;
+        openInChat: z.ZodDefault<z.ZodString>;
+        scrollToTop: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        addToCursor: string;
+        addToVscode: string;
+        askAI: string;
+        connectMcp: string;
+        copied: string;
+        copyClaudeCode: string;
+        copyMarkdown: string;
+        copyServerUrl: string;
+        edit: string;
+        openInChat: string;
+        scrollToTop: string;
+    }, {
+        addToCursor?: string | undefined;
+        addToVscode?: string | undefined;
+        askAI?: string | undefined;
+        connectMcp?: string | undefined;
+        copied?: string | undefined;
+        copyClaudeCode?: string | undefined;
+        copyMarkdown?: string | undefined;
+        copyServerUrl?: string | undefined;
+        edit?: string | undefined;
+        openInChat?: string | undefined;
+        scrollToTop?: string | undefined;
+    }>>;
+    ask: z.ZodDefault<z.ZodObject<{
+        empty: z.ZodDefault<z.ZodString>;
+        error: z.ZodDefault<z.ZodString>;
+        label: z.ZodDefault<z.ZodString>;
+        placeholder: z.ZodDefault<z.ZodString>;
+        send: z.ZodDefault<z.ZodString>;
+        title: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        empty: string;
+        error: string;
+        label: string;
+        placeholder: string;
+        send: string;
+        title: string;
+    }, {
+        empty?: string | undefined;
+        error?: string | undefined;
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        send?: string | undefined;
+        title?: string | undefined;
+    }>>;
+    feedback: z.ZodDefault<z.ZodObject<{
+        no: z.ZodDefault<z.ZodString>;
+        question: z.ZodDefault<z.ZodString>;
+        thanks: z.ZodDefault<z.ZodString>;
+        yes: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        no: string;
+        question: string;
+        thanks: string;
+        yes: string;
+    }, {
+        no?: string | undefined;
+        question?: string | undefined;
+        thanks?: string | undefined;
+        yes?: string | undefined;
+    }>>;
+    languageSwitcher: z.ZodDefault<z.ZodObject<{
+        label: z.ZodDefault<z.ZodString>;
+        untranslated: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        untranslated: string;
+    }, {
+        label?: string | undefined;
+        untranslated?: string | undefined;
+    }>>;
+    page: z.ZodDefault<z.ZodObject<{
+        lastUpdated: z.ZodDefault<z.ZodString>;
+        next: z.ZodDefault<z.ZodString>;
+        previous: z.ZodDefault<z.ZodString>;
+        skipToContent: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        lastUpdated: string;
+        next: string;
+        previous: string;
+        skipToContent: string;
+    }, {
+        lastUpdated?: string | undefined;
+        next?: string | undefined;
+        previous?: string | undefined;
+        skipToContent?: string | undefined;
+    }>>;
+    search: z.ZodDefault<z.ZodObject<{
+        allLanguages: z.ZodDefault<z.ZodString>;
+        button: z.ZodDefault<z.ZodString>;
+        devOnly: z.ZodDefault<z.ZodString>;
+        label: z.ZodDefault<z.ZodString>;
+        noResults: z.ZodDefault<z.ZodString>;
+        placeholder: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        placeholder: string;
+        button: string;
+        devOnly: string;
+        noResults: string;
+        allLanguages: string;
+    }, {
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        button?: string | undefined;
+        devOnly?: string | undefined;
+        noResults?: string | undefined;
+        allLanguages?: string | undefined;
+    }>>;
+    toc: z.ZodDefault<z.ZodObject<{
+        title: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+    }, {
+        title?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    actions: {
+        addToCursor: string;
+        addToVscode: string;
+        askAI: string;
+        connectMcp: string;
+        copied: string;
+        copyClaudeCode: string;
+        copyMarkdown: string;
+        copyServerUrl: string;
+        edit: string;
+        openInChat: string;
+        scrollToTop: string;
+    };
+    ask: {
+        empty: string;
+        error: string;
+        label: string;
+        placeholder: string;
+        send: string;
+        title: string;
+    };
+    feedback: {
+        no: string;
+        question: string;
+        thanks: string;
+        yes: string;
+    };
+    languageSwitcher: {
+        label: string;
+        untranslated: string;
+    };
+    page: {
+        lastUpdated: string;
+        next: string;
+        previous: string;
+        skipToContent: string;
+    };
+    search: {
+        label: string;
+        placeholder: string;
+        button: string;
+        devOnly: string;
+        noResults: string;
+        allLanguages: string;
+    };
+    toc: {
+        title: string;
+    };
+}, {
+    actions?: {
+        addToCursor?: string | undefined;
+        addToVscode?: string | undefined;
+        askAI?: string | undefined;
+        connectMcp?: string | undefined;
+        copied?: string | undefined;
+        copyClaudeCode?: string | undefined;
+        copyMarkdown?: string | undefined;
+        copyServerUrl?: string | undefined;
+        edit?: string | undefined;
+        openInChat?: string | undefined;
+        scrollToTop?: string | undefined;
+    } | undefined;
+    ask?: {
+        empty?: string | undefined;
+        error?: string | undefined;
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        send?: string | undefined;
+        title?: string | undefined;
+    } | undefined;
+    feedback?: {
+        no?: string | undefined;
+        question?: string | undefined;
+        thanks?: string | undefined;
+        yes?: string | undefined;
+    } | undefined;
+    languageSwitcher?: {
+        label?: string | undefined;
+        untranslated?: string | undefined;
+    } | undefined;
+    page?: {
+        lastUpdated?: string | undefined;
+        next?: string | undefined;
+        previous?: string | undefined;
+        skipToContent?: string | undefined;
+    } | undefined;
+    search?: {
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        button?: string | undefined;
+        devOnly?: string | undefined;
+        noResults?: string | undefined;
+        allLanguages?: string | undefined;
+    } | undefined;
+    toc?: {
+        title?: string | undefined;
+    } | undefined;
+}>;
+export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
+    actions: z.ZodDefault<z.ZodObject<{
+        addToCursor: z.ZodDefault<z.ZodString>;
+        addToVscode: z.ZodDefault<z.ZodString>;
+        askAI: z.ZodDefault<z.ZodString>;
+        connectMcp: z.ZodDefault<z.ZodString>;
+        copied: z.ZodDefault<z.ZodString>;
+        copyClaudeCode: z.ZodDefault<z.ZodString>;
+        copyMarkdown: z.ZodDefault<z.ZodString>;
+        copyServerUrl: z.ZodDefault<z.ZodString>;
+        edit: z.ZodDefault<z.ZodString>;
+        openInChat: z.ZodDefault<z.ZodString>;
+        scrollToTop: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        addToCursor: string;
+        addToVscode: string;
+        askAI: string;
+        connectMcp: string;
+        copied: string;
+        copyClaudeCode: string;
+        copyMarkdown: string;
+        copyServerUrl: string;
+        edit: string;
+        openInChat: string;
+        scrollToTop: string;
+    }, {
+        addToCursor?: string | undefined;
+        addToVscode?: string | undefined;
+        askAI?: string | undefined;
+        connectMcp?: string | undefined;
+        copied?: string | undefined;
+        copyClaudeCode?: string | undefined;
+        copyMarkdown?: string | undefined;
+        copyServerUrl?: string | undefined;
+        edit?: string | undefined;
+        openInChat?: string | undefined;
+        scrollToTop?: string | undefined;
+    }>>;
+    ask: z.ZodDefault<z.ZodObject<{
+        empty: z.ZodDefault<z.ZodString>;
+        error: z.ZodDefault<z.ZodString>;
+        label: z.ZodDefault<z.ZodString>;
+        placeholder: z.ZodDefault<z.ZodString>;
+        send: z.ZodDefault<z.ZodString>;
+        title: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        empty: string;
+        error: string;
+        label: string;
+        placeholder: string;
+        send: string;
+        title: string;
+    }, {
+        empty?: string | undefined;
+        error?: string | undefined;
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        send?: string | undefined;
+        title?: string | undefined;
+    }>>;
+    feedback: z.ZodDefault<z.ZodObject<{
+        no: z.ZodDefault<z.ZodString>;
+        question: z.ZodDefault<z.ZodString>;
+        thanks: z.ZodDefault<z.ZodString>;
+        yes: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        no: string;
+        question: string;
+        thanks: string;
+        yes: string;
+    }, {
+        no?: string | undefined;
+        question?: string | undefined;
+        thanks?: string | undefined;
+        yes?: string | undefined;
+    }>>;
+    languageSwitcher: z.ZodDefault<z.ZodObject<{
+        label: z.ZodDefault<z.ZodString>;
+        untranslated: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        untranslated: string;
+    }, {
+        label?: string | undefined;
+        untranslated?: string | undefined;
+    }>>;
+    page: z.ZodDefault<z.ZodObject<{
+        lastUpdated: z.ZodDefault<z.ZodString>;
+        next: z.ZodDefault<z.ZodString>;
+        previous: z.ZodDefault<z.ZodString>;
+        skipToContent: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        lastUpdated: string;
+        next: string;
+        previous: string;
+        skipToContent: string;
+    }, {
+        lastUpdated?: string | undefined;
+        next?: string | undefined;
+        previous?: string | undefined;
+        skipToContent?: string | undefined;
+    }>>;
+    search: z.ZodDefault<z.ZodObject<{
+        allLanguages: z.ZodDefault<z.ZodString>;
+        button: z.ZodDefault<z.ZodString>;
+        devOnly: z.ZodDefault<z.ZodString>;
+        label: z.ZodDefault<z.ZodString>;
+        noResults: z.ZodDefault<z.ZodString>;
+        placeholder: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        placeholder: string;
+        button: string;
+        devOnly: string;
+        noResults: string;
+        allLanguages: string;
+    }, {
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        button?: string | undefined;
+        devOnly?: string | undefined;
+        noResults?: string | undefined;
+        allLanguages?: string | undefined;
+    }>>;
+    toc: z.ZodDefault<z.ZodObject<{
+        title: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+    }, {
+        title?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    actions: {
+        addToCursor: string;
+        addToVscode: string;
+        askAI: string;
+        connectMcp: string;
+        copied: string;
+        copyClaudeCode: string;
+        copyMarkdown: string;
+        copyServerUrl: string;
+        edit: string;
+        openInChat: string;
+        scrollToTop: string;
+    };
+    ask: {
+        empty: string;
+        error: string;
+        label: string;
+        placeholder: string;
+        send: string;
+        title: string;
+    };
+    feedback: {
+        no: string;
+        question: string;
+        thanks: string;
+        yes: string;
+    };
+    languageSwitcher: {
+        label: string;
+        untranslated: string;
+    };
+    page: {
+        lastUpdated: string;
+        next: string;
+        previous: string;
+        skipToContent: string;
+    };
+    search: {
+        label: string;
+        placeholder: string;
+        button: string;
+        devOnly: string;
+        noResults: string;
+        allLanguages: string;
+    };
+    toc: {
+        title: string;
+    };
+}, {
+    actions?: {
+        addToCursor?: string | undefined;
+        addToVscode?: string | undefined;
+        askAI?: string | undefined;
+        connectMcp?: string | undefined;
+        copied?: string | undefined;
+        copyClaudeCode?: string | undefined;
+        copyMarkdown?: string | undefined;
+        copyServerUrl?: string | undefined;
+        edit?: string | undefined;
+        openInChat?: string | undefined;
+        scrollToTop?: string | undefined;
+    } | undefined;
+    ask?: {
+        empty?: string | undefined;
+        error?: string | undefined;
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        send?: string | undefined;
+        title?: string | undefined;
+    } | undefined;
+    feedback?: {
+        no?: string | undefined;
+        question?: string | undefined;
+        thanks?: string | undefined;
+        yes?: string | undefined;
+    } | undefined;
+    languageSwitcher?: {
+        label?: string | undefined;
+        untranslated?: string | undefined;
+    } | undefined;
+    page?: {
+        lastUpdated?: string | undefined;
+        next?: string | undefined;
+        previous?: string | undefined;
+        skipToContent?: string | undefined;
+    } | undefined;
+    search?: {
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        button?: string | undefined;
+        devOnly?: string | undefined;
+        noResults?: string | undefined;
+        allLanguages?: string | undefined;
+    } | undefined;
+    toc?: {
+        title?: string | undefined;
+    } | undefined;
+}>>;
+/** A fully-resolved dictionary; every key present. */
+export type UIStrings = z.infer<typeof uiStringsObject>;
+/** The English baseline, derived from the schema defaults. */
+export declare const EN_UI: UIStrings;
+/**
+ * A partial override: `{ group: { key: "translation" } }`. Validated loosely
+ * (object of objects of strings) so packs and user config can supply only the
+ * keys they translate. Unknown groups/keys merge harmlessly.
+ */
+export declare const uiStringsOverrideSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
+export type UIStringsOverride = z.infer<typeof uiStringsOverrideSchema>;
+/** Per-locale UI overrides supplied in `i18n.ui`. */
+export declare const uiLocaleOverridesSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+/**
+ * Built-in translation packs, one module per locale under {@link ./ui-packs}.
+ * English is the schema baseline (no pack); every other locale ships a starter
+ * pack so adopters get translated chrome out of the box. Re-exported here so the
+ * resolver and existing imports keep a single entry point.
+ */
+export { UI_PACKS };
+/**
+ * Resolve the active dictionary for a locale. Layers, in order:
+ * English baseline ← default-locale pack ← default-locale override ←
+ * locale pack ← locale override. So a missing key falls back to the default
+ * locale's translation, then to English.
+ */
+export declare const resolveUIStrings: (locale: string, options: {
+    defaultLocale: string;
+    overrides?: Record<string, UIStringsOverride>;
+}) => UIStrings;

package/dist/types/core/load-module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create a loader for user-authored ESM/TS modules (`blume.config.ts`,
+ * `meta.ts`). One jiti instance is reused across every file the returned loader
+ * is called with. `moduleCache: false` ensures edits are picked up on each load,
+ * which is what makes dev-server regeneration reflect config/meta changes.
+ */
+export declare const createModuleLoader: () => ((file: string) => Promise<unknown>);

package/dist/types/core/package-root.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Walk up from `start` until a directory containing a `package.json` is found.
+ *
+ * Exported for testing; call sites should use {@link packageRoot}.
+ */
+export declare const findPackageRoot: (start: string) => string;
+/**
+ * Absolute path to the installed Blume package root (the directory holding its
+ * `package.json`), found by walking up from this module.
+ *
+ * Anchoring here — rather than at a fixed offset from `import.meta` — keeps the
+ * package's own `src/`, assets, and `node_modules` locatable whether the code
+ * runs from source under Bun (`src/...`) or from the published, bundled CLI
+ * (`dist/cli/index.js`). The two layouts sit at different depths, so a relative
+ * `../..` resolves to different places; locating `package.json` does not.
+ */
+export declare const packageRoot: () => string;

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

@@ -0,0 +1,9 @@
+import type { ResolvedConfig } from "./schema.ts";
+import type { ProjectContext } from "./types.ts";
+/** Locate the Blume config file for a project root, if any. */
+export declare const findConfigFile: (root: string) => string | null;
+/**
+ * Resolve every path Blume needs from a project root and its resolved config.
+ * Paths are absolute and normalized.
+ */
+export declare const resolveProjectContext: (root: string, config: ResolvedConfig) => ProjectContext;