@stainless-api/docs-ui 0.1.0-beta.86 → 0.1.0-beta.87

package/dist/routing-C_fawH40.d.ts

@@ -0,0 +1,61 @@
+import { d as Method, f as Model, h as Resource, v as Spec } from "./index-DFr9Mesr.js";
+
+//#region src/routing.d.ts
+declare namespace routing_d_exports {
+  export { DocsLanguage, LanguageNames, Languages, ParsedStainlessPath, RouteEntry, SpecTreeEntry, SupportedLanguageSyntaxes, expandToElement, findNavigationPath, generateMissingRouteList, generateRoute, generateRouteList, getLanguageSnippet, getResource, isSupportedLanguage, parseRoute, parseStainlessPath, scrollToPath, trimStainlessPath, updateHistory, walkTree };
+}
+declare const Languages: readonly ["http", "node", "python", "go", "typescript", "terraform", "ruby", "java", "kotlin", "csharp", "php", "cli"];
+declare const SupportedLanguageSyntaxes: string[];
+type DocsLanguage = (typeof Languages)[number];
+declare const LanguageNames: Record<DocsLanguage, string>;
+declare function getLanguageSnippet(language: DocsLanguage): "cli.default" | "csharp.default" | "go.default" | "http.curl" | "java.default" | "kotlin.default" | "node.default" | "php.default" | "python.default" | "ruby.default" | "terraform.default" | "typescript.default";
+declare function isSupportedLanguage(language: string): language is DocsLanguage;
+type ParsedStainlessPath = ReturnType<typeof parseStainlessPath>;
+declare function parseStainlessPath(stainlessPath: string): {
+  resource: string[] | null;
+  method: string | null;
+  model: string | null;
+  routable: string | undefined;
+} | null;
+declare function trimStainlessPath(stainlessPath: string): string;
+declare function getResource(stainlessPath: string): string | undefined;
+declare function parseRoute(basePath: string, route: string): {
+  stainlessPath: string;
+  language: DocsLanguage;
+};
+declare function generateRoute(basePath: string, language: string, stainlessPath: string): string | null;
+type SpecTreeEntry = {
+  data: Method | Resource | Model;
+  path: string[];
+};
+declare function walkTree(spec: Spec, includeModels?: boolean): Generator<SpecTreeEntry, void, any>;
+type RouteEntry = {
+  title: string;
+  kind: SpecTreeEntry['data']['kind'];
+  language: DocsLanguage;
+  stainlessPath: string;
+  slug: string;
+};
+declare function generateRouteList({
+  spec,
+  languages,
+  excludeLanguages
+}: {
+  spec: Spec;
+  languages?: DocsLanguage[];
+  excludeLanguages?: DocsLanguage[];
+}): RouteEntry[];
+declare function generateMissingRouteList({
+  spec,
+  basePath
+}: {
+  spec: Spec;
+  basePath: string;
+}): string[];
+type ResourceOrMethod = Resource | Method;
+declare function findNavigationPath(items: ResourceOrMethod[], target: string): string[] | undefined;
+declare function expandToElement(el: HTMLElement | null): void;
+declare function scrollToPath(stainlessPath: string): void;
+declare function updateHistory(basePath: string, language: DocsLanguage, stainlessPath: string): void;
+//#endregion
+export { walkTree as S, parseStainlessPath as _, RouteEntry as a, trimStainlessPath as b, expandToElement as c, generateRoute as d, generateRouteList as f, parseRoute as g, isSupportedLanguage as h, ParsedStainlessPath as i, findNavigationPath as l, getResource as m, LanguageNames as n, SpecTreeEntry as o, getLanguageSnippet as p, Languages as r, SupportedLanguageSyntaxes as s, DocsLanguage as t, generateMissingRouteList as u, routing_d_exports as v, updateHistory as x, scrollToPath as y };

package/dist/routing.d.ts

@@ -1,2 +1,2 @@
-import { S as walkTree, _ as parseStainlessPath, a as RouteEntry, b as trimStainlessPath, c as expandToElement, d as generateRoute, f as generateRouteList, g as parseRoute, h as isSupportedLanguage, i as ParsedStainlessPath, l as findNavigationPath, m as getResource, n as LanguageNames, o as SpecTreeEntry, p as getLanguageSnippet, r as Languages, s as SupportedLanguageSyntaxes, t as DocsLanguage, u as generateMissingRouteList, x as updateHistory, y as scrollToPath } from "./routing-yTSG7nWM.js";
+import { S as walkTree, _ as parseStainlessPath, a as RouteEntry, b as trimStainlessPath, c as expandToElement, d as generateRoute, f as generateRouteList, g as parseRoute, h as isSupportedLanguage, i as ParsedStainlessPath, l as findNavigationPath, m as getResource, n as LanguageNames, o as SpecTreeEntry, p as getLanguageSnippet, r as Languages, s as SupportedLanguageSyntaxes, t as DocsLanguage, u as generateMissingRouteList, x as updateHistory, y as scrollToPath } from "./routing-C_fawH40.js";
 export { DocsLanguage, LanguageNames, Languages, ParsedStainlessPath, RouteEntry, SpecTreeEntry, SupportedLanguageSyntaxes, expandToElement, findNavigationPath, generateMissingRouteList, generateRoute, generateRouteList, getLanguageSnippet, getResource, isSupportedLanguage, parseRoute, parseStainlessPath, scrollToPath, trimStainlessPath, updateHistory, walkTree };

package/dist/sdk-Cx2Z7bDk.d.ts

@@ -0,0 +1,128 @@
+import { _ as SnippetLanguage, c as ID, d as Method, f as Model, o as HasStainlessPath, t as BaseDeclaration } from "./index-DFr9Mesr.js";
+import { t as DocsLanguage } from "./routing-C_fawH40.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/sdk.d.ts
+type PropertyModelContextType = {
+  modelPath?: string;
+  propertyPath?: string;
+};
+declare const PropertyModelContext: React$1.Context<PropertyModelContextType>;
+declare function usePropertyModel(): PropertyModelContextType;
+type ReferenceNestingContextType = string[];
+declare const ReferenceNestingContext: React$1.Context<ReferenceNestingContextType>;
+declare function useReferenceNesting(): ReferenceNestingContextType;
+type DeclarationParentsContextType = ReadonlySet<string>;
+declare function useDeclarationParents(): DeclarationParentsContextType;
+type SDKSnippetLanguagesType = Record<SnippetLanguage, {
+  name: string;
+}>;
+declare const SDKSnippetLanguages: SDKSnippetLanguagesType;
+type TransformRequestSnippetFn = ({
+  snippet,
+  language
+}: {
+  snippet: string;
+  language: DocsLanguage;
+}) => string;
+type SDKChildrenProps = {
+  paths: ID[];
+  expand?: boolean;
+  depth?: number;
+};
+declare function SDKChildren({
+  paths,
+  expand,
+  depth
+}: SDKChildrenProps): react_jsx_runtime0.JSX.Element;
+type SDKDeclarationProps = {
+  path: string;
+  expand?: boolean;
+  depth?: number;
+};
+declare function SDKDeclaration({
+  path,
+  expand,
+  depth
+}: SDKDeclarationProps): react_jsx_runtime0.JSX.Element;
+type SDKConstraintsProps = {
+  constraints?: Record<string, unknown>;
+};
+declare function SDKConstraints({
+  constraints
+}: SDKConstraintsProps): react_jsx_runtime0.JSX.Element | undefined;
+type SDKIconProps = {
+  language: SnippetLanguage;
+  size?: number;
+};
+declare function SDKIcon({
+  language
+}: SDKIconProps): react_jsx_runtime0.JSX.Element | null;
+type SDKRequestTitleProps = {
+  snippetLanguage: SnippetLanguage;
+};
+declare function SDKRequestTitle({
+  snippetLanguage
+}: SDKRequestTitleProps): react_jsx_runtime0.JSX.Element;
+type SDKExampleProps = {
+  method: Partial<Method> & HasStainlessPath;
+  transformRequestSnippet?: TransformRequestSnippetFn;
+};
+declare function SDKExample({
+  method,
+  transformRequestSnippet
+}: SDKExampleProps): react_jsx_runtime0.JSX.Element;
+type SDKMethodProps = {
+  method: Method;
+  transformRequestSnippet?: TransformRequestSnippetFn;
+};
+declare function SDKMethodHeader({
+  method
+}: SDKMethodProps): react_jsx_runtime0.JSX.Element;
+declare function useStreamingResponse(method: BaseDeclaration): ID | undefined;
+declare function SDKMethodInfo({
+  method,
+  children
+}: SDKMethodProps & {
+  children?: React$1.ReactNode;
+}): react_jsx_runtime0.JSX.Element;
+declare function SDKMethodNotImplemented({
+  method
+}: SDKMethodProps): react_jsx_runtime0.JSX.Element;
+declare function SDKMethodInfoContent(_props: SDKMethodProps): React$1.ReactNode;
+declare function SDKMethod({
+  method,
+  transformRequestSnippet
+}: SDKMethodProps): react_jsx_runtime0.JSX.Element;
+type SDKModelProps = {
+  model: Model;
+};
+declare function SDKModel({
+  model
+}: SDKModelProps): react_jsx_runtime0.JSX.Element | null;
+type SDKReferenceProps = {
+  stainlessPath: string;
+  children?: React$1.ReactNode;
+};
+declare function SDKReference({
+  stainlessPath,
+  children
+}: SDKReferenceProps): string | number | bigint | boolean | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | react_jsx_runtime0.JSX.Element | null | undefined;
+type SDKLanguageBlockProps = {
+  language: DocsLanguage;
+  version: string;
+  install: string;
+  links: {
+    repo: string;
+    docs: string;
+  };
+};
+declare function SDKLanguageBlock({
+  language,
+  version,
+  install,
+  links
+}: SDKLanguageBlockProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { useStreamingResponse as A, SDKRequestTitleProps as C, useDeclarationParents as D, TransformRequestSnippetFn as E, usePropertyModel as O, SDKRequestTitle as S, SDKSnippetLanguagesType as T, SDKMethodNotImplemented as _, ReferenceNestingContextType as a, SDKModelProps as b, SDKConstraintsProps as c, SDKIcon as d, SDKLanguageBlock as f, SDKMethodInfoContent as g, SDKMethodInfo as h, ReferenceNestingContext as i, useReferenceNesting as k, SDKDeclaration as l, SDKMethodHeader as m, PropertyModelContext as n, SDKChildren as o, SDKMethod as p, PropertyModelContextType as r, SDKConstraints as s, DeclarationParentsContextType as t, SDKExample as u, SDKMethodProps as v, SDKSnippetLanguages as w, SDKReference as x, SDKModel as y };

package/dist/spec.d.ts

@@ -1,5 +1,5 @@
 import { d as Method, f as Model, h as Resource, i as DeclarationNode, v as Spec, y as SpecLanguage } from "./index-DFr9Mesr.js";
-import { t as DocsLanguage } from "./routing-yTSG7nWM.js";
+import { t as DocsLanguage } from "./routing-C_fawH40.js";
 
 //#region src/spec.d.ts
 type SecurityScheme = Spec['security_schemes'][number];
@@ -36,13 +36,13 @@ declare function generateNavigation(resource: Partial<Resource>): {
 declare function generateSpecForResource(spec: Spec, name: string, lang: DocsLanguage, transforms: SpecTransforms): Partial<Spec>;
 declare function transform(spec: Spec, transforms: SpecTransforms): {
   name: string;
-  lang: "http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin" | "csharp" | "php" | "cli";
+  lang: "cli" | "csharp" | "go" | "http" | "java" | "kotlin" | "node" | "php" | "python" | "ruby" | "terraform" | "typescript";
   spec: Partial<Spec>;
 }[];
 declare function split(spec: Spec, transforms?: SpecTransforms): {
   resources: ReturnType<typeof transform>;
   navigation: {
-    languages: ("http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin" | "csharp" | "php" | "cli" | "sql" | "openapi")[] | undefined;
+    languages: ("cli" | "csharp" | "go" | "http" | "java" | "kotlin" | "node" | "php" | "python" | "ruby" | "terraform" | "typescript" | "sql" | "openapi")[] | undefined;
     resources: {
       [k: string]: {
         title: string | undefined;

package/dist/styles/main.css

@@ -439,8 +439,18 @@
     border: 1px solid var(--stl-color-border);
     border-radius: 12px;
 
+    &:is(.stldocs-method-response-column .stldocs-snippet-multi-response) {
+      overflow: clip;
+
+      & .stldocs-snippet {
+        padding: 0;
+      }
+    }
+
     & .stldocs-snippet {
       background-color: #0000;
+      border: none;
+      border-radius: 0;
     }
 
     & .stldocs-snippet-code .shiki {
@@ -625,7 +635,7 @@
     }
 
     & .stldocs-snippet-response-pane {
-      --shiki-background: var(--stl-color-faint-background);
+      --shiki-background: transparent;
       padding: .5rem;
       display: none;
 
@@ -703,8 +713,6 @@
   & .stldocs-snippet-response-tab {
     border-bottom: 1px solid var(--stl-color-border-faint);
     gap: .5rem;
-    margin-inline: -.5rem;
-    padding-inline: .5rem;
     display: flex;
     overflow-x: auto;
 
@@ -738,8 +746,6 @@
 
     &.stldocs-snippet-response-tab-single-return {
       background-color: var(--stl-color-faint-background);
-      border-top-left-radius: 12px;
-      border-top-right-radius: 12px;
 
       & .stldocs-snippet-response-tab-item {
         color: var(--stl-color-foreground-reduced);
@@ -945,6 +951,11 @@
           padding: 0;
           display: block;
         }
+
+        & .stldocs-snippet-response-tab {
+          margin-inline: -.5rem;
+          padding-inline: .5rem;
+        }
       }
 
       & .stldocs-method-response-column {

package/dist/styles.css

@@ -2173,8 +2173,18 @@ a.stl-ui-button {
     border: 1px solid var(--stl-color-border);
     border-radius: 12px;
 
+    &:is(.stldocs-method-response-column .stldocs-snippet-multi-response) {
+      overflow: clip;
+
+      & .stldocs-snippet {
+        padding: 0;
+      }
+    }
+
     & .stldocs-snippet {
       background-color: #0000;
+      border: none;
+      border-radius: 0;
     }
 
     & .stldocs-snippet-code .shiki {
@@ -2359,7 +2369,7 @@ a.stl-ui-button {
     }
 
     & .stldocs-snippet-response-pane {
-      --shiki-background: var(--stl-color-faint-background);
+      --shiki-background: transparent;
       padding: .5rem;
       display: none;
 
@@ -2437,8 +2447,6 @@ a.stl-ui-button {
   & .stldocs-snippet-response-tab {
     border-bottom: 1px solid var(--stl-color-border-faint);
     gap: .5rem;
-    margin-inline: -.5rem;
-    padding-inline: .5rem;
     display: flex;
     overflow-x: auto;
 
@@ -2472,8 +2480,6 @@ a.stl-ui-button {
 
     &.stldocs-snippet-response-tab-single-return {
       background-color: var(--stl-color-faint-background);
-      border-top-left-radius: 12px;
-      border-top-right-radius: 12px;
 
       & .stldocs-snippet-response-tab-item {
         color: var(--stl-color-foreground-reduced);
@@ -2679,6 +2685,11 @@ a.stl-ui-button {
           padding: 0;
           display: block;
         }
+
+        & .stldocs-snippet-response-tab {
+          margin-inline: -.5rem;
+          padding-inline: .5rem;
+        }
       }
 
       & .stldocs-method-response-column {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.86",
+  "version": "0.1.0-beta.87",
   "publishConfig": {
     "access": "public"
   },
@@ -17,7 +17,7 @@
     "@markdoc/markdoc": "^0.5.6",
     "clsx": "^2.1.1",
     "htmlparser2": "^10.1.0",
-    "lucide-react": "^0.574.0",
+    "lucide-react": "^0.577.0",
     "@stainless-api/ui-primitives": "0.1.0-beta.50"
   },
   "devDependencies": {
@@ -30,8 +30,8 @@
     "react-dom": "^19.2.4",
     "tsdown": "^0.21.4",
     "typescript": "5.9.3",
-    "@stainless/eslint-config": "0.1.0-beta.1",
-    "@stainless/sdk-json": "^0.1.0-beta.9"
+    "@stainless/sdk-json": "^0.1.0-beta.9",
+    "@stainless/eslint-config": "0.1.0-beta.1"
   },
   "exports": {
     ".": {

package/dist/markdown-ClGRntP5.d.ts

@@ -1,22 +0,0 @@
-import * as React$1 from "react";
-import * as react_jsx_runtime0 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_runtime0.JSX.Element;
-//#endregion
-export { useMarkdownContext as a, useHighlight as i, MarkdownProvider as n, useRenderMarkdown as o, MarkdownProviderProps as r, MarkdownContext as t };