@chilkat/react-native 11.6.1

package/src/specs/Zip.nitro.ts

@@ -0,0 +1,1611 @@
+// Generated by ReactNativeNs.RnGenerator -- do not edit.
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { BinData } from './BinData.nitro'
+import type { StringArray } from './StringArray.nitro'
+import type { StringBuilder } from './StringBuilder.nitro'
+import type { ZipEntry } from './ZipEntry.nitro'
+
+/**
+ * Create, read, modify, encrypt, and extract ZIP archives.
+ *
+ * `Zip` provides a comprehensive API for working with ZIP
+ * archives from files, memory, `BinData`, embedded resources, and
+ * Windows self-extracting EXEs. It can create new archives, open existing ZIPs,
+ * add files or in-memory data, inspect entries, extract selectively, and write
+ * the final archive to disk or memory.
+ *
+ * **Create ZIP archives**
+ *
+ * Add files, directories, strings, byte arrays, `BinData`, and
+ * `StringBuilder` content.
+ *
+ * **Open ZIPs from many sources**
+ *
+ * Open archives from disk, memory, `BinData`, embedded Windows
+ * resources, or Chilkat-created self-extracting EXEs.
+ *
+ * **Control stored paths**
+ *
+ * Use options such as `AppendFromDir`, `DiscardPaths`,
+ * `PathPrefix`, and `saveExtraPath`.
+ *
+ * **Extract selectively**
+ *
+ * Extract all files, matching entries, newer files, or flatten all output
+ * into a single directory.
+ *
+ * **Encryption support**
+ *
+ * Work with WinZip-compatible AES encryption and legacy Zip 2.0 password
+ * protection.
+ *
+ * **Large archive support**
+ *
+ * ZIP64 is used automatically when older ZIP limits are exceeded.
+ *
+ * **Important:**
+ * Many methods update the in-memory ZIP object first. The archive is not
+ * written until a method such as `WriteZip`,
+ * `WriteZipAndClose`, `WriteBd`, or
+ * `WriteToMemory` is called.
+ *
+ * For an extended overview, see
+ * [Zip Class Overview](https://www.chilkatsoft.com/zip_class_overview.asp).
+ *
+ * Each `Zip` instance owns a native Chilkat object. It is released when the JavaScript object is
+ * garbage collected, or immediately by `dispose()`; any use after `dispose()` throws.
+ * Create one with `new Zip()`.
+ *
+ * Methods that can take a while (network, files, compression, key generation) also have an
+ * `...Async` form returning a `Promise`; it runs on a native worker thread so the UI keeps
+ * rendering. While such a call is pending, every other call on this object throws, except
+ * {@link Zip.abort} and assigning {@link Zip.onPercentDone} / {@link Zip.onProgressInfo}.
+ */
+export interface Zip extends HybridObject<{ ios: 'c++', android: 'c++' }> {
+  // ---- Properties ----
+
+  /**
+   * Provides HTML-formatted information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorHtml: string
+
+  /**
+   * Provides plain text information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorText: string
+
+  /**
+   * Provides XML-formatted information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorXml: string
+
+  /**
+   * Version of the component/library, such as "10.1.0"
+   *
+   * This property is read-only.
+   */
+  readonly version: string
+
+  /**
+   * If set to a file path, this property logs the LastErrorText of each Chilkat method or property
+   * call to the specified file. This logging helps identify the context and history of Chilkat
+   * calls leading up to any crash or hang, aiding in debugging.
+   *
+   * Enabling the VerboseLogging property provides more detailed information.
+   *
+   * This property is mainly used for debugging rare instances where a Chilkat method call causes a
+   * hang or crash, which should generally not happen.
+   *
+   * Possible causes of hangs include:
+   *
+   * - A timeout property set to 0, indicating an infinite timeout.
+   *
+   * - A hang occurring within an event callback in the application code.
+   *
+   * - An internal bug in the Chilkat code causing the hang.
+   */
+  debugLogFilePath: string
+
+  /**
+   * If set to `true`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may
+   * contain more verbose information. The default value is `false`. Verbose logging should only be
+   * used for debugging. The potentially large quantity of logged information may adversely affect
+   * peformance.
+   */
+  verboseLogging: boolean
+
+  /**
+   * Indicates the success or failure of the most recent method call: `true` means success, `false`
+   * means failure. This property remains unchanged by property setters or getters. This method is
+   * present to address challenges in checking for null or Nothing returns in certain programming
+   * languages. Note: This property does not apply to methods that return integer values or to
+   * boolean-returning methods where the boolean does not indicate success or failure.
+   */
+  lastMethodSuccess: boolean
+
+  /**
+   * Stops the currently executing operation when set to `_TRUE_`.
+   *
+   * - Used to cancel long-running operations such as compression or extraction.
+   *
+   * - Can be triggered from another thread.
+   *
+   * - Automatically resets to `_FALSE_` after the operation stops.
+   */
+  abortCurrent: boolean
+
+  /**
+   * Specifies a base directory when adding files to the ZIP.
+   *
+   * - This portion of the path is **not included** in stored ZIP entry paths.
+   *
+   * - Useful for controlling relative paths inside the archive.
+   *
+   * For example, to add all files under `c:/abc/123/myAppDir`, this property could be set to
+   * `c:/abc/123`, and `myAppDir/*` would be passed to `AppendFiles`.
+   *
+   * The path stored in the ZIP would begin with `myAppDir/`.
+   */
+  appendFromDir: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Specifies the name of an executable inside a self-extracting EXE that runs automatically after
+   * extraction.
+   */
+  autoRun: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Command-line arguments passed to the `AutoRun` executable.
+   */
+  autoRunParams: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * If `_TRUE_`, the EXE being created will automatically select and create a temporary directory
+   * for unzipping.
+   *
+   * This property is often used together with `AutoRun` to create a self-extracting EXE that
+   * automatically unzips to a temporary directory and runs a setup program, such as `setup.exe`,
+   * without user interaction.
+   *
+   * **Note:** To create a self-extracting EXE with no user interaction, set the following
+   * properties:
+   *
+   * `ExeSilentProgress = _FALSE_`
+   *
+   * `ExeNoInterface = _TRUE_`
+   *
+   * `ExeFinishNotifier = _FALSE_`
+   *
+   * The default value is `_FALSE_`.
+   */
+  autoTemp: boolean
+
+  /**
+   * Controls whether filename matching is case-sensitive.
+   *
+   * - Affects methods such as `EntryMatching` and `UnzipMatching`.
+   *
+   * - Default: `_FALSE_`
+   */
+  caseSensitive: boolean
+
+  /**
+   * `(Windows only)`
+   *
+   * If `_TRUE_`, clears the Windows archive attribute after files are successfully added to the
+   * ZIP.
+   *
+   * The archive attribute indicates that a file has changed since the last backup.
+   *
+   * The default value is `_FALSE_`.
+   */
+  clearArchiveAttribute: boolean
+
+  /**
+   * If `_TRUE_`, removes the read-only attribute from extracted files.
+   *
+   * If `_FALSE_`, the read-only attribute remains unchanged.
+   *
+   * The default value is `_FALSE_`.
+   */
+  clearReadOnlyAttr: boolean
+
+  /**
+   * Sets or retrieves the global ZIP file comment.
+   *
+   * The default value is the empty string.
+   */
+  comment: string
+
+  /**
+   * Password used to extract encrypted ZIP archives.
+   *
+   * - Required to unzip encrypted entries.
+   *
+   * - Encrypted ZIP files may still be opened without a password, but their contents cannot be
+   *   extracted until the correct password is provided.
+   *
+   * The default value is the empty string.
+   */
+  decryptPassword: string
+
+  /**
+   * If `_TRUE_`, removes all directory path information when adding files.
+   *
+   * Only filenames are stored in the ZIP.
+   *
+   * The default value is `_FALSE_`.
+   */
+  discardPaths: boolean
+
+  /**
+   * Specifies the AES encryption key length.
+   *
+   * - Valid values: `128`, `192`, or `256`
+   *
+   * The default value is `128`.
+   */
+  encryptKeyLength: number
+
+  /**
+   * Password used when creating encrypted ZIP archives.
+   *
+   * The default value is the empty string.
+   */
+  encryptPassword: string
+
+  /**
+   * Specifies encryption mode:
+   *
+   * - `0` → No encryption
+   *
+   * - `4` → WinZip-compatible AES encryption
+   *
+   * **Important:** `Encryption` and `PasswordProtect` are mutually exclusive.
+   *
+   * If `PasswordProtect = _TRUE_`, then `Encryption` should be `0`.
+   *
+   * The default value is `0`.
+   */
+  encryption: number
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Default extraction directory shown in the self-extracting EXE user interface.
+   *
+   * The default value is the empty string.
+   */
+  exeDefaultDir: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * If `_TRUE_`, displays a completion dialog after extraction finishes.
+   *
+   * The default value is `_FALSE_`.
+   */
+  exeFinishNotifier: boolean
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Path to an `.ico` file used as the EXE icon.
+   *
+   * This feature is only available when the application creating the EXE is 32-bit.
+   *
+   * The default value is the empty string.
+   */
+  exeIconFile: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * If `_TRUE_`, runs the self-extracting EXE without displaying the main user interface.
+   *
+   * The default value is `_FALSE_`.
+   */
+  exeNoInterface: boolean
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Controls whether a progress dialog is shown during extraction.
+   *
+   * If `ExeNoInterface = _FALSE_`, the progress bar appears within the main dialog and this
+   * property has no effect.
+   *
+   * The default value is `_FALSE_`.
+   */
+  exeSilentProgress: boolean
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Title displayed in the self-extracting EXE dialog.
+   *
+   * The default value is the empty string.
+   */
+  exeTitle: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Caption text displayed in the self-extracting EXE dialog.
+   *
+   * The default value is the empty string.
+   */
+  exeUnzipCaption: string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Specifies a predefined extraction directory.
+   *
+   * - Supports environment variables such as `%TEMP%`.
+   *
+   * - UNC paths are not supported.
+   *
+   * The default value is the empty string.
+   */
+  exeUnzipDir: string
+
+  /**
+   * If `_TRUE_`, waits for the AutoRun executable to finish before exiting.
+   *
+   * If `_FALSE_`, the self-extracting EXE may exit before the AutoRun executable completes.
+   *
+   * The default value is `_TRUE_`.
+   */
+  exeWaitForSetup: boolean
+
+  /**
+   * Allows for an XML config document to be used to specify all possible options for
+   * self-extracting EXEs. This property is a string containing the XML config document.
+   *
+   * The XML should have this format:
+   *
+   * \<SfxConfig\>
+   *
+   * \<ErrPwdTitle\>Title for incorrect password dialog\</ErrPwdTitle\>
+   *
+   * \<ErrPwdCaption\>Caption for incorrect password dialog\</ErrPwdCaption\>
+   *
+   * \<FinOkBtn\>Text on finish notifier button\</FinOkBtn\>
+   *
+   * \<PwdOkBtn\>Text on password challenge dialog's "OK" button.\</PwdOkBtn\>
+   *
+   * \<PwdCancelBtn\>Text on password challenge dialog's Cancel button.\</PwdCancelBtn\>
+   *
+   * \<ErrInvalidPassword\>Incorrect password error message.\</ErrInvalidPassword\>
+   *
+   * \<MainUnzipBtn\>Text on main dialog's unzip button.
+   * **Note:** The `MainUnzipLabel` must also be set for this to take effect.\</MainUnzipBtn\>
+   *
+   * \<MainCloseBtn\>Text on main dialog's quit/exit button.
+   * **Note:** The `MainUnzipLabel` must also be set for this to take effect.\</MainCloseBtn\>
+   *
+   * \<MainBrowseBtn\>Text on main dialog's browse-for-directory button.
+   * **Note:** The `MainUnzipLabel` must also be set for this to take effect.\</MainBrowseBtn\>
+   *
+   * \<MainUnzipLabel\>Caption displayed in main dialog.\</MainUnzipLabel\>
+   *
+   * \<AutoTemp\>0 or 1 (Maps to the `AutoTemp` property)\</AutoTemp\>
+   *
+   * \<Cleanup\>0 or 1 (If 1, extracted files are deleted after the `SetupExe` is run.)\</Cleanup\>
+   *
+   * \<Debug\>0 or 1 (If 1, the EXE will not extract any files.)\</Debug\>
+   *
+   * \<Verbose\>0 or 1 (If 1, verbose information is written to the log.)\</Verbose\>
+   *
+   * \<ShowFin\>0 or 1 (Maps to the `ExeFinishNotifier` property)\</ShowFin\>
+   *
+   * \<ShowMain\>0 or 1 (Maps to the `ExeNoInterface` property)\</ShowMain\>
+   *
+   * \<ShowProgress\>0 or 1 (Maps to the `ExeSilentProgress` property)\</ShowProgress\>
+   *
+   * \<WaitForSetup\>0 or 1 (Maps to the `ExeWaitForSetup` property)\</WaitForSetup\>
+   *
+   * \<Encryption\>0 or 1 (1 = Yes, 0 = No)\</Encryption\>
+   *
+   * \<KeyLength\>128|192|256\</KeyLength\>
+   *
+   * \<SetupExe\>EXE to run after extracting. (Maps to the `AutoRun` property)\</SetupExe\>
+   *
+   * \<UnzipDir\>Pre-defined unzip directory. (Maps to the `ExeUnzipDir` property. UNC paths, such
+   * as \\\\servername\\path, are not supported.)\</UnzipDir\>
+   *
+   * \<DefaultDir\>Default unzip directory to appear in the main dialog. (Maps to the
+   * `ExeDefaultDir` property)\</DefaultDir\>
+   *
+   * \<IconFile\>Icon file to be used (Maps to the `ExeIconFile` property)\</IconFile\>
+   *
+   * \<MainTitle\>Maps to the `ExeTitle` property.\</MainTitle\>
+   *
+   * \<MainCaption\>Maps to the `ExeUnzipCaption` property.\</MainCaption\>
+   *
+   * \<FinTitle\>Title for the finish notifier dialog.\</FinTitle\>
+   *
+   * \<FinCaption\>Caption for the finish notifier dialog.\</FinCaption\>
+   *
+   * \<ProgressTitle\>Title for the progress dialog.\</ProgressTitle\>
+   *
+   * \<ProgressCaption\>Caption for the progress dialog.\</ProgressCaption\>
+   *
+   * \<PwTitle\>Title for the password challenge dialog.\</PwTitle\>
+   *
+   * \<PwCaption\>Caption for the password challenge dialog.\</PwCaption\>
+   *
+   * \</SfxConfig\>
+   *
+   * A self-extracting EXE can be run from the command line with the
+   * `-log {logFilePath}` option to create a log with information for debugging.
+   */
+  exeXmlConfig: string
+
+  /**
+   * Number of files in the ZIP, excluding directory entries.
+   *
+   * This property is read-only.
+   */
+  readonly fileCount: number
+
+  /**
+   * Path of the ZIP file to be written or overwritten.
+   *
+   * The default value is the empty string.
+   */
+  fileName: string
+
+  /**
+   * Indicates whether minor ZIP format problems were detected when opening the ZIP archive.
+   *
+   * This property is read-only.
+   */
+  readonly hasZipFormatErrors: boolean
+
+  /**
+   * Interval, in milliseconds, between abort-check callbacks.
+   *
+   * If set to `0`, abort callbacks are disabled.
+   *
+   * The default value is `0`.
+   */
+  heartbeatMs: number
+
+  /**
+   * If `_TRUE_`, files that cannot be read, written, or created due to filesystem permission errors
+   * are skipped.
+   *
+   * If `_FALSE_`, any access-denied error causes the ZIP operation to fail.
+   *
+   * The default value is `_TRUE_`.
+   */
+  ignoreAccessDenied: boolean
+
+  /**
+   * Total number of entries in the ZIP, including both files and directories.
+   *
+   * This property is read-only.
+   */
+  readonly numEntries: number
+
+  /**
+   * Specifies the OEM code page used for ZIP filename encoding.
+   *
+   * Defaults to the OEM code page of the current computer.
+   */
+  oemCodePage: number
+
+  /**
+   * If `_TRUE_`, existing files are overwritten during extraction.
+   *
+   * The default value is `_TRUE_`.
+   */
+  overwriteExisting: boolean
+
+  /**
+   * Indicates whether the ZIP uses legacy Zip 2.0 password protection.
+   *
+   * This property is set automatically when a ZIP archive is opened by any of the `Open*` methods,
+   * such as `OpenZip`, `OpenFromMemory`, `OpenBd`, and related methods.
+   *
+   * **Important:** `PasswordProtect` and `Encryption` are mutually exclusive.
+   *
+   * If `PasswordProtect = _TRUE_`, then `Encryption` should be `0`.
+   *
+   * The default value is `_FALSE_`.
+   */
+  passwordProtect: boolean
+
+  /**
+   * Gets or sets a path prefix that is prepended to ZIP entry paths for
+   * files appended from the local filesystem.
+   *
+   * This is useful when you want all extracted files to appear under a specific subdirectory.
+   *
+   * This property affects only the following methods:
+   *
+   * -
+   * `AppendFiles`
+   *
+   * -
+   * `AppendFilesEx`
+   *
+   * -
+   * `AddFile`
+   *
+   * -
+   * `AppendOneFileOrDir`
+   *
+   * The `PathPrefix` value is prepended to the stored ZIP
+   * path for each appended filesystem file.
+   *
+   * For example, set PathPrefix to subdir/ so that files are stored in the ZIP with subdir/
+   * prepended to their paths. When extracted, the files will be placed under the subdir directory.
+   *
+   * This property does not affect entries added entirely from memory,
+   * such as entries added using:
+   *
+   * -
+   * `AddString`
+   *
+   * -
+   * `AddData`
+   *
+   * -
+   * `AddBd`
+   *
+   * -
+   * `AddSb`
+   *
+   * For in-memory entries, the ZIP entry path is determined solely by
+   * the filename/path argument passed to the method.
+   *
+   * The default value is the empty string.
+   */
+  pathPrefix: string
+
+  /**
+   * Controls the granularity of PercentDone event callbacks.
+   *
+   * This property is only applicable in programming environments that support event callbacks.
+   *
+   * The value specifies what should be considered `100%` complete for progress reporting purposes.
+   *
+   * - A value of `100` provides whole-percent progress updates.
+   *
+   * - A value of `1000` provides tenth-percent granularity.
+   *
+   * - For example, with a scale of `1000`, a PercentDone callback value of `453` represents `45.3%`
+   *   complete.
+   *
+   * Increasing this value allows for more frequent and finer-grained progress callbacks during
+   * long-running operations.
+   *
+   * The value is automatically clamped to the range:
+   *
+   * - Minimum: `10`
+   *
+   * - Maximum: `100000`
+   *
+   * The default value is `100`.
+   */
+  percentDoneScale: number
+
+  /**
+   * Directory used for temporary files during ZIP operations.
+   *
+   * When overwriting an existing ZIP file, a temporary file is used to avoid corrupting the
+   * original ZIP if an error occurs.
+   *
+   * The default value depends on the runtime environment.
+   */
+  tempDir: string
+
+  /**
+   * If `_TRUE_`, creates ZIPX archives using the most appropriate compression method for each file.
+   *
+   * The default value is `_FALSE_`.
+   */
+  zipx: boolean
+
+  /**
+   * Default compression algorithm used when creating ZIPX archives.
+   *
+   * - Possible values include:
+   *
+   * - `deflate`
+   *
+   * - `ppmd`
+   *
+   * - `lzma`
+   *
+   * - `bzip2`
+   *
+   * - `deflate64`
+   *
+   * The default value is `deflate`.
+   */
+  zipxDefaultAlg: string
+
+  /**
+   * Specifies the character encoding used to convert the decrypt password into its binary byte
+   * representation for legacy password-protected ZIP archives that use Zip 2.0 encryption.
+   *
+   * The default value is `ansi`.
+   *
+   * Other possible values include:
+   *
+   * - `cp850`
+   *
+   * - `cp437`
+   *
+   * - Any supported Windows or OEM code page listed at the link below.
+   *
+   * This property applies only to older Zip 2.0 password protection and is not used for
+   * AES-encrypted ZIP archives.
+   */
+  pwdProtCharset: string
+
+  /**
+   * Advanced options for uncommon scenarios.
+   *
+   * - `ForceZip64` → Forces ZIP64 format even when not required.
+   *
+   * The default value is the empty string.
+   */
+  uncommonOptions: string
+
+  /**
+   * Prevents extraction of files larger than the specified uncompressed size.
+   *
+   * A value of `0` means no size limit.
+   *
+   * The default value is `0`.
+   */
+  maxUncompressSize: number
+
+  /**
+   * Minimum last-modified timestamp for files processed during add or extract operations.
+   *
+   * Supports ISO 8601 date/time formats, including:
+   *
+   * - `YYYY-MM-DD`
+   *   Example: `2024-07-31`
+   *
+   * - `YYYY-MM-DDTHH:MM:SS±HH:MM`
+   *   Example: `2024-07-31T12:34:56+02:00`
+   *
+   * - `YYYY-MM-DDTHH:MM:SSZ`
+   *   Example: `2024-07-31T12:34:56Z`
+   *
+   * The default value is the empty string, meaning no minimum date restriction.
+   */
+  minDate: string
+
+  /**
+   * Maximum last-modified timestamp for files processed during add or extract operations.
+   *
+   * Files having modification timestamps later than this value are skipped.
+   *
+   * Supports ISO 8601 date/time formats, including:
+   *
+   * - `YYYY-MM-DD`
+   *   Example: `2024-07-31`
+   *
+   * - `YYYY-MM-DDTHH:MM:SS±HH:MM`
+   *   Example: `2024-07-31T12:34:56+02:00`
+   *
+   * - `YYYY-MM-DDTHH:MM:SSZ`
+   *   Example: `2024-07-31T12:34:56Z`
+   *
+   * The default value is the empty string, meaning no maximum date restriction.
+   */
+  maxDate: string
+
+  // ---- Methods ----
+
+  /**
+   * Adds a file extension to the internal "no-compression" list.
+   *
+   * Files having these extensions are stored without compression because they are already
+   * compressed or because compression would provide little benefit.
+   *
+   * For example:
+   *
+   * - `.zip`
+   *
+   * - `.jpg`
+   *
+   * - `.png`
+   *
+   * - `.gz`
+   *
+   * The extension may be specified with or without the leading dot.
+   *
+   * Additional extensions remain active for the lifetime of the Zip object unless removed with
+   * `RemoveNoCompressExtension`.
+   */
+  addNoCompressExtension(fileExtension: string): void
+
+  /**
+   * Adds one or more files matching a wildcard pattern.
+   *
+   * - The wildcard character `*` matches zero or more characters.
+   *
+   * - If `recurse = _TRUE_`, subdirectories are processed recursively.
+   *
+   * - If `recurse = _FALSE_`, only the current directory is searched.
+   *
+   * For example:
+   *
+   * `AppendFiles("c:/temp/*.txt", _FALSE_)`
+   *
+   * This method only updates the in-memory ZIP object. The ZIP file itself is not written until a
+   * `Write*` method is called.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.appendFilesAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  appendFiles(filePattern: string, recurse: boolean): void
+
+  /**
+   * Asynchronous form of {@link Zip.appendFiles}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  appendFilesAsync(filePattern: string, recurse: boolean): Promise<void>
+
+  /**
+   * Advanced version of `AppendFiles` with additional filtering and path options.
+   *
+   * - `saveExtraPath` controls whether the extra leading path information from the `filePattern` is
+   *   preserved in the ZIP.
+   *
+   * - `archiveOnly` applies only on Windows and limits processing to files having the archive
+   *   attribute set.
+   *
+   * - `includeHidden` controls whether hidden files are included.
+   *
+   * - `includeSystem` controls whether files with the System attribute are included.
+   *
+   * This method adds references to files in the in-memory ZIP object. No ZIP file is written until
+   * a `Write*` method is called.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.appendFilesExAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  appendFilesEx(filePattern: string, recurse: boolean, saveExtraPath: boolean, archiveOnly: boolean, includeHidden: boolean, includeSystem: boolean): void
+
+  /**
+   * Asynchronous form of {@link Zip.appendFilesEx}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  appendFilesExAsync(filePattern: string, recurse: boolean, saveExtraPath: boolean, archiveOnly: boolean, includeHidden: boolean, includeSystem: boolean): Promise<void>
+
+  /**
+   * **Note:** This method is currently not working and will be fixed in v11.5.0
+   *
+   * Adds all entries from another existing ZIP archive into the current ZIP object.
+   *
+   * The `zipPath` argument specifies the path of a ZIP file located in the local filesystem.
+   *
+   * All entries from the specified ZIP archive are appended to the current in-memory ZIP object.
+   *
+   * The ZIP archive itself is not rewritten until a `Write*` method is called.
+   *
+   * This method is useful for merging the contents of multiple ZIP archives into a single ZIP.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  appendZip(zipPath: string): void
+
+  /**
+   * Closes the currently open ZIP archive and clears all entries from the Zip object.
+   *
+   * This method has the same effect as calling `NewZip` without specifying a filename.
+   */
+  closeZip(): void
+
+  /**
+   * Removes a ZIP entry from the current ZIP object.
+   *
+   * The ZIP file itself is not rewritten until a `Write*` method is called.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  deleteEntry(entry: ZipEntry): void
+
+  /**
+   * Adds a directory name to the exclusion list used by recursive append operations.
+   *
+   * - All directories having the specified name are skipped.
+   *
+   * - The comparison is case-insensitive.
+   *
+   * - Call multiple times to exclude multiple directory names.
+   *
+   * This affects methods such as `AppendFiles` and `AppendFilesEx`.
+   */
+  excludeDir(dirName: string): void
+
+  /**
+   * Extracts files from a Chilkat-created self-extracting EXE.
+   *
+   * - Files are extracted into `dirPath`.
+   *
+   * - Subdirectories are automatically created as needed.
+   *
+   * - If the EXE is encrypted, `DecryptPassword` must be set before extraction.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.extractExeAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  extractExe(exePath: string, dirPath: string): void
+
+  /**
+   * Asynchronous form of {@link Zip.extractExe}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  extractExeAsync(exePath: string, dirPath: string): Promise<void>
+
+  /**
+   * Returns the ZIP directory structure as an XML document.
+   *
+   * The returned XML contains information about the entries currently contained within the ZIP
+   * archive, including files and directories.
+   *
+   * This method is useful for inspecting ZIP contents without extracting files.
+   *
+   * Returns the XML document as a string.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  getDirectoryAsXML(): string
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Returns the value of a configuration parameter embedded within a self-extracting EXE.
+   *
+   * The `name` argument should be one of the XML tag names described in the `ExeXmlConfig` property
+   * documentation.
+   *
+   * For example:
+   *
+   * - `MainTitle`
+   *
+   * - `MainCaption`
+   *
+   * - `SetupExe`
+   *
+   * Returns the parameter value as a string.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  getExeConfigParam(name: string): string
+
+  /**
+   * Checks whether a file extension is contained in the internal "no-compression" extension list.
+   *
+   * Files having extensions in this list are stored without compression because they are typically
+   * already compressed.
+   *
+   * The extension may be specified with or without the leading dot.
+   *
+   * For example, both of the following are valid:
+   *
+   * - `.jpg`
+   *
+   * - `jpg`
+   *
+   * Returns `_TRUE_` if the extension exists in the list, otherwise returns `_FALSE_`.
+   */
+  isNoCompressExtension(fileExtension: string): boolean
+
+  /**
+   * Checks whether a ZIP archive uses legacy Zip 2.0 password protection.
+   *
+   * The `zipPath` argument specifies the path of a ZIP file in the local filesystem.
+   *
+   * This method checks only for traditional Zip 2.0 password protection.
+   *
+   * Returns `_TRUE_` if the ZIP archive is password protected, otherwise returns `_FALSE_`.
+   */
+  isPasswordProtected(zipPath: string): boolean
+
+  /**
+   * Initializes a new empty ZIP archive.
+   *
+   * - If another ZIP archive is currently open, it is closed.
+   *
+   * - All existing in-memory ZIP entries are discarded.
+   *
+   * - The `FileName` property is set to `zipPath`.
+   *
+   * No ZIP file is actually created until a `Write*` method is called.
+   *
+   * This method resets the Zip object to a clean empty state.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  newZip(zipPath: string): void
+
+  /**
+   * `(Windows only)`
+   *
+   * Opens a ZIP archive embedded as a resource within a Windows executable.
+   *
+   * - `exeFilename` specifies the EXE file path.
+   *
+   * - `resourceName` specifies the embedded resource name containing the ZIP data.
+   *
+   * This method is useful when ZIP archives are packaged within Windows applications.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  openEmbedded(exeFilename: string, resourceName: string): void
+
+  /**
+   * Opens a ZIP archive from the local filesystem.
+   *
+   * The `zipPath` argument specifies the path of the ZIP file to open.
+   *
+   * Encrypted ZIP archives may be opened without providing a password, but encrypted entries cannot
+   * be extracted until the correct password is provided using `DecryptPassword`.
+   *
+   * When the ZIP archive is opened:
+   *
+   * - `PasswordProtect` is automatically set if legacy Zip 2.0 encryption is detected.
+   *
+   * - `Encryption` is automatically set if strong encryption is detected.
+   *
+   * - `Encryption = 4` indicates WinZip-compatible AES encryption.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.openZipAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  openZip(zipPath: string): void
+
+  /**
+   * Asynchronous form of {@link Zip.openZip}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  openZipAsync(zipPath: string): Promise<void>
+
+  /**
+   * Efficiently appends additional entries to an existing ZIP archive.
+   *
+   * The `zipPath` argument specifies the path of an existing ZIP archive in the local filesystem.
+   *
+   * This method avoids rewriting existing entries.
+   *
+   * - Existing ZIP entries remain unchanged.
+   *
+   * - New entries are appended to the end of the ZIP archive.
+   *
+   * - The ZIP central directory is updated accordingly.
+   *
+   * This method is typically faster than rebuilding the entire ZIP archive.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.quickAppendAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  quickAppend(zipPath: string): void
+
+  /**
+   * Asynchronous form of {@link Zip.quickAppend}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  quickAppendAsync(zipPath: string): Promise<void>
+
+  /**
+   * Removes a file extension from the internal "no-compression" extension list.
+   *
+   * After removal, files having this extension may be compressed normally.
+   *
+   * The extension may be specified with or without the leading dot.
+   */
+  removeNoCompressExtension(fileExtension: string): void
+
+  /**
+   * Sets the compression level for all file and data entries currently contained within the ZIP
+   * object.
+   *
+   * - `0` → No compression
+   *
+   * - `9` → Maximum compression
+   *
+   * The default compression level is `6`.
+   *
+   * **Important:** This method should be called after files or data entries have already been added
+   * to the ZIP object.
+   *
+   * The compression level cannot be changed for mapped entries originating from an already-open ZIP
+   * archive.
+   */
+  setCompressionLevel(level: number): void
+
+  /**
+   * Specifies a collection of wildcard exclusion patterns used when adding files to the ZIP
+   * archive.
+   *
+   * Each pattern may use the wildcard character `*` to match zero or more characters.
+   *
+   * Files matching any exclusion pattern are skipped.
+   */
+  setExclusions(excludePatterns: StringArray): void
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Sets a configuration parameter embedded within a self-extracting EXE created by `WriteExe` or
+   * `WriteExe2`.
+   *
+   * The `paramName` should be one of the XML configuration tag names described in the
+   * `ExeXmlConfig` property documentation.
+   *
+   * For example:
+   *
+   * `SetExeConfigParam("MainUnzipBtn","Extract")`
+   *
+   * This changes the text displayed on the self-extractor's main unzip button.
+   */
+  setExeConfigParam(paramName: string, paramValue: string): void
+
+  /**
+   * Extracts all files and directories from the ZIP archive.
+   *
+   * - `dirPath` specifies the destination directory.
+   *
+   * - Subdirectories are automatically created as needed.
+   *
+   * Returns the number of files extracted.
+   *
+   * Returns `-1` if a failure occurs.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.unzipAsync}.
+   */
+  unzip(dirPath: string): number
+
+  /**
+   * Asynchronous form of {@link Zip.unzip}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   */
+  unzipAsync(dirPath: string): Promise<number>
+
+  /**
+   * Extracts all files into a single directory.
+   *
+   * All directory path information stored within the ZIP archive is ignored.
+   *
+   * If multiple files have the same filename, later extracted files overwrite earlier ones.
+   *
+   * Returns the number of files extracted, or `-1` on failure.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.unzipIntoAsync}.
+   */
+  unzipInto(dirPath: string): number
+
+  /**
+   * Asynchronous form of {@link Zip.unzipInto}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   */
+  unzipIntoAsync(dirPath: string): Promise<number>
+
+  /**
+   * Extracts only entries whose stored paths match a wildcard pattern.
+   *
+   * - The wildcard character `*` matches zero or more characters.
+   *
+   * - If no wildcard is used, an exact filename match is required.
+   *
+   * Subdirectories are automatically created as needed.
+   *
+   * Returns the number of files extracted, or `-1` on failure.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.unzipMatchingAsync}.
+   */
+  unzipMatching(dirPath: string, pattern: string, verbose: boolean): number
+
+  /**
+   * Asynchronous form of {@link Zip.unzipMatching}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   */
+  unzipMatchingAsync(dirPath: string, pattern: string, verbose: boolean): Promise<number>
+
+  /**
+   * Extracts matching entries into a single directory while ignoring all stored ZIP path
+   * information.
+   *
+   * Matching behavior is identical to `UnzipMatching`.
+   *
+   * If duplicate filenames occur, later extracted files overwrite earlier ones.
+   *
+   * Returns the number of files extracted, or `-1` on failure.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.unzipMatchingIntoAsync}.
+   */
+  unzipMatchingInto(dirPath: string, pattern: string, verbose: boolean): number
+
+  /**
+   * Asynchronous form of {@link Zip.unzipMatchingInto}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   */
+  unzipMatchingIntoAsync(dirPath: string, pattern: string, verbose: boolean): Promise<number>
+
+  /**
+   * Extracts only files that:
+   *
+   * - Do not already exist
+   *
+   * - Or have older modification timestamps than the ZIP entry
+   *
+   * Subdirectories are automatically created as needed.
+   *
+   * Returns the number of files extracted, or `-1` on failure.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.unzipNewerAsync}.
+   */
+  unzipNewer(dirPath: string): number
+
+  /**
+   * Asynchronous form of {@link Zip.unzipNewer}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   */
+  unzipNewerAsync(dirPath: string): Promise<number>
+
+  /**
+   * Verifies that the current `DecryptPassword` value is correct for the currently opened ZIP
+   * archive.
+   *
+   * This method allows password validation before attempting extraction.
+   *
+   * Returns `_TRUE_` if the password is valid, otherwise returns `_FALSE_`.
+   */
+  verifyPassword(): boolean
+
+  /**
+   * `(Windows only, for creating self-extracting EXE's)`
+   *
+   * Creates a Windows self-extracting executable (EXE).
+   *
+   * The generated EXE contains both the extraction logic and the ZIP archive data.
+   *
+   * There are no limitations on:
+   *
+   * - Total ZIP size
+   *
+   * - Individual file size
+   *
+   * - Number of files
+   *
+   * The generated EXE supports the following command-line arguments:
+   *
+   * - `-log logFileName`
+   *
+   * - `-unzipDir unzipDirectoryPath`
+   *
+   * - `-pwd password`
+   *
+   * - `-ap autoRunParams`
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.writeExeAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeExe(exeFilename: string): void
+
+  /**
+   * Asynchronous form of {@link Zip.writeExe}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeExeAsync(exeFilename: string): Promise<void>
+
+  /**
+   * (Relevant only when running on a Microsoft Windows operating system.) Writes a self-extracting
+   * MS-Windows EXE with no limitations on total file size and no limitations on the size of any one
+   * file contained within.
+   *
+   * The 1st argument is the pre-existing EXE housing that is to be used.  Essentially,
+   * the self-extracting EXE is a concatenation of the EXE housing and the compressed/encrypted
+   * data.
+   * The 2nd argument is the name of the EXE to create or overwrite.
+   *
+   * A housing for use with WriteExe2 can be found here:
+   * <https://www.chilkatsoft.com/d2/SaExtract.zip>
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.writeExe2Async}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeExe2(exePath: string, destExePath: string, bAesEncrypt: boolean, keyLength: number, password: string): void
+
+  /**
+   * Asynchronous form of {@link Zip.writeExe2}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeExe2Async(exePath: string, destExePath: string, bAesEncrypt: boolean, keyLength: number, password: string): Promise<void>
+
+  /**
+   * Saves the Zip to a file and implictly re-opens it so further operations can continue. Use
+   * WriteZipAndClose to write and close the Zip. There is no limitation on the size of files that
+   * may be contained within a .zip, the total number of files in a .zip, or the total size of a
+   * .zip. If necessary, WriteZip will use the ZIP64 file format extensions when 4GB or file count
+   * limitations of the old zip file format are exceeded.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.writeZipAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeZip(): void
+
+  /**
+   * Asynchronous form of {@link Zip.writeZip}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeZipAsync(): Promise<void>
+
+  /**
+   * Saves the Zip to a file and closes it. On return, the Zip object will be in the state as if
+   * NewZip had been called. There is no limitation on the size of files that may be contained
+   * within a .zip, the total number of files in a .zip, or the total size of a .zip. If necessary,
+   * WriteZip will use the ZIP64 file format extensions when 4GB or file count limitations of the
+   * old zip file format are exceeded.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.writeZipAndCloseAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeZipAndClose(): void
+
+  /**
+   * Asynchronous form of {@link Zip.writeZipAndClose}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeZipAndCloseAsync(): Promise<void>
+
+  /**
+   * Writes the ZIP archive to a `BinData` object instead of a filesystem file.
+   *
+   * The generated ZIP archive exists entirely in memory.
+   *
+   * The ZIP data written by this method may later be opened using `OpenBd`.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link Zip.writeBdAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeBd(binData: BinData): void
+
+  /**
+   * Asynchronous form of {@link Zip.writeBd}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link Zip.abort} (which cancels it) and the {@link Zip.onPercentDone} /
+   * {@link Zip.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  writeBdAsync(binData: BinData): Promise<void>
+
+  /**
+   * Opens a ZIP archive contained entirely within a `BinData` object.
+   *
+   * This method allows ZIP archives to be processed entirely in memory without requiring a
+   * filesystem file.
+   *
+   * When a ZIP archive is opened:
+   *
+   * - `PasswordProtect` is automatically set if legacy Zip 2.0 encryption is detected.
+   *
+   * - `Encryption` is automatically set if strong encryption is detected.
+   *
+   * - A value of `4` for `Encryption` indicates WinZip-compatible AES encryption.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  openBd(binData: BinData): void
+
+  /**
+   * Returns the largest uncompressed file size contained within the ZIP archive.
+   *
+   * The size is returned as a string rather than an integer because the value may exceed the range
+   * of a 32-bit integer.
+   *
+   * This method is useful when:
+   *
+   * - Checking for extremely large files before extraction
+   *
+   * - Estimating required disk space
+   *
+   * - Detecting unusually large compressed entries
+   *
+   * Returns the size as a decimal string.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  getMaxUncompressedSize(): string
+
+  /**
+   * Adds the contents of a `BinData` object as a new entry in the ZIP archive.
+   *
+   * - `pathInZip` specifies the filename and optional directory path stored within the ZIP.
+   *
+   * - The bytes contained in `bd` become the contents of the ZIP entry.
+   *
+   * - The entry is added to the in-memory ZIP object and is not written to disk until `WriteZip`,
+   *   `WriteZipAndClose`, `WriteBd`, or `WriteToMemory` is called.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  addBd(pathInZip: string, bd: BinData): void
+
+  /**
+   * Adds encoded binary data as a ZIP entry.
+   *
+   * - `encoding` specifies how `data` is encoded.
+   *
+   * - Common encodings include `base64` and `hex`.
+   *
+   * - The decoded binary bytes become the contents of the ZIP entry.
+   *
+   * This method is useful when binary data already exists in textual encoded form.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  addEncoded(pathInZip: string, encoding: string, data: string): void
+
+  /**
+   * Adds an empty file or directory entry to the ZIP archive.
+   *
+   * - If `isDir = _TRUE_`, an empty directory entry is created.
+   *
+   * - If `isDir = _FALSE_`, an empty file entry is created.
+   *
+   * - `pathInZip` specifies the path stored in the ZIP archive.
+   *
+   * This method is useful when directory structure entries must exist even if no files are present.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  addEmpty(isDir: boolean, pathInZip: string): void
+
+  /**
+   * Adds a string as a text file entry in the ZIP archive.
+   *
+   * - The string is converted to bytes using the specified `charset`.
+   *
+   * - `pathInZip` specifies the path stored within the ZIP archive.
+   *
+   * This method is useful for dynamically generating text files directly in memory.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  addString(pathInZip: string, content: string, charset: string): void
+
+  /**
+   * Adds the contents of a `StringBuilder` object as a text entry in the ZIP archive.
+   *
+   * - The text is converted to bytes using the specified `charset`.
+   *
+   * - `pathInZip` specifies the filename stored in the ZIP.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  addSb(pathInZip: string, sb: StringBuilder, charset: string): void
+
+  /**
+   * Adds a file or directory from the local filesystem to the ZIP archive.
+   *
+   * - If `localPath` is an absolute path and `saveExtraPath = _TRUE_`, the stored ZIP path includes
+   *   the relative directory structure.
+   *
+   * - If `saveExtraPath = _FALSE_`, only the filename is stored.
+   *
+   * - If `localPath` is already relative, the relative path is stored as-is regardless of
+   *   `saveExtraPath`.
+   *
+   * This method adds a reference to the file or directory in the local filesystem. The file data is
+   * not immediately read or compressed.
+   *
+   * The actual file contents are consumed only when a `Write*` method is called, such as:
+   *
+   * - `WriteZip`
+   *
+   * - `WriteZipAndClose`
+   *
+   * - `WriteBd`
+   *
+   * - `WriteToMemory`
+   *
+   * This allows files and data entries to be accumulated in the in-memory ZIP object prior to
+   * writing the final ZIP archive.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  addFile(localPath: string, saveExtraPath: boolean): void
+
+  /**
+   * Retrieves the ZIP entry at the specified zero-based index.
+   *
+   * - The first entry is at index `0`.
+   *
+   * - The matching entry is returned in the supplied `ZipEntry` object.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  entryAt(index: number, entry: ZipEntry): void
+
+  /**
+   * Finds the first ZIP entry whose stored path matches a wildcard pattern.
+   *
+   * - The wildcard character `*` matches zero or more characters.
+   *
+   * - The comparison is performed against the full stored ZIP path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  entryMatching(pattern: string, entry: ZipEntry): void
+
+  /**
+   * Finds a ZIP entry whose stored path exactly matches `pathInZip`.
+   *
+   * The matching entry is returned in the supplied `ZipEntry` object.
+   */
+  entryOf(pathInZip: string, entry: ZipEntry): boolean
+
+  /**
+   * Finds a ZIP entry by its unique EntryID.
+   *
+   * The matching entry is returned in the supplied `ZipEntry` object.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link Zip.lastErrorText}.
+   */
+  entryById(id: number, entry: ZipEntry): void
+
+  // ---- Events (ReactNativeGen_DESIGN.md §6) ----
+
+  /**
+   * Called with the percent completed (0..100) while a long-running method runs, when Chilkat
+   * can measure progress. Runs on the JavaScript thread, so it is only useful with the
+   * `...Async` methods (during a synchronous call the thread is busy and the events arrive
+   * after it returns). Assign `undefined` to remove.
+   */
+  onPercentDone?: (pctDone: number) => void
+
+  /**
+   * Called with a name/value pair of progress information while a long-running method runs
+   * (what is reported depends on the class and method). Runs on the JavaScript thread; see
+   * {@link Zip.onPercentDone}. Assign `undefined` to remove.
+   */
+  onProgressInfo?: (name: string, value: string) => void
+
+  /**
+   * Requests that the pending `...Async` call on this object stop at its next progress check.
+   * The promise then rejects with Chilkat's abort error. Chilkat checks at least every
+   * `heartbeatMs` milliseconds on the classes that have that property, so set it (e.g. 250)
+   * for a responsive cancel. Harmless when nothing is pending.
+   */
+  abort(): void
+}