@myoc/excalidraw 0.18.1

package/dist/types/excalidraw/element/typeChecks.d.ts

@@ -0,0 +1,39 @@
+import type { ElementOrToolType } from "../types";
+import type { MarkNonNullable } from "../utility-types";
+import type { Bounds } from "./bounds";
+import type { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawEmbeddableElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawFreeDrawElement, InitializedExcalidrawImageElement, ExcalidrawImageElement, ExcalidrawTextElementWithContainer, ExcalidrawTextContainer, ExcalidrawFrameElement, RoundnessType, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeElement, ExcalidrawIframeLikeElement, ExcalidrawMagicFrameElement, ExcalidrawArrowElement, ExcalidrawElbowArrowElement, PointBinding, FixedPointBinding, ExcalidrawFlowchartNodeElement } from "./types";
+export declare const isInitializedImageElement: (element: ExcalidrawElement | null) => element is InitializedExcalidrawImageElement;
+export declare const isImageElement: (element: ExcalidrawElement | null) => element is ExcalidrawImageElement;
+export declare const isEmbeddableElement: (element: ExcalidrawElement | null | undefined) => element is ExcalidrawEmbeddableElement;
+export declare const isIframeElement: (element: ExcalidrawElement | null) => element is ExcalidrawIframeElement;
+export declare const isIframeLikeElement: (element: ExcalidrawElement | null) => element is ExcalidrawIframeLikeElement;
+export declare const isTextElement: (element: ExcalidrawElement | null) => element is ExcalidrawTextElement;
+export declare const isFrameElement: (element: ExcalidrawElement | null) => element is ExcalidrawFrameElement;
+export declare const isMagicFrameElement: (element: ExcalidrawElement | null) => element is ExcalidrawMagicFrameElement;
+export declare const isFrameLikeElement: (element: ExcalidrawElement | null) => element is ExcalidrawFrameLikeElement;
+export declare const isFreeDrawElement: (element?: ExcalidrawElement | null) => element is ExcalidrawFreeDrawElement;
+export declare const isFreeDrawElementType: (elementType: ExcalidrawElementType) => boolean;
+export declare const isLinearElement: (element?: ExcalidrawElement | null) => element is ExcalidrawLinearElement;
+export declare const isArrowElement: (element?: ExcalidrawElement | null) => element is ExcalidrawArrowElement;
+export declare const isElbowArrow: (element?: ExcalidrawElement) => element is ExcalidrawElbowArrowElement;
+export declare const isLinearElementType: (elementType: ElementOrToolType) => boolean;
+export declare const isBindingElement: (element?: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawLinearElement;
+export declare const isBindingElementType: (elementType: ElementOrToolType) => boolean;
+export declare const isBindableElement: (element: ExcalidrawElement | null | undefined, includeLocked?: boolean) => element is ExcalidrawBindableElement;
+export declare const isRectanguloidElement: (element?: ExcalidrawElement | null) => element is ExcalidrawBindableElement;
+export declare const isRectangularElement: (element?: ExcalidrawElement | null) => element is ExcalidrawBindableElement;
+export declare const isTextBindableContainer: (element: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawTextContainer;
+export declare const isExcalidrawElement: (element: any) => element is ExcalidrawElement;
+export declare const isFlowchartNodeElement: (element: ExcalidrawElement) => element is ExcalidrawFlowchartNodeElement;
+export declare const hasBoundTextElement: (element: ExcalidrawElement | null) => element is MarkNonNullable<ExcalidrawBindableElement, "boundElements">;
+export declare const isBoundToContainer: (element: ExcalidrawElement | null) => element is ExcalidrawTextElementWithContainer;
+export declare const isUsingAdaptiveRadius: (type: string) => boolean;
+export declare const isUsingProportionalRadius: (type: string) => boolean;
+export declare const canApplyRoundnessTypeToElement: (roundnessType: RoundnessType, element: ExcalidrawElement) => boolean;
+export declare const getDefaultRoundnessTypeForElement: (element: ExcalidrawElement) => {
+    type: 2;
+} | {
+    type: 3;
+} | null;
+export declare const isFixedPointBinding: (binding: PointBinding | FixedPointBinding) => binding is FixedPointBinding;
+export declare const isBounds: (box: unknown) => box is Bounds;

package/dist/types/excalidraw/element/types.d.ts

@@ -0,0 +1,282 @@
+import type { LocalPoint, Radians } from "@excalidraw/math";
+import type { FONT_FAMILY, ROUNDNESS, TEXT_ALIGN, THEME, VERTICAL_ALIGN } from "../constants";
+import type { MakeBrand, MarkNonNullable, Merge, ValueOf } from "../utility-types";
+export type ChartType = "bar" | "line";
+export type FillStyle = "hachure" | "cross-hatch" | "solid" | "zigzag";
+export type FontFamilyKeys = keyof typeof FONT_FAMILY;
+export type FontFamilyValues = typeof FONT_FAMILY[FontFamilyKeys];
+export type Theme = typeof THEME[keyof typeof THEME];
+export type FontString = string & {
+    _brand: "fontString";
+};
+export type GroupId = string;
+export type PointerType = "mouse" | "pen" | "touch";
+export type StrokeRoundness = "round" | "sharp";
+export type RoundnessType = ValueOf<typeof ROUNDNESS>;
+export type StrokeStyle = "solid" | "dashed" | "dotted";
+export type TextAlign = typeof TEXT_ALIGN[keyof typeof TEXT_ALIGN];
+type VerticalAlignKeys = keyof typeof VERTICAL_ALIGN;
+export type VerticalAlign = typeof VERTICAL_ALIGN[VerticalAlignKeys];
+export type FractionalIndex = string & {
+    _brand: "franctionalIndex";
+};
+export type BoundElement = Readonly<{
+    id: ExcalidrawLinearElement["id"];
+    type: "arrow" | "text";
+}>;
+type _ExcalidrawElementBase = Readonly<{
+    id: string;
+    x: number;
+    y: number;
+    strokeColor: string;
+    backgroundColor: string;
+    fillStyle: FillStyle;
+    strokeWidth: number;
+    strokeStyle: StrokeStyle;
+    roundness: null | {
+        type: RoundnessType;
+        value?: number;
+    };
+    roughness: number;
+    opacity: number;
+    width: number;
+    height: number;
+    angle: Radians;
+    /** Random integer used to seed shape generation so that the roughjs shape
+        doesn't differ across renders. */
+    seed: number;
+    /** Integer that is sequentially incremented on each change. Used to reconcile
+        elements during collaboration or when saving to server. */
+    version: number;
+    /** Random integer that is regenerated on each change.
+        Used for deterministic reconciliation of updates during collaboration,
+        in case the versions (see above) are identical. */
+    versionNonce: number;
+    /** String in a fractional form defined by https://github.com/rocicorp/fractional-indexing.
+        Used for ordering in multiplayer scenarios, such as during reconciliation or undo / redo.
+        Always kept in sync with the array order by `syncMovedIndices` and `syncInvalidIndices`.
+        Could be null, i.e. for new elements which were not yet assigned to the scene. */
+    index: FractionalIndex | null;
+    isDeleted: boolean;
+    /** List of groups the element belongs to.
+        Ordered from deepest to shallowest. */
+    groupIds: readonly GroupId[];
+    frameId: string | null;
+    /** other elements that are bound to this element */
+    boundElements: readonly BoundElement[] | null;
+    /** epoch (ms) timestamp of last element update */
+    updated: number;
+    link: string | null;
+    locked: boolean;
+    customData?: Record<string, any>;
+}>;
+export type ExcalidrawSelectionElement = _ExcalidrawElementBase & {
+    type: "selection";
+};
+export type ExcalidrawRectangleElement = _ExcalidrawElementBase & {
+    type: "rectangle";
+};
+export type ExcalidrawDiamondElement = _ExcalidrawElementBase & {
+    type: "diamond";
+};
+export type ExcalidrawEllipseElement = _ExcalidrawElementBase & {
+    type: "ellipse";
+};
+export type ExcalidrawEmbeddableElement = _ExcalidrawElementBase & Readonly<{
+    type: "embeddable";
+}>;
+export type MagicGenerationData = {
+    status: "pending";
+} | {
+    status: "done";
+    html: string;
+} | {
+    status: "error";
+    message?: string;
+    code: "ERR_GENERATION_INTERRUPTED" | string;
+};
+export type ExcalidrawIframeElement = _ExcalidrawElementBase & Readonly<{
+    type: "iframe";
+    customData?: {
+        generationData?: MagicGenerationData;
+    };
+}>;
+export type ExcalidrawIframeLikeElement = ExcalidrawIframeElement | ExcalidrawEmbeddableElement;
+export type IframeData = ({
+    intrinsicSize: {
+        w: number;
+        h: number;
+    };
+    error?: Error;
+    sandbox?: {
+        allowSameOrigin?: boolean;
+    };
+} & ({
+    type: "video" | "generic";
+    link: string;
+} | {
+    type: "document";
+    srcdoc: (theme: Theme) => string;
+}));
+export type ImageCrop = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    naturalWidth: number;
+    naturalHeight: number;
+};
+export type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
+    type: "image";
+    fileId: FileId | null;
+    /** whether respective file is persisted */
+    status: "pending" | "saved" | "error";
+    /** X and Y scale factors <-1, 1>, used for image axis flipping */
+    scale: [number, number];
+    /** whether an element is cropped */
+    crop: ImageCrop | null;
+}>;
+export type InitializedExcalidrawImageElement = MarkNonNullable<ExcalidrawImageElement, "fileId">;
+export type ExcalidrawFrameElement = _ExcalidrawElementBase & {
+    type: "frame";
+    name: string | null;
+};
+export type ExcalidrawMagicFrameElement = _ExcalidrawElementBase & {
+    type: "magicframe";
+    name: string | null;
+};
+export type ExcalidrawFrameLikeElement = ExcalidrawFrameElement | ExcalidrawMagicFrameElement;
+/**
+ * These are elements that don't have any additional properties.
+ */
+export type ExcalidrawGenericElement = ExcalidrawSelectionElement | ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement;
+export type ExcalidrawFlowchartNodeElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement;
+export type ExcalidrawRectanguloidElement = ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawTextElement | ExcalidrawFreeDrawElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement | ExcalidrawEmbeddableElement;
+/**
+ * ExcalidrawElement should be JSON serializable and (eventually) contain
+ * no computed data. The list of all ExcalidrawElements should be shareable
+ * between peers and contain no state local to the peer.
+ */
+export type ExcalidrawElement = ExcalidrawGenericElement | ExcalidrawTextElement | ExcalidrawLinearElement | ExcalidrawArrowElement | ExcalidrawFreeDrawElement | ExcalidrawImageElement | ExcalidrawFrameElement | ExcalidrawMagicFrameElement | ExcalidrawIframeElement | ExcalidrawEmbeddableElement;
+export type ExcalidrawNonSelectionElement = Exclude<ExcalidrawElement, ExcalidrawSelectionElement>;
+export type Ordered<TElement extends ExcalidrawElement> = TElement & {
+    index: FractionalIndex;
+};
+export type OrderedExcalidrawElement = Ordered<ExcalidrawElement>;
+export type NonDeleted<TElement extends ExcalidrawElement> = TElement & {
+    isDeleted: boolean;
+};
+export type NonDeletedExcalidrawElement = NonDeleted<ExcalidrawElement>;
+export type ExcalidrawTextElement = _ExcalidrawElementBase & Readonly<{
+    type: "text";
+    fontSize: number;
+    fontFamily: FontFamilyValues;
+    text: string;
+    textAlign: TextAlign;
+    verticalAlign: VerticalAlign;
+    containerId: ExcalidrawGenericElement["id"] | null;
+    originalText: string;
+    /**
+     * If `true` the width will fit the text. If `false`, the text will
+     * wrap to fit the width.
+     *
+     * @default true
+     */
+    autoResize: boolean;
+    /**
+     * Unitless line height (aligned to W3C). To get line height in px, multiply
+     *  with font size (using `getLineHeightInPx` helper).
+     */
+    lineHeight: number & {
+        _brand: "unitlessLineHeight";
+    };
+}>;
+export type ExcalidrawBindableElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawTextElement | ExcalidrawImageElement | ExcalidrawIframeElement | ExcalidrawEmbeddableElement | ExcalidrawFrameElement | ExcalidrawMagicFrameElement;
+export type ExcalidrawTextContainer = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawArrowElement;
+export type ExcalidrawTextElementWithContainer = {
+    containerId: ExcalidrawTextContainer["id"];
+} & ExcalidrawTextElement;
+export type FixedPoint = [number, number];
+export type PointBinding = {
+    elementId: ExcalidrawBindableElement["id"];
+    focus: number;
+    gap: number;
+};
+export type FixedPointBinding = Merge<PointBinding, {
+    fixedPoint: FixedPoint;
+}>;
+export type Arrowhead = "arrow" | "bar" | "dot" | "circle" | "circle_outline" | "triangle" | "triangle_outline" | "diamond" | "diamond_outline" | "crowfoot_one" | "crowfoot_many" | "crowfoot_one_or_many";
+export type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<{
+    type: "line" | "arrow";
+    points: readonly LocalPoint[];
+    lastCommittedPoint: LocalPoint | null;
+    startBinding: PointBinding | null;
+    endBinding: PointBinding | null;
+    startArrowhead: Arrowhead | null;
+    endArrowhead: Arrowhead | null;
+}>;
+export type FixedSegment = {
+    start: LocalPoint;
+    end: LocalPoint;
+    index: number;
+};
+export type ExcalidrawArrowElement = ExcalidrawLinearElement & Readonly<{
+    type: "arrow";
+    elbowed: boolean;
+}>;
+export type ExcalidrawElbowArrowElement = Merge<ExcalidrawArrowElement, {
+    elbowed: true;
+    startBinding: FixedPointBinding | null;
+    endBinding: FixedPointBinding | null;
+    fixedSegments: readonly FixedSegment[] | null;
+    /**
+     * Marks that the 3rd point should be used as the 2nd point of the arrow in
+     * order to temporarily hide the first segment of the arrow without losing
+     * the data from the points array. It allows creating the expected arrow
+     * path when the arrow with fixed segments is bound on a horizontal side and
+     * moved to a vertical and vica versa.
+     */
+    startIsSpecial: boolean | null;
+    /**
+     * Marks that the 3rd point backwards from the end should be used as the 2nd
+     * point of the arrow in order to temporarily hide the last segment of the
+     * arrow without losing the data from the points array. It allows creating
+     * the expected arrow path when the arrow with fixed segments is bound on a
+     * horizontal side and moved to a vertical and vica versa.
+     */
+    endIsSpecial: boolean | null;
+}>;
+export type ExcalidrawFreeDrawElement = _ExcalidrawElementBase & Readonly<{
+    type: "freedraw";
+    points: readonly LocalPoint[];
+    pressures: readonly number[];
+    simulatePressure: boolean;
+    lastCommittedPoint: LocalPoint | null;
+}>;
+export type FileId = string & {
+    _brand: "FileId";
+};
+export type ExcalidrawElementType = ExcalidrawElement["type"];
+/**
+ * Map of excalidraw elements.
+ * Unspecified whether deleted or non-deleted.
+ * Can be a subset of Scene elements.
+ */
+export type ElementsMap = Map<ExcalidrawElement["id"], ExcalidrawElement>;
+/**
+ * Map of non-deleted elements.
+ * Can be a subset of Scene elements.
+ */
+export type NonDeletedElementsMap = Map<ExcalidrawElement["id"], NonDeletedExcalidrawElement> & MakeBrand<"NonDeletedElementsMap">;
+/**
+ * Map of all excalidraw Scene elements, including deleted.
+ * Not a subset. Use this type when you need access to current Scene elements.
+ */
+export type SceneElementsMap = Map<ExcalidrawElement["id"], Ordered<ExcalidrawElement>> & MakeBrand<"SceneElementsMap">;
+/**
+ * Map of all non-deleted Scene elements.
+ * Not a subset. Use this type when you need access to current Scene elements.
+ */
+export type NonDeletedSceneElementsMap = Map<ExcalidrawElement["id"], Ordered<NonDeletedExcalidrawElement>> & MakeBrand<"NonDeletedSceneElementsMap">;
+export type ElementsMapOrArray = readonly ExcalidrawElement[] | Readonly<ElementsMap>;
+export {};

package/dist/types/excalidraw/element/utils.d.ts

@@ -0,0 +1,21 @@
+import { type GlobalPoint } from "@excalidraw/math";
+import type { Curve, LineSegment } from "@excalidraw/math";
+import type { ExcalidrawDiamondElement, ExcalidrawRectanguloidElement } from "./types";
+/**
+ * Get the building components of a rectanguloid element in the form of
+ * line segments and curves.
+ *
+ * @param element Target rectanguloid element
+ * @param offset Optional offset to expand the rectanguloid shape
+ * @returns Tuple of line segments (0) and curves (1)
+ */
+export declare function deconstructRectanguloidElement(element: ExcalidrawRectanguloidElement, offset?: number): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];
+/**
+ * Get the building components of a diamond element in the form of
+ * line segments and curves as a tuple, in this order.
+ *
+ * @param element The element to deconstruct
+ * @param offset An optional offset
+ * @returns Tuple of line segments (0) and curves (1)
+ */
+export declare function deconstructDiamondElement(element: ExcalidrawDiamondElement, offset?: number): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];

package/dist/types/excalidraw/emitter.d.ts

@@ -0,0 +1,16 @@
+import type { UnsubscribeCallback } from "./types";
+type Subscriber<T extends any[]> = (...payload: T) => void;
+export declare class Emitter<T extends any[] = []> {
+    subscribers: Subscriber<T>[];
+    /**
+     * Attaches subscriber
+     *
+     * @returns unsubscribe function
+     */
+    on(...handlers: Subscriber<T>[] | Subscriber<T>[][]): UnsubscribeCallback;
+    once(...handlers: Subscriber<T>[] | Subscriber<T>[][]): UnsubscribeCallback;
+    off(...handlers: Subscriber<T>[] | Subscriber<T>[][]): void;
+    trigger(...payload: T): this;
+    clear(): void;
+}
+export {};

package/dist/types/excalidraw/errors.d.ts

@@ -0,0 +1,32 @@
+type CANVAS_ERROR_NAMES = "CANVAS_ERROR" | "CANVAS_POSSIBLY_TOO_BIG";
+export declare class CanvasError extends Error {
+    constructor(message?: string, name?: CANVAS_ERROR_NAMES);
+}
+export declare class AbortError extends DOMException {
+    constructor(message?: string);
+}
+type ImageSceneDataErrorCode = "IMAGE_NOT_CONTAINS_SCENE_DATA" | "IMAGE_SCENE_DATA_ERROR";
+export declare class ImageSceneDataError extends Error {
+    code: ImageSceneDataErrorCode;
+    constructor(message?: string, code?: ImageSceneDataErrorCode);
+}
+export declare class InvalidFractionalIndexError extends Error {
+    code: "ELEMENT_HAS_INVALID_INDEX";
+}
+type WorkerErrorCodes = "WORKER_URL_NOT_DEFINED" | "WORKER_IN_THE_MAIN_CHUNK";
+export declare class WorkerUrlNotDefinedError extends Error {
+    code: WorkerErrorCodes;
+    constructor(message?: string, code?: WorkerErrorCodes);
+}
+export declare class WorkerInTheMainChunkError extends Error {
+    code: WorkerErrorCodes;
+    constructor(message?: string, code?: WorkerErrorCodes);
+}
+/**
+ * Use this for generic, handled errors, so you can check against them
+ * and rethrow if needed
+ */
+export declare class ExcalidrawError extends Error {
+    constructor(message: string);
+}
+export {};

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const CascadiaFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const ComicShannsFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const EmojiFontFaces: ExcalidrawFontFaceDescriptor[];

package/dist/types/excalidraw/fonts/ExcalidrawFontFace.d.ts

@@ -0,0 +1,25 @@
+type DataURL = string;
+export declare class ExcalidrawFontFace {
+    readonly urls: URL[] | DataURL[];
+    readonly fontFace: FontFace;
+    private static readonly ASSETS_FALLBACK_URL;
+    constructor(family: string, uri: string, descriptors?: FontFaceDescriptors);
+    /**
+     * Generates CSS `@font-face` definition with the (subsetted) font source as a data url for the characters within the unicode range.
+     *
+     * Retrieves `undefined` otherwise.
+     */
+    toCSS(characters: string): Promise<string> | undefined;
+    /**
+     * Tries to fetch woff2 content, based on the registered urls (from first to last, treated as fallbacks).
+     *
+     * @returns base64 with subsetted glyphs based on the passed codepoint, last defined url otherwise
+     */
+    getContent(codePoints: Array<number>): Promise<string>;
+    fetchFont(url: URL | DataURL): Promise<ArrayBuffer>;
+    private getUnicodeRangeRegex;
+    private static createUrls;
+    private static getFormat;
+    private static normalizeBaseUrl;
+}
+export {};

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const ExcalifontFontFaces: ExcalidrawFontFaceDescriptor[];

package/dist/types/excalidraw/fonts/FontMetadata.d.ts

@@ -0,0 +1,38 @@
+import type { JSX } from "react";
+/**
+ * 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;
+    /** flag to indicate a fallback font */
+    fallback?: true;
+}
+export declare const FONT_METADATA: Record<number, FontMetadata>;
+/** Unicode ranges defined by google fonts */
+export declare const GOOGLE_FONTS_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/dist/types/excalidraw/fonts/Fonts.d.ts

@@ -0,0 +1,89 @@
+import { ExcalidrawFontFace } from "./ExcalidrawFontFace";
+import { type FontMetadata } from "./FontMetadata";
+import type { ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues } from "../element/types";
+import type Scene from "../scene/Scene";
+export declare class Fonts {
+    static readonly loadedFontsCache: Set<string>;
+    private static _registered;
+    private static _initialized;
+    static get registered(): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    get registered(): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    private readonly scene;
+    constructor(scene: Scene);
+    /**
+     * Get all the font families for the given scene.
+     */
+    getSceneFamilies: () => number[];
+    /**
+     * 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[]) => void;
+    /**
+     * Load font faces for a given scene and trigger scene update.
+     */
+    loadSceneFonts: () => Promise<FontFace[]>;
+    /**
+     * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
+     */
+    static loadElementsFonts: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
+    /**
+     * Generate CSS @font-face declarations for the given elements.
+     */
+    static generateFontFaceDeclarations(elements: readonly ExcalidrawElement[]): Promise<string[]>;
+    private static loadFontFaces;
+    private static fontFacesLoader;
+    private static fontFacesStylesGenerator;
+    /**
+     * Register a new font.
+     *
+     * @param family font family
+     * @param metadata font metadata
+     * @param fontFacesDecriptors font faces descriptors
+     */
+    private static register;
+    /**
+     * WARN: should be called just once on init, even across multiple instances.
+     */
+    private static init;
+    /**
+     * Get all the unique font families for the given elements.
+     */
+    private static getUniqueFamilies;
+    /**
+     * Get all the unique characters per font family for the given scene.
+     */
+    private static getCharsPerFamily;
+    /**
+     * Get characters for a given family.
+     */
+    private static getCharacters;
+    /**
+     * Get all registered font families.
+     */
+    private static getAllFamilies;
+}
+/**
+ * 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";
+};
+export interface ExcalidrawFontFaceDescriptor {
+    uri: string;
+    descriptors?: FontFaceDescriptors;
+}

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const HelveticaFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const LiberationFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const LilitaFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const NunitoFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const VirgilFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,8 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+/**
+ * The original font was modified with the following changes:
+ * - removed non-CJK codepoints
+ * - reduced any Hangul side-bearings to 40%
+ * - centered in width of inproperly centered CJK codepoints
+ */
+export declare const XiaolaiFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1 @@
+export * from "./Fonts";

package/dist/types/excalidraw/fractionalIndex.d.ts

@@ -0,0 +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[];