@dreamlake/dockit 0.2.3 → 0.2.5

package/dist/components/Chip.d.ts

@@ -0,0 +1,22 @@
+import { ComponentPropsWithoutRef } from 'react';
+export type ChipVariant = 'muted' | 'accent' | 'warn';
+export interface ChipProps extends ComponentPropsWithoutRef<'button'> {
+    /** Color pair: `muted` (default), `accent`, or `warn`. */
+    variant?: ChipVariant;
+}
+/**
+ * The canonical chip idiom of the shell — this component IS the design
+ * guide's badge spec, not an approximation of it: mono
+ * (`--font-doc-template-mono`), 10px / 600, `0.08em` tracking, uppercase,
+ * `2px 7px` padding, 4px radius, and a hairline `currentColor` border at
+ * 45% opacity. The topbar's DEV badge renders through it, and the
+ * segments of [`VersionBadge`](./VersionBadge.tsx) and the data-driven
+ * [`TestStatus`](./StatusTable.tsx) badge follow the same idiom.
+ *
+ * Renders a `<span>` by default, or a `<button type="button">` (with a
+ * pointer cursor) when `onClick` is given. All other props — `title`,
+ * `aria-*`, `className`, `style` — pass straight through; `style` wins
+ * over the base + variant styles, so one-off recolors are just inline
+ * overrides.
+ */
+export declare function Chip({ variant, onClick, className, style, children, ...rest }: ChipProps): import("react").JSX.Element;

package/dist/components/Chip.js

@@ -0,0 +1,43 @@
+import { jsx } from "react/jsx-runtime";
+const VARIANT_COLORS = {
+  muted: {
+    color: "var(--color-doc-template-muted)",
+    background: "var(--color-doc-template-chip)"
+  },
+  accent: {
+    color: "var(--color-doc-template-accent)",
+    background: "var(--color-doc-template-accent-soft)"
+  },
+  warn: {
+    color: "var(--color-doc-template-warn)",
+    background: "var(--color-doc-template-warn-soft)"
+  }
+};
+const BASE_STYLE = {
+  display: "inline-flex",
+  alignItems: "center",
+  fontFamily: "var(--font-doc-template-mono)",
+  fontSize: 10,
+  fontWeight: 600,
+  letterSpacing: "0.08em",
+  lineHeight: 1.4,
+  textTransform: "uppercase",
+  padding: "2px 7px",
+  borderRadius: 4,
+  border: "1px solid color-mix(in srgb, currentColor 45%, transparent)"
+};
+function Chip({ variant = "muted", onClick, className, style, children, ...rest }) {
+  const mergedStyle = {
+    ...BASE_STYLE,
+    ...VARIANT_COLORS[variant],
+    ...onClick ? { cursor: "pointer" } : {},
+    ...style
+  };
+  if (onClick) {
+    return /* @__PURE__ */ jsx("button", { type: "button", onClick, className, style: mergedStyle, ...rest, children });
+  }
+  return /* @__PURE__ */ jsx("span", { className, style: mergedStyle, ...rest, children });
+}
+export {
+  Chip
+};

package/dist/components/Sidebar.js

@@ -54,9 +54,10 @@ function Sidebar() {
       className: "hidden md:flex sticky overflow-y-auto flex-col",
       style: { top: 40, height: "calc(100vh - 40px)", padding: "22px 12px 32px 18px", gap: 2 },
       children: groups.map((group) => {
-        const isFolded = group.label ? collapsed.has(group.label) : false;
+        const soleSection = groups.length === 1;
+        const isFolded = !soleSection && group.label ? collapsed.has(group.label) : false;
         return /* @__PURE__ */ jsxs("div", { className: "flex flex-col", style: { gap: 1, marginBottom: isFolded ? 4 : 14, transition: "margin-bottom 0.2s ease" }, children: [
-          group.label && /* @__PURE__ */ jsxs(
+          group.label && !soleSection && /* @__PURE__ */ jsxs(
             "button",
             {
               type: "button",

package/dist/components/StatusTable.d.ts

@@ -12,6 +12,9 @@ export declare function StatusTable({ kind }: {
 /**
  * Inline single-suite status badge for embedding in API docs. Example:
  *   <TestStatus suite="lakeshore-controlplane" />
+ *
+ * The badge itself is the data-driven face of the canonical chip idiom —
+ * see [`Chip`](./Chip.tsx) and the `StatusBadge` notes above.
  */
 export declare function TestStatus({ suite, example }: {
     suite?: string;

package/dist/components/StatusTable.js

@@ -1,5 +1,6 @@
 import { jsxs, jsx, Fragment } from "react/jsx-runtime";
 import { useState, useEffect } from "react";
+import { Chip } from "./Chip.js";
 const STATUS_COLOR = {
   pass: "oklch(62% .15 145)",
   fail: "oklch(58% .19 25)",
@@ -27,21 +28,16 @@ function StatusDot({ status }) {
 function StatusBadge({ status }) {
   const color = STATUS_COLOR[status] ?? "var(--color-doc-template-muted)";
   return /* @__PURE__ */ jsxs(
-    "span",
+    Chip,
     {
       style: {
-        display: "inline-flex",
-        alignItems: "center",
         gap: 6,
         padding: "2px 8px",
-        borderRadius: 4,
+        border: "none",
         background: `color-mix(in srgb, ${color} 12%, transparent)`,
         color,
-        fontFamily: "var(--font-doc-template-mono)",
         fontSize: 11,
-        fontWeight: 600,
-        textTransform: "uppercase",
-        letterSpacing: "0.08em"
+        lineHeight: "inherit"
       },
       children: [
         /* @__PURE__ */ jsx(StatusDot, { status }),

package/dist/components/Topbar.js

@@ -5,6 +5,7 @@ import { findPage } from "../lib/navigation.js";
 import { siteConfig } from "../site-config.js";
 import { useMediaQuery } from "../lib/use-media-query.js";
 import { useHiddenToggle } from "../lib/use-hidden-toggle.js";
+import { Chip } from "./Chip.js";
 import { ThemeToggle } from "./ThemeToggle.js";
 import { VersionBadge } from "./VersionBadge.js";
 import { useMerge } from "../renderer/Layout.js";
@@ -13,27 +14,12 @@ function HiddenRevealChip() {
   const [show, setShow] = useHiddenToggle();
   if (!show) return null;
   return /* @__PURE__ */ jsx(
-    "button",
+    Chip,
     {
-      type: "button",
+      variant: "warn",
       onClick: () => setShow(false),
       "aria-label": "Dev mode on — hidden pages are visible. Click to hide again.",
       title: "Dev mode on — hidden pages are visible (Cmd+Shift+D to toggle)",
-      className: "text-doc-template-warn",
-      style: {
-        display: "inline-flex",
-        alignItems: "center",
-        padding: "2px 7px",
-        border: "1px solid color-mix(in srgb, var(--color-doc-template-warn) 45%, transparent)",
-        borderRadius: 4,
-        background: "var(--color-doc-template-warn-soft)",
-        fontFamily: "var(--font-doc-template-mono)",
-        fontSize: 10,
-        fontWeight: 600,
-        letterSpacing: "0.08em",
-        lineHeight: 1.4,
-        cursor: "pointer"
-      },
       children: "DEV"
     }
   );

package/dist/components/VersionBadge.d.ts

@@ -27,5 +27,10 @@ export interface VersionBadgeProps {
  *
  * Rendered by the Topbar for each `siteConfig.versionChips` entry, and
  * exported from the library index for standalone placement.
+ *
+ * Visually, each segment follows the canonical chip idiom encapsulated by
+ * [`Chip`](./Chip.tsx) — mono 10px/600, 0.08em tracking, uppercase, 4px
+ * radius, hairline border. The two-segment (label | version) layout is
+ * bespoke, so this component does not compose `Chip` internally.
  */
 export declare function VersionBadge({ label, version, collapsed, dropdown, }: VersionBadgeProps): import("react").JSX.Element;

package/dist/components/mdx-components.d.ts

@@ -1,5 +1,6 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { Callout } from './Callout';
+import { Chip } from './Chip';
 import { Preview } from './Preview';
 import { StatusTable, TestStatus } from './StatusTable';
 /**
@@ -23,6 +24,7 @@ export declare const mdxComponents: {
     code: import('react').FC<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref">>;
     pre: typeof PreWrapper;
     Callout: typeof Callout;
+    Chip: typeof Chip;
     Preview: typeof Preview;
     StatusTable: typeof StatusTable;
     TestStatus: typeof TestStatus;

package/dist/components/mdx-components.js

@@ -2,6 +2,7 @@ import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { useContext, createContext, useState } from "react";
 import { CodeBlock } from "./CodeBlock.js";
 import { Callout } from "./Callout.js";
+import { Chip } from "./Chip.js";
 import { Preview } from "./Preview.js";
 import { TestStatus, StatusTable } from "./StatusTable.js";
 const InsidePreContext = createContext(false);
@@ -337,6 +338,7 @@ const mdxComponents = {
   code: Code,
   pre: PreWrapper,
   Callout,
+  Chip,
   Preview,
   StatusTable,
   TestStatus

package/dist/index.d.ts

@@ -27,6 +27,7 @@ export { useLineNumbers } from './lib/use-line-numbers';
 export { useLocalStorage, DOC_PREFIX, docKey } from './lib/use-local-storage';
 export { useMediaQuery } from './lib/use-media-query';
 export { Callout } from './components/Callout';
+export { Chip, type ChipProps, type ChipVariant } from './components/Chip';
 export { ClientOnly } from './components/ClientOnly';
 export { CodeBlock } from './components/CodeBlock';
 export { DocFooter } from './components/DocFooter';

package/dist/index.js

@@ -12,6 +12,7 @@ import { useLineNumbers } from "./lib/use-line-numbers.js";
 import { DOC_PREFIX, docKey, useLocalStorage } from "./lib/use-local-storage.js";
 import { useMediaQuery } from "./lib/use-media-query.js";
 import { Callout } from "./components/Callout.js";
+import { Chip } from "./components/Chip.js";
 import { ClientOnly } from "./components/ClientOnly.js";
 import { CodeBlock } from "./components/CodeBlock.js";
 import { DocFooter } from "./components/DocFooter.js";
@@ -36,6 +37,7 @@ function initDocs(opts) {
 }
 export {
   Callout,
+  Chip,
   ClientOnly,
   CodeBlock,
   DOC_PREFIX,

package/dist/renderer/Layout.js

@@ -96,7 +96,7 @@ function HeadSync() {
       tag.remove();
     }
     let robotsTag = document.querySelector('meta[name="robots"]');
-    if (current?.noindex) {
+    if (current?.noindex || siteConfig.indexable !== true) {
       if (!robotsTag) {
         robotsTag = document.createElement("meta");
         robotsTag.name = "robots";

package/dist/renderer/onRenderHtml.js

@@ -32,7 +32,7 @@ async function onRenderHtml(pageContext) {
     <link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@400;500;600;700&family=Fira+Code:wght@400;500;600&display=swap" rel="stylesheet" />
     <title>${title}</title>
     ${description ? escapeInject`<meta name="description" content="${description}" />` : ""}
-    ${current?.noindex ? escapeInject`<meta name="robots" content="noindex, nofollow" />` : ""}
+    ${current?.noindex || siteConfig.indexable !== true ? escapeInject`<meta name="robots" content="noindex, nofollow" />` : ""}
     ${mdHref ? escapeInject`<link rel="alternate" type="text/markdown" href="${mdHref}" />` : ""}
   </head>
   <body>

package/dist/site-config.d.ts

@@ -69,6 +69,12 @@ export interface SiteConfig {
      *  — http(s), protocol-relative, or absolute-path; anything else is
      *  silently dropped. */
     headScripts?: string[];
+    /** Search-engine visibility. DEFAULT FALSE per org policy: every page
+     *  gets `<meta name="robots" content="noindex, nofollow">` unless a site
+     *  explicitly opts in with `indexable: true`. Page-level `noindex`
+     *  frontmatter still applies on indexable sites. The site's own pagefind
+     *  search and the llms/skill surfaces are unaffected. */
+    indexable?: boolean;
 }
 export declare const siteConfig: SiteConfig;
 /** Merge site-provided values into the singleton (mutates in place). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamlake/dockit",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "The DreamLake documentation shell — Vike + React + Tailwind v4 + MDX docs framework with sidebar, TOC, search, and theming",
   "license": "MIT",
   "type": "module",