radiant-docs 0.1.0

package/template/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "builder2",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "tsx runner.ts",
+    "prebuild": "rm -rf public/pagefind",
+    "build": "astro build && pagefind --site dist",
+    "preview": "astro preview",
+    "astro": "astro",
+    "search:index": "astro build && pagefind --site dist && cp -r dist/pagefind public/"
+  },
+  "dependencies": {
+    "@alpinejs/collapse": "^3.15.2",
+    "@alpinejs/focus": "^3.15.3",
+    "@alpinejs/persist": "^3.15.2",
+    "@astrojs/alpinejs": "^0.4.9",
+    "@astrojs/mdx": "^4.3.12",
+    "@aws-sdk/client-s3": "^3.964.0",
+    "@expressive-code/plugin-collapsible-sections": "^0.41.4",
+    "@expressive-code/plugin-line-numbers": "^0.41.4",
+    "@iconify-json/lucide": "^1.2.79",
+    "@readme/oas-to-snippet": "^29.3.0",
+    "@stoplight/spectral-core": "^1.20.0",
+    "@stoplight/spectral-rulesets": "^1.22.0",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tailwindcss/vite": "^4.1.17",
+    "@xt0rted/expressive-code-file-icons": "^1.0.0",
+    "alpinejs": "^3.15.2",
+    "astro": "^5.16.4",
+    "astro-expressive-code": "^0.41.4",
+    "astro-icon": "^1.1.5",
+    "fs-extra": "^11.3.3",
+    "mime-types": "^3.0.2",
+    "oas": "^28.7.0",
+    "openapi-sampler": "^1.6.2",
+    "prismjs": "^1.30.0",
+    "simple-git": "^3.30.0",
+    "tailwindcss": "^4.1.17",
+    "yaml": "^2.8.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/mime-types": "^3.0.1",
+    "@types/prismjs": "^1.26.5",
+    "pagefind": "^1.4.0",
+    "tsx": "^4.21.0"
+  }
+}

package/template/public/favicon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>

package/template/src/assets/icons/check.svg

@@ -0,0 +1,33 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  x="0px"
+  y="0px"
+  width="18px"
+  height="18px"
+  viewBox="0 0 18 18"
+>
+  <path
+    d="M9.305 1.848L14.555 3.528C14.969 3.661 15.25 4.046 15.25 4.48V11C15.25 14.03 10.566 15.748 9.308 16.155C9.105 16.221 8.895 16.221 8.692 16.155C7.434 15.748 2.75 14.03 2.75 11V4.48C2.75 4.045 3.031 3.66 3.445 3.528L8.695 1.848C8.893 1.785 9.106 1.785 9.305 1.848Z"
+    fill="#16a34a"
+    fill-opacity="0.7"
+    data-color="color-2"
+    data-stroke="none"
+  ></path>
+  <path
+    d="M9.305 1.848L14.555 3.528C14.969 3.661 15.25 4.046 15.25 4.48V11C15.25 14.03 10.566 15.748 9.308 16.155C9.105 16.221 8.895 16.221 8.692 16.155C7.434 15.748 2.75 14.03 2.75 11V4.48C2.75 4.045 3.031 3.66 3.445 3.528L8.695 1.848C8.893 1.785 9.106 1.785 9.305 1.848Z"
+    stroke="#16a34a"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M6.49701 9.75L8.10601 11.25L11.503 6.75"
+    stroke="white"
+    opacity="0.9"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+</svg>

package/template/src/assets/icons/danger.svg

@@ -0,0 +1,37 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="18"
+  height="18"
+  viewBox="0 0 18 18"
+>
+  <path
+    opacity="0.8"
+    d="M5.63604 1.5H12.364L16.5 5.63604V12.364L12.364 16.5H5.63604L1.5 12.364V5.63604L5.63604 1.5Z"
+    fill="#dc2626"
+  ></path>
+  <path
+    d="M5.63604 1.5H12.364L16.5 5.63604V12.364L12.364 16.5H5.63604L1.5 12.364V5.63604L5.63604 1.5Z"
+    stroke="#dc2626"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <g transform="translate(0 -0.5)">
+    <path
+      d="M9 6.75V9.75"
+      stroke="white"
+      opacity="0.9"
+      stroke-width="1.8"
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      fill="none"
+    ></path>
+    <path
+      d="M9 13.5C8.448 13.5 8 13.05 8 12.5C8 11.95 8.448 11.5 9 11.5C9.552 11.5 10 11.9501 10 12.5C10 13.0499 9.552 13.5 9 13.5Z"
+      fill="white"
+      opacity="0.9"
+      data-stroke="none"
+    ></path>
+  </g>
+</svg>

package/template/src/assets/icons/info.svg

@@ -0,0 +1,36 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="18"
+  height="18"
+  viewBox="0 0 18 18"
+>
+  <circle opacity="0.6" cx="9" cy="9" r="7.5" fill="#0284c7"></circle>
+  <circle
+    cx="9"
+    cy="9"
+    r="7.5"
+    stroke="#0284c7"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></circle>
+  <path
+    d="M9 12V9"
+    stroke="white"
+    opacity="0.9"
+    stroke-width="1.9"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M9 6H9.0075"
+    stroke="white"
+    opacity="0.9"
+    stroke-width="1.9"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+</svg>

package/template/src/assets/icons/lightbulb.svg

@@ -0,0 +1,74 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  x="0px"
+  y="0px"
+  width="18px"
+  height="18px"
+  viewBox="0 0 18 18"
+>
+  <path
+    fill-rule="evenodd"
+    clip-rule="evenodd"
+    d="M7.97299 4.358C11.045 3.714 13.75 6.041 13.75 9C13.75 10.867 12.6695 12.475 11.1028 13.25H6.89719C5.11109 12.367 3.95699 10.399 4.31499 8.202C4.62299 6.315 6.10099 4.75 7.97299 4.358Z"
+    fill="#eab308"
+    opacity="0.7"
+    data-color="color-2"
+    data-stroke="none"
+  ></path>
+  <path
+    d="M9 0.75V1.75"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M14.834 3.16599L14.127 3.87299"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M17.25 9H16.25"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M3.16602 3.16599L3.87302 3.87299"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M0.75 9H1.75"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M13.75 8.99999C13.75 6.04069 11.0445 3.71348 7.97199 4.35818C6.09979 4.75108 4.62099 6.31669 4.31449 8.20489C3.93509 10.5427 5.26679 12.6193 7.24999 13.407V15.25C7.24999 16.0784 7.92159 16.75 8.74999 16.75H9.24999C10.0784 16.75 10.75 16.0784 10.75 15.25V13.407C12.505 12.71 13.75 11.004 13.75 8.99999Z"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M6.89697 13.25H11.103"
+    stroke="#eab308"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+</svg>

package/template/src/assets/icons/warning.svg

@@ -0,0 +1,37 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  x="0px"
+  y="0px"
+  width="18px"
+  height="18px"
+  viewBox="0 0 18 18"
+>
+  <path
+    opacity="0.7"
+    d="M7.63796 3.48996L2.21295 12.89C1.60795 13.9399 2.36395 15.25 3.57495 15.25H14.425C15.636 15.25 16.392 13.9399 15.787 12.89L10.362 3.48996C9.75696 2.44996 8.24296 2.44996 7.63796 3.48996Z"
+    fill="#f59e0b"
+    data-color="color-2"
+    data-stroke="none"
+  ></path>
+  <path
+    d="M7.63796 3.48996L2.21295 12.89C1.60795 13.9399 2.36395 15.25 3.57495 15.25H14.425C15.636 15.25 16.392 13.9399 15.787 12.89L10.362 3.48996C9.75696 2.44996 8.24296 2.44996 7.63796 3.48996Z"
+    stroke="#f59e0b"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M9 6.75V9.75"
+    stroke="#78350f"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    fill="none"
+  ></path>
+  <path
+    d="M9 13.5C8.448 13.5 8 13.05 8 12.5C8 11.95 8.448 11.5 9 11.5C9.552 11.5 10 11.9501 10 12.5C10 13.0499 9.552 13.5 9 13.5Z"
+    fill="#78350f"
+    data-stroke="none"
+  ></path>
+</svg>

package/template/src/components/Header.astro

@@ -0,0 +1,176 @@
+---
+import { Icon } from "astro-icon/components";
+import { getConfig } from "../lib/validation";
+import Search from "./Search.astro";
+
+const config = await getConfig();
+
+function getLogoUrl(logoPath: string | undefined): string | null {
+  if (!logoPath) return null;
+
+  // Normalize path: remove leading slash if present
+  const normalizedPath = logoPath.startsWith("/")
+    ? logoPath.slice(1)
+    : logoPath;
+
+  // Return public URL - Vite plugin ensures file exists in public
+  return `/${normalizedPath}`;
+}
+
+// Load light and dark logos
+const lightLogoUrl = getLogoUrl(config.logo?.light);
+const darkLogoUrl = getLogoUrl(config.logo?.dark);
+
+// Get the href for the logo link (defaults to "/")
+const logoHref = config.logo?.href || "/";
+---
+
+<header
+  class:list={[
+    "fixed z-30 inset-x-1 top-0 h-16 mt-1 border-x border-t border-border rounded-t-xl overflow-hidden",
+    config.navbar?.blur
+      ? "bg-background/80 backdrop-blur-[18px] backdrop-saturate-200"
+      : "bg-background",
+  ]}
+  data-pagefind-ignore
+>
+  <div class="flex h-full border-b border-b-border-light">
+    <div class="lg:w-[283px] h-full">
+      <div class="flex gap-3 lg:block h-full lg:border-r border-border-light">
+        <button
+          x-on:click="open = ! open"
+          class="lg:hidden cursor-pointer pl-4 sm:pl-6 pr-2"
+        >
+          <div
+            class="flex flex-col items-center justify-center gap-1 h-full transition"
+            x-bind:class="open ? 'rotate-90': ''"
+          >
+            <div
+              class="w-[14px] h-0.5 bg-neutral-900 rounded-full origin-[20%_50%] transition"
+              x-bind:class="open ? 'rotate-45': ''"
+            >
+            </div>
+            <div
+              class="w-[14px] h-0.5 bg-neutral-900 rounded-full origin-[20%_50%] transition"
+              x-bind:class="open ? '-rotate-45': ''"
+            >
+            </div>
+          </div>
+        </button>
+        <a
+          href={logoHref}
+          class="h-full flex items-center justify-center gap-2 lg:gap-3 text-xl font-bold text-neutral-800 dark:text-neutral-100"
+        >
+          {
+            lightLogoUrl || darkLogoUrl ? (
+              <>
+                {/* Light mode: show light logo if available, otherwise show title */}
+                {lightLogoUrl ? (
+                  <img
+                    src={lightLogoUrl}
+                    class="max-h-[40px] w-auto max-w-[200px] object-contain dark:hidden"
+                    alt="Logo"
+                  />
+                ) : (
+                  <span class="dark:hidden">{config.title}</span>
+                )}
+
+                {/* Dark mode: show dark logo if available, otherwise show title */}
+                {darkLogoUrl ? (
+                  <img
+                    src={darkLogoUrl}
+                    class="max-h-[40px] w-auto max-w-[200px] object-contain hidden dark:block"
+                    alt="Logo"
+                  />
+                ) : (
+                  <span class="hidden dark:block">{config.title}</span>
+                )}
+              </>
+            ) : (
+              config.title
+            )
+          }
+          <span
+            class="text-[10px] text-neutral-500 font-semibold bg-neutral-100 dark:bg-neutral-800 px-2 py-px mt-0.5 rounded-full border border-neutral-200 dark:border-neutral-700/70 shadow-xs"
+            >Docs</span
+          >
+        </a>
+      </div>
+    </div>
+    <div class="flex-1 flex">
+      <div
+        class="min-w-0 w-full flex items-center justify-end md:justify-between gap-3 px-4 sm:px-6"
+      >
+        <Search />
+        {
+          config.navbar && (
+            <nav class="hidden xs:flex items-center gap-3">
+              {config.navbar.links && (
+                <div
+                  class:list={[
+                    "space-x-1",
+                    config.navbar.primary || config.navbar.secondary
+                      ? "pr-2 hidden xl:flex"
+                      : "hidden lg:flex",
+                  ]}
+                >
+                  {config.navbar.links.map((l, i) => (
+                    <a
+                      class="flex items-center gap-1 text-sm font-medium text-neutral-600/80 hover:text-neutral-600 duration-200 px-1.5 py-[5px] whitespace-nowrap"
+                      href={l.href}
+                    >
+                      {l.icon && (
+                        <Icon
+                          class="ml-0.5"
+                          name={`lucide:${l.icon}`}
+                          width="16"
+                          height="16"
+                        />
+                      )}
+                      {l.text}
+                    </a>
+                  ))}
+                </div>
+              )}
+              {config.navbar.secondary && (
+                <a
+                  class:list={[
+                    "items-center gap-1.5 px-3 py-[5px] text-sm font-[450] bg-white text-neutral-600 hover:text-neutral-700 rounded-md border border-neutral-200 shadow-xs hover:shadow-sm transition-all whitespace-nowrap",
+                    config.navbar.primary ? "hidden lg:flex" : "flex",
+                  ]}
+                  href={config.navbar.secondary.href}
+                >
+                  {config.navbar.secondary.icon && (
+                    <Icon
+                      name={`lucide:${config.navbar.secondary.icon}`}
+                      width="16"
+                      height="16"
+                    />
+                  )}
+                  {config.navbar.secondary.text}
+                </a>
+              )}
+              {config.navbar.primary && (
+                <a
+                  class:list={[
+                    "flex items-center gap-1.5 px-5 py-[5px] text-sm font-medium rounded-md bg-neutral-900 text-white/95 hover:text-white duration-200 shadow-[inset_0_1px_0_rgb(255,255,255,0.3),0_0_0_1px_var(--color-neutral-800)] transition-all whitespace-nowrap",
+                  ]}
+                  href={config.navbar.primary.href}
+                >
+                  {config.navbar.primary.icon && (
+                    <Icon
+                      name={`lucide:${config.navbar.primary.icon}`}
+                      width="16"
+                      height="16"
+                    />
+                  )}
+                  {config.navbar.primary.text}
+                </a>
+              )}
+            </nav>
+          )
+        }
+      </div>
+    </div>
+  </div>
+</header>

package/template/src/components/MdxPage.astro

@@ -0,0 +1,49 @@
+---
+import Layout from "../layouts/Layout.astro";
+import { render } from "astro:content";
+import Callout from "./user/Callout.astro";
+import Tabs from "./user/Tabs.astro";
+import Tab from "./user/Tab.astro";
+import Steps from "./user/Steps.astro";
+import Step from "./user/Step.astro";
+import Accordian from "./user/Accordian.astro";
+import AccordianGroup from "./user/AccordianGroup.astro";
+import TableOfContents from "./TableOfContents.astro";
+import { deriveTitleFromEntryId } from "../lib/utils";
+interface Props {
+  entry: any;
+}
+
+const { entry } = Astro.props;
+
+const components = {
+  Accordian,
+  AccordianGroup,
+  Callout,
+  Tabs,
+  Tab,
+  Steps,
+  Step,
+};
+
+const { Content, headings } = await render(entry);
+const title = entry.data.title || deriveTitleFromEntryId(entry.filePath);
+
+const tocHeadings = headings.filter(({ depth }) => depth === 2 || depth === 3);
+---
+
+<Layout>
+  <article>
+    <header class="mb-6">
+      <h1 class="text-3xl font-semibold">{title}</h1>
+    </header>
+    <div class="flex justify-between w-full">
+      <div class="prose-rules">
+        <Content components={components} />
+      </div>
+      <aside class="hidden xl:block w-56 shrink-0">
+        <TableOfContents headings={tocHeadings} />
+      </aside>
+    </div>
+  </article>
+</Layout>