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

package/dist/components/index.d.ts

@@ -0,0 +1,10 @@
+import { a as Join, c as ListViewProps, d as ToggleButtonProps, f as Tooltip, i as InputProps, l as Markdown, n as Expander, o as Link, p as VirtualExpander, r as Input, s as ListView, t as Badge, u as ToggleButton } from "../primitives-BHt-BuLf.js";
+import { n as generateApiBreadcrumbs, t as SDKBreadcrumbs } from "../breadcrumbs-BaNU4WsC.js";
+import { a as MethodHeaderProps, c as MethodProps, i as MethodHeader, l as MethodRoute, n as MethodDescription, o as MethodInfo, r as MethodDescriptionProps, s as MethodInfoProps, t as Method, u as MethodRouteProps } from "../method-BKJnP-rW.js";
+import { a as PropertyTitle, c as PropertyToggleProps, i as PropertyProps, n as PropertyDescription, o as PropertyTitleProps, r as PropertyDescriptionProps, s as PropertyToggle, t as Property } from "../properties-CCbMRhSX.js";
+import { A as useStreamingResponse, C as SDKRequestTitleProps, D as useDeclarationParents, E as TransformRequestSnippetFn, O as usePropertyModel, S as SDKRequestTitle, T as SDKSnippetLanguagesType, _ as SDKMethodNotImplemented, a as ReferenceNestingContextType, b as SDKModelProps, c as SDKConstraintsProps, d as SDKIcon, f as SDKLanguageBlock, g as SDKMethodInfoContent, h as SDKMethodInfo, i as ReferenceNestingContext, k as useReferenceNesting, l as SDKDeclaration, m as SDKMethodHeader, n as PropertyModelContext, o as SDKChildren, p as SDKMethod, r as PropertyModelContextType, s as SDKConstraints, t as DeclarationParentsContextType, u as SDKExample, v as SDKMethodProps, w as SDKSnippetLanguages, x as SDKReference, y as SDKModel } from "../sdk-BengV7mg.js";
+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";
+import { a as SDKResource, c as SDKRoot, i as SDKOverviewProps, l as SDKRootProps, n as SDKMethodSummaryProps, o as SDKResourceHeader, r as SDKOverview, s as SDKResourceProps, t as SDKMethodSummary } from "../overview-iH1evPEF.js";
+import { n as SDKSidebarProps, t as SDKSidebar } from "../sdk-sidebar-CRqLm3YO.js";
+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 { Badge, DeclarationParentsContextType, Expander, Input, InputProps, Join, Link, ListView, ListViewProps, Markdown, Method, MethodDescription, MethodDescriptionProps, MethodHeader, MethodHeaderProps, MethodInfo, MethodInfoProps, MethodProps, MethodRoute, MethodRouteProps, MultiSnippets, MultiSnippetsProps, Property, PropertyDescription, PropertyDescriptionProps, PropertyModelContext, PropertyModelContextType, PropertyProps, PropertyTitle, PropertyTitleProps, PropertyToggle, PropertyToggleProps, ReferenceNestingContext, ReferenceNestingContextType, SDKBreadcrumbs, SDKChildren, SDKConstraints, SDKConstraintsProps, SDKDeclaration, SDKExample, SDKIcon, SDKLanguageBlock, SDKMethod, SDKMethodHeader, SDKMethodInfo, SDKMethodInfoContent, SDKMethodNotImplemented, SDKMethodProps, SDKMethodSummary, SDKMethodSummaryProps, SDKModel, SDKModelProps, SDKOverview, SDKOverviewProps, SDKReference, SDKRequestTitle, SDKRequestTitleProps, SDKResource, SDKResourceHeader, SDKResourceProps, SDKRoot, SDKRootProps, SDKSidebar, SDKSidebarProps, SDKSnippetLanguages, SDKSnippetLanguagesType, Snippet, SnippetButtons, SnippetCode, SnippetCodeProps, SnippetContainer, SnippetContainerProps, SnippetFooter, SnippetProps, SnippetRequestContainer, SnippetRequestContainerProps, SnippetResponse, StlSidebar, StlSidebarEntry, StlSidebarGroup, StlSidebarLink, StlSidebarProps, StlSidebarTarget, ToggleButton, ToggleButtonProps, Tooltip, TransformRequestSnippetFn, VirtualExpander, generateApiBreadcrumbs, useDeclarationParents, usePropertyModel, useReferenceNesting, useStreamingResponse };

package/dist/components/index.js

@@ -0,0 +1,72 @@
+import { t as __exportAll } from "../chunk-pbuEa-1d.js";
+import { Property, PropertyDescription, PropertyTitle, PropertyToggle } from "./properties.js";
+import { Method, MethodDescription, MethodHeader, MethodInfo, MethodRoute } from "./method.js";
+import { Badge, Expander, Input, Join, Link, ListView, Markdown, ToggleButton, Tooltip, VirtualExpander } from "./primitives.js";
+import { PropertyModelContext, ReferenceNestingContext, SDKChildren, SDKConstraints, SDKDeclaration, SDKExample, SDKIcon, SDKLanguageBlock, SDKMethod, SDKMethodHeader, SDKMethodInfo, SDKMethodInfoContent, SDKMethodNotImplemented, SDKModel, SDKReference, SDKRequestTitle, SDKSnippetLanguages, useDeclarationParents, usePropertyModel, useReferenceNesting, useStreamingResponse } from "./sdk.js";
+import { MultiSnippets, Snippet, SnippetButtons, SnippetCode, SnippetContainer, SnippetFooter, SnippetRequestContainer, SnippetResponse } from "./snippets.js";
+import { SDKMethodSummary, SDKOverview, SDKResource, SDKResourceHeader, SDKRoot } from "./overview.js";
+import { SDKBreadcrumbs, generateApiBreadcrumbs } from "./breadcrumbs.js";
+import { StlSidebar } from "./stl-sidebar.js";
+import { SDKSidebar } from "./sdk-sidebar.js";
+//#region src/components/index.ts
+var components_exports = /* @__PURE__ */ __exportAll({
+	Badge: () => Badge,
+	Expander: () => Expander,
+	Input: () => Input,
+	Join: () => Join,
+	Link: () => Link,
+	ListView: () => ListView,
+	Markdown: () => Markdown,
+	Method: () => Method,
+	MethodDescription: () => MethodDescription,
+	MethodHeader: () => MethodHeader,
+	MethodInfo: () => MethodInfo,
+	MethodRoute: () => MethodRoute,
+	MultiSnippets: () => MultiSnippets,
+	Property: () => Property,
+	PropertyDescription: () => PropertyDescription,
+	PropertyModelContext: () => PropertyModelContext,
+	PropertyTitle: () => PropertyTitle,
+	PropertyToggle: () => PropertyToggle,
+	ReferenceNestingContext: () => ReferenceNestingContext,
+	SDKBreadcrumbs: () => SDKBreadcrumbs,
+	SDKChildren: () => SDKChildren,
+	SDKConstraints: () => SDKConstraints,
+	SDKDeclaration: () => SDKDeclaration,
+	SDKExample: () => SDKExample,
+	SDKIcon: () => SDKIcon,
+	SDKLanguageBlock: () => SDKLanguageBlock,
+	SDKMethod: () => SDKMethod,
+	SDKMethodHeader: () => SDKMethodHeader,
+	SDKMethodInfo: () => SDKMethodInfo,
+	SDKMethodInfoContent: () => SDKMethodInfoContent,
+	SDKMethodNotImplemented: () => SDKMethodNotImplemented,
+	SDKMethodSummary: () => SDKMethodSummary,
+	SDKModel: () => SDKModel,
+	SDKOverview: () => SDKOverview,
+	SDKReference: () => SDKReference,
+	SDKRequestTitle: () => SDKRequestTitle,
+	SDKResource: () => SDKResource,
+	SDKResourceHeader: () => SDKResourceHeader,
+	SDKRoot: () => SDKRoot,
+	SDKSidebar: () => SDKSidebar,
+	SDKSnippetLanguages: () => SDKSnippetLanguages,
+	Snippet: () => Snippet,
+	SnippetButtons: () => SnippetButtons,
+	SnippetCode: () => SnippetCode,
+	SnippetContainer: () => SnippetContainer,
+	SnippetFooter: () => SnippetFooter,
+	SnippetRequestContainer: () => SnippetRequestContainer,
+	SnippetResponse: () => SnippetResponse,
+	StlSidebar: () => StlSidebar,
+	ToggleButton: () => ToggleButton,
+	Tooltip: () => Tooltip,
+	VirtualExpander: () => VirtualExpander,
+	generateApiBreadcrumbs: () => generateApiBreadcrumbs,
+	useDeclarationParents: () => useDeclarationParents,
+	usePropertyModel: () => usePropertyModel,
+	useReferenceNesting: () => useReferenceNesting,
+	useStreamingResponse: () => useStreamingResponse
+});
+//#endregion
+export { Badge, Expander, Input, Join, Link, ListView, Markdown, Method, MethodDescription, MethodHeader, MethodInfo, MethodRoute, MultiSnippets, Property, PropertyDescription, PropertyModelContext, PropertyTitle, PropertyToggle, ReferenceNestingContext, SDKBreadcrumbs, SDKChildren, SDKConstraints, SDKDeclaration, SDKExample, SDKIcon, SDKLanguageBlock, SDKMethod, SDKMethodHeader, SDKMethodInfo, SDKMethodInfoContent, SDKMethodNotImplemented, SDKMethodSummary, SDKModel, SDKOverview, SDKReference, SDKRequestTitle, SDKResource, SDKResourceHeader, SDKRoot, SDKSidebar, SDKSnippetLanguages, Snippet, SnippetButtons, SnippetCode, SnippetContainer, SnippetFooter, SnippetRequestContainer, SnippetResponse, StlSidebar, ToggleButton, Tooltip, VirtualExpander, generateApiBreadcrumbs, components_exports as t, useDeclarationParents, usePropertyModel, useReferenceNesting, useStreamingResponse };

package/dist/components/method.d.ts

@@ -0,0 +1,2 @@
+import { a as MethodHeaderProps, c as MethodProps, i as MethodHeader, l as MethodRoute, n as MethodDescription, o as MethodInfo, r as MethodDescriptionProps, s as MethodInfoProps, t as Method, u as MethodRouteProps } from "../method-BKJnP-rW.js";
+export { Method, MethodDescription, MethodDescriptionProps, MethodHeader, MethodHeaderProps, MethodInfo, MethodInfoProps, MethodProps, MethodRoute, MethodRouteProps };

package/dist/components/method.js

@@ -0,0 +1,94 @@
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { PropertyToggle } from "./properties.js";
+import "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import { Badge, getHttpMethod } from "@stainless-api/ui-primitives";
+import { FunctionIcon } from "@stainless-api/ui-primitives/icons";
+//#region src/components/method.tsx
+function MethodHeader({ title, badges, signature, children, level }) {
+	const Heading = level ?? "h5";
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.MethodHeader,
+		children: [
+			/* @__PURE__ */ jsx(Heading, {
+				className: style_default.MethodTitle,
+				children: title
+			}),
+			badges ? /* @__PURE__ */ jsx("div", {
+				className: style_default.MethodBadges,
+				children: badges
+			}) : null,
+			signature,
+			children
+		]
+	});
+}
+function MethodRoute({ httpMethod, endpoint, iconOnly }) {
+	const httpMethodTyped = getHttpMethod(httpMethod);
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.MethodRoute,
+		children: [httpMethod ? httpMethodTyped && /* @__PURE__ */ jsx(Badge.HTTP, {
+			method: httpMethodTyped,
+			iconOnly,
+			size: "sm"
+		}) : /* @__PURE__ */ jsx(Badge, {
+			size: "sm",
+			icon: /* @__PURE__ */ jsx(FunctionIcon, {}),
+			intent: "info",
+			children: !iconOnly && "Function"
+		}), endpoint ? /* @__PURE__ */ jsx("span", {
+			className: style_default.MethodRouteEndpoint,
+			children: endpoint
+		}) : null]
+	});
+}
+function MethodDescription({ description }) {
+	const { Markdown } = useComponents();
+	if (description) return /* @__PURE__ */ jsx("div", {
+		className: style_default.MethodDescription,
+		children: /* @__PURE__ */ jsx(Markdown, { content: description })
+	});
+}
+function MethodInfo({ children, parameters, returns }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.MethodInfo,
+		children: [
+			children ? /* @__PURE__ */ jsx("div", {
+				className: style_default.MethodContent,
+				children
+			}) : null,
+			parameters ? /* @__PURE__ */ jsxs("div", {
+				className: style_default.MethodInfoSection,
+				children: [/* @__PURE__ */ jsxs("h5", { children: ["Parameters", /* @__PURE__ */ jsx(PropertyToggle, { target: "parameters" })] }), /* @__PURE__ */ jsx("div", {
+					className: style_default.MethodParameters,
+					"data-stldocs-property-group": "parameters",
+					children: parameters
+				})]
+			}) : null,
+			returns ? /* @__PURE__ */ jsxs("div", {
+				className: style_default.MethodInfoSection,
+				children: [/* @__PURE__ */ jsxs("h5", { children: ["Returns", /* @__PURE__ */ jsx(PropertyToggle, { target: "returns" })] }), /* @__PURE__ */ jsx("div", {
+					className: style_default.MethodReturns,
+					"data-stldocs-property-group": "returns",
+					children: returns
+				})]
+			}) : null
+		]
+	});
+}
+function Method({ id, header, children, className, ...props }) {
+	return /* @__PURE__ */ jsxs("div", {
+		id,
+		className: clsx(style_default.Method, className),
+		tabIndex: 0,
+		...props,
+		children: [header, /* @__PURE__ */ jsx("div", {
+			className: style_default.MethodBody,
+			children
+		})]
+	});
+}
+//#endregion
+export { Method, MethodDescription, MethodHeader, MethodInfo, MethodRoute };

package/dist/components/overview.d.ts

@@ -0,0 +1,2 @@
+import { a as SDKResource, c as SDKRoot, i as SDKOverviewProps, l as SDKRootProps, n as SDKMethodSummaryProps, o as SDKResourceHeader, r as SDKOverview, s as SDKResourceProps, t as SDKMethodSummary } from "../overview-iH1evPEF.js";
+export { SDKMethodSummary, SDKMethodSummaryProps, SDKOverview, SDKOverviewProps, SDKResource, SDKResourceHeader, SDKResourceProps, SDKRoot, SDKRootProps };

package/dist/components/overview.js

@@ -0,0 +1,139 @@
+import { useDeclaration, useLanguage, useSpec } from "../contexts/docs.js";
+import { useLanguageComponents } from "../contexts/index.js";
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { PropertyToggle } from "./properties.js";
+import { parseStainlessPath } from "../routing.js";
+import { Markdown } from "./primitives.js";
+import { flatResources, getResourceFromSpec } from "../utils.js";
+import * as React$1 from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ChevronRight } from "lucide-react";
+//#region src/components/overview.tsx
+function SDKResourceHeader({ resource, parents }) {
+	const segments = parents?.map((parent, index) => /* @__PURE__ */ jsxs("span", {
+		className: style_default.ResourceTitleSegment,
+		children: [parent.title, index < parents.length && /* @__PURE__ */ jsx(ChevronRight, {
+			size: 16,
+			className: style_default.Icon
+		})]
+	}, parent.stainlessPath));
+	if (!segments && !resource.description) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.ResourceHeader,
+		children: [segments && /* @__PURE__ */ jsxs("h4", {
+			id: resource.stainlessPath,
+			className: style_default.ResourceTitle,
+			children: [segments, /* @__PURE__ */ jsx("span", {
+				className: style_default.ResourceTitleSegment,
+				children: resource.title
+			})]
+		}), resource.description && /* @__PURE__ */ jsx("div", {
+			className: style_default.ResourceDescription,
+			children: /* @__PURE__ */ jsx(Markdown, { content: resource.description })
+		})]
+	});
+}
+function SDKMethodSummary({ method }) {
+	const Docs = useComponents();
+	const Lang = useLanguageComponents();
+	const decl = useDeclaration(method.stainlessPath, true);
+	return /* @__PURE__ */ jsx(Docs.MethodHeader, {
+		level: "h5",
+		title: /* @__PURE__ */ jsx(Docs.Link, {
+			stainlessPath: method.stainlessPath,
+			children: method.summary || method.title
+		}),
+		signature: /* @__PURE__ */ jsx(Lang.MethodSignature, { decl }),
+		badges: method.deprecated && /* @__PURE__ */ jsx(Docs.Badge, {
+			id: "deprecated",
+			children: "Deprecated"
+		}),
+		children: /* @__PURE__ */ jsx(Docs.MethodRoute, {
+			httpMethod: method.httpMethod,
+			endpoint: method.endpoint.split(" ", 2).at(-1)
+		})
+	});
+}
+function SDKResource({ resource, parents, showModels }) {
+	const Docs = useComponents();
+	const Lang = useLanguageComponents();
+	const language = useLanguage();
+	const spec = useSpec();
+	const methods = Object.values(resource.methods).filter((method) => spec?.decls?.[language]?.[method.stainlessPath]);
+	const models = Object.values(resource.models).filter((model) => spec?.decls?.[language]?.[`${model.stainlessPath} > (schema)`]);
+	if (Lang.Resource) return /* @__PURE__ */ jsx(Lang.Resource, {
+		resource,
+		parents
+	});
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.Resource,
+		"data-stl-resource-language": language,
+		children: /* @__PURE__ */ jsxs("div", {
+			className: style_default.ResourceContent,
+			children: [
+				/* @__PURE__ */ jsx(Docs.SDKResourceHeader, {
+					resource,
+					parents
+				}),
+				methods.length > 0 && /* @__PURE__ */ jsx("div", {
+					className: style_default.ResourceContentGroup,
+					children: methods.map((method) => /* @__PURE__ */ jsx("div", {
+						className: style_default.MethodSummary,
+						children: /* @__PURE__ */ jsx(Docs.SDKMethodSummary, { method })
+					}, method.stainlessPath))
+				}),
+				showModels !== false && models.length > 0 && /* @__PURE__ */ jsxs("div", {
+					className: style_default.ResourceContentGroup,
+					"data-stldocs-property-group": "models",
+					children: [/* @__PURE__ */ jsxs("h5", {
+						className: style_default.ResourceContentGroupModelTitle,
+						children: ["Models", /* @__PURE__ */ jsx(PropertyToggle, { target: "models" })]
+					}), models.map((model) => /* @__PURE__ */ jsx(Docs.SDKModel, { model }, model.stainlessPath))]
+				})
+			]
+		})
+	});
+}
+function SDKOverview({ resource }) {
+	const { SDKResource } = useComponents();
+	const nested = React$1.useMemo(() => flatResources(resource.subresources, [resource]), [resource]);
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.Overview,
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: style_default.OverviewHeader,
+				children: /* @__PURE__ */ jsx("h1", { children: resource.title })
+			}),
+			/* @__PURE__ */ jsx(SDKResource, { resource }),
+			nested.map((props, index) => /* @__PURE__ */ jsx(SDKResource, { ...props }, index))
+		]
+	});
+}
+function SDKRoot({ stainlessPath }) {
+	const spec = useSpec();
+	const Docs = useComponents();
+	const parsed = parseStainlessPath(stainlessPath);
+	const resource = spec && getResourceFromSpec(stainlessPath, spec);
+	if (!resource || !parsed) {
+		console.warn(`Could not find resource or parsed path for '${stainlessPath}'`);
+		return null;
+	}
+	if (parsed.method) {
+		const method = resource.methods[parsed.method];
+		if (!method) {
+			console.warn(`Method '${parsed.method}' not found in resource '${resource.stainlessPath}'`);
+			return null;
+		}
+		return /* @__PURE__ */ jsx("div", {
+			className: style_default.Root,
+			children: /* @__PURE__ */ jsx(Docs.SDKMethod, { method })
+		});
+	}
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.Root,
+		children: /* @__PURE__ */ jsx(Docs.SDKOverview, { resource })
+	});
+}
+//#endregion
+export { SDKMethodSummary, SDKOverview, SDKResource, SDKResourceHeader, SDKRoot };

package/dist/components/primitives.d.ts

@@ -0,0 +1,2 @@
+import { a as Join, c as ListViewProps, d as ToggleButtonProps, f as Tooltip, i as InputProps, l as Markdown, n as Expander, o as Link, p as VirtualExpander, r as Input, s as ListView, t as Badge, u as ToggleButton } from "../primitives-BHt-BuLf.js";
+export { Badge, Expander, Input, InputProps, Join, Link, ListView, ListViewProps, Markdown, ToggleButton, ToggleButtonProps, Tooltip, VirtualExpander };

package/dist/components/primitives.js

@@ -0,0 +1,250 @@
+import { useLanguage, useSettings } from "../contexts/docs.js";
+import { useNavigation } from "../contexts/navigation.js";
+import { useRenderMarkdown } from "../contexts/markdown.js";
+import "../contexts/index.js";
+import style_default from "../style.js";
+import { generateRoute } from "../routing.js";
+import { Fragment, createContext, use, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import { MinusIcon, PlusIcon } from "lucide-react";
+//#region src/components/primitives.tsx
+function Join({ items, limit, children }) {
+	return (limit && items.length > limit + 1 ? [...items.slice(0, limit), /* @__PURE__ */ jsxs("span", {
+		className: style_default.Truncation,
+		children: [items.length - limit, " more"]
+	}, "truncation")] : items).map((item, index) => /* @__PURE__ */ jsxs(Fragment, { children: [!!index && children, item] }, `iterator:${index}`));
+}
+function Expander({ id, open, summary, virtual, muted, children }) {
+	const virtualExpanders = useSettings()?.virtualExpanders;
+	if (virtual || virtualExpanders) return /* @__PURE__ */ jsx(VirtualExpander, {
+		summary,
+		open,
+		muted,
+		id,
+		children
+	}, open ? "open" : "closed");
+	return /* @__PURE__ */ jsxs("details", {
+		className: style_default.Expander,
+		open,
+		"data-stldocs-expander-muted": muted,
+		"data-stldocs-expander-initial-state": open,
+		children: [/* @__PURE__ */ jsxs("summary", {
+			className: style_default.ExpanderSummary,
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: style_default.ExpanderSummaryIcon,
+				children: [/* @__PURE__ */ jsx(PlusIcon, {
+					size: 16,
+					strokeWidth: 1,
+					className: style_default.Icon
+				}), /* @__PURE__ */ jsx(MinusIcon, {
+					size: 16,
+					strokeWidth: 1,
+					className: style_default.Icon
+				})]
+			}), /* @__PURE__ */ jsx("div", {
+				className: style_default.ExpanderSummaryContent,
+				children: summary
+			})]
+		}), /* @__PURE__ */ jsx("div", {
+			className: style_default.ExpanderContent,
+			id,
+			children
+		})]
+	});
+}
+function VirtualExpander({ id, open: isOpen, muted, summary, children }) {
+	const [open, setOpen] = useState(isOpen ?? false);
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.Expander,
+		"data-open": open,
+		"data-stldocs-expander-muted": muted,
+		"data-stldocs-expander-initial-state": open,
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: style_default.ExpanderSummary,
+			onClick: () => setOpen(!open),
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: style_default.ExpanderSummaryIcon,
+				children: [/* @__PURE__ */ jsx(PlusIcon, {
+					size: 16,
+					className: style_default.Icon
+				}), /* @__PURE__ */ jsx(MinusIcon, {
+					size: 16,
+					className: style_default.Icon
+				})]
+			}), /* @__PURE__ */ jsx("div", {
+				className: style_default.ExpanderSummaryContent,
+				children: summary
+			})]
+		}), open && /* @__PURE__ */ jsx("div", {
+			className: style_default.ExpanderContent,
+			id,
+			children
+		})]
+	});
+}
+function Markdown({ content, style: cssStyle }) {
+	const rendered = useRenderMarkdown(content);
+	return rendered && /* @__PURE__ */ jsx("div", {
+		style: cssStyle,
+		className: clsx(style_default.Markdown, style_default.Content, "stl-ui-prose"),
+		dangerouslySetInnerHTML: { __html: rendered }
+	});
+}
+function Badge({ id, children }) {
+	return /* @__PURE__ */ jsx("span", {
+		className: style_default.Badge,
+		"data-badge-id": id,
+		children: children ?? id
+	});
+}
+const TooltipNestingContext = createContext(false);
+function Tooltip({ content, children }) {
+	if (use(TooltipNestingContext)) return children;
+	return /* @__PURE__ */ jsxs("span", {
+		className: style_default.Tooltip,
+		children: [/* @__PURE__ */ jsx("span", {
+			className: style_default.TooltipContent,
+			children: /* @__PURE__ */ jsx(TooltipNestingContext, {
+				value: true,
+				children: content
+			})
+		}), /* @__PURE__ */ jsx("span", {
+			className: style_default.TooltipHost,
+			children
+		})]
+	});
+}
+function Link({ stainlessPath, scroll = true, children, ...props }) {
+	const { basePath, onNavigate } = useNavigation();
+	const language = useLanguage();
+	const href = useMemo(() => {
+		if (props.href) return props.href;
+		if (stainlessPath && basePath) return generateRoute(basePath, language, stainlessPath);
+	}, [
+		basePath,
+		language,
+		stainlessPath,
+		props.href
+	]);
+	const handleClick = useCallback((e) => {
+		if (props.onClick) props.onClick(e);
+		if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+		if (href && stainlessPath) onNavigate?.(e, {
+			href,
+			language,
+			stainlessPath,
+			scroll
+		});
+	}, [
+		href,
+		scroll,
+		onNavigate,
+		language,
+		props,
+		stainlessPath
+	]);
+	if (!href) return children;
+	return /* @__PURE__ */ jsx("a", {
+		href,
+		onClick: handleClick,
+		...props,
+		children
+	});
+}
+function Input({ left, right, ref, className, ...props }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: clsx(style_default.Input, props.disabled && style_default.InputDisabled, className),
+		children: [
+			left,
+			/* @__PURE__ */ jsx("input", {
+				...props,
+				ref,
+				className: style_default.InputTextField
+			}),
+			right
+		]
+	});
+}
+function ToggleButton({ children, selected, ref, ...props }) {
+	return /* @__PURE__ */ jsx("button", {
+		...props,
+		ref,
+		className: style_default.ToggleButton,
+		"data-stldocs-toggle-selected": selected,
+		children
+	});
+}
+function ListView({ items, itemDelegate, onSelectListItem, ...rest }) {
+	const [selectedIndex, setSelectedIndex] = useState(0);
+	const [keyboardIndex, setKeyboardIndex] = useState(0);
+	const listRef = useRef(null);
+	const itemRef = useRef(null);
+	const handleSelect = useCallback(() => {
+		const item = items[selectedIndex];
+		if (item) onSelectListItem?.(item);
+	}, [
+		items,
+		selectedIndex,
+		onSelectListItem
+	]);
+	useEffect(() => {
+		const ac = new AbortController();
+		document.addEventListener("keydown", (ev) => {
+			switch (ev.key) {
+				case "ArrowUp": {
+					ev.preventDefault();
+					const value = Math.max(0, selectedIndex - 1);
+					setSelectedIndex(value);
+					setKeyboardIndex(value);
+					break;
+				}
+				case "ArrowDown": {
+					ev.preventDefault();
+					const value = Math.min(items.length, selectedIndex + 1);
+					setSelectedIndex(value);
+					setKeyboardIndex(value);
+					break;
+				}
+				case "Enter":
+					ev.preventDefault();
+					handleSelect();
+					break;
+			}
+		}, { signal: ac.signal });
+		return () => ac.abort();
+	}, [
+		items,
+		selectedIndex,
+		handleSelect
+	]);
+	useEffect(() => {
+		if (!keyboardIndex || !itemRef.current || !listRef.current) {
+			listRef?.current?.scroll(0, 0);
+			return;
+		}
+		const selectedBounds = itemRef.current.getBoundingClientRect();
+		const listBounds = listRef.current.getBoundingClientRect();
+		if (selectedBounds.top < listBounds.top || selectedBounds.bottom > listBounds.bottom) itemRef.current.scrollIntoView({ block: "nearest" });
+	}, [
+		keyboardIndex,
+		items,
+		listRef
+	]);
+	return /* @__PURE__ */ jsx("div", {
+		ref: listRef,
+		className: style_default.ListView,
+		tabIndex: 0,
+		...rest,
+		children: items.map((item, index) => /* @__PURE__ */ jsx("div", {
+			ref: index === selectedIndex ? itemRef : null,
+			className: style_default.ListViewItem,
+			"data-stldocs-listview-selected": index === selectedIndex,
+			onClick: handleSelect,
+			onMouseEnter: () => setSelectedIndex(index),
+			children: itemDelegate(item, index === selectedIndex)
+		}, index))
+	});
+}
+//#endregion
+export { Badge, Expander, Input, Join, Link, ListView, Markdown, ToggleButton, Tooltip, VirtualExpander };

package/dist/components/properties.d.ts

@@ -0,0 +1,2 @@
+import { a as PropertyTitle, c as PropertyToggleProps, i as PropertyProps, n as PropertyDescription, o as PropertyTitleProps, r as PropertyDescriptionProps, s as PropertyToggle, t as Property } from "../properties-CCbMRhSX.js";
+export { Property, PropertyDescription, PropertyDescriptionProps, PropertyProps, PropertyTitle, PropertyTitleProps, PropertyToggle, PropertyToggleProps };