skilld 0.0.1 → 0.1.1

package/dist/_chunks/types.d.mts

@@ -0,0 +1,87 @@
+//#region src/retriv/types.d.ts
+interface ChunkEntity {
+  name: string;
+  type: string;
+  signature?: string;
+  isPartial?: boolean;
+}
+interface Document {
+  id: string;
+  content: string;
+  metadata?: Record<string, any>;
+}
+interface ChunkingOptions {
+  chunkSize?: number;
+  chunkOverlap?: number;
+}
+interface IndexConfig {
+  dbPath: string;
+  model?: string;
+  chunking?: ChunkingOptions;
+  /** Progress callback (current, total, currentDoc) */
+  onProgress?: (current: number, total: number, doc?: {
+    id: string;
+    type?: string;
+  }) => void;
+}
+interface SearchResult {
+  id: string;
+  content: string;
+  score: number;
+  metadata: Record<string, any>;
+  highlights: string[];
+  /** Line range from chunk [start, end] */
+  lineRange?: [number, number];
+  entities?: ChunkEntity[];
+  scope?: ChunkEntity[];
+}
+type FilterOperator = {
+  $eq: string | number | boolean;
+} | {
+  $ne: string | number | boolean;
+} | {
+  $gt: number;
+} | {
+  $gte: number;
+} | {
+  $lt: number;
+} | {
+  $lte: number;
+} | {
+  $in: (string | number)[];
+} | {
+  $prefix: string;
+} | {
+  $exists: boolean;
+};
+type FilterValue = string | number | boolean | FilterOperator;
+type SearchFilter = Record<string, FilterValue>;
+interface SearchOptions {
+  /** Max results */
+  limit?: number;
+  /** Filter by metadata fields */
+  filter?: SearchFilter;
+}
+interface SearchSnippet {
+  /** Package name and version */
+  package: string;
+  /** Source file path */
+  source: string;
+  /** Start line number */
+  lineStart: number;
+  /** End line number */
+  lineEnd: number;
+  /** Snippet content (5 lines around best match) */
+  content: string;
+  /** Relevance score */
+  score: number;
+  /** Matched query terms, ordered by BM25 score */
+  highlights: string[];
+  /** Entities defined in this chunk */
+  entities?: ChunkEntity[];
+  /** Containing scope chain */
+  scope?: ChunkEntity[];
+}
+//#endregion
+export { SearchOptions as a, SearchFilter as i, Document as n, SearchResult as o, IndexConfig as r, SearchSnippet as s, ChunkEntity as t };
+//# sourceMappingURL=types.d.mts.map

package/dist/_chunks/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/retriv/types.ts"],"mappings":";UAAiB,WAAA;EACf,IAAA;EACA,IAAA;EACA,SAAA;EACA,SAAA;AAAA;AAAA,UAGe,QAAA;EACf,EAAA;EACA,OAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,eAAA;EACf,SAAA;EACA,YAAA;AAAA;AAAA,UAGe,WAAA;EACf,MAAA;EACA,KAAA;EACA,QAAA,GAAW,eAAA;;EAEX,UAAA,IAAc,OAAA,UAAiB,KAAA,UAAe,GAAA;IAAQ,EAAA;IAAY,IAAA;EAAA;AAAA;AAAA,UAGnD,YAAA;EACf,EAAA;EACA,OAAA;EACA,KAAA;EACA,QAAA,EAAU,MAAA;EACV,UAAA;EAXA;EAaA,SAAA;EACA,QAAA,GAAW,WAAA;EACX,KAAA,GAAQ,WAAA;AAAA;AAAA,KAGE,cAAA;EACJ,GAAA;AAAA;EACA,GAAA;AAAA;EACA,GAAA;AAAA;EACA,IAAA;AAAA;EACA,GAAA;AAAA;EACA,IAAA;AAAA;EACA,GAAA;AAAA;EACA,OAAA;AAAA;EACA,OAAA;AAAA;AAAA,KAEI,WAAA,+BAA0C,cAAA;AAAA,KAC1C,YAAA,GAAe,MAAA,SAAe,WAAA;AAAA,UAEzB,aAAA;EAlBJ;EAoBX,KAAA;EAnBQ;EAqBR,MAAA,GAAS,YAAA;AAAA;AAAA,UAGM,aAAA;EArBS;EAuBxB,OAAA;EAvBwB;EAyBxB,MAAA;EAvBM;EAyBN,SAAA;EAvBM;EAyBN,OAAA;EAvBM;EAyBN,OAAA;EAvBM;EAyBN,KAAA;;EAEA,UAAA;EAxBU;EA0BV,QAAA,GAAW,WAAA;;EAEX,KAAA,GAAQ,WAAA;AAAA"}

package/dist/_chunks/utils.d.mts

@@ -0,0 +1,352 @@
+//#region src/sources/discussions.d.ts
+/**
+ * GitHub discussions fetching via gh CLI GraphQL
+ */
+interface GitHubDiscussion {
+  number: number;
+  title: string;
+  body: string;
+  category: string;
+  createdAt: string;
+  url: string;
+  upvoteCount: number;
+  comments: number;
+}
+/**
+ * Fetch last N discussions from a GitHub repo using gh CLI GraphQL
+ */
+declare function fetchGitHubDiscussions(owner: string, repo: string, limit?: number): Promise<GitHubDiscussion[]>;
+/**
+ * Format discussions as markdown for agent consumption
+ */
+declare function formatDiscussionsAsMarkdown(discussions: GitHubDiscussion[]): string;
+//#endregion
+//#region src/sources/entries.d.ts
+interface EntryFile {
+  path: string;
+  content: string;
+  type: 'types' | 'source';
+}
+/**
+ * Glob .d.ts type definition files from a package directory, skipping junk.
+ */
+declare function resolveEntryFiles(packageDir: string): Promise<EntryFile[]>;
+//#endregion
+//#region src/sources/github.d.ts
+/**
+ * GitHub/ungh README resolution + versioned docs
+ */
+interface GitDocsResult {
+  /** URL pattern for fetching docs (use with ref) */
+  baseUrl: string;
+  /** Git ref (tag) used */
+  ref: string;
+  /** List of doc file paths relative to repo root */
+  files: string[];
+  /** Prefix to strip when normalizing paths to docs/ (e.g. 'apps/evalite-docs/src/content/') for nested monorepo docs */
+  docsPrefix?: string;
+}
+/**
+ * Fetch versioned docs from GitHub repo's docs/ folder.
+ * Pass packageName to check doc overrides (e.g. vue -> vuejs/docs).
+ */
+declare function fetchGitDocs(owner: string, repo: string, version: string, packageName?: string): Promise<GitDocsResult | null>;
+/**
+ * Fetch GitHub repo metadata to get website URL.
+ * Pass packageName to check doc overrides first (avoids API call).
+ */
+declare function fetchGitHubRepoMeta(owner: string, repo: string, packageName?: string): Promise<{
+  homepage?: string;
+} | null>;
+/**
+ * Resolve README URL for a GitHub repo, returns ungh:// pseudo-URL or raw URL
+ */
+declare function fetchReadme(owner: string, repo: string, subdir?: string): Promise<string | null>;
+/**
+ * Fetch README content from ungh:// pseudo-URL, file:// URL, or regular URL
+ */
+declare function fetchReadmeContent(url: string): Promise<string | null>;
+//#endregion
+//#region src/sources/issues.d.ts
+/**
+ * GitHub issues fetching via gh CLI
+ */
+interface GitHubIssue {
+  number: number;
+  title: string;
+  state: string;
+  labels: string[];
+  body: string;
+  createdAt: string;
+  url: string;
+}
+/**
+ * Check if gh CLI is installed and authenticated (cached)
+ */
+declare function isGhAvailable(): boolean;
+/**
+ * Fetch last N issues from a GitHub repo using gh CLI
+ */
+declare function fetchGitHubIssues(owner: string, repo: string, limit?: number): Promise<GitHubIssue[]>;
+/**
+ * Format issues as markdown for agent consumption
+ */
+declare function formatIssuesAsMarkdown(issues: GitHubIssue[]): string;
+//#endregion
+//#region src/sources/types.d.ts
+/**
+ * Doc resolver types
+ */
+interface NpmPackageInfo {
+  name: string;
+  version?: string;
+  description?: string;
+  homepage?: string;
+  repository?: string | {
+    type: string;
+    url: string;
+    directory?: string;
+  };
+  readme?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+}
+interface ResolvedPackage {
+  name: string;
+  version?: string;
+  /** ISO date string when this version was released */
+  releasedAt?: string;
+  description?: string;
+  /** Production dependencies with version specifiers */
+  dependencies?: Record<string, string>;
+  /** npm dist-tags with version and release date */
+  distTags?: Record<string, {
+    version: string;
+    releasedAt?: string;
+  }>;
+  docsUrl?: string;
+  llmsUrl?: string;
+  readmeUrl?: string;
+  repoUrl?: string;
+  /** Git docs folder - versioned docs from repo */
+  gitDocsUrl?: string;
+  /** Git tag/ref used for gitDocsUrl */
+  gitRef?: string;
+}
+interface LocalDependency {
+  name: string;
+  version: string;
+}
+interface LlmsContent {
+  raw: string;
+  /** Markdown links extracted from llms.txt */
+  links: LlmsLink[];
+}
+interface LlmsLink {
+  title: string;
+  url: string;
+}
+interface FetchedDoc {
+  url: string;
+  title: string;
+  content: string;
+}
+interface ResolveAttempt {
+  source: 'npm' | 'github-docs' | 'github-meta' | 'github-search' | 'llms.txt' | 'readme';
+  url?: string;
+  status: 'success' | 'not-found' | 'error';
+  message?: string;
+}
+interface ResolveResult {
+  package: ResolvedPackage | null;
+  attempts: ResolveAttempt[];
+}
+//#endregion
+//#region src/sources/llms.d.ts
+/**
+ * Check for llms.txt at a docs URL, returns the llms.txt URL if found
+ */
+declare function fetchLlmsUrl(docsUrl: string): Promise<string | null>;
+/**
+ * Fetch and parse llms.txt content
+ */
+declare function fetchLlmsTxt(url: string): Promise<LlmsContent | null>;
+/**
+ * Parse markdown links from llms.txt to get .md file paths
+ */
+declare function parseMarkdownLinks(content: string): LlmsLink[];
+/**
+ * Download all .md files referenced in llms.txt
+ */
+declare function downloadLlmsDocs(llmsContent: LlmsContent, baseUrl: string, onProgress?: (url: string, index: number, total: number) => void): Promise<FetchedDoc[]>;
+/**
+ * Normalize llms.txt links to relative paths for local access
+ * Handles: absolute URLs, root-relative paths, and relative paths
+ */
+declare function normalizeLlmsLinks(content: string, baseUrl?: string): string;
+/**
+ * Extract sections from llms-full.txt by URL patterns
+ * Format: ---\nurl: /path.md\n---\n<content>\n\n---\nurl: ...
+ */
+declare function extractSections(content: string, patterns: string[]): string | null;
+//#endregion
+//#region src/sources/npm.d.ts
+/**
+ * Fetch package info from npm registry
+ */
+declare function fetchNpmPackage(packageName: string): Promise<NpmPackageInfo | null>;
+interface DistTagInfo {
+  version: string;
+  releasedAt?: string;
+}
+interface NpmRegistryMeta {
+  releasedAt?: string;
+  distTags?: Record<string, DistTagInfo>;
+}
+/**
+ * Fetch release date and dist-tags from npm registry
+ */
+declare function fetchNpmRegistryMeta(packageName: string, version: string): Promise<NpmRegistryMeta>;
+type ResolveStep = 'npm' | 'github-docs' | 'github-meta' | 'github-search' | 'readme' | 'llms.txt' | 'local';
+interface ResolveOptions {
+  /** User's installed version - used to fetch versioned git docs */
+  version?: string;
+  /** Current working directory - for local readme fallback */
+  cwd?: string;
+  /** Progress callback - called before each resolution step */
+  onProgress?: (step: ResolveStep) => void;
+}
+/**
+ * Resolve documentation URL for a package (legacy - returns null on failure)
+ */
+declare function resolvePackageDocs(packageName: string, options?: ResolveOptions): Promise<ResolvedPackage | null>;
+/**
+ * Resolve documentation URL for a package with attempt tracking
+ */
+declare function resolvePackageDocsWithAttempts(packageName: string, options?: ResolveOptions): Promise<ResolveResult>;
+/**
+ * Parse version specifier, handling protocols like link:, workspace:, npm:, file:
+ */
+declare function parseVersionSpecifier(name: string, version: string, cwd: string): LocalDependency | null;
+/**
+ * Read package.json dependencies with versions
+ */
+declare function readLocalDependencies(cwd: string): Promise<LocalDependency[]>;
+interface LocalPackageInfo {
+  name: string;
+  version: string;
+  description?: string;
+  repoUrl?: string;
+  localPath: string;
+}
+/**
+ * Read package info from a local path (for link: deps)
+ */
+declare function readLocalPackageInfo(localPath: string): LocalPackageInfo | null;
+/**
+ * Resolve docs for a local package (link: dependency)
+ */
+declare function resolveLocalPackageDocs(localPath: string): Promise<ResolvedPackage | null>;
+/**
+ * Download and extract npm package tarball to cache directory.
+ * Used when the package isn't available in node_modules.
+ *
+ * Extracts to: ~/.skilld/references/<pkg>@<version>/pkg/
+ * Returns the extracted directory path, or null on failure.
+ */
+declare function fetchPkgDist(name: string, version: string): Promise<string | null>;
+/**
+ * Fetch just the latest version string from npm (lightweight)
+ */
+declare function fetchLatestVersion(packageName: string): Promise<string | null>;
+/**
+ * Get installed skill version from SKILL.md
+ */
+declare function getInstalledSkillVersion(skillDir: string): string | null;
+//#endregion
+//#region src/sources/overrides.d.ts
+/**
+ * Hardcoded overrides for packages whose docs live in a different repo
+ * than what npm registry points to.
+ */
+interface DocOverride {
+  /** GitHub owner */
+  owner: string;
+  /** GitHub repo */
+  repo: string;
+  /** Path prefix to filter markdown files (e.g. 'src') */
+  path: string;
+  /** Branch or ref to use (default: 'main') */
+  ref?: string;
+  /** Homepage/docs URL */
+  homepage?: string;
+}
+/**
+ * Map of package name -> doc source override.
+ * Keyed by npm package name.
+ */
+declare const DOC_OVERRIDES: Record<string, DocOverride>;
+declare function getDocOverride(packageName: string): DocOverride | undefined;
+//#endregion
+//#region src/sources/releases.d.ts
+/**
+ * GitHub release notes fetching via gh CLI (preferred) with ungh.cc fallback
+ */
+interface GitHubRelease {
+  id: number;
+  tag: string;
+  name: string;
+  prerelease: boolean;
+  createdAt: string;
+  publishedAt: string;
+  markdown: string;
+}
+interface CachedDoc {
+  path: string;
+  content: string;
+}
+/**
+ * Select last 20 stable releases for a package, sorted newest first.
+ * For monorepos, filters to package-specific tags (pkg@version).
+ * Falls back to generic tags (v1.2.3) only if no package-specific found.
+ */
+/**
+ * Fetch release notes for a package. Returns CachedDoc[] with releases/{tag}.md files.
+ *
+ * Strategy:
+ * 1. Fetch GitHub releases, filter to package-specific tags for monorepos
+ * 2. If no releases found, try CHANGELOG.md as fallback
+ */
+declare function fetchReleaseNotes(owner: string, repo: string, installedVersion: string, gitRef?: string, packageName?: string): Promise<CachedDoc[]>;
+//#endregion
+//#region src/sources/utils.d.ts
+/**
+ * Shared utilities for doc resolution
+ */
+/**
+ * Fetch text content from URL
+ */
+declare function fetchText(url: string): Promise<string | null>;
+/**
+ * Verify URL exists and is not HTML (likely 404 page)
+ */
+declare function verifyUrl(url: string): Promise<boolean>;
+/**
+ * Check if URL is a GitHub repo URL (not a docs site)
+ */
+declare function isGitHubRepoUrl(url: string): boolean;
+/**
+ * Parse owner/repo from GitHub URL
+ */
+declare function parseGitHubUrl(url: string): {
+  owner: string;
+  repo: string;
+} | null;
+/**
+ * Normalize git repo URL to https
+ */
+declare function normalizeRepoUrl(url: string): string;
+//#endregion
+export { parseMarkdownLinks as A, fetchGitHubIssues as B, resolvePackageDocs as C, fetchLlmsTxt as D, extractSections as E, NpmPackageInfo as F, fetchGitHubRepoMeta as G, isGhAvailable as H, ResolveAttempt as I, EntryFile as J, fetchReadme as K, ResolveResult as L, LlmsContent as M, LlmsLink as N, fetchLlmsUrl as O, LocalDependency as P, formatDiscussionsAsMarkdown as Q, ResolvedPackage as R, resolveLocalPackageDocs as S, downloadLlmsDocs as T, GitDocsResult as U, formatIssuesAsMarkdown as V, fetchGitDocs as W, GitHubDiscussion as X, resolveEntryFiles as Y, fetchGitHubDiscussions as Z, fetchPkgDist as _, verifyUrl as a, readLocalDependencies as b, DOC_OVERRIDES as c, LocalPackageInfo as d, ResolveOptions as f, fetchNpmRegistryMeta as g, fetchNpmPackage as h, parseGitHubUrl as i, FetchedDoc as j, normalizeLlmsLinks as k, DocOverride as l, fetchLatestVersion as m, isGitHubRepoUrl as n, GitHubRelease as o, ResolveStep as p, fetchReadmeContent as q, normalizeRepoUrl as r, fetchReleaseNotes as s, fetchText as t, getDocOverride as u, getInstalledSkillVersion as v, resolvePackageDocsWithAttempts as w, readLocalPackageInfo as x, parseVersionSpecifier as y, GitHubIssue as z };
+//# sourceMappingURL=utils.d.mts.map

package/dist/_chunks/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../src/sources/discussions.ts","../../src/sources/entries.ts","../../src/sources/github.ts","../../src/sources/issues.ts","../../src/sources/types.ts","../../src/sources/llms.ts","../../src/sources/npm.ts","../../src/sources/overrides.ts","../../src/sources/releases.ts","../../src/sources/utils.ts"],"mappings":"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"}

package/dist/_chunks/version.d.mts

@@ -0,0 +1,147 @@
+//#region src/cache/config.d.ts
+/**
+ * Cache configuration
+ */
+/** Global cache directory */
+declare const CACHE_DIR: string;
+/** References subdirectory */
+declare const REFERENCES_DIR: string;
+/** @deprecated Use getPackageDbPath instead */
+declare const SEARCH_DB: string;
+/** Get search DB path for a specific package@version */
+declare function getPackageDbPath(name: string, version: string): string;
+//#endregion
+//#region src/cache/types.d.ts
+/**
+ * Cache types
+ */
+interface CacheConfig {
+  /** Package name */
+  name: string;
+  /** Package version (full semver) */
+  version: string;
+}
+interface CachedPackage {
+  name: string;
+  version: string;
+  dir: string;
+}
+interface CachedDoc {
+  path: string;
+  content: string;
+}
+//#endregion
+//#region src/cache/storage.d.ts
+/**
+ * Check if package is cached at given version
+ */
+declare function isCached(name: string, version: string): boolean;
+/**
+ * Ensure cache directories exist
+ */
+declare function ensureCacheDir(): void;
+/**
+ * Write docs to cache, cleaning stale version dirs for the same package
+ */
+declare function writeToCache(name: string, version: string, docs: CachedDoc[]): string;
+/**
+ * Create .skilld directory with symlinked docs (only if external fetch needed)
+ *
+ * Structure:
+ *   .claude/skills/<skill>/.skilld/
+ *     pkg -> node_modules/<pkg> (always, has package.json, README.md, dist/)
+ *     docs -> ~/.skilld/references/<pkg>@<version>/docs (only if fetched externally)
+ *
+ * The .skilld/ dirs are gitignored. After clone, `skilld install` recreates from lockfile.
+ */
+declare function linkReferences(skillDir: string, name: string, version: string): void;
+/**
+ * Create symlink from .skilld dir to cached github data (issues + discussions)
+ *
+ * Structure:
+ *   .claude/skills/<skill>/.skilld/github -> ~/.skilld/references/<pkg>@<version>/github
+ */
+declare function linkGithub(skillDir: string, name: string, version: string): void;
+/**
+ * Resolve the package directory: node_modules first, then cached dist fallback.
+ * Returns the path if found, null otherwise.
+ */
+declare function resolvePkgDir(name: string, cwd: string, version?: string): string | null;
+/**
+ * Create symlink from .skilld dir to package directory
+ *
+ * Structure:
+ *   .claude/skills/<skill>/.skilld/pkg -> node_modules/<pkg> OR ~/.skilld/references/<pkg>@<version>/pkg
+ *
+ * This gives access to package.json, README.md, dist/, and any shipped docs/
+ */
+declare function linkPkg(skillDir: string, name: string, cwd: string, version?: string): void;
+/**
+ * Get key files from a package directory for display
+ * Returns entry points + docs files
+ */
+declare function getPkgKeyFiles(name: string, cwd: string, version?: string): string[];
+/**
+ * Check if package ships its own docs folder
+ */
+interface ShippedSkill {
+  skillName: string;
+  skillDir: string;
+}
+/**
+ * Check if package ships a skills/ directory with _SKILL.md subdirs
+ */
+declare function getShippedSkills(name: string, cwd: string, version?: string): ShippedSkill[];
+/**
+ * Create symlink from .skilld dir to cached releases
+ *
+ * Structure:
+ *   .claude/skills/<skill>/.skilld/releases -> ~/.skilld/references/<pkg>@<version>/releases
+ */
+declare function linkReleases(skillDir: string, name: string, version: string): void;
+/**
+ * Create symlink from skills dir to shipped skill dir
+ */
+declare function linkShippedSkill(baseDir: string, skillName: string, targetDir: string): void;
+declare function hasShippedDocs(name: string, cwd: string, version?: string): boolean;
+/**
+ * List all cached packages
+ */
+declare function listCached(): CachedPackage[];
+/**
+ * Read cached docs for a package
+ */
+declare function readCachedDocs(name: string, version: string): CachedDoc[];
+/**
+ * Clear cache for a specific package
+ */
+declare function clearCache(name: string, version: string): boolean;
+/**
+ * Clear all cache
+ */
+declare function clearAllCache(): number;
+/**
+ * List files in .skilld directory (pkg + docs) as relative paths for prompt context
+ * Returns paths like ./.skilld/pkg/README.md, ./.skilld/docs/api.md
+ */
+declare function listReferenceFiles(skillDir: string, maxDepth?: number): string[];
+//#endregion
+//#region src/cache/version.d.ts
+/**
+ * Version utilities
+ */
+/**
+ * Get exact version key for cache keying
+ */
+declare function getVersionKey(version: string): string;
+/**
+ * Get cache key for a package: name@version
+ */
+declare function getCacheKey(name: string, version: string): string;
+/**
+ * Get path to cached package references
+ */
+declare function getCacheDir(name: string, version: string): string;
+//#endregion
+export { CachedDoc as C, SEARCH_DB as D, REFERENCES_DIR as E, getPackageDbPath as O, CacheConfig as S, CACHE_DIR as T, listCached as _, clearAllCache as a, resolvePkgDir as b, getPkgKeyFiles as c, isCached as d, linkGithub as f, linkShippedSkill as g, linkReleases as h, ShippedSkill as i, getShippedSkills as l, linkReferences as m, getCacheKey as n, clearCache as o, linkPkg as p, getVersionKey as r, ensureCacheDir as s, getCacheDir as t, hasShippedDocs as u, listReferenceFiles as v, CachedPackage as w, writeToCache as x, readCachedDocs as y };
+//# sourceMappingURL=version.d.mts.map

package/dist/_chunks/version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.mts","names":[],"sources":["../../src/cache/config.ts","../../src/cache/types.ts","../../src/cache/storage.ts","../../src/cache/version.ts"],"mappings":";;AASA;;;cAAa,SAAA;;cAGA,cAAA;;cAGA,SAAA;;iBAGG,gBAAA,CAAiB,IAAA,UAAc,OAAA;;;;AAT/C;;UCLiB,WAAA;EDKkC;ECHjD,IAAA;EDMW;ECJX,OAAA;AAAA;AAAA,UAGe,aAAA;EACf,IAAA;EACA,OAAA;EACA,GAAA;AAAA;AAAA,UAGe,SAAA;EACf,IAAA;EACA,OAAA;AAAA;;;;;ADPF;iBECgB,QAAA,CAAS,IAAA,UAAc,OAAA;;;;iBAOvB,cAAA,CAAA;;;;iBAOA,YAAA,CACd,IAAA,UACA,OAAA,UACA,IAAA,EAAM,SAAA;AFZR;;;;;;;;ACdA;;ADcA,iBEyEgB,cAAA,CAAe,QAAA,UAAkB,IAAA,UAAc,OAAA;;;ADhF/D;;;;iBCwGgB,UAAA,CAAW,QAAA,UAAkB,IAAA,UAAc,OAAA;;;;;iBAoB3C,aAAA,CAAc,IAAA,UAAc,GAAA,UAAa,OAAA;;;;;;;;AA1HzD;iBAiJgB,OAAA,CAAQ,QAAA,UAAkB,IAAA,UAAc,GAAA,UAAa,OAAA;;;;AA1IrE;iBA6JgB,cAAA,CAAe,IAAA,UAAc,GAAA,UAAa,OAAA;;;;UA8BzC,YAAA;EACf,SAAA;EACA,QAAA;AAAA;;;;iBAMc,gBAAA,CAAiB,IAAA,UAAc,GAAA,UAAa,OAAA,YAAmB,YAAA;;;AA5H/E;;;;iBAgJgB,YAAA,CAAa,QAAA,UAAkB,IAAA,UAAc,OAAA;;;;iBAmB7C,gBAAA,CAAiB,OAAA,UAAiB,SAAA,UAAmB,SAAA;AAAA,iBAWrD,cAAA,CAAe,IAAA,UAAc,GAAA,UAAa,OAAA;;;;iBAiB1C,UAAA,CAAA,GAAc,aAAA;;;;iBAed,cAAA,CAAe,IAAA,UAAc,OAAA,WAAkB,SAAA;AAlK/D;;;AAAA,iBAiMgB,UAAA,CAAW,IAAA,UAAc,OAAA;;;;iBAYzB,aAAA,CAAA;;AAtLhB;;;iBAkMgB,kBAAA,CAAmB,QAAA,UAAkB,QAAA;;;;AFvVrD;;;;;iBGCgB,aAAA,CAAc,OAAA;;;;iBAOd,WAAA,CAAY,IAAA,UAAc,OAAA;AHF1C;;;AAAA,iBGSgB,WAAA,CAAY,IAAA,UAAc,OAAA"}