@mocanvas/editor 4.4.2 → 4.5.0

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { ComputedCache, ComputedCacheContext, CreateComputedCacheOptions, IndexK
 import { StyleWords, FrameBuffers, CameraState, EngineBridge, ClipRect } from '@mocanvas/wasm';
 export { CameraState, ClipRect, EngineBridge, FLAG, GEO_FLAG, GEO_KIND, PATH_OP, StyleWords, getLoadedEngine, loadEngine, loadEngineSync } from '@mocanvas/wasm';
 import * as react from 'react';
-import { ReactNode, ComponentType, CSSProperties, HTMLAttributes, Ref, SVGAttributes, Component, ErrorInfo, RefObject } from 'react';
+import { ReactNode, ComponentType, Component, ErrorInfo, CSSProperties, HTMLAttributes, Ref, SVGAttributes, RefObject } from 'react';
 import { Signal, Atom } from '@mocanvas/state';
 export { AtomMap, atom, computed, react, reactor, transact, transaction } from '@mocanvas/state';
 export { track, useAtom, useComputed, useQuickReactor, useReactor, useStateTracking, useValue } from '@mocanvas/state/react';
@@ -12250,251 +12250,6 @@ declare class WebGL2Backend implements RenderBackend {
  */
 declare function createBackend(canvas: HTMLCanvasElement): RenderBackend;
 
-/**
- * What the `Canvas` component slot is handed.
- *
- * A host replacing the canvas gets only presentation: a class name and
- * children. It deliberately does *not* receive the editor as a prop — the
- * replacement is rendered inside the editor's provider and reads it with
- * `useEditor()`, so a slot cannot be rendered against a different editor than
- * the one it is inside of.
- */
-interface TLCanvasComponentProps {
-    className?: string;
-    children?: ReactNode;
-}
-interface CanvasProps {
-    editor: Editor;
-    className?: string;
-    style?: CSSProperties;
-    /** Extra layers rendered above the canvas (UI, menus). */
-    children?: ReactNode;
-    /** Override the default selection/brush indicators. */
-    components?: Partial<CanvasComponents>;
-    /**
-     * The overlay util that paints shape indicators onto the canvas layer.
-     *
-     * A *class*, not an instance — one is constructed per editor. Pass
-     * `ShapeIndicatorCompositor.configure({ lineWidth })` to restyle, or a
-     * subclass to control which shapes get an outline.
-     */
-    indicatorOverlayUtil?: typeof ShapeIndicatorCompositor;
-}
-interface CanvasComponents {
-    Indicators: (props: {
-        editor: Editor;
-    }) => ReactNode;
-    Brush: (props: {
-        editor: Editor;
-    }) => ReactNode;
-    Background: (props: {
-        editor: Editor;
-    }) => ReactNode;
-}
-/**
- * The canvas: a WebGL2 surface driven by the engine, a DOM overlay for shapes
- * that render through `ShapeUtil.component`, a 2D canvas overlay for shape
- * indicators, and an SVG layer for the selection handles, snap lines, the brush
- * — and for any util still on the deprecated `indicator()` hook.
- */
-declare function Canvas({ editor, className, style, children, components, indicatorOverlayUtil }: CanvasProps): react.JSX.Element;
-/**
- * The outline to draw over one shape: whatever its util's `indicator()`
- * returns, or a rectangle around the shape's geometry bounds when the util has
- * no indicator (or returns nothing). Both are expressed in *shape-local*
- * coordinates; the caller wraps them in the shape's page transform.
- *
- * Pure and exported so a custom `Indicators` component can reuse the same rule
- * instead of guessing at it.
- *
- * @deprecated The SVG indicator layer only draws utils still on the deprecated
- * `indicator()` hook. A util that implements `getIndicatorPath` is stroked on
- * the canvas overlay by `ShapeIndicatorCompositor` instead.
- */
-declare function getShapeIndicatorNode<T extends UnknownShape>(util: {
-    indicator?(shape: T): ReactNode;
-}, shape: T, bounds: {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-} | undefined): ReactNode;
-
-declare const EditorContext: react.Context<Editor | null>;
-/** The editor of the nearest `<EditorProvider>` / `<Canvas>`. */
-declare function useEditor(): Editor;
-declare function useMaybeEditor(): Editor | null;
-/** Props of {@link EditorProvider}. */
-interface EditorProviderProps {
-    /** The editor every `useEditor()` below this point resolves to. */
-    editor: Editor;
-    children?: ReactNode;
-}
-/**
- * Publishes an editor to the React tree.
- *
- * Takes the editor as `editor` rather than a context provider's `value`, so a
- * test — or an app rendering chrome outside `<Canvas>` — writes
- * `<EditorProvider editor={editor}>` and never has to know that a context is
- * what is underneath. {@link EditorContext} is still exported for the rare
- * caller that wants the raw provider (to publish `null`, say).
- */
-declare function EditorProvider({ editor, children }: EditorProviderProps): react.JSX.Element;
-
-interface HTMLContainerProps extends HTMLAttributes<HTMLDivElement> {
-    children?: ReactNode;
-    ref?: Ref<HTMLDivElement>;
-}
-/**
- * The DOM body of a shape. Fills the shape's bounds; anything else — size,
- * pointer-events, overflow, a class of your own — is set through `style` and
- * `className`, which are merged over the defaults rather than replacing them.
- */
-declare function HTMLContainer({ children, className, style, ...rest }: HTMLContainerProps): react.JSX.Element;
-interface SVGContainerProps extends SVGAttributes<SVGSVGElement> {
-    children?: ReactNode;
-    ref?: Ref<SVGSVGElement>;
-}
-/**
- * The SVG body of a shape: an `<svg>` filling the shape's bounds, whose user
- * space is the shape's own local coordinate space, so a `<path>` drawn at
- * `(0, 0)` sits at the shape's origin at any pan, zoom or rotation.
- */
-declare function SVGContainer({ children, className, style, ...rest }: SVGContainerProps): react.JSX.Element;
-/**
- * Stop an event travelling any further up the tree.
- *
- * The canvas listens for pointer events on its container, so a click on a
- * piece of chrome rendered over it — a toolbar button, a menu, a panel —
- * would also start a canvas interaction. Hanging this on the chrome's root
- * (`onPointerDown={stopEventPropagation}`) keeps the two apart.
- *
- * Typed structurally rather than against `React.SyntheticEvent` so it can be
- * handed to a native listener, a React handler, or a test double alike.
- */
-declare function stopEventPropagation(event: {
-    stopPropagation(): void;
-}): void;
-
-/**
- * The bridge from the theme to CSS: the canvas container stamps the theme's
- * surface colours as custom properties, and everything drawn in CSS or SVG
- * reads them.
- *
- * Only the *surface* half of a ramp is published — the colours that belong to
- * the canvas rather than to any one shape. A shape's paint comes from its
- * style props through `getDisplayValues`, not from a variable, because a
- * shape is drawn on the GPU where a CSS variable means nothing.
- */
-/**
- * Which theme colour each custom property carries.
- *
- * The names are the ones `ui.css` already declares and `Canvas` already reads,
- * so an app that themed mocanvas by overriding the variables by hand keeps
- * working: the theme now writes the same variables it used to have to be told.
- */
-declare const CANVAS_THEME_VARS: {
-    readonly "--mocanvas-selection": "selectStroke";
-    readonly "--mocanvas-selection-fg": "background";
-    readonly "--mocanvas-brush-fill": "selectFill";
-    readonly "--mocanvas-brush-stroke": "selectStroke";
-    readonly "--mocanvas-snap": "hint";
-    readonly "--mocanvas-background": "background";
-    readonly "--mocanvas-surface": "solid";
-    readonly "--mocanvas-text": "text";
-    readonly "--mocanvas-grid": "grid";
-};
-/**
- * The camera, as custom properties.
- *
- * Separate from the colours because these change on every zoom rather than on
- * a theme swap, and because they are the two variables an app most often needs
- * in CSS: anything drawn in the DOM over a zooming canvas has to divide by the
- * zoom to keep a constant on-screen size. `@mocanvas/compat` maps tldraw's
- * `--tl-zoom` and `--tl-scale` onto them; without them every `calc()` in a
- * migrated stylesheet resolved to nothing and took its whole declaration with
- * it.
- */
-declare function getCameraCssVars(zoom: number): CSSProperties;
-/** {@link getCameraCssVars} for an editor, tracked reactively. */
-declare function useCameraCssVars(editor: Editor): CSSProperties;
-/**
- * The custom properties for one resolved ramp.
- *
- * SEMANTICS-ASSUMED: `--mocanvas-selection-fg` is the fill of a solid
- * selection handle, and is mapped to the theme's `background`. A handle is a
- * chip of the page punched out of the selection stroke, so it has to match the
- * page it sits on or it reads as a light dot on a dark canvas — which is
- * exactly what the hard-coded `#ffffff` did before the theme existed.
- *
- * A colour the ramp does not carry is skipped rather than written as
- * `undefined`, so the literal fallback in `var(--x, …)` still applies.
- */
-declare function getThemeCssVars(colors: TLThemeColors | undefined): CSSProperties;
-/**
- * The theme's custom properties for an editor, tracked reactively — swapping a
- * theme or flipping to dark restamps the container without anything being
- * invalidated by hand.
- *
- * Takes the editor rather than reading it from context, because the element
- * that carries the variables is the canvas container itself: the hook runs
- * above the provider that would supply it. The theme manager is read
- * defensively for the same reason `useColorMode` does — a stand-in editor in a
- * chrome test has no theme at all.
- */
-declare function useThemeCssVars(editor: Editor): CSSProperties;
-
-/**
- * Where an app self-hosts the files the UI loads at runtime.
- *
- * mocanvas itself needs none of them — its icons are inline SVG and it ships
- * no translation bundles — so the map is carried, not consumed: it exists so a
- * component an app drops into a chrome slot can ask for the same base paths
- * the host configured, instead of every such component growing a prop for it.
- *
- * Kept as nested string maps rather than a fixed shape because the categories
- * are the app's, not ours; the four named below are only the ones a
- * self-hosting setup usually has.
- */
-interface TLAssetUrls {
-    fonts?: Readonly<Record<string, string>>;
-    icons?: Readonly<Record<string, string>>;
-    embedIcons?: Readonly<Record<string, string>>;
-    translations?: Readonly<Record<string, string>>;
-    [category: string]: Readonly<Record<string, string>> | undefined;
-}
-/**
- * The editor's half of the map: the fonts the canvas loads.
- *
- * A separate name from {@link TLAssetUrls} because the editor package can only
- * promise what it itself uses — the UI layer adds icons and translations on
- * top, as {@link TLUiAssetUrls}.
- */
-interface TLEditorAssetUrls extends TLAssetUrls {
-    fonts?: Readonly<Record<string, string>>;
-}
-/**
- * The UI layer's half: the icons and translation bundles a self-hosting app
- * serves itself.
- */
-interface TLUiAssetUrls extends TLEditorAssetUrls {
-    icons?: Readonly<Record<string, string>>;
-    embedIcons?: Readonly<Record<string, string>>;
-    translations?: Readonly<Record<string, string>>;
-}
-interface AssetUrlsProviderProps {
-    assetUrls: TLAssetUrls;
-    children?: ReactNode;
-}
-/** Publishes an {@link TLAssetUrls} map to everything below it. */
-declare function AssetUrlsProvider({ assetUrls, children }: AssetUrlsProviderProps): react.JSX.Element;
-/**
- * The asset urls the host configured. Empty outside a provider — a component
- * that needs a file should fall back to its own default rather than fail,
- * because most mounts configure nothing at all.
- */
-declare function useAssetUrls(): TLAssetUrls;
-
 /**
  * The UI override surface: the types an app uses to replace mocanvas's chrome
  * and to add its own tools to it.
@@ -12808,15 +12563,384 @@ interface TLUiOverrides {
 type TLUiTranslations = Record<string, Record<string, string>>;
 
 /**
- * Resolving a UI string id through an app's `TLUiOverrides.translations`.
+ * Failure containment for the editor's React tree.
  *
- * Kept apart from the React context so the lookup rule can be tested — and
- * reused by an app's own chrome — without rendering anything.
+ * One badly-behaved shape component should cost you that shape, not the
+ * document: `<Canvas>` wraps each shape body in a boundary of its own, and the
+ * editor as a whole is wrapped in another. Without this, a `TypeError` inside
+ * one custom `ShapeUtil.component` unmounts the whole editor and the user
+ * loses the canvas.
  */
-/**
- * The locales to try, most specific first: the locale itself, its base
- * language, then English.
- *
+interface TLErrorFallbackProps {
+    /** What was thrown. Not necessarily an `Error`. */
+    error: unknown;
+    /** Re-mount the subtree. Undefined when the boundary was told not to retry. */
+    resetError?(): void;
+}
+interface TLErrorBoundaryProps {
+    children: ReactNode;
+    /** Rendered in place of the subtree once it has thrown. */
+    fallback: (props: TLErrorFallbackProps) => ReactNode;
+    /** Reported to the host app: logging, error tracking. */
+    onError?(error: unknown, info?: ErrorInfo): void;
+}
+/** The pre-`TL` spelling of {@link TLErrorBoundaryProps}. The same type. */
+type ErrorBoundaryProps = TLErrorBoundaryProps;
+/**
+ * A replacement for the editor-wide error screen, or `null` to render nothing
+ * at all.
+ *
+ * `null` is a real choice, not an oversight: a host that shows its own error UI
+ * outside the canvas wants the editor to fail silently rather than to draw a
+ * second, competing message.
+ */
+type TLErrorFallbackComponent = ComponentType<TLErrorFallbackProps> | null;
+/**
+ * A replacement for the fallback drawn in place of a single broken shape, or
+ * `null` to draw nothing.
+ *
+ * Separate from {@link TLErrorFallbackComponent} because the situations are not
+ * comparable: one shape failing should cost that shape, and the fallback is
+ * drawn *in the canvas*, at the shape's position, where a whole error screen
+ * would be absurd.
+ */
+type TLShapeErrorFallbackComponent = ComponentType<{
+    error: unknown;
+}> | null;
+interface ErrorBoundaryState {
+    error: unknown;
+    hasError: boolean;
+}
+/**
+ * Catches a render-time throw in its subtree and renders `fallback` instead.
+ *
+ * Class component because that is the only form React gives an error boundary;
+ * there is no hook equivalent.
+ */
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: unknown): ErrorBoundaryState;
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    private readonly resetError;
+    render(): ReactNode;
+}
+/**
+ * What an unhandled error looks like when nothing better is configured: the
+ * message, and a button that re-mounts the subtree.
+ *
+ * Deliberately plain and self-contained — it must render correctly when the
+ * failure is in the very stylesheet or provider the rest of the chrome needs.
+ */
+declare function DefaultErrorFallback({ error, resetError }: TLErrorFallbackProps): react.JSX.Element;
+interface ErrorScreenProps {
+    children?: ReactNode;
+}
+/**
+ * A full-bleed error surface, for a failure that happened before there was an
+ * editor to put a fallback inside of — a store that would not load, a schema
+ * that would not migrate.
+ */
+declare function ErrorScreen({ children }: ErrorScreenProps): react.JSX.Element;
+/**
+ * The indeterminate progress mark, sized to the text around it.
+ *
+ * Uses SMIL rather than a CSS keyframe so it also animates when the editor is
+ * mounted without `ui.css` — the case a loading screen is most likely to hit,
+ * since it is on screen before anything else has been set up.
+ */
+declare function DefaultSpinner(): react.JSX.Element;
+interface LoadingScreenProps {
+    children?: ReactNode;
+}
+/**
+ * What is on screen while the editor's store and engine are still coming up.
+ *
+ * Occupies the editor's whole box so the layout does not jump when the canvas
+ * replaces it, and is labelled as a live region so a screen reader is told
+ * that something is loading rather than that the page is empty.
+ */
+declare function LoadingScreen({ children }: LoadingScreenProps): react.JSX.Element;
+
+/**
+ * What the `Canvas` component slot is handed.
+ *
+ * A host replacing the canvas gets only presentation: a class name and
+ * children. It deliberately does *not* receive the editor as a prop — the
+ * replacement is rendered inside the editor's provider and reads it with
+ * `useEditor()`, so a slot cannot be rendered against a different editor than
+ * the one it is inside of.
+ */
+interface TLCanvasComponentProps {
+    className?: string;
+    children?: ReactNode;
+}
+interface CanvasProps {
+    editor: Editor;
+    className?: string;
+    style?: CSSProperties;
+    /** Extra layers rendered above the canvas (UI, menus). */
+    children?: ReactNode;
+    /**
+     * The canvas's own slots: the indicators, the brush, the background, the
+     * grid, and the two error fallbacks. A slot given here wins over the same
+     * slot on the surrounding `MocanvasUiProvider`, so an app can configure the
+     * whole editor through the provider and still override one canvas on one
+     * screen.
+     */
+    components?: Partial<CanvasComponents>;
+    /**
+     * The overlay util that paints shape indicators onto the canvas layer.
+     *
+     * A *class*, not an instance — one is constructed per editor. Pass
+     * `ShapeIndicatorCompositor.configure({ lineWidth })` to restyle, or a
+     * subclass to control which shapes get an outline.
+     */
+    indicatorOverlayUtil?: typeof ShapeIndicatorCompositor;
+}
+interface CanvasComponents {
+    Indicators: (props: {
+        editor: Editor;
+    }) => ReactNode;
+    Brush: (props: {
+        editor: Editor;
+    }) => ReactNode;
+    Background: (props: {
+        editor: Editor;
+    }) => ReactNode;
+    /**
+     * The grid, behind the scene. Rendered only in grid mode, and handed the
+     * camera and the document's step rather than reading them — see
+     * `TLComponents.Grid`. `null` draws none; omitted uses {@link DefaultGrid}.
+     */
+    Grid: ((props: TLGridProps) => ReactNode) | null;
+    /**
+     * Rendered in place of the whole editor once it has thrown. `null` renders
+     * nothing — the choice a host with its own error UI outside the canvas
+     * wants, rather than two competing messages. Omitted uses
+     * {@link DefaultErrorFallback}.
+     */
+    ErrorFallback: ComponentType<TLErrorFallbackProps> | null;
+    /**
+     * Rendered in place of one shape whose body has thrown, at that shape's own
+     * bounds. `null` leaves a hole; omitted uses
+     * {@link DefaultShapeErrorFallback}.
+     */
+    ShapeErrorFallback: ComponentType<TLErrorFallbackProps> | null;
+}
+/**
+ * The canvas: a WebGL2 surface driven by the engine, a DOM overlay for shapes
+ * that render through `ShapeUtil.component`, a 2D canvas overlay for shape
+ * indicators, and an SVG layer for the selection handles, snap lines, the brush
+ * — and for any util still on the deprecated `indicator()` hook.
+ */
+declare function Canvas(props: CanvasProps): react.JSX.Element;
+/**
+ * The outline to draw over one shape: whatever its util's `indicator()`
+ * returns, or a rectangle around the shape's geometry bounds when the util has
+ * no indicator (or returns nothing). Both are expressed in *shape-local*
+ * coordinates; the caller wraps them in the shape's page transform.
+ *
+ * Pure and exported so a custom `Indicators` component can reuse the same rule
+ * instead of guessing at it.
+ *
+ * @deprecated The SVG indicator layer only draws utils still on the deprecated
+ * `indicator()` hook. A util that implements `getIndicatorPath` is stroked on
+ * the canvas overlay by `ShapeIndicatorCompositor` instead.
+ */
+declare function getShapeIndicatorNode<T extends UnknownShape>(util: {
+    indicator?(shape: T): ReactNode;
+}, shape: T, bounds: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+} | undefined): ReactNode;
+
+declare const EditorContext: react.Context<Editor | null>;
+/** The editor of the nearest `<EditorProvider>` / `<Canvas>`. */
+declare function useEditor(): Editor;
+declare function useMaybeEditor(): Editor | null;
+/** Props of {@link EditorProvider}. */
+interface EditorProviderProps {
+    /** The editor every `useEditor()` below this point resolves to. */
+    editor: Editor;
+    children?: ReactNode;
+}
+/**
+ * Publishes an editor to the React tree.
+ *
+ * Takes the editor as `editor` rather than a context provider's `value`, so a
+ * test — or an app rendering chrome outside `<Canvas>` — writes
+ * `<EditorProvider editor={editor}>` and never has to know that a context is
+ * what is underneath. {@link EditorContext} is still exported for the rare
+ * caller that wants the raw provider (to publish `null`, say).
+ */
+declare function EditorProvider({ editor, children }: EditorProviderProps): react.JSX.Element;
+
+interface HTMLContainerProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+}
+/**
+ * The DOM body of a shape. Fills the shape's bounds; anything else — size,
+ * pointer-events, overflow, a class of your own — is set through `style` and
+ * `className`, which are merged over the defaults rather than replacing them.
+ */
+declare function HTMLContainer({ children, className, style, ...rest }: HTMLContainerProps): react.JSX.Element;
+interface SVGContainerProps extends SVGAttributes<SVGSVGElement> {
+    children?: ReactNode;
+    ref?: Ref<SVGSVGElement>;
+}
+/**
+ * The SVG body of a shape: an `<svg>` filling the shape's bounds, whose user
+ * space is the shape's own local coordinate space, so a `<path>` drawn at
+ * `(0, 0)` sits at the shape's origin at any pan, zoom or rotation.
+ */
+declare function SVGContainer({ children, className, style, ...rest }: SVGContainerProps): react.JSX.Element;
+/**
+ * Stop an event travelling any further up the tree.
+ *
+ * The canvas listens for pointer events on its container, so a click on a
+ * piece of chrome rendered over it — a toolbar button, a menu, a panel —
+ * would also start a canvas interaction. Hanging this on the chrome's root
+ * (`onPointerDown={stopEventPropagation}`) keeps the two apart.
+ *
+ * Typed structurally rather than against `React.SyntheticEvent` so it can be
+ * handed to a native listener, a React handler, or a test double alike.
+ */
+declare function stopEventPropagation(event: {
+    stopPropagation(): void;
+}): void;
+
+/**
+ * The bridge from the theme to CSS: the canvas container stamps the theme's
+ * surface colours as custom properties, and everything drawn in CSS or SVG
+ * reads them.
+ *
+ * Only the *surface* half of a ramp is published — the colours that belong to
+ * the canvas rather than to any one shape. A shape's paint comes from its
+ * style props through `getDisplayValues`, not from a variable, because a
+ * shape is drawn on the GPU where a CSS variable means nothing.
+ */
+/**
+ * Which theme colour each custom property carries.
+ *
+ * The names are the ones `ui.css` already declares and `Canvas` already reads,
+ * so an app that themed mocanvas by overriding the variables by hand keeps
+ * working: the theme now writes the same variables it used to have to be told.
+ */
+declare const CANVAS_THEME_VARS: {
+    readonly "--mocanvas-selection": "selectStroke";
+    readonly "--mocanvas-selection-fg": "background";
+    readonly "--mocanvas-brush-fill": "selectFill";
+    readonly "--mocanvas-brush-stroke": "selectStroke";
+    readonly "--mocanvas-snap": "hint";
+    readonly "--mocanvas-background": "background";
+    readonly "--mocanvas-surface": "solid";
+    readonly "--mocanvas-text": "text";
+    readonly "--mocanvas-grid": "grid";
+};
+/**
+ * The camera, as custom properties.
+ *
+ * Separate from the colours because these change on every zoom rather than on
+ * a theme swap, and because they are the two variables an app most often needs
+ * in CSS: anything drawn in the DOM over a zooming canvas has to divide by the
+ * zoom to keep a constant on-screen size. `@mocanvas/compat` maps tldraw's
+ * `--tl-zoom` and `--tl-scale` onto them; without them every `calc()` in a
+ * migrated stylesheet resolved to nothing and took its whole declaration with
+ * it.
+ */
+declare function getCameraCssVars(zoom: number): CSSProperties;
+/** {@link getCameraCssVars} for an editor, tracked reactively. */
+declare function useCameraCssVars(editor: Editor): CSSProperties;
+/**
+ * The custom properties for one resolved ramp.
+ *
+ * SEMANTICS-ASSUMED: `--mocanvas-selection-fg` is the fill of a solid
+ * selection handle, and is mapped to the theme's `background`. A handle is a
+ * chip of the page punched out of the selection stroke, so it has to match the
+ * page it sits on or it reads as a light dot on a dark canvas — which is
+ * exactly what the hard-coded `#ffffff` did before the theme existed.
+ *
+ * A colour the ramp does not carry is skipped rather than written as
+ * `undefined`, so the literal fallback in `var(--x, …)` still applies.
+ */
+declare function getThemeCssVars(colors: TLThemeColors | undefined): CSSProperties;
+/**
+ * The theme's custom properties for an editor, tracked reactively — swapping a
+ * theme or flipping to dark restamps the container without anything being
+ * invalidated by hand.
+ *
+ * Takes the editor rather than reading it from context, because the element
+ * that carries the variables is the canvas container itself: the hook runs
+ * above the provider that would supply it. The theme manager is read
+ * defensively for the same reason `useColorMode` does — a stand-in editor in a
+ * chrome test has no theme at all.
+ */
+declare function useThemeCssVars(editor: Editor): CSSProperties;
+
+/**
+ * Where an app self-hosts the files the UI loads at runtime.
+ *
+ * mocanvas itself needs none of them — its icons are inline SVG and it ships
+ * no translation bundles — so the map is carried, not consumed: it exists so a
+ * component an app drops into a chrome slot can ask for the same base paths
+ * the host configured, instead of every such component growing a prop for it.
+ *
+ * Kept as nested string maps rather than a fixed shape because the categories
+ * are the app's, not ours; the four named below are only the ones a
+ * self-hosting setup usually has.
+ */
+interface TLAssetUrls {
+    fonts?: Readonly<Record<string, string>>;
+    icons?: Readonly<Record<string, string>>;
+    embedIcons?: Readonly<Record<string, string>>;
+    translations?: Readonly<Record<string, string>>;
+    [category: string]: Readonly<Record<string, string>> | undefined;
+}
+/**
+ * The editor's half of the map: the fonts the canvas loads.
+ *
+ * A separate name from {@link TLAssetUrls} because the editor package can only
+ * promise what it itself uses — the UI layer adds icons and translations on
+ * top, as {@link TLUiAssetUrls}.
+ */
+interface TLEditorAssetUrls extends TLAssetUrls {
+    fonts?: Readonly<Record<string, string>>;
+}
+/**
+ * The UI layer's half: the icons and translation bundles a self-hosting app
+ * serves itself.
+ */
+interface TLUiAssetUrls extends TLEditorAssetUrls {
+    icons?: Readonly<Record<string, string>>;
+    embedIcons?: Readonly<Record<string, string>>;
+    translations?: Readonly<Record<string, string>>;
+}
+interface AssetUrlsProviderProps {
+    assetUrls: TLAssetUrls;
+    children?: ReactNode;
+}
+/** Publishes an {@link TLAssetUrls} map to everything below it. */
+declare function AssetUrlsProvider({ assetUrls, children }: AssetUrlsProviderProps): react.JSX.Element;
+/**
+ * The asset urls the host configured. Empty outside a provider — a component
+ * that needs a file should fall back to its own default rather than fail,
+ * because most mounts configure nothing at all.
+ */
+declare function useAssetUrls(): TLAssetUrls;
+
+/**
+ * Resolving a UI string id through an app's `TLUiOverrides.translations`.
+ *
+ * Kept apart from the React context so the lookup rule can be tested — and
+ * reused by an app's own chrome — without rendering anything.
+ */
+/**
+ * The locales to try, most specific first: the locale itself, its base
+ * language, then English.
+ *
  * SEMANTICS-ASSUMED: the base-language step is not pinned by any call site
  * (the consumer registers a single `en` map). It is included because the
  * alternative — `cs-CZ` silently missing every string a `cs` dictionary has —
@@ -12926,105 +13050,6 @@ declare function useIsEditing(shapeId?: ShapeId): boolean;
  */
 declare function useGlobalMenuIsOpen(id: string, onChange?: (isOpen: boolean) => void): readonly [boolean, (next: boolean) => void];
 
-/**
- * Failure containment for the editor's React tree.
- *
- * One badly-behaved shape component should cost you that shape, not the
- * document: `<Canvas>` wraps each shape body in a boundary of its own, and the
- * editor as a whole is wrapped in another. Without this, a `TypeError` inside
- * one custom `ShapeUtil.component` unmounts the whole editor and the user
- * loses the canvas.
- */
-interface TLErrorFallbackProps {
-    /** What was thrown. Not necessarily an `Error`. */
-    error: unknown;
-    /** Re-mount the subtree. Undefined when the boundary was told not to retry. */
-    resetError?(): void;
-}
-interface TLErrorBoundaryProps {
-    children: ReactNode;
-    /** Rendered in place of the subtree once it has thrown. */
-    fallback: (props: TLErrorFallbackProps) => ReactNode;
-    /** Reported to the host app: logging, error tracking. */
-    onError?(error: unknown, info?: ErrorInfo): void;
-}
-/** The pre-`TL` spelling of {@link TLErrorBoundaryProps}. The same type. */
-type ErrorBoundaryProps = TLErrorBoundaryProps;
-/**
- * A replacement for the editor-wide error screen, or `null` to render nothing
- * at all.
- *
- * `null` is a real choice, not an oversight: a host that shows its own error UI
- * outside the canvas wants the editor to fail silently rather than to draw a
- * second, competing message.
- */
-type TLErrorFallbackComponent = ComponentType<TLErrorFallbackProps> | null;
-/**
- * A replacement for the fallback drawn in place of a single broken shape, or
- * `null` to draw nothing.
- *
- * Separate from {@link TLErrorFallbackComponent} because the situations are not
- * comparable: one shape failing should cost that shape, and the fallback is
- * drawn *in the canvas*, at the shape's position, where a whole error screen
- * would be absurd.
- */
-type TLShapeErrorFallbackComponent = ComponentType<{
-    error: unknown;
-}> | null;
-interface ErrorBoundaryState {
-    error: unknown;
-    hasError: boolean;
-}
-/**
- * Catches a render-time throw in its subtree and renders `fallback` instead.
- *
- * Class component because that is the only form React gives an error boundary;
- * there is no hook equivalent.
- */
-declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
-    state: ErrorBoundaryState;
-    static getDerivedStateFromError(error: unknown): ErrorBoundaryState;
-    componentDidCatch(error: unknown, info: ErrorInfo): void;
-    private readonly resetError;
-    render(): ReactNode;
-}
-/**
- * What an unhandled error looks like when nothing better is configured: the
- * message, and a button that re-mounts the subtree.
- *
- * Deliberately plain and self-contained — it must render correctly when the
- * failure is in the very stylesheet or provider the rest of the chrome needs.
- */
-declare function DefaultErrorFallback({ error, resetError }: TLErrorFallbackProps): react.JSX.Element;
-interface ErrorScreenProps {
-    children?: ReactNode;
-}
-/**
- * A full-bleed error surface, for a failure that happened before there was an
- * editor to put a fallback inside of — a store that would not load, a schema
- * that would not migrate.
- */
-declare function ErrorScreen({ children }: ErrorScreenProps): react.JSX.Element;
-/**
- * The indeterminate progress mark, sized to the text around it.
- *
- * Uses SMIL rather than a CSS keyframe so it also animates when the editor is
- * mounted without `ui.css` — the case a loading screen is most likely to hit,
- * since it is on screen before anything else has been set up.
- */
-declare function DefaultSpinner(): react.JSX.Element;
-interface LoadingScreenProps {
-    children?: ReactNode;
-}
-/**
- * What is on screen while the editor's store and engine are still coming up.
- *
- * Occupies the editor's whole box so the layout does not jump when the canvas
- * replaces it, and is labelled as a live region so a screen reader is told
- * that something is loading rather than that the page is empty.
- */
-declare function LoadingScreen({ children }: LoadingScreenProps): react.JSX.Element;
-
 interface ContainerProviderProps {
     container: HTMLElement;
     children?: ReactNode;
@@ -13108,6 +13133,16 @@ declare function DefaultBackground(): react.JSX.Element;
  * zooms away, because a grid finer than a few screen pixels is noise.
  */
 declare function DefaultGrid({ x, y, z, size }: TLGridProps): react.JSX.Element;
+/**
+ * Drawn in place of one shape whose body threw.
+ *
+ * At the shape's own position and size, because that is where the user is
+ * looking — and quiet, because a page of thirty broken shapes should not be
+ * thirty alarms. The point is that the other twenty-nine still work.
+ */
+declare function DefaultShapeErrorFallback({ error }: {
+    error: unknown;
+}): react.JSX.Element;
 /**
  * The document-level `<defs>`: the one place a shape can put a gradient,
  * filter or marker that every instance of it shares.
@@ -14069,4 +14104,4 @@ declare function setDefaultCdnBaseUrl(url: string): void;
 /** Forget every asset id in `ids`. Exported for stores that batch their deletes. */
 type AssetIdList = readonly AssetId[];
 
-export { ARROWHEAD_KINDS, ARROW_SHAPE_KINDS, ASSET_MIGRATION_SEQUENCE_PREFIX, Arc2d, ArrayOfValidator, ArrowShapeArrowheadEndStyle, type ArrowShapeArrowheadKind, ArrowShapeArrowheadStartStyle, type ArrowShapeKind, ArrowShapeKindStyle, type Asset, type AssetContext, type AssetCreate, type AssetId, type AssetIdList, type AssetPartial, type AssetPropsForType, AssetRecordType, type AssetStore, type AssetType, type AssetTypeName, type AssetUploadResult, AssetUrlsProvider, type AssetUrlsProviderProps, AssetUtil, AssetUtilRegistry, type B64VecPoint, BINDING_MIGRATION_SEQUENCE_PREFIX, BUILTIN_ASSET_MIGRATION_SEQUENCE_PREFIX, BUILTIN_BINDING_MIGRATION_SEQUENCE_PREFIX, BUILTIN_SHAPE_MIGRATION_SEQUENCE_PREFIX, type BaseAsset, type BaseBinding, BaseBoxShapeUtil, type BaseEventInfo, BaseFrameLikeShapeUtil, type BaseShape, type BatchMeasurementRequest, type Binding, type BindingCanBindOptions, type BindingCreate, type BindingId, type BindingOnChangeOptions, type BindingOnCreateOptions, type BindingOnDeleteOptions, type BindingOnShapeChangeOptions, type BindingOnShapeDeleteOptions, type BindingOnShapeIsolateOptions, type BindingPartial, type BindingPropsForType, BindingRecordType, type BindingTypeName, BindingUtil, type BindingUtilConstructor, type BookmarkAsset, type BookmarkAssetProps, type BoundsSnapGeometry, type BoundsSnapPoint, type BoundsSnapResizeOptions, type BoundsSnapTranslateOptions, BoundsSnaps, Box, type BoxHandle, type BoxLike, type BoxModel, CANVAS_THEME_VARS, COLLABORATOR_INACTIVE_TIMEOUT, CURRENT_SESSION_SCHEMA_VERSION, CURSOR_TYPES, CUSTOM_RECORD_MIGRATION_SEQUENCE_PREFIX, CUSTOM_RECORD_TYPE_NAME, type CachedUserResolve, type Camera, type CameraId, CameraRecordType, CameraStateTracker, type CancelEventInfo, Canvas, type CanvasComponents, type CanvasProps, Circle2d, type ClickEventInfo, type ClickEventName, ClickManager, CollaboratorsManager, type ColorScheme, type DefaultColorStyle$1 as ColorValue, CommentReactionRecordType, CommentRecordType, CommentThreadRecordType, type CompleteEventInfo, type ContainerDocument, ContainerProvider, type ContainerProviderProps, type ContainerWindow, type ContentElementHost, ContentElementManager, type ContentElementSource, type CreateCachedUserResolveOptions, type CreatePresenceStateDerivationOpts, type CreateStoreOptions, CubicBezier2d, type CubicSegmentLike, CubicSpline2d, type CurrentUser, type CustomRecordInfo, type CustomRecordPropsForType, DEFAULT_ASSET_CONTEXT, DEFAULT_CAMERA_OPTIONS, DEFAULT_COLORS, DEFAULT_DARK_COLORS, DEFAULT_DASHES, DEFAULT_EDITOR_CONFIG, DEFAULT_FILLS, DEFAULT_FILL_TOKENS, DEFAULT_FONTS, DEFAULT_FONT_FAMILIES, DEFAULT_H_ALIGNS, DEFAULT_LIGHT_COLORS, DEFAULT_LINE_HEIGHT, DEFAULT_MENU_CONTEXT, DEFAULT_PAGE_ID, DEFAULT_SHAPE_INDICATOR_OPTIONS, DEFAULT_SIZES, DEFAULT_TEXT_ALIGNS, DEFAULT_THEME, DEFAULT_TIME_CONTEXT, DEFAULT_V_ALIGNS, DIM_2D, DIM_3D, DOCUMENT_ID, type DefaultDashStyle$1 as DashValue, type DecodedDrawPoint, type DecomposedMat, DefaultBackground, DefaultCanvas, DefaultColorStyle, DefaultCursor, DefaultDashStyle, DefaultErrorFallback, DefaultFillStyle, DefaultFontFaces, DefaultFontFamilies, DefaultFontStyle, DefaultGrid, DefaultHorizontalAlignStyle, DefaultLabelColorStyle, DefaultShapeWrapper, DefaultSizeStyle, DefaultSpinner, DefaultSvgDefs, DefaultTextAlignStyle, DefaultVerticalAlignStyle, DictValidator, type Document$1 as Document, type DocumentId, DocumentRecordType, type DrawOptions, EASINGS, ELBOW_ARROW_SNAP_MODES, EVENT_NAME_MAP, Edge2d, EdgeScrollManager, Editor, EditorAtom, type EditorConfig, EditorContext, type EditorEngineProvider, type EditorEvents, type EditorExportImplementation, type EditorImageExportOptions, type EditorImageExportResult, type EditorInputs, EditorManager, type EditorOptions, EditorPortal, type EditorPortalProps, EditorProvider, type EditorProviderProps, type EditorRecord, type EditorStore, type EditorStoreProps, type EditorStoreSnapshot, type EditorSvgExportOptions, type EditorSvgExportResult, type EditorTextHtmlMeasurement, type EditorTextMeasure, type EditorTextMeasureHtmlOptions, type EditorTextMeasureOptions, type EditorTextMeasureProvider, type EditorTextMeasurement, ElbowArrowSnap, type ElbowArrowSnapMode, Ellipse2d, type EngineGeometry, EnumStyleProp, ErrorBoundary, type ErrorBoundaryProps, ErrorScreen, type ErrorScreenProps, EventEmitter, type EventHandlers, type EventInfo, type ExternalAssetContent, type ExternalAssetHandler, type ExternalAssetType, type ExternalContent, type ExternalContentHandler, type ExternalContentType, type ExtractShapeByProps, FIRST_PAGE_INDEX, FONT_SIZES, type DefaultFillStyle$1 as FillValue, FontManager, type DefaultFontStyle$1 as FontValue, type FrameLikeShape, GEO_SHAPE_KINDS, type GapsSnapIndicator, GeoShapeGeoStyle, type GeoShapeKind, Geometry2d, Geometry2dFilters, type Geometry2dOptions, type GetSvgAsImageOptions, Group2d, HALF_PI, HANDLE_HIT_RADIUS, type DefaultHorizontalAlignStyle$1 as HAlignValue, HTMLContainer, type HTMLContainerProps, type HandleSnapGeometry, type HandleSnapOptions, HandleSnaps, HandleTable, HistoryManager, type HitTestOptions, INSTANCE_ID, type ImageAsset, type ImageAssetProps, ImageShapeCrop, type IndicatorPathSource, type IndicatorShapeUtil, type IndicatorSource, InputsManager, type Instance, type InstanceId, type InstancePageState, type InstancePageStateId, InstancePageStateRecordType, type InstancePresence, type InstancePresenceId, InstancePresenceRecordType, InstanceRecordType, type InterruptEventInfo, type JsonObject, type JsonPrimitive, type JsonValue, type KeyboardEventInfo, type KeyboardEventName, LIGHT_THEME, LINE_SPLINE_KINDS, LOCAL_STATE_PREFIX, type LegacyDrawShapeSegment, type LineShapeSplineKind, LineShapeSplineStyle, LoadingScreen, type LoadingScreenProps, MAX_TEXTURE_RESOLUTION, MAX_TEXTURE_ZOOM, Mat, type MatLike, type MatModel, MenuClickCapture, MenuManager, type MigratableProps, type MocanvasUiContextValue, MocanvasUiProvider, type MocanvasUiProviderProps, type NormalizeOptions, type NormalizeResult, ObjectValidator, type ObjectValidatorType, type OptionalKeys, type OverlayEntry, type OverlayHost, type OverlayLike, OverlayManager, type OverlayOptionsWithDisplayValues, OverlayUtil, type OverlayUtilOptions, PI, PI2, PRESENCE_COLORS, type Page, type PageId, PageRecordType, type ParentId, type PerfectDashOptions, type PerfectDashProps, type PerfectDashTerminal, PerformanceApiAdapter, type PerformanceApiAdapterOptions, type PerformanceEventName, type PerformanceEvents, PerformanceManager, type PinchEventInfo, Point2d, type PointLike, type PointerEventInfo, type PointerEventName, PointerRecordType, type PointerSource, type PointerTarget, type PointsSnapIndicator, Polygon2d, Polyline2d, type PresenceStateDerivationOptions, type PresenceUser, type PropsMigration, type PropsMigrationSource, type PropsMigrationTarget, type PropsMigrations, type RGBA, ROTATE_CORNER_TO_SELECTION_CORNER, ROTATE_HANDLE_OFFSET, ReadonlySharedStyleMap, type RecordPropValidator, type RecordProps, type RecordPropsType, type RecordValidatorOptions, Rectangle2d, type RegisteredAssetType, type RegisteredBindingType, type RegisteredCustomRecordType, type RegisteredShapeType, type RenderBackend, type RequiredKeys, type ResizeBoxOptions, type ResizeInfo, type ResizeShapeOptions, type RichTextFontVisitor, type RichTextFontVisitorState, RootState, type RotateCorner, SHAPE_MIGRATION_SEQUENCE_PREFIX, SIDES, SIN, STROKE_SIZES, SVGContainer, type SVGContainerProps, type SafeId, type SchemaPropsInfo, type SchemaPropsInfoMap, type SchemaUtilSource, type Scribble, type ScribbleItem, ScribbleManager, type ScribbleSessionOptions, type SelectionCorner, type SelectionEdge, type SelectionHandle, type SelectionHandleHit, type SetValue, type Shape, type ShapeCreate, type ShapeHandle, type ShapeId, ShapeIndicatorCompositor, type ShapePartial, type ShapePropsForType, ShapeRecordType, type ShapeRef, type ShapeSvgContext, type ShapeSvgResult, type ShapeTypeName, ShapeUtil, type ShapeUtilClass, type ShapeUtilConstructor, type ShapeUtilOptions, type ShapeUtilOptionsPatch, type ShapeWithCrop, type SharedStyle, SharedStyleMap, type DefaultSizeStyle$1 as SizeValue, type SnapData, type SnapIndicator, type SnapLine, SnapManager, type SnapResult, Stadium2d, StateNode, type StateNodeClass, type StateNodeConstructor, type StateNodeType, type StrokeShapeIndicatorsOptions, StyleProp, type StylePropValue, SvgExportContextProvider, type SvgExportContextProviderProps, type SvgExportDef, T, TAB_ID, type TLActionShortcutsLocation, type TLAdjacentDirection, type TLAnimationOptions, type TLAnyAssetUtilConstructor, type TLAnyOverlayUtilConstructor, type TLArrowShapeArrowheadStyle, type TLArrowShapeKind, type TLAssetShape, type TLAssetUrls, type TLAssetUtilClass, type TLAssetUtilConstructor, type TLAssetUtilConstructorLike, type TLAssetUtilLike, type TLAssetUtilOptions, type TLBaseBoxShape, type TLBaseExternalContent, type TLBindingUpdate, type TLCLickEventName, type TLCameraConstraints, type TLCameraConstraintsZoom, type TLCameraEndPerfEvent, type TLCameraMoveOptions, type TLCameraOptions, type TLCameraStartPerfEvent, type TLCameraState, type TLCancelEvent, type TLCanvasComponentProps, type TLCanvasUiColor, type TLClickEvent, type TLClickEventInfo, type TLClickState, type TLClipboardPasteRawInfo, type TLClipboardWriteInfo, type TLColorMode, type TLColorScheme, type TLColorSchemeWindow, type TLComment, type TLCommentAnchor, type TLCommentId, type TLCommentReaction, type TLCommentReactionId, type TLCommentThread, type TLCommentThreadId, type TLCompleteEvent, type TLComponents, type TLComponentsResolved, type TLContent, type TLCreateShapePartial, type TLCropInfo, type TLCursor, type TLCursorProps, type TLCursorSlotProps, type TLCursorType, type TLCursorViewportSource, type TLCustomRecord, type TLCustomRecordId, type TLDeepLink, type TLDeepLinkOptions, type TLDefaultAsset, type TLDefaultBinding, type TLDefaultColor, type TLDefaultColorVariant, type TLDefaultDisplayValues, type TLDefaultRecord, type TLDefaultShape, type TLDefaultTextAlignStyle, type TLDisplayValuesSource, type TLDragShapesInInfo, type TLDragShapesInfo, type TLDragShapesOutInfo, type TLDragShapesOverInfo, type TLDrawShapeSegment, type TLDropShapesOverInfo, type TLEasingType, type TLEditStartInfo, type TLEditorAssetUrls, type TLEditorComponents, type TLEditorComponentsEditor, type TLEditorRunOptions, type TLEditorSnapshot, TLEditorsRegistry, type TLEmbedExternalContent, type TLEnterEventHandler, type TLEnvironment, type TLErrorBoundaryProps, type TLErrorExternalContentSource, type TLErrorFallbackComponent, type TLErrorFallbackProps, type TLErrorSlotProps, type TLEventMap, type TLEventMapHandler, type TLEventName, type TLExcalidrawExternalContent, type TLExcalidrawExternalContentSource, type TLExitEventHandler, type TLExportType, type TLExternalAsset, type TLExternalContentSource, type TLFileExternalAsset, type TLFileReplaceExternalContent, type TLFilesExternalContent, type TLFontFace, type TLFontFaceSet, type TLFontFaceSource, type TLFontLoadState, type TLFramePerfEvent, type TLGeometryOpts, type TLGetCustomDisplayValues, type TLGetCustomOverlayDisplayValues, type TLGetDefaultDisplayValues, type TLGetDefaultOverlayDisplayValues, type TLGetShapeAtPointOptions, type TLGetShapeVisibility, type TLGlobalAssetPropsMap, type TLGlobalBindingPropsMap, type TLGlobalRecordPropsMap, type TLGlobalShapePropsMap, type TLGridProps, type TLGridStep, type TLHandleDragInfo, type TLHandleType, type TLHistoryBatchOptions, type TLHistoryDiff, type TLHistoryEntry, type TLHistoryMark, type TLHistoryRecordingMode, type TLImageExportOptions, type TLIndexedAssets, type TLIndexedBindings, type TLIndexedRecords, type TLIndexedShapes, type TLIndicatorContext, type TLIndicatorHost, type TLIndicatorOverlay, type TLIndicatorPath, type TLIndicatorPathResult, type TLIndicatorTransform, type TLInstancePresenceID, type TLInteractionEndPerfEvent, type TLInteractionStartPerfEvent, type TLInterpolationProgress, type TLInterruptEvent, type TLKeyboardEvent, type TLLineShapeSplineStyle, type TLLoadSessionStateSnapshotOptions, type TLLoadSnapshotOptions, type TLMeasureTextOpts, type TLMeasureTextSpanOpts, type TLMeasuredTextSize, type TLMenus, type TLOpacityType, type TLOverlay, type TLOverlayDisplayValuesSource, type TLOverlayEntry, type TLOverlayUtilConstructor, TLPOINTER_ID, type TLPerfEventMap, type TLPerfFrameTimeStats, type TLPerfLongAnimationFrame, type TLPerfLongAnimationFrameScript, type TLPinchEvent, type TLPinchEventName, type TLPointInShapeOptions, type TLPointer, type TLPointerEvent, type TLPointerEventTarget, type TLPointerId, type TLPointerInfo, type TLPresenceStateInfo, type TLReactiveEnvironment, type TLRegisteredAsset, type TLRemovedDefaultThemeColors, type TLRenderingShape, type TLResettableEditor, type TLResizeHandle, type TLResizeMode, type TLRichTextFontSource, type TLRuntime, type TLSchema, type TLScribbleState, type TLSessionPageState, type TLSessionStateSnapshot, type TLShapeCrop, type TLShapeErrorFallbackComponent, type TLShapeIndicatorOptions, type TLShapeOperationPerfEvent, type TLShapeUtilCanBeLaidOutOpts, type TLShapeUtilCanBindOpts, type TLShapeUtilCanvasSvgDef, type TLShapeVisibility, type TLShapeWrapperProps, type TLShapeWrapperSlotProps, type TLSharedOpacity, type TLStoreBaseOptions, type TLStoreEventInfo, type TLStoreOptions, type TLStoreProps, type TLStoreSchemaOptions, type TLStoreWithStatus, type TLStyledShape, type TLStyledShapeProps, type TLSvgExportContext, type TLSvgTextExternalContent, type TLTemporaryAssetPreview, type TLTextExternalContent, type TLTextExternalContentSource, type TLTextOptions, type TLTextSpan, type TLTheme, type TLThemeColors, type TLThemeDefaultColors, type TLThemeFont, type TLThemeFonts, type TLThemeHost, type TLThemeId, type TLThemePatch, type TLThemeUiColorKeys, type TLThemes, type TLThemesInput, type TLTickEvent, type TLTime, type TLTimeContext, type TLTldrawExternalContent, type TLTldrawExternalContentSource, type TLUiActionItem, type TLUiActionsBuilder, type TLUiActionsContextType, type TLUiAssetUrls, type TLUiComponentSlot, type TLUiEventSource, type TLUiOverrideHelpers, type TLUiOverrides, type TLUiToolItem, type TLUiToolsBuilder, type TLUiToolsContextType, type TLUiTranslations, type TLUndoRedoPerfEvent, type TLUnknownAsset, type TLUpdatePointerOptions, type TLUrlExternalAsset, type TLUrlExternalContent, type TLWheelEvent, TL_CANVAS_UI_COLOR_TYPES, TL_CURSOR_TYPES, TL_HANDLE_TYPES, TL_SCRIBBLE_STATES, type DefaultTextAlignStyle$1 as TextAlignValue, TextManager, type TextureInfo, type TextureLoader, TextureManager, type TextureManagerOptions, type TextureOptions, type TextureSource, type TextureState, type ThemeColor, ThemeManager, type ThemeManagerOptions, type TickEventInfo, Timers, type TiptapEditor, type TiptapNode, type TldrawEditorBaseProps, type TldrawEditorProps, type TldrawEditorWithStoreProps, type TldrawEditorWithoutStoreProps, type TldrawOptions, TransformedGeometry2d, type TransformedGeometry2dOptions, type TranslateInfo, type TypeOf, UNKNOWN_EDIT_START_INFO, USER_PREFERENCES_DEFAULTS, type UiEvent, type UiEventType, UnionValidator, type UnionValidatorConfig, type UnknownBinding, type UnknownCustomRecord, type UnknownPropsPolicy, type UnknownRecordProps, type UnknownShape, type UseCurrentUserOptions, type User, type UserId, type UserPreferences, type UserPreferencesInit, UserPreferencesManager, type UserPreferencesState, type UserRecordId, UserRecordType, type UserSchemaInfo, type UserStore, type DefaultVerticalAlignStyle$1 as VAlignValue, type Validatable, ValidationError, type ValidationLibrary, type ValidationPathSegment, Validator, Vec, type VecLike, type VecModel, type VideoAsset, type VideoAssetProps, WebGL2Backend, type WheelEventInfo, angleDistance, animateShape, animateShapes, applyThemePatch, approximately, areAnglesCompatible, arrowBindingVersions, assetIdValidator, assetMigrations, assetPropsMigrationSequenceId, assetValidator, assetValidators, average, b64Vecs, bindingIdValidator, bindingPropsMigrationSequenceId, bookmarkAssetMigrations, bookmarkAssetProps, bookmarkAssetPropsValidator, bookmarkAssetValidator, boundsIndicatorPath, boxModelValidator, bucketTextureResolution, canBindShapes, canBuildIndicatorPaths, canCreateShape, canCreateShapes, canCropShape, canEditShape, canonicalizeRotation, canvasUiColorTypeValidator, centerOfCircleFromThreePoints, clamp, clampRadians, clockwiseAngleDist, commentAnchorValidator, commentReactionRecordConfig, commentReactionValidator, commentRecordConfig, commentSchemaRecords, commentThreadRecordConfig, commentThreadValidator, commentValidator, compressLegacySegments, coreShapes, counterClockwiseAngleDist, createAssetId, createAssetPropsMigrationIds, createAssetPropsMigrationSequence, createAssetPropsValidator, createAssetValidator, createBackend, createBaseAssetValidator, createBaseBindingValidator, createBaseShapeValidator, createBindingId, createBindingPropsMigrationIds, createBindingPropsMigrationSequence, createBindingValidator, createBuiltInAssetPropsMigrationIds, createBuiltInBindingPropsMigrationIds, createBuiltInShapePropsMigrationIds, createCachedUserResolve, createComment, createCommentId, createCommentReaction, createCommentReactionId, createCommentThread, createCommentThreadId, createCurrentUser, createCustomRecord, createCustomRecordId, createCustomRecordMigrationIds, createCustomRecordMigrationSequence, createCustomRecordMigrationSequences, createCustomRecordType, createCustomRecordTypeMap, createCustomRecordValidator, createDeepLinkString, createInMemoryAssetStore, createMemoryUserStore, createPresenceStateDerivation, createPropsMigrationSequences, createRootState, createSchema, createSessionStateSnapshotSignal, createShapeId, createShapePropsMigrationIds, createShapePropsMigrationSequence, createShapeValidator, createStore, createTLCurrentUser, createTLSchemaFromUtils, createTheme, createUserId, createUserPreferences, createUserRecordType, cursorTypeValidator, cursorValidator, customRecordMigrationSequenceId, dataUrlToFile, decodeDrawSegmentPath, defaultAssetMigrations, defaultAssetSchemas, defaultBindingSchemas, defaultShapeSchemas, defaultTldrawOptions, defaultUserPreferences, defaultUserStore, degreesToRadians, deselect, drawShapeSegmentValidator, dropShapesOnFrameLike, duplicatePage, easeInOutCubic, fileToBase64DataUrl, fileToDataUrl, findCommonAncestor, findShapeAncestor, fontKey, formatValidationPath, getArcMeasure, getAssetSrc, getBaseZoomForCameraOptions, getCameraCssVars, getColorNamesFromThemes, getColorValue, getCulledShapes, getCurrentPageRenderingShapesSorted, getCurrentPageShapesInReadingOrder, getCursor, getCustomRecordIdType, getDefaultAssetContext, getDefaultCdnBaseUrl, getDefaultCrop, getDefaultDisplayValues, getDefaultUserPresence, getDefaultUserProperties, getDisplayValues, getDroppedShapesToNewParents, getEngineProvider, getExportImplementation, getFocusedGroup, getFocusedGroupId, getFontNamesFromThemes, getFontsFromRichText, getFrameLikeDropTarget, getFreshUserPreferences, getHandleHitRadius, getIncrementedName, getIndicatorSource, getInitialMetaForShape, getLocaleChain, getNearestAdjacentShape, getNotVisibleShapes, getOnlySelectedShapeId, getOverlayDisplayValues, getOwnerDocument, getOwnerWindow, getPageStates, getPaletteEntries, getPerfectDashProps, getPointInArcT, getPointOnCircle, getPointerInfo, getPointsOnArc, getPolygonVertices, getRenderingShapes, getSelectedShapeAtPoint, getSelectionHandlePositions, getSelectionRotatedPageBounds, getSelectionRotatedScreenBounds, getSelectionScreenBounds, getSessionStateSnapshot, getSessionStateSnapshotFromStore, getShapeAndDescendantIds, getShapeClipPath, getShapeHandles, getShapeIdsInsideBounds, getShapeIndicatorNode, getShapeIndicatorPath, getShapeMaskedPageBounds, getShapeStyleIfExists, getShapesPageBounds, getSharedOpacity, getSnapshot, getStylePropsOf, getSvgAsImage, getSvgPathFromPoints, getTextMeasureProvider, getThemeCssVars, getUncroppedSize, getUserPreferences, handleTypeValidator, hardReset, hardResetEditor, hasAncestor, hexToRgba, hitTestSelectionBounds, hitTestSelectionHandles, idValidator, imageAssetMigrations, imageAssetProps, imageAssetPropsValidator, imageAssetValidator, inlineBase64AssetStore, intersectCircleCircle, intersectCirclePolygon, intersectCirclePolyline, intersectLineSegmentCircle, intersectLineSegmentLineSegment, intersectLineSegmentPolygon, intersectLineSegmentPolyline, intersectPolygonBounds, intersectPolygonPolygon, isAncestorSelected, isAsset, isAssetId, isBinding, isBindingId, isCommentId, isCommentReactionId, isCommentThreadId, isCursorInViewport, isCustomRecord, isCustomRecordId, isDocument, isFullCrop, isInstancePresenceId, isOptionalValidator, isPage, isPageId, isPointInShape, isPropsMigrations, isSafeFloat, isShape, isShapeHidden, isShapeId, isShapeInPage, isUserId, isValidProps, kickoutOccludedShapes, lerp, linesIntersect, loadSessionStateSnapshotIntoStore, loadSnapshot, loopToHtmlElement, maybeSnapToGrid, mixHexColors, moveElementInto, moveShapesToPage, normalizeIndicatorPath, normalizeLoadedRecords, noteReactivePointerType, opacityValidator, openWindow, packShapes, pageIdValidator, parentIdValidator, parseDeepLinkString, perimeterOfEllipse, pointInPolygon, pointerValidator, polygonIntersectsPolyline, polygonsIntersect, popFocusedGroupId, precise, prefixError, preventDefault, radiansToDegrees, randomPresenceColor, rangeIntersection, refreshPage, refreshReactiveEnvironment, registerColorsFromThemes, registerCoreShape, registerDefaultAssetSchema, registerDefaultBindingSchema, registerDefaultShapeSchema, registerEngineProvider, registerExportImplementation, registerFontsFromThemes, registerTextMeasureImplementation, releasePointerCapture, resizeBox, resizeScaled, resizeToBounds, resolveAssetUrl, resolveLineHeightPx, resolveShape, resolveThemes, resolveUiMessage, richTextToPlainText, rootBindingMigrations, rootShapeMigrations, rotateSelectionHandle, runtime, sanitizeId, scribbleValidator, selectAdjacentShape, selectFirstChildShape, selectParentShape, setDefaultCdnBaseUrl, setFocusedGroup, setOpacityForNextShapes, setOpacityForSelectedShapes, setPointerCapture, setRuntimeOverrides, setUserPreferences, shapeIdValidator, shapePropsMigrationSequenceId, shortAngleDist, snapAngle, stopEventPropagation, strokeShapeIndicators, suffixSafeId, tleditors, tlenv, tlenvReactive, tlmenus, tltime, toCustomRecordMigrationSequence, toDomPrecision, toFixed, toMigrationSequence, toPrecision, trackPointer, uniq, updatePage, useActions, useAssetUrls, useCameraCssVars, useColorMode, useContainer, useContainerIfExists, useCurrentTheme, useCurrentUser, useDelaySvgExport, useEditor, useEditorComponents, useEditorPortalHost, useGlobalMenuIsOpen, useIsCropping, useIsEditing, useIsToolSelected, useMaybeEditor, useMocanvasUi, usePassThroughWheelEvents, useSharedSafeId, useSvgExportContext, useTLSchemaFromUtils, useTLStore, useThemeColors, useThemeCssVars, useTools, useTransform, useUniqueSafeId, useViewportHeight, userIdValidator, userPreferencesValidator, userTypeValidator, userValidator, validateCustomRecordInfos, validateProps, vecModelValidator, videoAssetMigrations, videoAssetProps, videoAssetValidator, visitDescendants, warnOnce, withCoreShapes };
+export { ARROWHEAD_KINDS, ARROW_SHAPE_KINDS, ASSET_MIGRATION_SEQUENCE_PREFIX, Arc2d, ArrayOfValidator, ArrowShapeArrowheadEndStyle, type ArrowShapeArrowheadKind, ArrowShapeArrowheadStartStyle, type ArrowShapeKind, ArrowShapeKindStyle, type Asset, type AssetContext, type AssetCreate, type AssetId, type AssetIdList, type AssetPartial, type AssetPropsForType, AssetRecordType, type AssetStore, type AssetType, type AssetTypeName, type AssetUploadResult, AssetUrlsProvider, type AssetUrlsProviderProps, AssetUtil, AssetUtilRegistry, type B64VecPoint, BINDING_MIGRATION_SEQUENCE_PREFIX, BUILTIN_ASSET_MIGRATION_SEQUENCE_PREFIX, BUILTIN_BINDING_MIGRATION_SEQUENCE_PREFIX, BUILTIN_SHAPE_MIGRATION_SEQUENCE_PREFIX, type BaseAsset, type BaseBinding, BaseBoxShapeUtil, type BaseEventInfo, BaseFrameLikeShapeUtil, type BaseShape, type BatchMeasurementRequest, type Binding, type BindingCanBindOptions, type BindingCreate, type BindingId, type BindingOnChangeOptions, type BindingOnCreateOptions, type BindingOnDeleteOptions, type BindingOnShapeChangeOptions, type BindingOnShapeDeleteOptions, type BindingOnShapeIsolateOptions, type BindingPartial, type BindingPropsForType, BindingRecordType, type BindingTypeName, BindingUtil, type BindingUtilConstructor, type BookmarkAsset, type BookmarkAssetProps, type BoundsSnapGeometry, type BoundsSnapPoint, type BoundsSnapResizeOptions, type BoundsSnapTranslateOptions, BoundsSnaps, Box, type BoxHandle, type BoxLike, type BoxModel, CANVAS_THEME_VARS, COLLABORATOR_INACTIVE_TIMEOUT, CURRENT_SESSION_SCHEMA_VERSION, CURSOR_TYPES, CUSTOM_RECORD_MIGRATION_SEQUENCE_PREFIX, CUSTOM_RECORD_TYPE_NAME, type CachedUserResolve, type Camera, type CameraId, CameraRecordType, CameraStateTracker, type CancelEventInfo, Canvas, type CanvasComponents, type CanvasProps, Circle2d, type ClickEventInfo, type ClickEventName, ClickManager, CollaboratorsManager, type ColorScheme, type DefaultColorStyle$1 as ColorValue, CommentReactionRecordType, CommentRecordType, CommentThreadRecordType, type CompleteEventInfo, type ContainerDocument, ContainerProvider, type ContainerProviderProps, type ContainerWindow, type ContentElementHost, ContentElementManager, type ContentElementSource, type CreateCachedUserResolveOptions, type CreatePresenceStateDerivationOpts, type CreateStoreOptions, CubicBezier2d, type CubicSegmentLike, CubicSpline2d, type CurrentUser, type CustomRecordInfo, type CustomRecordPropsForType, DEFAULT_ASSET_CONTEXT, DEFAULT_CAMERA_OPTIONS, DEFAULT_COLORS, DEFAULT_DARK_COLORS, DEFAULT_DASHES, DEFAULT_EDITOR_CONFIG, DEFAULT_FILLS, DEFAULT_FILL_TOKENS, DEFAULT_FONTS, DEFAULT_FONT_FAMILIES, DEFAULT_H_ALIGNS, DEFAULT_LIGHT_COLORS, DEFAULT_LINE_HEIGHT, DEFAULT_MENU_CONTEXT, DEFAULT_PAGE_ID, DEFAULT_SHAPE_INDICATOR_OPTIONS, DEFAULT_SIZES, DEFAULT_TEXT_ALIGNS, DEFAULT_THEME, DEFAULT_TIME_CONTEXT, DEFAULT_V_ALIGNS, DIM_2D, DIM_3D, DOCUMENT_ID, type DefaultDashStyle$1 as DashValue, type DecodedDrawPoint, type DecomposedMat, DefaultBackground, DefaultCanvas, DefaultColorStyle, DefaultCursor, DefaultDashStyle, DefaultErrorFallback, DefaultFillStyle, DefaultFontFaces, DefaultFontFamilies, DefaultFontStyle, DefaultGrid, DefaultHorizontalAlignStyle, DefaultLabelColorStyle, DefaultShapeErrorFallback, DefaultShapeWrapper, DefaultSizeStyle, DefaultSpinner, DefaultSvgDefs, DefaultTextAlignStyle, DefaultVerticalAlignStyle, DictValidator, type Document$1 as Document, type DocumentId, DocumentRecordType, type DrawOptions, EASINGS, ELBOW_ARROW_SNAP_MODES, EVENT_NAME_MAP, Edge2d, EdgeScrollManager, Editor, EditorAtom, type EditorConfig, EditorContext, type EditorEngineProvider, type EditorEvents, type EditorExportImplementation, type EditorImageExportOptions, type EditorImageExportResult, type EditorInputs, EditorManager, type EditorOptions, EditorPortal, type EditorPortalProps, EditorProvider, type EditorProviderProps, type EditorRecord, type EditorStore, type EditorStoreProps, type EditorStoreSnapshot, type EditorSvgExportOptions, type EditorSvgExportResult, type EditorTextHtmlMeasurement, type EditorTextMeasure, type EditorTextMeasureHtmlOptions, type EditorTextMeasureOptions, type EditorTextMeasureProvider, type EditorTextMeasurement, ElbowArrowSnap, type ElbowArrowSnapMode, Ellipse2d, type EngineGeometry, EnumStyleProp, ErrorBoundary, type ErrorBoundaryProps, ErrorScreen, type ErrorScreenProps, EventEmitter, type EventHandlers, type EventInfo, type ExternalAssetContent, type ExternalAssetHandler, type ExternalAssetType, type ExternalContent, type ExternalContentHandler, type ExternalContentType, type ExtractShapeByProps, FIRST_PAGE_INDEX, FONT_SIZES, type DefaultFillStyle$1 as FillValue, FontManager, type DefaultFontStyle$1 as FontValue, type FrameLikeShape, GEO_SHAPE_KINDS, type GapsSnapIndicator, GeoShapeGeoStyle, type GeoShapeKind, Geometry2d, Geometry2dFilters, type Geometry2dOptions, type GetSvgAsImageOptions, Group2d, HALF_PI, HANDLE_HIT_RADIUS, type DefaultHorizontalAlignStyle$1 as HAlignValue, HTMLContainer, type HTMLContainerProps, type HandleSnapGeometry, type HandleSnapOptions, HandleSnaps, HandleTable, HistoryManager, type HitTestOptions, INSTANCE_ID, type ImageAsset, type ImageAssetProps, ImageShapeCrop, type IndicatorPathSource, type IndicatorShapeUtil, type IndicatorSource, InputsManager, type Instance, type InstanceId, type InstancePageState, type InstancePageStateId, InstancePageStateRecordType, type InstancePresence, type InstancePresenceId, InstancePresenceRecordType, InstanceRecordType, type InterruptEventInfo, type JsonObject, type JsonPrimitive, type JsonValue, type KeyboardEventInfo, type KeyboardEventName, LIGHT_THEME, LINE_SPLINE_KINDS, LOCAL_STATE_PREFIX, type LegacyDrawShapeSegment, type LineShapeSplineKind, LineShapeSplineStyle, LoadingScreen, type LoadingScreenProps, MAX_TEXTURE_RESOLUTION, MAX_TEXTURE_ZOOM, Mat, type MatLike, type MatModel, MenuClickCapture, MenuManager, type MigratableProps, type MocanvasUiContextValue, MocanvasUiProvider, type MocanvasUiProviderProps, type NormalizeOptions, type NormalizeResult, ObjectValidator, type ObjectValidatorType, type OptionalKeys, type OverlayEntry, type OverlayHost, type OverlayLike, OverlayManager, type OverlayOptionsWithDisplayValues, OverlayUtil, type OverlayUtilOptions, PI, PI2, PRESENCE_COLORS, type Page, type PageId, PageRecordType, type ParentId, type PerfectDashOptions, type PerfectDashProps, type PerfectDashTerminal, PerformanceApiAdapter, type PerformanceApiAdapterOptions, type PerformanceEventName, type PerformanceEvents, PerformanceManager, type PinchEventInfo, Point2d, type PointLike, type PointerEventInfo, type PointerEventName, PointerRecordType, type PointerSource, type PointerTarget, type PointsSnapIndicator, Polygon2d, Polyline2d, type PresenceStateDerivationOptions, type PresenceUser, type PropsMigration, type PropsMigrationSource, type PropsMigrationTarget, type PropsMigrations, type RGBA, ROTATE_CORNER_TO_SELECTION_CORNER, ROTATE_HANDLE_OFFSET, ReadonlySharedStyleMap, type RecordPropValidator, type RecordProps, type RecordPropsType, type RecordValidatorOptions, Rectangle2d, type RegisteredAssetType, type RegisteredBindingType, type RegisteredCustomRecordType, type RegisteredShapeType, type RenderBackend, type RequiredKeys, type ResizeBoxOptions, type ResizeInfo, type ResizeShapeOptions, type RichTextFontVisitor, type RichTextFontVisitorState, RootState, type RotateCorner, SHAPE_MIGRATION_SEQUENCE_PREFIX, SIDES, SIN, STROKE_SIZES, SVGContainer, type SVGContainerProps, type SafeId, type SchemaPropsInfo, type SchemaPropsInfoMap, type SchemaUtilSource, type Scribble, type ScribbleItem, ScribbleManager, type ScribbleSessionOptions, type SelectionCorner, type SelectionEdge, type SelectionHandle, type SelectionHandleHit, type SetValue, type Shape, type ShapeCreate, type ShapeHandle, type ShapeId, ShapeIndicatorCompositor, type ShapePartial, type ShapePropsForType, ShapeRecordType, type ShapeRef, type ShapeSvgContext, type ShapeSvgResult, type ShapeTypeName, ShapeUtil, type ShapeUtilClass, type ShapeUtilConstructor, type ShapeUtilOptions, type ShapeUtilOptionsPatch, type ShapeWithCrop, type SharedStyle, SharedStyleMap, type DefaultSizeStyle$1 as SizeValue, type SnapData, type SnapIndicator, type SnapLine, SnapManager, type SnapResult, Stadium2d, StateNode, type StateNodeClass, type StateNodeConstructor, type StateNodeType, type StrokeShapeIndicatorsOptions, StyleProp, type StylePropValue, SvgExportContextProvider, type SvgExportContextProviderProps, type SvgExportDef, T, TAB_ID, type TLActionShortcutsLocation, type TLAdjacentDirection, type TLAnimationOptions, type TLAnyAssetUtilConstructor, type TLAnyOverlayUtilConstructor, type TLArrowShapeArrowheadStyle, type TLArrowShapeKind, type TLAssetShape, type TLAssetUrls, type TLAssetUtilClass, type TLAssetUtilConstructor, type TLAssetUtilConstructorLike, type TLAssetUtilLike, type TLAssetUtilOptions, type TLBaseBoxShape, type TLBaseExternalContent, type TLBindingUpdate, type TLCLickEventName, type TLCameraConstraints, type TLCameraConstraintsZoom, type TLCameraEndPerfEvent, type TLCameraMoveOptions, type TLCameraOptions, type TLCameraStartPerfEvent, type TLCameraState, type TLCancelEvent, type TLCanvasComponentProps, type TLCanvasUiColor, type TLClickEvent, type TLClickEventInfo, type TLClickState, type TLClipboardPasteRawInfo, type TLClipboardWriteInfo, type TLColorMode, type TLColorScheme, type TLColorSchemeWindow, type TLComment, type TLCommentAnchor, type TLCommentId, type TLCommentReaction, type TLCommentReactionId, type TLCommentThread, type TLCommentThreadId, type TLCompleteEvent, type TLComponents, type TLComponentsResolved, type TLContent, type TLCreateShapePartial, type TLCropInfo, type TLCursor, type TLCursorProps, type TLCursorSlotProps, type TLCursorType, type TLCursorViewportSource, type TLCustomRecord, type TLCustomRecordId, type TLDeepLink, type TLDeepLinkOptions, type TLDefaultAsset, type TLDefaultBinding, type TLDefaultColor, type TLDefaultColorVariant, type TLDefaultDisplayValues, type TLDefaultRecord, type TLDefaultShape, type TLDefaultTextAlignStyle, type TLDisplayValuesSource, type TLDragShapesInInfo, type TLDragShapesInfo, type TLDragShapesOutInfo, type TLDragShapesOverInfo, type TLDrawShapeSegment, type TLDropShapesOverInfo, type TLEasingType, type TLEditStartInfo, type TLEditorAssetUrls, type TLEditorComponents, type TLEditorComponentsEditor, type TLEditorRunOptions, type TLEditorSnapshot, TLEditorsRegistry, type TLEmbedExternalContent, type TLEnterEventHandler, type TLEnvironment, type TLErrorBoundaryProps, type TLErrorExternalContentSource, type TLErrorFallbackComponent, type TLErrorFallbackProps, type TLErrorSlotProps, type TLEventMap, type TLEventMapHandler, type TLEventName, type TLExcalidrawExternalContent, type TLExcalidrawExternalContentSource, type TLExitEventHandler, type TLExportType, type TLExternalAsset, type TLExternalContentSource, type TLFileExternalAsset, type TLFileReplaceExternalContent, type TLFilesExternalContent, type TLFontFace, type TLFontFaceSet, type TLFontFaceSource, type TLFontLoadState, type TLFramePerfEvent, type TLGeometryOpts, type TLGetCustomDisplayValues, type TLGetCustomOverlayDisplayValues, type TLGetDefaultDisplayValues, type TLGetDefaultOverlayDisplayValues, type TLGetShapeAtPointOptions, type TLGetShapeVisibility, type TLGlobalAssetPropsMap, type TLGlobalBindingPropsMap, type TLGlobalRecordPropsMap, type TLGlobalShapePropsMap, type TLGridProps, type TLGridStep, type TLHandleDragInfo, type TLHandleType, type TLHistoryBatchOptions, type TLHistoryDiff, type TLHistoryEntry, type TLHistoryMark, type TLHistoryRecordingMode, type TLImageExportOptions, type TLIndexedAssets, type TLIndexedBindings, type TLIndexedRecords, type TLIndexedShapes, type TLIndicatorContext, type TLIndicatorHost, type TLIndicatorOverlay, type TLIndicatorPath, type TLIndicatorPathResult, type TLIndicatorTransform, type TLInstancePresenceID, type TLInteractionEndPerfEvent, type TLInteractionStartPerfEvent, type TLInterpolationProgress, type TLInterruptEvent, type TLKeyboardEvent, type TLLineShapeSplineStyle, type TLLoadSessionStateSnapshotOptions, type TLLoadSnapshotOptions, type TLMeasureTextOpts, type TLMeasureTextSpanOpts, type TLMeasuredTextSize, type TLMenus, type TLOpacityType, type TLOverlay, type TLOverlayDisplayValuesSource, type TLOverlayEntry, type TLOverlayUtilConstructor, TLPOINTER_ID, type TLPerfEventMap, type TLPerfFrameTimeStats, type TLPerfLongAnimationFrame, type TLPerfLongAnimationFrameScript, type TLPinchEvent, type TLPinchEventName, type TLPointInShapeOptions, type TLPointer, type TLPointerEvent, type TLPointerEventTarget, type TLPointerId, type TLPointerInfo, type TLPresenceStateInfo, type TLReactiveEnvironment, type TLRegisteredAsset, type TLRemovedDefaultThemeColors, type TLRenderingShape, type TLResettableEditor, type TLResizeHandle, type TLResizeMode, type TLRichTextFontSource, type TLRuntime, type TLSchema, type TLScribbleState, type TLSessionPageState, type TLSessionStateSnapshot, type TLShapeCrop, type TLShapeErrorFallbackComponent, type TLShapeIndicatorOptions, type TLShapeOperationPerfEvent, type TLShapeUtilCanBeLaidOutOpts, type TLShapeUtilCanBindOpts, type TLShapeUtilCanvasSvgDef, type TLShapeVisibility, type TLShapeWrapperProps, type TLShapeWrapperSlotProps, type TLSharedOpacity, type TLStoreBaseOptions, type TLStoreEventInfo, type TLStoreOptions, type TLStoreProps, type TLStoreSchemaOptions, type TLStoreWithStatus, type TLStyledShape, type TLStyledShapeProps, type TLSvgExportContext, type TLSvgTextExternalContent, type TLTemporaryAssetPreview, type TLTextExternalContent, type TLTextExternalContentSource, type TLTextOptions, type TLTextSpan, type TLTheme, type TLThemeColors, type TLThemeDefaultColors, type TLThemeFont, type TLThemeFonts, type TLThemeHost, type TLThemeId, type TLThemePatch, type TLThemeUiColorKeys, type TLThemes, type TLThemesInput, type TLTickEvent, type TLTime, type TLTimeContext, type TLTldrawExternalContent, type TLTldrawExternalContentSource, type TLUiActionItem, type TLUiActionsBuilder, type TLUiActionsContextType, type TLUiAssetUrls, type TLUiComponentSlot, type TLUiEventSource, type TLUiOverrideHelpers, type TLUiOverrides, type TLUiToolItem, type TLUiToolsBuilder, type TLUiToolsContextType, type TLUiTranslations, type TLUndoRedoPerfEvent, type TLUnknownAsset, type TLUpdatePointerOptions, type TLUrlExternalAsset, type TLUrlExternalContent, type TLWheelEvent, TL_CANVAS_UI_COLOR_TYPES, TL_CURSOR_TYPES, TL_HANDLE_TYPES, TL_SCRIBBLE_STATES, type DefaultTextAlignStyle$1 as TextAlignValue, TextManager, type TextureInfo, type TextureLoader, TextureManager, type TextureManagerOptions, type TextureOptions, type TextureSource, type TextureState, type ThemeColor, ThemeManager, type ThemeManagerOptions, type TickEventInfo, Timers, type TiptapEditor, type TiptapNode, type TldrawEditorBaseProps, type TldrawEditorProps, type TldrawEditorWithStoreProps, type TldrawEditorWithoutStoreProps, type TldrawOptions, TransformedGeometry2d, type TransformedGeometry2dOptions, type TranslateInfo, type TypeOf, UNKNOWN_EDIT_START_INFO, USER_PREFERENCES_DEFAULTS, type UiEvent, type UiEventType, UnionValidator, type UnionValidatorConfig, type UnknownBinding, type UnknownCustomRecord, type UnknownPropsPolicy, type UnknownRecordProps, type UnknownShape, type UseCurrentUserOptions, type User, type UserId, type UserPreferences, type UserPreferencesInit, UserPreferencesManager, type UserPreferencesState, type UserRecordId, UserRecordType, type UserSchemaInfo, type UserStore, type DefaultVerticalAlignStyle$1 as VAlignValue, type Validatable, ValidationError, type ValidationLibrary, type ValidationPathSegment, Validator, Vec, type VecLike, type VecModel, type VideoAsset, type VideoAssetProps, WebGL2Backend, type WheelEventInfo, angleDistance, animateShape, animateShapes, applyThemePatch, approximately, areAnglesCompatible, arrowBindingVersions, assetIdValidator, assetMigrations, assetPropsMigrationSequenceId, assetValidator, assetValidators, average, b64Vecs, bindingIdValidator, bindingPropsMigrationSequenceId, bookmarkAssetMigrations, bookmarkAssetProps, bookmarkAssetPropsValidator, bookmarkAssetValidator, boundsIndicatorPath, boxModelValidator, bucketTextureResolution, canBindShapes, canBuildIndicatorPaths, canCreateShape, canCreateShapes, canCropShape, canEditShape, canonicalizeRotation, canvasUiColorTypeValidator, centerOfCircleFromThreePoints, clamp, clampRadians, clockwiseAngleDist, commentAnchorValidator, commentReactionRecordConfig, commentReactionValidator, commentRecordConfig, commentSchemaRecords, commentThreadRecordConfig, commentThreadValidator, commentValidator, compressLegacySegments, coreShapes, counterClockwiseAngleDist, createAssetId, createAssetPropsMigrationIds, createAssetPropsMigrationSequence, createAssetPropsValidator, createAssetValidator, createBackend, createBaseAssetValidator, createBaseBindingValidator, createBaseShapeValidator, createBindingId, createBindingPropsMigrationIds, createBindingPropsMigrationSequence, createBindingValidator, createBuiltInAssetPropsMigrationIds, createBuiltInBindingPropsMigrationIds, createBuiltInShapePropsMigrationIds, createCachedUserResolve, createComment, createCommentId, createCommentReaction, createCommentReactionId, createCommentThread, createCommentThreadId, createCurrentUser, createCustomRecord, createCustomRecordId, createCustomRecordMigrationIds, createCustomRecordMigrationSequence, createCustomRecordMigrationSequences, createCustomRecordType, createCustomRecordTypeMap, createCustomRecordValidator, createDeepLinkString, createInMemoryAssetStore, createMemoryUserStore, createPresenceStateDerivation, createPropsMigrationSequences, createRootState, createSchema, createSessionStateSnapshotSignal, createShapeId, createShapePropsMigrationIds, createShapePropsMigrationSequence, createShapeValidator, createStore, createTLCurrentUser, createTLSchemaFromUtils, createTheme, createUserId, createUserPreferences, createUserRecordType, cursorTypeValidator, cursorValidator, customRecordMigrationSequenceId, dataUrlToFile, decodeDrawSegmentPath, defaultAssetMigrations, defaultAssetSchemas, defaultBindingSchemas, defaultShapeSchemas, defaultTldrawOptions, defaultUserPreferences, defaultUserStore, degreesToRadians, deselect, drawShapeSegmentValidator, dropShapesOnFrameLike, duplicatePage, easeInOutCubic, fileToBase64DataUrl, fileToDataUrl, findCommonAncestor, findShapeAncestor, fontKey, formatValidationPath, getArcMeasure, getAssetSrc, getBaseZoomForCameraOptions, getCameraCssVars, getColorNamesFromThemes, getColorValue, getCulledShapes, getCurrentPageRenderingShapesSorted, getCurrentPageShapesInReadingOrder, getCursor, getCustomRecordIdType, getDefaultAssetContext, getDefaultCdnBaseUrl, getDefaultCrop, getDefaultDisplayValues, getDefaultUserPresence, getDefaultUserProperties, getDisplayValues, getDroppedShapesToNewParents, getEngineProvider, getExportImplementation, getFocusedGroup, getFocusedGroupId, getFontNamesFromThemes, getFontsFromRichText, getFrameLikeDropTarget, getFreshUserPreferences, getHandleHitRadius, getIncrementedName, getIndicatorSource, getInitialMetaForShape, getLocaleChain, getNearestAdjacentShape, getNotVisibleShapes, getOnlySelectedShapeId, getOverlayDisplayValues, getOwnerDocument, getOwnerWindow, getPageStates, getPaletteEntries, getPerfectDashProps, getPointInArcT, getPointOnCircle, getPointerInfo, getPointsOnArc, getPolygonVertices, getRenderingShapes, getSelectedShapeAtPoint, getSelectionHandlePositions, getSelectionRotatedPageBounds, getSelectionRotatedScreenBounds, getSelectionScreenBounds, getSessionStateSnapshot, getSessionStateSnapshotFromStore, getShapeAndDescendantIds, getShapeClipPath, getShapeHandles, getShapeIdsInsideBounds, getShapeIndicatorNode, getShapeIndicatorPath, getShapeMaskedPageBounds, getShapeStyleIfExists, getShapesPageBounds, getSharedOpacity, getSnapshot, getStylePropsOf, getSvgAsImage, getSvgPathFromPoints, getTextMeasureProvider, getThemeCssVars, getUncroppedSize, getUserPreferences, handleTypeValidator, hardReset, hardResetEditor, hasAncestor, hexToRgba, hitTestSelectionBounds, hitTestSelectionHandles, idValidator, imageAssetMigrations, imageAssetProps, imageAssetPropsValidator, imageAssetValidator, inlineBase64AssetStore, intersectCircleCircle, intersectCirclePolygon, intersectCirclePolyline, intersectLineSegmentCircle, intersectLineSegmentLineSegment, intersectLineSegmentPolygon, intersectLineSegmentPolyline, intersectPolygonBounds, intersectPolygonPolygon, isAncestorSelected, isAsset, isAssetId, isBinding, isBindingId, isCommentId, isCommentReactionId, isCommentThreadId, isCursorInViewport, isCustomRecord, isCustomRecordId, isDocument, isFullCrop, isInstancePresenceId, isOptionalValidator, isPage, isPageId, isPointInShape, isPropsMigrations, isSafeFloat, isShape, isShapeHidden, isShapeId, isShapeInPage, isUserId, isValidProps, kickoutOccludedShapes, lerp, linesIntersect, loadSessionStateSnapshotIntoStore, loadSnapshot, loopToHtmlElement, maybeSnapToGrid, mixHexColors, moveElementInto, moveShapesToPage, normalizeIndicatorPath, normalizeLoadedRecords, noteReactivePointerType, opacityValidator, openWindow, packShapes, pageIdValidator, parentIdValidator, parseDeepLinkString, perimeterOfEllipse, pointInPolygon, pointerValidator, polygonIntersectsPolyline, polygonsIntersect, popFocusedGroupId, precise, prefixError, preventDefault, radiansToDegrees, randomPresenceColor, rangeIntersection, refreshPage, refreshReactiveEnvironment, registerColorsFromThemes, registerCoreShape, registerDefaultAssetSchema, registerDefaultBindingSchema, registerDefaultShapeSchema, registerEngineProvider, registerExportImplementation, registerFontsFromThemes, registerTextMeasureImplementation, releasePointerCapture, resizeBox, resizeScaled, resizeToBounds, resolveAssetUrl, resolveLineHeightPx, resolveShape, resolveThemes, resolveUiMessage, richTextToPlainText, rootBindingMigrations, rootShapeMigrations, rotateSelectionHandle, runtime, sanitizeId, scribbleValidator, selectAdjacentShape, selectFirstChildShape, selectParentShape, setDefaultCdnBaseUrl, setFocusedGroup, setOpacityForNextShapes, setOpacityForSelectedShapes, setPointerCapture, setRuntimeOverrides, setUserPreferences, shapeIdValidator, shapePropsMigrationSequenceId, shortAngleDist, snapAngle, stopEventPropagation, strokeShapeIndicators, suffixSafeId, tleditors, tlenv, tlenvReactive, tlmenus, tltime, toCustomRecordMigrationSequence, toDomPrecision, toFixed, toMigrationSequence, toPrecision, trackPointer, uniq, updatePage, useActions, useAssetUrls, useCameraCssVars, useColorMode, useContainer, useContainerIfExists, useCurrentTheme, useCurrentUser, useDelaySvgExport, useEditor, useEditorComponents, useEditorPortalHost, useGlobalMenuIsOpen, useIsCropping, useIsEditing, useIsToolSelected, useMaybeEditor, useMocanvasUi, usePassThroughWheelEvents, useSharedSafeId, useSvgExportContext, useTLSchemaFromUtils, useTLStore, useThemeColors, useThemeCssVars, useTools, useTransform, useUniqueSafeId, useViewportHeight, userIdValidator, userPreferencesValidator, userTypeValidator, userValidator, validateCustomRecordInfos, validateProps, vecModelValidator, videoAssetMigrations, videoAssetProps, videoAssetValidator, visitDescendants, warnOnce, withCoreShapes };