@zsviczian/excalidraw 0.14.2-obsidian-4 → 0.15.2-obsidian-1

package/types/constants.d.ts

@@ -1,170 +1,192 @@
-import { AppProps } from "./types";
-import { FontFamilyValues } from "./element/types";
-export declare const isDarwin: boolean;
-export declare const isWindows: boolean;
-export declare const isAndroid: boolean;
-export declare const isFirefox: boolean;
-export declare const isChrome: boolean;
-export declare const isSafari: boolean;
-export declare const isBrave: () => boolean;
-export declare const APP_NAME = "Excalidraw";
-export declare const DRAGGING_THRESHOLD = 10;
-export declare const LINE_CONFIRM_THRESHOLD = 8;
-export declare const ELEMENT_SHIFT_TRANSLATE_AMOUNT = 5;
-export declare const ELEMENT_TRANSLATE_AMOUNT = 1;
-export declare const TEXT_TO_CENTER_SNAP_THRESHOLD = 30;
-export declare const SHIFT_LOCKING_ANGLE: number;
-export declare const CURSOR_TYPE: {
-    TEXT: string;
-    CROSSHAIR: string;
-    GRABBING: string;
-    GRAB: string;
-    POINTER: string;
-    MOVE: string;
-    AUTO: string;
-};
-export declare const POINTER_BUTTON: {
-    readonly MAIN: 0;
-    readonly WHEEL: 1;
-    readonly SECONDARY: 2;
-    readonly TOUCH: -1;
-};
-export declare enum EVENT {
-    COPY = "copy",
-    PASTE = "paste",
-    CUT = "cut",
-    KEYDOWN = "keydown",
-    KEYUP = "keyup",
-    MOUSE_MOVE = "mousemove",
-    RESIZE = "resize",
-    UNLOAD = "unload",
-    FOCUS = "focus",
-    BLUR = "blur",
-    DRAG_OVER = "dragover",
-    DROP = "drop",
-    GESTURE_END = "gestureend",
-    BEFORE_UNLOAD = "beforeunload",
-    GESTURE_START = "gesturestart",
-    GESTURE_CHANGE = "gesturechange",
-    POINTER_MOVE = "pointermove",
-    POINTER_UP = "pointerup",
-    STATE_CHANGE = "statechange",
-    WHEEL = "wheel",
-    TOUCH_START = "touchstart",
-    TOUCH_END = "touchend",
-    HASHCHANGE = "hashchange",
-    VISIBILITY_CHANGE = "visibilitychange",
-    SCROLL = "scroll",
-    EXCALIDRAW_LINK = "excalidraw-link",
-    MENU_ITEM_SELECT = "menu.itemSelect"
-}
-export declare const ENV: {
-    TEST: string;
-    DEVELOPMENT: string;
-};
-export declare const CLASSES: {
-    SHAPE_ACTIONS_MENU: string;
-    SHAPE_ACTIONS_MOBILE_MENU: string;
-    MOBILE_TOOLBAR: string;
-};
-export declare const FONT_FAMILY: {
-    Virgil: number;
-    Helvetica: number;
-    Cascadia: number;
-    LocalFont: number;
-};
-export declare const THEME: {
-    LIGHT: string;
-    DARK: string;
-};
-export declare const WINDOWS_EMOJI_FALLBACK_FONT = "Segoe UI Emoji";
-export declare const DEFAULT_FONT_SIZE = 20;
-export declare const DEFAULT_FONT_FAMILY: FontFamilyValues;
-export declare const DEFAULT_TEXT_ALIGN = "left";
-export declare const DEFAULT_VERTICAL_ALIGN = "top";
-export declare const DEFAULT_VERSION = "{version}";
-export declare const CANVAS_ONLY_ACTIONS: string[];
-export declare const GRID_SIZE = 20;
-export declare const MIME_TYPES: {
-    readonly excalidraw: "application/vnd.excalidraw+json";
-    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
-    readonly json: "application/json";
-    readonly svg: "image/svg+xml";
-    readonly "excalidraw.svg": "image/svg+xml";
-    readonly png: "image/png";
-    readonly "excalidraw.png": "image/png";
-    readonly jpg: "image/jpeg";
-    readonly gif: "image/gif";
-    readonly webp: "image/webp";
-    readonly bmp: "image/bmp";
-    readonly ico: "image/x-icon";
-    readonly binary: "application/octet-stream";
-};
-export declare const EXPORT_DATA_TYPES: {
-    readonly excalidraw: "excalidraw";
-    readonly excalidrawClipboard: "excalidraw/clipboard";
-    readonly excalidrawLibrary: "excalidrawlib";
-};
-export declare const EXPORT_SOURCE: string;
-export declare const IMAGE_RENDER_TIMEOUT = 500;
-export declare const TAP_TWICE_TIMEOUT = 300;
-export declare const TOUCH_CTX_MENU_TIMEOUT = 500;
-export declare const TITLE_TIMEOUT = 10000;
-export declare const VERSION_TIMEOUT = 30000;
-export declare const SCROLL_TIMEOUT = 100;
-export declare const ZOOM_STEP = 0.05;
-export declare const MIN_ZOOM = 0.1;
-export declare const HYPERLINK_TOOLTIP_DELAY = 300;
-export declare const IDLE_THRESHOLD = 60000;
-export declare const ACTIVE_THRESHOLD = 3000;
-export declare const THEME_FILTER: any;
-export declare const URL_QUERY_KEYS: {
-    readonly addLibrary: "addLibrary";
-};
-export declare const URL_HASH_KEYS: {
-    readonly addLibrary: "addLibrary";
-};
-export declare const DEFAULT_UI_OPTIONS: AppProps["UIOptions"];
-export declare const MQ_SM_MAX_WIDTH = 640;
-export declare const MQ_MAX_WIDTH_PORTRAIT = 730;
-export declare const MQ_MAX_WIDTH_LANDSCAPE = 1000;
-export declare const MQ_MAX_HEIGHT_LANDSCAPE = 500;
-export declare const MQ_RIGHT_SIDEBAR_MIN_WIDTH = 1229;
-export declare const LIBRARY_SIDEBAR_WIDTH: number;
-export declare const MAX_DECIMALS_FOR_SVG_EXPORT = 2;
-export declare const EXPORT_SCALES: number[];
-export declare const DEFAULT_EXPORT_PADDING = 10;
-export declare const DEFAULT_MAX_IMAGE_WIDTH_OR_HEIGHT = 1440;
-export declare const ALLOWED_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/svg+xml", "image/gif", "image/webp", "image/bmp", "image/x-icon"];
-export declare const MAX_ALLOWED_FILE_BYTES: number;
-export declare const SVG_NS = "http://www.w3.org/2000/svg";
-export declare const ENCRYPTION_KEY_BITS = 128;
-export declare const VERSIONS: {
-    readonly excalidraw: 2;
-    readonly excalidrawLibrary: 2;
-};
-export declare const BOUND_TEXT_PADDING = 5;
-export declare const VERTICAL_ALIGN: {
-    TOP: string;
-    MIDDLE: string;
-    BOTTOM: string;
-};
-export declare const TEXT_ALIGN: {
-    LEFT: string;
-    CENTER: string;
-    RIGHT: string;
-};
-export declare const ELEMENT_READY_TO_ERASE_OPACITY = 20;
-export declare const DEFAULT_PROPORTIONAL_RADIUS = 0.25;
-export declare const DEFAULT_ADAPTIVE_RADIUS = 32;
-export declare const ROUNDNESS: {
-    readonly LEGACY: 1;
-    readonly PROPORTIONAL_RADIUS: 2;
-    readonly ADAPTIVE_RADIUS: 3;
-};
-/** key containt id of precedeing elemnt id we use in reconciliation during
- * collaboration */
-export declare const PRECEDING_ELEMENT_KEY = "__precedingElement__";
-export declare const COLOR_NAMES: {
-    [key: string]: string;
-};
+import { AppProps } from "./types";
+import { ExcalidrawElement, FontFamilyValues } from "./element/types";
+export declare const isDarwin: boolean;
+export declare const isWindows: boolean;
+export declare const isAndroid: boolean;
+export declare const isFirefox: boolean;
+export declare const isChrome: boolean;
+export declare const isSafari: boolean;
+export declare const isBrave: () => boolean;
+export declare const APP_NAME = "Excalidraw";
+export declare const DRAGGING_THRESHOLD = 10;
+export declare const LINE_CONFIRM_THRESHOLD = 8;
+export declare const ELEMENT_SHIFT_TRANSLATE_AMOUNT = 5;
+export declare const ELEMENT_TRANSLATE_AMOUNT = 1;
+export declare const TEXT_TO_CENTER_SNAP_THRESHOLD = 30;
+export declare const SHIFT_LOCKING_ANGLE: number;
+export declare const CURSOR_TYPE: {
+    TEXT: string;
+    CROSSHAIR: string;
+    GRABBING: string;
+    GRAB: string;
+    POINTER: string;
+    MOVE: string;
+    AUTO: string;
+};
+export declare const POINTER_BUTTON: {
+    readonly MAIN: 0;
+    readonly WHEEL: 1;
+    readonly SECONDARY: 2;
+    readonly TOUCH: -1;
+};
+export declare enum EVENT {
+    COPY = "copy",
+    PASTE = "paste",
+    CUT = "cut",
+    KEYDOWN = "keydown",
+    KEYUP = "keyup",
+    MOUSE_MOVE = "mousemove",
+    RESIZE = "resize",
+    UNLOAD = "unload",
+    FOCUS = "focus",
+    BLUR = "blur",
+    DRAG_OVER = "dragover",
+    DROP = "drop",
+    GESTURE_END = "gestureend",
+    BEFORE_UNLOAD = "beforeunload",
+    GESTURE_START = "gesturestart",
+    GESTURE_CHANGE = "gesturechange",
+    POINTER_MOVE = "pointermove",
+    POINTER_UP = "pointerup",
+    STATE_CHANGE = "statechange",
+    WHEEL = "wheel",
+    TOUCH_START = "touchstart",
+    TOUCH_END = "touchend",
+    HASHCHANGE = "hashchange",
+    VISIBILITY_CHANGE = "visibilitychange",
+    SCROLL = "scroll",
+    EXCALIDRAW_LINK = "excalidraw-link",
+    MENU_ITEM_SELECT = "menu.itemSelect"
+}
+export declare const ENV: {
+    TEST: string;
+    DEVELOPMENT: string;
+};
+export declare const CLASSES: {
+    SHAPE_ACTIONS_MENU: string;
+    SHAPE_ACTIONS_MOBILE_MENU: string;
+    MOBILE_TOOLBAR: string;
+};
+export declare const FONT_FAMILY: {
+    Virgil: number;
+    Helvetica: number;
+    Cascadia: number;
+    LocalFont: number;
+};
+export declare const THEME: {
+    LIGHT: string;
+    DARK: string;
+};
+export declare const WINDOWS_EMOJI_FALLBACK_FONT = "Segoe UI Emoji";
+export declare const DEFAULT_FONT_SIZE = 20;
+export declare const DEFAULT_FONT_FAMILY: FontFamilyValues;
+export declare const DEFAULT_TEXT_ALIGN = "left";
+export declare const DEFAULT_VERTICAL_ALIGN = "top";
+export declare const DEFAULT_VERSION = "{version}";
+export declare const CANVAS_ONLY_ACTIONS: string[];
+export declare const GRID_SIZE = 20;
+export declare const IMAGE_MIME_TYPES: {
+    readonly svg: "image/svg+xml";
+    readonly png: "image/png";
+    readonly jpg: "image/jpeg";
+    readonly gif: "image/gif";
+    readonly webp: "image/webp";
+    readonly bmp: "image/bmp";
+    readonly ico: "image/x-icon";
+    readonly avif: "image/avif";
+    readonly jfif: "image/jfif";
+};
+export declare const MIME_TYPES: {
+    readonly svg: "image/svg+xml";
+    readonly png: "image/png";
+    readonly jpg: "image/jpeg";
+    readonly gif: "image/gif";
+    readonly webp: "image/webp";
+    readonly bmp: "image/bmp";
+    readonly ico: "image/x-icon";
+    readonly avif: "image/avif";
+    readonly jfif: "image/jfif";
+    readonly json: "application/json";
+    readonly excalidraw: "application/vnd.excalidraw+json";
+    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
+    readonly "excalidraw.svg": "image/svg+xml";
+    readonly "excalidraw.png": "image/png";
+    readonly binary: "application/octet-stream";
+};
+export declare const EXPORT_DATA_TYPES: {
+    readonly excalidraw: "excalidraw";
+    readonly excalidrawClipboard: "excalidraw/clipboard";
+    readonly excalidrawLibrary: "excalidrawlib";
+};
+export declare const EXPORT_SOURCE: string;
+export declare const IMAGE_RENDER_TIMEOUT = 500;
+export declare const TAP_TWICE_TIMEOUT = 300;
+export declare const TOUCH_CTX_MENU_TIMEOUT = 500;
+export declare const TITLE_TIMEOUT = 10000;
+export declare const VERSION_TIMEOUT = 30000;
+export declare const SCROLL_TIMEOUT = 100;
+export declare const ZOOM_STEP = 0.05;
+export declare const MIN_ZOOM = 0.1;
+export declare const HYPERLINK_TOOLTIP_DELAY = 300;
+export declare const IDLE_THRESHOLD = 60000;
+export declare const ACTIVE_THRESHOLD = 3000;
+export declare const THEME_FILTER: any;
+export declare const URL_QUERY_KEYS: {
+    readonly addLibrary: "addLibrary";
+};
+export declare const URL_HASH_KEYS: {
+    readonly addLibrary: "addLibrary";
+};
+export declare const DEFAULT_UI_OPTIONS: AppProps["UIOptions"];
+export declare const MQ_SM_MAX_WIDTH = 640;
+export declare const MQ_MAX_WIDTH_PORTRAIT = 730;
+export declare const MQ_MAX_WIDTH_LANDSCAPE = 1000;
+export declare const MQ_MAX_HEIGHT_LANDSCAPE = 500;
+export declare const MQ_RIGHT_SIDEBAR_MIN_WIDTH = 1229;
+export declare const LIBRARY_SIDEBAR_WIDTH: number;
+export declare const MAX_DECIMALS_FOR_SVG_EXPORT = 2;
+export declare const EXPORT_SCALES: number[];
+export declare const DEFAULT_EXPORT_PADDING = 10;
+export declare const DEFAULT_MAX_IMAGE_WIDTH_OR_HEIGHT = 1440;
+export declare const MAX_ALLOWED_FILE_BYTES: number;
+export declare const SVG_NS = "http://www.w3.org/2000/svg";
+export declare const ENCRYPTION_KEY_BITS = 128;
+export declare const VERSIONS: {
+    readonly excalidraw: 2;
+    readonly excalidrawLibrary: 2;
+};
+export declare const BOUND_TEXT_PADDING = 5;
+export declare const VERTICAL_ALIGN: {
+    TOP: string;
+    MIDDLE: string;
+    BOTTOM: string;
+};
+export declare const TEXT_ALIGN: {
+    LEFT: string;
+    CENTER: string;
+    RIGHT: string;
+};
+export declare const ELEMENT_READY_TO_ERASE_OPACITY = 20;
+export declare const DEFAULT_PROPORTIONAL_RADIUS = 0.25;
+export declare const DEFAULT_ADAPTIVE_RADIUS = 32;
+export declare const ROUNDNESS: {
+    readonly LEGACY: 1;
+    readonly PROPORTIONAL_RADIUS: 2;
+    readonly ADAPTIVE_RADIUS: 3;
+};
+/** key containt id of precedeing elemnt id we use in reconciliation during
+ * collaboration */
+export declare const PRECEDING_ELEMENT_KEY = "__precedingElement__";
+export declare const COLOR_NAMES: {
+    [key: string]: string;
+};
+export declare const DEFAULT_ELEMENT_PROPS: {
+    strokeColor: ExcalidrawElement["strokeColor"];
+    backgroundColor: ExcalidrawElement["backgroundColor"];
+    fillStyle: ExcalidrawElement["fillStyle"];
+    strokeWidth: ExcalidrawElement["strokeWidth"];
+    strokeStyle: ExcalidrawElement["strokeStyle"];
+    roughness: ExcalidrawElement["roughness"];
+    opacity: ExcalidrawElement["opacity"];
+    locked: ExcalidrawElement["locked"];
+};

package/types/data/blob.d.ts

@@ -1,48 +1,48 @@
-import { ALLOWED_IMAGE_MIME_TYPES, MIME_TYPES } from "../constants";
-import { ExcalidrawElement, FileId } from "../element/types";
-import { AppState, DataURL, LibraryItem } from "../types";
-import { ValueOf } from "../utility-types";
-import { FileSystemHandle } from "./filesystem";
-import { ImportedLibraryData } from "./types";
-export declare const getMimeType: (blob: Blob | string) => string;
-export declare const getFileHandleType: (handle: FileSystemHandle | null) => string | null;
-export declare const isImageFileHandleType: (type: string | null) => type is "svg" | "png";
-export declare const isImageFileHandle: (handle: FileSystemHandle | null) => boolean;
-export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
-    type: (typeof ALLOWED_IMAGE_MIME_TYPES)[number];
-};
-export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<{
-    type: "application/vnd.excalidraw+json";
-    data: import("./restore").RestoredDataState;
-} | {
-    type: "application/vnd.excalidrawlib+json";
-    data: ImportedLibraryData;
-}>;
-export declare const loadFromBlob: (blob: Blob, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<import("./restore").RestoredDataState>;
-export declare const parseLibraryJSON: (json: string, defaultStatus?: LibraryItem["status"]) => LibraryItem[];
-export declare const loadLibraryFromBlob: (blob: Blob, defaultStatus?: LibraryItem["status"]) => Promise<LibraryItem[]>;
-export declare const canvasToBlob: (canvas: HTMLCanvasElement) => Promise<Blob>;
-/** generates SHA-1 digest from supplied file (if not supported, falls back
-    to a 40-char base64 random id) */
-export declare const generateIdFromFile: (file: File) => Promise<FileId>;
-export declare const getDataURL: (file: Blob | File) => Promise<DataURL>;
-export declare const dataURLToFile: (dataURL: DataURL, filename?: string) => File;
-export declare const resizeImageFile: (file: File, opts: {
-    /** undefined indicates auto */
-    outputType?: (typeof MIME_TYPES)["jpg"];
-    maxWidthOrHeight: number;
-}) => Promise<File>;
-export declare const SVGStringToFile: (SVGString: string, filename?: string) => File & {
-    type: typeof MIME_TYPES.svg;
-};
-export declare const getFileFromEvent: (event: React.DragEvent<HTMLDivElement>) => Promise<{
-    file: File | null;
-    fileHandle: FileSystemHandle | null;
-}>;
-export declare const getFileHandle: (event: React.DragEvent<HTMLDivElement>) => Promise<FileSystemHandle | null>;
-export declare const createFile: (blob: File | Blob | ArrayBuffer, mimeType: ValueOf<typeof MIME_TYPES>, name: string | undefined) => File;
-/** attempts to detect correct mimeType if none is set, or if an image
- * has an incorrect extension.
- * Note: doesn't handle missing .excalidraw/.excalidrawlib extension  */
-export declare const normalizeFile: (file: File) => Promise<File>;
-export declare const blobToArrayBuffer: (blob: Blob) => Promise<ArrayBuffer>;
+import { IMAGE_MIME_TYPES, MIME_TYPES } from "../constants";
+import { ExcalidrawElement, FileId } from "../element/types";
+import { AppState, DataURL, LibraryItem } from "../types";
+import { ValueOf } from "../utility-types";
+import { FileSystemHandle } from "./filesystem";
+import { ImportedLibraryData } from "./types";
+export declare const getMimeType: (blob: Blob | string) => string;
+export declare const getFileHandleType: (handle: FileSystemHandle | null) => string | null;
+export declare const isImageFileHandleType: (type: string | null) => type is "svg" | "png";
+export declare const isImageFileHandle: (handle: FileSystemHandle | null) => boolean;
+export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
+    type: ValueOf<typeof IMAGE_MIME_TYPES>;
+};
+export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<{
+    type: "application/vnd.excalidraw+json";
+    data: import("./restore").RestoredDataState;
+} | {
+    type: "application/vnd.excalidrawlib+json";
+    data: ImportedLibraryData;
+}>;
+export declare const loadFromBlob: (blob: Blob, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<import("./restore").RestoredDataState>;
+export declare const parseLibraryJSON: (json: string, defaultStatus?: LibraryItem["status"]) => LibraryItem[];
+export declare const loadLibraryFromBlob: (blob: Blob, defaultStatus?: LibraryItem["status"]) => Promise<LibraryItem[]>;
+export declare const canvasToBlob: (canvas: HTMLCanvasElement) => Promise<Blob>;
+/** generates SHA-1 digest from supplied file (if not supported, falls back
+    to a 40-char base64 random id) */
+export declare const generateIdFromFile: (file: File) => Promise<FileId>;
+export declare const getDataURL: (file: Blob | File) => Promise<DataURL>;
+export declare const dataURLToFile: (dataURL: DataURL, filename?: string) => File;
+export declare const resizeImageFile: (file: File, opts: {
+    /** undefined indicates auto */
+    outputType?: (typeof MIME_TYPES)["jpg"];
+    maxWidthOrHeight: number;
+}) => Promise<File>;
+export declare const SVGStringToFile: (SVGString: string, filename?: string) => File & {
+    type: typeof MIME_TYPES.svg;
+};
+export declare const getFileFromEvent: (event: React.DragEvent<HTMLDivElement>) => Promise<{
+    file: File | null;
+    fileHandle: FileSystemHandle | null;
+}>;
+export declare const getFileHandle: (event: React.DragEvent<HTMLDivElement>) => Promise<FileSystemHandle | null>;
+export declare const createFile: (blob: File | Blob | ArrayBuffer, mimeType: ValueOf<typeof MIME_TYPES>, name: string | undefined) => File;
+/** attempts to detect correct mimeType if none is set, or if an image
+ * has an incorrect extension.
+ * Note: doesn't handle missing .excalidraw/.excalidrawlib extension  */
+export declare const normalizeFile: (file: File) => Promise<File>;
+export declare const blobToArrayBuffer: (blob: Blob) => Promise<ArrayBuffer>;

package/types/data/encode.d.ts

@@ -1,53 +1,53 @@
-export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) => Promise<string>;
-/**
- * @param isByteString set to true if already byte string to prevent bloat
- *  due to reencoding
- */
-export declare const stringToBase64: (str: string, isByteString?: boolean) => Promise<string>;
-export declare const base64ToString: (base64: string, isByteString?: boolean) => Promise<string>;
-declare type EncodedData = {
-    encoded: string;
-    encoding: "bstring";
-    /** whether text is compressed (zlib) */
-    compressed: boolean;
-    /** version for potential migration purposes */
-    version?: string;
-};
-/**
- * Encodes (and potentially compresses via zlib) text to byte string
- */
-export declare const encode: ({ text, compress, }: {
-    text: string;
-    /** defaults to `true`. If compression fails, falls back to bstring alone. */
-    compress?: boolean | undefined;
-}) => Promise<EncodedData>;
-export declare const decode: (data: EncodedData) => Promise<string>;
-/**
- * The returned buffer has following format:
- * `[]` refers to a buffers wrapper (see `concatBuffers`)
- *
- * [
- *   encodingMetadataBuffer,
- *   iv,
- *   [
- *      contentsMetadataBuffer
- *      contentsBuffer
- *   ]
- * ]
- */
-export declare const compressData: <T extends Record<string, any> = never>(dataBuffer: Uint8Array, options: {
-    encryptionKey: string;
-} & ([T] extends [never] ? {
-    metadata?: T | undefined;
-} : {
-    metadata: T;
-})) => Promise<Uint8Array>;
-export declare const decompressData: <T extends Record<string, any>>(bufferView: Uint8Array, options: {
-    decryptionKey: string;
-}) => Promise<{
-    /** metadata source is always JSON so we can decode it here */
-    metadata: T;
-    /** data can be anything so the caller must decode it */
-    data: Uint8Array;
-}>;
-export {};
+export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) => Promise<string>;
+/**
+ * @param isByteString set to true if already byte string to prevent bloat
+ *  due to reencoding
+ */
+export declare const stringToBase64: (str: string, isByteString?: boolean) => Promise<string>;
+export declare const base64ToString: (base64: string, isByteString?: boolean) => Promise<string>;
+declare type EncodedData = {
+    encoded: string;
+    encoding: "bstring";
+    /** whether text is compressed (zlib) */
+    compressed: boolean;
+    /** version for potential migration purposes */
+    version?: string;
+};
+/**
+ * Encodes (and potentially compresses via zlib) text to byte string
+ */
+export declare const encode: ({ text, compress, }: {
+    text: string;
+    /** defaults to `true`. If compression fails, falls back to bstring alone. */
+    compress?: boolean | undefined;
+}) => Promise<EncodedData>;
+export declare const decode: (data: EncodedData) => Promise<string>;
+/**
+ * The returned buffer has following format:
+ * `[]` refers to a buffers wrapper (see `concatBuffers`)
+ *
+ * [
+ *   encodingMetadataBuffer,
+ *   iv,
+ *   [
+ *      contentsMetadataBuffer
+ *      contentsBuffer
+ *   ]
+ * ]
+ */
+export declare const compressData: <T extends Record<string, any> = never>(dataBuffer: Uint8Array, options: {
+    encryptionKey: string;
+} & ([T] extends [never] ? {
+    metadata?: T | undefined;
+} : {
+    metadata: T;
+})) => Promise<Uint8Array>;
+export declare const decompressData: <T extends Record<string, any>>(bufferView: Uint8Array, options: {
+    decryptionKey: string;
+}) => Promise<{
+    /** metadata source is always JSON so we can decode it here */
+    metadata: T;
+    /** data can be anything so the caller must decode it */
+    data: Uint8Array;
+}>;
+export {};

package/types/data/encryption.d.ts

@@ -1,9 +1,9 @@
-export declare const IV_LENGTH_BYTES = 12;
-export declare const createIV: () => Uint8Array;
-export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T | undefined) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
-export declare const getCryptoKey: (key: string, usage: KeyUsage) => Promise<CryptoKey>;
-export declare const encryptData: (key: string | CryptoKey, data: Uint8Array | ArrayBuffer | Blob | File | string) => Promise<{
-    encryptedBuffer: ArrayBuffer;
-    iv: Uint8Array;
-}>;
-export declare const decryptData: (iv: Uint8Array, encrypted: Uint8Array | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;
+export declare const IV_LENGTH_BYTES = 12;
+export declare const createIV: () => Uint8Array;
+export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T | undefined) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
+export declare const getCryptoKey: (key: string, usage: KeyUsage) => Promise<CryptoKey>;
+export declare const encryptData: (key: string | CryptoKey, data: Uint8Array | ArrayBuffer | Blob | File | string) => Promise<{
+    encryptedBuffer: ArrayBuffer;
+    iv: Uint8Array;
+}>;
+export declare const decryptData: (iv: Uint8Array, encrypted: Uint8Array | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;

package/types/data/filesystem.d.ts

@@ -1,18 +1,19 @@
-import { FileSystemHandle, supported as nativeFileSystemSupported } from "browser-fs-access";
-declare type FILE_EXTENSION = "gif" | "jpg" | "png" | "excalidraw.png" | "svg" | "excalidraw.svg" | "json" | "excalidraw" | "excalidrawlib";
-export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
-    extensions?: FILE_EXTENSION[] | undefined;
-    description: string;
-    multiple?: M | undefined;
-}) => Promise<M extends false | undefined ? File : File[]>;
-export declare const fileSave: (blob: Blob, opts: {
-    /** supply without the extension */
-    name: string;
-    /** file extension */
-    extension: FILE_EXTENSION;
-    description: string;
-    /** existing FileSystemHandle */
-    fileHandle?: FileSystemHandle | null;
-}) => Promise<FileSystemHandle | null>;
-export type { FileSystemHandle };
-export { nativeFileSystemSupported };
+import { FileSystemHandle, supported as nativeFileSystemSupported } from "browser-fs-access";
+import { MIME_TYPES } from "../constants";
+declare type FILE_EXTENSION = Exclude<keyof typeof MIME_TYPES, "binary">;
+export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
+    extensions?: FILE_EXTENSION[] | undefined;
+    description: string;
+    multiple?: M | undefined;
+}) => Promise<M extends false | undefined ? File : File[]>;
+export declare const fileSave: (blob: Blob, opts: {
+    /** supply without the extension */
+    name: string;
+    /** file extension */
+    extension: FILE_EXTENSION;
+    description: string;
+    /** existing FileSystemHandle */
+    fileHandle?: FileSystemHandle | null;
+}) => Promise<FileSystemHandle | null>;
+export type { FileSystemHandle };
+export { nativeFileSystemSupported };