1n-destructure 0.0.1-alpha.0

package/README.md

@@ -0,0 +1,2 @@
+# destructure
+A library for serialisation and deserialisation of structured data.

package/dist/decoder/decoder.d.ts

@@ -0,0 +1,3 @@
+import { type Data, type Schema } from "../schema/schema.ts";
+export declare const decode: <T extends Schema>(schema: T, buffer: Uint8Array<ArrayBuffer>, offset?: number) => Data<T>;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/decoder/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/decoder/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,EACT,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAa7B,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,MAAM,EACrC,QAAQ,CAAC,EACT,QAAQ,UAAU,CAAC,WAAW,CAAC,EAC/B,eAAU,KACT,IAAI,CAAC,CAAC,CAuGR,CAAC"}

package/dist/decoder/decoder.js

@@ -0,0 +1,102 @@
+import { schema as _schema, SchemaType, } from "../schema/schema.js";
+const dvMethodMap = {
+    u8: DataView.prototype.getUint8,
+    u16: DataView.prototype.getUint16,
+    u32: DataView.prototype.getUint32,
+    i8: DataView.prototype.getInt8,
+    i16: DataView.prototype.getInt16,
+    i32: DataView.prototype.getInt32,
+    f32: DataView.prototype.getFloat32,
+    f64: DataView.prototype.getFloat64,
+};
+export const decode = (schema, buffer, offset = 0) => {
+    const bytes = {
+        array: buffer,
+        view: new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength),
+    };
+    const view = bytes.view;
+    const state = {
+        stack: [_schema(schema)],
+        stackData: new WeakMap(),
+        processingQueue: [],
+        offset: offset,
+        result: null,
+    };
+    const handleQueue = (value) => {
+        const processingQueue = state.processingQueue;
+        if (!processingQueue.length)
+            return value;
+        const entry = processingQueue.shift();
+        if (entry[0] === "object")
+            entry[1][entry[2]] = value;
+        else if (entry[0] === "array")
+            entry[1].push(value);
+        return value;
+    };
+    do {
+        const current = state.stack.shift();
+        if (!current)
+            continue;
+        let _value = null;
+        switch (current.type) {
+            case SchemaType.Null: {
+                handleQueue((_value = null));
+                break;
+            }
+            case SchemaType.Simple: {
+                if (current.base === "char") {
+                    const codepoint = buffer[state.offset++];
+                    if (!codepoint)
+                        throw new Error("Unexpected element value.");
+                    handleQueue((_value = String.fromCharCode(codepoint)));
+                }
+                else {
+                    handleQueue((_value = dvMethodMap[current.base].call(view, state.offset, true)));
+                    state.offset += current.byteLength;
+                }
+                break;
+            }
+            case SchemaType.Object: {
+                const value = {};
+                handleQueue((_value = value));
+                state.stack.unshift(...current.entries.map((entry) => entry[1]));
+                state.processingQueue.unshift(...current.entries.map((entry) => ["object", value, entry[0]]));
+                break;
+            }
+            case SchemaType.Tuple: {
+                const value = [];
+                const procEntry = ["array", handleQueue((_value = value))];
+                state.stack.unshift(...current.entries);
+                state.processingQueue.unshift(...new Array(current.entries.length).fill(procEntry));
+                break;
+            }
+            case SchemaType.Array: {
+                const value = [];
+                const procEntry = ["array", handleQueue((_value = value))];
+                const count = current.count === -1 ? view.getUint32(state.offset, true) : current.count;
+                state.offset += +(current.count === -1) * 4;
+                state.stack.unshift(...new Array(count).fill(current.schema));
+                state.processingQueue.unshift(...new Array(count).fill(procEntry));
+                break;
+            }
+            case SchemaType.Optional: {
+                const hasData = !!buffer[state.offset++];
+                !hasData && handleQueue((_value = undefined));
+                hasData && state.stack.unshift(current.schema);
+                break;
+            }
+            case SchemaType.Custom: {
+                const { value, nextOffset } = current.handler.decode(bytes, state.offset);
+                state.offset = nextOffset;
+                handleQueue((_value = value));
+                break;
+            }
+            default: {
+                throw new TypeError("Unknown schema type.");
+            }
+        }
+        state.result === null && (state.result = _value);
+    } while (state.stack.length);
+    return state.result;
+};
+//# sourceMappingURL=decoder.js.map

package/dist/decoder/decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.js","sourceRoot":"","sources":["../../src/decoder/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,OAAO,EACjB,UAAU,GAIX,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ;IAC/B,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS;IACjC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS;IACjC,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO;IAC9B,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ;IAChC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ;IAChC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU;IAClC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,MAAS,EACT,MAA+B,EAC/B,MAAM,GAAG,CAAC,EACD,EAAE;IAWX,MAAM,KAAK,GAAG;QACZ,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;KACxE,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,KAAK,GAAiB;QAC1B,KAAK,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,SAAS,EAAE,IAAI,OAAO,EAAE;QACxB,eAAe,EAAE,EAAE;QACnB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,KAAU,EAAgB,EAAE;QAC/C,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,eAAe,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE1C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAG,CAAC;QACvC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;aACjD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,GAAG,CAAC;QACF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,IAAI,MAAM,GAAQ,IAAI,CAAC;QACvB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;gBACrB,WAAW,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBACvB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;oBACzC,IAAI,CAAC,SAAS;wBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;oBAC7D,WAAW,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACzD,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;oBACjF,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;gBACrC,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBACvB,MAAM,KAAK,GAAwB,EAAE,CAAC;gBAEtC,WAAW,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;gBAC9B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjE,KAAK,CAAC,eAAe,CAAC,OAAO,CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAmB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CACjF,CAAC;gBACF,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtB,MAAM,KAAK,GAAU,EAAE,CAAC;gBACxB,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3D,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;gBACxC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;gBACpF,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtB,MAAM,KAAK,GAAU,EAAE,CAAC;gBACxB,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;gBACxF,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC5C,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC9D,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;gBACnE,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzB,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBACzC,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;gBAC9C,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC/C,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBACvB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC1E,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;gBAE1B,WAAW,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;gBAC9B,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAI,SAAS,CAAC,sBAAsB,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD,CAAC,QAAQ,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;IAE7B,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC,CAAC"}

package/dist/encoder/encoder.d.ts

@@ -0,0 +1,3 @@
+import { type CompiledSchema, type Data, type Schema } from "../schema/schema.ts";
+export declare const encode: <T extends Schema>(schema: T | CompiledSchema<T>, data: Data<T>) => Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/encoder/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/encoder/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,KAAK,MAAM,EAGZ,MAAM,qBAAqB,CAAC;AAc7B,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,MAAM,EACrC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAC7B,MAAM,IAAI,CAAC,CAAC,CAAC,KACZ,UAAU,CAAC,WAAW,CA+ExB,CAAC"}

package/dist/encoder/encoder.js

@@ -0,0 +1,90 @@
+import { SchemaType, schema as _schema, } from "../schema/schema.js";
+import { createGrowingBuffer, getStringCodePoints } from "../utils/utils.js";
+const dvMethodMap = {
+    u8: DataView.prototype.setUint8,
+    u16: DataView.prototype.setUint16,
+    u32: DataView.prototype.setUint32,
+    i8: DataView.prototype.setInt8,
+    i16: DataView.prototype.setInt16,
+    i32: DataView.prototype.setInt32,
+    f32: DataView.prototype.setFloat32,
+    f64: DataView.prototype.setFloat64,
+};
+export const encode = (schema, data) => {
+    const buffer = createGrowingBuffer();
+    const stack = [[_schema(schema), data, {}]];
+    while (stack.length) {
+        const [schema, payload, data] = stack.pop();
+        switch (schema.type) {
+            case SchemaType.Null: {
+                break;
+            }
+            case SchemaType.Simple: {
+                if (schema.base === "char") {
+                    const codepoints = getStringCodePoints(payload);
+                    if (codepoints.length === 1)
+                        buffer.writeOne(codepoints[0]);
+                    else
+                        throw new Error("char data must be a string with one codepoint.");
+                    break;
+                }
+                const method = dvMethodMap[schema.base];
+                buffer.ensureCapacity(schema.byteLength);
+                method.call(buffer.view, buffer.offset, payload, true);
+                buffer.offset += schema.byteLength;
+                break;
+            }
+            case SchemaType.Object: {
+                if (typeof payload !== "object")
+                    throw new TypeError("data must be an object.");
+                stack.push(...schema.entries
+                    .map(([key, schema]) => [schema, payload[key], {}])
+                    .reverse());
+                break;
+            }
+            case SchemaType.Tuple: {
+                if (!Array.isArray(payload))
+                    throw new TypeError("data must be an array.");
+                stack.push(...schema.entries.map((schema, i) => [schema, payload[i], {}]).reverse());
+                break;
+            }
+            case SchemaType.Array: {
+                if (!Array.isArray(payload))
+                    throw new TypeError("data must be an array.");
+                if (schema.count !== -1 && schema.count !== payload.length) {
+                    throw new Error("Element count mismatch between schema and data.");
+                }
+                if (schema.count === -1) {
+                    if (payload.length > 2 ** 32 - 1)
+                        throw new RangeError("Too many elements in input.");
+                    buffer.ensureCapacity(4);
+                    buffer.view.setUint32(buffer.offset, payload.length, true);
+                    buffer.offset += 4;
+                }
+                stack.push(...payload.map((payload) => [schema.schema, payload, {}]).reverse());
+                break;
+            }
+            case SchemaType.Optional: {
+                const isSupplied = payload !== undefined;
+                buffer.ensureCapacity(1);
+                buffer.buffer[buffer.offset++] = +isSupplied;
+                isSupplied && stack.push([schema.schema, payload, {}]);
+                break;
+            }
+            case SchemaType.Custom: {
+                if ("encodeInto" in schema.handler)
+                    schema.handler.encodeInto(buffer, payload);
+                else {
+                    const data = schema.handler.encode(payload);
+                    buffer.write(data);
+                }
+                break;
+            }
+            default: {
+                throw new TypeError("Unknown schema type.");
+            }
+        }
+    }
+    return buffer.finalise();
+};
+//# sourceMappingURL=encoder.js.map

package/dist/encoder/encoder.js.map

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

package/dist/schema/schema.d.ts

@@ -0,0 +1,24 @@
+import type { CompiledSchema, CustomSchemaHandler, OptionalSchema, Schema } from "./types.ts";
+type CSchema<T extends Schema = Schema> = CompiledSchema<T>;
+declare const SchemaType: {
+    readonly Null: -1;
+    readonly Simple: 0;
+    readonly Object: 1;
+    readonly Tuple: 2;
+    readonly Array: 3;
+    readonly Optional: 4;
+    readonly Custom: 5;
+};
+declare const optionalSchemaKey: unique symbol;
+declare const schemaSourceKey: unique symbol;
+declare const isCustomSchema: (value: unknown) => value is CustomSchemaHandler;
+declare const schema: <T extends Schema>(value: T | CSchema<T>) => CSchema<T>;
+declare const source: <T extends Schema>(value: CSchema<T>) => T;
+declare const array: <T extends Schema>(value: T, count?: number) => T[];
+declare const optional: <T extends Schema>(value: T) => OptionalSchema<T>;
+declare const custom: <T>(handler: CustomSchemaHandler<T>) => CustomSchemaHandler<T>;
+declare const string: CustomSchemaHandler<string>;
+export type * from "./types.ts";
+export { array, custom, isCustomSchema, optional, schema, SchemaType, source, string };
+export type { optionalSchemaKey, schemaSourceKey };
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema/schema.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9F,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AAE5D,QAAA,MAAM,UAAU;;;;;;;;CAQN,CAAC;AAEX,QAAA,MAAM,iBAAiB,eAA2B,CAAC;AACnD,QAAA,MAAM,eAAe,eAAyB,CAAC;AAO/C,QAAA,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,mBAEjD,CAAC;AAEF,QAAA,MAAM,MAAM,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAyB,CAAC;AAC7F,QAAA,MAAM,MAAM,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC,CAAC,KAAG,CAA2B,CAAC;AAwElF,QAAA,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,CAAC,EAAE,QAAO,MAAW,KAAG,CAAC,EAahE,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,CAAC,KAAG,cAAc,CAAC,CAAC,CAW9D,CAAC;AAEF,QAAA,MAAM,MAAM,GAAI,CAAC,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,KAAG,mBAAmB,CAAC,CAAC,CAgBzE,CAAC;AAEF,QAAA,MAAM,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAgCtC,CAAC;AAIH,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACvF,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC"}

package/dist/schema/schema.js

@@ -0,0 +1,165 @@
+import { coder, destructureSimpleSchema, PRIMITIVE_TYPES_ARRAY, sortObjectEntries, textDecoder, textEncoder, } from "../utils/utils.js";
+const SchemaType = {
+    Null: -1,
+    Simple: 0,
+    Object: 1,
+    Tuple: 2,
+    Array: 3,
+    Optional: 4,
+    Custom: 5,
+};
+const optionalSchemaKey = Symbol("optionalSchema");
+const schemaSourceKey = Symbol("schemaSource");
+const schemaMap = new Map();
+const schemaSet = new Set();
+schemaMap.set(null, Object.freeze({ type: SchemaType.Null, [schemaSourceKey]: null }));
+const isCompiledSchema = (value) => schemaSet.has(value);
+const isCustomSchema = (value) => {
+    return schemaMap.get(value)?.type === SchemaType.Custom;
+};
+const schema = (value) => compileSchema(value);
+const source = (value) => value[schemaSourceKey];
+const compileSchema = (value) => {
+    if (schemaMap.has(value))
+        return schemaMap.get(value);
+    if (isCompiledSchema(value))
+        return value;
+    if (isCustomSchema(value))
+        return schemaMap.get(value);
+    let compiled;
+    if (value === null)
+        compiled = schemaMap.get(null);
+    else if (typeof value === "string") {
+        const ds = destructureSimpleSchema(value);
+        compiled = ds.isArray
+            ? {
+                type: SchemaType.Array,
+                [schemaSourceKey]: value,
+                schema: {
+                    type: SchemaType.Simple,
+                    [schemaSourceKey]: ds.base,
+                    base: ds.base,
+                    byteLength: ds.byteLength,
+                },
+                count: ds.arrayLength,
+            }
+            : {
+                type: SchemaType.Simple,
+                [schemaSourceKey]: value,
+                base: ds.base,
+                byteLength: ds.byteLength,
+            };
+    }
+    else if (typeof value === "object") {
+        compiled = Array.isArray(value)
+            ? { type: SchemaType.Tuple, [schemaSourceKey]: value, entries: [] }
+            : { type: SchemaType.Object, [schemaSourceKey]: value, entries: [] };
+        const stack = Array.isArray(value)
+            ? value.map((s) => [compiled, null, s]).reverse()
+            : sortObjectEntries(Object.entries(value))
+                .map((s) => [compiled, s[0], s[1]])
+                .reverse();
+        while (stack.length) {
+            const [parent, key, value] = stack.pop();
+            let compiled;
+            if (isCompiledSchema(value))
+                compiled = value;
+            else if (schemaMap.has(value))
+                compiled = schemaMap.get(value);
+            else if (typeof value === "string")
+                compiled = compileSchema(value);
+            else if (value === null)
+                compiled = compileSchema(value);
+            else if (isCustomSchema(value))
+                compiled = compileSchema(value);
+            else if (Array.isArray(value)) {
+                compiled = { type: SchemaType.Tuple, [schemaSourceKey]: value, entries: [] };
+                stack.push(...value.map((s) => [compiled, null, s]).reverse());
+            }
+            else if (typeof value === "object") {
+                compiled = { type: SchemaType.Object, [schemaSourceKey]: value, entries: [] };
+                stack.push(...sortObjectEntries(Object.entries(value))
+                    .map((s) => [compiled, s[0], s[1]])
+                    .reverse());
+            }
+            else
+                throw new Error("Invalid schema.");
+            if (parent.type === SchemaType.Object)
+                key && parent.entries.push([key, compiled]);
+            else if (parent.type === SchemaType.Tuple)
+                parent.entries.push(compiled);
+        }
+    }
+    else
+        throw new Error("Invalid schema.");
+    Object.freeze(compiled);
+    schemaMap.set(value, compiled);
+    schemaSet.add(compiled);
+    return compiled;
+};
+const array = (value, count = -1) => {
+    const compiled = {
+        type: SchemaType.Array,
+        [schemaSourceKey]: value,
+        schema: compileSchema(value),
+        count,
+    };
+    const placeholderSchema = [];
+    Object.freeze(compiled);
+    schemaMap.set(placeholderSchema, compiled);
+    schemaSet.add(compiled);
+    return placeholderSchema;
+};
+const optional = (value) => {
+    const placeholderSchema = { [optionalSchemaKey]: true, schema: value };
+    const compiled = Object.freeze({
+        type: SchemaType.Optional,
+        [schemaSourceKey]: value,
+        schema: compileSchema(value),
+    });
+    schemaMap.set(placeholderSchema, compiled);
+    schemaSet.add(compiled);
+    return placeholderSchema;
+};
+const custom = (handler) => {
+    if (!(typeof handler?.encode === "function" &&
+        typeof handler?.decode === "function" &&
+        typeof handler?.size === "function" &&
+        ("encodeInto" in handler ? typeof handler.encodeInto === "function" : true)))
+        throw new Error("Invalid custom schema handler.");
+    schemaMap.set(handler, Object.freeze({ type: SchemaType.Custom, [schemaSourceKey]: handler, handler }));
+    return handler;
+};
+const string = custom({
+    encode: (value) => {
+        const encoded = textEncoder.encode(value);
+        if (encoded.length > 2 ** 32 - 1)
+            throw new RangeError("Input length exceeds limit.");
+        const result = new Uint8Array(encoded.length + 4);
+        result.set(encoded, 4);
+        result.set(coder.encodeNumber(encoded.length), 0);
+        return result;
+    },
+    decode: (bytes, offset) => {
+        const dataLength = bytes.view.getUint32(offset, true);
+        const dataOffset = offset + 4;
+        return {
+            value: textDecoder.decode(bytes.array.subarray(dataOffset, dataOffset + dataLength)),
+            nextOffset: offset + 4 + dataLength,
+        };
+    },
+    encodeInto: (buffer, value) => {
+        const encoded = textEncoder.encode(value);
+        if (encoded.length > 2 ** 32 - 1)
+            throw new RangeError("Input length exceeds limit.");
+        buffer.ensureCapacity(encoded.length + 4);
+        buffer.view.setUint32(buffer.offset, encoded.length, true);
+        buffer.buffer.set(encoded, (buffer.offset += 4));
+        buffer.offset += encoded.length;
+        return null;
+    },
+    size: () => ({ value: 4, isVariable: true }),
+});
+PRIMITIVE_TYPES_ARRAY.map(schema); // Precompile schemas
+export { array, custom, isCustomSchema, optional, schema, SchemaType, source, string };
+//# sourceMappingURL=schema.js.map

package/dist/schema/schema.js.map

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

package/dist/schema/types.d.ts

@@ -0,0 +1,96 @@
+import type { GrowingBuffer } from "../utils/utils.ts";
+import type { SchemaType as _SchemaTypeMap, optionalSchemaKey, schemaSourceKey } from "./schema.ts";
+type KeysWithOptionalSchemas<T extends ObjectSchema> = {
+    [K in keyof T]: T[K] extends OptionalSchema<Schema> ? K : never;
+}[keyof T];
+export type PrimitiveType = "char" | `u${8 | 16 | 32}` | `i${8 | 16 | 32}` | `f${32 | 64}`;
+export type PrimitiveTypeMap = {
+    char: string;
+    u8: number;
+    u16: number;
+    u32: number;
+    i8: number;
+    i16: number;
+    i32: number;
+    f32: number;
+    f64: number;
+};
+export type SchemaTypeMap = typeof _SchemaTypeMap;
+export type SchemaType = SchemaTypeMap[keyof SchemaTypeMap];
+type CompiledNullSchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Null"];
+    [schemaSourceKey]: T;
+}>;
+type CompiledSimpleSchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Simple"];
+    [schemaSourceKey]: T;
+    base: PrimitiveType;
+    byteLength: number;
+}>;
+type CompiledObjectSchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Object"];
+    [schemaSourceKey]: T;
+    entries: [string, CompiledSchema][];
+}>;
+type CompiledTupleSchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Tuple"];
+    [schemaSourceKey]: T;
+    entries: CompiledSchema[];
+}>;
+type CompiledArraySchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Array"];
+    [schemaSourceKey]: T;
+    schema: CompiledSchema;
+    count: number;
+}>;
+type CompiledOptionalSchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Optional"];
+    [schemaSourceKey]: T;
+    schema: CompiledSchema;
+}>;
+type CompiledCustomSchema<T extends Schema> = Readonly<{
+    type: SchemaTypeMap["Custom"];
+    [schemaSourceKey]: T;
+    handler: CustomSchemaHandler;
+}>;
+export type CompiledSchema<T extends Schema = Schema> = CompiledNullSchema<T> | CompiledSimpleSchema<T> | CompiledObjectSchema<T> | CompiledTupleSchema<T> | CompiledArraySchema<T> | CompiledOptionalSchema<T> | CompiledCustomSchema<T>;
+export type StructDecodeResult<T> = {
+    value: T;
+    nextOffset: number;
+};
+export type SizeOfResult = {
+    value: number;
+    isVariable: boolean;
+};
+export interface CustomSchemaHandler<T = any> {
+    encode: (value: T) => Uint8Array<ArrayBuffer>;
+    encodeInto?: (buffer: GrowingBuffer, value: T) => null;
+    decode: (bytes: {
+        array: Uint8Array<ArrayBuffer>;
+        view: DataView<ArrayBuffer>;
+    }, offset: number) => StructDecodeResult<T>;
+    size: () => SizeOfResult;
+}
+export type SimpleSchema = `${PrimitiveType}${`[${number | ""}]` | ""}`;
+export type ObjectSchema = Readonly<{
+    [x: string]: Schema;
+}>;
+export type TupleSchema = Schema[];
+export type OptionalSchema<T extends Schema> = Readonly<{
+    [optionalSchemaKey]: true;
+    schema: T;
+}>;
+export type NullSchema = null;
+export type Schema = NullSchema | SimpleSchema | ObjectSchema | TupleSchema | CustomSchemaHandler | {
+    [schemaSourceKey]: Schema;
+};
+type DecodePrimitive<T extends SimpleSchema> = T extends PrimitiveType ? PrimitiveTypeMap[T] : T extends `${infer PT extends PrimitiveType}[${number | ""}]` ? PrimitiveTypeMap[PT][] : never;
+type DecodeTuple<T extends Schema[], Collector extends unknown[] = []> = any[] extends T ? T extends (infer ST extends Schema)[] ? Data<ST>[] : never : T extends [infer Schm extends Schema, ...infer Rest extends Schema[]] ? DecodeTuple<Rest, [...Collector, Data<Schm>]> : Collector;
+type DecodeObject<T extends ObjectSchema> = {
+    [K in Exclude<keyof T, KeysWithOptionalSchemas<T>>]: Data<T[K]>;
+} & {
+    [K in KeysWithOptionalSchemas<T>]?: Data<T[K]>;
+};
+export type Data<Schm extends Schema> = Schm extends NullSchema ? null : Schm extends OptionalSchema<infer T> ? Data<T> | undefined : Schm extends SimpleSchema ? DecodePrimitive<Schm> : Schm extends TupleSchema ? DecodeTuple<Schm> : Schm extends ObjectSchema ? DecodeObject<Schm> : Schm extends CustomSchemaHandler<infer CS> ? CS : Schm extends CompiledSchema<infer S> ? Data<S> : never;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

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

package/dist/schema/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":""}

package/dist/utils/types.d.ts

@@ -0,0 +1,19 @@
+import type { PrimitiveType } from "../schema/schema.ts";
+export interface DestructuredSimpleSchema {
+    base: PrimitiveType;
+    isArray: boolean;
+    byteLength: number;
+    arrayLength: number;
+}
+export interface GrowingBuffer {
+    buffer: Uint8Array<ArrayBuffer>;
+    view: DataView<ArrayBuffer>;
+    growthFactor: number;
+    offset: number;
+    updateGrowthFactor(value: number): null;
+    ensureCapacity(byteLength: number): null;
+    writeOne(value: number): null;
+    write(values: ArrayLike<number>): null;
+    finalise(): Uint8Array<ArrayBuffer>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAChC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;CACrC"}

package/dist/utils/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":""}

package/dist/utils/utils.d.ts

@@ -0,0 +1,21 @@
+import type { PrimitiveType, SimpleSchema } from "../schema/schema.ts";
+import type { DestructuredSimpleSchema, GrowingBuffer } from "./types.ts";
+export declare const PRIMITIVE_TYPES_ARRAY: ReadonlyArray<PrimitiveType>;
+export declare const PRIMITIVE_TYPES: ReadonlySet<PrimitiveType>;
+export declare const BITLENGTH_REGEX: RegExp;
+export declare const PRIMITIVE_TYPE_REGEX: RegExp;
+export declare const textEncoder: TextEncoder;
+export declare const textDecoder: TextDecoder;
+export declare const coder: {
+    encodeNumber: (value: number) => Uint8Array<ArrayBuffer>;
+    decodeNumber: (value: ArrayLike<number>) => number;
+    encodeString: (value: string) => Uint8Array<ArrayBuffer>;
+    decodeString: (x: ArrayLike<number>) => string;
+};
+export declare const getStringCodePoints: (value: string, guardFn?: (cp: number) => number) => number[];
+export declare const destructureSimpleSchema: (schema: SimpleSchema) => DestructuredSimpleSchema;
+export declare const sortObjectKeys: (a: PropertyKey, b: PropertyKey) => number;
+export declare const sortObjectEntries: <Key extends PropertyKey, Value>(entries: [Key, Value][]) => [Key, Value][];
+export declare const createGrowingBuffer: (initialSize?: number, growth?: number) => GrowingBuffer;
+export type * from "./types.ts";
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1E,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,aAAa,CAU7D,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,aAAa,CAAkC,CAAC;AAE1F,eAAO,MAAM,eAAe,QAAkB,CAAC;AAC/C,eAAO,MAAM,oBAAoB,QAGhC,CAAC;AAEF,eAAO,MAAM,WAAW,aAAoB,CAAC;AAC7C,eAAO,MAAM,WAAW,aAAoB,CAAC;AAK7C,eAAO,MAAM,KAAK;0BACM,MAAM,KAAG,UAAU,CAAC,WAAW,CAAC;0BAYhC,SAAS,CAAC,MAAM,CAAC,KAAG,MAAM;0BAM1B,MAAM,KAAG,UAAU,CAAC,WAAW,CAAC;sBACpC,SAAS,CAAC,MAAM,CAAC,KAAG,MAAM;CAC7C,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,aAWlF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,YAAY,KAAG,wBAkB9D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,GAAG,WAAW,EAAE,GAAG,WAAW,KAAG,MAM/D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,GAAG,SAAS,WAAW,EAAE,KAAK,EAC9D,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,KACtB,CAAC,GAAG,EAAE,KAAK,CAAC,EAEd,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,oBAAsB,EAAE,eAAU,KAAG,aA8CxE,CAAC;AAEF,mBAAmB,YAAY,CAAC"}

package/dist/utils/utils.js

@@ -0,0 +1,122 @@
+export const PRIMITIVE_TYPES_ARRAY = Object.freeze([
+    "char",
+    "u8",
+    "u16",
+    "u32",
+    "i8",
+    "i16",
+    "i32",
+    "f32",
+    "f64",
+]);
+export const PRIMITIVE_TYPES = new Set(PRIMITIVE_TYPES_ARRAY);
+export const BITLENGTH_REGEX = /(8|16|32|64)$/;
+export const PRIMITIVE_TYPE_REGEX = new RegExp(`^((?:${PRIMITIVE_TYPES_ARRAY.join("|")})+)(\\[([0-9])?\\])?$`, "i");
+export const textEncoder = new TextEncoder();
+export const textDecoder = new TextDecoder();
+// Math.log(256) -> 5.545177444479562
+const getByteCount = (x) => +!(x % 256) + Math.ceil(Math.log(x) / 5.545177444479562);
+export const coder = {
+    encodeNumber: (value) => {
+        const result = new Uint8Array(getByteCount(value));
+        let offset = 0;
+        do {
+            result[offset++] = value & 0xff;
+            value = Math.floor(value / 256);
+        } while (value);
+        return result;
+    },
+    decodeNumber: (value) => {
+        let result = 0;
+        for (let i = 0; i < value.length; result += (value[i] ?? 0) * 256 ** i++)
+            ;
+        return result;
+    },
+    encodeString: (value) => textEncoder.encode(value),
+    decodeString: (x) => textDecoder.decode(new Uint8Array(x)),
+};
+export const getStringCodePoints = (value, guardFn) => {
+    const codepoints = [];
+    if (typeof value !== "string")
+        throw new TypeError("value must be a string.");
+    if (guardFn) {
+        for (let i = 0; i < value.length; i++)
+            codepoints.push(guardFn(value.codePointAt(i) || 0));
+    }
+    else {
+        for (let i = 0; i < value.length; i++)
+            codepoints.push(value.codePointAt(i) || 0);
+    }
+    return codepoints;
+};
+export const destructureSimpleSchema = (schema) => {
+    const match = schema.match(PRIMITIVE_TYPE_REGEX);
+    if (!match)
+        throw new Error("Invalid struct.");
+    const [_input, base, array, arrayLength] = match;
+    const [_, _byteLength] = base?.match(BITLENGTH_REGEX) || [];
+    if (_byteLength == null && base !== "char")
+        throw new Error("Invalid struct.");
+    if (!PRIMITIVE_TYPES.has(base)) {
+        throw new Error(`Unknown primitive type: ${base}`);
+    }
+    return {
+        base: base,
+        isArray: array != null,
+        byteLength: base === "char" ? 1 : +_byteLength / 8,
+        arrayLength: arrayLength == null ? -1 : +arrayLength,
+    };
+};
+export const sortObjectKeys = (a, b) => {
+    const _a = String(a);
+    const _b = String(b);
+    if (_a < _b)
+        return -1;
+    if (_a > _b)
+        return 1;
+    return 0;
+};
+export const sortObjectEntries = (entries) => {
+    return entries.sort(([a], [b]) => sortObjectKeys(a, b));
+};
+export const createGrowingBuffer = (initialSize = 1024 * 4, growth = 2) => {
+    let buffer = new Uint8Array(initialSize);
+    return {
+        buffer: buffer,
+        view: new DataView(buffer.buffer),
+        growthFactor: growth > 1 ? growth : 2,
+        offset: 0,
+        updateGrowthFactor(value) {
+            if (!Number.isFinite(value))
+                throw new Error("Growth factor must be finite.");
+            if (value <= 1)
+                throw new Error("Growth factor must be greater than 1.");
+            this.growthFactor = value;
+            return null;
+        },
+        ensureCapacity(byteLength) {
+            if (this.buffer.byteLength >= this.offset + byteLength)
+                return null;
+            const newBuffer = new Uint8Array(Math.ceil(Math.max(this.buffer.byteLength * this.growthFactor, this.offset + byteLength)));
+            newBuffer.set(this.buffer, 0);
+            this.buffer = newBuffer;
+            this.view = new DataView(this.buffer.buffer);
+            return null;
+        },
+        writeOne(value) {
+            this.ensureCapacity(1);
+            this.buffer[this.offset++] = value;
+            return null;
+        },
+        write(values) {
+            this.ensureCapacity(values.length);
+            this.buffer.set(values, this.offset);
+            this.offset += values.length;
+            return null;
+        },
+        finalise() {
+            return this.buffer.slice(0, this.offset);
+        },
+    };
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils/utils.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "1n-destructure",
+  "version": "0.0.1-alpha.0",
+  "description": "A library for serialisation and deserialisation of structured data.",
+  "homepage": "https://github.com/1natsie/destructure#readme",
+  "author": "Oghenevwegba Obire",
+  "license": "MIT",
+  "keywords": [
+    "destructure",
+    "serialisation",
+    "binary-data",
+    "memory-manipulation",
+    "buffer"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "node ./scripts/build.js",
+    "build:watch": "node ./scripts/build-watch.js",
+    "dev": "node ./scripts/dev.js"
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    "./decode": {
+      "import": "./dist/decoder/decoder.js",
+      "types": "./dist/decoder/decoder.d.ts"
+    },
+    "./encode": {
+      "import": "./dist/encoder/encoder.js",
+      "types": "./dist/encoder/encoder.d.ts"
+    },
+    "./schema": {
+      "import": "./dist/schema/schema.js",
+      "types": "./dist/schema/schema.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.7.0",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3"
+  },
+  "bugs": {
+    "url": "https://github.com/1natsie/destructure/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1natsie/destructure.git"
+  }
+}