@taurgis/bonsai 1.0.4 → 1.0.6

package/dist/lib/text.d.ts

@@ -0,0 +1,35 @@
+/** Display label when an artifact has no topic — not a filterable topic value. */
+export declare const NO_TOPIC_LABEL = "(no topic)";
+/**
+ * Pick the singular or plural noun for a count so human-readable output stays grammatical
+ * ("1 entry" / "2 entries"). English has irregular plurals, so the plural is passed explicitly
+ * rather than derived.
+ */
+export declare function pluralize(count: number, singular: string, plural: string): string;
+/** How a command labels a result listing, so its heading and truncation notice stay consistent. */
+export interface ResultListLabels {
+    /** Noun phrase after the count, e.g. "cached research"; the "entry/entries" plural is appended. */
+    noun: string;
+    /** Ordering word shown when truncated: "first" (recency order) or "top" (ranked order). */
+    order: 'first' | 'top';
+    /** The command's --limit ceiling, surfaced in the truncation hint. */
+    maxLimit: number;
+}
+/** Heading for a result listing; notes truncation inline when more matched than are shown. */
+export declare function resultListHeading(total: number, shown: number, labels: ResultListLabels): string;
+/**
+ * One-line truncation notice for stderr, or null when nothing was cut. Used under --json, where the
+ * stdout heading is suppressed and an agent would otherwise get no signal that results were capped.
+ */
+export declare function truncationNotice(total: number, shown: number, labels: ResultListLabels): string | null;
+/**
+ * Levenshtein edit distance: the minimum number of single-character insertions, deletions, or
+ * substitutions to turn `s1` into `s2`. Shared by fuzzy search ranking and command-typo suggestion.
+ */
+export declare function levenshtein(s1: string, s2: string): number;
+/**
+ * The candidate nearest to `input` by edit distance, or null when even the closest is farther than
+ * `maxDistance`. The threshold keeps suggestions to plausible typos — input that resembles nothing
+ * gets no correction rather than an absurd one.
+ */
+export declare function closestMatch(input: string, candidates: readonly string[], maxDistance: number): string | null;

package/dist/lib/text.js

@@ -0,0 +1,65 @@
+/** Display label when an artifact has no topic — not a filterable topic value. */
+export const NO_TOPIC_LABEL = '(no topic)';
+/**
+ * Pick the singular or plural noun for a count so human-readable output stays grammatical
+ * ("1 entry" / "2 entries"). English has irregular plurals, so the plural is passed explicitly
+ * rather than derived.
+ */
+export function pluralize(count, singular, plural) {
+    return count === 1 ? singular : plural;
+}
+/** Heading for a result listing; notes truncation inline when more matched than are shown. */
+export function resultListHeading(total, shown, labels) {
+    const noun = `${labels.noun} ${pluralize(total, 'entry', 'entries')}`;
+    return total > shown
+        ? `Found ${total} ${noun} (showing ${labels.order} ${shown}; raise --limit to see more):`
+        : `Found ${total} ${noun}:`;
+}
+/**
+ * One-line truncation notice for stderr, or null when nothing was cut. Used under --json, where the
+ * stdout heading is suppressed and an agent would otherwise get no signal that results were capped.
+ */
+export function truncationNotice(total, shown, labels) {
+    if (total <= shown)
+        return null;
+    return `${total} entries matched; returning the ${labels.order} ${shown}. Raise --limit (max ${labels.maxLimit}) to see more.`;
+}
+/**
+ * Levenshtein edit distance: the minimum number of single-character insertions, deletions, or
+ * substitutions to turn `s1` into `s2`. Shared by fuzzy search ranking and command-typo suggestion.
+ */
+export function levenshtein(s1, s2) {
+    if (s1.length < s2.length)
+        return levenshtein(s2, s1);
+    if (s2.length === 0)
+        return s1.length;
+    let prevRow = Array.from({ length: s2.length + 1 }, (_, i) => i);
+    for (let i = 0; i < s1.length; i++) {
+        const currRow = [i + 1];
+        for (let j = 0; j < s2.length; j++) {
+            const deletions = prevRow[j + 1] + 1;
+            const insertions = currRow[j] + 1;
+            const substitutions = prevRow[j] + (s1[i] === s2[j] ? 0 : 1);
+            currRow.push(Math.min(deletions, insertions, substitutions));
+        }
+        prevRow = currRow;
+    }
+    return prevRow[s2.length];
+}
+/**
+ * The candidate nearest to `input` by edit distance, or null when even the closest is farther than
+ * `maxDistance`. The threshold keeps suggestions to plausible typos — input that resembles nothing
+ * gets no correction rather than an absurd one.
+ */
+export function closestMatch(input, candidates, maxDistance) {
+    let best = null;
+    let bestDistance = Infinity;
+    for (const candidate of candidates) {
+        const distance = levenshtein(input, candidate);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = candidate;
+        }
+    }
+    return bestDistance <= maxDistance ? best : null;
+}

package/dist/sites/algolia.d.ts

@@ -0,0 +1,9 @@
+import type { SiteModule } from './types.js';
+export declare function createAlgoliaSite(id: string, name: string, domains: string[], appId: string, apiKey: string, indexName: string): SiteModule;
+export declare const react: SiteModule;
+export declare const vue: SiteModule;
+export declare const tailwind: SiteModule;
+export declare const jest: SiteModule;
+export declare const cypress: SiteModule;
+export declare const vitest: SiteModule;
+export declare const vitepress: SiteModule;

package/dist/sites/algolia.js

@@ -0,0 +1,26 @@
+import { algoliaQueryUrl, parseAlgoliaResponse } from '../lib/research/docs/remote-search.js';
+import { postJson } from '../lib/research/fetcher.js';
+export function createAlgoliaSite(id, name, domains, appId, apiKey, indexName) {
+    return {
+        id,
+        name,
+        domains,
+        search: async (query) => {
+            const url = algoliaQueryUrl({ appId, apiKey, indexName });
+            const bodyParams = { params: `query=${encodeURIComponent(query)}&hitsPerPage=20` };
+            const res = await postJson(url, bodyParams, {
+                'Content-Type': 'application/json',
+                'X-Algolia-API-Key': apiKey,
+                'X-Algolia-Application-Id': appId,
+            });
+            return parseAlgoliaResponse(res, url);
+        },
+    };
+}
+export const react = createAlgoliaSite('react', 'React', ['react.dev', 'legacy.reactjs.org'], '1FCF9AYYAT', '1b7ad4e1c89e645e351e59d40544eda1', 'beta-react');
+export const vue = createAlgoliaSite('vue', 'Vue.js', ['vuejs.org'], 'ML0LEBN7FQ', '10e7a8b13e6aec4007343338ab134e05', 'vuejs');
+export const tailwind = createAlgoliaSite('tailwind', 'Tailwind CSS', ['tailwindcss.com'], 'KNPXZI5B0M', '5fc87cef58bb80203d2207578309fab6', 'tailwindcss');
+export const jest = createAlgoliaSite('jest', 'Jest', ['jestjs.io'], 'HP439UUSOL', 'e5e670fd16f8f17caada79d6b0931682', 'jest-v2');
+export const cypress = createAlgoliaSite('cypress', 'Cypress', ['docs.cypress.io', 'cypress.io'], 'R9KDA5FMJB', 'b4af59e23bc2fa05281af7dcf13fcae5', 'cypress_docs');
+export const vitest = createAlgoliaSite('vitest', 'Vitest', ['vitest.dev'], 'ZTF29HGJ69', '9c3ced6fed60d2670bb36ab7e8bed8bc', 'vitest');
+export const vitepress = createAlgoliaSite('vitepress', 'VitePress', ['vitepress.dev'], '8J64VVRP8K', '52f578a92b88ad6abde815aae2b0ad7c', 'vitepress');

package/dist/sites/auto.d.ts

@@ -0,0 +1,8 @@
+import type { SiteModule } from './types.js';
+export declare function createAutoSite(id: string, name: string, domains: string[], docsUrl: string): SiteModule;
+export declare const angular: SiteModule;
+export declare const redux: SiteModule;
+export declare const vite: SiteModule;
+export declare const fastify: SiteModule;
+export declare const rollup: SiteModule;
+export declare const vueuse: SiteModule;

package/dist/sites/auto.js

@@ -0,0 +1,30 @@
+import { runRemoteDocsSearch } from '../lib/research/docs/remote-search-runner.js';
+import { fetchStaticHtml, fetchText, postJson } from '../lib/research/fetcher.js';
+export function createAutoSite(id, name, domains, docsUrl) {
+    return {
+        id,
+        name,
+        domains,
+        search: async (query) => {
+            const deps = {
+                fetchStatic: async (url) => {
+                    const res = await fetchStaticHtml(url);
+                    return { content: res.content, finalUrl: res.finalUrl };
+                },
+                fetchText: async (url) => {
+                    const res = await fetchText(url);
+                    return { content: res.content, status: res.status };
+                },
+                postJson: (url, body, headers) => postJson(url, body, headers),
+            };
+            const { results } = await runRemoteDocsSearch(docsUrl, query, deps);
+            return results;
+        },
+    };
+}
+export const angular = createAutoSite('angular', 'Angular', ['angular.dev'], 'https://angular.dev');
+export const redux = createAutoSite('redux', 'Redux', ['redux.js.org'], 'https://redux.js.org');
+export const vite = createAutoSite('vite', 'Vite', ['vitejs.dev', 'vite.dev'], 'https://vite.dev');
+export const fastify = createAutoSite('fastify', 'Fastify', ['fastify.dev', 'fastify.io'], 'https://fastify.dev');
+export const rollup = createAutoSite('rollup', 'Rollup', ['rollupjs.org'], 'https://rollupjs.org');
+export const vueuse = createAutoSite('vueuse', 'VueUse', ['vueuse.org'], 'https://vueuse.org');

package/dist/sites/index.js

@@ -1,11 +1,27 @@
 import { salesforce } from './salesforce/index.js';
 import { salesforceDeveloper } from './salesforce-developer/index.js';
+import { nextjs } from './nextjs/index.js';
+import { react, vue, tailwind, jest, cypress, vitest, vitepress } from './algolia.js';
+import { angular, redux, vite, fastify, rollup, vueuse } from './auto.js';
 // The known documentation sites. A plain constant, not a registry: these ship
 // with the CLI, so there is nothing to register at runtime. Sites with custom
 // fetch/search behavior live in their own module (e.g. ./salesforce). Salesforce Help and
 // Salesforce Developer are separate modules — different domains, different extraction.
 export const SITES = [
-    { id: 'react', name: 'React', domains: ['react.dev', 'legacy.reactjs.org'] },
+    react,
+    vue,
+    tailwind,
+    nextjs,
+    jest,
+    cypress,
+    vitest,
+    vitepress,
+    angular,
+    redux,
+    vite,
+    fastify,
+    rollup,
+    vueuse,
     salesforce,
     salesforceDeveloper,
     // TanStack docs embed a GitHub "edit this page" link, so capture resolves the page's source

package/dist/sites/nextjs/index.d.ts

@@ -0,0 +1,2 @@
+import type { SiteModule } from '../types.js';
+export declare const nextjs: SiteModule;

package/dist/sites/nextjs/index.js

@@ -0,0 +1,52 @@
+import { postJson } from '../../lib/research/fetcher.js';
+export const nextjs = {
+    id: 'nextjs',
+    name: 'Next.js',
+    domains: ['nextjs.org'],
+    search: async (query) => {
+        const url = 'https://nextjs.org/api/search';
+        const bodyStr = await postJson(url, { query, version: 'stable', routerType: 'app' }, {});
+        let data;
+        try {
+            // The Next.js API returns a JSON array sometimes or a JSON object with 'hits'
+            const parsed = JSON.parse(bodyStr);
+            if (Array.isArray(parsed)) {
+                data = parsed;
+            }
+            else if (parsed && Array.isArray(parsed.hits)) {
+                data = parsed.hits;
+            }
+            else {
+                throw new Error('Unexpected response format from Next.js search');
+            }
+        }
+        catch (err) {
+            throw new Error(`Failed to parse Next.js search response: ${err.message}`);
+        }
+        const queryLower = query.toLowerCase();
+        return data.map((item) => {
+            const content = item.content || '';
+            let snippet = content;
+            const idx = content.toLowerCase().indexOf(queryLower);
+            if (idx !== -1) {
+                const start = Math.max(0, idx - 40);
+                const end = Math.min(content.length, idx + 110);
+                snippet = content.slice(start, end);
+                if (start > 0)
+                    snippet = '...' + snippet;
+                if (end < content.length)
+                    snippet = snippet + '...';
+            }
+            else {
+                snippet = content.slice(0, 150);
+            }
+            // Clean up whitespace and newlines so it looks like a snippet and not a raw script
+            snippet = snippet.replace(/\s+/g, ' ').trim();
+            return {
+                url: `https://nextjs.org${item.path}${item.anchor ? `#${item.anchor}` : ''}`,
+                title: item.title ? `${item.pageTitle} - ${item.title}` : item.pageTitle || 'Untitled',
+                snippet,
+            };
+        });
+    },
+};

package/dist/sites/react/index.d.ts

@@ -0,0 +1,2 @@
+import type { SiteModule } from '../types.js';
+export declare const react: SiteModule;

package/dist/sites/react/index.js

@@ -0,0 +1,17 @@
+import { algoliaQueryUrl, parseAlgoliaResponse } from '../../lib/research/docs/remote-search.js';
+import { postJson } from '../../lib/research/fetcher.js';
+export const react = {
+    id: 'react',
+    name: 'React',
+    domains: ['react.dev', 'legacy.reactjs.org'],
+    search: async (query) => {
+        const config = {
+            appId: '1FCF9AYYAT',
+            apiKey: '1b7ad4e1c89e645e351e59d40544eda1',
+            indexName: 'beta-react'
+        };
+        const url = algoliaQueryUrl(config);
+        const body = await postJson(url, { params: `query=${encodeURIComponent(query)}` }, { 'X-Algolia-API-Key': config.apiKey, 'X-Algolia-Application-Id': config.appId });
+        return parseAlgoliaResponse(body, url);
+    }
+};

package/dist/sites/tailwind/index.d.ts

@@ -0,0 +1,2 @@
+import type { SiteModule } from '../types.js';
+export declare const tailwind: SiteModule;

package/dist/sites/tailwind/index.js

@@ -0,0 +1,17 @@
+import { algoliaQueryUrl, parseAlgoliaResponse } from '../../lib/research/docs/remote-search.js';
+import { postJson } from '../../lib/research/fetcher.js';
+export const tailwind = {
+    id: 'tailwind',
+    name: 'Tailwind CSS',
+    domains: ['tailwindcss.com'],
+    search: async (query) => {
+        const config = {
+            appId: 'KNPXZI5B0M',
+            apiKey: '5fc87cef58bb80203d2207578309fab6',
+            indexName: 'tailwindcss'
+        };
+        const url = algoliaQueryUrl(config);
+        const body = await postJson(url, { params: `query=${encodeURIComponent(query)}` }, { 'X-Algolia-API-Key': config.apiKey, 'X-Algolia-Application-Id': config.appId });
+        return parseAlgoliaResponse(body, url);
+    }
+};

package/dist/sites/vue/index.d.ts

@@ -0,0 +1,2 @@
+import type { SiteModule } from '../types.js';
+export declare const vue: SiteModule;

package/dist/sites/vue/index.js

@@ -0,0 +1,17 @@
+import { algoliaQueryUrl, parseAlgoliaResponse } from '../../lib/research/docs/remote-search.js';
+import { postJson } from '../../lib/research/fetcher.js';
+export const vue = {
+    id: 'vue',
+    name: 'Vue.js',
+    domains: ['vuejs.org'],
+    search: async (query) => {
+        const config = {
+            appId: 'ML0LEBN7FQ',
+            apiKey: '10e7a8b13e6aec4007343338ab134e05',
+            indexName: 'vuejs'
+        };
+        const url = algoliaQueryUrl(config);
+        const body = await postJson(url, { params: `query=${encodeURIComponent(query)}` }, { 'X-Algolia-API-Key': config.apiKey, 'X-Algolia-Application-Id': config.appId });
+        return parseAlgoliaResponse(body, url);
+    }
+};