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

package/dist/primitives-VtUGoYwX.d.ts

@@ -0,0 +1,105 @@
+import * as react0 from "react";
+import { ReactNode } from "react";
+import * as react_jsx_runtime53 from "react/jsx-runtime";
+
+//#region src/components/primitives.d.ts
+type JoinProps = {
+  items: ReactNode[];
+  limit?: number;
+  children: ReactNode;
+};
+declare function Join({
+  items,
+  limit,
+  children
+}: JoinProps): react_jsx_runtime53.JSX.Element[];
+type ExpanderProps = {
+  id?: string;
+  open?: boolean;
+  summary: ReactNode;
+  virtual?: boolean;
+  muted?: boolean;
+  children?: ReactNode;
+};
+declare function Expander({
+  id,
+  open,
+  summary,
+  virtual,
+  muted,
+  children
+}: ExpanderProps): react_jsx_runtime53.JSX.Element;
+declare function VirtualExpander({
+  id,
+  open: isOpen,
+  muted,
+  summary,
+  children
+}: Omit<ExpanderProps, 'virtual'>): react_jsx_runtime53.JSX.Element;
+declare function Markdown({
+  content
+}: {
+  content: string;
+}): "" | react_jsx_runtime53.JSX.Element | undefined;
+type BadgeProps = {
+  id: string;
+  children?: ReactNode;
+};
+declare function Badge({
+  id,
+  children
+}: BadgeProps): react_jsx_runtime53.JSX.Element;
+type TooltipProps = {
+  content: ReactNode;
+  children: ReactNode;
+};
+declare function Tooltip({
+  content,
+  children
+}: TooltipProps): string | number | bigint | boolean | react_jsx_runtime53.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react0.ReactPortal | react0.ReactElement<unknown, string | react0.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
+type LinkProps = {
+  stainlessPath: string;
+  scroll?: boolean;
+  children?: ReactNode;
+} & React.HTMLProps<HTMLAnchorElement>;
+declare function Link({
+  stainlessPath,
+  scroll,
+  children,
+  ...props
+}: LinkProps): string | number | bigint | boolean | react_jsx_runtime53.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react0.ReactPortal | react0.ReactElement<unknown, string | react0.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
+type InputProps = {
+  left?: ReactNode;
+  right?: ReactNode;
+  ref?: React.Ref<HTMLInputElement>;
+} & React.InputHTMLAttributes<HTMLInputElement>;
+declare function Input({
+  left,
+  right,
+  ref,
+  className,
+  ...props
+}: InputProps): react_jsx_runtime53.JSX.Element;
+type ToggleButtonProps = {
+  children?: ReactNode;
+  selected?: boolean;
+} & React.ComponentProps<'button'>;
+declare function ToggleButton({
+  children,
+  selected,
+  ref,
+  ...props
+}: ToggleButtonProps): react_jsx_runtime53.JSX.Element;
+type ListViewProps<TItem> = {
+  items: Array<TItem>;
+  itemDelegate: (item: TItem, selected: boolean) => React.ReactNode;
+  onSelectListItem?: (item: TItem) => void;
+} & React.HTMLAttributes<HTMLDivElement>;
+declare function ListView<TItem>({
+  items,
+  itemDelegate,
+  onSelectListItem,
+  ...rest
+}: ListViewProps<TItem>): react_jsx_runtime53.JSX.Element;
+//#endregion
+export { Join as a, ListViewProps as c, ToggleButtonProps as d, Tooltip as f, InputProps as i, Markdown as l, Expander as n, Link as o, VirtualExpander as p, Input as r, ListView as s, Badge as t, ToggleButton as u };

package/dist/properties-Bun4nfUE.d.ts

@@ -0,0 +1,54 @@
+import { ReactNode } from "react";
+import * as react_jsx_runtime16 from "react/jsx-runtime";
+
+//#region src/components/properties.d.ts
+type PropertyToggleProps = {
+  target: string;
+};
+declare function PropertyToggle({
+  target
+}: PropertyToggleProps): react_jsx_runtime16.JSX.Element;
+type PropertyDescriptionProps = {
+  description?: string;
+};
+declare function PropertyDescription({
+  description
+}: PropertyDescriptionProps): react_jsx_runtime16.JSX.Element | undefined;
+type PropertyTitleProps = {
+  title?: string;
+};
+declare function PropertyTitle({
+  title
+}: PropertyTitleProps): react_jsx_runtime16.JSX.Element | undefined;
+type PropertyProps = {
+  id?: string;
+  name?: ReactNode;
+  typeName?: ReactNode;
+  badges?: ReactNode;
+  type?: ReactNode;
+  description?: string;
+  title?: string;
+  expand?: boolean;
+  deprecated?: boolean | string;
+  additional?: ReactNode;
+  declaration?: ReactNode;
+  constraints?: ReactNode;
+  children?: ReactNode;
+};
+declare function Property({
+  id,
+  name,
+  typeName,
+  badges,
+  type,
+  declaration,
+  description,
+  title,
+  deprecated,
+  expand,
+  additional,
+  constraints,
+  children
+}: PropertyProps): react_jsx_runtime16.JSX.Element;
+//#endregion
+export { PropertyTitle as a, PropertyToggleProps as c, PropertyProps as i, PropertyDescription as n, PropertyTitleProps as o, PropertyDescriptionProps as r, PropertyToggle as s, Property as t };

package/dist/properties-DGL2J11L.js

@@ -0,0 +1,131 @@
+import { a as useLanguage, s as useSettings } from "./docs-Di94viZV.js";
+import { t as useComponents } from "./use-components-BUz3GbO4.js";
+import { t as style_default } from "./style-LwfvXElj.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { ArrowDownWideNarrowIcon, ArrowUpNarrowWideIcon } from "lucide-react";
+
+//#region src/components/properties.tsx
+function PropertyToggle({ target }) {
+	return /* @__PURE__ */ jsxs("span", {
+		className: style_default.ExpandToggle,
+		"data-stldocs-property-toggle-expanded": "false",
+		"data-stldocs-property-toggle-target": target,
+		children: [/* @__PURE__ */ jsxs("span", {
+			className: style_default.ExpandToggleContent,
+			children: ["Expand ", /* @__PURE__ */ jsx(ArrowDownWideNarrowIcon, {
+				className: style_default.Icon,
+				size: 16
+			})]
+		}), /* @__PURE__ */ jsxs("span", {
+			className: style_default.ExpandToggleContent,
+			children: ["Collapse ", /* @__PURE__ */ jsx(ArrowUpNarrowWideIcon, {
+				className: style_default.Icon,
+				size: 16
+			})]
+		})]
+	});
+}
+function PropertyDescription({ description }) {
+	const { Markdown } = useComponents();
+	if (description) return /* @__PURE__ */ jsx("div", {
+		className: style_default.PropertyDescription,
+		children: /* @__PURE__ */ jsx(Markdown, { content: description })
+	});
+}
+function PropertyTitle({ title }) {
+	const { Markdown } = useComponents();
+	if (title) return /* @__PURE__ */ jsx("div", {
+		className: style_default.PropertyTitle,
+		children: /* @__PURE__ */ jsx(Markdown, { content: title })
+	});
+}
+function Property({ id, name, typeName, badges, type, declaration, description, title, deprecated, expand, additional, constraints, children }) {
+	const Docs = useComponents();
+	const language = useLanguage();
+	const properties = useSettings()?.properties;
+	const { collapseDescription, showTitle } = properties ?? {};
+	const types = properties?.types;
+	const textContent = /* @__PURE__ */ jsxs(Fragment, { children: [
+		typeof deprecated === "string" && /* @__PURE__ */ jsx("div", {
+			className: style_default.PropertyDeprecatedMessage,
+			children: deprecated
+		}),
+		description && /* @__PURE__ */ jsx(Docs.PropertyDescription, { description }),
+		constraints && /* @__PURE__ */ jsx("div", {
+			className: style_default.PropertyContent,
+			children: constraints
+		})
+	] });
+	const rich = /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsxs("div", {
+			className: style_default.PropertyDeclaration,
+			children: [
+				deprecated && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyDeprecated,
+					children: "Deprecated"
+				}),
+				declaration,
+				badges && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyBadges,
+					children: badges
+				})
+			]
+		}),
+		title && showTitle && /* @__PURE__ */ jsx(Docs.PropertyTitle, { title }),
+		collapseDescription === false ? textContent : null
+	] });
+	const simple = /* @__PURE__ */ jsxs(Fragment, { children: [
+		name && /* @__PURE__ */ jsxs("div", {
+			className: style_default.PropertyHeader,
+			children: [
+				deprecated && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyDeprecated,
+					children: "Deprecated"
+				}),
+				name && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyName,
+					children: name
+				}),
+				typeName && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyTypeName,
+					children: typeName
+				}),
+				badges && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyBadges,
+					children: badges
+				})
+			]
+		}),
+		type && /* @__PURE__ */ jsx("div", {
+			className: style_default.PropertyType,
+			children: type
+		}),
+		title && showTitle && /* @__PURE__ */ jsx(Docs.PropertyTitle, { title }),
+		collapseDescription === false ? textContent : null
+	] });
+	const content = /* @__PURE__ */ jsx("div", {
+		id,
+		className: style_default.PropertyInfo,
+		children: types === "simple" ? simple : rich
+	});
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.Property,
+		"data-stldocs-language": language,
+		children: children || collapseDescription !== false && description ? /* @__PURE__ */ jsxs(Docs.Expander, {
+			summary: content,
+			muted: !children,
+			open: expand,
+			children: [
+				collapseDescription !== false ? textContent : null,
+				additional,
+				children && /* @__PURE__ */ jsx("div", {
+					className: style_default.PropertyChildren,
+					children
+				})
+			]
+		}) : content
+	});
+}
+
+//#endregion
+export { PropertyToggle as i, PropertyDescription as n, PropertyTitle as r, Property as t };

package/dist/properties-ZOIqpkET.d.ts

@@ -0,0 +1,54 @@
+import { ReactNode } from "react";
+import * as react_jsx_runtime46 from "react/jsx-runtime";
+
+//#region src/components/properties.d.ts
+type PropertyToggleProps = {
+  target: string;
+};
+declare function PropertyToggle({
+  target
+}: PropertyToggleProps): react_jsx_runtime46.JSX.Element;
+type PropertyDescriptionProps = {
+  description?: string;
+};
+declare function PropertyDescription({
+  description
+}: PropertyDescriptionProps): react_jsx_runtime46.JSX.Element | undefined;
+type PropertyTitleProps = {
+  title?: string;
+};
+declare function PropertyTitle({
+  title
+}: PropertyTitleProps): react_jsx_runtime46.JSX.Element | undefined;
+type PropertyProps = {
+  id?: string;
+  name?: ReactNode;
+  typeName?: ReactNode;
+  badges?: ReactNode;
+  type?: ReactNode;
+  description?: string;
+  title?: string;
+  expand?: boolean;
+  deprecated?: boolean | string;
+  additional?: ReactNode;
+  declaration?: ReactNode;
+  constraints?: ReactNode;
+  children?: ReactNode;
+};
+declare function Property({
+  id,
+  name,
+  typeName,
+  badges,
+  type,
+  declaration,
+  description,
+  title,
+  deprecated,
+  expand,
+  additional,
+  constraints,
+  children
+}: PropertyProps): react_jsx_runtime46.JSX.Element;
+//#endregion
+export { PropertyTitle as a, PropertyToggleProps as c, PropertyProps as i, PropertyDescription as n, PropertyTitleProps as o, PropertyDescriptionProps as r, PropertyToggle as s, Property as t };

package/dist/python-D8ABqtn1.js

@@ -0,0 +1,269 @@
+import { t as __exportAll } from "./chunk-BN_g-Awi.js";
+import { n as useLanguageComponents } from "./contexts-CeV_L_Iy.js";
+import { t as useComponents } from "./use-components-BUz3GbO4.js";
+import { t as style_default } from "./style-LwfvXElj.js";
+import * as React$1 from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/languages/python.tsx
+var python_exports = /* @__PURE__ */ __exportAll({
+	Declaration: () => Declaration,
+	MethodSignature: () => MethodSignature,
+	Property: () => Property,
+	Type: () => Type,
+	TypeName: () => TypeName
+});
+const constStyle = {
+	string: style_default.LiteralString,
+	number: style_default.LiteralNumeric,
+	boolean: style_default.LiteralBoolean
+};
+function showFullType(type) {
+	if (type.kind !== "PythonTypeReference") return false;
+	return type.typeName === "Optional" ? showFullType(type.typeParameters[0]) : type.typeParameters.length > 0;
+}
+function TypeName({ type }) {
+	const Lang = useLanguageComponents();
+	if (type.kind === "PythonTypeReference") switch (type.typeName) {
+		case "Optional": return /* @__PURE__ */ jsx(Lang.TypeName, { type: type.typeParameters[0] });
+		case "List":
+		case "Iterable":
+		case "Literal":
+		case "Union": return type.typeName.toLowerCase();
+	}
+	return /* @__PURE__ */ jsx(Lang.Type, { type });
+}
+function Type({ type }) {
+	const Lang = useLanguageComponents();
+	const { Join, SDKReference } = useComponents();
+	switch (type.kind) {
+		case "PythonTypeAny":
+		case "PythonTypeUnknown":
+		case "PythonTypeInt":
+		case "PythonTypeFloat":
+		case "PythonTypeBool": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: type.kind.slice(10).toLowerCase()
+			})
+		});
+		case "PythonTypeString": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeString,
+				children: "str"
+			})
+		});
+		case "PythonTypeLiteral": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: constStyle[typeof type.literal.value],
+				children: JSON.stringify(type.literal.value)
+			})
+		});
+		case "PythonTypeArray": return /* @__PURE__ */ jsxs("span", {
+			className: style_default.Type,
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TypeArray,
+					children: "Array<"
+				}),
+				/* @__PURE__ */ jsx(Lang.Type, { type: type.elementType }),
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TypeArray,
+					children: ">"
+				})
+			]
+		});
+		case "PythonTypeClass": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: "class"
+			})
+		});
+		case "PythonTypeMap": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: "Dict"
+			})
+		});
+		case "PythonTypeReference": {
+			const params = type.typeParameters?.map((param, key) => /* @__PURE__ */ jsx(Lang.Type, { type: param }, key));
+			return /* @__PURE__ */ jsxs("span", {
+				className: style_default.Type,
+				children: [/* @__PURE__ */ jsx("span", {
+					className: type.typeName === "Optional" ? style_default.TypeArray : "",
+					children: /* @__PURE__ */ jsx(SDKReference, {
+						stainlessPath: type.$ref,
+						children: type.typeName
+					})
+				}), params && params.length > 0 && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					/* @__PURE__ */ jsx("span", {
+						className: style_default.TypeBracket,
+						children: "["
+					}),
+					/* @__PURE__ */ jsx(Join, {
+						items: params,
+						limit: 3,
+						children: /* @__PURE__ */ jsx("span", {
+							className: style_default.TextOperator,
+							children: ", "
+						})
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: style_default.TypeBracket,
+						children: "]"
+					})
+				] })]
+			});
+		}
+	}
+}
+function MethodSignature({ decl }) {
+	const Lang = useLanguageComponents();
+	const { Join, Tooltip } = useComponents();
+	const params = decl.parameters.map((param, i) => /* @__PURE__ */ jsx(React$1.Fragment, { children: /* @__PURE__ */ jsx(Tooltip, {
+		content: /* @__PURE__ */ jsx(Lang.Type, { type: param.type }),
+		children: /* @__PURE__ */ jsx("span", {
+			className: style_default.TextIdentifier,
+			children: param.ident
+		})
+	}) }, i));
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.MethodSignature,
+		children: /* @__PURE__ */ jsxs("span", {
+			className: style_default.SignatureTitle,
+			children: [
+				decl.async && /* @__PURE__ */ jsx("span", {
+					className: style_default.TextKeyword,
+					children: "async "
+				}),
+				decl.qualified && /* @__PURE__ */ jsx("span", {
+					className: style_default.SignatureQualified,
+					children: /* @__PURE__ */ jsx("span", {
+						className: style_default.TextIdentifier,
+						children: decl.qualified?.slice(0, -decl.ident.length)
+					})
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.SignatureName,
+					children: /* @__PURE__ */ jsx("span", {
+						className: style_default.TextIdentifier,
+						children: decl.ident
+					})
+				}),
+				/* @__PURE__ */ jsxs("span", {
+					className: style_default.MethodSignature,
+					children: [
+						/* @__PURE__ */ jsx("span", {
+							className: style_default.SignatureParen,
+							children: "("
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: style_default.SignatureParams,
+							children: /* @__PURE__ */ jsx(Join, {
+								items: params,
+								children: /* @__PURE__ */ jsx("span", {
+									className: style_default.TextOperator,
+									children: ", "
+								})
+							})
+						}),
+						/* @__PURE__ */ jsxs("span", {
+							className: style_default.SignatureParen,
+							children: [")", " "]
+						}),
+						decl.returns && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+							className: style_default.TextOperator,
+							children: " -> "
+						}), /* @__PURE__ */ jsx(Lang.Type, { type: decl.returns })] })
+					]
+				})
+			]
+		})
+	});
+}
+function Property({ decl, children }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return;
+	switch (decl.kind) {
+		case "PythonDeclProperty": return children({
+			name: decl.ident,
+			typeName: /* @__PURE__ */ jsx(Lang.TypeName, { type: decl.type }),
+			type: showFullType(decl.type) && /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+		});
+		case "PythonDeclClass": return children({
+			name: decl.ident,
+			typeName: "class"
+		});
+		case "PythonDeclType": return children({
+			name: decl.ident,
+			typeName: "type",
+			type: /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+		});
+		case "PythonDeclReference": return children({ type: /* @__PURE__ */ jsx(Lang.Type, { type: decl.type }) });
+	}
+}
+function Declaration({ decl }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return;
+	switch (decl.kind) {
+		case "PythonDeclProperty": {
+			const nullable = decl.type.kind === "PythonTypeReference" && decl.type.typeName === "Optional" && (decl.type.typeParameters ?? []).length > 0;
+			return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TypePropertyName,
+					children: /* @__PURE__ */ jsx("span", {
+						className: style_default.TextIdentifier,
+						children: decl.ident
+					})
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TextPunctuation,
+					children: ": "
+				}),
+				decl.optional && !nullable ? /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					/* @__PURE__ */ jsx("span", {
+						className: style_default.TypePlain,
+						children: "Optional"
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: style_default.TypeBracket,
+						children: "["
+					}),
+					/* @__PURE__ */ jsx(Lang.Type, { type: decl.type }),
+					/* @__PURE__ */ jsx("span", {
+						className: style_default.TypeBrace,
+						children: "]"
+					})
+				] }) : /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+			] });
+		}
+		case "PythonDeclClass": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: "class "
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextIdentifier,
+				children: decl.ident
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextPunctuation,
+				children: ": "
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: `${style_default.TypePreviewContent} ${style_default.TextPunctuation}`,
+				children: "…"
+			})
+		] });
+		case "PythonDeclType": return /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsx(Lang.Type, { type: decl.type }) });
+		case "PythonDeclReference": return /* @__PURE__ */ jsx(Lang.Type, { type: decl.type });
+	}
+}
+
+//#endregion
+export { TypeName as a, Type as i, MethodSignature as n, python_exports as o, Property as r, Declaration as t };