qrush-compressor 0.0.1-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Qrush Compressor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# 🦀 Qrush Compressor
+
+Fast file and image compression library powered by WebAssembly (Rust).
+Qrush Compressor is an advanced library for file and image compression, developed in Rust and compiled to WebAssembly. Rust enables superior performance and resource optimization, achieving fast and efficient compression directly in the browser or any modern JavaScript environment. Thanks to Rust’s memory safety and concurrency, data processing is robust and scalable—ideal for web applications that require maximum speed and low resource usage.
+
+## Installation
+
+```bash
+npm install qrush-compressor
+```
+
+## Quick Start
+
+### Initialize WASM
+
+```typescript
+import init from 'qrush-compressor';
+await init();  // Required before using any function
+```
+
+### Compress Data
+
+```typescript
+import { compress, WasmCompressionMethod, WasmCompressionLevel } from 'qrush-compressor';
+
+const data = new Uint8Array([...]);
+const result = compress(data, WasmCompressionMethod.Gzip, WasmCompressionLevel.Best);
+
+console.log(`Original: ${result.original_size()} bytes`);
+console.log(`Compressed: ${result.compressed_size()} bytes`);
+console.log(`Ratio: ${(result.compression_ratio() * 100).toFixed(2)}%`);
+```
+
+### Compress Image
+
+```typescript
+import { compress_image_jpeg } from 'qrush-compressor';
+
+const imageData = new Uint8Array([...]); // Your image file
+const result = compress_image_jpeg(imageData, 85); // Quality 1-100
+const jpegBytes = result.data();
+```
+
+### Resize & Compress Image
+
+```typescript
+import { compress_and_resize_image } from 'qrush-compressor';
+
+const result = compress_and_resize_image(
+  imageData,
+  1920,  // max width (null for auto)
+  null,  // max height (null for auto)
+  85     // quality
+);
+```
+
+## Framework Examples
+
+### React
+
+```tsx
+import { useEffect, useState } from 'react';
+import init, { compress_image_jpeg } from 'qrush-compressor';
+
+function App() {
+  const [ready, setReady] = useState(false);
+
+  useEffect(() => {
+    init().then(() => setReady(true));
+  }, []);
+
+  const handleFile = async (e: React.ChangeEvent<HTMLInputElement>) => {
+    if (!ready || !e.target.files) return;
+    const file = e.target.files[0];
+    const data = new Uint8Array(await file.arrayBuffer());
+    const result = compress_image_jpeg(data, 85);
+    console.log(`Saved ${((1 - result.compression_ratio()) * 100).toFixed(2)}%`);
+  };
+
+  return <input type="file" onChange={handleFile} accept="image/*" />;
+}
+```
+
+### Angular
+
+```typescript
+import { Component, OnInit } from '@angular/core';
+import init, { compress, WasmCompressionMethod } from 'qrush-compressor';
+
+@Component({
+  selector: 'app-root',
+  template: '<input type="file" (change)="onFile($event)">'
+})
+export class AppComponent implements OnInit {
+  async ngOnInit() {
+    await init();
+  }
+
+  async onFile(event: any) {
+    const file = event.target.files[0];
+    const data = new Uint8Array(await file.arrayBuffer());
+    const result = compress(data, WasmCompressionMethod.Brotli);
+    console.log(`Compressed to ${result.compressed_size()} bytes`);
+  }
+}
+```
+
+### Vue 3
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+import init, { compress_image_jpeg } from 'qrush-compressor';
+
+onMounted(async () => {
+  await init();
+});
+
+async function handleFile(e: Event) {
+  const file = (e.target as HTMLInputElement).files?.[0];
+  if (!file) return;
+  const data = new Uint8Array(await file.arrayBuffer());
+  const result = compress_image_jpeg(data, 80);
+  console.log(`Compressed: ${result.compressed_size()} bytes`);
+}
+</script>
+
+<template>
+  <input type="file" @change="handleFile" accept="image/*">
+</template>
+```
+
+## API Reference
+
+### Compression Methods
+
+- `WasmCompressionMethod.Gzip` - Standard GZIP
+- `WasmCompressionMethod.Zlib` - ZLIB format
+- `WasmCompressionMethod.Brotli` - Best compression
+
+### Compression Levels
+
+- `WasmCompressionLevel.Fast` - Fastest
+- `WasmCompressionLevel.Default` - Balanced
+- `WasmCompressionLevel.Best` - Maximum compression
+
+### Functions
+
+#### `compress(data, method, level)`
+Compress binary data.
+
+#### `decompress(data, method)`
+Decompress previously compressed data.
+
+#### `compress_image_jpeg(data, quality)`
+Compress image to JPEG format.
+
+#### `compress_and_resize_image(data, maxWidth, maxHeight, quality)`
+Resize and compress image in one step.
+
+## Performance
+
+| Method | Compression | Speed |
+|--------|-------------|-------|
+| Brotli | Best (~20%) | Slow |
+| ZLIB   | Good (~25%) | Fast |
+| GZIP   | Good (~26%) | Fast |
+
+## Browser Support
+
+All modern browsers (Chrome, Firefox, Safari, Edge).
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "qrush-compressor",
+  "version": "0.0.1-alpha.1",
+  "description": "Fast file and image compression library using WebAssembly. Perfect for Angular, React, Vue, and other web frameworks.",
+  "main": "qrush_compressor.js",
+  "types": "qrush_compressor.d.ts",
+  "files": [
+    "qrush_compressor.js",
+    "qrush_compressor.d.ts",
+    "qrush_compressor_bg.wasm",
+    "qrush_compressor_bg.wasm.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "compression",
+    "image",
+    "wasm",
+    "webassembly",
+    "rust",
+    "gzip",
+    "brotli",
+    "jpeg",
+    "optimizer",
+    "angular",
+    "react",
+    "vue"
+  ],
+  "author": "Enrique Ruiz <enrique.ruiz@nunsys.com>",
+  "license": "MIT"
+}

package/qrush_compressor.d.ts

@@ -0,0 +1,46 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export enum WasmCompressionLevel {
+    Fast = 0,
+    Default = 1,
+    Best = 2,
+}
+
+export enum WasmCompressionMethod {
+    Gzip = 0,
+    Zlib = 1,
+    Brotli = 2,
+}
+
+export class WasmCompressionResult {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly compressed_size: number;
+    readonly compression_ratio: number;
+    readonly data: Uint8Array;
+    readonly original_size: number;
+}
+
+/**
+ * Compress data using the specified method
+ */
+export function compress(data: Uint8Array, method: WasmCompressionMethod, level: WasmCompressionLevel): WasmCompressionResult;
+
+/**
+ * Compress and resize an image
+ */
+export function compress_and_resize_image(data: Uint8Array, width: number | null | undefined, height: number | null | undefined, quality: number): WasmCompressionResult;
+
+/**
+ * Compress an image with quality setting (JPEG)
+ */
+export function compress_image_jpeg(data: Uint8Array, quality: number): WasmCompressionResult;
+
+/**
+ * Decompress data using the specified method
+ */
+export function decompress(data: Uint8Array, method: WasmCompressionMethod): Uint8Array;
+
+export function init(): void;

package/qrush_compressor.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./qrush_compressor.d.ts" */
+
+import * as wasm from "./qrush_compressor_bg.wasm";
+import { __wbg_set_wasm } from "./qrush_compressor_bg.js";
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    WasmCompressionLevel, WasmCompressionMethod, WasmCompressionResult, compress, compress_and_resize_image, compress_image_jpeg, decompress, init
+} from "./qrush_compressor_bg.js";

package/qrush_compressor_bg.wasm.d.ts

@@ -0,0 +1,74 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_wasmcompressionresult_free: (a: number, b: number) => void;
+export const compress: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const compress_and_resize_image: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+export const compress_image_jpeg: (a: number, b: number, c: number) => [number, number, number];
+export const decompress: (a: number, b: number, c: number) => [number, number, number, number];
+export const init: () => void;
+export const wasmcompressionresult_compressed_size: (a: number) => number;
+export const wasmcompressionresult_compression_ratio: (a: number) => number;
+export const wasmcompressionresult_data: (a: number) => [number, number];
+export const wasmcompressionresult_original_size: (a: number) => number;
+export const BroccoliConcatFinish: (a: number, b: number, c: number) => number;
+export const BroccoliConcatFinished: (a: number, b: number, c: number) => number;
+export const BroccoliConcatStream: (a: number, b: number, c: number, d: number, e: number) => number;
+export const BroccoliConcatStreaming: (a: number, b: number, c: number, d: number, e: number) => number;
+export const BroccoliCreateInstance: (a: number) => void;
+export const BroccoliCreateInstanceWithWindowSize: (a: number, b: number) => void;
+export const BroccoliDestroyInstance: (a: number) => void;
+export const BroccoliNewBrotliFile: (a: number) => void;
+export const BrotliEncoderCompress: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+export const BrotliEncoderCompressMulti: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => number;
+export const BrotliEncoderCompressStream: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+export const BrotliEncoderCompressStreaming: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+export const BrotliEncoderCompressWorkPool: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => number;
+export const BrotliEncoderCreateInstance: (a: number, b: number, c: number) => number;
+export const BrotliEncoderCreateWorkPool: (a: number, b: number, c: number, d: number) => number;
+export const BrotliEncoderDestroyInstance: (a: number) => void;
+export const BrotliEncoderDestroyWorkPool: (a: number) => void;
+export const BrotliEncoderFreeU8: (a: number, b: number, c: number) => void;
+export const BrotliEncoderFreeUsize: (a: number, b: number, c: number) => void;
+export const BrotliEncoderHasMoreOutput: (a: number) => number;
+export const BrotliEncoderIsFinished: (a: number) => number;
+export const BrotliEncoderMallocU8: (a: number, b: number) => number;
+export const BrotliEncoderMallocUsize: (a: number, b: number) => number;
+export const BrotliEncoderMaxCompressedSize: (a: number) => number;
+export const BrotliEncoderMaxCompressedSizeMulti: (a: number, b: number) => number;
+export const BrotliEncoderSetCustomDictionary: (a: number, b: number, c: number) => void;
+export const BrotliEncoderSetParameter: (a: number, b: number, c: number) => number;
+export const BrotliEncoderTakeOutput: (a: number, b: number) => number;
+export const BrotliEncoderVersion: () => number;
+export const CBrotliDecoderErrorString: (a: number) => number;
+export const BrotliDecoderErrorString: (a: number) => number;
+export const CBrotliDecoderGetErrorCode: (a: number) => number;
+export const BrotliDecoderGetErrorCode: (a: number) => number;
+export const CBrotliDecoderGetErrorString: (a: number) => number;
+export const BrotliDecoderGetErrorString: (a: number) => number;
+export const CBrotliDecoderHasMoreOutput: (a: number) => number;
+export const BrotliDecoderHasMoreOutput: (a: number) => number;
+export const CBrotliDecoderIsFinished: (a: number) => number;
+export const BrotliDecoderIsFinished: (a: number) => number;
+export const CBrotliDecoderIsUsed: (a: number) => number;
+export const BrotliDecoderIsUsed: (a: number) => number;
+export const CBrotliDecoderTakeOutput: (a: number, b: number) => number;
+export const BrotliDecoderTakeOutput: (a: number, b: number) => number;
+export const BrotliDecoderFreeU8: (a: number, b: number, c: number) => void;
+export const BrotliDecoderVersion: () => number;
+export const BrotliDecoderMallocU8: (a: number, b: number) => number;
+export const BrotliDecoderFreeUsize: (a: number, b: number, c: number) => void;
+export const BrotliDecoderDecompress: (a: number, b: number, c: number, d: number) => number;
+export const BrotliDecoderMallocUsize: (a: number, b: number) => number;
+export const BrotliDecoderSetParameter: (a: number, b: number, c: number) => void;
+export const BrotliDecoderCreateInstance: (a: number, b: number, c: number) => number;
+export const BrotliDecoderDestroyInstance: (a: number) => void;
+export const BrotliDecoderDecompressStream: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+export const BrotliDecoderDecompressPrealloc: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+export const BrotliDecoderDecompressStreaming: (a: number, b: number, c: number, d: number, e: number) => number;
+export const BrotliDecoderDecompressWithReturnInfo: (a: number, b: number, c: number, d: number, e: number) => void;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_start: () => void;