blodemd 0.0.13 → 0.0.14

package/packages/@repo/previewing/dist/config-loader.d.ts

@@ -0,0 +1,134 @@
+import type { SiteConfig } from "@repo/models";
+import type { ContentSource } from "./content-source.js";
+import type { SiteConfigResult } from "./types.js";
+export declare const loadSiteConfig: (source: ContentSource) => Promise<SiteConfigResult>;
+export declare const getDocsCollection: (config: SiteConfig) => {
+    id: string;
+    type: "site" | "blog" | "docs" | "courses" | "products" | "notes" | "forms" | "sheets" | "slides" | "todos";
+    index?: {
+        slug: string;
+        description?: string | undefined;
+        hidden?: boolean | undefined;
+        title?: string | undefined;
+    } | undefined;
+    navigation?: {
+        global?: {
+            anchors?: {
+                href: string;
+                label: string;
+            }[] | undefined;
+            links?: {
+                href: string;
+                label: string;
+            }[] | undefined;
+        } | undefined;
+        groups?: {
+            expanded?: boolean | undefined;
+            group?: string | undefined;
+            hidden?: boolean | undefined;
+            openapi?: string | {
+                source: string;
+                basePath?: string | undefined;
+                directory?: string | undefined;
+                include?: string[] | undefined;
+            } | undefined;
+            pages?: string[] | undefined;
+        }[] | undefined;
+        hidden?: string[] | undefined;
+        languages?: {
+            label: string;
+            url: string;
+            locale?: string | undefined;
+        }[] | undefined;
+        pages?: string[] | undefined;
+        tabs?: {
+            label: string;
+            groups?: {
+                expanded?: boolean | undefined;
+                group?: string | undefined;
+                hidden?: boolean | undefined;
+                openapi?: string | {
+                    source: string;
+                    basePath?: string | undefined;
+                    directory?: string | undefined;
+                    include?: string[] | undefined;
+                } | undefined;
+                pages?: string[] | undefined;
+            }[] | undefined;
+            href?: string | undefined;
+            icon?: string | undefined;
+            pages?: string[] | undefined;
+        }[] | undefined;
+        versions?: {
+            label: string;
+            url: string;
+        }[] | undefined;
+    } | undefined;
+    openapi?: string | string[] | {
+        source: string;
+        basePath?: string | undefined;
+        directory?: string | undefined;
+        include?: string[] | undefined;
+    } | undefined;
+    root?: string | undefined;
+    slugPrefix?: string | undefined;
+    sort?: {
+        direction?: "asc" | "desc" | undefined;
+        field?: "date" | "title" | "order" | "price" | undefined;
+    } | undefined;
+} | undefined;
+export declare const getDocsNavigation: (config: SiteConfig) => {
+    global?: {
+        anchors?: {
+            href: string;
+            label: string;
+        }[] | undefined;
+        links?: {
+            href: string;
+            label: string;
+        }[] | undefined;
+    } | undefined;
+    groups?: {
+        expanded?: boolean | undefined;
+        group?: string | undefined;
+        hidden?: boolean | undefined;
+        openapi?: string | {
+            source: string;
+            basePath?: string | undefined;
+            directory?: string | undefined;
+            include?: string[] | undefined;
+        } | undefined;
+        pages?: string[] | undefined;
+    }[] | undefined;
+    hidden?: string[] | undefined;
+    languages?: {
+        label: string;
+        url: string;
+        locale?: string | undefined;
+    }[] | undefined;
+    pages?: string[] | undefined;
+    tabs?: {
+        label: string;
+        groups?: {
+            expanded?: boolean | undefined;
+            group?: string | undefined;
+            hidden?: boolean | undefined;
+            openapi?: string | {
+                source: string;
+                basePath?: string | undefined;
+                directory?: string | undefined;
+                include?: string[] | undefined;
+            } | undefined;
+            pages?: string[] | undefined;
+        }[] | undefined;
+        href?: string | undefined;
+        icon?: string | undefined;
+        pages?: string[] | undefined;
+    }[] | undefined;
+    versions?: {
+        label: string;
+        url: string;
+    }[] | undefined;
+} | undefined;
+export declare const getDocsCollectionWithNavigation: (config: SiteConfig) => SiteConfig["collections"][number] | undefined;
+//# sourceMappingURL=config-loader.d.ts.map

package/packages/@repo/previewing/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,cAAc,CAAC;AAI3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoRnD,eAAO,MAAM,cAAc,GACzB,QAAQ,aAAa,KACpB,OAAO,CAAC,gBAAgB,CAU1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aACiB,CAAC;AAEtE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aACQ,CAAC;AAE7D,eAAO,MAAM,+BAA+B,GAC1C,QAAQ,UAAU,KACjB,UAAU,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,SAStC,CAAC"}

package/packages/@repo/previewing/dist/config-loader.js

@@ -0,0 +1,231 @@
+import path from "node:path";
+import { normalizePath } from "@repo/common";
+import { validateDocsConfig, validateSiteConfig } from "@repo/validation";
+import { LEGACY_PROJECT_NAME_FALLBACK_WARNING } from "./constants.js";
+const DOCS_CONFIG_FILE = "docs.json";
+const defaultLinkLabel = (input) => {
+    if (input.label) {
+        return input.label;
+    }
+    if (input.type === "github") {
+        return "GitHub";
+    }
+    if (input.type === "discord") {
+        return "Discord";
+    }
+    try {
+        return new URL(input.href).hostname;
+    }
+    catch {
+        return input.href;
+    }
+};
+// oxlint-disable-next-line eslint/complexity
+const mapDocsConfig = (docs) => {
+    const navigation = {
+        global: docs.navbar?.links?.length || docs.navigation.global?.anchors?.length
+            ? {
+                anchors: docs.navigation.global?.anchors?.map((anchor) => ({
+                    href: anchor.href,
+                    label: anchor.anchor,
+                })),
+                links: docs.navbar?.links?.map((link) => ({
+                    href: link.href,
+                    label: defaultLinkLabel(link),
+                })),
+            }
+            : undefined,
+        groups: docs.navigation.groups?.map((group) => ({
+            expanded: group.expanded,
+            group: group.group,
+            hidden: group.hidden,
+            pages: group.root
+                ? [
+                    group.root,
+                    ...(group.pages ?? []).filter((page) => page !== group.root),
+                ]
+                : group.pages,
+        })),
+        languages: docs.navigation.languages?.map((language) => ({
+            label: language.language,
+            locale: language.language,
+            url: language.href,
+        })),
+        pages: docs.navigation.pages,
+        tabs: docs.navigation.tabs?.map((tab) => ({
+            groups: tab.groups?.map((group) => ({
+                expanded: group.expanded,
+                group: group.group,
+                hidden: group.hidden,
+                pages: group.root
+                    ? [
+                        group.root,
+                        ...(group.pages ?? []).filter((page) => page !== group.root),
+                    ]
+                    : group.pages,
+            })),
+            href: tab.href,
+            icon: tab.icon,
+            label: tab.tab,
+            pages: tab.pages,
+        })),
+        versions: docs.navigation.versions?.map((version) => ({
+            label: version.version,
+            url: version.href,
+        })),
+    };
+    return {
+        collections: [
+            {
+                id: "docs",
+                navigation,
+                openapi: docs.api?.openapi,
+                root: "",
+                type: "docs",
+            },
+        ],
+        contextual: docs.contextual,
+        description: docs.description,
+        favicon: typeof docs.favicon === "string" ? docs.favicon : docs.favicon?.light,
+        features: {
+            rightToc: true,
+            search: true,
+            themeToggle: docs.appearance?.strict !== true,
+            toc: true,
+        },
+        logo: docs.logo
+            ? {
+                dark: typeof docs.logo === "string" ? docs.logo : docs.logo.dark,
+                href: typeof docs.logo === "string" ? undefined : docs.logo.href,
+                light: typeof docs.logo === "string" ? docs.logo : docs.logo.light,
+            }
+            : undefined,
+        name: docs.name,
+        navigation,
+        openapiProxy: {
+            enabled: docs.api?.playground?.proxy !== false &&
+                Boolean(docs.api?.openapi || docs.api?.asyncapi),
+        },
+        seo: docs.seo,
+        slug: docs.slug,
+    };
+};
+const getProjectWarnings = (config) => config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
+const readJsonConfig = async (source, relativePath) => JSON.parse(await source.readFile(relativePath));
+const normalizeRefPath = (baseDirectory, reference) => {
+    if (reference.startsWith("/") ||
+        reference.startsWith("\\") ||
+        reference.startsWith("http://") ||
+        reference.startsWith("https://")) {
+        throw new Error(`Invalid $ref "${reference}". Only relative JSON files are supported.`);
+    }
+    const normalized = normalizePath(path.posix.join(baseDirectory, reference));
+    if (!normalized ||
+        normalized === "." ||
+        normalized.startsWith("../") ||
+        normalized.includes("/../")) {
+        throw new Error(`Invalid $ref "${reference}".`);
+    }
+    return normalized;
+};
+const resolveJsonRefs = async (source, value, baseDirectory, seen) => {
+    if (Array.isArray(value)) {
+        return await Promise.all(value.map((item) => resolveJsonRefs(source, item, baseDirectory, seen)));
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const record = value;
+    const reference = record.$ref;
+    if (typeof reference === "string") {
+        const resolvedPath = normalizeRefPath(baseDirectory, reference);
+        if (seen.has(resolvedPath)) {
+            throw new Error(`Circular $ref detected for "${resolvedPath}".`);
+        }
+        const nextSeen = new Set(seen);
+        // oxlint-disable-next-line eslint-plugin-unicorn/no-immediate-mutation
+        nextSeen.add(resolvedPath);
+        const referenced = await readJsonConfig(source, resolvedPath);
+        const referencedValue = await resolveJsonRefs(source, referenced, path.posix.dirname(resolvedPath) === "."
+            ? ""
+            : normalizePath(path.posix.dirname(resolvedPath)), nextSeen);
+        const siblingEntries = Object.entries(record).filter(([key]) => key !== "$ref");
+        if (!siblingEntries.length ||
+            !referencedValue ||
+            typeof referencedValue !== "object" ||
+            Array.isArray(referencedValue)) {
+            return referencedValue;
+        }
+        const siblingValue = await resolveJsonRefs(source, Object.fromEntries(siblingEntries), baseDirectory, seen);
+        return {
+            ...referencedValue,
+            ...siblingValue,
+        };
+    }
+    const resolvedEntries = await Promise.all(Object.entries(record).map(async ([key, entryValue]) => [
+        key,
+        await resolveJsonRefs(source, entryValue, baseDirectory, seen),
+    ]));
+    return Object.fromEntries(resolvedEntries);
+};
+const readResolvedJsonConfig = async (source, relativePath) => await resolveJsonRefs(source, await readJsonConfig(source, relativePath), path.posix.dirname(relativePath) === "."
+    ? ""
+    : normalizePath(path.posix.dirname(relativePath)), new Set([relativePath]));
+const loadDocsConfig = async (source) => {
+    if (!(await source.exists(DOCS_CONFIG_FILE))) {
+        return null;
+    }
+    try {
+        const parsed = await readResolvedJsonConfig(source, DOCS_CONFIG_FILE);
+        // Try SiteConfig format first (has collections, theme, colors, etc.)
+        const siteResult = validateSiteConfig(parsed);
+        if (siteResult.success) {
+            return {
+                config: siteResult.data,
+                ok: true,
+                warnings: getProjectWarnings(siteResult.data),
+            };
+        }
+        // Fall back to DocsConfig format (Mintlify-compatible) and map to SiteConfig
+        const docsResult = validateDocsConfig(parsed);
+        if (docsResult.success) {
+            return {
+                config: mapDocsConfig(docsResult.data),
+                ok: true,
+                warnings: getProjectWarnings(docsResult.data),
+            };
+        }
+        return { errors: docsResult.errors, ok: false };
+    }
+    catch (error) {
+        return {
+            errors: [
+                error instanceof Error
+                    ? error.message
+                    : `Failed to load ${DOCS_CONFIG_FILE}`,
+            ],
+            ok: false,
+        };
+    }
+};
+export const loadSiteConfig = async (source) => {
+    const docsConfig = await loadDocsConfig(source);
+    if (docsConfig) {
+        return docsConfig;
+    }
+    return {
+        errors: [`${DOCS_CONFIG_FILE} not found.`],
+        ok: false,
+    };
+};
+export const getDocsCollection = (config) => config.collections.find((collection) => collection.type === "docs");
+export const getDocsNavigation = (config) => getDocsCollection(config)?.navigation ?? config.navigation;
+export const getDocsCollectionWithNavigation = (config) => {
+    const docsCollection = getDocsCollection(config);
+    const docsNavigation = getDocsNavigation(config);
+    return docsCollection &&
+        docsNavigation &&
+        docsCollection.navigation !== docsNavigation
+        ? { ...docsCollection, navigation: docsNavigation }
+        : docsCollection;
+};

package/packages/@repo/previewing/dist/constants.d.ts

@@ -0,0 +1,15 @@
+export declare const PREBUILT_INDEX_PATH = "_content-index.json";
+export declare const PREBUILT_OPENAPI_INDEX_PATH = "_openapi-index.json";
+export declare const PREBUILT_SEARCH_INDEX_PATH = "_search-index.json";
+export declare const PREBUILT_TOC_INDEX_PATH = "_toc-index.json";
+export declare const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
+export declare const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
+export declare const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
+export declare const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export declare const PREBUILT_UTILITY_LLMS_SEGMENT_PREFIX = "_utility/llms/";
+export declare const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export declare const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
+export declare const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export declare const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
+export declare const NEWLINE_REGEX: RegExp;
+//# sourceMappingURL=constants.d.ts.map

package/packages/@repo/previewing/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAC9D,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,oCAAoC,mBAAmB,CAAC;AACrE,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAC/E,eAAO,MAAM,iCAAiC,qBAAqB,CAAC;AACpE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,oCAAoC,wGACsD,CAAC;AAExG,eAAO,MAAM,aAAa,QAAU,CAAC"}

package/packages/@repo/previewing/dist/constants.js

@@ -0,0 +1,14 @@
+export const PREBUILT_INDEX_PATH = "_content-index.json";
+export const PREBUILT_OPENAPI_INDEX_PATH = "_openapi-index.json";
+export const PREBUILT_SEARCH_INDEX_PATH = "_search-index.json";
+export const PREBUILT_TOC_INDEX_PATH = "_toc-index.json";
+export const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
+export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
+export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
+export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export const PREBUILT_UTILITY_LLMS_SEGMENT_PREFIX = "_utility/llms/";
+export const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
+export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
+export const NEWLINE_REGEX = /\r?\n/;

package/packages/@repo/previewing/dist/content-index.d.ts

@@ -0,0 +1,7 @@
+import type { SiteConfig } from "@repo/models";
+import type { ContentSource } from "./content-source.js";
+import type { ContentEntry, ContentIndex, PageMetadata } from "./types.js";
+export declare const buildPageMetadataMap: (index: ContentIndex) => Map<string, PageMetadata>;
+export declare const buildContentIndex: (source: ContentSource, config: SiteConfig) => Promise<ContentIndex>;
+export declare const shouldIncludeSearchEntry: (entry: ContentEntry, pageMetadataMap: Map<string, PageMetadata>, config: SiteConfig) => boolean;
+//# sourceMappingURL=content-index.d.ts.map

package/packages/@repo/previewing/dist/content-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-index.d.ts","sourceRoot":"","sources":["../src/content-index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,UAAU,EACX,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI3E,eAAO,MAAM,oBAAoB,GAC/B,OAAO,YAAY,KAClB,GAAG,CAAC,MAAM,EAAE,YAAY,CAiD1B,CAAC;AA8MF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,aAAa,EACrB,QAAQ,UAAU,KACjB,OAAO,CAAC,YAAY,CAkFtB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,OAAO,YAAY,EACnB,iBAAiB,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC1C,QAAQ,UAAU,YAiBnB,CAAC"}