@wirunrom/hqr-generate 0.2.23 → 0.3.11

package/package.json

@@ -1,64 +1,66 @@
-{
-  "name": "@wirunrom/hqr-generate",
-  "version": "0.2.23",
-  "description": "Stable black/white QR code generator (PNG data URL) powered by Rust + WASM",
-  "license": "MIT",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/wirunrom/hqr-generate.git"
-  },
-  "homepage": "https://github.com/wirunrom/hqr-generate#readme",
-  "files": [
-    "pkg/**",
-    "index.web.js",
-    "index.bundler.js",
-    "index.d.ts",
-    "react/**",
-    "README.md",
-    "LICENSE"
-  ],
-  "types": "./index.d.ts",
-  "main": "./index.bundler.js",
-  "module": "./index.bundler.js",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "default": "./index.bundler.js"
-    },
-    "./react": {
-      "types": "./react/index.d.ts",
-      "default": "./react/index.js"
-    },
-    "./web": {
-      "types": "./index.d.ts",
-      "default": "./index.web.js"
-    }
-  },
-  "peerDependencies": {
-    "react": ">=17"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
-  },
-  "scripts": {
-    "clean": "rm -rf pkg",
-    "build:web": "wasm-pack build --target web --out-dir pkg/web",
-    "build:bundler": "wasm-pack build --target bundler --out-dir pkg/bundler",
-    "build": "npm run build:web && npm run build:bundler",
-    "prepack": "npm run clean && npm run build && rm -f pkg/web/.gitignore pkg/bundler/.gitignore",
-    "publish:npm": "npm publish --registry=https://registry.npmjs.org --access public",
-    "publish:github": "npm publish --registry=https://npm.pkg.github.com --userconfig .npmrc.github --access public"
-  },
-  "keywords": [
-    "qrcode",
-    "qr",
-    "rust",
-    "wasm",
-    "react",
-    "png",
-    "performance"
-  ]
-}
+{
+  "name": "@wirunrom/hqr-generate",
+  "version": "0.3.11",
+  "description": "High-performance QR code generator and decoder powered by Rust + WASM",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wirunrom/hqr-generate.git"
+  },
+  "homepage": "https://github.com/wirunrom/hqr-generate#readme",
+  "files": [
+    "pkg/**",
+    "index.web.js",
+    "index.bundler.js",
+    "index.d.ts",
+    "react/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "types": "./index.d.ts",
+  "main": "./index.bundler.js",
+  "module": "./index.bundler.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.bundler.js"
+    },
+    "./react": {
+      "types": "./react/index.d.ts",
+      "default": "./react/index.js"
+    },
+    "./web": {
+      "types": "./index.d.ts",
+      "default": "./index.web.js"
+    }
+  },
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf pkg",
+    "build:web": "wasm-pack build --target web --out-dir pkg/web -- --features wasm,decode",
+    "build:bundler": "wasm-pack build --target bundler --out-dir pkg/bundler -- --features wasm,decode",
+    "build": "npm run build:web && npm run build:bundler",
+    "prepack": "npm run clean && npm run build && rm -f pkg/web/.gitignore pkg/bundler/.gitignore",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org --access public",
+    "publish:github": "npm publish --registry=https://npm.pkg.github.com --userconfig .npmrc.github --access public"
+  },
+  "keywords": [
+    "qrcode",
+    "qr",
+    "qr-decode",
+    "qr-scanner",
+    "rust",
+    "wasm",
+    "react",
+    "png",
+    "performance"
+  ]
+}

package/pkg/bundler/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Wirunrom
+
+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/pkg/bundler/README.md

@@ -1,151 +1,230 @@
-# @wirunrom/hqr-generate
-
-A **stable black-and-white QR Code generator** that returns **PNG Data URLs or PNG bytes**, powered by **Rust + WebAssembly (WASM)**.
-
-This library is designed with a **scan-reliability-first** mindset and a **frontend-first API**, making it easy to use in modern web applications without additional configuration.
-
----
-
-## Features
-
-- High-contrast **black & white only** output (maximum scan compatibility)
-- Optimized for both **old and new mobile devices**
-- Deterministic and consistent QR output
-- Lightweight and fast (**Rust + WASM**)
-- Supports:
-  - **PNG Data URL** (simple usage)
-  - **PNG raw bytes** (best performance, no Base64 overhead)
-- Works out of the box with:
-  - Plain HTML / JavaScript
-  - React
-  - Next.js (Pages Router & App Router)
-  - Modern bundlers (Vite, Webpack, etc.)
-
----
-
-## Installation
-
-```bash
-npm install @wirunrom/hqr-generate
-```
-
-## Basic Usage (Bundler / React / Next.js)
-
-**Generate PNG Data URL**
-
-Simple and widely compatible. Recommended for most use cases.
-
-```ts
-import { qrPngDataUrl } from "@wirunrom/hqr-generate";
-
-const src = await qrPngDataUrl("hello world", {
-  size: 320,
-  margin: 4,
-  ecc: "Q",
-});
-
-<img src={src} alt="QR Code" />
-```
-
-**Generate PNG Bytes (Best Performance)**
-
-Using raw bytes avoids Base64 overhead and is more memory-efficient.
-
-```ts
-import { qrPngBytes } from "@wirunrom/hqr-generate";
-
-const bytes = await qrPngBytes("hello world", {
-  size: 320,
-  margin: 4,
-  ecc: "Q",
-});
-
-const url = URL.createObjectURL(
-  new Blob([bytes], { type: "image/png" })
-);
-
-<img src={url} alt="QR Code" />
-
-```
-
-## React Hook Helper (/react)
-
-For React or Next.js applications, the library provides idiomatic React hooks that automatically update when inputs change.
-
-**useQrPngDataUrl**
-
-Generates a PNG Data URL and updates automatically when dependencies change.
-
-```ts
-import { useQrPngDataUrl } from "@wirunrom/hqr-generate/react";
-
-function QR() {
-  const src = useQrPngDataUrl("hello world", {
-    size: 320,
-    margin: 4,
-    ecc: "Q",
-  });
-
-  if (!src) return null;
-  return <img src={src} alt="QR Code" />;
-}
-```
-
-**useQrPngBlobUrl**
-
-Generates a Blob URL instead of a Base64 Data URL.
-Recommended for larger QR codes or frequent updates.
-
-```ts
-import { useQrPngBlobUrl } from "@wirunrom/hqr-generate/react";
-
-function QR() {
-  const src = useQrPngBlobUrl("hello world", {
-    size: 320,
-    margin: 4,
-    ecc: "Q",
-  });
-
-  if (!src) return null;
-  return <img src={src} alt="QR Code" />;
-}
-```
-
-## Plain HTML / No Bundler (/web)
-
-Use this entry when working with static HTML, CDN, or environments without a bundler.
-
-```html
-<script type="module">
-  import { qr_png_bytes, qr_png_data_url } from "@wirunrom/hqr-generate/web";
-
-  const src = await qr_png_bytes("hello world", {
-    size: 320,
-    margin: 4,
-    ecc: "Q",
-  });
-
-  // or
-
-  const src = await qr_png_data_url("hello world", {
-    size: 320,
-    margin: 4,
-    ecc: "Q",
-  });
-
-  document.getElementById("qr").src = src;
-</script>
-
-<img id="qr" />
-```
-
-## API Reference
-
-Generate a QR code and return a PNG Data URL.
-
-| Name   | Type                       | Default | Description                  |
-| ------ | -------------------------- | ------- | ---------------------------- |
-| text   | `string`                   | —       | Text to encode               |
-| size   | `number`                   | `320`   | Image size in pixels         |
-| margin | `number`                   | `4`     | Quiet zone (recommended ≥ 4) |
-| ecc    | `"L" \| "M" \| "Q" \| "H"` | `"Q"`   | Error correction level       |
+# @wirunrom/hqr-generate
+
+A high-performance **QR Code generator and decoder** with
+**black-and-white only output**, powered by **Rust + WebAssembly (WASM)**.
+
+Supports both **QR generation** and **QR decoding (scan)** in modern web applications.
+
+This library is designed with a **scan-reliability-first** mindset and a **frontend-first API**, making it easy to use in modern web applications without additional configuration.
+
+---
+
+## Features
+
+- High-contrast **black & white only** output (maximum scan compatibility)
+- Optimized for both **old and new mobile devices**
+- Deterministic and consistent QR output
+- Lightweight and fast (**Rust + WASM**)
+- QR decoding (scan) from browser ImageData
+- Supports:
+  - **PNG Data URL** (simple usage)
+  - **PNG raw bytes** (best performance, no Base64 overhead)
+- Works out of the box with:
+  - Plain HTML / JavaScript
+  - React
+  - Next.js Client Component (Pages Router & App Router)
+  - Modern bundlers (Vite, Webpack, etc.)
+
+---
+
+## Installation
+
+```bash
+npm install @wirunrom/hqr-generate
+```
+
+## API Reference (GenerateQR)
+
+Generate a QR code and return a PNG Data URL.
+
+Parameters
+
+| Name   | Type                       | Default | Description                  |
+| ------ | -------------------------- | ------- | ---------------------------- |
+| text   | `string`                   | —       | Text to encode               |
+| size   | `number`                   | `320`   | Image size in pixels         |
+| margin | `number`                   | `4`     | Quiet zone (recommended ≥ 4) |
+| ecc    | `"L" \| "M" \| "Q" \| "H"` | `"Q"`   | Error correction level       |
+
+## Basic Usage [Bundler / React / Next.js (Client)]
+
+**Generate PNG Data URL**
+
+Simple and widely compatible. Recommended for most use cases.
+
+```ts
+import { qr_png_data_url } from "@wirunrom/hqr-generate";
+
+const src = await qr_png_data_url("hello world", 320, 4, "Q");
+
+<img src={src} alt="QR Code" />
+```
+
+**Generate PNG Bytes (Best Performance)**
+
+Using raw bytes avoids Base64 overhead and is more memory-efficient.
+
+```ts
+import { qr_png_bytes } from "@wirunrom/hqr-generate";
+
+const bytes = await qr_png_bytes("hello world", 320, 4, "Q");
+
+const url = URL.createObjectURL(
+  new Blob([bytes], { type: "image/png" })
+);
+
+<img src={url} alt="QR Code" />
+```
+
+**Decode QR Code**
+
+Decode a QR code from browser ImageData (Canvas / camera / image upload friendly).
+
+```ts
+import { qr_decode_from_image } from "@wirunrom/hqr-generate";
+
+const imageData = ctx.getImageData(0, 0, width, height);
+const text = await qr_decode_from_image(imageData);
+
+console.log(text);
+```
+
+Decode runs entirely in WASM and does not require server-side processing.
+
+## React Hook Helper (/react)
+
+For React or Next.js applications, the library provides idiomatic React hooks that manage async state automatically.
+
+**useQrPngDataUrl**
+
+Generates a PNG Data URL and updates automatically when inputs change.
+
+```ts
+import { useQrPngDataUrl } from "@wirunrom/hqr-generate/react";
+
+function QR() {
+  const src = useQrPngDataUrl("hello world", {
+    size: 320,
+    margin: 4,
+    ecc: "Q",
+  });
+
+  if (!src) return null;
+  return <img src={src} alt="QR Code" />;
+}
+```
+
+**useQrPngBlobUrl**
+
+Generates a Blob URL instead of a Base64 Data URL.
+Recommended for larger QR codes or frequent updates.
+
+```ts
+import { useQrPngBlobUrl } from "@wirunrom/hqr-generate/react";
+
+function QR() {
+  const src = useQrPngBlobUrl("hello world", {
+    size: 320,
+    margin: 4,
+    ecc: "Q",
+  });
+
+  if (!src) return null;
+  return <img src={src} alt="QR Code" />;
+}
+```
+
+**useQrDecodeFromImageData**
+
+Decode a QR code from browser ImageData.
+
+```ts
+import { useQrDecodeFromImageData } from "@wirunrom/hqr-generate/react";
+
+function Scanner({ image }: { image: ImageData | null }) {
+  const { text, loading, error } = useQrDecodeFromImageData(image);
+
+  if (loading) return <div>Scanning…</div>;
+  if (error) return <div>Error</div>;
+  if (!text) return null;
+
+  return <div>QR: {text}</div>;
+}
+```
+
+Parameters
+
+| Name  | Type        | Description                                 |
+| ----- | ----------- | ------------------------------------------- |
+| image | `ImageData` | RGBA image data from Canvas or Camera frame |
+
+Returns
+
+- `Promise<string>`
+  - Resolves with decoded QR text
+  - Rejects if no QR code is detected or image is invalid
+
+Notes
+
+- Input must be RGBA ImageData
+- Decode runs entirely in WASM
+- No server or backend required
+- Best results with:
+  - High-contrast QR codes
+  - Minimal blur
+  - Proper quiet zone
+
+**useQrDecodeFromImageSrc**
+
+Decode a QR code from your image path.
+
+```ts
+import { useQrDecodeFromImageSrc } from "@wirunrom/hqr-generate/react";
+
+function DecodeQR({ imagePath }: { imagePath: string | null }) {
+  const { text } = useQrDecodeFromImageSrc(imagePath);
+
+  if (!text) return null;
+
+  return <div>Decode QR: {text}</div>;
+}
+```
+
+Parameters
+
+| Name | Type     | Description     |
+| ---- | -------- | --------------- |
+| src  | `string` | Your image path |
+
+Returns
+
+- `Promise<string>`
+  - Resolves with decoded QR text
+
+## Plain HTML / No Bundler (/web)
+
+Use this entry when working with static HTML, CDN, or environments without a bundler.
+
+```html
+<script type="module">
+  import {
+    qr_png_bytes,
+    qr_png_data_url,
+    qr_decode_from_image_data,
+  } from "@wirunrom/hqr-generate/web";
+
+  const src = await qr_png_data_url("hello world", 320, 4, "Q");
+  document.getElementById("qr").src = src;
+
+  // decode example (canvas)
+  const canvas = document.getElementById("c");
+  const ctx = canvas.getContext("2d");
+  const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+
+  const text = await qr_decode_from_image_data(imageData);
+  console.log(text);
+</script>
+
+<img id="qr" />
+<canvas id="c" hidden></canvas>
+```

package/pkg/bundler/hqr_generate.d.ts

@@ -1,6 +1,8 @@
 /* tslint:disable */
 /* eslint-disable */
 
+export function qr_decode_from_rgba(width: number, height: number, rgba: Uint8Array): string;
+
 export function qr_png_bytes(text: string, size: number, margin: number, ecc: number): Uint8Array;
 
 export function qr_png_data_url(text: string, size: number, margin: number, ecc: number): string;

package/pkg/bundler/hqr_generate.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./hqr_generate_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    qr_png_bytes, qr_png_data_url
+    qr_decode_from_rgba, qr_png_bytes, qr_png_data_url
 } from "./hqr_generate_bg.js";

package/pkg/bundler/hqr_generate_bg.js

@@ -1,3 +1,28 @@
+/**
+ * @param {number} width
+ * @param {number} height
+ * @param {Uint8Array} rgba
+ * @returns {string}
+ */
+export function qr_decode_from_rgba(width, height, rgba) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ret = wasm.qr_decode_from_rgba(width, height, rgba);
+        var ptr1 = ret[0];
+        var len1 = ret[1];
+        if (ret[3]) {
+            ptr1 = 0; len1 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred2_0 = ptr1;
+        deferred2_1 = len1;
+        return getStringFromWasm0(ptr1, len1);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
 /**
  * @param {string} text
  * @param {number} size
@@ -45,10 +70,17 @@ export function qr_png_data_url(text, size, margin, ecc) {
 export function __wbg___wbindgen_throw_be289d5034ed271b(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
+export function __wbg_length_32ed9a279acd054c(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
 export function __wbg_new_from_slice_a3d2629dc1826784(arg0, arg1) {
     const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
     return ret;
 }
+export function __wbg_prototypesetcall_bdcdcc5842e4d77d(arg0, arg1, arg2) {
+    Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
+}
 export function __wbindgen_cast_0000000000000001(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);

package/pkg/bundler/hqr_generate_bg.wasm.d.ts

@@ -1,11 +1,12 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const qr_decode_from_rgba: (a: number, b: number, c: any) => [number, number, number, number];
 export const qr_png_bytes: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
 export const qr_png_data_url: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const __wbindgen_externrefs: WebAssembly.Table;
-export const __wbindgen_malloc: (a: number, b: number) => number;
-export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_start: () => void;

package/pkg/bundler/package.json

@@ -2,7 +2,7 @@
   "name": "hqr-generate",
   "type": "module",
   "description": "Stable black/white QR code generator (PNG data URL) powered by Rust + WASM",
-  "version": "0.2.0",
+  "version": "0.3.11",
   "license": "MIT",
   "repository": {
     "type": "git",

package/pkg/web/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Wirunrom
+
+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.