Rename asMutable to asWritable

readme.md

@@ -23,7 +23,7 @@ import {isDefined} from 'ts-extras';
 
 **General**
 
-- [`asMutable`](source/as-mutable.ts) - Cast the given value to be [`Mutable`](https://github.com/sindresorhus/type-fest/blob/main/source/mutable.d.ts).
+- [`asWritable`](source/as-writable.ts) - Cast the given value to be [`Writable`](https://github.com/sindresorhus/type-fest/blob/main/source/writable.d.ts).
 
 **Type guard**
 

source/as-writable.ts

@@ -0,0 +1,19 @@
+import {type Writable} from 'type-fest';
+
+/**
+Cast the given value to be [`Writable`](https://github.com/sindresorhus/type-fest/blob/main/source/writable.d.ts).
+
+This is useful because of a [TypeScript limitation](https://github.com/microsoft/TypeScript/issues/45618#issuecomment-908072756).
+
+@example
+```
+import {asWritable} from 'ts-extras';
+
+const writableContext = asWritable((await import('x')).context);
+```
+
+@category General
+*/
+export function asWritable<T>(value: T): Writable<T> {
+	return value as any; // eslint-disable-line @typescript-eslint/no-unsafe-return
+}

source/index.ts

@@ -1,5 +1,5 @@
 export {arrayIncludes} from './array-includes.js';
-export {asMutable} from './as-mutable.js';
+export {asWritable} from './as-writable.js';
 export {assertError} from './assert-error.js';
 export {isDefined} from './is-defined.js';
 export {isPresent} from './is-present.js';

test/as-writable.ts

@@ -0,0 +1,17 @@
+import test from 'ava';
+import {asWritable} from '../source/index.js';
+
+test('asWritable()', t => {
+	type Fixture = {
+		readonly a: number;
+	};
+
+	const fixture: Fixture = {a: 1};
+
+	// @ts-expect-error
+	fixture.a = 2;
+
+	const writableFixture = asWritable(fixture);
+	writableFixture.a = 2;
+	t.is(writableFixture.a, 2);
+});