@stainless-api/docs-ui 0.1.0-beta.9 → 0.1.0-beta.91

package/dist/components/snippets.d.ts

@@ -0,0 +1,2 @@
+import { a as SnippetButtons, c as SnippetContainer, d as SnippetProps, f as SnippetRequestContainer, i as Snippet, l as SnippetContainerProps, m as SnippetResponse, n as MultiSnippets, o as SnippetCode, p as SnippetRequestContainerProps, r as MultiSnippetsProps, s as SnippetCodeProps, u as SnippetFooter } from "../index-Dt9uPKZP.js";
+export { MultiSnippets, MultiSnippetsProps, Snippet, SnippetButtons, SnippetCode, SnippetCodeProps, SnippetContainer, SnippetContainerProps, SnippetFooter, SnippetProps, SnippetRequestContainer, SnippetRequestContainerProps, SnippetResponse };

package/dist/components/snippets.js

@@ -0,0 +1,183 @@
+import { useDeclaration, useLanguage, useSnippet, useSnippetIds, useSnippetResponse } from "../contexts/docs.js";
+import { useHighlight } from "../contexts/markdown.js";
+import "../contexts/index.js";
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { useCallback, useId, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import { CheckIcon, CircleAlertIcon, CopyIcon } from "lucide-react";
+import { Badge, Button, getHttpMethod } from "@stainless-api/ui-primitives";
+//#region src/components/snippets.tsx
+function SnippetCode({ content, language }) {
+	const lang = useLanguage();
+	const highlighted = useHighlight(content, language || lang);
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.SnippetCode,
+		"data-stldocs-copy-content": true,
+		dangerouslySetInnerHTML: { __html: highlighted }
+	});
+}
+function SnippetContainer({ children, className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: clsx(style_default.Snippet, className),
+		...props,
+		children
+	});
+}
+function SnippetRequestContainer({ children }) {
+	return /* @__PURE__ */ jsx("div", { children });
+}
+function Snippet({ requestTitle, method, snippet, transformRequestSnippet }) {
+	const Docs = useComponents();
+	const language = useLanguage();
+	const originalSnippetContent = useSnippet(method.stainlessPath, void 0, snippet);
+	const snippetResponses = useSnippetResponse(method.stainlessPath, snippet);
+	const decl = useDeclaration(method.stainlessPath, false);
+	const signature = decl && "qualified" in decl ? decl.qualified : void 0;
+	if (!originalSnippetContent) {
+		console.warn(`Snippet not found for method '${method.stainlessPath}'`);
+		return null;
+	}
+	const snippetContent = transformRequestSnippet ? transformRequestSnippet({
+		snippet: originalSnippetContent,
+		language
+	}) : originalSnippetContent;
+	const httpMethod = getHttpMethod(method.httpMethod);
+	return /* @__PURE__ */ jsxs(Docs.SnippetContainer, {
+		signature,
+		method,
+		children: [snippetContent && /* @__PURE__ */ jsx(Docs.SnippetRequestContainer, {
+			signature,
+			children: /* @__PURE__ */ jsxs("div", {
+				className: style_default.SnippetRequest,
+				"data-stldocs-copy-parent": true,
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: style_default.SnippetRequestTitle,
+						children: [
+							/* @__PURE__ */ jsxs("div", {
+								className: style_default.SnippetRequestTitleMethod,
+								children: [httpMethod && /* @__PURE__ */ jsx(Badge.HTTP, {
+									method: httpMethod,
+									iconOnly: true
+								}), /* @__PURE__ */ jsx("h3", { children: method.summary || method.title })]
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: style_default.SnippetRequestTitleContent,
+								children: requestTitle
+							}),
+							/* @__PURE__ */ jsx(Docs.SnippetButtons, { content: snippetContent })
+						]
+					}),
+					/* @__PURE__ */ jsx(Docs.SnippetCode, {
+						content: snippetContent,
+						signature
+					}),
+					/* @__PURE__ */ jsx(Docs.SnippetFooter, {})
+				]
+			})
+		}), /* @__PURE__ */ jsx(Docs.SnippetResponse, { responses: snippetResponses })]
+	});
+}
+function MultiSnippets({ requestTitle, method }) {
+	const snippetIds = useSnippetIds(method.stainlessPath)?.filter((id) => id !== "default");
+	const radioId = useId();
+	const Docs = useComponents();
+	if (!snippetIds) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.SnippetMulti,
+		"data-stldocs-multi-snippet-container": true,
+		children: [/* @__PURE__ */ jsx("div", {
+			className: style_default.SnippetMultiTabs,
+			"data-stldocs-multi-snippet-tabs": true,
+			children: snippetIds.map((snid, idx) => /* @__PURE__ */ jsxs("label", {
+				className: style_default.SnippetMultiTab,
+				children: [/* @__PURE__ */ jsx("input", {
+					type: "radio",
+					name: `snippet-example-radio-${radioId}`,
+					value: idx,
+					defaultChecked: idx === 0
+				}), /* @__PURE__ */ jsx("span", { children: snid.slice(7) })]
+			}, `snippet-example-${idx}`))
+		}), /* @__PURE__ */ jsx("div", {
+			className: style_default.SnippetMultiContent,
+			children: snippetIds.map((snid, idx) => {
+				return /* @__PURE__ */ jsx("div", {
+					className: clsx(style_default.SnippetMultiPane, idx === 0 && style_default.SnippetMultiPaneActive),
+					"data-stldocs-multi-snippet-id": idx,
+					children: /* @__PURE__ */ jsx(Docs.Snippet, {
+						method,
+						snippet: snid,
+						requestTitle
+					})
+				}, `snippet-example-content-${idx}`);
+			})
+		})]
+	});
+}
+function SnippetButtons({ content }) {
+	const [CopyButtonIcon, setCopyButtonIcon] = useState(CopyIcon);
+	const timeoutRef = useRef(null);
+	const handleCopy = useCallback(() => {
+		if (timeoutRef.current) clearTimeout(timeoutRef.current);
+		navigator.clipboard.writeText(content).then(() => {
+			setCopyButtonIcon(CheckIcon);
+		}).catch(() => {
+			setCopyButtonIcon(CircleAlertIcon);
+		}).finally(() => {
+			timeoutRef.current = setTimeout(() => setCopyButtonIcon(CopyIcon), 1e3);
+		});
+	}, [content]);
+	return /* @__PURE__ */ jsx(Button, {
+		variant: "outline",
+		"data-stldocs-snippet-copy": true,
+		children: /* @__PURE__ */ jsx(CopyButtonIcon, {
+			size: 16,
+			className: style_default.Icon,
+			onClick: handleCopy
+		})
+	});
+}
+function SnippetFooter() {
+	return null;
+}
+function SnippetResponse({ responses }) {
+	const Docs = useComponents();
+	if (!responses || responses.length === 0) return null;
+	const tabs = responses.map(({ status }, index) => ({
+		status,
+		index,
+		label: status ? `${status} example` : null
+	}));
+	const hasTabs = tabs.length > 1 || tabs.some((tab) => tab.label);
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.SnippetMultiResponse,
+		children: /* @__PURE__ */ jsxs("div", {
+			className: clsx(style_default.Snippet),
+			children: [hasTabs && /* @__PURE__ */ jsx("div", {
+				className: clsx(style_default.SnippetResponseTab, tabs.length === 1 && style_default.SnippetResponseTabSingleReturn),
+				children: tabs.map(({ status, label }, index) => /* @__PURE__ */ jsx("div", {
+					"data-snippet-response-tab-id": `snippet-response-tab-${status}-${index}`,
+					className: clsx(style_default.SnippetResponseTabItem, index === 0 && style_default.SnippetResponseTabItemActive),
+					children: /* @__PURE__ */ jsx(Button, {
+						disabled: responses.length === 1,
+						variant: "ghost",
+						children: label ?? `Example ${index + 1}`
+					})
+				}, `snippet-response-tab-item-${status}-${index}`))
+			}), responses.map(({ status, content, contentType }, index) => {
+				return typeof content === "string" ? /* @__PURE__ */ jsx("div", {
+					className: clsx(style_default.SnippetResponsePane, index === 0 && style_default.SnippetResponsePaneActive),
+					"data-snippet-response-pane-id": `snippet-response-tab-${status}-${index}`,
+					children: /* @__PURE__ */ jsx(Docs.SnippetCode, {
+						content,
+						language: contentType === "application/json" || !contentType ? "json" : "none"
+					})
+				}, `snippet-response-${status}-${index}`) : null;
+			})]
+		})
+	});
+}
+//#endregion
+export { MultiSnippets, Snippet, SnippetButtons, SnippetCode, SnippetContainer, SnippetFooter, SnippetRequestContainer, SnippetResponse };

package/dist/components/stl-sidebar.d.ts

@@ -0,0 +1,2 @@
+import { a as StlSidebarProps, i as StlSidebarLink, n as StlSidebarEntry, o as StlSidebarTarget, r as StlSidebarGroup, t as StlSidebar } from "../stl-sidebar-Pra9uCYo.js";
+export { StlSidebar, StlSidebarEntry, StlSidebarGroup, StlSidebarLink, StlSidebarProps, StlSidebarTarget };

package/dist/components/stl-sidebar.js

@@ -0,0 +1,111 @@
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import { ChevronRight } from "lucide-react";
+//#region src/components/stl-sidebar.tsx
+function targetToAttributes(target) {
+	return {
+		href: target.type === "href" ? target.href : void 0,
+		stainlessPath: target.type === "stainlessPath" ? target.stainlessPath : void 0
+	};
+}
+function StlSidebarSublist({ entries, entryToIndex }) {
+	return /* @__PURE__ */ jsx("ul", {
+		className: style_default.SidebarList,
+		children: entries.map((entry, index) => entry.type === "link" ? /* @__PURE__ */ jsx(LinkEntry, { entry }, index) : /* @__PURE__ */ jsx(GroupEntry, {
+			entry,
+			entryToIndex
+		}, index))
+	});
+}
+function EntryItem({ className, children }) {
+	return /* @__PURE__ */ jsx("li", {
+		className: clsx(style_default.SidebarEntry, className),
+		children
+	});
+}
+function LinkEntry({ entry }) {
+	const Docs = useComponents();
+	return /* @__PURE__ */ jsx(EntryItem, {
+		className: style_default.SidebarEntryLink,
+		children: /* @__PURE__ */ jsxs(Docs.Link, {
+			...targetToAttributes(entry.target),
+			"aria-current": entry.isCurrent ? "page" : void 0,
+			...entry.attrs,
+			children: [entry.icon, entry.label]
+		})
+	});
+}
+function GroupEntry({ entry, entryToIndex }) {
+	const Docs = useComponents();
+	const restorePointIndex = entryToIndex?.get(entry);
+	const { collapsible = true } = entry;
+	const labelWithIcon = /* @__PURE__ */ jsxs(Fragment, { children: [entry.label, entry.icon] });
+	const GroupElement = collapsible ? "details" : "div";
+	const GroupLabelElement = collapsible ? "summary" : "div";
+	return /* @__PURE__ */ jsxs(EntryItem, {
+		className: style_default.SidebarEntryGroup,
+		children: [entry.target && /* @__PURE__ */ jsx(Docs.Link, {
+			...targetToAttributes(entry.target),
+			"aria-current": entry.isCurrent ? "page" : void 0,
+			children: labelWithIcon
+		}), /* @__PURE__ */ jsxs(GroupElement, {
+			className: style_default.SidebarExpander,
+			...collapsible ? { open: !entry.collapsed || isAnyItemCurrent(entry.entries) } : {},
+			children: [
+				/* @__PURE__ */ jsxs(GroupLabelElement, {
+					className: style_default.ExpanderSummary,
+					children: [/* @__PURE__ */ jsx("span", {
+						"aria-hidden": entry.target ? "true" : void 0,
+						children: labelWithIcon
+					}), entry.entries.length > 0 && collapsible && /* @__PURE__ */ jsx(ChevronRight, {
+						size: 16,
+						strokeWidth: 1,
+						className: `${style_default.Icon} ${style_default.ExpanderSummaryIcon}`
+					})]
+				}),
+				restorePointIndex !== void 0 && /* @__PURE__ */ jsx("sl-sidebar-restore", { "data-index": restorePointIndex }),
+				entry.entries.length > 0 && /* @__PURE__ */ jsx(StlSidebarSublist, {
+					entries: entry.entries,
+					entryToIndex
+				})
+			]
+		})]
+	});
+}
+function StlSidebar({ entries, withStarlightRestoration }) {
+	const entryToIndex = withStarlightRestoration ? computeEntryToIndex(entries) : void 0;
+	return /* @__PURE__ */ jsx("div", {
+		className: `${style_default.Root} ${style_default.Sidebar}`,
+		children: /* @__PURE__ */ jsx(StlSidebarSublist, {
+			entries,
+			entryToIndex
+		})
+	});
+}
+function computeEntryToIndex(allEntries) {
+	const entryToIndex = /* @__PURE__ */ new Map();
+	let currentIndex = 0;
+	function addEntries(entries) {
+		for (const entry of entries) if (entry.type === "group") {
+			entryToIndex.set(entry, currentIndex);
+			currentIndex++;
+			addEntries(entry.entries);
+		}
+	}
+	addEntries(allEntries);
+	return entryToIndex;
+}
+function* walkSidebar(entries) {
+	for (const entry of entries) {
+		yield entry;
+		if (entry.type === "group") yield* walkSidebar(entry.entries);
+	}
+}
+function isAnyItemCurrent(entries) {
+	for (const e of walkSidebar(entries)) if (e.isCurrent) return true;
+	return false;
+}
+//#endregion
+export { StlSidebar };

package/dist/contexts/component-generics.d.ts

@@ -0,0 +1,2 @@
+import { a as useComponents, i as useComponentContext, n as ComponentsContextType, r as customizeComponents, t as ComponentProvider } from "../component-generics-D9XaPlr8.js";
+export { ComponentProvider, ComponentsContextType, customizeComponents, useComponentContext, useComponents };

package/dist/contexts/component-generics.js

@@ -0,0 +1,2 @@
+import { i as useComponents, n as customizeComponents, r as useComponentContext, t as ComponentProvider } from "../component-generics-DYxBWv1v.js";
+export { ComponentProvider, customizeComponents, useComponentContext, useComponents };

package/dist/contexts/component-types.d.ts

@@ -0,0 +1,7 @@
+import { t as index_d_exports, y as index_d_exports$1 } from "../index-Dt9uPKZP.js";
+
+//#region src/contexts/component-types.d.ts
+type AppComponents = typeof index_d_exports;
+type AppLanguage = typeof index_d_exports$1;
+//#endregion
+export { AppComponents, AppLanguage };

package/dist/contexts/component.d.ts

@@ -0,0 +1,20 @@
+import { t as index_d_exports, y as index_d_exports$1 } from "../index-Dt9uPKZP.js";
+import { n as ComponentsContextType } from "../component-generics-D9XaPlr8.js";
+import React from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/contexts/component.d.ts
+type AppComponents = typeof index_d_exports;
+type AppLanguage = typeof index_d_exports$1;
+declare const defaultContextValue: ComponentsContextType<AppComponents, AppLanguage>;
+declare function ComponentProvider({
+  components,
+  language,
+  children
+}: {
+  components?: Partial<AppComponents>;
+  language?: { [K in keyof AppLanguage]?: Partial<AppLanguage[K]> };
+  children: React.ReactNode;
+}): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AppComponents, AppLanguage, ComponentProvider, defaultContextValue };

package/dist/contexts/component.js

@@ -0,0 +1,21 @@
+import { n as customizeComponents, t as ComponentProvider$1 } from "../component-generics-DYxBWv1v.js";
+import { t as components_exports } from "../components/index.js";
+import { t as languages_exports } from "../languages/index.js";
+import React from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/contexts/component.tsx
+const defaultContextValue = {
+	components: components_exports,
+	language: languages_exports
+};
+function ComponentProvider({ components, language, children }) {
+	return /* @__PURE__ */ jsx(ComponentProvider$1, {
+		value: React.useMemo(() => customizeComponents(defaultContextValue, {
+			components,
+			language
+		}), [components, language]),
+		children
+	});
+}
+//#endregion
+export { ComponentProvider, defaultContextValue };

package/dist/contexts/docs.d.ts

@@ -0,0 +1,2 @@
+import { _ as useSnippetResponse, a as DocsProviderProps, c as useContentPanelLayout, d as useIgnoredResources, f as useLanguage, g as useSnippetIds, h as useSnippet, i as DocsProvider, l as useDeclaration, m as useSettings, n as Declaration, o as PropertySettingsType, p as useResource, r as DocsContextType, s as useAvailableLanguages, t as ContentPanelLayout, u as useDocs, v as useSnippets, y as useSpec } from "../docs-D0qzNoXq.js";
+export { ContentPanelLayout, Declaration, DocsContextType, DocsProvider, DocsProviderProps, PropertySettingsType, useAvailableLanguages, useContentPanelLayout, useDeclaration, useDocs, useIgnoredResources, useLanguage, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };

package/dist/contexts/docs.js

@@ -0,0 +1,89 @@
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/contexts/docs.tsx
+const DocsContextDefaults = {
+	settings: {},
+	language: "node",
+	spec: null
+};
+const DocsContext = React$1.createContext(DocsContextDefaults);
+function useDocs() {
+	return React$1.use(DocsContext);
+}
+function useSpec() {
+	return useDocs().spec;
+}
+function useSettings() {
+	return useDocs().settings;
+}
+function useSnippets(stainlessPath, language) {
+	const defaultLanguage = useLanguage();
+	const lang = language ?? defaultLanguage;
+	const snippetLanguage = lang === "http" ? "http.curl" : `${lang}.default`;
+	return useSpec()?.snippets?.[snippetLanguage]?.[stainlessPath];
+}
+function useSnippetIds(stainlessPath, language) {
+	const snippets = useSnippets(stainlessPath, language);
+	if (!snippets) return void 0;
+	return Object.keys(snippets).flatMap((key) => {
+		const customPrefix = "custom:";
+		if (key.startsWith(customPrefix)) return `${customPrefix}${key.slice(7)}`;
+		if (key === "default") return "default";
+		return [];
+	});
+}
+/** Find a custom snippet named Default (case-insensitive); otherwise use the generated default */
+function getDefaultSnippet(snippets) {
+	return Object.entries(snippets).find(([key]) => key.toLowerCase() === "custom:default")?.[1] ?? snippets.default;
+}
+function useSnippet(stainlessPath, language, snippetId) {
+	const snippets = useSnippets(stainlessPath, language);
+	if (!snippets) return void 0;
+	if (!snippetId) return getDefaultSnippet(snippets)?.content;
+	return snippets?.[snippetId]?.content;
+}
+function useSnippetResponse(stainlessPath, snippetId) {
+	const responses = useSpec()?.snippetResponses?.http?.[stainlessPath];
+	if (!responses) return void 0;
+	if (!snippetId) return getDefaultSnippet(responses);
+	return responses[snippetId];
+}
+function useDeclaration(stainlessPath, required, language) {
+	const defaultLanguage = useLanguage();
+	const decl = useSpec()?.decls?.[language ?? defaultLanguage]?.[stainlessPath];
+	if (required && !decl) throw new Error(`Declaration not found for '${stainlessPath}'`);
+	return decl;
+}
+function useAvailableLanguages(stainlessPath) {
+	const spec = useSpec();
+	return Object.keys(spec?.decls ?? {}).filter((lang) => spec?.decls?.[lang]?.[stainlessPath] !== void 0).filter((e) => spec?.docs?.languages?.includes(e));
+}
+function useIgnoredResources() {
+	return ["(resource) webhooks > (model) unwrap_webhook_event > (schema)"];
+}
+function useResource(name) {
+	return useSpec()?.resources?.[name];
+}
+function useLanguage() {
+	return useDocs().language;
+}
+function useContentPanelLayout() {
+	return useDocs().settings?.contentPanelLayout ?? "double-pane";
+}
+function DocsProvider({ spec, language, settings, children }) {
+	return /* @__PURE__ */ jsx(DocsContext, {
+		value: React$1.useMemo(() => ({
+			...DocsContextDefaults,
+			spec,
+			settings: settings ?? DocsContextDefaults.settings,
+			language: language ?? DocsContextDefaults.language
+		}), [
+			spec,
+			language,
+			settings
+		]),
+		children
+	});
+}
+//#endregion
+export { DocsProvider, useAvailableLanguages, useContentPanelLayout, useDeclaration, useDocs, useIgnoredResources, useLanguage, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };

package/dist/contexts/index.d.ts

@@ -0,0 +1,6 @@
+import { g as useLanguageComponents } from "../index-Dt9uPKZP.js";
+import { a as useNavigation, i as NavigationProviderProps, n as NavigationHandler, r as NavigationProvider, t as NavigationContextType } from "../navigation-DGl8lR6w.js";
+import { a as SuspensefulMarkdownProvider, c as useRenderMarkdown, i as MarkdownProviderProps, n as MarkdownContextValue, o as useHighlight, r as MarkdownProvider, s as useMarkdownContext, t as MarkdownContext } from "../markdown-B30HO-Vy.js";
+import { a as useComponents, i as useComponentContext, n as ComponentsContextType, r as customizeComponents, t as ComponentProvider } from "../component-generics-D9XaPlr8.js";
+import { _ as useSnippetResponse, a as DocsProviderProps, c as useContentPanelLayout, d as useIgnoredResources, f as useLanguage, g as useSnippetIds, h as useSnippet, i as DocsProvider, l as useDeclaration, m as useSettings, n as Declaration, o as PropertySettingsType, p as useResource, r as DocsContextType, s as useAvailableLanguages, t as ContentPanelLayout, u as useDocs, v as useSnippets, y as useSpec } from "../docs-D0qzNoXq.js";
+export { ComponentProvider, ComponentsContextType, ContentPanelLayout, Declaration, DocsContextType, DocsProvider, DocsProviderProps, MarkdownContext, MarkdownContextValue, MarkdownProvider, MarkdownProviderProps, NavigationContextType, NavigationHandler, NavigationProvider, NavigationProviderProps, PropertySettingsType, SuspensefulMarkdownProvider, customizeComponents, useAvailableLanguages, useComponentContext, useComponents, useContentPanelLayout, useDeclaration, useDocs, useHighlight, useIgnoredResources, useLanguage, useLanguageComponents, useMarkdownContext, useNavigation, useRenderMarkdown, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };

package/dist/contexts/index.js

@@ -0,0 +1,43 @@
+import { t as __exportAll } from "../chunk-pbuEa-1d.js";
+import { DocsProvider, useAvailableLanguages, useContentPanelLayout, useDeclaration, useDocs, useIgnoredResources, useLanguage, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec } from "./docs.js";
+import { i as useComponents, n as customizeComponents, r as useComponentContext, t as ComponentProvider } from "../component-generics-DYxBWv1v.js";
+import { NavigationProvider, useNavigation } from "./navigation.js";
+import { MarkdownContext, MarkdownProvider, SuspensefulMarkdownProvider, useHighlight, useMarkdownContext, useRenderMarkdown } from "./markdown.js";
+//#region src/contexts/index.tsx
+var contexts_exports = /* @__PURE__ */ __exportAll({
+	ComponentProvider: () => ComponentProvider,
+	DocsProvider: () => DocsProvider,
+	MarkdownContext: () => MarkdownContext,
+	MarkdownProvider: () => MarkdownProvider,
+	NavigationProvider: () => NavigationProvider,
+	SuspensefulMarkdownProvider: () => SuspensefulMarkdownProvider,
+	customizeComponents: () => customizeComponents,
+	useAvailableLanguages: () => useAvailableLanguages,
+	useComponentContext: () => useComponentContext,
+	useComponents: () => useComponents,
+	useContentPanelLayout: () => useContentPanelLayout,
+	useDeclaration: () => useDeclaration,
+	useDocs: () => useDocs,
+	useHighlight: () => useHighlight,
+	useIgnoredResources: () => useIgnoredResources,
+	useLanguage: () => useLanguage,
+	useLanguageComponents: () => useLanguageComponents,
+	useMarkdownContext: () => useMarkdownContext,
+	useNavigation: () => useNavigation,
+	useRenderMarkdown: () => useRenderMarkdown,
+	useResource: () => useResource,
+	useSettings: () => useSettings,
+	useSnippet: () => useSnippet,
+	useSnippetIds: () => useSnippetIds,
+	useSnippetResponse: () => useSnippetResponse,
+	useSnippets: () => useSnippets,
+	useSpec: () => useSpec
+});
+function useLanguageComponents() {
+	const language = useLanguage();
+	const definition = useComponentContext().language[language];
+	if (!definition) throw new Error(`Language component definition not found for language: ${language}`);
+	return definition;
+}
+//#endregion
+export { ComponentProvider, DocsProvider, MarkdownContext, MarkdownProvider, NavigationProvider, SuspensefulMarkdownProvider, customizeComponents, contexts_exports as t, useAvailableLanguages, useComponentContext, useComponents, useContentPanelLayout, useDeclaration, useDocs, useHighlight, useIgnoredResources, useLanguage, useLanguageComponents, useMarkdownContext, useNavigation, useRenderMarkdown, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };

package/dist/contexts/markdown.d.ts

@@ -0,0 +1,2 @@
+import { a as SuspensefulMarkdownProvider, c as useRenderMarkdown, i as MarkdownProviderProps, n as MarkdownContextValue, o as useHighlight, r as MarkdownProvider, s as useMarkdownContext, t as MarkdownContext } from "../markdown-B30HO-Vy.js";
+export { MarkdownContext, MarkdownContextValue, MarkdownProvider, MarkdownProviderProps, SuspensefulMarkdownProvider, useHighlight, useMarkdownContext, useRenderMarkdown };

package/dist/contexts/markdown.js

@@ -0,0 +1,62 @@
+import { useLanguage } from "./docs.js";
+import { Suspense, createContext, use, useMemo } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+//#region src/contexts/markdown.tsx
+const HighlightLanguageMappings = {
+	node: "typescript",
+	http: "bash",
+	cli: "bash"
+};
+const MarkdownContext = createContext({
+	highlight: (content) => content,
+	render: (content) => content
+});
+const useMarkdownContext = () => use(MarkdownContext);
+function useRenderMarkdown(content) {
+	const { render } = use(MarkdownContext);
+	return useMemo(() => {
+		if (!content) return void 0;
+		const rendered = render(content);
+		return typeof rendered === "string" ? rendered : use(rendered);
+	}, [content, render]);
+}
+function useHighlight(content, language) {
+	const { highlight } = use(MarkdownContext);
+	const defaultLanguage = useLanguage();
+	const lang = language ?? defaultLanguage;
+	return useMemo(() => {
+		if (lang === "none") return content;
+		const rendered = highlight(content, HighlightLanguageMappings[lang] ?? lang);
+		return typeof rendered === "string" ? rendered : use(rendered);
+	}, [
+		content,
+		highlight,
+		lang
+	]);
+}
+function MarkdownProvider({ render, highlight, children }) {
+	return /* @__PURE__ */ jsx(MarkdownContext, {
+		value: useMemo(() => ({
+			render,
+			highlight
+		}), [render, highlight]),
+		children
+	});
+}
+function SuspensefulMarkdownProviderInner({ value, children }) {
+	return /* @__PURE__ */ jsx(MarkdownContext, {
+		value: use(value),
+		children
+	});
+}
+function SuspensefulMarkdownProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(Suspense, {
+		fallback: /* @__PURE__ */ jsx(Fragment$1, { children }),
+		children: /* @__PURE__ */ jsx(SuspensefulMarkdownProviderInner, {
+			value,
+			children
+		})
+	});
+}
+//#endregion
+export { MarkdownContext, MarkdownProvider, SuspensefulMarkdownProvider, useHighlight, useMarkdownContext, useRenderMarkdown };

package/dist/contexts/navigation.d.ts

@@ -0,0 +1,2 @@
+import { a as useNavigation, i as NavigationProviderProps, n as NavigationHandler, r as NavigationProvider, t as NavigationContextType } from "../navigation-DGl8lR6w.js";
+export { NavigationContextType, NavigationHandler, NavigationProvider, NavigationProviderProps, useNavigation };

package/dist/contexts/navigation.js

@@ -0,0 +1,21 @@
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/contexts/navigation.tsx
+const Defaults = { basePath: "/" };
+const NavigationContext = React$1.createContext(Defaults);
+function useNavigation() {
+	return React$1.use(NavigationContext);
+}
+function NavigationProvider({ basePath, selectedPath, onNavigate, children }) {
+	return /* @__PURE__ */ jsx(NavigationContext, {
+		value: {
+			...Defaults,
+			onNavigate,
+			basePath,
+			selectedPath
+		},
+		children
+	});
+}
+//#endregion
+export { NavigationProvider, useNavigation };

package/dist/contexts/use-components.d.ts

@@ -0,0 +1,6 @@
+import { t as index_d_exports } from "../index-Dt9uPKZP.js";
+
+//#region src/contexts/use-components.d.ts
+declare const useComponents: () => typeof index_d_exports;
+//#endregion
+export { useComponents };

package/dist/contexts/use-components.js

@@ -0,0 +1,5 @@
+import { i as useComponents$1 } from "../component-generics-DYxBWv1v.js";
+//#region src/contexts/use-components.tsx
+const useComponents = () => useComponents$1();
+//#endregion
+export { useComponents };