@crossbind/port-zstd 2.0.0-beta.50

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @crossbind/port-zstd
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- Rebuilt in the 1.0.2 toolchain image — Rust 1.98.0, Emscripten 6.0.2. The recipe and the
+  upstream source are unchanged; what moved is the compiler the binaries were produced by.
+
+## 1.0.0
+
+- 🚀 first release

package/LICENSE

@@ -0,0 +1,30 @@
+BSD License
+
+For Zstandard software
+
+Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook, nor Meta, nor the names of its contributors may
+   be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,66 @@
+# @crossbind/port-zstd
+**Precompiled Zstandard (zstd) library built with crossbind for seamless integration in JavaScript, WebAssembly and React Native projects.**
+
+<a href="https://www.npmjs.com/package/@crossbind/port-zstd">
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/port-zstd?style=for-the-badge" />
+</a>
+<a href="https://github.com/facebook/zstd">
+    <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Funpkg.com%2F%40crossbind%2Fpackage-zstd%2Fpackage.json&query=%24.nativeVersion&style=for-the-badge&label=ZSTD" />
+</a>
+<a href="https://github.com/facebook/zstd/blob/dev/LICENSE">
+    <img alt="License" src="https://img.shields.io/npm/l/%40crossbind%2Fpackage-zstd?style=for-the-badge" />
+</a>
+
+> Use it together with **[crossbind](https://crossbind.dev)** — the toolchain for using C++ libraries from JavaScript, TypeScript, WebAssembly, Node.js and React Native. Learn more at **[crossbind.dev](https://crossbind.dev)**.
+
+## Integration
+Install the main package together with the platform builds:
+
+```sh
+npm install @crossbind/port-zstd @crossbind/port-zstd-wasm @crossbind/port-zstd-android @crossbind/port-zstd-ios
+```
+
+Then import all three platforms in `crossbind.config.js` — crossbind compiles only the one matching each build target:
+
+```diff
++import zstdWasm from '@crossbind/port-zstd-wasm/crossbind.config.js';
++import zstdAndroid from '@crossbind/port-zstd-android/crossbind.config.js';
++import zstdIos from '@crossbind/port-zstd-ios/crossbind.config.js';
+
+export default {
+    dependencies: [
++        zstdWasm,
++        zstdAndroid,
++        zstdIos,
+    ],
+    paths: {
+        config: import.meta.url,
+    }
+};
+```
+
+## Usage
+Below are the steps to use zstd in your C++ or JavaScript code.
+
+### Usage in C++ Code
+```diff
++#include <zstd.h>
+
+std::string Native::sample() {
++    return ZSTD_versionString();
+}
+```
+
+## Supported platforms
+This is the main package; the precompiled binaries are shipped per platform:
+
+| Platform | Package | Targets |
+|---|---|---|
+| WebAssembly | [`@crossbind/port-zstd-wasm`](https://www.npmjs.com/package/@crossbind/port-zstd-wasm) | `wasm32` — single-threaded & multi-threaded |
+| Android | [`@crossbind/port-zstd-android`](https://www.npmjs.com/package/@crossbind/port-zstd-android) | `arm64-v8a` (64-bit ARM), `x86_64` (emulator) |
+| iOS | [`@crossbind/port-zstd-ios`](https://www.npmjs.com/package/@crossbind/port-zstd-ios) | device (`arm64`), simulator (`arm64`) |
+
+## License
+This project includes the precompiled zstd library, which is distributed under the [zstd License](https://github.com/facebook/zstd/blob/dev/LICENSE).
+
+zstd Homepage: [https://facebook.github.io/zstd/](https://facebook.github.io/zstd/)

package/build.mjs

@@ -0,0 +1,21 @@
+export default {
+    sha256: 'eb33e51f49a15e023950cd7825ca74a4a2b43db8354825ac24fc1b7ee09e6fa3', // zstd-1.5.7.tar.gz
+    getURL: (version) => `https://github.com/facebook/zstd/releases/download/v${version}/zstd-${version}.tar.gz`,
+    // zstd ships its CMake project under build/cmake/, not at the source root.
+    // copyToSource places a thin wrapper CMakeLists.txt at the extracted
+    // source root that simply add_subdirectory()s build/cmake.
+    copyToSource: { 'assets/CMakeLists.txt': 'CMakeLists.txt' },
+    buildType: 'cmake',
+    getBuildParams: (target) => {
+        const shared = target.platform === 'android';
+        return [
+            `-DZSTD_BUILD_SHARED=${shared ? 'ON' : 'OFF'}`,
+            `-DZSTD_BUILD_STATIC=${shared ? 'OFF' : 'ON'}`,
+            '-DZSTD_BUILD_PROGRAMS=OFF',
+            '-DZSTD_BUILD_TESTS=OFF',
+            '-DZSTD_LEGACY_SUPPORT=OFF',
+            '-DZSTD_MULTITHREAD_SUPPORT=OFF',
+            '-DZSTD_DISABLE_ASM=ON',
+        ];
+    },
+};

package/mergeConfig.mjs

@@ -0,0 +1,18 @@
+export default (newConfig = {}) => ({
+    ...newConfig,
+    general: {
+        name: 'zstd',
+        alias: { package: '@crossbind/port-zstd' },
+    },
+    export: {
+        type: 'cmake',
+        bundle: false,
+        libName: ['zstd'],
+        ...(newConfig.export || {}),
+    },
+    paths: {
+        output: 'dist',
+        base: '../..',
+        ...(newConfig.paths || {}),
+    },
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@crossbind/port-zstd",
+  "version": "2.0.0-beta.50",
+  "nativeVersion": "1.5.7",
+  "description": "This package provides a libzstd library compiled with crossbind, enabling seamless usage of Zstandard (de)compression functionalities in JavaScript, WebAssembly and React Native projects.",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/ports/zstd#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crossbind/crossbind.git"
+  },
+  "type": "module",
+  "license": "BSD-3-Clause",
+  "keywords": [
+    "zstd",
+    "zstandard",
+    "libzstd",
+    "compression",
+    "crossbind",
+    "crossbind-package",
+    "webassembly",
+    "wasm",
+    "android",
+    "ios",
+    "react-native"
+  ],
+  "crossbind": {
+    "upstream": {
+      "license": {
+        "declared": "BSD-3-Clause OR GPL-2.0-only",
+        "selected": null,
+        "files": [
+          "LICENSE",
+          "COPYING"
+        ],
+        "copyright": null
+      }
+    }
+  }
+}