@zsviczian/excalidraw 0.17.1-obsidian-55 → 0.17.1-obsidian-56

package/types/excalidraw/fonts/ExcalidrawFont.d.ts

@@ -1,37 +1,37 @@
-export interface Font {
-    urls: URL[];
-    fontFace: FontFace;
-    getContent(codePoints: ReadonlySet<number>): Promise<string>;
-    getContentLegacy(): Promise<string>;
-}
-export declare const UNPKG_FALLBACK_URL: string;
-export declare class ExcalidrawFont implements Font {
-    readonly urls: URL[];
-    readonly fontFace: FontFace;
-    constructor(family: string, uri: string, descriptors?: FontFaceDescriptors);
-    /**
-     * Tries to fetch woff2 content, based on the registered urls (from first to last, treated as fallbacks).
-     *
-     * NOTE: assumes usage of `dataurl` outside the browser environment
-     *
-     * @returns base64 with subsetted glyphs based on the passed codepoint, last defined url otherwise
-     */
-    getContent(codePoints: ReadonlySet<number>): Promise<string>;
-    /**
-     * Tries to subset glyphs in a font based on the used codepoints, returning the font as daturl.
-     *
-     * @param arrayBuffer font data buffer, preferrably in the woff2 format, though others should work as well
-     * @param codePoints codepoints used to subset the glyphs
-     *
-     * @returns font with subsetted glyphs (all glyphs in case of errors) converted into a dataurl
-     */
-    private static subsetGlyphsByCodePoints;
-    private static toBase64;
-    private static createUrls;
-    private static getFormat;
-    private static normalizeBaseUrl;
-    /**
-     * zsviczian https://github.com/zsviczian/excalidraw/commit/b4cfaaa4b4f46ca01f94e27fb7bf651a9da99daa
-     */
-    getContentLegacy(): Promise<string>;
-}
+export interface Font {
+    urls: URL[];
+    fontFace: FontFace;
+    getContent(codePoints: ReadonlySet<number>): Promise<string>;
+    getContentLegacy(): Promise<string>;
+}
+export declare const UNPKG_FALLBACK_URL: string;
+export declare class ExcalidrawFont implements Font {
+    readonly urls: URL[];
+    readonly fontFace: FontFace;
+    constructor(family: string, uri: string, descriptors?: FontFaceDescriptors);
+    /**
+     * Tries to fetch woff2 content, based on the registered urls (from first to last, treated as fallbacks).
+     *
+     * NOTE: assumes usage of `dataurl` outside the browser environment
+     *
+     * @returns base64 with subsetted glyphs based on the passed codepoint, last defined url otherwise
+     */
+    getContent(codePoints: ReadonlySet<number>): Promise<string>;
+    /**
+     * Tries to subset glyphs in a font based on the used codepoints, returning the font as daturl.
+     *
+     * @param arrayBuffer font data buffer, preferrably in the woff2 format, though others should work as well
+     * @param codePoints codepoints used to subset the glyphs
+     *
+     * @returns font with subsetted glyphs (all glyphs in case of errors) converted into a dataurl
+     */
+    private static subsetGlyphsByCodePoints;
+    private static toBase64;
+    private static createUrls;
+    private static getFormat;
+    private static normalizeBaseUrl;
+    /**
+     * zsviczian https://github.com/zsviczian/excalidraw/commit/b4cfaaa4b4f46ca01f94e27fb7bf651a9da99daa
+     */
+    getContentLegacy(): Promise<string>;
+}

package/types/excalidraw/fonts/index.d.ts

@@ -1,83 +1,83 @@
-import type Scene from "../scene/Scene";
-import type { ValueOf } from "../utility-types";
-import type { ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues } from "../element/types";
-import { FONT_FAMILY } from "../constants";
-import { type FontMetadata } from "./metadata";
-import { type Font } from "./ExcalidrawFont";
-export declare class Fonts {
-    static readonly loadedFontsCache: Set<string>;
-    private static _registered;
-    private static _initialized;
-    static get registered(): Map<number, {
-        metadata: FontMetadata;
-        fonts: Font[];
-    }>;
-    get registered(): Map<number, {
-        metadata: FontMetadata;
-        fonts: Font[];
-    }>;
-    private readonly scene;
-    constructor({ scene }: {
-        scene: Scene;
-    });
-    /**
-     * if we load a (new) font, it's likely that text elements using it have
-     * already been rendered using a fallback font. Thus, we want invalidate
-     * their shapes and rerender. See #637.
-     *
-     * Invalidates text elements and rerenders scene, provided that at least one
-     * of the supplied fontFaces has not already been processed.
-     */
-    onLoaded: (fontFaces: readonly FontFace[]) => false | undefined;
-    /**
-     * Load font faces for a given scene and trigger scene update.
-     */
-    loadSceneFonts: () => Promise<FontFace[]>;
-    /**
-     * Gets all the font families for the given scene.
-     */
-    getSceneFontFamilies: () => number[];
-    /**
-     * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
-     */
-    static loadFontsForElements: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
-    private static loadFontFaces;
-    /**
-     * WARN: should be called just once on init, even across multiple instances.
-     */
-    private static init;
-    private static getFontFamilies;
-}
-/**
- * Register a new font.
- *
- * @param family font family
- * @param metadata font metadata
- * @param params array of the rest of the FontFace parameters [uri: string, descriptors: FontFaceDescriptors?] ,
- */
-export declare function register(//zsviczian (changed from private to export)
-this: Fonts | {
-    registered: Map<ValueOf<typeof FONT_FAMILY>, {
-        metadata: FontMetadata;
-        fonts: Font[];
-    }>;
-}, family: string, metadata: FontMetadata, ...params: Array<{
-    uri: string;
-    descriptors?: FontFaceDescriptors;
-}>): Map<number, {
-    metadata: FontMetadata;
-    fonts: Font[];
-}> | Map<number, {
-    metadata: FontMetadata;
-    fonts: Font[];
-}>;
-/**
- * Calculates vertical offset for a text with alphabetic baseline.
- */
-export declare const getVerticalOffset: (fontFamily: ExcalidrawTextElement["fontFamily"], fontSize: ExcalidrawTextElement["fontSize"], lineHeightPx: number) => number;
-/**
- * Gets line height forr a selected family.
- */
-export declare const getLineHeight: (fontFamily: FontFamilyValues) => number & {
-    _brand: "unitlessLineHeight";
-};
+import type Scene from "../scene/Scene";
+import type { ValueOf } from "../utility-types";
+import type { ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues } from "../element/types";
+import { FONT_FAMILY } from "../constants";
+import { type FontMetadata } from "./metadata";
+import { type Font } from "./ExcalidrawFont";
+export declare class Fonts {
+    static readonly loadedFontsCache: Set<string>;
+    private static _registered;
+    private static _initialized;
+    static get registered(): Map<number, {
+        metadata: FontMetadata;
+        fonts: Font[];
+    }>;
+    get registered(): Map<number, {
+        metadata: FontMetadata;
+        fonts: Font[];
+    }>;
+    private readonly scene;
+    constructor({ scene }: {
+        scene: Scene;
+    });
+    /**
+     * if we load a (new) font, it's likely that text elements using it have
+     * already been rendered using a fallback font. Thus, we want invalidate
+     * their shapes and rerender. See #637.
+     *
+     * Invalidates text elements and rerenders scene, provided that at least one
+     * of the supplied fontFaces has not already been processed.
+     */
+    onLoaded: (fontFaces: readonly FontFace[]) => false | undefined;
+    /**
+     * Load font faces for a given scene and trigger scene update.
+     */
+    loadSceneFonts: () => Promise<FontFace[]>;
+    /**
+     * Gets all the font families for the given scene.
+     */
+    getSceneFontFamilies: () => number[];
+    /**
+     * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
+     */
+    static loadFontsForElements: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
+    private static loadFontFaces;
+    /**
+     * WARN: should be called just once on init, even across multiple instances.
+     */
+    private static init;
+    private static getFontFamilies;
+}
+/**
+ * Register a new font.
+ *
+ * @param family font family
+ * @param metadata font metadata
+ * @param params array of the rest of the FontFace parameters [uri: string, descriptors: FontFaceDescriptors?] ,
+ */
+export declare function register(//zsviczian (changed from private to export)
+this: Fonts | {
+    registered: Map<ValueOf<typeof FONT_FAMILY>, {
+        metadata: FontMetadata;
+        fonts: Font[];
+    }>;
+}, family: string, metadata: FontMetadata, ...params: Array<{
+    uri: string;
+    descriptors?: FontFaceDescriptors;
+}>): Map<number, {
+    metadata: FontMetadata;
+    fonts: Font[];
+}> | Map<number, {
+    metadata: FontMetadata;
+    fonts: Font[];
+}>;
+/**
+ * Calculates vertical offset for a text with alphabetic baseline.
+ */
+export declare const getVerticalOffset: (fontFamily: ExcalidrawTextElement["fontFamily"], fontSize: ExcalidrawTextElement["fontSize"], lineHeightPx: number) => number;
+/**
+ * Gets line height forr a selected family.
+ */
+export declare const getLineHeight: (fontFamily: FontFamilyValues) => number & {
+    _brand: "unitlessLineHeight";
+};

package/types/excalidraw/fonts/metadata.d.ts

@@ -1,35 +1,35 @@
-/**
- * Encapsulates font metrics with additional font metadata.
- * */
-export interface FontMetadata {
-    /** for head & hhea metrics read the woff2 with https://fontdrop.info/ */
-    metrics: {
-        /** head.unitsPerEm metric */
-        unitsPerEm: 1000 | 1024 | 2048;
-        /** hhea.ascender metric */
-        ascender: number;
-        /** hhea.descender metric */
-        descender: number;
-        /** harcoded unitless line-height, https://github.com/excalidraw/excalidraw/pull/6360#issuecomment-1477635971 */
-        lineHeight: number;
-    };
-    /** element to be displayed as an icon  */
-    icon: JSX.Element;
-    /** flag to indicate a deprecated font */
-    deprecated?: true;
-    /** flag to indicate a server-side only font */
-    serverSide?: true;
-    /** flag to indiccate a local-only font */
-    local?: true;
-}
-export declare const FONT_METADATA: Record<number, FontMetadata>;
-/** Unicode ranges */
-export declare const RANGES: {
-    LATIN: string;
-    LATIN_EXT: string;
-    CYRILIC_EXT: string;
-    CYRILIC: string;
-    VIETNAMESE: string;
-};
-/** local protocol to skip the local font from registering or inlining */
-export declare const LOCAL_FONT_PROTOCOL = "local:";
+/**
+ * Encapsulates font metrics with additional font metadata.
+ * */
+export interface FontMetadata {
+    /** for head & hhea metrics read the woff2 with https://fontdrop.info/ */
+    metrics: {
+        /** head.unitsPerEm metric */
+        unitsPerEm: 1000 | 1024 | 2048;
+        /** hhea.ascender metric */
+        ascender: number;
+        /** hhea.descender metric */
+        descender: number;
+        /** harcoded unitless line-height, https://github.com/excalidraw/excalidraw/pull/6360#issuecomment-1477635971 */
+        lineHeight: number;
+    };
+    /** element to be displayed as an icon  */
+    icon: JSX.Element;
+    /** flag to indicate a deprecated font */
+    deprecated?: true;
+    /** flag to indicate a server-side only font */
+    serverSide?: true;
+    /** flag to indiccate a local-only font */
+    local?: true;
+}
+export declare const FONT_METADATA: Record<number, FontMetadata>;
+/** Unicode ranges */
+export declare const RANGES: {
+    LATIN: string;
+    LATIN_EXT: string;
+    CYRILIC_EXT: string;
+    CYRILIC: string;
+    VIETNAMESE: string;
+};
+/** local protocol to skip the local font from registering or inlining */
+export declare const LOCAL_FONT_PROTOCOL = "local:";

package/types/excalidraw/fonts/wasm/hb-subset.bindings.d.ts

@@ -1,45 +1,45 @@
-/**
- * Modified version of hb-subset bindings from "subset-font" package https://github.com/papandreou/subset-font/blob/3f711c8aa29a426c7f22655861abfb976950f527/index.js
- *
- * CHANGELOG:
- * - removed dependency on node APIs to work inside the browser
- * - removed dependency on font fontverter for brotli compression
- * - removed dependencies on lodash and p-limit
- * - removed options for preserveNameIds, variationAxes, noLayoutClosure (not needed for now)
- * - replaced text input with codepoints
- * - rewritten in typescript and with esm modules
-
-Copyright (c) 2012, Andreas Lind Petersen
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-  * Redistributions of source code must retain the above copyright
-    notice, this list of conditions and the following disclaimer.
-  * Redistributions in binary form must reproduce the above copyright
-    notice, this list of conditions and the following disclaimer in
-    the documentation and/or other materials provided with the
-    distribution.
-  * Neither the name of the author nor the names of contributors may
-    be used to endorse or promote products derived from this
-    software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
-IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-declare function subset(hbSubsetWasm: any, heapu8: Uint8Array, font: ArrayBuffer, codePoints: ReadonlySet<number>): Uint8Array;
-declare const _default: {
-    subset: typeof subset;
-};
-export default _default;
+/**
+ * Modified version of hb-subset bindings from "subset-font" package https://github.com/papandreou/subset-font/blob/3f711c8aa29a426c7f22655861abfb976950f527/index.js
+ *
+ * CHANGELOG:
+ * - removed dependency on node APIs to work inside the browser
+ * - removed dependency on font fontverter for brotli compression
+ * - removed dependencies on lodash and p-limit
+ * - removed options for preserveNameIds, variationAxes, noLayoutClosure (not needed for now)
+ * - replaced text input with codepoints
+ * - rewritten in typescript and with esm modules
+
+Copyright (c) 2012, Andreas Lind Petersen
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+  * Neither the name of the author nor the names of contributors may
+    be used to endorse or promote products derived from this
+    software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+declare function subset(hbSubsetWasm: any, heapu8: Uint8Array, font: ArrayBuffer, codePoints: ReadonlySet<number>): Uint8Array;
+declare const _default: {
+    subset: typeof subset;
+};
+export default _default;

package/types/excalidraw/fonts/wasm/hb-subset.loader.d.ts

@@ -1,5 +1,5 @@
-declare const load: () => Promise<{
-    subset: (fontBuffer: ArrayBuffer, codePoints: ReadonlySet<number>) => Uint8Array;
-}>;
-declare const _default: () => ReturnType<typeof load>;
-export default _default;
+declare const load: () => Promise<{
+    subset: (fontBuffer: ArrayBuffer, codePoints: ReadonlySet<number>) => Uint8Array;
+}>;
+declare const _default: () => ReturnType<typeof load>;
+export default _default;

package/types/excalidraw/fonts/wasm/hb-subset.wasm.d.ts

@@ -1,2 +1,2 @@
-declare const _default: Uint8Array;
-export default _default;
+declare const _default: Uint8Array;
+export default _default;

package/types/excalidraw/fonts/wasm/woff2.bindings.d.ts

@@ -1,31 +1,31 @@
-/**
- * Slitghly modified emscripten bindings of https://github.com/kekee000/fonteditor-core/blob/582bba757aa2915ec2240c61717ff12c50594675/woff2src/woff2.js
- *
- * CHANGELOG:
- * - replaced existing exports with default esm export (`export default Module;`)
- * - replaced "instanceof ArrayBuffer" with "Object.prototype.toString.call(d) === "[object ArrayBuffer]", due to unreliability of different ArrayBuffer instances depending on the context (i.e. inside VM)
-
-The MIT License (MIT)
-
-Copyright (c) 2014 ecomfe
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
- */
-declare const Module: (Module: any) => any;
-export default Module;
+/**
+ * Slitghly modified emscripten bindings of https://github.com/kekee000/fonteditor-core/blob/582bba757aa2915ec2240c61717ff12c50594675/woff2src/woff2.js
+ *
+ * CHANGELOG:
+ * - replaced existing exports with default esm export (`export default Module;`)
+ * - replaced "instanceof ArrayBuffer" with "Object.prototype.toString.call(d) === "[object ArrayBuffer]", due to unreliability of different ArrayBuffer instances depending on the context (i.e. inside VM)
+
+The MIT License (MIT)
+
+Copyright (c) 2014 ecomfe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+ */
+declare const Module: (Module: any) => any;
+export default Module;

package/types/excalidraw/fonts/wasm/woff2.loader.d.ts

@@ -1,6 +1,6 @@
-declare const load: () => Promise<{
-    compress: (buffer: ArrayBuffer) => Uint8Array;
-    decompress: (buffer: ArrayBuffer) => Uint8Array;
-}>;
-declare const _default: () => ReturnType<typeof load>;
-export default _default;
+declare const load: () => Promise<{
+    compress: (buffer: ArrayBuffer) => Uint8Array;
+    decompress: (buffer: ArrayBuffer) => Uint8Array;
+}>;
+declare const _default: () => ReturnType<typeof load>;
+export default _default;

package/types/excalidraw/fonts/wasm/woff2.wasm.d.ts

@@ -1,2 +1,2 @@
-declare const _default: Uint8Array;
-export default _default;
+declare const _default: Uint8Array;
+export default _default;

package/types/excalidraw/fractionalIndex.d.ts

@@ -1,48 +1,48 @@
-import type { ExcalidrawElement, OrderedExcalidrawElement } from "./element/types";
-/**
- * Envisioned relation between array order and fractional indices:
- *
- * 1) Array (or array-like ordered data structure) should be used as a cache of elements order, hiding the internal fractional indices implementation.
- * - it's undesirable to perform reorder for each related operation, therefore it's necessary to cache the order defined by fractional indices into an ordered data structure
- * - it's easy enough to define the order of the elements from the outside (boundaries), without worrying about the underlying structure of fractional indices (especially for the host apps)
- * - it's necessary to always keep the array support for backwards compatibility (restore) - old scenes, old libraries, supporting multiple excalidraw versions etc.
- * - it's necessary to always keep the fractional indices in sync with the array order
- * - elements with invalid indices should be detected and synced, without altering the already valid indices
- *
- * 2) Fractional indices should be used to reorder the elements, whenever the cached order is expected to be invalidated.
- * - as the fractional indices are encoded as part of the elements, it opens up possibilities for incremental-like APIs
- * - re-order based on fractional indices should be part of (multiplayer) operations such as reconciliation & undo/redo
- * - technically all the z-index actions could perform also re-order based on fractional indices,but in current state it would not bring much benefits,
- *   as it's faster & more efficient to perform re-order based on array manipulation and later synchronisation of moved indices with the array order
- */
-/**
- * Ensure that all elements have valid fractional indices.
- *
- * @throws `InvalidFractionalIndexError` if invalid index is detected.
- */
-export declare const validateFractionalIndices: (elements: readonly ExcalidrawElement[], { shouldThrow, includeBoundTextValidation, ignoreLogs, reconciliationContext, }: {
-    shouldThrow: boolean;
-    includeBoundTextValidation: boolean;
-    ignoreLogs?: true | undefined;
-    reconciliationContext?: {
-        localElements: ReadonlyArray<ExcalidrawElement>;
-        remoteElements: ReadonlyArray<ExcalidrawElement>;
-    } | undefined;
-}) => void;
-/**
- * Order the elements based on the fractional indices.
- * - when fractional indices are identical, break the tie based on the element id
- * - when there is no fractional index in one of the elements, respect the order of the array
- */
-export declare const orderByFractionalIndex: (elements: OrderedExcalidrawElement[]) => OrderedExcalidrawElement[];
-/**
- * Synchronizes invalid fractional indices of moved elements with the array order by mutating passed elements.
- * If the synchronization fails or the result is invalid, it fallbacks to `syncInvalidIndices`.
- */
-export declare const syncMovedIndices: (elements: readonly ExcalidrawElement[], movedElements: Map<string, ExcalidrawElement>) => OrderedExcalidrawElement[];
-/**
- * Synchronizes all invalid fractional indices with the array order by mutating passed elements.
- *
- * WARN: in edge cases it could modify the elements which were not moved, as it's impossible to guess the actually moved elements from the elements array itself.
- */
-export declare const syncInvalidIndices: (elements: readonly ExcalidrawElement[]) => OrderedExcalidrawElement[];
+import type { ExcalidrawElement, OrderedExcalidrawElement } from "./element/types";
+/**
+ * Envisioned relation between array order and fractional indices:
+ *
+ * 1) Array (or array-like ordered data structure) should be used as a cache of elements order, hiding the internal fractional indices implementation.
+ * - it's undesirable to perform reorder for each related operation, therefore it's necessary to cache the order defined by fractional indices into an ordered data structure
+ * - it's easy enough to define the order of the elements from the outside (boundaries), without worrying about the underlying structure of fractional indices (especially for the host apps)
+ * - it's necessary to always keep the array support for backwards compatibility (restore) - old scenes, old libraries, supporting multiple excalidraw versions etc.
+ * - it's necessary to always keep the fractional indices in sync with the array order
+ * - elements with invalid indices should be detected and synced, without altering the already valid indices
+ *
+ * 2) Fractional indices should be used to reorder the elements, whenever the cached order is expected to be invalidated.
+ * - as the fractional indices are encoded as part of the elements, it opens up possibilities for incremental-like APIs
+ * - re-order based on fractional indices should be part of (multiplayer) operations such as reconciliation & undo/redo
+ * - technically all the z-index actions could perform also re-order based on fractional indices,but in current state it would not bring much benefits,
+ *   as it's faster & more efficient to perform re-order based on array manipulation and later synchronisation of moved indices with the array order
+ */
+/**
+ * Ensure that all elements have valid fractional indices.
+ *
+ * @throws `InvalidFractionalIndexError` if invalid index is detected.
+ */
+export declare const validateFractionalIndices: (elements: readonly ExcalidrawElement[], { shouldThrow, includeBoundTextValidation, ignoreLogs, reconciliationContext, }: {
+    shouldThrow: boolean;
+    includeBoundTextValidation: boolean;
+    ignoreLogs?: true | undefined;
+    reconciliationContext?: {
+        localElements: ReadonlyArray<ExcalidrawElement>;
+        remoteElements: ReadonlyArray<ExcalidrawElement>;
+    } | undefined;
+}) => void;
+/**
+ * Order the elements based on the fractional indices.
+ * - when fractional indices are identical, break the tie based on the element id
+ * - when there is no fractional index in one of the elements, respect the order of the array
+ */
+export declare const orderByFractionalIndex: (elements: OrderedExcalidrawElement[]) => OrderedExcalidrawElement[];
+/**
+ * Synchronizes invalid fractional indices of moved elements with the array order by mutating passed elements.
+ * If the synchronization fails or the result is invalid, it fallbacks to `syncInvalidIndices`.
+ */
+export declare const syncMovedIndices: (elements: readonly ExcalidrawElement[], movedElements: Map<string, ExcalidrawElement>) => OrderedExcalidrawElement[];
+/**
+ * Synchronizes all invalid fractional indices with the array order by mutating passed elements.
+ *
+ * WARN: in edge cases it could modify the elements which were not moved, as it's impossible to guess the actually moved elements from the elements array itself.
+ */
+export declare const syncInvalidIndices: (elements: readonly ExcalidrawElement[]) => OrderedExcalidrawElement[];