@stainless-api/docs-ui 0.1.0-beta.1 → 0.1.0-beta.10

package/dist/routing.d.ts

@@ -0,0 +1,44 @@
+import type { SDKJSON } from './types/sdkjson';
+export declare const Languages: readonly ["http", "node", "python", "go", "typescript", "terraform", "ruby", "java", "kotlin"];
+export declare const SupportedLanguageSyntaxes: string[];
+export type DocsLanguage = (typeof Languages)[number];
+export declare const LanguageNames: Record<DocsLanguage, string>;
+export declare function getLanguageSnippet(language: DocsLanguage): "node.default" | "go.default" | "python.default" | "terraform.default" | "http.curl" | "typescript.default" | "ruby.default" | "java.default" | "kotlin.default";
+export declare function isSupportedLanguage(language: string): language is DocsLanguage;
+export type ParsedStainlessPath = ReturnType<typeof parseStainlessPath>;
+export declare function parseStainlessPath(stainlessPath: string): {
+    resource: string[];
+    method: string | null;
+    model: string | null;
+    routable: string | undefined;
+} | null;
+export declare function trimStainlessPath(stainlessPath: string): string;
+export declare function getResource(stainlessPath: string): string | undefined;
+export declare function parseRoute(basePath: string, route: string): {
+    stainlessPath: string;
+    language: DocsLanguage;
+};
+export declare function generateRoute(basePath: string, language: string, stainlessPath: string): string | null;
+export type SpecTreeEntry = {
+    data: SDKJSON.Method | SDKJSON.Resource | SDKJSON.Model;
+    path: string[];
+};
+export declare function walkTree(spec: SDKJSON.Spec, includeModels?: boolean): Generator<SpecTreeEntry, void, any>;
+export type RouteEntry = {
+    title: string;
+    kind: SpecTreeEntry['data']['kind'];
+    language: DocsLanguage;
+    stainlessPath: string;
+    slug: string;
+};
+export declare function generateRouteList({ spec, languages, excludeLanguages, }: {
+    spec: SDKJSON.Spec;
+    languages?: DocsLanguage[];
+    excludeLanguages?: DocsLanguage[];
+}): RouteEntry[];
+type ResourceOrMethod = SDKJSON.Resource | SDKJSON.Method;
+export declare function findNavigationPath(items: ResourceOrMethod[], target: string): any;
+export declare function expandToElement(el: HTMLElement): void;
+export declare function scrollToPath(stainlessPath: string): void;
+export declare function updateHistory(basePath: string, language: DocsLanguage, stainlessPath: string): void;
+export {};

package/dist/routing.js

@@ -1,180 +1,169 @@
-// src/routing.ts
-var Languages = [
-  "http",
-  "node",
-  "python",
-  "go",
-  "typescript",
-  "terraform",
-  "ruby",
-  "java",
-  "kotlin"
+export const Languages = [
+    'http',
+    'node',
+    'python',
+    'go',
+    'typescript',
+    'terraform',
+    'ruby',
+    'java',
+    'kotlin',
 ];
-var SupportedLanguageSyntaxes = [
-  "http",
-  "javascript",
-  "python",
-  "go",
-  "typescript",
-  "terraform",
-  "ruby",
-  "java",
-  "kotlin"
+export const 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"
+export const 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`;
+export function getLanguageSnippet(language) {
+    return language === 'http' ? 'http.curl' : `${language}.default`;
 }
-function isSupportedLanguage(language) {
-  return Languages.includes(language);
+export 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]
-  };
+const DefaultLanguage = 'http';
+const StainlessPathPattern = /(\(resource\) (?<resource>[^\s]+))( > (\(method\) (?<method>[^\s]+)|\(model\) (?<model>[^\s]+))?)?/;
+export 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]+\)$/, "");
+export function trimStainlessPath(stainlessPath) {
+    return stainlessPath.replace(/ > \([^\s]+\)$/, '');
 }
-function getResource(stainlessPath) {
-  const parsed = parseStainlessPath(stainlessPath);
-  return parsed?.resource[0];
+export 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;
+export 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);
     }
-  }
-  return { stainlessPath, language };
+    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("/");
+export 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,
+    ]);
+    // Ensure model links always go to top-level resource page
+    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] };
+    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]);
     }
-  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);
-  }
+export 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("/")
-    }))
-  );
+export 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];
-  }
+export 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;
-  }
+export 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" });
-  }
+export 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 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
-};
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM;IACN,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,WAAW;IACX,MAAM;IACN,MAAM;IACN,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,WAAW;IACX,MAAM;IACN,MAAM;IACN,QAAQ;CACT,CAAC;AAIF,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAE,WAAqB,CAAC,CAAC,CAAE,GAAG,QAAQ,UAAoB,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAwB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAM,oBAAoB,GACxB,oGAAoG,CAAC;AAIvG,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAExD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI;QACnC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI;QACjC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,aAAqB;IACrD,OAAO,aAAa,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,aAAqB;IAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,KAAa;IAEb,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAEzF,IAAI,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEjF,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,QAAQ,GAAiB,eAAe,CAAC;IAE7C,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAiB,CAAC,EAAE,CAAC;QACnE,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAiB,CAAC;QACvC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjC,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,WAAW;gBACd,aAAa,IAAI,cAAc,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;gBAClD,MAAM;YAER,KAAK,cAAc;gBACjB,aAAa,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxC,MAAM;YAER,KAAK,SAAS;gBACZ,aAAa,IAAI,eAAe,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;gBACnD,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAgB,EAAE,aAAqB;IACrF,MAAM,UAAU,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzE,IAAI,QAAQ,IAAI,QAAQ,KAAK,eAAe;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElE,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7D,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;QACxC,IAAI;KACL,CAAC,CAAC;IAEH,0DAA0D;IAC1D,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAE3B,IAAI,UAAU,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE/D,OAAO,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM;QACtD,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,aAAa,CAAC,EAAE;QAC1D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAOD,QAAQ,CAAC,CAAC,YAAY,CACpB,QAA0B,EAC1B,IAAc,EACd,aAAuB;IAEvB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,aAAa;QACf,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,MAAM,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAkB,EAAE,aAAuB;IACnE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAUD,MAAM,UAAU,iBAAiB,CAAC,EAChC,IAAI,EACJ,SAAS,EACT,gBAAgB,GAAG,EAAE,GAKtB;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,WAAW,CAAC;SAClE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;SACnD,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACpB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/D,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,aAAa;QACb,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KACnE,CAAC,CAAC,CACJ,CAAC;AACN,CAAC;AAID,MAAM,UAAU,kBAAkB,CAAC,KAAyB,EAAE,MAAc;IAC1E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;YAAE,SAAS;QAE1C,MAAM,IAAI,GAAG,kBAAkB,CAC7B,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,EACjF,MAAM,CACP,CAAC;QAEF,IAAI,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAe;IAC7C,OAAO,EAAE,EAAE,CAAC;QACV,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS;YAAE,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAChD,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAAqB;IAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,EAAE,EAAE,CAAC;QACP,eAAe,CAAC,EAAE,CAAC,CAAC;QACpB,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAsB,EAAE,aAAqB;IAC3F,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/search/form.d.ts

@@ -0,0 +1,13 @@
+import { QueryKindsType, ResultData } from './types';
+export declare function SearchForm(): import("react/jsx-runtime").JSX.Element;
+export type SearchFilterProps = {
+    results: ResultData;
+    filterKind: QueryKindsType;
+    onChange: (filterKind?: QueryKindsType) => void;
+};
+export declare function SearchFilter({ results, filterKind, onChange }: SearchFilterProps): import("react/jsx-runtime").JSX.Element;
+export type SearchModalProps = {
+    id?: string;
+    open?: boolean;
+};
+export declare function SearchModal({ id, open: isOpen }: SearchModalProps): import("react/jsx-runtime").JSX.Element;

package/dist/search/form.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { Search as SearchIcon, X as XIcon } from 'lucide-react';
+import { QueryKinds } from './types';
+import { GuideResult, QueryKindDisplay, SearchResult } from './results';
+import { guideSearch } from './providers/pagefind';
+import { useLanguage, useSearch, useSearchContext } from '../contexts';
+import { useComponents } from '../contexts/use-components';
+import style from '../style';
+export function SearchForm() {
+    const Docs = useComponents();
+    const search = useSearch();
+    const language = useLanguage();
+    const { onSelect, pageFind } = useSearchContext();
+    const [results, setResults] = React.useState(null);
+    const [filterKind, setFilterKind] = React.useState('all');
+    const [searchQuery, setSearchQuery] = React.useState('');
+    const inputRef = React.useRef(null);
+    async function performSearch() {
+        const guideLimit = filterKind === 'guide' ? 25 : 5;
+        const kind = ['all', 'guide'].includes(filterKind) ? undefined : filterKind;
+        const [guideResults, apiResults] = await Promise.all([
+            pageFind ? guideSearch(pageFind, searchQuery, guideLimit) : [],
+            search({ query: searchQuery, kind, language }),
+        ]);
+        setResults({
+            items: filterKind === 'guide' ? guideResults : [...guideResults, ...apiResults.hits],
+            counts: {
+                ...apiResults.facets?.['kind'],
+                guide: guideResults.length,
+                all: apiResults.nbHits,
+            },
+        });
+    }
+    function clearInput() {
+        setSearchQuery('');
+        inputRef?.current?.focus();
+    }
+    React.useEffect(() => void performSearch(), [searchQuery, filterKind, language]);
+    return (_jsxs("div", { className: style.SearchForm, children: [_jsx(Docs.Input, { ref: inputRef, autoFocus: true, onChange: (ev) => setSearchQuery(ev.target.value), left: _jsx(SearchIcon, { size: 16, className: style.Icon }), right: searchQuery && (_jsx(XIcon, { cursor: "pointer", onClick: () => clearInput(), size: 16, className: style.Icon })), value: searchQuery, placeholder: "Search" }), _jsx(SearchFilter, { results: results, filterKind: filterKind, onChange: (filterKind) => setFilterKind(filterKind) }), _jsx(Docs.ListView, { items: results?.items ?? [], itemDelegate: (item) => 'kind' in item ? _jsx(SearchResult, { result: item }) : _jsx(GuideResult, { result: item }), onSelectListItem: (item) => onSelect?.(item['data']?.['url'] ?? item['stainlessPath']) })] }));
+}
+export function SearchFilter({ results, filterKind, onChange }) {
+    const Docs = useComponents();
+    const { pageFind } = useSearchContext();
+    const toggles = pageFind ? QueryKinds : QueryKinds.slice(0, -1);
+    return (_jsx("div", { className: style.SearchFilter, children: toggles.map((kind, index) => (_jsxs(Docs.ToggleButton, { selected: filterKind === kind, onClick: () => onChange?.(kind), children: [React.createElement(QueryKindDisplay[kind].icon, {
+                    size: 16,
+                    className: style.Icon,
+                }), QueryKindDisplay[kind].name, _jsx("span", { className: style.SearchFilterCount, children: results?.counts?.[kind] ?? 0 })] }, index))) }));
+}
+export function SearchModal({ id, open: isOpen }) {
+    const [open, setOpen] = React.useState(isOpen);
+    return (_jsx("div", { id: id, onToggle: (ev) => setOpen(ev.newState === 'open'), className: style.SearchModal, popover: "auto", "data-stldocs-modal-open": open, children: open && _jsx(SearchForm, {}) }));
+}
+//# sourceMappingURL=form.js.map

package/dist/search/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/search/form.tsx"],"names":[],"mappings":"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"}

package/dist/search/index.d.ts

@@ -0,0 +1 @@
+export * from './form';

package/dist/search/index.js

@@ -0,0 +1,2 @@
+export * from './form';
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.tsx"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/search/indexer.d.ts

@@ -0,0 +1,31 @@
+import type { SDKJSON } from '../types/sdkjson';
+import type { IndexEntry } from './types';
+export declare function getResourceNames(resourceIds: string[], topResources?: Record<string, SDKJSON.Resource>): string[];
+export declare function generateChatIndex(spec: SDKJSON.Spec): Generator<{
+    language: string;
+    title: string;
+    content: string;
+    url: string;
+    name?: undefined;
+    endpoint?: undefined;
+    httpMethod?: undefined;
+    summary?: undefined;
+    description?: undefined;
+    stainlessPath?: undefined;
+    qualified?: undefined;
+    ident?: undefined;
+} | {
+    language: "node" | "go" | "python" | "terraform" | "http" | "typescript" | "ruby" | "java" | "kotlin";
+    title: string;
+    name: string;
+    endpoint: string;
+    httpMethod: string;
+    summary: string | undefined;
+    description: string | undefined;
+    stainlessPath: string;
+    qualified: any;
+    ident: any;
+    content: string;
+    url: string | null;
+}, void, unknown>;
+export declare function generateIndex(spec: SDKJSON.Spec, renderMarkdownFn?: (string?: any) => string | null, includeTypes?: boolean): Generator<IndexEntry>;