@stainless-api/docs-ui 0.1.0-beta.61 → 0.1.0-beta.63

package/dist/{sdk-GGpyGTao.js → sdk-afI6c7Wd.js}

@@ -1,9 +1,9 @@
-import { a as useLanguage, l as useSpec, n as useContentPanelLayout, r as useDeclaration, s as useSettings } from "./docs-Di94viZV.js";
+import { c as useSettings, i as useDeclaration, n as useAvailableLanguages, o as useLanguage, r as useContentPanelLayout, u as useSpec } from "./docs-6PYi1eEV.js";
 import { n as useNavigation } from "./navigation-aoYZ_tl4.js";
-import { n as useLanguageComponents } from "./contexts-CeV_L_Iy.js";
+import { n as useLanguageComponents } from "./contexts-DMjqoc7S.js";
 import { t as useComponents } from "./use-components-BUz3GbO4.js";
-import { t as style_default } from "./style-LwfvXElj.js";
-import { c as getLanguageSnippet, t as LanguageNames } from "./routing-Ce0_tBW6.js";
+import { t as style_default } from "./style-Bxr5gqcM.js";
+import { l as getLanguageSnippet, s as generateRoute, t as LanguageNames } from "./routing-CLgL--x1.js";
 import { a as JavaIcon, c as PythonIcon, d as TypescriptIcon, i as GoIcon, l as RubyIcon, n as CSharpIcon, o as KotlinIcon, r as CurlIcon, s as PowershellIcon, t as CLIIcon, u as TerraformIcon } from "./icons-BYKn5X8E.js";
 import * as React$1 from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -174,10 +174,20 @@ function SDKMethodHeader({ method }) {
 		})
 	});
 }
+function useStreamingResponse(method) {
+	const tsDecl = useDeclaration(method.stainlessPath, false, "typescript");
+	if (tsDecl?.kind === "TSDeclFunction" && tsDecl.overloads) {
+		for (const e of tsDecl.overloads) if (e.returns.kind === "TSTypeReference" && (e.returns.$ref === "$.typescript.Stream" || e.returns.$ref === "$.node.Stream") && e.returns.typeParameters?.[0]?.kind === "TSTypeReference") {
+			const id = e.returns.typeParameters?.[0].$ref;
+			if (id) return id;
+		}
+	}
+}
 function SDKMethodInfo({ method }) {
 	const Docs = useComponents();
 	const Lang = useLanguageComponents();
 	const decl = useDeclaration(method.stainlessPath, true);
+	const streamingResponse = useStreamingResponse(method);
 	const spec = useSpec();
 	const language = useLanguage();
 	if (Lang.MethodInfo) return /* @__PURE__ */ jsx(Lang.MethodInfo, { decl });
@@ -188,23 +198,32 @@ function SDKMethodInfo({ method }) {
 		const decl = spec?.decls?.[language]?.[item];
 		return decl && "children" in decl && decl.children && decl.children.length > 0;
 	}
+	const responseChildren = "responseChildren" in decl && decl.responseChildren && decl.responseChildren.length > 0 ? [...decl.responseChildren] : [];
+	if (streamingResponse) responseChildren.push(streamingResponse);
 	return /* @__PURE__ */ jsx(Docs.MethodInfo, {
 		parameters: "paramsChildren" in decl && Array.isArray(decl.paramsChildren) && decl.paramsChildren.length > 0 && /* @__PURE__ */ jsx(Docs.SDKChildren, {
 			expand: shouldExpand(decl.paramsChildren),
 			paths: decl.paramsChildren
 		}),
-		returns: "responseChildren" in decl && decl.responseChildren && decl.responseChildren.length > 0 && /* @__PURE__ */ jsx(Docs.SDKChildren, {
-			expand: shouldExpand(decl.responseChildren),
-			paths: decl.responseChildren
+		returns: responseChildren.length > 0 && /* @__PURE__ */ jsx(Docs.SDKChildren, {
+			expand: shouldExpand(responseChildren),
+			paths: responseChildren
 		})
 	});
 }
-function SDKMethod({ method, transformRequestSnippet }) {
+function SDKMethodNotImplemented({ method }) {
 	const Docs = useComponents();
-	const decl = useDeclaration(method?.stainlessPath, false);
-	const layout = useContentPanelLayout();
+	const languages = useAvailableLanguages(method?.stainlessPath);
 	const language = useLanguage();
-	if (!decl) return /* @__PURE__ */ jsxs("div", {
+	const { basePath } = useNavigation();
+	const availableLanguageLinks = languages.flatMap((lang) => {
+		const url = generateRoute(basePath ?? "/", lang, method.stainlessPath);
+		return url ? [{
+			url,
+			label: LanguageNames[lang] ?? lang
+		}] : [];
+	});
+	return /* @__PURE__ */ jsxs("div", {
 		className: style_default.Method,
 		children: [/* @__PURE__ */ jsx(Docs.MethodHeader, {
 			level: "h1",
@@ -220,10 +239,21 @@ function SDKMethod({ method, transformRequestSnippet }) {
 				/* @__PURE__ */ jsx("code", { children: method.name }),
 				" is not implemented in ",
 				LanguageNames[language] ?? language,
-				"."
+				basePath && availableLanguageLinks.length > 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [", but it is available in the following languages:", /* @__PURE__ */ jsx("ul", { children: availableLanguageLinks.map(({ url, label }) => {
+					return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", {
+						href: url,
+						children: label
+					}) }, url);
+				}) })] }) : "."
 			]
 		})]
 	});
+}
+function SDKMethod({ method, transformRequestSnippet }) {
+	const Docs = useComponents();
+	const decl = useDeclaration(method?.stainlessPath, false);
+	const layout = useContentPanelLayout();
+	if (!decl) return /* @__PURE__ */ jsx(SDKMethodNotImplemented, { method });
 	return /* @__PURE__ */ jsxs(Docs.Method, {
 		id: method.stainlessPath,
 		header: /* @__PURE__ */ jsx(Docs.SDKMethodHeader, { method }),
@@ -335,4 +365,4 @@ function SDKLanguageBlock({ language, version, install, links }) {
 }
 
 //#endregion
-export { useReferenceNesting as _, SDKDeclaration as a, SDKLanguageBlock as c, SDKMethodInfo as d, SDKModel as f, usePropertyModel as g, SDKSnippetLanguages as h, SDKConstraints as i, SDKMethod as l, SDKRequestTitle as m, ReferenceNestingContext as n, SDKExample as o, SDKReference as p, SDKChildren as r, SDKIcon as s, PropertyModelContext as t, SDKMethodHeader as u };
+export { usePropertyModel as _, SDKDeclaration as a, SDKLanguageBlock as c, SDKMethodInfo as d, SDKMethodNotImplemented as f, SDKSnippetLanguages as g, SDKRequestTitle as h, SDKConstraints as i, SDKMethod as l, SDKReference as m, ReferenceNestingContext as n, SDKExample as o, SDKModel as p, SDKChildren as r, SDKIcon as s, PropertyModelContext as t, SDKMethodHeader as u, useReferenceNesting as v, useStreamingResponse as y };

package/dist/{sdk-CIxaNoAs.d.ts → sdk-hDAzjotL.d.ts}

@@ -1,7 +1,7 @@
-import { l as Method, m as SnippetLanguage, o as ID, u as Model } from "./index-zNpvNvtN.js";
-import { t as DocsLanguage } from "./routing-CtbZJru_.js";
+import { d as Model, h as SnippetLanguage, s as ID, t as BaseDeclaration, u as Method } from "./index-DuHyTVVD.js";
+import { t as DocsLanguage } from "./routing-CqnhQY4G.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime20 from "react/jsx-runtime";
+import * as react_jsx_runtime61 from "react/jsx-runtime";
 
 //#region src/components/sdk.d.ts
 type PropertyModelContextType = {
@@ -33,7 +33,7 @@ declare function SDKChildren({
   paths,
   expand,
   depth
-}: SDKChildrenProps): react_jsx_runtime20.JSX.Element;
+}: SDKChildrenProps): react_jsx_runtime61.JSX.Element;
 type SDKDeclarationProps = {
   path: string;
   expand?: boolean;
@@ -43,26 +43,26 @@ declare function SDKDeclaration({
   path,
   expand,
   depth
-}: SDKDeclarationProps): react_jsx_runtime20.JSX.Element;
+}: SDKDeclarationProps): react_jsx_runtime61.JSX.Element;
 type SDKConstraintsProps = {
   constraints?: Record<string, any>;
 };
 declare function SDKConstraints({
   constraints
-}: SDKConstraintsProps): react_jsx_runtime20.JSX.Element | undefined;
+}: SDKConstraintsProps): react_jsx_runtime61.JSX.Element | undefined;
 type SDKIconProps = {
   language: SnippetLanguage;
   size?: number;
 };
 declare function SDKIcon({
   language
-}: SDKIconProps): react_jsx_runtime20.JSX.Element | null;
+}: SDKIconProps): react_jsx_runtime61.JSX.Element | null;
 type SDKRequestTitleProps = {
   snippetLanguage: SnippetLanguage;
 };
 declare function SDKRequestTitle({
   snippetLanguage
-}: SDKRequestTitleProps): react_jsx_runtime20.JSX.Element;
+}: SDKRequestTitleProps): react_jsx_runtime61.JSX.Element;
 type SDKExampleProps = {
   method: Method;
   transformRequestSnippet?: TransformRequestSnippetFn;
@@ -70,27 +70,31 @@ type SDKExampleProps = {
 declare function SDKExample({
   method,
   transformRequestSnippet
-}: SDKExampleProps): react_jsx_runtime20.JSX.Element;
+}: SDKExampleProps): react_jsx_runtime61.JSX.Element;
 type SDKMethodProps = {
   method: Method;
   transformRequestSnippet?: TransformRequestSnippetFn;
 };
 declare function SDKMethodHeader({
   method
-}: SDKMethodProps): react_jsx_runtime20.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime61.JSX.Element;
+declare function useStreamingResponse(method: BaseDeclaration): ID | undefined;
 declare function SDKMethodInfo({
   method
-}: SDKMethodProps): react_jsx_runtime20.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime61.JSX.Element;
+declare function SDKMethodNotImplemented({
+  method
+}: SDKMethodProps): react_jsx_runtime61.JSX.Element;
 declare function SDKMethod({
   method,
   transformRequestSnippet
-}: SDKMethodProps): react_jsx_runtime20.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime61.JSX.Element;
 type SDKModelProps = {
   model: Model;
 };
 declare function SDKModel({
   model
-}: SDKModelProps): react_jsx_runtime20.JSX.Element | null;
+}: SDKModelProps): react_jsx_runtime61.JSX.Element | null;
 type SDKReferenceProps = {
   stainlessPath: string;
   children?: React$1.ReactNode;
@@ -98,7 +102,7 @@ type SDKReferenceProps = {
 declare function SDKReference({
   stainlessPath,
   children
-}: SDKReferenceProps): string | number | bigint | boolean | react_jsx_runtime20.JSX.Element | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | null | undefined;
+}: SDKReferenceProps): string | number | bigint | boolean | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | react_jsx_runtime61.JSX.Element | null | undefined;
 type SDKLanguageBlockProps = {
   language: DocsLanguage;
   version: string;
@@ -113,6 +117,6 @@ declare function SDKLanguageBlock({
   version,
   install,
   links
-}: SDKLanguageBlockProps): react_jsx_runtime20.JSX.Element;
+}: SDKLanguageBlockProps): react_jsx_runtime61.JSX.Element;
 //#endregion
-export { TransformRequestSnippetFn as C, SDKSnippetLanguagesType as S, useReferenceNesting as T, SDKModelProps as _, SDKChildren as a, SDKRequestTitleProps as b, SDKDeclaration as c, SDKLanguageBlock as d, SDKMethod as f, SDKModel as g, SDKMethodProps as h, ReferenceNestingContextType as i, SDKExample as l, SDKMethodInfo as m, PropertyModelContextType as n, SDKConstraints as o, SDKMethodHeader as p, ReferenceNestingContext as r, SDKConstraintsProps as s, PropertyModelContext as t, SDKIcon as u, SDKReference as v, usePropertyModel as w, SDKSnippetLanguages as x, SDKRequestTitle as y };
+export { SDKSnippetLanguagesType as C, useStreamingResponse as D, useReferenceNesting as E, SDKSnippetLanguages as S, usePropertyModel as T, SDKModel as _, SDKChildren as a, SDKRequestTitle as b, SDKDeclaration as c, SDKLanguageBlock as d, SDKMethod as f, SDKMethodProps as g, SDKMethodNotImplemented as h, ReferenceNestingContextType as i, SDKExample as l, SDKMethodInfo as m, PropertyModelContextType as n, SDKConstraints as o, SDKMethodHeader as p, ReferenceNestingContext as r, SDKConstraintsProps as s, PropertyModelContext as t, SDKIcon as u, SDKModelProps as v, TransformRequestSnippetFn as w, SDKRequestTitleProps as x, SDKReference as y };

package/dist/sdk-sidebar-ByMsvpUm.d.ts

@@ -0,0 +1,15 @@
+import { p as Resource } from "./index-DuHyTVVD.js";
+import * as react_jsx_runtime60 from "react/jsx-runtime";
+
+//#region src/components/sdk-sidebar.d.ts
+type SDKSidebarProps = {
+  resources: Resource[];
+};
+/**
+ * Given some SDKJSON.Resources, calls into StlSidebar with the appropriate sidebar entries.
+ */
+declare function SDKSidebar({
+  resources
+}: SDKSidebarProps): react_jsx_runtime60.JSX.Element;
+//#endregion
+export { SDKSidebarProps as n, SDKSidebar as t };

package/dist/sdk-sidebar-CoVgP38f.d.ts

@@ -0,0 +1,15 @@
+import { p as Resource } from "./index-DuHyTVVD.js";
+import * as react_jsx_runtime74 from "react/jsx-runtime";
+
+//#region src/components/sdk-sidebar.d.ts
+type SDKSidebarProps = {
+  resources: Resource[];
+};
+/**
+ * Given some SDKJSON.Resources, calls into StlSidebar with the appropriate sidebar entries.
+ */
+declare function SDKSidebar({
+  resources
+}: SDKSidebarProps): react_jsx_runtime74.JSX.Element;
+//#endregion
+export { SDKSidebarProps as n, SDKSidebar as t };

package/dist/sdk-sidebar-ZaXTw63C.js

@@ -0,0 +1,36 @@
+import { n as useNavigation } from "./navigation-aoYZ_tl4.js";
+import { r as isResourceEmpty } from "./utils-36jzmKxv.js";
+import { t as StlSidebar } from "./stl-sidebar-DdxZx2KK.js";
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/sdk-sidebar.tsx
+function resourceToEntry(resource, selectedPath) {
+	const result = {
+		type: "group",
+		collapsed: false,
+		label: resource.title,
+		entries: [],
+		stainlessPath: resource.stainlessPath,
+		isCurrent: selectedPath === resource.stainlessPath
+	};
+	for (const method of Object.values(resource.methods)) result.entries.push({
+		type: "link",
+		attrs: { "data-stldocs-method": method.httpMethod },
+		stainlessPath: method.stainlessPath,
+		label: method.title,
+		isCurrent: selectedPath === method.stainlessPath
+	});
+	for (const subresource of Object.values(resource.subresources ?? {})) result.entries.push(resourceToEntry(subresource, selectedPath));
+	return result;
+}
+/**
+* Given some SDKJSON.Resources, calls into StlSidebar with the appropriate sidebar entries.
+*/
+function SDKSidebar({ resources }) {
+	const { selectedPath } = useNavigation();
+	return /* @__PURE__ */ jsx(StlSidebar, { entries: React$1.useMemo(() => resources.filter((resource) => !isResourceEmpty(resource)).map((resource) => resourceToEntry(resource, selectedPath)), [resources, selectedPath]) });
+}
+
+//#endregion
+export { SDKSidebar as t };

package/dist/{snippets-CwVjwsAo.d.ts → snippets-BqKFOZfY.d.ts}

@@ -1,7 +1,7 @@
-import { l as Method } from "./index-zNpvNvtN.js";
-import { C as TransformRequestSnippetFn } from "./sdk-CIxaNoAs.js";
+import { u as Method } from "./index-DuHyTVVD.js";
+import { w as TransformRequestSnippetFn } from "./sdk-hDAzjotL.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime47 from "react/jsx-runtime";
+import * as react_jsx_runtime75 from "react/jsx-runtime";
 
 //#region src/components/snippets.d.ts
 type SnippetCodeProps = {
@@ -12,7 +12,7 @@ type SnippetCodeProps = {
 declare function SnippetCode({
   content,
   language
-}: SnippetCodeProps): react_jsx_runtime47.JSX.Element;
+}: SnippetCodeProps): react_jsx_runtime75.JSX.Element;
 type SnippetProps = {
   method: Method;
   requestTitle?: React$1.ReactNode;
@@ -25,29 +25,29 @@ type SnippetContainerProps = {
 };
 declare function SnippetContainer({
   children
-}: SnippetContainerProps): react_jsx_runtime47.JSX.Element;
+}: SnippetContainerProps): react_jsx_runtime75.JSX.Element;
 type SnippetRequestContainerProps = {
   children?: React$1.ReactNode;
   signature?: string;
 };
 declare function SnippetRequestContainer({
   children
-}: SnippetRequestContainerProps): react_jsx_runtime47.JSX.Element;
+}: SnippetRequestContainerProps): react_jsx_runtime75.JSX.Element;
 declare function Snippet({
   requestTitle,
   method,
   transformRequestSnippet
-}: SnippetProps): react_jsx_runtime47.JSX.Element | null;
+}: SnippetProps): react_jsx_runtime75.JSX.Element | null;
 declare function SnippetButtons({
   content
 }: {
   content: string;
-}): react_jsx_runtime47.JSX.Element;
+}): react_jsx_runtime75.JSX.Element;
 declare function SnippetFooter(): React$1.ReactNode;
 declare function SnippetResponse({
   responses
 }: {
   responses: Method['exampleResponses'];
-}): react_jsx_runtime47.JSX.Element | null;
+}): react_jsx_runtime75.JSX.Element | null;
 //#endregion
 export { SnippetContainer as a, SnippetProps as c, SnippetResponse as d, SnippetCodeProps as i, SnippetRequestContainer as l, SnippetButtons as n, SnippetContainerProps as o, SnippetCode as r, SnippetFooter as s, Snippet as t, SnippetRequestContainerProps as u };

package/dist/{snippets-Ym3mnHO3.d.ts → snippets-Dfd3zU_j.d.ts}

@@ -1,7 +1,7 @@
-import { l as Method } from "./index-zNpvNvtN.js";
-import { C as TransformRequestSnippetFn } from "./sdk-BebFnWYL.js";
+import { u as Method } from "./index-DuHyTVVD.js";
+import { w as TransformRequestSnippetFn } from "./sdk-BDzHdl2y.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime67 from "react/jsx-runtime";
+import * as react_jsx_runtime88 from "react/jsx-runtime";
 
 //#region src/components/snippets.d.ts
 type SnippetCodeProps = {
@@ -12,7 +12,7 @@ type SnippetCodeProps = {
 declare function SnippetCode({
   content,
   language
-}: SnippetCodeProps): react_jsx_runtime67.JSX.Element;
+}: SnippetCodeProps): react_jsx_runtime88.JSX.Element;
 type SnippetProps = {
   method: Method;
   requestTitle?: React$1.ReactNode;
@@ -25,29 +25,29 @@ type SnippetContainerProps = {
 };
 declare function SnippetContainer({
   children
-}: SnippetContainerProps): react_jsx_runtime67.JSX.Element;
+}: SnippetContainerProps): react_jsx_runtime88.JSX.Element;
 type SnippetRequestContainerProps = {
   children?: React$1.ReactNode;
   signature?: string;
 };
 declare function SnippetRequestContainer({
   children
-}: SnippetRequestContainerProps): react_jsx_runtime67.JSX.Element;
+}: SnippetRequestContainerProps): react_jsx_runtime88.JSX.Element;
 declare function Snippet({
   requestTitle,
   method,
   transformRequestSnippet
-}: SnippetProps): react_jsx_runtime67.JSX.Element | null;
+}: SnippetProps): react_jsx_runtime88.JSX.Element | null;
 declare function SnippetButtons({
   content
 }: {
   content: string;
-}): react_jsx_runtime67.JSX.Element;
+}): react_jsx_runtime88.JSX.Element;
 declare function SnippetFooter(): React$1.ReactNode;
 declare function SnippetResponse({
   responses
 }: {
   responses: Method['exampleResponses'];
-}): react_jsx_runtime67.JSX.Element | null;
+}): react_jsx_runtime88.JSX.Element | null;
 //#endregion
 export { SnippetContainer as a, SnippetProps as c, SnippetResponse as d, SnippetCodeProps as i, SnippetRequestContainer as l, SnippetButtons as n, SnippetContainerProps as o, SnippetCode as r, SnippetFooter as s, Snippet as t, SnippetRequestContainerProps as u };

package/dist/{snippets-kI8eNs1F.js → snippets-bh8lfniq.js}

@@ -1,7 +1,7 @@
-import { a as useLanguage, c as useSnippet, r as useDeclaration } from "./docs-Di94viZV.js";
-import { r as useHighlight } from "./markdown-D2JWyRws.js";
+import { i as useDeclaration, l as useSnippet, o as useLanguage } from "./docs-6PYi1eEV.js";
+import { r as useHighlight } from "./markdown-DHjcD13O.js";
 import { t as useComponents } from "./use-components-BUz3GbO4.js";
-import { t as style_default } from "./style-LwfvXElj.js";
+import { t as style_default } from "./style-Bxr5gqcM.js";
 import * as React$1 from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import clsx from "clsx";

package/dist/spec.d.ts

@@ -1,5 +1,5 @@
-import { f as Resource, g as SpecLanguage, h as Spec, l as Method, r as DeclarationNode, u as Model } from "./index-zNpvNvtN.js";
-import { t as DocsLanguage } from "./routing-CtbZJru_.js";
+import { _ as SpecLanguage, d as Model, g as Spec, i as DeclarationNode, p as Resource, u as Method } from "./index-DuHyTVVD.js";
+import { t as DocsLanguage } from "./routing-CqnhQY4G.js";
 
 //#region src/spec.d.ts
 type SecurityScheme = Spec['security_schemes'][number];

package/dist/spec.js

@@ -1,5 +1,5 @@
-import { n as Languages } from "./routing-Ce0_tBW6.js";
-import { r as isResourceEmpty } from "./utils-D01mAUfQ.js";
+import { n as Languages } from "./routing-CLgL--x1.js";
+import { r as isResourceEmpty } from "./utils-36jzmKxv.js";
 
 //#region src/spec.ts
 const defaultTransforms = {

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

@@ -0,0 +1,45 @@
+import * as react_jsx_runtime74 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>;
+    }
+  }
+}
+interface StlSidebarLink {
+  type: 'link';
+  label: string;
+  isCurrent?: boolean;
+  attrs: Record<string, unknown>;
+  href?: string;
+  stainlessPath?: string;
+}
+interface StlSidebarGroup {
+  type: 'group';
+  label: string;
+  entries: Array<StlSidebarLink | StlSidebarGroup>;
+  collapsed: boolean;
+  isCurrent?: boolean;
+  href?: string;
+  stainlessPath?: string;
+}
+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_runtime74.JSX.Element;
+//#endregion
+export { StlSidebarProps as a, StlSidebarLink as i, StlSidebarEntry as n, StlSidebarGroup as r, StlSidebar as t };

package/dist/stl-sidebar-DdxZx2KK.js

@@ -0,0 +1,82 @@
+import { t as useComponents } from "./use-components-BUz3GbO4.js";
+import { t as style_default } from "./style-Bxr5gqcM.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 StlSidebarSublist({ entries, entryToIndex }) {
+	const Docs = useComponents();
+	return /* @__PURE__ */ jsx("ul", {
+		className: style_default.SidebarList,
+		children: entries.map((entry, index) => {
+			const restorePointIndex = entryToIndex?.get(entry);
+			const hasLink = !!(entry.href || entry.stainlessPath);
+			return /* @__PURE__ */ jsx("li", {
+				className: clsx(style_default.SidebarEntry, entry.type === "link" ? style_default.SidebarEntryLink : style_default.SidebarEntryGroup),
+				children: entry.type === "link" ? /* @__PURE__ */ jsx(Docs.Link, {
+					href: entry.href,
+					stainlessPath: entry.stainlessPath,
+					"aria-current": entry.isCurrent ? "page" : void 0,
+					...entry.attrs,
+					children: entry.label
+				}) : /* @__PURE__ */ jsxs(Fragment, { children: [hasLink && /* @__PURE__ */ jsx(Docs.Link, {
+					href: entry.href,
+					stainlessPath: entry.stainlessPath,
+					"aria-current": entry.isCurrent ? "page" : void 0,
+					children: entry.label
+				}), /* @__PURE__ */ jsxs("details", {
+					className: style_default.SidebarExpander,
+					open: flattenStlSidebar(entry.entries).some((i) => i.isCurrent) || !entry.collapsed,
+					children: [
+						/* @__PURE__ */ jsxs("summary", {
+							className: style_default.ExpanderSummary,
+							children: [/* @__PURE__ */ jsx("span", {
+								"aria-hidden": hasLink ? "true" : void 0,
+								children: entry.label
+							}), entry.entries.length > 0 && /* @__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
+						})
+					]
+				})] })
+			}, index);
+		})
+	});
+}
+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 as t };

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

@@ -0,0 +1,45 @@
+import * as react_jsx_runtime34 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>;
+    }
+  }
+}
+interface StlSidebarLink {
+  type: 'link';
+  label: string;
+  isCurrent?: boolean;
+  attrs: Record<string, unknown>;
+  href?: string;
+  stainlessPath?: string;
+}
+interface StlSidebarGroup {
+  type: 'group';
+  label: string;
+  entries: Array<StlSidebarLink | StlSidebarGroup>;
+  collapsed: boolean;
+  isCurrent?: boolean;
+  href?: string;
+  stainlessPath?: string;
+}
+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_runtime34.JSX.Element;
+//#endregion
+export { StlSidebarProps as a, StlSidebarLink as i, StlSidebarEntry as n, StlSidebarGroup as r, StlSidebar as t };

package/dist/{style-LwfvXElj.js → style-Bxr5gqcM.js}

@@ -129,13 +129,13 @@ var style_default = {
 	Model: "stldocs-model",
 	Root: "stldocs-root",
 	Sidebar: "stldocs-sidebar",
-	SidebarResource: "stldocs-sidebar-resource",
-	SidebarResourceTitle: "stldocs-sidebar-resource-title",
-	SidebarMethod: "stldocs-sidebar-method",
-	SidebarItemTitle: "stldocs-sidebar-resource-title",
+	SidebarList: "stldocs-sidebar-list",
 	SidebarExpander: "stldocs-sidebar-expander",
 	SidebarExpanderSummary: "stldocs-sidebar-expander-summary",
 	SidebarExpanderContent: "stldocs-sidebar-expander-content",
+	SidebarEntry: "stldocs-sidebar-entry",
+	SidebarEntryLink: "stldocs-sidebar-entry-link",
+	SidebarEntryGroup: "stldocs-sidebar-entry-group",
 	SearchForm: "stldocs-search-form",
 	SearchModal: "stldocs-search-modal",
 	SearchFilter: "stldocs-search-filter",

package/dist/style.d.ts

@@ -129,13 +129,13 @@ declare const _default: {
   readonly Model: "stldocs-model";
   readonly Root: "stldocs-root";
   readonly Sidebar: "stldocs-sidebar";
-  readonly SidebarResource: "stldocs-sidebar-resource";
-  readonly SidebarResourceTitle: "stldocs-sidebar-resource-title";
-  readonly SidebarMethod: "stldocs-sidebar-method";
-  readonly SidebarItemTitle: "stldocs-sidebar-resource-title";
+  readonly SidebarList: "stldocs-sidebar-list";
   readonly SidebarExpander: "stldocs-sidebar-expander";
   readonly SidebarExpanderSummary: "stldocs-sidebar-expander-summary";
   readonly SidebarExpanderContent: "stldocs-sidebar-expander-content";
+  readonly SidebarEntry: "stldocs-sidebar-entry";
+  readonly SidebarEntryLink: "stldocs-sidebar-entry-link";
+  readonly SidebarEntryGroup: "stldocs-sidebar-entry-group";
   readonly SearchForm: "stldocs-search-form";
   readonly SearchModal: "stldocs-search-modal";
   readonly SearchFilter: "stldocs-search-filter";

package/dist/style.js

@@ -1,3 +1,3 @@
-import { t as style_default } from "./style-LwfvXElj.js";
+import { t as style_default } from "./style-Bxr5gqcM.js";
 
 export { style_default as default };

package/dist/styles/primitives.css

@@ -251,6 +251,12 @@
   ol {
     list-style-type: decimal;
   }
+
+  hr {
+    margin-bottom: 16px;
+    border: none;
+    border-bottom: 1px solid var(--stl-color-border);
+  }
 }
 
 .stldocs-root .stldocs-input {