@stainless-api/docs-ui 0.1.0-beta.8 → 0.1.0-beta.81

package/dist/languages/cli.d.ts

@@ -0,0 +1,38 @@
+import { n as CLIAST, s as HttpAST } from "../index-pvh-w1xa.js";
+import { PropertyFn } from "./index.js";
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/languages/cli.d.ts
+declare namespace cli_d_exports {
+  export { Declaration, DeclarationProps, MethodSignature, MethodSignatureProps, Property, PropertyProps, Type, TypeName };
+}
+type TypeProps = {
+  type: HttpAST.HttpType;
+};
+declare function TypeName(props: TypeProps): string | react_jsx_runtime0.JSX.Element;
+declare function Type({
+  type
+}: TypeProps): react_jsx_runtime0.JSX.Element;
+type MethodSignatureProps = {
+  decl: CLIAST.CLICommand;
+};
+declare function MethodSignature({
+  decl
+}: MethodSignatureProps): react_jsx_runtime0.JSX.Element;
+type PropertyProps = {
+  decl: CLIAST.CLIDeclaration;
+  children: PropertyFn;
+};
+declare function Property({
+  decl,
+  children
+}: PropertyProps): React.ReactNode;
+type DeclarationProps = {
+  decl: CLIAST.CLIDeclaration;
+};
+declare function Declaration({
+  decl
+}: DeclarationProps): react_jsx_runtime0.JSX.Element | undefined;
+//#endregion
+export { Declaration, DeclarationProps, MethodSignature, MethodSignatureProps, Property, PropertyProps, Type, TypeName, cli_d_exports as t };

package/dist/languages/cli.js

@@ -0,0 +1,167 @@
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
+import "../use-strict-context-L0c8JKg4.js";
+import { useLanguageComponents } from "../contexts/index.js";
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { Type as Type$1, TypeName as TypeName$1 } from "./http.js";
+import React from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/languages/cli.tsx
+var cli_exports = /* @__PURE__ */ __exportAll({
+	Declaration: () => Declaration,
+	MethodSignature: () => MethodSignature,
+	Property: () => Property,
+	Type: () => Type,
+	TypeName: () => TypeName
+});
+const ComplexTypes = {
+	HttpTypeUnion: "union",
+	HttpTypeIntersection: "intersection"
+};
+const constStyle = {
+	string: style_default.LiteralString,
+	number: style_default.LiteralNumeric,
+	boolean: style_default.LiteralBoolean
+};
+function TypeName(props) {
+	return TypeName$1(props);
+}
+function Type({ type }) {
+	switch (type.kind) {
+		case "HttpTypeBinary": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypePlain,
+				children: "file path"
+			})
+		});
+		default: return Type$1({ type });
+	}
+}
+function MethodSignature({ decl }) {
+	const { Join } = useComponents();
+	const params = decl.arguments?.map((arg, i) => /* @__PURE__ */ jsxs(React.Fragment, { children: [
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TextOperator,
+			children: "<"
+		}),
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TextIdentifier,
+			children: arg.value
+		}),
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TextOperator,
+			children: ">"
+		})
+	] }, i));
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.MethodSignature,
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextOperator,
+				children: "$ "
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.SignatureName,
+				children: /* @__PURE__ */ jsx("span", {
+					className: style_default.TextIdentifier,
+					children: decl.invocation.join(" ")
+				})
+			}),
+			params && /* @__PURE__ */ jsxs("span", {
+				className: style_default.MethodSignature,
+				children: [" ", /* @__PURE__ */ jsx(Join, {
+					items: params,
+					children: " "
+				})]
+			}),
+			decl.options && decl.options.length > 0 ? /* @__PURE__ */ jsx("span", {
+				className: style_default.TextOperator,
+				children: " [options]"
+			}) : null
+		]
+	});
+}
+function renderVariantInfo(type) {
+	if (type.kind === "HttpTypeUnion" && type.types.every((t) => t.kind === "HttpTypeObject" || t.kind === "HttpTypeReference")) return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		"One of the following ",
+		type.types.length,
+		" object variants:"
+	] });
+}
+function Property({ decl, children }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return;
+	switch (decl.kind) {
+		case "CLIFlag":
+		case "CLISchemaProperty": {
+			const variants = decl.type ? renderVariantInfo(decl.type) : void 0;
+			return children({
+				name: /* @__PURE__ */ jsxs(Fragment$1, { children: [decl.kind === "CLIFlag" && "--", flagName(decl)] }),
+				typeName: decl.type ? /* @__PURE__ */ jsx(Lang.TypeName, { type: decl.type }) : void 0,
+				type: decl.type && decl.type.kind in ComplexTypes && !variants && /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+			});
+		}
+		case "CLIFunction": return children({
+			name: decl.name,
+			typeName: "function"
+		});
+		case "CLIStdin": return children({ name: "stdin" });
+		case "CLICommand": return children({
+			name: decl.invocation.join(" "),
+			typeName: "command"
+		});
+	}
+}
+function flagName(node) {
+	if (node.kind === "CLIFlag" && node.flag) return typeof node.flag === "string" ? node.flag : node.flag.name || "";
+	return node.name ?? node.ident ?? "unknown";
+}
+function Declaration({ decl }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return;
+	switch (decl.kind) {
+		case "CLICommand": return /* @__PURE__ */ jsx("span", {
+			className: style_default.TextIdentifier,
+			children: `$ ${decl.invocation.join(" ")}`
+		});
+		case "CLISchemaProperty":
+		case "CLIFlag":
+			if ("value" in decl) return /* @__PURE__ */ jsx("span", {
+				className: constStyle[typeof decl.value],
+				children: JSON.stringify(decl.value)
+			});
+			return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.PropertyName,
+				children: /* @__PURE__ */ jsxs("span", {
+					className: style_default.TextIdentifier,
+					children: [decl.kind === "CLIFlag" && "--", flagName(decl)]
+				})
+			}), decl.type && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TextPunctuation,
+					children: ": "
+				}),
+				decl.optional && /* @__PURE__ */ jsx("span", {
+					className: style_default.TextPunctuation,
+					children: "optional "
+				}),
+				typeof decl.type === "string" ? /* @__PURE__ */ jsx("span", {
+					className: style_default.TextKeyword,
+					children: decl.type
+				}) : /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+			] })] });
+		case "CLIFunction": return /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsxs("span", {
+			className: style_default.TextIdentifier,
+			children: [decl.name, "()"]
+		}) });
+		case "CLIStdin": return /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsx("span", {
+			className: style_default.TextIdentifier,
+			children: "stdin"
+		}) });
+	}
+}
+
+//#endregion
+export { Declaration, MethodSignature, Property, Type, TypeName, cli_exports as t };

package/dist/languages/csharp.d.ts

@@ -0,0 +1,42 @@
+import { r as CSharpAST } from "../index-pvh-w1xa.js";
+import { PropertyFn } from "./index.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/languages/csharp.d.ts
+declare namespace csharp_d_exports {
+  export { Declaration, DeclarationProps, MethodSignature, MethodSignatureProps, Property, PropertyProps, Type, TypeName };
+}
+declare function TypeName({
+  type,
+  optional
+}: TypeProps): react_jsx_runtime0.JSX.Element;
+type TypeProps = {
+  type: CSharpAST.CSharpType;
+  optional?: boolean;
+};
+declare function Type({
+  type
+}: TypeProps): react_jsx_runtime0.JSX.Element;
+type MethodSignatureProps = {
+  decl: CSharpAST.CSharpDeclFunction;
+};
+declare function MethodSignature({
+  decl
+}: MethodSignatureProps): react_jsx_runtime0.JSX.Element;
+type PropertyProps = {
+  decl: CSharpAST.CSharpDeclaration;
+  children: PropertyFn;
+};
+declare function Property({
+  decl,
+  children
+}: PropertyProps): React$1.ReactNode;
+type DeclarationProps = {
+  decl: CSharpAST.CSharpDeclaration;
+};
+declare function Declaration({
+  decl
+}: DeclarationProps): react_jsx_runtime0.JSX.Element | null | undefined;
+//#endregion
+export { Declaration, DeclarationProps, MethodSignature, MethodSignatureProps, Property, PropertyProps, Type, TypeName, csharp_d_exports as t };

package/dist/languages/csharp.js

@@ -0,0 +1,284 @@
+import { t as __exportAll } from "../chunk-BYypO7fO.js";
+import "../use-strict-context-L0c8JKg4.js";
+import { useLanguageComponents } from "../contexts/index.js";
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import * as React$1 from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/languages/csharp.tsx
+var csharp_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 TypeName({ type, optional }) {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(useLanguageComponents().Type, { type }), optional && /* @__PURE__ */ jsx("span", {
+		className: style_default.TextOperator,
+		children: "? "
+	})] });
+}
+function Type({ type }) {
+	const Lang = useLanguageComponents();
+	const { Join, SDKReference } = useComponents();
+	switch (type.kind) {
+		case "CSharpTypeReference": {
+			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(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: ">"
+						})
+					] }) : null,
+					type.nullable && /* @__PURE__ */ jsx("span", {
+						className: style_default.TextOperator,
+						children: "?"
+					})
+				]
+			});
+		}
+		case "CSharpTypeClass":
+		case "CSharpTypeUnion": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: "class"
+			})
+		});
+		case "CSharpTypeEnum":
+		case "CSharpTypeBoolean":
+		case "CSharpTypeFloat":
+		case "CSharpTypeDouble":
+		case "CSharpTypeInt":
+		case "CSharpTypeLong": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: type.kind.slice(10)
+			})
+		});
+		case "CSharpTypeString": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeString,
+				children: "string"
+			})
+		});
+		case "CSharpTypeConstant": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: "JsonElement"
+			})
+		});
+	}
+}
+function MethodSignature({ decl }) {
+	const Lang = useLanguageComponents();
+	const { Join, Tooltip } = useComponents();
+	const params = decl.parameters.map((param, i) => /* @__PURE__ */ jsx(React$1.Fragment, { children: /* @__PURE__ */ jsxs(Tooltip, {
+		content: /* @__PURE__ */ jsx(Lang.Type, { type: param.typeAnnotation }),
+		children: [/* @__PURE__ */ jsx("span", {
+			className: style_default.TextIdentifier,
+			children: param.ident
+		}), param.hasDefault && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			" ",
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextOperator,
+				children: "="
+			}),
+			" ",
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: "default"
+			})
+		] })]
+	}) }, i));
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.MethodSignature,
+		children: /* @__PURE__ */ jsxs("span", {
+			className: style_default.SignatureTitle,
+			children: [
+				decl.returnType && /* @__PURE__ */ jsxs("span", {
+					className: style_default.SignatureReturns,
+					children: [/* @__PURE__ */ jsx(Lang.Type, { type: decl.returnType }), " "]
+				}),
+				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: [")", " "]
+						})
+					]
+				})
+			]
+		})
+	});
+}
+function Property({ decl, children }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return null;
+	switch (decl.kind) {
+		case "CSharpDeclProperty": {
+			const type = /* @__PURE__ */ jsx(Lang.Type, {
+				type: decl.type,
+				optional: decl.optional
+			});
+			return children({
+				name: decl.ident,
+				typeName: /* @__PURE__ */ jsx(Lang.TypeName, {
+					type: decl.type,
+					optional: decl.optional
+				}),
+				type
+			});
+		}
+		case "CSharpDeclConst": return children({
+			name: decl.ident,
+			typeName: "constant",
+			type: /* @__PURE__ */ jsx("span", {
+				className: constStyle[typeof decl.value],
+				children: JSON.stringify(decl.value)
+			})
+		});
+		case "CSharpDeclType": {
+			const typeName = decl.type.kind === "CSharpTypeUnion" ? "union" : decl.type.kind === "CSharpTypeEnum" ? "enum" : "class";
+			return children({
+				name: decl.ident,
+				typeName
+			});
+		}
+		case "CSharpDeclReference": return children({ type: /* @__PURE__ */ jsx(Lang.Type, { type: decl.type }) });
+	}
+}
+function Declaration({ decl }) {
+	const Docs = useComponents();
+	const Lang = useLanguageComponents();
+	if (!decl) return null;
+	switch (decl.kind) {
+		case "CSharpDeclConst": return /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsx(Docs.Tooltip, {
+			content: JSON.stringify(decl.value),
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TextIdentifier,
+				children: decl.ident
+			})
+		}) });
+		case "CSharpDeclType": {
+			const keyword = decl.type.kind === "CSharpTypeEnum" ? "enum" : "class";
+			return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TextKeyword,
+					children: keyword
+				}),
+				" ",
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TextIdentifier,
+					children: decl.ident
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TextPunctuation,
+					children: ":"
+				}),
+				decl.type.kind === "CSharpTypeUnion" && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					" ",
+					/* @__PURE__ */ jsx(Docs.Tooltip, {
+						content: "A class that can be one of several variants.",
+						children: /* @__PURE__ */ jsx(Docs.Badge, {
+							id: "csharp-union",
+							children: "union"
+						})
+					}),
+					" "
+				] })
+			] });
+		}
+		case "CSharpDeclProperty": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			decl.optional === false && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: "required"
+			}), " "] }),
+			/* @__PURE__ */ jsx(Lang.Type, {
+				type: decl.type,
+				optional: decl.optional
+			}),
+			decl.nullable && !("nullable" in decl.type && decl.type.nullable) && /* @__PURE__ */ jsx("span", {
+				className: style_default.TextOperator,
+				children: "?"
+			}),
+			" ",
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextIdentifier,
+				children: decl.ident
+			}),
+			decl.type.kind === "CSharpTypeConstant" && /* @__PURE__ */ jsxs(Fragment$1, { children: [" ", /* @__PURE__ */ jsx(Docs.Tooltip, {
+				content: /* @__PURE__ */ jsx("span", {
+					className: style_default.TextIdentifier,
+					children: decl.type.value
+				}),
+				children: /* @__PURE__ */ jsx(Docs.Badge, {
+					id: "csharp-constant",
+					children: "constant"
+				})
+			})] })
+		] });
+		case "CSharpDeclReference": return /* @__PURE__ */ jsx(Lang.Type, { type: decl.type });
+	}
+}
+
+//#endregion
+export { Declaration, MethodSignature, Property, Type, TypeName, csharp_exports as t };

package/dist/languages/go.d.ts

@@ -0,0 +1,40 @@
+import { a as GoAST } from "../index-pvh-w1xa.js";
+import { PropertyFn } from "./index.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/languages/go.d.ts
+declare namespace go_d_exports {
+  export { Declaration, DeclarationProps, MethodSignature, MethodSignatureProps, Property, PropertyProps, Type, TypeName, TypeProps };
+}
+type TypeProps = {
+  type: GoAST.GoType;
+};
+declare function TypeName({
+  type
+}: TypeProps): string | react_jsx_runtime0.JSX.Element;
+declare function Type({
+  type
+}: TypeProps): react_jsx_runtime0.JSX.Element;
+type MethodSignatureProps = {
+  decl: GoAST.GoDeclFunction;
+};
+declare function MethodSignature({
+  decl
+}: MethodSignatureProps): react_jsx_runtime0.JSX.Element;
+type PropertyProps = {
+  decl: GoAST.GoDeclaration;
+  children: PropertyFn;
+};
+declare function Property({
+  decl,
+  children
+}: PropertyProps): React$1.ReactNode;
+type DeclarationProps = {
+  decl: GoAST.GoDeclaration;
+};
+declare function Declaration({
+  decl
+}: DeclarationProps): react_jsx_runtime0.JSX.Element | undefined;
+//#endregion
+export { Declaration, DeclarationProps, MethodSignature, MethodSignatureProps, Property, PropertyProps, Type, TypeName, TypeProps, go_d_exports as t };