@pleaseai/ask 0.1.0 → 0.1.3

package/dist/schemas.d.ts

@@ -0,0 +1,490 @@
+import { z } from 'zod';
+export declare const SourceConfigSchema: z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
+    source: z.ZodLiteral<"github">;
+    name: z.ZodString;
+    version: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    docsPath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "github";
+    name: string;
+    version: string;
+    repo: string;
+    branch?: string | undefined;
+    tag?: string | undefined;
+    docsPath?: string | undefined;
+}, {
+    source: "github";
+    name: string;
+    version: string;
+    repo: string;
+    branch?: string | undefined;
+    tag?: string | undefined;
+    docsPath?: string | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"npm">;
+    name: z.ZodString;
+    version: z.ZodString;
+    package: z.ZodOptional<z.ZodString>;
+    docsPath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "npm";
+    name: string;
+    version: string;
+    docsPath?: string | undefined;
+    package?: string | undefined;
+}, {
+    source: "npm";
+    name: string;
+    version: string;
+    docsPath?: string | undefined;
+    package?: string | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"web">;
+    name: z.ZodString;
+    version: z.ZodString;
+    urls: z.ZodArray<z.ZodString, "many">;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    allowedPathPrefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "web";
+    name: string;
+    version: string;
+    urls: string[];
+    maxDepth?: number | undefined;
+    allowedPathPrefix?: string | undefined;
+}, {
+    source: "web";
+    name: string;
+    version: string;
+    urls: string[];
+    maxDepth?: number | undefined;
+    allowedPathPrefix?: string | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"llms-txt">;
+    name: z.ZodString;
+    version: z.ZodString;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "llms-txt";
+    name: string;
+    version: string;
+    url: string;
+}, {
+    source: "llms-txt";
+    name: string;
+    version: string;
+    url: string;
+}>]>;
+export type SourceConfig = z.infer<typeof SourceConfigSchema>;
+export declare const ConfigSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    docs: z.ZodArray<z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
+        source: z.ZodLiteral<"github">;
+        name: z.ZodString;
+        version: z.ZodString;
+        repo: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        tag: z.ZodOptional<z.ZodString>;
+        docsPath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "github";
+        name: string;
+        version: string;
+        repo: string;
+        branch?: string | undefined;
+        tag?: string | undefined;
+        docsPath?: string | undefined;
+    }, {
+        source: "github";
+        name: string;
+        version: string;
+        repo: string;
+        branch?: string | undefined;
+        tag?: string | undefined;
+        docsPath?: string | undefined;
+    }>, z.ZodObject<{
+        source: z.ZodLiteral<"npm">;
+        name: z.ZodString;
+        version: z.ZodString;
+        package: z.ZodOptional<z.ZodString>;
+        docsPath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "npm";
+        name: string;
+        version: string;
+        docsPath?: string | undefined;
+        package?: string | undefined;
+    }, {
+        source: "npm";
+        name: string;
+        version: string;
+        docsPath?: string | undefined;
+        package?: string | undefined;
+    }>, z.ZodObject<{
+        source: z.ZodLiteral<"web">;
+        name: z.ZodString;
+        version: z.ZodString;
+        urls: z.ZodArray<z.ZodString, "many">;
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+        allowedPathPrefix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "web";
+        name: string;
+        version: string;
+        urls: string[];
+        maxDepth?: number | undefined;
+        allowedPathPrefix?: string | undefined;
+    }, {
+        source: "web";
+        name: string;
+        version: string;
+        urls: string[];
+        maxDepth?: number | undefined;
+        allowedPathPrefix?: string | undefined;
+    }>, z.ZodObject<{
+        source: z.ZodLiteral<"llms-txt">;
+        name: z.ZodString;
+        version: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: "llms-txt";
+        name: string;
+        version: string;
+        url: string;
+    }, {
+        source: "llms-txt";
+        name: string;
+        version: string;
+        url: string;
+    }>]>, "many">;
+    manageIgnores: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    docs: ({
+        source: "github";
+        name: string;
+        version: string;
+        repo: string;
+        branch?: string | undefined;
+        tag?: string | undefined;
+        docsPath?: string | undefined;
+    } | {
+        source: "npm";
+        name: string;
+        version: string;
+        docsPath?: string | undefined;
+        package?: string | undefined;
+    } | {
+        source: "web";
+        name: string;
+        version: string;
+        urls: string[];
+        maxDepth?: number | undefined;
+        allowedPathPrefix?: string | undefined;
+    } | {
+        source: "llms-txt";
+        name: string;
+        version: string;
+        url: string;
+    })[];
+    manageIgnores?: boolean | undefined;
+}, {
+    schemaVersion: 1;
+    docs: ({
+        source: "github";
+        name: string;
+        version: string;
+        repo: string;
+        branch?: string | undefined;
+        tag?: string | undefined;
+        docsPath?: string | undefined;
+    } | {
+        source: "npm";
+        name: string;
+        version: string;
+        docsPath?: string | undefined;
+        package?: string | undefined;
+    } | {
+        source: "web";
+        name: string;
+        version: string;
+        urls: string[];
+        maxDepth?: number | undefined;
+        allowedPathPrefix?: string | undefined;
+    } | {
+        source: "llms-txt";
+        name: string;
+        version: string;
+        url: string;
+    })[];
+    manageIgnores?: boolean | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare const LockEntrySchema: z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
+    source: z.ZodLiteral<"github">;
+    repo: z.ZodString;
+    ref: z.ZodString;
+    commit: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    fetchedAt: z.ZodString;
+    fileCount: z.ZodNumber;
+    contentHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "github";
+    version: string;
+    repo: string;
+    ref: string;
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+    commit?: string | undefined;
+}, {
+    source: "github";
+    version: string;
+    repo: string;
+    ref: string;
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+    commit?: string | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"npm">;
+    tarball: z.ZodString;
+    integrity: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    fetchedAt: z.ZodString;
+    fileCount: z.ZodNumber;
+    contentHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "npm";
+    version: string;
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+    tarball: string;
+    integrity?: string | undefined;
+}, {
+    source: "npm";
+    version: string;
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+    tarball: string;
+    integrity?: string | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"web">;
+    urls: z.ZodArray<z.ZodString, "many">;
+    version: z.ZodString;
+    fetchedAt: z.ZodString;
+    fileCount: z.ZodNumber;
+    contentHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "web";
+    version: string;
+    urls: string[];
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+}, {
+    source: "web";
+    version: string;
+    urls: string[];
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"llms-txt">;
+    url: z.ZodString;
+    version: z.ZodString;
+    fetchedAt: z.ZodString;
+    fileCount: z.ZodNumber;
+    contentHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "llms-txt";
+    version: string;
+    url: string;
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+}, {
+    source: "llms-txt";
+    version: string;
+    url: string;
+    fetchedAt: string;
+    fileCount: number;
+    contentHash: string;
+}>]>;
+export type LockEntry = z.infer<typeof LockEntrySchema>;
+export declare const LockSchema: z.ZodObject<{
+    lockfileVersion: z.ZodLiteral<1>;
+    generatedAt: z.ZodString;
+    entries: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
+        source: z.ZodLiteral<"github">;
+        repo: z.ZodString;
+        ref: z.ZodString;
+        commit: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+        fetchedAt: z.ZodString;
+        fileCount: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: "github";
+        version: string;
+        repo: string;
+        ref: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        commit?: string | undefined;
+    }, {
+        source: "github";
+        version: string;
+        repo: string;
+        ref: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        commit?: string | undefined;
+    }>, z.ZodObject<{
+        source: z.ZodLiteral<"npm">;
+        tarball: z.ZodString;
+        integrity: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+        fetchedAt: z.ZodString;
+        fileCount: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: "npm";
+        version: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        tarball: string;
+        integrity?: string | undefined;
+    }, {
+        source: "npm";
+        version: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        tarball: string;
+        integrity?: string | undefined;
+    }>, z.ZodObject<{
+        source: z.ZodLiteral<"web">;
+        urls: z.ZodArray<z.ZodString, "many">;
+        version: z.ZodString;
+        fetchedAt: z.ZodString;
+        fileCount: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: "web";
+        version: string;
+        urls: string[];
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    }, {
+        source: "web";
+        version: string;
+        urls: string[];
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    }>, z.ZodObject<{
+        source: z.ZodLiteral<"llms-txt">;
+        url: z.ZodString;
+        version: z.ZodString;
+        fetchedAt: z.ZodString;
+        fileCount: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: "llms-txt";
+        version: string;
+        url: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    }, {
+        source: "llms-txt";
+        version: string;
+        url: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    entries: Record<string, {
+        source: "github";
+        version: string;
+        repo: string;
+        ref: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        commit?: string | undefined;
+    } | {
+        source: "npm";
+        version: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        tarball: string;
+        integrity?: string | undefined;
+    } | {
+        source: "web";
+        version: string;
+        urls: string[];
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    } | {
+        source: "llms-txt";
+        version: string;
+        url: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    }>;
+    lockfileVersion: 1;
+    generatedAt: string;
+}, {
+    entries: Record<string, {
+        source: "github";
+        version: string;
+        repo: string;
+        ref: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        commit?: string | undefined;
+    } | {
+        source: "npm";
+        version: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+        tarball: string;
+        integrity?: string | undefined;
+    } | {
+        source: "web";
+        version: string;
+        urls: string[];
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    } | {
+        source: "llms-txt";
+        version: string;
+        url: string;
+        fetchedAt: string;
+        fileCount: number;
+        contentHash: string;
+    }>;
+    lockfileVersion: 1;
+    generatedAt: string;
+}>;
+export type Lock = z.infer<typeof LockSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA+CvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIvB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AA8CjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK1B,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIrB,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+const NameField = z.string().min(1);
+const VersionField = z.string().min(1);
+// Git ref names must match a conservative subset to prevent shell-injection or
+// path-traversal style mischief — git itself permits broader characters but
+// the ASK lockfile only needs alphanumerics, dot, slash, underscore, hyphen.
+const GitRefField = z.string().regex(/^[\w./-]+$/, 'git ref must contain only [A-Za-z0-9 _ . / -]');
+const GithubSourceConfig = z.object({
+    source: z.literal('github'),
+    name: NameField,
+    version: VersionField,
+    repo: z.string().regex(/^[^/]+\/[^/]+$/, 'repo must be in "owner/name" form'),
+    branch: GitRefField.optional(),
+    tag: GitRefField.optional(),
+    docsPath: z.string().optional(),
+});
+const NpmSourceConfig = z.object({
+    source: z.literal('npm'),
+    name: NameField,
+    version: VersionField,
+    package: z.string().optional(),
+    docsPath: z.string().optional(),
+});
+const WebSourceConfig = z.object({
+    source: z.literal('web'),
+    name: NameField,
+    version: VersionField,
+    urls: z.array(z.string().url()).min(1),
+    maxDepth: z.number().int().min(0).optional(),
+    allowedPathPrefix: z.string().optional(),
+});
+const LlmsTxtSourceConfig = z.object({
+    source: z.literal('llms-txt'),
+    name: NameField,
+    version: VersionField,
+    url: z.string().url(),
+});
+export const SourceConfigSchema = z.discriminatedUnion('source', [
+    GithubSourceConfig,
+    NpmSourceConfig,
+    WebSourceConfig,
+    LlmsTxtSourceConfig,
+]);
+export const ConfigSchema = z.object({
+    schemaVersion: z.literal(1),
+    docs: z.array(SourceConfigSchema),
+    manageIgnores: z.boolean().optional(),
+});
+const ContentHashField = z.string().regex(/^sha256-[0-9a-f]{64}$/, 'contentHash must be sha256-<64 hex chars>');
+const IsoDateTimeField = z.string().datetime({ offset: true });
+const LockEntryBase = {
+    version: VersionField,
+    fetchedAt: IsoDateTimeField,
+    fileCount: z.number().int().nonnegative(),
+    contentHash: ContentHashField,
+};
+const GithubLockEntry = z.object({
+    ...LockEntryBase,
+    source: z.literal('github'),
+    repo: z.string(),
+    ref: z.string(),
+    commit: z.string().regex(/^[0-9a-f]{40}$/).optional(),
+});
+const NpmLockEntry = z.object({
+    ...LockEntryBase,
+    source: z.literal('npm'),
+    tarball: z.string().url(),
+    integrity: z.string().regex(/^sha(?:256|384|512)-[A-Za-z0-9+/=]+$/, 'integrity must be a valid Subresource Integrity hash').optional(),
+});
+const WebLockEntry = z.object({
+    ...LockEntryBase,
+    source: z.literal('web'),
+    urls: z.array(z.string().url()).min(1),
+});
+const LlmsTxtLockEntry = z.object({
+    ...LockEntryBase,
+    source: z.literal('llms-txt'),
+    url: z.string().url(),
+});
+export const LockEntrySchema = z.discriminatedUnion('source', [
+    GithubLockEntry,
+    NpmLockEntry,
+    WebLockEntry,
+    LlmsTxtLockEntry,
+]);
+export const LockSchema = z.object({
+    lockfileVersion: z.literal(1),
+    generatedAt: IsoDateTimeField,
+    entries: z.record(z.string(), LockEntrySchema),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/skill.d.ts

@@ -0,0 +1,4 @@
+export declare function getSkillDir(projectDir: string, name: string): string;
+export declare function generateSkill(projectDir: string, name: string, version: string, fileList: string[]): string;
+export declare function removeSkill(projectDir: string, name: string): void;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CA+CR;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKlE"}

package/dist/skill.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLibraryDocsDir } from './storage.js';
+export function getSkillDir(projectDir, name) {
+    return path.join(projectDir, '.claude', 'skills', `${name}-docs`);
+}
+export function generateSkill(projectDir, name, version, fileList) {
+    const skillDir = getSkillDir(projectDir, name);
+    fs.mkdirSync(skillDir, { recursive: true });
+    const docsRelPath = path.relative(projectDir, getLibraryDocsDir(projectDir, name, version));
+    const toc = fileList
+        .filter(f => f !== 'INDEX.md')
+        .map(f => `- \`${docsRelPath}/${f}\``)
+        .join('\n');
+    const major = version.split('.')[0];
+    const content = `---
+name: ${name}-docs
+description: ${name} v${version} documentation reference. TRIGGER when writing or modifying code that imports or uses ${name}.
+---
+
+# ${name} v${version} Documentation
+
+This project uses **${name} v${version}**.
+The APIs and patterns may differ from your training data.
+**Read the relevant docs before writing any code.**
+
+## Version
+- Current: \`${version}\`
+- In package.json, use \`"^${major}"\` (NOT older major versions)
+
+## Documentation Location
+\`${docsRelPath}/\`
+
+## Available Guides
+${toc}
+
+## Instructions
+1. Before writing any ${name}-related code, read the relevant guide in \`${docsRelPath}/\`
+2. Heed deprecation notices and breaking changes
+3. Prefer patterns shown in the documentation over patterns from training data
+4. When adding ${name} to package.json, use version \`"^${major}"\`
+`;
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    fs.writeFileSync(skillPath, content, 'utf-8');
+    return skillPath;
+}
+export function removeSkill(projectDir, name) {
+    const skillDir = getSkillDir(projectDir, name);
+    if (fs.existsSync(skillDir)) {
+        fs.rmSync(skillDir, { recursive: true });
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,IAAY;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,IAAY,EACZ,OAAe,EACf,QAAkB;IAElB,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC9C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAC/B,UAAU,EACV,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAC7C,CAAA;IAED,MAAM,GAAG,GAAG,QAAQ;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,WAAW,IAAI,CAAC,IAAI,CAAC;SACrC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnC,MAAM,OAAO,GAAG;QACV,IAAI;eACG,IAAI,KAAK,OAAO,yFAAyF,IAAI;;;IAGxH,IAAI,KAAK,OAAO;;sBAEE,IAAI,KAAK,OAAO;;;;;eAKvB,OAAO;6BACO,KAAK;;;IAG9B,WAAW;;;EAGb,GAAG;;;wBAGmB,IAAI,+CAA+C,WAAW;;;iBAGrE,IAAI,qCAAqC,KAAK;CAC9D,CAAA;IAEC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACjD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,IAAY;IAC1D,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}

package/dist/sources/github.d.ts

@@ -0,0 +1,14 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+export declare class GithubSource implements DocSource {
+    fetch(options: SourceConfig): Promise<FetchResult>;
+    private detectDocsPath;
+    private collectDocFiles;
+    /**
+     * 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.
+     */
+    private resolveCommit;
+    private isDocFile;
+}
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/sources/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EAEX,YAAY,EACb,MAAM,YAAY,CAAA;AAWnB,qBAAa,YAAa,YAAW,SAAS;IACtC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA4DxD,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;IAmBvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,SAAS;CAIlB"}