scoutline 0.2.0 → 0.6.0

package/dist/commands/repository-explorer.js

@@ -0,0 +1,550 @@
+/**
+ * Provider-neutral Repository Explorer (P6-05, DESIGN.md §18, §11,
+ * PRD FR-081, FR-083–FR-086, FR-088, FR-091; NFR-004, NFR-005, NFR-007).
+ *
+ * The Explorer is the single non-Adapter consumer of the Repository
+ * Capability contract. It owns canonical repository-path handling,
+ * deterministic breadth-first traversal, duplicate-directory
+ * protection, and local Search/File `--max-chars` projection. It
+ * constructs canonical Capability requests, hands them to shared
+ * execution, and projects the normalized results.
+ *
+ * Boundary rules (ARCHITECTURE.md §2, NFR-004):
+ *   - Imports ONLY provider-neutral Repository Capability types and
+ *     shared `executeRepositoryOperation` / `ExecutionDependencies`,
+ *     plus the normalized `ValidationError`.
+ *   - Imports NO concrete Provider Adapter, MCP/UTCP client, raw tool
+ *     name, or Provider response type. Provider-specific facts (ZRead
+ *     grammar, credentials, transports) remain Adapter-internal.
+ *   - Owns canonicalization, BFS, and projection; never owns
+ *     transport, credentials, Provider selection, or command
+ *     presentation.
+ *
+ * Fixed ordering (DESIGN.md §18):
+ *   1. Apply Explorer-level defaults (Search `language`, Tree
+ *      `depth`) and canonicalize paths.
+ *   2. Validate `repository` (at-least-one-slash), `query`
+ *      (non-whitespace), `language`, and `depth`.
+ *   3. Construct the canonical Capability request.
+ *   4. Delegate to `executeRepositoryOperation`, which runs
+ *      `operation.validate`, `operation.cacheIdentity`, the
+ *      provider-partitioned cache read, ordered legacy candidates,
+ *      retry-wrapped invoke, and the normalized cache write.
+ *   5. Apply post-execution `--max-chars` projection (Search/File
+ *      only). Tree is never character-limited.
+ *
+ * `--max-chars` is post-execution projection. It never appears in
+ * the canonical request, the cache identity, or the cache itself.
+ */
+import { executeRepositoryOperation, } from "../lib/execution.js";
+import { ValidationError } from "../lib/errors.js";
+/**
+ * Canonicalize a repository-relative POSIX path.
+ *
+ * Rules (DESIGN.md §18, technical plan):
+ *   - Backslashes (`\\`) and ASCII control characters (C0 plus DEL,
+ *     code points 0–31 and 127) always throw `ValidationError`.
+ *   - Whole-string root aliases (`undefined`, `""`, `"/"`, `"."`)
+ *     map to root (`""`). For File (`kind: "file"`), root is
+ *     invalid and throws.
+ *   - File accepts a single leading `./` and any leading `/` as
+ *     convenience; both are stripped. Directory does NOT get the
+ *     leading `./` convenience (a leading `.` segment is unsafe and
+ *     is rejected below); leading `/` is naturally stripped by the
+ *     empty-segment collapse.
+ *   - Repeated `/` collapses and trailing `/` is removed via the
+ *     empty-segment skip.
+ *   - Actual `.` or `..` segments at any position throw.
+ *   - Percent escapes are never decoded.
+ *
+ * Returns the canonical repository-relative POSIX path. `""` is the
+ * repository root.
+ */
+export function canonicalizeRepositoryPath(input, kind) {
+    // 1. `undefined` is the canonical "omitted" value. For File this
+    //    is invalid because File requires a non-root path; for
+    //    Directory/Tree it is the root.
+    if (input === undefined) {
+        if (kind === "file") {
+            throw new ValidationError("File path is required");
+        }
+        return "";
+    }
+    if (typeof input !== "string") {
+        throw new ValidationError("Repository path must be a string");
+    }
+    // 2. Reject backslashes and ASCII control characters (C0 + DEL).
+    //    Percent escapes are never decoded, so `%2e` and similar are
+    //    preserved as literal three-character sequences.
+    for (let i = 0; i < input.length; i += 1) {
+        const code = input.charCodeAt(i);
+        if (code === 92 /* backslash */) {
+            throw new ValidationError("Repository path must not contain backslashes");
+        }
+        if (code < 32 || code === 127) {
+            throw new ValidationError("Repository path must not contain ASCII control characters");
+        }
+    }
+    // 3. Whole-string root aliases. `""`, `"/"`, and `"."` all map
+    //    to root. For File, root is invalid.
+    if (input === "" || input === "/" || input === ".") {
+        if (kind === "file") {
+            throw new ValidationError("File path must not be the repository root");
+        }
+        return "";
+    }
+    // 4. File-only leading `./` convenience. Directory does not get
+    //    this: a leading `.` segment is unsafe and is rejected below.
+    //    Leading `/` is naturally stripped by the empty-segment
+    //    collapse for both kinds.
+    let work = input;
+    if (kind === "file" && work.startsWith("./")) {
+        work = work.slice(2);
+    }
+    // 5. Split, collapse empty segments (handles leading/trailing/
+    //    repeated `/`), and reject any actual `.` or `..` segment.
+    const segments = [];
+    for (const segment of work.split("/")) {
+        if (segment === "")
+            continue;
+        if (segment === "." || segment === "..") {
+            throw new ValidationError(`Repository path must not contain a "${segment}" segment`);
+        }
+        segments.push(segment);
+    }
+    const canonical = segments.join("/");
+    if (canonical === "") {
+        // The input reduced to nothing (e.g., `"///"` or `"./"`). For
+        // File, this is root and invalid; for Directory/Tree, this is
+        // root.
+        if (kind === "file") {
+            throw new ValidationError("File path must not be the repository root");
+        }
+        return "";
+    }
+    return canonical;
+}
+// ---------------------------------------------------------------------------
+// Defaults and Explorer-level pre-validation.
+//
+// Defaults and canonicalization happen BEFORE
+// `operation.validate` / `operation.cacheIdentity`. The Explorer's
+// pre-validation is provider-neutral (slash in repository,
+// non-whitespace query, language in `{en, zh}`, finite positive
+// integer depth); the Adapter's `operation.validate` runs after,
+// as a defensive backstop with Provider-specific messaging.
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a Search language value. `undefined` defaults to `"en"`;
+ * `"en"` and `"zh"` are passed through; any other value throws
+ * `ValidationError`.
+ */
+function normalizeSearchLanguage(language) {
+    if (language === undefined)
+        return "en";
+    if (language === "en" || language === "zh")
+        return language;
+    throw new ValidationError('Search language must be "en" or "zh"');
+}
+/**
+ * Project a Tree depth value. `undefined` defaults to 1. Finite
+ * positive values are floored to an integer; non-finite or
+ * non-positive values throw `ValidationError`. Matches the
+ * existing shipped behaviour.
+ */
+function projectTreeDepth(depth) {
+    if (depth === undefined)
+        return 1;
+    const n = Number(depth);
+    if (!Number.isFinite(n) || n < 1) {
+        throw new ValidationError("Tree depth must be a finite positive integer");
+    }
+    return Math.floor(n);
+}
+/**
+ * Assert that `repository` is a string containing at least one `/`.
+ * The check is provider-neutral and preserves the existing
+ * at-least-one-slash rule. The exact repository text is preserved.
+ */
+function assertRepositoryString(repository) {
+    if (typeof repository !== "string") {
+        throw new ValidationError("Repository must be a string");
+    }
+    let hasSlash = false;
+    for (let i = 0; i < repository.length; i += 1) {
+        if (repository.charCodeAt(i) === 47 /* "/" */) {
+            hasSlash = true;
+            break;
+        }
+    }
+    if (!hasSlash) {
+        throw new ValidationError(`Invalid repository format: "${repository}". Use "owner/repo" format (e.g., "facebook/react")`);
+    }
+}
+/**
+ * Assert that `query` is a string containing at least one
+ * non-whitespace character. The exact query text is preserved.
+ */
+function assertSearchQuery(query) {
+    if (typeof query !== "string" || query.trim().length === 0) {
+        throw new ValidationError("Search query must contain at least one non-whitespace character");
+    }
+}
+// ---------------------------------------------------------------------------
+// Provider-derived listing validation (DESIGN.md §18).
+//
+// Every Provider-returned listing and child is validated BEFORE
+// snapshot/enqueue. The validator binds the listing to the exact
+// canonical request and requires every entry to be the immediate
+// child of the listing's path. Unsafe, inconsistent, or
+// non-immediate children fail the whole tree; partial success is
+// never returned. The validation is read-only and never mutates
+// the Adapter result.
+// ---------------------------------------------------------------------------
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Assert that `name` is a valid single path segment: a non-empty
+ * string with no `/`, no backslash, no ASCII control characters
+ * (C0 + DEL), and not equal to `.` or `..`. Percent escapes remain
+ * literal (`%2e` is three characters, not `.`).
+ *
+ * A directory entry name supplies exactly one path segment, so the
+ * segment-level rules are stricter than the full-path rules: a `/`
+ * in a name would split it into multiple segments and is therefore
+ * rejected here rather than collapsed.
+ */
+function assertValidEntryName(name) {
+    if (typeof name !== "string" || name.length === 0) {
+        throw new ValidationError("Provider-derived directory entry name must be a non-empty string");
+    }
+    for (let i = 0; i < name.length; i += 1) {
+        const code = name.charCodeAt(i);
+        if (code === 47 /* "/" */) {
+            throw new ValidationError("Provider-derived directory entry name must not contain '/'");
+        }
+        if (code === 92 /* backslash */) {
+            throw new ValidationError("Provider-derived directory entry name must not contain backslashes");
+        }
+        if (code < 32 || code === 127) {
+            throw new ValidationError("Provider-derived directory entry name must not contain ASCII control characters");
+        }
+    }
+    if (name === "." || name === "..") {
+        throw new ValidationError(`Provider-derived directory entry name must not be "${name}"`);
+    }
+}
+/**
+ * Assert that `entry` is a structurally valid
+ * {@link RepositoryEntry} that is the IMMEDIATE child of
+ * `listingPath` under the canonical request.
+ *
+ * The entry's `name` must be a valid single segment, and the
+ * entry's `path` must equal the immediate-child path constructed
+ * from `listingPath` and `name`:
+ *
+ *   expectedPath = listingPath === "" ? name : listingPath + "/" + name
+ *
+ * `entry.path` MUST equal `expectedPath` exactly. The expectedPath
+ * is then canonicalized through the shared canonicalizer under the
+ * entry's kind to reject any non-canonical residue. Because
+ * `listingPath` arrived canonical (either the Explorer-canonical
+ * starting path or a previously validated immediate-child path) and
+ * `entry.name` is a validated single segment, the canonical form
+ * should equal the expected form; this final canonicalize call is
+ * defensive against any future regression.
+ *
+ * DESIGN §18: `entry.name` is the final path segment and the
+ * DirectoryListing holds the requested directory's immediate
+ * entries.
+ */
+function assertValidRepositoryEntry(entry, listingPath) {
+    if (!isPlainObject(entry)) {
+        throw new ValidationError("Provider-derived directory entry must be an object");
+    }
+    assertValidEntryName(entry.name);
+    if (entry.kind !== "file" && entry.kind !== "directory") {
+        throw new ValidationError("Provider-derived directory entry kind must be 'file' or 'directory'");
+    }
+    if (typeof entry.path !== "string" || entry.path.length === 0) {
+        throw new ValidationError("Provider-derived directory entry path must be a non-empty string");
+    }
+    // Compute the expected immediate-child path. listingPath is
+    // already canonical; entry.name supplies one validated segment.
+    const expectedPath = listingPath === "" ? entry.name : `${listingPath}/${entry.name}`;
+    if (entry.path !== expectedPath) {
+        throw new ValidationError(`Provider-derived directory entry path "${entry.path}" must equal the immediate-child path "${expectedPath}"`);
+    }
+    // Canonical-safety: canonicalize the expectedPath under the
+    // entry's kind to reject any non-canonical residue. Files use the
+    // File canonicalizer (root invalid); directories use the
+    // Directory canonicalizer (root allowed). A root child is
+    // structurally impossible for a non-root listing but is defended
+    // against here all the same.
+    const canonical = canonicalizeRepositoryPath(expectedPath, entry.kind);
+    if (canonical !== expectedPath) {
+        throw new ValidationError(`Provider-derived directory entry path is not canonical: "${expectedPath}"`);
+    }
+}
+/**
+ * Assert that `listing` is a structurally valid
+ * {@link RepositoryDirectoryListing} BOUND to the canonical
+ * {@link RepositoryDirectoryRequest}. The listing's `repository`
+ * MUST equal `request.repository` and the listing's `path` MUST
+ * equal `request.path`. Every entry MUST be a valid immediate
+ * child of the listing's path.
+ *
+ * Without this binding a fake or buggy Adapter could return a
+ * listing for a different repository or a different directory than
+ * the one requested, and the BFS would snapshot or enqueue the
+ * wrong subtree. Binding the listing to the request closes that
+ * gap.
+ */
+function assertValidRepositoryDirectoryListing(listing, request) {
+    if (!isPlainObject(listing)) {
+        throw new ValidationError("Provider-derived directory listing must be an object");
+    }
+    if (typeof listing.repository !== "string") {
+        throw new ValidationError("Provider-derived directory listing repository must be a string");
+    }
+    if (listing.repository !== request.repository) {
+        throw new ValidationError("Provider-derived directory listing repository must match the request repository");
+    }
+    if (typeof listing.path !== "string") {
+        throw new ValidationError("Provider-derived directory listing path must be a string");
+    }
+    if (listing.path !== request.path) {
+        throw new ValidationError("Provider-derived directory listing path must match the request path");
+    }
+    if (!Array.isArray(listing.entries)) {
+        throw new ValidationError("Provider-derived directory listing entries must be an array");
+    }
+    for (const entry of listing.entries) {
+        assertValidRepositoryEntry(entry, listing.path);
+    }
+}
+// ---------------------------------------------------------------------------
+// Local `--max-chars` projection (DESIGN.md §18, technical plan).
+//
+// Projection is post-execution: it runs on the normalized result
+// returned by shared execution. It is the only step that consumes
+// `--max-chars`. `--max-chars` never enters the canonical request,
+// the cache identity, or the cache itself. Tree is never
+// character-limited.
+// ---------------------------------------------------------------------------
+/**
+ * Apply the Search `--max-chars` budget. The budget is a single
+ * total character count consumed by `excerpts[].text` in Provider
+ * order. Absent, `NaN`, zero, or negative means no truncation
+ * (matches the shipped `!max || max <= 0` rule). `Infinity` is
+ * naturally unlimited (the loop fits every excerpt). Whole
+ * excerpts are kept while they fit; the final retained excerpt is
+ * truncated with the existing rule
+ * `text.slice(0, remaining - 1).trimEnd() + "…"`; later excerpts
+ * are omitted. Metadata (`repository`, `query`, `language`,
+ * `originalTextLength`) is outside the budget. `originalTextLength`
+ * reports the full pre-projection value; `truncated` is set if the
+ * projection omitted or truncated any excerpt, OR if the Provider
+ * flagged its own truncation.
+ *
+ * The input result is never mutated.
+ */
+function projectSearchResult(result, maxChars) {
+    if (!maxChars || maxChars <= 0) {
+        return result;
+    }
+    let remaining = maxChars;
+    const projectedExcerpts = [];
+    let projectionTruncated = false;
+    for (const excerpt of result.excerpts) {
+        if (remaining <= 0) {
+            projectionTruncated = true;
+            break;
+        }
+        if (excerpt.text.length <= remaining) {
+            projectedExcerpts.push({ text: excerpt.text });
+            remaining -= excerpt.text.length;
+        }
+        else {
+            const truncatedText = excerpt.text.slice(0, remaining - 1).trimEnd() + "…";
+            projectedExcerpts.push({ text: truncatedText });
+            remaining = 0;
+            projectionTruncated = true;
+        }
+    }
+    if (!projectionTruncated) {
+        return result;
+    }
+    return {
+        schemaVersion: 1,
+        repository: result.repository,
+        query: result.query,
+        language: result.language,
+        excerpts: projectedExcerpts,
+        truncated: true,
+        originalTextLength: result.originalTextLength,
+    };
+}
+/**
+ * Apply the File `--max-chars` budget to `content`. Absent, `NaN`,
+ * zero, or negative means no truncation (matches the shipped
+ * `!max || max <= 0` rule). `Infinity` is naturally unlimited.
+ * Content shorter than or equal to the budget is returned
+ * unchanged. Otherwise the content is truncated with the existing
+ * rule `content.slice(0, max - 1).trimEnd() + "…"`. `truncated` is
+ * set if the projection truncated the content or if the Provider
+ * flagged its own truncation. `originalContentLength` reports the
+ * full pre-projection value.
+ *
+ * The input result is never mutated.
+ */
+function projectFileResult(result, maxChars) {
+    if (!maxChars || maxChars <= 0) {
+        return result;
+    }
+    if (result.content.length <= maxChars) {
+        return result;
+    }
+    const truncatedContent = result.content.slice(0, maxChars - 1).trimEnd() + "…";
+    return {
+        schemaVersion: 1,
+        repository: result.repository,
+        path: result.path,
+        content: truncatedContent,
+        truncated: true,
+        originalContentLength: result.originalContentLength,
+    };
+}
+// ---------------------------------------------------------------------------
+// Breadth-first traversal (DESIGN.md §18).
+//
+// Deterministic BFS that preserves Provider sibling order,
+// snapshots breadth-first, requests each canonical directory at
+// most once, expands only directories while `level < depth`, and
+// never returns partial success after a directory failure.
+// ---------------------------------------------------------------------------
+/**
+ * Collect directory snapshots via deterministic breadth-first
+ * traversal.
+ *
+ * Rules:
+ *   - BFS starts at level 1 with the canonical starting path. The
+ *     starting directory is requested exactly once and snapshotted
+ *     even at depth 1.
+ *   - Children are snapshot/enqueued in Provider sibling order.
+ *     Only `kind: "directory"` children are enqueued, and only
+ *     while `level < depth`.
+ *   - Each canonical directory path is requested at most once.
+ *     Duplicate encounters (a directory reachable from multiple
+ *     parents) preserve first-encounter order and are not
+ *     re-requested.
+ *   - Every Provider-derived listing and entry is validated before
+ *     snapshot/enqueue. Unsafe or inconsistent children fail the
+ *     whole tree; partial success is never returned.
+ *
+ * `executeRepositoryOperation` is the single transport-touching
+ * call per directory; it owns validate/cache-identity/cache/retry.
+ * The Explorer never invokes the Adapter directly.
+ */
+async function collectTreeSnapshots(capability, canonicalRequest, depth, options, dependencies) {
+    const snapshots = [];
+    const visited = new Set();
+    // Queue entries: { request, level }. The starting path is
+    // enqueued at level 1. The visited set is populated at enqueue
+    // time so a directory reachable from multiple parents is
+    // requested exactly once and appears in first-encounter order.
+    const queue = [
+        { request: canonicalRequest, level: 1 },
+    ];
+    visited.add(canonicalRequest.path);
+    while (queue.length > 0) {
+        const { request, level } = queue.shift();
+        const listing = await executeRepositoryOperation(capability.listDirectory, request, options, dependencies);
+        // Validate the Adapter result before snapshot/enqueue. Bind the
+        // listing to the canonical request so a fake or buggy Adapter
+        // cannot snapshot or enqueue a different repository, a different
+        // directory, or non-immediate children.
+        assertValidRepositoryDirectoryListing(listing, request);
+        snapshots.push(listing);
+        if (level >= depth)
+            continue;
+        for (const entry of listing.entries) {
+            if (entry.kind !== "directory")
+                continue;
+            if (visited.has(entry.path))
+                continue;
+            visited.add(entry.path);
+            queue.push({
+                request: { repository: request.repository, path: entry.path },
+                level: level + 1,
+            });
+        }
+    }
+    return snapshots;
+}
+/**
+ * Provider-neutral Repository Search (DESIGN.md §18, PRD FR-081,
+ * FR-083). Applies the `language` default, validates `repository`
+ * (at-least-one-slash) and `query` (non-whitespace), constructs the
+ * canonical request, delegates to shared execution, and applies the
+ * `--max-chars` budget to `excerpts[].text` only.
+ *
+ * Defaults and canonicalization precede `operation.validate` /
+ * `operation.cacheIdentity`. The Provider sees the canonical
+ * request; the Explorer never widens into Provider-specific fields.
+ */
+export async function explorerSearch(capability, request, options, dependencies) {
+    assertRepositoryString(request.repository);
+    assertSearchQuery(request.query);
+    const language = normalizeSearchLanguage(request.language);
+    const canonicalRequest = {
+        repository: request.repository,
+        query: request.query,
+        language,
+    };
+    const result = await executeRepositoryOperation(capability.search, canonicalRequest, { noCache: options.noCache, retryPolicy: options.retryPolicy }, dependencies);
+    return projectSearchResult(result, options.maxChars);
+}
+/**
+ * Provider-neutral Repository File read (DESIGN.md §18, PRD FR-086).
+ * Canonicalizes the File path (root rejected, leading `./` and `/`
+ * stripped, unsafe segments throw), delegates to shared execution,
+ * and applies the `--max-chars` budget to `content` only.
+ */
+export async function explorerReadFile(capability, request, options, dependencies) {
+    assertRepositoryString(request.repository);
+    const canonicalPath = canonicalizeRepositoryPath(request.path, "file");
+    const canonicalRequest = {
+        repository: request.repository,
+        path: canonicalPath,
+    };
+    const result = await executeRepositoryOperation(capability.readFile, canonicalRequest, { noCache: options.noCache, retryPolicy: options.retryPolicy }, dependencies);
+    return projectFileResult(result, options.maxChars);
+}
+/**
+ * Provider-neutral Repository Tree (DESIGN.md §18, PRD FR-088).
+ * Canonicalizes the starting path (root allowed), projects depth
+ * (default 1, finite positive integer), and drives a deterministic
+ * breadth-first traversal that preserves Provider sibling order,
+ * requests each canonical directory at most once, and never returns
+ * partial success. Tree is never character-limited.
+ */
+export async function explorerTree(capability, request, options, dependencies) {
+    assertRepositoryString(request.repository);
+    const canonicalPath = canonicalizeRepositoryPath(request.path, "directory");
+    const depth = projectTreeDepth(request.depth);
+    const canonicalRequest = {
+        repository: request.repository,
+        path: canonicalPath,
+    };
+    const snapshots = await collectTreeSnapshots(capability, canonicalRequest, depth, { noCache: options.noCache, retryPolicy: options.retryPolicy }, dependencies);
+    return {
+        schemaVersion: 1,
+        repository: request.repository,
+        path: canonicalPath,
+        depth,
+        snapshots,
+    };
+}
+//# sourceMappingURL=repository-explorer.js.map

package/dist/commands/repository-explorer.js.map

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

package/dist/index.d.ts

@@ -41,6 +41,26 @@ export interface MainDependencies {
     readonly searchCache?: ResponseCache;
     readonly searchSleep?: (ms: number) => Promise<void>;
     readonly searchRandom?: () => number;
+    /**
+     * Injectable shared-Repository execution dependencies (P6-07).
+     * Production defaults to the same on-disk cache and real sleep/random
+     * as Search; tests inject in-memory doubles so Repository dispatch
+     * tests stay isolated from Search state. These are NOT a rename of
+     * the Search seams.
+     */
+    readonly repositoryCache?: ResponseCache;
+    readonly repositorySleep?: (ms: number) => Promise<void>;
+    readonly repositoryRandom?: () => number;
+    /**
+     * Injectable shared-Reader execution dependencies (Reader Migration
+     * Ticket 04). Production defaults to the same on-disk cache and real
+     * sleep/random as Search/Repository; tests inject in-memory doubles
+     * so Reader dispatch tests stay isolated from Search/Repository
+     * state. NOT a rename of either prior seam.
+     */
+    readonly readerCache?: ResponseCache;
+    readonly readerSleep?: (ms: number) => Promise<void>;
+    readonly readerRandom?: () => number;
 }
 export declare function main(args: readonly string[], dependencies: MainDependencies): Promise<number>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI1E,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,sBAAsB,CAAC;AA8X3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAuBtE;AA6cD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC;AAID,wBAAsB,IAAI,CACxB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAuGjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmCH,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI1E,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,sBAAsB,CAAC;AA8Z3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAuBtE;AAuoBD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC;AAID,wBAAsB,IAAI,CACxB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAAC,MAAM,CAAC,CA4HjB"}