@stainless-api/docs-ui 0.1.0-beta.12 → 0.1.0-beta.14

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
+};