@stainless-api/docs-ui 0.1.0-beta.8 → 0.1.0-beta.81

package/dist/components/snippets.js

@@ -0,0 +1,184 @@
+import { useDeclaration, useLanguage, useSnippet, useSnippetIds, useSnippetResponse } from "../contexts/docs.js";
+import "../use-strict-context-L0c8JKg4.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 * as React$1 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 = React$1.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, setCopyIcon] = React$1.useState(CopyIcon);
+	async function handleCopy() {
+		try {
+			await navigator.clipboard.writeText(content);
+			setCopyIcon(CheckIcon);
+		} catch {
+			setCopyIcon(CircleAlertIcon);
+		}
+		setTimeout(() => setCopyIcon(CopyIcon), 1e3);
+	}
+	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,58 @@
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/stl-sidebar.d.ts
+declare module 'react' {
+  namespace JSX {
+    interface IntrinsicElements {
+      /**
+       * Custom element defined by Starlight's <SidebarPersister>.
+       */
+      'sl-sidebar-restore': React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>;
+    }
+  }
+}
+type StlSidebarTarget = {
+  type: 'href';
+  href: string;
+} | {
+  type: 'stainlessPath';
+  stainlessPath: string;
+};
+interface StlSidebarLink {
+  type: 'link';
+  icon?: ReactNode;
+  label: string;
+  /** Current sidebar item is highlighted. */
+  isCurrent?: boolean;
+  target: StlSidebarTarget;
+  /** Additional HTML attributes that will be attached to the anchor element. */
+  attrs?: Record<string, unknown>;
+}
+interface StlSidebarGroup {
+  type: 'group';
+  icon?: ReactNode;
+  label: string;
+  entries: Array<StlSidebarLink | StlSidebarGroup>;
+  /** Defaults to true. */
+  collapsible?: boolean;
+  collapsed?: boolean;
+  /** Current sidebar item is highlighted. */
+  isCurrent?: boolean;
+  target?: StlSidebarTarget;
+}
+type StlSidebarEntry = StlSidebarLink | StlSidebarGroup;
+type StlSidebarProps = {
+  entries: StlSidebarEntry[];
+  /**
+   * If set, add <sl-sidebar-restore> custom elements (as defined by Starlight's SidebarPersister)
+   * which are used to save/restore sidebar state.
+   */
+  withStarlightRestoration?: boolean;
+};
+declare function StlSidebar({
+  entries,
+  withStarlightRestoration
+}: StlSidebarProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { StlSidebar, StlSidebarEntry, StlSidebarGroup, StlSidebarLink, StlSidebarProps, StlSidebarTarget };

package/dist/components/stl-sidebar.js

@@ -0,0 +1,114 @@
+import "../use-strict-context-L0c8JKg4.js";
+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,30 @@
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/contexts/component-generics.d.ts
+type DeepPartialMap<L> = { [K in keyof L]?: Partial<L[K]> };
+type ComponentsContextType<C, L> = {
+  components: C;
+  language: L;
+};
+declare const useComponentContext: () => ComponentsContextType<any, any>;
+declare function useComponents<C = unknown>(): C;
+declare function customizeComponents<C, L>(defaults: {
+  components: C;
+  language: L;
+}, overrides?: {
+  components?: Partial<C>;
+  language?: DeepPartialMap<L>;
+}): {
+  components: C;
+  language: L;
+};
+declare function ComponentProvider<C, L>({
+  value,
+  children
+}: {
+  value: ComponentsContextType<C, L>;
+  children: React$1.ReactNode;
+}): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ComponentProvider, ComponentsContextType, customizeComponents, useComponentContext, useComponents };

package/dist/contexts/component-generics.js

@@ -0,0 +1,33 @@
+import { t as createStrictContext } from "../use-strict-context-L0c8JKg4.js";
+import "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/contexts/component-generics.tsx
+const [Provider, useComponentContext] = createStrictContext("Component");
+function useComponents() {
+	return useComponentContext().components;
+}
+function customizeComponents(defaults, overrides = {}) {
+	return {
+		components: {
+			...defaults.components,
+			...overrides.components ?? {}
+		},
+		language: Object.keys(defaults.language).reduce((acc, key) => {
+			acc[key] = {
+				...defaults.language[key],
+				...overrides.language?.[key] ?? {}
+			};
+			return acc;
+		}, {})
+	};
+}
+function ComponentProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(Provider, {
+		value,
+		children
+	});
+}
+
+//#endregion
+export { ComponentProvider, customizeComponents, useComponentContext, useComponents };

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

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

package/dist/contexts/component.d.ts

@@ -0,0 +1,21 @@
+import { t as index_d_exports } from "../languages/index.js";
+import { ComponentsContextType } from "./component-generics.js";
+import { t as index_d_exports$1 } from "../components/index.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$1;
+type AppLanguage = typeof index_d_exports;
+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,24 @@
+import "../use-strict-context-L0c8JKg4.js";
+import { ComponentProvider as ComponentProvider$1, customizeComponents } from "./component-generics.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,62 @@
+import { h as Resource, u as LanguageDeclNodes, v as Spec, y as SpecLanguage } from "../index-pvh-w1xa.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/contexts/docs.d.ts
+type ContentPanelLayout = 'double-pane' | 'single-pane';
+type PropertySettingsType = {
+  types?: 'simple' | 'rich';
+  includeModelProperties?: boolean | 'method-page';
+  collapseDescription?: boolean | 'show-first-line';
+  showTitle?: boolean;
+  expandDepth?: number;
+};
+type DocsContextType = {
+  language: SpecLanguage;
+  spec: Spec | null;
+  settings?: {
+    properties?: PropertySettingsType;
+    contentPanelLayout?: ContentPanelLayout;
+    virtualExpanders?: boolean;
+  };
+};
+declare function useDocs(): DocsContextType;
+declare function useSpec(): Spec | null;
+declare function useSettings(): {
+  properties?: PropertySettingsType;
+  contentPanelLayout?: ContentPanelLayout;
+  virtualExpanders?: boolean;
+} | undefined;
+declare function useSnippets(stainlessPath: string, language?: SpecLanguage): {
+  [key: `custom:${string}`]: {
+    content: string;
+  };
+  default: {
+    content: string;
+  };
+} | undefined;
+declare function useSnippetIds(stainlessPath: string, language?: SpecLanguage): SnippetId[] | undefined;
+type SnippetId = keyof NonNullable<ReturnType<typeof useSnippets>>;
+declare function useSnippet(stainlessPath: string, language?: SpecLanguage, snippetId?: SnippetId): string | undefined;
+declare function useSnippetResponse(stainlessPath: string, snippetId?: SnippetId): {
+  status?: string;
+  content: string;
+}[] | undefined;
+type Declaration = LanguageDeclNodes[SpecLanguage];
+declare function useDeclaration<Required extends boolean>(stainlessPath: string, required: Required, language?: SpecLanguage): (Required extends true ? never : undefined) | Declaration;
+declare function useAvailableLanguages(stainlessPath: string): SpecLanguage[];
+declare function useIgnoredResources(): string[];
+declare function useResource(name: string): Resource | undefined;
+declare function useLanguage(): "http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin" | "csharp" | "php" | "cli";
+declare function useContentPanelLayout(): ContentPanelLayout;
+type DocsProviderProps = DocsContextType & {
+  children: React$1.ReactNode;
+};
+declare function DocsProvider({
+  spec,
+  language,
+  settings,
+  children
+}: DocsProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+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,91 @@
+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,13 @@
+import { LanguageComponentDefinition } from "../languages/index.js";
+import { NavigationContextType, NavigationHandler, NavigationProvider, NavigationProviderProps, useNavigation } from "./navigation.js";
+import { MarkdownContext, MarkdownProvider, MarkdownProviderProps, useHighlight, useMarkdownContext, useRenderMarkdown } from "./markdown.js";
+import { ComponentProvider, ComponentsContextType, customizeComponents, useComponentContext, useComponents } from "./component-generics.js";
+import { ContentPanelLayout, Declaration, DocsContextType, DocsProvider, DocsProviderProps, PropertySettingsType, useAvailableLanguages, useContentPanelLayout, useDeclaration, useDocs, useIgnoredResources, useLanguage, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec } from "./docs.js";
+
+//#region src/contexts/index.d.ts
+declare namespace index_d_exports {
+  export { ComponentProvider, ComponentsContextType, ContentPanelLayout, Declaration, DocsContextType, DocsProvider, DocsProviderProps, MarkdownContext, MarkdownProvider, MarkdownProviderProps, NavigationContextType, NavigationHandler, NavigationProvider, NavigationProviderProps, PropertySettingsType, customizeComponents, useAvailableLanguages, useComponentContext, useComponents, useContentPanelLayout, useDeclaration, useDocs, useHighlight, useIgnoredResources, useLanguage, useLanguageComponents, useMarkdownContext, useNavigation, useRenderMarkdown, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };
+}
+declare function useLanguageComponents(): LanguageComponentDefinition;
+//#endregion
+export { ComponentProvider, ComponentsContextType, ContentPanelLayout, Declaration, DocsContextType, DocsProvider, DocsProviderProps, MarkdownContext, MarkdownProvider, MarkdownProviderProps, NavigationContextType, NavigationHandler, NavigationProvider, NavigationProviderProps, PropertySettingsType, customizeComponents, index_d_exports as t, useAvailableLanguages, useComponentContext, useComponents, useContentPanelLayout, useDeclaration, useDocs, useHighlight, useIgnoredResources, useLanguage, useLanguageComponents, useMarkdownContext, useNavigation, useRenderMarkdown, useResource, useSettings, useSnippet, useSnippetIds, useSnippetResponse, useSnippets, useSpec };