qr 0.5.4 → 0.6.0

package/dom.js

@@ -23,6 +23,20 @@ limitations under the License.
  * @module
  */
 import decodeQR, {} from "./decode.js";
+/**
+ * Read rendered element dimensions from computed CSS.
+ * @param elm - Element whose computed width and height should be parsed.
+ * @returns Pixel width and height parsed from computed styles.
+ * @example
+ * Read rendered element dimensions from computed CSS.
+ * ```ts
+ * import { getSize } from 'qr/dom.js';
+ * if (typeof document !== 'undefined') {
+ *   const video = document.querySelector('video')!;
+ *   void getSize(video);
+ * }
+ * ```
+ */
 export const getSize = (elm) => {
     const css = getComputedStyle(elm);
     const width = Math.floor(+css.width.split('px')[0]);
@@ -46,7 +60,19 @@ const clearCanvas = ({ canvas, context }) => {
     context.clearRect(0, 0, canvas.width, canvas.height);
 };
 /**
- * Handles canvases for QR code decoding
+ * Handles canvases for QR code decoding.
+ * @param elements - Optional output canvases. See {@link QRCanvasElements}.
+ * @param opts - Drawing and decode options for the helper canvases. See {@link QRCanvasOpts}.
+ * @example
+ * Create a `QRCanvas` that paints overlay highlights onto a DOM canvas.
+ * ```ts
+ * import { QRCanvas } from 'qr/dom.js';
+ * if (typeof document !== 'undefined') {
+ *   const overlay = document.createElement('canvas');
+ *   const canvas = new QRCanvas({ overlay });
+ *   void canvas;
+ * }
+ * ```
  */
 export class QRCanvas {
     opts;
@@ -55,7 +81,8 @@ export class QRCanvas {
     overlay;
     bitmap;
     resultQR;
-    constructor({ overlay, bitmap, resultQR } = {}, opts = {}) {
+    constructor(elements = {}, opts = {}) {
+        const { overlay, bitmap, resultQR } = elements;
         this.opts = {
             resultBlockSize: 8,
             overlayMainColor: 'green',
@@ -77,6 +104,8 @@ export class QRCanvas {
         }
     }
     setSize(height, width) {
+        // `resultQR` is resized in `drawResultQr()` because it tracks the decoded
+        // QR image size, not the current source frame dimensions.
         setCanvasSize(this.main.canvas, height, width);
         if (this.overlay)
             setCanvasSize(this.overlay.canvas, height, width);
@@ -89,9 +118,11 @@ export class QRCanvas {
         const imgData = new ImageData(Uint8ClampedArray.from(data), width, height);
         let offset = { x: 0, y: 0 };
         if (this.opts.cropToSquare) {
+            // Match `decodeQR()`'s center-crop offset so the bitmap debug view
+            // stays aligned with detected points remapped into the source frame.
             offset = {
-                x: Math.ceil((this.bitmap.canvas.width - width) / 2),
-                y: Math.ceil((this.bitmap.canvas.height - height) / 2),
+                x: Math.floor((this.bitmap.canvas.width - width) / 2),
+                y: Math.floor((this.bitmap.canvas.height - height) / 2),
             };
         }
         this.bitmap.context.putImageData(imgData, offset.x, offset.y);
@@ -103,6 +134,9 @@ export class QRCanvas {
         setCanvasSize(this.resultQR.canvas, height, width);
         const imgData = new ImageData(Uint8ClampedArray.from(data), width, height);
         this.resultQR.context.putImageData(imgData, 0, 0);
+        // The result canvas owns these inline rendering/layout styles: CSS Images
+        // defines `image-rendering: pixelated`, and scaled QR modules become hard
+        // to read with default smoothing. Use class/id CSS for unrelated styling.
         this.resultQR.canvas.style = `image-rendering: pixelated; width: ${blockSize * width}px; height: ${blockSize * height}px`;
     }
     drawOverlay(points) {
@@ -121,13 +155,17 @@ export class QRCanvas {
             // Clear only central part (flickering)
             ctx.clearRect(offset.x, offset.y, squareSize, squareSize);
             ctx.fillStyle = this.opts.overlaySideColor;
+            // Trailing sidebars start where the floor-centered crop ends; odd
+            // remainders put the extra pixel on the trailing side.
             if (width > height) {
+                const right = offset.x + squareSize;
                 ctx.fillRect(0, 0, offset.x, height); // left
-                ctx.fillRect(width - offset.x, 0, offset.x, height); // right
+                ctx.fillRect(right, 0, width - right, height); // right
             }
             else if (height > width) {
+                const bottom = offset.y + squareSize;
                 ctx.fillRect(0, 0, width, offset.y); // top
-                ctx.fillRect(0, height - offset.y, width, offset.y); // bottom
+                ctx.fillRect(0, bottom, width, height - bottom); // bottom
             }
         }
         else {
@@ -177,6 +215,9 @@ export class QRCanvas {
             return res;
         }
         catch (e) {
+            // Camera-frame decoding is fail-soft UI policy: README says "even if
+            // one frame fails, the next frame can succeed", so decode hook errors
+            // are treated as frame misses here instead of breaking the loop.
             if (this.overlay && Date.now() - this.lastDetect > this.opts.overlayTimeout)
                 this.drawOverlay();
         }
@@ -203,6 +244,7 @@ class QRCamera {
     setStream(stream) {
         this.stream = stream;
         const { player } = this;
+        // Keep camera preview autoplaying inline on mobile before attaching the stream.
         player.setAttribute('autoplay', '');
         player.setAttribute('muted', '');
         player.setAttribute('playsinline', '');
@@ -228,6 +270,10 @@ class QRCamera {
      * @param deviceId - devideId from '.listDevices'
      */
     async setDevice(deviceId) {
+        // Stop-first is intentional for camera switching: WPT's Media Capture
+        // `GUM-deny` and `GUM-impossible-constraint` tests show getUserMedia()
+        // can reject, but this DOM helper prioritizes releasing constrained
+        // camera hardware before requesting the replacement stream.
         this.stop();
         const stream = await navigator.mediaDevices.getUserMedia({
             video: { deviceId: { exact: deviceId } },
@@ -236,6 +282,8 @@ class QRCamera {
     }
     readFrame(canvas, fullSize = false) {
         const { player } = this;
+        // Default to the rendered player box so overlay coordinates stay aligned
+        // with the on-screen preview; `fullSize` opts into intrinsic frame pixels.
         if (fullSize)
             return canvas.drawImage(player, player.videoHeight, player.videoWidth);
         const size = getSize(player);
@@ -249,12 +297,19 @@ class QRCamera {
 /**
  * Creates new QRCamera from frontal camera
  * @param player - HTML Video element
+ * @returns Camera wrapper backed by the selected media stream.
  * @example
- * const canvas = new QRCanvas();
- * const camera = frontalCamera();
- * const devices = await camera.listDevices();
- * await camera.setDevice(devices[0].deviceId); // Change camera
- * const res = camera.readFrame(canvas);
+ * Create a camera helper and read frames into a `QRCanvas`.
+ * ```ts
+ * import { QRCanvas, frontalCamera } from 'qr/dom.js';
+ * if (typeof document !== 'undefined') {
+ *   const player = document.querySelector('video')!;
+ *   const canvas = new QRCanvas();
+ *   const camera = await frontalCamera(player);
+ *   camera.readFrame(canvas);
+ *   camera.stop();
+ * }
+ * ```
  */
 export async function frontalCamera(player) {
     const stream = await navigator.mediaDevices.getUserMedia({
@@ -262,23 +317,35 @@ export async function frontalCamera(player) {
             // Ask for screen resolution
             height: { ideal: window.screen.height },
             width: { ideal: window.screen.width },
-            // prefer front-facing camera, but can use any other
-            // NOTE: 'exact' will cause OverConstrained error if no frontal camera available
+            // Media Capture names the screen/user-facing camera "user" and the
+            // world-facing camera "environment". This helper intentionally treats the
+            // phone's camera side as "frontal", since it is the main QR scanning side.
             facingMode: 'environment',
         },
     });
     return new QRCamera(stream, player);
 }
 /**
- * Run callback in a loop with requestAnimationFrame
- * @param cb - callback
+ * Run callback in a loop with requestAnimationFrame.
+ * @param cb - Callback invoked for each requested animation frame.
+ * @returns Canceller that stops the scheduled loop.
  * @example
- * const cancel = frameLoop((ns) => console.log(ns));
- * cancel();
+ * Run a callback on every animation frame until cancelled.
+ * ```ts
+ * import { frameLoop } from 'qr/dom.js';
+ * if (typeof requestAnimationFrame !== 'undefined') {
+ *   const cancel = frameLoop(() => {});
+ *   cancel();
+ * }
+ * ```
  */
 export function frameLoop(cb) {
     let handle = undefined;
     function loop(ts) {
+        // HTML `AnimationFrameProvider` IDL defines `FrameRequestCallback` as
+        // `undefined (DOMHighResTimeStamp time)`. The returned canceller is for the
+        // scheduled handle between frames, not self-cancel from inside `cb`, because
+        // this loop requests the next frame only after `cb` returns.
         cb(ts);
         handle = requestAnimationFrame(loop);
     }
@@ -290,6 +357,23 @@ export function frameLoop(cb) {
         handle = undefined;
     };
 }
+/**
+ * Convert an SVG string into a PNG data URL in browser environments.
+ * @param svgData - SVG markup to rasterize.
+ * @param width - Output PNG width in pixels.
+ * @param height - Output PNG height in pixels.
+ * @returns Promise that resolves to a PNG `data:` URL.
+ * @example
+ * Convert an SVG string into a PNG data URL in browser environments.
+ * ```ts
+ * import { svgToPng } from 'qr/dom.js';
+ * const svg = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1 1"><rect width="1" height="1"/></svg>';
+ * if (typeof DOMParser !== 'undefined' && typeof document !== 'undefined') {
+ *   const pngUrl = await svgToPng(svg, 256, 256);
+ *   void pngUrl;
+ * }
+ * ```
+ */
 export function svgToPng(svgData, width, height) {
     return new Promise((resolve, reject) => {
         if (!(Number.isSafeInteger(width) &&
@@ -312,7 +396,10 @@ export function svgToPng(svgData, width, height) {
         const serializer = new XMLSerializer();
         const source = serializer.serializeToString(doc);
         const img = new Image();
-        img.src = 'data:image/svg+xml,' + encodeURIComponent(source);
+        // HTMLImageElement IDL exposes `src` as the URL attribute and `onload` /
+        // `onerror` as EventHandler attributes. Register handlers before mutating
+        // `src` so a fast image implementation cannot complete before listeners
+        // exist.
         img.onload = function () {
             const canvas = document.createElement('canvas');
             canvas.width = width;
@@ -325,6 +412,39 @@ export function svgToPng(svgData, width, height) {
             resolve(dataUrl);
         };
         img.onerror = reject;
+        img.src = 'data:image/svg+xml,' + encodeURIComponent(source);
     });
 }
+/**
+ * Convert GIF bytes into a PNG blob in browser environments.
+ * @param gifBytes - GIF file contents.
+ * @returns Promise that resolves to a PNG blob.
+ * @throws If the browser cannot create an image bitmap or rendering context for the GIF. {@link Error}
+ * @example
+ * Convert GIF bytes into a PNG blob in browser environments.
+ * ```ts
+ * import { gifToPng } from 'qr/dom.js';
+ * if (typeof window !== 'undefined') {
+ *   const gif = new Uint8Array(await (await fetch('/qr.gif')).arrayBuffer());
+ *   const png = await gifToPng(gif);
+ *   void png;
+ * }
+ * ```
+ */
+export async function gifToPng(gifBytes) {
+    const blob = new Blob([gifBytes], { type: 'image/gif' });
+    const bitmap = await createImageBitmap(blob);
+    try {
+        const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
+        const ctx = canvas.getContext('bitmaprenderer', { alpha: false });
+        if (!ctx)
+            throw new Error('was not able to create bitmaprenderer context');
+        ctx.transferFromImageBitmap(bitmap);
+        return await canvas.convertToBlob({ type: 'image/png' });
+    }
+    finally {
+        // Release the decoded bitmap even when context creation or PNG encoding fails.
+        bitmap.close();
+    }
+}
 //# sourceMappingURL=dom.js.map

package/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","sourceRoot":"","sources":["src/dom.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["src/dom.ts"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -14,8 +14,75 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 */
+/**
+ * Methods for encoding (generating) QR code patterns.
+ * Check out decode.ts for decoding (reading).
+ * @module
+ * @example
+```js
+import encodeQR from 'qr';
+const txt = 'Hello world';
+const ascii = encodeQR(txt, 'ascii'); // Not all fonts are supported
+const terminalFriendly = encodeQR(txt, 'term'); // 2x larger, all fonts are OK
+const gifBytes = encodeQR(txt, 'gif'); // Uncompressed GIF
+const svgElement = encodeQR(txt, 'svg'); // SVG vector image element
+const array = encodeQR(txt, 'raw'); // 2d array for canvas or other libs
+// import decodeQR from 'qr/decode.js';
+```
+ */
+/**
+ * Bytes API type helpers for old + new TypeScript.
+ *
+ * TS 5.6 has `Uint8Array`, while TS 5.9+ made it generic `Uint8Array<ArrayBuffer>`.
+ * We can't use specific return type, because TS 5.6 will error.
+ * We can't use generic return type, because most TS 5.9 software will expect specific type.
+ *
+ * Maps typed-array input leaves to broad forms.
+ * These are compatibility adapters, not ownership guarantees.
+ *
+ * - `TArg` keeps byte inputs broad.
+ * - `TRet` marks byte outputs for TS 5.6 and TS 5.9+ compatibility.
+ */
+export type TypedArg<T> = T extends BigInt64Array ? BigInt64Array : T extends BigUint64Array ? BigUint64Array : T extends Float32Array ? Float32Array : T extends Float64Array ? Float64Array : T extends Int16Array ? Int16Array : T extends Int32Array ? Int32Array : T extends Int8Array ? Int8Array : T extends Uint16Array ? Uint16Array : T extends Uint32Array ? Uint32Array : T extends Uint8ClampedArray ? Uint8ClampedArray : T extends Uint8Array ? Uint8Array : never;
+/** Maps typed-array output leaves to narrow TS-compatible forms. */
+export type TypedRet<T> = T extends BigInt64Array ? ReturnType<typeof BigInt64Array.of> : T extends BigUint64Array ? ReturnType<typeof BigUint64Array.of> : T extends Float32Array ? ReturnType<typeof Float32Array.of> : T extends Float64Array ? ReturnType<typeof Float64Array.of> : T extends Int16Array ? ReturnType<typeof Int16Array.of> : T extends Int32Array ? ReturnType<typeof Int32Array.of> : T extends Int8Array ? ReturnType<typeof Int8Array.of> : T extends Uint16Array ? ReturnType<typeof Uint16Array.of> : T extends Uint32Array ? ReturnType<typeof Uint32Array.of> : T extends Uint8ClampedArray ? ReturnType<typeof Uint8ClampedArray.of> : T extends Uint8Array ? ReturnType<typeof Uint8Array.of> : never;
+/** Recursively adapts byte-carrying API input types. See {@link TypedArg}. */
+export type TArg<T> = T | ([TypedArg<T>] extends [never] ? T extends (...args: infer A) => infer R ? ((...args: {
+    [K in keyof A]: TRet<A[K]>;
+}) => TArg<R>) & {
+    [K in keyof T]: T[K] extends (...args: any) => any ? T[K] : TArg<T[K]>;
+} : T extends [infer A, ...infer R] ? [TArg<A>, ...{
+    [K in keyof R]: TArg<R[K]>;
+}] : T extends readonly [infer A, ...infer R] ? readonly [TArg<A>, ...{
+    [K in keyof R]: TArg<R[K]>;
+}] : T extends (infer A)[] ? TArg<A>[] : T extends readonly (infer A)[] ? readonly TArg<A>[] : T extends Promise<infer A> ? Promise<TArg<A>> : T extends object ? {
+    [K in keyof T]: TArg<T[K]>;
+} : T : TypedArg<T>);
+/** Recursively adapts byte-carrying API output types. See {@link TypedArg}. */
+export type TRet<T> = T extends unknown ? T & ([TypedRet<T>] extends [never] ? T extends (...args: infer A) => infer R ? ((...args: {
+    [K in keyof A]: TArg<A[K]>;
+}) => TRet<R>) & {
+    [K in keyof T]: T[K] extends (...args: any) => any ? T[K] : TRet<T[K]>;
+} : T extends [infer A, ...infer R] ? [TRet<A>, ...{
+    [K in keyof R]: TRet<R[K]>;
+}] : T extends readonly [infer A, ...infer R] ? readonly [TRet<A>, ...{
+    [K in keyof R]: TRet<R[K]>;
+}] : T extends (infer A)[] ? TRet<A>[] : T extends readonly (infer A)[] ? readonly TRet<A>[] : T extends Promise<infer A> ? Promise<TRet<A>> : T extends object ? {
+    [K in keyof T]: TRet<T[K]>;
+} : T : TypedRet<T>) : never;
+/** Bidirectional codec interface. */
 export interface Coder<F, T> {
+    /**
+     * Encodes a source value into the target representation.
+     * @param from - Source value to encode.
+     * @returns Encoded representation.
+     */
     encode(from: F): T;
+    /**
+     * Decodes a target value back into the source representation.
+     * @param to - Encoded representation to decode.
+     * @returns Decoded source value.
+     */
     decode(to: T): F;
 }
 declare function validateVersion(ver: Version): void;
@@ -27,20 +94,40 @@ declare function best<T>(): {
     get: () => T | undefined;
     score: () => number;
 };
+/** Two-dimensional point. */
 export type Point = {
+    /** Horizontal coordinate. */
     x: number;
+    /** Vertical coordinate. */
     y: number;
 };
+/** Width and height pair. */
 export type Size = {
+    /** Pixel height. */
     height: number;
+    /** Pixel width. */
     width: number;
 };
+/** Raster image used by the encoder and decoder. */
 export type Image = Size & {
+    /** Row-major RGB or RGBA pixel data. */
     data: Uint8Array | Uint8ClampedArray | number[];
 };
 type DrawValue = boolean | undefined;
 type DrawFn = DrawValue | ((c: Point, curr: DrawValue) => DrawValue);
 type ReadFn = (c: Point, curr: DrawValue) => void;
+/**
+ * Mutable monochrome bitmap used as the internal QR representation.
+ * @param size - Square edge length or explicit bitmap dimensions.
+ * @param data - Optional row-major pixel matrix using `true`, `false`, or `undefined`.
+ * @example
+ * Create a bitmap, then scale it for display.
+ * ```ts
+ * import { Bitmap } from 'qr';
+ * const bitmap = Bitmap.fromString('X \n X');
+ * bitmap.scale(2);
+ * ```
+ */
 export declare class Bitmap {
     private static size;
     static fromString(s: string): Bitmap;
@@ -94,81 +181,134 @@ export declare class Bitmap {
     toGIF(): Uint8Array;
     toImage(isRGB?: boolean): Image;
 }
-/** Error correction mode. low: 7%, medium: 15%, quartile: 25%, high: 30% */
-export declare const ECMode: readonly ["low", "medium", "quartile", "high"];
-/** Error correction mode. */
+/** Error correction mode. low: 7%, medium: 15%, quartile: 25%, high: 30%. */
+export declare const ECMode: readonly ['low', 'medium', 'quartile', 'high'];
+/** Error correction mode name. */
 export type ErrorCorrection = (typeof ECMode)[number];
-/** QR Code version. */
+/** QR Code version in the `[1..40]` range. */
 export type Version = number;
-/** QR Code mask type */
+/** QR Code mask index. */
 export type Mask = (0 | 1 | 2 | 3 | 4 | 5 | 6 | 7) & keyof typeof PATTERNS;
-/** QR Code encoding */
-export declare const Encoding: readonly ["numeric", "alphanumeric", "byte", "kanji", "eci"];
-/** QR Code encoding type */
+/**
+ * QR payload compaction mode names recognized by the type/validator.
+ * `kanji` and `eci` are spec modes, but `encodeQR` currently rejects them until implemented.
+ */
+export declare const Encoding: readonly ['numeric', 'alphanumeric', 'byte', 'kanji', 'eci'];
+/** QR payload encoding name. */
 export type EncodingType = (typeof Encoding)[number];
 declare const PATTERNS: readonly ((x: number, y: number) => boolean)[];
-declare function interleave(ver: Version, ecc: ErrorCorrection): Coder<Uint8Array, Uint8Array>;
-declare function drawTemplate(ver: Version, ecc: ErrorCorrection, maskIdx: Mask, test?: boolean): Bitmap;
-declare function zigzag(tpl: Bitmap, maskIdx: Mask, fn: (x: number, y: number, mask: boolean) => void): void;
+declare function interleave(ver: Version, ecc: ErrorCorrection): TRet<Coder<Uint8Array, Uint8Array>>;
+declare function drawTemplate(ver: Version, ecc: ErrorCorrection, maskIdx: Mask, test?: boolean): TRet<Bitmap>;
+declare function zigzag(tpl: TArg<Bitmap>, maskIdx: Mask, fn: (x: number, y: number, mask: boolean) => void): void;
 declare function detectType(str: string): EncodingType;
 /**
- * @example utf8ToBytes('abc') // new Uint8Array([97, 98, 99])
+ * Encode a string as UTF-8 bytes.
+ * @param str - Text to encode into UTF-8.
+ * @returns UTF-8 bytes for the provided string.
+ * @throws If the input is not a string. {@link Error}
+ * @example
+ * Encode a string as UTF-8 bytes.
+ * ```ts
+ * const bytes = utf8ToBytes('abc'); // new Uint8Array([97, 98, 99])
+ * ```
  */
-export declare function utf8ToBytes(str: string): Uint8Array;
-declare function encode(ver: Version, ecc: ErrorCorrection, data: string, type: EncodingType, encoder?: (value: string) => Uint8Array): Uint8Array;
-declare function drawQR(ver: Version, ecc: ErrorCorrection, data: Uint8Array, maskIdx: Mask, test?: boolean): Bitmap;
-declare function penalty(bm: Bitmap): number;
+export declare function utf8ToBytes(str: string): TRet<Uint8Array>;
+declare function encode(ver: Version, ecc: ErrorCorrection, data: string, type: EncodingType, encoder?: TArg<(value: string) => Uint8Array>): TRet<Uint8Array>;
+declare function drawQR(ver: Version, ecc: ErrorCorrection, data: TArg<Uint8Array>, maskIdx: Mask, test?: boolean): TRet<Bitmap>;
+declare function penalty(bm: TArg<Bitmap>): number;
 /** QR Code generation options. */
 export type QrOpts = {
+    /** Error-correction level to encode into the symbol. */
     ecc?: ErrorCorrection | undefined;
+    /** Explicit payload encoding, otherwise detected from the input text. */
     encoding?: EncodingType | undefined;
-    textEncoder?: (text: string) => Uint8Array;
+    /**
+     * Custom text encoder used for `byte` payloads.
+     *
+     * Receives the text payload and returns the encoded byte sequence.
+     * @param text - Text payload to encode.
+     * @returns Encoded byte sequence for the payload.
+     */
+    textEncoder?: TArg<(text: string) => Uint8Array>;
+    /** Explicit QR version to use instead of auto-fitting. */
     version?: Version | undefined;
+    /** Explicit mask pattern to apply instead of choosing the best one. */
     mask?: number | undefined;
+    /** Quiet-zone border width in modules. */
     border?: number | undefined;
+    /** Output scale multiplier for raster formats. */
     scale?: number | undefined;
 };
+/** SVG-specific QR output options. */
 export type SvgQrOpts = {
     /**
      * Controls how cells are generated within the SVG.
      *
      * If `true`:
      *   - Cells are drawn using a single `path` element.
-     *   - Pro: significantly reduces the size of the QR code (>70% smaller than
+     *   - Pro: significantly reduces the size of the QR code (`70%` smaller than
      *     unoptimized).
      *   - Con: less flexible with visually customizing cell shapes.
      *
      * If `false`:
      *   - Each cell is drawn with its own `rect` element.
      *   - Pro: allows more flexibility with visually customizing cells shapes.
-     *   - Con: significantly increases the QR code size (>230% larger than
+     *   - Con: significantly increases the QR code size (`230%` larger than
      *     optimized).
      *
-     * @default true
+     * Default is `true`.
      */
     optimize?: boolean | undefined;
 };
+/** Supported encoder outputs. */
 export type Output = 'raw' | 'ascii' | 'term' | 'gif' | 'svg';
 /**
  * Encodes (creates / generates) QR code.
- * @param text text that would be encoded
- * @param output output type: raw, ascii, svg, gif, or term
- * @param opts
+ * @param text - Text payload that should be encoded into the QR symbol.
+ * @param output - Output format to generate: raw matrix, ASCII, terminal ANSI, GIF, or SVG.
+ * @param opts - Encoding and rendering options. See {@link QrOpts} and {@link SvgQrOpts}.
+ * @returns Encoded QR data in the format selected by `output`.
+ * @throws If the payload, options, QR capacity, or output format are invalid. {@link Error}
  * @example
-```js
-const txt = 'Hello world';
-const ascii = encodeQR(txt, 'ascii'); // Not all fonts are supported
-const terminalFriendly = encodeQR(txt, 'term'); // 2x larger, all fonts are OK
-const gifBytes = encodeQR(txt, 'gif'); // Uncompressed GIF
-const svgElement = encodeQR(txt, 'svg'); // SVG vector image element
-const array = encodeQR(txt, 'raw'); // 2d array for canvas or other libs
-```
+ * Encode one text payload into several QR output formats.
+ * ```ts
+ * const txt = 'Hello world';
+ * const ascii = encodeQR(txt, 'ascii'); // Not all fonts are supported
+ * const terminalFriendly = encodeQR(txt, 'term'); // 2x larger, all fonts are OK
+ * const gifBytes = encodeQR(txt, 'gif'); // Uncompressed GIF
+ * const svgElement = encodeQR(txt, 'svg'); // SVG vector image element
+ * const array = encodeQR(txt, 'raw'); // 2d array for canvas or other libs
+ * ```
+ */
+export declare function encodeQR(text: string, output: 'raw', opts?: TArg<QrOpts>): boolean[][];
+export declare function encodeQR(text: string, output: 'ascii' | 'term', opts?: TArg<QrOpts>): string;
+export declare function encodeQR(text: string, output: 'svg', opts?: TArg<QrOpts & SvgQrOpts>): string;
+export declare function encodeQR(text: string, output: 'gif', opts?: TArg<QrOpts>): TRet<Uint8Array>;
+/**
+ * Default export alias for {@link encodeQR}.
+ * @param text - Text payload that should be encoded into the QR symbol.
+ * @param output - Output format to generate: raw matrix, ASCII, terminal ANSI, GIF, or SVG.
+ * @param opts - Encoding and rendering options. See {@link QrOpts} and {@link SvgQrOpts}.
+ * @returns Encoded QR data in the format selected by `output`.
+ * @throws If the payload, options, QR capacity, or output format are invalid. {@link Error}
+ * @example
+ * Encode text into the default export from the package root.
+ * ```ts
+ * import encodeQR from 'qr';
+ * encodeQR('Hello world', 'ascii');
+ * ```
  */
-export declare function encodeQR(text: string, output: 'raw', opts?: QrOpts): boolean[][];
-export declare function encodeQR(text: string, output: 'ascii' | 'term', opts?: QrOpts): string;
-export declare function encodeQR(text: string, output: 'svg', opts?: QrOpts & SvgQrOpts): string;
-export declare function encodeQR(text: string, output: 'gif', opts?: QrOpts): Uint8Array;
 export default encodeQR;
+/**
+ * Low-level helpers used by the encoder and test suite.
+ * Exports the shared helper tables/functions through a frozen container.
+ * @example
+ * Read low-level QR metadata tables.
+ * ```ts
+ * import { utils } from 'qr';
+ * const size = utils.info.size.encode(1); // 21
+ * ```
+ */
 export declare const utils: {
     best: typeof best;
     bin: typeof bin;