@pleaseai/ask 0.1.0 → 0.1.3

package/dist/sources/github.js

@@ -0,0 +1,114 @@
+import { execFileSync, execSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { consola } from 'consola';
+const RE_LEADING_V = /^v/;
+const RE_SHA40 = /^[0-9a-f]{40}$/;
+const RE_WHITESPACE = /\s+/;
+export class GithubSource {
+    async fetch(options) {
+        const opts = options;
+        const { repo, docsPath } = opts;
+        const ref = opts.tag ?? opts.branch ?? 'main';
+        // Resolve the ref to get the actual version (strip leading "v" from tags)
+        const tagVersion = opts.tag?.replace(RE_LEADING_V, '');
+        const resolvedVersion = tagVersion ?? opts.version;
+        // Download repo archive and extract docs
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ask-gh-'));
+        try {
+            const archiveUrl = `https://github.com/${repo}/archive/refs/${opts.tag ? 'tags' : 'heads'}/${ref}.tar.gz`;
+            execSync(`curl -sL "${archiveUrl}" | tar xz -C "${tmpDir}"`, {
+                encoding: 'utf-8',
+            });
+            // Find extracted directory (format: reponame-ref)
+            const extractedDirs = fs.readdirSync(tmpDir);
+            if (extractedDirs.length === 0) {
+                throw new Error(`Failed to extract archive from ${repo}@${ref}`);
+            }
+            const extractedDir = path.join(tmpDir, extractedDirs[0]);
+            // Find docs
+            const targetPath = docsPath ?? this.detectDocsPath(extractedDir);
+            if (!targetPath) {
+                throw new Error(`No docs directory found in ${repo}@${ref}. Specify --path to point to the docs directory.`);
+            }
+            const docsDir = path.join(extractedDir, targetPath);
+            if (!fs.existsSync(docsDir)) {
+                throw new Error(`Path "${targetPath}" not found in ${repo}@${ref}`);
+            }
+            let files;
+            if (fs.statSync(docsDir).isFile()) {
+                // Single file specified
+                const content = fs.readFileSync(docsDir, 'utf-8');
+                files = [{ path: path.basename(docsDir), content }];
+            }
+            else {
+                files = this.collectDocFiles(docsDir, docsDir);
+            }
+            const commit = this.resolveCommit(repo, ref);
+            return {
+                files,
+                resolvedVersion,
+                meta: { commit, ref },
+            };
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+    detectDocsPath(dir) {
+        const candidates = ['docs', 'doc', 'documentation', 'guide', 'guides'];
+        for (const candidate of candidates) {
+            const fullPath = path.join(dir, candidate);
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+                return candidate;
+            }
+        }
+        return null;
+    }
+    collectDocFiles(baseDir, currentDir) {
+        const files = [];
+        const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...this.collectDocFiles(baseDir, fullPath));
+            }
+            else if (this.isDocFile(entry.name)) {
+                const relativePath = path.relative(baseDir, fullPath);
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                files.push({ path: relativePath, content });
+            }
+        }
+        return files;
+    }
+    /**
+     * Resolve a ref (tag or branch) to a full commit sha via `git ls-remote`.
+     * Returns undefined when git is unavailable or the ref cannot be resolved
+     * — the lockfile leaves `commit` undefined rather than guessing.
+     */
+    resolveCommit(repo, ref) {
+        try {
+            // execFileSync (not execSync) to bypass the shell — `ref` originates
+            // from user-supplied tag/branch and must not be interpolated into a
+            // shell command line.
+            const out = execFileSync('git', ['ls-remote', `https://github.com/${repo}.git`, ref], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            // ls-remote may return multiple lines (e.g. tag + ^{} dereference).
+            // Prefer the dereferenced commit if present.
+            const lines = out.split('\n').filter(Boolean);
+            const dereferenced = lines.find(l => l.includes(`refs/tags/${ref}^{}`));
+            const sha = (dereferenced ?? lines[0])?.split(RE_WHITESPACE)[0];
+            return sha && RE_SHA40.test(sha) ? sha : undefined;
+        }
+        catch (err) {
+            consola.warn(`Could not resolve commit for ${repo}@${ref}: ${err instanceof Error ? err.message : err}. `
+                + 'Lockfile will not pin a commit sha for this entry.');
+            return undefined;
+        }
+    }
+    isDocFile(filename) {
+        const ext = path.extname(filename).toLowerCase();
+        return ['.md', '.mdx', '.txt', '.rst'].includes(ext);
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/sources/github.js.map

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

package/dist/sources/index.d.ts

@@ -0,0 +1,41 @@
+import type { SourceConfig } from '../schemas.js';
+export type { SourceConfig };
+export type NpmSourceOptions = Extract<SourceConfig, {
+    source: 'npm';
+}>;
+export type GithubSourceOptions = Extract<SourceConfig, {
+    source: 'github';
+}>;
+export type WebSourceOptions = Extract<SourceConfig, {
+    source: 'web';
+}>;
+export type LlmsTxtSourceOptions = Extract<SourceConfig, {
+    source: 'llms-txt';
+}>;
+export interface DocFile {
+    path: string;
+    content: string;
+}
+export interface FetchResult {
+    files: DocFile[];
+    resolvedVersion: string;
+    /** Source-specific metadata propagated to ask.lock */
+    meta?: {
+        /** GitHub commit sha (40 hex chars) */
+        commit?: string;
+        /** GitHub ref used (tag name or branch name) */
+        ref?: string;
+        /** npm Subresource Integrity hash from dist.integrity */
+        integrity?: string;
+        /** npm tarball URL */
+        tarball?: string;
+        /** web/llms-txt source URL(s) */
+        urls?: string[];
+    };
+}
+export interface DocSource {
+    fetch: (options: SourceConfig) => Promise<FetchResult>;
+}
+type SourceKind = SourceConfig['source'];
+export declare function getSource(type: SourceKind): DocSource;
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAMjD,YAAY,EAAE,YAAY,EAAE,CAAA;AAM5B,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AACvE,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAC7E,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AACvE,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAAA;AAEhF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,IAAI,CAAC,EAAE;QACL,uCAAuC;QACvC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,gDAAgD;QAChD,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,yDAAyD;QACzD,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,sBAAsB;QACtB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,iCAAiC;QACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;CACF;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CACvD;AAED,KAAK,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AASxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAErD"}

package/dist/sources/index.js

@@ -0,0 +1,14 @@
+import { GithubSource } from './github.js';
+import { LlmsTxtSource } from './llms-txt.js';
+import { NpmSource } from './npm.js';
+import { WebSource } from './web.js';
+const sources = {
+    'npm': new NpmSource(),
+    'github': new GithubSource(),
+    'web': new WebSource(),
+    'llms-txt': new LlmsTxtSource(),
+};
+export function getSource(type) {
+    return sources[type];
+}
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AA0CpC,MAAM,OAAO,GAAkC;IAC7C,KAAK,EAAE,IAAI,SAAS,EAAE;IACtB,QAAQ,EAAE,IAAI,YAAY,EAAE;IAC5B,KAAK,EAAE,IAAI,SAAS,EAAE;IACtB,UAAU,EAAE,IAAI,aAAa,EAAE;CAChC,CAAA;AAED,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC"}

package/dist/sources/llms-txt.d.ts

@@ -0,0 +1,5 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+export declare class LlmsTxtSource implements DocSource {
+    fetch(options: SourceConfig): Promise<FetchResult>;
+}
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/sources/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../../src/sources/llms-txt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EAEX,YAAY,EACb,MAAM,YAAY,CAAA;AAGnB,qBAAa,aAAc,YAAW,SAAS;IACvC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAqCzD"}

package/dist/sources/llms-txt.js

@@ -0,0 +1,33 @@
+import { consola } from 'consola';
+export class LlmsTxtSource {
+    async fetch(options) {
+        const opts = options;
+        const url = opts.url;
+        consola.info(`  Fetching: ${url}`);
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'ask-docs/0.1 (documentation downloader)',
+                'Accept': 'text/plain, text/markdown',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+        }
+        const content = await response.text();
+        if (content.trim().length === 0) {
+            throw new Error(`No content found at ${url}`);
+        }
+        // Determine filename from URL path
+        const urlObj = new URL(url);
+        const filename = urlObj.pathname.split('/').pop() || 'llms.txt';
+        const filePath = filename.endsWith('.md') || filename.endsWith('.txt')
+            ? filename
+            : `${filename}.md`;
+        consola.info(`  Fetched: ${url} -> ${filePath} (${content.length} chars)`);
+        return {
+            files: [{ path: filePath, content }],
+            resolvedVersion: opts.version,
+        };
+    }
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/sources/llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../../src/sources/llms-txt.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,MAAM,IAAI,GAAG,OAA+B,CAAA;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QAEpB,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,CAAA;QAElC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,YAAY,EAAE,yCAAyC;gBACvD,QAAQ,EAAE,2BAA2B;aACtC;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QACtF,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAErC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAA;QAC/C,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,UAAU,CAAA;QAC/D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpE,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAA;QAEpB,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,OAAO,QAAQ,KAAK,OAAO,CAAC,MAAM,SAAS,CAAC,CAAA;QAE1E,OAAO;YACL,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YACpC,eAAe,EAAE,IAAI,CAAC,OAAO;SAC9B,CAAA;IACH,CAAC;CACF"}

package/dist/sources/npm.d.ts

@@ -0,0 +1,14 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+/**
+ * @deprecated Use the npm ecosystem resolver (`resolvers/npm.ts`) + github source
+ * instead. This direct npm tarball source is kept for one release to avoid
+ * regressions in existing configs that specify `source: 'npm'` explicitly.
+ */
+export declare class NpmSource implements DocSource {
+    fetch(options: SourceConfig): Promise<FetchResult>;
+    private detectDocsPath;
+    private listDirs;
+    private collectMarkdownFiles;
+    private isDocFile;
+}
+//# sourceMappingURL=npm.d.ts.map

package/dist/sources/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../src/sources/npm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EAEX,YAAY,EACb,MAAM,YAAY,CAAA;AAOnB;;;;GAIG;AACH,qBAAa,SAAU,YAAW,SAAS;IACnC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAsExD,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,SAAS;CAIlB"}

package/dist/sources/npm.js

@@ -0,0 +1,113 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { consola } from 'consola';
+/**
+ * @deprecated Use the npm ecosystem resolver (`resolvers/npm.ts`) + github source
+ * instead. This direct npm tarball source is kept for one release to avoid
+ * regressions in existing configs that specify `source: 'npm'` explicitly.
+ */
+export class NpmSource {
+    async fetch(options) {
+        const opts = options;
+        const pkg = opts.package ?? opts.name;
+        const spec = `${pkg}@${opts.version}`;
+        // Get package info to resolve exact version and tarball URL
+        const resolvedVersion = execSync(`npm view ${spec} version`, {
+            encoding: 'utf-8',
+        }).trim();
+        const tarballUrl = execSync(`npm view ${spec} dist.tarball`, {
+            encoding: 'utf-8',
+        }).trim();
+        const integrity = (() => {
+            try {
+                return execSync(`npm view ${spec} dist.integrity`, {
+                    encoding: 'utf-8',
+                }).trim() || undefined;
+            }
+            catch {
+                return undefined;
+            }
+        })();
+        // Download and extract tarball
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ask-npm-'));
+        try {
+            consola.info(`  Downloading ${pkg}@${resolvedVersion}...`);
+            execSync(`curl -sL "${tarballUrl}" | tar xz -C "${tmpDir}"`, {
+                encoding: 'utf-8',
+            });
+            // Find docs in the extracted package
+            const packageDir = path.join(tmpDir, 'package');
+            const docsPath = opts.docsPath ?? this.detectDocsPath(packageDir);
+            if (!docsPath) {
+                throw new Error(`No docs found in ${spec}. Specify --docs-path to point to the docs directory within the package.`);
+            }
+            const docsDir = path.join(packageDir, docsPath);
+            if (!fs.existsSync(docsDir)) {
+                throw new Error(`Docs path "${docsPath}" not found in ${spec}. Available paths:\n${this.listDirs(packageDir)}`);
+            }
+            let files;
+            if (fs.statSync(docsDir).isFile()) {
+                const content = fs.readFileSync(docsDir, 'utf-8');
+                files = [{ path: path.basename(docsDir), content }];
+            }
+            else {
+                files = this.collectMarkdownFiles(docsDir, docsDir);
+            }
+            return {
+                files,
+                resolvedVersion,
+                meta: { tarball: tarballUrl, integrity },
+            };
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+    detectDocsPath(packageDir) {
+        const candidates = [
+            'docs',
+            'doc',
+            'dist/docs',
+            'documentation',
+            'guide',
+            'guides',
+        ];
+        for (const candidate of candidates) {
+            const fullPath = path.join(packageDir, candidate);
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+                return candidate;
+            }
+        }
+        return null;
+    }
+    listDirs(dir) {
+        return fs
+            .readdirSync(dir, { withFileTypes: true })
+            .filter(d => d.isDirectory())
+            .map(d => `  - ${d.name}/`)
+            .join('\n');
+    }
+    collectMarkdownFiles(baseDir, currentDir) {
+        const files = [];
+        const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...this.collectMarkdownFiles(baseDir, fullPath));
+            }
+            else if (this.isDocFile(entry.name)) {
+                const relativePath = path.relative(baseDir, fullPath);
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                files.push({ path: relativePath, content });
+            }
+        }
+        return files;
+    }
+    isDocFile(filename) {
+        const ext = path.extname(filename).toLowerCase();
+        return ['.md', '.mdx', '.txt', '.rst'].includes(ext);
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/sources/npm.js.map

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

package/dist/sources/web.d.ts

@@ -0,0 +1,13 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+export declare class WebSource implements DocSource {
+    private nhm;
+    fetch(options: SourceConfig): Promise<FetchResult>;
+    private crawl;
+    private htmlToMarkdown;
+    private extractMainContent;
+    private extractLinks;
+    private isSkippableUrl;
+    private normalizeUrl;
+    private urlToFilePath;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/sources/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/sources/web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAA;AAgBnB,qBAAa,SAAU,YAAW,SAAS;IACzC,OAAO,CAAC,GAAG,CAAyB;IAE9B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;YAmB1C,KAAK;IA6DnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,YAAY;IA+CpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,aAAa;CAetB"}

package/dist/sources/web.js

@@ -0,0 +1,143 @@
+import { consola } from 'consola';
+import { NodeHtmlMarkdown } from 'node-html-markdown';
+/* eslint-disable regexp/no-unused-capturing-group -- all capturing groups accessed via match[1] */
+const RE_MAIN = /<main[^>]*>([\s\S]*?)<\/main>/i;
+const RE_ARTICLE = /<article[^>]*>([\s\S]*?)<\/article>/i;
+const RE_CONTENT_DIV = /<div[^>]*class="[^"]*(?:content|docs|documentation)[^"]*"[^>]*>([\s\S]*?)<\/div>/i;
+const RE_BODY = /<body[^>]*>([\s\S]*?)<\/body>/i;
+const RE_HREF = /href="([^"]+)"/g;
+const RE_SKIP_EXT = /\.(png|jpg|jpeg|gif|svg|ico|css|js|woff|woff2|ttf|eot)$/i;
+const RE_SKIP_PATH = /\/(api|auth|login|signup|search)\/?$/i;
+/* eslint-enable regexp/no-unused-capturing-group */
+const RE_TRAILING_SLASH = /\/$/;
+const RE_LEADING_SLASH = /^\//;
+export class WebSource {
+    nhm = new NodeHtmlMarkdown();
+    async fetch(options) {
+        const opts = options;
+        const maxDepth = opts.maxDepth ?? 1;
+        const visited = new Set();
+        const files = [];
+        for (const startUrl of opts.urls) {
+            await this.crawl(startUrl, startUrl, maxDepth, 0, visited, files, opts);
+        }
+        if (files.length === 0) {
+            throw new Error(`No documentation content found from URLs: ${opts.urls.join(', ')}`);
+        }
+        return { files, resolvedVersion: opts.version };
+    }
+    async crawl(url, baseUrl, maxDepth, currentDepth, visited, files, opts) {
+        const normalized = this.normalizeUrl(url);
+        if (visited.has(normalized))
+            return;
+        visited.add(normalized);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'ask-docs/0.1 (documentation downloader)',
+                    'Accept': 'text/html',
+                },
+            });
+            if (!response.ok) {
+                consola.warn(`  Warning: ${url} returned ${response.status}, skipping`);
+                return;
+            }
+            const contentType = response.headers.get('content-type') ?? '';
+            if (!contentType.includes('text/html'))
+                return;
+            const html = await response.text();
+            const markdown = this.htmlToMarkdown(html, url);
+            if (markdown.trim().length > 0) {
+                const filePath = this.urlToFilePath(url, baseUrl);
+                files.push({ path: filePath, content: markdown });
+                consola.info(`  Fetched: ${url} -> ${filePath}`);
+            }
+            // Crawl linked pages if depth allows
+            if (currentDepth < maxDepth) {
+                const links = this.extractLinks(html, url, baseUrl, opts);
+                for (const link of links) {
+                    await this.crawl(link, baseUrl, maxDepth, currentDepth + 1, visited, files, opts);
+                }
+            }
+        }
+        catch (err) {
+            consola.warn(`  Warning: Failed to fetch ${url}: ${err}`);
+        }
+    }
+    htmlToMarkdown(html, url) {
+        const mainContent = this.extractMainContent(html);
+        const markdown = this.nhm.translate(mainContent);
+        return `<!-- Source: ${url} -->\n\n${markdown}`;
+    }
+    extractMainContent(html) {
+        const patterns = [RE_MAIN, RE_ARTICLE, RE_CONTENT_DIV, RE_BODY];
+        for (const pattern of patterns) {
+            const match = html.match(pattern);
+            if (match)
+                return match[1];
+        }
+        return html;
+    }
+    extractLinks(html, currentUrl, baseUrl, opts) {
+        const links = [];
+        const base = new URL(baseUrl);
+        for (const match of html.matchAll(RE_HREF)) {
+            try {
+                const resolved = new URL(match[1], currentUrl);
+                // Only follow same-origin links
+                if (resolved.origin !== base.origin)
+                    continue;
+                // Filter by path prefix if specified
+                if (opts.allowedPathPrefix) {
+                    if (!resolved.pathname.startsWith(opts.allowedPathPrefix))
+                        continue;
+                }
+                else {
+                    // Default: stay within the base URL's path
+                    const basePath = new URL(baseUrl).pathname;
+                    if (!resolved.pathname.startsWith(basePath))
+                        continue;
+                }
+                // Skip non-doc links
+                if (this.isSkippableUrl(resolved.pathname))
+                    continue;
+                // Remove hash and query
+                resolved.hash = '';
+                resolved.search = '';
+                links.push(resolved.toString());
+            }
+            catch {
+                // Invalid URL, skip
+            }
+        }
+        return links;
+    }
+    isSkippableUrl(pathname) {
+        return RE_SKIP_EXT.test(pathname) || RE_SKIP_PATH.test(pathname);
+    }
+    normalizeUrl(url) {
+        try {
+            const u = new URL(url);
+            u.hash = '';
+            u.search = '';
+            u.pathname = u.pathname.replace(RE_TRAILING_SLASH, '') || '/';
+            return u.toString();
+        }
+        catch {
+            return url;
+        }
+    }
+    urlToFilePath(url, baseUrl) {
+        const u = new URL(url);
+        const base = new URL(baseUrl);
+        let relativePath = u.pathname.replace(base.pathname, '').replace(RE_LEADING_SLASH, '');
+        if (!relativePath)
+            relativePath = 'index';
+        relativePath = relativePath.replace(RE_TRAILING_SLASH, '');
+        if (!relativePath.endsWith('.md')) {
+            relativePath += '.md';
+        }
+        return relativePath;
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/sources/web.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,11 @@
+import type { DocFile } from './sources/index.js';
+export declare function getDocsDir(projectDir: string): string;
+export declare function getLibraryDocsDir(projectDir: string, name: string, version: string): string;
+export declare function saveDocs(projectDir: string, name: string, version: string, files: DocFile[]): string;
+export declare function removeDocs(projectDir: string, name: string, version?: string): void;
+export declare function listDocs(projectDir: string): Array<{
+    name: string;
+    version: string;
+    fileCount: number;
+}>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAKjD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EAAE,GACf,MAAM,CA2BR;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAmBN;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAc7D"}

package/dist/storage.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getAskDir } from './io.js';
+export function getDocsDir(projectDir) {
+    return path.join(getAskDir(projectDir), 'docs');
+}
+export function getLibraryDocsDir(projectDir, name, version) {
+    return path.join(getDocsDir(projectDir), `${name}@${version}`);
+}
+export function saveDocs(projectDir, name, version, files) {
+    const docsDir = getLibraryDocsDir(projectDir, name, version);
+    // Clean existing docs for this library version
+    if (fs.existsSync(docsDir)) {
+        fs.rmSync(docsDir, { recursive: true });
+    }
+    fs.mkdirSync(docsDir, { recursive: true });
+    for (const file of files) {
+        const filePath = path.join(docsDir, file.path);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, file.content, 'utf-8');
+    }
+    // Create an index file listing all docs
+    const index = files
+        .map(f => `- [${f.path}](./${f.path})`)
+        .join('\n');
+    fs.writeFileSync(path.join(docsDir, 'INDEX.md'), `# ${name}@${version} Documentation\n\n${index}\n`, 'utf-8');
+    return docsDir;
+}
+export function removeDocs(projectDir, name, version) {
+    if (version) {
+        const docsDir = getLibraryDocsDir(projectDir, name, version);
+        if (fs.existsSync(docsDir)) {
+            fs.rmSync(docsDir, { recursive: true });
+        }
+    }
+    else {
+        // Remove all versions for this library
+        const baseDir = getDocsDir(projectDir);
+        if (!fs.existsSync(baseDir))
+            return;
+        const entries = fs.readdirSync(baseDir);
+        for (const entry of entries) {
+            if (entry.startsWith(`${name}@`)) {
+                fs.rmSync(path.join(baseDir, entry), { recursive: true });
+            }
+        }
+    }
+}
+export function listDocs(projectDir) {
+    const baseDir = getDocsDir(projectDir);
+    if (!fs.existsSync(baseDir))
+        return [];
+    return fs
+        .readdirSync(baseDir, { withFileTypes: true })
+        .filter(d => d.isDirectory() && d.name.includes('@'))
+        .map((d) => {
+        const [name, version] = d.name.split('@');
+        const dirPath = path.join(baseDir, d.name);
+        const fileCount = countFiles(dirPath);
+        return { name, version, fileCount };
+    });
+}
+function countFiles(dir) {
+    let count = 0;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            count += countFiles(path.join(dir, entry.name));
+        }
+        else {
+            count++;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=storage.js.map