@nberlette/utf8 0.2.0

package/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright © 2024+ Nicholas Berlette. All rights reserved.
+
+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.

package/README.md

@@ -0,0 +1,298 @@
+<div align="center">
+
+# [`@nick/utf8`]
+
+##### Blazing fast ponyfills for `TextEncoder`, `TextDecoder`, and more.
+
+</div>
+
+---
+
+## Overview
+
+This package provides a set of high performance [ponyfill]s for `TextEncoder`
+and `TextDecoder`. They're dependency-free and platform-agnostic, suitable for
+use in any ES2015+ environment.
+
+- [`TextEncoder`](#textencoder)
+- [`TextDecoder`](#textdecoder)
+- [`TextEncoderStream`](#textencoderstream)[^1]
+- [`TextDecoderStream`](#textdecoderstream)[^1]
+
+[^1]: Requires the `TransformStream` API to be available in the environment.
+
+---
+
+## Install
+
+<picture align="left" width="32" height="48">
+  <source media="(prefers-color-scheme: dark)" srcset="https://api.iconify.design/simple-icons:deno.svg?height=2.75rem&width=3rem&color=%23fff" />
+  <img align="left" src="https://api.iconify.design/simple-icons:deno.svg?height=2.75rem&width=3rem" alt="Deno" width="32" height="48" />
+</picture>
+
+```sh
+deno add @nick/utf8
+```
+
+<img align="left" src="https://api.iconify.design/simple-icons:jsr.svg?color=%23fc0" alt="JSR" width="32" height="48" />
+
+```sh
+npx jsr add @nick/utf8
+```
+
+<img align="left" src="https://api.iconify.design/logos:bun.svg" alt="Bun" width="32" height="48" />
+
+```sh
+bunx jsr add @nick/utf8
+```
+
+<img align="left" src="https://api.iconify.design/devicon:pnpm.svg?height=2.5rem&width=2.5rem&inline=true" alt="PNPM" width="32" height="48" />
+
+```sh
+pnpm dlx jsr add @nick/utf8
+```
+
+<img align="left" src="https://api.iconify.design/logos:yarn.svg?height=2rem&width=2rem&inline=true" alt="Yarn" width="32" height="48" />
+
+```sh
+yarn add @nick/utf8
+```
+
+<br>
+
+**Mirrored on NPM as `@nberlette/utf8`**:
+
+<img align="left" src="https://api.iconify.design/logos:npm.svg?height=2rem&width=2rem&inline=true" alt="NPM" width="32" height="48" />
+
+```sh
+npm install @nberlette/utf8
+```
+
+---
+
+## Usage
+
+```ts
+import { TextDecoder, TextEncoder } from "@nick/utf8";
+
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+
+const encoded = encoder.encode("Hello, World!");
+const decoded = decoder.decode(encoded);
+
+console.log(decoded); // Hello, World!
+```
+
+---
+
+## API
+
+### `TextEncoder`
+
+The `TextEncoder` class encodes strings into UTF-8 byte sequences.
+
+#### `encode(input?: string)`
+
+Encodes the given `input` into a new `Uint8Array`.
+
+**Returns**: a new `Uint8Array` containing the encoded bytes.
+
+```ts
+import { TextEncoder } from "@nick/utf8";
+
+const encoder = new TextEncoder();
+const encoded = encoder.encode("Hello, World!");
+console.log(encoded); // Uint8Array([...])
+```
+
+#### `encodeInto(input: string, output: Uint8Array)`
+
+Encodes an `input` string into an existing `Uint8Array` output buffer.
+
+**Returns**: the number of characters read and bytes written.
+
+```ts
+import { TextEncoder } from "@nick/utf8";
+
+const encoder = new TextEncoder();
+const output = new Uint8Array(16);
+const input = "Hello, my name is Nick!"; // 23 characters
+const { read, written } = encoder.encodeInto(input, output);
+```
+
+<br /><div align="center">·<b>·</b>•<b>•</b>•<b>·</b>·</div>
+
+### `TextDecoder`
+
+The `TextDecoder` class decodes UTF-8 byte sequences into strings.
+
+#### `decode(input?: BufferSource, options?: TextDecodeOptions)`
+
+Decodes UTF-8 bytes from the given `BufferSource` into a string.
+
+```ts
+import { TextDecoder } from "@nick/utf8";
+
+const decoder = new TextDecoder();
+const encoded = new Uint8Array([72, 101, 108, 108, 111, 33]);
+const decoded = decoder.decode(encoded);
+console.log(decoded); // Hello!
+```
+
+<br /><div align="center">·<b>·</b>•<b>•</b>•<b>·</b>·</div>
+
+### `TextEncoderStream`
+
+Provides a full-duplex UTF-8 encoding stream, allowing strings to be written to
+its writable side, and the encoded bytes to be read from its readable side.
+
+> **Note**: Requires `TransformStream` to be available in the environment.
+
+#### Usage
+
+```ts ignore
+import { TextEncoderStream } from "@nick/utf8";
+
+const chunks = ["Hello", ", ", "World!", "\n"];
+
+// encode the strings and write them to stdout
+await ReadableStream
+  .from(chunks)
+  .pipeThrough(new TextEncoderStream())
+  .pipeTo(Deno.stdout.writable, { preventClose: true });
+```
+
+#### Properties
+
+##### `encoding: string`
+
+The encoding used. Always `"utf-8"`.
+
+##### `readable: ReadableStream<Uint8Array>`
+
+Returns a readable stream of encoded UTF-8 bytes.
+
+##### `writable: WritableStream<string>`
+
+Returns a writable stream, to which strings can be written for encoding.
+
+<br /><div align="center">·<b>·</b>•<b>•</b>•<b>·</b>·</div>
+
+### `TextDecoderStream`
+
+Provides a full-duplex UTF-8 decoding stream, allowing UTF-8 bytes to be written
+to its writable side, and the decoded strings to be read from its readable side.
+
+Just like the [`TextDecoder`](#textdecoder) API, this class supports any type of
+`BufferSource` containing UTF-8 bytes, such as `Uint8Array`, `DataView`,
+`ArrayBuffer`, and more. It also supports the same `fatal` and `ignoreBOM`
+decoding options, which can be passed to the constructor.
+
+> **Note**: Requires `TransformStream` to be available in the environment.
+
+#### Usage
+
+```ts
+import { TextDecoderStream } from "@nick/utf8";
+
+const decoderStream = new TextDecoderStream();
+
+const writer = decoderStream.writable.getWriter();
+writer.write(new Uint8Array([72, 101, 108, 108, 111]));
+writer.close();
+
+const reader = decoderStream.readable.getReader();
+reader.read().then(({ value, done }) => {
+  console.log(value); // Hello
+});
+```
+
+#### Properties
+
+##### `encoding: string`
+
+The encoding used by the underlying decoder.
+
+##### `readable: ReadableStream<string>`
+
+The readable stream of decoded strings.
+
+##### `writable: WritableStream<BufferSource>`
+
+The writable stream to which UTF-8 bytes can be written for decoding.
+
+---
+
+## Performance
+
+The implementations in this package are highly optimized for performance. They
+are written in a way that minimizes the number of allocations and copies, and
+they take advantage of the fastest available APIs in the environment.
+
+Take a look at the benchmarks below to see how this package compares to the
+native APIs in Deno:
+
+```scala
+> deno bench -A --no-check
+
+    CPU | Apple M1 Pro
+Runtime | Deno 2.1.2+7c03677 (x86_64-apple-darwin)
+
+
+benchmark                    time/iter (avg)        iter/s      (min … max)           p75      p99     p995
+---------------------------- ----------------------------- --------------------- --------------------------
+
+Native TextDecoder                    1.8 µs       543,200 (  1.4 µs …  13.7 ms)   1.6 µs   2.9 µs   3.6 µs
+Ponyfill TextDecoder                769.0 ns     1,300,000 (583.0 ns …   1.5 ms) 708.0 ns   1.4 µs   1.8 µs
+
+summary
+  Ponyfill TextDecoder
+     2.39x faster than Native TextDecoder
+
+
+
+Native TextDecoderStream             24.6 µs        40,730 ( 13.3 µs …   5.6 ms)  18.9 µs 219.8 µs 574.2 µs
+Ponyfill TextDecoderStream            5.4 µs       185,700 (  4.5 µs …   1.5 ms)   5.1 µs   7.4 µs   9.2 µs
+
+summary
+  Ponyfill TextDecoderStream
+     4.56x faster than Native TextDecoderStream
+
+
+
+Native TextEncoder                    1.1 µs       926,900 (630.1 ns …   1.6 µs)   1.3 µs   1.6 µs   1.6 µs
+Ponyfill TextEncoder                  1.1 µs       870,300 (708.0 ns …   6.9 ms)   1.0 µs   3.6 µs   6.1 µs
+
+summary
+  Ponyfill TextEncoder
+     1.06x slower than Native TextEncoder
+
+
+
+Native TextEncoderStream              8.0 µs       124,500 (  4.9 µs …   3.6 ms)   6.0 µs  19.9 µs  44.6 µs
+Ponyfill TextEncoderStream            5.8 µs       171,100 (  4.7 µs …   1.1 ms)   5.4 µs   9.2 µs  14.9 µs
+
+summary
+  Ponyfill TextEncoderStream
+     1.37x faster than Native TextEncoderStream
+```
+
+---
+
+<div align="center">
+
+##### [MIT] © [Nicholas Berlette]. All rights reserved.
+
+###### [GitHub] · [JSR] · [NPM] · [Bugs]
+
+</div>
+
+[MIT]: https://nick.mit-license.org "MIT © Nicholas Berlette. All rights reserved."
+[Nicholas Berlette]: https://github.com/nberlette "Nicholas Berlette's GitHub Profile"
+[`@nick/utf8`]: https://jsr.io/@nick/utf8 "Blazing fast ponyfills for `TextEncoder`, `TextDecoder`, and more."
+[ponyfill]: https://ponyfill.com "A polyfill that doesn't overwrite the native implementation."
+[GitHub]: https://github.com/nberlette/utf8#readme "Give me a star on GitHub! :) 🌟"
+[JSR]: https://jsr.io/@nick/utf8 "View on JSR - The JavaScript Registry"
+[NPM]: https://www.npmjs.com/package/@nick/utf8 "View @nberlette/utf8 on NPM"
+[Bugs]: https://github.com/nberlette/utf8/issues "Submit a bug report or feature request"

package/cjs/_dnt.shims.d.ts

@@ -0,0 +1 @@
+export declare const dntGlobalThis: Omit<typeof globalThis, never>;

package/cjs/_dnt.shims.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = void 0;
+const dntGlobals = {};
+exports.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;
+        },
+    });
+}
+//# sourceMappingURL=_dnt.shims.js.map

package/cjs/_dnt.shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.js","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":";;;AAAA,MAAM,UAAU,GAAG,EAClB,CAAC;AACW,QAAA,aAAa,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAEtE,SAAS,gBAAgB,CACvB,OAAU,EACV,MAAS;IAET,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS;YAC1B,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK;YACtB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YACA,OAAe,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,IAAI;YAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;gBAC7B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,CAAC,OAAO;YACb,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI;YAChC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wBAAwB,CAAC,OAAO,EAAE,IAAI;YACpC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO,OAAO,CAAC,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC;QAC3C,CAAC;KACF,CAAQ,CAAC;AACZ,CAAC"}

package/cjs/_internal.d.ts

@@ -0,0 +1,54 @@
+export declare var undefined: undefined;
+type Uncurry<T, This = void> = T extends (this: infer ThisArg, ...args: infer A) => infer R ? [This] extends [void] ? (thisArg: ThisArg, ...args: A) => R : (thisArg: This, ...args: A) => R : T extends (...args: infer A) => infer R ? (thisArg: [This] extends [void] ? unknown : This, ...args: A) => R : never;
+export type TypedArrayConstructor = Int8ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Int32ArrayConstructor | Uint32ArrayConstructor | Float16ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor | BigInt64ArrayConstructor | BigUint64ArrayConstructor;
+export type TypedArray = InstanceType<TypedArrayConstructor>;
+type TypedArrayToStringTag = TypedArray[typeof Symbol.toStringTag];
+type TypedArrayFromTag<T extends TypedArrayToStringTag> = TypedArray extends infer A extends TypedArray ? A extends {
+    [Symbol.toStringTag]: T;
+} ? A : never : never;
+export declare function isTypedArray<T extends TypedArrayToStringTag = TypedArrayToStringTag>(it: unknown, type?: T | undefined): it is TypedArrayFromTag<T>;
+export declare const Object: typeof globalThis.Object;
+export declare const ObjectGetPrototypeOf: (o: any) => any;
+export declare const ObjectDefineProperty: <T>(o: T, p: PropertyKey, attributes: PropertyDescriptor & ThisType<any>) => T;
+export declare const ObjectGetOwnPropertyDescriptor: (o: any, p: PropertyKey) => PropertyDescriptor | undefined;
+export declare const toString: (thisArg: unknown) => string;
+export declare const Error: typeof globalThis.Error;
+export declare const TypeError: typeof globalThis.TypeError;
+export declare const RangeError: typeof globalThis.RangeError;
+export declare const ReferenceError: typeof globalThis.ReferenceError;
+export declare const Array: typeof globalThis.Array;
+export declare const Symbol: typeof globalThis.Symbol;
+export declare const ArrayBuffer: typeof globalThis.ArrayBuffer;
+export declare const ArrayBufferIsView: (arg: any) => arg is ArrayBufferView;
+export declare const ArrayBufferPrototypeGetByteLength: (thisArg: ArrayBuffer) => number;
+export declare const SharedArrayBuffer: typeof globalThis.SharedArrayBuffer;
+export declare const SharedArrayBufferPrototypeGetByteLength: (thisArg: SharedArrayBuffer) => number;
+export declare const Uint8Array: typeof globalThis.Uint8Array;
+export declare const Uint8ArrayPrototypeSlice: Uncurry<typeof Uint8Array.prototype.slice, Uint8Array>;
+export declare const Uint8ArrayPrototypeSubarray: Uncurry<typeof Uint8Array.prototype.subarray, Uint8Array>;
+export declare const TypedArray: TypedArrayConstructor;
+export declare const TypedArrayPrototype: InstanceType<TypedArrayConstructor>;
+export declare const TypedArrayPrototypeGetToStringTag: any;
+export declare const TypedArrayPrototypeSubarray: Uncurry<typeof TypedArrayPrototype.subarray, typeof TypedArrayPrototype>;
+export declare const String: typeof globalThis.String;
+export declare const StringFromCharCode: typeof String.fromCharCode;
+export declare const StringPrototype: typeof String.prototype;
+export declare const StringPrototypeCharCodeAt: Uncurry<typeof String.prototype.charCodeAt, string>;
+export declare const StringPrototypeReplace: Uncurry<typeof String.prototype.replace, string>;
+export declare const StringPrototypeSlice: Uncurry<typeof String.prototype.slice, string>;
+export declare const StringPrototypeCodePointAt: Uncurry<typeof String.prototype.codePointAt, string>;
+export declare const StringPrototypeToLowerCase: Uncurry<typeof String.prototype.toLowerCase, string>;
+export declare const StringPrototypeTrim: Uncurry<typeof String.prototype.trim, string>;
+export declare const Promise: typeof globalThis.Promise;
+export declare const PromiseResolve: {
+    (): Promise<void>;
+    <T>(value: T): Promise<Awaited<T>>;
+    <T>(value: T | PromiseLike<T>): Promise<Awaited<T>>;
+};
+export declare const PromiseReject: <T = never>(reason?: any) => Promise<T>;
+export declare const TransformStream: typeof globalThis.TransformStream;
+export declare function getCodePoint(input: string, index: number): number;
+export declare function utf8BytesNeeded(codePoint: number): number;
+export declare function normalizeEncoding(label: string): string;
+export declare function toUint8Array(input?: BufferSource | null): Uint8Array;
+export {};

package/cjs/_internal.js

@@ -0,0 +1,173 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransformStream = exports.PromiseReject = exports.PromiseResolve = exports.Promise = exports.StringPrototypeTrim = exports.StringPrototypeToLowerCase = exports.StringPrototypeCodePointAt = exports.StringPrototypeSlice = exports.StringPrototypeReplace = exports.StringPrototypeCharCodeAt = exports.StringPrototype = exports.StringFromCharCode = exports.String = exports.TypedArrayPrototypeSubarray = exports.TypedArrayPrototypeGetToStringTag = exports.TypedArrayPrototype = exports.TypedArray = exports.Uint8ArrayPrototypeSubarray = exports.Uint8ArrayPrototypeSlice = exports.Uint8Array = exports.SharedArrayBufferPrototypeGetByteLength = exports.SharedArrayBuffer = exports.ArrayBufferPrototypeGetByteLength = exports.ArrayBufferIsView = exports.ArrayBuffer = exports.Symbol = exports.Array = exports.ReferenceError = exports.RangeError = exports.TypeError = exports.Error = exports.toString = exports.ObjectGetOwnPropertyDescriptor = exports.ObjectDefineProperty = exports.ObjectGetPrototypeOf = exports.Object = exports.undefined = void 0;
+exports.isTypedArray = isTypedArray;
+exports.getCodePoint = getCodePoint;
+exports.utf8BytesNeeded = utf8BytesNeeded;
+exports.normalizeEncoding = normalizeEncoding;
+exports.toUint8Array = toUint8Array;
+// deno-lint-ignore no-var
+const dntShim = __importStar(require("./_dnt.shims.js"));
+const $global = (() => {
+    try {
+        if (typeof dntShim.dntGlobalThis === "object")
+            return dntShim.dntGlobalThis;
+        return (0, eval)("this");
+    }
+    catch {
+        if (typeof dntShim.dntGlobalThis === "object")
+            return dntShim.dntGlobalThis;
+        if (typeof self === "object")
+            return self;
+        if (typeof global === "object")
+            return global;
+        if (typeof root === "object")
+            return root;
+        if (typeof this === "object")
+            return this;
+        // ewww
+        throw "Unable to locate global `this`";
+    }
+})();
+function isTypedArray(it, type) {
+    try {
+        return (0, exports.TypedArrayPrototypeGetToStringTag)(it) === type;
+    }
+    catch {
+        return false;
+    }
+}
+exports.Object = $global.Object;
+exports.ObjectGetPrototypeOf = exports.Object.getPrototypeOf;
+exports.ObjectDefineProperty = exports.Object.defineProperty;
+exports.ObjectGetOwnPropertyDescriptor = exports.Object.getOwnPropertyDescriptor;
+const Function = $global.Function;
+const FunctionPrototype = Function.prototype;
+const { bind, call } = FunctionPrototype;
+const uncurryThis = (fn) => {
+    const bound = bind.call(call, fn);
+    (0, exports.ObjectDefineProperty)(bound, "name", { value: fn.name });
+    return bound;
+};
+const FunctionPrototypeBind = uncurryThis(bind);
+function uncurryGetter(o, p) {
+    return uncurryThis(lookupGetter(o, p));
+}
+function lookupGetter(o, p, _allowUndefined) {
+    return (0, exports.ObjectGetOwnPropertyDescriptor)(o, p)?.get ?? (() => exports.undefined);
+}
+// deno-lint-ignore no-explicit-any
+function bindAndRename(fn, thisArg, name = fn.name) {
+    const bound = FunctionPrototypeBind(fn, thisArg);
+    (0, exports.ObjectDefineProperty)(bound, "name", { value: name });
+    return bound;
+}
+exports.toString = uncurryThis(exports.Object.prototype.toString);
+exports.Error = $global.Error;
+exports.TypeError = $global.TypeError;
+exports.RangeError = $global.RangeError;
+exports.ReferenceError = $global.ReferenceError;
+exports.Array = $global.Array;
+exports.Symbol = $global.Symbol;
+exports.ArrayBuffer = $global.ArrayBuffer;
+exports.ArrayBufferIsView = exports.ArrayBuffer.isView;
+exports.ArrayBufferPrototypeGetByteLength = uncurryGetter(exports.ArrayBuffer.prototype, "byteLength");
+exports.SharedArrayBuffer = $global.SharedArrayBuffer;
+exports.SharedArrayBufferPrototypeGetByteLength = uncurryGetter(exports.SharedArrayBuffer.prototype, "byteLength");
+exports.Uint8Array = $global.Uint8Array;
+exports.Uint8ArrayPrototypeSlice = uncurryThis(exports.Uint8Array.prototype.slice);
+exports.Uint8ArrayPrototypeSubarray = uncurryThis(exports.Uint8Array.prototype.subarray);
+exports.TypedArray = (0, exports.ObjectGetPrototypeOf)(exports.Uint8Array);
+exports.TypedArrayPrototype = exports.TypedArray?.prototype;
+exports.TypedArrayPrototypeGetToStringTag = uncurryGetter(exports.TypedArrayPrototype, exports.Symbol.toStringTag);
+exports.TypedArrayPrototypeSubarray // deno-lint-ignore no-explicit-any
+ = uncurryThis(exports.TypedArrayPrototype.subarray);
+exports.String = $global.String;
+exports.StringFromCharCode = exports.String.fromCharCode;
+exports.StringPrototype = exports.String.prototype;
+exports.StringPrototypeCharCodeAt = uncurryThis(exports.StringPrototype.charCodeAt);
+exports.StringPrototypeReplace = uncurryThis(exports.StringPrototype.replace);
+exports.StringPrototypeSlice = uncurryThis(exports.StringPrototype.slice);
+exports.StringPrototypeCodePointAt = uncurryThis(exports.StringPrototype.codePointAt);
+exports.StringPrototypeToLowerCase = uncurryThis(exports.StringPrototype.toLowerCase);
+exports.StringPrototypeTrim = uncurryThis(exports.StringPrototype.trim);
+exports.Promise = $global.Promise;
+exports.PromiseResolve = bindAndRename(exports.Promise.resolve, exports.Promise);
+exports.PromiseReject = bindAndRename(exports.Promise.reject, exports.Promise);
+exports.TransformStream = $global.TransformStream;
+function getCodePoint(input, index) {
+    const first = (0, exports.StringPrototypeCharCodeAt)(input, index);
+    if (first >= 0xd800 && first <= 0xdbff) {
+        const second = (0, exports.StringPrototypeCharCodeAt)(input, index + 1);
+        if (second >= 0xdc00 && second <= 0xdfff) {
+            return ((first - 0xd800) << 10) + (second - 0xdc00) + 0x10000;
+        }
+    }
+    return first;
+}
+function utf8BytesNeeded(codePoint) {
+    if (codePoint <= 0x7f)
+        return 1;
+    if (codePoint <= 0x7ff)
+        return 2;
+    if (codePoint <= 0xffff)
+        return 3;
+    return 4;
+}
+function normalizeEncoding(label) {
+    let encoding = (0, exports.StringPrototypeToLowerCase)(label);
+    encoding = (0, exports.StringPrototypeTrim)(encoding);
+    if (encoding === "utf8" || encoding === "utf-8")
+        return "utf-8";
+    throw new exports.TypeError(`The encoding label provided ('${label}') is invalid.`);
+}
+function toUint8Array(input) {
+    if (input == null) {
+        return new exports.Uint8Array();
+    }
+    else if (isTypedArray(input, "Uint8Array")) {
+        return input;
+    }
+    else if ((0, exports.ArrayBufferIsView)(input)) {
+        return new exports.Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+    }
+    else {
+        try {
+            (0, exports.SharedArrayBufferPrototypeGetByteLength)(input);
+            return new exports.Uint8Array(input);
+        }
+        catch (_) {
+            try {
+                (0, exports.ArrayBufferPrototypeGetByteLength)(input);
+                return new exports.Uint8Array(input);
+            }
+            catch (_) {
+                throw new exports.TypeError('The "input" argument must be of type BufferSource');
+            }
+        }
+    }
+}
+//# sourceMappingURL=_internal.js.map

package/cjs/_internal.js.map

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

package/cjs/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * # `@nick/utf8`
+ *
+ * This package provides blazing-fast, zero-dependency ponyfills for the native
+ * `TextEncoder` and `TextDecoder` APIs, as well as the streaming counterparts,
+ * `TextEncoderStream` and `TextDecoderStream`.
+ *
+ * The ponyfills are based on the WHATWG Encoding standard, and are designed to
+ * work in any ES2015+ environment, including Deno, Node, Bun, and the browser.
+ *
+ * @example
+ * ```ts
+ * import { TextEncoder, TextDecoder } from "@nick/utf8";
+ *
+ * const encoder = new TextEncoder();
+ * const decoder = new TextDecoder();
+ *
+ * const buffer = encoder.encode("Hello, world!");
+ * const text = decoder.decode(buffer);
+ *
+ * console.log(text); // Outputs: "Hello, world!"
+ * ```
+ * @module utf8
+ */
+export * from "./text_encoder.js";
+export * from "./text_decoder.js";
+export * from "./text_encoder_stream.js";
+export * from "./text_decoder_stream.js";