@blaaiz/docs-core 0.5.0 → 0.6.0

package/styles/docs.css

@@ -127,12 +127,17 @@ button:has(kbd) {
   position: absolute;
   inset: 0 0 auto 0;
   height: 2.75rem;
-  background: color-mix(in oklab, var(--color-fd-card) 88%, black);
+  background: color-mix(in oklab, var(--color-fd-card) 94%, black);
   border-bottom: 1px solid var(--color-fd-border);
   border-top-left-radius: inherit;
   border-top-right-radius: inherit;
 }
 
+/* Dark cards are already near black; the strip needs a deeper mix to read. */
+.dark #nd-page figure.shiki::before {
+  background: color-mix(in oklab, var(--color-fd-card) 88%, black);
+}
+
 #nd-page figure.shiki::after {
   content: '';
   position: absolute;
@@ -273,3 +278,93 @@ body {
   width: 15px;
   height: 15px;
 }
+
+/* --- The top bar's action cluster and second row ------------------------- */
+
+/* Actions at the end of row one: extras, the secondary link, sign-out, and
+   the primary button. */
+.nav-actions {
+  display: flex;
+  align-items: center;
+  gap: 1.25rem;
+}
+
+.nav-actions__secondary,
+.nav-actions__signout {
+  border: none;
+  background: none;
+  padding: 0;
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--color-fd-muted-foreground);
+  cursor: pointer;
+  text-decoration: none;
+  transition: color 0.15s;
+  white-space: nowrap;
+}
+
+.nav-actions__secondary:hover,
+.nav-actions__signout:hover {
+  color: var(--color-fd-foreground);
+}
+
+.nav-actions__primary {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.4375rem 1rem;
+  border-radius: 999px;
+  background: var(--color-fd-primary);
+  color: #fff;
+  font-size: 0.875rem;
+  font-weight: 600;
+  text-decoration: none;
+  white-space: nowrap;
+  transition: opacity 0.15s;
+}
+
+.nav-actions__primary:hover {
+  opacity: 0.9;
+}
+
+/* Dark-mode primaries run light, so the button's text runs dark. */
+.dark .nav-actions__primary {
+  color: #000;
+}
+
+/* The second row: the section links, under the utility row. */
+.site-subnav {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+  height: 2.875rem;
+  padding-inline: 1rem;
+  border-bottom: 1px solid color-mix(in oklab, var(--color-fd-border) 60%, transparent);
+  background: color-mix(in oklab, var(--color-fd-background) 80%, transparent);
+  backdrop-filter: blur(16px);
+  overflow-x: auto;
+  scrollbar-width: none;
+}
+
+.site-subnav > * {
+  flex-shrink: 0;
+}
+
+/* The sidebar's section headings: the separators the headings sidebar style
+   renders for top-level groups. fumadocs marks them as bare <p> rows. */
+#nd-sidebar [data-radix-scroll-area-viewport] p {
+  font-weight: 600;
+}
+
+/* The docs header draws its own rules under both rows; run them as faint as
+   the landing's, so the chrome doesn't outweigh the content. */
+#nd-subnav [data-header-body],
+#nd-subnav [data-header-tabs] {
+  border-color: color-mix(in oklab, var(--color-fd-border) 60%, transparent);
+}
+
+/* The navbar tabs render only the title node, so the section icon travels
+   inside it (docsLayoutTabs); size it like the landing's links. */
+#nd-subnav [data-header-tabs] svg {
+  width: 15px;
+  height: 15px;
+}

package/styles/home.css

@@ -1,3 +1,32 @@
+/* The landing's top bar stands as tall as the docs pages' rendered header
+   (72px), so the two layouts read as one site. #nd-nav exists only in the
+   home layout; the docs layout's header is #nd-subnav. */
+#nd-nav {
+  height: 4.5rem;
+}
+
+#nd-nav nav {
+  height: 4.5rem;
+}
+
+/* The landing header's rule, as faint as the subnav's. */
+#nd-nav > div {
+  border-color: color-mix(in oklab, var(--color-fd-border) 60%, transparent);
+}
+
+/* On the landing the section links render as a sticky row under the top bar
+   (the home layout's header slot replaces its navbar rather than wrapping it,
+   so the row lives outside the header there). The row is full-bleed while the
+   header centres its content to --fd-layout-width, so the padding re-derives
+   that inset; the extra 0.625rem is the first link's own padding, backed out
+   so its icon sits flush with the logo above. */
+.site-subnav--home {
+  position: sticky;
+  top: 4.5rem;
+  z-index: 30;
+  padding-inline: max(0.375rem, calc((100% - var(--fd-layout-width, 100%)) / 2 + 0.375rem));
+}
+
 /*
  * @blaaiz/docs-core — the landing-page layout.
  *
@@ -37,7 +66,11 @@
  */
 
 .home-page {
-  --home-gutter: clamp(1.25rem, 4vw, 3.5rem);
+  /* The gutter re-derives the header's centred inset (--fd-layout-width plus
+     its 1rem padding), so every section's content column starts where the
+     logo does. Sections stay full-bleed: the inset is padding, so backgrounds
+     and borders still run edge to edge. */
+  --home-gutter: max(1rem, calc((100% - var(--fd-layout-width, 100%)) / 2 + 1rem));
   --home-mono: var(--font-code, var(--font-mono, ui-monospace, 'SF Mono', Menlo, monospace));
   width: 100%;
   padding-bottom: 5rem;

package/dist/chunk-ZKOOKLZ3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ui/icons.tsx"],"names":[],"mappings":"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","file":"chunk-ZKOOKLZ3.js","sourcesContent":["import type { ReactNode } from 'react';\n\n/**\n * The framework's inline-SVG glyph set — internal.\n *\n * Five UI modules drew their own icons, and four glyphs were drawn twice: the\n * house on the error screen and in the sidebar icon map, the padlock on the\n * sign-in and the `403` screen, the info circle on both of those, the key in\n * both places again, and the check mark in the copy-page button and the\n * playground. One drawing per glyph now lives here.\n *\n * Nothing is exported from the package: the modules below compose these paths,\n * and `docsIcon` remains the only public icon surface. Zero dependencies — the\n * paths are Lucide-shaped, on the same 24×24 grid, so any glyph works at any\n * size.\n *\n * @packageDocumentation\n */\n\n/**\n * The glyph paths, keyed by name. Each value is the *inside* of an `<svg>`, so\n * a caller decides the size, the stroke, and the class.\n */\nconst GLYPHS = {\n  house: (\n    <>\n      <path d=\"m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z\" />\n      <path d=\"M9 22V12h6v10\" />\n    </>\n  ),\n  book: <path d=\"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H20v20H6.5a2.5 2.5 0 0 1 0-5H20\" />,\n  code: (\n    <>\n      <path d=\"m16 18 6-6-6-6\" />\n      <path d=\"m8 6-6 6 6 6\" />\n    </>\n  ),\n  rocket: (\n    <>\n      <path d=\"M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91 0z\" />\n      <path d=\"m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z\" />\n      <path d=\"M9 12H4s.55-3.03 2-4c1.62-1.08 5 0 5 0\" />\n      <path d=\"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5\" />\n    </>\n  ),\n  terminal: (\n    <>\n      <path d=\"m4 17 6-6-6-6\" />\n      <path d=\"M12 19h8\" />\n    </>\n  ),\n  wallet: (\n    <>\n      <path d=\"M19 7V4a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1\" />\n      <path d=\"M3 5v14a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-4\" />\n    </>\n  ),\n  key: (\n    <>\n      <path d=\"m15.5 7.5 2.3 2.3a1 1 0 0 0 1.4 0l2.1-2.1a1 1 0 0 0 0-1.4L19 4\" />\n      <path d=\"m21 2-9.6 9.6\" />\n      <circle cx=\"7.5\" cy=\"15.5\" r=\"5.5\" />\n    </>\n  ),\n  webhook: (\n    <>\n      <path d=\"M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2\" />\n      <path d=\"m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06\" />\n      <path d=\"m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8\" />\n    </>\n  ),\n  globe: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20\" />\n      <path d=\"M2 12h20\" />\n    </>\n  ),\n  mail: (\n    <>\n      <rect x=\"2\" y=\"4\" width=\"20\" height=\"16\" rx=\"2\" />\n      <path d=\"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7\" />\n    </>\n  ),\n  user: (\n    <>\n      <circle cx=\"12\" cy=\"8\" r=\"4\" />\n      <path d=\"M4 21a8 8 0 0 1 16 0\" />\n    </>\n  ),\n  lock: (\n    <>\n      <rect x=\"3\" y=\"11\" width=\"18\" height=\"11\" rx=\"2\" />\n      <path d=\"M7 11V7a5 5 0 0 1 10 0v4\" />\n    </>\n  ),\n  /** A circled `i` — an informational note, and the generic error state. */\n  info: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"M12 8v4M12 16h.01\" strokeLinecap=\"round\" />\n    </>\n  ),\n  /** A warning triangle — a caution, and the `500` screen. */\n  alert: (\n    <>\n      <path d=\"M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\" />\n      <path d=\"M12 9v4M12 17h.01\" strokeLinecap=\"round\" />\n    </>\n  ),\n  /** A light bulb — a tip. */\n  bulb: (\n    <path d=\"M9 18h6M10 22h4M12 2a7 7 0 0 0-4 12.7c.6.5 1 1.3 1 2.1V17h6v-.2c0-.8.4-1.6 1-2.1A7 7 0 0 0 12 2Z\" />\n  ),\n  /** A circle with a cross — the `404` screen. */\n  crossCircle: (\n    <>\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"m14.31 8-1.31 2.4M9.69 8l4.62 8M14.31 16 9.69 8\" strokeLinecap=\"round\" />\n    </>\n  ),\n  /** Struck-through signal bars — the offline screen. */\n  offline: (\n    <>\n      <path d=\"M5 12.55a11 11 0 0 1 14 0M8.5 16.11a6 6 0 0 1 7 0M12 20h.01\" strokeLinecap=\"round\" />\n      <path d=\"m2 2 20 20\" strokeLinecap=\"round\" />\n    </>\n  ),\n  copy: (\n    <path d=\"M9 9h9a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H9a2 2 0 0 1-2-2v-9a2 2 0 0 1 2-2ZM5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1\" />\n  ),\n  check: <path d=\"M20 6 9 17l-5-5\" />,\n  chevronDown: <path d=\"m6 9 6 6 6-6\" />,\n  /** Stacked chevrons — a value this control switches between. */\n  chevronUpDown: <path d=\"m7 15 5 5 5-5M7 9l5-5 5 5\" />,\n  /** An open arc — one turn of a loading spinner. */\n  spinner: <path d=\"M21 12a9 9 0 1 1-6.219-8.56\" strokeLinecap=\"round\" />,\n  markdown: (\n    <>\n      <rect x=\"2\" y=\"5\" width=\"20\" height=\"14\" rx=\"2\" />\n      <path d=\"M6 15V9l3 3 3-3v6M17 9v4m0 0 2-2m-2 2-2-2\" />\n    </>\n  ),\n} satisfies Record<string, ReactNode>;\n\n/** A glyph in {@link GLYPHS}. */\nexport type GlyphName = keyof typeof GLYPHS;\n\n/**\n * How one icon is drawn. Every field is optional, and the defaults match the\n * house style: 24×24 grid, current colour, hidden from assistive technology.\n */\nexport interface IconOptions {\n  /**\n   * React key for the `<svg>`. Set it when a host may place the icon in an\n   * array of children — fumadocs renders a sidebar link as `[icon, text]`, and\n   * an unkeyed element there raises React's \"unique key\" warning in the\n   * consuming site's console.\n   */\n  readonly key?: string;\n  /** Pixel size for `width` and `height`. Omit to let CSS size the icon. */\n  readonly size?: number;\n  /** Stroke width. Default 2. */\n  readonly strokeWidth?: number;\n  /** Round the stroke's ends and joins. Default `false`. */\n  readonly rounded?: boolean;\n  /** Class for the `<svg>`, e.g. a spin animation. */\n  readonly className?: string;\n}\n\n/**\n * Draw a stroked glyph.\n *\n * @param name - the glyph\n * @param options - size, stroke, and class\n * @returns the `<svg>` element\n */\nexport function strokeIcon(name: GlyphName, options: IconOptions = {}): ReactNode {\n  return (\n    <svg\n      key={options.key}\n      {...(options.className === undefined ? {} : { className: options.className })}\n      {...(options.size === undefined ? {} : { width: options.size, height: options.size })}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={options.strokeWidth ?? 2}\n      {...(options.rounded ? { strokeLinecap: 'round', strokeLinejoin: 'round' } : {})}\n      aria-hidden=\"true\"\n    >\n      {GLYPHS[name]}\n    </svg>\n  );\n}\n\n/**\n * Draw a filled glyph. Used by the solid play triangle, where a stroke would\n * read as an outline.\n *\n * @param path - the path data\n * @param options - size and class\n * @returns the `<svg>` element\n */\nexport function filledIcon(path: string, options: IconOptions = {}): ReactNode {\n  return (\n    <svg\n      key={options.key}\n      {...(options.className === undefined ? {} : { className: options.className })}\n      {...(options.size === undefined ? {} : { width: options.size, height: options.size })}\n      viewBox=\"0 0 24 24\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n    >\n      <path d={path} />\n    </svg>\n  );\n}\n\n/** A solid right-pointing triangle: run this request. */\nexport const PLAY_PATH = 'M8 5v14l11-7z';\n"]}