@dogsbay/format-openapi 0.2.0-beta.12 → 0.2.0-beta.120

package/dist/spec-path.js

@@ -0,0 +1,69 @@
+/**
+ * Which spec file a page's `:::openapi{spec}` may name. No dependencies, so
+ * a host can check a path without loading the spec parser
+ * (`@dogsbay/format-openapi/spec-path`); also exported from `./core`.
+ */
+const SPEC_EXT = /\.(ya?ml|json)$/i;
+/**
+ * The content-relative paths `:::openapi{spec}` on the page `slug` may mean,
+ * in the order to try them, or why it may name none.
+ *
+ * The spec path is CONTENT, so it is held to what content may name:
+ *  - a file, never a URL: a page does not get to make the build fetch;
+ *  - `.yaml`, `.yml` or `.json`;
+ *  - inside a content root (the caller checks, after resolving symlinks).
+ *
+ * A leading `/` is the content root. A relative path is tried against the
+ * page's folder, then the page's own folder for an index page (slug
+ * `reference` may be `reference/index.md`). Importers write root-relative
+ * paths, which have no such ambiguity.
+ */
+export function specCandidates(spec, slug) {
+    if (!spec)
+        return { error: "no `spec` on :::openapi" };
+    if (/^[a-z][a-z0-9+.-]*:/i.test(spec) || spec.startsWith("//")) {
+        return { error: `a page may name a spec file, not a URL (${spec})` };
+    }
+    if (/[?#]/.test(spec) || !SPEC_EXT.test(spec)) {
+        return { error: `not a .yaml, .yml or .json file (${spec})` };
+    }
+    const clean = spec.replace(/\\/g, "/");
+    if (clean.startsWith("/"))
+        return { paths: [normalizePath(clean)].filter(isContained) };
+    const dir = slug.includes("/") ? slug.slice(0, slug.lastIndexOf("/")) : "";
+    return { paths: [normalizePath(`${dir}/${clean}`), normalizePath(`${slug}/${clean}`)].filter(isContained) };
+}
+/**
+ * The spec file `:::openapi{spec}` on the page `slug` names, or an error.
+ * `lookup` answers for one content-relative path (dogsbay-ssg: its file
+ * map; the CLI: each content root, symlinks resolved).
+ */
+export function findSpec(spec, slug, lookup) {
+    const c = specCandidates(spec, slug);
+    if ("error" in c)
+        return c;
+    let escaped = c.paths.length === 0;
+    for (const p of c.paths) {
+        const found = lookup(p);
+        if (found === "outside")
+            escaped = true;
+        else if (found)
+            return found;
+    }
+    return { error: escaped ? `the spec resolves outside the content root (${spec})` : `spec not found (${spec})` };
+}
+/** `a/./b/../c` → `a/c`; a path that climbs above the root keeps its leading `..`. */
+function normalizePath(p) {
+    const out = [];
+    for (const seg of p.split("/")) {
+        if (!seg || seg === ".")
+            continue;
+        if (seg === ".." && out.length && out[out.length - 1] !== "..")
+            out.pop();
+        else
+            out.push(seg);
+    }
+    return out.join("/");
+}
+const isContained = (p) => p !== "" && p !== ".." && !p.startsWith("../");
+//# sourceMappingURL=spec-path.js.map

package/dist/spec-path.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/format-openapi",
-  "version": "0.2.0-beta.12",
+  "version": "0.2.0-beta.120",
   "description": "OpenAPI format plugin for Dogsbay — parse OpenAPI 3.x specs into ExportPage[] for the SSG pipeline",
   "type": "module",
   "main": "dist/index.js",
@@ -10,9 +10,21 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./spec-path": {
+      "types": "./dist/spec-path.d.ts",
+      "import": "./dist/spec-path.js"
+    },
     "./cli": {
       "types": "./dist/cli.d.ts",
       "import": "./dist/cli.js"
+    },
+    "./embed": {
+      "types": "./dist/embed.d.ts",
+      "import": "./dist/embed.js"
     }
   },
   "files": [
@@ -20,15 +32,18 @@
     "README.md"
   ],
   "dependencies": {
-    "@scalar/openapi-parser": "^0.10.0",
-    "yaml": "^2.8.3",
-    "@dogsbay/types": "0.2.0-beta.12"
+    "@scalar/openapi-parser": "^0.10.17",
+    "markdown-it": "^14.3.0",
+    "yaml": "^2.9.0",
+    "@dogsbay/types": "0.2.0-beta.120"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0",
-    "@dogsbay/format-astro": "0.2.0-beta.12"
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^25.9.5",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "@dogsbay/format-astro": "0.2.0-beta.120"
   },
   "license": "MIT",
   "repository": {