browser-git-ops 0.0.4 → 0.0.7

package/dist/git/githubAdapter.d.ts

@@ -1,14 +1,14 @@
 import { GitAdapter } from './adapter.ts';
 import AbstractGitAdapter, { fetchWithRetry, classifyStatus, getDelayForResponse, processResponseWithDelay, mapWithConcurrency, shaOf } from './abstractAdapter.ts';
-type GHOptions = {
+export type GHOptions = {
     owner: string;
     repo: string;
     token: string;
     host?: string;
 };
 /**
- * 指定ミリ秒だけ sleep するユーティリティ
- * @param ms ミリ秒
+ * GitHub 向けの `GitAdapter` 実装。
+ * GitHub API をラップしてリポジトリ操作（コミット作成、ブランチ一覧、ファイル取得等）を提供します。
  */
 export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdapter {
     private _fetchWithRetry;
@@ -16,12 +16,15 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     private blobCache;
     /**
      * GitHubAdapter を初期化します。
-     * @param {GHOptions} opts 設定オブジェクト
+     * @param {GHOptions} options 設定オブジェクト
      */
     constructor(options: GHOptions);
     /**
      * List commits for a ref (GitHub commits API)
-     * @param {{ref:string,perPage?:number,page?:number}} query
+     * @param {Object} query query parameters
+     * @param {string} query.ref reference name (branch/tag/SHA)
+     * @param {number} [query.perPage] items per page
+     * @param {number} [query.page] page number
      * @returns {Promise<import('./adapter').CommitHistoryPage>} ページ情報を返します
      */
     listCommits(query: {
@@ -57,11 +60,6 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {import('./adapter').CommitSummary}
      */
     private _mapGithubCommitToSummary;
-    /**
-     * コンテンツから sha1 を算出します。
-     * @param {string} content コンテンツ
-     * @returns {string} sha1 ハッシュ
-     */
     /**
      * ブロブを作成またはキャッシュから取得します。
      * @param {any[]} changes 変更一覧（create/update を含む）
@@ -69,11 +67,6 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<Record<string,string>>} パス→blobSha のマップ
      */
     createBlobs(changes: any[], concurrency?: number): Promise<Record<string, string>>;
-    /**
-     * ブロブ作成用のヘルパー（createBlobs から抽出）
-     * @param {any} ch 変更エントリ
-      * @returns {Promise<{path:string,sha:string}>}
-     */
     /**
      * Create a blob for a change or return cached blobSha.
      * @param {any} ch change entry
@@ -108,7 +101,8 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     private _makeRepoMetadata;
     /**
      * List branches via GitHub API and map to BranchListPage.
-      * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
+     * @param {import('../virtualfs/types.ts').BranchListQuery} [query] query parameters
+     * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
      */
     listBranches(query?: import('../virtualfs/types.ts').BranchListQuery): Promise<{
         items: {
@@ -132,15 +126,15 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     private _mapBranchItems;
     /**
      * 参照を更新します。
-     * @param {string} ref 参照名（例: heads/main）
+     * @param {string} reference 参照名（例: heads/main）
      * @param {string} commitSha コミット SHA
      * @param {boolean} force 強制更新フラグ
      */
     updateRef(reference: string, commitSha: string, force?: boolean): Promise<void>;
     /**
      * Create a branch (ref) on the remote repository.
-     * @param branchName branch name to create
-     * @param fromSha commit sha to point the new branch at
+     * @param {string} branchName branch name to create
+     * @param {string} fromSha commit sha to point the new branch at
      * @returns {Promise<import('../virtualfs/types.ts').CreateBranchResult>} created branch info
      */
     createBranch(branchName: string, fromSha: string): Promise<import('../virtualfs/types.ts').CreateBranchResult>;
@@ -159,14 +153,10 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     getCommitTreeSha(commitSha: string): Promise<string>;
     /**
      * 指定 ref の先頭コミット SHA を取得します。
-     * @param ref 例: `heads/main`
-      * @returns {Promise<string>} 参照先のコミット SHA
+     * @param {string} reference 䉶: `heads/main`
+     * @returns {Promise<string>} 参照先のコミット SHA
      */
     getRef(reference: string): Promise<string>;
-    /**
-     * Helper to fetch a ref URL and extract a SHA if present.
-     * Returns null when SHA not found.
-     */
     /**
      * Fetch a ref URL and extract a SHA if present.
      * @param {string} url API URL to fetch
@@ -207,18 +197,6 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
         content: any;
         encoding: any;
     }>;
-    /**
-     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
-     * Throws if resolution fails.
-     */
-    /**
-     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
-     * Throws if resolution fails.
-     * @param {string} reference commit-ish to resolve
-     * @returns {Promise<string>} resolved commit SHA
-     */
     /**
      * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
      * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
@@ -234,44 +212,24 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<string|null>} resolved sha or null
      */
     private _runResolvers;
-    /**
-     * Try to resolve reference as a branch and return its sha.
-     * @param {string} reference branch name
-     * @returns {Promise<string|null>} resolved sha or null
-     */
     /**
      * Try to resolve a branch name to a commit SHA.
      * @param {string} reference branch name
      * @returns {Promise<string|null>}
      */
     private _tryResolveByBranch;
-    /**
-     * Try to resolve reference as a tag and return its sha.
-     * @param {string} reference tag name
-     * @returns {Promise<string|null>} resolved sha or null
-     */
     /**
      * Try to resolve a tag name to a commit SHA.
      * @param {string} reference tag name
      * @returns {Promise<string|null>}
      */
     private _tryResolveByTag;
-    /**
-     * Try to resolve reference using commits endpoint (could be SHA or other form).
-     * @param {string} reference commit-ish
-     * @returns {Promise<string|null>} resolved sha or null
-     */
     /**
      * Try to resolve via commits endpoint (may accept SHA or other forms).
      * @param {string} reference commit-ish
      * @returns {Promise<string|null>}
      */
     private _tryResolveByCommitEndpoint;
-    /**
-     * Blob を取得して content を返す。取得失敗時は content=null を返す。
-     * @param {{sha:string,path:string}} f blob 情報
-     * @returns {Promise<{path:string,content:string|null}>}
-     */
     /**
      * Fetch a blob's content; return null content on failure.
      * @param {any} f blob metadata
@@ -281,19 +239,10 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     /**
      * Decode a base64 string into UTF-8 text. Uses global Buffer when available,
      * falls back to atob/TextDecoder for browsers.
+     * @param {string} safe base64 string to decode
      * @returns {string} decoded UTF-8 string
      */
     private _decodeBase64ToString;
-    /**
-     * Fetch a blob's content; return null content on failure.
-     * @param {any} f blob metadata
-     * @returns {Promise<{path:string,content:string|null}>}
-     */
-    /**
-     * リポジトリのスナップショットを取得します。
-     * @param {string} branch ブランチ名 (default: 'main')
-      * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:Function,snapshot:Record<string,string>}>}
-     */
     /**
      * Fetch repository snapshot: headSha, shas map and a fetchContent helper.
      * @param {string} branch branch name
@@ -337,22 +286,6 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<null>}
      */
     private _mapperForFetch;
-    /**
-     * 指定パスのコンテンツを取得し、キャッシュと snapshot を更新します。
-     * @param {Map<string, any>} fileMap ファイルメタ情報マップ
-     * @param {Map<string, string>} contentCache キャッシュマップ
-     * @param {Record<string,string>} snapshot スナップショット出力マップ
-     * @param {string} p 取得対象パス
-     * @returns {Promise<string|null>} ファイル内容または null
-     */
-    /**
-     * Fetch single path content, update cache and snapshot.
-     * @param {Map<string, any>} fileMap file map
-     * @param {Map<string,string>} contentCache cache map
-     * @param {Record<string,string>} snapshot snapshot map
-     * @param {string} p path to fetch
-     * @returns {Promise<string|null>} content or null
-     */
     /**
      * Fetch single path content, update cache and snapshot.
      * @param {Map<string, any>} fileMap file map

package/dist/git/githubAdapter.d.ts.map

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

package/dist/git/gitlabAdapter.d.ts

@@ -1,6 +1,6 @@
 import { GitAdapter } from './adapter.ts';
 import AbstractGitAdapter from './abstractAdapter.ts';
-type GLOptions = {
+export type GLOptions = {
     projectId: string;
     token: string;
     host?: string;
@@ -15,12 +15,15 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private projectMetadata;
     /**
      * GitLabAdapter を初期化します。
-     * @param {GLOpts} opts 設定オブジェクト
+     * @param {GLOptions} options 設定オブジェクト
      */
     constructor(options: GLOptions);
     /**
      * List commits for a ref (GitLab commits API)
-     * @param {{ref:string,perPage?:number,page?:number}} query
+     * @param {Object} query query parameters
+     * @param {string} query.ref reference name
+     * @param {number} [query.perPage] items per page
+     * @param {number} [query.page] page number
      * @returns {Promise<import('./adapter').CommitHistoryPage>} ページ情報を返します
      */
     listCommits(query: {
@@ -46,7 +49,8 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _parseJsonArray;
     /**
      * GitLab のページングヘッダを解析します（x-next-page / x-total-pages）。
-      * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
+     * @param {Response} resp HTTP レスポンス
+     * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
      */
     private _parsePagingHeaders;
     /**
@@ -55,11 +59,6 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {import('./adapter').CommitSummary}
      */
     private _mapGitLabCommitToSummary;
-    /**
-     * コンテンツから sha1 を算出します。
-     * @param {string} content コンテンツ
-     * @returns {string} sha1 ハッシュ
-     */
     /**
      * 変更一覧から blob sha のマップを作成します（疑似実装）。
      * @param {any[]} changes 変更一覧
@@ -83,9 +82,9 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     createCommit(message: string, parentSha: string, _treeSha: string): Promise<any>;
     /**
      * リファレンス更新は不要なため noop 実装です。
-     * @param {string} _ref ref 名
+     * @param {string} _reference ref 名
      * @param {string} _commitSha コミット SHA
-     * @param {boolean} [_force]
+     * @param {boolean} [_force] 強制フラグ
      * @returns {Promise<void>}
      */
     updateRef(_reference: string, _commitSha: string, _force?: boolean): Promise<void>;
@@ -93,7 +92,8 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * actions を用いて GitLab のコミット API を呼び出します。
      * @param {string} branch ブランチ名
      * @param {string} message コミットメッセージ
-     * @param {{type:string,path:string,content?:string}[]} changes 変更一覧
+     * @param {Array<{type:string,path:string,content?:string}>} changes 変更一覧
+     * @param {string} [expectedParentSha] 下発コミット SHA
      * @returns {Promise<any>} コミット応答（id など）
      */
     createCommitWithActions(branch: string, message: string, changes: Array<{
@@ -101,9 +101,6 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
         path: string;
         content?: string;
     }>, expectedParentSha?: string): Promise<any>;
-    /**
-     * Retrieve project metadata (default branch, name, id) and cache it.
-     */
     /**
      * Retrieve project metadata (default branch, name, id) and cache it.
      * @returns {Promise<import('../virtualfs/types.ts').RepositoryMetadata>} repository metadata
@@ -117,6 +114,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _makeProjectMetadata;
     /**
      * List branches via GitLab API and map to BranchListPage.
+     * @param {import('../virtualfs/types.ts').BranchListQuery} [query] query parameters
      * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
      */
     listBranches(query?: import('../virtualfs/types.ts').BranchListQuery): Promise<{
@@ -134,11 +132,12 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     }>;
     /**
      * Create a branch in GitLab: POST /projects/{projectId}/repository/branches
-     * @param branchName name of branch to create
-     * @param fromSha branch/tag name or SHA to base the new branch on
+     * @param {string} branchName name of branch to create
+     * @param {string} fromSha branch/tag name or SHA to base the new branch on
      * @returns {Promise<import('../virtualfs/types.ts').CreateBranchResult>} created branch info
      */
     createBranch(branchName: string, fromSha: string): Promise<import('../virtualfs/types.ts').CreateBranchResult>;
+    private _extractShaFromCommitResponseText;
     /**
      * Normalize common createBranch error messages into thrown Errors.
      * @param {string} message error message text
@@ -155,14 +154,10 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _mapBranchItems;
     /**
      * Convert change descriptors to GitLab API actions
-      * @returns {Array<any>} API-compatible actions array
+     * @param {Array<{type:string,path:string,content?:string}>} changes change descriptors
+     * @returns {Array<any>} API-compatible actions array
      */
     private createActions;
-    /**
-     * Verify remote branch head matches expected parent SHA.
-     * @throws Error if non-fast-forward
-      * @returns {Promise<void>}
-     */
     /**
      * Verify that remote branch head matches expected parent SHA.
      * Throws when non-fast-forward detected.
@@ -177,10 +172,6 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {any} parsed commit id/object
      */
     private parseCommitResponse;
-    /**
-     * Post commit request and parse response
-      * @returns {Promise<any>}
-      */
     /**
      * Post commit request and return parsed commit response.
      * @param {string} url endpoint URL
@@ -188,50 +179,20 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<any>} parsed commit response
      */
     private postCommit;
-    /**
-     * fetch をリトライ付きで実行します。
-     * @param {string} url リクエスト URL
-     * @param {RequestInit} opts fetch オプション
-     * @param {number} [retries] 最大リトライ回数
-     * @returns {Promise<Response>} レスポンス
-     */
-    /**
-     * Wait helper for fetch retry backoff.
-     * @param attempt Attempt number
-     * @returns {Promise<void>} resolves after backoff
-     */
     /**
      * Wait helper for retry backoff.
      * @param {number} attempt attempt number
      * @returns {Promise<void>}
      */
     private _waitAttempt;
-    /**
-     * ステータスが再試行対象か判定します。
-     * @param {number} status ステータスコード
-     * @returns {boolean}
-     */
-    /**
-     * バックオフ時間を計算します。
-     * @param {number} attempt 試行回数（1..）
-     * @returns {number} ミリ秒
-     */
-    /**
-     * 並列マッピングユーティリティ
-     * @template T, R
-     * @param {T[]} items 入力配列
-     * @param {(t:T)=>Promise<R>} mapper マッピング関数
-     * @param {number} concurrency 同時実行数
-     * @returns {Promise<R[]>}
-     */
     /**
      * Prepare JSON body for commit API call.
+     * @param {string} branch branch name
+     * @param {string} message commit message
+     * @param {any[]} actions commit actions
      * @returns {string} JSON body
      */
     private _prepareCommitBody;
-    /**
-     * Optionally verify parent SHA; swallow non-422 errors.
-     */
     /**
      * Optionally verify parent SHA; rethrow errors after logging.
      * @param {string} expectedParentSha expected SHA
@@ -242,35 +203,23 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     /**
      * リポジトリのスナップショットを取得します。
      * @param {string} branch ブランチ名 (default: 'main')
-    * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:(paths:string[])=>Promise<Record<string,string>>}>}
+     * @param {number} concurrency fetch concurrency level
+     * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:(paths:string[])=>Promise<Record<string,string>>}>}
      */
     fetchSnapshot(branch?: string, concurrency?: number): Promise<any>;
-    /**
-     * Determine the remote head SHA for a branch. Falls back to branch name on error.
-     * @param {string} branch Branch name
-     * @returns {Promise<string>} head SHA or branch
-     */
     /**
      * Determine the head SHA for a branch; fallback to branch name if unavailable.
      * @param {string} branch branch name
      * @returns {Promise<string>} head SHA or branch
      */
     private _determineHeadSha;
-    /**
-     * Fetch repository tree and build shas/fileSet.
-     * @param {string} branch Branch name
-     * @returns {Promise<{shas:Record<string,string>,fileSet:Set<string>}>}
-     */
+    private _safeGetBranchHead;
     /**
      * Fetch repository tree and build shas map and fileSet.
      * @param {string} branch branch name
      * @returns {Promise<{shas:Record<string,string>,fileSet:Set<string>}>}
      */
     private _fetchTreeAndBuildShas;
-    /**
-     * Helper to fetch files from the repository tree with caching and concurrency.
-      * @returns {Promise<Record<string,string>>}
-     */
     /**
      * Fetch contents for requested paths from a FileSet with caching.
      * @param {Set<string>} fileSet set of available files
@@ -282,14 +231,6 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<Record<string,string>>}
      */
     private _fetchContentFromFileSet;
-    /**
-     * 指定パスのファイル内容を取得し、キャッシュと snapshot を更新します。
-     * @param {Map<string,string>} cache キャッシュマップ
-     * @param {Record<string,string>} snapshot スナップショットマップ
-     * @param {string} p ファイルパス
-     * @param {string} branch ブランチ名
-     * @returns {Promise<string|null>} ファイル内容または null
-     */
     /**
      * Fetch the content for a single file path, updating cache and snapshot.
      * @param {Map<string,string>} cache cache map
@@ -299,12 +240,6 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<string|null>} file content or null
      */
     private _fetchFileContentForPath;
-    /**
-     * ファイルの raw コンテンツを取得して返します。失敗時は null を返します。
-     * @param {string} path ファイルパス
-     * @param {string} branch ブランチ名
-      * @returns {Promise<string|null>} ファイル内容または null
-     */
     /**
      * Fetch raw file content from GitLab; return null on failure.
      * @param {string} path file path
@@ -312,24 +247,12 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<string|null>} file content or null
      */
     private _fetchFileRaw;
-    /** Build shas map and fileSet from tree entries */
     /**
      * Build shas map and fileSet from tree entries
+     * @param {any[]} files tree file entries
      * @returns {{shas:Record<string,string>,fileSet:Set<string>}}
      */
     private _buildShasAndFileSet;
-    /**
-     * Resolve a commit-ish (branch name, tag name, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
-     * Throws if not resolvable.
-     */
-    /**
-     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
-     * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
-     * Throws if not resolvable.
-     * @param {string} reference commit-ish to resolve
-     * @returns {Promise<string>} resolved commit SHA
-     */
     /**
      * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
      * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
@@ -345,6 +268,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<string|null>} resolved sha or null
      */
     private _runResolvers;
+    private _tryRunResolver;
     /**
      * Try to resolve a branch name to its commit SHA.
      * @param {string} reference branch name

package/dist/git/gitlabAdapter.d.ts.map

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

package/dist/index.d.ts

@@ -5,4 +5,11 @@ export { default as InMemoryStorage } from './virtualfs/inmemoryStorage.ts';
 export { default as GitHubAdapter } from './git/githubAdapter.ts';
 export { default as GitLabAdapter } from './git/gitlabAdapter.ts';
 export { default } from './virtualfs/virtualfs.ts';
+export type { IndexFile, AdapterMeta, CommitInput, BranchListQuery, BranchListPage, RepositoryMetadata, CreateBranchInput, CreateBranchResult, IndexEntry, BranchInfo, Change as VfsChange, FileState } from './virtualfs/types.ts';
+export type { StorageBackend, StorageBackendConstructor, Segment } from './virtualfs/storageBackend.ts';
+export type { Logger } from './git/abstractAdapter.ts';
+export type { CommitHistoryQuery, CommitHistoryPage, CommitSummary, CommitResult, GitAdapter, Change as GitChange } from './git/adapter.ts';
+export type { GHOptions } from './git/githubAdapter.ts';
+export type { GLOptions } from './git/gitlabAdapter.ts';
+export type { RemoteSnapshotDescriptor } from './virtualfs/virtualfs.ts';
 //# 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,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAGlD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACnO,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AACvG,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3I,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA"}