@tldraw/tlschema 5.2.0-next.ee0fa4d6244f → 5.2.1

package/dist-cjs/index.d.ts

@@ -285,38 +285,100 @@ export declare class b64Vecs {
      * - Delta points: 3 Float16 values each = 6 bytes = 8 base64 chars each
      *
      * @param points - An array of VecModel objects to encode
+     * @param dim - Encoding dimension; `2` routes through the 2D variant (drops z), `3` (default) keeps x, y, z
      * @returns A base64-encoded string containing delta-encoded points
      * @public
      */
-    static encodePoints(points: VecModel[]): string;
+    static encodePoints(points: VecModel[], dim?: 2 | 3): 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
+     * @param dim - Encoding dimension; `2` expects x/y only (z supplied as 0.5), `3` (default) expects x/y/z
      * @returns An array of VecModel objects with absolute coordinates
      * @public
      */
-    static decodePoints(base64: string): VecModel[];
+    static decodePoints(base64: string, dim?: 2 | 3): 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
+     * @param dim - Encoding dimension; `2` expects x/y only (z supplied as 0.5), `3` (default) expects x/y/z
      * @returns The first point as a VecModel, or null if the string is too short
      * @public
      */
-    static decodeFirstPoint(b64Points: string): null | VecModel;
+    static decodeFirstPoint(b64Points: string, dim?: 2 | 3): 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
+     * @param dim - Encoding dimension; `2` expects x/y only (z supplied as 0.5), `3` (default) expects x/y/z
      * @returns The last point as a VecModel, or null if the string is too short
      * @public
      */
-    static decodeLastPoint(b64Points: string): null | VecModel;
+    static decodeLastPoint(b64Points: string, dim?: 2 | 3): null | VecModel;
+    /**
+     * Encode an array of VecModels as 2D delta-encoded points, dropping z entirely.
+     * Use for draw shapes from devices that don't report pressure, where z is a
+     * constant 0.5 and storing it wastes ~33% of per-point bytes.
+     *
+     * Format:
+     * - First point: 2 Float32 values (x, y) = 8 bytes
+     * - Delta points: 2 Float16 values (dx, dy) = 4 bytes each
+     *
+     * @param points - An array of VecModel objects to encode (z is discarded)
+     * @returns A base64-encoded string containing 2D delta-encoded points
+     * @public
+     */
+    static encodePoints2D(points: VecModel[]): string;
+    /**
+     * Decode a 2D delta-encoded base64 string back to an array of absolute VecModels.
+     * The z coordinate is always set to 0.5 (the default pressure value) so downstream
+     * consumers don't need a separate code path.
+     *
+     * @param base64 - The base64-encoded string containing 2D delta-encoded point data
+     * @returns An array of VecModel objects with absolute (x, y) and z = 0.5
+     * @public
+     */
+    static decodePoints2D(base64: string): VecModel[];
+    /**
+     * Get the first point from a 2D delta-encoded base64 string.
+     *
+     * @param b64Points - The 2D delta-encoded base64 string
+     * @returns The first point with z = 0.5, or null if the string is too short
+     * @public
+     */
+    static decodeFirstPoint2D(b64Points: string): null | VecModel;
+    /**
+     * Get the last point from a 2D delta-encoded base64 string.
+     * Requires decoding all points to accumulate deltas.
+     *
+     * @param b64Points - The 2D delta-encoded base64 string
+     * @returns The last point with z = 0.5, or null if the string is too short
+     * @public
+     */
+    static decodeLastPoint2D(b64Points: string): null | VecModel;
+    /**
+     * Whether an encoded path contains only a single point (a "dot"), inferred from
+     * the encoded length without decoding — cheap enough for the render path.
+     *
+     * The single-point length depends on the encoding dimension, so this takes the
+     * segment's `dim`: a one-point path is `FIRST_POINT_B64_LENGTH` chars (3D) or
+     * `FIRST_POINT_2D_B64_LENGTH` chars (2D). Keeping this beside the layout constants
+     * is deliberate — it is the single source of truth for "how long is one point", so
+     * callers never hard-code a length threshold (which silently breaks when a new
+     * encoding is added).
+     *
+     * @param b64Points - The encoded path string
+     * @param dim - Encoding dimension; `2` for (x, y), `3` (default) for (x, y, z)
+     * @returns true if the path encodes exactly one point
+     * @public
+     */
+    static isSinglePoint(b64Points: string, dim?: 2 | 3): boolean;
 }
 
 /**
@@ -1626,6 +1688,12 @@ export declare const DefaultTextAlignStyle: EnumStyleProp<"end" | "middle" | "st
  */
 export declare const DefaultVerticalAlignStyle: EnumStyleProp<"end" | "middle" | "start">;
 
+/** Draw segment path encoded with 2 dimensions, XY — the constant pressure Z is dropped. @public */
+export declare const DIM_2D = 2;
+
+/** Draw segment path encoded with 3 dimensions, XYZ. @public */
+export declare const DIM_3D = 3;
+
 /**
  * Record type definition for TLDocument with validation and default properties.
  * Configures the document as a document-scoped record that persists across sessions.
@@ -1924,7 +1992,7 @@ export declare function getDefaultUserPresence(store: TLStore, user: TLUser): {
         x: number;
         y: number;
     };
-    followingUserId: null | string;
+    followingUserId: TLUserId | null;
     lastActivityTimestamp: number;
     meta: {};
     screenBounds: BoxModel;
@@ -4466,6 +4534,12 @@ export declare interface TLDrawShapeSegment {
      * First point stored as Float32 (12 bytes) for precision, subsequent points as Float16 deltas (6 bytes each).
      */
     path: string;
+    /**
+     * Encoding dimension of `path`. `2` means (x, y) only — the constant 0.5 pressure
+     * was omitted, for input from devices that don't report pressure. `3` or absent
+     * (the legacy default) means (x, y, z). Added in the `OmitNonPressureZ` migration.
+     */
+    dim?: 2 | 3;
 }
 
 /**
@@ -5101,8 +5175,8 @@ export declare interface TLInstance extends BaseRecord<'instance', TLInstanceId>
     currentPageId: TLPageId;
     opacityForNextShape: TLOpacityType;
     stylesForNextShape: Record<string, unknown>;
-    followingUserId: null | string;
-    highlightedUserIds: string[];
+    followingUserId: null | TLUserId;
+    highlightedUserIds: TLUserId[];
     brush: BoxModel | null;
     cursor: TLCursor;
     scribbles: TLScribble[];
@@ -5250,7 +5324,7 @@ export declare type TLInstancePageStateId = RecordId<TLInstancePageState>;
  * @public
  */
 export declare interface TLInstancePresence extends BaseRecord<'instance_presence', TLInstancePresenceID> {
-    userId: string;
+    userId: TLUserId;
     userName: string;
     lastActivityTimestamp: null | number;
     color: string;
@@ -5264,7 +5338,7 @@ export declare interface TLInstancePresence extends BaseRecord<'instance_presenc
     brush: BoxModel | null;
     scribbles: TLScribble[];
     screenBounds: BoxModel | null;
-    followingUserId: null | string;
+    followingUserId: null | TLUserId;
     cursor: {
         rotation: number;
         type: TLCursor['type'];
@@ -5502,8 +5576,8 @@ export declare interface TLNoteShapeProps {
     richText: TLRichText;
     /** Scale factor applied to the note shape for display */
     scale: number;
-    /** User ID of the person who first edited the note text */
-    textFirstEditedBy: null | string;
+    /** User ID of the person who last edited the note text */
+    textLastEditedBy: null | string;
 }
 
 /**

package/dist-cjs/index.js

@@ -23,6 +23,8 @@ __export(index_exports, {
   ArrowShapeKindStyle: () => import_TLArrowShape.ArrowShapeKindStyle,
   AssetRecordType: () => import_TLAsset.AssetRecordType,
   CameraRecordType: () => import_TLCamera.CameraRecordType,
+  DIM_2D: () => import_b64Vecs.DIM_2D,
+  DIM_3D: () => import_b64Vecs.DIM_3D,
   DefaultColorStyle: () => import_TLColorStyle.DefaultColorStyle,
   DefaultDashStyle: () => import_TLDashStyle.DefaultDashStyle,
   DefaultFillStyle: () => import_TLFillStyle.DefaultFillStyle,
@@ -205,7 +207,7 @@ var import_translations = require("./translations/translations");
 var import_b64Vecs = require("./misc/b64Vecs");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/tlschema",
-  "5.2.0-next.ee0fa4d6244f",
+  "5.2.1",
   "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 {\n\tbookmarkAssetMigrations,\n\tbookmarkAssetProps,\n\ttype TLBookmarkAsset,\n} from './assets/TLBookmarkAsset'\nexport { imageAssetMigrations, imageAssetProps, type TLImageAsset } from './assets/TLImageAsset'\nexport { videoAssetMigrations, videoAssetProps, 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 CreatePresenceStateDerivationOpts,\n\ttype TLPresenceStateInfo,\n} from './createPresenceStateDerivation'\nexport {\n\tcreateTLSchema,\n\tdefaultAssetSchemas,\n\tdefaultBindingSchemas,\n\tdefaultShapeSchemas,\n\ttype SchemaPropsInfo,\n\ttype TLSchema,\n\ttype UserSchemaInfo,\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\tcreateAssetPropsMigrationIds,\n\tcreateAssetPropsMigrationSequence,\n\tcreateAssetRecordType,\n\ttype TLAsset,\n\ttype TLAssetId,\n\ttype TLAssetPartial,\n\ttype TLAssetShape,\n\ttype TLDefaultAsset,\n\ttype TLGlobalAssetPropsMap,\n\ttype TLIndexedAssets,\n\ttype TLUnknownAsset,\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\tcreateCustomRecordId,\n\tcreateCustomRecordMigrationIds,\n\tcreateCustomRecordMigrationSequence,\n\tisCustomRecord,\n\tisCustomRecordId,\n\ttype CustomRecordInfo,\n} from './records/TLCustomRecord'\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 {\n\ttype TLCustomRecord,\n\ttype TLDefaultRecord,\n\ttype TLGlobalRecordPropsMap,\n\ttype TLIndexedRecords,\n\ttype TLRecord,\n} 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\tcreateUserId,\n\tcreateUserRecordType,\n\tisUserId,\n\tuserIdValidator,\n\tUserRecordType,\n\ttype TLUser,\n\ttype TLUserId,\n} from './records/TLUser'\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\tDefaultColorStyle,\n\tregisterColorsFromThemes,\n\ttype TLDefaultColorStyle,\n} from './styles/TLColorStyle'\nexport { DefaultDashStyle, type TLDefaultDashStyle } from './styles/TLDashStyle'\nexport { DefaultFillStyle, type TLDefaultFillStyle } from './styles/TLFillStyle'\nexport { type TLFontFace, type TLFontFaceSource } from './styles/TLFontFace'\nexport {\n\tDefaultFontFamilies,\n\tDefaultFontStyle,\n\tisFontEntry,\n\tregisterFontsFromThemes,\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\ttype TLDefaultColor,\n\ttype TLRemovedDefaultThemeColors,\n\ttype TLTheme,\n\ttype TLThemeColors,\n\ttype TLThemeDefaultColors,\n\ttype TLThemeFont,\n\ttype TLThemeFonts,\n\ttype TLThemeId,\n\ttype TLThemes,\n\ttype TLThemeUiColorKeys,\n} from './styles/TLTheme'\nexport {\n\tDefaultVerticalAlignStyle,\n\ttype TLDefaultVerticalAlignStyle,\n} from './styles/TLVerticalAlignStyle'\nexport {\n\tcreateCachedUserResolve,\n\ttype TLAssetContext,\n\ttype TLAssetStore,\n\ttype TLSerializedStore,\n\ttype TLStore,\n\ttype TLStoreProps,\n\ttype TLStoreSchema,\n\ttype TLStoreSnapshot,\n\ttype TLUserStore,\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,mBAA6C;AAC7C,yBAAyE;AACzE,6BAIO;AACP,0BAAyE;AACzE,0BAAyE;AACzE,4BAOO;AACP,2BAIO;AACP,2CAKO;AACP,4BAQO;AACP,4BAKO;AACP,0BAA4B;AAC5B,qBAIO;AACP,sBAAkE;AAClE,sBAAkE;AAClE,uBAAqD;AACrD,wBAA+D;AAC/D,wBAAuE;AACvE,qBAcO;AACP,uBAeO;AACP,sBAAiE;AACjE,4BAOO;AACP,wBAKO;AACP,wBAKO;AACP,oBAMO;AACP,yBAIO;AACP,uBAKO;AACP,wBAIO;AAQP,qBAkBO;AACP,oBAQO;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,0BAIO;AACP,yBAA0D;AAC1D,yBAA0D;AAE1D,yBAMO;AACP,oCAGO;AACP,yBAA0D;AAC1D,8BAAoE;AAapE,kCAGO;AACP,qBAUO;AACP,0BAIO;AASP,qBAAwB;AAAA,IANxB;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 {\n\tbookmarkAssetMigrations,\n\tbookmarkAssetProps,\n\ttype TLBookmarkAsset,\n} from './assets/TLBookmarkAsset'\nexport { imageAssetMigrations, imageAssetProps, type TLImageAsset } from './assets/TLImageAsset'\nexport { videoAssetMigrations, videoAssetProps, 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 CreatePresenceStateDerivationOpts,\n\ttype TLPresenceStateInfo,\n} from './createPresenceStateDerivation'\nexport {\n\tcreateTLSchema,\n\tdefaultAssetSchemas,\n\tdefaultBindingSchemas,\n\tdefaultShapeSchemas,\n\ttype SchemaPropsInfo,\n\ttype TLSchema,\n\ttype UserSchemaInfo,\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\tcreateAssetPropsMigrationIds,\n\tcreateAssetPropsMigrationSequence,\n\tcreateAssetRecordType,\n\ttype TLAsset,\n\ttype TLAssetId,\n\ttype TLAssetPartial,\n\ttype TLAssetShape,\n\ttype TLDefaultAsset,\n\ttype TLGlobalAssetPropsMap,\n\ttype TLIndexedAssets,\n\ttype TLUnknownAsset,\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\tcreateCustomRecordId,\n\tcreateCustomRecordMigrationIds,\n\tcreateCustomRecordMigrationSequence,\n\tisCustomRecord,\n\tisCustomRecordId,\n\ttype CustomRecordInfo,\n} from './records/TLCustomRecord'\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 {\n\ttype TLCustomRecord,\n\ttype TLDefaultRecord,\n\ttype TLGlobalRecordPropsMap,\n\ttype TLIndexedRecords,\n\ttype TLRecord,\n} 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\tcreateUserId,\n\tcreateUserRecordType,\n\tisUserId,\n\tuserIdValidator,\n\tUserRecordType,\n\ttype TLUser,\n\ttype TLUserId,\n} from './records/TLUser'\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\tDefaultColorStyle,\n\tregisterColorsFromThemes,\n\ttype TLDefaultColorStyle,\n} from './styles/TLColorStyle'\nexport { DefaultDashStyle, type TLDefaultDashStyle } from './styles/TLDashStyle'\nexport { DefaultFillStyle, type TLDefaultFillStyle } from './styles/TLFillStyle'\nexport { type TLFontFace, type TLFontFaceSource } from './styles/TLFontFace'\nexport {\n\tDefaultFontFamilies,\n\tDefaultFontStyle,\n\tisFontEntry,\n\tregisterFontsFromThemes,\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\ttype TLDefaultColor,\n\ttype TLRemovedDefaultThemeColors,\n\ttype TLTheme,\n\ttype TLThemeColors,\n\ttype TLThemeDefaultColors,\n\ttype TLThemeFont,\n\ttype TLThemeFonts,\n\ttype TLThemeId,\n\ttype TLThemes,\n\ttype TLThemeUiColorKeys,\n} from './styles/TLTheme'\nexport {\n\tDefaultVerticalAlignStyle,\n\ttype TLDefaultVerticalAlignStyle,\n} from './styles/TLVerticalAlignStyle'\nexport {\n\tcreateCachedUserResolve,\n\ttype TLAssetContext,\n\ttype TLAssetStore,\n\ttype TLSerializedStore,\n\ttype TLStore,\n\ttype TLStoreProps,\n\ttype TLStoreSchema,\n\ttype TLStoreSnapshot,\n\ttype TLUserStore,\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 { DIM_2D, DIM_3D, 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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,mBAA6C;AAC7C,yBAAyE;AACzE,6BAIO;AACP,0BAAyE;AACzE,0BAAyE;AACzE,4BAOO;AACP,2BAIO;AACP,2CAKO;AACP,4BAQO;AACP,4BAKO;AACP,0BAA4B;AAC5B,qBAIO;AACP,sBAAkE;AAClE,sBAAkE;AAClE,uBAAqD;AACrD,wBAA+D;AAC/D,wBAAuE;AACvE,qBAcO;AACP,uBAeO;AACP,sBAAiE;AACjE,4BAOO;AACP,wBAKO;AACP,wBAKO;AACP,oBAMO;AACP,yBAIO;AACP,uBAKO;AACP,wBAIO;AAQP,qBAkBO;AACP,oBAQO;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,0BAIO;AACP,yBAA0D;AAC1D,yBAA0D;AAE1D,yBAMO;AACP,oCAGO;AACP,yBAA0D;AAC1D,8BAAoE;AAapE,kCAGO;AACP,qBAUO;AACP,0BAIO;AASP,qBAAwC;AAAA,IANxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;",
   "names": []
 }

package/dist-cjs/misc/b64Vecs.js

@@ -18,6 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var b64Vecs_exports = {};
 __export(b64Vecs_exports, {
+  DIM_2D: () => DIM_2D,
+  DIM_3D: () => DIM_3D,
   b64Vecs: () => b64Vecs,
   fallbackBase64ToUint8Array: () => fallbackBase64ToUint8Array,
   fallbackUint8ArrayToBase64: () => fallbackUint8ArrayToBase64,
@@ -25,14 +27,19 @@ __export(b64Vecs_exports, {
   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 FIRST_POINT_2D_B64_LENGTH = 12;
+const DEFAULT_PRESSURE = 0.5;
+const DIM_2D = 2;
+const DIM_3D = 3;
 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 SIX_BIT_MASK = 63;
+const PADDING_CHAR_CODE = "=".charCodeAt(0);
 const POW2 = new Float64Array(31);
 for (let i = 0; i < 31; i++) {
   POW2[i] = Math.pow(2, i - 15);
@@ -61,10 +68,19 @@ function nativeBase64ToUint8Array(base64) {
   return Uint8Array.fromBase64(base64);
 }
 function fallbackBase64ToUint8Array(base64) {
-  const numBytes = Math.floor(base64.length * 3 / 4);
+  const paddedLength = base64.length;
+  let padding = 0;
+  if (paddedLength > 0 && base64.charCodeAt(paddedLength - 1) === PADDING_CHAR_CODE) {
+    padding++;
+    if (paddedLength > 1 && base64.charCodeAt(paddedLength - 2) === PADDING_CHAR_CODE) {
+      padding++;
+    }
+  }
+  const numBytes = Math.floor(paddedLength * 3 / 4) - padding;
   const bytes = new Uint8Array(numBytes);
   let byteIndex = 0;
-  for (let i = 0; i < base64.length; i += 4) {
+  const fullGroups = Math.floor((paddedLength - padding) / 4) * 4;
+  for (let i = 0; i < fullGroups; 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)];
@@ -74,20 +90,45 @@ function fallbackBase64ToUint8Array(base64) {
     bytes[byteIndex++] = bitmap >> 8 & 255;
     bytes[byteIndex++] = bitmap & 255;
   }
+  if (padding === 1) {
+    const c0 = B64_LOOKUP[base64.charCodeAt(fullGroups)];
+    const c1 = B64_LOOKUP[base64.charCodeAt(fullGroups + 1)];
+    const c2 = B64_LOOKUP[base64.charCodeAt(fullGroups + 2)];
+    const bitmap = c0 << 18 | c1 << 12 | c2 << 6;
+    bytes[byteIndex++] = bitmap >> 16 & 255;
+    bytes[byteIndex++] = bitmap >> 8 & 255;
+  } else if (padding === 2) {
+    const c0 = B64_LOOKUP[base64.charCodeAt(fullGroups)];
+    const c1 = B64_LOOKUP[base64.charCodeAt(fullGroups + 1)];
+    const bitmap = c0 << 18 | c1 << 12;
+    bytes[byteIndex++] = bitmap >> 16 & 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");
+  const len = uint8Array.length;
+  const fullGroups = Math.floor(len / 3) * 3;
   let result = "";
-  for (let i = 0; i < uint8Array.length; i += 3) {
+  for (let i = 0; i < fullGroups; 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];
+    result += BASE64_CHARS[bitmap >> 18 & SIX_BIT_MASK] + // bits 23–18 (top sextet)
+    BASE64_CHARS[bitmap >> 12 & SIX_BIT_MASK] + // bits 17–12
+    BASE64_CHARS[bitmap >> 6 & SIX_BIT_MASK] + // bits 11–6
+    BASE64_CHARS[bitmap & SIX_BIT_MASK];
+  }
+  const remaining = len - fullGroups;
+  if (remaining === 1) {
+    const bitmap = uint8Array[fullGroups] << 16;
+    result += BASE64_CHARS[bitmap >> 18 & SIX_BIT_MASK] + BASE64_CHARS[bitmap >> 12 & SIX_BIT_MASK] + "==";
+  } else if (remaining === 2) {
+    const bitmap = uint8Array[fullGroups] << 16 | uint8Array[fullGroups + 1] << 8;
+    result += BASE64_CHARS[bitmap >> 18 & SIX_BIT_MASK] + BASE64_CHARS[bitmap >> 12 & SIX_BIT_MASK] + BASE64_CHARS[bitmap >> 6 & SIX_BIT_MASK] + "=";
   }
   return result;
 }
@@ -208,10 +249,12 @@ class b64Vecs {
    * - Delta points: 3 Float16 values each = 6 bytes = 8 base64 chars each
    *
    * @param points - An array of VecModel objects to encode
+   * @param dim - Encoding dimension; `2` routes through the 2D variant (drops z), `3` (default) keeps x, y, z
    * @returns A base64-encoded string containing delta-encoded points
    * @public
    */
-  static encodePoints(points) {
+  static encodePoints(points, dim) {
+    if (dim === DIM_2D) return b64Vecs.encodePoints2D(points);
     if (points.length === 0) return "";
     const firstPointBytes = 12;
     const deltaBytes = (points.length - 1) * 6;
@@ -244,10 +287,12 @@ class b64Vecs {
    * Float16 deltas that are accumulated to reconstruct absolute positions.
    *
    * @param base64 - The base64-encoded string containing delta-encoded point data
+   * @param dim - Encoding dimension; `2` expects x/y only (z supplied as 0.5), `3` (default) expects x/y/z
    * @returns An array of VecModel objects with absolute coordinates
    * @public
    */
-  static decodePoints(base64) {
+  static decodePoints(base64, dim) {
+    if (dim === DIM_2D) return b64Vecs.decodePoints2D(base64);
     if (base64.length === 0) return [];
     const bytes = base64ToUint8Array(base64);
     const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
@@ -270,10 +315,12 @@ class b64Vecs {
    * The first point is stored as Float32 for full precision.
    *
    * @param b64Points - The delta-encoded base64 string
+   * @param dim - Encoding dimension; `2` expects x/y only (z supplied as 0.5), `3` (default) expects x/y/z
    * @returns The first point as a VecModel, or null if the string is too short
    * @public
    */
-  static decodeFirstPoint(b64Points) {
+  static decodeFirstPoint(b64Points, dim) {
+    if (dim === DIM_2D) return b64Vecs.decodeFirstPoint2D(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);
@@ -288,10 +335,12 @@ class b64Vecs {
    * Requires decoding all points to accumulate deltas.
    *
    * @param b64Points - The delta-encoded base64 string
+   * @param dim - Encoding dimension; `2` expects x/y only (z supplied as 0.5), `3` (default) expects x/y/z
    * @returns The last point as a VecModel, or null if the string is too short
    * @public
    */
-  static decodeLastPoint(b64Points) {
+  static decodeLastPoint(b64Points, dim) {
+    if (dim === DIM_2D) return b64Vecs.decodeLastPoint2D(b64Points);
     if (b64Points.length < FIRST_POINT_B64_LENGTH) return null;
     const bytes = base64ToUint8Array(b64Points);
     const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
@@ -306,5 +355,121 @@ class b64Vecs {
     }
     return { x, y, z };
   }
+  /**
+   * Encode an array of VecModels as 2D delta-encoded points, dropping z entirely.
+   * Use for draw shapes from devices that don't report pressure, where z is a
+   * constant 0.5 and storing it wastes ~33% of per-point bytes.
+   *
+   * Format:
+   * - First point: 2 Float32 values (x, y) = 8 bytes
+   * - Delta points: 2 Float16 values (dx, dy) = 4 bytes each
+   *
+   * @param points - An array of VecModel objects to encode (z is discarded)
+   * @returns A base64-encoded string containing 2D delta-encoded points
+   * @public
+   */
+  static encodePoints2D(points) {
+    if (points.length === 0) return "";
+    const firstPointBytes = 8;
+    const deltaBytes = (points.length - 1) * 4;
+    const buffer = new Uint8Array(firstPointBytes + deltaBytes);
+    const dataView = new DataView(buffer.buffer);
+    const first = points[0];
+    dataView.setFloat32(0, first.x, true);
+    dataView.setFloat32(4, first.y, true);
+    let prevX = first.x;
+    let prevY = first.y;
+    for (let i = 1; i < points.length; i++) {
+      const p = points[i];
+      const offset = firstPointBytes + (i - 1) * 4;
+      setFloat16(dataView, offset, p.x - prevX);
+      setFloat16(dataView, offset + 2, p.y - prevY);
+      prevX = p.x;
+      prevY = p.y;
+    }
+    return uint8ArrayToBase64(buffer);
+  }
+  /**
+   * Decode a 2D delta-encoded base64 string back to an array of absolute VecModels.
+   * The z coordinate is always set to 0.5 (the default pressure value) so downstream
+   * consumers don't need a separate code path.
+   *
+   * @param base64 - The base64-encoded string containing 2D delta-encoded point data
+   * @returns An array of VecModel objects with absolute (x, y) and z = 0.5
+   * @public
+   */
+  static decodePoints2D(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);
+    result.push({ x, y, z: DEFAULT_PRESSURE });
+    const firstPointBytes = 8;
+    for (let offset = firstPointBytes; offset < bytes.length; offset += 4) {
+      x += getFloat16(dataView, offset);
+      y += getFloat16(dataView, offset + 2);
+      result.push({ x, y, z: DEFAULT_PRESSURE });
+    }
+    return result;
+  }
+  /**
+   * Get the first point from a 2D delta-encoded base64 string.
+   *
+   * @param b64Points - The 2D delta-encoded base64 string
+   * @returns The first point with z = 0.5, or null if the string is too short
+   * @public
+   */
+  static decodeFirstPoint2D(b64Points) {
+    if (b64Points.length < FIRST_POINT_2D_B64_LENGTH) return null;
+    const bytes = base64ToUint8Array(b64Points.slice(0, FIRST_POINT_2D_B64_LENGTH));
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    return {
+      x: dataView.getFloat32(0, true),
+      y: dataView.getFloat32(4, true),
+      z: DEFAULT_PRESSURE
+    };
+  }
+  /**
+   * Get the last point from a 2D delta-encoded base64 string.
+   * Requires decoding all points to accumulate deltas.
+   *
+   * @param b64Points - The 2D delta-encoded base64 string
+   * @returns The last point with z = 0.5, or null if the string is too short
+   * @public
+   */
+  static decodeLastPoint2D(b64Points) {
+    if (b64Points.length < FIRST_POINT_2D_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);
+    const firstPointBytes = 8;
+    for (let offset = firstPointBytes; offset < bytes.length; offset += 4) {
+      x += getFloat16(dataView, offset);
+      y += getFloat16(dataView, offset + 2);
+    }
+    return { x, y, z: DEFAULT_PRESSURE };
+  }
+  /**
+   * Whether an encoded path contains only a single point (a "dot"), inferred from
+   * the encoded length without decoding — cheap enough for the render path.
+   *
+   * The single-point length depends on the encoding dimension, so this takes the
+   * segment's `dim`: a one-point path is `FIRST_POINT_B64_LENGTH` chars (3D) or
+   * `FIRST_POINT_2D_B64_LENGTH` chars (2D). Keeping this beside the layout constants
+   * is deliberate — it is the single source of truth for "how long is one point", so
+   * callers never hard-code a length threshold (which silently breaks when a new
+   * encoding is added).
+   *
+   * @param b64Points - The encoded path string
+   * @param dim - Encoding dimension; `2` for (x, y), `3` (default) for (x, y, z)
+   * @returns true if the path encodes exactly one point
+   * @public
+   */
+  static isSinglePoint(b64Points, dim) {
+    return b64Points.length <= (dim === DIM_2D ? FIRST_POINT_2D_B64_LENGTH : FIRST_POINT_B64_LENGTH);
+  }
 }
 //# sourceMappingURL=b64Vecs.js.map