utilium 2.8.7 → 3.0.0

package/dist/buffer.d.ts

@@ -1,4 +1,3 @@
-import type { Mutable } from './objects.js';
 /**
  * A generic constructor for an `ArrayBufferView`
  */
@@ -229,12 +228,6 @@ export interface TypedArrayConstructor {
  */
 export declare function extendBuffer<T extends ArrayBufferLike | ArrayBufferView>(buffer: T, newByteLength: number): T;
 export declare function toUint8Array(buffer: ArrayBufferLike | ArrayBufferView): Uint8Array;
-/**
- * @hidden @deprecated
- */
-export declare function initView<T extends ArrayBufferLike = ArrayBuffer>(view: Mutable<ArrayBufferView<T> & {
-    BYTES_PER_ELEMENT?: number;
-}>, buffer?: T | ArrayBufferView<T> | ArrayLike<number> | number, byteOffset?: number, byteLength?: number): void;
 /** A generic view of an array buffer */
 export declare class BufferView<T extends ArrayBufferLike = ArrayBufferLike> extends DataView<T> implements ArrayBufferView<T> {
     constructor(_buffer?: T | ArrayBufferView<T> | ArrayLike<number> | number, _byteOffset?: number, _byteLength?: number);

package/dist/buffer.js

@@ -39,42 +39,6 @@ export function toUint8Array(buffer) {
         return new Uint8Array(buffer);
     return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
 }
-/**
- * @hidden @deprecated
- */
-export function initView(view, buffer, byteOffset, byteLength) {
-    if (typeof buffer == 'number') {
-        view.buffer = new ArrayBuffer(buffer);
-        view.byteOffset = 0;
-        view.byteLength = buffer;
-        return;
-    }
-    if (!buffer
-        || buffer instanceof ArrayBuffer
-        || (globalThis.SharedArrayBuffer && buffer instanceof SharedArrayBuffer)) {
-        const size = byteLength
-            ?? view.constructor?.size // Memium types
-            ?? buffer?.byteLength
-            ?? 0;
-        view.buffer = buffer ?? new ArrayBuffer(size);
-        view.byteOffset = byteOffset ?? 0;
-        view.byteLength = size;
-        return;
-    }
-    if (ArrayBuffer.isView(buffer)) {
-        view.buffer = buffer.buffer;
-        view.byteOffset = buffer.byteOffset;
-        view.byteLength = buffer.byteLength;
-        return;
-    }
-    const u8 = new Uint8Array(buffer.length);
-    view.buffer = u8.buffer;
-    view.byteOffset = 0;
-    view.byteLength = u8.length;
-    for (let i = 0; i < u8.length; i++) {
-        u8[i] = buffer[i];
-    }
-}
 /** A generic view of an array buffer */
 export class BufferView extends DataView {
     constructor(_buffer, _byteOffset, _byteLength) {

package/dist/fs.d.ts

@@ -9,6 +9,8 @@ export declare abstract class FileMap<V> implements Map<string, V> {
     abstract get(key: string): V;
     abstract has(key: string): boolean;
     abstract set(key: string, value: V): this;
+    getOrInsert(key: string, defaultValue: V): V;
+    getOrInsertComputed(key: string, callback: (key: string) => V): V;
     get size(): number;
     get [Symbol.iterator](): () => MapIterator<[string, V]>;
     get keys(): typeof this._map.keys;

package/dist/fs.js

@@ -13,6 +13,18 @@ export class FileMap {
             throw new ReferenceError('No path specified');
         }
     }
+    getOrInsert(key, defaultValue) {
+        if (this.has(key)) {
+            return this.get(key);
+        }
+        return this.set(key, defaultValue).get(key);
+    }
+    getOrInsertComputed(key, callback) {
+        if (this.has(key)) {
+            return this.get(key);
+        }
+        return this.set(key, callback(key)).get(key);
+    }
     get size() {
         return this._map.size;
     }

package/dist/requests.d.ts

@@ -4,16 +4,6 @@
  * Copyright (c) 2025 James Prevett
  */
 import * as cache from './cache.js';
-/** @deprecated Use `cache.Options` */
-export type ResourceCacheOptions = cache.Options;
-/** @deprecated Use `cache.Resource` */
-export declare const ResourceCache: typeof cache.Resource;
-/** @deprecated Use `cache.Resource` */
-export type ResourceCache = cache.Resource<string>;
-/** @deprecated Use `cache.Range` */
-export type CacheRange = cache.Range;
-/** @deprecated Use `cache.Options` */
-export type CacheOptions = cache.Options;
 /**
  * @internal
  */
@@ -29,18 +19,10 @@ export type Issue = {
     tag: 'fetch' | 'size';
     message: string;
 } | Error;
-/**
- * @deprecated Use `Issue`
- */
-export type RequestError = Issue;
 export interface Options extends cache.Options {
     /** Optionally provide a function for logging warnings */
     warn?(message: string): unknown;
 }
-/**
- * @deprecated Use `Options`
- */
-export type RequestOptions = Options;
 export interface GetOptions extends Options {
     /**
      * When using range requests,
@@ -58,10 +40,6 @@ export interface GetOptions extends Options {
  * @throws RequestError
  */
 export declare function get(url: string, options: GetOptions, init?: RequestInit): Promise<Uint8Array>;
-/**
- * @deprecated Use `get`
- */
-export declare const GET: typeof get;
 /**
  * Synchronously gets a cached resource
  * Assumes you pass valid start and end when using ranges

package/dist/requests.js

@@ -5,8 +5,6 @@
  * Copyright (c) 2025 James Prevett
  */
 import * as cache from './cache.js';
-/** @deprecated Use `cache.Resource` */
-export const ResourceCache = cache.Resource;
 /* eslint-disable @typescript-eslint/only-throw-error */
 /**
  * @internal
@@ -72,10 +70,6 @@ export async function get(url, options, init = {}) {
     const region = resource.regionAt(start);
     return region.data.subarray(start - region.offset, end - region.offset);
 }
-/**
- * @deprecated Use `get`
- */
-export const GET = get;
 /**
  * Synchronously gets a cached resource
  * Assumes you pass valid start and end when using ranges

package/dist/types.d.ts

@@ -1,5 +1,4 @@
-import type { Length, Unshift, Push, FromLength } from './array.js';
-import type { Subtract } from './type-math.js';
+import type { Push } from './array.js';
 /**
  * Expands the type T (for intellisense and debugging)
  * @see https://stackoverflow.com/a/69288824/17637456
@@ -24,16 +23,6 @@ type StrictUnionHelper<T, TAll> = T extends unknown ? T & Partial<Record<Exclude
  * @see https://stackoverflow.com/a/65805753/17637456
  */
 export type StrictUnion<T> = Expand<StrictUnionHelper<T, T>>;
-/**
- * Increments N
- * @deprecated Use Add<N, 1> instead
- */
-export type Increment<N extends number> = Length<Unshift<FromLength<N>, 0>>;
-/**
- * Decrements N
- * @deprecated Use Subtract<N, 1> instead
- */
-export type Decrement<N extends number> = Subtract<N, 1>;
 /**
  * Keys of a Map
  */

package/eslint.shared.js

@@ -4,11 +4,12 @@
  * Copyright (c) 2025 James Prevett
  */
 import eslint from '@eslint/js';
+import { defineConfig } from 'eslint/config';
 import globals from 'globals';
 import tseslint from 'typescript-eslint';
 
 export default function (tsconfigRootDir) {
-	return tseslint.config(
+	return defineConfig(
 		{
 			name: 'Utilium',
 			extends: [eslint.configs.recommended, ...tseslint.configs.recommendedTypeChecked],

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "2.8.7",
+	"version": "3.0.0",
 	"description": "Typescript utilities",
 	"funding": {
 		"type": "individual",
@@ -11,7 +11,7 @@
 	"type": "module",
 	"exports": {
 		".": "./dist/index.js",
-		"./*": "./dist/*",
+		"./*": "./dist/*.js",
 		"./eslint": "./eslint.shared.js"
 	},
 	"bin": {
@@ -39,15 +39,15 @@
 	},
 	"homepage": "https://github.com/james-pre/utilium#readme",
 	"devDependencies": {
-		"@eslint/js": "^9.12.0",
+		"@eslint/js": "^10.0.1",
 		"@types/node": "^24.7.0",
-		"eslint": "^9.12.0",
+		"eslint": "^10.1.0",
 		"globals": "^15.10.0",
 		"prettier": "^3.2.5",
 		"tsx": "^4.19.1",
-		"typedoc": "^0.28.13",
-		"typescript": "^5.7.2",
-		"typescript-eslint": "^8.8.0"
+		"typedoc": "^0.28.18",
+		"typescript": "^6.0.0",
+		"typescript-eslint": "^8.58.0"
 	},
 	"dependencies": {
 		"eventemitter3": "^5.0.1"