sourcey 2.0.2

package/dist/utils/code-samples.js

@@ -0,0 +1,84 @@
+import { generateExample } from "./example-generator.js";
+/**
+ * Auto-generate code samples (curl, JavaScript fetch, Python requests)
+ * from an operation's spec when no custom x-code-samples are provided.
+ */
+export function generateCodeSamples(op, serverUrl) {
+    if (op.codeSamples?.length)
+        return op.codeSamples;
+    const url = `${serverUrl.replace(/\/$/, "")}${op.path}`;
+    const method = op.method.toUpperCase();
+    const hasBody = !!op.requestBody;
+    const contentType = hasBody
+        ? Object.keys(op.requestBody.content)[0] ?? "application/json"
+        : undefined;
+    const bodyExample = hasBody ? getRequestBodyExample(op) : undefined;
+    const bodyJson = bodyExample ? JSON.stringify(bodyExample, null, 2) : undefined;
+    return [
+        generateCurl(url, method, contentType, bodyJson),
+        generateJavaScript(url, method, contentType, bodyJson),
+        generatePython(url, method, contentType, bodyJson),
+    ];
+}
+function getRequestBodyExample(op) {
+    const content = op.requestBody?.content;
+    if (!content)
+        return undefined;
+    const mediaType = Object.values(content)[0];
+    if (!mediaType)
+        return undefined;
+    if (mediaType.example !== undefined)
+        return mediaType.example;
+    if (mediaType.schema)
+        return generateExample(mediaType.schema);
+    return undefined;
+}
+function generateCurl(url, method, contentType, body) {
+    const parts = [`curl -X ${method} '${url}'`];
+    if (contentType) {
+        parts.push(`  -H 'Content-Type: ${contentType}'`);
+    }
+    if (body) {
+        parts.push(`  -d '${body}'`);
+    }
+    return { lang: "bash", label: "cURL", source: parts.join(" \\\n") };
+}
+function generateJavaScript(url, method, contentType, body) {
+    const lines = [`const response = await fetch('${url}', {`];
+    lines.push(`  method: '${method}',`);
+    if (contentType) {
+        lines.push(`  headers: {`);
+        lines.push(`    'Content-Type': '${contentType}',`);
+        lines.push(`  },`);
+    }
+    if (body) {
+        lines.push(`  body: JSON.stringify(${body}),`);
+    }
+    lines.push(`});`);
+    lines.push(``);
+    lines.push(`const data = await response.json();`);
+    return { lang: "javascript", label: "JavaScript", source: lines.join("\n") };
+}
+function generatePython(url, method, contentType, body) {
+    const lines = ["import requests", ""];
+    const args = [`'${url}'`];
+    if (body) {
+        lines.push(`payload = ${pythonDict(body)}`);
+        lines.push("");
+        args.push("json=payload");
+    }
+    if (contentType && !body) {
+        args.push(`headers={'Content-Type': '${contentType}'}`);
+    }
+    lines.push(`response = requests.${method.toLowerCase()}(${args.join(", ")})`);
+    lines.push(`data = response.json()`);
+    return { lang: "python", label: "Python", source: lines.join("\n") };
+}
+function pythonDict(jsonStr) {
+    // Simple conversion of JSON to Python dict syntax
+    return jsonStr
+        .replace(/: true/g, ": True")
+        .replace(/: false/g, ": False")
+        .replace(/: null/g, ": None");
+}
+//# sourceMappingURL=code-samples.js.map

package/dist/utils/code-samples.js.map

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

package/dist/utils/example-generator.d.ts

@@ -0,0 +1,12 @@
+import type { NormalizedSchema } from "../core/types.js";
+/**
+ * Generate an example value from a JSON Schema definition.
+ *
+ * Improvements over legacy:
+ * - Handles anyOf/oneOf (picks first option)
+ * - Uses default values and first enum value
+ * - Returns "[circular]" instead of raw $ref string on cycles
+ * - Cycle detection via Set<string> instead of array linear scan
+ */
+export declare function generateExample(schema: NormalizedSchema, seen?: Set<string>): unknown;
+//# sourceMappingURL=example-generator.d.ts.map

package/dist/utils/example-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-generator.d.ts","sourceRoot":"","sources":["../../src/utils/example-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,OAAO,CAqDT"}

package/dist/utils/example-generator.js

@@ -0,0 +1,123 @@
+/**
+ * Generate an example value from a JSON Schema definition.
+ *
+ * Improvements over legacy:
+ * - Handles anyOf/oneOf (picks first option)
+ * - Uses default values and first enum value
+ * - Returns "[circular]" instead of raw $ref string on cycles
+ * - Cycle detection via Set<string> instead of array linear scan
+ */
+export function generateExample(schema, seen = new Set()) {
+    // Cycle detection using schema name
+    if (schema.name) {
+        if (seen.has(schema.name))
+            return "[circular]";
+        seen = new Set(seen);
+        seen.add(schema.name);
+    }
+    // Use explicit example first
+    if (schema.example !== undefined)
+        return schema.example;
+    // Use default value
+    if (schema.default !== undefined)
+        return schema.default;
+    // Use first enum value
+    if (schema.enum?.length)
+        return schema.enum[0];
+    // Use const
+    if (schema.const !== undefined)
+        return schema.const;
+    // Handle composition — pick first option
+    if (schema.allOf?.length) {
+        return mergeAllOfExamples(schema.allOf, seen);
+    }
+    if (schema.oneOf?.length) {
+        return generateExample(schema.oneOf[0], seen);
+    }
+    if (schema.anyOf?.length) {
+        return generateExample(schema.anyOf[0], seen);
+    }
+    const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+    switch (type) {
+        case "object":
+            return generateObjectExample(schema, seen);
+        case "array":
+            return generateArrayExample(schema, seen);
+        case "string":
+            return generateStringExample(schema);
+        case "integer":
+            return schema.minimum ?? 0;
+        case "number":
+            return schema.minimum ?? 0.0;
+        case "boolean":
+            return true;
+        case "null":
+            return null;
+        default:
+            // If it has properties, treat as object
+            if (schema.properties)
+                return generateObjectExample(schema, seen);
+            return undefined;
+    }
+}
+function generateObjectExample(schema, seen) {
+    const obj = {};
+    if (schema.properties) {
+        for (const [key, prop] of Object.entries(schema.properties)) {
+            const val = generateExample(prop, seen);
+            if (val !== undefined) {
+                obj[key] = val;
+            }
+        }
+    }
+    return obj;
+}
+function generateArrayExample(schema, seen) {
+    if (schema.items) {
+        const item = generateExample(schema.items, seen);
+        return item !== undefined ? [item] : [];
+    }
+    return [];
+}
+function generateStringExample(schema) {
+    switch (schema.format) {
+        case "date-time":
+            return "2024-01-15T09:30:00Z";
+        case "date":
+            return "2024-01-15";
+        case "time":
+            return "09:30:00Z";
+        case "email":
+            return "user@example.com";
+        case "uri":
+        case "url":
+            return "https://example.com";
+        case "uuid":
+            return "550e8400-e29b-41d4-a716-446655440000";
+        case "ipv4":
+            return "192.168.1.1";
+        case "ipv6":
+            return "::1";
+        case "hostname":
+            return "example.com";
+        case "binary":
+            return "<binary>";
+        case "byte":
+            return "dGVzdA==";
+        case "password":
+            return "********";
+        default:
+            return "string";
+    }
+}
+function mergeAllOfExamples(schemas, seen) {
+    const merged = {};
+    for (const sub of schemas) {
+        const example = generateExample(sub, seen);
+        if (example && typeof example === "object" && !Array.isArray(example)) {
+            Object.assign(merged, example);
+        }
+    }
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+//# sourceMappingURL=example-generator.js.map

package/dist/utils/example-generator.js.map

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

package/dist/utils/highlighter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Highlight code with Shiki (synchronous, build-time).
+ * Uses dual-theme output: light theme inline + dark theme via CSS vars.
+ * Switch themes with `.dark` class on a parent element.
+ *
+ * The HTML uses `--shiki-dark` CSS custom properties so dark mode
+ * works via CSS (no JS theme switching needed at runtime).
+ */
+export declare function highlightCode(code: string, lang?: string): string;
+//# sourceMappingURL=highlighter.d.ts.map

package/dist/utils/highlighter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlighter.d.ts","sourceRoot":"","sources":["../../src/utils/highlighter.ts"],"names":[],"mappings":"AA6BA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBjE"}

package/dist/utils/highlighter.js

@@ -0,0 +1,51 @@
+import { createHighlighterCoreSync, createJavaScriptRegexEngine, } from "shiki";
+import js from "shiki/langs/javascript.mjs";
+import ts from "shiki/langs/typescript.mjs";
+import bash from "shiki/langs/bash.mjs";
+import python from "shiki/langs/python.mjs";
+import json from "shiki/langs/json.mjs";
+import cpp from "shiki/langs/cpp.mjs";
+import c from "shiki/langs/c.mjs";
+import yaml from "shiki/langs/yaml.mjs";
+import html from "shiki/langs/html.mjs";
+import css from "shiki/langs/css.mjs";
+import go from "shiki/langs/go.mjs";
+import rust from "shiki/langs/rust.mjs";
+import cmake from "shiki/langs/cmake.mjs";
+import sql from "shiki/langs/sql.mjs";
+import xml from "shiki/langs/xml.mjs";
+import docker from "shiki/langs/docker.mjs";
+import githubLight from "shiki/themes/github-light-default.mjs";
+import darkPlus from "shiki/themes/dark-plus.mjs";
+const highlighter = createHighlighterCoreSync({
+    themes: [githubLight, darkPlus],
+    langs: [js, ts, bash, python, json, cpp, c, yaml, html, css, go, rust, cmake, sql, xml, docker],
+    engine: createJavaScriptRegexEngine(),
+});
+/**
+ * Highlight code with Shiki (synchronous, build-time).
+ * Uses dual-theme output: light theme inline + dark theme via CSS vars.
+ * Switch themes with `.dark` class on a parent element.
+ *
+ * The HTML uses `--shiki-dark` CSS custom properties so dark mode
+ * works via CSS (no JS theme switching needed at runtime).
+ */
+export function highlightCode(code, lang) {
+    const resolved = lang && highlighter.getLoadedLanguages().includes(lang) ? lang : "text";
+    if (resolved === "text") {
+        // No highlighting — return escaped HTML in our standard structure
+        const escaped = code
+            .replace(/&/g, "&")
+            .replace(/</g, "&lt;")
+            .replace(/>/g, "&gt;");
+        return `<pre class="shiki"><code>${escaped}</code></pre>`;
+    }
+    return highlighter.codeToHtml(code, {
+        lang: resolved,
+        themes: {
+            light: "github-light-default",
+            dark: "dark-plus",
+        },
+    });
+}
+//# sourceMappingURL=highlighter.js.map

package/dist/utils/highlighter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlighter.js","sourceRoot":"","sources":["../../src/utils/highlighter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC5C,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC5C,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,GAAG,MAAM,qBAAqB,CAAC;AACtC,OAAO,CAAC,MAAM,mBAAmB,CAAC;AAClC,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,GAAG,MAAM,qBAAqB,CAAC;AACtC,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpC,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,KAAK,MAAM,uBAAuB,CAAC;AAC1C,OAAO,GAAG,MAAM,qBAAqB,CAAC;AACtC,OAAO,GAAG,MAAM,qBAAqB,CAAC;AACtC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,QAAQ,MAAM,4BAA4B,CAAC;AAElD,MAAM,WAAW,GAAG,yBAAyB,CAAC;IAC5C,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC;IAC/F,MAAM,EAAE,2BAA2B,EAAE;CACtC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAa;IACvD,MAAM,QAAQ,GAAG,IAAI,IAAI,WAAW,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAEzF,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,kEAAkE;QAClE,MAAM,OAAO,GAAG,IAAI;aACjB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;aACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;aACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,OAAO,4BAA4B,OAAO,eAAe,CAAC;IAC5D,CAAC;IAED,OAAO,WAAW,CAAC,UAAU,CAAC,IAAI,EAAE;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE;YACN,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,WAAW;SAClB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/html-id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Convert a string into a URL-safe HTML id attribute value.
+ * Matches the legacy htmlId Handlebars helper behavior.
+ */
+export declare function htmlId(value: string): string;
+//# sourceMappingURL=html-id.d.ts.map

package/dist/utils/html-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-id.d.ts","sourceRoot":"","sources":["../../src/utils/html-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK5C"}

package/dist/utils/html-id.js

@@ -0,0 +1,11 @@
+/**
+ * Convert a string into a URL-safe HTML id attribute value.
+ * Matches the legacy htmlId Handlebars helper behavior.
+ */
+export function htmlId(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=html-id.js.map

package/dist/utils/html-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-id.js","sourceRoot":"","sources":["../../src/utils/html-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,14 @@
+export declare function httpStatusText(code: string): string;
+/**
+ * Format a schema's numeric range constraints for display.
+ * Fixes legacy bug where maximumExclusive was checked with minimumExclusive.
+ */
+export declare function schemaRange(schema: {
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number | boolean;
+    exclusiveMaximum?: number | boolean;
+}): string | undefined;
+/** HTTP method color classes for badges */
+export declare function methodColor(method: string): string;
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAiDA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC,GAAG,MAAM,GAAG,SAAS,CA0BrB;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBlD"}

package/dist/utils/http.js

@@ -0,0 +1,97 @@
+/**
+ * HTTP response status code descriptions.
+ */
+const HTTP_STATUS_CODES = {
+    "100": "Continue",
+    "101": "Switching Protocols",
+    "200": "OK",
+    "201": "Created",
+    "202": "Accepted",
+    "203": "Non-Authoritative Information",
+    "204": "No Content",
+    "205": "Reset Content",
+    "206": "Partial Content",
+    "300": "Multiple Choices",
+    "301": "Moved Permanently",
+    "302": "Found",
+    "303": "See Other",
+    "304": "Not Modified",
+    "307": "Temporary Redirect",
+    "308": "Permanent Redirect",
+    "400": "Bad Request",
+    "401": "Unauthorized",
+    "402": "Payment Required",
+    "403": "Forbidden",
+    "404": "Not Found",
+    "405": "Method Not Allowed",
+    "406": "Not Acceptable",
+    "407": "Proxy Authentication Required",
+    "408": "Request Timeout",
+    "409": "Conflict",
+    "410": "Gone",
+    "411": "Length Required",
+    "412": "Precondition Failed",
+    "413": "Payload Too Large",
+    "414": "URI Too Long",
+    "415": "Unsupported Media Type",
+    "416": "Range Not Satisfiable",
+    "417": "Expectation Failed",
+    "418": "I'm a Teapot",
+    "422": "Unprocessable Entity",
+    "429": "Too Many Requests",
+    "500": "Internal Server Error",
+    "501": "Not Implemented",
+    "502": "Bad Gateway",
+    "503": "Service Unavailable",
+    "504": "Gateway Timeout",
+    default: "",
+};
+export function httpStatusText(code) {
+    return HTTP_STATUS_CODES[code] ?? HTTP_STATUS_CODES["default"];
+}
+/**
+ * Format a schema's numeric range constraints for display.
+ * Fixes legacy bug where maximumExclusive was checked with minimumExclusive.
+ */
+export function schemaRange(schema) {
+    const parts = [];
+    if (schema.minimum !== undefined) {
+        const exclusive = schema.exclusiveMinimum === true ||
+            typeof schema.exclusiveMinimum === "number";
+        const min = typeof schema.exclusiveMinimum === "number"
+            ? schema.exclusiveMinimum
+            : schema.minimum;
+        parts.push(`${exclusive ? "(" : "["}${min}`);
+    }
+    if (schema.maximum !== undefined) {
+        const exclusive = schema.exclusiveMaximum === true ||
+            typeof schema.exclusiveMaximum === "number";
+        const max = typeof schema.exclusiveMaximum === "number"
+            ? schema.exclusiveMaximum
+            : schema.maximum;
+        parts.push(`${max}${exclusive ? ")" : "]"}`);
+    }
+    return parts.length === 2 ? parts.join(", ") : undefined;
+}
+/** HTTP method color classes for badges */
+export function methodColor(method) {
+    switch (method.toLowerCase()) {
+        case "get":
+            return "bg-emerald-600";
+        case "post":
+            return "bg-blue-600";
+        case "put":
+            return "bg-amber-600";
+        case "delete":
+            return "bg-red-600";
+        case "patch":
+            return "bg-purple-600";
+        case "options":
+            return "bg-gray-500";
+        case "head":
+            return "bg-gray-600";
+        default:
+            return "bg-gray-500";
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

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

package/dist/utils/markdown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Render Markdown to HTML. Used for spec descriptions.
+ */
+export declare function renderMarkdown(input?: string): string;
+/**
+ * Render Markdown to inline HTML (strip wrapping <p> tags).
+ */
+export declare function renderMarkdownInline(input?: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/utils/markdown.js

@@ -0,0 +1,18 @@
+import { marked } from "marked";
+/**
+ * Render Markdown to HTML. Used for spec descriptions.
+ */
+export function renderMarkdown(input) {
+    if (!input)
+        return "";
+    return marked.parse(input, { async: false });
+}
+/**
+ * Render Markdown to inline HTML (strip wrapping <p> tags).
+ */
+export function renderMarkdownInline(input) {
+    if (!input)
+        return "";
+    return marked.parseInline(input, { async: false });
+}
+//# sourceMappingURL=markdown.js.map

package/dist/utils/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW,CAAC;AAC/D,CAAC"}

package/dist/vite-plugin.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin } from "vite";
+export interface SourceyPluginOptions {
+    /** Additional file paths to watch (specs, markdown) */
+    watchPaths: string[];
+    /** SSR render function: given a URL path, return HTML or null */
+    render: (url: string) => Promise<string | null>;
+    /** Optional: generate search index JSON on demand */
+    searchIndex?: () => Promise<string>;
+}
+/**
+ * Vite plugin for Sourcey.
+ * - Injects SSR middleware that renders pages on the fly
+ * - Watches spec and markdown files; triggers full reload on change
+ */
+export declare function sourceyPlugin(options: SourceyPluginOptions): Plugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

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

@@ -0,0 +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;AAIlD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,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;CACrC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAiGnE"}

package/dist/vite-plugin.js

@@ -0,0 +1,92 @@
+import { resolve, extname } from "node:path";
+/**
+ * Vite plugin for Sourcey.
+ * - Injects SSR middleware that renders pages on the fly
+ * - Watches spec and markdown files; triggers full reload on change
+ */
+export function sourceyPlugin(options) {
+    const { watchPaths, render, searchIndex } = options;
+    const watchSet = new Set(watchPaths.map((p) => resolve(p)));
+    return {
+        name: "sourcey",
+        configureServer(server) {
+            // Add spec/markdown files to Vite's watcher
+            for (const p of watchPaths) {
+                server.watcher.add(resolve(p));
+            }
+            // Trigger full reload when watched files or source components change
+            server.watcher.on("change", (file) => {
+                const ext = extname(file);
+                if (watchSet.has(file) ||
+                    ext === ".md" ||
+                    ext === ".yml" ||
+                    ext === ".yaml" ||
+                    ext === ".tsx" ||
+                    ext === ".ts") {
+                    // Invalidate SSR module cache so next render uses fresh source
+                    const mods = server.moduleGraph.getModulesByFile(file);
+                    if (mods) {
+                        for (const mod of mods) {
+                            server.moduleGraph.invalidateModule(mod);
+                        }
+                    }
+                    const timestamp = new Date().toLocaleTimeString();
+                    console.log(`  [${timestamp}] ${file} changed, reloading…`);
+                    server.ws.send({ type: "full-reload" });
+                }
+            });
+            // Return a post middleware (runs after Vite internals)
+            // We use pre-middleware instead by calling server.middlewares.use directly
+            // This runs BEFORE Vite's static file handler
+            server.middlewares.use(async (req, res, next) => {
+                const url = req.url ?? "/";
+                // Let Vite handle its own requests
+                if (url.startsWith("/@") ||
+                    url.startsWith("/__vite") ||
+                    url.startsWith("/node_modules/") ||
+                    url === "/favicon.ico") {
+                    return next();
+                }
+                // Serve search index on demand
+                if (url === "/search-index.json" && searchIndex) {
+                    try {
+                        const json = await searchIndex();
+                        res.writeHead(200, {
+                            "Content-Type": "application/json",
+                            "Cache-Control": "no-cache",
+                        });
+                        res.end(json);
+                        return;
+                    }
+                    catch {
+                        return next();
+                    }
+                }
+                // Only handle HTML page requests (no extension, or .html)
+                const ext = extname(url);
+                if (ext && ext !== ".html") {
+                    return next();
+                }
+                try {
+                    let html = await render(url);
+                    if (!html) {
+                        return next();
+                    }
+                    // Let Vite transform the HTML (injects HMR client script)
+                    html = await server.transformIndexHtml(url, html);
+                    res.writeHead(200, {
+                        "Content-Type": "text/html; charset=utf-8",
+                        "Cache-Control": "no-cache",
+                    });
+                    res.end(html);
+                }
+                catch (e) {
+                    server.ssrFixStacktrace(e);
+                    console.error(`  SSR error for ${url}:`, e.message);
+                    return next();
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

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