blodemd 0.0.4 → 0.0.6

package/packages/@repo/prebuild/dist/openapi.d.ts

@@ -0,0 +1,43 @@
+export interface OpenApiServer {
+    url: string;
+    description?: string;
+}
+export interface OpenApiSpec {
+    openapi?: string;
+    info?: {
+        title?: string;
+        description?: string;
+    };
+    servers?: OpenApiServer[];
+    paths?: Record<string, Record<string, OpenApiOperationSpec>>;
+    components?: Record<string, unknown>;
+}
+export interface OpenApiOperationSpec {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    parameters?: Record<string, unknown>[];
+    requestBody?: Record<string, unknown>;
+    responses?: Record<string, unknown>;
+}
+export interface OpenApiOperation {
+    id: string;
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    tags: string[];
+    parameters: Record<string, unknown>[];
+    requestBody?: Record<string, unknown>;
+    responses?: Record<string, unknown>;
+}
+export declare const parseOpenApiSpec: (raw: string, sourcePath?: string) => OpenApiSpec;
+export declare const loadOpenApiSpec: (absolutePath: string) => Promise<OpenApiSpec>;
+export declare const openApiIdentifier: (method: string, routePath: string) => string;
+export declare const openApiSlug: (method: string, routePath: string, directory?: string) => string;
+export declare const extractOpenApiOperations: (spec: OpenApiSpec, directory?: string) => {
+    bySlug: Map<string, OpenApiOperation>;
+    operations: OpenApiOperation[];
+};
+//# sourceMappingURL=openapi.d.ts.map

package/packages/@repo/prebuild/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,mBAAe,KAAG,WAgB/D,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,KACnB,OAAO,CAAC,WAAW,CACmD,CAAC;AAE1E,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,WAC3B,CAAC;AAEzC,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,kBAAiB,WAUlB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,MAAM,WAAW,EACjB,YAAY,MAAM;;;CA+BnB,CAAC"}

package/packages/@repo/prebuild/dist/openapi.js

@@ -0,0 +1,58 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { normalizePath, slugify } from "@repo/common";
+import YAML from "yaml";
+export const parseOpenApiSpec = (raw, sourcePath = "") => {
+    const ext = path.extname(sourcePath).toLowerCase();
+    if (ext === ".json") {
+        return JSON.parse(raw);
+    }
+    if (ext === ".yaml" || ext === ".yml") {
+        return YAML.parse(raw);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return YAML.parse(raw);
+    }
+};
+export const loadOpenApiSpec = async (absolutePath) => parseOpenApiSpec(await fs.readFile(absolutePath, "utf8"), absolutePath);
+export const openApiIdentifier = (method, routePath) => `${method.toUpperCase()} ${routePath}`;
+export const openApiSlug = (method, routePath, directory = "api") => {
+    const normalized = normalizePath(routePath)
+        .split("/")
+        .map((segment) => segment.replaceAll(/[{}]/g, ""))
+        .filter(Boolean)
+        .join("-");
+    const base = normalized.length ? normalized : "root";
+    const slug = slugify(`${method.toLowerCase()}-${base}`);
+    return normalizePath(path.join(directory, slug));
+};
+export const extractOpenApiOperations = (spec, directory) => {
+    const ops = [];
+    const paths = spec.paths ?? {};
+    for (const [routePath, methods] of Object.entries(paths)) {
+        for (const [method, operation] of Object.entries(methods)) {
+            const upper = method.toUpperCase();
+            const id = operation.operationId ?? openApiIdentifier(upper, routePath);
+            ops.push({
+                description: operation.description,
+                id,
+                method: upper,
+                parameters: operation.parameters ?? [],
+                path: routePath,
+                requestBody: operation.requestBody,
+                responses: operation.responses,
+                summary: operation.summary,
+                tags: operation.tags ?? [],
+            });
+        }
+    }
+    const map = new Map();
+    for (const op of ops) {
+        const slug = openApiSlug(op.method, op.path, directory);
+        map.set(slug, op);
+    }
+    return { bySlug: map, operations: ops };
+};

package/packages/@repo/prebuild/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@repo/prebuild",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./openapi": {
+      "types": "./dist/openapi.d.ts",
+      "import": "./dist/openapi.js",
+      "default": "./dist/openapi.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "check-types": "tsc --noEmit",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt ."
+  },
+  "dependencies": {
+    "@repo/common": "*",
+    "yaml": "^2.8.3"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "*",
+    "@types/node": "^22.19.15",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0",
+    "typescript": "6.0.2",
+    "ultracite": "^7.3.2"
+  }
+}

package/packages/@repo/prebuild/src/index.ts

@@ -0,0 +1,2 @@
+// biome-ignore lint/performance/noBarrelFile: This is the main entry point for the package
+export * from "./openapi.js";

package/packages/@repo/prebuild/src/openapi.ts

@@ -0,0 +1,116 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+import { normalizePath, slugify } from "@repo/common";
+import YAML from "yaml";
+
+export interface OpenApiServer {
+  url: string;
+  description?: string;
+}
+
+export interface OpenApiSpec {
+  openapi?: string;
+  info?: { title?: string; description?: string };
+  servers?: OpenApiServer[];
+  paths?: Record<string, Record<string, OpenApiOperationSpec>>;
+  components?: Record<string, unknown>;
+}
+
+export interface OpenApiOperationSpec {
+  operationId?: string;
+  summary?: string;
+  description?: string;
+  tags?: string[];
+  parameters?: Record<string, unknown>[];
+  requestBody?: Record<string, unknown>;
+  responses?: Record<string, unknown>;
+}
+
+export interface OpenApiOperation {
+  id: string;
+  method: string;
+  path: string;
+  summary?: string;
+  description?: string;
+  tags: string[];
+  parameters: Record<string, unknown>[];
+  requestBody?: Record<string, unknown>;
+  responses?: Record<string, unknown>;
+}
+
+export const parseOpenApiSpec = (raw: string, sourcePath = ""): OpenApiSpec => {
+  const ext = path.extname(sourcePath).toLowerCase();
+
+  if (ext === ".json") {
+    return JSON.parse(raw) as OpenApiSpec;
+  }
+
+  if (ext === ".yaml" || ext === ".yml") {
+    return YAML.parse(raw) as OpenApiSpec;
+  }
+
+  try {
+    return JSON.parse(raw) as OpenApiSpec;
+  } catch {
+    return YAML.parse(raw) as OpenApiSpec;
+  }
+};
+
+export const loadOpenApiSpec = async (
+  absolutePath: string
+): Promise<OpenApiSpec> =>
+  parseOpenApiSpec(await fs.readFile(absolutePath, "utf8"), absolutePath);
+
+export const openApiIdentifier = (method: string, routePath: string) =>
+  `${method.toUpperCase()} ${routePath}`;
+
+export const openApiSlug = (
+  method: string,
+  routePath: string,
+  directory = "api"
+) => {
+  const normalized = normalizePath(routePath)
+    .split("/")
+    .map((segment) => segment.replaceAll(/[{}]/g, ""))
+    .filter(Boolean)
+    .join("-");
+  const base = normalized.length ? normalized : "root";
+  const slug = slugify(`${method.toLowerCase()}-${base}`);
+  return normalizePath(path.join(directory, slug));
+};
+
+export const extractOpenApiOperations = (
+  spec: OpenApiSpec,
+  directory?: string
+) => {
+  const ops: OpenApiOperation[] = [];
+  const paths = spec.paths ?? {};
+
+  for (const [routePath, methods] of Object.entries(paths)) {
+    for (const [method, operation] of Object.entries(methods)) {
+      const upper = method.toUpperCase();
+      const id = operation.operationId ?? openApiIdentifier(upper, routePath);
+
+      ops.push({
+        description: operation.description,
+        id,
+        method: upper,
+        parameters: operation.parameters ?? [],
+        path: routePath,
+        requestBody: operation.requestBody,
+        responses: operation.responses,
+        summary: operation.summary,
+        tags: operation.tags ?? [],
+      });
+    }
+  }
+
+  const map = new Map<string, OpenApiOperation>();
+  for (const op of ops) {
+    const slug = openApiSlug(op.method, op.path, directory);
+    map.set(slug, op);
+  }
+
+  return { bySlug: map, operations: ops };
+};

package/packages/@repo/previewing/dist/blob-source.d.ts

@@ -0,0 +1,16 @@
+import type { CompiledMdxResult, ContentSource } from "./content-source.js";
+export declare class BlobContentSource implements ContentSource {
+    private readonly manifestUrl;
+    private readonly cacheTag?;
+    private manifestPromise?;
+    constructor(manifestUrl: string, cacheTag?: string);
+    private getFetchOptions;
+    private loadManifest;
+    readFile(relativePath: string): Promise<string>;
+    listFiles(directory: string): Promise<string[]>;
+    exists(relativePath: string): Promise<boolean>;
+    resolveUrl(relativePath: string): Promise<string | null>;
+    readCompiledMdx(relativePath: string): Promise<CompiledMdxResult | null>;
+}
+export declare const createBlobSource: (manifestUrl: string, cacheTag?: string) => ContentSource;
+//# sourceMappingURL=blob-source.d.ts.map

package/packages/@repo/previewing/dist/blob-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-source.d.ts","sourceRoot":"","sources":["../src/blob-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA8C5E,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,eAAe,CAAC,CAA+B;gBAE3C,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAKlD,OAAO,CAAC,eAAe;YAaT,YAAY;IA2BpB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY/C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9C,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKxD,eAAe,CACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAuBrC;AAED,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,WAAW,MAAM,KAChB,aAA6D,CAAC"}

package/packages/@repo/previewing/dist/blob-source.js

@@ -0,0 +1,110 @@
+import path from "node:path";
+import { normalizePath } from "@repo/common";
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isBlobManifest = (value) => {
+    if (!isRecord(value) || !Array.isArray(value.files)) {
+        return false;
+    }
+    return value.files.every((file) => {
+        if (!isRecord(file)) {
+            return false;
+        }
+        return typeof file.path === "string" && typeof file.url === "string";
+    });
+};
+const normalizeDirectory = (directory) => {
+    const normalized = normalizePath(path.posix.normalize(directory));
+    if (!normalized || normalized === ".") {
+        return "";
+    }
+    return normalized ? `${normalized}/` : "";
+};
+const normalizeRelativePath = (value) => normalizePath(path.posix.normalize(value));
+export class BlobContentSource {
+    manifestUrl;
+    cacheTag;
+    manifestPromise;
+    constructor(manifestUrl, cacheTag) {
+        this.manifestUrl = manifestUrl;
+        this.cacheTag = cacheTag;
+    }
+    getFetchOptions() {
+        if (!this.cacheTag) {
+            return { cache: "no-store" };
+        }
+        return {
+            next: {
+                revalidate: 3600,
+                tags: [this.cacheTag],
+            },
+        };
+    }
+    async loadManifest() {
+        if (!this.manifestPromise) {
+            this.manifestPromise = (async () => {
+                const response = await fetch(this.manifestUrl, this.getFetchOptions());
+                if (!response.ok) {
+                    throw new Error(`Failed to load deployment manifest: ${response.status}`);
+                }
+                const manifest = (await response.json());
+                if (!isBlobManifest(manifest)) {
+                    throw new Error("Deployment manifest is invalid.");
+                }
+                return new Map(manifest.files.map((file) => [
+                    normalizeRelativePath(file.path),
+                    file.url,
+                ]));
+            })();
+        }
+        return await this.manifestPromise;
+    }
+    async readFile(relativePath) {
+        const url = await this.resolveUrl(relativePath);
+        if (!url) {
+            throw new Error(`Content file "${relativePath}" not found.`);
+        }
+        const response = await fetch(url, this.getFetchOptions());
+        if (!response.ok) {
+            throw new Error(`Failed to load content file: ${response.status}`);
+        }
+        return await response.text();
+    }
+    async listFiles(directory) {
+        const manifest = await this.loadManifest();
+        const prefix = normalizeDirectory(directory);
+        const files = [...manifest.keys()].filter((file) => prefix ? file.startsWith(prefix) : true);
+        // oxlint-disable-next-line eslint-plugin-unicorn/no-array-sort
+        files.sort();
+        return files;
+    }
+    async exists(relativePath) {
+        const manifest = await this.loadManifest();
+        return manifest.has(normalizeRelativePath(relativePath));
+    }
+    async resolveUrl(relativePath) {
+        const manifest = await this.loadManifest();
+        return manifest.get(normalizeRelativePath(relativePath)) ?? null;
+    }
+    async readCompiledMdx(relativePath) {
+        const compiledPath = `_compiled/${normalizeRelativePath(relativePath)}.json`;
+        const url = await this.resolveUrl(compiledPath);
+        if (!url) {
+            return null;
+        }
+        try {
+            const response = await fetch(url, this.getFetchOptions());
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            if (!data.compiledSource || data.version !== 1) {
+                return null;
+            }
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+export const createBlobSource = (manifestUrl, cacheTag) => new BlobContentSource(manifestUrl, cacheTag);

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

@@ -0,0 +1,12 @@
+export interface CompiledMdxResult {
+    compiledSource: string;
+    version: number;
+}
+export interface ContentSource {
+    readFile(relativePath: string): Promise<string>;
+    listFiles(directory: string): Promise<string[]>;
+    exists(relativePath: string): Promise<boolean>;
+    resolveUrl?(relativePath: string): Promise<string | null> | string | null;
+    readCompiledMdx?(relativePath: string): Promise<CompiledMdxResult | null>;
+}
+//# sourceMappingURL=content-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-source.d.ts","sourceRoot":"","sources":["../src/content-source.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1E,eAAe,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAC3E"}

package/packages/@repo/previewing/dist/content-source.js

@@ -0,0 +1 @@
+export {};

package/packages/@repo/previewing/dist/fs-source.d.ts

@@ -0,0 +1,11 @@
+import type { ContentSource } from "./content-source.js";
+export declare class FsContentSource implements ContentSource {
+    private readonly root;
+    constructor(root: string);
+    readFile(relativePath: string): Promise<string>;
+    listFiles(directory: string): Promise<string[]>;
+    exists(relativePath: string): Promise<boolean>;
+    resolveUrl(): string | null;
+}
+export declare const createFsSource: (root: string) => ContentSource;
+//# sourceMappingURL=fs-source.d.ts.map

package/packages/@repo/previewing/dist/fs-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-source.d.ts","sourceRoot":"","sources":["../src/fs-source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoEzD,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAIlB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO/C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAapD,UAAU,IAAI,MAAM,GAAG,IAAI;CAG5B;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,aACnB,CAAC"}

package/packages/@repo/previewing/dist/fs-source.js

@@ -0,0 +1,79 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { normalizePath } from "@repo/common";
+const IGNORED_DIRECTORIES = new Set([
+    "app",
+    "components",
+    "content",
+    "lib",
+    "node_modules",
+    "public",
+]);
+const IGNORED_ROOT_FILES = new Set(["AGENTS.md", "README.md"]);
+const isNotFoundError = (error) => Boolean(error &&
+    typeof error === "object" &&
+    "code" in error &&
+    error.code === "ENOENT");
+const isWithinRoot = (root, candidate) => candidate === root || candidate.startsWith(`${root}${path.sep}`);
+const resolveWithinRoot = (root, relativePath) => {
+    const normalized = normalizePath(relativePath);
+    const absolutePath = path.resolve(root, normalized);
+    if (!isWithinRoot(root, absolutePath)) {
+        throw new Error(`Path "${relativePath}" escapes the content source root.`);
+    }
+    return absolutePath;
+};
+const walkFiles = async (directory, prefix) => {
+    const entries = await fs.readdir(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith(".")) {
+            continue;
+        }
+        const absolutePath = path.join(directory, entry.name);
+        const relativePath = prefix ? path.join(prefix, entry.name) : entry.name;
+        if (entry.isDirectory()) {
+            if (IGNORED_DIRECTORIES.has(entry.name)) {
+                continue;
+            }
+            files.push(...(await walkFiles(absolutePath, relativePath)));
+            continue;
+        }
+        if (entry.isFile()) {
+            if (!prefix && IGNORED_ROOT_FILES.has(entry.name)) {
+                continue;
+            }
+            files.push(normalizePath(relativePath));
+        }
+    }
+    return files;
+};
+export class FsContentSource {
+    root;
+    constructor(root) {
+        this.root = path.resolve(root);
+    }
+    async readFile(relativePath) {
+        return await fs.readFile(resolveWithinRoot(this.root, relativePath), "utf8");
+    }
+    async listFiles(directory) {
+        return await walkFiles(resolveWithinRoot(this.root, directory), "");
+    }
+    async exists(relativePath) {
+        try {
+            await fs.access(resolveWithinRoot(this.root, relativePath));
+            return true;
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    // oxlint-disable-next-line eslint/class-methods-use-this
+    resolveUrl() {
+        return null;
+    }
+}
+export const createFsSource = (root) => new FsContentSource(root);

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

@@ -0,0 +1,120 @@
+import type { ContentType, DocsOpenApiSource, FrontmatterByType, PageMode, SiteConfig } from "@repo/models";
+import type { OpenApiOperation, OpenApiSpec } from "@repo/prebuild";
+import type { ContentSource } from "./content-source.js";
+export { BlobContentSource, createBlobSource } from "./blob-source.js";
+export { createFsSource, FsContentSource } from "./fs-source.js";
+export type { CompiledMdxResult, ContentSource } from "./content-source.js";
+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 UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export type SiteConfigResult = {
+    ok: true;
+    config: SiteConfig;
+    warnings: string[];
+} | {
+    ok: false;
+    errors: string[];
+};
+export type ContentEntry = {
+    kind: "entry";
+    slug: string;
+    title: string;
+    description?: string;
+    hidden?: boolean;
+    type: ContentType;
+    collectionId: string;
+    sourcePath: string;
+    relativePath: string;
+    frontmatter: FrontmatterByType[ContentType];
+} | {
+    kind: "index";
+    slug: string;
+    title: string;
+    description?: string;
+    type: ContentType;
+    collectionId: string;
+};
+export interface ContentIndex {
+    entries: ContentEntry[];
+    bySlug: Map<string, ContentEntry>;
+    byCollection: Map<string, ContentEntry[]>;
+    errors: string[];
+}
+export interface PageMetadata {
+    title?: string;
+    sidebarTitle?: string;
+    icon?: string;
+    iconType?: string;
+    tag?: string;
+    hidden?: boolean;
+    deprecated?: boolean;
+    url?: string;
+    mode?: PageMode;
+    noindex?: boolean;
+    hideFooterPagination?: boolean;
+    hideApiMarker?: boolean;
+    keywords?: string[];
+}
+export interface SearchIndexItem {
+    href?: string;
+    title: string;
+    path: string;
+}
+export interface TocItem {
+    id: string;
+    level: number;
+    title: string;
+}
+export interface UtilityPage {
+    content: string;
+    description?: string;
+    slug: string;
+    title: string;
+}
+export interface UtilityIndex {
+    description?: string;
+    name: string;
+    pages: UtilityPage[];
+}
+export interface UtilityArtifact {
+    content: string;
+    contentType: string;
+    path: string;
+}
+export interface PrebuiltOpenApiEntry {
+    identifier: string;
+    operation: OpenApiOperation;
+    slug: string;
+    source: DocsOpenApiSource;
+    sourceKey: string;
+    spec: OpenApiSpec;
+}
+export declare const buildPageMetadataMap: (index: ContentIndex) => Map<string, PageMetadata>;
+export declare const loadSiteConfig: (source: ContentSource) => Promise<SiteConfigResult>;
+export declare const loadContentSource: (source: ContentSource, relativePath: string) => Promise<string>;
+export declare const buildContentIndex: (source: ContentSource, config: SiteConfig) => Promise<ContentIndex>;
+export declare const extractToc: (source: string) => TocItem[];
+export declare const formatMarkdownPage: (title: string, source: string) => string;
+export declare const formatMarkdownPageSection: (title: string, url: string, source: string) => string;
+export declare const buildSearchIndex: (index: ContentIndex, config: SiteConfig, utilityIndex?: UtilityIndex) => SearchIndexItem[];
+export declare const buildUtilityIndex: (index: ContentIndex, source: ContentSource, config: SiteConfig) => Promise<UtilityIndex>;
+export declare const getPrebuiltUtilityLlmPagePath: (slug: string) => string;
+export declare const buildUtilityArtifacts: (index: UtilityIndex) => UtilityArtifact[];
+export declare const buildTocIndex: (index: ContentIndex, source: ContentSource) => Promise<Map<string, TocItem[]>>;
+export declare const serializeContentIndex: (index: ContentIndex) => string;
+export declare const serializeOpenApiIndex: (entries: PrebuiltOpenApiEntry[]) => string;
+export declare const loadPrebuiltContentIndex: (source: ContentSource) => Promise<ContentIndex | null>;
+export declare const loadPrebuiltOpenApiIndex: (source: ContentSource) => Promise<PrebuiltOpenApiEntry[] | null>;
+export declare const serializeSearchIndex: (items: SearchIndexItem[]) => string;
+export declare const loadPrebuiltSearchIndex: (source: ContentSource) => Promise<SearchIndexItem[] | null>;
+export declare const serializeTocIndex: (itemsBySlug: Map<string, TocItem[]>) => string;
+export declare const loadPrebuiltTocIndex: (source: ContentSource) => Promise<Map<string, TocItem[]> | null>;
+export declare const serializeUtilityIndex: (index: UtilityIndex) => string;
+export declare const loadPrebuiltUtilityIndex: (source: ContentSource) => Promise<UtilityIndex | null>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}