npm - puredocs_v2 - Versions diffs - 1.0.0 - Mend

puredocs_v2 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (66) hide show

package/LICENSE +46 -0
package/README.md +164 -0
package/dist/api/http-client.d.ts +14 -0
package/dist/api/snippets.d.ts +15 -0
package/dist/components/app.d.ts +7 -0
package/dist/components/layout/empty-state-page.d.ts +11 -0
package/dist/components/layout/page-layout.d.ts +9 -0
package/dist/components/modals/auth-modal.d.ts +17 -0
package/dist/components/modals/modal-base.d.ts +15 -0
package/dist/components/modals/search-modal.d.ts +6 -0
package/dist/components/nav/route-nav.d.ts +2 -0
package/dist/components/nav/sidebar.d.ts +13 -0
package/dist/components/pages/endpoint.d.ts +3 -0
package/dist/components/pages/overview.d.ts +2 -0
package/dist/components/pages/tag-page.d.ts +2 -0
package/dist/components/pages/webhook.d.ts +3 -0
package/dist/components/shared/connection-settings.d.ts +2 -0
package/dist/components/shared/copy-button.d.ts +12 -0
package/dist/components/shared/editor-panel.d.ts +14 -0
package/dist/components/shared/example-picker.d.ts +20 -0
package/dist/components/shared/responses.d.ts +27 -0
package/dist/components/shared/schema-viewer.d.ts +17 -0
package/dist/components/shared/summary.d.ts +5 -0
package/dist/components/shared/try-it.d.ts +20 -0
package/dist/components/ui/badge.d.ts +24 -0
package/dist/components/ui/breadcrumb.d.ts +12 -0
package/dist/components/ui/button.d.ts +17 -0
package/dist/components/ui/card.d.ts +25 -0
package/dist/components/ui/index.d.ts +20 -0
package/dist/components/ui/input.d.ts +20 -0
package/dist/components/ui/lock-icon.d.ts +8 -0
package/dist/components/ui/section.d.ts +8 -0
package/dist/components/ui/select.d.ts +20 -0
package/dist/core/auth-storage.d.ts +3 -0
package/dist/core/effects.d.ts +33 -0
package/dist/core/parser.d.ts +7 -0
package/dist/core/persistence.d.ts +12 -0
package/dist/core/router.d.ts +40 -0
package/dist/core/search.d.ts +5 -0
package/dist/core/security.d.ts +16 -0
package/dist/core/state.d.ts +24 -0
package/dist/core/theme.d.ts +9 -0
package/dist/core/types.d.ts +291 -0
package/dist/core/validation.d.ts +17 -0
package/dist/helpers/debounce.d.ts +1 -0
package/dist/helpers/schema-utils.d.ts +2 -0
package/dist/helpers/text.d.ts +2 -0
package/dist/helpers/validation-ui.d.ts +4 -0
package/dist/index.d.ts +34 -0
package/dist/lib/dom.d.ts +17 -0
package/dist/lib/highlight.d.ts +8 -0
package/dist/lib/icons.d.ts +24 -0
package/dist/puredocs.cjs +49 -0
package/dist/puredocs.cjs.map +1 -0
package/dist/puredocs.css +1 -0
package/dist/puredocs.js +5324 -0
package/dist/puredocs.js.map +1 -0
package/dist/puredocs.umd.js +49 -0
package/dist/puredocs.umd.js.map +1 -0
package/dist/server.cjs +117 -0
package/dist/server.cjs.map +1 -0
package/dist/server.d.ts +43 -0
package/dist/server.js +116 -0
package/dist/server.js.map +1 -0
package/dist/services/env.d.ts +7 -0
package/package.json +84 -0

package/dist/server.cjs ADDED Viewed

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const node_fs = require("node:fs");
+const path = require("node:path");
+const node_url = require("node:url");
+var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
+const currentDir = typeof __dirname === "string" ? __dirname : path.dirname(node_url.fileURLToPath(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("server.cjs", document.baseURI).href));
+const cssPath = path.resolve(currentDir, "puredocs.css");
+const umdPath = path.resolve(currentDir, "puredocs.umd.js");
+let inlineAssetsCache = null;
+function getInlineAssets() {
+  if (!inlineAssetsCache) {
+    const css = node_fs.readFileSync(cssPath, "utf8");
+    const umd = node_fs.readFileSync(umdPath, "utf8");
+    inlineAssetsCache = {
+      css: css.replace(/<\/style>/gi, "<\\/style>"),
+      umd: umd.replace(/<\/script>/gi, "<\\/script>")
+    };
+  }
+  return inlineAssetsCache;
+}
+function toSafeJson(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function buildClientConfig(options) {
+  if (!options.specUrl && !options.spec) {
+    throw new Error('[PureDocs] pureDocs.html() requires either "specUrl" or "spec".');
+  }
+  return {
+    specUrl: options.specUrl,
+    spec: options.spec,
+    title: options.title,
+    theme: options.theme ?? "auto",
+    primaryColor: options.primaryColor
+  };
+}
+function sendHtmlResponse(res, html) {
+  if (typeof res.type === "function") {
+    res.type("text/html");
+  } else if (typeof res.setHeader === "function") {
+    res.setHeader("content-type", "text/html; charset=utf-8");
+  }
+  if (typeof res.send === "function") {
+    return res.send(html);
+  }
+  if (typeof res.end === "function") {
+    return res.end(html);
+  }
+  throw new Error("[PureDocs] Unsupported response object: expected res.send() or res.end().");
+}
+function resolveRoute(options) {
+  const route = options.route || "/docs";
+  return route.startsWith("/") ? route : `/${route}`;
+}
+function pureDocsHtml(options, template) {
+  const { css, umd } = getInlineAssets();
+  const clientConfig = buildClientConfig(options);
+  const pageTitle = options.title ? `${options.title} — pureDocs` : "pureDocs";
+  const bootstrapScript = `PureDocs.bootstrap(${toSafeJson(clientConfig)});`;
+  const payload = {
+    css,
+    script: umd,
+    bootstrapScript,
+    pageTitle
+  };
+  if (template) {
+    return template(payload);
+  }
+  return [
+    "<!doctype html>",
+    '<html lang="en">',
+    "<head>",
+    '  <meta charset="utf-8" />',
+    '  <meta name="viewport" content="width=device-width, initial-scale=1" />',
+    `  <title>${escapeHtml(pageTitle)}</title>`,
+    `  <style>${css}</style>`,
+    "</head>",
+    "<body>",
+    `  <script>${umd}<\/script>`,
+    `  <script>${bootstrapScript}<\/script>`,
+    "</body>",
+    "</html>"
+  ].join("\n");
+}
+function pureDocsExpress(app, options) {
+  const html = pureDocsHtml(options);
+  const route = resolveRoute(options);
+  app.get(route, (_req, res) => sendHtmlResponse(res, html));
+  return html;
+}
+function pureDocsFastify(app, options) {
+  const html = pureDocsHtml(options);
+  const route = resolveRoute(options);
+  app.get(route, (_request, reply) => {
+    if (typeof reply.type === "function") {
+      reply.type("text/html");
+    } else if (typeof reply.header === "function") {
+      reply.header("content-type", "text/html; charset=utf-8");
+    }
+    return reply.send ? reply.send(html) : html;
+  });
+  return html;
+}
+const pureDocs = {
+  html: pureDocsHtml,
+  express: pureDocsExpress,
+  fastify: pureDocsFastify
+};
+exports.default = pureDocs;
+exports.pureDocs = pureDocs;
+exports.pureDocsExpress = pureDocsExpress;
+exports.pureDocsFastify = pureDocsFastify;
+exports.pureDocsHtml = pureDocsHtml;
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"server.cjs","sources":["../src/server.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nexport interface PureDocsOptions {\n specUrl?: string;\n spec?: Record<string, unknown>;\n title?: string;\n theme?: 'light' | 'dark' | 'auto';\n primaryColor?: string;\n}\n\nexport interface PureDocsRouteOptions extends PureDocsOptions {\n route?: string;\n}\n\nexport interface PureDocsHtmlPayload {\n css: string;\n script: string;\n bootstrapScript: string;\n pageTitle: string;\n}\n\nexport type PureDocsHtmlTemplate = (payload: PureDocsHtmlPayload) => string;\n\ninterface ExpressLikeResponse {\n type?: (value: string) => unknown;\n setHeader?: (name: string, value: string) => unknown;\n send?: (body: string) => unknown;\n end?: (body?: string) => unknown;\n}\n\ninterface ExpressLikeApp {\n get: (path: string, handler: (_req: unknown, res: ExpressLikeResponse) => unknown) => unknown;\n}\n\ninterface FastifyLikeReply {\n type?: (value: string) => FastifyLikeReply;\n header?: (name: string, value: string) => FastifyLikeReply;\n send?: (body: string) => unknown;\n}\n\ninterface FastifyLikeApp {\n get: (path: string, handler: (_request: unknown, reply: FastifyLikeReply) => unknown) => unknown;\n}\n\ninterface PureDocsClientConfig {\n specUrl?: string;\n spec?: Record<string, unknown>;\n title?: string;\n theme?: 'light' | 'dark' | 'auto';\n primaryColor?: string;\n}\n\ninterface InlineAssets {\n css: string;\n umd: string;\n}\n\nconst currentDir = typeof __dirname === 'string'\n ? __dirname\n : path.dirname(fileURLToPath(import.meta.url));\n\nconst cssPath = path.resolve(currentDir, 'puredocs.css');\nconst umdPath = path.resolve(currentDir, 'puredocs.umd.js');\n\nlet inlineAssetsCache: InlineAssets | null = null;\n\nfunction getInlineAssets(): InlineAssets {\n if (!inlineAssetsCache) {\n const css = readFileSync(cssPath, 'utf8');\n const umd = readFileSync(umdPath, 'utf8');\n\n inlineAssetsCache = {\n css: css.replace(/<\\/style>/gi, '<\\\\/style>'),\n umd: umd.replace(/<\\/script>/gi, '<\\\\/script>'),\n };\n }\n\n return inlineAssetsCache;\n}\n\nfunction toSafeJson(value: unknown): string {\n return JSON.stringify(value)\n .replace(/</g, '\\\\u003c')\n .replace(/>/g, '\\\\u003e')\n .replace(/&/g, '\\\\u0026')\n .replace(/\\u2028/g, '\\\\u2028')\n .replace(/\\u2029/g, '\\\\u2029');\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replace(/&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\nfunction buildClientConfig(options: PureDocsOptions): PureDocsClientConfig {\n if (!options.specUrl && !options.spec) {\n throw new Error('[PureDocs] pureDocs.html() requires either \"specUrl\" or \"spec\".');\n }\n\n return {\n specUrl: options.specUrl,\n spec: options.spec,\n title: options.title,\n theme: options.theme ?? 'auto',\n primaryColor: options.primaryColor,\n };\n}\n\nfunction sendHtmlResponse(res: ExpressLikeResponse, html: string): unknown {\n if (typeof res.type === 'function') {\n res.type('text/html');\n } else if (typeof res.setHeader === 'function') {\n res.setHeader('content-type', 'text/html; charset=utf-8');\n }\n\n if (typeof res.send === 'function') {\n return res.send(html);\n }\n if (typeof res.end === 'function') {\n return res.end(html);\n }\n\n throw new Error('[PureDocs] Unsupported response object: expected res.send() or res.end().');\n}\n\nfunction resolveRoute(options: PureDocsRouteOptions): string {\n const route = options.route || '/docs';\n return route.startsWith('/') ? route : `/${route}`;\n}\n\nexport function pureDocsHtml(options: PureDocsOptions, template?: PureDocsHtmlTemplate): string {\n const { css, umd } = getInlineAssets();\n const clientConfig = buildClientConfig(options);\n const pageTitle = options.title ? `${options.title} — pureDocs` : 'pureDocs';\n const bootstrapScript = `PureDocs.bootstrap(${toSafeJson(clientConfig)});`;\n\n const payload: PureDocsHtmlPayload = {\n css,\n script: umd,\n bootstrapScript,\n pageTitle,\n };\n\n if (template) {\n return template(payload);\n }\n\n return [\n '<!doctype html>',\n '<html lang=\"en\">',\n '<head>',\n ' <meta charset=\"utf-8\" />',\n ' <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />',\n ` <title>${escapeHtml(pageTitle)}</title>`,\n ` <style>${css}</style>`,\n '</head>',\n '<body>',\n ` <script>${umd}</script>`,\n ` <script>${bootstrapScript}</script>`,\n '</body>',\n '</html>',\n ].join('\\n');\n}\n\nexport function pureDocsExpress(app: ExpressLikeApp, options: PureDocsRouteOptions): string {\n const html = pureDocsHtml(options);\n const route = resolveRoute(options);\n\n app.get(route, (_req, res) => sendHtmlResponse(res, html));\n return html;\n}\n\nexport function pureDocsFastify(app: FastifyLikeApp, options: PureDocsRouteOptions): string {\n const html = pureDocsHtml(options);\n const route = resolveRoute(options);\n\n app.get(route, (_request, reply) => {\n if (typeof reply.type === 'function') {\n reply.type('text/html');\n } else if (typeof reply.header === 'function') {\n reply.header('content-type', 'text/html; charset=utf-8');\n }\n return reply.send ? reply.send(html) : html;\n });\n\n return html;\n}\n\nexport const pureDocs = {\n html: pureDocsHtml,\n express: pureDocsExpress,\n fastify: pureDocsFastify,\n};\n\nexport default pureDocs;\n"],"names":["fileURLToPath","readFileSync"],"mappings":"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"}

package/dist/server.d.ts ADDED Viewed

@@ -0,0 +1,43 @@
+export interface PureDocsOptions {
+    specUrl?: string;
+    spec?: Record<string, unknown>;
+    title?: string;
+    theme?: 'light' | 'dark' | 'auto';
+    primaryColor?: string;
+}
+export interface PureDocsRouteOptions extends PureDocsOptions {
+    route?: string;
+}
+export interface PureDocsHtmlPayload {
+    css: string;
+    script: string;
+    bootstrapScript: string;
+    pageTitle: string;
+}
+export type PureDocsHtmlTemplate = (payload: PureDocsHtmlPayload) => string;
+interface ExpressLikeResponse {
+    type?: (value: string) => unknown;
+    setHeader?: (name: string, value: string) => unknown;
+    send?: (body: string) => unknown;
+    end?: (body?: string) => unknown;
+}
+interface ExpressLikeApp {
+    get: (path: string, handler: (_req: unknown, res: ExpressLikeResponse) => unknown) => unknown;
+}
+interface FastifyLikeReply {
+    type?: (value: string) => FastifyLikeReply;
+    header?: (name: string, value: string) => FastifyLikeReply;
+    send?: (body: string) => unknown;
+}
+interface FastifyLikeApp {
+    get: (path: string, handler: (_request: unknown, reply: FastifyLikeReply) => unknown) => unknown;
+}
+export declare function pureDocsHtml(options: PureDocsOptions, template?: PureDocsHtmlTemplate): string;
+export declare function pureDocsExpress(app: ExpressLikeApp, options: PureDocsRouteOptions): string;
+export declare function pureDocsFastify(app: FastifyLikeApp, options: PureDocsRouteOptions): string;
+export declare const pureDocs: {
+    html: typeof pureDocsHtml;
+    express: typeof pureDocsExpress;
+    fastify: typeof pureDocsFastify;
+};
+export default pureDocs;

package/dist/server.js ADDED Viewed

@@ -0,0 +1,116 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const currentDir = typeof __dirname === "string" ? __dirname : path.dirname(fileURLToPath(import.meta.url));
+const cssPath = path.resolve(currentDir, "puredocs.css");
+const umdPath = path.resolve(currentDir, "puredocs.umd.js");
+let inlineAssetsCache = null;
+function getInlineAssets() {
+  if (!inlineAssetsCache) {
+    const css = readFileSync(cssPath, "utf8");
+    const umd = readFileSync(umdPath, "utf8");
+    inlineAssetsCache = {
+      css: css.replace(/<\/style>/gi, "<\\/style>"),
+      umd: umd.replace(/<\/script>/gi, "<\\/script>")
+    };
+  }
+  return inlineAssetsCache;
+}
+function toSafeJson(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function buildClientConfig(options) {
+  if (!options.specUrl && !options.spec) {
+    throw new Error('[PureDocs] pureDocs.html() requires either "specUrl" or "spec".');
+  }
+  return {
+    specUrl: options.specUrl,
+    spec: options.spec,
+    title: options.title,
+    theme: options.theme ?? "auto",
+    primaryColor: options.primaryColor
+  };
+}
+function sendHtmlResponse(res, html) {
+  if (typeof res.type === "function") {
+    res.type("text/html");
+  } else if (typeof res.setHeader === "function") {
+    res.setHeader("content-type", "text/html; charset=utf-8");
+  }
+  if (typeof res.send === "function") {
+    return res.send(html);
+  }
+  if (typeof res.end === "function") {
+    return res.end(html);
+  }
+  throw new Error("[PureDocs] Unsupported response object: expected res.send() or res.end().");
+}
+function resolveRoute(options) {
+  const route = options.route || "/docs";
+  return route.startsWith("/") ? route : `/${route}`;
+}
+function pureDocsHtml(options, template) {
+  const { css, umd } = getInlineAssets();
+  const clientConfig = buildClientConfig(options);
+  const pageTitle = options.title ? `${options.title} — pureDocs` : "pureDocs";
+  const bootstrapScript = `PureDocs.bootstrap(${toSafeJson(clientConfig)});`;
+  const payload = {
+    css,
+    script: umd,
+    bootstrapScript,
+    pageTitle
+  };
+  if (template) {
+    return template(payload);
+  }
+  return [
+    "<!doctype html>",
+    '<html lang="en">',
+    "<head>",
+    '  <meta charset="utf-8" />',
+    '  <meta name="viewport" content="width=device-width, initial-scale=1" />',
+    `  <title>${escapeHtml(pageTitle)}</title>`,
+    `  <style>${css}</style>`,
+    "</head>",
+    "<body>",
+    `  <script>${umd}<\/script>`,
+    `  <script>${bootstrapScript}<\/script>`,
+    "</body>",
+    "</html>"
+  ].join("\n");
+}
+function pureDocsExpress(app, options) {
+  const html = pureDocsHtml(options);
+  const route = resolveRoute(options);
+  app.get(route, (_req, res) => sendHtmlResponse(res, html));
+  return html;
+}
+function pureDocsFastify(app, options) {
+  const html = pureDocsHtml(options);
+  const route = resolveRoute(options);
+  app.get(route, (_request, reply) => {
+    if (typeof reply.type === "function") {
+      reply.type("text/html");
+    } else if (typeof reply.header === "function") {
+      reply.header("content-type", "text/html; charset=utf-8");
+    }
+    return reply.send ? reply.send(html) : html;
+  });
+  return html;
+}
+const pureDocs = {
+  html: pureDocsHtml,
+  express: pureDocsExpress,
+  fastify: pureDocsFastify
+};
+export {
+  pureDocs as default,
+  pureDocs,
+  pureDocsExpress,
+  pureDocsFastify,
+  pureDocsHtml
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"server.js","sources":["../src/server.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nexport interface PureDocsOptions {\n specUrl?: string;\n spec?: Record<string, unknown>;\n title?: string;\n theme?: 'light' | 'dark' | 'auto';\n primaryColor?: string;\n}\n\nexport interface PureDocsRouteOptions extends PureDocsOptions {\n route?: string;\n}\n\nexport interface PureDocsHtmlPayload {\n css: string;\n script: string;\n bootstrapScript: string;\n pageTitle: string;\n}\n\nexport type PureDocsHtmlTemplate = (payload: PureDocsHtmlPayload) => string;\n\ninterface ExpressLikeResponse {\n type?: (value: string) => unknown;\n setHeader?: (name: string, value: string) => unknown;\n send?: (body: string) => unknown;\n end?: (body?: string) => unknown;\n}\n\ninterface ExpressLikeApp {\n get: (path: string, handler: (_req: unknown, res: ExpressLikeResponse) => unknown) => unknown;\n}\n\ninterface FastifyLikeReply {\n type?: (value: string) => FastifyLikeReply;\n header?: (name: string, value: string) => FastifyLikeReply;\n send?: (body: string) => unknown;\n}\n\ninterface FastifyLikeApp {\n get: (path: string, handler: (_request: unknown, reply: FastifyLikeReply) => unknown) => unknown;\n}\n\ninterface PureDocsClientConfig {\n specUrl?: string;\n spec?: Record<string, unknown>;\n title?: string;\n theme?: 'light' | 'dark' | 'auto';\n primaryColor?: string;\n}\n\ninterface InlineAssets {\n css: string;\n umd: string;\n}\n\nconst currentDir = typeof __dirname === 'string'\n ? __dirname\n : path.dirname(fileURLToPath(import.meta.url));\n\nconst cssPath = path.resolve(currentDir, 'puredocs.css');\nconst umdPath = path.resolve(currentDir, 'puredocs.umd.js');\n\nlet inlineAssetsCache: InlineAssets | null = null;\n\nfunction getInlineAssets(): InlineAssets {\n if (!inlineAssetsCache) {\n const css = readFileSync(cssPath, 'utf8');\n const umd = readFileSync(umdPath, 'utf8');\n\n inlineAssetsCache = {\n css: css.replace(/<\\/style>/gi, '<\\\\/style>'),\n umd: umd.replace(/<\\/script>/gi, '<\\\\/script>'),\n };\n }\n\n return inlineAssetsCache;\n}\n\nfunction toSafeJson(value: unknown): string {\n return JSON.stringify(value)\n .replace(/</g, '\\\\u003c')\n .replace(/>/g, '\\\\u003e')\n .replace(/&/g, '\\\\u0026')\n .replace(/\\u2028/g, '\\\\u2028')\n .replace(/\\u2029/g, '\\\\u2029');\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replace(/&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\nfunction buildClientConfig(options: PureDocsOptions): PureDocsClientConfig {\n if (!options.specUrl && !options.spec) {\n throw new Error('[PureDocs] pureDocs.html() requires either \"specUrl\" or \"spec\".');\n }\n\n return {\n specUrl: options.specUrl,\n spec: options.spec,\n title: options.title,\n theme: options.theme ?? 'auto',\n primaryColor: options.primaryColor,\n };\n}\n\nfunction sendHtmlResponse(res: ExpressLikeResponse, html: string): unknown {\n if (typeof res.type === 'function') {\n res.type('text/html');\n } else if (typeof res.setHeader === 'function') {\n res.setHeader('content-type', 'text/html; charset=utf-8');\n }\n\n if (typeof res.send === 'function') {\n return res.send(html);\n }\n if (typeof res.end === 'function') {\n return res.end(html);\n }\n\n throw new Error('[PureDocs] Unsupported response object: expected res.send() or res.end().');\n}\n\nfunction resolveRoute(options: PureDocsRouteOptions): string {\n const route = options.route || '/docs';\n return route.startsWith('/') ? route : `/${route}`;\n}\n\nexport function pureDocsHtml(options: PureDocsOptions, template?: PureDocsHtmlTemplate): string {\n const { css, umd } = getInlineAssets();\n const clientConfig = buildClientConfig(options);\n const pageTitle = options.title ? `${options.title} — pureDocs` : 'pureDocs';\n const bootstrapScript = `PureDocs.bootstrap(${toSafeJson(clientConfig)});`;\n\n const payload: PureDocsHtmlPayload = {\n css,\n script: umd,\n bootstrapScript,\n pageTitle,\n };\n\n if (template) {\n return template(payload);\n }\n\n return [\n '<!doctype html>',\n '<html lang=\"en\">',\n '<head>',\n ' <meta charset=\"utf-8\" />',\n ' <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />',\n ` <title>${escapeHtml(pageTitle)}</title>`,\n ` <style>${css}</style>`,\n '</head>',\n '<body>',\n ` <script>${umd}</script>`,\n ` <script>${bootstrapScript}</script>`,\n '</body>',\n '</html>',\n ].join('\\n');\n}\n\nexport function pureDocsExpress(app: ExpressLikeApp, options: PureDocsRouteOptions): string {\n const html = pureDocsHtml(options);\n const route = resolveRoute(options);\n\n app.get(route, (_req, res) => sendHtmlResponse(res, html));\n return html;\n}\n\nexport function pureDocsFastify(app: FastifyLikeApp, options: PureDocsRouteOptions): string {\n const html = pureDocsHtml(options);\n const route = resolveRoute(options);\n\n app.get(route, (_request, reply) => {\n if (typeof reply.type === 'function') {\n reply.type('text/html');\n } else if (typeof reply.header === 'function') {\n reply.header('content-type', 'text/html; charset=utf-8');\n }\n return reply.send ? reply.send(html) : html;\n });\n\n return html;\n}\n\nexport const pureDocs = {\n html: pureDocsHtml,\n express: pureDocsExpress,\n fastify: pureDocsFastify,\n};\n\nexport default pureDocs;\n"],"names":[],"mappings":"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"}

package/dist/services/env.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { PortalState } from '../core/types';
+export declare function getActiveEnvironment(state: PortalState): import("../core/types").PortalEnvironment;
+export declare function getBaseUrl(state: PortalState): string;
+export declare function normalizeBaseUrl(baseUrl: string): string;
+export declare function formatBaseUrlForDisplay(baseUrl: string): string;
+export declare function getNormalizedBaseUrl(state: PortalState): string;
+export declare function getDisplayBaseUrl(state: PortalState): string;

package/package.json ADDED Viewed

@@ -0,0 +1,84 @@
+{
+  "name": "puredocs_v2",
+  "version": "1.0.0",
+  "description": "Beautiful API documentation portal from any OpenAPI 3.1 spec. One-liner for Express & Fastify. Standard Web Component for everything else.",
+  "author": "esurkov1",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://puredocs.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/esurkov1/puredocs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/esurkov1/puredocs/issues"
+  },
+  "keywords": [
+    "openapi",
+    "openapi-3.1",
+    "api-docs",
+    "api-documentation",
+    "documentation",
+    "swagger",
+    "web-components",
+    "api-portal",
+    "developer-portal",
+    "rest-api",
+    "express",
+    "fastify",
+    "api-reference"
+  ],
+  "type": "module",
+  "main": "dist/server.cjs",
+  "module": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "unpkg": "dist/puredocs.umd.js",
+  "jsdelivr": "dist/puredocs.umd.js",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./web": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/puredocs.js",
+      "require": "./dist/puredocs.cjs"
+    },
+    "./style.css": "./dist/puredocs.css"
+  },
+  "sideEffects": [
+    "./dist/puredocs.css",
+    "./dist/puredocs.js",
+    "./dist/puredocs.umd.js"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && vite build -c vite.server.config.ts && tsc --emitDeclarationOnly",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.7.0",
+    "vite": "^6.1.0",
+    "vite-plugin-dts": "^4.5.0"
+  },
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0.0"
+  }
+}