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

package/dist/styles.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/typescript-D924WidI.js

@@ -0,0 +1,449 @@
+import { t as __exportAll } from "./chunk-BN_g-Awi.js";
+import { a as useLanguage, l as useSpec, r as useDeclaration } from "./docs-Di94viZV.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/typescript.tsx
+var typescript_exports = /* @__PURE__ */ __exportAll({
+	Declaration: () => Declaration,
+	MethodSignature: () => MethodSignature,
+	Property: () => Property,
+	Type: () => Type,
+	TypeName: () => TypeName
+});
+const ComplexTypes = {
+	TSTypeObject: "object",
+	TSTypeUnion: "union",
+	TSTypeInterface: "interface",
+	TSTypeIntersection: "intersection",
+	TSTypeArray: "array"
+};
+const constStyle = {
+	string: style_default.LiteralString,
+	number: style_default.LiteralNumeric,
+	boolean: style_default.LiteralBoolean
+};
+function Identifier({ name, optional }) {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+		className: style_default.TextIdentifier,
+		children: /^[_a-zA-Z][_a-zA-Z0-9]*$/.test(name) ? name : JSON.stringify(name)
+	}), optional && /* @__PURE__ */ jsx("span", {
+		className: style_default.TextPunctuation,
+		children: "?"
+	})] });
+}
+function TypeParams({ params }) {
+	const Lang = useLanguageComponents();
+	const { Join } = useComponents();
+	if (!params?.length) return null;
+	const typeParams = params?.map((param, key) => param.constraint ? /* @__PURE__ */ jsxs(React$1.Fragment, { children: [
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TypeReference,
+			children: param.name
+		}),
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TextKeyword,
+			children: "extends "
+		}),
+		/* @__PURE__ */ jsx(Lang.Type, { type: param.constraint })
+	] }, key) : /* @__PURE__ */ jsx(React$1.Fragment, { children: "param.name" }, key));
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TypeBracket,
+			children: "<"
+		}),
+		/* @__PURE__ */ jsx(Join, {
+			items: typeParams,
+			limit: 3,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TextOperator,
+				children: ", "
+			})
+		}),
+		/* @__PURE__ */ jsx("span", {
+			className: style_default.TypeBracket,
+			children: ">"
+		})
+	] });
+}
+function TypePreview({ path }) {
+	const spec = useSpec();
+	const language = useLanguage();
+	const decl = useDeclaration(path, false);
+	const { Join } = useComponents();
+	if (!(decl && "children" in decl && decl.children && decl.children.length > 0) || decl && "type" in decl && decl.type !== void 0 && "kind" in decl["type"] && decl["type"]["kind"] === "TSTypeUnion") return;
+	const items = decl.children.map((prop, key) => {
+		const p = spec?.decls?.[language]?.[prop];
+		return /* @__PURE__ */ jsx("span", {
+			className: style_default.TypePropertyName,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TextIdentifier,
+				children: p && "key" in p ? p["key"] : null
+			})
+		}, key);
+	});
+	return /* @__PURE__ */ jsxs("span", {
+		className: style_default.TypePreview,
+		"data-stldocs-type-preview": "properties",
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TypeBrace,
+				children: " {"
+			}),
+			/* @__PURE__ */ jsxs("span", {
+				className: style_default.TypePreviewContent,
+				children: [
+					" ",
+					/* @__PURE__ */ jsx(Join, {
+						items,
+						limit: 3,
+						children: /* @__PURE__ */ jsx("span", {
+							className: style_default.TextOperator,
+							children: ", "
+						})
+					}),
+					" "
+				]
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TypeBrace,
+				children: "} "
+			})
+		]
+	});
+}
+function TypeName({ type }) {
+	const Lang = useLanguageComponents();
+	return ComplexTypes[type.kind] ?? /* @__PURE__ */ jsx(Lang.Type, { type });
+}
+function Type({ type }) {
+	const Lang = useLanguageComponents();
+	const { Join, SDKReference } = useComponents();
+	switch (type.kind) {
+		case "TSTypeUnknown":
+		case "TSTypeUndefined":
+		case "TSTypeNever":
+		case "TSTypeVoid":
+		case "TSTypeNull":
+		case "TSTypeAny":
+		case "TSTypeBoolean":
+		case "TSTypeNumber": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeKeyword,
+				children: type.kind.slice(6).toLowerCase()
+			})
+		});
+		case "TSTypeString": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeString,
+				children: "string"
+			})
+		});
+		case "TSTypeLiteral": return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: constStyle[typeof type.literal],
+				children: JSON.stringify(type.literal)
+			})
+		});
+		case "TSTypeArray": 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 "TSTypeReference": {
+			const name = type.ident.split(".").at(-1);
+			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: name
+					}),
+					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: ">"
+						})
+					] }),
+					/* @__PURE__ */ jsx(TypePreview, { path: type.$ref })
+				]
+			});
+		}
+		case "TSTypeIntersection":
+		case "TSTypeUnion": {
+			const items = type.types.map((t, key) => /* @__PURE__ */ jsx(Lang.Type, { type: t }, key));
+			const delimiter = type.kind === "TSTypeUnion" ? "|" : "&";
+			return /* @__PURE__ */ jsx("span", {
+				className: style_default.Type,
+				children: /* @__PURE__ */ jsx("span", {
+					className: style_default.TypePreview,
+					"data-stldocs-type-preview": "union",
+					children: /* @__PURE__ */ jsx("span", {
+						className: style_default.TypePreviewContent,
+						children: /* @__PURE__ */ jsx(Join, {
+							items,
+							limit: 3,
+							children: /* @__PURE__ */ jsxs("span", {
+								className: style_default.TextOperator,
+								children: [
+									" ",
+									delimiter,
+									" "
+								]
+							})
+						})
+					})
+				})
+			});
+		}
+		case "TSTypeObject":
+		case "TSTypeInterface": {
+			const extend = type.kind === "TSTypeObject" ? null : type.extends?.map((ref, key) => /* @__PURE__ */ jsx(Lang.Type, { type: ref }, key));
+			const items = type.members.map((prop, key) => /* @__PURE__ */ jsxs(React$1.Fragment, { children: [
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TypePropertyName,
+					children: /* @__PURE__ */ jsx(Identifier, {
+						name: prop.ident,
+						optional: prop.optional
+					})
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.TextPunctuation,
+					children: ": "
+				}),
+				/* @__PURE__ */ jsx(Lang.Type, { type: prop.type })
+			] }, key));
+			return /* @__PURE__ */ jsxs("span", {
+				className: style_default.Type,
+				children: [extend?.length && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+					className: style_default.TypeKeyword,
+					children: " extends "
+				}), /* @__PURE__ */ jsx(Join, {
+					items: extend,
+					limit: 3,
+					children: /* @__PURE__ */ jsx("span", {
+						className: style_default.TextOperator,
+						children: ", "
+					})
+				})] }), /* @__PURE__ */ jsxs("span", {
+					className: style_default.TypePreview,
+					"data-stldocs-type-preview": "properties",
+					children: [
+						/* @__PURE__ */ jsx("span", {
+							className: style_default.TypeBrace,
+							children: "{ "
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: style_default.TypePreviewContent,
+							children: /* @__PURE__ */ jsx(Join, {
+								items,
+								limit: 3,
+								children: /* @__PURE__ */ jsx("span", {
+									className: style_default.TextOperator,
+									children: ", "
+								})
+							})
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: style_default.TypeBrace,
+							children: "} "
+						})
+					]
+				})]
+			});
+		}
+	}
+}
+function MethodSignature({ decl }) {
+	const Lang = useLanguageComponents();
+	const { Join, Tooltip } = useComponents();
+	const params = decl.signature.parameters.map((param, i) => /* @__PURE__ */ jsxs(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
+		})
+	}), param.optional && /* @__PURE__ */ jsx("span", {
+		className: style_default.TextPunctuation,
+		children: "?"
+	})] }, i));
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.MethodSignature,
+		children: /* @__PURE__ */ jsxs("span", {
+			className: style_default.SignatureTitle,
+			children: [
+				decl.signature.async && /* @__PURE__ */ jsx("span", {
+					className: style_default.TextKeyword,
+					children: "async "
+				}),
+				/* @__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: [
+						decl.signature.typeParameters && /* @__PURE__ */ jsx(TypeParams, { params: decl.signature.typeParameters }),
+						/* @__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__ */ jsx("span", {
+							className: style_default.SignatureParen,
+							children: ")"
+						}),
+						decl.signature.returns && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+							className: style_default.TextPunctuation,
+							children: ": "
+						}), /* @__PURE__ */ jsx(Lang.Type, { type: decl.signature.returns })] })
+					]
+				})
+			]
+		})
+	});
+}
+function Property({ decl, children }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return;
+	switch (decl.kind) {
+		case "TSDeclProperty": return children({
+			name: decl.key,
+			typeName: /* @__PURE__ */ jsx(Lang.TypeName, { type: decl.type }),
+			type: decl.type.kind in ComplexTypes && /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+		});
+		case "TSDeclTypeAlias": return children({
+			name: decl.ident,
+			typeName: "alias",
+			type: /* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+		});
+		case "TSDeclReference": return children({ type: /* @__PURE__ */ jsx(Lang.Type, { type: decl.type }) });
+		case "TSDeclInterface": return children({ type: /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextIdentifier,
+				children: decl.ident
+			}),
+			decl.typeParameters && /* @__PURE__ */ jsx(TypeParams, { params: decl.typeParameters }),
+			decl.extends?.flatMap((t, key) => /* @__PURE__ */ jsxs(React$1.Fragment, { children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: " extends "
+			}), /* @__PURE__ */ jsx(Lang.Type, { type: t })] }, `extends:${key}`))
+		] }) });
+	}
+}
+function Declaration({ decl }) {
+	const Lang = useLanguageComponents();
+	if (!decl) return;
+	switch (decl.kind) {
+		case "TSDeclProperty": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			decl.declare && /* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: "declare "
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TypePropertyName,
+				children: /* @__PURE__ */ jsx(Identifier, {
+					name: decl.key,
+					optional: decl.optional
+				})
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextPunctuation,
+				children: ": "
+			}),
+			/* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+		] });
+		case "TSDeclFunction": return /* @__PURE__ */ jsx(Lang.MethodSignature, { decl });
+		case "TSDeclTypeAlias": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			/* @__PURE__ */ jsx(Identifier, { name: decl.ident }),
+			/* @__PURE__ */ jsx(TypeParams, { params: decl.typeParameters }),
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextOperator,
+				children: " = "
+			}),
+			/* @__PURE__ */ jsx(Lang.Type, { type: decl.type })
+		] });
+		case "TSDeclReference": return /* @__PURE__ */ jsx(Lang.Type, { type: decl.type });
+		case "TSDeclInterface": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			/* @__PURE__ */ jsx("span", {
+				className: style_default.TextIdentifier,
+				children: decl.ident
+			}),
+			/* @__PURE__ */ jsx(TypeParams, { params: decl.typeParameters }),
+			decl.extends?.map((t, index) => /* @__PURE__ */ jsxs(React$1.Fragment, { children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: " extends "
+			}), /* @__PURE__ */ jsx(Lang.Type, { type: t })] }, index)),
+			/* @__PURE__ */ jsx(TypePreview, { path: decl.stainlessPath })
+		] });
+		case "TSDeclClass": 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(TypeParams, { params: decl.typeParameters }),
+			decl.superClass ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: " extends "
+			}), /* @__PURE__ */ jsx(Lang.Type, { type: decl.superClass })] }) : null,
+			decl.implements?.map((t, index) => /* @__PURE__ */ jsxs(React$1.Fragment, { children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.TextKeyword,
+				children: " implements "
+			}), /* @__PURE__ */ jsx(Lang.Type, { type: t })] }, index))
+		] });
+	}
+}
+
+//#endregion
+export { TypeName as a, Type as i, MethodSignature as n, typescript_exports as o, Property as r, Declaration as t };

package/dist/use-components-BUz3GbO4.js

@@ -0,0 +1,7 @@
+import { i as useComponents$1 } from "./component-generics-POFirVVb.js";
+
+//#region src/contexts/use-components.tsx
+const useComponents = () => useComponents$1();
+
+//#endregion
+export { useComponents as t };

package/dist/utils-D01mAUfQ.js

@@ -0,0 +1,32 @@
+import { t as __exportAll } from "./chunk-BN_g-Awi.js";
+import { f as parseStainlessPath } from "./routing-Ce0_tBW6.js";
+
+//#region src/utils.ts
+var utils_exports = /* @__PURE__ */ __exportAll({
+	flatResources: () => flatResources,
+	getResourceFromSpec: () => getResourceFromSpec,
+	isResourceEmpty: () => isResourceEmpty
+});
+function flatResources(resources, parents) {
+	return Object.keys(resources ?? {}).flatMap((key) => {
+		const resource = resources[key];
+		return [{
+			resource,
+			parents
+		}, ...resource.subresources ? flatResources(resource.subresources, [...parents, resource]) : []];
+	});
+}
+function getResourceFromSpec(stainlessPath, spec) {
+	if (typeof stainlessPath === "string") {
+		const parsed = parseStainlessPath(stainlessPath);
+		if (!parsed?.resource) return null;
+		stainlessPath = parsed.resource;
+	}
+	return stainlessPath.slice(1).reduce((acc, cur) => acc?.subresources?.[cur], spec.resources[stainlessPath[0]]) ?? null;
+}
+function isResourceEmpty(resource) {
+	return !(Object.values(resource.methods).length > 0 || Object.values(resource.models).length > 0 || Object.values(resource.subresources).length > 0);
+}
+
+//#endregion
+export { utils_exports as i, getResourceFromSpec as n, isResourceEmpty as r, flatResources as t };

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+import { f as Resource, h as Spec } from "./index-zNpvNvtN.js";
+
+//#region src/utils.d.ts
+declare namespace utils_d_exports {
+  export { flatResources, getResourceFromSpec, isResourceEmpty };
+}
+declare function flatResources(resources: Record<string, Resource> | undefined, parents: Resource[]): {
+  resource: Resource;
+  parents: Resource[];
+}[];
+declare function getResourceFromSpec(stainlessPath: string | string[], spec: Spec): Resource | null;
+declare function isResourceEmpty(resource: Resource): boolean;
+//#endregion
+export { flatResources, getResourceFromSpec, isResourceEmpty, utils_d_exports as t };

package/dist/utils.js

@@ -0,0 +1,3 @@
+import { n as getResourceFromSpec, r as isResourceEmpty, t as flatResources } from "./utils-D01mAUfQ.js";
+
+export { flatResources, getResourceFromSpec, isResourceEmpty };

package/package.json

@@ -1,39 +1,91 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.61",
   "publishConfig": {
     "access": "public"
   },
   "type": "module",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
   "dependencies": {
-    "@algolia/client-search": "^5.25.0",
-    "@markdoc/markdoc": "^0.5.2",
-    "ai": "4.3.19",
+    "@markdoc/markdoc": "^0.5.4",
     "clsx": "^2.1.1",
-    "fuse.js": "^7.1.0",
     "htmlparser2": "^10.0.0",
-    "lucide-react": "^0.544.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "@stainless-api/ui-primitives": "0.1.0-beta.7"
+    "lucide-react": "^0.562.0",
+    "@stainless-api/ui-primitives": "0.1.0-beta.45"
   },
   "devDependencies": {
-    "@types/node": "^24.4.0",
-    "@types/react": "^19.1.13",
-    "@types/react-dom": "^19.1.9",
-    "dotenv": "17.2.2",
-    "esbuild": "^0.25.4",
-    "tsx": "^4.20.3",
-    "@stainless/eslint-config": "0.0.0"
+    "@types/node": "24.10.9",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "dotenv": "17.2.3",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "tsdown": "^0.20.0",
+    "typescript": "5.9.3",
+    "@stainless/eslint-config": "0.1.0-beta.1",
+    "@stainless/sdk-json": "^0.1.0-beta.3"
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/index.js"
+    },
+    "./routing": {
+      "default": "./dist/routing.js"
+    },
+    "./utils": {
+      "default": "./dist/utils.js"
+    },
+    "./components": {
+      "default": "./dist/components/index.js"
+    },
+    "./components/scripts/*": {
+      "default": "./dist/components/scripts/*.js"
+    },
+    "./components/*": {
+      "default": "./dist/components/*.js"
+    },
+    "./languages": {
+      "default": "./dist/languages/index.js"
+    },
+    "./languages/*": {
+      "default": "./dist/languages/*.js"
+    },
+    "./contexts": {
+      "default": "./dist/contexts/index.js"
+    },
+    "./contexts/*": {
+      "default": "./dist/contexts/*.js"
+    },
+    "./style": {
+      "default": "./dist/style.js"
+    },
+    "./styles/*": {
+      "default": "./dist/styles/*"
+    },
+    "./styles.css": {
+      "default": "./dist/styles.css"
+    },
+    "./markdown": {
+      "default": "./dist/markdown/index.js"
+    },
+    "./markdown/*": {
+      "default": "./dist/markdown/*.js"
+    },
+    "./spec": {
+      "default": "./dist/spec.js"
+    }
   },
   "scripts": {
-    "symlink": "node make-symlink.js",
-    "build": "node build.js",
-    "lint": "eslint ."
+    "build": "tsdown",
+    "clean": "rm -rf dist",
+    "lint": "eslint .",
+    "check:types": "tsc --noEmit"
   }
 }