@hugoalh/adler32 0.1.0

package/LICENSE.md

@@ -0,0 +1,35 @@
+# MIT License
+
+Copyright © 2024 hugoalh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+## TLDR
+
+This is a short and simple list that mostly concluded this license about the permissions, conditions, and limitations, this license content section shall prevail.
+
+### Permissions
+
+- **Commercial Use:** The licensed material and derivatives may be used for commercial purposes.
+- **Distribution:** The licensed material may be distributed.
+- **Modification:** The licensed material may be modified.
+- **Private Use:** The licensed material may be used and modified in private.
+
+### Conditions
+
+- **License & Copyright Notice:** A copy of the license and copyright notice must be included with the licensed material.
+
+### Limitations
+
+- **Liability:** This license includes a limitation of liability.
+- **Warranty:** This license explicitly states that it does not provide any warranty.
+
+## Attribution
+
+This license is adopted from [Choose A License](https://choosealicense.com/), available at [here](https://choosealicense.com/licenses/mit).

package/README.md

@@ -0,0 +1,103 @@
+# Adler32 (ES)
+
+[**⚖️** MIT](./LICENSE.md)
+
+[![GitHub: hugoalh/adler32-es](https://img.shields.io/github/v/release/hugoalh/adler32-es?label=hugoalh/adler32-es&labelColor=181717&logo=github&logoColor=ffffff&sort=semver&style=flat "GitHub: hugoalh/adler32-es")](https://github.com/hugoalh/adler32-es)
+[![JSR: @hugoalh/adler32](https://img.shields.io/jsr/v/@hugoalh/adler32?label=@hugoalh/adler32&labelColor=F7DF1E&logo=jsr&logoColor=000000&style=flat "JSR: @hugoalh/adler32")](https://jsr.io/@hugoalh/adler32)
+[![NPM: @hugoalh/adler32](https://img.shields.io/npm/v/@hugoalh/adler32?label=@hugoalh/adler32&labelColor=CB3837&logo=npm&logoColor=ffffff&style=flat "NPM: @hugoalh/adler32")](https://www.npmjs.com/package/@hugoalh/adler32)
+
+An ES (JavaScript & TypeScript) CLI and module to get the checksum of the data with algorithm Adler32.
+
+## 🔰 Begin
+
+### 🎯 Targets
+
+|  | **Remote** | **JSR** | **NPM** |
+|:--|:--|:--|:--|
+| **[Bun](https://bun.sh/)** >= v1.1.0 | ❌ | ❓ | ✔️ |
+| **[Cloudflare Workers](https://workers.cloudflare.com/)** | ❌ | ❓ | ✔️ |
+| **[Deno](https://deno.land/)** >= v1.42.0 | ✔️ | ✔️ | ✔️ |
+| **[NodeJS](https://nodejs.org/)** >= v16.13.0 | ❌ | ❓ | ✔️ |
+
+> [!NOTE]
+> - It is possible to use this module in other methods/ways which not listed in here, however those methods/ways are not officially supported, and should beware maybe cause security issues.
+
+### #️⃣ Resources Identifier
+
+- **Remote - GitHub Raw:**
+  ```
+  https://raw.githubusercontent.com/hugoalh/adler32-es/{Tag}/mod.ts
+  ```
+- **JSR:**
+  ```
+  [jsr:]@hugoalh/adler32[@{Tag}]
+  ```
+- **NPM:**
+  ```
+  [npm:]@hugoalh/adler32[@{Tag}]
+  ```
+
+> [!NOTE]
+> - For usage of remote resources, it is recommended to import the entire module with the main path `mod.ts`, however it is also able to import part of the module with sub path if available, but do not import if:
+>
+>   - it's path has an underscore prefix (e.g.: `_foo.ts`, `_util/bar.ts`), or
+>   - it is a benchmark or test file (e.g.: `foo.bench.ts`, `foo.test.ts`), or
+>   - it's symbol has an underscore prefix (e.g.: `_bar`, `_foo`).
+>
+>   These elements are not considered part of the public API, thus no stability is guaranteed for them.
+> - For usage of JSR or NPM resources, it is recommended to import the entire module with the main entrypoint, however it is also able to import part of the module with sub entrypoint if available, please visit the [file `jsr.jsonc`](./jsr.jsonc) property `exports` for available sub entrypoints.
+> - It is recommended to use this module with tag for immutability.
+
+### 🛡️ Require Runtime Permissions
+
+*This module does not require any runtime permission.*
+
+## 🧩 APIs
+
+- ```ts
+  class Adler32 {
+    constructor(data?: Adler32AcceptDataType);
+    hash(): bigint;
+    hashBase16(): string;
+    hashBase32Hex(): string;
+    hashBase36(): string;
+    hashHex(): string;
+    hashHexPadding(): string;
+    hashNumber(): number;
+    update(data: Adler32AcceptDataType): this;
+    static fromFile(filePath: string | URL): Promise<Adler32>;
+    static fromFileSync(filePath: string | URL): Adler32;
+  }
+  ```
+- ```ts
+  type Adler32AcceptDataType = string | ArrayBuffer | BigInt64Array | BigUint64Array | Int8Array | Int16Array | Int32Array | Uint8Array | Uint16Array | Uint32Array;
+  ```
+
+> [!NOTE]
+> - For the full or prettier documentation, can visit via:
+>   - [Deno CLI `deno doc`](https://docs.deno.com/runtime/reference/cli/documentation_generator/)
+>   - [JSR](https://jsr.io/@hugoalh/adler32)
+
+## 🧩 CLIs
+
+**Entrypoint:** `cli.js`/`cli.ts`
+
+- From argument; Output hex padding
+  ```ps1
+  adler32 {Data}
+  ```
+- From file; Output hex padding
+  ```ps1
+  adler32 --file {FilePath}
+  ```
+- From stdin; Output hex padding
+  ```ps1
+  adler32 --stdin
+  ```
+
+## ✍️ Examples
+
+- ```ts
+  new Adler32("Wikipedia").hashHexPadding();
+  //=> "11E60398"
+  ```

package/_dnt.polyfills.d.ts

@@ -0,0 +1,36 @@
+declare global {
+    interface ImportMeta {
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         */
+        resolve(specifier: string): string;
+    }
+}
+export {};
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;WAOG;QAEH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;KACpC;CACF;AAED,OAAO,EAAE,CAAA;AAgBT,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}

package/_dnt.polyfills.js

@@ -0,0 +1,15 @@
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
+}
+export {};

package/_dnt.shims.d.ts

@@ -0,0 +1,12 @@
+export { Deno } from "@deno/shim-deno";
+export { alert, confirm, prompt } from "@deno/shim-prompts";
+export { setInterval, setTimeout } from "@deno/shim-timers";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno" | "alert" | "confirm" | "prompt" | "setInterval" | "setTimeout"> & {
+    Deno: any;
+    alert: any;
+    confirm: any;
+    prompt: any;
+    setInterval: any;
+    setTimeout: any;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAU5D,eAAO,MAAM,aAAa;;;;;;;CAA2C,CAAC"}

package/_dnt.shims.js

@@ -0,0 +1,70 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+import { alert, confirm, prompt } from "@deno/shim-prompts";
+export { alert, confirm, prompt } from "@deno/shim-prompts";
+import { setInterval, setTimeout } from "@deno/shim-timers";
+export { setInterval, setTimeout } from "@deno/shim-timers";
+const dntGlobals = {
+    Deno,
+    alert,
+    confirm,
+    prompt,
+    setInterval,
+    setTimeout,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "./_dnt.polyfills.js";
+//# sourceMappingURL=cli.d.ts.map

package/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC"}

package/cli.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import "./_dnt.polyfills.js";
+import * as dntShim from "./_dnt.shims.js";
+import { parseArgs } from "./deps/jsr.io/@std/cli/1.0.6/parse_args.js";
+import { Adler32 } from "./mod.js";
+if (!(import.meta.url === ("file:///" + process.argv[1].replace(/\\/g, "/")).replace(/\/{3,}/, "///"))) {
+    throw new Error(`This script is for command line usage only!`);
+}
+const args = parseArgs(dntShim.Deno.args, {
+    boolean: ["file", "stdin"],
+});
+const fromFile = args.file;
+const fromStdin = args.stdin;
+const values = args._.map((value) => {
+    return String(value);
+});
+if (fromFile && fromStdin) {
+    throw new SyntaxError(`Unable to use the sources of file and stdin together!`);
+}
+if (fromFile) {
+    if (values.length === 0) {
+        throw new SyntaxError(`File path is not defined!`);
+    }
+    if (values.length !== 1) {
+        throw new SyntaxError(`Too many arguments! Expect: 1; Current: ${values.length}.`);
+    }
+    console.log((await Adler32.fromFile(values[0])).hashHexPadding());
+}
+else if (fromStdin) {
+    if (values.length !== 0) {
+        throw new SyntaxError(`Too many arguments! Expect: 0; Current: ${values.length}.`);
+    }
+    const stdinReader = dntShim.Deno.stdin.readable.getReader();
+    const instance = new Adler32();
+    while (true) {
+        const { done, value } = await stdinReader.read();
+        if (done) {
+            break;
+        }
+        instance.update(value);
+    }
+    console.log(instance.hashHexPadding());
+}
+else {
+    if (values.length === 0) {
+        throw new SyntaxError(`Data is not defined!`);
+    }
+    if (values.length !== 1) {
+        throw new SyntaxError(`Too many arguments! Expect: 1; Current: ${values.length}.`);
+    }
+    console.log(new Adler32(values[0]).hashHexPadding());
+}

package/deps/jsr.io/@std/cli/1.0.6/parse_args.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Command line arguments parser based on
+ * {@link https://github.com/minimistjs/minimist | minimist}.
+ *
+ * @example
+ * ```ts
+ * import { parseArgs } from "@std/cli/parse-args";
+ *
+ * console.dir(parseArgs(Deno.args));
+ * ```
+ *
+ * @module
+ */
+/** Combines recursively all intersection types and returns a new single type.
+ * @internal
+ */
+type Id<TRecord> = TRecord extends Record<string, unknown> ? TRecord extends infer InferredRecord ? {
+    [Key in keyof InferredRecord]: Id<InferredRecord[Key]>;
+} : never : TRecord;
+/** Converts a union type `A | B | C` into an intersection type `A & B & C`.
+ * @internal
+ */
+type UnionToIntersection<TValue> = (TValue extends unknown ? (args: TValue) => unknown : never) extends (args: infer R) => unknown ? R extends Record<string, unknown> ? R : never : never;
+/** @internal */
+type BooleanType = boolean | string | undefined;
+/** @internal */
+type StringType = string | undefined;
+/** @internal */
+type ArgType = StringType | BooleanType;
+/** @internal */
+type Collectable = string | undefined;
+/** @internal */
+type Negatable = string | undefined;
+type UseTypes<TBooleans extends BooleanType, TStrings extends StringType, TCollectable extends Collectable> = undefined extends ((false extends TBooleans ? undefined : TBooleans) & TCollectable & TStrings) ? false : true;
+/**
+ * Creates a record with all available flags with the corresponding type and
+ * default type.
+ * @internal
+ */
+type Values<TBooleans extends BooleanType, TStrings extends StringType, TCollectable extends Collectable, TNegatable extends Negatable, TDefault extends Record<string, unknown> | undefined, TAliases extends Aliases | undefined> = UseTypes<TBooleans, TStrings, TCollectable> extends true ? Record<string, unknown> & AddAliases<SpreadDefaults<CollectValues<TStrings, string, TCollectable, TNegatable> & RecursiveRequired<CollectValues<TBooleans, boolean, TCollectable>> & CollectUnknownValues<TBooleans, TStrings, TCollectable, TNegatable>, DedotRecord<TDefault>>, TAliases> : Record<string, any>;
+/** @internal */
+type Aliases<TArgNames = string, TAliasNames extends string = string> = Partial<Record<Extract<TArgNames, string>, TAliasNames | ReadonlyArray<TAliasNames>>>;
+type AddAliases<TArgs, TAliases extends Aliases | undefined> = {
+    [TArgName in keyof TArgs as AliasNames<TArgName, TAliases>]: TArgs[TArgName];
+};
+type AliasNames<TArgName, TAliases extends Aliases | undefined> = TArgName extends keyof TAliases ? string extends TAliases[TArgName] ? TArgName : TAliases[TArgName] extends string ? TArgName | TAliases[TArgName] : TAliases[TArgName] extends Array<string> ? TArgName | TAliases[TArgName][number] : TArgName : TArgName;
+/**
+ * Spreads all default values of Record `TDefaults` into Record `TArgs`
+ * and makes default values required.
+ *
+ * **Example:**
+ * `SpreadValues<{ foo?: boolean, bar?: number }, { foo: number }>`
+ *
+ * **Result:** `{ foo: boolean | number, bar?: number }`
+ */
+type SpreadDefaults<TArgs, TDefaults> = TDefaults extends undefined ? TArgs : TArgs extends Record<string, unknown> ? Omit<TArgs, keyof TDefaults> & {
+    [Default in keyof TDefaults]: Default extends keyof TArgs ? (TArgs[Default] & TDefaults[Default] | TDefaults[Default]) extends Record<string, unknown> ? NonNullable<SpreadDefaults<TArgs[Default], TDefaults[Default]>> : TDefaults[Default] | NonNullable<TArgs[Default]> : unknown;
+} : never;
+/**
+ * Defines the Record for the `default` option to add
+ * auto-suggestion support for IDE's.
+ * @internal
+ */
+type Defaults<TBooleans extends BooleanType, TStrings extends StringType> = Id<UnionToIntersection<Record<string, unknown> & MapTypes<TStrings, unknown> & MapTypes<TBooleans, unknown> & MapDefaults<TBooleans> & MapDefaults<TStrings>>>;
+type MapDefaults<TArgNames extends ArgType> = Partial<Record<TArgNames extends string ? TArgNames : string, unknown>>;
+type RecursiveRequired<TRecord> = TRecord extends Record<string, unknown> ? {
+    [Key in keyof TRecord]-?: RecursiveRequired<TRecord[Key]>;
+} : TRecord;
+/** Same as `MapTypes` but also supports collectable options. */
+type CollectValues<TArgNames extends ArgType, TType, TCollectable extends Collectable, TNegatable extends Negatable = undefined> = UnionToIntersection<Extract<TArgNames, TCollectable> extends string ? (Exclude<TArgNames, TCollectable> extends never ? Record<never, never> : MapTypes<Exclude<TArgNames, TCollectable>, TType, TNegatable>) & (Extract<TArgNames, TCollectable> extends never ? Record<never, never> : RecursiveRequired<MapTypes<Extract<TArgNames, TCollectable>, Array<TType>, TNegatable>>) : MapTypes<TArgNames, TType, TNegatable>>;
+/** Same as `Record` but also supports dotted and negatable options. */
+type MapTypes<TArgNames extends ArgType, TType, TNegatable extends Negatable = undefined> = undefined extends TArgNames ? Record<never, never> : TArgNames extends `${infer Name}.${infer Rest}` ? {
+    [Key in Name]?: MapTypes<Rest, TType, TNegatable extends `${Name}.${infer Negate}` ? Negate : undefined>;
+} : TArgNames extends string ? Partial<Record<TArgNames, TNegatable extends TArgNames ? TType | false : TType>> : Record<never, never>;
+type CollectUnknownValues<TBooleans extends BooleanType, TStrings extends StringType, TCollectable extends Collectable, TNegatable extends Negatable> = UnionToIntersection<TCollectable extends TBooleans & TStrings ? Record<never, never> : DedotRecord<Record<Exclude<Extract<Exclude<TCollectable, TNegatable>, string>, Extract<TStrings | TBooleans, string>>, Array<unknown>> & Record<Exclude<Extract<Extract<TCollectable, TNegatable>, string>, Extract<TStrings | TBooleans, string>>, Array<unknown> | false>>>;
+/** Converts `{ "foo.bar.baz": unknown }` into `{ foo: { bar: { baz: unknown } } }`. */
+type DedotRecord<TRecord> = Record<string, unknown> extends TRecord ? TRecord : TRecord extends Record<string, unknown> ? UnionToIntersection<ValueOf<{
+    [Key in keyof TRecord]: Key extends string ? Dedot<Key, TRecord[Key]> : never;
+}>> : TRecord;
+type Dedot<TKey extends string, TValue> = TKey extends `${infer Name}.${infer Rest}` ? {
+    [Key in Name]: Dedot<Rest, TValue>;
+} : {
+    [Key in TKey]: TValue;
+};
+type ValueOf<TValue> = TValue[keyof TValue];
+/** The value returned from {@linkcode parseArgs}. */
+export type Args<TArgs extends Record<string, unknown> = Record<string, any>, TDoubleDash extends boolean | undefined = undefined> = Id<TArgs & {
+    /** Contains all the arguments that didn't have an option associated with
+     * them. */
+    _: Array<string | number>;
+} & (boolean extends TDoubleDash ? DoubleDash : true extends TDoubleDash ? Required<DoubleDash> : Record<never, never>)>;
+/** @internal */
+type DoubleDash = {
+    /** Contains all the arguments that appear after the double dash: "--". */
+    "--"?: Array<string>;
+};
+/** Options for {@linkcode parseArgs}. */
+export interface ParseOptions<TBooleans extends BooleanType = BooleanType, TStrings extends StringType = StringType, TCollectable extends Collectable = Collectable, TNegatable extends Negatable = Negatable, TDefault extends Record<string, unknown> | undefined = Record<string, unknown> | undefined, TAliases extends Aliases | undefined = Aliases | undefined, TDoubleDash extends boolean | undefined = boolean | undefined> {
+    /**
+     * When `true`, populate the result `_` with everything before the `--` and
+     * the result `['--']` with everything after the `--`.
+     *
+     * @default {false}
+     *
+     *  @example
+     * ```ts
+     * // $ deno run example.ts -- a arg1
+     * import { parseArgs } from "@std/cli/parse-args";
+     * console.dir(parseArgs(Deno.args, { "--": false }));
+     * // output: { _: [ "a", "arg1" ] }
+     * console.dir(parseArgs(Deno.args, { "--": true }));
+     * // output: { _: [], --: [ "a", "arg1" ] }
+     * ```
+     */
+    "--"?: TDoubleDash;
+    /**
+     * An object mapping string names to strings or arrays of string argument
+     * names to use as aliases.
+     *
+     * @default {{}}
+     */
+    alias?: TAliases;
+    /**
+     * A boolean, string or array of strings to always treat as booleans. If
+     * `true` will treat all double hyphenated arguments without equal signs as
+     * `boolean` (e.g. affects `--foo`, not `-f` or `--foo=bar`).
+     *  All `boolean` arguments will be set to `false` by default.
+     *
+     * @default {false}
+     */
+    boolean?: TBooleans | ReadonlyArray<Extract<TBooleans, string>>;
+    /**
+     * An object mapping string argument names to default values.
+     *
+     * @default {{}}
+     */
+    default?: TDefault & Defaults<TBooleans, TStrings>;
+    /**
+     * When `true`, populate the result `_` with everything after the first
+     * non-option.
+     *
+     * @default {false}
+     */
+    stopEarly?: boolean;
+    /**
+     * A string or array of strings argument names to always treat as strings.
+     *
+     * @default {[]}
+     */
+    string?: TStrings | ReadonlyArray<Extract<TStrings, string>>;
+    /**
+     * A string or array of strings argument names to always treat as arrays.
+     * Collectable options can be used multiple times. All values will be
+     * collected into one array. If a non-collectable option is used multiple
+     * times, the last value is used.
+     *
+     * @default {[]}
+     */
+    collect?: TCollectable | ReadonlyArray<Extract<TCollectable, string>>;
+    /**
+     * A string or array of strings argument names which can be negated
+     * by prefixing them with `--no-`, like `--no-config`.
+     *
+     * @default {[]}
+     */
+    negatable?: TNegatable | ReadonlyArray<Extract<TNegatable, string>>;
+    /**
+     * A function which is invoked with a command line parameter not defined in
+     * the `options` configuration object. If the function returns `false`, the
+     * unknown option is not added to `parsedArgs`.
+     *
+     * @default {unknown}
+     */
+    unknown?: (arg: string, key?: string, value?: unknown) => unknown;
+}
+/**
+ * Take a set of command line arguments, optionally with a set of options, and
+ * return an object representing the flags found in the passed arguments.
+ *
+ * By default, any arguments starting with `-` or `--` are considered boolean
+ * flags. If the argument name is followed by an equal sign (`=`) it is
+ * considered a key-value pair. Any arguments which could not be parsed are
+ * available in the `_` property of the returned object.
+ *
+ * By default, this module tries to determine the type of all arguments
+ * automatically and the return type of this function will have an index
+ * signature with `any` as value (`{ [x: string]: any }`).
+ *
+ * If the `string`, `boolean` or `collect` option is set, the return value of
+ * this function will be fully typed and the index signature of the return
+ * type will change to `{ [x: string]: unknown }`.
+ *
+ * Any arguments after `'--'` will not be parsed and will end up in `parsedArgs._`.
+ *
+ * Numeric-looking arguments will be returned as numbers unless `options.string`
+ * or `options.boolean` is set for that argument name.
+ *
+ * @param args An array of command line arguments.
+ * @param options Options for the parse function.
+ *
+ * @typeParam TArgs Type of result.
+ * @typeParam TDoubleDash Used by `TArgs` for the result.
+ * @typeParam TBooleans Used by `TArgs` for the result.
+ * @typeParam TStrings Used by `TArgs` for the result.
+ * @typeParam TCollectable Used by `TArgs` for the result.
+ * @typeParam TNegatable Used by `TArgs` for the result.
+ * @typeParam TDefaults Used by `TArgs` for the result.
+ * @typeParam TAliases Used by `TArgs` for the result.
+ * @typeParam TAliasArgNames Used by `TArgs` for the result.
+ * @typeParam TAliasNames Used by `TArgs` for the result.
+ *
+ * @return The parsed arguments.
+ *
+ * @example Usage
+ * ```ts
+ * import { parseArgs } from "@std/cli/parse-args";
+ * import { assertEquals } from "@std/assert";
+ *
+ * // For proper use, one should use `parseArgs(Deno.args)`
+ * assertEquals(parseArgs(["--foo", "--bar=baz", "./quux.txt"]), {
+ *   foo: true,
+ *   bar: "baz",
+ *   _: ["./quux.txt"],
+ * });
+ * ```
+ */
+export declare function parseArgs<TArgs extends Values<TBooleans, TStrings, TCollectable, TNegatable, TDefaults, TAliases>, TDoubleDash extends boolean | undefined = undefined, TBooleans extends BooleanType = undefined, TStrings extends StringType = undefined, TCollectable extends Collectable = undefined, TNegatable extends Negatable = undefined, TDefaults extends Record<string, unknown> | undefined = undefined, TAliases extends Aliases<TAliasArgNames, TAliasNames> | undefined = undefined, TAliasArgNames extends string = string, TAliasNames extends string = string>(args: string[], options?: ParseOptions<TBooleans, TStrings, TCollectable, TNegatable, TDefaults, TAliases, TDoubleDash>): Args<TArgs, TDoubleDash>;
+export {};
+//# sourceMappingURL=parse_args.d.ts.map

package/deps/jsr.io/@std/cli/1.0.6/parse_args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/cli/1.0.6/parse_args.ts"],"names":[],"mappings":"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"}

package/deps/jsr.io/@std/cli/1.0.6/parse_args.js

@@ -0,0 +1,305 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+const FLAG_REGEXP = /^(?:-(?:(?<doubleDash>-)(?<negated>no-)?)?)(?<key>.+?)(?:=(?<value>.+?))?$/s;
+const LETTER_REGEXP = /[A-Za-z]/;
+const NUMBER_REGEXP = /-?\d+(\.\d*)?(e-?\d+)?$/;
+const HYPHEN_REGEXP = /^(-|--)[^-]/;
+const VALUE_REGEXP = /=(?<value>.+)/;
+const FLAG_NAME_REGEXP = /^--[^=]+$/;
+const SPECIAL_CHAR_REGEXP = /\W/;
+const NON_WHITESPACE_REGEXP = /\S/;
+function isNumber(string) {
+    return NON_WHITESPACE_REGEXP.test(string) && Number.isFinite(Number(string));
+}
+function setNested(object, keys, value, collect = false) {
+    keys = [...keys];
+    const key = keys.pop();
+    keys.forEach((key) => object = (object[key] ??= {}));
+    if (collect) {
+        const v = object[key];
+        if (Array.isArray(v)) {
+            v.push(value);
+            return;
+        }
+        value = v ? [v, value] : [value];
+    }
+    object[key] = value;
+}
+function hasNested(object, keys) {
+    for (const key of keys) {
+        const value = object[key];
+        if (!Object.hasOwn(object, key))
+            return false;
+        object = value;
+    }
+    return true;
+}
+function aliasIsBoolean(aliasMap, booleanSet, key) {
+    const set = aliasMap.get(key);
+    if (set === undefined)
+        return false;
+    for (const alias of set)
+        if (booleanSet.has(alias))
+            return true;
+    return false;
+}
+function isBooleanString(value) {
+    return value === "true" || value === "false";
+}
+function parseBooleanString(value) {
+    return value !== "false";
+}
+/**
+ * Take a set of command line arguments, optionally with a set of options, and
+ * return an object representing the flags found in the passed arguments.
+ *
+ * By default, any arguments starting with `-` or `--` are considered boolean
+ * flags. If the argument name is followed by an equal sign (`=`) it is
+ * considered a key-value pair. Any arguments which could not be parsed are
+ * available in the `_` property of the returned object.
+ *
+ * By default, this module tries to determine the type of all arguments
+ * automatically and the return type of this function will have an index
+ * signature with `any` as value (`{ [x: string]: any }`).
+ *
+ * If the `string`, `boolean` or `collect` option is set, the return value of
+ * this function will be fully typed and the index signature of the return
+ * type will change to `{ [x: string]: unknown }`.
+ *
+ * Any arguments after `'--'` will not be parsed and will end up in `parsedArgs._`.
+ *
+ * Numeric-looking arguments will be returned as numbers unless `options.string`
+ * or `options.boolean` is set for that argument name.
+ *
+ * @param args An array of command line arguments.
+ * @param options Options for the parse function.
+ *
+ * @typeParam TArgs Type of result.
+ * @typeParam TDoubleDash Used by `TArgs` for the result.
+ * @typeParam TBooleans Used by `TArgs` for the result.
+ * @typeParam TStrings Used by `TArgs` for the result.
+ * @typeParam TCollectable Used by `TArgs` for the result.
+ * @typeParam TNegatable Used by `TArgs` for the result.
+ * @typeParam TDefaults Used by `TArgs` for the result.
+ * @typeParam TAliases Used by `TArgs` for the result.
+ * @typeParam TAliasArgNames Used by `TArgs` for the result.
+ * @typeParam TAliasNames Used by `TArgs` for the result.
+ *
+ * @return The parsed arguments.
+ *
+ * @example Usage
+ * ```ts
+ * import { parseArgs } from "@std/cli/parse-args";
+ * import { assertEquals } from "@std/assert";
+ *
+ * // For proper use, one should use `parseArgs(Deno.args)`
+ * assertEquals(parseArgs(["--foo", "--bar=baz", "./quux.txt"]), {
+ *   foo: true,
+ *   bar: "baz",
+ *   _: ["./quux.txt"],
+ * });
+ * ```
+ */
+export function parseArgs(args, options) {
+    const { "--": doubleDash = false, alias = {}, boolean = false, default: defaults = {}, stopEarly = false, string = [], collect = [], negatable = [], unknown: unknownFn = (i) => i, } = options ?? {};
+    const aliasMap = new Map();
+    const booleanSet = new Set();
+    const stringSet = new Set();
+    const collectSet = new Set();
+    const negatableSet = new Set();
+    let allBools = false;
+    if (alias) {
+        for (const [key, value] of Object.entries(alias)) {
+            if (value === undefined) {
+                throw new TypeError("Alias value must be defined");
+            }
+            const aliases = Array.isArray(value) ? value : [value];
+            aliasMap.set(key, new Set(aliases));
+            aliases.forEach((alias) => aliasMap.set(alias, new Set([key, ...aliases.filter((it) => it !== alias)])));
+        }
+    }
+    if (boolean) {
+        if (typeof boolean === "boolean") {
+            allBools = boolean;
+        }
+        else {
+            const booleanArgs = Array.isArray(boolean) ? boolean : [boolean];
+            for (const key of booleanArgs.filter(Boolean)) {
+                booleanSet.add(key);
+                aliasMap.get(key)?.forEach((al) => {
+                    booleanSet.add(al);
+                });
+            }
+        }
+    }
+    if (string) {
+        const stringArgs = Array.isArray(string) ? string : [string];
+        for (const key of stringArgs.filter(Boolean)) {
+            stringSet.add(key);
+            aliasMap.get(key)?.forEach((al) => stringSet.add(al));
+        }
+    }
+    if (collect) {
+        const collectArgs = Array.isArray(collect) ? collect : [collect];
+        for (const key of collectArgs.filter(Boolean)) {
+            collectSet.add(key);
+            aliasMap.get(key)?.forEach((al) => collectSet.add(al));
+        }
+    }
+    if (negatable) {
+        const negatableArgs = Array.isArray(negatable) ? negatable : [negatable];
+        for (const key of negatableArgs.filter(Boolean)) {
+            negatableSet.add(key);
+            aliasMap.get(key)?.forEach((alias) => negatableSet.add(alias));
+        }
+    }
+    const argv = { _: [] };
+    function setArgument(key, value, arg, collect) {
+        if (!booleanSet.has(key) &&
+            !stringSet.has(key) &&
+            !aliasMap.has(key) &&
+            !(allBools && FLAG_NAME_REGEXP.test(arg)) &&
+            unknownFn?.(arg, key, value) === false) {
+            return;
+        }
+        if (typeof value === "string" && !stringSet.has(key)) {
+            value = isNumber(value) ? Number(value) : value;
+        }
+        const collectable = collect && collectSet.has(key);
+        setNested(argv, key.split("."), value, collectable);
+        aliasMap.get(key)?.forEach((key) => {
+            setNested(argv, key.split("."), value, collectable);
+        });
+    }
+    let notFlags = [];
+    // all args after "--" are not parsed
+    const index = args.indexOf("--");
+    if (index !== -1) {
+        notFlags = args.slice(index + 1);
+        args = args.slice(0, index);
+    }
+    argsLoop: for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const groups = arg.match(FLAG_REGEXP)?.groups;
+        if (groups) {
+            const { doubleDash, negated } = groups;
+            let key = groups.key;
+            let value = groups.value;
+            if (doubleDash) {
+                if (value) {
+                    if (booleanSet.has(key))
+                        value = parseBooleanString(value);
+                    setArgument(key, value, arg, true);
+                    continue;
+                }
+                if (negated) {
+                    if (negatableSet.has(key)) {
+                        setArgument(key, false, arg, false);
+                        continue;
+                    }
+                    key = `no-${key}`;
+                }
+                const next = args[i + 1];
+                if (next) {
+                    if (!booleanSet.has(key) &&
+                        !allBools &&
+                        !next.startsWith("-") &&
+                        (!aliasMap.has(key) || !aliasIsBoolean(aliasMap, booleanSet, key))) {
+                        value = next;
+                        i++;
+                        setArgument(key, value, arg, true);
+                        continue;
+                    }
+                    if (isBooleanString(next)) {
+                        value = parseBooleanString(next);
+                        i++;
+                        setArgument(key, value, arg, true);
+                        continue;
+                    }
+                }
+                value = stringSet.has(key) ? "" : true;
+                setArgument(key, value, arg, true);
+                continue;
+            }
+            const letters = arg.slice(1, -1).split("");
+            for (const [j, letter] of letters.entries()) {
+                const next = arg.slice(j + 2);
+                if (next === "-") {
+                    setArgument(letter, next, arg, true);
+                    continue;
+                }
+                if (LETTER_REGEXP.test(letter)) {
+                    const groups = VALUE_REGEXP.exec(next)?.groups;
+                    if (groups) {
+                        setArgument(letter, groups.value, arg, true);
+                        continue argsLoop;
+                    }
+                    if (NUMBER_REGEXP.test(next)) {
+                        setArgument(letter, next, arg, true);
+                        continue argsLoop;
+                    }
+                }
+                if (letters[j + 1]?.match(SPECIAL_CHAR_REGEXP)) {
+                    setArgument(letter, arg.slice(j + 2), arg, true);
+                    continue argsLoop;
+                }
+                setArgument(letter, stringSet.has(letter) ? "" : true, arg, true);
+            }
+            key = arg.slice(-1);
+            if (key === "-")
+                continue;
+            const nextArg = args[i + 1];
+            if (nextArg) {
+                if (!HYPHEN_REGEXP.test(nextArg) &&
+                    !booleanSet.has(key) &&
+                    (!aliasMap.has(key) || !aliasIsBoolean(aliasMap, booleanSet, key))) {
+                    setArgument(key, nextArg, arg, true);
+                    i++;
+                    continue;
+                }
+                if (isBooleanString(nextArg)) {
+                    const value = parseBooleanString(nextArg);
+                    setArgument(key, value, arg, true);
+                    i++;
+                    continue;
+                }
+            }
+            setArgument(key, stringSet.has(key) ? "" : true, arg, true);
+            continue;
+        }
+        if (unknownFn?.(arg) !== false) {
+            argv._.push(stringSet.has("_") || !isNumber(arg) ? arg : Number(arg));
+        }
+        if (stopEarly) {
+            argv._.push(...args.slice(i + 1));
+            break;
+        }
+    }
+    for (const [key, value] of Object.entries(defaults)) {
+        const keys = key.split(".");
+        if (!hasNested(argv, keys)) {
+            setNested(argv, keys, value);
+            aliasMap.get(key)?.forEach((key) => setNested(argv, key.split("."), value));
+        }
+    }
+    for (const key of booleanSet.keys()) {
+        const keys = key.split(".");
+        if (!hasNested(argv, keys)) {
+            const value = collectSet.has(key) ? [] : false;
+            setNested(argv, keys, value);
+        }
+    }
+    for (const key of stringSet.keys()) {
+        const keys = key.split(".");
+        if (!hasNested(argv, keys) && collectSet.has(key)) {
+            setNested(argv, keys, []);
+        }
+    }
+    if (doubleDash) {
+        argv["--"] = notFlags;
+    }
+    else {
+        argv._.push(...notFlags);
+    }
+    return argv;
+}

package/mod.d.ts

@@ -0,0 +1,68 @@
+import "./_dnt.polyfills.js";
+export type Adler32AcceptDataType = string | ArrayBuffer | BigInt64Array | BigUint64Array | Int8Array | Int16Array | Int32Array | Uint8Array | Uint16Array | Uint32Array;
+/**
+ * Get the checksum of the data with algorithm Adler32.
+ */
+export declare class Adler32 {
+    #private;
+    /**
+     * Initialize.
+     * @param {Adler32AcceptDataType} [data] Data. Can append later via the method {@linkcode Adler32.update}.
+     */
+    constructor(data?: Adler32AcceptDataType);
+    /**
+     * Get the checksum of the data, in big integer.
+     * @returns {bigint}
+     */
+    hash(): bigint;
+    /**
+     * Get the checksum of the data, in Base16.
+     * @returns {string}
+     */
+    hashBase16(): string;
+    /**
+     * Get the checksum of the data, in Base32Hex ({@link https://datatracker.ietf.org/doc/html/rfc4648#section-7 RFC 4648 §7}).
+     * @returns {string}
+     */
+    hashBase32Hex(): string;
+    /**
+     * Get the checksum of the data, in Base36.
+     * @returns {string}
+     */
+    hashBase36(): string;
+    /**
+     * Get the checksum of the data, in hex/hexadecimal without padding.
+     * @returns {string}
+     */
+    hashHex(): string;
+    /**
+     * Get the checksum of the data, in hex/hexadecimal with padding.
+     * @returns {string}
+     */
+    hashHexPadding(): string;
+    /**
+     * Get the checksum of the data, in number.
+     * @returns {number}
+     */
+    hashNumber(): number;
+    /**
+     * Append data.
+     * @param {Adler32AcceptDataType} data Data.
+     * @returns {this}
+     */
+    update(data: Adler32AcceptDataType): this;
+    /**
+     * Initialize from file, asynchronously.
+     * @param {string | URL} filePath Path of the file.
+     * @returns {Promise<Adler32>}
+     */
+    static fromFile(filePath: string | URL): Promise<Adler32>;
+    /**
+     * Initialize from file, synchronously.
+     * @param {string | URL} filePath Path of the file.
+     * @returns {Adler32}
+     */
+    static fromFileSync(filePath: string | URL): Adler32;
+}
+export default Adler32;
+//# sourceMappingURL=mod.d.ts.map

package/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AACzK;;GAEG;AACH,qBAAa,OAAO;;IAInB;;;OAGG;gBACS,IAAI,CAAC,EAAE,qBAAqB;IAKxC;;;OAGG;IACH,IAAI,IAAI,MAAM;IAMd;;;OAGG;IACH,UAAU,IAAI,MAAM;IAGpB;;;OAGG;IACH,aAAa,IAAI,MAAM;IAGvB;;;OAGG;IACH,UAAU,IAAI,MAAM;IAGpB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAGjB;;;OAGG;IACH,cAAc,IAAI,MAAM;IAGxB;;;OAGG;IACH,UAAU,IAAI,MAAM;IAGpB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAQzC;;;;OAIG;WACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAG/D;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO;CAGpD;AACD,eAAe,OAAO,CAAC"}

package/mod.js

@@ -0,0 +1,101 @@
+import "./_dnt.polyfills.js";
+import * as dntShim from "./_dnt.shims.js";
+/**
+ * Get the checksum of the data with algorithm Adler32.
+ */
+export class Adler32 {
+    #a = 1n;
+    #b = 0n;
+    #hash = null;
+    /**
+     * Initialize.
+     * @param {Adler32AcceptDataType} [data] Data. Can append later via the method {@linkcode Adler32.update}.
+     */
+    constructor(data) {
+        if (typeof data !== "undefined") {
+            this.update(data);
+        }
+    }
+    /**
+     * Get the checksum of the data, in big integer.
+     * @returns {bigint}
+     */
+    hash() {
+        if (this.#hash === null) {
+            this.#hash = (this.#b % 65521n) * 65536n + this.#a % 65521n;
+        }
+        return this.#hash;
+    }
+    /**
+     * Get the checksum of the data, in Base16.
+     * @returns {string}
+     */
+    hashBase16() {
+        return this.hashNumber().toString(16).toUpperCase();
+    }
+    /**
+     * Get the checksum of the data, in Base32Hex ({@link https://datatracker.ietf.org/doc/html/rfc4648#section-7 RFC 4648 §7}).
+     * @returns {string}
+     */
+    hashBase32Hex() {
+        return this.hashNumber().toString(32).toUpperCase();
+    }
+    /**
+     * Get the checksum of the data, in Base36.
+     * @returns {string}
+     */
+    hashBase36() {
+        return this.hashNumber().toString(36).toUpperCase();
+    }
+    /**
+     * Get the checksum of the data, in hex/hexadecimal without padding.
+     * @returns {string}
+     */
+    hashHex() {
+        return this.hashBase16();
+    }
+    /**
+     * Get the checksum of the data, in hex/hexadecimal with padding.
+     * @returns {string}
+     */
+    hashHexPadding() {
+        return this.hashHex().padStart(8, "0");
+    }
+    /**
+     * Get the checksum of the data, in number.
+     * @returns {number}
+     */
+    hashNumber() {
+        return Number(this.hash());
+    }
+    /**
+     * Append data.
+     * @param {Adler32AcceptDataType} data Data.
+     * @returns {this}
+     */
+    update(data) {
+        this.#hash = null;
+        for (const byte of new Uint32Array((typeof data === "string") ? new TextEncoder().encode(data) : data)) {
+            this.#a += BigInt(byte);
+            this.#b += this.#a;
+        }
+        return this;
+    }
+    /**
+     * Initialize from file, asynchronously.
+     * @param {string | URL} filePath Path of the file.
+     * @returns {Promise<Adler32>}
+     */
+    static async fromFile(filePath) {
+        return new Adler32(await dntShim.Deno.readFile(filePath));
+    }
+    /**
+     * Initialize from file, synchronously.
+     * @param {string | URL} filePath Path of the file.
+     * @returns {Adler32}
+     */
+    static fromFileSync(filePath) {
+        return new Adler32(dntShim.Deno.readFileSync(filePath));
+    }
+}
+export default Adler32;

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@hugoalh/adler32",
+	"version": "0.1.0",
+	"description": "A CLI and module to get the checksum of the data with algorithm Adler32.",
+	"keywords": [
+		"adler32"
+	],
+	"homepage": "https://github.com/hugoalh/adler32-es#readme",
+	"bugs": {
+		"url": "https://github.com/hugoalh/adler32-es/issues"
+	},
+	"license": "MIT",
+	"author": "hugoalh",
+	"type": "module",
+	"bin": {
+		"adler32": "./cli.js"
+	},
+	"main": "./mod.js",
+	"module": "./mod.js",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./mod.d.ts",
+				"default": "./mod.js"
+			}
+		}
+	},
+	"types": "./mod.d.ts",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/hugoalh/adler32-es.git"
+	},
+	"scripts": {},
+	"dependencies": {
+		"@deno/shim-deno": "~0.18.0",
+		"@deno/shim-prompts": "~0.1.0",
+		"@deno/shim-timers": "~0.1.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.9.0"
+	},
+	"engines": {
+		"node": ">=16.13.0"
+	},
+	"private": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"_generatedBy": "dnt@dev"
+}