@stainless-api/docs-ui 0.1.0-beta.11 → 0.1.0-beta.13

package/dist/routing.js

@@ -1,3 +1,180 @@
-import { _ as walkTree, a as findNavigationPath, c as getLanguageSnippet, d as parseRoute, f as parseStainlessPath, g as updateHistory, h as trimStainlessPath, i as expandToElement, l as getResource, m as scrollToPath, n as Languages, o as generateRoute, r as SupportedLanguageSyntaxes, s as generateRouteList, t as LanguageNames, u as isSupportedLanguage } from "./routing-DQjbRxdJ.js";
-
-export { LanguageNames, Languages, SupportedLanguageSyntaxes, expandToElement, findNavigationPath, generateRoute, generateRouteList, getLanguageSnippet, getResource, isSupportedLanguage, parseRoute, parseStainlessPath, scrollToPath, trimStainlessPath, updateHistory, walkTree };
+// src/routing.ts
+var Languages = [
+  "http",
+  "node",
+  "python",
+  "go",
+  "typescript",
+  "terraform",
+  "ruby",
+  "java",
+  "kotlin"
+];
+var SupportedLanguageSyntaxes = [
+  "http",
+  "javascript",
+  "python",
+  "go",
+  "typescript",
+  "terraform",
+  "ruby",
+  "java",
+  "kotlin"
+];
+var LanguageNames = {
+  http: "HTTP",
+  node: "TypeScript",
+  typescript: "TypeScript",
+  python: "Python",
+  go: "Go",
+  ruby: "Ruby",
+  java: "Java",
+  kotlin: "Kotlin",
+  terraform: "Terraform"
+};
+function getLanguageSnippet(language) {
+  return language === "http" ? "http.curl" : `${language}.default`;
+}
+function isSupportedLanguage(language) {
+  return Languages.includes(language);
+}
+var DefaultLanguage = "http";
+var StainlessPathPattern = /(\(resource\) (?<resource>[^\s]+))( > (\(method\) (?<method>[^\s]+)|\(model\) (?<model>[^\s]+))?)?/;
+function parseStainlessPath(stainlessPath) {
+  const match = stainlessPath.match(StainlessPathPattern);
+  if (!match) return null;
+  return {
+    resource: match.groups.resource.split("."),
+    method: match.groups.method ?? null,
+    model: match.groups.model ?? null,
+    routable: match.groups.model ? match[1] : match[0]
+  };
+}
+function trimStainlessPath(stainlessPath) {
+  return stainlessPath.replace(/ > \([^\s]+\)$/, "");
+}
+function getResource(stainlessPath) {
+  const parsed = parseStainlessPath(stainlessPath);
+  return parsed?.resource[0];
+}
+function parseRoute(basePath, route) {
+  if (!route.startsWith(basePath)) return { stainlessPath: "", language: DefaultLanguage };
+  if (basePath && route.startsWith(basePath)) route = route.slice(basePath.length);
+  let stainlessPath = "";
+  let elements = route.slice(1).split("/");
+  let language = DefaultLanguage;
+  if (elements[0] && Languages.includes(elements[0])) {
+    language = elements[0];
+    elements = elements.slice(1);
+  }
+  while (elements.length > 0) {
+    const element = elements.shift();
+    switch (element) {
+      case "resources":
+        stainlessPath += `(resource) ${elements.shift()}`;
+        break;
+      case "subresources":
+        stainlessPath += `.${elements.shift()}`;
+        break;
+      case "methods":
+        stainlessPath += ` > (method) ${elements.shift()}`;
+        break;
+    }
+  }
+  return { stainlessPath, language };
+}
+function generateRoute(basePath, language, stainlessPath) {
+  const parsedPath = parseStainlessPath(stainlessPath);
+  if (!parsedPath) return null;
+  const path = [basePath.endsWith("/") ? basePath.slice(0, -1) : basePath];
+  if (language && language !== DefaultLanguage) path.push(language);
+  const resources = parsedPath.resource.flatMap((name, index) => [
+    index > 0 ? "subresources" : "resources",
+    name
+  ]);
+  const resourcePath = parsedPath.model ? resources.slice(0, 2) : resources;
+  path.push(...resourcePath);
+  if (parsedPath.method) path.push("methods", parsedPath.method);
+  return stainlessPath.length > parsedPath.routable.length ? `${path.join("/")}#${encodeURIComponent(stainlessPath)}` : path.join("/");
+}
+function* walkResource(resource, path, includeModels) {
+  yield { data: resource, path };
+  for (const data of Object.values(resource.methods)) {
+    yield { data, path: [...path, "methods", data.name] };
+  }
+  if (includeModels)
+    for (const data of Object.values(resource.models)) {
+      yield { data, path: [...path, "models", data.name] };
+    }
+  for (const data of Object.values(resource.subresources ?? {})) {
+    yield* walkResource(data, [...path, "subresources", data.name]);
+  }
+}
+function* walkTree(spec, includeModels) {
+  for (const data of Object.values(spec.resources)) {
+    yield* walkResource(data, ["resources", data.name], includeModels);
+  }
+}
+function generateRouteList({
+  spec,
+  languages,
+  excludeLanguages = []
+}) {
+  const entries = Array.from(walkTree(spec));
+  const langs = languages ?? spec.docs?.languages ?? ["http"];
+  return langs.filter((lang) => Languages.includes(lang) && lang !== "terraform").filter((lang) => !excludeLanguages?.includes(lang)).flatMap(
+    (language) => entries.map(({ path, data: { title, kind, stainlessPath } }) => ({
+      title,
+      kind,
+      language,
+      stainlessPath,
+      slug: (language === "http" ? path : [language, ...path]).join("/")
+    }))
+  );
+}
+function findNavigationPath(items, target) {
+  for (const item of Object.values(items)) {
+    if (item.stainlessPath === target) return [item.stainlessPath];
+    if (item.kind === "http_method") continue;
+    const path = findNavigationPath(
+      [...Object.values(item.methods ?? {}), ...Object.values(item.subresources ?? {})],
+      target
+    );
+    if (path) return [item.stainlessPath, ...path];
+  }
+}
+function expandToElement(el) {
+  while (el) {
+    if (el.tagName === "DETAILS") el["open"] = true;
+    el = el.parentElement;
+  }
+}
+function scrollToPath(stainlessPath) {
+  const el = document.getElementById(stainlessPath);
+  if (el) {
+    expandToElement(el);
+    el.scrollIntoView({ behavior: "smooth" });
+  }
+}
+function updateHistory(basePath, language, stainlessPath) {
+  const path = generateRoute(basePath, language, stainlessPath);
+  window.history.pushState({ stainlessPath, language }, "", path);
+}
+export {
+  LanguageNames,
+  Languages,
+  SupportedLanguageSyntaxes,
+  expandToElement,
+  findNavigationPath,
+  generateRoute,
+  generateRouteList,
+  getLanguageSnippet,
+  getResource,
+  isSupportedLanguage,
+  parseRoute,
+  parseStainlessPath,
+  scrollToPath,
+  trimStainlessPath,
+  updateHistory,
+  walkTree
+};

package/dist/styles/main.css

@@ -1,7 +1,7 @@
 /* Overview page content */
 .stldocs-root .stldocs-overview {
   .stldocs-overview-header {
-    padding: var(--stldocs-title-padding-y) var(--stldocs-content-padding) var(--stldocs-content-padding);
+    padding: var(--stldocs-title-padding-y) 0;
 
     & > * {
       max-width: var(--stldocs-content-width);
@@ -27,7 +27,6 @@
 
     .stldocs-resource-content {
       max-width: var(--stldocs-content-width);
-      padding: 0 calc(var(--stldocs-content-padding));
       margin: auto 0;
     }
 
@@ -534,7 +533,7 @@
     gap: 2rem;
     grid-template-columns: minmax(0, 1fr);
     grid-template-rows: repeat(4, auto);
-    padding: var(--stldocs-content-padding) 0 var(--stldocs-content-padding) var(--stldocs-content-padding);
+    padding: var(--stldocs-content-padding) 0;
 
     .stldocs-method-description p {
       color: var(--stldocs-color-text-secondary);
@@ -874,11 +873,6 @@ starlight-theme-select select {
 @media (max-width: 50rem) {
   .stldocs-root .stldocs-method-body {
     padding: 1rem var(--stldocs-content-padding) !important;
-
-    .stldocs-method-parameters,
-    .stldocs-method-returns {
-      margin-left: 0 !important;
-    }
   }
 
   .stldocs-root .stldocs-resource .stldocs-resource-content {
@@ -899,6 +893,14 @@ starlight-theme-select select {
   }
 }
 
+@media (min-width: 50rem) {
+  .stldocs-root .stldocs-method {
+    .stldocs-method-header {
+      padding: var(--stldocs-title-padding-y) 0;
+    }
+  }
+}
+
 @media (min-width: 1280px) {
   .stldocs-root {
     .stldocs-method.stldocs-method-double-pane .stldocs-method-content-column {
@@ -984,4 +986,3 @@ starlight-theme-select select {
     }
   }
 }
-

package/dist/styles/primitives.css

@@ -578,4 +578,3 @@
     }
   }
 }
-

package/dist/styles/resets.css

@@ -37,4 +37,3 @@
     margin-top: 0;
   }
 }
-

package/dist/styles/search.css

@@ -339,4 +339,3 @@
     transform: rotate(360deg);
   }
 }
-

package/dist/styles/sidebar.css

@@ -83,4 +83,3 @@
     }
   }
 }
-

package/dist/styles/snippets.css

@@ -128,4 +128,3 @@
     }
   }
 }
-

package/dist/styles/variables.css

@@ -84,4 +84,3 @@
   --stldocs-expander-right-margin: 8px;
   --stldocs-title-padding-y: 2.5rem;
 }
-

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.11",
+  "version": "0.1.0-beta.13",
   "publishConfig": {
     "access": "public"
   },
@@ -20,7 +20,7 @@
     "lucide-react": "^0.544.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "@stainless-api/ui-primitives": "0.1.0-beta.12"
+    "@stainless-api/ui-primitives": "0.1.0-beta.14"
   },
   "devDependencies": {
     "@types/node": "^24.4.0",

package/src/components/overview.tsx

@@ -89,13 +89,11 @@ export function SDKResource({ resource, parents, showModels }: SDKResourceProps
         <Docs.SDKResourceHeader resource={resource} parents={parents} />
         {methods.length > 0 && (
           <div className={style.ResourceContentGroup}>
-            {methods
-              .toSorted((first, second) => first.name.localeCompare(second.name))
-              .map((method) => (
-                <div className={style.MethodSummary} key={method.stainlessPath}>
-                  <Docs.SDKMethodSummary method={method} />
-                </div>
-              ))}
+            {methods.map((method) => (
+              <div className={style.MethodSummary} key={method.stainlessPath}>
+                <Docs.SDKMethodSummary method={method} />
+              </div>
+            ))}
           </div>
         )}
 

package/src/styles/main.css

@@ -1,7 +1,7 @@
 /* Overview page content */
 .stldocs-root .stldocs-overview {
   .stldocs-overview-header {
-    padding: var(--stldocs-title-padding-y) var(--stldocs-content-padding) var(--stldocs-content-padding);
+    padding: var(--stldocs-title-padding-y) 0;
 
     & > * {
       max-width: var(--stldocs-content-width);
@@ -27,7 +27,6 @@
 
     .stldocs-resource-content {
       max-width: var(--stldocs-content-width);
-      padding: 0 calc(var(--stldocs-content-padding));
       margin: auto 0;
     }
 
@@ -534,7 +533,7 @@
     gap: 2rem;
     grid-template-columns: minmax(0, 1fr);
     grid-template-rows: repeat(4, auto);
-    padding: var(--stldocs-content-padding) 0 var(--stldocs-content-padding) var(--stldocs-content-padding);
+    padding: var(--stldocs-content-padding) 0;
 
     .stldocs-method-description p {
       color: var(--stldocs-color-text-secondary);
@@ -874,11 +873,6 @@ starlight-theme-select select {
 @media (max-width: 50rem) {
   .stldocs-root .stldocs-method-body {
     padding: 1rem var(--stldocs-content-padding) !important;
-
-    .stldocs-method-parameters,
-    .stldocs-method-returns {
-      margin-left: 0 !important;
-    }
   }
 
   .stldocs-root .stldocs-resource .stldocs-resource-content {
@@ -899,6 +893,14 @@ starlight-theme-select select {
   }
 }
 
+@media (min-width: 50rem) {
+  .stldocs-root .stldocs-method {
+    .stldocs-method-header {
+      padding: var(--stldocs-title-padding-y) 0;
+    }
+  }
+}
+
 @media (min-width: 1280px) {
   .stldocs-root {
     .stldocs-method.stldocs-method-double-pane .stldocs-method-content-column {

package/src/utils.ts

@@ -5,15 +5,13 @@ export function flatResources(
   resources: Record<string, SDKJSON.Resource>,
   parents: SDKJSON.Resource[],
 ): { resource: SDKJSON.Resource; parents: SDKJSON.Resource[] }[] {
-  return Object.keys(resources)
-    .toSorted()
-    .flatMap((key: string | number) => {
-      const resource = resources[key]!;
-      return [
-        { resource, parents },
-        ...(resource.subresources ? flatResources(resource.subresources, [...parents, resource]) : []),
-      ];
-    });
+  return Object.keys(resources).flatMap((key: string | number) => {
+    const resource = resources[key]!;
+    return [
+      { resource, parents },
+      ...(resource.subresources ? flatResources(resource.subresources, [...parents, resource]) : []),
+    ];
+  });
 }
 
 export function getResourceFromSpec(

package/dist/styles/main.js

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

package/dist/styles/primitives.js

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

package/dist/styles/resets.js

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

package/dist/styles/search.js

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

package/dist/styles/sidebar.js

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

package/dist/styles/snippets.js

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

package/dist/styles/variables.js

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