@stainless-api/docs-ui 0.1.0-beta.5 → 0.1.0-beta.50

package/dist/markdown/index.js

@@ -0,0 +1,104 @@
+import "../docs-CXqi26jB.js";
+import "../component-generics-B6Fn47Mz.js";
+import "../navigation-C5TN0SgC.js";
+import "../markdown-CxdeWgjV.js";
+import "../contexts-p3rRZDlM.js";
+import "../use-components-RWQbviGq.js";
+import "../properties-jlGW3USi.js";
+import "../method-CE08mUME.js";
+import "../primitives-BIWfwN5L.js";
+import "../icons-Ckod9aod.js";
+import "../sdk-CSCbbn3O.js";
+import "../snippets-BQLXEIf6.js";
+import "../overview-S2hUqPXA.js";
+import "../breadcrumbs-nSFZO5Gf.js";
+import "../sidebar-CWyvCrJ0.js";
+import "../components-D7M-BwNI.js";
+import "../typescript-DXG9psK3.js";
+import "../java-BbjF_oUI.js";
+import "../go-1c3S5ETL.js";
+import "../python-USOwFDv_.js";
+import "../ruby-CSvGbSLe.js";
+import "../http-2QNWXH9t.js";
+import "../csharp-CDSxfCZE.js";
+import "../languages-BCYZjzuS.js";
+import "../component-DRO8kQSp.js";
+import { a as item, c as parse, l as strong, n as fence, o as list, r as heading, s as paragraph, t as code, u as text } from "../md-oM2tUaCA.js";
+import { n as getSnippet, r as stripMarkup, t as getDecl } from "../utils-CqnL9Fc3.js";
+import { n as methodSignature, r as printer_exports, t as declaration$1 } from "../printer-bNxiG6UB.js";
+import Markdoc from "@markdoc/markdoc";
+
+//#region src/markdown/index.ts
+function declaration(env, decl) {
+	const content = declaration$1(env.language, decl);
+	return paragraph(code(stripMarkup(content)));
+}
+function renderChildren(env, children, nesting = []) {
+	return list(...children.map((child) => renderDecl(env, child, nesting)));
+}
+function renderDecl(env, path, nesting = []) {
+	const decl = getDecl(env, path);
+	const item$1 = item(declaration(env, decl));
+	const hasChildren = "children" in decl && decl.children && decl.children.length > 0;
+	const showModelProps = !("modelPath" in decl && decl["modelPath"]) || env.options.includeModelProperties;
+	if ("docstring" in decl && decl.docstring) item$1.children.push(...parse(decl.docstring));
+	if (hasChildren && showModelProps && !nesting.includes(path)) item$1.push(renderChildren(env, decl.children ?? [], [...nesting, path]));
+	return item$1;
+}
+function renderMethod(env, method) {
+	const decl = getDecl(env, method.stainlessPath);
+	if (!decl) return [paragraph(text("The method "), code(method.name), text(" is not available in this language."))];
+	const signature = methodSignature(env.language, decl);
+	const [httpMethod, endpoint] = method.endpoint.split(" ");
+	const output = [
+		heading(2, method.title),
+		...env.language === "http" ? [] : [paragraph(code(stripMarkup(signature)))],
+		paragraph(strong(text(httpMethod)), text(" "), code(endpoint))
+	];
+	if (method.description) output.push(...parse(method.description));
+	if (env.language === "http") {
+		const p = "paramsChildren" in decl && typeof decl.paramsChildren === "object" ? decl.paramsChildren : {};
+		for (const [location, value] of Object.entries(p)) {
+			if (value.length < 1) continue;
+			output.push(heading(3, [
+				text(location.at(0)?.toUpperCase() ?? ""),
+				text(location.slice(1)),
+				text(" Parameters")
+			]), renderChildren(env, value));
+		}
+		const bp = "bodyParamsChildren" in decl ? decl.bodyParamsChildren?.["application/json"] : [];
+		if (bp && bp.length > 0) output.push(heading(3, "Body Parameters"), renderChildren(env, bp));
+	}
+	if ("paramsChildren" in decl && Array.isArray(decl.paramsChildren) && decl.paramsChildren.length > 0) output.push(heading(3, "Parameters"), renderChildren(env, decl.paramsChildren));
+	if ("responseChildren" in decl && decl.responseChildren && decl.responseChildren.length > 0) output.push(heading(3, "Returns"), renderChildren(env, decl.responseChildren));
+	const snippet = getSnippet(env, method.stainlessPath);
+	if (snippet) output.push(heading(3, "Example"), fence(env.language, snippet));
+	return output;
+}
+function renderModel(env, model) {
+	return [heading(3, model.title), list(renderDecl(env, `${model.stainlessPath} > (schema)`))];
+}
+function renderResource(env, resource) {
+	const methods = Object.values(resource.methods).filter((method) => getDecl(env, method.stainlessPath)).flatMap((method) => renderMethod(env, method));
+	const models = Object.values(resource.models).filter((model) => getDecl(env, `${model.stainlessPath} > (schema)`)).flatMap((model) => renderModel(env, model));
+	const doc = [heading(1, resource.title), ...methods];
+	if (models.length > 0) doc.push(heading(2, "Domain Types"), ...models);
+	if (!env.options.renderNestedResources) return doc;
+	const children = Object.values(resource.subresources ?? {}).flatMap((resource$1) => renderResource(env, resource$1));
+	return [...doc, ...children];
+}
+function render(env, node) {
+	switch (node.kind) {
+		case "resource": return renderResource(env, node);
+		case "http_method": return renderMethod(env, node);
+		case "model": return renderModel(env, node);
+	}
+}
+function renderMarkdown(env, node) {
+	const content = render(env, node);
+	const doc = new Markdoc.Ast.Node("document", {}, content);
+	return Markdoc.format(doc);
+}
+
+//#endregion
+export { declaration, printer_exports as printer, render, renderMarkdown };

package/dist/markdown/md.d.ts

@@ -0,0 +1,15 @@
+import { Node } from "@markdoc/markdoc";
+
+//#region src/markdown/md.d.ts
+declare function heading(level: number, children: string | Node[]): Node;
+declare function text(content: string): Node;
+declare function code(content: string): Node;
+declare function paragraph(...children: Node[]): Node;
+declare function list(...children: Node[]): Node;
+declare function item(...children: Node[]): Node;
+declare function strong(...children: Node[]): Node;
+declare function inline(...children: Node[]): Node;
+declare function fence(language: string, content: string): Node;
+declare function parse(content: string): Node[];
+//#endregion
+export { code, fence, heading, inline, item, list, paragraph, parse, strong, text };

package/dist/markdown/md.js

@@ -0,0 +1,3 @@
+import { a as item, c as parse, i as inline, l as strong, n as fence, o as list, r as heading, s as paragraph, t as code, u as text } from "../md-oM2tUaCA.js";
+
+export { code, fence, heading, inline, item, list, paragraph, parse, strong, text };

package/dist/markdown/printer.d.ts

@@ -0,0 +1,2 @@
+import { a as typeName, i as type, n as methodSignature, t as declaration } from "../printer-DBw4S_Jn.js";
+export { declaration, methodSignature, type, typeName };

package/dist/markdown/printer.js

@@ -0,0 +1,28 @@
+import "../docs-CXqi26jB.js";
+import "../component-generics-B6Fn47Mz.js";
+import "../navigation-C5TN0SgC.js";
+import "../markdown-CxdeWgjV.js";
+import "../contexts-p3rRZDlM.js";
+import "../use-components-RWQbviGq.js";
+import "../properties-jlGW3USi.js";
+import "../method-CE08mUME.js";
+import "../primitives-BIWfwN5L.js";
+import "../icons-Ckod9aod.js";
+import "../sdk-CSCbbn3O.js";
+import "../snippets-BQLXEIf6.js";
+import "../overview-S2hUqPXA.js";
+import "../breadcrumbs-nSFZO5Gf.js";
+import "../sidebar-CWyvCrJ0.js";
+import "../components-D7M-BwNI.js";
+import "../typescript-DXG9psK3.js";
+import "../java-BbjF_oUI.js";
+import "../go-1c3S5ETL.js";
+import "../python-USOwFDv_.js";
+import "../ruby-CSvGbSLe.js";
+import "../http-2QNWXH9t.js";
+import "../csharp-CDSxfCZE.js";
+import "../languages-BCYZjzuS.js";
+import "../component-DRO8kQSp.js";
+import { a as typeName, i as type, n as methodSignature, t as declaration } from "../printer-bNxiG6UB.js";
+
+export { declaration, methodSignature, type, typeName };

package/dist/markdown/utils.d.ts

@@ -0,0 +1,3 @@
+import "../sdk-BwXeHS3_.js";
+import { i as stripMarkup, n as getDecl, r as getSnippet, t as EnvironmentType } from "../utils-_AEBNJhG.js";
+export { EnvironmentType, getDecl, getSnippet, stripMarkup };

package/dist/markdown/utils.js

@@ -0,0 +1,3 @@
+import { n as getSnippet, r as stripMarkup, t as getDecl } from "../utils-CqnL9Fc3.js";
+
+export { getDecl, getSnippet, stripMarkup };

package/dist/markdown-CxdeWgjV.js

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

package/dist/markdown-DeSSIANr.d.ts

@@ -0,0 +1,22 @@
+import * as React$1 from "react";
+import * as react_jsx_runtime12 from "react/jsx-runtime";
+
+//#region src/contexts/markdown.d.ts
+type MarkdownContext = {
+  highlight: (content: string, language: string) => string | Promise<string>;
+  render: (content: string) => string | Promise<string>;
+};
+declare const MarkdownContext: React$1.Context<MarkdownContext>;
+declare const useMarkdownContext: () => MarkdownContext;
+declare function useRenderMarkdown(content?: string): string | undefined;
+declare function useHighlight(content: string, language?: string): string;
+type MarkdownProviderProps = MarkdownContext & {
+  children: React$1.ReactNode;
+};
+declare function MarkdownProvider({
+  render,
+  highlight,
+  children
+}: MarkdownProviderProps): react_jsx_runtime12.JSX.Element;
+//#endregion
+export { useMarkdownContext as a, useHighlight as i, MarkdownProvider as n, useRenderMarkdown as o, MarkdownProviderProps as r, MarkdownContext as t };

package/dist/markdown-OuUthjwK.d.ts

@@ -0,0 +1,22 @@
+import * as React$1 from "react";
+import * as react_jsx_runtime66 from "react/jsx-runtime";
+
+//#region src/contexts/markdown.d.ts
+type MarkdownContext = {
+  highlight: (content: string, language: string) => string | Promise<string>;
+  render: (content: string) => string | Promise<string>;
+};
+declare const MarkdownContext: React$1.Context<MarkdownContext>;
+declare const useMarkdownContext: () => MarkdownContext;
+declare function useRenderMarkdown(content?: string): string | undefined;
+declare function useHighlight(content: string, language?: string): string;
+type MarkdownProviderProps = MarkdownContext & {
+  children: React$1.ReactNode;
+};
+declare function MarkdownProvider({
+  render,
+  highlight,
+  children
+}: MarkdownProviderProps): react_jsx_runtime66.JSX.Element;
+//#endregion
+export { useMarkdownContext as a, useHighlight as i, MarkdownProvider as n, useRenderMarkdown as o, MarkdownProviderProps as r, MarkdownContext as t };

package/dist/md-oM2tUaCA.js

@@ -0,0 +1,41 @@
+import Markdoc from "@markdoc/markdoc";
+
+//#region src/markdown/md.ts
+function heading(level, children) {
+	const content = inline(...typeof children === "string" ? [text(children)] : children);
+	return new Markdoc.Ast.Node("heading", { level }, [content]);
+}
+function text(content) {
+	return new Markdoc.Ast.Node("text", { content });
+}
+function code(content) {
+	return new Markdoc.Ast.Node("code", { content });
+}
+function paragraph(...children) {
+	const inline$1 = new Markdoc.Ast.Node("inline", {}, children);
+	return new Markdoc.Ast.Node("paragraph", {}, [inline$1]);
+}
+function list(...children) {
+	return new Markdoc.Ast.Node("list", { ordered: false }, children);
+}
+function item(...children) {
+	return new Markdoc.Ast.Node("item", {}, children);
+}
+function strong(...children) {
+	return new Markdoc.Ast.Node("strong", {}, children);
+}
+function inline(...children) {
+	return new Markdoc.Ast.Node("inline", {}, children);
+}
+function fence(language, content) {
+	return new Markdoc.Ast.Node("fence", {
+		language,
+		content
+	});
+}
+function parse(content) {
+	return Markdoc.parse(content).children;
+}
+
+//#endregion
+export { item as a, parse as c, inline as i, strong as l, fence as n, list as o, heading as r, paragraph as s, code as t, text as u };

package/dist/method-BiXJltKa.d.ts

@@ -0,0 +1,71 @@
+import * as React$1 from "react";
+import { ReactNode } from "react";
+import * as react_jsx_runtime78 from "react/jsx-runtime";
+import { LucideIcon } from "lucide-react";
+
+//#region src/components/method.d.ts
+declare const HttpMethods: string[];
+type HTTPMethod = (typeof HttpMethods)[number];
+declare const HttpMethodIcons: Record<HTTPMethod, LucideIcon>;
+type MethodIconProps = {
+  httpMethod?: string;
+  showName?: boolean;
+};
+declare function MethodIconBadge({
+  httpMethod,
+  showName
+}: MethodIconProps): react_jsx_runtime78.JSX.Element | null;
+type MethodHeaderProps = {
+  title: ReactNode;
+  level?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5';
+  signature?: ReactNode;
+  badges?: ReactNode;
+  children?: ReactNode;
+};
+declare function MethodHeader({
+  title,
+  badges,
+  signature,
+  children,
+  level
+}: MethodHeaderProps): react_jsx_runtime78.JSX.Element;
+type MethodRouteProps = {
+  httpMethod?: string;
+  endpoint?: string | ReactNode;
+  iconOnly?: boolean;
+};
+declare function MethodRoute({
+  httpMethod,
+  endpoint,
+  iconOnly
+}: MethodRouteProps): react_jsx_runtime78.JSX.Element;
+type MethodDescriptionProps = {
+  description?: string;
+};
+declare function MethodDescription({
+  description
+}: MethodDescriptionProps): react_jsx_runtime78.JSX.Element | undefined;
+type MethodInfoProps = {
+  children?: ReactNode;
+  parameters?: ReactNode;
+  returns?: ReactNode;
+};
+declare function MethodInfo({
+  children,
+  parameters,
+  returns
+}: MethodInfoProps): react_jsx_runtime78.JSX.Element;
+type MethodProps = {
+  id?: string;
+  header?: ReactNode;
+  children?: ReactNode;
+} & React$1.HTMLProps<HTMLDivElement>;
+declare function Method({
+  id,
+  header,
+  children,
+  className,
+  ...props
+}: MethodProps): react_jsx_runtime78.JSX.Element;
+//#endregion
+export { MethodDescription as a, MethodHeaderProps as c, MethodInfo as d, MethodInfoProps as f, MethodRouteProps as h, Method as i, MethodIconBadge as l, MethodRoute as m, HttpMethodIcons as n, MethodDescriptionProps as o, MethodProps as p, HttpMethods as r, MethodHeader as s, HTTPMethod as t, MethodIconProps as u };

package/dist/method-CE08mUME.js

@@ -0,0 +1,115 @@
+import { t as useComponents } from "./use-components-RWQbviGq.js";
+import { t as style_default } from "./style-gnVEeXFj.js";
+import { i as PropertyToggle } from "./properties-jlGW3USi.js";
+import * as React$1 from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ArrowDownLeft, ArrowUpRight, X } from "lucide-react";
+import clsx from "clsx";
+
+//#region src/components/method.tsx
+const HttpMethods = [
+	"get",
+	"head",
+	"put",
+	"delete",
+	"post",
+	"patch"
+];
+const HttpMethodIcons = {
+	get: ArrowDownLeft,
+	put: ArrowUpRight,
+	post: ArrowUpRight,
+	patch: ArrowUpRight,
+	delete: X
+};
+function MethodIconBadge({ httpMethod, showName }) {
+	if (!httpMethod || !HttpMethods.includes(httpMethod)) return null;
+	return /* @__PURE__ */ jsxs("span", {
+		className: clsx(style_default.MethodRouteHttpMethod, style_default.MethodRouteHttpMethodIconOnly),
+		"data-method": httpMethod,
+		children: [HttpMethodIcons[httpMethod] && React$1.createElement(HttpMethodIcons[httpMethod], {
+			size: 14,
+			strokeWidth: 3,
+			className: style_default.Icon
+		}), showName && httpMethod]
+	});
+}
+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
+			}),
+			signature,
+			children
+		]
+	});
+}
+function MethodRoute({ httpMethod, endpoint, iconOnly }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.MethodRoute,
+		children: [/* @__PURE__ */ jsx(MethodIconBadge, {
+			httpMethod,
+			showName: !iconOnly
+		}), endpoint && /* @__PURE__ */ jsx("span", {
+			className: style_default.MethodRouteEndpoint,
+			children: endpoint
+		})]
+	});
+}
+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
+			}),
+			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
+				})]
+			}),
+			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
+				})]
+			})
+		]
+	});
+}
+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 { MethodHeader as a, MethodRoute as c, MethodDescription as i, HttpMethods as n, MethodIconBadge as o, Method as r, MethodInfo as s, HttpMethodIcons as t };

package/dist/method-DQ3lDoTM.d.ts

@@ -0,0 +1,71 @@
+import * as React$1 from "react";
+import { ReactNode } from "react";
+import * as react_jsx_runtime14 from "react/jsx-runtime";
+import { LucideIcon } from "lucide-react";
+
+//#region src/components/method.d.ts
+declare const HttpMethods: string[];
+type HTTPMethod = (typeof HttpMethods)[number];
+declare const HttpMethodIcons: Record<HTTPMethod, LucideIcon>;
+type MethodIconProps = {
+  httpMethod?: string;
+  showName?: boolean;
+};
+declare function MethodIconBadge({
+  httpMethod,
+  showName
+}: MethodIconProps): react_jsx_runtime14.JSX.Element | null;
+type MethodHeaderProps = {
+  title: ReactNode;
+  level?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5';
+  signature?: ReactNode;
+  badges?: ReactNode;
+  children?: ReactNode;
+};
+declare function MethodHeader({
+  title,
+  badges,
+  signature,
+  children,
+  level
+}: MethodHeaderProps): react_jsx_runtime14.JSX.Element;
+type MethodRouteProps = {
+  httpMethod?: string;
+  endpoint?: string | ReactNode;
+  iconOnly?: boolean;
+};
+declare function MethodRoute({
+  httpMethod,
+  endpoint,
+  iconOnly
+}: MethodRouteProps): react_jsx_runtime14.JSX.Element;
+type MethodDescriptionProps = {
+  description?: string;
+};
+declare function MethodDescription({
+  description
+}: MethodDescriptionProps): react_jsx_runtime14.JSX.Element | undefined;
+type MethodInfoProps = {
+  children?: ReactNode;
+  parameters?: ReactNode;
+  returns?: ReactNode;
+};
+declare function MethodInfo({
+  children,
+  parameters,
+  returns
+}: MethodInfoProps): react_jsx_runtime14.JSX.Element;
+type MethodProps = {
+  id?: string;
+  header?: ReactNode;
+  children?: ReactNode;
+} & React$1.HTMLProps<HTMLDivElement>;
+declare function Method({
+  id,
+  header,
+  children,
+  className,
+  ...props
+}: MethodProps): react_jsx_runtime14.JSX.Element;
+//#endregion
+export { MethodDescription as a, MethodHeaderProps as c, MethodInfo as d, MethodInfoProps as f, MethodRouteProps as h, Method as i, MethodIconBadge as l, MethodRoute as m, HttpMethodIcons as n, MethodDescriptionProps as o, MethodProps as p, HttpMethods as r, MethodHeader as s, HTTPMethod as t, MethodIconProps as u };

package/dist/navigation-BX8nuda9.d.ts

@@ -0,0 +1,29 @@
+import { t as DocsLanguage } from "./routing-CMqh1cTZ.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime13 from "react/jsx-runtime";
+
+//#region src/contexts/navigation.d.ts
+type NavigationHandler = (ev: React$1.MouseEvent | null, opts: {
+  href: string;
+  language: DocsLanguage;
+  stainlessPath: string;
+  scroll: boolean;
+}) => void;
+type NavigationContextType = {
+  basePath?: string;
+  selectedPath?: string;
+  navigationPath?: string[];
+  onNavigate?: NavigationHandler;
+};
+declare function useNavigation(): NavigationContextType;
+type NavigationProviderProps = NavigationContextType & {
+  children: React$1.ReactNode;
+};
+declare function NavigationProvider({
+  basePath,
+  selectedPath,
+  onNavigate,
+  children
+}: NavigationProviderProps): react_jsx_runtime13.JSX.Element;
+//#endregion
+export { useNavigation as a, NavigationProviderProps as i, NavigationHandler as n, NavigationProvider as r, NavigationContextType as t };

package/dist/navigation-C5TN0SgC.js

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

package/dist/navigation-CWDfzVoR.d.ts

@@ -0,0 +1,29 @@
+import { t as DocsLanguage } from "./routing-CMqh1cTZ.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime27 from "react/jsx-runtime";
+
+//#region src/contexts/navigation.d.ts
+type NavigationHandler = (ev: React$1.MouseEvent | null, opts: {
+  href: string;
+  language: DocsLanguage;
+  stainlessPath: string;
+  scroll: boolean;
+}) => void;
+type NavigationContextType = {
+  basePath?: string;
+  selectedPath?: string;
+  navigationPath?: string[];
+  onNavigate?: NavigationHandler;
+};
+declare function useNavigation(): NavigationContextType;
+type NavigationProviderProps = NavigationContextType & {
+  children: React$1.ReactNode;
+};
+declare function NavigationProvider({
+  basePath,
+  selectedPath,
+  onNavigate,
+  children
+}: NavigationProviderProps): react_jsx_runtime27.JSX.Element;
+//#endregion
+export { useNavigation as a, NavigationProviderProps as i, NavigationHandler as n, NavigationProvider as r, NavigationContextType as t };