@gmitch215/tinyimg 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,345 @@
+/**
+ * The option and error vocabulary the wrapper speaks.
+ *
+ * The names mirror Cloudflare Images' own transformation parameters wherever there is one to mirror,
+ * because the point of the library is to do that work inside the Worker instead of paying for it:
+ * a caller moving off the binding should be able to keep the option object they already have.
+ */
+/** A container format, mirroring `TinyImageFormat`. */
+export type ImageFormat = 'png' | 'jpeg' | 'bmp' | 'gif' | 'tiff' | 'webp' | 'avif' | 'heif';
+/**
+ * How an aspect mismatch is absorbed, mirroring `TinyImageFit`.
+ *
+ * The eleven are two independent choices read as one: whether the mismatch is left, cropped, padded
+ * or distorted, and whether the scale may rise, fall, both or neither.
+ */
+export type Fit = 'scale-down' | 'contain' | 'cover' | 'crop' | 'aspect-crop' | 'aspect-contain' | 'aspect-cover' | 'pad' | 'stretch' | 'fill' | 'scale-up';
+/**
+ * Which part of an image a crop keeps, mirroring `TinyImageGravity`.
+ *
+ * `auto` weights the image by local detail and centers on the result. `face` runs the detector and
+ * centers on what it finds, falling back to `auto` when no cascade is loaded or nothing is found;
+ * see {@link TinyImgModule.loadBlob}.
+ */
+export type Gravity = 'center' | 'north' | 'south' | 'west' | 'east' | 'north-west' | 'north-east' | 'south-west' | 'south-east' | 'auto' | 'face';
+/** Which weights a resample reads through, mirroring `TinyResampleFilter`. */
+export type ResampleFilter = 'auto' | 'nearest' | 'bilinear' | 'box' | 'catmull-rom';
+/** Which axes a flip mirrors. */
+export type FlipAxis = 'horizontal' | 'vertical' | 'both';
+/** What to do with metadata on encode. */
+export type MetadataPolicy = 'keep' | 'none';
+/**
+ * A color.
+ *
+ * Either CSS-style hex (`'#rgb'`, `'#rrggbb'`, `'#rrggbbaa'`, with or without the hash) or channel
+ * values as numbers. A three number array is RGB and a four is RGBA; a single number is gray.
+ */
+export type Color = string | readonly number[];
+/**
+ * Everything a one-shot transformation can ask for.
+ *
+ * Every field is optional and an empty object is a valid request: it decodes and re-encodes. The
+ * order the operations run in is fixed and documented on {@link transform}, because an option
+ * object has no order of its own and two callers writing the same keys have to get the same image.
+ */
+export interface TransformOptions {
+    /** Target width in pixels. With `height` unset, the aspect ratio is kept. */
+    width?: number;
+    /** Target height in pixels. With `width` unset, the aspect ratio is kept. */
+    height?: number;
+    /** How an aspect mismatch is absorbed. Only read when both `width` and `height` are set. */
+    fit?: Fit;
+    /** Which part a crop keeps, or where a pad puts the image. */
+    gravity?: Gravity;
+    /** Weights the resample reads through. `auto` is an area average down and a cubic up. */
+    filter?: ResampleFilter;
+    /** Source rectangle, taken before anything else. */
+    crop?: Rect;
+    /** Multiplies `width` and `height`, for serving a retina variant of one request. */
+    dpr?: number;
+    /** Quarter turns clockwise. Anything else is rejected; use {@link Image.rotateFree}. */
+    rotate?: 0 | 90 | 180 | 270;
+    /** Which axes to mirror. */
+    flip?: FlipAxis;
+    /** Scales every channel. 1 is unchanged. */
+    brightness?: number;
+    /** Scales every channel about mid gray. 1 is unchanged. */
+    contrast?: number;
+    /** Moves every channel toward or away from its luminance. 1 is unchanged. */
+    saturation?: number;
+    /** Rotates the hue, in degrees. */
+    hue?: number;
+    /** Raises every channel to a power. 1 is unchanged. */
+    gamma?: number;
+    /** Replaces every channel with the pixel's luminance. */
+    grayscale?: boolean;
+    /** Subtracts every channel from full scale, leaving alpha alone. */
+    invert?: boolean;
+    /** Gaussian blur radius in pixels. */
+    blur?: number;
+    /** Unsharp mask amount. */
+    sharpen?: number;
+    /** Trims a uniform border, at this tolerance. `true` means a tolerance of 8. */
+    trim?: boolean | number;
+    /** Fills whatever a pad or a rotation leaves empty. */
+    background?: Color;
+    /**
+     * Container to encode as. Defaults to the source's own format.
+     *
+     * `'auto'` picks one. On its own that is WebP, which is the better artifact. With
+     * {@link TransformOptions.budgetMs} it becomes the best format that fits the budget, which
+     * matters because the encoders differ by about a factor of five per sample.
+     */
+    format?: ImageFormat | 'auto';
+    /**
+     * How much computation the encoder may spend. `'fancy'` is the default.
+     *
+     * A separate axis from {@link TransformOptions.quality}: quality says what the output should
+     * look like, this says how hard to work to get there. See the `effort` option on
+     * `Image.bytes` for what each format gives up and what it was measured to cost.
+     */
+    effort?: 'fancy' | 'fast';
+    /**
+     * A CPU budget in milliseconds, which changes what `format: 'auto'` chooses.
+     *
+     * The Workers Free plan allows 10 milliseconds of CPU per request and it is not configurable,
+     * so a request either fits or fails; there is no paying slightly more. Give a budget below the
+     * limit rather than at it, since the estimate behind the choice is accurate to about 20%.
+     *
+     * An explicitly named `format` is never substituted, however far over budget it is: naming one
+     * is a decision, and this option does not overrule it.
+     */
+    budgetMs?: number;
+    /** Quality for a lossy format, 1 through 100. */
+    quality?: number;
+    /** Use a format's lossless mode where it has one. */
+    lossless?: boolean;
+    /** Write a progressive or interlaced stream. */
+    progressive?: boolean;
+    /** Whether to carry EXIF and other metadata into the output. Defaults to `keep`. */
+    metadata?: MetadataPolicy;
+}
+/** A rectangle in pixels. */
+export interface Rect {
+    /** Left edge. */
+    x: number;
+    /** Top edge. */
+    y: number;
+    /** Width. */
+    width: number;
+    /** Height. */
+    height: number;
+}
+/** An extent in pixels. */
+export interface Extent {
+    /** Width. */
+    width: number;
+    /** Height. */
+    height: number;
+}
+/** Kinds of data the library reads but does not ship, mirroring `TinyBlobKind`. */
+export type BlobKind = 'font' | 'icc' | 'cascade';
+/** What a decoded image is, without its pixels. */
+export interface ImageInfo {
+    /** Width in pixels. */
+    width: number;
+    /** Height in pixels. */
+    height: number;
+    /** Frames the file holds; 1 for a still image. */
+    frames: number;
+    /** The format the magic bytes identified. */
+    format: ImageFormat | 'unknown';
+    /** Channels a full decode would produce. */
+    channels: number;
+    /** Bits per channel in the file, before decoding normalizes them to 8. */
+    bitDepth: number;
+    /** Whether the file carries transparency. */
+    hasAlpha: boolean;
+    /** Whether this is a progressive JPEG, which cannot stream a region. */
+    progressive: boolean;
+}
+/** Decoded samples, with the extent they describe. */
+export interface RawImage {
+    /** Width in pixels. */
+    width: number;
+    /** Height in pixels. */
+    height: number;
+    /** Bytes per pixel, 1 through 4. */
+    channels: number;
+    /** `width * height * channels` bytes, rows tightly packed. */
+    pixels: Uint8Array<ArrayBuffer>;
+}
+/** One detection, in the coordinates of the image that was searched. */
+export interface FaceBox extends Rect {
+    /**
+     * Overlapping raw detections this box was formed from.
+     *
+     * A usable ranking: a face the cascade is confident about fires at several nearby positions and
+     * scales, so the highest is the most likely to be a face.
+     */
+    neighbors: number;
+}
+/** What the planner decided, before any pixel was touched. */
+export interface PlanDecision {
+    /** The region of the source the decoder was asked for. */
+    region: Rect;
+    /** The subsampling denominator the decoder was asked for: 1, 2, 4 or 8. */
+    scale: number;
+    /** Extent the decode produced. */
+    decoded: Extent;
+    /** Extent of the final image, and how many channels it carries. */
+    output: Extent & {
+        /** Channels per pixel, 1 through 4. */
+        channels: number;
+    };
+    /** Operations left after the rewrites. */
+    operations: number;
+    /** Operations an identity or annihilation rule removed. */
+    eliminated: number;
+    /** Operations a pair rule merged into another. */
+    collapsed: number;
+    /** Color stages the operations collapsed into. */
+    colorStages: number;
+    /** Fused passes the run will make. */
+    passes: number;
+    /** Special cases the planner took, by name. */
+    kernels: string[];
+    /**
+     * What running this plan is expected to cost in milliseconds, before any encoder.
+     *
+     * An estimate and not a promise: the rates behind it were measured on one machine, and against
+     * real transforms it lands within about 20%. That is the accuracy the question needs when the
+     * question is whether work will fit inside a CPU limit, and it is not a substitute for
+     * measuring, which {@link TinyImgModule.measure} does.
+     *
+     * 0 when the source header could not be read.
+     */
+    estimateMs: number;
+}
+/**
+ * A failed call.
+ *
+ * Every failure carries the module's own error code, so a caller can branch on the code rather than
+ * on a message, and the subclasses group the codes a caller is likely to treat the same way.
+ */
+export declare class TinyImgError extends Error {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name: string;
+    /** The negative `TinyImageError` the module returned. */
+    readonly code: number;
+    /** The short, stable name the module carries for that code. */
+    readonly codeName: string;
+    constructor(code: number, codeName: string, context?: string);
+}
+/** An argument was NULL, outside its range, or a rectangle fell outside the image. */
+export declare class TinyImgArgumentError extends TinyImgError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name = "TinyImgArgumentError";
+}
+/** The bytes are not a format this build can read, or not a variant of it that it can. */
+export declare class TinyImgFormatError extends TinyImgError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name = "TinyImgFormatError";
+}
+/** The bitstream is malformed, truncated or internally inconsistent. */
+export declare class TinyImgDataError extends TinyImgError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name = "TinyImgDataError";
+}
+/**
+ * The allocator could not satisfy a request, or the image is past the budget.
+ *
+ * The two are separate codes because the remedy differs, so the budget one is
+ * {@link TinyImgTooLargeError}, a subclass. Catching this catches both.
+ */
+export declare class TinyImgMemoryError extends TinyImgError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name: string;
+}
+/**
+ * The image is past the pixel or byte budget, so no amount of memory would help.
+ *
+ * The remedy is a smaller decode rather than a bigger heap: ask for a region, a scale denominator,
+ * or a transformation whose output fits. A plain {@link TinyImgMemoryError} means the allocator ran
+ * out on a request that was within budget, which is a different problem.
+ */
+export declare class TinyImgTooLargeError extends TinyImgMemoryError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name = "TinyImgTooLargeError";
+}
+/** The operation needs a blob nobody has loaded; see {@link TinyImgModule.loadBlob}. */
+export declare class TinyImgBlobError extends TinyImgError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name = "TinyImgBlobError";
+}
+/** The plan is full, or holds an operation that cannot be combined with the others in it. */
+export declare class TinyImgPlanError extends TinyImgError {
+    /** The error's class, for a caller matching on it without instanceof. */
+    readonly name = "TinyImgPlanError";
+}
+/** Error codes, mirroring `enum TinyImageError`. */
+export declare const Err: {
+    /** The call succeeded. */
+    readonly ok: 0;
+    /** A required pointer argument was NULL. */
+    readonly null: -1;
+    /** An argument was outside its documented range. */
+    readonly range: -2;
+    /** Coordinates or a rectangle fell outside the image. */
+    readonly bounds: -3;
+    /** The allocator could not satisfy a request. */
+    readonly memory: -4;
+    /** The image exceeds the pixel budget; reach for a scaled decode. */
+    readonly tooLarge: -5;
+    /** The buffer matched no format tinyimg recognizes. */
+    readonly unknownFormat: -6;
+    /** Recognized, and this build cannot decode or encode it. */
+    readonly unsupportedCodec: -7;
+    /** The bitstream is malformed, truncated or inconsistent. */
+    readonly corrupt: -8;
+    /** Supported format, unsupported variant of it. */
+    readonly unsupportedVariant: -9;
+    /** The output buffer was too small. */
+    readonly bufferTooSmall: -10;
+    /** A font, profile or cascade nobody has loaded. */
+    readonly blobMissing: -11;
+    /** The image has no channel the operation needs. */
+    readonly noChannel: -12;
+    /** The requested key or metadata entry does not exist. */
+    readonly notFound: -13;
+    /** The plan is full, or holds an operation it cannot combine. */
+    readonly plan: -14;
+};
+/**
+ * Builds the error for a code.
+ *
+ * The mapping lives here rather than beside the module so the classes and the codes they cover stay
+ * in one place; `codeName` comes from the module, which is the only thing that knows it.
+ *
+ * @param code The negative code the module returned.
+ * @param codeName What the module calls it.
+ * @param context What was being attempted, for the message.
+ * @return The error to throw. Never returns for a code of zero, which is not a failure.
+ */
+export declare function errorFor(code: number, codeName: string, context?: string): TinyImgError;
+/** Anything the wrapper will take as an image or a blob. */
+export type Source = Uint8Array | ArrayBuffer | ArrayBufferView | Blob | Response | ReadableStream<Uint8Array>;
+/**
+ * Reads any accepted source into bytes.
+ *
+ * A caller should never have to reach for a `Response.arrayBuffer()` or drain a stream themselves to
+ * hand this library an image; every shape a Worker is likely to be holding one in is accepted.
+ *
+ * @param source The image or blob.
+ * @return Its bytes.
+ */
+export declare function readSource(source: Source): Promise<Uint8Array>;
+/**
+ * Turns a color into channel bytes.
+ *
+ * @param color The color.
+ * @param channels How many the image has.
+ * @return Exactly `channels` bytes.
+ */
+export declare function readColor(color: Color, channels: number): Uint8Array;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,132 @@
+export class TinyImgError extends Error {
+    name = 'TinyImgError';
+    code;
+    codeName;
+    constructor(code, codeName, context) {
+        super(context ? `${context}: ${codeName}` : codeName);
+        this.code = code;
+        this.codeName = codeName;
+    }
+}
+export class TinyImgArgumentError extends TinyImgError {
+    name = 'TinyImgArgumentError';
+}
+export class TinyImgFormatError extends TinyImgError {
+    name = 'TinyImgFormatError';
+}
+export class TinyImgDataError extends TinyImgError {
+    name = 'TinyImgDataError';
+}
+export class TinyImgMemoryError extends TinyImgError {
+    name = 'TinyImgMemoryError';
+}
+export class TinyImgTooLargeError extends TinyImgMemoryError {
+    name = 'TinyImgTooLargeError';
+}
+export class TinyImgBlobError extends TinyImgError {
+    name = 'TinyImgBlobError';
+}
+export class TinyImgPlanError extends TinyImgError {
+    name = 'TinyImgPlanError';
+}
+export const Err = {
+    ok: 0,
+    null: -1,
+    range: -2,
+    bounds: -3,
+    memory: -4,
+    tooLarge: -5,
+    unknownFormat: -6,
+    unsupportedCodec: -7,
+    corrupt: -8,
+    unsupportedVariant: -9,
+    bufferTooSmall: -10,
+    blobMissing: -11,
+    noChannel: -12,
+    notFound: -13,
+    plan: -14
+};
+export function errorFor(code, codeName, context) {
+    switch (code) {
+        case Err.null:
+        case Err.range:
+        case Err.bounds:
+        case Err.noChannel:
+        case Err.bufferTooSmall:
+            return new TinyImgArgumentError(code, codeName, context);
+        case Err.unknownFormat:
+        case Err.unsupportedCodec:
+        case Err.unsupportedVariant:
+            return new TinyImgFormatError(code, codeName, context);
+        case Err.corrupt:
+            return new TinyImgDataError(code, codeName, context);
+        case Err.memory:
+            return new TinyImgMemoryError(code, codeName, context);
+        case Err.tooLarge:
+            return new TinyImgTooLargeError(code, codeName, context);
+        case Err.blobMissing:
+            return new TinyImgBlobError(code, codeName, context);
+        case Err.plan:
+            return new TinyImgPlanError(code, codeName, context);
+        default:
+            return new TinyImgError(code, codeName, context);
+    }
+}
+export async function readSource(source) {
+    if (source instanceof Uint8Array)
+        return source;
+    if (source instanceof ArrayBuffer)
+        return new Uint8Array(source);
+    if (source instanceof Response) {
+        if (!source.body)
+            throw new TypeError('the Response has no body');
+        return new Uint8Array(await source.arrayBuffer());
+    }
+    if (typeof Blob !== 'undefined' && source instanceof Blob) {
+        return new Uint8Array(await source.arrayBuffer());
+    }
+    if (source instanceof ReadableStream) {
+        return new Uint8Array(await new Response(source).arrayBuffer());
+    }
+    if (ArrayBuffer.isView(source)) {
+        return new Uint8Array(source.buffer, source.byteOffset, source.byteLength);
+    }
+    throw new TypeError('expected bytes, an ArrayBuffer, a Blob, a Response or a ReadableStream');
+}
+export function readColor(color, channels) {
+    const out = new Uint8Array(channels);
+    if (typeof color !== 'string') {
+        const values = [...color];
+        if (values.length === 0)
+            throw new TypeError('the color has no channels');
+        for (let i = 0; i < channels; i++) {
+            const value = values[Math.min(i, values.length - 1)];
+            out[i] = Math.max(0, Math.min(255, Math.round(value)));
+        }
+        if ((channels === 2 || channels === 4) && values.length < channels) {
+            out[channels - 1] = 255;
+        }
+        return out;
+    }
+    const hex = color.startsWith('#') ? color.slice(1) : color;
+    const wide = hex.length <= 4 ? [...hex].map((digit) => digit + digit).join('') : hex;
+    if (!/^[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/.test(wide)) {
+        throw new TypeError(`'${color}' is not a hex color`);
+    }
+    const rgba = [
+        parseInt(wide.slice(0, 2), 16),
+        parseInt(wide.slice(2, 4), 16),
+        parseInt(wide.slice(4, 6), 16),
+        wide.length === 8 ? parseInt(wide.slice(6, 8), 16) : 255
+    ];
+    if (channels >= 3) {
+        for (let i = 0; i < channels; i++)
+            out[i] = rgba[i === 3 ? 3 : i];
+        return out;
+    }
+    out[0] = Math.round(0.2126 * rgba[0] + 0.7152 * rgba[1] + 0.0722 * rgba[2]);
+    if (channels === 2)
+        out[1] = rgba[3];
+    return out;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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