@iconify/tools 4.0.0-beta.9 → 4.0.0

package/lib/download/api/download.d.mts

@@ -0,0 +1,8 @@
+import { APIQueryParams } from './types.mjs';
+
+/**
+ * Download file
+ */
+declare function downloadFile(query: APIQueryParams, target: string): Promise<void>;
+
+export { downloadFile };

package/lib/download/api/index.d.cts

@@ -0,0 +1,8 @@
+import { APIQueryParams, APICacheOptions } from './types.cjs';
+
+/**
+ * Send API query
+ */
+declare function sendAPIQuery(query: APIQueryParams, cache?: APICacheOptions): Promise<number | string>;
+
+export { sendAPIQuery };

package/lib/download/api/index.d.mts

@@ -0,0 +1,8 @@
+import { APIQueryParams, APICacheOptions } from './types.mjs';
+
+/**
+ * Send API query
+ */
+declare function sendAPIQuery(query: APIQueryParams, cache?: APICacheOptions): Promise<number | string>;
+
+export { sendAPIQuery };

package/lib/download/api/queue.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Default parameters
+ */
+declare const defaultQueueParams: ConcurrentQueriesCommonParams<unknown>;
+/**
+ * Callback to get query
+ */
+type GetConcurrentQueryCallback<T> = (index: number) => Promise<T>;
+/**
+ * Parameters
+ */
+interface ConcurrentQueriesCommonParams<T> {
+    limit?: number;
+    retries?: number;
+    onError?: (index: number, error: unknown, params: ConcurrentQueriesParams<T>) => void | Promise<void>;
+    onSuccess?: (index: number, params: ConcurrentQueriesParams<T>, result: T) => void;
+    onStart?: (index: number, params: ConcurrentQueriesParams<T>) => void;
+}
+interface ConcurrentQueriesParamsWithCount<T> extends ConcurrentQueriesCommonParams<T> {
+    total: number;
+    callback: (index: number) => Promise<T>;
+}
+interface ConcurrentQueriesParamsWithPromises<T> extends ConcurrentQueriesCommonParams<T> {
+    promises: Promise<T>[];
+}
+type ConcurrentQueriesParams<T> = ConcurrentQueriesParamsWithCount<T> | ConcurrentQueriesParamsWithPromises<T>;
+/**
+ * Runs concurrent async operations
+ */
+declare function runConcurrentQueries<T>(params: ConcurrentQueriesParams<T>): Promise<T[]>;
+
+export { type ConcurrentQueriesCommonParams, type ConcurrentQueriesParams, type ConcurrentQueriesParamsWithCount, type ConcurrentQueriesParamsWithPromises, type GetConcurrentQueryCallback, defaultQueueParams, runConcurrentQueries };

package/lib/download/api/queue.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Default parameters
+ */
+declare const defaultQueueParams: ConcurrentQueriesCommonParams<unknown>;
+/**
+ * Callback to get query
+ */
+type GetConcurrentQueryCallback<T> = (index: number) => Promise<T>;
+/**
+ * Parameters
+ */
+interface ConcurrentQueriesCommonParams<T> {
+    limit?: number;
+    retries?: number;
+    onError?: (index: number, error: unknown, params: ConcurrentQueriesParams<T>) => void | Promise<void>;
+    onSuccess?: (index: number, params: ConcurrentQueriesParams<T>, result: T) => void;
+    onStart?: (index: number, params: ConcurrentQueriesParams<T>) => void;
+}
+interface ConcurrentQueriesParamsWithCount<T> extends ConcurrentQueriesCommonParams<T> {
+    total: number;
+    callback: (index: number) => Promise<T>;
+}
+interface ConcurrentQueriesParamsWithPromises<T> extends ConcurrentQueriesCommonParams<T> {
+    promises: Promise<T>[];
+}
+type ConcurrentQueriesParams<T> = ConcurrentQueriesParamsWithCount<T> | ConcurrentQueriesParamsWithPromises<T>;
+/**
+ * Runs concurrent async operations
+ */
+declare function runConcurrentQueries<T>(params: ConcurrentQueriesParams<T>): Promise<T[]>;
+
+export { type ConcurrentQueriesCommonParams, type ConcurrentQueriesParams, type ConcurrentQueriesParamsWithCount, type ConcurrentQueriesParamsWithPromises, type GetConcurrentQueryCallback, defaultQueueParams, runConcurrentQueries };

package/lib/download/api/queue.d.ts

@@ -29,4 +29,4 @@ type ConcurrentQueriesParams<T> = ConcurrentQueriesParamsWithCount<T> | Concurre
  */
 declare function runConcurrentQueries<T>(params: ConcurrentQueriesParams<T>): Promise<T[]>;
 
-export { ConcurrentQueriesCommonParams, ConcurrentQueriesParams, ConcurrentQueriesParamsWithCount, ConcurrentQueriesParamsWithPromises, GetConcurrentQueryCallback, defaultQueueParams, runConcurrentQueries };
+export { type ConcurrentQueriesCommonParams, type ConcurrentQueriesParams, type ConcurrentQueriesParamsWithCount, type ConcurrentQueriesParamsWithPromises, type GetConcurrentQueryCallback, defaultQueueParams, runConcurrentQueries };

package/lib/download/api/types.d.cts

@@ -0,0 +1,17 @@
+/**
+ * API Cache
+ */
+interface APICacheOptions {
+    dir: string;
+    ttl: number;
+}
+/**
+ * Params
+ */
+interface APIQueryParams {
+    uri: string;
+    params?: URLSearchParams;
+    headers?: Record<string, string>;
+}
+
+export type { APICacheOptions, APIQueryParams };

package/lib/download/api/types.d.mts

@@ -0,0 +1,17 @@
+/**
+ * API Cache
+ */
+interface APICacheOptions {
+    dir: string;
+    ttl: number;
+}
+/**
+ * Params
+ */
+interface APIQueryParams {
+    uri: string;
+    params?: URLSearchParams;
+    headers?: Record<string, string>;
+}
+
+export type { APICacheOptions, APIQueryParams };

package/lib/download/api/types.d.ts

@@ -14,4 +14,4 @@ interface APIQueryParams {
     headers?: Record<string, string>;
 }
 
-export { APICacheOptions, APIQueryParams };
+export type { APICacheOptions, APIQueryParams };

package/lib/download/git/branch.d.cts

@@ -0,0 +1,8 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.cjs';
+
+/**
+ * Get current branch from cloned git repo
+ */
+declare function getGitRepoBranch(options: ExportTargetOptions, checkout?: string): Promise<string>;
+
+export { getGitRepoBranch };

package/lib/download/git/branch.d.mts

@@ -0,0 +1,8 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.mjs';
+
+/**
+ * Get current branch from cloned git repo
+ */
+declare function getGitRepoBranch(options: ExportTargetOptions, checkout?: string): Promise<string>;
+
+export { getGitRepoBranch };

package/lib/download/git/hash.d.cts

@@ -0,0 +1,8 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.cjs';
+
+/**
+ * Get latest hash from cloned git repo
+ */
+declare function getGitRepoHash(options: ExportTargetOptions): Promise<string>;
+
+export { getGitRepoHash };

package/lib/download/git/hash.d.mts

@@ -0,0 +1,8 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.mjs';
+
+/**
+ * Get latest hash from cloned git repo
+ */
+declare function getGitRepoHash(options: ExportTargetOptions): Promise<string>;
+
+export { getGitRepoHash };

package/lib/download/git/index.d.cts

@@ -0,0 +1,29 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.cjs';
+import { DocumentNotModified } from '../types/modified.cjs';
+import { DownloadSourceMixin } from '../types/sources.cjs';
+
+interface IfModifiedSinceOption {
+    ifModifiedSince: string | true | DownloadGitRepoResult;
+}
+/**
+ * Options for downloadGitRepo()
+ */
+interface DownloadGitRepoOptions extends ExportTargetOptions, Partial<IfModifiedSinceOption> {
+    remote: string;
+    branch: string;
+    log?: boolean;
+}
+/**
+ * Result
+ */
+interface DownloadGitRepoResult extends DownloadSourceMixin<'git'> {
+    contentsDir: string;
+    hash: string;
+}
+/**
+ * Download Git repo
+ */
+declare function downloadGitRepo<T extends IfModifiedSinceOption & DownloadGitRepoOptions>(options: T): Promise<DownloadGitRepoResult | DocumentNotModified>;
+declare function downloadGitRepo(options: DownloadGitRepoOptions): Promise<DownloadGitRepoResult>;
+
+export { type DownloadGitRepoOptions, type DownloadGitRepoResult, downloadGitRepo };

package/lib/download/git/index.d.mts

@@ -0,0 +1,29 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.mjs';
+import { DocumentNotModified } from '../types/modified.mjs';
+import { DownloadSourceMixin } from '../types/sources.mjs';
+
+interface IfModifiedSinceOption {
+    ifModifiedSince: string | true | DownloadGitRepoResult;
+}
+/**
+ * Options for downloadGitRepo()
+ */
+interface DownloadGitRepoOptions extends ExportTargetOptions, Partial<IfModifiedSinceOption> {
+    remote: string;
+    branch: string;
+    log?: boolean;
+}
+/**
+ * Result
+ */
+interface DownloadGitRepoResult extends DownloadSourceMixin<'git'> {
+    contentsDir: string;
+    hash: string;
+}
+/**
+ * Download Git repo
+ */
+declare function downloadGitRepo<T extends IfModifiedSinceOption & DownloadGitRepoOptions>(options: T): Promise<DownloadGitRepoResult | DocumentNotModified>;
+declare function downloadGitRepo(options: DownloadGitRepoOptions): Promise<DownloadGitRepoResult>;
+
+export { type DownloadGitRepoOptions, type DownloadGitRepoResult, downloadGitRepo };

package/lib/download/git/index.d.ts

@@ -26,4 +26,4 @@ interface DownloadGitRepoResult extends DownloadSourceMixin<'git'> {
 declare function downloadGitRepo<T extends IfModifiedSinceOption & DownloadGitRepoOptions>(options: T): Promise<DownloadGitRepoResult | DocumentNotModified>;
 declare function downloadGitRepo(options: DownloadGitRepoOptions): Promise<DownloadGitRepoResult>;
 
-export { DownloadGitRepoOptions, DownloadGitRepoResult, downloadGitRepo };
+export { type DownloadGitRepoOptions, type DownloadGitRepoResult, downloadGitRepo };

package/lib/download/git/reset.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Reset Git repo contents
+ */
+declare function resetGitRepoContents(target: string): Promise<void>;
+
+export { resetGitRepoContents };

package/lib/download/git/reset.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Reset Git repo contents
+ */
+declare function resetGitRepoContents(target: string): Promise<void>;
+
+export { resetGitRepoContents };

package/lib/download/github/hash.d.cts

@@ -0,0 +1,8 @@
+import { GitHubAPIOptions } from './types.cjs';
+
+/**
+ * Get latest hash from GitHub using API
+ */
+declare function getGitHubRepoHash(options: GitHubAPIOptions): Promise<string>;
+
+export { getGitHubRepoHash };

package/lib/download/github/hash.d.mts

@@ -0,0 +1,8 @@
+import { GitHubAPIOptions } from './types.mjs';
+
+/**
+ * Get latest hash from GitHub using API
+ */
+declare function getGitHubRepoHash(options: GitHubAPIOptions): Promise<string>;
+
+export { getGitHubRepoHash };

package/lib/download/github/index.d.cts

@@ -0,0 +1,31 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.cjs';
+import { DocumentNotModified } from '../types/modified.cjs';
+import { GitHubAPIOptions } from './types.cjs';
+import { DownloadSourceMixin } from '../types/sources.cjs';
+
+interface IfModifiedSinceOption {
+    ifModifiedSince: string | DownloadGitHubRepoResult;
+}
+/**
+ * Options for downloadGitHubRepo()
+ */
+interface DownloadGitHubRepoOptions extends ExportTargetOptions, GitHubAPIOptions, Partial<IfModifiedSinceOption> {
+    cleanupOldFiles?: boolean;
+    cleanupOldDirectories?: boolean;
+    log?: boolean;
+}
+/**
+ * Result
+ */
+interface DownloadGitHubRepoResult extends DownloadSourceMixin<'github'> {
+    rootDir: string;
+    contentsDir: string;
+    hash: string;
+}
+/**
+ * Download GitHub repo using API
+ */
+declare function downloadGitHubRepo<T extends IfModifiedSinceOption & DownloadGitHubRepoOptions>(options: T): Promise<DownloadGitHubRepoResult | DocumentNotModified>;
+declare function downloadGitHubRepo(options: DownloadGitHubRepoOptions): Promise<DownloadGitHubRepoResult>;
+
+export { type DownloadGitHubRepoOptions, type DownloadGitHubRepoResult, downloadGitHubRepo };

package/lib/download/github/index.d.mts

@@ -0,0 +1,31 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.mjs';
+import { DocumentNotModified } from '../types/modified.mjs';
+import { GitHubAPIOptions } from './types.mjs';
+import { DownloadSourceMixin } from '../types/sources.mjs';
+
+interface IfModifiedSinceOption {
+    ifModifiedSince: string | DownloadGitHubRepoResult;
+}
+/**
+ * Options for downloadGitHubRepo()
+ */
+interface DownloadGitHubRepoOptions extends ExportTargetOptions, GitHubAPIOptions, Partial<IfModifiedSinceOption> {
+    cleanupOldFiles?: boolean;
+    cleanupOldDirectories?: boolean;
+    log?: boolean;
+}
+/**
+ * Result
+ */
+interface DownloadGitHubRepoResult extends DownloadSourceMixin<'github'> {
+    rootDir: string;
+    contentsDir: string;
+    hash: string;
+}
+/**
+ * Download GitHub repo using API
+ */
+declare function downloadGitHubRepo<T extends IfModifiedSinceOption & DownloadGitHubRepoOptions>(options: T): Promise<DownloadGitHubRepoResult | DocumentNotModified>;
+declare function downloadGitHubRepo(options: DownloadGitHubRepoOptions): Promise<DownloadGitHubRepoResult>;
+
+export { type DownloadGitHubRepoOptions, type DownloadGitHubRepoResult, downloadGitHubRepo };

package/lib/download/github/index.d.ts

@@ -28,4 +28,4 @@ interface DownloadGitHubRepoResult extends DownloadSourceMixin<'github'> {
 declare function downloadGitHubRepo<T extends IfModifiedSinceOption & DownloadGitHubRepoOptions>(options: T): Promise<DownloadGitHubRepoResult | DocumentNotModified>;
 declare function downloadGitHubRepo(options: DownloadGitHubRepoOptions): Promise<DownloadGitHubRepoResult>;
 
-export { DownloadGitHubRepoOptions, DownloadGitHubRepoResult, downloadGitHubRepo };
+export { type DownloadGitHubRepoOptions, type DownloadGitHubRepoResult, downloadGitHubRepo };

package/lib/download/github/types.d.cts

@@ -0,0 +1,11 @@
+/**
+ * API options
+ */
+interface GitHubAPIOptions {
+    token: string;
+    user: string;
+    repo: string;
+    branch: string;
+}
+
+export type { GitHubAPIOptions };

package/lib/download/github/types.d.mts

@@ -0,0 +1,11 @@
+/**
+ * API options
+ */
+interface GitHubAPIOptions {
+    token: string;
+    user: string;
+    repo: string;
+    branch: string;
+}
+
+export type { GitHubAPIOptions };

package/lib/download/github/types.d.ts

@@ -8,4 +8,4 @@ interface GitHubAPIOptions {
     branch: string;
 }
 
-export { GitHubAPIOptions };
+export type { GitHubAPIOptions };

package/lib/download/gitlab/hash.d.cts

@@ -0,0 +1,8 @@
+import { GitLabAPIOptions } from './types.cjs';
+
+/**
+ * Get latest hash from GitHub using API
+ */
+declare function getGitLabRepoHash(options: GitLabAPIOptions): Promise<string>;
+
+export { getGitLabRepoHash };

package/lib/download/gitlab/hash.d.mts

@@ -0,0 +1,8 @@
+import { GitLabAPIOptions } from './types.mjs';
+
+/**
+ * Get latest hash from GitHub using API
+ */
+declare function getGitLabRepoHash(options: GitLabAPIOptions): Promise<string>;
+
+export { getGitLabRepoHash };

package/lib/download/gitlab/index.d.cts

@@ -0,0 +1,31 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.cjs';
+import { DocumentNotModified } from '../types/modified.cjs';
+import { GitLabAPIOptions } from './types.cjs';
+import { DownloadSourceMixin } from '../types/sources.cjs';
+
+interface IfModifiedSinceOption {
+    ifModifiedSince: string | DownloadGitLabRepoResult;
+}
+/**
+ * Options for downloadGitLabRepo()
+ */
+interface DownloadGitLabRepoOptions extends ExportTargetOptions, GitLabAPIOptions, Partial<IfModifiedSinceOption> {
+    cleanupOldFiles?: boolean;
+    cleanupOldDirectories?: boolean;
+    log?: boolean;
+}
+/**
+ * Result
+ */
+interface DownloadGitLabRepoResult extends DownloadSourceMixin<'gitlab'> {
+    rootDir: string;
+    contentsDir: string;
+    hash: string;
+}
+/**
+ * Download GitLab repo using API
+ */
+declare function downloadGitLabRepo<T extends IfModifiedSinceOption & DownloadGitLabRepoOptions>(options: T): Promise<DownloadGitLabRepoResult | DocumentNotModified>;
+declare function downloadGitLabRepo(options: DownloadGitLabRepoOptions): Promise<DownloadGitLabRepoResult>;
+
+export { type DownloadGitLabRepoOptions, type DownloadGitLabRepoResult, downloadGitLabRepo };

package/lib/download/gitlab/index.d.mts

@@ -0,0 +1,31 @@
+import { ExportTargetOptions } from '../../export/helpers/prepare.mjs';
+import { DocumentNotModified } from '../types/modified.mjs';
+import { GitLabAPIOptions } from './types.mjs';
+import { DownloadSourceMixin } from '../types/sources.mjs';
+
+interface IfModifiedSinceOption {
+    ifModifiedSince: string | DownloadGitLabRepoResult;
+}
+/**
+ * Options for downloadGitLabRepo()
+ */
+interface DownloadGitLabRepoOptions extends ExportTargetOptions, GitLabAPIOptions, Partial<IfModifiedSinceOption> {
+    cleanupOldFiles?: boolean;
+    cleanupOldDirectories?: boolean;
+    log?: boolean;
+}
+/**
+ * Result
+ */
+interface DownloadGitLabRepoResult extends DownloadSourceMixin<'gitlab'> {
+    rootDir: string;
+    contentsDir: string;
+    hash: string;
+}
+/**
+ * Download GitLab repo using API
+ */
+declare function downloadGitLabRepo<T extends IfModifiedSinceOption & DownloadGitLabRepoOptions>(options: T): Promise<DownloadGitLabRepoResult | DocumentNotModified>;
+declare function downloadGitLabRepo(options: DownloadGitLabRepoOptions): Promise<DownloadGitLabRepoResult>;
+
+export { type DownloadGitLabRepoOptions, type DownloadGitLabRepoResult, downloadGitLabRepo };

package/lib/download/gitlab/index.d.ts

@@ -28,4 +28,4 @@ interface DownloadGitLabRepoResult extends DownloadSourceMixin<'gitlab'> {
 declare function downloadGitLabRepo<T extends IfModifiedSinceOption & DownloadGitLabRepoOptions>(options: T): Promise<DownloadGitLabRepoResult | DocumentNotModified>;
 declare function downloadGitLabRepo(options: DownloadGitLabRepoOptions): Promise<DownloadGitLabRepoResult>;
 
-export { DownloadGitLabRepoOptions, DownloadGitLabRepoResult, downloadGitLabRepo };
+export { type DownloadGitLabRepoOptions, type DownloadGitLabRepoResult, downloadGitLabRepo };

package/lib/download/gitlab/types.d.cts

@@ -0,0 +1,15 @@
+/**
+ * API options
+ */
+interface GitLabAPIOptions {
+    uri?: string;
+    token: string;
+    project: string;
+    branch: string;
+}
+/**
+ * Default base URI for GitLab API
+ */
+declare const defaultGitLabBaseURI = "https://gitlab.com/api/v4/projects";
+
+export { type GitLabAPIOptions, defaultGitLabBaseURI };

package/lib/download/gitlab/types.d.mts

@@ -0,0 +1,15 @@
+/**
+ * API options
+ */
+interface GitLabAPIOptions {
+    uri?: string;
+    token: string;
+    project: string;
+    branch: string;
+}
+/**
+ * Default base URI for GitLab API
+ */
+declare const defaultGitLabBaseURI = "https://gitlab.com/api/v4/projects";
+
+export { type GitLabAPIOptions, defaultGitLabBaseURI };

package/lib/download/gitlab/types.d.ts

@@ -12,4 +12,4 @@ interface GitLabAPIOptions {
  */
 declare const defaultGitLabBaseURI = "https://gitlab.com/api/v4/projects";
 
-export { GitLabAPIOptions, defaultGitLabBaseURI };
+export { type GitLabAPIOptions, defaultGitLabBaseURI };

package/lib/download/helpers/untar.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Unpack .tgz archive
+ */
+declare function untar(file: string, path: string): Promise<void>;
+
+export { untar };

package/lib/download/helpers/untar.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Unpack .tgz archive
+ */
+declare function untar(file: string, path: string): Promise<void>;
+
+export { untar };

package/lib/download/helpers/unzip.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Unzip archive
+ */
+declare function unzip(source: string, path: string): Promise<void>;
+
+export { unzip };

package/lib/download/helpers/unzip.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Unzip archive
+ */
+declare function unzip(source: string, path: string): Promise<void>;
+
+export { unzip };

package/lib/download/index.d.cts

@@ -0,0 +1,48 @@
+import { DownloadGitHubRepoOptions, DownloadGitHubRepoResult } from './github/index.cjs';
+import { DownloadGitRepoOptions, DownloadGitRepoResult } from './git/index.cjs';
+import { DownloadNPMPackageOptions, DownloadNPMPackageResult } from './npm/index.cjs';
+import { DocumentNotModified } from './types/modified.cjs';
+import { DownloadSourceType, DownloadSourceMixin } from './types/sources.cjs';
+import { DownloadGitLabRepoOptions, DownloadGitLabRepoResult } from './gitlab/index.cjs';
+import '../export/helpers/prepare.cjs';
+import './github/types.cjs';
+import './gitlab/types.cjs';
+
+/**
+ * Options and result combinations
+ */
+interface DownloadGitRepo {
+    options: DownloadGitRepoOptions & DownloadSourceMixin<'git'>;
+    result: DownloadGitRepoResult;
+}
+interface DownloadGitHubRepo {
+    options: DownloadGitHubRepoOptions & DownloadSourceMixin<'github'>;
+    result: DownloadGitHubRepoResult;
+}
+interface DownloadGitLabRepo {
+    options: DownloadGitLabRepoOptions & DownloadSourceMixin<'gitlab'>;
+    result: DownloadGitLabRepoResult;
+}
+interface DownloadNPMPackage {
+    options: DownloadNPMPackageOptions & DownloadSourceMixin<'npm'>;
+    result: DownloadNPMPackageResult;
+}
+/**
+ * Combinations based on type
+ */
+type DownloadParamsMixin<T extends DownloadSourceType> = T extends 'git' ? DownloadGitRepo : T extends 'github' ? DownloadGitHubRepo : T extends 'gitlab' ? DownloadGitLabRepo : T extends 'npm' ? DownloadNPMPackage : never;
+/**
+ * Combinations
+ */
+type DownloadParams = DownloadGitRepo | DownloadGitHubRepo | DownloadGitLabRepo | DownloadNPMPackage;
+/**
+ * Pick options or result from combinations
+ */
+type DownloadOptions<T extends DownloadSourceType> = DownloadParamsMixin<T>['options'];
+type DownloadResult<T extends DownloadSourceType> = Promise<DocumentNotModified | DownloadParamsMixin<T>['result']>;
+declare function downloadPackage<T extends 'git'>(options: DownloadOptions<T>): DownloadResult<T>;
+declare function downloadPackage<T extends 'github'>(options: DownloadOptions<T>): DownloadResult<T>;
+declare function downloadPackage<T extends 'gitlab'>(options: DownloadOptions<T>): DownloadResult<T>;
+declare function downloadPackage<T extends 'npm'>(options: DownloadOptions<T>): DownloadResult<T>;
+
+export { type DownloadParams, type DownloadParamsMixin, downloadPackage };