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

package/dist/search/indexer.js

@@ -0,0 +1,212 @@
+import { generateRoute, Languages, parseStainlessPath, walkTree } from '../routing';
+import * as printer from './printer';
+import { renderMarkdown } from '../markdown';
+// function sanitizeTerraformType(key: string, value: any) {
+//   return typeof value === "number" && !Number.isSafeInteger(value)
+//     ? value.toString()
+//     : value;
+// }
+export function getResourceNames(resourceIds, topResources) {
+    let element = undefined;
+    let resources = topResources;
+    const resourceName = [];
+    for (const resource of resourceIds) {
+        element = resources?.[resource];
+        if (!element)
+            break;
+        resourceName.push(element.title);
+        resources = element?.subresources;
+    }
+    return resourceName;
+}
+function chunkByLines(content, maxSize = 60000) {
+    if (Buffer.byteLength(content, 'utf8') < maxSize)
+        return [content];
+    const lines = content.split('\n');
+    const chunks = [];
+    let currentChunk = [];
+    let currentSize = 0;
+    for (const line of lines) {
+        const lineSize = Buffer.byteLength(line + '\n', 'utf8');
+        if (currentSize + lineSize > maxSize) {
+            chunks.push(currentChunk.join('\n'));
+            currentChunk = [];
+            currentSize = 0;
+        }
+        currentChunk.push(line);
+        currentSize += lineSize;
+    }
+    if (currentChunk.length > 0)
+        chunks.push(currentChunk.join('\n'));
+    return chunks;
+}
+export function* generateChatIndex(spec) {
+    for (const [language, readme] of Object.entries(spec.readme)) {
+        const chunks = chunkByLines(readme);
+        for (const chunk of chunks) {
+            yield {
+                language,
+                title: 'Overview',
+                content: chunk,
+                url: `docs://BASE_PATH/${language}`,
+            };
+        }
+    }
+    for (const { data } of walkTree(spec)) {
+        if (data.kind !== 'http_method')
+            continue;
+        const { title, name, stainlessPath, httpMethod, summary, description } = data;
+        const endpoint = data.endpoint.slice(httpMethod.length).trim();
+        for (const language of Languages) {
+            const decl = spec.decls[language]?.[stainlessPath];
+            if (!decl)
+                continue;
+            const env = {
+                spec,
+                language,
+                options: {
+                    includeModelProperties: true,
+                },
+            };
+            const content = renderMarkdown(env, data);
+            const chunks = chunkByLines(content);
+            for (const chunk of chunks) {
+                yield {
+                    language,
+                    title,
+                    name,
+                    endpoint,
+                    httpMethod,
+                    summary,
+                    description,
+                    stainlessPath,
+                    qualified: decl['qualified'],
+                    ident: decl['ident'],
+                    content: chunk,
+                    url: generateRoute('docs://BASE_PATH', language, stainlessPath),
+                };
+            }
+        }
+    }
+}
+export function* generateIndex(spec, renderMarkdownFn, includeTypes) {
+    const parentCrumbs = {};
+    for (const { data } of walkTree(spec, true)) {
+        const { kind, name, title, stainlessPath } = data;
+        const common = { name, title, stainlessPath };
+        const parsedPath = parseStainlessPath(stainlessPath);
+        const crumbs = getResourceNames(parsedPath.resource, spec.resources);
+        switch (kind) {
+            case 'resource':
+                for (const language of Languages) {
+                    if (!data[language])
+                        continue;
+                    parentCrumbs[stainlessPath] = crumbs;
+                    const { Name, QualifiedName } = data[language];
+                    yield {
+                        kind,
+                        crumbs,
+                        language,
+                        Name,
+                        QualifiedName,
+                        priority: 0,
+                        ...common,
+                    };
+                }
+                break;
+            case 'http_method': {
+                const { summary, endpoint, httpMethod } = data;
+                for (const language of Languages) {
+                    const found = spec.decls[language]?.[stainlessPath];
+                    if (!found)
+                        continue;
+                    parentCrumbs[stainlessPath] = [...crumbs, title];
+                    const qualified = found['qualified'];
+                    const ident = qualified?.split('.')?.at(-1);
+                    yield {
+                        kind,
+                        crumbs: [...crumbs, title],
+                        ident,
+                        qualified,
+                        language,
+                        description: renderMarkdownFn?.(data.description) ?? data.description,
+                        endpoint: endpoint.slice(httpMethod.length).trim(),
+                        httpMethod,
+                        summary,
+                        priority: 0,
+                        ...common,
+                    };
+                }
+                break;
+            }
+            case 'model':
+                for (const language of Languages) {
+                    if (!spec.decls[language])
+                        continue;
+                    parentCrumbs[stainlessPath] = [...crumbs, title];
+                    const schema = spec.decls[language]?.[`${stainlessPath} > (schema)`];
+                    const children = schema?.['children']
+                        ?.map((childPath) => {
+                        const child = spec.decls?.[language]?.[childPath];
+                        return (child?.['ident'] ??
+                            child?.['name'] ??
+                            child?.['key'] ??
+                            child?.['type']?.['literal']?.['value'] ??
+                            child?.['type']?.['literal'] ??
+                            child?.['type']?.['value']);
+                    })
+                        ?.filter((child) => child) ?? [];
+                    yield {
+                        kind,
+                        crumbs: [...crumbs, title],
+                        children,
+                        language,
+                        priority: 2,
+                        ident: schema?.['ident'],
+                        ...common,
+                    };
+                }
+        }
+    }
+    for (const language of Languages) {
+        const decls = spec.decls?.[language];
+        if (!decls)
+            continue;
+        for (const decl of Object.values(decls)) {
+            switch (decl.kind) {
+                // case "TerraformDeclAttribute":
+                case 'JavaDeclProperty':
+                case 'GoDeclProperty':
+                case 'PythonDeclProperty':
+                case 'RubyDeclProperty':
+                case 'HttpDeclProperty':
+                case 'TSDeclProperty':
+                    {
+                        const parsedPath = parseStainlessPath(decl.stainlessPath);
+                        const type = includeTypes === false ? undefined : printer.typeName(language, decl.type);
+                        const name = decl['ident'] ?? decl['name'] ?? decl['key'];
+                        const parent = parentCrumbs[parsedPath.routable];
+                        // Filter out properties of non-routable response types
+                        if (parent === undefined)
+                            continue;
+                        const matches = decl.stainlessPath.matchAll(/\((property|params|param)\) ([^\s]+)/g);
+                        const props = Array.from(matches)
+                            .map((p) => p[2])
+                            .filter((p) => p !== undefined);
+                        yield {
+                            kind: 'property',
+                            name,
+                            stainlessPath: decl.stainlessPath,
+                            crumbs: [...parent, ...props],
+                            docstring: renderMarkdownFn?.(decl.docstring) ?? decl.docstring,
+                            type,
+                            language,
+                            priority: 3,
+                        };
+                    }
+                    break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/search/indexer.js.map

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

package/dist/search/mcp.d.ts

@@ -0,0 +1,8 @@
+import { DocsLanguage } from '../routing';
+import { buildIndex } from './providers/fuse';
+import type { IndexEntry } from './types';
+import type { SDKJSON } from '../types/sdkjson';
+export declare function consolidate(results: IndexEntry[]): string[];
+export declare function render(spec: SDKJSON.Spec, language: DocsLanguage, items: IndexEntry[], includeModelProperties: boolean): any;
+export declare function searchAndRender(spec: SDKJSON.Spec, language: DocsLanguage, query: string, limit?: number, includeModelProperties?: boolean): any;
+export { buildIndex };

package/dist/search/mcp.js

@@ -0,0 +1,43 @@
+import { renderMarkdown } from '../markdown';
+import { parseStainlessPath } from '../routing';
+import { getResourceFromSpec } from '../utils';
+import { buildIndex, search } from './providers/fuse';
+export function consolidate(results) {
+    const resources = new Set();
+    const methods = new Set();
+    for (const entry of results) {
+        const parsed = parseStainlessPath(entry.stainlessPath);
+        if (parsed.method)
+            methods.add(parsed.routable);
+        else
+            resources.add(parsed.routable);
+    }
+    const filtered = Array.from(methods).filter((path) => !resources.has(path.split(' >').at(0)));
+    return [...resources, ...filtered];
+}
+export function render(spec, language, items, includeModelProperties) {
+    const env = {
+        spec,
+        language,
+        options: {
+            renderNestedResources: false,
+            includeModelProperties,
+        },
+    };
+    const paths = consolidate(items);
+    const output = paths.map((entry) => {
+        const parsed = parseStainlessPath(entry);
+        const resource = getResourceFromSpec(parsed.resource, spec);
+        const target = parsed.method ? resource.methods[parsed.method] : resource;
+        const content = renderMarkdown(env, target);
+        return [entry, content];
+    });
+    return Object.fromEntries(output);
+}
+export function searchAndRender(spec, language, query, limit, includeModelProperties = false) {
+    const idx = buildIndex(spec, language);
+    const results = search(idx, query, limit).map(({ item }) => item);
+    return render(spec, language, results, includeModelProperties);
+}
+export { buildIndex };
+//# sourceMappingURL=mcp.js.map

package/dist/search/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/search/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAgB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAItD,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;;YAC3C,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,IAAkB,EAClB,QAAsB,EACtB,KAAmB,EACnB,sBAA+B;IAE/B,MAAM,GAAG,GAAG;QACV,IAAI;QACJ,QAAQ;QACR,OAAO,EAAE;YACP,qBAAqB,EAAE,KAAK;YAC5B,sBAAsB;SACvB;KACF,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1E,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAkB,EAClB,QAAsB,EACtB,KAAa,EACb,KAAc,EACd,yBAAkC,KAAK;IAEvC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC;AACjE,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/search/printer.d.ts

@@ -0,0 +1,6 @@
+import type { SDKJSON } from '../types/sdkjson';
+import type { DocsLanguage } from '../routing';
+export declare function typeName(language: DocsLanguage, type: SDKJSON.Type): string;
+export declare function type(language: DocsLanguage, type: SDKJSON.Type): string;
+export declare function declaration(language: DocsLanguage, decl: SDKJSON.DeclarationNode): string;
+export declare function methodSignature(language: DocsLanguage, decl: SDKJSON.DeclarationNode): string;

package/dist/search/printer.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { renderToStaticMarkup } from 'react-dom/server';
+import { DocsProvider, useLanguageComponents } from '../contexts';
+import style from '../style';
+import { ComponentProvider } from '../contexts/component';
+function Providers({ language, children }) {
+    return (_jsx(DocsProvider, { spec: null, language: language, children: _jsx(ComponentProvider, { components: {
+                SDKReference({ stainlessPath, children }) {
+                    if (!stainlessPath)
+                        return children;
+                    return _jsx("span", { className: style.TypeReference, children: children });
+                },
+            }, children: children }) }));
+}
+function RenderType({ type, full }) {
+    const { Type, TypeName } = useLanguageComponents();
+    return full ? _jsx(Type, { type: type }) : _jsx(TypeName, { type: type });
+}
+export function typeName(language, type) {
+    const component = (_jsx(Providers, { language: language, children: _jsx(RenderType, { type: type }) }));
+    return renderToStaticMarkup(component);
+}
+export function type(language, type) {
+    const component = (_jsx(Providers, { language: language, children: _jsx(RenderType, { type: type, full: true }) }));
+    return renderToStaticMarkup(component);
+}
+function RenderDeclaration({ decl }) {
+    const { Declaration } = useLanguageComponents();
+    return _jsx(Declaration, { decl: decl });
+}
+export function declaration(language, decl) {
+    const component = (_jsx(Providers, { language: language, children: _jsx(RenderDeclaration, { decl: decl }) }));
+    return renderToStaticMarkup(component);
+}
+function RenderMethod({ method }) {
+    const { MethodSignature } = useLanguageComponents();
+    return _jsx(MethodSignature, { decl: method });
+}
+export function methodSignature(language, decl) {
+    const component = (_jsx(Providers, { language: language, children: _jsx(RenderMethod, { method: decl }) }));
+    return renderToStaticMarkup(component);
+}
+//# sourceMappingURL=printer.js.map

package/dist/search/printer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.js","sourceRoot":"","sources":["../../src/search/printer.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,MAAM,UAAU,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO1D,SAAS,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAkB;IACvD,OAAO,CACL,KAAC,YAAY,IAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,YAC1C,KAAC,iBAAiB,IAChB,UAAU,EAAE;gBACV,YAAY,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE;oBACtC,IAAI,CAAC,aAAa;wBAAE,OAAO,QAAQ,CAAC;oBACpC,OAAO,eAAM,SAAS,EAAE,KAAK,CAAC,aAAa,YAAG,QAAQ,GAAQ,CAAC;gBACjE,CAAC;aACF,YAEA,QAAQ,GACS,GACP,CAChB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAA0C;IACxE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACnD,OAAO,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC,CAAC,CAAC,KAAC,QAAQ,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAsB,EAAE,IAAkB;IACjE,MAAM,SAAS,GAAG,CAChB,KAAC,SAAS,IAAC,QAAQ,EAAE,QAAQ,YAC3B,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,GAAI,GAChB,CACb,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,QAAsB,EAAE,IAAkB;IAC7D,MAAM,SAAS,GAAG,CAChB,KAAC,SAAS,IAAC,QAAQ,EAAE,QAAQ,YAC3B,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAI,GAC5B,CACb,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAE,IAAI,EAAqC;IACpE,MAAM,EAAE,WAAW,EAAE,GAAG,qBAAqB,EAAE,CAAC;IAChD,OAAO,KAAC,WAAW,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAsB,EAAE,IAA6B;IAC/E,MAAM,SAAS,GAAG,CAChB,KAAC,SAAS,IAAC,QAAQ,EAAE,QAAQ,YAC3B,KAAC,iBAAiB,IAAC,IAAI,EAAE,IAAI,GAAI,GACvB,CACb,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,MAAM,EAAuC;IACnE,MAAM,EAAE,eAAe,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACpD,OAAO,KAAC,eAAe,IAAC,IAAI,EAAE,MAAM,GAAI,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAsB,EAAE,IAA6B;IACnF,MAAM,SAAS,GAAG,CAChB,KAAC,SAAS,IAAC,QAAQ,EAAE,QAAQ,YAC3B,KAAC,YAAY,IAAC,MAAM,EAAE,IAAI,GAAI,GACpB,CACb,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC"}

package/dist/search/providers/algolia.d.ts

@@ -0,0 +1,8 @@
+import type { SDKJSON } from '../../types/sdkjson';
+import type { SearchSettings, SearchParams, ResultType } from '../types';
+export declare function buildIndex(appId: string, indexName: string, writeKey: string, spec: SDKJSON.Spec, renderMarkdown: (string?: any) => string | null): Promise<void>;
+export declare function buildChatIndex(appId: string, indexName: string, writeKey: string, spec: SDKJSON.Spec): Promise<void>;
+export declare function search({ settings: { appId, indexName, searchKey }, params: { query, language, kind }, }: {
+    params: SearchParams;
+    settings: SearchSettings;
+}): Promise<ResultType | undefined>;

package/dist/search/providers/algolia.js

@@ -0,0 +1,64 @@
+import { searchClient } from '@algolia/client-search';
+import { generateChatIndex, generateIndex } from '../indexer';
+import { SearchableAttributes, SearchableAttributesChat } from '../types';
+export async function buildIndex(appId, indexName, writeKey, spec, renderMarkdown) {
+    if (!appId || !indexName || !writeKey)
+        return;
+    const objects = Array.from(generateIndex(spec, renderMarkdown));
+    const client = searchClient(appId, writeKey);
+    await client.setSettings({
+        indexName,
+        indexSettings: {
+            highlightPreTag: '<mark>',
+            highlightPostTag: '</mark>',
+            customRanking: ['asc(priority)'],
+            attributesForFaceting: ['language', 'kind'],
+            searchableAttributes: SearchableAttributes,
+        },
+    });
+    await client.replaceAllObjects({ indexName, objects });
+}
+export async function buildChatIndex(appId, indexName, writeKey, spec) {
+    if (!appId || !indexName || !writeKey)
+        return;
+    const objects = Array.from(generateChatIndex(spec));
+    const client = searchClient(appId, writeKey);
+    await client.setSettings({
+        indexName,
+        indexSettings: {
+            attributesForFaceting: ['language'],
+            attributeForDistinct: 'stainlessPath',
+            searchableAttributes: SearchableAttributesChat,
+        },
+    });
+    await client.replaceAllObjects({ indexName, objects });
+}
+export async function search({ settings: { appId, indexName, searchKey }, params: { query, language, kind }, }) {
+    const client = searchClient(appId, searchKey);
+    const filters = language ? `language:${language}` : undefined;
+    const facetFilters = kind ? [`kind:${kind}`] : undefined;
+    const { results } = await client.search({
+        requests: [
+            {
+                query,
+                indexName,
+                filters,
+                hitsPerPage: 5,
+                facets: ['kind'],
+            },
+            {
+                query,
+                indexName,
+                filters,
+                facetFilters,
+                facets: ['kind'],
+                hitsPerPage: 50,
+            },
+        ],
+    });
+    if ('hits' in results[0] && 'hits' in results[1]) {
+        const [{ nbHits, facets }, { hits }] = results;
+        return { hits, nbHits, facets };
+    }
+}
+//# sourceMappingURL=algolia.js.map

package/dist/search/providers/algolia.js.map

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

package/dist/search/providers/fuse.d.ts

@@ -0,0 +1,10 @@
+import { FuseIndex } from 'fuse.js';
+import { DocsLanguage } from '../../routing';
+import { IndexEntry } from '../types';
+import type { SDKJSON } from '../../types/sdkjson';
+export type FuseIndexData = {
+    content: IndexEntry[];
+    index: FuseIndex<IndexEntry>;
+};
+export declare function buildIndex(spec: SDKJSON.Spec, language?: DocsLanguage): FuseIndexData;
+export declare function search({ content, index }: FuseIndexData, query: string, limit?: number): import("fuse.js").FuseResult<IndexEntry>[];

package/dist/search/providers/fuse.js

@@ -0,0 +1,14 @@
+import Fuse from 'fuse.js';
+import { generateIndex } from '../indexer';
+import { SearchableAttributes } from '../types';
+export function buildIndex(spec, language) {
+    const idx = Array.from(generateIndex(spec, null, false));
+    const content = language ? idx.filter((entry) => entry.language === language) : idx;
+    const index = Fuse.createIndex(SearchableAttributes, content);
+    return { content, index };
+}
+export function search({ content, index }, query, limit = 100) {
+    const fuse = new Fuse(content, { keys: SearchableAttributes }, index);
+    return fuse.search(query).slice(0, limit);
+}
+//# sourceMappingURL=fuse.js.map

package/dist/search/providers/fuse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuse.js","sourceRoot":"","sources":["../../../src/search/providers/fuse.ts"],"names":[],"mappings":"AAAA,OAAO,IAAmB,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAc,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAK5D,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,QAAuB;IACpE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAiB,EAAE,KAAa,EAAE,QAAgB,GAAG;IAC1F,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC"}

package/dist/search/providers/pagefind.d.ts

@@ -0,0 +1,2 @@
+import type { GuideResultType } from '../types';
+export declare function guideSearch(loadPath: string, query: string, limit?: number): Promise<GuideResultType[]>;

package/dist/search/providers/pagefind.js

@@ -0,0 +1,19 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+async function loadPagefind(path) {
+    const url = new URL(path, import.meta.url).href;
+    return await import(__rewriteRelativeImportExtension(/* @vite-ignore */ url));
+}
+export async function guideSearch(loadPath, query, limit) {
+    const index = await loadPagefind(loadPath);
+    const response = await index.search(query);
+    const items = limit ? response.results.slice(0, limit) : response.results;
+    return Promise.all(items.map((result) => result.data().then((data) => ({ ...result, data }))));
+}
+//# sourceMappingURL=pagefind.js.map

package/dist/search/providers/pagefind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagefind.js","sourceRoot":"","sources":["../../../src/search/providers/pagefind.ts"],"names":[],"mappings":";;;;;;;;AAEA,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAChD,OAAO,MAAM,MAAM,kCAAC,kBAAkB,CAAC,GAAG,EAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,KAAa,EACb,KAAc;IAEd,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC1E,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC"}

package/dist/search/providers/walker.d.ts

@@ -0,0 +1,5 @@
+import { DocsLanguage } from '../../routing';
+import { IndexEntry } from '../types';
+import type { SDKJSON } from '../../types/sdkjson';
+export declare function buildIndex(spec: SDKJSON.Spec): Generator<IndexEntry, any, any>;
+export declare function search(index: Generator<IndexEntry>, language: DocsLanguage, query: string, limit?: number): IndexEntry[];

package/dist/search/providers/walker.js

@@ -0,0 +1,23 @@
+import { generateIndex } from '../indexer';
+import { SearchableAttributes } from '../types';
+export function buildIndex(spec) {
+    return generateIndex(spec, null, false);
+}
+function* findEntryInIndex(index, language, query) {
+    for (const entry of index) {
+        if (entry.language !== language)
+            continue;
+        for (const attr of SearchableAttributes) {
+            if (entry[attr] && typeof entry[attr] === 'string' && entry[attr].includes(query))
+                yield entry;
+        }
+    }
+}
+export function search(index, language, query, limit = 100) {
+    const results = findEntryInIndex(index, language, query);
+    const sorted = Array.from(results)
+        .sort((a, b) => a.priority - b.priority)
+        .slice(0, limit);
+    return sorted;
+}
+//# sourceMappingURL=walker.js.map

package/dist/search/providers/walker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.js","sourceRoot":"","sources":["../../../src/search/providers/walker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAc,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAG5D,MAAM,UAAU,UAAU,CAAC,IAAkB;IAC3C,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,QAAQ,CAAC,CAAC,gBAAgB,CAAC,KAA4B,EAAE,QAAgB,EAAE,KAAa;IACtF,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,SAAS;QAC1C,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;QACjG,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,KAA4B,EAC5B,QAAsB,EACtB,KAAa,EACb,QAAgB,GAAG;IAEnB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;SAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/search/results.d.ts

@@ -0,0 +1,21 @@
+import { Folder } from 'lucide-react';
+import { GuideResultType, QueryKindsType, ResultRecordType, SearchAttributeNames } from './types';
+export declare const QueryKindDisplay: Record<QueryKindsType, {
+    name: string;
+    icon: typeof Folder;
+}>;
+export type HighlightProps = {
+    result: ResultRecordType;
+    name: SearchAttributeNames;
+};
+export declare function Highlight({ result, name }: HighlightProps): import("react/jsx-runtime").JSX.Element | undefined;
+export type SearchResultProps = {
+    result: ResultRecordType;
+};
+export declare function SearchResultBreadcrumb({ result }: SearchResultProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchResult({ result }: SearchResultProps): import("react/jsx-runtime").JSX.Element;
+export type GuideResultProps = {
+    result: GuideResultType;
+};
+export declare function GuideResult({ result }: GuideResultProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchResultContent({ result }: SearchResultProps): import("react/jsx-runtime").JSX.Element;

package/dist/search/results.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Folder, Box, Code, Wrench, BookOpenText, Search } from 'lucide-react';
+import { useLanguage } from '../contexts';
+import { useComponents } from '../contexts/use-components';
+import style from '../style';
+export const QueryKindDisplay = {
+    all: { name: 'Results', icon: Search },
+    resource: { name: 'Resources', icon: Folder },
+    http_method: { name: 'Methods', icon: Box },
+    model: { name: 'Types', icon: Code },
+    property: { name: 'Properties', icon: Wrench },
+    guide: { name: 'Guide', icon: BookOpenText },
+};
+export function Highlight({ result, name }) {
+    const value = result._highlightResult[name]?.value;
+    if (value)
+        return _jsx("span", { dangerouslySetInnerHTML: { __html: value } });
+}
+export function SearchResultBreadcrumb({ result }) {
+    const Docs = useComponents();
+    const Icon = QueryKindDisplay[result.kind].icon;
+    const items = result.crumbs?.map((crumb) => (_jsx("span", { className: style.SearchBreadcrumbItem, children: crumb }, crumb)));
+    return (_jsxs("div", { className: style.SearchBreadcrumb, children: [_jsx(Icon, { className: style.Icon, size: 14 }), Array.isArray(result.crumbs) && (_jsx(Docs.Join, { items: items, children: _jsx("span", { className: style.SearchBreadcrumbDivider, children: '›' }) }))] }));
+}
+export function SearchResult({ result }) {
+    return (_jsxs("div", { className: style.SearchResult, "data-stldocs-search-result": result.kind, children: [_jsx(SearchResultBreadcrumb, { result: result }), _jsx(SearchResultContent, { result: result })] }));
+}
+export function GuideResult({ result }) {
+    const Docs = useComponents();
+    const Icon = QueryKindDisplay['guide'].icon;
+    const path = result.data.url
+        .slice(1, -1)
+        .split('/')
+        .map((crumb) => (_jsx("span", { className: style.SearchBreadcrumbItem, children: crumb }, crumb)));
+    const crumbs = path.length > 1
+        ? path
+        : [
+            _jsx("span", { className: style.SearchBreadcrumbItem, children: "Overview" }, "overview"),
+        ];
+    return (_jsxs("div", { className: style.SearchResult, "data-stldocs-search-result": "guide", children: [_jsxs("div", { className: style.SearchBreadcrumb, children: [_jsx(Icon, { className: style.Icon, size: 14 }), _jsx(Docs.Join, { items: crumbs, children: _jsx("span", { className: style.SearchBreadcrumbDivider, children: '›' }) })] }), _jsx("h3", { className: style.SearchResultGuideTitle, children: result.data.meta.title }), _jsx("div", { className: style.SearchResultGuideExcerpt, dangerouslySetInnerHTML: { __html: result.data.excerpt } })] }));
+}
+export function SearchResultContent({ result }) {
+    const Docs = useComponents();
+    const language = useLanguage();
+    switch (result.kind) {
+        case 'http_method':
+            return (_jsxs(_Fragment, { children: [_jsx(Docs.MethodHeader, { level: "h5", title: _jsx(Highlight, { result: result, name: result.summary ? 'summary' : 'title' }), signature: result['qualified'] && _jsx(Highlight, { result: result, name: 'qualified' }), children: _jsx(Docs.MethodRoute, { httpMethod: result.httpMethod, endpoint: _jsx(Highlight, { result: result, name: "endpoint" }) }) }), _jsx("div", { className: style.MethodDescription, children: _jsx(Highlight, { result: result, name: "description" }) })] }));
+        case 'model': {
+            const properties = result.children.map((child, index) => (_jsx("span", { className: style.TextIdentifier, children: child }, index)));
+            return (_jsxs("div", { className: style.Property, "data-stldocs-language": language, children: [_jsx("div", { className: style.PropertyHeader, children: _jsx("span", { className: style.PropertyName, children: _jsx(Highlight, { result: result, name: result.title ? 'title' : 'name' }) }) }), _jsxs("span", { className: style.PropertyDeclaration, children: [_jsx(Highlight, { result: result, name: "ident" }), ":", ' ', _jsx(Docs.Join, { items: properties, limit: 3, children: _jsx("span", { className: style.TextPunctuation, children: ", " }) })] })] }));
+        }
+        case 'resource':
+            return (_jsxs("div", { className: style.SearchResultResourceInfo, children: [_jsx("span", { className: style.SearchResultResourceTitle, children: _jsx(Highlight, { result: result, name: "title" }) }), _jsx("span", { className: style.SearchResultResourcePath, children: _jsx(Highlight, { result: result, name: "QualifiedName" }) })] }));
+        case 'property':
+            return (_jsxs("div", { className: style.Property, "data-stldocs-language": language, children: [_jsxs("div", { className: style.PropertyHeader, children: [_jsx("span", { className: style.PropertyName, children: _jsx(Highlight, { result: result, name: "name" }) }), _jsx("span", { className: style.PropertyTypeName, children: _jsx("span", { dangerouslySetInnerHTML: { __html: result.type } }) })] }), result.docstring && (_jsx("span", { className: style.PropertyDescription, children: _jsx(Highlight, { result: result, name: "docstring" }) }))] }));
+    }
+}
+//# sourceMappingURL=results.js.map

package/dist/search/results.js.map

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