@tldraw/tlschema 4.3.0-next.2d181ae353a2 → 4.3.0-next.40e4536afc8e

package/dist-esm/store-migrations.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/store-migrations.ts"],
-  "sourcesContent": ["import { createMigrationIds, createMigrationSequence } from '@tldraw/store'\nimport { IndexKey, objectMapEntries } from '@tldraw/utils'\nimport { TLPage } from './records/TLPage'\nimport { TLShape } from './records/TLShape'\nimport { TLLineShape } from './shapes/TLLineShape'\n\n/**\n * Migration version constants for store-level schema changes.\n * Each version represents a breaking change that requires data transformation.\n *\n * @internal\n */\nconst Versions = createMigrationIds('com.tldraw.store', {\n\tRemoveCodeAndIconShapeTypes: 1,\n\tAddInstancePresenceType: 2,\n\tRemoveTLUserAndPresenceAndAddPointer: 3,\n\tRemoveUserDocument: 4,\n\tFixIndexKeys: 5,\n} as const)\n\n/**\n * Migration version identifiers for store-level migrations.\n * These versions track changes to the overall store structure and data model.\n *\n * @example\n * ```ts\n * import { storeVersions } from '@tldraw/tlschema'\n *\n * // Check if a specific migration version exists\n * const hasRemoveCodeShapes = storeVersions.RemoveCodeAndIconShapeTypes\n * ```\n *\n * @public\n */\nexport { Versions as storeVersions }\n\n/**\n * Store-level migration sequence that handles evolution of the tldraw data model.\n * These migrations run when the store schema version changes and ensure backward\n * compatibility by transforming old data structures to new formats.\n *\n * The migrations handle:\n * - Removal of deprecated shape types (code, icon)\n * - Addition of new record types (instance presence)\n * - Cleanup of obsolete user and presence data\n * - Removal of deprecated user document records\n *\n * @example\n * ```ts\n * import { storeMigrations } from '@tldraw/tlschema'\n * import { migrate } from '@tldraw/store'\n *\n * // Apply store migrations to old data\n * const migratedStore = migrate({\n *   store: oldStoreData,\n *   migrations: storeMigrations,\n *   fromVersion: 0,\n *   toVersion: storeMigrations.currentVersion\n * })\n * ```\n *\n * @public\n */\nexport const storeMigrations = createMigrationSequence({\n\tsequenceId: 'com.tldraw.store',\n\tretroactive: false,\n\tsequence: [\n\t\t{\n\t\t\tid: Versions.RemoveCodeAndIconShapeTypes,\n\t\t\tscope: 'store',\n\t\t\tup: (store) => {\n\t\t\t\tfor (const [id, record] of objectMapEntries(store)) {\n\t\t\t\t\tif (\n\t\t\t\t\t\trecord.typeName === 'shape' &&\n\t\t\t\t\t\t'type' in record &&\n\t\t\t\t\t\t(record.type === 'icon' || record.type === 'code')\n\t\t\t\t\t) {\n\t\t\t\t\t\tdelete store[id]\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tid: Versions.AddInstancePresenceType,\n\t\t\tscope: 'store',\n\t\t\tup(_store) {\n\t\t\t\t// noop\n\t\t\t\t// there used to be a down migration for this but we made down migrations optional\n\t\t\t\t// and we don't use them on store-level migrations so we can just remove it\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t// remove user and presence records and add pointer records\n\t\t\tid: Versions.RemoveTLUserAndPresenceAndAddPointer,\n\t\t\tscope: 'store',\n\t\t\tup: (store) => {\n\t\t\t\tfor (const [id, record] of objectMapEntries(store)) {\n\t\t\t\t\tif (record.typeName.match(/^(user|user_presence)$/)) {\n\t\t\t\t\t\tdelete store[id]\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t// remove user document records\n\t\t\tid: Versions.RemoveUserDocument,\n\t\t\tscope: 'store',\n\t\t\tup: (store) => {\n\t\t\t\tfor (const [id, record] of objectMapEntries(store)) {\n\t\t\t\t\tif (record.typeName.match('user_document')) {\n\t\t\t\t\t\tdelete store[id]\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tid: Versions.FixIndexKeys,\n\t\t\tscope: 'record',\n\t\t\tup: (record) => {\n\t\t\t\tif (['shape', 'page'].includes(record.typeName) && 'index' in record) {\n\t\t\t\t\tconst recordWithIndex = record as TLShape | TLPage\n\t\t\t\t\t// Our newer fractional indexed library (more correctly) validates that indices\n\t\t\t\t\t// do not end with 0. ('a0' being an exception)\n\t\t\t\t\tif (recordWithIndex.index.endsWith('0') && recordWithIndex.index !== 'a0') {\n\t\t\t\t\t\trecordWithIndex.index = (recordWithIndex.index.slice(0, -1) +\n\t\t\t\t\t\t\tgetNRandomBase62Digits(3)) as IndexKey\n\t\t\t\t\t}\n\t\t\t\t\t// Line shapes have 'points' that have indices as well.\n\t\t\t\t\tif (record.typeName === 'shape' && (recordWithIndex as TLShape).type === 'line') {\n\t\t\t\t\t\tconst lineShape = recordWithIndex as TLLineShape\n\t\t\t\t\t\tfor (const [_, point] of objectMapEntries(lineShape.props.points)) {\n\t\t\t\t\t\t\tif (point.index.endsWith('0') && point.index !== 'a0') {\n\t\t\t\t\t\t\t\tpoint.index = (point.index.slice(0, -1) + getNRandomBase62Digits(3)) as IndexKey\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t\tdown: () => {\n\t\t\t\t// noop\n\t\t\t\t// Enables tlsync to support older clients so as to not force people to refresh immediately after deploying.\n\t\t\t},\n\t\t},\n\t],\n})\n\nconst BASE_62_DIGITS_WITHOUT_ZERO = '123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'\nconst getRandomBase62Digit = () => {\n\treturn BASE_62_DIGITS_WITHOUT_ZERO.charAt(\n\t\tMath.floor(Math.random() * BASE_62_DIGITS_WITHOUT_ZERO.length)\n\t)\n}\n\nconst getNRandomBase62Digits = (n: number) => {\n\treturn Array.from({ length: n }, getRandomBase62Digit).join('')\n}\n"],
-  "mappings": "AAAA,SAAS,oBAAoB,+BAA+B;AAC5D,SAAmB,wBAAwB;AAW3C,MAAM,WAAW,mBAAmB,oBAAoB;AAAA,EACvD,6BAA6B;AAAA,EAC7B,yBAAyB;AAAA,EACzB,sCAAsC;AAAA,EACtC,oBAAoB;AAAA,EACpB,cAAc;AACf,CAAU;AA6CH,MAAM,kBAAkB,wBAAwB;AAAA,EACtD,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,UAAU;AAAA,IACT;AAAA,MACC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,UAAU;AACd,mBAAW,CAAC,IAAI,MAAM,KAAK,iBAAiB,KAAK,GAAG;AACnD,cACC,OAAO,aAAa,WACpB,UAAU,WACT,OAAO,SAAS,UAAU,OAAO,SAAS,SAC1C;AACD,mBAAO,MAAM,EAAE;AAAA,UAChB;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,GAAG,QAAQ;AAAA,MAIX;AAAA,IACD;AAAA,IACA;AAAA;AAAA,MAEC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,UAAU;AACd,mBAAW,CAAC,IAAI,MAAM,KAAK,iBAAiB,KAAK,GAAG;AACnD,cAAI,OAAO,SAAS,MAAM,wBAAwB,GAAG;AACpD,mBAAO,MAAM,EAAE;AAAA,UAChB;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA;AAAA,MAEC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,UAAU;AACd,mBAAW,CAAC,IAAI,MAAM,KAAK,iBAAiB,KAAK,GAAG;AACnD,cAAI,OAAO,SAAS,MAAM,eAAe,GAAG;AAC3C,mBAAO,MAAM,EAAE;AAAA,UAChB;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,WAAW;AACf,YAAI,CAAC,SAAS,MAAM,EAAE,SAAS,OAAO,QAAQ,KAAK,WAAW,QAAQ;AACrE,gBAAM,kBAAkB;AAGxB,cAAI,gBAAgB,MAAM,SAAS,GAAG,KAAK,gBAAgB,UAAU,MAAM;AAC1E,4BAAgB,QAAS,gBAAgB,MAAM,MAAM,GAAG,EAAE,IACzD,uBAAuB,CAAC;AAAA,UAC1B;AAEA,cAAI,OAAO,aAAa,WAAY,gBAA4B,SAAS,QAAQ;AAChF,kBAAM,YAAY;AAClB,uBAAW,CAAC,GAAG,KAAK,KAAK,iBAAiB,UAAU,MAAM,MAAM,GAAG;AAClE,kBAAI,MAAM,MAAM,SAAS,GAAG,KAAK,MAAM,UAAU,MAAM;AACtD,sBAAM,QAAS,MAAM,MAAM,MAAM,GAAG,EAAE,IAAI,uBAAuB,CAAC;AAAA,cACnE;AAAA,YACD;AAAA,UACD;AAAA,QACD;AAAA,MACD;AAAA,MACA,MAAM,MAAM;AAAA,MAGZ;AAAA,IACD;AAAA,EACD;AACD,CAAC;AAED,MAAM,8BAA8B;AACpC,MAAM,uBAAuB,MAAM;AAClC,SAAO,4BAA4B;AAAA,IAClC,KAAK,MAAM,KAAK,OAAO,IAAI,4BAA4B,MAAM;AAAA,EAC9D;AACD;AAEA,MAAM,yBAAyB,CAAC,MAAc;AAC7C,SAAO,MAAM,KAAK,EAAE,QAAQ,EAAE,GAAG,oBAAoB,EAAE,KAAK,EAAE;AAC/D;",
+  "sourcesContent": ["import { createMigrationIds, createMigrationSequence } from '@tldraw/store'\nimport { IndexKey, objectMapEntries } from '@tldraw/utils'\nimport { TLPage } from './records/TLPage'\nimport { TLShape } from './records/TLShape'\nimport { TLLineShape } from './shapes/TLLineShape'\n\n/**\n * Migration version constants for store-level schema changes.\n * Each version represents a breaking change that requires data transformation.\n *\n * @internal\n */\nconst Versions = createMigrationIds('com.tldraw.store', {\n\tRemoveCodeAndIconShapeTypes: 1,\n\tAddInstancePresenceType: 2,\n\tRemoveTLUserAndPresenceAndAddPointer: 3,\n\tRemoveUserDocument: 4,\n\tFixIndexKeys: 5,\n} as const)\n\n/**\n * Migration version identifiers for store-level migrations.\n * These versions track changes to the overall store structure and data model.\n *\n * @example\n * ```ts\n * import { storeVersions } from '@tldraw/tlschema'\n *\n * // Check if a specific migration version exists\n * const hasRemoveCodeShapes = storeVersions.RemoveCodeAndIconShapeTypes\n * ```\n *\n * @public\n */\nexport { Versions as storeVersions }\n\n/**\n * Store-level migration sequence that handles evolution of the tldraw data model.\n * These migrations run when the store schema version changes and ensure backward\n * compatibility by transforming old data structures to new formats.\n *\n * The migrations handle:\n * - Removal of deprecated shape types (code, icon)\n * - Addition of new record types (instance presence)\n * - Cleanup of obsolete user and presence data\n * - Removal of deprecated user document records\n *\n * @example\n * ```ts\n * import { storeMigrations } from '@tldraw/tlschema'\n * import { migrate } from '@tldraw/store'\n *\n * // Apply store migrations to old data\n * const migratedStore = migrate({\n *   store: oldStoreData,\n *   migrations: storeMigrations,\n *   fromVersion: 0,\n *   toVersion: storeMigrations.currentVersion\n * })\n * ```\n *\n * @public\n */\nexport const storeMigrations = createMigrationSequence({\n\tsequenceId: 'com.tldraw.store',\n\tretroactive: false,\n\tsequence: [\n\t\t{\n\t\t\tid: Versions.RemoveCodeAndIconShapeTypes,\n\t\t\tscope: 'storage',\n\t\t\tup: (storage) => {\n\t\t\t\tfor (const [id, record] of storage.entries()) {\n\t\t\t\t\tif (\n\t\t\t\t\t\trecord.typeName === 'shape' &&\n\t\t\t\t\t\t'type' in record &&\n\t\t\t\t\t\t(record.type === 'icon' || record.type === 'code')\n\t\t\t\t\t) {\n\t\t\t\t\t\tstorage.delete(id)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tid: Versions.AddInstancePresenceType,\n\t\t\tscope: 'storage',\n\t\t\tup(_storage) {\n\t\t\t\t// noop\n\t\t\t\t// there used to be a down migration for this but we made down migrations optional\n\t\t\t\t// and we don't use them on storage-level migrations so we can just remove it\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t// remove user and presence records and add pointer records\n\t\t\tid: Versions.RemoveTLUserAndPresenceAndAddPointer,\n\t\t\tscope: 'storage',\n\t\t\tup: (storage) => {\n\t\t\t\tfor (const [id, record] of storage.entries()) {\n\t\t\t\t\tif (record.typeName.match(/^(user|user_presence)$/)) {\n\t\t\t\t\t\tstorage.delete(id)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t// remove user document records\n\t\t\tid: Versions.RemoveUserDocument,\n\t\t\tscope: 'storage',\n\t\t\tup: (storage) => {\n\t\t\t\tfor (const [id, record] of storage.entries()) {\n\t\t\t\t\tif (record.typeName.match('user_document')) {\n\t\t\t\t\t\tstorage.delete(id)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tid: Versions.FixIndexKeys,\n\t\t\tscope: 'record',\n\t\t\tup: (record) => {\n\t\t\t\tif (['shape', 'page'].includes(record.typeName) && 'index' in record) {\n\t\t\t\t\tconst recordWithIndex = record as TLShape | TLPage\n\t\t\t\t\t// Our newer fractional indexed library (more correctly) validates that indices\n\t\t\t\t\t// do not end with 0. ('a0' being an exception)\n\t\t\t\t\tif (recordWithIndex.index.endsWith('0') && recordWithIndex.index !== 'a0') {\n\t\t\t\t\t\trecordWithIndex.index = (recordWithIndex.index.slice(0, -1) +\n\t\t\t\t\t\t\tgetNRandomBase62Digits(3)) as IndexKey\n\t\t\t\t\t}\n\t\t\t\t\t// Line shapes have 'points' that have indices as well.\n\t\t\t\t\tif (record.typeName === 'shape' && (recordWithIndex as TLShape).type === 'line') {\n\t\t\t\t\t\tconst lineShape = recordWithIndex as TLLineShape\n\t\t\t\t\t\tfor (const [_, point] of objectMapEntries(lineShape.props.points)) {\n\t\t\t\t\t\t\tif (point.index.endsWith('0') && point.index !== 'a0') {\n\t\t\t\t\t\t\t\tpoint.index = (point.index.slice(0, -1) + getNRandomBase62Digits(3)) as IndexKey\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t\tdown: () => {\n\t\t\t\t// noop\n\t\t\t\t// Enables tlsync to support older clients so as to not force people to refresh immediately after deploying.\n\t\t\t},\n\t\t},\n\t],\n})\n\nconst BASE_62_DIGITS_WITHOUT_ZERO = '123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'\nconst getRandomBase62Digit = () => {\n\treturn BASE_62_DIGITS_WITHOUT_ZERO.charAt(\n\t\tMath.floor(Math.random() * BASE_62_DIGITS_WITHOUT_ZERO.length)\n\t)\n}\n\nconst getNRandomBase62Digits = (n: number) => {\n\treturn Array.from({ length: n }, getRandomBase62Digit).join('')\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB,+BAA+B;AAC5D,SAAmB,wBAAwB;AAW3C,MAAM,WAAW,mBAAmB,oBAAoB;AAAA,EACvD,6BAA6B;AAAA,EAC7B,yBAAyB;AAAA,EACzB,sCAAsC;AAAA,EACtC,oBAAoB;AAAA,EACpB,cAAc;AACf,CAAU;AA6CH,MAAM,kBAAkB,wBAAwB;AAAA,EACtD,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,UAAU;AAAA,IACT;AAAA,MACC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,YAAY;AAChB,mBAAW,CAAC,IAAI,MAAM,KAAK,QAAQ,QAAQ,GAAG;AAC7C,cACC,OAAO,aAAa,WACpB,UAAU,WACT,OAAO,SAAS,UAAU,OAAO,SAAS,SAC1C;AACD,oBAAQ,OAAO,EAAE;AAAA,UAClB;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,GAAG,UAAU;AAAA,MAIb;AAAA,IACD;AAAA,IACA;AAAA;AAAA,MAEC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,YAAY;AAChB,mBAAW,CAAC,IAAI,MAAM,KAAK,QAAQ,QAAQ,GAAG;AAC7C,cAAI,OAAO,SAAS,MAAM,wBAAwB,GAAG;AACpD,oBAAQ,OAAO,EAAE;AAAA,UAClB;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA;AAAA,MAEC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,YAAY;AAChB,mBAAW,CAAC,IAAI,MAAM,KAAK,QAAQ,QAAQ,GAAG;AAC7C,cAAI,OAAO,SAAS,MAAM,eAAe,GAAG;AAC3C,oBAAQ,OAAO,EAAE;AAAA,UAClB;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC,IAAI,SAAS;AAAA,MACb,OAAO;AAAA,MACP,IAAI,CAAC,WAAW;AACf,YAAI,CAAC,SAAS,MAAM,EAAE,SAAS,OAAO,QAAQ,KAAK,WAAW,QAAQ;AACrE,gBAAM,kBAAkB;AAGxB,cAAI,gBAAgB,MAAM,SAAS,GAAG,KAAK,gBAAgB,UAAU,MAAM;AAC1E,4BAAgB,QAAS,gBAAgB,MAAM,MAAM,GAAG,EAAE,IACzD,uBAAuB,CAAC;AAAA,UAC1B;AAEA,cAAI,OAAO,aAAa,WAAY,gBAA4B,SAAS,QAAQ;AAChF,kBAAM,YAAY;AAClB,uBAAW,CAAC,GAAG,KAAK,KAAK,iBAAiB,UAAU,MAAM,MAAM,GAAG;AAClE,kBAAI,MAAM,MAAM,SAAS,GAAG,KAAK,MAAM,UAAU,MAAM;AACtD,sBAAM,QAAS,MAAM,MAAM,MAAM,GAAG,EAAE,IAAI,uBAAuB,CAAC;AAAA,cACnE;AAAA,YACD;AAAA,UACD;AAAA,QACD;AAAA,MACD;AAAA,MACA,MAAM,MAAM;AAAA,MAGZ;AAAA,IACD;AAAA,EACD;AACD,CAAC;AAED,MAAM,8BAA8B;AACpC,MAAM,uBAAuB,MAAM;AAClC,SAAO,4BAA4B;AAAA,IAClC,KAAK,MAAM,KAAK,OAAO,IAAI,4BAA4B,MAAM;AAAA,EAC9D;AACD;AAEA,MAAM,yBAAyB,CAAC,MAAc;AAC7C,SAAO,MAAM,KAAK,EAAE,QAAQ,EAAE,GAAG,oBAAoB,EAAE,KAAK,EAAE;AAC/D;",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tldraw/tlschema",
   "description": "tldraw infinite canvas SDK (schema).",
-  "version": "4.3.0-next.2d181ae353a2",
+  "version": "4.3.0-next.40e4536afc8e",
   "author": {
     "name": "tldraw Inc.",
     "email": "hello@tldraw.com"
@@ -47,18 +47,18 @@
   "devDependencies": {
     "kleur": "^4.1.5",
     "lazyrepo": "0.0.0-alpha.27",
-    "react": "^18.3.1",
+    "react": "^19.2.1",
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@tldraw/state": "4.3.0-next.2d181ae353a2",
-    "@tldraw/store": "4.3.0-next.2d181ae353a2",
-    "@tldraw/utils": "4.3.0-next.2d181ae353a2",
-    "@tldraw/validate": "4.3.0-next.2d181ae353a2"
+    "@tldraw/state": "4.3.0-next.40e4536afc8e",
+    "@tldraw/store": "4.3.0-next.40e4536afc8e",
+    "@tldraw/utils": "4.3.0-next.40e4536afc8e",
+    "@tldraw/validate": "4.3.0-next.40e4536afc8e"
   },
   "peerDependencies": {
-    "react": "^18.2.0 || ^19.0.0",
-    "react-dom": "^18.2.0 || ^19.0.0"
+    "react": "^18.2.0 || ^19.2.1",
+    "react-dom": "^18.2.0 || ^19.2.1"
   },
   "module": "dist-esm/index.mjs",
   "source": "src/index.ts",

package/src/__tests__/migrationTestUtils.ts

@@ -1,4 +1,4 @@
-import { Migration, MigrationId } from '@tldraw/store'
+import { devFreeze, Migration, MigrationId } from '@tldraw/store'
 import { mockUniqueId, structuredClone } from '@tldraw/utils'
 import { vi } from 'vitest'
 import { createTLSchema } from '../createTLSchema'
@@ -25,8 +25,14 @@ export function getTestMigration(migrationId: MigrationId) {
 		id: migrationId,
 		up: (stuff: any) => {
 			nextNanoId = 0
-			const result = structuredClone(stuff)
-			return migration.up(result) ?? result
+			if (migration.scope === 'record' || migration.scope === 'store') {
+				const result = structuredClone(stuff)
+				return migration.up(result) ?? result
+			}
+			const storage =
+				typeof stuff.entries === 'function' ? stuff : new Map(Object.entries(stuff).map(devFreeze))
+			migration.up(storage)
+			return typeof stuff.entries === 'function' ? storage : Object.fromEntries(storage.entries())
 		},
 		down: (stuff: any) => {
 			nextNanoId = 0

package/src/index.ts

@@ -191,6 +191,7 @@ export {
 	type TLBookmarkShapeProps,
 } from './shapes/TLBookmarkShape'
 export {
+	compressLegacySegments,
 	drawShapeMigrations,
 	drawShapeProps,
 	type TLDrawShape,
@@ -313,3 +314,5 @@ registerTldrawLibraryVersion(
 	(globalThis as any).TLDRAW_LIBRARY_VERSION,
 	(globalThis as any).TLDRAW_LIBRARY_MODULES
 )
+
+export { b64Vecs } from './misc/b64Vecs'

package/src/migrations.test.ts

@@ -16,7 +16,7 @@ import { instancePresenceVersions } from './records/TLPresence'
 import { TLShape, rootShapeVersions } from './records/TLShape'
 import { arrowShapeVersions } from './shapes/TLArrowShape'
 import { bookmarkShapeVersions } from './shapes/TLBookmarkShape'
-import { drawShapeVersions } from './shapes/TLDrawShape'
+import { compressLegacySegments, drawShapeVersions } from './shapes/TLDrawShape'
 import { embedShapeVersions } from './shapes/TLEmbedShape'
 import { frameShapeVersions } from './shapes/TLFrameShape'
 import { geoShapeVersions } from './shapes/TLGeoShape'
@@ -1444,6 +1444,32 @@ describe('Add rich text', () => {
 	}
 })
 
+describe('Add rich text attrs', () => {
+	const migrations = [
+		['text shape', getTestMigration(textShapeVersions.AddRichTextAttrs)],
+		['geo shape', getTestMigration(geoShapeVersions.AddRichTextAttrs)],
+		['note shape', getTestMigration(noteShapeVersions.AddRichTextAttrs)],
+		['arrow shape', getTestMigration(arrowShapeVersions.AddRichTextAttrs)],
+	] as const
+
+	for (const [shapeName, { up, down }] of migrations) {
+		it(`works for ${shapeName}`, () => {
+			const shape = { props: { richText: toRichText('hello, world') } }
+			const shapeWithAttrs = {
+				props: { richText: { ...toRichText('hello, world'), attrs: { test: 'value' } } },
+			}
+
+			// Up migration should be a noop
+			expect(up(shape)).toEqual(shape)
+			expect(up(shapeWithAttrs)).toEqual(shapeWithAttrs)
+
+			// Down migration should remove attrs
+			expect(down(shapeWithAttrs)).toEqual(shape)
+			expect(down(shape)).toEqual(shape)
+		})
+	}
+})
+
 describe('Make urls valid for all the assets', () => {
 	const migrations = [
 		['bookmark asset', getTestMigration(bookmarkAssetVersions.MakeUrlsValid)],
@@ -2242,6 +2268,128 @@ describe('TLVideoAsset AddAutoplay', () => {
 	})
 })
 
+describe('Add scaleX, scaleY, and new base64 format to draw shape', () => {
+	const { up, down } = getTestMigration(drawShapeVersions.Base64)
+
+	test('up works as expected', () => {
+		const legacySegments = [
+			{
+				type: 'free',
+				points: [
+					{ x: 0, y: 0, z: 0.5 },
+					{ x: 10, y: 10, z: 0.6 },
+					{ x: 20, y: 20, z: 0.7 },
+				],
+			},
+			{
+				type: 'straight',
+				points: [
+					{ x: 20, y: 20, z: 0.7 },
+					{ x: 30, y: 30, z: 0.8 },
+				],
+			},
+		]
+		expect(
+			up({
+				props: {
+					segments: legacySegments,
+				},
+			})
+		).toEqual({
+			props: {
+				scaleX: 1,
+				scaleY: 1,
+				segments: compressLegacySegments(legacySegments as any),
+			},
+		})
+	})
+
+	test('down works as expected', () => {
+		const legacySegments = [
+			{
+				type: 'free',
+				points: [
+					{ x: 0, y: 0, z: 0.5 },
+					{ x: 10, y: 10, z: 0.6 },
+				],
+			},
+		]
+		const compressed = compressLegacySegments(legacySegments as any)
+		const result = down({
+			props: {
+				scaleX: 1,
+				scaleY: 1,
+				segments: compressed,
+			},
+		})
+		expect(result.props.scaleX).toBeUndefined()
+		expect(result.props.scaleY).toBeUndefined()
+		expect(Array.isArray(result.props.segments[0].points)).toBe(true)
+		expect(result.props.segments[0].points.length).toBe(2)
+	})
+})
+
+describe('Add scaleX, scaleY, and new base64 format to highlight shape', () => {
+	const { up, down } = getTestMigration(highlightShapeVersions.Base64)
+
+	test('up works as expected', () => {
+		const legacySegments = [
+			{
+				type: 'free',
+				points: [
+					{ x: 0, y: 0, z: 0.5 },
+					{ x: 10, y: 10, z: 0.6 },
+					{ x: 20, y: 20, z: 0.7 },
+				],
+			},
+			{
+				type: 'straight',
+				points: [
+					{ x: 20, y: 20, z: 0.7 },
+					{ x: 30, y: 30, z: 0.8 },
+				],
+			},
+		]
+		expect(
+			up({
+				props: {
+					segments: legacySegments,
+				},
+			})
+		).toEqual({
+			props: {
+				scaleX: 1,
+				scaleY: 1,
+				segments: compressLegacySegments(legacySegments as any),
+			},
+		})
+	})
+
+	test('down works as expected', () => {
+		const legacySegments = [
+			{
+				type: 'free',
+				points: [
+					{ x: 0, y: 0, z: 0.5 },
+					{ x: 10, y: 10, z: 0.6 },
+				],
+			},
+		]
+		const compressed = compressLegacySegments(legacySegments as any)
+		const result = down({
+			props: {
+				scaleX: 1,
+				scaleY: 1,
+				segments: compressed,
+			},
+		})
+		expect(result.props.scaleX).toBeUndefined()
+		expect(result.props.scaleY).toBeUndefined()
+		expect(Array.isArray(result.props.segments[0].points)).toBe(true)
+		expect(result.props.segments[0].points.length).toBe(2)
+	})
+})
+
 /* ---  PUT YOUR MIGRATIONS TESTS ABOVE HERE --- */
 
 // check that all migrator fns were called at least once

package/src/misc/TLOpacity.ts

@@ -53,8 +53,4 @@ export type TLOpacityType = number
  *
  * @public
  */
-export const opacityValidator = T.number.check((n) => {
-	if (n < 0 || n > 1) {
-		throw new T.ValidationError('Opacity must be between 0 and 1')
-	}
-})
+export const opacityValidator = T.unitInterval

package/src/misc/TLRichText.ts

@@ -12,7 +12,12 @@ import { T } from '@tldraw/validate'
  * const isValid = richTextValidator.check(richText) // true
  * ```
  */
-export const richTextValidator = T.object({ type: T.string, content: T.arrayOf(T.unknown) })
+
+export const richTextValidator = T.object({
+	type: T.string,
+	content: T.arrayOf(T.unknown),
+	attrs: T.any.optional(),
+})
 
 /**
  * Type representing rich text content in tldraw. Rich text follows a document-based

package/src/misc/b64Vecs.ts

@@ -0,0 +1,308 @@
+import { VecModel } from './geometry-types'
+
+// Each point = 3 Float16s = 6 bytes = 8 base64 chars
+const POINT_B64_LENGTH = 8
+
+// O(1) lookup table for base64 decoding (maps char code -> 6-bit value)
+const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'
+const B64_LOOKUP = new Uint8Array(128)
+for (let i = 0; i < 64; i++) {
+	B64_LOOKUP[BASE64_CHARS.charCodeAt(i)] = i
+}
+
+// Precomputed powers of 2 for Float16 exponents (exp - 15, so indices 0-30 map to 2^-15 to 2^15)
+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 // For subnormal numbers
+
+// Precomputed mantissa values: 1 + frac/1024 for all 1024 possible frac values
+// Avoids division in hot path
+const MANTISSA = new Float64Array(1024)
+for (let i = 0; i < 1024; i++) {
+	MANTISSA[i] = 1 + i / 1024
+}
+
+/**
+ * Convert a Uint16Array (containing Float16 bits) to base64.
+ * Processes bytes in groups of 3 to produce 4 base64 characters.
+ *
+ * @internal
+ */
+function uint16ArrayToBase64(uint16Array: Uint16Array): string {
+	const uint8Array = new Uint8Array(
+		uint16Array.buffer,
+		uint16Array.byteOffset,
+		uint16Array.byteLength
+	)
+	let result = ''
+
+	// Process bytes in groups of 3 -> 4 base64 chars
+	for (let i = 0; i < uint8Array.length; i += 3) {
+		const byte1 = uint8Array[i]
+		const byte2 = uint8Array[i + 1] // Always exists for our use case (multiple of 6 bytes)
+		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
+}
+
+/**
+ * Convert a base64 string to Uint16Array containing Float16 bits.
+ * The base64 string must have a length that is a multiple of 4.
+ *
+ * @param base64 - The base64-encoded string to decode
+ * @returns A Uint16Array containing the decoded Float16 bit values
+ * @public
+ */
+function base64ToUint16Array(base64: string): Uint16Array {
+	// Calculate exact number of bytes (4 base64 chars = 3 bytes)
+	const numBytes = Math.floor((base64.length * 3) / 4)
+	const bytes = new Uint8Array(numBytes)
+	let byteIndex = 0
+
+	// Process in groups of 4 base64 characters
+	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 new Uint16Array(bytes.buffer, bytes.byteOffset, bytes.byteLength / 2)
+}
+
+/**
+ * Convert Float16 bits to a number using optimized lookup tables.
+ * Handles normal numbers, subnormal numbers, zero, infinity, and NaN.
+ *
+ * @param bits - The 16-bit Float16 value to decode
+ * @returns The decoded number value
+ */
+function float16BitsToNumber(bits: number): number {
+	const sign = bits >> 15
+	const exp = (bits >> 10) & 0x1f
+	const frac = bits & 0x3ff
+
+	if (exp === 0) {
+		// Subnormal or zero - rare case
+		return sign ? -frac * POW2_SUBNORMAL : frac * POW2_SUBNORMAL
+	}
+	if (exp === 31) {
+		// Infinity or NaN - very rare
+		return frac ? NaN : sign ? -Infinity : Infinity
+	}
+	// Normal case - two table lookups, one multiply, no division
+	const magnitude = POW2[exp] * MANTISSA[frac]
+	return sign ? -magnitude : magnitude
+}
+
+/**
+ * Convert a number to Float16 bits.
+ * Handles normal numbers, subnormal numbers, zero, infinity, and NaN.
+ *
+ * @param value - The number to encode as Float16
+ * @returns The 16-bit Float16 representation of the number
+ * @internal
+ */
+function numberToFloat16Bits(value: number): number {
+	if (value === 0) return Object.is(value, -0) ? 0x8000 : 0
+	if (!Number.isFinite(value)) {
+		if (Number.isNaN(value)) return 0x7e00
+		return value > 0 ? 0x7c00 : 0xfc00
+	}
+
+	const sign = value < 0 ? 1 : 0
+	value = Math.abs(value)
+
+	// Find exponent and mantissa
+	const exp = Math.floor(Math.log2(value))
+	let expBiased = exp + 15
+
+	if (expBiased >= 31) {
+		// Overflow to infinity
+		return (sign << 15) | 0x7c00
+	}
+	if (expBiased <= 0) {
+		// Subnormal or underflow
+		const frac = Math.round(value * Math.pow(2, 14) * 1024)
+		return (sign << 15) | (frac & 0x3ff)
+	}
+
+	// Normal number
+	const mantissa = value / Math.pow(2, exp) - 1
+	let frac = Math.round(mantissa * 1024)
+
+	// Handle rounding overflow: if frac rounds to 1024, increment exponent
+	if (frac >= 1024) {
+		frac = 0
+		expBiased++
+		if (expBiased >= 31) {
+			// Overflow to infinity
+			return (sign << 15) | 0x7c00
+		}
+	}
+
+	return (sign << 15) | (expBiased << 10) | frac
+}
+
+/**
+ * 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 class b64Vecs {
+	/**
+	 * Encode a single point (x, y, z) to 8 base64 characters.
+	 * 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
+	 */
+	static encodePoint(x: number, y: number, z: number): string {
+		const xBits = numberToFloat16Bits(x)
+		const yBits = numberToFloat16Bits(y)
+		const zBits = numberToFloat16Bits(z)
+
+		// Convert Float16 bits to 6 bytes (little-endian)
+		const b0 = xBits & 0xff
+		const b1 = (xBits >> 8) & 0xff
+		const b2 = yBits & 0xff
+		const b3 = (yBits >> 8) & 0xff
+		const b4 = zBits & 0xff
+		const b5 = (zBits >> 8) & 0xff
+
+		// Convert 6 bytes to 8 base64 chars
+		const bitmap1 = (b0 << 16) | (b1 << 8) | b2
+		const bitmap2 = (b3 << 16) | (b4 << 8) | b5
+
+		return (
+			BASE64_CHARS[(bitmap1 >> 18) & 0x3f] +
+			BASE64_CHARS[(bitmap1 >> 12) & 0x3f] +
+			BASE64_CHARS[(bitmap1 >> 6) & 0x3f] +
+			BASE64_CHARS[bitmap1 & 0x3f] +
+			BASE64_CHARS[(bitmap2 >> 18) & 0x3f] +
+			BASE64_CHARS[(bitmap2 >> 12) & 0x3f] +
+			BASE64_CHARS[(bitmap2 >> 6) & 0x3f] +
+			BASE64_CHARS[bitmap2 & 0x3f]
+		)
+	}
+
+	/**
+	 * Convert an array of VecModels to a base64 string for compact storage.
+	 * 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
+	 */
+	static encodePoints(points: VecModel[]): string {
+		const uint16s = new Uint16Array(points.length * 3)
+		for (let i = 0; i < points.length; i++) {
+			const p = points[i]
+			uint16s[i * 3] = numberToFloat16Bits(p.x)
+			uint16s[i * 3 + 1] = numberToFloat16Bits(p.y)
+			uint16s[i * 3 + 2] = numberToFloat16Bits(p.z ?? 0.5)
+		}
+		return uint16ArrayToBase64(uint16s)
+	}
+
+	/**
+	 * Convert a 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
+	 */
+	static decodePoints(base64: string): VecModel[] {
+		const uint16s = base64ToUint16Array(base64)
+		const result: VecModel[] = []
+		for (let i = 0; i < uint16s.length; i += 3) {
+			result.push({
+				x: float16BitsToNumber(uint16s[i]),
+				y: float16BitsToNumber(uint16s[i + 1]),
+				z: float16BitsToNumber(uint16s[i + 2]),
+			})
+		}
+		return result
+	}
+
+	/**
+	 * Decode a single point (8 base64 chars) starting at the given offset.
+	 * Each point is encoded as 3 Float16 values (x, y, z) in 8 base64 characters.
+	 *
+	 * @param b64Points - The base64-encoded string containing point data
+	 * @param charOffset - The character offset where the point starts (must be a multiple of 8)
+	 * @returns A VecModel object with x, y, and z coordinates
+	 * @internal
+	 */
+	static decodePointAt(b64Points: string, charOffset: number): VecModel {
+		// Decode 8 base64 chars -> 6 bytes -> 3 Float16s using O(1) lookup
+		const c0 = B64_LOOKUP[b64Points.charCodeAt(charOffset)]
+		const c1 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 1)]
+		const c2 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 2)]
+		const c3 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 3)]
+		const c4 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 4)]
+		const c5 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 5)]
+		const c6 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 6)]
+		const c7 = B64_LOOKUP[b64Points.charCodeAt(charOffset + 7)]
+
+		// 4 base64 chars -> 24 bits -> 3 bytes
+		const bitmap1 = (c0 << 18) | (c1 << 12) | (c2 << 6) | c3
+		const bitmap2 = (c4 << 18) | (c5 << 12) | (c6 << 6) | c7
+
+		// Extract Float16 bits directly (little-endian byte order)
+		// bitmap1 = [byte0:8][byte1:8][byte2:8], bitmap2 = [byte3:8][byte4:8][byte5:8]
+		// xBits = byte0 | (byte1 << 8), yBits = byte2 | (byte3 << 8), zBits = byte4 | (byte5 << 8)
+		const xBits = ((bitmap1 >> 16) & 0xff) | (bitmap1 & 0xff00)
+		const yBits = (bitmap1 & 0xff) | ((bitmap2 >> 8) & 0xff00)
+		const zBits = ((bitmap2 >> 8) & 0xff) | ((bitmap2 << 8) & 0xff00)
+
+		return {
+			x: float16BitsToNumber(xBits),
+			y: float16BitsToNumber(yBits),
+			z: float16BitsToNumber(zBits),
+		}
+	}
+
+	/**
+	 * Get the first point from a base64-encoded string of points.
+	 *
+	 * @param b64Points - The base64-encoded string containing point data
+	 * @returns The first point as a VecModel, or null if the string is too short
+	 * @public
+	 */
+	static decodeFirstPoint(b64Points: string): VecModel | null {
+		if (b64Points.length < POINT_B64_LENGTH) return null
+		return b64Vecs.decodePointAt(b64Points, 0)
+	}
+
+	/**
+	 * Get the last point from a base64-encoded string of points.
+	 *
+	 * @param b64Points - The base64-encoded string containing point data
+	 * @returns The last point as a VecModel, or null if the string is too short
+	 */
+	static decodeLastPoint(b64Points: string): VecModel | null {
+		if (b64Points.length < POINT_B64_LENGTH) return null
+		return b64Vecs.decodePointAt(b64Points, b64Points.length - POINT_B64_LENGTH)
+	}
+}