windmill-cli 0.0.1

package/esm/bootstrap/script_bootstrap.js

@@ -0,0 +1,57 @@
+export function defaultScriptMetadata() {
+    return {
+        summary: "",
+        description: "",
+        lock: "",
+        kind: "script",
+        schema: {
+            $schema: "https://json-schema.org/draft/2020-12/schema",
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    };
+}
+export const scriptBootstrapCode = {
+    python3: `def main():
+    return "Hello world"
+`,
+    nativets: `export async function main() {
+    return "Hello world";
+}
+`,
+    bun: `export async function main() {
+  return "Hello world";
+}
+`,
+    deno: `export async function main() {
+  return "Hello world";
+}
+`,
+    go: `package inner
+func main() (interface{}, error) {
+    return "Hello world", nil
+}
+`,
+    mysql: `SELECT 'Hello world' AS message
+`,
+    bigquery: `SELECT 'Hello world' AS message
+`,
+    snowflake: `SELECT 'Hello world' AS message
+`,
+    mssql: `SELECT 'Hello world' AS message
+`,
+    graphql: `query() {
+    demo() {}
+}`,
+    postgresql: `SELECT 'Hello world' AS message
+`,
+    bash: `echo "Hello world"
+`,
+    powershell: `Write-Output "Hello world"`,
+    php: `<?php
+function main() {
+  return "Hello world";
+}
+`,
+};

package/esm/codebase.d.ts

@@ -0,0 +1,6 @@
+import { Codebase, SyncOptions } from "./conf.js";
+export type SyncCodebase = Codebase & {
+    digest: string;
+};
+export declare function listSyncCodebases(options: SyncOptions): Promise<SyncCodebase[]>;
+//# sourceMappingURL=codebase.d.ts.map

package/esm/codebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase.d.ts","sourceRoot":"","sources":["../src/codebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIlD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACzD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBzB"}

package/esm/codebase.js

@@ -0,0 +1,18 @@
+import { log } from "./deps.js";
+import { digestDir } from "./utils.js";
+export async function listSyncCodebases(options) {
+    const res = [];
+    const nb_codebase = options?.codebases?.length ?? 0;
+    if (nb_codebase > 0) {
+        log.info(`Found ${nb_codebase} codebases:`);
+    }
+    for (const codebase of options?.codebases ?? []) {
+        let digest = await digestDir(codebase.relative_path, JSON.stringify(codebase));
+        if (Array.isArray(codebase.assets) && codebase.assets.length > 0) {
+            digest += ".tar";
+        }
+        log.info(`Codebase ${codebase.relative_path}, digest: ${digest}`);
+        res.push({ ...codebase, digest });
+    }
+    return res;
+}

package/esm/conf.d.ts

@@ -0,0 +1,41 @@
+export interface SyncOptions {
+    stateful?: boolean;
+    raw?: boolean;
+    yes?: boolean;
+    skipPull?: boolean;
+    failConflicts?: boolean;
+    plainSecrets?: boolean;
+    json?: boolean;
+    skipVariables?: boolean;
+    skipResources?: boolean;
+    skipSecrets?: boolean;
+    includeSchedules?: boolean;
+    includeUsers?: boolean;
+    includeGroups?: boolean;
+    includeSettings?: boolean;
+    includeKey?: boolean;
+    message?: string;
+    includes?: string[];
+    extraIncludes?: string[];
+    excludes?: string[];
+    defaultTs?: "bun" | "deno";
+    codebases?: Codebase[];
+}
+export interface Codebase {
+    relative_path: string;
+    includes?: string[];
+    excludes?: string[];
+    assets?: {
+        from: string;
+        to: string;
+    }[];
+    customBundler?: string;
+    external?: string[];
+    define?: {
+        [key: string]: string;
+    };
+    inject?: string[];
+}
+export declare function readConfigFile(): Promise<SyncOptions>;
+export declare function mergeConfigWithConfigFile<T>(opts: T): Promise<T & SyncOptions>;
+//# sourceMappingURL=conf.d.ts.map

package/esm/conf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conf.d.ts","sourceRoot":"","sources":["../src/conf.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;IACJ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAiB3D;AAED,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,CAG1B"}

package/esm/conf.js

@@ -0,0 +1,19 @@
+import * as dntShim from "./_dnt.shims.js";
+import { log, yamlParse } from "./deps.js";
+export async function readConfigFile() {
+    try {
+        const conf = yamlParse(await dntShim.Deno.readTextFile("wmill.yaml"));
+        if (conf?.defaultTs == undefined) {
+            log.warn("No defaultTs defined in your wmill.yaml. Using 'bun' as default.");
+        }
+        return typeof conf == "object" ? conf : {};
+    }
+    catch (e) {
+        log.warn("No wmill.yaml found. Use 'wmill init' to bootstrap it. Using 'bun' as default typescript runtime.");
+        return {};
+    }
+}
+export async function mergeConfigWithConfigFile(opts) {
+    const configFile = await readConfigFile();
+    return Object.assign(configFile, opts);
+}

package/esm/context.d.ts

@@ -0,0 +1,15 @@
+import { GlobalUserInfo } from "./deps.js";
+import { GlobalOptions } from "./types.js";
+import { Workspace } from "./workspace.js";
+export type Context = {
+    workspace: string;
+    baseUrl: string;
+    urlStore: string;
+    token: string;
+};
+export declare function resolveWorkspace(opts: GlobalOptions): Promise<Workspace>;
+export declare function requireLogin(opts: GlobalOptions): Promise<GlobalUserInfo>;
+export declare function fetchVersion(baseUrl: string): Promise<string>;
+export declare function tryResolveVersion(opts: GlobalOptions): Promise<number | undefined>;
+export declare function validatePath(path: string): boolean;
+//# sourceMappingURL=context.d.ts.map

package/esm/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,cAAc,EAA+B,MAAM,WAAW,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAKL,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAiCF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,SAAS,CAAC,CAQpB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBnE;AACD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWlD"}

package/esm/context.js

@@ -0,0 +1,97 @@
+// deno-lint-ignore-file no-explicit-any
+import * as dntShim from "./_dnt.shims.js";
+import { colors, log, setClient, UserService } from "./deps.js";
+import { loginInteractive, tryGetLoginInfo } from "./login.js";
+import { getHeaders } from "./utils.js";
+import { addWorkspace, getActiveWorkspace, getWorkspaceByName, removeWorkspace, } from "./workspace.js";
+async function tryResolveWorkspace(opts) {
+    const cache = opts.__secret_workspace;
+    if (cache)
+        return { isError: false, value: cache };
+    if (opts.workspace) {
+        const e = await getWorkspaceByName(opts.workspace);
+        if (!e) {
+            return {
+                isError: true,
+                error: colors.red.underline("Given workspace does not exist."),
+            };
+        }
+        opts.__secret_workspace = e;
+        return { isError: false, value: e };
+    }
+    const defaultWorkspace = await getActiveWorkspace(opts);
+    if (!defaultWorkspace) {
+        return {
+            isError: true,
+            error: colors.red.underline("No workspace given and no default set."),
+        };
+    }
+    return { isError: false, value: defaultWorkspace };
+}
+export async function resolveWorkspace(opts) {
+    const res = await tryResolveWorkspace(opts);
+    if (res.isError) {
+        log.info(colors.red.bold(res.error));
+        return dntShim.Deno.exit(-1);
+    }
+    else {
+        return res.value;
+    }
+}
+export async function requireLogin(opts) {
+    const workspace = await resolveWorkspace(opts);
+    let token = await tryGetLoginInfo(opts);
+    if (!token) {
+        token = workspace.token;
+    }
+    setClient(token, workspace.remote.substring(0, workspace.remote.length - 1));
+    try {
+        return await UserService.globalWhoami();
+    }
+    catch {
+        log.info("! Could not reach API given existing credentials. Attempting to reauth...");
+        const newToken = await loginInteractive(workspace.remote);
+        if (!newToken) {
+            throw new Error("Could not reauth");
+        }
+        removeWorkspace(workspace.name, false, opts);
+        workspace.token = newToken;
+        addWorkspace(workspace, opts);
+        setClient(token, workspace.remote.substring(0, workspace.remote.length - 1));
+        return await UserService.globalWhoami();
+    }
+}
+export async function fetchVersion(baseUrl) {
+    const requestHeaders = new dntShim.Headers();
+    const extraHeaders = getHeaders();
+    if (extraHeaders) {
+        for (const [key, value] of Object.entries(extraHeaders)) {
+            // @ts-ignore
+            requestHeaders.set(key, value);
+        }
+    }
+    const response = await dntShim.fetch(new URL(new URL(baseUrl).origin + "/api/version"), { headers: requestHeaders, method: "GET" });
+    return await response.text();
+}
+export async function tryResolveVersion(opts) {
+    if (opts.__cache_version) {
+        return opts.__cache_version;
+    }
+    const workspaceRes = await tryResolveWorkspace(opts);
+    if (workspaceRes.isError)
+        return undefined;
+    const version = await fetchVersion(workspaceRes.value.remote);
+    try {
+        return Number.parseInt(version.split("-", 1)[0].replaceAll(".", "").replace("v", ""));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function validatePath(path) {
+    if (!(path.startsWith("g") || path.startsWith("u") || path.startsWith("f"))) {
+        log.info(colors.red("Given remote path looks invalid. Remote paths are typically of the form <u|g|f>/<username|group|folder>/..."));
+        return false;
+    }
+    return true;
+}

package/esm/deps/jsr.io/@cliffy/ansi/1.0.0-rc.5/ansi_escapes.d.ts

@@ -0,0 +1,135 @@
+/** Ring audio bell: `\u0007` */
+export declare const bel = "\u0007";
+/** Get cursor position. */
+export declare const cursorPosition: string;
+/**
+ * Move cursor to x, y, counting from the top left corner.
+ * @param x Position left.
+ * @param y Position top.
+ */
+export declare function cursorTo(x: number, y?: number): string;
+/**
+ * Move cursor by offset.
+ * @param x Offset left.
+ * @param y Offset top.
+ */
+export declare function cursorMove(x: number, y: number): string;
+/**
+ * Move cursor up by n lines.
+ * @param count Number of lines.
+ */
+export declare function cursorUp(count?: number): string;
+/**
+ * Move cursor down by n lines.
+ * @param count Number of lines.
+ */
+export declare function cursorDown(count?: number): string;
+/**
+ * Move cursor forward by n lines.
+ * @param count Number of lines.
+ */
+export declare function cursorForward(count?: number): string;
+/**
+ * Move cursor backward by n lines.
+ * @param count Number of lines.
+ */
+export declare function cursorBackward(count?: number): string;
+/**
+ * Move cursor to the beginning of the line n lines down.
+ * @param count Number of lines.
+ */
+export declare function cursorNextLine(count?: number): string;
+/**
+ * Move cursor to the beginning of the line n lines up.
+ * @param count Number of lines.
+ */
+export declare function cursorPrevLine(count?: number): string;
+/** Move cursor to first column of current row. */
+export declare const cursorLeft: string;
+/** Hide cursor. */
+export declare const cursorHide: string;
+/** Show cursor. */
+export declare const cursorShow: string;
+/** Save cursor. */
+export declare const cursorSave: string;
+/** Restore cursor. */
+export declare const cursorRestore: string;
+/**
+ * Scroll window up by n lines.
+ * @param count Number of lines.
+ */
+export declare function scrollUp(count?: number): string;
+/**
+ * Scroll window down by n lines.
+ * @param count Number of lines.
+ */
+export declare function scrollDown(count?: number): string;
+/** Clear screen. */
+export declare const eraseScreen: string;
+/**
+ * Clear screen up by n lines.
+ * @param count Number of lines.
+ */
+export declare function eraseUp(count?: number): string;
+/**
+ * Clear screen down by n lines.
+ * @param count Number of lines.
+ */
+export declare function eraseDown(count?: number): string;
+/** Clear current line. */
+export declare const eraseLine: string;
+/** Clear to line end. */
+export declare const eraseLineEnd: string;
+/** Clear to line start. */
+export declare const eraseLineStart: string;
+/**
+ * Clear screen and move cursor by n lines up and move cursor to first column.
+ * @param count Number of lines.
+ */
+export declare function eraseLines(count: number): string;
+/** Clear the terminal screen. (Viewport) */
+export declare const clearScreen = "\u001Bc";
+/**
+ * Clear the whole terminal, including scrollback buffer.
+ * (Not just the visible part of it).
+ */
+export declare const clearTerminal: string;
+/**
+ * Create link.
+ *
+ * @param text Link text.
+ * @param url Link url.
+ *
+ * ```ts
+ * import { link } from "@cliffy/ansi/ansi-escapes";
+ *
+ * console.log(
+ *   link("Click me.", "https://deno.land"),
+ * );
+ * ```
+ */
+export declare function link(text: string, url: string): string;
+/** Image options. */
+export interface ImageOptions {
+    width?: number;
+    height?: number;
+    preserveAspectRatio?: boolean;
+}
+/**
+ * Create image.
+ *
+ * @param buffer  Image buffer.
+ * @param options Image options.
+ *
+ * ```ts
+ * import { image } from "@cliffy/ansi/ansi-escapes";
+ *
+ * const response = await fetch("https://deno.land/images/hashrock_simple.png");
+ * const imageBuffer: ArrayBuffer = await response.arrayBuffer();
+ * console.log(
+ *   image(imageBuffer),
+ * );
+ * ```
+ */
+export declare function image(buffer: string | ArrayBuffer, options?: ImageOptions): string;
+//# sourceMappingURL=ansi_escapes.d.ts.map

package/esm/deps/jsr.io/@cliffy/ansi/1.0.0-rc.5/ansi_escapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi_escapes.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@cliffy/ansi/1.0.0-rc.5/ansi_escapes.ts"],"names":[],"mappings":"AAYA,gCAAgC;AAChC,eAAO,MAAM,GAAG,WAAW,CAAC;AAC5B,2BAA2B;AAC3B,eAAO,MAAM,cAAc,EAAE,MAAmB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAI,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAI,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAI,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAI,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAI,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAI,GAAG,MAAM,CAEhD;AAED,kDAAkD;AAClD,eAAO,MAAM,UAAU,EAAE,MAAkB,CAAC;AAC5C,mBAAmB;AACnB,eAAO,MAAM,UAAU,EAAE,MAAqB,CAAC;AAC/C,mBAAmB;AACnB,eAAO,MAAM,UAAU,EAAE,MAAqB,CAAC;AAC/C,mBAAmB;AACnB,eAAO,MAAM,UAAU,EAAE,MAAkB,CAAC;AAC5C,sBAAsB;AACtB,eAAO,MAAM,aAAa,EAAE,MAAkB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAI,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAI,GAAG,MAAM,CAE5C;AAED,oBAAoB;AACpB,eAAO,MAAM,WAAW,EAAE,MAAmB,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,SAAI,GAAG,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAI,GAAG,MAAM,CAE3C;AAED,0BAA0B;AAC1B,eAAO,MAAM,SAAS,EAAE,MAAmB,CAAC;AAC5C,yBAAyB;AACzB,eAAO,MAAM,YAAY,EAAE,MAAmB,CAAC;AAC/C,2BAA2B;AAC3B,eAAO,MAAM,cAAc,EAAE,MAAmB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,4CAA4C;AAC5C,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAMO,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAetD;AAED,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,GAAG,WAAW,EAC5B,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAgBR"}

package/esm/deps/jsr.io/@cliffy/ansi/1.0.0-rc.5/ansi_escapes.js

@@ -0,0 +1,218 @@
+import { encodeBase64 } from "../../../@std/encoding/1.0.0-rc.2/base64.js";
+import { getOs } from "../../internal/1.0.0-rc.5/runtime/get_os.js";
+/** Escape sequence: `\x1B` */
+const ESC = "\x1B";
+/** Control sequence intro: `\x1B[` */
+const CSI = `${ESC}[`;
+/** Operating system command: `\x1B]` */
+const OSC = `${ESC}]`;
+/** Link separator */
+const SEP = ";";
+/** Ring audio bell: `\u0007` */
+export const bel = "\u0007";
+/** Get cursor position. */
+export const cursorPosition = `${CSI}6n`;
+/**
+ * Move cursor to x, y, counting from the top left corner.
+ * @param x Position left.
+ * @param y Position top.
+ */
+export function cursorTo(x, y) {
+    if (typeof y !== "number") {
+        return `${CSI}${x}G`;
+    }
+    return `${CSI}${y};${x}H`;
+}
+/**
+ * Move cursor by offset.
+ * @param x Offset left.
+ * @param y Offset top.
+ */
+export function cursorMove(x, y) {
+    let ret = "";
+    if (x < 0) {
+        ret += `${CSI}${-x}D`;
+    }
+    else if (x > 0) {
+        ret += `${CSI}${x}C`;
+    }
+    if (y < 0) {
+        ret += `${CSI}${-y}A`;
+    }
+    else if (y > 0) {
+        ret += `${CSI}${y}B`;
+    }
+    return ret;
+}
+/**
+ * Move cursor up by n lines.
+ * @param count Number of lines.
+ */
+export function cursorUp(count = 1) {
+    return `${CSI}${count}A`;
+}
+/**
+ * Move cursor down by n lines.
+ * @param count Number of lines.
+ */
+export function cursorDown(count = 1) {
+    return `${CSI}${count}B`;
+}
+/**
+ * Move cursor forward by n lines.
+ * @param count Number of lines.
+ */
+export function cursorForward(count = 1) {
+    return `${CSI}${count}C`;
+}
+/**
+ * Move cursor backward by n lines.
+ * @param count Number of lines.
+ */
+export function cursorBackward(count = 1) {
+    return `${CSI}${count}D`;
+}
+/**
+ * Move cursor to the beginning of the line n lines down.
+ * @param count Number of lines.
+ */
+export function cursorNextLine(count = 1) {
+    return `${CSI}E`.repeat(count);
+}
+/**
+ * Move cursor to the beginning of the line n lines up.
+ * @param count Number of lines.
+ */
+export function cursorPrevLine(count = 1) {
+    return `${CSI}F`.repeat(count);
+}
+/** Move cursor to first column of current row. */
+export const cursorLeft = `${CSI}G`;
+/** Hide cursor. */
+export const cursorHide = `${CSI}?25l`;
+/** Show cursor. */
+export const cursorShow = `${CSI}?25h`;
+/** Save cursor. */
+export const cursorSave = `${ESC}7`;
+/** Restore cursor. */
+export const cursorRestore = `${ESC}8`;
+/**
+ * Scroll window up by n lines.
+ * @param count Number of lines.
+ */
+export function scrollUp(count = 1) {
+    return `${CSI}S`.repeat(count);
+}
+/**
+ * Scroll window down by n lines.
+ * @param count Number of lines.
+ */
+export function scrollDown(count = 1) {
+    return `${CSI}T`.repeat(count);
+}
+/** Clear screen. */
+export const eraseScreen = `${CSI}2J`;
+/**
+ * Clear screen up by n lines.
+ * @param count Number of lines.
+ */
+export function eraseUp(count = 1) {
+    return `${CSI}1J`.repeat(count);
+}
+/**
+ * Clear screen down by n lines.
+ * @param count Number of lines.
+ */
+export function eraseDown(count = 1) {
+    return `${CSI}0J`.repeat(count);
+}
+/** Clear current line. */
+export const eraseLine = `${CSI}2K`;
+/** Clear to line end. */
+export const eraseLineEnd = `${CSI}0K`;
+/** Clear to line start. */
+export const eraseLineStart = `${CSI}1K`;
+/**
+ * Clear screen and move cursor by n lines up and move cursor to first column.
+ * @param count Number of lines.
+ */
+export function eraseLines(count) {
+    let clear = "";
+    for (let i = 0; i < count; i++) {
+        clear += eraseLine + (i < count - 1 ? cursorUp() : "");
+    }
+    clear += cursorLeft;
+    return clear;
+}
+/** Clear the terminal screen. (Viewport) */
+export const clearScreen = "\u001Bc";
+/**
+ * Clear the whole terminal, including scrollback buffer.
+ * (Not just the visible part of it).
+ */
+export const clearTerminal = getOs() === "windows"
+    ? `${eraseScreen}${CSI}0f`
+    // 1. Erases the screen (Only done in case `2` is not supported)
+    // 2. Erases the whole screen including scrollback buffer
+    // 3. Moves cursor to the top-left position
+    // More info: https://www.real-world-systems.com/docs/ANSIcode.html
+    : `${eraseScreen}${CSI}3J${CSI}H`;
+/**
+ * Create link.
+ *
+ * @param text Link text.
+ * @param url Link url.
+ *
+ * ```ts
+ * import { link } from "@cliffy/ansi/ansi-escapes";
+ *
+ * console.log(
+ *   link("Click me.", "https://deno.land"),
+ * );
+ * ```
+ */
+export function link(text, url) {
+    return [
+        OSC,
+        "8",
+        SEP,
+        SEP,
+        url,
+        bel,
+        text,
+        OSC,
+        "8",
+        SEP,
+        SEP,
+        bel,
+    ].join("");
+}
+/**
+ * Create image.
+ *
+ * @param buffer  Image buffer.
+ * @param options Image options.
+ *
+ * ```ts
+ * import { image } from "@cliffy/ansi/ansi-escapes";
+ *
+ * const response = await fetch("https://deno.land/images/hashrock_simple.png");
+ * const imageBuffer: ArrayBuffer = await response.arrayBuffer();
+ * console.log(
+ *   image(imageBuffer),
+ * );
+ * ```
+ */
+export function image(buffer, options) {
+    let ret = `${OSC}1337;File=inline=1`;
+    if (options?.width) {
+        ret += `;width=${options.width}`;
+    }
+    if (options?.height) {
+        ret += `;height=${options.height}`;
+    }
+    if (options?.preserveAspectRatio === false) {
+        ret += ";preserveAspectRatio=0";
+    }
+    return ret + ":" + encodeBase64(buffer) + bel;
+}