@qr-platform/qr-code.js 0.8.20 → 0.8.22

package/lib/lib/zxing-js/src/browser/BrowserCodeReader.d.ts

@@ -2,9 +2,7 @@ import BinaryBitmap from '../core/BinaryBitmap';
 import DecodeHintType from '../core/DecodeHintType';
 import Reader from '../core/Reader';
 import Result from '../core/Result';
-import { DecodeContinuouslyCallback } from './DecodeContinuouslyCallback';
 import { HTMLVisualMediaElement } from './HTMLVisualMediaElement';
-import { VideoInputDevice } from './VideoInputDevice';
 /**
  *
  * Base class for browser code reader.
@@ -25,14 +23,6 @@ export declare class BrowserCodeReader {
      * If enumerateDevices under navigator is supported.
      */
     get canEnumerateDevices(): boolean;
-    /**
-     * This will break the loop.
-     */
-    private _stopContinuousDecode;
-    /**
-     * This will break the loop.
-     */
-    private _stopAsyncDecode;
     /**
      * Delay time between decode attempts made by the scanner.
      */
@@ -62,29 +52,6 @@ export declare class BrowserCodeReader {
      * used to unregister that listener when needed.
      */
     protected imageLoadedListener: EventListener;
-    /**
-     * The stream output from camera.
-     */
-    protected stream: MediaStream;
-    /**
-     * The HTML video element, used to display the camera stream.
-     */
-    protected videoElement: HTMLVideoElement;
-    /**
-     * Should contain the current registered listener for video loaded-metadata,
-     * used to unregister that listener when needed.
-     */
-    protected videoCanPlayListener: EventListener;
-    /**
-     * Should contain the current registered listener for video play-ended,
-     * used to unregister that listener when needed.
-     */
-    protected videoEndedListener: EventListener;
-    /**
-     * Should contain the current registered listener for video playing,
-     * used to unregister that listener when needed.
-     */
-    protected videoPlayingEventListener: EventListener;
     /**
      * Sets the hints.
      */
@@ -101,144 +68,6 @@ export declare class BrowserCodeReader {
      * @memberOf BrowserCodeReader
      */
     constructor(reader: Reader, timeBetweenScansMillis?: number, _hints?: Map<DecodeHintType, any> | undefined);
-    /**
-     * Lists all the available video input devices.
-     */
-    listVideoInputDevices(): Promise<MediaDeviceInfo[]>;
-    /**
-     * Obtain the list of available devices with type 'videoinput'.
-     *
-     * @returns {Promise<VideoInputDevice[]>} an array of available video input devices
-     *
-     * @memberOf BrowserCodeReader
-     *
-     * @deprecated Use `listVideoInputDevices` instead.
-     */
-    getVideoInputDevices(): Promise<VideoInputDevice[]>;
-    /**
-     * Let's you find a device using it's Id.
-     */
-    findDeviceById(deviceId: string): Promise<MediaDeviceInfo>;
-    /**
-     * Decodes the barcode from the device specified by deviceId while showing the video in the specified video element.
-     *
-     * @param deviceId the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available.
-     * @param video the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     *
-     * @deprecated Use `decodeOnceFromVideoDevice` instead.
-     */
-    decodeFromInputVideoDevice(deviceId?: string, videoSource?: string | HTMLVideoElement): Promise<Result>;
-    /**
-     * In one attempt, tries to decode the barcode from the device specified by deviceId while showing the video in the specified video element.
-     *
-     * @param deviceId the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available.
-     * @param video the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeOnceFromVideoDevice(deviceId?: string, videoSource?: string | HTMLVideoElement): Promise<Result>;
-    /**
-     * In one attempt, tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element.
-     *
-     * @param constraints the media stream constraints to get s valid media stream to decode from
-     * @param video the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeOnceFromConstraints(constraints: MediaStreamConstraints, videoSource?: string | HTMLVideoElement): Promise<Result>;
-    /**
-     * In one attempt, tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element.
-     *
-     * @param {MediaStream} [constraints] the media stream constraints to get s valid media stream to decode from
-     * @param {string|HTMLVideoElement} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns {Promise<Result>} The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeOnceFromStream(stream: MediaStream, videoSource?: string | HTMLVideoElement): Promise<Result>;
-    /**
-     * Continuously decodes the barcode from the device specified by device while showing the video in the specified video element.
-     *
-     * @param {string|null} [deviceId] the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available.
-     * @param {string|HTMLVideoElement|null} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns {Promise<void>}
-     *
-     * @memberOf BrowserCodeReader
-     *
-     * @deprecated Use `decodeFromVideoDevice` instead.
-     */
-    decodeFromInputVideoDeviceContinuously(deviceId: string | null, videoSource: string | HTMLVideoElement | null, callbackFn: DecodeContinuouslyCallback): Promise<void>;
-    /**
-     * Continuously tries to decode the barcode from the device specified by device while showing the video in the specified video element.
-     *
-     * @param {string|null} [deviceId] the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available.
-     * @param {string|HTMLVideoElement|null} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns {Promise<void>}
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeFromVideoDevice(deviceId: string | null, videoSource: string | HTMLVideoElement | null, callbackFn: DecodeContinuouslyCallback): Promise<void>;
-    /**
-     * Continuously tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element.
-     *
-     * @param {MediaStream} [constraints] the media stream constraints to get s valid media stream to decode from
-     * @param {string|HTMLVideoElement} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns {Promise<Result>} The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeFromConstraints(constraints: MediaStreamConstraints, videoSource: string | HTMLVideoElement, callbackFn: DecodeContinuouslyCallback): Promise<void>;
-    /**
-     * In one attempt, tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element.
-     *
-     * @param {MediaStream} [constraints] the media stream constraints to get s valid media stream to decode from
-     * @param {string|HTMLVideoElement} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown.
-     * @returns {Promise<Result>} The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeFromStream(stream: MediaStream, videoSource: string | HTMLVideoElement, callbackFn: DecodeContinuouslyCallback): Promise<void>;
-    /**
-     * Breaks the decoding loop.
-     */
-    stopAsyncDecode(): void;
-    /**
-     * Breaks the decoding loop.
-     */
-    stopContinuousDecode(): void;
-    /**
-     * Sets the new stream and request a new decoding-with-delay.
-     *
-     * @param stream The stream to be shown in the video element.
-     * @param decodeFn A callback for the decode method.
-     */
-    protected attachStreamToVideo(stream: MediaStream, videoSource: string | HTMLVideoElement): Promise<HTMLVideoElement>;
-    /**
-     *
-     * @param videoElement
-     */
-    protected playVideoOnLoadAsync(videoElement: HTMLVideoElement): Promise<void>;
-    /**
-     * Binds listeners and callbacks to the videoElement.
-     *
-     * @param element
-     * @param callbackFn
-     */
-    protected playVideoOnLoad(element: HTMLVideoElement, callbackFn: EventListener): void;
-    /**
-     * Checks if the given video element is currently playing.
-     */
-    isVideoPlaying(video: HTMLVideoElement): boolean;
-    /**
-     * Just tries to play the video and logs any errors.
-     * The play call is only made is the video is not already playing.
-     */
-    tryPlayVideo(videoElement: HTMLVideoElement): Promise<void>;
     /**
      * Searches and validates a media element.
      */
@@ -253,79 +82,21 @@ export declare class BrowserCodeReader {
      * @memberOf BrowserCodeReader
      */
     decodeFromImage(source?: string | HTMLImageElement, url?: string): Promise<Result>;
-    /**
-     * Decodes the barcode from a video.
-     *
-     * @param {(string|HTMLImageElement)} [source] The image element that can be either an element id or the element itself. Can be undefined in which case the decoding will be done from the imageUrl parameter.
-     * @param {string} [url]
-     * @returns {Promise<Result>} The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     */
-    decodeFromVideo(source?: string | HTMLVideoElement, url?: string): Promise<Result>;
-    /**
-     * Decodes continuously the barcode from a video.
-     *
-     * @param {(string|HTMLImageElement)} [source] The image element that can be either an element id or the element itself. Can be undefined in which case the decoding will be done from the imageUrl parameter.
-     * @param {string} [url]
-     * @returns {Promise<Result>} The decoding result.
-     *
-     * @memberOf BrowserCodeReader
-     *
-     * @experimental
-     */
-    decodeFromVideoContinuously(source: string | HTMLVideoElement | null, url: string | null, callbackFn: DecodeContinuouslyCallback): Promise<void>;
     /**
      * Decodes something from an image HTML element.
      */
     decodeFromImageElement(source: string | HTMLImageElement): Promise<Result>;
-    /**
-     * Decodes something from an image HTML element.
-     */
-    decodeFromVideoElement(source: string | HTMLVideoElement): Promise<Result>;
-    /**
-     * Decodes something from an image HTML element.
-     */
-    decodeFromVideoElementContinuously(source: string | HTMLVideoElement, callbackFn: DecodeContinuouslyCallback): Promise<void>;
-    /**
-     * Sets up the video source so it can be decoded when loaded.
-     *
-     * @param source The video source element.
-     */
-    private _decodeFromVideoElementSetup;
     /**
      * Decodes an image from a URL.
      */
     decodeFromImageUrl(url?: string): Promise<Result>;
-    /**
-     * Decodes an image from a URL.
-     */
-    decodeFromVideoUrl(url: string): Promise<Result>;
-    /**
-     * Decodes an image from a URL.
-     *
-     * @experimental
-     */
-    decodeFromVideoUrlContinuously(url: string, callbackFn: DecodeContinuouslyCallback): Promise<void>;
     private _decodeOnLoadImage;
-    private _decodeOnLoadVideo;
-    private _decodeOnLoadVideoContinuously;
     isImageLoaded(img: HTMLImageElement): boolean;
     prepareImageElement(imageSource?: HTMLImageElement | string): HTMLImageElement;
     /**
-     * Sets a HTMLVideoElement for scanning or creates a new one.
-     *
-     * @param videoSource The HTMLVideoElement to be set.
-     */
-    prepareVideoElement(videoSource?: HTMLVideoElement | string): HTMLVideoElement;
-    /**
-     * Tries to decode from the video input until it finds some value.
+     * Tries to decode from the image input until it finds some value.
      */
     decodeOnce(element: HTMLVisualMediaElement, retryIfNotFound?: boolean, retryIfChecksumOrFormatError?: boolean): Promise<Result>;
-    /**
-     * Continuously decodes from video input.
-     */
-    decodeContinuously(element: HTMLVideoElement, callbackFn: DecodeContinuouslyCallback): void;
     /**
      * Gets the BinaryBitmap for ya! (and decodes it)
      */
@@ -344,19 +115,6 @@ export declare class BrowserCodeReader {
      *
      */
     protected getCaptureCanvas(mediaElement?: HTMLVisualMediaElement): HTMLCanvasElement;
-    /**
-     * Overwriting this allows you to manipulate the next frame in anyway you want before decode.
-     */
-    drawFrameOnCanvas(srcElement: HTMLVideoElement, dimensions?: {
-        sx: number;
-        sy: number;
-        sWidth: number;
-        sHeight: number;
-        dx: number;
-        dy: number;
-        dWidth: number;
-        dHeight: number;
-    }, canvasElementContext?: CanvasRenderingContext2D): void;
     /**
      * Ovewriting this allows you to manipulate the snapshot image in anyway you want before decode.
      */
@@ -379,32 +137,14 @@ export declare class BrowserCodeReader {
      */
     createCaptureCanvas(mediaElement?: HTMLVisualMediaElement): HTMLCanvasElement;
     /**
-     * Stops the continuous scan and cleans the stream.
-     */
-    protected stopStreams(): void;
-    /**
-     * Resets the code reader to the initial state. Cancels any ongoing barcode scanning from video or camera.
+     * Resets the code reader to the initial state.
      *
      * @memberOf BrowserCodeReader
      */
     reset(): void;
-    private _destroyVideoElement;
     private _destroyImageElement;
     /**
-     * Cleans canvas references 🖌
+     * Destroys the capture canvas and context.
      */
     private _destroyCaptureCanvas;
-    /**
-     * Defines what the videoElement src will be.
-     *
-     * @param videoElement
-     * @param stream
-     */
-    addVideoSource(videoElement: HTMLVideoElement, stream: MediaStream): void;
-    /**
-     * Unbinds a HTML video src property.
-     *
-     * @param videoElement
-     */
-    private cleanVideoSource;
 }

package/lib/lib/zxing-js/src/core/NodeLuminanceSource.d.ts

@@ -5,15 +5,20 @@ import LuminanceSource from './LuminanceSource';
  */
 export declare class NodeLuminanceSource extends LuminanceSource {
     private buffer;
-    private _width;
-    private _height;
     private constructor();
     /**
      * Asynchronously creates a NodeLuminanceSource from an image buffer.
-     * @param imageBuffer - The image data (e.g. from fs.readFile) as a Buffer.
-     * @param doAutoInvert - If true, computes an inverted grayscale buffer.
+     * Can handle standard image formats (PNG/JPEG via Jimp) or raw RGBA buffers.
+     * @param bufferInput - The image data as a Buffer (PNG, JPEG, or raw RGBA).
+     * @param isPngOrJpeg - Flag indicating if the buffer is a standard format (true) or raw RGBA (false).
+     * @param width - Required width if bufferInput is raw RGBA.
+     * @param height - Required height if bufferInput is raw RGBA.
+     * @param doAutoInvert - If true, computes an inverted grayscale buffer (only relevant for grayscale conversion).
      */
-    static create(imageBuffer: Buffer, doAutoInvert?: boolean): Promise<NodeLuminanceSource>;
+    static create(bufferInput: Buffer, isPngOrJpeg: boolean, // Renamed from isPng for clarity
+    width?: number, // Optional width
+    height?: number, // Optional height
+    doAutoInvert?: boolean): Promise<NodeLuminanceSource>;
     /**
      * Converts raw RGBA data to a grayscale buffer.
      * If doAutoInvert is true, each computed luminance is inverted.
@@ -24,13 +29,5 @@ export declare class NodeLuminanceSource extends LuminanceSource {
     isCropSupported(): boolean;
     crop(left: number, top: number, width: number, height: number): LuminanceSource;
     isRotateSupported(): boolean;
-    rotateCounterClockwise(): LuminanceSource;
-    rotateCounterClockwise45(): LuminanceSource;
-    /**
-     * Rotates the image by the specified angle (in degrees) using Sharp.
-     * This method creates a temporary RGBA image from the grayscale data,
-     * rotates it, then re-converts to grayscale.
-     */
-    private rotate;
     invert(): LuminanceSource;
 }

package/lib/node.d.ts

@@ -1,3 +1,4 @@
+import { QRCodeBuilder } from './builder/node';
 import { QRCodeJs as _QRCodeJs } from './core/qr-code-js';
 import { type ValidationResult } from './license/LicenseManagerNode';
 import type * as _browserUtils from './tools/browser-utils';
@@ -30,6 +31,13 @@ export declare class QRCodeJs extends _QRCodeJs {
     static setLicenseUrl(url: string): typeof QRCodeJs;
     constructor(options: RecursivePartial<Options>);
     validateScanning(): Promise<ScanValidatorResponse>;
+    /**
+     * Creates a QRCodeBuilder instance initialized with a specific template.
+     * Allows for fluent configuration chaining.
+     * @param templateName - The name of the template to start with.
+     * @returns A new QRCodeBuilder instance.
+     */
+    static useTemplate(templateName: string): QRCodeBuilder;
 }
 export declare class _ extends QRCodeJs {
     protected _hls(): boolean;