@brainfish-ai/devdoc 0.1.21

package/dist/config/index.d.ts

@@ -0,0 +1,80 @@
+export interface DocsConfig {
+    name?: string;
+    logo?: string | {
+        light?: string;
+        dark?: string;
+    };
+    favicon?: string;
+    colors?: {
+        primary?: string;
+        accent?: string;
+    };
+    navigation?: Navigation | NavigationGroup[];
+    tabs?: Tab[];
+    footer?: {
+        links?: Array<{
+            name: string;
+            url: string;
+        }>;
+    };
+    notice?: {
+        content?: string;
+        dismissible?: boolean;
+        background?: string;
+    };
+    redirects?: Array<{
+        source: string;
+        destination: string;
+    }>;
+}
+export interface Navigation {
+    tabs?: NavigationTab[];
+    global?: {
+        anchors?: Array<{
+            anchor: string;
+            href: string;
+            icon?: string;
+        }>;
+    };
+}
+export interface NavigationTab {
+    tab: string;
+    type: 'docs' | 'openapi' | 'changelog';
+    path?: string;
+    groups?: NavigationGroup[];
+    versions?: Array<{
+        version: string;
+        spec: string;
+        default?: boolean;
+    }>;
+}
+export interface NavigationGroup {
+    group: string;
+    icon?: string;
+    pages: Array<string | {
+        page?: string;
+        group?: string;
+        pages?: string[];
+        title?: string;
+    }>;
+}
+export interface Tab {
+    name: string;
+    url: string;
+    openapi?: string;
+}
+/**
+ * Load docs.json configuration from project root
+ */
+export declare function loadConfig(projectRoot: string): Promise<DocsConfig>;
+/**
+ * Validate docs.json configuration
+ */
+export declare function validateConfig(config: DocsConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get the content directory from config or default
+ */
+export declare function getContentDir(config: DocsConfig, projectRoot: string): string;

package/dist/config/index.js

@@ -0,0 +1,133 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.validateConfig = validateConfig;
+exports.getContentDir = getContentDir;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+/**
+ * Load docs.json configuration from project root
+ */
+async function loadConfig(projectRoot) {
+    const configPath = path_1.default.join(projectRoot, 'docs.json');
+    if (!fs_extra_1.default.existsSync(configPath)) {
+        throw new Error(`docs.json not found at ${configPath}`);
+    }
+    const content = await fs_extra_1.default.readFile(configPath, 'utf-8');
+    try {
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in docs.json: ${error.message}`);
+    }
+}
+/**
+ * Validate docs.json configuration
+ */
+function validateConfig(config) {
+    const errors = [];
+    // Check required fields
+    if (!config.name) {
+        errors.push('Missing required field: name');
+    }
+    // Validate navigation - support both old array format and new object format
+    if (config.navigation) {
+        if (Array.isArray(config.navigation)) {
+            // Old format: navigation is an array of groups
+            config.navigation.forEach((group, index) => {
+                if (!group.group) {
+                    errors.push(`navigation[${index}]: missing group name`);
+                }
+                if (!group.pages || !Array.isArray(group.pages)) {
+                    errors.push(`navigation[${index}]: pages must be an array`);
+                }
+            });
+        }
+        else if (typeof config.navigation === 'object') {
+            // New format: navigation is an object with tabs
+            const nav = config.navigation;
+            if (nav.tabs) {
+                if (!Array.isArray(nav.tabs)) {
+                    errors.push('navigation.tabs must be an array');
+                }
+                else {
+                    nav.tabs.forEach((tab, index) => {
+                        if (!tab.tab) {
+                            errors.push(`navigation.tabs[${index}]: missing tab name`);
+                        }
+                        if (!tab.type) {
+                            errors.push(`navigation.tabs[${index}]: missing type`);
+                        }
+                    });
+                }
+            }
+        }
+    }
+    // Validate tabs (legacy format)
+    if (config.tabs) {
+        if (!Array.isArray(config.tabs)) {
+            errors.push('tabs must be an array');
+        }
+        else {
+            config.tabs.forEach((tab, index) => {
+                if (!tab.name) {
+                    errors.push(`tabs[${index}]: missing name`);
+                }
+                if (!tab.url) {
+                    errors.push(`tabs[${index}]: missing url`);
+                }
+            });
+        }
+    }
+    // Validate colors
+    if (config.colors) {
+        if (config.colors.primary && !isValidColor(config.colors.primary)) {
+            errors.push('colors.primary must be a valid color (hex, rgb, or named color)');
+        }
+        if (config.colors.accent && !isValidColor(config.colors.accent)) {
+            errors.push('colors.accent must be a valid color (hex, rgb, or named color)');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Check if a string is a valid color
+ */
+function isValidColor(color) {
+    // Hex colors
+    if (/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(color)) {
+        return true;
+    }
+    // RGB/RGBA
+    if (/^rgba?\(.+\)$/.test(color)) {
+        return true;
+    }
+    // HSL/HSLA
+    if (/^hsla?\(.+\)$/.test(color)) {
+        return true;
+    }
+    // Named colors (basic check)
+    const namedColors = [
+        'black', 'white', 'red', 'green', 'blue', 'yellow', 'cyan', 'magenta',
+        'gray', 'grey', 'orange', 'purple', 'pink', 'brown',
+    ];
+    if (namedColors.includes(color.toLowerCase())) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get the content directory from config or default
+ */
+function getContentDir(config, projectRoot) {
+    // For now, content is at the project root
+    // Could be made configurable in the future
+    return projectRoot;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBMERBLGdDQWNDO0FBS0Qsd0NBc0VDO0FBb0NELHNDQUlDO0FBM0xELGdEQUF3QjtBQUN4Qix3REFBMEI7QUFzRDFCOztHQUVHO0FBQ0ksS0FBSyxVQUFVLFVBQVUsQ0FBQyxXQUFtQjtJQUNsRCxNQUFNLFVBQVUsR0FBRyxjQUFJLENBQUMsSUFBSSxDQUFDLFdBQVcsRUFBRSxXQUFXLENBQUMsQ0FBQztJQUV2RCxJQUFJLENBQUMsa0JBQUUsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztRQUMvQixNQUFNLElBQUksS0FBSyxDQUFDLDBCQUEwQixVQUFVLEVBQUUsQ0FBQyxDQUFDO0lBQzFELENBQUM7SUFFRCxNQUFNLE9BQU8sR0FBRyxNQUFNLGtCQUFFLENBQUMsUUFBUSxDQUFDLFVBQVUsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUV2RCxJQUFJLENBQUM7UUFDSCxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDN0IsQ0FBQztJQUFDLE9BQU8sS0FBVSxFQUFFLENBQUM7UUFDcEIsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUM7SUFDakUsQ0FBQztBQUNILENBQUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLGNBQWMsQ0FBQyxNQUFrQjtJQUMvQyxNQUFNLE1BQU0sR0FBYSxFQUFFLENBQUM7SUFFNUIsd0JBQXdCO0lBQ3hCLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDakIsTUFBTSxDQUFDLElBQUksQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO0lBQzlDLENBQUM7SUFFRCw0RUFBNEU7SUFDNUUsSUFBSSxNQUFNLENBQUMsVUFBVSxFQUFFLENBQUM7UUFDdEIsSUFBSSxLQUFL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QUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHBhdGggZnJvbSAncGF0aCc7XG5pbXBvcnQgZnMgZnJvbSAnZnMtZXh0cmEnO1xuXG5leHBvcnQgaW50ZXJmYWNlIERvY3NDb25maWcge1xuICBuYW1lPzogc3RyaW5nO1xuICBsb2dvPzogc3RyaW5nIHwgeyBsaWdodD86IHN0cmluZzsgZGFyaz86IHN0cmluZyB9O1xuICBmYXZpY29uPzogc3RyaW5nO1xuICBjb2xvcnM/OiB7XG4gICAgcHJpbWFyeT86IHN0cmluZztcbiAgICBhY2NlbnQ/OiBzdHJpbmc7XG4gIH07XG4gIG5hdmlnYXRpb24/OiBOYXZpZ2F0aW9uIHwgTmF2aWdhdGlvbkdyb3VwW107XG4gIHRhYnM/OiBUYWJbXTtcbiAgZm9vdGVyPzoge1xuICAgIGxpbmtzPzogQXJyYXk8eyBuYW1lOiBzdHJpbmc7IHVybDogc3RyaW5nIH0+O1xuICB9O1xuICBub3RpY2U/OiB7XG4gICAgY29udGVudD86IHN0cmluZztcbiAgICBkaXNtaXNzaWJsZT86IGJvb2xlYW47XG4gICAgYmFja2dyb3VuZD86IHN0cmluZztcbiAgfTtcbiAgcmVkaXJlY3RzPzogQXJyYXk8e1xuICAgIHNvdXJjZTogc3RyaW5nO1xuICAgIGRlc3RpbmF0aW9uOiBzdHJpbmc7XG4gIH0+O1xufVxuXG4vLyBOZXcgbmF2aWdhdGlvbiBzdHJ1Y3R1cmUgd2l0aCB0YWJzXG5leHBvcnQgaW50ZXJmYWNlIE5hdmlnYXRpb24ge1xuICB0YWJzPzogTmF2aWdhdGlvblRhYltdO1xuICBnbG9iYWw/OiB7XG4gICAgYW5jaG9ycz86IEFycmF5PHsgYW5jaG9yOiBzdHJpbmc7IGhyZWY6IHN0cmluZzsgaWNvbj86IHN0cmluZyB9PjtcbiAgfTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBOYXZpZ2F0aW9uVGFiIHtcbiAgdGFiOiBzdHJpbmc7XG4gIHR5cGU6ICdkb2NzJyB8ICdvcGVuYXBpJyB8ICdjaGFuZ2Vsb2cnO1xuICBwYXRoPzogc3RyaW5nO1xuICBncm91cHM/OiBOYXZpZ2F0aW9uR3JvdXBbXTtcbiAgdmVyc2lvbnM/OiBBcnJheTx7IHZlcnNpb246IHN0cmluZzsgc3BlYzogc3RyaW5nOyBkZWZhdWx0PzogYm9vbGVhbiB9Pjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBOYXZpZ2F0aW9uR3JvdXAge1xuICBncm91cDogc3RyaW5nO1xuICBpY29uPzogc3RyaW5nO1xuICBwYWdlczogQXJyYXk8c3RyaW5nIHwgeyBwYWdlPzogc3RyaW5nOyBncm91cD86IHN0cmluZzsgcGFnZXM/OiBzdHJpbmdbXTsgdGl0bGU/OiBzdHJpbmcgfT47XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVGFiIHtcbiAgbmFtZTogc3RyaW5nO1xuICB1cmw6IHN0cmluZztcbiAgb3BlbmFwaT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBMb2FkIGRvY3MuanNvbiBjb25maWd1cmF0aW9uIGZyb20gcHJvamVjdCByb290XG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBsb2FkQ29uZmlnKHByb2plY3RSb290OiBzdHJpbmcpOiBQcm9taXNlPERvY3NDb25maWc+IHtcbiAgY29uc3QgY29uZmlnUGF0aCA9IHBhdGguam9pbihwcm9qZWN0Um9vdCwgJ2RvY3MuanNvbicpO1xuICBcbiAgaWYgKCFmcy5leGlzdHNTeW5jKGNvbmZpZ1BhdGgpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBkb2NzLmpzb24gbm90IGZvdW5kIGF0ICR7Y29uZmlnUGF0aH1gKTtcbiAgfVxuICBcbiAgY29uc3QgY29udGVudCA9IGF3YWl0IGZzLnJlYWRGaWxlKGNvbmZpZ1BhdGgsICd1dGYtOCcpO1xuICBcbiAgdHJ5IHtcbiAgICByZXR1cm4gSlNPTi5wYXJzZShjb250ZW50KTtcbiAgfSBjYXRjaCAoZXJyb3I6IGFueSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgSW52YWxpZCBKU09OIGluIGRvY3MuanNvbjogJHtlcnJvci5tZXNzYWdlfWApO1xuICB9XG59XG5cbi8qKlxuICogVmFsaWRhdGUgZG9jcy5qc29uIGNvbmZpZ3VyYXRpb25cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHZhbGlkYXRlQ29uZmlnKGNvbmZpZzogRG9jc0NvbmZpZyk6IHsgdmFsaWQ6IGJvb2xlYW47IGVycm9yczogc3RyaW5nW10gfSB7XG4gIGNvbnN0IGVycm9yczogc3RyaW5nW10gPSBbXTtcbiAgXG4gIC8vIENoZWNrIHJlcXVpcmVkIGZpZWxkc1xuICBpZiAoIWNvbmZpZy5uYW1lKSB7XG4gICAgZXJyb3JzLnB1c2goJ01pc3NpbmcgcmVxdWlyZWQgZmllbGQ6IG5hbWUnKTtcbiAgfVxuICBcbiAgLy8gVmFsaWRhdGUgbmF2aWdhdGlvbiAtIHN1cHBvcnQgYm90aCBvbGQgYXJyYXkgZm9ybWF0IGFuZCBuZXcgb2JqZWN0IGZvcm1hdFxuICBpZiAoY29uZmlnLm5hdmlnYXRpb24pIHtcbiAgICBpZiAoQXJyYXkuaXNBcnJheShjb25maWcubmF2aWdhdGlvbikpIHtcbiAgICAgIC8vIE9sZCBmb3JtYXQ6IG5hdmlnYXRpb24gaXMgYW4gYXJyYXkgb2YgZ3JvdXBzXG4gICAgICBjb25maWcubmF2aWdhdGlvbi5mb3JFYWNoKChncm91cCwgaW5kZXgpID0+IHtcbiAgICAgICAgaWYgKCFncm91cC5ncm91cCkge1xuICAgICAgICAgIGVycm9ycy5wdXNoKGBuYXZpZ2F0aW9uWyR7aW5kZXh9XTogbWlzc2luZyBncm91cCBuYW1lYCk7XG4gICAgICAgIH1cbiAgICAgICAgaWYgKCFncm91cC5wYWdlcyB8fCAhQXJyYXkuaXNBcnJheShncm91cC5wYWdlcykpIHtcbiAgICAgICAgICBlcnJvcnMucHVzaChgbmF2aWdhdGlvblske2luZGV4fV06IHBhZ2VzIG11c3QgYmUgYW4gYXJyYXlgKTtcbiAgICAgICAgfVxuICAgICAgfSk7XG4gICAgfSBlbHNlIGlmICh0eXBlb2YgY29uZmlnLm5hdmlnYXRpb24gPT09ICdvYmplY3QnKSB7XG4gICAgICAvLyBOZXcgZm9ybWF0OiBuYXZpZ2F0aW9uIGlzIGFuIG9iamVjdCB3aXRoIHRhYnNcbiAgICAgIGNvbnN0IG5hdiA9IGNvbmZpZy5uYXZpZ2F0aW9uIGFzIE5hdmlnYXRpb247XG4gICAgICBpZiAobmF2LnRhYnMpIHtcbiAgICAgICAgaWYgKCFBcnJheS5pc0FycmF5KG5hdi50YWJzKSkge1xuICAgICAgICAgIGVycm9ycy5wdXNoKCduYXZpZ2F0aW9uLnRhYnMgbXVzdCBiZSBhbiBhcnJheScpO1xuICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgIG5hdi50YWJzLmZvckVhY2goKHRhYiwgaW5kZXgpID0+IHtcbiAgICAgICAgICAgIGlmICghdGFiLnRhYikge1xuICAgICAgICAgICAgICBlcnJvcnMucHVzaChgbmF2aWdhdGlvbi50YWJzWyR7aW5kZXh9XTogbWlzc2luZyB0YWIgbmFtZWApO1xuICAgICAgICAgICAgfVxuICAgICAgICAgICAgaWYgKCF0YWIudHlwZSkge1xuICAgICAgICAgICAgICBlcnJvcnMucHVzaChgbmF2aWdhdGlvbi50YWJzWyR7aW5kZXh9XTogbWlzc2luZyB0eXBlYCk7XG4gICAgICAgICAgICB9XG4gICAgICAgICAgfSk7XG4gICAgICAgIH1cbiAgICAgIH1cbiAgICB9XG4gIH1cbiAgXG4gIC8vIFZhbGlkYXRlIHRhYnMgKGxlZ2FjeSBmb3JtYXQpXG4gIGlmIChjb25maWcudGFicykge1xuICAgIGlmICghQXJyYXkuaXNBcnJheShjb25maWcudGFicykpIHtcbiAgICAgIGVycm9ycy5wdXNoKCd0YWJzIG11c3QgYmUgYW4gYXJyYXknKTtcbiAgICB9IGVsc2Uge1xuICAgICAgY29uZmlnLnRhYnMuZm9yRWFjaCgodGFiLCBpbmRleCkgPT4ge1xuICAgICAgICBpZiAoIXRhYi5uYW1lKSB7XG4gICAgICAgICAgZXJyb3JzLnB1c2goYHRhYnNbJHtpbmRleH1dOiBtaXNzaW5nIG5hbWVgKTtcbiAgICAgICAgfVxuICAgICAgICBpZiAoIXRhYi51cmwpIHtcbiAgICAgICAgICBlcnJvcnMucHVzaChgdGFic1ske2luZGV4fV06IG1pc3NpbmcgdXJsYCk7XG4gICAgICAgIH1cbiAgICAgIH0pO1xuICAgIH1cbiAgfVxuICBcbiAgLy8gVmFsaWRhdGUgY29sb3JzXG4gIGlmIChjb25maWcuY29sb3JzKSB7XG4gICAgaWYgKGNvbmZpZy5jb2xvcnMucHJpbWFyeSAmJiAhaXNWYWxpZENvbG9yKGNvbmZpZy5jb2xvcnMucHJpbWFyeSkpIHtcbiAgICAgIGVycm9ycy5wdXNoKCdjb2xvcnMucHJpbWFyeSBtdXN0IGJlIGEgdmFsaWQgY29sb3IgKGhleCwgcmdiLCBvciBuYW1lZCBjb2xvciknKTtcbiAgICB9XG4gICAgaWYgKGNvbmZpZy5jb2xvcnMuYWNjZW50ICYmICFpc1ZhbGlkQ29sb3IoY29uZmlnLmNvbG9ycy5hY2NlbnQpKSB7XG4gICAgICBlcnJvcnMucHVzaCgnY29sb3JzLmFjY2VudCBtdXN0IGJlIGEgdmFsaWQgY29sb3IgKGhleCwgcmdiLCBvciBuYW1lZCBjb2xvciknKTtcbiAgICB9XG4gIH1cbiAgXG4gIHJldHVybiB7XG4gICAgdmFsaWQ6IGVycm9ycy5sZW5ndGggPT09IDAsXG4gICAgZXJyb3JzLFxuICB9O1xufVxuXG4vKipcbiAqIENoZWNrIGlmIGEgc3RyaW5nIGlzIGEgdmFsaWQgY29sb3JcbiAqL1xuZnVuY3Rpb24gaXNWYWxpZENvbG9yKGNvbG9yOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgLy8gSGV4IGNvbG9yc1xuICBpZiAoL14jKFswLTlBLUZhLWZdezN9fFswLTlBLUZhLWZdezZ9KSQvLnRlc3QoY29sb3IpKSB7XG4gICAgcmV0dXJuIHRydWU7XG4gIH1cbiAgXG4gIC8vIFJHQi9SR0JBXG4gIGlmICgvXnJnYmE/XFwoLitcXCkkLy50ZXN0KGNvbG9yKSkge1xuICAgIHJldHVybiB0cnVlO1xuICB9XG4gIFxuICAvLyBIU0wvSFNMQVxuICBpZiAoL15oc2xhP1xcKC4rXFwpJC8udGVzdChjb2xvcikpIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxuICBcbiAgLy8gTmFtZWQgY29sb3JzIChiYXNpYyBjaGVjaylcbiAgY29uc3QgbmFtZWRDb2xvcnMgPSBbXG4gICAgJ2JsYWNrJywgJ3doaXRlJywgJ3JlZCcsICdncmVlbicsICdibHVlJywgJ3llbGxvdycsICdjeWFuJywgJ21hZ2VudGEnLFxuICAgICdncmF5JywgJ2dyZXknLCAnb3JhbmdlJywgJ3B1cnBsZScsICdwaW5rJywgJ2Jyb3duJyxcbiAgXTtcbiAgaWYgKG5hbWVkQ29sb3JzLmluY2x1ZGVzKGNvbG9yLnRvTG93ZXJDYXNlKCkpKSB7XG4gICAgcmV0dXJuIHRydWU7XG4gIH1cbiAgXG4gIHJldHVybiBmYWxzZTtcbn1cblxuLyoqXG4gKiBHZXQgdGhlIGNvbnRlbnQgZGlyZWN0b3J5IGZyb20gY29uZmlnIG9yIGRlZmF1bHRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldENvbnRlbnREaXIoY29uZmlnOiBEb2NzQ29uZmlnLCBwcm9qZWN0Um9vdDogc3RyaW5nKTogc3RyaW5nIHtcbiAgLy8gRm9yIG5vdywgY29udGVudCBpcyBhdCB0aGUgcHJvamVjdCByb290XG4gIC8vIENvdWxkIGJlIG1hZGUgY29uZmlndXJhYmxlIGluIHRoZSBmdXR1cmVcbiAgcmV0dXJuIHByb2plY3RSb290O1xufVxuIl19

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default API URL for DevDoc services
+ * Used for subdomain checks, project registration, deployment, etc.
+ */
+export declare const DEFAULT_API_URL = "https://api.devdoc.sh";
+/**
+ * Default domain suffix for deployed documentation sites
+ */
+export declare const DOCS_DOMAIN_SUFFIX = ".devdoc.sh";

package/dist/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCS_DOMAIN_SUFFIX = exports.DEFAULT_API_URL = void 0;
+/**
+ * Default API URL for DevDoc services
+ * Used for subdomain checks, project registration, deployment, etc.
+ */
+exports.DEFAULT_API_URL = 'https://api.devdoc.sh';
+/**
+ * Default domain suffix for deployed documentation sites
+ */
+exports.DOCS_DOMAIN_SUFFIX = '.devdoc.sh';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7O0dBR0c7QUFDVSxRQUFBLGVBQWUsR0FBRyx1QkFBdUIsQ0FBQTtBQUV0RDs7R0FFRztBQUNVLFFBQUEsa0JBQWtCLEdBQUcsWUFBWSxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBEZWZhdWx0IEFQSSBVUkwgZm9yIERldkRvYyBzZXJ2aWNlc1xuICogVXNlZCBmb3Igc3ViZG9tYWluIGNoZWNrcywgcHJvamVjdCByZWdpc3RyYXRpb24sIGRlcGxveW1lbnQsIGV0Yy5cbiAqL1xuZXhwb3J0IGNvbnN0IERFRkFVTFRfQVBJX1VSTCA9ICdodHRwczovL2FwaS5kZXZkb2Muc2gnXG5cbi8qKlxuICogRGVmYXVsdCBkb21haW4gc3VmZml4IGZvciBkZXBsb3llZCBkb2N1bWVudGF0aW9uIHNpdGVzXG4gKi9cbmV4cG9ydCBjb25zdCBET0NTX0RPTUFJTl9TVUZGSVggPSAnLmRldmRvYy5zaCdcbiJdfQ==

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @brainfish/devdoc
+ *
+ * Documentation framework for developers
+ */
+export { loadConfig, validateConfig } from './config';
+export type { DocsConfig, NavigationGroup, Tab } from './config';

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @brainfish/devdoc
+ *
+ * Documentation framework for developers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = exports.loadConfig = void 0;
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_1.validateConfig; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7OztBQUVILG1DQUFzRDtBQUE3QyxvR0FBQSxVQUFVLE9BQUE7QUFBRSx3R0FBQSxjQUFjLE9BQUEiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBicmFpbmZpc2gvZGV2ZG9jXG4gKiBcbiAqIERvY3VtZW50YXRpb24gZnJhbWV3b3JrIGZvciBkZXZlbG9wZXJzXG4gKi9cblxuZXhwb3J0IHsgbG9hZENvbmZpZywgdmFsaWRhdGVDb25maWcgfSBmcm9tICcuL2NvbmZpZyc7XG5leHBvcnQgdHlwZSB7IERvY3NDb25maWcsIE5hdmlnYXRpb25Hcm91cCwgVGFiIH0gZnJvbSAnLi9jb25maWcnO1xuIl19

package/dist/utils/logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Simple logger utility for CLI output
+ */
+export declare const logger: {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    log(message: string): void;
+    newline(): void;
+    cyan(text: string): string;
+    green(text: string): string;
+    yellow(text: string): string;
+    red(text: string): string;
+};

package/dist/utils/logger.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Simple logger utility for CLI output
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    gray: '\x1b[90m',
+};
+function formatMessage(color, prefix, message) {
+    return `${color}${prefix}${colors.reset} ${message}`;
+}
+exports.logger = {
+    info(message) {
+        console.log(formatMessage(colors.blue, '○', message));
+    },
+    success(message) {
+        console.log(formatMessage(colors.green, '✓', message));
+    },
+    warn(message) {
+        console.log(formatMessage(colors.yellow, '⚠', message));
+    },
+    error(message) {
+        console.error(formatMessage(colors.red, '✗', message));
+    },
+    debug(message) {
+        if (process.env.DEBUG || process.env.DEVDOC_DEBUG) {
+            console.log(formatMessage(colors.gray, '⋯', message));
+        }
+    },
+    // Plain log without prefix
+    log(message) {
+        console.log(message);
+    },
+    // Empty line
+    newline() {
+        console.log('');
+    },
+    // Color helpers for inline formatting
+    cyan(text) {
+        return `${colors.cyan}${text}${colors.reset}`;
+    },
+    green(text) {
+        return `${colors.green}${text}${colors.reset}`;
+    },
+    yellow(text) {
+        return `${colors.yellow}${text}${colors.reset}`;
+    },
+    red(text) {
+        return `${colors.red}${text}${colors.reset}`;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2xvZ2dlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7O0dBRUc7OztBQUVILE1BQU0sTUFBTSxHQUFHO0lBQ2IsS0FBSyxFQUFFLFNBQVM7SUFDaEIsR0FBRyxFQUFFLFVBQVU7SUFDZixLQUFLLEVBQUUsVUFBVTtJQUNqQixNQUFNLEVBQUUsVUFBVTtJQUNsQixJQUFJLEVBQUUsVUFBVTtJQUNoQixPQUFPLEVBQUUsVUFBVTtJQUNuQixJQUFJLEVBQUUsVUFBVTtJQUNoQixLQUFLLEVBQUUsVUFBVTtJQUNqQixJQUFJLEVBQUUsVUFBVTtDQUNqQixDQUFDO0FBRUYsU0FBUyxhQUFhLENBQUMsS0FBYSxFQUFFLE1BQWMsRUFBRSxPQUFlO0lBQ25FLE9BQU8sR0FBRyxLQUFLLEdBQUcsTUFBTSxHQUFHLE1BQU0sQ0FBQyxLQUFLLElBQUksT0FBTyxFQUFFLENBQUM7QUFDdkQsQ0FBQztBQUVZLFFBQUEsTUFBTSxHQUFHO0lBQ3BCLElBQUksQ0FBQyxPQUFlO1FBQ2xCLE9BQU8sQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxJQUFJLEVBQUUsR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDeEQsQ0FBQztJQUVELE9BQU8sQ0FBQyxPQUFlO1FBQ3JCLE9BQU8sQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDekQsQ0FBQztJQUVELElBQUksQ0FBQyxPQUFlO1FBQ2xCLE9BQU8sQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDMUQsQ0FBQztJQUVELEtBQUssQ0FBQyxPQUFlO1FBQ25CLE9BQU8sQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDekQsQ0FBQztJQUVELEtBQUssQ0FBQyxPQUFlO1FBQ25CLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxLQUFLLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxZQUFZLEVBQUUsQ0FBQztZQUNsRCxPQUFPLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLEdBQUcsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDO1FBQ3hELENBQUM7SUFDSCxDQUFDO0lBRUQsMkJBQTJCO0lBQzNCLEdBQUcsQ0FBQyxPQUFlO1FBQ2pCLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDdkIsQ0FBQztJQUVELGFBQWE7SUFDYixPQUFPO1FBQ0wsT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNsQixDQUFDO0lBRUQsc0NBQXNDO0lBQ3RDLElBQUksQ0FBQyxJQUFZO1FBQ2YsT0FBTyxHQUFHLE1BQU0sQ0FBQyxJQUFJLEdBQUcsSUFBSSxHQUFHLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUNoRCxDQUFDO0lBRUQsS0FBSyxDQUFDLElBQVk7UUFDaEIsT0FBTyxHQUFHLE1BQU0sQ0FBQyxLQUFLLEdBQUcsSUFBSSxHQUFHLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUNqRCxDQUFDO0lBRUQsTUFBTSxDQUFDLElBQVk7UUFDakIsT0FBTyxHQUFHLE1BQU0sQ0FBQyxNQUFNLEdBQUcsSUFBSSxHQUFHLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUNsRCxDQUFDO0lBRUQsR0FBRyxDQUFDLElBQVk7UUFDZCxPQUFPLEdBQUcsTUFBTSxDQUFDLEdBQUcsR0FBRyxJQUFJLEdBQUcsTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQy9DLENBQUM7Q0FDRixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTaW1wbGUgbG9nZ2VyIHV0aWxpdHkgZm9yIENMSSBvdXRwdXRcbiAqL1xuXG5jb25zdCBjb2xvcnMgPSB7XG4gIHJlc2V0OiAnXFx4MWJbMG0nLFxuICByZWQ6ICdcXHgxYlszMW0nLFxuICBncmVlbjogJ1xceDFiWzMybScsXG4gIHllbGxvdzogJ1xceDFiWzMzbScsXG4gIGJsdWU6ICdcXHgxYlszNG0nLFxuICBtYWdlbnRhOiAnXFx4MWJbMzVtJyxcbiAgY3lhbjogJ1xceDFiWzM2bScsXG4gIHdoaXRlOiAnXFx4MWJbMzdtJyxcbiAgZ3JheTogJ1xceDFiWzkwbScsXG59O1xuXG5mdW5jdGlvbiBmb3JtYXRNZXNzYWdlKGNvbG9yOiBzdHJpbmcsIHByZWZpeDogc3RyaW5nLCBtZXNzYWdlOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gYCR7Y29sb3J9JHtwcmVmaXh9JHtjb2xvcnMucmVzZXR9ICR7bWVzc2FnZX1gO1xufVxuXG5leHBvcnQgY29uc3QgbG9nZ2VyID0ge1xuICBpbmZvKG1lc3NhZ2U6IHN0cmluZyk6IHZvaWQge1xuICAgIGNvbnNvbGUubG9nKGZvcm1hdE1lc3NhZ2UoY29sb3JzLmJsdWUsICfil4snLCBtZXNzYWdlKSk7XG4gIH0sXG5cbiAgc3VjY2VzcyhtZXNzYWdlOiBzdHJpbmcpOiB2b2lkIHtcbiAgICBjb25zb2xlLmxvZyhmb3JtYXRNZXNzYWdlKGNvbG9ycy5ncmVlbiwgJ+KckycsIG1lc3NhZ2UpKTtcbiAgfSxcblxuICB3YXJuKG1lc3NhZ2U6IHN0cmluZyk6IHZvaWQge1xuICAgIGNvbnNvbGUubG9nKGZvcm1hdE1lc3NhZ2UoY29sb3JzLnllbGxvdywgJ+KaoCcsIG1lc3NhZ2UpKTtcbiAgfSxcblxuICBlcnJvcihtZXNzYWdlOiBzdHJpbmcpOiB2b2lkIHtcbiAgICBjb25zb2xlLmVycm9yKGZvcm1hdE1lc3NhZ2UoY29sb3JzLnJlZCwgJ+KclycsIG1lc3NhZ2UpKTtcbiAgfSxcblxuICBkZWJ1ZyhtZXNzYWdlOiBzdHJpbmcpOiB2b2lkIHtcbiAgICBpZiAocHJvY2Vzcy5lbnYuREVCVUcgfHwgcHJvY2Vzcy5lbnYuREVWRE9DX0RFQlVHKSB7XG4gICAgICBjb25zb2xlLmxvZyhmb3JtYXRNZXNzYWdlKGNvbG9ycy5ncmF5LCAn4ouvJywgbWVzc2FnZSkpO1xuICAgIH1cbiAgfSxcblxuICAvLyBQbGFpbiBsb2cgd2l0aG91dCBwcmVmaXhcbiAgbG9nKG1lc3NhZ2U6IHN0cmluZyk6IHZvaWQge1xuICAgIGNvbnNvbGUubG9nKG1lc3NhZ2UpO1xuICB9LFxuXG4gIC8vIEVtcHR5IGxpbmVcbiAgbmV3bGluZSgpOiB2b2lkIHtcbiAgICBjb25zb2xlLmxvZygnJyk7XG4gIH0sXG5cbiAgLy8gQ29sb3IgaGVscGVycyBmb3IgaW5saW5lIGZvcm1hdHRpbmdcbiAgY3lhbih0ZXh0OiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIHJldHVybiBgJHtjb2xvcnMuY3lhbn0ke3RleHR9JHtjb2xvcnMucmVzZXR9YDtcbiAgfSxcblxuICBncmVlbih0ZXh0OiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIHJldHVybiBgJHtjb2xvcnMuZ3JlZW59JHt0ZXh0fSR7Y29sb3JzLnJlc2V0fWA7XG4gIH0sXG5cbiAgeWVsbG93KHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gICAgcmV0dXJuIGAke2NvbG9ycy55ZWxsb3d9JHt0ZXh0fSR7Y29sb3JzLnJlc2V0fWA7XG4gIH0sXG5cbiAgcmVkKHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gICAgcmV0dXJuIGAke2NvbG9ycy5yZWR9JHt0ZXh0fSR7Y29sb3JzLnJlc2V0fWA7XG4gIH0sXG59O1xuIl19

package/dist/utils/paths.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Get the renderer directory
+ *
+ * The renderer is bundled with the package at:
+ * - Development: packages/devdoc/renderer (built by scripts/build.js)
+ * - Published: node_modules/@brainfish/devdoc/renderer
+ */
+export declare function getRendererDir(): string | null;
+/**
+ * Check if we're running in development mode (from source)
+ */
+export declare function isDevelopment(): boolean;
+/**
+ * Get the package root directory
+ */
+export declare function getPackageRoot(): string;

package/dist/utils/paths.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRendererDir = getRendererDir;
+exports.isDevelopment = isDevelopment;
+exports.getPackageRoot = getPackageRoot;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+/**
+ * Get the renderer directory
+ *
+ * The renderer is bundled with the package at:
+ * - Development: packages/devdoc/renderer (built by scripts/build.js)
+ * - Published: node_modules/@brainfish/devdoc/renderer
+ */
+function getRendererDir() {
+    // __dirname is dist/utils when compiled
+    const distDir = __dirname;
+    const packageRoot = path_1.default.resolve(distDir, '../..');
+    // Check for bundled renderer
+    const rendererDir = path_1.default.join(packageRoot, 'renderer');
+    if (fs_extra_1.default.existsSync(rendererDir) && fs_extra_1.default.existsSync(path_1.default.join(rendererDir, 'package.json'))) {
+        return rendererDir;
+    }
+    // Development fallback: look for the main app
+    // When developing locally, the renderer might not be built yet
+    const devAppDir = path_1.default.resolve(packageRoot, '../..');
+    if (fs_extra_1.default.existsSync(path_1.default.join(devAppDir, 'app')) && fs_extra_1.default.existsSync(path_1.default.join(devAppDir, 'package.json'))) {
+        return devAppDir;
+    }
+    return null;
+}
+/**
+ * Check if we're running in development mode (from source)
+ */
+function isDevelopment() {
+    const packageRoot = path_1.default.resolve(__dirname, '../..');
+    const rendererDir = path_1.default.join(packageRoot, 'renderer');
+    // If bundled renderer doesn't exist, we're in dev mode
+    return !fs_extra_1.default.existsSync(rendererDir);
+}
+/**
+ * Get the package root directory
+ */
+function getPackageRoot() {
+    return path_1.default.resolve(__dirname, '../..');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvcGF0aHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFVQSx3Q0FtQkM7QUFLRCxzQ0FNQztBQUtELHdDQUVDO0FBL0NELGdEQUF3QjtBQUN4Qix3REFBMEI7QUFFMUI7Ozs7OztHQU1HO0FBQ0gsU0FBZ0IsY0FBYztJQUM1Qix3Q0FBd0M7SUFDeEMsTUFBTSxPQUFPLEdBQUcsU0FBUyxDQUFDO0lBQzFCLE1BQU0sV0FBVyxHQUFHLGNBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBRW5ELDZCQUE2QjtJQUM3QixNQUFNLFdBQVcsR0FBRyxjQUFJLENBQUMsSUFBSSxDQUFDLFdBQVcsRUFBRSxVQUFVLENBQUMsQ0FBQztJQUN2RCxJQUFJLGtCQUFFLENBQUMsVUFBVSxDQUFDLFdBQVcsQ0FBQyxJQUFJLGtCQUFFLENBQUMsVUFBVSxDQUFDLGNBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxFQUFFLGNBQWMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUN4RixPQUFPLFdBQVcsQ0FBQztJQUNyQixDQUFDO0lBRUQsOENBQThDO0lBQzlDLCtEQUErRDtJQUMvRCxNQUFNLFNBQVMsR0FBRyxjQUFJLENBQUMsT0FBTyxDQUFDLFdBQVcsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNyRCxJQUFJLGtCQUFFLENBQUMsVUFBVSxDQUFDLGNBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEtBQUssQ0FBQyxDQUFDLElBQUksa0JBQUUsQ0FBQyxVQUFVLENBQUMsY0FBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsY0FBYyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3RHLE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFFRCxPQUFPLElBQUksQ0FBQztBQUNkLENBQUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLGFBQWE7SUFDM0IsTUFBTSxXQUFXLEdBQUcsY0FBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDckQsTUFBTSxXQUFXLEdBQUcsY0FBSSxDQUFDLElBQUksQ0FBQyxXQUFXLEVBQUUsVUFBVSxDQUFDLENBQUM7SUFFdkQsdURBQXVEO0lBQ3ZELE9BQU8sQ0FBQyxrQkFBRSxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsQ0FBQztBQUNyQyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixjQUFjO0lBQzVCLE9BQU8sY0FBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFDMUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0IGZzIGZyb20gJ2ZzLWV4dHJhJztcblxuLyoqXG4gKiBHZXQgdGhlIHJlbmRlcmVyIGRpcmVjdG9yeVxuICogXG4gKiBUaGUgcmVuZGVyZXIgaXMgYnVuZGxlZCB3aXRoIHRoZSBwYWNrYWdlIGF0OlxuICogLSBEZXZlbG9wbWVudDogcGFja2FnZXMvZGV2ZG9jL3JlbmRlcmVyIChidWlsdCBieSBzY3JpcHRzL2J1aWxkLmpzKVxuICogLSBQdWJsaXNoZWQ6IG5vZGVfbW9kdWxlcy9AYnJhaW5maXNoL2RldmRvYy9yZW5kZXJlclxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0UmVuZGVyZXJEaXIoKTogc3RyaW5nIHwgbnVsbCB7XG4gIC8vIF9fZGlybmFtZSBpcyBkaXN0L3V0aWxzIHdoZW4gY29tcGlsZWRcbiAgY29uc3QgZGlzdERpciA9IF9fZGlybmFtZTtcbiAgY29uc3QgcGFja2FnZVJvb3QgPSBwYXRoLnJlc29sdmUoZGlzdERpciwgJy4uLy4uJyk7XG4gIFxuICAvLyBDaGVjayBmb3IgYnVuZGxlZCByZW5kZXJlclxuICBjb25zdCByZW5kZXJlckRpciA9IHBhdGguam9pbihwYWNrYWdlUm9vdCwgJ3JlbmRlcmVyJyk7XG4gIGlmIChmcy5leGlzdHNTeW5jKHJlbmRlcmVyRGlyKSAmJiBmcy5leGlzdHNTeW5jKHBhdGguam9pbihyZW5kZXJlckRpciwgJ3BhY2thZ2UuanNvbicpKSkge1xuICAgIHJldHVybiByZW5kZXJlckRpcjtcbiAgfVxuICBcbiAgLy8gRGV2ZWxvcG1lbnQgZmFsbGJhY2s6IGxvb2sgZm9yIHRoZSBtYWluIGFwcFxuICAvLyBXaGVuIGRldmVsb3BpbmcgbG9jYWxseSwgdGhlIHJlbmRlcmVyIG1pZ2h0IG5vdCBiZSBidWlsdCB5ZXRcbiAgY29uc3QgZGV2QXBwRGlyID0gcGF0aC5yZXNvbHZlKHBhY2thZ2VSb290LCAnLi4vLi4nKTtcbiAgaWYgKGZzLmV4aXN0c1N5bmMocGF0aC5qb2luKGRldkFwcERpciwgJ2FwcCcpKSAmJiBmcy5leGlzdHNTeW5jKHBhdGguam9pbihkZXZBcHBEaXIsICdwYWNrYWdlLmpzb24nKSkpIHtcbiAgICByZXR1cm4gZGV2QXBwRGlyO1xuICB9XG4gIFxuICByZXR1cm4gbnVsbDtcbn1cblxuLyoqXG4gKiBDaGVjayBpZiB3ZSdyZSBydW5uaW5nIGluIGRldmVsb3BtZW50IG1vZGUgKGZyb20gc291cmNlKVxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNEZXZlbG9wbWVudCgpOiBib29sZWFuIHtcbiAgY29uc3QgcGFja2FnZVJvb3QgPSBwYXRoLnJlc29sdmUoX19kaXJuYW1lLCAnLi4vLi4nKTtcbiAgY29uc3QgcmVuZGVyZXJEaXIgPSBwYXRoLmpvaW4ocGFja2FnZVJvb3QsICdyZW5kZXJlcicpO1xuICBcbiAgLy8gSWYgYnVuZGxlZCByZW5kZXJlciBkb2Vzbid0IGV4aXN0LCB3ZSdyZSBpbiBkZXYgbW9kZVxuICByZXR1cm4gIWZzLmV4aXN0c1N5bmMocmVuZGVyZXJEaXIpO1xufVxuXG4vKipcbiAqIEdldCB0aGUgcGFja2FnZSByb290IGRpcmVjdG9yeVxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0UGFja2FnZVJvb3QoKTogc3RyaW5nIHtcbiAgcmV0dXJuIHBhdGgucmVzb2x2ZShfX2Rpcm5hbWUsICcuLi8uLicpO1xufVxuIl19

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@brainfish-ai/devdoc",
+  "version": "0.1.21",
+  "description": "Documentation framework for developers. Write docs in MDX, preview locally, deploy to Brainfish.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "devdoc": "./bin/devdoc.js"
+  },
+  "scripts": {
+    "build:cli": "tsc",
+    "build:bundle": "node scripts/build.js",
+    "build": "npm run build:cli",
+    "dev": "tsc --watch",
+    "test:dev": "npm run build:cli && cd ../../devdoc-docs && node ../../packages/devdoc/bin/devdoc.js dev",
+    "test:check": "npm run build:cli && cd ../../devdoc-docs && node ../../packages/devdoc/bin/devdoc.js check",
+    "prepublishOnly": "npm run build:bundle"
+  },
+  "keywords": [
+    "documentation",
+    "docs",
+    "mdx",
+    "api-docs",
+    "developer-docs",
+    "cli"
+  ],
+  "author": "Brainfish",
+  "license": "AGPL-3.0",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/fs-extra": "^11.0.4",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "renderer",
+    "templates"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brainfish/devdoc"
+  }
+}

package/renderer/app/api/assets/[...path]/route.ts

@@ -0,0 +1,123 @@
+import { NextRequest, NextResponse } from 'next/server'
+import { head } from '@vercel/blob'
+import path from 'path'
+import fs from 'fs'
+
+// Check if we're in local development mode
+const IS_LOCAL_DEV = !process.env.BLOB_READ_WRITE_TOKEN
+const LOCAL_STORAGE_DIR = path.join(process.cwd(), '.devdoc-storage')
+
+/**
+ * Asset proxy - serves uploaded assets for multi-tenant docs
+ * 
+ * GET /api/assets/[slug]/[...path]
+ * 
+ * This allows MDX files to reference assets as:
+ *   ![logo](/api/assets/my-project/logo.png)
+ * 
+ * Or with the middleware rewrite, simply:
+ *   ![logo](/logo.png)  -> rewrites to /api/assets/[slug]/logo.png
+ */
+export async function GET(
+  request: NextRequest,
+  { params }: { params: Promise<{ path: string[] }> }
+) {
+  try {
+    const { path: pathSegments } = await params
+    
+    if (!pathSegments || pathSegments.length < 2) {
+      return NextResponse.json(
+        { error: 'Invalid asset path' },
+        { status: 400 }
+      )
+    }
+    
+    // First segment is the project slug, rest is the asset path
+    const [slug, ...assetPath] = pathSegments
+    const fileName = assetPath.join('/')
+    
+    if (!slug || !fileName) {
+      return NextResponse.json(
+        { error: 'Missing slug or file path' },
+        { status: 400 }
+      )
+    }
+    
+    // Build blob path
+    const blobPath = `projects/${slug}/assets/${fileName}`
+    
+    if (IS_LOCAL_DEV) {
+      // Local development - serve from filesystem
+      const filePath = path.join(LOCAL_STORAGE_DIR, 'projects', slug, 'assets', fileName)
+      
+      if (!fs.existsSync(filePath)) {
+        return NextResponse.json(
+          { error: 'Asset not found' },
+          { status: 404 }
+        )
+      }
+      
+      const fileBuffer = fs.readFileSync(filePath)
+      const contentType = getContentType(fileName)
+      
+      return new NextResponse(fileBuffer, {
+        status: 200,
+        headers: {
+          'Content-Type': contentType,
+          'Cache-Control': 'public, max-age=31536000, immutable',
+        },
+      })
+    }
+    
+    // Production - fetch from Vercel Blob
+    const blobInfo = await head(blobPath).catch(() => null)
+    
+    if (!blobInfo) {
+      return NextResponse.json(
+        { error: 'Asset not found' },
+        { status: 404 }
+      )
+    }
+    
+    // Redirect to the blob URL (more efficient than proxying)
+    return NextResponse.redirect(blobInfo.url, {
+      status: 302,
+      headers: {
+        'Cache-Control': 'public, max-age=31536000, immutable',
+      },
+    })
+    
+  } catch (error) {
+    console.error('[Asset Proxy] Error:', error)
+    return NextResponse.json(
+      { error: 'Failed to serve asset' },
+      { status: 500 }
+    )
+  }
+}
+
+/**
+ * Get content type from file extension
+ */
+function getContentType(fileName: string): string {
+  const ext = fileName.split('.').pop()?.toLowerCase()
+  const types: Record<string, string> = {
+    'jpg': 'image/jpeg',
+    'jpeg': 'image/jpeg',
+    'png': 'image/png',
+    'gif': 'image/gif',
+    'webp': 'image/webp',
+    'svg': 'image/svg+xml',
+    'ico': 'image/x-icon',
+    'pdf': 'application/pdf',
+    'mp4': 'video/mp4',
+    'webm': 'video/webm',
+    'mp3': 'audio/mpeg',
+    'wav': 'audio/wav',
+    'woff': 'font/woff',
+    'woff2': 'font/woff2',
+    'ttf': 'font/ttf',
+    'otf': 'font/otf',
+  }
+  return types[ext || ''] || 'application/octet-stream'
+}