@stainless-api/docs-ui 0.1.0-beta.72 → 0.1.0-beta.74

package/dist/components/snippets.js

@@ -1,9 +1,184 @@
-import "../docs-YgoQ3bzY.js";
-import "../component-generics-POFirVVb.js";
-import "../navigation-aoYZ_tl4.js";
-import "../markdown-Cq3XEhrR.js";
-import "../contexts-_NNW5yqC.js";
-import "../use-components-BUz3GbO4.js";
-import { a as SnippetContainer, c as SnippetResponse, i as SnippetCode, n as Snippet, o as SnippetFooter, r as SnippetButtons, s as SnippetRequestContainer, t as MultiSnippets } from "../snippets-CLpNVNlA.js";
+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

@@ -1,2 +1,58 @@
-import { a as StlSidebarProps, i as StlSidebarLink, n as StlSidebarEntry, o as StlSidebarTarget, r as StlSidebarGroup, t as StlSidebar } from "../stl-sidebar-BTTErIJs.js";
+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

@@ -1,5 +1,107 @@
-import "../component-generics-POFirVVb.js";
-import "../use-components-BUz3GbO4.js";
-import { t as StlSidebar } from "../stl-sidebar-DC5UOJiT.js";
+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: flattenStlSidebar(entry.entries).some((i) => i.isCurrent) || !entry.collapsed } : {},
+			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 flattenStlSidebar(sidebar) {
+	return sidebar.flatMap((entry) => entry.type === "group" ? flattenStlSidebar(entry.entries) : entry);
+}
+
+//#endregion
 export { StlSidebar };

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

@@ -1,2 +1,30 @@
-import { a as useComponents, i as useComponentContext, n as ComponentsContextType, r as customizeComponents, t as ComponentProvider } from "../component-generics-Bw4ZOyEG.js";
+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

@@ -1,3 +1,33 @@
-import { i as useComponents, n as customizeComponents, r as useComponentContext, t as ComponentProvider } from "../component-generics-POFirVVb.js";
+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

@@ -1,19 +1,8 @@
-import "../primitives-WGxdBJDS.js";
-import "../breadcrumbs-46Qjx1Pd.js";
-import "../method-D6R_farj.js";
-import "../properties-Bu4nW9JD.js";
-import "../sdk-Dm0S-XQE.js";
-import { t as index_d_exports, y as index_d_exports$1 } from "../index-BOmn7DHa.js";
-import "../navigation-HiZWRl34.js";
-import "../markdown-plMAoN22.js";
-import "../component-generics-Bw4ZOyEG.js";
-import "../docs-xb5wYGjM.js";
-import "../overview-CTeKhpQq.js";
-import "../sdk-sidebar-Dqeu7C1-.js";
-import "../stl-sidebar-BTTErIJs.js";
+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;
-type AppLanguage = typeof index_d_exports$1;
+type AppComponents = typeof index_d_exports$1;
+type AppLanguage = typeof index_d_exports;
 //#endregion
 export { AppComponents, AppLanguage };

package/dist/contexts/component.d.ts

@@ -1,22 +1,12 @@
-import "../primitives-WGxdBJDS.js";
-import "../breadcrumbs-46Qjx1Pd.js";
-import "../method-D6R_farj.js";
-import "../properties-Bu4nW9JD.js";
-import "../sdk-Dm0S-XQE.js";
-import { t as index_d_exports, y as index_d_exports$1 } from "../index-BOmn7DHa.js";
-import "../navigation-HiZWRl34.js";
-import "../markdown-plMAoN22.js";
-import { n as ComponentsContextType } from "../component-generics-Bw4ZOyEG.js";
-import "../docs-xb5wYGjM.js";
-import "../overview-CTeKhpQq.js";
-import "../sdk-sidebar-Dqeu7C1-.js";
-import "../stl-sidebar-BTTErIJs.js";
+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_runtime51 from "react/jsx-runtime";
+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;
+type AppComponents = typeof index_d_exports$1;
+type AppLanguage = typeof index_d_exports;
 declare const defaultContextValue: ComponentsContextType<AppComponents, AppLanguage>;
 declare function ComponentProvider({
   components,
@@ -26,6 +16,6 @@ declare function ComponentProvider({
   components?: Partial<AppComponents>;
   language?: { [K in keyof AppLanguage]?: Partial<AppLanguage[K]> };
   children: React.ReactNode;
-}): react_jsx_runtime51.JSX.Element;
+}): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { AppComponents, AppLanguage, ComponentProvider, defaultContextValue };

package/dist/contexts/component.js

@@ -1,30 +1,24 @@
-import "../docs-YgoQ3bzY.js";
-import "../component-generics-POFirVVb.js";
-import "../navigation-aoYZ_tl4.js";
-import "../markdown-Cq3XEhrR.js";
-import "../contexts-_NNW5yqC.js";
-import "../use-components-BUz3GbO4.js";
-import "../properties-DQU0NBzb.js";
-import "../method-DjzVBzZe.js";
-import "../primitives-CNG-fEhQ.js";
-import "../icons-BYKn5X8E.js";
-import "../sdk-BSdgEEJw.js";
-import "../snippets-CLpNVNlA.js";
-import "../overview-ocTARt-j.js";
-import "../breadcrumbs-BiBfNqBI.js";
-import "../stl-sidebar-DC5UOJiT.js";
-import "../sdk-sidebar-BDn8S1xS.js";
-import "../components-9NMl1791.js";
-import "../typescript-Cmk-jBBw.js";
-import "../java-BiLRuLuD.js";
-import "../go-BoaAVmP0.js";
-import "../python-nqOBH7GS.js";
-import "../ruby-BBc8HdIt.js";
-import "../http-B3qTyMc3.js";
-import "../csharp-sn5CJu9t.js";
-import "../cli-hduQ5XS1.js";
-import "../terraform-DVx2ea2h.js";
-import "../languages-vUhD5Hu_.js";
-import { n as defaultContextValue, t as ComponentProvider } from "../component-BU8BTbqz.js";
+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

@@ -1,2 +1,62 @@
-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-xb5wYGjM.js";
+import { _ as Spec, m as Resource, u as LanguageDeclNodes, v as SpecLanguage } from "../index-PdnFhQF9.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 };