sourcey 3.6.4 → 3.6.6

package/dist/themes/registry.d.ts

@@ -0,0 +1,20 @@
+export declare const themeDefinitions: {
+    readonly default: {
+        client: string;
+        css: string[];
+    };
+    readonly minimal: {
+        client: string;
+        css: string[];
+    };
+    readonly "api-first": {
+        client: string;
+        css: string[];
+    };
+    readonly reader: {
+        readonly client: "reader";
+        readonly css: readonly ["default/sourcey.css", "reader/sourcey.css"];
+    };
+};
+export type ThemeName = keyof typeof themeDefinitions;
+//# sourceMappingURL=registry.d.ts.map

package/dist/themes/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/themes/registry.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAKnB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,gBAAgB,CAAC"}

package/dist/themes/registry.js

@@ -0,0 +1,8 @@
+/** Built-in themes and their packaged assets. Themes may deliberately share a foundation. */
+const foundation = { client: "index", css: ["default/sourcey.css"] };
+export const themeDefinitions = {
+    default: foundation,
+    minimal: foundation,
+    "api-first": foundation,
+    reader: { client: "reader", css: ["default/sourcey.css", "reader/sourcey.css"] },
+};

package/dist/utils/server-warnings.d.ts

@@ -0,0 +1,4 @@
+import type { NormalizedSpec } from "../core/types.js";
+export declare function findPlaceholderServerUrls(spec: Pick<NormalizedSpec, "servers">): string[];
+export declare function isPlaceholderServerUrl(serverUrl: string): boolean;
+//# sourceMappingURL=server-warnings.d.ts.map

package/dist/utils/server-warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-warnings.d.ts","sourceRoot":"","sources":["../../src/utils/server-warnings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWvD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,CAQzF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAajE"}

package/dist/utils/server-warnings.js

@@ -0,0 +1,41 @@
+const PLACEHOLDER_HOSTS = new Set([
+    "localhost",
+    "0.0.0.0",
+    "::1",
+    "example.com",
+    "example.org",
+    "example.net",
+]);
+export function findPlaceholderServerUrls(spec) {
+    const urls = new Set();
+    for (const server of spec.servers) {
+        if (isPlaceholderServerUrl(server.url))
+            urls.add(server.url);
+    }
+    return [...urls];
+}
+export function isPlaceholderServerUrl(serverUrl) {
+    const hostname = extractHostname(serverUrl);
+    if (!hostname)
+        return false;
+    const normalized = hostname.toLowerCase().replace(/^\[|\]$/g, "");
+    if (PLACEHOLDER_HOSTS.has(normalized))
+        return true;
+    if (/^127(?:\.\d{1,3}){3}$/.test(normalized))
+        return true;
+    return (normalized.endsWith(".example.com") ||
+        normalized.endsWith(".example.org") ||
+        normalized.endsWith(".example.net"));
+}
+function extractHostname(serverUrl) {
+    const trimmed = serverUrl.trim();
+    if (!trimmed || trimmed.startsWith("/") || trimmed.startsWith("{"))
+        return null;
+    const candidate = /^[a-z][a-z\d+.-]*:\/\//i.test(trimmed) ? trimmed : `http://${trimmed}`;
+    try {
+        return new URL(candidate).hostname || null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/vite-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAKlD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IACvB,iEAAiE;IACjE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA6HnE"}
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAMlD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IACvB,iEAAiE;IACjE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA6HnE"}

package/dist/vite-plugin.js

@@ -1,5 +1,6 @@
 import { resolve, extname } from "node:path";
 import { normalizeBaseUrl } from "./site-url.js";
+import { contentTypeForPath, outputPathFromRequestPath } from "./renderer/static-files.js";
 /**
  * Vite plugin for Sourcey.
  * - Injects SSR middleware that renders pages on the fly
@@ -116,56 +117,3 @@ export function sourceyPlugin(options) {
         },
     };
 }
-function outputPathFromRequestPath(pathname, baseUrl) {
-    let path = pathname;
-    if (baseUrl && path.startsWith(baseUrl)) {
-        path = path.slice(baseUrl.length);
-    }
-    try {
-        path = decodeURIComponent(path);
-    }
-    catch {
-        // Keep the raw path; a malformed escape cannot match generated output.
-    }
-    return path.replace(/^\/+/, "");
-}
-function contentTypeForPath(path) {
-    switch (extname(path).toLowerCase()) {
-        case ".css":
-            return "text/css; charset=utf-8";
-        case ".js":
-        case ".mjs":
-            return "text/javascript; charset=utf-8";
-        case ".json":
-            return "application/json; charset=utf-8";
-        case ".svg":
-            return "image/svg+xml";
-        case ".png":
-            return "image/png";
-        case ".jpg":
-        case ".jpeg":
-            return "image/jpeg";
-        case ".gif":
-            return "image/gif";
-        case ".webp":
-            return "image/webp";
-        case ".avif":
-            return "image/avif";
-        case ".ico":
-            return "image/x-icon";
-        case ".txt":
-            return "text/plain; charset=utf-8";
-        case ".pdf":
-            return "application/pdf";
-        case ".woff":
-            return "font/woff";
-        case ".woff2":
-            return "font/woff2";
-        case ".mp4":
-            return "video/mp4";
-        case ".webm":
-            return "video/webm";
-        default:
-            return "application/octet-stream";
-    }
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.6.4",
+  "version": "3.6.6",
   "description": "Precision documentation from OpenAPI, MCP, Doxygen, godoc, rustdoc, and Markdown. Static HTML you own.",
   "type": "module",
   "engines": {
@@ -13,6 +13,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./astro": {
+      "types": "./dist/astro/index.d.ts",
+      "import": "./dist/astro/index.js"
     }
   },
   "files": [
@@ -20,8 +24,9 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc && cp -r src/themes dist/ && cp src/client/*.js dist/client/ && cp -r src/og/fonts dist/og/ && rm -rf dist/core/sourcey-godoc dist/core/godoc-introspect && mkdir -p dist/core/sourcey-godoc && cp -R go/sourcey-godoc/go.mod go/sourcey-godoc/doc.go go/sourcey-godoc/cmd dist/core/sourcey-godoc/ && rm -rf dist/core/sourcey-rustdoc && mkdir -p dist/core/sourcey-rustdoc && cp -R rust/sourcey-rustdoc/Cargo.toml rust/sourcey-rustdoc/Cargo.lock rust/sourcey-rustdoc/README.md rust/sourcey-rustdoc/src rust/sourcey-rustdoc/tests dist/core/sourcey-rustdoc/",
+    "build": "rm -rf dist && tsc && node scripts/copy-theme-assets.mjs && cp src/client/*.js dist/client/ && cp -r src/og/fonts dist/og/ && rm -rf dist/core/sourcey-godoc dist/core/godoc-introspect && mkdir -p dist/core/sourcey-godoc && cp -R go/sourcey-godoc/go.mod go/sourcey-godoc/doc.go go/sourcey-godoc/cmd dist/core/sourcey-godoc/ && rm -rf dist/core/sourcey-rustdoc && mkdir -p dist/core/sourcey-rustdoc && cp -R rust/sourcey-rustdoc/Cargo.toml rust/sourcey-rustdoc/Cargo.lock rust/sourcey-rustdoc/README.md rust/sourcey-rustdoc/src rust/sourcey-rustdoc/tests dist/core/sourcey-rustdoc/",
     "watch": "npm run build && tsc --watch --preserveWatchOutput",
+    "pretest": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/ test/",
@@ -46,7 +51,7 @@
     "js-yaml": "^4.1.0",
     "marked": "^15.0.0",
     "mcp-parser": "^0.4.0",
-    "moxygen": "^2.1.10",
+    "moxygen": "^2.1.12",
     "preact": "^10.28.4",
     "preact-render-to-string": "^6.6.6",
     "sanitize-html": "^2.17.4",
@@ -66,7 +71,7 @@
     "prettier": "^3.4.0",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.9"
   },
   "keywords": [
     "openapi",