@apifn/docsfn 0.0.2 → 0.1.1

package/dist/react.cjs

@@ -0,0 +1,186 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/ApifnApiReference.tsx
+var ApifnApiReference_exports = {};
+__export(ApifnApiReference_exports, {
+  ApifnApiReference: () => ApifnApiReference
+});
+module.exports = __toCommonJS(ApifnApiReference_exports);
+var import_react = require("react");
+var import_react2 = require("@apifn/react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var METHOD_COLORS = {
+  get: { bg: "#065f46", text: "#6ee7b7" },
+  post: { bg: "#1e3a5f", text: "#93c5fd" },
+  put: { bg: "#78350f", text: "#fcd34d" },
+  patch: { bg: "#5b21b6", text: "#c4b5fd" },
+  delete: { bg: "#7f1d1d", text: "#fca5a5" },
+  head: { bg: "#1f2937", text: "#9ca3af" },
+  options: { bg: "#1f2937", text: "#9ca3af" }
+};
+function getThemeStyle(theme) {
+  const dark = `
+    --apifn-bg:#0f1117;--apifn-bg-surface:#1a1d2e;--apifn-bg-surface-hover:#252840;
+    --apifn-border:#2d3748;--apifn-text:#e2e8f0;--apifn-text-muted:#64748b;
+    --apifn-accent:#7c3aed;--apifn-accent-text:#c4b5fd;--apifn-green:#6ee7b7;
+    --apifn-blue:#93c5fd;--apifn-yellow:#fcd34d;--apifn-red:#fca5a5;
+    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif
+  `;
+  const light = `
+    --apifn-bg:#ffffff;--apifn-bg-surface:#f8fafc;--apifn-bg-surface-hover:#f1f5f9;
+    --apifn-border:#e2e8f0;--apifn-text:#0f172a;--apifn-text-muted:#64748b;
+    --apifn-accent:#7c3aed;--apifn-accent-text:#6d28d9;--apifn-green:#059669;
+    --apifn-blue:#2563eb;--apifn-yellow:#d97706;--apifn-red:#dc2626;
+    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif
+  `;
+  if (theme === "dark") return `.apifn-root{${dark}}`;
+  if (theme === "light") return `.apifn-root{${light}}`;
+  return `.apifn-root{${light}}@media(prefers-color-scheme:dark){.apifn-root{${dark}}}`;
+}
+var s = {
+  root: {
+    fontFamily: "var(--apifn-font-sans)",
+    color: "var(--apifn-text)",
+    background: "var(--apifn-bg)",
+    maxWidth: "960px",
+    margin: "0 auto",
+    padding: "0 24px 48px"
+  },
+  pageTitle: { fontSize: "28px", fontWeight: 800, marginBottom: "8px" },
+  pageSubtitle: { fontSize: "14px", color: "var(--apifn-text-muted)", marginBottom: "40px" },
+  card: {
+    border: "1px solid var(--apifn-border)",
+    borderRadius: "var(--apifn-radius)",
+    marginBottom: "24px",
+    overflow: "hidden",
+    background: "var(--apifn-bg-surface)"
+  },
+  cardHeader: {
+    width: "100%",
+    border: "none",
+    background: "none",
+    color: "inherit",
+    font: "inherit",
+    textAlign: "left",
+    display: "flex",
+    alignItems: "center",
+    gap: "12px",
+    padding: "14px 20px",
+    cursor: "pointer",
+    borderBottom: "1px solid var(--apifn-border)"
+  },
+  badge: (method) => {
+    const c = METHOD_COLORS[method.toLowerCase()] ?? { bg: "#2d3748", text: "#9ca3af" };
+    return { padding: "3px 10px", borderRadius: "3px", background: c.bg, color: c.text, fontWeight: 700, fontSize: "12px", fontFamily: "var(--apifn-font-mono)", textTransform: "uppercase" };
+  },
+  cardPath: { fontFamily: "var(--apifn-font-mono)", fontSize: "14px", fontWeight: 600, flex: 1 },
+  cardSummary: { fontSize: "13px", color: "var(--apifn-text-muted)" },
+  tabs: {
+    display: "flex",
+    borderBottom: "1px solid var(--apifn-border)",
+    padding: "0 20px"
+  },
+  tab: (active) => ({
+    padding: "10px 14px",
+    fontSize: "13px",
+    fontWeight: active ? 600 : 400,
+    color: active ? "var(--apifn-text)" : "var(--apifn-text-muted)",
+    border: "none",
+    borderBottomWidth: "2px",
+    borderBottomStyle: "solid",
+    borderBottomColor: active ? "var(--apifn-accent)" : "transparent",
+    background: "none",
+    cursor: "pointer"
+  })
+};
+function EndpointCard({
+  path,
+  method,
+  operation,
+  tryIt,
+  baseUrl,
+  performanceMetrics
+}) {
+  const [open, setOpen] = (0, import_react.useState)(false);
+  const [tab, setTab] = (0, import_react.useState)("docs");
+  const perfKey = `${method.toUpperCase()} ${path}`;
+  const rawMetrics = performanceMetrics?.[perfKey];
+  const anchorId = `${method.toLowerCase()}-${path.replace(/[^a-z0-9]/gi, "-")}`;
+  const perfMetrics = rawMetrics ? { endpoint: path, method, lastUpdated: (/* @__PURE__ */ new Date()).toISOString(), ...rawMetrics } : void 0;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { id: anchorId, style: s.card, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("button", { type: "button", style: s.cardHeader, "aria-expanded": open, onClick: () => setOpen((o) => !o), children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: s.badge(method), children: method.toUpperCase() }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: s.cardPath, children: path }),
+      operation.summary && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: s.cardSummary, children: operation.summary }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", style: { color: "var(--apifn-text-muted)", fontSize: "12px", transform: open ? "rotate(180deg)" : "none", transition: "transform .15s" }, children: "\u25BC" })
+    ] }),
+    open && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: s.tabs, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { style: s.tab(tab === "docs"), onClick: () => setTab("docs"), children: "Docs" }),
+        tryIt && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { style: s.tab(tab === "tryit"), onClick: () => setTab("tryit"), children: "Try It" }),
+        perfMetrics && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { style: s.tab(tab === "perf"), onClick: () => setTab("perf"), children: "Performance" })
+      ] }),
+      tab === "docs" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react2.EndpointViewer, { path, method, operation }),
+      tab === "tryit" && tryIt && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react2.TryIt, { path, method, operation, baseUrl }),
+      tab === "perf" && perfMetrics && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { padding: "20px" }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react2.PerformanceOverlay, { metrics: perfMetrics }) })
+    ] })
+  ] });
+}
+function ApifnApiReference({
+  entry,
+  tryIt = false,
+  baseUrl,
+  theme = "auto",
+  performanceMetrics
+}) {
+  const themeStyle = getThemeStyle(theme);
+  const effectiveBaseUrl = baseUrl ?? entry.baseUrl ?? entry.spec.servers?.[0]?.url ?? "https://api.example.com";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "apifn-root", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("style", { children: themeStyle }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: s.root, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h1", { style: s.pageTitle, children: entry.title }),
+      entry.tag && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: s.pageSubtitle, children: [
+        "Tag: ",
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("code", { style: { fontFamily: "var(--apifn-font-mono)" }, children: entry.tag }),
+        " \u2014 ",
+        entry.endpoints.length,
+        " endpoint",
+        entry.endpoints.length !== 1 ? "s" : ""
+      ] }),
+      entry.endpoints.map((ep) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        EndpointCard,
+        {
+          path: ep.path,
+          method: ep.method,
+          operation: ep.operation,
+          tryIt,
+          baseUrl: effectiveBaseUrl,
+          performanceMetrics
+        },
+        `${ep.method}-${ep.path}`
+      ))
+    ] })
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApifnApiReference
+});
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/ApifnApiReference.tsx"],"sourcesContent":["/**\n * ApifnApiReference (React) — renders a docsfn RawContentEntry as an API reference page (DOCS-002, DOCS-005).\n */\n\nimport React, { useState } from \"react\";\nimport { EndpointViewer, TryIt, PerformanceOverlay } from \"@apifn/react\";\nimport type { ApifnApiReferenceProps, PerformanceMetrics } from \"../types.js\";\nimport type { OperationObject } from \"@apifn/core\";\n\nexport type { ApifnApiReferenceProps };\n\n// Inline method colors — avoids importing internal @apifn/react paths\nconst METHOD_COLORS: Record<string, { bg: string; text: string }> = {\n    get: { bg: \"#065f46\", text: \"#6ee7b7\" },\n    post: { bg: \"#1e3a5f\", text: \"#93c5fd\" },\n    put: { bg: \"#78350f\", text: \"#fcd34d\" },\n    patch: { bg: \"#5b21b6\", text: \"#c4b5fd\" },\n    delete: { bg: \"#7f1d1d\", text: \"#fca5a5\" },\n    head: { bg: \"#1f2937\", text: \"#9ca3af\" },\n    options: { bg: \"#1f2937\", text: \"#9ca3af\" },\n};\n\nfunction getThemeStyle(theme: \"light\" | \"dark\" | \"auto\"): string {\n    const dark = `\n    --apifn-bg:#0f1117;--apifn-bg-surface:#1a1d2e;--apifn-bg-surface-hover:#252840;\n    --apifn-border:#2d3748;--apifn-text:#e2e8f0;--apifn-text-muted:#64748b;\n    --apifn-accent:#7c3aed;--apifn-accent-text:#c4b5fd;--apifn-green:#6ee7b7;\n    --apifn-blue:#93c5fd;--apifn-yellow:#fcd34d;--apifn-red:#fca5a5;\n    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif\n  `;\n    const light = `\n    --apifn-bg:#ffffff;--apifn-bg-surface:#f8fafc;--apifn-bg-surface-hover:#f1f5f9;\n    --apifn-border:#e2e8f0;--apifn-text:#0f172a;--apifn-text-muted:#64748b;\n    --apifn-accent:#7c3aed;--apifn-accent-text:#6d28d9;--apifn-green:#059669;\n    --apifn-blue:#2563eb;--apifn-yellow:#d97706;--apifn-red:#dc2626;\n    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif\n  `;\n    if (theme === \"dark\") return `.apifn-root{${dark}}`;\n    if (theme === \"light\") return `.apifn-root{${light}}`;\n    return `.apifn-root{${light}}@media(prefers-color-scheme:dark){.apifn-root{${dark}}}`;\n}\n\nconst s = {\n    root: {\n        fontFamily: \"var(--apifn-font-sans)\",\n        color: \"var(--apifn-text)\",\n        background: \"var(--apifn-bg)\",\n        maxWidth: \"960px\",\n        margin: \"0 auto\",\n        padding: \"0 24px 48px\",\n    } as React.CSSProperties,\n    pageTitle: { fontSize: \"28px\", fontWeight: 800, marginBottom: \"8px\" } as React.CSSProperties,\n    pageSubtitle: { fontSize: \"14px\", color: \"var(--apifn-text-muted)\", marginBottom: \"40px\" } as React.CSSProperties,\n    card: {\n        border: \"1px solid var(--apifn-border)\",\n        borderRadius: \"var(--apifn-radius)\",\n        marginBottom: \"24px\",\n        overflow: \"hidden\",\n        background: \"var(--apifn-bg-surface)\",\n    } as React.CSSProperties,\n    cardHeader: {\n        width: \"100%\", border: \"none\", background: \"none\",\n        color: \"inherit\", font: \"inherit\", textAlign: \"left\",\n        display: \"flex\", alignItems: \"center\", gap: \"12px\",\n        padding: \"14px 20px\", cursor: \"pointer\",\n        borderBottom: \"1px solid var(--apifn-border)\",\n    } as React.CSSProperties,\n    badge: (method: string): React.CSSProperties => {\n        const c = METHOD_COLORS[method.toLowerCase()] ?? { bg: \"#2d3748\", text: \"#9ca3af\" };\n        return { padding: \"3px 10px\", borderRadius: \"3px\", background: c.bg, color: c.text, fontWeight: 700, fontSize: \"12px\", fontFamily: \"var(--apifn-font-mono)\", textTransform: \"uppercase\" };\n    },\n    cardPath: { fontFamily: \"var(--apifn-font-mono)\", fontSize: \"14px\", fontWeight: 600, flex: 1 } as React.CSSProperties,\n    cardSummary: { fontSize: \"13px\", color: \"var(--apifn-text-muted)\" } as React.CSSProperties,\n    tabs: {\n        display: \"flex\", borderBottom: \"1px solid var(--apifn-border)\", padding: \"0 20px\",\n    } as React.CSSProperties,\n    tab: (active: boolean): React.CSSProperties => ({\n        padding: \"10px 14px\", fontSize: \"13px\",\n        fontWeight: active ? 600 : 400,\n        color: active ? \"var(--apifn-text)\" : \"var(--apifn-text-muted)\",\n        border: \"none\", borderBottomWidth: \"2px\", borderBottomStyle: \"solid\",\n        borderBottomColor: active ? \"var(--apifn-accent)\" : \"transparent\",\n        background: \"none\", cursor: \"pointer\",\n    }),\n};\n\nfunction EndpointCard({\n    path, method, operation, tryIt, baseUrl, performanceMetrics,\n}: Readonly<{\n    path: string;\n    method: string;\n    operation: OperationObject;\n    tryIt: boolean;\n    baseUrl: string;\n    performanceMetrics?: ApifnApiReferenceProps[\"performanceMetrics\"];\n}>) {\n    const [open, setOpen] = useState(false);\n    const [tab, setTab] = useState<\"docs\" | \"tryit\" | \"perf\">(\"docs\");\n\n    const perfKey = `${method.toUpperCase()} ${path}`;\n    const rawMetrics = performanceMetrics?.[perfKey];\n    const anchorId = `${method.toLowerCase()}-${path.replace(/[^a-z0-9]/gi, \"-\")}`;\n\n    const perfMetrics: PerformanceMetrics | undefined = rawMetrics\n        ? { endpoint: path, method, lastUpdated: new Date().toISOString(), ...rawMetrics }\n        : undefined;\n\n    return (\n        <div id={anchorId} style={s.card}>\n            <button type=\"button\" style={s.cardHeader} aria-expanded={open} onClick={() => setOpen((o) => !o)}>\n                <span style={s.badge(method)}>{method.toUpperCase()}</span>\n                <span style={s.cardPath}>{path}</span>\n                {operation.summary && <span style={s.cardSummary}>{operation.summary as string}</span>}\n                <span aria-hidden=\"true\" style={{ color: \"var(--apifn-text-muted)\", fontSize: \"12px\", transform: open ? \"rotate(180deg)\" : \"none\", transition: \"transform .15s\" }}>▼</span>\n            </button>\n\n            {open && (\n                <>\n                    <div style={s.tabs}>\n                        <button style={s.tab(tab === \"docs\")} onClick={() => setTab(\"docs\")}>Docs</button>\n                        {tryIt && <button style={s.tab(tab === \"tryit\")} onClick={() => setTab(\"tryit\")}>Try It</button>}\n                        {perfMetrics && <button style={s.tab(tab === \"perf\")} onClick={() => setTab(\"perf\")}>Performance</button>}\n                    </div>\n                    {tab === \"docs\" && <EndpointViewer path={path} method={method} operation={operation} />}\n                    {tab === \"tryit\" && tryIt && <TryIt path={path} method={method} operation={operation} baseUrl={baseUrl} />}\n                    {tab === \"perf\" && perfMetrics && (\n                        <div style={{ padding: \"20px\" }}>\n                            <PerformanceOverlay metrics={perfMetrics} />\n                        </div>\n                    )}\n                </>\n            )}\n        </div>\n    );\n}\n\nexport function ApifnApiReference({\n    entry, tryIt = false, baseUrl, theme = \"auto\", performanceMetrics,\n}: Readonly<ApifnApiReferenceProps>): React.ReactElement {\n    const themeStyle = getThemeStyle(theme);\n    const effectiveBaseUrl =\n        baseUrl\n        ?? entry.baseUrl\n        ?? (entry.spec as { servers?: Array<{ url: string }> }).servers?.[0]?.url\n        ?? \"https://api.example.com\";\n\n    return (\n        <div className=\"apifn-root\">\n            <style>{themeStyle}</style>\n            <div style={s.root}>\n                <h1 style={s.pageTitle}>{entry.title}</h1>\n                {entry.tag && (\n                    <div style={s.pageSubtitle}>\n                        Tag: <code style={{ fontFamily: \"var(--apifn-font-mono)\" }}>{entry.tag}</code>\n                        {\" — \"}\n                        {entry.endpoints.length} endpoint{entry.endpoints.length !== 1 ? \"s\" : \"\"}\n                    </div>\n                )}\n                {entry.endpoints.map((ep) => (\n                    <EndpointCard\n                        key={`${ep.method}-${ep.path}`}\n                        path={ep.path}\n                        method={ep.method}\n                        operation={ep.operation}\n                        tryIt={tryIt}\n                        baseUrl={effectiveBaseUrl}\n                        performanceMetrics={performanceMetrics}\n                    />\n                ))}\n            </div>\n        </div>\n    );\n}\n"],"mappings":"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","names":["import_react"]}

package/dist/react.d.cts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { a as ApifnApiReferenceProps } from './types-D4LTWU9V.cjs';
+import '@apifn/core';
+
+/**
+ * ApifnApiReference (React) — renders a docsfn RawContentEntry as an API reference page (DOCS-002, DOCS-005).
+ */
+
+declare function ApifnApiReference({ entry, tryIt, baseUrl, theme, performanceMetrics, }: Readonly<ApifnApiReferenceProps>): React.ReactElement;
+
+export { ApifnApiReference, ApifnApiReferenceProps };

package/dist/react.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { a as ApifnApiReferenceProps } from './types-D4LTWU9V.js';
+import '@apifn/core';
+
+/**
+ * ApifnApiReference (React) — renders a docsfn RawContentEntry as an API reference page (DOCS-002, DOCS-005).
+ */
+
+declare function ApifnApiReference({ entry, tryIt, baseUrl, theme, performanceMetrics, }: Readonly<ApifnApiReferenceProps>): React.ReactElement;
+
+export { ApifnApiReference, ApifnApiReferenceProps };

package/dist/react.js

@@ -0,0 +1,161 @@
+// src/react/ApifnApiReference.tsx
+import { useState } from "react";
+import { EndpointViewer, TryIt, PerformanceOverlay } from "@apifn/react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var METHOD_COLORS = {
+  get: { bg: "#065f46", text: "#6ee7b7" },
+  post: { bg: "#1e3a5f", text: "#93c5fd" },
+  put: { bg: "#78350f", text: "#fcd34d" },
+  patch: { bg: "#5b21b6", text: "#c4b5fd" },
+  delete: { bg: "#7f1d1d", text: "#fca5a5" },
+  head: { bg: "#1f2937", text: "#9ca3af" },
+  options: { bg: "#1f2937", text: "#9ca3af" }
+};
+function getThemeStyle(theme) {
+  const dark = `
+    --apifn-bg:#0f1117;--apifn-bg-surface:#1a1d2e;--apifn-bg-surface-hover:#252840;
+    --apifn-border:#2d3748;--apifn-text:#e2e8f0;--apifn-text-muted:#64748b;
+    --apifn-accent:#7c3aed;--apifn-accent-text:#c4b5fd;--apifn-green:#6ee7b7;
+    --apifn-blue:#93c5fd;--apifn-yellow:#fcd34d;--apifn-red:#fca5a5;
+    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif
+  `;
+  const light = `
+    --apifn-bg:#ffffff;--apifn-bg-surface:#f8fafc;--apifn-bg-surface-hover:#f1f5f9;
+    --apifn-border:#e2e8f0;--apifn-text:#0f172a;--apifn-text-muted:#64748b;
+    --apifn-accent:#7c3aed;--apifn-accent-text:#6d28d9;--apifn-green:#059669;
+    --apifn-blue:#2563eb;--apifn-yellow:#d97706;--apifn-red:#dc2626;
+    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif
+  `;
+  if (theme === "dark") return `.apifn-root{${dark}}`;
+  if (theme === "light") return `.apifn-root{${light}}`;
+  return `.apifn-root{${light}}@media(prefers-color-scheme:dark){.apifn-root{${dark}}}`;
+}
+var s = {
+  root: {
+    fontFamily: "var(--apifn-font-sans)",
+    color: "var(--apifn-text)",
+    background: "var(--apifn-bg)",
+    maxWidth: "960px",
+    margin: "0 auto",
+    padding: "0 24px 48px"
+  },
+  pageTitle: { fontSize: "28px", fontWeight: 800, marginBottom: "8px" },
+  pageSubtitle: { fontSize: "14px", color: "var(--apifn-text-muted)", marginBottom: "40px" },
+  card: {
+    border: "1px solid var(--apifn-border)",
+    borderRadius: "var(--apifn-radius)",
+    marginBottom: "24px",
+    overflow: "hidden",
+    background: "var(--apifn-bg-surface)"
+  },
+  cardHeader: {
+    width: "100%",
+    border: "none",
+    background: "none",
+    color: "inherit",
+    font: "inherit",
+    textAlign: "left",
+    display: "flex",
+    alignItems: "center",
+    gap: "12px",
+    padding: "14px 20px",
+    cursor: "pointer",
+    borderBottom: "1px solid var(--apifn-border)"
+  },
+  badge: (method) => {
+    const c = METHOD_COLORS[method.toLowerCase()] ?? { bg: "#2d3748", text: "#9ca3af" };
+    return { padding: "3px 10px", borderRadius: "3px", background: c.bg, color: c.text, fontWeight: 700, fontSize: "12px", fontFamily: "var(--apifn-font-mono)", textTransform: "uppercase" };
+  },
+  cardPath: { fontFamily: "var(--apifn-font-mono)", fontSize: "14px", fontWeight: 600, flex: 1 },
+  cardSummary: { fontSize: "13px", color: "var(--apifn-text-muted)" },
+  tabs: {
+    display: "flex",
+    borderBottom: "1px solid var(--apifn-border)",
+    padding: "0 20px"
+  },
+  tab: (active) => ({
+    padding: "10px 14px",
+    fontSize: "13px",
+    fontWeight: active ? 600 : 400,
+    color: active ? "var(--apifn-text)" : "var(--apifn-text-muted)",
+    border: "none",
+    borderBottomWidth: "2px",
+    borderBottomStyle: "solid",
+    borderBottomColor: active ? "var(--apifn-accent)" : "transparent",
+    background: "none",
+    cursor: "pointer"
+  })
+};
+function EndpointCard({
+  path,
+  method,
+  operation,
+  tryIt,
+  baseUrl,
+  performanceMetrics
+}) {
+  const [open, setOpen] = useState(false);
+  const [tab, setTab] = useState("docs");
+  const perfKey = `${method.toUpperCase()} ${path}`;
+  const rawMetrics = performanceMetrics?.[perfKey];
+  const anchorId = `${method.toLowerCase()}-${path.replace(/[^a-z0-9]/gi, "-")}`;
+  const perfMetrics = rawMetrics ? { endpoint: path, method, lastUpdated: (/* @__PURE__ */ new Date()).toISOString(), ...rawMetrics } : void 0;
+  return /* @__PURE__ */ jsxs("div", { id: anchorId, style: s.card, children: [
+    /* @__PURE__ */ jsxs("button", { type: "button", style: s.cardHeader, "aria-expanded": open, onClick: () => setOpen((o) => !o), children: [
+      /* @__PURE__ */ jsx("span", { style: s.badge(method), children: method.toUpperCase() }),
+      /* @__PURE__ */ jsx("span", { style: s.cardPath, children: path }),
+      operation.summary && /* @__PURE__ */ jsx("span", { style: s.cardSummary, children: operation.summary }),
+      /* @__PURE__ */ jsx("span", { "aria-hidden": "true", style: { color: "var(--apifn-text-muted)", fontSize: "12px", transform: open ? "rotate(180deg)" : "none", transition: "transform .15s" }, children: "\u25BC" })
+    ] }),
+    open && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsxs("div", { style: s.tabs, children: [
+        /* @__PURE__ */ jsx("button", { style: s.tab(tab === "docs"), onClick: () => setTab("docs"), children: "Docs" }),
+        tryIt && /* @__PURE__ */ jsx("button", { style: s.tab(tab === "tryit"), onClick: () => setTab("tryit"), children: "Try It" }),
+        perfMetrics && /* @__PURE__ */ jsx("button", { style: s.tab(tab === "perf"), onClick: () => setTab("perf"), children: "Performance" })
+      ] }),
+      tab === "docs" && /* @__PURE__ */ jsx(EndpointViewer, { path, method, operation }),
+      tab === "tryit" && tryIt && /* @__PURE__ */ jsx(TryIt, { path, method, operation, baseUrl }),
+      tab === "perf" && perfMetrics && /* @__PURE__ */ jsx("div", { style: { padding: "20px" }, children: /* @__PURE__ */ jsx(PerformanceOverlay, { metrics: perfMetrics }) })
+    ] })
+  ] });
+}
+function ApifnApiReference({
+  entry,
+  tryIt = false,
+  baseUrl,
+  theme = "auto",
+  performanceMetrics
+}) {
+  const themeStyle = getThemeStyle(theme);
+  const effectiveBaseUrl = baseUrl ?? entry.baseUrl ?? entry.spec.servers?.[0]?.url ?? "https://api.example.com";
+  return /* @__PURE__ */ jsxs("div", { className: "apifn-root", children: [
+    /* @__PURE__ */ jsx("style", { children: themeStyle }),
+    /* @__PURE__ */ jsxs("div", { style: s.root, children: [
+      /* @__PURE__ */ jsx("h1", { style: s.pageTitle, children: entry.title }),
+      entry.tag && /* @__PURE__ */ jsxs("div", { style: s.pageSubtitle, children: [
+        "Tag: ",
+        /* @__PURE__ */ jsx("code", { style: { fontFamily: "var(--apifn-font-mono)" }, children: entry.tag }),
+        " \u2014 ",
+        entry.endpoints.length,
+        " endpoint",
+        entry.endpoints.length !== 1 ? "s" : ""
+      ] }),
+      entry.endpoints.map((ep) => /* @__PURE__ */ jsx(
+        EndpointCard,
+        {
+          path: ep.path,
+          method: ep.method,
+          operation: ep.operation,
+          tryIt,
+          baseUrl: effectiveBaseUrl,
+          performanceMetrics
+        },
+        `${ep.method}-${ep.path}`
+      ))
+    ] })
+  ] });
+}
+export {
+  ApifnApiReference
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/ApifnApiReference.tsx"],"sourcesContent":["/**\n * ApifnApiReference (React) — renders a docsfn RawContentEntry as an API reference page (DOCS-002, DOCS-005).\n */\n\nimport React, { useState } from \"react\";\nimport { EndpointViewer, TryIt, PerformanceOverlay } from \"@apifn/react\";\nimport type { ApifnApiReferenceProps, PerformanceMetrics } from \"../types.js\";\nimport type { OperationObject } from \"@apifn/core\";\n\nexport type { ApifnApiReferenceProps };\n\n// Inline method colors — avoids importing internal @apifn/react paths\nconst METHOD_COLORS: Record<string, { bg: string; text: string }> = {\n    get: { bg: \"#065f46\", text: \"#6ee7b7\" },\n    post: { bg: \"#1e3a5f\", text: \"#93c5fd\" },\n    put: { bg: \"#78350f\", text: \"#fcd34d\" },\n    patch: { bg: \"#5b21b6\", text: \"#c4b5fd\" },\n    delete: { bg: \"#7f1d1d\", text: \"#fca5a5\" },\n    head: { bg: \"#1f2937\", text: \"#9ca3af\" },\n    options: { bg: \"#1f2937\", text: \"#9ca3af\" },\n};\n\nfunction getThemeStyle(theme: \"light\" | \"dark\" | \"auto\"): string {\n    const dark = `\n    --apifn-bg:#0f1117;--apifn-bg-surface:#1a1d2e;--apifn-bg-surface-hover:#252840;\n    --apifn-border:#2d3748;--apifn-text:#e2e8f0;--apifn-text-muted:#64748b;\n    --apifn-accent:#7c3aed;--apifn-accent-text:#c4b5fd;--apifn-green:#6ee7b7;\n    --apifn-blue:#93c5fd;--apifn-yellow:#fcd34d;--apifn-red:#fca5a5;\n    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif\n  `;\n    const light = `\n    --apifn-bg:#ffffff;--apifn-bg-surface:#f8fafc;--apifn-bg-surface-hover:#f1f5f9;\n    --apifn-border:#e2e8f0;--apifn-text:#0f172a;--apifn-text-muted:#64748b;\n    --apifn-accent:#7c3aed;--apifn-accent-text:#6d28d9;--apifn-green:#059669;\n    --apifn-blue:#2563eb;--apifn-yellow:#d97706;--apifn-red:#dc2626;\n    --apifn-radius:6px;--apifn-font-mono:'JetBrains Mono',monospace;--apifn-font-sans:-apple-system,sans-serif\n  `;\n    if (theme === \"dark\") return `.apifn-root{${dark}}`;\n    if (theme === \"light\") return `.apifn-root{${light}}`;\n    return `.apifn-root{${light}}@media(prefers-color-scheme:dark){.apifn-root{${dark}}}`;\n}\n\nconst s = {\n    root: {\n        fontFamily: \"var(--apifn-font-sans)\",\n        color: \"var(--apifn-text)\",\n        background: \"var(--apifn-bg)\",\n        maxWidth: \"960px\",\n        margin: \"0 auto\",\n        padding: \"0 24px 48px\",\n    } as React.CSSProperties,\n    pageTitle: { fontSize: \"28px\", fontWeight: 800, marginBottom: \"8px\" } as React.CSSProperties,\n    pageSubtitle: { fontSize: \"14px\", color: \"var(--apifn-text-muted)\", marginBottom: \"40px\" } as React.CSSProperties,\n    card: {\n        border: \"1px solid var(--apifn-border)\",\n        borderRadius: \"var(--apifn-radius)\",\n        marginBottom: \"24px\",\n        overflow: \"hidden\",\n        background: \"var(--apifn-bg-surface)\",\n    } as React.CSSProperties,\n    cardHeader: {\n        width: \"100%\", border: \"none\", background: \"none\",\n        color: \"inherit\", font: \"inherit\", textAlign: \"left\",\n        display: \"flex\", alignItems: \"center\", gap: \"12px\",\n        padding: \"14px 20px\", cursor: \"pointer\",\n        borderBottom: \"1px solid var(--apifn-border)\",\n    } as React.CSSProperties,\n    badge: (method: string): React.CSSProperties => {\n        const c = METHOD_COLORS[method.toLowerCase()] ?? { bg: \"#2d3748\", text: \"#9ca3af\" };\n        return { padding: \"3px 10px\", borderRadius: \"3px\", background: c.bg, color: c.text, fontWeight: 700, fontSize: \"12px\", fontFamily: \"var(--apifn-font-mono)\", textTransform: \"uppercase\" };\n    },\n    cardPath: { fontFamily: \"var(--apifn-font-mono)\", fontSize: \"14px\", fontWeight: 600, flex: 1 } as React.CSSProperties,\n    cardSummary: { fontSize: \"13px\", color: \"var(--apifn-text-muted)\" } as React.CSSProperties,\n    tabs: {\n        display: \"flex\", borderBottom: \"1px solid var(--apifn-border)\", padding: \"0 20px\",\n    } as React.CSSProperties,\n    tab: (active: boolean): React.CSSProperties => ({\n        padding: \"10px 14px\", fontSize: \"13px\",\n        fontWeight: active ? 600 : 400,\n        color: active ? \"var(--apifn-text)\" : \"var(--apifn-text-muted)\",\n        border: \"none\", borderBottomWidth: \"2px\", borderBottomStyle: \"solid\",\n        borderBottomColor: active ? \"var(--apifn-accent)\" : \"transparent\",\n        background: \"none\", cursor: \"pointer\",\n    }),\n};\n\nfunction EndpointCard({\n    path, method, operation, tryIt, baseUrl, performanceMetrics,\n}: Readonly<{\n    path: string;\n    method: string;\n    operation: OperationObject;\n    tryIt: boolean;\n    baseUrl: string;\n    performanceMetrics?: ApifnApiReferenceProps[\"performanceMetrics\"];\n}>) {\n    const [open, setOpen] = useState(false);\n    const [tab, setTab] = useState<\"docs\" | \"tryit\" | \"perf\">(\"docs\");\n\n    const perfKey = `${method.toUpperCase()} ${path}`;\n    const rawMetrics = performanceMetrics?.[perfKey];\n    const anchorId = `${method.toLowerCase()}-${path.replace(/[^a-z0-9]/gi, \"-\")}`;\n\n    const perfMetrics: PerformanceMetrics | undefined = rawMetrics\n        ? { endpoint: path, method, lastUpdated: new Date().toISOString(), ...rawMetrics }\n        : undefined;\n\n    return (\n        <div id={anchorId} style={s.card}>\n            <button type=\"button\" style={s.cardHeader} aria-expanded={open} onClick={() => setOpen((o) => !o)}>\n                <span style={s.badge(method)}>{method.toUpperCase()}</span>\n                <span style={s.cardPath}>{path}</span>\n                {operation.summary && <span style={s.cardSummary}>{operation.summary as string}</span>}\n                <span aria-hidden=\"true\" style={{ color: \"var(--apifn-text-muted)\", fontSize: \"12px\", transform: open ? \"rotate(180deg)\" : \"none\", transition: \"transform .15s\" }}>▼</span>\n            </button>\n\n            {open && (\n                <>\n                    <div style={s.tabs}>\n                        <button style={s.tab(tab === \"docs\")} onClick={() => setTab(\"docs\")}>Docs</button>\n                        {tryIt && <button style={s.tab(tab === \"tryit\")} onClick={() => setTab(\"tryit\")}>Try It</button>}\n                        {perfMetrics && <button style={s.tab(tab === \"perf\")} onClick={() => setTab(\"perf\")}>Performance</button>}\n                    </div>\n                    {tab === \"docs\" && <EndpointViewer path={path} method={method} operation={operation} />}\n                    {tab === \"tryit\" && tryIt && <TryIt path={path} method={method} operation={operation} baseUrl={baseUrl} />}\n                    {tab === \"perf\" && perfMetrics && (\n                        <div style={{ padding: \"20px\" }}>\n                            <PerformanceOverlay metrics={perfMetrics} />\n                        </div>\n                    )}\n                </>\n            )}\n        </div>\n    );\n}\n\nexport function ApifnApiReference({\n    entry, tryIt = false, baseUrl, theme = \"auto\", performanceMetrics,\n}: Readonly<ApifnApiReferenceProps>): React.ReactElement {\n    const themeStyle = getThemeStyle(theme);\n    const effectiveBaseUrl =\n        baseUrl\n        ?? entry.baseUrl\n        ?? (entry.spec as { servers?: Array<{ url: string }> }).servers?.[0]?.url\n        ?? \"https://api.example.com\";\n\n    return (\n        <div className=\"apifn-root\">\n            <style>{themeStyle}</style>\n            <div style={s.root}>\n                <h1 style={s.pageTitle}>{entry.title}</h1>\n                {entry.tag && (\n                    <div style={s.pageSubtitle}>\n                        Tag: <code style={{ fontFamily: \"var(--apifn-font-mono)\" }}>{entry.tag}</code>\n                        {\" — \"}\n                        {entry.endpoints.length} endpoint{entry.endpoints.length !== 1 ? \"s\" : \"\"}\n                    </div>\n                )}\n                {entry.endpoints.map((ep) => (\n                    <EndpointCard\n                        key={`${ep.method}-${ep.path}`}\n                        path={ep.path}\n                        method={ep.method}\n                        operation={ep.operation}\n                        tryIt={tryIt}\n                        baseUrl={effectiveBaseUrl}\n                        performanceMetrics={performanceMetrics}\n                    />\n                ))}\n            </div>\n        </div>\n    );\n}\n"],"mappings":"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","names":[]}

package/dist/types-D4LTWU9V.d.cts

@@ -0,0 +1,97 @@
+import { OperationObject, OpenAPIDocument } from '@apifn/core';
+
+/**
+ * docsfn integration types for @apifn/docsfn.
+ *
+ * docsfn is an optional peer dependency that may not be installed.
+ * We define the minimal interfaces needed for our provider here so
+ * consumers get correct types even without the full docsfn package.
+ */
+
+/** Sidebar leaf link. */
+interface SidebarLink {
+    type: "link";
+    label: string;
+    href: string;
+}
+/** Sidebar group containing links. */
+interface SidebarGroup {
+    type: "group";
+    label: string;
+    items: Array<SidebarLink | SidebarGroup>;
+}
+type SidebarItem = SidebarLink | SidebarGroup;
+/** A processed endpoint grouped in a docsfn page. */
+interface ApiEndpoint {
+    path: string;
+    method: string;
+    operation: OperationObject;
+    tag: string;
+}
+/**
+ * A single raw content entry produced by a DocsContentProvider.
+ * `kind: "api"` signals to docsfn that this is an API reference page.
+ */
+interface RawContentEntry {
+    kind: "api";
+    /** URL slug for this page (e.g. "/api/users") */
+    slug: string;
+    /** Human-readable page title */
+    title: string;
+    /** Tag name when split by tag */
+    tag?: string;
+    /** Endpoint list for this page */
+    endpoints: ApiEndpoint[];
+    /** Sidebar items generated for this entry */
+    sidebar: SidebarGroup;
+    /** Full OpenAPI spec (so renderers can look up $refs etc.) */
+    spec: OpenAPIDocument;
+    /** Optional Try-It base URL supplied by the provider */
+    baseUrl?: string;
+}
+/** A DocsContentProvider is a callable that returns RawContentEntry[]. */
+interface DocsContentProvider {
+    (): Promise<RawContentEntry[]>;
+    entries: RawContentEntry[];
+}
+interface CreateApifnProviderOptions {
+    /** OpenAPI document (object) */
+    spec?: OpenAPIDocument;
+    /** File path to a JSON or YAML OpenAPI spec */
+    specPath?: string;
+    /** Base path prefix for slug generation (default: "/api") */
+    basePath?: string;
+    /**
+     * Split the spec into one page per tag.
+     * - `true`  → one RawContentEntry per tag
+     * - `false` → one RawContentEntry with all endpoints
+     * @default true
+     */
+    splitByTag?: boolean;
+    /** Optional base URL to embed in entries (for TryIt) */
+    baseUrl?: string;
+}
+interface PerformanceMetrics {
+    endpoint: string;
+    method: string;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    errorRatePct: number;
+    requestsPerMinute: number;
+    lastUpdated: string;
+}
+interface ApifnApiReferenceProps {
+    /** Single content entry from createApifnProvider */
+    entry: RawContentEntry;
+    /** Show embedded Try-It console per endpoint (DOCS-005) */
+    tryIt?: boolean;
+    /** Base URL for Try-It requests */
+    baseUrl?: string;
+    /** Theme for the embedded components */
+    theme?: "light" | "dark" | "auto";
+    /** Optional watchfn metrics per endpoint key ("METHOD /path") */
+    performanceMetrics?: Record<string, Omit<PerformanceMetrics, "endpoint" | "method" | "lastUpdated">>;
+}
+
+export type { ApiEndpoint as A, CreateApifnProviderOptions as C, DocsContentProvider as D, RawContentEntry as R, SidebarGroup as S, ApifnApiReferenceProps as a, SidebarItem as b, SidebarLink as c };

package/dist/types-D4LTWU9V.d.ts

@@ -0,0 +1,97 @@
+import { OperationObject, OpenAPIDocument } from '@apifn/core';
+
+/**
+ * docsfn integration types for @apifn/docsfn.
+ *
+ * docsfn is an optional peer dependency that may not be installed.
+ * We define the minimal interfaces needed for our provider here so
+ * consumers get correct types even without the full docsfn package.
+ */
+
+/** Sidebar leaf link. */
+interface SidebarLink {
+    type: "link";
+    label: string;
+    href: string;
+}
+/** Sidebar group containing links. */
+interface SidebarGroup {
+    type: "group";
+    label: string;
+    items: Array<SidebarLink | SidebarGroup>;
+}
+type SidebarItem = SidebarLink | SidebarGroup;
+/** A processed endpoint grouped in a docsfn page. */
+interface ApiEndpoint {
+    path: string;
+    method: string;
+    operation: OperationObject;
+    tag: string;
+}
+/**
+ * A single raw content entry produced by a DocsContentProvider.
+ * `kind: "api"` signals to docsfn that this is an API reference page.
+ */
+interface RawContentEntry {
+    kind: "api";
+    /** URL slug for this page (e.g. "/api/users") */
+    slug: string;
+    /** Human-readable page title */
+    title: string;
+    /** Tag name when split by tag */
+    tag?: string;
+    /** Endpoint list for this page */
+    endpoints: ApiEndpoint[];
+    /** Sidebar items generated for this entry */
+    sidebar: SidebarGroup;
+    /** Full OpenAPI spec (so renderers can look up $refs etc.) */
+    spec: OpenAPIDocument;
+    /** Optional Try-It base URL supplied by the provider */
+    baseUrl?: string;
+}
+/** A DocsContentProvider is a callable that returns RawContentEntry[]. */
+interface DocsContentProvider {
+    (): Promise<RawContentEntry[]>;
+    entries: RawContentEntry[];
+}
+interface CreateApifnProviderOptions {
+    /** OpenAPI document (object) */
+    spec?: OpenAPIDocument;
+    /** File path to a JSON or YAML OpenAPI spec */
+    specPath?: string;
+    /** Base path prefix for slug generation (default: "/api") */
+    basePath?: string;
+    /**
+     * Split the spec into one page per tag.
+     * - `true`  → one RawContentEntry per tag
+     * - `false` → one RawContentEntry with all endpoints
+     * @default true
+     */
+    splitByTag?: boolean;
+    /** Optional base URL to embed in entries (for TryIt) */
+    baseUrl?: string;
+}
+interface PerformanceMetrics {
+    endpoint: string;
+    method: string;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    errorRatePct: number;
+    requestsPerMinute: number;
+    lastUpdated: string;
+}
+interface ApifnApiReferenceProps {
+    /** Single content entry from createApifnProvider */
+    entry: RawContentEntry;
+    /** Show embedded Try-It console per endpoint (DOCS-005) */
+    tryIt?: boolean;
+    /** Base URL for Try-It requests */
+    baseUrl?: string;
+    /** Theme for the embedded components */
+    theme?: "light" | "dark" | "auto";
+    /** Optional watchfn metrics per endpoint key ("METHOD /path") */
+    performanceMetrics?: Record<string, Omit<PerformanceMetrics, "endpoint" | "method" | "lastUpdated">>;
+}
+
+export type { ApiEndpoint as A, CreateApifnProviderOptions as C, DocsContentProvider as D, RawContentEntry as R, SidebarGroup as S, ApifnApiReferenceProps as a, SidebarItem as b, SidebarLink as c };