@dogsbay/format-openapi 0.2.0-beta.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import type { FormatPlugin } from "@dogsbay/types";
+export declare const plugin: FormatPlugin;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAGxE,eAAO,MAAM,MAAM,EAAE,YAiBpB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,16 @@
+import { detectOpenApiSource, parseOpenApiSpec } from "./parse.js";
+export const plugin = {
+    name: "openapi",
+    canImport: true,
+    canExport: false,
+    detectSource: (path) => detectOpenApiSource(path),
+    importOptions: [],
+    exportOptions: [],
+    async import(source, opts) {
+        return parseOpenApiSpec(source, {
+            hrefPrefix: typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : undefined,
+            section: typeof opts.section === "string" ? opts.section : undefined,
+        });
+    },
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;IACzD,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IAEjB,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAA6B;QAE7B,OAAO,gBAAgB,CAAC,MAAM,EAAE;YAC9B,UAAU,EAAE,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YAC7E,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACrE,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/code-samples.d.ts

@@ -0,0 +1,16 @@
+import type { CodeSample } from "./types.js";
+/**
+ * Code-sample resolution.
+ *
+ * Order of preference per `(method, path)`:
+ *   1. Vendor extension `x-codeSamples` / `x-code-samples` on the
+ *      operation (Redoc convention). Hand-curated by the spec author;
+ *      assumed strictly better than anything we'd generate.
+ *   2. Auto-generated curl + Python + TypeScript samples derived from
+ *      `(method, path, baseUrl)`.
+ *
+ * The Redoc spec uses `x-codeSamples` (camelCase). Some older specs
+ * use `x-code-samples` (kebab). Honour both.
+ */
+export declare function resolveCodeSamples(operation: any, method: string, path: string, baseUrl: string): CodeSample[];
+//# sourceMappingURL=code-samples.d.ts.map

package/dist/code-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-samples.d.ts","sourceRoot":"","sources":["../src/code-samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;GAYG;AAEH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAId"}

package/dist/code-samples.js

@@ -0,0 +1,68 @@
+/**
+ * Code-sample resolution.
+ *
+ * Order of preference per `(method, path)`:
+ *   1. Vendor extension `x-codeSamples` / `x-code-samples` on the
+ *      operation (Redoc convention). Hand-curated by the spec author;
+ *      assumed strictly better than anything we'd generate.
+ *   2. Auto-generated curl + Python + TypeScript samples derived from
+ *      `(method, path, baseUrl)`.
+ *
+ * The Redoc spec uses `x-codeSamples` (camelCase). Some older specs
+ * use `x-code-samples` (kebab). Honour both.
+ */
+export function resolveCodeSamples(operation, method, path, baseUrl) {
+    const vendor = readVendorSamples(operation);
+    if (vendor.length > 0)
+        return vendor;
+    return generateCodeSamples(method, path, baseUrl);
+}
+function readVendorSamples(operation) {
+    const raw = (operation && (operation["x-codeSamples"] || operation["x-code-samples"])) ||
+        [];
+    if (!Array.isArray(raw))
+        return [];
+    const samples = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const language = typeof entry.lang === "string" && entry.lang
+            ? entry.lang
+            : typeof entry.language === "string" && entry.language
+                ? entry.language
+                : undefined;
+        const code = typeof entry.source === "string" ? entry.source : undefined;
+        if (!language || !code)
+            continue;
+        const sample = { language, code };
+        if (typeof entry.label === "string" && entry.label)
+            sample.label = entry.label;
+        samples.push(sample);
+    }
+    return samples;
+}
+function generateCodeSamples(method, path, baseUrl) {
+    const url = `${baseUrl}${path}`;
+    const upper = method.toUpperCase();
+    return [
+        {
+            language: "curl",
+            code: upper === "GET"
+                ? `curl "${url}" \\\n  -H "Accept: application/json"`
+                : `curl -X ${upper} "${url}" \\\n  -H "Content-Type: application/json" \\\n  -H "Accept: application/json"`,
+        },
+        {
+            language: "python",
+            code: upper === "GET"
+                ? `import requests\n\nresponse = requests.get("${url}")\ndata = response.json()`
+                : `import requests\n\nresponse = requests.${method}(\n    "${url}",\n    json={}\n)\ndata = response.json()`,
+        },
+        {
+            language: "typescript",
+            code: upper === "GET"
+                ? `const response = await fetch("${url}");\nconst data = await response.json();`
+                : `const response = await fetch("${url}", {\n  method: "${upper}",\n  headers: { "Content-Type": "application/json" },\n  body: JSON.stringify({}),\n});\nconst data = await response.json();`,
+        },
+    ];
+}
+//# sourceMappingURL=code-samples.js.map

package/dist/code-samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-samples.js","sourceRoot":"","sources":["../src/code-samples.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,kBAAkB,CAChC,SAAc,EACd,MAAc,EACd,IAAY,EACZ,OAAe;IAEf,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACrC,OAAO,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAc;IACvC,MAAM,GAAG,GACP,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1E,EAAE,CAAC;IACL,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,QAAQ,GACZ,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI;YAC1C,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ;gBACpD,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAChB,CAAC,CAAC,SAAS,CAAC;QAClB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;YAAE,SAAS;QACjC,MAAM,MAAM,GAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC9C,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAc,EACd,IAAY,EACZ,OAAe;IAEf,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAEnC,OAAO;QACL;YACE,QAAQ,EAAE,MAAM;YAChB,IAAI,EACF,KAAK,KAAK,KAAK;gBACb,CAAC,CAAC,SAAS,GAAG,uCAAuC;gBACrD,CAAC,CAAC,WAAW,KAAK,KAAK,GAAG,iFAAiF;SAChH;QACD;YACE,QAAQ,EAAE,QAAQ;YAClB,IAAI,EACF,KAAK,KAAK,KAAK;gBACb,CAAC,CAAC,+CAA+C,GAAG,4BAA4B;gBAChF,CAAC,CAAC,0CAA0C,MAAM,WAAW,GAAG,4CAA4C;SACjH;QACD;YACE,QAAQ,EAAE,YAAY;YACtB,IAAI,EACF,KAAK,KAAK,KAAK;gBACb,CAAC,CAAC,iCAAiC,GAAG,0CAA0C;gBAChF,CAAC,CAAC,iCAAiC,GAAG,oBAAoB,KAAK,+HAA+H;SACnM;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { SchemaProperty, Parameter, ResponseDef, CodeSample, EndpointProps, } from "./types.js";
+export { parseOpenApiSpec, detectOpenApiSource, detectSpecPath } from "./parse.js";
+export type { ParseOpenApiOptions } from "./parse.js";
+export { operationToSlug, slugifyTag } from "./slug.js";
+export { resolveCodeSamples } from "./code-samples.js";
+export { plugin } from "./cli.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { parseOpenApiSpec, detectOpenApiSource, detectSpecPath } from "./parse.js";
+export { operationToSlug, slugifyTag } from "./slug.js";
+export { resolveCodeSamples } from "./code-samples.js";
+export { plugin } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,20 @@
+import type { ExportPage, NavItem } from "@dogsbay/types";
+/** Auto-detect spec location given the configured source path. */
+export declare function detectSpecPath(sourcePath: string): string | null;
+/**
+ * detectSource: returns true if the path looks like an OpenAPI source
+ * (a directory containing openapi.{yaml,yml,json} or a file with that
+ * extension whose contents declare `openapi:`).
+ */
+export declare function detectOpenApiSource(path: string): boolean;
+export interface ParseOpenApiOptions {
+    /** When the importer wants nav hrefs to start with this prefix. */
+    hrefPrefix?: string;
+    /** Sub-path within the namespace for emitted pages, e.g. "api". */
+    section?: string;
+}
+export declare function parseOpenApiSpec(sourcePath: string, options?: ParseOpenApiOptions): Promise<{
+    pages: ExportPage[];
+    nav: NavItem[];
+}>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,UAAU,EAEV,OAAO,EAER,MAAM,gBAAgB,CAAC;AAqBxB,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmChE;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAazD;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CA4HlD"}

package/dist/parse.js

@@ -0,0 +1,513 @@
+/**
+ * Parse an OpenAPI spec into ExportPage[] + NavItem[].
+ *
+ * Mirrors the demo loader's extraction logic
+ * (`apps/demo/src/lib/openapi-loader.ts`), but emits the Dogsbay
+ * universal shape: ExportPage where `tree` carries an `endpoint`
+ * TreeNode with all operation data in props. format-astro's
+ * serializer renders that node by emitting `<ApiLayout>` + friends.
+ *
+ * Inputs come in three forms:
+ *   - A directory containing `openapi.{yaml,yml,json}` (auto-detect).
+ *   - A direct path to a spec file.
+ *   - An HTTP(S) URL.
+ *
+ * Tag overview pages and a root info page are emitted alongside the
+ * per-operation pages so the namespace renders as a self-contained
+ * mini-site.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { resolve, join, isAbsolute } from "node:path";
+import { dereference } from "@scalar/openapi-parser";
+import { parse as parseYaml } from "yaml";
+import { operationToSlug, slugifyTag } from "./slug.js";
+import { resolveCodeSamples } from "./code-samples.js";
+const HTTP_METHODS = [
+    "get",
+    "post",
+    "put",
+    "patch",
+    "delete",
+    "head",
+    "options",
+];
+/** Auto-detect spec location given the configured source path. */
+export function detectSpecPath(sourcePath) {
+    if (sourcePath.startsWith("http://") || sourcePath.startsWith("https://")) {
+        return sourcePath;
+    }
+    if (existsSync(sourcePath)) {
+        const stat = (() => {
+            try {
+                return readFileSync(sourcePath);
+            }
+            catch {
+                return null;
+            }
+        })();
+        // If it's a file, return as-is. If it's a directory, look inside.
+        try {
+            const isFile = existsSync(sourcePath) && stat !== null;
+            if (isFile && !isDirectory(sourcePath))
+                return sourcePath;
+        }
+        catch {
+            // fall through to directory probe
+        }
+        if (isDirectory(sourcePath)) {
+            const candidates = [
+                "openapi.yaml",
+                "openapi.yml",
+                "openapi.json",
+                "spec.yaml",
+                "spec.yml",
+                "spec.json",
+            ];
+            for (const name of candidates) {
+                const p = join(sourcePath, name);
+                if (existsSync(p))
+                    return p;
+            }
+        }
+    }
+    return null;
+}
+function isDirectory(p) {
+    try {
+        const { statSync } = require("node:fs");
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * detectSource: returns true if the path looks like an OpenAPI source
+ * (a directory containing openapi.{yaml,yml,json} or a file with that
+ * extension whose contents declare `openapi:`).
+ */
+export function detectOpenApiSource(path) {
+    const detected = detectSpecPath(path);
+    if (!detected)
+        return false;
+    if (detected.startsWith("http"))
+        return true;
+    // Sanity-check the file content briefly to avoid false-positives on
+    // arbitrary YAML/JSON sitting in a sibling directory.
+    try {
+        const head = readFileSync(detected, "utf-8").slice(0, 2048);
+        return /^\s*"?openapi"?\s*[:=]/m.test(head) ||
+            /^\s*"?swagger"?\s*[:=]/m.test(head);
+    }
+    catch {
+        return false;
+    }
+}
+export async function parseOpenApiSpec(sourcePath, options = {}) {
+    const specPath = detectSpecPath(sourcePath);
+    if (!specPath) {
+        throw new Error(`OpenAPI spec not found at ${sourcePath}. Looked for openapi.{yaml,yml,json} ` +
+            `and spec.{yaml,yml,json} (or expected a direct file path / URL).`);
+    }
+    const raw = await readSpecText(specPath);
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        parsed = parseYaml(raw);
+    }
+    const { schema: spec } = await dereference(parsed);
+    if (!spec) {
+        throw new Error(`Failed to dereference OpenAPI spec at ${specPath}`);
+    }
+    const baseUrl = spec.servers?.[0]?.url || "";
+    const hrefPrefix = normalisePrefix(options.hrefPrefix);
+    const pages = [];
+    // Collect tag descriptions (from spec.tags[]) for tag overview pages.
+    const tagDescriptions = new Map();
+    for (const t of spec.tags || []) {
+        if (t?.name)
+            tagDescriptions.set(t.name, t.description || "");
+    }
+    // Walk operations.
+    const paths = spec.paths || {};
+    const tagToOps = new Map();
+    const untagged = [];
+    for (const [path, pathItem] of Object.entries(paths)) {
+        if (!pathItem)
+            continue;
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const opTags = Array.isArray(operation.tags)
+                ? operation.tags
+                : [];
+            const primaryTag = opTags[0];
+            const tagSlug = primaryTag ? slugifyTag(primaryTag) : "";
+            const opSlug = operationToSlug(method, path, operation.operationId);
+            const slug = tagSlug ? `${tagSlug}/${opSlug}` : opSlug;
+            const props = {
+                method,
+                path,
+                baseUrl,
+                summary: operation.summary || undefined,
+                description: operation.description || undefined,
+                operationId: operation.operationId || undefined,
+                tags: opTags.length > 0 ? opTags : undefined,
+                deprecated: operation.deprecated === true ? true : undefined,
+                parameters: extractParameters(operation, pathItem),
+                ...extractRequestBody(operation),
+                responses: extractResponses(operation),
+                codeSamples: resolveCodeSamples(operation, method, path, baseUrl),
+            };
+            const title = operation.summary || `${method.toUpperCase()} ${path}`;
+            const tree = [
+                {
+                    type: "endpoint",
+                    props: props,
+                },
+            ];
+            const headings = [{ depth: 1, slug: opSlug, text: title }];
+            pages.push({
+                slug,
+                title,
+                tree,
+                headings,
+            });
+            const summary = {
+                slug,
+                title,
+                method,
+                path,
+                deprecated: operation.deprecated === true,
+            };
+            if (primaryTag) {
+                const arr = tagToOps.get(primaryTag) || [];
+                arr.push(summary);
+                tagToOps.set(primaryTag, arr);
+            }
+            else {
+                untagged.push(summary);
+            }
+        }
+    }
+    // Tag overview pages.
+    for (const [tagName, ops] of tagToOps) {
+        const tagSlug = slugifyTag(tagName);
+        const description = tagDescriptions.get(tagName) || "";
+        pages.push(buildTagPage(tagName, tagSlug, description, ops));
+    }
+    // Root info page.
+    const info = spec.info || {};
+    pages.push(buildInfoPage(info.title || "API Reference", info.description || "", info.version || ""));
+    // Build nav: tag groups in declaration order, with operations as
+    // children. Untagged operations land under a synthetic "Other" group
+    // so they're discoverable but visually separated.
+    const nav = buildNav(spec, pages, tagToOps, untagged, hrefPrefix);
+    return { pages, nav };
+}
+async function readSpecText(specPath) {
+    if (specPath.startsWith("http://") || specPath.startsWith("https://")) {
+        const r = await fetch(specPath);
+        return await r.text();
+    }
+    const abs = isAbsolute(specPath) ? specPath : resolve(specPath);
+    return await readFile(abs, "utf-8");
+}
+function normalisePrefix(p) {
+    if (!p)
+        return "";
+    return p.replace(/\/+$/, "");
+}
+function schemaToType(schema) {
+    if (!schema)
+        return "any";
+    if (schema.type === "array") {
+        const itemType = schema.items ? schemaToType(schema.items) : "any";
+        return `${itemType}[]`;
+    }
+    return schema.type || "any";
+}
+function extractSchemaProperties(schema, requiredFields) {
+    if (!schema?.properties)
+        return [];
+    const required = requiredFields || schema.required || [];
+    return Object.entries(schema.properties).map(([name, prop]) => {
+        const result = {
+            name,
+            type: schemaToType(prop),
+            required: required.includes(name),
+        };
+        if (prop.description)
+            result.description = prop.description;
+        if (prop.nullable)
+            result.nullable = true;
+        if (prop.format)
+            result.format = prop.format;
+        if (prop.enum)
+            result.enum = prop.enum;
+        if (prop.default !== undefined)
+            result.default = prop.default;
+        if (prop.example !== undefined)
+            result.example = prop.example;
+        if (prop.type === "object" && prop.properties) {
+            result.properties = extractSchemaProperties(prop);
+        }
+        if (prop.type === "array" && prop.items) {
+            if (prop.items.type === "object" && prop.items.properties) {
+                result.items = extractSchemaProperties(prop.items);
+            }
+        }
+        return result;
+    });
+}
+function extractParameters(operation, pathItem) {
+    const params = [];
+    const allParams = [
+        ...(pathItem.parameters || []),
+        ...(operation.parameters || []),
+    ];
+    // Operation-level wins over path-level on (name, in) collision.
+    const seen = new Map();
+    for (const p of allParams) {
+        if (!p?.name || !p?.in)
+            continue;
+        seen.set(`${p.name}:${p.in}`, p);
+    }
+    for (const p of seen.values()) {
+        const param = {
+            name: p.name,
+            in: p.in,
+            type: schemaToType(p.schema),
+            required: p.required || false,
+        };
+        if (p.description)
+            param.description = p.description;
+        if (p.schema?.default !== undefined) {
+            param.default = String(p.schema.default);
+        }
+        if (p.schema?.enum)
+            param.enum = p.schema.enum;
+        if (p.deprecated)
+            param.deprecated = true;
+        params.push(param);
+    }
+    return params;
+}
+function extractRequestBody(operation) {
+    const body = operation.requestBody;
+    if (!body?.content)
+        return {};
+    const mediaType = body.content["application/json"] ||
+        Object.values(body.content)[0];
+    if (!mediaType?.schema)
+        return {};
+    return {
+        requestBody: extractSchemaProperties(mediaType.schema),
+        requestBodyExample: generateExampleFromSchema(mediaType.schema),
+    };
+}
+function extractResponses(operation) {
+    if (!operation.responses)
+        return [];
+    return Object.entries(operation.responses)
+        .filter(([status]) => status !== "default")
+        .map(([status, resp]) => {
+        const result = {
+            status,
+            description: resp.description,
+        };
+        if (resp.content) {
+            const contentTypeKey = resp.content["application/json"]
+                ? "application/json"
+                : Object.keys(resp.content)[0];
+            const mediaType = resp.content[contentTypeKey];
+            if (contentTypeKey)
+                result.contentType = contentTypeKey;
+            if (mediaType?.schema) {
+                const rawSchema = mediaType.schema;
+                const schema = rawSchema.type === "array" && rawSchema.items
+                    ? rawSchema.items
+                    : rawSchema;
+                result.schema = extractSchemaProperties(schema);
+                result.example = generateExampleFromSchema(rawSchema);
+            }
+        }
+        return result;
+    })
+        .sort((a, b) => a.status.localeCompare(b.status));
+}
+function generateExampleFromSchema(schema) {
+    if (!schema)
+        return undefined;
+    if (schema.example !== undefined)
+        return schema.example;
+    switch (schema.type) {
+        case "object": {
+            if (!schema.properties)
+                return {};
+            const obj = {};
+            for (const [name, prop] of Object.entries(schema.properties)) {
+                obj[name] = generateExampleFromSchema(prop);
+            }
+            return obj;
+        }
+        case "array":
+            return schema.items ? [generateExampleFromSchema(schema.items)] : [];
+        case "string": {
+            if (schema.enum)
+                return schema.enum[0];
+            if (schema.format === "date-time")
+                return "2024-01-01T00:00:00Z";
+            if (schema.format === "email")
+                return "user@example.com";
+            if (schema.format === "uri" || schema.format === "url") {
+                return "https://example.com";
+            }
+            if (schema.format === "uuid") {
+                return "550e8400-e29b-41d4-a716-446655440000";
+            }
+            if (schema.default !== undefined)
+                return schema.default;
+            return "string";
+        }
+        case "integer":
+            return schema.example ?? schema.default ?? 0;
+        case "number":
+            return schema.example ?? schema.default ?? 0.0;
+        case "boolean":
+            return schema.example ?? schema.default ?? true;
+        default:
+            return null;
+    }
+}
+function buildTagPage(tagName, tagSlug, description, ops) {
+    const tree = [
+        {
+            type: "heading",
+            props: { level: 1, id: tagSlug },
+            children: [{ type: "prose", html: escapeHtml(tagName) }],
+        },
+    ];
+    if (description) {
+        tree.push({ type: "prose", html: paragraphHtml(description) });
+    }
+    const items = ops.map((op) => ({
+        type: "list-item",
+        children: [
+            {
+                type: "prose",
+                html: `<a href="${escapeAttr(op.slug)}"><code>${op.method.toUpperCase()}</code> ${escapeHtml(op.path)}</a>${op.deprecated ? ' <span class="text-muted-foreground">(deprecated)</span>' : ""}`,
+            },
+        ],
+    }));
+    tree.push({ type: "unordered-list", children: items });
+    return {
+        slug: tagSlug,
+        title: tagName,
+        tree,
+        headings: [{ depth: 1, slug: tagSlug, text: tagName }],
+    };
+}
+function buildInfoPage(title, description, version) {
+    const tree = [
+        {
+            type: "heading",
+            props: { level: 1, id: "api-reference" },
+            children: [{ type: "prose", html: escapeHtml(title) }],
+        },
+    ];
+    if (version) {
+        tree.push({
+            type: "prose",
+            html: `<p class="text-sm text-muted-foreground">Version ${escapeHtml(version)}</p>`,
+        });
+    }
+    if (description) {
+        tree.push({ type: "prose", html: paragraphHtml(description) });
+    }
+    return {
+        slug: "index",
+        title,
+        tree,
+        headings: [{ depth: 1, slug: "api-reference", text: title }],
+    };
+}
+function buildNav(spec, pages, tagToOps, untagged, hrefPrefix) {
+    const nav = [];
+    const root = {
+        label: (spec.info && spec.info.title) || "API Reference",
+        href: hrefHref(hrefPrefix, "index"),
+    };
+    nav.push(root);
+    // Use spec.tags[] order when present so authors control nav order.
+    const declaredTagOrder = Array.isArray(spec.tags)
+        ? spec.tags.map((t) => t?.name).filter(Boolean)
+        : [];
+    const seenTags = new Set();
+    const tagOrder = [];
+    for (const t of declaredTagOrder) {
+        if (tagToOps.has(t)) {
+            tagOrder.push(t);
+            seenTags.add(t);
+        }
+    }
+    for (const t of tagToOps.keys()) {
+        if (!seenTags.has(t))
+            tagOrder.push(t);
+    }
+    for (const tagName of tagOrder) {
+        const ops = tagToOps.get(tagName) || [];
+        const tagSlug = slugifyTag(tagName);
+        nav.push({
+            label: tagName,
+            href: hrefHref(hrefPrefix, tagSlug),
+            children: ops
+                .slice()
+                .sort(byMethodThenPath)
+                .map((op) => ({
+                label: op.title,
+                href: hrefHref(hrefPrefix, op.slug),
+            })),
+        });
+    }
+    if (untagged.length > 0) {
+        nav.push({
+            label: "Other",
+            children: untagged
+                .slice()
+                .sort(byMethodThenPath)
+                .map((op) => ({
+                label: op.title,
+                href: hrefHref(hrefPrefix, op.slug),
+            })),
+        });
+    }
+    return nav;
+}
+function byMethodThenPath(a, b) {
+    const m = a.method.localeCompare(b.method);
+    if (m !== 0)
+        return m;
+    return a.path.localeCompare(b.path);
+}
+function hrefHref(prefix, slug) {
+    const p = prefix ? `${prefix}/` : "/";
+    return slug === "index" ? p : `${p}${slug}`;
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function escapeAttr(s) {
+    return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+function paragraphHtml(text) {
+    return `<p>${escapeHtml(text)}</p>`;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/slug.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Operation slug derivation.
+ *
+ * Decision: prefer `operationId` when the spec author has set one
+ * (~70% of public specs do). It's the spec-declared stable handle —
+ * paths drift (refactors, parameter additions), operationId doesn't,
+ * so bookmarks and deep links survive. Fall back to `{method}-{path}`
+ * when operationId is absent.
+ */
+export declare function operationToSlug(method: string, path: string, operationId?: string): string;
+/**
+ * Slugify a tag name for use in URLs and nav grouping.
+ * Tag "Pet Store" → "pet-store".
+ */
+export declare function slugifyTag(tag: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAWR;AAYD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/dist/slug.js

@@ -0,0 +1,41 @@
+/**
+ * Operation slug derivation.
+ *
+ * Decision: prefer `operationId` when the spec author has set one
+ * (~70% of public specs do). It's the spec-declared stable handle —
+ * paths drift (refactors, parameter additions), operationId doesn't,
+ * so bookmarks and deep links survive. Fall back to `{method}-{path}`
+ * when operationId is absent.
+ */
+export function operationToSlug(method, path, operationId) {
+    if (operationId) {
+        return slugifyOperationId(operationId);
+    }
+    return `${method}-${path}`
+        .replace(/[{}]/g, "")
+        .replace(/\//g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "")
+        .replace(/-+/g, "-")
+        .toLowerCase();
+}
+function slugifyOperationId(id) {
+    return id
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/_/g, "-")
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Slugify a tag name for use in URLs and nav grouping.
+ * Tag "Pet Store" → "pet-store".
+ */
+export function slugifyTag(tag) {
+    return tag
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAY,EACZ,WAAoB;IAEpB,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE;SACvB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAU;IACpC,OAAO,EAAE;SACN,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG;SACP,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Internal types matching the API component prop shapes.
+ *
+ * These flow into the `endpoint` TreeNode's props verbatim, so any
+ * change here must be matched in the format-astro `endpointToAstro`
+ * serializer case.
+ */
+export interface SchemaProperty {
+    name: string;
+    type: string;
+    description?: string;
+    required?: boolean;
+    nullable?: boolean;
+    format?: string;
+    enum?: string[];
+    default?: unknown;
+    example?: unknown;
+    /** Nested object properties. */
+    properties?: SchemaProperty[];
+    /** Item shape for arrays of objects. */
+    items?: SchemaProperty[];
+}
+export interface Parameter {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    type: string;
+    required?: boolean;
+    description?: string;
+    default?: string;
+    enum?: string[];
+    deprecated?: boolean;
+}
+export interface ResponseDef {
+    status: string;
+    description?: string;
+    schema?: SchemaProperty[];
+    example?: unknown;
+    contentType?: string;
+}
+export interface CodeSample {
+    language: string;
+    label?: string;
+    code: string;
+}
+/**
+ * Props for the `endpoint` TreeNode. format-astro's serializer reads
+ * these to render an `<ApiLayout>` + friends.
+ */
+export interface EndpointProps {
+    method: string;
+    path: string;
+    baseUrl: string;
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    deprecated?: boolean;
+    parameters?: Parameter[];
+    requestBody?: SchemaProperty[];
+    requestBodyExample?: unknown;
+    responses?: ResponseDef[];
+    codeSamples?: CodeSample[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,wCAAwC;IACxC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Internal types matching the API component prop shapes.
+ *
+ * These flow into the `endpoint` TreeNode's props verbatim, so any
+ * change here must be matched in the format-astro `endpointToAstro`
+ * serializer case.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@dogsbay/format-openapi",
+  "version": "0.2.0-beta.0",
+  "description": "OpenAPI format plugin for Dogsbay — parse OpenAPI 3.x specs into ExportPage[] for the SSG pipeline",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@scalar/openapi-parser": "^0.10.0",
+    "yaml": "^2.8.3",
+    "@dogsbay/types": "0.2.0-beta.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@dogsbay/format-astro": "0.2.0-beta.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dogsbay/dogsbay.git",
+    "directory": "packages/format-openapi"
+  },
+  "homepage": "https://github.com/dogsbay/dogsbay/tree/main/packages/format-openapi",
+  "bugs": {
+    "url": "https://github.com/dogsbay/dogsbay/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}