Merge branch 'main' into csv-columns-options-type

Releases.md

@@ -1,3 +1,68 @@
+### 2025.01.31
+
+#### @std/bytes 1.0.5 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/cli 1.0.12 (patch)
+
+- feat(cli/unstable): support stderr on spinner (#6350)
+
+#### @std/crypto 1.0.4 (patch)
+
+- docs(crypto): clarify doc comment (#6368)
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/encoding 1.0.7 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/expect 1.0.13 (patch)
+
+- test(expect): check error message of `.toBeCloseTo()` (#6296)
+
+#### @std/fmt 1.0.5 (patch)
+
+- fix(fmt): make printf working with colors. (#6360)
+
+#### @std/fs 1.0.11 (patch)
+
+- feat(fs/unstable): add readLink and readLinkSync (#6373)
+- feat(fs/unstable): add link and linkSync (#6369)
+- feat(fs/unstable): add realPath and realPathSync (#6366)
+
+#### @std/http 1.0.13 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/io 0.225.2 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/log 0.224.14 (patch)
+
+- docs(log): mention potential deprecation of @std/log (#6364)
+
+#### @std/msgpack 1.0.3 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/streams 1.0.9 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
+#### @std/tar 0.1.5 (patch)
+
+- refactor(bytes,crypto,encoding,http,io,msgpack,streams,tar): make Uint8Array
+  usages compatible with TS 5.7 (#6372)
+
 ### 2025.01.22
 
 #### @std/assert 1.0.11 (patch)

_tools/node_test_runner/run_test.mjs

@@ -49,7 +49,10 @@ import "../../collections/union_test.ts";
 import "../../collections/unzip_test.ts";
 import "../../collections/without_all_test.ts";
 import "../../collections/zip_test.ts";
+import "../../fs/unstable_link_test.ts";
 import "../../fs/unstable_read_dir_test.ts";
+import "../../fs/unstable_read_link_test.ts";
+import "../../fs/unstable_real_path_test.ts";
 import "../../fs/unstable_stat_test.ts";
 import "../../fs/unstable_symlink_test.ts";
 import "../../fs/unstable_lstat_test.ts";

bytes/_types.ts

@@ -0,0 +1,11 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+
+/**
+ * Proxy type of {@code Uint8Array<ArrayBuffer} or {@code Uint8Array} in TypeScript 5.7 or below respectively.
+ *
+ * This type is internal utility type and should not be used directly.
+ *
+ * @internal @private
+ */
+
+export type Uint8Array_ = ReturnType<Uint8Array["slice"]>;

bytes/concat.ts

@@ -1,6 +1,9 @@
 // Copyright 2018-2025 the Deno authors. MIT license.
 // This module is browser compatible.
 
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
+
 /**
  * Concatenate an array of byte slices into a single slice.
  *
@@ -18,7 +21,7 @@
  * assertEquals(concat([a, b]), new Uint8Array([0, 1, 2, 3, 4, 5]));
  * ```
  */
-export function concat(buffers: Uint8Array[]): Uint8Array {
+export function concat(buffers: Uint8Array[]): Uint8Array_ {
   let length = 0;
   for (const buffer of buffers) {
     length += buffer.length;

bytes/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@std/bytes",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "exports": {
     ".": "./mod.ts",
     "./concat": "./concat.ts",

bytes/repeat.ts

@@ -1,6 +1,8 @@
 // Copyright 2018-2025 the Deno authors. MIT license.
 // This module is browser compatible.
 import { copy } from "./copy.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 /**
  * Returns a new byte slice composed of `count` repetitions of the `source`
@@ -31,7 +33,7 @@ import { copy } from "./copy.ts";
  * assertEquals(repeat(source, 0), new Uint8Array());
  * ```
  */
-export function repeat(source: Uint8Array, count: number): Uint8Array {
+export function repeat(source: Uint8Array, count: number): Uint8Array_ {
   if (count < 0 || !Number.isInteger(count)) {
     throw new RangeError("Count must be a non-negative integer");
   }

cli/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@std/cli",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "exports": {
     ".": "./mod.ts",
     "./parse-args": "./parse_args.ts",

crypto/crypto.ts

@@ -188,8 +188,8 @@ export interface StdCrypto extends Crypto {
 }
 
 /**
- * An wrapper for WebCrypto adding support for additional non-standard
- * algorithms, but delegating to the runtime WebCrypto implementation whenever
+ * A wrapper for WebCrypto which adds support for additional non-standard
+ * algorithms, but delegates to the runtime WebCrypto implementation whenever
  * possible.
  */
 const stdCrypto: StdCrypto = ((x) => x)({
@@ -241,7 +241,7 @@ const stdCrypto: StdCrypto = ((x) => x)({
             }
             context.update(chunkBytes);
           }
-          return context.digestAndDrop(length).buffer;
+          return context.digestAndDrop(length).buffer as ArrayBuffer;
         } else {
           throw new TypeError(
             "data must be a BufferSource or [Async]Iterable<BufferSource>",
@@ -265,7 +265,7 @@ const stdCrypto: StdCrypto = ((x) => x)({
       const wasmCrypto = instantiateWasm();
       if (isBufferSource(data)) {
         const bytes = toUint8Array(data)!;
-        return wasmCrypto.digest(name, bytes, length).buffer;
+        return wasmCrypto.digest(name, bytes, length).buffer as ArrayBuffer;
       }
       if (isIterable(data)) {
         const context = new wasmCrypto.DigestContext(name);
@@ -278,7 +278,7 @@ const stdCrypto: StdCrypto = ((x) => x)({
           }
           context.update(chunkBytes);
         }
-        return context.digestAndDrop(length).buffer;
+        return context.digestAndDrop(length).buffer as ArrayBuffer;
       }
       throw new TypeError(
         "data must be a BufferSource or Iterable<BufferSource>",

crypto/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@std/crypto",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "exports": {
     ".": "./mod.ts",
     "./crypto": "./crypto.ts",

encoding/_base32_common.ts

@@ -7,6 +7,7 @@
  */
 
 import { validateBinaryLike } from "./_validate_binary_like.ts";
+import type { Uint8Array_ } from "./_types.ts";
 
 const placeHolderPadLookup = [0, 1, , 2, 3, , 4];
 
@@ -46,7 +47,10 @@ function getByteLength(validLen: number, placeHoldersLen: number): number {
  * @param lookup The lookup table
  * @returns The encoded string.
  */
-export function decode(b32: string, lookup: ReadonlyArray<string>): Uint8Array {
+export function decode(
+  b32: string,
+  lookup: ReadonlyArray<string>,
+): Uint8Array_ {
   const revLookup: number[] = [];
   lookup.forEach((c, i) => (revLookup[c.charCodeAt(0)] = i));
 

encoding/_types.ts

@@ -0,0 +1,11 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+
+/**
+ * Proxy type of {@code Uint8Array<ArrayBuffer} or {@code Uint8Array} in TypeScript 5.7 or below respectively.
+ *
+ * This type is internal utility type and should not be used directly.
+ *
+ * @internal @private
+ */
+
+export type Uint8Array_ = ReturnType<Uint8Array["slice"]>;

encoding/ascii85.ts

@@ -1,6 +1,9 @@
 // Copyright 2018-2025 the Deno authors. MIT license.
 // This module is browser compatible.
 
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
+
 /**
  * Utilities for working with {@link https://en.wikipedia.org/wiki/Ascii85 | ascii85} encoding.
  *
@@ -156,7 +159,7 @@ export type DecodeAscii85Options = Omit<EncodeAscii85Options, "delimiter">;
 export function decodeAscii85(
   ascii85: string,
   options: DecodeAscii85Options = {},
-): Uint8Array {
+): Uint8Array_ {
   const { standard = "Adobe" } = options;
 
   // translate all encodings to most basic adobe/btoa one and decompress some special characters ("z" and "y")

encoding/base32.ts

@@ -2,6 +2,9 @@
 // Copyright (c) 2014 Jameson Little. MIT License.
 // This module is browser compatible.
 
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
+
 /**
  * Utilities for
  * {@link https://www.rfc-editor.org/rfc/rfc4648.html#section-6 | base32}
@@ -48,7 +51,7 @@ lookup.forEach((c, i) => (revLookup[c.charCodeAt(0)] = i));
  * );
  * ```
  */
-export function decodeBase32(b32: string): Uint8Array {
+export function decodeBase32(b32: string): Uint8Array_ {
   return decode(b32, lookup);
 }
 

encoding/base58.ts

@@ -21,6 +21,8 @@
  */
 
 import { validateBinaryLike } from "./_validate_binary_like.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 // deno-fmt-ignore
 const mapBase58: Record<string, number> = {
@@ -120,7 +122,7 @@ export function encodeBase58(data: ArrayBuffer | Uint8Array | string): string {
  * );
  * ```
  */
-export function decodeBase58(b58: string): Uint8Array {
+export function decodeBase58(b58: string): Uint8Array_ {
   const splitInput = b58.trim().split("");
 
   let length = 0;

encoding/base58_test.ts

@@ -53,7 +53,7 @@ Deno.test("encodeBase58() encodes binary", () => {
 
 Deno.test("encodeBase58() encodes binary buffer", () => {
   for (const [input, output] of testSetBinary) {
-    assertEquals(encodeBase58(input.buffer), output);
+    assertEquals(encodeBase58(input.buffer as ArrayBuffer), output);
   }
 });
 

encoding/base64.ts

@@ -23,6 +23,8 @@
  */
 
 import { validateBinaryLike } from "./_validate_binary_like.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 const base64abc = [
   "A",
@@ -163,7 +165,7 @@ export function encodeBase64(data: ArrayBuffer | Uint8Array | string): string {
  * );
  * ```
  */
-export function decodeBase64(b64: string): Uint8Array {
+export function decodeBase64(b64: string): Uint8Array_ {
   const binString = atob(b64);
   const size = binString.length;
   const bytes = new Uint8Array(size);

encoding/base64_test.ts

@@ -33,7 +33,7 @@ Deno.test("encodeBase64() encodes binary", () => {
 
 Deno.test("encodeBase64() encodes binary buffer", () => {
   for (const [input, output] of testsetBinary) {
-    assertEquals(encodeBase64(input.buffer), output);
+    assertEquals(encodeBase64(input.buffer as ArrayBuffer), output);
   }
 });
 

encoding/base64url.ts

@@ -10,6 +10,8 @@
  */
 
 import * as base64 from "./base64.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 /**
  * Some variants allow or require omitting the padding '=' signs:
@@ -83,6 +85,6 @@ export function encodeBase64Url(
  * );
  * ```
  */
-export function decodeBase64Url(b64url: string): Uint8Array {
+export function decodeBase64Url(b64url: string): Uint8Array_ {
   return base64.decodeBase64(convertBase64urlToBase64(b64url));
 }

encoding/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@std/encoding",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "exports": {
     ".": "./mod.ts",
     "./ascii85": "./ascii85.ts",

encoding/hex.ts

@@ -27,6 +27,8 @@
  */
 
 import { validateBinaryLike } from "./_validate_binary_like.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 const hexTable = new TextEncoder().encode("0123456789abcdef");
 const textEncoder = new TextEncoder();
@@ -100,7 +102,7 @@ export function encodeHex(src: string | Uint8Array | ArrayBuffer): string {
  * );
  * ```
  */
-export function decodeHex(src: string): Uint8Array {
+export function decodeHex(src: string): Uint8Array_ {
   const u8 = textEncoder.encode(src);
   const dst = new Uint8Array(u8.length / 2);
   for (let i = 0; i < dst.length; i++) {

encoding/unstable_base32_stream.ts

@@ -22,6 +22,8 @@
  */
 
 import { decodeBase32, encodeBase32 } from "./base32.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 /**
  * Converts a Uint8Array stream into a base32-encoded stream.
@@ -88,7 +90,7 @@ export class Base32EncoderStream extends TransformStream<Uint8Array, string> {
  * assertEquals(await toText(stream), "Hello World!");
  * ```
  */
-export class Base32DecoderStream extends TransformStream<string, Uint8Array> {
+export class Base32DecoderStream extends TransformStream<string, Uint8Array_> {
   constructor() {
     let push = "";
     super({

encoding/unstable_base32crockford.ts

@@ -24,6 +24,8 @@
  * @module
  */
 import { decode, encode } from "./_base32_common.ts";
+import type { Uint8Array_ } from "./_types.ts";
+export type { Uint8Array_ };
 
 const lookup: string[] = "0123456789ABCDEFGHJKMNPQRSTVWXYZ".split("");
 const revLookup: number[] = [];
@@ -48,7 +50,7 @@ lookup.forEach((c, i) => (revLookup[c.charCodeAt(0)] = i));
  * );
  * ```
  */
-export function decodeBase32Crockford(b32: string): Uint8Array {
+export function decodeBase32Crockford(b32: string): Uint8Array_ {
   return decode(b32, lookup);
 }