libwz 0.1.0

package/deps/zlib/zutil.h

@@ -0,0 +1,331 @@
+/* zutil.h -- internal interface and configuration of the compression library
+ * Copyright (C) 1995-2026 Jean-loup Gailly, Mark Adler
+ * For conditions of distribution and use, see copyright notice in zlib.h
+ */
+
+/* WARNING: this file should *not* be used by applications. It is
+   part of the implementation of the compression library and is
+   subject to change. Applications should only use zlib.h.
+ */
+
+/* @(#) $Id$ */
+
+#ifndef ZUTIL_H
+#define ZUTIL_H
+
+#ifdef HAVE_HIDDEN
+#  define ZLIB_INTERNAL __attribute__((visibility ("hidden")))
+#else
+#  define ZLIB_INTERNAL
+#endif
+
+#include "zlib.h"
+
+#if defined(STDC) && !defined(Z_SOLO)
+#  if !(defined(_WIN32_WCE) && defined(_MSC_VER))
+#    include <stddef.h>
+#  endif
+#  include <string.h>
+#  include <stdlib.h>
+#endif
+
+#ifndef local
+#  define local static
+#endif
+/* since "static" is used to mean two completely different things in C, we
+   define "local" for the non-static meaning of "static", for readability
+   (compile with -Dlocal if your debugger can't find static symbols) */
+
+extern const char deflate_copyright[];
+extern const char inflate_copyright[];
+extern const char inflate9_copyright[];
+
+typedef unsigned char  uch;
+typedef uch FAR uchf;
+typedef unsigned short ush;
+typedef ush FAR ushf;
+typedef unsigned long  ulg;
+
+#if !defined(Z_U8) && !defined(Z_SOLO) && defined(STDC)
+#  include <limits.h>
+#  if (ULONG_MAX == 0xffffffffffffffff)
+#    define Z_U8 unsigned long
+#  elif (ULLONG_MAX == 0xffffffffffffffff)
+#    define Z_U8 unsigned long long
+#  elif (ULONG_LONG_MAX == 0xffffffffffffffff)
+#    define Z_U8 unsigned long long
+#  elif (UINT_MAX == 0xffffffffffffffff)
+#    define Z_U8 unsigned
+#  endif
+#endif
+
+extern z_const char * const z_errmsg[10]; /* indexed by 2-zlib_error */
+/* (size given to avoid silly warnings with Visual C++) */
+
+#define ERR_MSG(err) z_errmsg[(err) < -6 || (err) > 2 ? 9 : 2 - (err)]
+
+#define ERR_RETURN(strm,err) \
+  return (strm->msg = ERR_MSG(err), (err))
+/* To be used only when the state is known to be valid */
+
+        /* common constants */
+#if MAX_WBITS < 9 || MAX_WBITS > 15
+#  error MAX_WBITS must be in 9..15
+#endif
+#ifndef DEF_WBITS
+#  define DEF_WBITS MAX_WBITS
+#endif
+/* default windowBits for decompression. MAX_WBITS is for compression only */
+
+#if MAX_MEM_LEVEL >= 8
+#  define DEF_MEM_LEVEL 8
+#else
+#  define DEF_MEM_LEVEL  MAX_MEM_LEVEL
+#endif
+/* default memLevel */
+
+#define STORED_BLOCK 0
+#define STATIC_TREES 1
+#define DYN_TREES    2
+/* The three kinds of block type */
+
+#define MIN_MATCH  3
+#define MAX_MATCH  258
+/* The minimum and maximum match lengths */
+
+#define PRESET_DICT 0x20 /* preset dictionary flag in zlib header */
+
+        /* target dependencies */
+
+#if defined(MSDOS) || (defined(WINDOWS) && !defined(WIN32))
+#  define OS_CODE  0x00
+#  ifndef Z_SOLO
+#    if defined(__TURBOC__) || defined(__BORLANDC__)
+#      if (__STDC__ == 1) && (defined(__LARGE__) || defined(__COMPACT__))
+         /* Allow compilation with ANSI keywords only enabled */
+         void _Cdecl farfree( void *block );
+         void *_Cdecl farmalloc( unsigned long nbytes );
+#      else
+#        include <alloc.h>
+#      endif
+#    else /* MSC or DJGPP */
+#      include <malloc.h>
+#    endif
+#  endif
+#endif
+
+#ifdef AMIGA
+#  define OS_CODE  1
+#endif
+
+#if defined(VAXC) || defined(VMS)
+#  define OS_CODE  2
+#  define F_OPEN(name, mode) \
+     fopen((name), (mode), "mbc=60", "ctx=stm", "rfm=fix", "mrs=512")
+#endif
+
+#ifdef __370__
+#  if __TARGET_LIB__ < 0x20000000
+#    define OS_CODE 4
+#  elif __TARGET_LIB__ < 0x40000000
+#    define OS_CODE 11
+#  else
+#    define OS_CODE 8
+#  endif
+#endif
+
+#if defined(ATARI) || defined(atarist)
+#  define OS_CODE  5
+#endif
+
+#ifdef OS2
+#  define OS_CODE  6
+#  if defined(M_I86) && !defined(Z_SOLO)
+#    include <malloc.h>
+#  endif
+#endif
+
+#if defined(MACOS)
+#  define OS_CODE  7
+#endif
+
+#if defined(__acorn) || defined(__riscos)
+#  define OS_CODE 13
+#endif
+
+#if defined(WIN32) && !defined(__CYGWIN__)
+#  define OS_CODE  10
+#endif
+
+#ifdef _BEOS_
+#  define OS_CODE  16
+#endif
+
+#ifdef __TOS_OS400__
+#  define OS_CODE 18
+#endif
+
+#ifdef __APPLE__
+#  define OS_CODE 19
+#endif
+
+#if defined(__BORLANDC__) && !defined(MSDOS)
+  #pragma warn -8004
+  #pragma warn -8008
+  #pragma warn -8066
+#endif
+
+/* provide prototypes for these when building zlib without LFS */
+#ifndef Z_LARGE64
+   ZEXTERN uLong ZEXPORT adler32_combine64(uLong, uLong, z_off64_t);
+   ZEXTERN uLong ZEXPORT crc32_combine64(uLong, uLong, z_off64_t);
+   ZEXTERN uLong ZEXPORT crc32_combine_gen64(z_off64_t);
+#endif
+
+        /* common defaults */
+
+#ifndef OS_CODE
+#  define OS_CODE  3     /* assume Unix */
+#endif
+
+#ifndef F_OPEN
+#  define F_OPEN(name, mode) fopen((name), (mode))
+#endif
+
+         /* functions */
+
+#if defined(pyr) || defined(Z_SOLO)
+#  define NO_MEMCPY
+#endif
+#if defined(SMALL_MEDIUM) && !defined(_MSC_VER) && !defined(__SC__)
+ /* Use our own functions for small and medium model with MSC <= 5.0.
+  * You may have to use the same strategy for Borland C (untested).
+  * The __SC__ check is for Symantec.
+  */
+#  define NO_MEMCPY
+#endif
+#if defined(STDC) && !defined(HAVE_MEMCPY) && !defined(NO_MEMCPY)
+#  define HAVE_MEMCPY
+#endif
+#ifdef HAVE_MEMCPY
+#  ifdef SMALL_MEDIUM /* MSDOS small or medium model */
+#    define zmemcpy _fmemcpy
+#    define zmemcmp _fmemcmp
+#    define zmemzero(dest, len) _fmemset(dest, 0, len)
+#  else
+#    define zmemcpy memcpy
+#    define zmemcmp memcmp
+#    define zmemzero(dest, len) memset(dest, 0, len)
+#  endif
+#else
+   void ZLIB_INTERNAL zmemcpy(void FAR *, const void FAR *, z_size_t);
+   int ZLIB_INTERNAL zmemcmp(const void FAR *, const void FAR *, z_size_t);
+   void ZLIB_INTERNAL zmemzero(void FAR *, z_size_t);
+#endif
+
+/* Diagnostic functions */
+#ifdef ZLIB_DEBUG
+#  include <stdio.h>
+   extern int ZLIB_INTERNAL z_verbose;
+   extern void ZLIB_INTERNAL z_error(char *m);
+#  define Assert(cond,msg) {if(!(cond)) z_error(msg);}
+#  define Trace(x) {if (z_verbose>=0) fprintf x ;}
+#  define Tracev(x) {if (z_verbose>0) fprintf x ;}
+#  define Tracevv(x) {if (z_verbose>1) fprintf x ;}
+#  define Tracec(c,x) {if (z_verbose>0 && (c)) fprintf x ;}
+#  define Tracecv(c,x) {if (z_verbose>1 && (c)) fprintf x ;}
+#else
+#  define Assert(cond,msg)
+#  define Trace(x)
+#  define Tracev(x)
+#  define Tracevv(x)
+#  define Tracec(c,x)
+#  define Tracecv(c,x)
+#endif
+
+#ifndef Z_SOLO
+   voidpf ZLIB_INTERNAL zcalloc(voidpf opaque, unsigned items,
+                                unsigned size);
+   void ZLIB_INTERNAL zcfree(voidpf opaque, voidpf ptr);
+#endif
+
+#define ZALLOC(strm, items, size) \
+           (*((strm)->zalloc))((strm)->opaque, (items), (size))
+#define ZFREE(strm, addr)  (*((strm)->zfree))((strm)->opaque, (voidpf)(addr))
+#define TRY_FREE(s, p) {if (p) ZFREE(s, p);}
+
+/* Reverse the bytes in a 32-bit value */
+#define ZSWAP32(q) ((((q) >> 24) & 0xff) + (((q) >> 8) & 0xff00) + \
+                    (((q) & 0xff00) << 8) + (((q) & 0xff) << 24))
+
+#ifdef Z_ONCE
+/*
+  Create a local z_once() function depending on the availability of atomics.
+ */
+
+/* Check for the availability of atomics. */
+#if defined(__STDC__) && __STDC_VERSION__ >= 201112L && \
+    !defined(__STDC_NO_ATOMICS__)
+
+#include <stdatomic.h>
+typedef struct {
+    atomic_flag begun;
+    atomic_int done;
+} z_once_t;
+#define Z_ONCE_INIT {ATOMIC_FLAG_INIT, 0}
+
+/*
+  Run the provided init() function exactly once, even if multiple threads
+  invoke once() at the same time. The state must be a once_t initialized with
+  Z_ONCE_INIT.
+ */
+local void z_once(z_once_t *state, void (*init)(void)) {
+    if (!atomic_load(&state->done)) {
+        if (atomic_flag_test_and_set(&state->begun))
+            while (!atomic_load(&state->done))
+                ;
+        else {
+            init();
+            atomic_store(&state->done, 1);
+        }
+    }
+}
+
+#else   /* no atomics */
+
+#warning zlib not thread-safe
+
+typedef struct z_once_s {
+    volatile int begun;
+    volatile int done;
+} z_once_t;
+#define Z_ONCE_INIT {0, 0}
+
+/* Test and set. Alas, not atomic, but tries to limit the period of
+   vulnerability. */
+local int test_and_set(int volatile *flag) {
+    int was;
+
+    was = *flag;
+    *flag = 1;
+    return was;
+}
+
+/* Run the provided init() function once. This is not thread-safe. */
+local void z_once(z_once_t *state, void (*init)(void)) {
+    if (!state->done) {
+        if (test_and_set(&state->begun))
+            while (!state->done)
+                ;
+        else {
+            init();
+            state->done = 1;
+        }
+    }
+}
+
+#endif /* ?atomics */
+
+#endif /* Z_ONCE */
+
+#endif /* ZUTIL_H */

package/dist/index.d.ts

@@ -0,0 +1,266 @@
+declare enum MapleVersion {
+    GMS = 0,
+    EMS = 1,
+    BMS = 2,
+    CLASSIC = 3,
+    GENERATE = 4,
+    GETFROMZLZ = 5,
+    CUSTOM = 6,
+    UNKNOWN = 99
+}
+declare enum ParseStatus {
+    PATH_IS_NULL = -1,
+    ERROR_GAME_VER_HASH = -2,
+    FAILED_UNKNOWN = 0,
+    SUCCESS = 1
+}
+declare enum PropertyType {
+    NULL = 0,
+    SHORT = 1,
+    INT = 2,
+    LONG = 3,
+    FLOAT = 4,
+    DOUBLE = 5,
+    STRING = 6,
+    SUB = 7,
+    CANVAS = 8,
+    VECTOR = 9,
+    CONVEX = 10,
+    SOUND = 11,
+    RAW = 12,
+    UOL = 13,
+    LUA = 14,
+    PNG = 15
+}
+declare enum ObjectType {
+    FILE = 0,
+    IMAGE = 1,
+    DIRECTORY = 2,
+    PROPERTY = 3,
+    LIST = 4
+}
+declare enum BinaryType {
+    RAW = 0,
+    MP3 = 1,
+    WAV = 2
+}
+declare class WzObject {
+    protected _ptr: NativeHandle;
+    protected _ownsNative: boolean;
+    constructor(ptr: NativeHandle, ownsNative?: boolean);
+    nativePtr(): NativeHandle;
+    protected _assertAlive(): void;
+    _markBorrowed(): void;
+    _markOwned(): void;
+    _markDisposed(): void;
+    _markBorrowedInstance(): void;
+    _markOwnedInstance(): void;
+    _markDisposedInstance(): void;
+    ownsNative(): boolean;
+    getObjectType(): ObjectType;
+    getName(): string;
+    getParent(): WzObject | null;
+    getFullPath(): string;
+    getWzFileParent(): WzFile | null;
+    getTopMostWzDirectory(): WzObject | null;
+    getTopMostWzImage(): WzObject | null;
+    at(name: string): WzObject | null;
+    setName(name: string): void;
+    remove(): void;
+    close(): void;
+    [Symbol.dispose](): void;
+}
+declare class WzFile extends WzObject {
+    private readonly disposeCallbacks;
+    static create(gameVersion: number, mapleVersion: MapleVersion): WzFile;
+    static fromBytes(name: string, bytes: Uint8Array, mapleVersion: MapleVersion): WzFile;
+    static fromBytes(name: string, bytes: Uint8Array, gameVersion: number, mapleVersion: MapleVersion): WzFile;
+    static fromBytes(name: string, bytes: Uint8Array, iv: NativeIv): WzFile;
+    static fromBlobSource(name: string, size: number, mapleVersion: MapleVersion, readRange: BlobReadRangeCallback): WzFile;
+    static fromBlobSource(name: string, size: number, gameVersion: number, mapleVersion: MapleVersion, readRange: BlobReadRangeCallback): WzFile;
+    static fromBlobSource(name: string, size: number, iv: NativeIv, readRange: BlobReadRangeCallback): WzFile;
+    constructor(path: string, mapleVersion?: MapleVersion);
+    constructor(path: string, gameVersion: number, mapleVersion: MapleVersion);
+    constructor(path: string, iv: NativeIv);
+    addDisposeCallback(callback: () => void): void;
+    parseWzFile(): ParseStatus;
+    saveToDisk(path: string): void;
+    getName(): string;
+    getFilePath(): string;
+    getVersion(): number;
+    getMapleVersion(): MapleVersion;
+    getWzDirectory(): WzDirectory | null;
+    is64BitWzFile(): boolean;
+    isUnloaded(): boolean;
+    getVersionHash(): number;
+    getObjectFromPath(path: string, checkFirstDirectoryName?: boolean): WzObject | null;
+    close(): void;
+}
+declare class WzDirectory extends WzObject {
+    getName(): string;
+    countImages(): number;
+    wzImages(): Array<WzImage | null>;
+    wzDirectories(): Array<WzDirectory | null>;
+    getImage(index: number): WzImage | null;
+    getImageByName(name: string): WzImage | null;
+    getDirectory(index: number): WzDirectory | null;
+    getDirectoryByName(name: string): WzDirectory | null;
+    createDirectory(name: string): WzDirectory;
+    createImage(name: string): WzImage;
+    removeDirectory(child: WzDirectory): void;
+    removeImage(child: WzImage): void;
+    getBlockSize(): number;
+    getChecksum(): number;
+    getOffset(): bigint;
+}
+declare class WzImage extends WzObject {
+    static fromFile(path: string, mapleVersion: MapleVersion): WzImage;
+    getName(): string;
+    isParsed(): boolean;
+    isChanged(): boolean;
+    getBlockSize(): number;
+    getChecksum(): number;
+    getOffset(): bigint;
+    isLuaWzImage(): boolean;
+    parseImage(): void;
+    wzProperties(): WzPropertyCollection;
+    getFromPath(path: string): WzImageProperty | null;
+    addProperty(prop: WzImageProperty): void;
+    removeProperty(prop: WzImageProperty): void;
+    clearProperties(): void;
+}
+declare class WzPropertyCollection extends Array<WzImageProperty> {
+    get(index: number): WzImageProperty | undefined;
+}
+declare class WzImageProperty extends WzObject {
+    getPropertyType(): PropertyType;
+    getName(): string;
+    wzProperties(): WzPropertyCollection;
+    getChild(index: number): WzImageProperty | null;
+    getChildByName(name: string): WzImageProperty | null;
+    getFromPath(path: string): WzImageProperty | null;
+    getLinkedWzImageProperty(): WzImageProperty | null;
+    getInt(): number;
+    getShort(): number;
+    getLong(): bigint;
+    getFloat(): number;
+    getDouble(): number;
+    getString(): string;
+    getBytes(): Uint8Array;
+    addProperty(child: WzImageProperty): void;
+    removeProperty(child: WzImageProperty): void;
+    clearProperties(): void;
+    close(): void;
+}
+declare class WzNullProperty extends WzImageProperty {
+}
+declare class WzShortProperty extends WzImageProperty {
+    getValue(): number;
+    setValue(value: number): void;
+}
+declare class WzIntProperty extends WzImageProperty {
+    getValue(): number;
+    setValue(value: number): void;
+}
+declare class WzLongProperty extends WzImageProperty {
+    getValue(): bigint;
+    setValue(value: bigint): void;
+}
+declare class WzFloatProperty extends WzImageProperty {
+    getValue(): number;
+    setValue(value: number): void;
+}
+declare class WzDoubleProperty extends WzImageProperty {
+    getValue(): number;
+    setValue(value: number): void;
+}
+declare class WzStringProperty extends WzImageProperty {
+    getValue(): string;
+    setValue(value: string): void;
+}
+declare class WzSubProperty extends WzImageProperty {
+}
+declare class WzCanvasProperty extends WzImageProperty {
+    getPngProperty(): WzPngProperty | null;
+    containsInlinkProperty(): boolean;
+    containsOutlinkProperty(): boolean;
+    getLinkedWzImageProperty(): WzImageProperty | null;
+    saveToFile(path: string): boolean;
+}
+declare class WzPngProperty extends WzImageProperty {
+    getWidth(): number;
+    getHeight(): number;
+    getFormat(): number;
+    isListWzUsed(): boolean;
+    getImage(): Uint8Array;
+    getCompressedBytes(): Uint8Array;
+    saveToFile(path: string): boolean;
+}
+declare class WzVectorProperty extends WzImageProperty {
+    getX(): number;
+    getY(): number;
+}
+declare class WzConvexProperty extends WzImageProperty {
+}
+declare class WzBinaryProperty extends WzImageProperty {
+    getBytes(): Uint8Array;
+    getWAVPlayback(): Uint8Array;
+    getLength(): number;
+    getFrequency(): number;
+    getType(): BinaryType;
+    isHeaderEncrypted(): boolean;
+    saveToFile(path: string): boolean;
+}
+declare class WzRawDataProperty extends WzImageProperty {
+    getBytes(): Uint8Array;
+    getRawType(): number;
+}
+declare class WzVideoProperty extends WzImageProperty {
+    getData(): Uint8Array;
+}
+declare class WzUOLProperty extends WzImageProperty {
+    getValue(): string;
+    setValue(value: string): void;
+    getLinkValue(): WzObject | null;
+}
+declare class WzLuaProperty extends WzImageProperty {
+    getData(): Uint8Array;
+    getString(): string;
+}
+declare class WzProperty {
+    static createNull(name: string): WzImageProperty;
+    static createShort(name: string, value: number): WzShortProperty;
+    static createInt(name: string, value: number): WzIntProperty;
+    static createLong(name: string, value: bigint): WzLongProperty;
+    static createFloat(name: string, value: number): WzFloatProperty;
+    static createDouble(name: string, value: number): WzDoubleProperty;
+    static createString(name: string, value: string): WzStringProperty;
+    static createSub(name: string): WzSubProperty;
+    static createVector(name: string, x: number, y: number): WzVectorProperty;
+    static createUol(name: string, value: string): WzUOLProperty;
+    static createCanvasFromPng(name: string, path: string): WzCanvasProperty;
+}
+declare const WzTool: Readonly<{
+    detectMapleVersion(path: string): DetectedMapleVersion;
+    getIvForVersion(version: MapleVersion): Uint8Array;
+}>;
+
+type NativeHandle = bigint;
+type NativeIv = Uint8Array;
+interface DetectedMapleVersion {
+    mapleVersion: MapleVersion;
+    version: number;
+}
+type BlobReadRangeCallback = (offset: number, length: number, destination?: Uint8Array) => Uint8Array | undefined;
+
+type WzBindingType = 'native' | 'wasm';
+declare function getWzBindingType(): WzBindingType;
+
+interface WzInitOptions {
+    forceWasm?: boolean;
+}
+declare function init(options?: WzInitOptions): Promise<void>;
+declare function init(wasmUrl: string | URL, options?: WzInitOptions): Promise<void>;
+
+export { BinaryType, MapleVersion, ObjectType, ParseStatus, PropertyType, WzBinaryProperty, WzCanvasProperty, WzConvexProperty, WzDirectory, WzDoubleProperty, WzFile, WzFloatProperty, WzImage, WzImageProperty, WzIntProperty, WzLongProperty, WzLuaProperty, WzNullProperty, WzObject, WzPngProperty, WzProperty, WzPropertyCollection, WzRawDataProperty, WzShortProperty, WzStringProperty, WzSubProperty, WzTool, WzUOLProperty, WzVectorProperty, WzVideoProperty, getWzBindingType, init };
+export type { DetectedMapleVersion, WzInitOptions };