@cyguin/docs 0.1.0

package/dist/index.mjs

@@ -0,0 +1,438 @@
+// src/components/DocsWidget.tsx
+import { useState, useEffect, useCallback, useRef } from "react";
+import { marked } from "marked";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+marked.setOptions({ breaks: true, gfm: true });
+function HelpIcon() {
+  return /* @__PURE__ */ jsxs("svg", { width: "18", height: "18", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [
+    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
+    /* @__PURE__ */ jsx("path", { d: "M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3" }),
+    /* @__PURE__ */ jsx("path", { d: "M12 17h.01" })
+  ] });
+}
+function SearchIcon() {
+  return /* @__PURE__ */ jsxs("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [
+    /* @__PURE__ */ jsx("circle", { cx: "11", cy: "11", r: "8" }),
+    /* @__PURE__ */ jsx("path", { d: "m21 21-4.35-4.35" })
+  ] });
+}
+function CloseIcon() {
+  return /* @__PURE__ */ jsxs("svg", { width: "18", height: "18", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [
+    /* @__PURE__ */ jsx("path", { d: "M18 6 6 18" }),
+    /* @__PURE__ */ jsx("path", { d: "m6 6 12 12" })
+  ] });
+}
+function ChevronRightIcon({ expanded }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      width: "14",
+      height: "14",
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: "2",
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      style: { transform: expanded ? "rotate(90deg)" : "rotate(0deg)", transition: "transform 0.15s" },
+      children: /* @__PURE__ */ jsx("path", { d: "m9 18 6-6-6-6" })
+    }
+  );
+}
+function BackIcon() {
+  return /* @__PURE__ */ jsx("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("path", { d: "m15 18-6-6 6-6" }) });
+}
+function renderMarkdown(md) {
+  return marked.parse(md);
+}
+function groupBySection(articles) {
+  const map = /* @__PURE__ */ new Map();
+  for (const article of articles) {
+    const list = map.get(article.section) ?? [];
+    list.push(article);
+    map.set(article.section, list);
+  }
+  return Array.from(map.entries()).map(([section, arts]) => ({ section, articles: arts.sort((a, b) => a.article_order - b.article_order) })).sort((a, b) => a.section.localeCompare(b.section));
+}
+function DocsTrigger({ label, onClick }) {
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      onClick,
+      "aria-label": label,
+      style: {
+        position: "fixed",
+        bottom: "24px",
+        right: "24px",
+        zIndex: 9998,
+        width: "48px",
+        height: "48px",
+        borderRadius: "var(--cyguin-docs-radius)",
+        background: "var(--cyguin-docs-accent)",
+        color: "var(--cyguin-accent-fg, #0a0a0a)",
+        border: "none",
+        cursor: "pointer",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        boxShadow: "var(--cyguin-docs-shadow)",
+        fontWeight: 600,
+        fontSize: "14px",
+        fontFamily: "var(--cyguin-docs-font)",
+        transition: "opacity 0.15s"
+      },
+      children: /* @__PURE__ */ jsx(HelpIcon, {})
+    }
+  );
+}
+function DocsSearch({ value, onChange }) {
+  const ref = useRef(null);
+  useEffect(() => {
+    const handler = (e) => {
+      if (e.key === "/" && !e.ctrlKey && !e.metaKey) {
+        const active = document.activeElement;
+        const widget = document.getElementById("cyguin-docs-widget");
+        if (active && widget?.contains(active)) return;
+        e.preventDefault();
+        ref.current?.focus();
+      }
+    };
+    document.addEventListener("keydown", handler);
+    return () => document.removeEventListener("keydown", handler);
+  }, []);
+  return /* @__PURE__ */ jsxs("div", { style: { position: "relative", padding: "12px 12px 8px" }, children: [
+    /* @__PURE__ */ jsx(SearchIcon, {}),
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        ref,
+        type: "text",
+        value,
+        onChange: (e) => onChange(e.target.value),
+        placeholder: "Search docs... (press / to focus)",
+        "aria-label": "Search documentation",
+        style: {
+          width: "100%",
+          padding: "8px 8px 8px 32px",
+          borderRadius: "var(--cyguin-docs-radius)",
+          border: "1px solid var(--cyguin-docs-border)",
+          background: "var(--cyguin-bg-subtle, #f5f5f5)",
+          color: "var(--cyguin-docs-text)",
+          fontSize: "14px",
+          fontFamily: "var(--cyguin-docs-font)",
+          boxSizing: "border-box",
+          outline: "none"
+        },
+        onFocus: (e) => {
+          e.currentTarget.style.borderColor = "var(--cyguin-border-focus, #f5a800)";
+        },
+        onBlur: (e) => {
+          e.currentTarget.style.borderColor = "var(--cyguin-docs-border)";
+        }
+      }
+    )
+  ] });
+}
+function DocsNav({ groups, selectedId, selectedIndex, onSelectArticle, searchQuery }) {
+  const [expandedSections, setExpandedSections] = useState(new Set(groups.map((g) => g.section)));
+  const navRef = useRef(null);
+  const flatArticles = groups.flatMap((g) => g.articles);
+  const activeIndexRef = useRef(-1);
+  useEffect(() => {
+    activeIndexRef.current = selectedIndex;
+  }, [selectedIndex]);
+  useEffect(() => {
+    const handler = (e) => {
+      if (e.key === "ArrowDown") {
+        e.preventDefault();
+        const next = Math.min(activeIndexRef.current + 1, flatArticles.length - 1);
+        onSelectArticle(flatArticles[next].id, next);
+        scrollToSelected(next);
+      } else if (e.key === "ArrowUp") {
+        e.preventDefault();
+        const prev = Math.max(activeIndexRef.current - 1, 0);
+        onSelectArticle(flatArticles[prev].id, prev);
+        scrollToSelected(prev);
+      } else if (e.key === "Enter" && selectedId) {
+        e.preventDefault();
+        const idx = flatArticles.findIndex((a) => a.id === selectedId);
+        if (idx !== -1) onSelectArticle(selectedId, idx);
+      }
+    };
+    const widget = document.getElementById("cyguin-docs-widget");
+    widget?.addEventListener("keydown", handler);
+    return () => widget?.removeEventListener("keydown", handler);
+  }, [flatArticles, selectedId, onSelectArticle]);
+  function scrollToSelected(index) {
+    const buttons = navRef.current?.querySelectorAll("[data-article-btn]");
+    buttons?.[index]?.scrollIntoView({ block: "nearest" });
+  }
+  function toggleSection(section) {
+    setExpandedSections((prev) => {
+      const next = new Set(prev);
+      if (next.has(section)) next.delete(section);
+      else next.add(section);
+      return next;
+    });
+  }
+  let articleIdx = 0;
+  return /* @__PURE__ */ jsxs("div", { ref: navRef, style: { overflowY: "auto", flex: 1, borderRight: "1px solid var(--cyguin-docs-border)" }, children: [
+    groups.length === 0 && /* @__PURE__ */ jsx("p", { style: { padding: "16px", color: "var(--cyguin-docs-muted)", fontSize: "13px", textAlign: "center", fontFamily: "var(--cyguin-docs-font)" }, children: searchQuery ? "No results found" : "No articles yet" }),
+    groups.map((group) => {
+      const isExpanded = expandedSections.has(group.section);
+      return /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsxs(
+          "button",
+          {
+            onClick: () => toggleSection(group.section),
+            style: {
+              width: "100%",
+              padding: "8px 12px",
+              background: "none",
+              border: "none",
+              cursor: "pointer",
+              display: "flex",
+              alignItems: "center",
+              gap: "6px",
+              color: "var(--cyguin-docs-text)",
+              fontSize: "12px",
+              fontWeight: 700,
+              fontFamily: "var(--cyguin-docs-font)",
+              textTransform: "uppercase",
+              letterSpacing: "0.05em"
+            },
+            children: [
+              /* @__PURE__ */ jsx(ChevronRightIcon, { expanded: isExpanded }),
+              group.section
+            ]
+          }
+        ),
+        isExpanded && group.articles.map((article) => {
+          const idx = articleIdx++;
+          const isSelected = article.id === selectedId;
+          return /* @__PURE__ */ jsx(
+            "button",
+            {
+              "data-article-btn": true,
+              onClick: () => onSelectArticle(article.id, idx),
+              style: {
+                width: "100%",
+                padding: "6px 12px 6px 28px",
+                background: isSelected ? "var(--cyguin-docs-accent)" : "none",
+                color: isSelected ? "var(--cyguin-accent-fg, #0a0a0a)" : "var(--cyguin-docs-text)",
+                border: "none",
+                cursor: "pointer",
+                textAlign: "left",
+                fontSize: "13px",
+                fontFamily: "var(--cyguin-docs-font)",
+                borderRadius: "var(--cyguin-docs-radius)",
+                margin: "1px 6px",
+                whiteSpace: "nowrap",
+                overflow: "hidden",
+                textOverflow: "ellipsis"
+              },
+              children: article.title
+            },
+            article.id
+          );
+        })
+      ] }, group.section);
+    })
+  ] });
+}
+function DocsArticleView({ article, onBack }) {
+  const contentRef = useRef(null);
+  useEffect(() => {
+    if (contentRef.current) {
+      contentRef.current.scrollTop = 0;
+    }
+  }, [article?.id]);
+  if (!article) {
+    return /* @__PURE__ */ jsx("div", { style: { flex: 2, display: "flex", alignItems: "center", justifyContent: "center", color: "var(--cyguin-docs-muted)", fontSize: "14px", fontFamily: "var(--cyguin-docs-font)" }, children: "Select an article to read" });
+  }
+  return /* @__PURE__ */ jsxs("div", { style: { flex: 2, display: "flex", flexDirection: "column", overflow: "hidden" }, children: [
+    /* @__PURE__ */ jsxs("div", { style: { padding: "12px 16px", borderBottom: "1px solid var(--cyguin-docs-border)", display: "flex", alignItems: "center", gap: "8px" }, children: [
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          onClick: onBack,
+          "aria-label": "Back to list",
+          style: { background: "none", border: "none", cursor: "pointer", color: "var(--cyguin-docs-muted)", display: "flex", alignItems: "center", padding: "4px", borderRadius: "var(--cyguin-docs-radius)" },
+          children: /* @__PURE__ */ jsx(BackIcon, {})
+        }
+      ),
+      /* @__PURE__ */ jsx("span", { style: { fontSize: "15px", fontWeight: 700, color: "var(--cyguin-docs-text)", fontFamily: "var(--cyguin-docs-font)", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: article.title })
+    ] }),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref: contentRef,
+        style: { flex: 1, overflowY: "auto", padding: "20px 24px", fontSize: "14px", lineHeight: 1.7, color: "var(--cyguin-docs-text)", fontFamily: "var(--cyguin-docs-font)" },
+        dangerouslySetInnerHTML: { __html: renderMarkdown(article.body_md) }
+      }
+    )
+  ] });
+}
+function DocsPanel({ mode, open, onClose, groups, selectedId, selectedIndex, searchQuery, onSearchChange, onSelectArticle, onBack, article }) {
+  const isMobile = typeof window !== "undefined" && window.innerWidth < 640;
+  const panelStyle = {
+    position: "fixed",
+    top: 0,
+    right: 0,
+    bottom: 0,
+    width: isMobile ? "100vw" : mode === "sidebar" ? "420px" : "680px",
+    maxWidth: "100vw",
+    background: "var(--cyguin-docs-bg)",
+    borderRadius: mode === "sidebar" || isMobile ? 0 : "var(--cyguin-docs-radius)",
+    boxShadow: mode === "modal" ? "var(--cyguin-docs-shadow)" : "none",
+    border: mode === "modal" && !isMobile ? "1px solid var(--cyguin-docs-border)" : "none",
+    display: "flex",
+    flexDirection: "column",
+    zIndex: 9999,
+    transform: open ? "translateX(0)" : "translateX(100%)",
+    transition: "transform 0.25s cubic-bezier(0.4, 0, 0.2, 1)",
+    fontFamily: "var(--cyguin-docs-font)"
+  };
+  if (!open) return null;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    mode === "modal" && /* @__PURE__ */ jsx(
+      "div",
+      {
+        onClick: onClose,
+        style: {
+          position: "fixed",
+          inset: 0,
+          background: `rgba(0, 0, 0, ${parseFloat(String(0.5))})`,
+          zIndex: 9998
+        },
+        "aria-hidden": "true"
+      }
+    ),
+    /* @__PURE__ */ jsxs("div", { id: "cyguin-docs-widget", role: "dialog", "aria-modal": mode === "modal", "aria-label": "Documentation", style: panelStyle, children: [
+      /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", padding: "12px 12px 8px", borderBottom: "1px solid var(--cyguin-docs-border)" }, children: [
+        /* @__PURE__ */ jsx("span", { style: { flex: 1, fontWeight: 700, fontSize: "15px", color: "var(--cyguin-docs-text)", fontFamily: "var(--cyguin-docs-font)" }, children: "Help Center" }),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: onClose,
+            "aria-label": "Close",
+            style: { background: "none", border: "none", cursor: "pointer", color: "var(--cyguin-docs-muted)", display: "flex", alignItems: "center", padding: "4px", borderRadius: "var(--cyguin-docs-radius)" },
+            children: /* @__PURE__ */ jsx(CloseIcon, {})
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx(DocsSearch, { value: searchQuery, onChange: onSearchChange }),
+      /* @__PURE__ */ jsxs("div", { style: { display: "flex", flex: 1, overflow: "hidden" }, children: [
+        /* @__PURE__ */ jsx("div", { style: { width: isMobile ? "100%" : "180px", display: "flex", flexDirection: "column" }, children: /* @__PURE__ */ jsx(
+          DocsNav,
+          {
+            groups,
+            selectedId,
+            selectedIndex,
+            onSelectArticle,
+            searchQuery
+          }
+        ) }),
+        !isMobile && /* @__PURE__ */ jsx(DocsArticleView, { article, onBack }),
+        isMobile && article && /* @__PURE__ */ jsx(DocsArticleView, { article, onBack })
+      ] })
+    ] })
+  ] });
+}
+function DocsWidget({
+  apiUrl = "/api/docs",
+  mode = "modal",
+  triggerLabel = "Help",
+  defaultOpen = false,
+  className = ""
+}) {
+  const [open, setOpen] = useState(defaultOpen);
+  const [articles, setArticles] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [searchQuery, setSearchQuery] = useState("");
+  const [selectedId, setSelectedId] = useState(null);
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const [selectedArticle, setSelectedArticle] = useState(null);
+  useEffect(() => {
+    if (open && articles.length === 0) {
+      setLoading(true);
+      fetch(apiUrl).then((r) => r.json()).then((data) => {
+        const arts = Array.isArray(data) ? data : data.articles ?? data.data ?? [];
+        setArticles(arts);
+      }).catch(() => setArticles([])).finally(() => setLoading(false));
+    }
+  }, [open, apiUrl, articles.length]);
+  useEffect(() => {
+    if (selectedId) {
+      const art = articles.find((a) => a.id === selectedId);
+      setSelectedArticle(art ?? null);
+    } else {
+      setSelectedArticle(null);
+    }
+  }, [selectedId, articles]);
+  useEffect(() => {
+    if (!open) return;
+    const handler = (e) => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("keydown", handler);
+    return () => document.removeEventListener("keydown", handler);
+  }, [open]);
+  const handleSearchChange = useCallback((q) => {
+    setSearchQuery(q);
+    setSelectedId(null);
+    setSelectedIndex(0);
+    setSelectedArticle(null);
+  }, []);
+  const handleSelectArticle = useCallback((id, index) => {
+    setSelectedId(id);
+    setSelectedIndex(index);
+    const art = articles.find((a) => a.id === id);
+    setSelectedArticle(art ?? null);
+  }, [articles]);
+  const handleBack = useCallback(() => {
+    setSelectedId(null);
+    setSelectedArticle(null);
+  }, []);
+  const filteredArticles = searchQuery.trim() ? articles.filter(
+    (a) => a.title.toLowerCase().includes(searchQuery.toLowerCase()) || a.body_md.toLowerCase().includes(searchQuery.toLowerCase())
+  ) : articles;
+  const groups = groupBySection(filteredArticles);
+  return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsxs("div", { className, style: { fontFamily: "var(--cyguin-docs-font)" }, children: [
+    /* @__PURE__ */ jsx(DocsTrigger, { label: triggerLabel, onClick: () => setOpen(true) }),
+    /* @__PURE__ */ jsx(
+      DocsPanel,
+      {
+        mode,
+        open,
+        onClose: () => setOpen(false),
+        groups,
+        selectedId,
+        selectedIndex,
+        searchQuery,
+        onSearchChange: handleSearchChange,
+        onSelectArticle: handleSelectArticle,
+        onBack: handleBack,
+        article: selectedArticle
+      }
+    )
+  ] }) });
+}
+
+// src/types.ts
+var defaultCssVars = {
+  "--cyguin-docs-bg": "var(--cyguin-surface, #ffffff)",
+  "--cyguin-docs-text": "var(--cyguin-text, #1a1a1a)",
+  "--cyguin-docs-border": "var(--cyguin-border, #e5e5e5)",
+  "--cyguin-docs-accent": "var(--cyguin-primary, #6366f1)",
+  "--cyguin-docs-muted": "var(--cyguin-muted, #737373)",
+  "--cyguin-docs-backdrop-opacity": "0.5",
+  "--cyguin-docs-radius": "var(--cyguin-radius, 8px)",
+  "--cyguin-docs-shadow": "var(--cyguin-shadow, 0 4px 24px rgba(0,0,0,0.12))",
+  "--cyguin-docs-trigger-size": "48px",
+  "--cyguin-docs-font": "var(--cyguin-font, system-ui, sans-serif)"
+};
+export {
+  DocsWidget,
+  defaultCssVars
+};

package/dist/next.d.mts

@@ -0,0 +1,10 @@
+import { b as DocsAdapter } from './types-0oOQLVHA.mjs';
+export { a as DocArticle } from './types-0oOQLVHA.mjs';
+
+declare function createDocsHandler(options: {
+    adapter?: DocsAdapter;
+}): (req: Request, context?: {
+    params?: Record<string, string | string[]>;
+}) => Promise<Response>;
+
+export { DocsAdapter, createDocsHandler };

package/dist/next.d.ts

@@ -0,0 +1,10 @@
+import { b as DocsAdapter } from './types-0oOQLVHA.js';
+export { a as DocArticle } from './types-0oOQLVHA.js';
+
+declare function createDocsHandler(options: {
+    adapter?: DocsAdapter;
+}): (req: Request, context?: {
+    params?: Record<string, string | string[]>;
+}) => Promise<Response>;
+
+export { DocsAdapter, createDocsHandler };

package/dist/next.js

@@ -0,0 +1,53 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/handlers/route.ts
+var _adapter = null;
+function getDocsAdapter() {
+  if (!_adapter) {
+    throw new Error("Docs adapter not set. Call setDocsAdapter() first.");
+  }
+  return _adapter;
+}
+function slugify(title) {
+  return title.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+}
+function kebabToTitle(kebab) {
+  return kebab.replace(/-/g, " ");
+}
+function createDocsHandler(options) {
+  const adapter = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.adapter]), () => ( getDocsAdapter()));
+  return async function handler(req, context) {
+    const segments = _nullishCoalesce(_optionalChain([context, 'optionalAccess', _2 => _2.params, 'optionalAccess', _3 => _3.cyguin]), () => ( []));
+    if (req.method !== "GET") {
+      return Response.json({ error: "Method not allowed" }, { status: 405 });
+    }
+    try {
+      if (segments.length === 0) {
+        const articles = await adapter.list({ published: true });
+        return Response.json(articles);
+      }
+      if (segments.length === 1) {
+        const [section] = segments;
+        const articles = await adapter.list({ section, published: true });
+        return Response.json(articles);
+      }
+      if (segments.length === 2) {
+        const [section, slug] = segments;
+        const titleQuery = kebabToTitle(slug);
+        const articles = await adapter.list({ section, published: true });
+        const article = articles.find(
+          (a) => slugify(a.title) === slug || a.title.toLowerCase() === titleQuery.toLowerCase()
+        );
+        if (!article) {
+          return Response.json({ error: "Article not found" }, { status: 404 });
+        }
+        return Response.json(article);
+      }
+      return Response.json({ error: "Not found" }, { status: 404 });
+    } catch (err) {
+      console.error("Docs handler error:", err);
+      return Response.json({ error: "Internal server error" }, { status: 500 });
+    }
+  };
+}
+
+
+exports.createDocsHandler = createDocsHandler;

package/dist/next.mjs

@@ -0,0 +1,53 @@
+// src/handlers/route.ts
+var _adapter = null;
+function getDocsAdapter() {
+  if (!_adapter) {
+    throw new Error("Docs adapter not set. Call setDocsAdapter() first.");
+  }
+  return _adapter;
+}
+function slugify(title) {
+  return title.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+}
+function kebabToTitle(kebab) {
+  return kebab.replace(/-/g, " ");
+}
+function createDocsHandler(options) {
+  const adapter = options?.adapter ?? getDocsAdapter();
+  return async function handler(req, context) {
+    const segments = context?.params?.cyguin ?? [];
+    if (req.method !== "GET") {
+      return Response.json({ error: "Method not allowed" }, { status: 405 });
+    }
+    try {
+      if (segments.length === 0) {
+        const articles = await adapter.list({ published: true });
+        return Response.json(articles);
+      }
+      if (segments.length === 1) {
+        const [section] = segments;
+        const articles = await adapter.list({ section, published: true });
+        return Response.json(articles);
+      }
+      if (segments.length === 2) {
+        const [section, slug] = segments;
+        const titleQuery = kebabToTitle(slug);
+        const articles = await adapter.list({ section, published: true });
+        const article = articles.find(
+          (a) => slugify(a.title) === slug || a.title.toLowerCase() === titleQuery.toLowerCase()
+        );
+        if (!article) {
+          return Response.json({ error: "Article not found" }, { status: 404 });
+        }
+        return Response.json(article);
+      }
+      return Response.json({ error: "Not found" }, { status: 404 });
+    } catch (err) {
+      console.error("Docs handler error:", err);
+      return Response.json({ error: "Internal server error" }, { status: 500 });
+    }
+  };
+}
+export {
+  createDocsHandler
+};

package/dist/styles.css

@@ -0,0 +1,11 @@
+:root {
+  --cyguin-docs-bg: var(--cyguin-bg, #ffffff);
+  --cyguin-docs-text: var(--cyguin-fg, #0a0a0a);
+  --cyguin-docs-border: var(--cyguin-border, #e5e5e5);
+  --cyguin-docs-accent: var(--cyguin-accent, #f5a800);
+  --cyguin-docs-muted: var(--cyguin-fg-muted, #888888);
+  --cyguin-docs-backdrop-opacity: 0.5;
+  --cyguin-docs-radius: var(--cyguin-radius, 6px);
+  --cyguin-docs-shadow: var(--cyguin-shadow, 0 1px 4px rgba(0,0,0,0.08));
+  --cyguin-docs-font: system-ui, sans-serif;
+}

package/dist/types-0oOQLVHA.d.mts

@@ -0,0 +1,52 @@
+interface DocArticle {
+    id: string;
+    title: string;
+    body_md: string;
+    section: string;
+    article_order: number;
+    published_at: number | null;
+}
+interface CreateArticleInput {
+    title: string;
+    body_md: string;
+    section: string;
+    article_order: number;
+    published_at?: number | null;
+}
+interface UpdateArticleInput {
+    title?: string;
+    body_md?: string;
+}
+interface DocsAdapter {
+    list(params?: {
+        section?: string;
+        published?: boolean;
+    }): Promise<DocArticle[]>;
+    get(id: string): Promise<DocArticle | null>;
+    create(data: CreateArticleInput): Promise<DocArticle>;
+    update(id: string, data: Partial<UpdateArticleInput>): Promise<DocArticle>;
+    delete(id: string): Promise<void>;
+    reorder(id: string, newOrder: number): Promise<void>;
+    moveSection(id: string, newSection: string): Promise<void>;
+}
+interface DocsWidgetProps {
+    apiUrl?: string;
+    mode?: 'modal' | 'sidebar';
+    triggerLabel?: string;
+    defaultOpen?: boolean;
+    className?: string;
+}
+declare const defaultCssVars: {
+    readonly '--cyguin-docs-bg': "var(--cyguin-surface, #ffffff)";
+    readonly '--cyguin-docs-text': "var(--cyguin-text, #1a1a1a)";
+    readonly '--cyguin-docs-border': "var(--cyguin-border, #e5e5e5)";
+    readonly '--cyguin-docs-accent': "var(--cyguin-primary, #6366f1)";
+    readonly '--cyguin-docs-muted': "var(--cyguin-muted, #737373)";
+    readonly '--cyguin-docs-backdrop-opacity': "0.5";
+    readonly '--cyguin-docs-radius': "var(--cyguin-radius, 8px)";
+    readonly '--cyguin-docs-shadow': "var(--cyguin-shadow, 0 4px 24px rgba(0,0,0,0.12))";
+    readonly '--cyguin-docs-trigger-size': "48px";
+    readonly '--cyguin-docs-font': "var(--cyguin-font, system-ui, sans-serif)";
+};
+
+export { type DocsWidgetProps as D, type DocArticle as a, type DocsAdapter as b, defaultCssVars as d };