@tldraw/tlschema 4.3.0-canary.fd6b7f2a8adc → 4.3.0-next.085293d79c32

package/dist-cjs/index.d.ts

@@ -210,6 +210,7 @@ export declare const arrowShapeVersions: {
     readonly AddLabelColor: "com.tldraw.shape.arrow/1";
     readonly AddLabelPosition: "com.tldraw.shape.arrow/3";
     readonly AddRichText: "com.tldraw.shape.arrow/7";
+    readonly AddRichTextAttrs: "com.tldraw.shape.arrow/8";
     readonly AddScale: "com.tldraw.shape.arrow/5";
     readonly ExtractBindings: "com.tldraw.shape.arrow/4";
 };
@@ -299,6 +300,63 @@ export declare const AssetRecordType: RecordType<TLAsset, "props" | "type">;
  */
 export declare const assetValidator: T.Validator<TLAsset>;
 
+/**
+ * Utilities for encoding and decoding points using base64 and Float16 encoding.
+ * Provides functions for converting between VecModel arrays and compact base64 strings,
+ * as well as individual point encoding/decoding operations.
+ *
+ * @public
+ */
+export declare class b64Vecs {
+    /* Excluded from this release type: _legacyEncodePoint */
+    /* Excluded from this release type: _legacyEncodePoints */
+    /* Excluded from this release type: _legacyDecodePoints */
+    /**
+     * Encode an array of VecModels using delta encoding for improved precision.
+     * The first point is stored as Float32 (high precision for absolute position),
+     * subsequent points are stored as Float16 deltas from the previous point.
+     * This provides full precision for the starting position and excellent precision
+     * for deltas between consecutive points (which are typically small values).
+     *
+     * Format:
+     * - First point: 3 Float32 values = 12 bytes = 16 base64 chars
+     * - Delta points: 3 Float16 values each = 6 bytes = 8 base64 chars each
+     *
+     * @param points - An array of VecModel objects to encode
+     * @returns A base64-encoded string containing delta-encoded points
+     * @public
+     */
+    static encodePoints(points: VecModel[]): string;
+    /**
+     * Decode a delta-encoded base64 string back to an array of absolute VecModels.
+     * The first point is stored as Float32 (high precision), subsequent points are
+     * Float16 deltas that are accumulated to reconstruct absolute positions.
+     *
+     * @param base64 - The base64-encoded string containing delta-encoded point data
+     * @returns An array of VecModel objects with absolute coordinates
+     * @public
+     */
+    static decodePoints(base64: string): VecModel[];
+    /**
+     * Get the first point from a delta-encoded base64 string.
+     * The first point is stored as Float32 for full precision.
+     *
+     * @param b64Points - The delta-encoded base64 string
+     * @returns The first point as a VecModel, or null if the string is too short
+     * @public
+     */
+    static decodeFirstPoint(b64Points: string): null | VecModel;
+    /**
+     * Get the last point from a delta-encoded base64 string.
+     * Requires decoding all points to accumulate deltas.
+     *
+     * @param b64Points - The delta-encoded base64 string
+     * @returns The last point as a VecModel, or null if the string is too short
+     * @public
+     */
+    static decodeLastPoint(b64Points: string): null | VecModel;
+}
+
 /**
  * Validator for binding IDs. Ensures that binding identifiers follow the correct
  * format and type constraints required by the tldraw schema system.
@@ -426,6 +484,18 @@ export declare const CameraRecordType: RecordType<TLCamera, never>;
  */
 export declare const canvasUiColorTypeValidator: T.Validator<"accent" | "black" | "laser" | "muted-1" | "selection-fill" | "selection-stroke" | "white">;
 
+/**
+ * Compress legacy draw shape segments by converting VecModel[] points to delta-encoded base64 format.
+ * This function is useful for converting old draw shape data to the new compressed format.
+ * Uses delta encoding for improved Float16 precision.
+ *
+ * @public
+ */
+export declare function compressLegacySegments(segments: {
+    points: VecModel[];
+    type: 'free' | 'straight';
+}[]): TLDrawShapeSegment[];
+
 /**
  * Creates a validator for a specific asset record type. This factory function generates
  * a complete validator that validates the entire asset record structure including the
@@ -1398,22 +1468,7 @@ export declare const DocumentRecordType: RecordType<TLDocument, never>;
  */
 export declare const drawShapeMigrations: TLPropsMigrations;
 
-/**
- * Validation schema for draw shape properties.
- *
- * @public
- * @example
- * ```ts
- * // Validate draw shape properties
- * const props = {
- *   color: 'red',
- *   fill: 'solid',
- *   segments: [{ type: 'free', points: [] }],
- *   isComplete: true
- * }
- * const isValid = drawShapeProps.color.isValid(props.color)
- * ```
- */
+/** @public */
 export declare const drawShapeProps: RecordProps<TLDrawShape>;
 
 /**
@@ -1537,7 +1592,7 @@ export declare const GeoShapeGeoStyle: EnumStyleProp<"arrow-down" | "arrow-left"
 /**
  * Migration sequence for geo shape properties across different schema versions.
  * Handles evolution of geo shapes including URL support, label colors, alignment changes,
- * and the transition from plain text to rich text.
+ * the transition from plain text to rich text, and support for attrs property on richText.
  *
  * @public
  */
@@ -1753,20 +1808,7 @@ export declare const groupShapeProps: RecordProps<TLGroupShape>;
  */
 export declare const highlightShapeMigrations: TLPropsMigrations;
 
-/**
- * Validation schema for highlight shape properties. Defines the runtime validation rules
- * for all properties of highlight shapes.
- *
- * @public
- * @example
- * ```ts
- * import { highlightShapeProps } from '@tldraw/tlschema'
- *
- * // Used internally by the validation system
- * const validator = T.object(highlightShapeProps)
- * const validatedProps = validator.validate(someHighlightProps)
- * ```
- */
+/** @public */
 export declare const highlightShapeProps: RecordProps<TLHighlightShape>;
 
 /**
@@ -2215,7 +2257,8 @@ export declare const LineShapeSplineStyle: EnumStyleProp<"cubic" | "line">;
  * Migration sequence for note shapes. Handles schema evolution over time by defining
  * how to upgrade and downgrade note shape data between different versions. Includes
  * migrations for URL properties, text alignment changes, vertical alignment addition,
- * font size adjustments, scaling support, label color, and the transition from plain text to rich text.
+ * font size adjustments, scaling support, label color, the transition from plain text to rich text,
+ * and support for attrs property on richText.
  *
  * @public
  */
@@ -2412,6 +2455,7 @@ export declare type RecordPropsType<Config extends Record<string, T.Validatable<
  * ```
  */
 export declare const richTextValidator: T.ObjectValidator<{
+    attrs?: any;
     content: unknown[];
     type: string;
 }>;
@@ -2717,6 +2761,7 @@ export declare type StylePropValue<T extends StyleProp<any>> = T extends StylePr
  * - RemoveJustify: Replaced 'justify' alignment with 'start'
  * - AddTextAlign: Migrated from 'align' to 'textAlign' property
  * - AddRichText: Converted plain text to rich text format
+ * - AddRichTextAttrs: Added support for attrs property on richText
  *
  * @public
  */
@@ -4161,6 +4206,10 @@ export declare interface TLDrawShapeProps {
     isPen: boolean;
     /** Scale factor applied to the drawing */
     scale: number;
+    /** Horizontal scale factor for lazy resize */
+    scaleX: number;
+    /** Vertical scale factor for lazy resize */
+    scaleY: number;
 }
 
 /**
@@ -4171,8 +4220,11 @@ export declare interface TLDrawShapeProps {
 export declare interface TLDrawShapeSegment {
     /** Type of drawing segment - 'free' for freehand curves, 'straight' for line segments */
     type: 'free' | 'straight';
-    /** Array of points defining the segment path with x, y coordinates and pressure (z) */
-    points: VecModel[];
+    /**
+     * Delta-encoded base64 path data.
+     * First point stored as Float32 (12 bytes) for precision, subsequent points as Float16 deltas (6 bytes each).
+     */
+    path: string;
 }
 
 /**
@@ -4543,6 +4595,10 @@ export declare interface TLHighlightShapeProps {
     isPen: boolean;
     /** Scale factor applied to the highlight shape for display */
     scale: number;
+    /** Horizontal scale factor for lazy resize */
+    scaleX: number;
+    /** Vertical scale factor for lazy resize */
+    scaleY: number;
 }
 
 /**

package/dist-cjs/index.js

@@ -62,11 +62,13 @@ __export(index_exports, {
   assetIdValidator: () => import_TLBaseAsset.assetIdValidator,
   assetMigrations: () => import_TLAsset.assetMigrations,
   assetValidator: () => import_TLAsset.assetValidator,
+  b64Vecs: () => import_b64Vecs.b64Vecs,
   bindingIdValidator: () => import_TLBaseBinding.bindingIdValidator,
   bookmarkShapeMigrations: () => import_TLBookmarkShape.bookmarkShapeMigrations,
   bookmarkShapeProps: () => import_TLBookmarkShape.bookmarkShapeProps,
   boxModelValidator: () => import_geometry_types.boxModelValidator,
   canvasUiColorTypeValidator: () => import_TLColor.canvasUiColorTypeValidator,
+  compressLegacySegments: () => import_TLDrawShape.compressLegacySegments,
   createAssetValidator: () => import_TLBaseAsset.createAssetValidator,
   createBindingId: () => import_TLBinding.createBindingId,
   createBindingPropsMigrationIds: () => import_TLBinding.createBindingPropsMigrationIds,
@@ -176,9 +178,10 @@ var import_TLSizeStyle = require("./styles/TLSizeStyle");
 var import_TLTextAlignStyle = require("./styles/TLTextAlignStyle");
 var import_TLVerticalAlignStyle = require("./styles/TLVerticalAlignStyle");
 var import_translations = require("./translations/translations");
+var import_b64Vecs = require("./misc/b64Vecs");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/tlschema",
-  "4.3.0-canary.fd6b7f2a8adc",
+  "4.3.0-next.085293d79c32",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * @fileoverview\n * Main entry point for the tldraw schema package. Exports the complete type system,\n * data structures, validation, and migrations for tldraw's persisted data.\n *\n * This package provides:\n * - Schema creation utilities (createTLSchema, defaultShapeSchemas, defaultBindingSchemas)\n * - All built-in shape types (TLGeoShape, TLTextShape, TLArrowShape, etc.)\n * - Asset management types and validators (TLImageAsset, TLVideoAsset, TLBookmarkAsset)\n * - Binding system for shape relationships (TLArrowBinding)\n * - Store integration types (TLStore, TLStoreProps, TLStoreSnapshot)\n * - Style properties for consistent styling (DefaultColorStyle, DefaultSizeStyle, etc.)\n * - Validation utilities and type guards\n * - Migration systems for schema evolution\n * - Geometry and utility types\n *\n * @example\n * ```ts\n * import { createTLSchema, defaultShapeSchemas, TLStore } from '@tldraw/tlschema'\n *\n * // Create a schema with default shapes\n * const schema = createTLSchema({\n *   shapes: defaultShapeSchemas\n * })\n *\n * // Use with a store\n * const store = new Store({ schema })\n * ```\n *\n * @public\n */\n\nimport { registerTldrawLibraryVersion } from '@tldraw/utils'\nexport { assetIdValidator, createAssetValidator, type TLBaseAsset } from './assets/TLBaseAsset'\nexport { type TLBookmarkAsset } from './assets/TLBookmarkAsset'\nexport { type TLImageAsset } from './assets/TLImageAsset'\nexport { type TLVideoAsset } from './assets/TLVideoAsset'\nexport {\n\tarrowBindingMigrations,\n\tarrowBindingProps,\n\tarrowBindingVersions,\n\tElbowArrowSnap,\n\ttype TLArrowBinding,\n\ttype TLArrowBindingProps,\n} from './bindings/TLArrowBinding'\nexport {\n\tbindingIdValidator,\n\tcreateBindingValidator,\n\ttype TLBaseBinding,\n} from './bindings/TLBaseBinding'\nexport {\n\tcreatePresenceStateDerivation,\n\tgetDefaultUserPresence,\n\ttype TLPresenceStateInfo,\n\ttype TLPresenceUserInfo,\n} from './createPresenceStateDerivation'\nexport {\n\tcreateTLSchema,\n\tdefaultBindingSchemas,\n\tdefaultShapeSchemas,\n\ttype SchemaPropsInfo,\n\ttype TLSchema,\n} from './createTLSchema'\nexport {\n\tboxModelValidator,\n\tvecModelValidator,\n\ttype BoxModel,\n\ttype VecModel,\n} from './misc/geometry-types'\nexport { idValidator } from './misc/id-validator'\nexport {\n\tcanvasUiColorTypeValidator,\n\tTL_CANVAS_UI_COLOR_TYPES,\n\ttype TLCanvasUiColor,\n} from './misc/TLColor'\nexport { TL_CURSOR_TYPES, type TLCursor, type TLCursorType } from './misc/TLCursor'\nexport { TL_HANDLE_TYPES, type TLHandle, type TLHandleType } from './misc/TLHandle'\nexport { opacityValidator, type TLOpacityType } from './misc/TLOpacity'\nexport { richTextValidator, toRichText, type TLRichText } from './misc/TLRichText'\nexport { scribbleValidator, TL_SCRIBBLE_STATES, type TLScribble } from './misc/TLScribble'\nexport {\n\tassetMigrations,\n\tAssetRecordType,\n\tassetValidator,\n\ttype TLAsset,\n\ttype TLAssetId,\n\ttype TLAssetPartial,\n\ttype TLAssetShape,\n} from './records/TLAsset'\nexport {\n\tcreateBindingId,\n\tcreateBindingPropsMigrationIds,\n\tcreateBindingPropsMigrationSequence,\n\tisBinding,\n\tisBindingId,\n\trootBindingMigrations,\n\ttype TLBinding,\n\ttype TLBindingCreate,\n\ttype TLBindingId,\n\ttype TLBindingUpdate,\n\ttype TLDefaultBinding,\n\ttype TLGlobalBindingPropsMap,\n\ttype TLIndexedBindings,\n\ttype TLUnknownBinding,\n} from './records/TLBinding'\nexport { CameraRecordType, type TLCamera, type TLCameraId } from './records/TLCamera'\nexport {\n\tDocumentRecordType,\n\tisDocument,\n\tTLDOCUMENT_ID,\n\ttype TLDocument,\n} from './records/TLDocument'\nexport {\n\tpluckPreservingValues,\n\tTLINSTANCE_ID,\n\ttype TLInstance,\n\ttype TLInstanceId,\n} from './records/TLInstance'\nexport {\n\tisPageId,\n\tpageIdValidator,\n\tPageRecordType,\n\ttype TLPage,\n\ttype TLPageId,\n} from './records/TLPage'\nexport {\n\tInstancePageStateRecordType,\n\ttype TLInstancePageState,\n\ttype TLInstancePageStateId,\n} from './records/TLPageState'\nexport {\n\tPointerRecordType,\n\tTLPOINTER_ID,\n\ttype TLPointer,\n\ttype TLPointerId,\n} from './records/TLPointer'\nexport {\n\tInstancePresenceRecordType,\n\ttype TLInstancePresence,\n\ttype TLInstancePresenceID,\n} from './records/TLPresence'\nexport { type TLRecord } from './records/TLRecord'\nexport {\n\tcreateShapeId,\n\tcreateShapePropsMigrationIds,\n\tcreateShapePropsMigrationSequence,\n\tgetShapePropKeysByStyle,\n\tisShape,\n\tisShapeId,\n\trootShapeMigrations,\n\ttype ExtractShapeByProps,\n\ttype TLCreateShapePartial,\n\ttype TLDefaultShape,\n\ttype TLGlobalShapePropsMap,\n\ttype TLIndexedShapes,\n\ttype TLParentId,\n\ttype TLShape,\n\ttype TLShapeId,\n\ttype TLShapePartial,\n\ttype TLUnknownShape,\n} from './records/TLShape'\nexport {\n\ttype RecordProps,\n\ttype RecordPropsType,\n\ttype TLPropsMigration,\n\ttype TLPropsMigrations,\n} from './recordsWithProps'\nexport { type ShapeWithCrop, type TLShapeCrop } from './shapes/ShapeWithCrop'\nexport {\n\tArrowShapeArrowheadEndStyle,\n\tArrowShapeArrowheadStartStyle,\n\tArrowShapeKindStyle,\n\tarrowShapeMigrations,\n\tarrowShapeProps,\n\tarrowShapeVersions,\n\ttype TLArrowShape,\n\ttype TLArrowShapeArrowheadStyle,\n\ttype TLArrowShapeKind,\n\ttype TLArrowShapeProps,\n} from './shapes/TLArrowShape'\nexport {\n\tcreateShapeValidator,\n\tparentIdValidator,\n\tshapeIdValidator,\n\ttype TLBaseShape,\n} from './shapes/TLBaseShape'\nexport {\n\tbookmarkShapeMigrations,\n\tbookmarkShapeProps,\n\ttype TLBookmarkShape,\n\ttype TLBookmarkShapeProps,\n} from './shapes/TLBookmarkShape'\nexport {\n\tdrawShapeMigrations,\n\tdrawShapeProps,\n\ttype TLDrawShape,\n\ttype TLDrawShapeProps,\n\ttype TLDrawShapeSegment,\n} from './shapes/TLDrawShape'\nexport {\n\tembedShapeMigrations,\n\tembedShapeProps,\n\ttype TLEmbedShape,\n\ttype TLEmbedShapeProps,\n} from './shapes/TLEmbedShape'\nexport {\n\tframeShapeMigrations,\n\tframeShapeProps,\n\ttype TLFrameShape,\n\ttype TLFrameShapeProps,\n} from './shapes/TLFrameShape'\nexport {\n\tGeoShapeGeoStyle,\n\tgeoShapeMigrations,\n\tgeoShapeProps,\n\ttype TLGeoShape,\n\ttype TLGeoShapeGeoStyle,\n\ttype TLGeoShapeProps,\n} from './shapes/TLGeoShape'\nexport {\n\tgroupShapeMigrations,\n\tgroupShapeProps,\n\ttype TLGroupShape,\n\ttype TLGroupShapeProps,\n} from './shapes/TLGroupShape'\nexport {\n\thighlightShapeMigrations,\n\thighlightShapeProps,\n\ttype TLHighlightShape,\n\ttype TLHighlightShapeProps,\n} from './shapes/TLHighlightShape'\nexport {\n\tImageShapeCrop,\n\timageShapeMigrations,\n\timageShapeProps,\n\ttype TLImageShape,\n\ttype TLImageShapeProps,\n} from './shapes/TLImageShape'\nexport {\n\tlineShapeMigrations,\n\tlineShapeProps,\n\tLineShapeSplineStyle,\n\ttype TLLineShape,\n\ttype TLLineShapePoint,\n\ttype TLLineShapeProps,\n\ttype TLLineShapeSplineStyle,\n} from './shapes/TLLineShape'\nexport {\n\tnoteShapeMigrations,\n\tnoteShapeProps,\n\ttype TLNoteShape,\n\ttype TLNoteShapeProps,\n} from './shapes/TLNoteShape'\nexport {\n\ttextShapeMigrations,\n\ttextShapeProps,\n\ttype TLTextShape,\n\ttype TLTextShapeProps,\n} from './shapes/TLTextShape'\nexport {\n\tvideoShapeMigrations,\n\tvideoShapeProps,\n\ttype TLVideoShape,\n\ttype TLVideoShapeProps,\n} from './shapes/TLVideoShape'\nexport { EnumStyleProp, StyleProp, type StylePropValue } from './styles/StyleProp'\nexport {\n\tdefaultColorNames,\n\tDefaultColorStyle,\n\tDefaultColorThemePalette,\n\tDefaultLabelColorStyle,\n\tgetColorValue,\n\tgetDefaultColorTheme,\n\ttype TLDefaultColorStyle,\n\ttype TLDefaultColorTheme,\n\ttype TLDefaultColorThemeColor,\n} from './styles/TLColorStyle'\nexport { DefaultDashStyle, type TLDefaultDashStyle } from './styles/TLDashStyle'\nexport { DefaultFillStyle, type TLDefaultFillStyle } from './styles/TLFillStyle'\nexport {\n\tDefaultFontFamilies,\n\tDefaultFontStyle,\n\ttype TLDefaultFontStyle,\n} from './styles/TLFontStyle'\nexport {\n\tDefaultHorizontalAlignStyle,\n\ttype TLDefaultHorizontalAlignStyle,\n} from './styles/TLHorizontalAlignStyle'\nexport { DefaultSizeStyle, type TLDefaultSizeStyle } from './styles/TLSizeStyle'\nexport { DefaultTextAlignStyle, type TLDefaultTextAlignStyle } from './styles/TLTextAlignStyle'\nexport {\n\tDefaultVerticalAlignStyle,\n\ttype TLDefaultVerticalAlignStyle,\n} from './styles/TLVerticalAlignStyle'\nexport {\n\ttype TLAssetContext,\n\ttype TLAssetStore,\n\ttype TLSerializedStore,\n\ttype TLStore,\n\ttype TLStoreProps,\n\ttype TLStoreSchema,\n\ttype TLStoreSnapshot,\n} from './TLStore'\nexport {\n\tgetDefaultTranslationLocale,\n\tLANGUAGES,\n\ttype TLLanguage,\n} from './translations/translations'\nexport { type SetValue } from './util-types'\n\nregisterTldrawLibraryVersion(\n\t(globalThis as any).TLDRAW_LIBRARY_NAME,\n\t(globalThis as any).TLDRAW_LIBRARY_VERSION,\n\t(globalThis as any).TLDRAW_LIBRARY_MODULES\n)\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,mBAA6C;AAC7C,yBAAyE;AAIzE,4BAOO;AACP,2BAIO;AACP,2CAKO;AACP,4BAMO;AACP,4BAKO;AACP,0BAA4B;AAC5B,qBAIO;AACP,sBAAkE;AAClE,sBAAkE;AAClE,uBAAqD;AACrD,wBAA+D;AAC/D,wBAAuE;AACvE,qBAQO;AACP,uBAeO;AACP,sBAAiE;AACjE,wBAKO;AACP,wBAKO;AACP,oBAMO;AACP,yBAIO;AACP,uBAKO;AACP,wBAIO;AAEP,qBAkBO;AAQP,0BAWO;AACP,yBAKO;AACP,6BAKO;AACP,yBAMO;AACP,0BAKO;AACP,0BAKO;AACP,wBAOO;AACP,0BAKO;AACP,8BAKO;AACP,0BAMO;AACP,yBAQO;AACP,yBAKO;AACP,yBAKO;AACP,0BAKO;AACP,uBAA8D;AAC9D,0BAUO;AACP,yBAA0D;AAC1D,yBAA0D;AAC1D,yBAIO;AACP,oCAGO;AACP,yBAA0D;AAC1D,8BAAoE;AACpE,kCAGO;AAUP,0BAIO;AAAA,IAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["/**\n * @fileoverview\n * Main entry point for the tldraw schema package. Exports the complete type system,\n * data structures, validation, and migrations for tldraw's persisted data.\n *\n * This package provides:\n * - Schema creation utilities (createTLSchema, defaultShapeSchemas, defaultBindingSchemas)\n * - All built-in shape types (TLGeoShape, TLTextShape, TLArrowShape, etc.)\n * - Asset management types and validators (TLImageAsset, TLVideoAsset, TLBookmarkAsset)\n * - Binding system for shape relationships (TLArrowBinding)\n * - Store integration types (TLStore, TLStoreProps, TLStoreSnapshot)\n * - Style properties for consistent styling (DefaultColorStyle, DefaultSizeStyle, etc.)\n * - Validation utilities and type guards\n * - Migration systems for schema evolution\n * - Geometry and utility types\n *\n * @example\n * ```ts\n * import { createTLSchema, defaultShapeSchemas, TLStore } from '@tldraw/tlschema'\n *\n * // Create a schema with default shapes\n * const schema = createTLSchema({\n *   shapes: defaultShapeSchemas\n * })\n *\n * // Use with a store\n * const store = new Store({ schema })\n * ```\n *\n * @public\n */\n\nimport { registerTldrawLibraryVersion } from '@tldraw/utils'\nexport { assetIdValidator, createAssetValidator, type TLBaseAsset } from './assets/TLBaseAsset'\nexport { type TLBookmarkAsset } from './assets/TLBookmarkAsset'\nexport { type TLImageAsset } from './assets/TLImageAsset'\nexport { type TLVideoAsset } from './assets/TLVideoAsset'\nexport {\n\tarrowBindingMigrations,\n\tarrowBindingProps,\n\tarrowBindingVersions,\n\tElbowArrowSnap,\n\ttype TLArrowBinding,\n\ttype TLArrowBindingProps,\n} from './bindings/TLArrowBinding'\nexport {\n\tbindingIdValidator,\n\tcreateBindingValidator,\n\ttype TLBaseBinding,\n} from './bindings/TLBaseBinding'\nexport {\n\tcreatePresenceStateDerivation,\n\tgetDefaultUserPresence,\n\ttype TLPresenceStateInfo,\n\ttype TLPresenceUserInfo,\n} from './createPresenceStateDerivation'\nexport {\n\tcreateTLSchema,\n\tdefaultBindingSchemas,\n\tdefaultShapeSchemas,\n\ttype SchemaPropsInfo,\n\ttype TLSchema,\n} from './createTLSchema'\nexport {\n\tboxModelValidator,\n\tvecModelValidator,\n\ttype BoxModel,\n\ttype VecModel,\n} from './misc/geometry-types'\nexport { idValidator } from './misc/id-validator'\nexport {\n\tcanvasUiColorTypeValidator,\n\tTL_CANVAS_UI_COLOR_TYPES,\n\ttype TLCanvasUiColor,\n} from './misc/TLColor'\nexport { TL_CURSOR_TYPES, type TLCursor, type TLCursorType } from './misc/TLCursor'\nexport { TL_HANDLE_TYPES, type TLHandle, type TLHandleType } from './misc/TLHandle'\nexport { opacityValidator, type TLOpacityType } from './misc/TLOpacity'\nexport { richTextValidator, toRichText, type TLRichText } from './misc/TLRichText'\nexport { scribbleValidator, TL_SCRIBBLE_STATES, type TLScribble } from './misc/TLScribble'\nexport {\n\tassetMigrations,\n\tAssetRecordType,\n\tassetValidator,\n\ttype TLAsset,\n\ttype TLAssetId,\n\ttype TLAssetPartial,\n\ttype TLAssetShape,\n} from './records/TLAsset'\nexport {\n\tcreateBindingId,\n\tcreateBindingPropsMigrationIds,\n\tcreateBindingPropsMigrationSequence,\n\tisBinding,\n\tisBindingId,\n\trootBindingMigrations,\n\ttype TLBinding,\n\ttype TLBindingCreate,\n\ttype TLBindingId,\n\ttype TLBindingUpdate,\n\ttype TLDefaultBinding,\n\ttype TLGlobalBindingPropsMap,\n\ttype TLIndexedBindings,\n\ttype TLUnknownBinding,\n} from './records/TLBinding'\nexport { CameraRecordType, type TLCamera, type TLCameraId } from './records/TLCamera'\nexport {\n\tDocumentRecordType,\n\tisDocument,\n\tTLDOCUMENT_ID,\n\ttype TLDocument,\n} from './records/TLDocument'\nexport {\n\tpluckPreservingValues,\n\tTLINSTANCE_ID,\n\ttype TLInstance,\n\ttype TLInstanceId,\n} from './records/TLInstance'\nexport {\n\tisPageId,\n\tpageIdValidator,\n\tPageRecordType,\n\ttype TLPage,\n\ttype TLPageId,\n} from './records/TLPage'\nexport {\n\tInstancePageStateRecordType,\n\ttype TLInstancePageState,\n\ttype TLInstancePageStateId,\n} from './records/TLPageState'\nexport {\n\tPointerRecordType,\n\tTLPOINTER_ID,\n\ttype TLPointer,\n\ttype TLPointerId,\n} from './records/TLPointer'\nexport {\n\tInstancePresenceRecordType,\n\ttype TLInstancePresence,\n\ttype TLInstancePresenceID,\n} from './records/TLPresence'\nexport { type TLRecord } from './records/TLRecord'\nexport {\n\tcreateShapeId,\n\tcreateShapePropsMigrationIds,\n\tcreateShapePropsMigrationSequence,\n\tgetShapePropKeysByStyle,\n\tisShape,\n\tisShapeId,\n\trootShapeMigrations,\n\ttype ExtractShapeByProps,\n\ttype TLCreateShapePartial,\n\ttype TLDefaultShape,\n\ttype TLGlobalShapePropsMap,\n\ttype TLIndexedShapes,\n\ttype TLParentId,\n\ttype TLShape,\n\ttype TLShapeId,\n\ttype TLShapePartial,\n\ttype TLUnknownShape,\n} from './records/TLShape'\nexport {\n\ttype RecordProps,\n\ttype RecordPropsType,\n\ttype TLPropsMigration,\n\ttype TLPropsMigrations,\n} from './recordsWithProps'\nexport { type ShapeWithCrop, type TLShapeCrop } from './shapes/ShapeWithCrop'\nexport {\n\tArrowShapeArrowheadEndStyle,\n\tArrowShapeArrowheadStartStyle,\n\tArrowShapeKindStyle,\n\tarrowShapeMigrations,\n\tarrowShapeProps,\n\tarrowShapeVersions,\n\ttype TLArrowShape,\n\ttype TLArrowShapeArrowheadStyle,\n\ttype TLArrowShapeKind,\n\ttype TLArrowShapeProps,\n} from './shapes/TLArrowShape'\nexport {\n\tcreateShapeValidator,\n\tparentIdValidator,\n\tshapeIdValidator,\n\ttype TLBaseShape,\n} from './shapes/TLBaseShape'\nexport {\n\tbookmarkShapeMigrations,\n\tbookmarkShapeProps,\n\ttype TLBookmarkShape,\n\ttype TLBookmarkShapeProps,\n} from './shapes/TLBookmarkShape'\nexport {\n\tcompressLegacySegments,\n\tdrawShapeMigrations,\n\tdrawShapeProps,\n\ttype TLDrawShape,\n\ttype TLDrawShapeProps,\n\ttype TLDrawShapeSegment,\n} from './shapes/TLDrawShape'\nexport {\n\tembedShapeMigrations,\n\tembedShapeProps,\n\ttype TLEmbedShape,\n\ttype TLEmbedShapeProps,\n} from './shapes/TLEmbedShape'\nexport {\n\tframeShapeMigrations,\n\tframeShapeProps,\n\ttype TLFrameShape,\n\ttype TLFrameShapeProps,\n} from './shapes/TLFrameShape'\nexport {\n\tGeoShapeGeoStyle,\n\tgeoShapeMigrations,\n\tgeoShapeProps,\n\ttype TLGeoShape,\n\ttype TLGeoShapeGeoStyle,\n\ttype TLGeoShapeProps,\n} from './shapes/TLGeoShape'\nexport {\n\tgroupShapeMigrations,\n\tgroupShapeProps,\n\ttype TLGroupShape,\n\ttype TLGroupShapeProps,\n} from './shapes/TLGroupShape'\nexport {\n\thighlightShapeMigrations,\n\thighlightShapeProps,\n\ttype TLHighlightShape,\n\ttype TLHighlightShapeProps,\n} from './shapes/TLHighlightShape'\nexport {\n\tImageShapeCrop,\n\timageShapeMigrations,\n\timageShapeProps,\n\ttype TLImageShape,\n\ttype TLImageShapeProps,\n} from './shapes/TLImageShape'\nexport {\n\tlineShapeMigrations,\n\tlineShapeProps,\n\tLineShapeSplineStyle,\n\ttype TLLineShape,\n\ttype TLLineShapePoint,\n\ttype TLLineShapeProps,\n\ttype TLLineShapeSplineStyle,\n} from './shapes/TLLineShape'\nexport {\n\tnoteShapeMigrations,\n\tnoteShapeProps,\n\ttype TLNoteShape,\n\ttype TLNoteShapeProps,\n} from './shapes/TLNoteShape'\nexport {\n\ttextShapeMigrations,\n\ttextShapeProps,\n\ttype TLTextShape,\n\ttype TLTextShapeProps,\n} from './shapes/TLTextShape'\nexport {\n\tvideoShapeMigrations,\n\tvideoShapeProps,\n\ttype TLVideoShape,\n\ttype TLVideoShapeProps,\n} from './shapes/TLVideoShape'\nexport { EnumStyleProp, StyleProp, type StylePropValue } from './styles/StyleProp'\nexport {\n\tdefaultColorNames,\n\tDefaultColorStyle,\n\tDefaultColorThemePalette,\n\tDefaultLabelColorStyle,\n\tgetColorValue,\n\tgetDefaultColorTheme,\n\ttype TLDefaultColorStyle,\n\ttype TLDefaultColorTheme,\n\ttype TLDefaultColorThemeColor,\n} from './styles/TLColorStyle'\nexport { DefaultDashStyle, type TLDefaultDashStyle } from './styles/TLDashStyle'\nexport { DefaultFillStyle, type TLDefaultFillStyle } from './styles/TLFillStyle'\nexport {\n\tDefaultFontFamilies,\n\tDefaultFontStyle,\n\ttype TLDefaultFontStyle,\n} from './styles/TLFontStyle'\nexport {\n\tDefaultHorizontalAlignStyle,\n\ttype TLDefaultHorizontalAlignStyle,\n} from './styles/TLHorizontalAlignStyle'\nexport { DefaultSizeStyle, type TLDefaultSizeStyle } from './styles/TLSizeStyle'\nexport { DefaultTextAlignStyle, type TLDefaultTextAlignStyle } from './styles/TLTextAlignStyle'\nexport {\n\tDefaultVerticalAlignStyle,\n\ttype TLDefaultVerticalAlignStyle,\n} from './styles/TLVerticalAlignStyle'\nexport {\n\ttype TLAssetContext,\n\ttype TLAssetStore,\n\ttype TLSerializedStore,\n\ttype TLStore,\n\ttype TLStoreProps,\n\ttype TLStoreSchema,\n\ttype TLStoreSnapshot,\n} from './TLStore'\nexport {\n\tgetDefaultTranslationLocale,\n\tLANGUAGES,\n\ttype TLLanguage,\n} from './translations/translations'\nexport { type SetValue } from './util-types'\n\nregisterTldrawLibraryVersion(\n\t(globalThis as any).TLDRAW_LIBRARY_NAME,\n\t(globalThis as any).TLDRAW_LIBRARY_VERSION,\n\t(globalThis as any).TLDRAW_LIBRARY_MODULES\n)\n\nexport { b64Vecs } from './misc/b64Vecs'\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,mBAA6C;AAC7C,yBAAyE;AAIzE,4BAOO;AACP,2BAIO;AACP,2CAKO;AACP,4BAMO;AACP,4BAKO;AACP,0BAA4B;AAC5B,qBAIO;AACP,sBAAkE;AAClE,sBAAkE;AAClE,uBAAqD;AACrD,wBAA+D;AAC/D,wBAAuE;AACvE,qBAQO;AACP,uBAeO;AACP,sBAAiE;AACjE,wBAKO;AACP,wBAKO;AACP,oBAMO;AACP,yBAIO;AACP,uBAKO;AACP,wBAIO;AAEP,qBAkBO;AAQP,0BAWO;AACP,yBAKO;AACP,6BAKO;AACP,yBAOO;AACP,0BAKO;AACP,0BAKO;AACP,wBAOO;AACP,0BAKO;AACP,8BAKO;AACP,0BAMO;AACP,yBAQO;AACP,yBAKO;AACP,yBAKO;AACP,0BAKO;AACP,uBAA8D;AAC9D,0BAUO;AACP,yBAA0D;AAC1D,yBAA0D;AAC1D,yBAIO;AACP,oCAGO;AACP,yBAA0D;AAC1D,8BAAoE;AACpE,kCAGO;AAUP,0BAIO;AASP,qBAAwB;AAAA,IANxB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;",
   "names": []
 }

package/dist-cjs/misc/TLOpacity.js

@@ -22,9 +22,5 @@ __export(TLOpacity_exports, {
 });
 module.exports = __toCommonJS(TLOpacity_exports);
 var import_validate = require("@tldraw/validate");
-const opacityValidator = import_validate.T.number.check((n) => {
-  if (n < 0 || n > 1) {
-    throw new import_validate.T.ValidationError("Opacity must be between 0 and 1");
-  }
-});
+const opacityValidator = import_validate.T.unitInterval;
 //# sourceMappingURL=TLOpacity.js.map

package/dist-cjs/misc/TLOpacity.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/misc/TLOpacity.ts"],
-  "sourcesContent": ["import { T } from '@tldraw/validate'\n\n/**\n * A type representing opacity values in tldraw.\n *\n * Opacity values are numbers between 0 and 1, where 0 is fully transparent\n * and 1 is fully opaque. This type is used throughout the editor to control\n * the transparency of shapes, UI elements, and other visual components.\n *\n * @example\n * ```ts\n * const fullyOpaque: TLOpacityType = 1.0\n * const halfTransparent: TLOpacityType = 0.5\n * const fullyTransparent: TLOpacityType = 0.0\n * const quarterOpaque: TLOpacityType = 0.25\n * ```\n *\n * @public\n */\nexport type TLOpacityType = number\n\n/**\n * A validator for opacity values.\n *\n * This validator ensures that opacity values are numbers between 0 and 1 (inclusive).\n * Values outside this range will cause a validation error. The validator provides\n * runtime type checking for opacity properties throughout the editor.\n *\n * @param n - The number to validate as an opacity value\n * @throws T.ValidationError When the value is not between 0 and 1\n *\n * @example\n * ```ts\n * import { opacityValidator } from '@tldraw/tlschema'\n *\n * // Valid opacity values\n * try {\n *   const validOpacity1 = opacityValidator.validate(0.5) // \u2713\n *   const validOpacity2 = opacityValidator.validate(1.0) // \u2713\n *   const validOpacity3 = opacityValidator.validate(0.0) // \u2713\n * } catch (error) {\n *   console.error('Validation failed:', error.message)\n * }\n *\n * // Invalid opacity values\n * try {\n *   opacityValidator.validate(-0.1) // \u2717 Throws error\n *   opacityValidator.validate(1.5)  // \u2717 Throws error\n * } catch (error) {\n *   console.error('Invalid opacity:', error.message)\n * }\n * ```\n *\n * @public\n */\nexport const opacityValidator = T.number.check((n) => {\n\tif (n < 0 || n > 1) {\n\t\tthrow new T.ValidationError('Opacity must be between 0 and 1')\n\t}\n})\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAkB;AAuDX,MAAM,mBAAmB,kBAAE,OAAO,MAAM,CAAC,MAAM;AACrD,MAAI,IAAI,KAAK,IAAI,GAAG;AACnB,UAAM,IAAI,kBAAE,gBAAgB,iCAAiC;AAAA,EAC9D;AACD,CAAC;",
+  "sourcesContent": ["import { T } from '@tldraw/validate'\n\n/**\n * A type representing opacity values in tldraw.\n *\n * Opacity values are numbers between 0 and 1, where 0 is fully transparent\n * and 1 is fully opaque. This type is used throughout the editor to control\n * the transparency of shapes, UI elements, and other visual components.\n *\n * @example\n * ```ts\n * const fullyOpaque: TLOpacityType = 1.0\n * const halfTransparent: TLOpacityType = 0.5\n * const fullyTransparent: TLOpacityType = 0.0\n * const quarterOpaque: TLOpacityType = 0.25\n * ```\n *\n * @public\n */\nexport type TLOpacityType = number\n\n/**\n * A validator for opacity values.\n *\n * This validator ensures that opacity values are numbers between 0 and 1 (inclusive).\n * Values outside this range will cause a validation error. The validator provides\n * runtime type checking for opacity properties throughout the editor.\n *\n * @param n - The number to validate as an opacity value\n * @throws T.ValidationError When the value is not between 0 and 1\n *\n * @example\n * ```ts\n * import { opacityValidator } from '@tldraw/tlschema'\n *\n * // Valid opacity values\n * try {\n *   const validOpacity1 = opacityValidator.validate(0.5) // \u2713\n *   const validOpacity2 = opacityValidator.validate(1.0) // \u2713\n *   const validOpacity3 = opacityValidator.validate(0.0) // \u2713\n * } catch (error) {\n *   console.error('Validation failed:', error.message)\n * }\n *\n * // Invalid opacity values\n * try {\n *   opacityValidator.validate(-0.1) // \u2717 Throws error\n *   opacityValidator.validate(1.5)  // \u2717 Throws error\n * } catch (error) {\n *   console.error('Invalid opacity:', error.message)\n * }\n * ```\n *\n * @public\n */\nexport const opacityValidator = T.unitInterval\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAkB;AAuDX,MAAM,mBAAmB,kBAAE;",
   "names": []
 }

package/dist-cjs/misc/TLRichText.js

@@ -23,7 +23,11 @@ __export(TLRichText_exports, {
 });
 module.exports = __toCommonJS(TLRichText_exports);
 var import_validate = require("@tldraw/validate");
-const richTextValidator = import_validate.T.object({ type: import_validate.T.string, content: import_validate.T.arrayOf(import_validate.T.unknown) });
+const richTextValidator = import_validate.T.object({
+  type: import_validate.T.string,
+  content: import_validate.T.arrayOf(import_validate.T.unknown),
+  attrs: import_validate.T.any.optional()
+});
 function toRichText(text) {
   const lines = text.split("\n");
   const content = lines.map((text2) => {

package/dist-cjs/misc/TLRichText.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/misc/TLRichText.ts"],
-  "sourcesContent": ["import { T } from '@tldraw/validate'\n\n/**\n * Validator for TLRichText objects that ensures they have the correct structure\n * for document-based rich text content. Validates a document with a type field\n * and an array of content blocks.\n *\n * @public\n * @example\n * ```ts\n * const richText = { type: 'doc', content: [{ type: 'paragraph', content: [{ type: 'text', text: 'Hello' }] }] }\n * const isValid = richTextValidator.check(richText) // true\n * ```\n */\nexport const richTextValidator = T.object({ type: T.string, content: T.arrayOf(T.unknown) })\n\n/**\n * Type representing rich text content in tldraw. Rich text follows a document-based\n * structure with a root document containing an array of content blocks (paragraphs,\n * text nodes, etc.). This enables formatted text with support for multiple paragraphs,\n * styling, and other rich content.\n *\n * @public\n * @example\n * ```ts\n * const richText: TLRichText = {\n *   type: 'doc',\n *   content: [\n *     {\n *       type: 'paragraph',\n *       content: [{ type: 'text', text: 'Hello world!' }]\n *     }\n *   ]\n * }\n * ```\n */\nexport type TLRichText = T.TypeOf<typeof richTextValidator>\n\n/**\n * Converts a plain text string into a TLRichText object. Each line of the input\n * text becomes a separate paragraph in the rich text document. Empty lines are\n * preserved as empty paragraphs to maintain the original text structure.\n *\n * @param text - The plain text string to convert to rich text\n * @returns A TLRichText object with the text content structured as paragraphs\n * @public\n * @example\n * ```ts\n * const richText = toRichText('Hello\\nWorld')\n * // Returns:\n * // {\n * //   type: 'doc',\n * //   content: [\n * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello' }] },\n * //     { type: 'paragraph', content: [{ type: 'text', text: 'World' }] }\n * //   ]\n * // }\n *\n * const emptyLine = toRichText('Line 1\\n\\nLine 3')\n * // Creates three paragraphs, with the middle one being empty\n * ```\n */\nexport function toRichText(text: string): TLRichText {\n\tconst lines = text.split('\\n')\n\tconst content = lines.map((text) => {\n\t\tif (!text) {\n\t\t\treturn {\n\t\t\t\ttype: 'paragraph',\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\ttype: 'paragraph',\n\t\t\tcontent: [{ type: 'text', text }],\n\t\t}\n\t})\n\n\treturn {\n\t\ttype: 'doc',\n\t\tcontent,\n\t}\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAkB;AAcX,MAAM,oBAAoB,kBAAE,OAAO,EAAE,MAAM,kBAAE,QAAQ,SAAS,kBAAE,QAAQ,kBAAE,OAAO,EAAE,CAAC;AAgDpF,SAAS,WAAW,MAA0B;AACpD,QAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,QAAM,UAAU,MAAM,IAAI,CAACA,UAAS;AACnC,QAAI,CAACA,OAAM;AACV,aAAO;AAAA,QACN,MAAM;AAAA,MACP;AAAA,IACD;AAEA,WAAO;AAAA,MACN,MAAM;AAAA,MACN,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAAA,MAAK,CAAC;AAAA,IACjC;AAAA,EACD,CAAC;AAED,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;",
+  "sourcesContent": ["import { T } from '@tldraw/validate'\n\n/**\n * Validator for TLRichText objects that ensures they have the correct structure\n * for document-based rich text content. Validates a document with a type field\n * and an array of content blocks.\n *\n * @public\n * @example\n * ```ts\n * const richText = { type: 'doc', content: [{ type: 'paragraph', content: [{ type: 'text', text: 'Hello' }] }] }\n * const isValid = richTextValidator.check(richText) // true\n * ```\n */\n\nexport const richTextValidator = T.object({\n\ttype: T.string,\n\tcontent: T.arrayOf(T.unknown),\n\tattrs: T.any.optional(),\n})\n\n/**\n * Type representing rich text content in tldraw. Rich text follows a document-based\n * structure with a root document containing an array of content blocks (paragraphs,\n * text nodes, etc.). This enables formatted text with support for multiple paragraphs,\n * styling, and other rich content.\n *\n * @public\n * @example\n * ```ts\n * const richText: TLRichText = {\n *   type: 'doc',\n *   content: [\n *     {\n *       type: 'paragraph',\n *       content: [{ type: 'text', text: 'Hello world!' }]\n *     }\n *   ]\n * }\n * ```\n */\nexport type TLRichText = T.TypeOf<typeof richTextValidator>\n\n/**\n * Converts a plain text string into a TLRichText object. Each line of the input\n * text becomes a separate paragraph in the rich text document. Empty lines are\n * preserved as empty paragraphs to maintain the original text structure.\n *\n * @param text - The plain text string to convert to rich text\n * @returns A TLRichText object with the text content structured as paragraphs\n * @public\n * @example\n * ```ts\n * const richText = toRichText('Hello\\nWorld')\n * // Returns:\n * // {\n * //   type: 'doc',\n * //   content: [\n * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello' }] },\n * //     { type: 'paragraph', content: [{ type: 'text', text: 'World' }] }\n * //   ]\n * // }\n *\n * const emptyLine = toRichText('Line 1\\n\\nLine 3')\n * // Creates three paragraphs, with the middle one being empty\n * ```\n */\nexport function toRichText(text: string): TLRichText {\n\tconst lines = text.split('\\n')\n\tconst content = lines.map((text) => {\n\t\tif (!text) {\n\t\t\treturn {\n\t\t\t\ttype: 'paragraph',\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\ttype: 'paragraph',\n\t\t\tcontent: [{ type: 'text', text }],\n\t\t}\n\t})\n\n\treturn {\n\t\ttype: 'doc',\n\t\tcontent,\n\t}\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAkB;AAeX,MAAM,oBAAoB,kBAAE,OAAO;AAAA,EACzC,MAAM,kBAAE;AAAA,EACR,SAAS,kBAAE,QAAQ,kBAAE,OAAO;AAAA,EAC5B,OAAO,kBAAE,IAAI,SAAS;AACvB,CAAC;AAgDM,SAAS,WAAW,MAA0B;AACpD,QAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,QAAM,UAAU,MAAM,IAAI,CAACA,UAAS;AACnC,QAAI,CAACA,OAAM;AACV,aAAO;AAAA,QACN,MAAM;AAAA,MACP;AAAA,IACD;AAEA,WAAO;AAAA,MACN,MAAM;AAAA,MACN,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAAA,MAAK,CAAC;AAAA,IACjC;AAAA,EACD,CAAC;AAED,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;",
   "names": ["text"]
 }

package/dist-cjs/misc/b64Vecs.js

@@ -0,0 +1,310 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var b64Vecs_exports = {};
+__export(b64Vecs_exports, {
+  b64Vecs: () => b64Vecs,
+  fallbackBase64ToUint8Array: () => fallbackBase64ToUint8Array,
+  fallbackUint8ArrayToBase64: () => fallbackUint8ArrayToBase64,
+  float16BitsToNumber: () => float16BitsToNumber,
+  numberToFloat16Bits: () => numberToFloat16Bits
+});
+module.exports = __toCommonJS(b64Vecs_exports);
+var import_utils = require("@tldraw/utils");
+const _POINT_B64_LENGTH = 8;
+const FIRST_POINT_B64_LENGTH = 16;
+const BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+const B64_LOOKUP = new Uint8Array(128);
+for (let i = 0; i < 64; i++) {
+  B64_LOOKUP[BASE64_CHARS.charCodeAt(i)] = i;
+}
+const POW2 = new Float64Array(31);
+for (let i = 0; i < 31; i++) {
+  POW2[i] = Math.pow(2, i - 15);
+}
+const POW2_SUBNORMAL = Math.pow(2, -14) / 1024;
+const MANTISSA = new Float64Array(1024);
+for (let i = 0; i < 1024; i++) {
+  MANTISSA[i] = 1 + i / 1024;
+}
+function nativeGetFloat16(dataView, offset) {
+  return dataView.getFloat16(offset, true);
+}
+function fallbackGetFloat16(dataView, offset) {
+  return float16BitsToNumber(dataView.getUint16(offset, true));
+}
+const getFloat16 = typeof DataView.prototype.getFloat16 === "function" ? nativeGetFloat16 : fallbackGetFloat16;
+function nativeSetFloat16(dataView, offset, value) {
+  ;
+  dataView.setFloat16(offset, value, true);
+}
+function fallbackSetFloat16(dataView, offset, value) {
+  dataView.setUint16(offset, numberToFloat16Bits(value), true);
+}
+const setFloat16 = typeof DataView.prototype.setFloat16 === "function" ? nativeSetFloat16 : fallbackSetFloat16;
+function nativeBase64ToUint8Array(base64) {
+  return Uint8Array.fromBase64(base64);
+}
+function fallbackBase64ToUint8Array(base64) {
+  const numBytes = Math.floor(base64.length * 3 / 4);
+  const bytes = new Uint8Array(numBytes);
+  let byteIndex = 0;
+  for (let i = 0; i < base64.length; i += 4) {
+    const c0 = B64_LOOKUP[base64.charCodeAt(i)];
+    const c1 = B64_LOOKUP[base64.charCodeAt(i + 1)];
+    const c2 = B64_LOOKUP[base64.charCodeAt(i + 2)];
+    const c3 = B64_LOOKUP[base64.charCodeAt(i + 3)];
+    const bitmap = c0 << 18 | c1 << 12 | c2 << 6 | c3;
+    bytes[byteIndex++] = bitmap >> 16 & 255;
+    bytes[byteIndex++] = bitmap >> 8 & 255;
+    bytes[byteIndex++] = bitmap & 255;
+  }
+  return bytes;
+}
+function nativeUint8ArrayToBase64(uint8Array) {
+  return uint8Array.toBase64();
+}
+function fallbackUint8ArrayToBase64(uint8Array) {
+  (0, import_utils.assert)(uint8Array.length % 3 === 0, "Uint8Array length must be a multiple of 3");
+  let result = "";
+  for (let i = 0; i < uint8Array.length; i += 3) {
+    const byte1 = uint8Array[i];
+    const byte2 = uint8Array[i + 1];
+    const byte3 = uint8Array[i + 2];
+    const bitmap = byte1 << 16 | byte2 << 8 | byte3;
+    result += BASE64_CHARS[bitmap >> 18 & 63] + BASE64_CHARS[bitmap >> 12 & 63] + BASE64_CHARS[bitmap >> 6 & 63] + BASE64_CHARS[bitmap & 63];
+  }
+  return result;
+}
+const uint8ArrayToBase64 = typeof Uint8Array.prototype.toBase64 === "function" ? nativeUint8ArrayToBase64 : fallbackUint8ArrayToBase64;
+const base64ToUint8Array = typeof Uint8Array.fromBase64 === "function" ? nativeBase64ToUint8Array : fallbackBase64ToUint8Array;
+function float16BitsToNumber(bits) {
+  const sign = bits >> 15;
+  const exp = bits >> 10 & 31;
+  const frac = bits & 1023;
+  if (exp === 0) {
+    return sign ? -frac * POW2_SUBNORMAL : frac * POW2_SUBNORMAL;
+  }
+  if (exp === 31) {
+    return frac ? NaN : sign ? -Infinity : Infinity;
+  }
+  const magnitude = POW2[exp] * MANTISSA[frac];
+  return sign ? -magnitude : magnitude;
+}
+function numberToFloat16Bits(value) {
+  if (value === 0) return Object.is(value, -0) ? 32768 : 0;
+  if (!Number.isFinite(value)) {
+    if (Number.isNaN(value)) return 32256;
+    return value > 0 ? 31744 : 64512;
+  }
+  const sign = value < 0 ? 1 : 0;
+  value = Math.abs(value);
+  const exp = Math.floor(Math.log2(value));
+  let expBiased = exp + 15;
+  if (expBiased >= 31) {
+    return sign << 15 | 31744;
+  }
+  if (expBiased <= 0) {
+    const frac2 = Math.round(value * Math.pow(2, 14) * 1024);
+    return sign << 15 | frac2 & 1023;
+  }
+  const mantissa = value / Math.pow(2, exp) - 1;
+  let frac = Math.round(mantissa * 1024);
+  if (frac >= 1024) {
+    frac = 0;
+    expBiased++;
+    if (expBiased >= 31) {
+      return sign << 15 | 31744;
+    }
+  }
+  return sign << 15 | expBiased << 10 | frac;
+}
+class b64Vecs {
+  /**
+   * Encode a single point (x, y, z) to 8 base64 characters using legacy Float16 encoding.
+   * Each coordinate is encoded as a Float16 value, resulting in 6 bytes total.
+   *
+   * @param x - The x coordinate
+   * @param y - The y coordinate
+   * @param z - The z coordinate
+   * @returns An 8-character base64 string representing the point
+   * @internal
+   */
+  static _legacyEncodePoint(x, y, z) {
+    const buffer = new Uint8Array(6);
+    const dataView = new DataView(buffer.buffer);
+    setFloat16(dataView, 0, x);
+    setFloat16(dataView, 2, y);
+    setFloat16(dataView, 4, z);
+    return uint8ArrayToBase64(buffer);
+  }
+  /**
+   * Convert an array of VecModels to a base64 string using legacy Float16 encoding.
+   * Uses Float16 encoding for each coordinate (x, y, z). If a point's z value is
+   * undefined, it defaults to 0.5.
+   *
+   * @param points - An array of VecModel objects to encode
+   * @returns A base64-encoded string containing all points
+   * @internal Used only for migrations from legacy format
+   */
+  static _legacyEncodePoints(points) {
+    if (points.length === 0) return "";
+    const buffer = new Uint8Array(points.length * 6);
+    const dataView = new DataView(buffer.buffer);
+    for (let i = 0; i < points.length; i++) {
+      const p = points[i];
+      const offset = i * 6;
+      setFloat16(dataView, offset, p.x);
+      setFloat16(dataView, offset + 2, p.y);
+      setFloat16(dataView, offset + 4, p.z ?? 0.5);
+    }
+    return uint8ArrayToBase64(buffer);
+  }
+  /**
+   * Convert a legacy base64 string back to an array of VecModels.
+   * Decodes Float16-encoded coordinates (x, y, z) from the base64 string.
+   *
+   * @param base64 - The base64-encoded string containing point data
+   * @returns An array of VecModel objects decoded from the string
+   * @internal Used only for migrations from legacy format
+   */
+  static _legacyDecodePoints(base64) {
+    const bytes = base64ToUint8Array(base64);
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const result = [];
+    for (let offset = 0; offset < bytes.length; offset += 6) {
+      result.push({
+        x: getFloat16(dataView, offset),
+        y: getFloat16(dataView, offset + 2),
+        z: getFloat16(dataView, offset + 4)
+      });
+    }
+    return result;
+  }
+  /**
+   * Encode an array of VecModels using delta encoding for improved precision.
+   * The first point is stored as Float32 (high precision for absolute position),
+   * subsequent points are stored as Float16 deltas from the previous point.
+   * This provides full precision for the starting position and excellent precision
+   * for deltas between consecutive points (which are typically small values).
+   *
+   * Format:
+   * - First point: 3 Float32 values = 12 bytes = 16 base64 chars
+   * - Delta points: 3 Float16 values each = 6 bytes = 8 base64 chars each
+   *
+   * @param points - An array of VecModel objects to encode
+   * @returns A base64-encoded string containing delta-encoded points
+   * @public
+   */
+  static encodePoints(points) {
+    if (points.length === 0) return "";
+    const firstPointBytes = 12;
+    const deltaBytes = (points.length - 1) * 6;
+    const totalBytes = firstPointBytes + deltaBytes;
+    const buffer = new Uint8Array(totalBytes);
+    const dataView = new DataView(buffer.buffer);
+    const first = points[0];
+    dataView.setFloat32(0, first.x, true);
+    dataView.setFloat32(4, first.y, true);
+    dataView.setFloat32(8, first.z ?? 0.5, true);
+    let prevX = first.x;
+    let prevY = first.y;
+    let prevZ = first.z ?? 0.5;
+    for (let i = 1; i < points.length; i++) {
+      const p = points[i];
+      const z = p.z ?? 0.5;
+      const offset = firstPointBytes + (i - 1) * 6;
+      setFloat16(dataView, offset, p.x - prevX);
+      setFloat16(dataView, offset + 2, p.y - prevY);
+      setFloat16(dataView, offset + 4, z - prevZ);
+      prevX = p.x;
+      prevY = p.y;
+      prevZ = z;
+    }
+    return uint8ArrayToBase64(buffer);
+  }
+  /**
+   * Decode a delta-encoded base64 string back to an array of absolute VecModels.
+   * The first point is stored as Float32 (high precision), subsequent points are
+   * Float16 deltas that are accumulated to reconstruct absolute positions.
+   *
+   * @param base64 - The base64-encoded string containing delta-encoded point data
+   * @returns An array of VecModel objects with absolute coordinates
+   * @public
+   */
+  static decodePoints(base64) {
+    if (base64.length === 0) return [];
+    const bytes = base64ToUint8Array(base64);
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const result = [];
+    let x = dataView.getFloat32(0, true);
+    let y = dataView.getFloat32(4, true);
+    let z = dataView.getFloat32(8, true);
+    result.push({ x, y, z });
+    const firstPointBytes = 12;
+    for (let offset = firstPointBytes; offset < bytes.length; offset += 6) {
+      x += getFloat16(dataView, offset);
+      y += getFloat16(dataView, offset + 2);
+      z += getFloat16(dataView, offset + 4);
+      result.push({ x, y, z });
+    }
+    return result;
+  }
+  /**
+   * Get the first point from a delta-encoded base64 string.
+   * The first point is stored as Float32 for full precision.
+   *
+   * @param b64Points - The delta-encoded base64 string
+   * @returns The first point as a VecModel, or null if the string is too short
+   * @public
+   */
+  static decodeFirstPoint(b64Points) {
+    if (b64Points.length < FIRST_POINT_B64_LENGTH) return null;
+    const bytes = base64ToUint8Array(b64Points.slice(0, FIRST_POINT_B64_LENGTH));
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    return {
+      x: dataView.getFloat32(0, true),
+      y: dataView.getFloat32(4, true),
+      z: dataView.getFloat32(8, true)
+    };
+  }
+  /**
+   * Get the last point from a delta-encoded base64 string.
+   * Requires decoding all points to accumulate deltas.
+   *
+   * @param b64Points - The delta-encoded base64 string
+   * @returns The last point as a VecModel, or null if the string is too short
+   * @public
+   */
+  static decodeLastPoint(b64Points) {
+    if (b64Points.length < FIRST_POINT_B64_LENGTH) return null;
+    const bytes = base64ToUint8Array(b64Points);
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    let x = dataView.getFloat32(0, true);
+    let y = dataView.getFloat32(4, true);
+    let z = dataView.getFloat32(8, true);
+    const firstPointBytes = 12;
+    for (let offset = firstPointBytes; offset < bytes.length; offset += 6) {
+      x += getFloat16(dataView, offset);
+      y += getFloat16(dataView, offset + 2);
+      z += getFloat16(dataView, offset + 4);
+    }
+    return { x, y, z };
+  }
+}
+//# sourceMappingURL=b64Vecs.js.map