@skmtc/core 0.0.226 → 0.0.228

package/script/context/RenderContext.js

@@ -0,0 +1,253 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderContext = void 0;
+const mod_js_1 = require("../deps/jsr.io/@std/encoding/1.0.1/mod.js");
+const Import_js_1 = require("../dsl/Import.js");
+const standalone_1 = require("prettier/standalone");
+const typescript_1 = __importDefault(require("prettier/plugins/typescript"));
+const estree_1 = __importDefault(require("prettier/plugins/estree"));
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const mod_js_2 = require("../deps/jsr.io/@std/path/1.0.0/mod.js");
+const Sentry = __importStar(require("@sentry/deno"));
+class RenderContext {
+    constructor({ files, packageDependencies, prettier, settings, renderDependencies, pinnableGenerators }) {
+        Object.defineProperty(this, "files", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "renderDependencies", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "packageDependencies", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "prettier", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "settings", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "currentDestinationPath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pinnableGenerators", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.currentDestinationPath = 'PRE_RENDER';
+        this.renderDependencies = renderDependencies;
+        this.files = files;
+        this.packageDependencies = packageDependencies;
+        this.prettier = prettier;
+        this.settings = settings;
+        this.pinnableGenerators = pinnableGenerators;
+    }
+    toPackageJson() {
+        const dependencies = Object.fromEntries(this.packageDependencies.entries());
+        const packageJson = JSON.stringify({ dependencies }, null, 2);
+        return packageJson;
+    }
+    async render({ packageJson }) {
+        const result = await Sentry.startSpan({ name: 'Collate content' }, async () => {
+            return await this.collate();
+        });
+        const renderDependenciesEntries = [
+            ...this.renderDependencies.entries()
+        ].map(([generatorId, dependencyGeneratorKeys]) => {
+            return [generatorId, Array.from(dependencyGeneratorKeys)];
+        });
+        const renderDependencies = Object.fromEntries(renderDependenciesEntries);
+        const pinnable = await Sentry.startSpan({ name: 'Generate pinnable' }, () => {
+            return generatePinnable({
+                pinnableGenerators: this.pinnableGenerators,
+                manifest: result.manifest
+            });
+        });
+        return {
+            artifacts: packageJson
+                ? {
+                    ...result.artifacts,
+                    'package.json': this.toPackageJson()
+                }
+                : result.artifacts,
+            manifest: {
+                ...result.manifest,
+                pinnable
+            },
+            renderDependencies
+        };
+    }
+    async collate() {
+        const fileEntries = Array.from(this.files.entries());
+        const fileObjects = fileEntries.map(([destination, file]) => {
+            // Set the current destination path to be used by
+            // addGeneratorKey method to apply generator keys
+            // to Correct file
+            this.currentDestinationPath = destination;
+            return renderFile({
+                file,
+                destination,
+                basePath: this.settings?.basePath,
+                prettier: this.prettier
+            });
+        });
+        this.currentDestinationPath = 'POST_RENDER';
+        const resolvedFileObjects = [];
+        for (const fileObject of fileObjects) {
+            const formattedContent = await Sentry.startSpan({ name: `Format file: ${fileObject.path}` }, async () => {
+                return await formatContent({
+                    content: fileObject.content,
+                    prettier: this.prettier
+                });
+            });
+            const hash = await toHash(formattedContent);
+            resolvedFileObjects.push({
+                ...fileObject,
+                content: formattedContent,
+                hash
+            });
+        }
+        return resolvedFileObjects.reduce((acc, fileObject) => ({
+            artifacts: {
+                ...acc.artifacts,
+                [fileObject.path]: fileObject.content
+            },
+            manifest: {
+                ...acc.manifest,
+                files: {
+                    ...acc.manifest.files,
+                    [fileObject.path]: {
+                        numberOfLines: fileObject.numberOfLines,
+                        numberOfCharacters: fileObject.numberOfCharacters,
+                        hash: fileObject.hash,
+                        generatorKeys: fileObject.generatorKeys
+                    }
+                }
+            }
+        }), {
+            artifacts: {},
+            manifest: {
+                createdAt: new Date().toISOString(),
+                files: {},
+                pinnable: {}
+            }
+        });
+    }
+    getFile(filePath) {
+        const normalisedPath = (0, mod_js_2.normalize)(filePath);
+        const currentFile = this.files.get(normalisedPath);
+        (0, tiny_invariant_1.default)(currentFile, `File not found during render phase: ${normalisedPath}`);
+        return currentFile;
+    }
+    addGeneratorKey({ generatorKey }) {
+        const path = this.currentDestinationPath;
+        (0, tiny_invariant_1.default)(!['PRE_RENDER', 'POST_RENDER'].includes(path), `Cannot add generator key during ${path} phase`);
+        const currentFile = this.getFile(path);
+        currentFile.generatorKeys.add(generatorKey);
+    }
+    pick({ name, exportPath }) {
+        return this.getFile(exportPath).definitions.get(name);
+    }
+}
+exports.RenderContext = RenderContext;
+const toHash = async (content) => {
+    const messageBuffer = new TextEncoder().encode(content);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', messageBuffer);
+    return (0, mod_js_1.encodeHex)(hashBuffer);
+};
+const renderFile = ({ file, destination, basePath }) => {
+    const imports = Array.from(file.imports.entries()).map(([module, importItems]) => new Import_js_1.Import({ module, importNames: Array.from(importItems) }));
+    const definitions = Array.from(file.definitions.values());
+    const content = [imports, definitions]
+        .filter(section => Boolean(section.length))
+        .map(section => section.join('\n'))
+        .join('\n\n');
+    return {
+        content,
+        path: (0, mod_js_2.join)(basePath ?? 'dist', destination.replace(/^@\//, '')),
+        numberOfLines: content.split('\n').length,
+        numberOfCharacters: content.length,
+        generatorKeys: Array.from(file.generatorKeys).filter(Boolean) // @TODO Fix null keys
+    };
+};
+const formatContent = async ({ content, prettier }) => {
+    if (!prettier) {
+        return content;
+    }
+    return await (0, standalone_1.format)(content, {
+        parser: 'typescript',
+        plugins: [estree_1.default, typescript_1.default],
+        ...prettier
+    });
+};
+const generatePinnable = ({ pinnableGenerators, manifest }) => {
+    const output = {};
+    Object.entries(manifest.files).forEach(([filepath, entry]) => {
+        entry.generatorKeys.forEach(generatorKey => {
+            if (!output[generatorKey]) {
+                output[generatorKey] = [];
+            }
+            output[generatorKey].push(filepath);
+        });
+    });
+    const pinnableEntries = Object.entries(output)
+        .map(([generatorKey, files]) => {
+        if (files.length !== 1) {
+            return null;
+        }
+        const isPinnable = pinnableGenerators.reduce((acc, pinnableGenerator) => {
+            if (generatorKey.startsWith(pinnableGenerator)) {
+                return true;
+            }
+            return acc;
+        }, false);
+        return isPinnable ? [generatorKey, files[0]] : null;
+    })
+        .filter((generatorKey) => generatorKey !== null);
+    return Object.fromEntries(pinnableEntries);
+};

package/script/context/Trail.d.ts

@@ -0,0 +1,26 @@
+import type { OpenAPIV3 } from 'openapi-types';
+type ConstructorArgs = {
+    path?: string[];
+    apiPath?: string;
+    method?: string;
+    schemaRef?: string;
+    document?: OpenAPIV3.Document;
+    subMethodIndex?: number;
+};
+export declare class Trail {
+    path: string[];
+    apiPath: string | undefined;
+    method: string | undefined;
+    schemaRef: string | undefined;
+    document: OpenAPIV3.Document | undefined;
+    subMethodIndex?: number;
+    constructor({ path, apiPath, method, schemaRef, document, subMethodIndex }?: ConstructorArgs);
+    add(path: string): Trail;
+    addApiPath(apiPath: string): Trail;
+    addMethod(method: string): Trail;
+    addSchemaRef(schemaRef: string): Trail;
+    toSubMethodTrail(): Trail;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=Trail.d.ts.map

package/script/context/Trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trail.d.ts","sourceRoot":"","sources":["../../src/context/Trail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,KAAK;IAChB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;gBAEX,EACV,IAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,cAAc,EACf,GAAE,eAAoB;IASvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAWxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAWlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IAWhC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAWtC,gBAAgB,IAAI,KAAK;IAWzB,QAAQ,IAAI,MAAM;CASnB"}

package/script/context/Trail.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Trail = void 0;
+class Trail {
+    constructor({ path = [], apiPath, method, schemaRef, document, subMethodIndex } = {}) {
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "apiPath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "method", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "schemaRef", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "document", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "subMethodIndex", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.path = Array.isArray(path) ? path : [path];
+        this.apiPath = apiPath;
+        this.method = method;
+        this.schemaRef = schemaRef;
+        this.document = document;
+        this.subMethodIndex = subMethodIndex;
+    }
+    add(path) {
+        return new Trail({
+            path: this.path.concat(path),
+            apiPath: this.apiPath,
+            method: this.method,
+            schemaRef: this.schemaRef,
+            document: this.document,
+            subMethodIndex: this.subMethodIndex
+        });
+    }
+    addApiPath(apiPath) {
+        return new Trail({
+            path: this.path.concat(`[${apiPath}]`),
+            apiPath,
+            method: this.method,
+            schemaRef: this.schemaRef,
+            document: this.document,
+            subMethodIndex: this.subMethodIndex
+        });
+    }
+    addMethod(method) {
+        return new Trail({
+            path: this.path.concat(method),
+            apiPath: this.apiPath,
+            method,
+            schemaRef: this.schemaRef,
+            document: this.document,
+            subMethodIndex: this.path.length + 1
+        });
+    }
+    addSchemaRef(schemaRef) {
+        return new Trail({
+            path: this.path.concat(schemaRef),
+            apiPath: this.apiPath,
+            method: this.method,
+            schemaRef,
+            document: this.document,
+            subMethodIndex: this.subMethodIndex
+        });
+    }
+    toSubMethodTrail() {
+        return new Trail({
+            path: this.path.slice(this.subMethodIndex),
+            apiPath: this.apiPath,
+            method: this.method,
+            schemaRef: this.schemaRef,
+            document: this.document,
+            subMethodIndex: 0
+        });
+    }
+    toString() {
+        return this.path.reduce((acc, path) => {
+            if (!acc) {
+                return path;
+            }
+            return path.startsWith('[') ? `${acc}${path}` : `${acc}.${path}`;
+        }, '');
+    }
+}
+exports.Trail = Trail;

package/script/context/types.d.ts

@@ -0,0 +1,19 @@
+import type { Definition } from '../dsl/Definition.js';
+import type { GeneratorKey } from '../types/GeneratorKeys.js';
+export type PhaseType = 'parse' | 'generate' | 'render';
+export type FileContents = {
+    imports: Map<string, Set<string>>;
+    definitions: Map<string, Definition>;
+    generatorKeys: Set<GeneratorKey>;
+};
+export type RenderOptions = {
+    packageJson?: boolean;
+};
+export type RenderDependencies = Map<string, Set<GeneratorKey>>;
+export type GetFileOptions = {
+    throwIfNotFound?: boolean;
+};
+export type AddGeneratorKeyArgs = {
+    generatorKey: GeneratorKey;
+};
+//# sourceMappingURL=types.d.ts.map

package/script/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAA;AAE/D,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAA"}

package/script/context/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.d.ts

@@ -0,0 +1,2 @@
+export declare function validateBinaryLike(source: unknown): Uint8Array;
+//# sourceMappingURL=_validate_binary_like.d.ts.map

package/script/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_validate_binary_like.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.ts"],"names":[],"mappings":"AAeA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAa9D"}

package/script/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.js

@@ -0,0 +1,29 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBinaryLike = validateBinaryLike;
+const encoder = new TextEncoder();
+function getTypeName(value) {
+    const type = typeof value;
+    if (type !== "object") {
+        return type;
+    }
+    else if (value === null) {
+        return "null";
+    }
+    else {
+        return value?.constructor?.name ?? "object";
+    }
+}
+function validateBinaryLike(source) {
+    if (typeof source === "string") {
+        return encoder.encode(source);
+    }
+    else if (source instanceof Uint8Array) {
+        return source;
+    }
+    else if (source instanceof ArrayBuffer) {
+        return new Uint8Array(source);
+    }
+    throw new TypeError(`The input must be a Uint8Array, a string, or an ArrayBuffer. Received a value of the type ${getTypeName(source)}.`);
+}

package/script/deps/jsr.io/@std/encoding/1.0.1/ascii85.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Supported ascii85 standards for {@linkcode EncodeAscii85Options} and
+ * {@linkcode DecodeAscii85Options}.
+ */
+export type Ascii85Standard = "Adobe" | "btoa" | "RFC 1924" | "Z85";
+/** Options for {@linkcode encodeAscii85}. */
+export interface EncodeAscii85Options {
+    /**
+     * Character set and delimiter (if supported and used).
+     *
+     * @default {"Adobe"}
+     */
+    standard?: Ascii85Standard;
+    /**
+     * Whether to use a delimiter (if supported).
+     *
+     * @default {false}
+     */
+    delimiter?: boolean;
+}
+/**
+ * Converts data into an ascii85-encoded string.
+ *
+ * @param data The data to encode.
+ * @param options Options for encoding.
+ *
+ * @returns The ascii85-encoded string.
+ *
+ * @example Usage
+ * ```ts
+ * import { encodeAscii85 } from "@std/encoding/ascii85";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(encodeAscii85("Hello world!"), "87cURD]j7BEbo80");
+ * ```
+ */
+export declare function encodeAscii85(data: ArrayBuffer | Uint8Array | string, options?: EncodeAscii85Options): string;
+/** Options for {@linkcode decodeAscii85}. */
+export type DecodeAscii85Options = Omit<EncodeAscii85Options, "delimiter">;
+/**
+ * Decodes a ascii85-encoded string.
+ *
+ * @param ascii85 The ascii85-encoded string to decode.
+ * @param options Options for decoding.
+ * @returns The decoded data.
+ *
+ * @example Usage
+ * ```ts
+ * import { decodeAscii85 } from "@std/encoding/ascii85";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(
+ *   decodeAscii85("87cURD]j7BEbo80"),
+ *   new TextEncoder().encode("Hello world!"),
+ * );
+ * ```
+ */
+export declare function decodeAscii85(ascii85: string, options?: DecodeAscii85Options): Uint8Array;
+//# sourceMappingURL=ascii85.d.ts.map

package/script/deps/jsr.io/@std/encoding/1.0.1/ascii85.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii85.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/encoding/1.0.1/ascii85.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAEpE,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,EACvC,OAAO,GAAE,oBAAyB,GACjC,MAAM,CA6DR;AAED,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,UAAU,CA4CZ"}

package/script/deps/jsr.io/@std/encoding/1.0.1/ascii85.js

@@ -0,0 +1,156 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeAscii85 = encodeAscii85;
+exports.decodeAscii85 = decodeAscii85;
+/**
+ * Utilities for working with {@link https://en.wikipedia.org/wiki/Ascii85 | ascii85} encoding.
+ *
+ * ## Specifying a standard and delimiter
+ *
+ * By default, all functions are using the most popular Adobe version of ascii85
+ * and not adding any delimiter. However, there are three more standards
+ * supported - btoa (different delimiter and additional compression of 4 bytes
+ * equal to 32), {@link https://rfc.zeromq.org/spec/32/ | Z85} and
+ * {@link https://www.rfc-editor.org/rfc/rfc1924.html | RFC 1924}. It's possible to use a
+ * different encoding by specifying it in `options` object as a second parameter.
+ *
+ * Similarly, it's possible to make `encode` add a delimiter (`<~` and `~>` for
+ * Adobe, `xbtoa Begin` and `xbtoa End` with newlines between the delimiters and
+ * encoded data for btoa. Checksums for btoa are not supported. Delimiters are not
+ * supported by other encodings.)
+ *
+ * @module
+ */
+const _validate_binary_like_js_1 = require("./_validate_binary_like.js");
+const rfc1924 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz!#$%&()*+-;<=>?@^_`{|}~";
+const Z85 = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-:+=^!/*?&<>()[]{}@%$#";
+/**
+ * Converts data into an ascii85-encoded string.
+ *
+ * @param data The data to encode.
+ * @param options Options for encoding.
+ *
+ * @returns The ascii85-encoded string.
+ *
+ * @example Usage
+ * ```ts
+ * import { encodeAscii85 } from "@std/encoding/ascii85";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(encodeAscii85("Hello world!"), "87cURD]j7BEbo80");
+ * ```
+ */
+function encodeAscii85(data, options = {}) {
+    let uint8 = (0, _validate_binary_like_js_1.validateBinaryLike)(data);
+    const { standard = "Adobe" } = options;
+    let output = [];
+    let v;
+    let n = 0;
+    let difference = 0;
+    if (uint8.length % 4 !== 0) {
+        const tmp = uint8;
+        difference = 4 - (tmp.length % 4);
+        uint8 = new Uint8Array(tmp.length + difference);
+        uint8.set(tmp);
+    }
+    const view = new DataView(uint8.buffer, uint8.byteOffset, uint8.byteLength);
+    for (let i = 0; i < uint8.length; i += 4) {
+        v = view.getUint32(i);
+        // Adobe and btoa standards compress 4 zeroes to single "z" character
+        if ((standard === "Adobe" || standard === "btoa") &&
+            v === 0 &&
+            i < uint8.length - difference - 3) {
+            output[n++] = "z";
+            continue;
+        }
+        // btoa compresses 4 spaces - that is, bytes equal to 32 - into single "y" character
+        if (standard === "btoa" && v === 538976288) {
+            output[n++] = "y";
+            continue;
+        }
+        for (let j = 4; j >= 0; j--) {
+            output[n + j] = String.fromCharCode((v % 85) + 33);
+            v = Math.trunc(v / 85);
+        }
+        n += 5;
+    }
+    switch (standard) {
+        case "Adobe":
+            if (options?.delimiter) {
+                return `<~${output.slice(0, output.length - difference).join("")}~>`;
+            }
+            break;
+        case "btoa":
+            if (options?.delimiter) {
+                return `xbtoa Begin\n${output
+                    .slice(0, output.length - difference)
+                    .join("")}\nxbtoa End`;
+            }
+            break;
+        case "RFC 1924":
+            output = output.map((val) => rfc1924[val.charCodeAt(0) - 33]);
+            break;
+        case "Z85":
+            output = output.map((val) => Z85[val.charCodeAt(0) - 33]);
+            break;
+    }
+    return output.slice(0, output.length - difference).join("");
+}
+/**
+ * Decodes a ascii85-encoded string.
+ *
+ * @param ascii85 The ascii85-encoded string to decode.
+ * @param options Options for decoding.
+ * @returns The decoded data.
+ *
+ * @example Usage
+ * ```ts
+ * import { decodeAscii85 } from "@std/encoding/ascii85";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(
+ *   decodeAscii85("87cURD]j7BEbo80"),
+ *   new TextEncoder().encode("Hello world!"),
+ * );
+ * ```
+ */
+function decodeAscii85(ascii85, options = {}) {
+    const { standard = "Adobe" } = options;
+    // translate all encodings to most basic adobe/btoa one and decompress some special characters ("z" and "y")
+    switch (standard) {
+        case "Adobe":
+            ascii85 = ascii85.replaceAll(/(<~|~>)/g, "").replaceAll("z", "!!!!!");
+            break;
+        case "btoa":
+            ascii85 = ascii85
+                .replaceAll(/(xbtoa Begin|xbtoa End|\n)/g, "")
+                .replaceAll("z", "!!!!!")
+                .replaceAll("y", "+<VdL");
+            break;
+        case "RFC 1924":
+            ascii85 = ascii85.replaceAll(/./g, (match) => String.fromCharCode(rfc1924.indexOf(match) + 33));
+            break;
+        case "Z85":
+            ascii85 = ascii85.replaceAll(/./g, (match) => String.fromCharCode(Z85.indexOf(match) + 33));
+            break;
+    }
+    // remove all invalid characters
+    ascii85 = ascii85.replaceAll(/[^!-u]/g, "");
+    const len = ascii85.length;
+    const output = new Uint8Array(len + 4 - (len % 4));
+    const view = new DataView(output.buffer);
+    let v = 0;
+    let n = 0;
+    let max = 0;
+    for (let i = 0; i < len;) {
+        for (max += 5; i < max; i++) {
+            v = v * 85 + (i < len ? ascii85.charCodeAt(i) : 117) - 33;
+        }
+        view.setUint32(n, v);
+        v = 0;
+        n += 4;
+    }
+    return output.slice(0, Math.trunc(len * 0.8));
+}