@blaaiz/docs-core 0.7.6 → 0.9.0

package/dist/ui.d.ts

@@ -246,12 +246,16 @@ declare function Tip({ children }: {
  * @packageDocumentation
  */
 /**
- * A card. When `href` is set it renders as a link.
+ * A card. When `href` is set it renders as a link. `icon` takes the same
+ * names as `docs.json` navigation icons (the Mintlify vocabulary — `user`,
+ * `bell`, `paper-plane`, …); an unknown name shows no icon rather than a
+ * broken one.
  *
  * @public
  */
-declare function Card({ title, href, children, }: {
+declare function Card({ title, icon, href, children, }: {
     title?: string;
+    icon?: string;
     href?: string;
     children?: ReactNode;
 }): react.JSX.Element;
@@ -265,6 +269,42 @@ declare function CardGroup({ cols, children }: {
     children?: ReactNode;
 }): react.JSX.Element;
 
+/**
+ * The code-tab container: one hidden radio per block, the bar of fence titles,
+ * and the blocks as panels. CSS shows the checked radio's label and panel.
+ *
+ * @public
+ */
+declare function CodeGroup({ children, labels, }: {
+    readonly children?: ReactNode;
+    readonly labels?: string | readonly string[];
+}): react.JSX.Element;
+
+/**
+ * Frame — the Mintlify `<Frame>`: a bordered, centred surface around an image
+ * or any media, with an optional caption. A plain `<figure>`, so it renders in
+ * a Server Component with zero client JavaScript. Styled by `styles/docs.css`
+ * on the theme tokens.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Props for {@link Frame}.
+ *
+ * @public
+ */
+interface FrameProps {
+    /** A caption rendered under the media. */
+    readonly caption?: ReactNode;
+    readonly children?: ReactNode;
+}
+/**
+ * A framed media block.
+ *
+ * @public
+ */
+declare function Frame({ caption, children }: FrameProps): react.JSX.Element;
+
 /**
  * Resolve a `docs.json` icon name to an inline SVG. Unknown names resolve to
  * nothing, so the sidebar simply shows no icon rather than a broken one.
@@ -593,6 +633,8 @@ declare const mdxComponents: {
     Step: typeof Step;
     Tabs: typeof Tabs;
     Tab: typeof Tab;
+    Frame: typeof Frame;
+    CodeGroup: typeof CodeGroup;
 };
 
 /**
@@ -629,4 +671,4 @@ declare function DocsSidebar({ nav, resolveHref, }: {
     resolveHref?: ResolveHref;
 }): react.JSX.Element;
 
-export { Accordion, AccordionGroup, type ApiOperationSlots, AuthScreen, type AuthScreenProps, Callout, Card, CardGroup, type DocsLayoutTab, type DocsNavLink, type DocsNavLinksOptions, DocsSidebar, type ErrorKind, type ErrorPreset, ErrorScreen, type ErrorScreenProps, Info, MethodBadge, NavActions, type NavActionsProps, type NavJsonLink, Note, type ResolveHref, type SidebarBadgeTransformer, type SidebarItem, Step, Steps, Tab, type TabProps, Tabs, Tip, Warning, apiMethodBadges, apiOperationLayout, authErrorMessage, docsIcon, docsLayoutTabs, docsNavLinks, errorPreset, isDocsNavLinkActive, mdxComponents };
+export { Accordion, AccordionGroup, type ApiOperationSlots, AuthScreen, type AuthScreenProps, Callout, Card, CardGroup, CodeGroup, type DocsLayoutTab, type DocsNavLink, type DocsNavLinksOptions, DocsSidebar, type ErrorKind, type ErrorPreset, ErrorScreen, type ErrorScreenProps, Frame, type FrameProps, Info, MethodBadge, NavActions, type NavActionsProps, type NavJsonLink, Note, type ResolveHref, type SidebarBadgeTransformer, type SidebarItem, Step, Steps, Tab, type TabProps, Tabs, Tip, Warning, apiMethodBadges, apiOperationLayout, authErrorMessage, docsIcon, docsLayoutTabs, docsNavLinks, errorPreset, isDocsNavLinkActive, mdxComponents };

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { strokeIcon } from './chunk-6H6OB7YP.js';
+import { strokeIcon } from './chunk-FSB3DLMU.js';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { isValidElement, cloneElement, useId, Children } from 'react';
 
@@ -278,38 +278,6 @@ function Info({ children }) {
 function Tip({ children }) {
   return /* @__PURE__ */ jsx(Callout, { tone: "tip", children });
 }
-function Card({
-  title,
-  href,
-  children
-}) {
-  const style = {
-    display: "block",
-    border: "1px solid var(--color-fd-border)",
-    borderRadius: 12,
-    padding: "16px 18px",
-    textDecoration: "none",
-    color: "inherit",
-    background: "var(--color-fd-card)"
-  };
-  const body = /* @__PURE__ */ jsxs(Fragment, { children: [
-    title !== void 0 && /* @__PURE__ */ jsx("div", { style: { fontWeight: 700, fontSize: 15, marginBottom: 4 }, children: title }),
-    /* @__PURE__ */ jsx("div", { style: { color: "var(--color-fd-muted-foreground)", fontSize: 14 }, children })
-  ] });
-  if (href !== void 0) {
-    return /* @__PURE__ */ jsx("a", { href, style, children: body });
-  }
-  return /* @__PURE__ */ jsx("div", { style, children: body });
-}
-function CardGroup({ cols = 2, children }) {
-  const style = {
-    display: "grid",
-    gridTemplateColumns: `repeat(${String(cols)}, minmax(0, 1fr))`,
-    gap: 12,
-    margin: "16px 0"
-  };
-  return /* @__PURE__ */ jsx("div", { style, children });
-}
 
 // src/ui/docs-icons.tsx
 var ICONS = {
@@ -325,7 +293,17 @@ var ICONS = {
   user: "user",
   users: "users",
   building: "building",
-  clock: "clock"
+  clock: "clock",
+  history: "history",
+  bell: "bell",
+  send: "send",
+  "id-card": "idCard",
+  coins: "coins",
+  handshake: "handshake",
+  "shield-check": "shieldCheck",
+  banknote: "banknote",
+  "circle-play": "circlePlay",
+  mail: "mail"
 };
 var ALIASES = {
   home: "house",
@@ -343,16 +321,127 @@ var ALIASES = {
   "building-2": "building",
   office: "building",
   company: "building",
-  history: "clock",
-  time: "clock"
+  time: "clock",
+  "clock-rotate-left": "history",
+  "paper-plane": "send",
+  "address-card": "id-card",
+  shield: "shield-check",
+  "money-check-dollar-pen": "banknote",
+  "money-bill": "banknote",
+  "money-bill-transfer": "banknote",
+  play: "circle-play",
+  envelope: "mail"
 };
 function docsIcon(name) {
-  if (!name) {
+  const glyph = name === void 0 ? void 0 : glyphFor(name);
+  return glyph === void 0 ? void 0 : strokeIcon(glyph, { size: 16, rounded: true, key: `docs-icon-${glyph}` });
+}
+function glyphFor(name) {
+  const key = name.toLowerCase();
+  return ICONS[key] ?? ICONS[ALIASES[key] ?? ""];
+}
+function Card({
+  title,
+  icon: icon2,
+  href,
+  children
+}) {
+  const glyph = icon2 === void 0 ? void 0 : glyphFor(icon2);
+  const style = {
+    display: "block",
+    border: "1px solid var(--color-fd-border)",
+    borderRadius: 12,
+    padding: "22px 24px",
+    textDecoration: "none",
+    color: "inherit",
+    background: "var(--color-fd-card)"
+  };
+  const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+    glyph !== void 0 && /* @__PURE__ */ jsx("div", { style: { color: "var(--color-fd-primary)", marginBottom: 10 }, children: strokeIcon(glyph, { size: 20, rounded: true }) }),
+    title !== void 0 && /* @__PURE__ */ jsx("div", { style: { fontWeight: 700, fontSize: 15, marginBottom: 4 }, children: title }),
+    /* @__PURE__ */ jsx("div", { style: { color: "var(--color-fd-muted-foreground)", fontSize: 14 }, children })
+  ] });
+  if (href !== void 0) {
+    return /* @__PURE__ */ jsx("a", { href, style, children: body });
+  }
+  return /* @__PURE__ */ jsx("div", { style, children: body });
+}
+function CardGroup({ cols = 2, children }) {
+  const style = {
+    display: "grid",
+    gridTemplateColumns: `repeat(${String(cols)}, minmax(0, 1fr))`,
+    gap: 16,
+    margin: "16px 0"
+  };
+  return /* @__PURE__ */ jsx("div", { style, children });
+}
+function findLabel(node, depth = 0) {
+  if (depth > 4) {
     return void 0;
   }
-  const key = name.toLowerCase();
-  const glyph = ICONS[key] ?? ICONS[ALIASES[key] ?? ""];
-  return glyph === void 0 ? void 0 : strokeIcon(glyph, { size: 16, rounded: true, key: `docs-icon-${glyph}` });
+  for (const child of Children.toArray(node)) {
+    if (!isValidElement(child)) {
+      continue;
+    }
+    const { title, lang, children } = child.props;
+    if (typeof title === "string" && title !== "") {
+      return title;
+    }
+    if (typeof lang === "string" && lang !== "") {
+      return lang;
+    }
+    const nested = findLabel(children, depth + 1);
+    if (nested !== void 0) {
+      return nested;
+    }
+  }
+  return void 0;
+}
+function parseLabels(labels) {
+  if (labels === void 0) {
+    return [];
+  }
+  if (typeof labels !== "string") {
+    return labels;
+  }
+  try {
+    const parsed = JSON.parse(labels);
+    return Array.isArray(parsed) ? parsed.map(String) : [];
+  } catch {
+    return [];
+  }
+}
+function CodeGroup({
+  children,
+  labels
+}) {
+  const group = useId();
+  const blocks = Children.toArray(children).filter(
+    (child) => isValidElement(child)
+  );
+  const named = parseLabels(labels);
+  const labelOf = (block, index) => named[index] ?? findLabel(block) ?? `Code ${String(index + 1)}`;
+  return /* @__PURE__ */ jsxs("div", { className: "tabs tabs--code", children: [
+    blocks.map((_block, index) => /* @__PURE__ */ jsx(
+      "input",
+      {
+        className: "tabs__radio",
+        type: "radio",
+        name: group,
+        id: `${group}-${String(index)}`,
+        defaultChecked: index === 0
+      },
+      index
+    )),
+    /* @__PURE__ */ jsx("div", { className: "tabs__bar", children: blocks.map((block, index) => /* @__PURE__ */ jsx("label", { className: "tabs__trigger", htmlFor: `${group}-${String(index)}`, children: labelOf(block, index) }, index)) }),
+    blocks.map((block, index) => /* @__PURE__ */ jsx("section", { className: "tabs__panel", children: block }, index))
+  ] });
+}
+function Frame({ caption, children }) {
+  return /* @__PURE__ */ jsxs("figure", { className: "frame", children: [
+    /* @__PURE__ */ jsx("div", { className: "frame__body", children }),
+    caption === void 0 ? null : /* @__PURE__ */ jsx("figcaption", { className: "frame__caption", children: caption })
+  ] });
 }
 
 // src/ui/nav-links.ts
@@ -565,7 +654,9 @@ var mdxComponents = {
   Steps,
   Step,
   Tabs,
-  Tab
+  Tab,
+  Frame,
+  CodeGroup
 };
 var defaultResolveHref = (page) => {
   if (page.kind === "openapi") {
@@ -656,6 +747,6 @@ function DocsSidebar({
   ] }, `t-${String(index)}`)) });
 }
 
-export { Accordion, AccordionGroup, AuthScreen, Callout, Card, CardGroup, DocsSidebar, ErrorScreen, Info, MethodBadge, NavActions, Note, Step, Steps, Tab, Tabs, Tip, Warning, apiMethodBadges, apiOperationLayout, authErrorMessage, docsIcon, docsLayoutTabs, docsNavLinks, errorPreset, isDocsNavLinkActive, mdxComponents };
+export { Accordion, AccordionGroup, AuthScreen, Callout, Card, CardGroup, CodeGroup, DocsSidebar, ErrorScreen, Frame, Info, MethodBadge, NavActions, Note, Step, Steps, Tab, Tabs, Tip, Warning, apiMethodBadges, apiOperationLayout, authErrorMessage, docsIcon, docsLayoutTabs, docsNavLinks, errorPreset, isDocsNavLinkActive, mdxComponents };
 //# sourceMappingURL=ui.js.map
 //# sourceMappingURL=ui.js.map