mirror of
https://github.com/outline/outline.git
synced 2026-11-20 21:23:06 +03:00
* feat: Support HEIC avatar uploads with in-browser conversion HEIC and HEIF images picked for an avatar are now converted to JPEG in the browser before the cropper opens. The browser's own decoder is used when it supports the format, otherwise a WebAssembly decoder is loaded on demand. Also collects the image utilities into an ImageHelper class, fixes the crop dialog's submit button never disabling, and stops the upload from forwarding request headers the browser controls itself. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> * refactor: Use only the browser's own HEIC decoder Drops the bundled WebAssembly decoder in favour of the browser's native support. This removes an LGPL dependency and a 3MB lazy chunk, and lets the Content Security Policy stay as it was. Browsers without HEIC support now get a message asking for a JPEG or PNG. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> * docs: Add class-level JSDoc to ImageHelper Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
96 lines
2.7 KiB
TypeScript
96 lines
2.7 KiB
TypeScript
import Compressor from "compressorjs";
|
|
|
|
/**
|
|
* Helpers for inspecting and transforming images in the browser.
|
|
*/
|
|
export class ImageHelper {
|
|
/**
|
|
* Checks whether a file is a HEIC or HEIF image. The extension is also
|
|
* checked because some platforms report an empty mime-type for these files.
|
|
*
|
|
* @param file the file to check.
|
|
* @returns true if the file is a HEIC or HEIF image.
|
|
*/
|
|
public static isHeic(file: File): boolean {
|
|
const contentTypes = [
|
|
"image/heic",
|
|
"image/heif",
|
|
"image/heic-sequence",
|
|
"image/heif-sequence",
|
|
];
|
|
const extensions = [".heic", ".heif"];
|
|
|
|
return (
|
|
contentTypes.includes(file.type.toLowerCase()) ||
|
|
extensions.some((extension) =>
|
|
file.name.toLowerCase().endsWith(extension)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Compresses an image file or blob, optionally constraining its dimensions.
|
|
*
|
|
* @param file the image file or blob to compress.
|
|
* @param options optional compression options, the result is returned by the
|
|
* promise rather than the success and error callbacks.
|
|
* @returns a promise resolving to the compressed image blob.
|
|
*/
|
|
public static compress(
|
|
file: File | Blob,
|
|
options?: Omit<Compressor.Options, "success" | "error">
|
|
): Promise<Blob> {
|
|
return new Promise((resolve, reject) => {
|
|
new Compressor(file, { ...options, success: resolve, error: reject });
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Converts a HEIC or HEIF image to a JPEG that all browsers can display,
|
|
* using the browser's own decoder. Support is limited, so callers must
|
|
* handle an undefined result.
|
|
*
|
|
* @param file the HEIC or HEIF file to convert.
|
|
* @returns a promise resolving to the converted JPEG file, or undefined if
|
|
* the browser cannot decode the format.
|
|
*/
|
|
public static async convertHeicToJpeg(file: File): Promise<File | undefined> {
|
|
if (typeof createImageBitmap === "undefined") {
|
|
return undefined;
|
|
}
|
|
|
|
let bitmap: ImageBitmap;
|
|
try {
|
|
bitmap = await createImageBitmap(file, {
|
|
imageOrientation: "from-image",
|
|
});
|
|
} catch (_err) {
|
|
return undefined;
|
|
}
|
|
|
|
try {
|
|
const canvas = document.createElement("canvas");
|
|
canvas.width = bitmap.width;
|
|
canvas.height = bitmap.height;
|
|
|
|
const context = canvas.getContext("2d");
|
|
if (!context) {
|
|
return undefined;
|
|
}
|
|
context.drawImage(bitmap, 0, 0);
|
|
|
|
const blob = await new Promise<Blob | null>((resolve) => {
|
|
canvas.toBlob(resolve, "image/jpeg", 0.92);
|
|
});
|
|
if (!blob) {
|
|
return undefined;
|
|
}
|
|
|
|
const name = `${file.name.replace(/\.(heic|heif)$/i, "")}.jpg`;
|
|
return new File([blob], name, { type: "image/jpeg" });
|
|
} finally {
|
|
bitmap.close();
|
|
}
|
|
}
|
|
}
|