@pleaseai/ask 0.1.0 → 0.1.3

package/dist/index.js

@@ -0,0 +1,485 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import process from 'node:process';
+import { pathToFileURL } from 'node:url';
+import { defineCommand, runMain } from 'citty';
+import { consola } from 'consola';
+import { generateAgentsMd } from './agents.js';
+import { runWithConcurrency } from './concurrency.js';
+import { addDocEntry, loadConfig, removeDocEntry, } from './config.js';
+import { manageIgnoreFiles } from './ignore-files.js';
+import { contentHash, getConfigPath, getLockPath, readLock, upsertLockEntry } from './io.js';
+import { getReader } from './manifest/index.js';
+import { migrateLegacyWorkspace } from './migrate-legacy.js';
+import { fetchRegistryEntry, parseDocSpec, parseEcosystem, resolveFromRegistry } from './registry.js';
+import { getResolver } from './resolvers/index.js';
+import { generateSkill, removeSkill } from './skill.js';
+import { getSource } from './sources/index.js';
+import { listDocs, removeDocs, saveDocs } from './storage.js';
+function buildLockEntry(config, result) {
+    const base = {
+        version: result.resolvedVersion,
+        fetchedAt: new Date().toISOString(),
+        fileCount: result.files.length,
+        contentHash: contentHash(result.files.map(f => ({ relpath: f.path, content: f.content }))),
+    };
+    const meta = result.meta ?? {};
+    switch (config.source) {
+        case 'github':
+            return {
+                ...base,
+                source: 'github',
+                repo: config.repo,
+                ref: meta.ref ?? config.tag ?? config.branch ?? 'main',
+                ...(meta.commit ? { commit: meta.commit } : {}),
+            };
+        case 'npm':
+            if (!meta.tarball) {
+                throw new Error(`npm source did not return a tarball URL for ${config.name}@${result.resolvedVersion}. `
+                    + 'Cannot record lockfile entry without it.');
+            }
+            return {
+                ...base,
+                source: 'npm',
+                tarball: meta.tarball,
+                ...(meta.integrity ? { integrity: meta.integrity } : {}),
+            };
+        case 'web':
+            return {
+                ...base,
+                source: 'web',
+                urls: meta.urls ?? config.urls,
+            };
+        case 'llms-txt':
+            return {
+                ...base,
+                source: 'llms-txt',
+                url: (meta.urls ?? [])[0] ?? config.url,
+            };
+    }
+}
+/**
+ * Gate A: reject bare-name specs (`ask docs add next`).
+ *
+ * Bare names are ambiguous — they give the CLI no ecosystem hint and no
+ * explicit source, and silently auto-resolving them (which the old code did)
+ * can hand back wrong-looking docs. Instead we force the caller to either use
+ * an ecosystem prefix (`npm:next`) or the github shorthand (`owner/repo`).
+ *
+ * Returns an error message when the spec is ambiguous, or `null` when it is
+ * OK to proceed. `hasExplicitSource` lets the caller opt out of the check
+ * when `--source` is passed explicitly — an explicit source disambiguates.
+ */
+export function checkBareNameGate(input, parsedKind, hasExplicitSource) {
+    if (hasExplicitSource)
+        return null;
+    if (parsedKind !== 'name')
+        return null;
+    return (`Ambiguous spec '${input}'. Use one of:\n`
+        + `  • npm:<name>[@version]    (or pypi:, pub:, crates:, hex:, go:, maven:)\n`
+        + `  • <owner>/<repo>[@ref]    (direct GitHub)\n`
+        + `Tip: the add-docs skill auto-resolves bare names from your project manifest.`);
+}
+export function runManifestGate(ecosystem, name, version, projectDir, opts, readerFactory = getReader) {
+    if (opts.noManifest)
+        return { kind: 'ok' };
+    if (version !== 'latest')
+        return { kind: 'ok' };
+    const reader = readerFactory(ecosystem);
+    const hit = reader?.readInstalledVersion(name, projectDir) ?? null;
+    if (!hit) {
+        if (opts.fromManifest) {
+            return {
+                kind: 'error',
+                message: `--from-manifest was set but no ${ecosystem} manifest entry found for '${name}'. `
+                    + `Ensure the package is listed in your lockfile or package.json.`,
+            };
+        }
+        return { kind: 'ok' };
+    }
+    return { kind: 'ok', version: hit.version, source: hit.source };
+}
+function parseSpec(spec) {
+    const lastAt = spec.lastIndexOf('@');
+    if (lastAt > 0) {
+        return {
+            name: spec.substring(0, lastAt),
+            version: spec.substring(lastAt + 1),
+        };
+    }
+    return { name: spec, version: 'latest' };
+}
+function buildSourceConfig(name, version, opts) {
+    const base = { name, version };
+    switch (opts.source) {
+        case 'npm':
+            return {
+                ...base,
+                source: 'npm',
+                docsPath: opts.docsPath,
+            };
+        case 'github':
+            if (!opts.repo) {
+                throw new Error('--repo is required for github source');
+            }
+            return {
+                ...base,
+                source: 'github',
+                repo: opts.repo,
+                branch: opts.branch,
+                tag: opts.tag,
+                docsPath: opts.docsPath,
+            };
+        case 'web':
+            if (!opts.url || opts.url.length === 0) {
+                throw new Error('--url is required for web source');
+            }
+            return {
+                ...base,
+                source: 'web',
+                urls: opts.url,
+                maxDepth: Number.parseInt(opts.maxDepth ?? '1', 10),
+                allowedPathPrefix: opts.pathPrefix,
+            };
+        case 'llms-txt':
+            if (!opts.url || opts.url.length === 0) {
+                throw new Error('--url is required for llms-txt source');
+            }
+            return {
+                ...base,
+                source: 'llms-txt',
+                url: opts.url[0],
+            };
+        default:
+            throw new Error(`Unknown source: ${opts.source}`);
+    }
+}
+const addCmd = defineCommand({
+    meta: { name: 'add', description: 'Download documentation for a library' },
+    args: {
+        'spec': { type: 'positional', description: 'Library spec (e.g. zod@3.22 or npm:next@canary)', required: true },
+        'source': { type: 'string', description: 'Source type: npm, github, web, llms-txt (auto-detected if omitted)', alias: ['s'] },
+        'repo': { type: 'string', description: 'GitHub repository (for github source)' },
+        'branch': { type: 'string', description: 'Git branch (for github source)' },
+        'tag': { type: 'string', description: 'Git tag (for github source)' },
+        'docsPath': { type: 'string', description: 'Path to docs within the package/repo' },
+        'url': { type: 'string', description: 'Documentation URL (for web source)' },
+        'maxDepth': { type: 'string', description: 'Max crawl depth for web source', default: '1' },
+        'pathPrefix': { type: 'string', description: 'URL path prefix filter for web source' },
+        'no-manifest': { type: 'boolean', description: 'Do not consult project manifest/lockfile for version resolution' },
+        'from-manifest': { type: 'boolean', description: 'Require manifest/lockfile to supply the version; error if absent' },
+    },
+    async run({ args }) {
+        const projectDir = process.cwd();
+        migrateLegacyWorkspace(projectDir);
+        let effectiveSpec = args.spec;
+        const parsed = parseDocSpec(effectiveSpec);
+        const { spec: cleanSpec } = parseEcosystem(effectiveSpec);
+        let sourceConfig;
+        // Gate A — reject bare-name specs (ambiguous, no ecosystem hint).
+        const gateAError = checkBareNameGate(effectiveSpec, parsed.kind, Boolean(args.source));
+        if (gateAError) {
+            consola.error(gateAError);
+            process.exit(1);
+            return; // unreachable
+        }
+        // Gate B — manifest-based version resolution. Only applies to ecosystem
+        // specs with no explicit version (`npm:next` / `pypi:fastapi`).
+        if (parsed.kind === 'ecosystem') {
+            const gateB = runManifestGate(parsed.ecosystem, parsed.name, parsed.version, projectDir, {
+                // citty exposes kebab-case flags under the original key as defined in args.
+                noManifest: Boolean(args['no-manifest']),
+                fromManifest: Boolean(args['from-manifest']),
+            });
+            if (gateB.kind === 'error') {
+                consola.error(gateB.message);
+                process.exit(1);
+                return; // unreachable
+            }
+            if (gateB.version) {
+                consola.info(`Using version ${gateB.version} from ${gateB.source}`);
+                // Mutation is intentional: the ecosystem resolver fallback at line ~365
+                // calls resolver.resolve(parsed.name, parsed.version) directly, so
+                // parsed.version must reflect the manifest override.
+                parsed.version = gateB.version;
+                // Also rebuild effectiveSpec so resolveFromRegistry (which re-parses
+                // from the raw spec string) picks up the override version.
+                effectiveSpec = `${parsed.ecosystem}:${parsed.name}@${gateB.version}`;
+            }
+        }
+        // github fast-path: `owner/repo[@ref]` — try registry for docsPath,
+        // then fall back to bare repo download.
+        // Only triggered when no explicit --source override was passed.
+        if (!args.source && parsed.kind === 'github') {
+            const { owner, repo, ref } = parsed;
+            const repoSpec = `${owner}/${repo}`;
+            const version = ref ?? 'latest';
+            const libName = `${owner}-${repo}`;
+            // Enrich with registry metadata (docsPath, strategies) when available
+            let docsPath = args.docsPath;
+            if (!docsPath) {
+                const entry = await fetchRegistryEntry(owner, repo);
+                if (entry) {
+                    consola.info(`Found ${entry.name} in registry`);
+                    docsPath = entry.docsPath;
+                }
+            }
+            consola.start(`Downloading ${repoSpec}${ref ? `@${ref}` : ''} docs (source: github)...`);
+            sourceConfig = {
+                source: 'github',
+                name: libName,
+                version,
+                repo: repoSpec,
+                tag: ref,
+                docsPath,
+            };
+        }
+        else if (args.source) {
+            // Explicit source — use manual config
+            const { name, version } = parseSpec(cleanSpec);
+            const urls = args.url ? [args.url] : undefined;
+            consola.start(`Downloading ${name}@${version} docs (source: ${args.source})...`);
+            sourceConfig = buildSourceConfig(name, version, {
+                source: args.source,
+                repo: args.repo,
+                branch: args.branch,
+                tag: args.tag,
+                docsPath: args.docsPath,
+                url: urls,
+                maxDepth: args.maxDepth,
+                pathPrefix: args.pathPrefix,
+            });
+        }
+        else {
+            // Auto-detect from registry
+            const resolved = await resolveFromRegistry(effectiveSpec, projectDir);
+            if (resolved) {
+                const { strategy } = resolved;
+                consola.start(`Downloading ${resolved.name}@${resolved.version} docs (source: ${strategy.source})...`);
+                sourceConfig = buildSourceConfig(resolved.name, resolved.version, {
+                    source: strategy.source,
+                    repo: strategy.repo,
+                    docsPath: strategy.docsPath,
+                    url: strategy.urls ?? (strategy.url ? [strategy.url] : undefined),
+                    maxDepth: strategy.maxDepth?.toString(),
+                    pathPrefix: strategy.allowedPathPrefix,
+                    branch: strategy.branch,
+                    tag: strategy.tag,
+                });
+            }
+            else if (parsed.kind === 'ecosystem') {
+                // Registry miss with ecosystem prefix → try ecosystem resolver
+                const resolver = getResolver(parsed.ecosystem);
+                if (!resolver) {
+                    consola.error(`'${args.spec}' not found in registry and no resolver for '${parsed.ecosystem}'. `
+                        + `Use --source to specify manually.`);
+                    process.exit(1);
+                    return; // unreachable — hints TS that control flow ends
+                }
+                consola.info(`Registry miss — resolving via ${parsed.ecosystem} package metadata...`);
+                const resolveResult = await resolver.resolve(parsed.name, parsed.version);
+                consola.start(`Downloading ${parsed.name}@${resolveResult.resolvedVersion} docs (source: github via ${parsed.ecosystem} resolver)...`);
+                sourceConfig = {
+                    source: 'github',
+                    name: parsed.name,
+                    version: resolveResult.resolvedVersion,
+                    repo: resolveResult.repo,
+                    tag: resolveResult.ref,
+                    docsPath: args.docsPath,
+                };
+            }
+            else {
+                consola.error(`'${args.spec}' not found in registry. Use --source to specify manually.`);
+                process.exit(1);
+                return; // unreachable — hints TS that control flow ends
+            }
+        }
+        const source = getSource(sourceConfig.source);
+        const result = await source.fetch(sourceConfig);
+        const libName = sourceConfig.name;
+        consola.info(`Fetched ${result.files.length} doc files (resolved version: ${result.resolvedVersion})`);
+        const docsDir = saveDocs(projectDir, libName, result.resolvedVersion, result.files);
+        consola.info(`Docs saved to: ${docsDir}`);
+        const configEntry = { ...sourceConfig, version: result.resolvedVersion };
+        addDocEntry(projectDir, configEntry);
+        consola.info(`Config updated: ${path.relative(projectDir, getConfigPath(projectDir))}`);
+        const lockEntry = buildLockEntry(sourceConfig, result);
+        upsertLockEntry(projectDir, libName, lockEntry);
+        consola.info(`Lock updated: ${path.relative(projectDir, getLockPath(projectDir))}`);
+        const skillPath = generateSkill(projectDir, libName, result.resolvedVersion, result.files.map(f => f.path));
+        consola.info(`Skill created: ${skillPath}`);
+        const agentsPath = generateAgentsMd(projectDir);
+        consola.info(`AGENTS.md updated: ${agentsPath}`);
+        manageIgnoreFiles(projectDir, 'install');
+        consola.success(`Done! ${libName}@${result.resolvedVersion} docs are ready for AI agents.`);
+    },
+});
+/**
+ * Sync a single doc entry: fetch, diff, write. Never throws — failures are
+ * captured and returned as `status: 'failed'`. Logs the same lines that the
+ * legacy serial loop emitted, so user-facing output is unchanged.
+ *
+ * The internal write order (saveDocs → addDocEntry → upsertLockEntry →
+ * removeDocs(old) → generateSkill) is preserved verbatim from the previous
+ * implementation. See the inline comment below for the rationale.
+ *
+ * Safe to call from `runWithConcurrency` because:
+ *   1. Only `source.fetch()` is async (network I/O).
+ *   2. All disk writes (`addDocEntry`, `upsertLockEntry`, `saveDocs`,
+ *      `removeDocs`, `generateSkill`) are fully synchronous fs operations
+ *      with no `await` between read and write — Node's single-threaded event
+ *      loop guarantees they execute atomically with respect to each other.
+ */
+async function syncEntry(projectDir, entry, lock) {
+    try {
+        consola.info(`  ${entry.name} (${entry.source})...`);
+        const source = getSource(entry.source);
+        const result = await source.fetch(entry);
+        const newLockEntry = buildLockEntry(entry, result);
+        const previousLock = lock.entries[entry.name];
+        const changed = !previousLock
+            || previousLock.contentHash !== newLockEntry.contentHash
+            || previousLock.version !== newLockEntry.version;
+        if (!changed) {
+            consola.info(`  -> unchanged (v${result.resolvedVersion})`);
+            return 'unchanged';
+        }
+        // Drift confirmed. Order is intentional: every write that can throw
+        // (saveDocs, addDocEntry/Zod, upsertLockEntry/Zod) happens BEFORE the
+        // destructive removeDocs of the old version. A mid-flow failure
+        // leaves both directories on disk and the config/lock pointing at
+        // the old version — recoverable on the next sync. Reversing this
+        // order would let a failed write leave config pointing at a deleted
+        // directory.
+        saveDocs(projectDir, entry.name, result.resolvedVersion, result.files);
+        addDocEntry(projectDir, { ...entry, version: result.resolvedVersion });
+        upsertLockEntry(projectDir, entry.name, newLockEntry);
+        if (previousLock && previousLock.version !== result.resolvedVersion) {
+            removeDocs(projectDir, entry.name, previousLock.version);
+        }
+        generateSkill(projectDir, entry.name, result.resolvedVersion, result.files.map(f => f.path));
+        const fromVersion = previousLock?.version ?? '(new)';
+        consola.success(`  ⟳ ${fromVersion} → ${result.resolvedVersion} (${result.files.length} files)`);
+        return 'drifted';
+    }
+    catch (err) {
+        consola.error(`  -> Error: ${err instanceof Error ? err.message : err}`);
+        return 'failed';
+    }
+}
+// Sources that are safe to fetch in parallel. `web` is intentionally excluded
+// to remain polite toward upstream documentation servers (we don't know if
+// multiple URLs hit the same host, and crawl bursts can trip rate limits).
+const PARALLEL_SOURCES = new Set(['github', 'npm', 'llms-txt']);
+const SYNC_CONCURRENCY = 5;
+export async function runSync(projectDir, options = {}) {
+    migrateLegacyWorkspace(projectDir);
+    const config = loadConfig(projectDir);
+    const lock = readLock(projectDir);
+    if (config.docs.length === 0) {
+        consola.info('No docs configured in .ask/config.json');
+        return { drifted: 0, unchanged: 0, failed: 0 };
+    }
+    consola.start(`Syncing ${config.docs.length} library docs...`);
+    const fn = options.syncEntryFn ?? syncEntry;
+    const parallel = [];
+    const serial = [];
+    for (const entry of config.docs) {
+        if (PARALLEL_SOURCES.has(entry.source)) {
+            parallel.push(entry);
+        }
+        else {
+            serial.push(entry);
+        }
+    }
+    const parallelResults = await runWithConcurrency(parallel, SYNC_CONCURRENCY, entry => fn(projectDir, entry, lock));
+    const serialResults = [];
+    for (const entry of serial) {
+        serialResults.push(await fn(projectDir, entry, lock));
+    }
+    const counts = { drifted: 0, unchanged: 0, failed: 0 };
+    for (const status of [...parallelResults, ...serialResults]) {
+        counts[status]++;
+    }
+    if (!options.skipAgentsMd) {
+        generateAgentsMd(projectDir);
+    }
+    // `skipAgentsMd` is specifically about AGENTS.md regeneration; ignore
+    // file management always runs so that the project's lint/format/review
+    // tooling stays in sync with the current `.ask/docs/` state.
+    manageIgnoreFiles(projectDir, 'install');
+    consola.success(`Sync complete: ${counts.drifted} re-fetched, ${counts.unchanged} unchanged, ${counts.failed} failed. AGENTS.md updated.`);
+    return counts;
+}
+const syncCmd = defineCommand({
+    meta: { name: 'sync', description: 'Refresh docs from .ask/config.json, using .ask/ask.lock as the drift baseline' },
+    async run() {
+        await runSync(process.cwd());
+    },
+});
+const listCmd = defineCommand({
+    meta: { name: 'list', description: 'List downloaded documentation' },
+    run() {
+        const projectDir = process.cwd();
+        migrateLegacyWorkspace(projectDir);
+        const entries = listDocs(projectDir);
+        if (entries.length === 0) {
+            consola.info('No docs downloaded yet. Use `ask docs add` to get started.');
+            return;
+        }
+        consola.info('Downloaded documentation:');
+        for (const { name, version, fileCount } of entries) {
+            consola.log(`  ${name}@${version}  (${fileCount} files)`);
+        }
+    },
+});
+const removeCmd = defineCommand({
+    meta: { name: 'remove', description: 'Remove downloaded documentation' },
+    args: {
+        spec: { type: 'positional', description: 'Library spec (e.g. zod or zod@3.22)', required: true },
+    },
+    run({ args }) {
+        const projectDir = process.cwd();
+        migrateLegacyWorkspace(projectDir);
+        const { name, version } = parseSpec(args.spec);
+        const hasExplicitVersion = args.spec.lastIndexOf('@') > 0;
+        const ver = hasExplicitVersion ? version : undefined;
+        removeDocs(projectDir, name, ver);
+        removeSkill(projectDir, name);
+        removeDocEntry(projectDir, name, ver);
+        generateAgentsMd(projectDir);
+        // If no docs remain, strip all ignore-file artifacts. Otherwise keep
+        // them in sync (e.g. a new root .prettierignore added since last add).
+        const remaining = listDocs(projectDir);
+        manageIgnoreFiles(projectDir, remaining.length === 0 ? 'remove' : 'install');
+        consola.success(`Removed docs for ${name}${ver ? `@${ver}` : ' (all versions)'}`);
+    },
+});
+const docsCmd = defineCommand({
+    meta: { name: 'docs', description: 'Manage library documentation' },
+    subCommands: {
+        add: addCmd,
+        sync: syncCmd,
+        list: listCmd,
+        remove: removeCmd,
+    },
+});
+const main = defineCommand({
+    meta: {
+        name: 'ask',
+        version: '0.1.0',
+        description: 'Agent Skills Kit - Download version-specific library docs for AI coding agents',
+    },
+    subCommands: {
+        docs: docsCmd,
+    },
+});
+// Only execute the CLI when this module is the program entry point.
+// Tests import `runSync` from this file and must NOT trigger CLI execution.
+// Use `pathToFileURL` for a cross-platform comparison: a naive
+// `file://${process.argv[1]}` template breaks on Windows (backslash paths)
+// and on POSIX paths containing spaces or unicode (no URL encoding).
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    runMain(main);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/io.d.ts

@@ -0,0 +1,55 @@
+import type { Config, Lock, LockEntry } from './schemas.js';
+/**
+ * Serialize a value to JSON with sorted keys, 2-space indent, and a trailing
+ * newline. Two calls with semantically equivalent input always produce the
+ * same byte string.
+ */
+export declare function sortedJSON(value: unknown): string;
+/**
+ * Compute a deterministic content hash over a list of files.
+ * Files are sorted by relative path; each file contributes
+ * `<relpath>\0<bytes>\0` to the hash stream. The null separators prevent
+ * `path + content` ambiguity (e.g. "ab" + "cd" vs "a" + "bcd").
+ *
+ * Accepts either pre-encoded bytes or string content (the common case for
+ * DocFile records returned by source adapters).
+ */
+export interface HashableFile {
+    relpath: string;
+    bytes?: Uint8Array;
+    content?: string;
+}
+export declare function contentHash(files: HashableFile[]): string;
+export declare function getAskDir(projectDir: string): string;
+export declare function getConfigPath(projectDir: string): string;
+export declare function getLockPath(projectDir: string): string;
+/**
+ * Read and validate `.ask/config.json`. Returns the default empty config when
+ * the file does not exist. Throws on invalid contents.
+ */
+export declare function readConfig(projectDir: string): Config;
+/**
+ * Validate, sort, and write `.ask/config.json`. Sorts `docs[]` by name.
+ * Throws (without writing) if the input fails Zod validation.
+ */
+export declare function writeConfig(projectDir: string, config: Config): void;
+/**
+ * Read and validate `.ask/ask.lock`. Returns the default empty lock when the
+ * file does not exist. Throws on invalid contents.
+ */
+export declare function readLock(projectDir: string): Lock;
+/**
+ * Validate, sort, and write `.ask/ask.lock`. Throws (without writing) if the
+ * input fails Zod validation.
+ */
+export declare function writeLock(projectDir: string, lock: Lock): void;
+/**
+ * Upsert a single entry into `.ask/ask.lock`. Updates `generatedAt` only when
+ * the entry actually changes (so byte-stable on no-op re-runs).
+ */
+export declare function upsertLockEntry(projectDir: string, name: string, entry: LockEntry): void;
+/**
+ * Remove one or more entries from the lock by name. No-op if absent.
+ */
+export declare function removeLockEntries(projectDir: string, names: string[]): void;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAuB3D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAKD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAYzD;AAMD,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBrD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAqBjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAK9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GACf,IAAI,CAeN;AAOD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,IAAI,CAaN"}