@bigbluebutton/tlschema 2.0.0-alpha.19

package/dist-esm/styles/TLHorizontalAlignStyle.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/styles/TLHorizontalAlignStyle.ts"],
+  "sourcesContent": ["import { T } from '@bigbluebutton/validate'\nimport { StyleProp } from './StyleProp'\n\n/** @public */\nexport const DefaultHorizontalAlignStyle = StyleProp.defineEnum('tldraw:horizontalAlign', {\n\tdefaultValue: 'middle',\n\tvalues: ['start', 'middle', 'end', 'start-legacy', 'end-legacy', 'middle-legacy'],\n})\n\n/** @public */\nexport type TLDefaultHorizontalAlignStyle = T.TypeOf<typeof DefaultHorizontalAlignStyle>\n"],
+  "mappings": "AACA,SAAS,iBAAiB;AAGnB,MAAM,8BAA8B,UAAU,WAAW,0BAA0B;AAAA,EACzF,cAAc;AAAA,EACd,QAAQ,CAAC,SAAS,UAAU,OAAO,gBAAgB,cAAc,eAAe;AACjF,CAAC;",
+  "names": []
+}

package/dist-esm/styles/TLSizeStyle.mjs

@@ -0,0 +1,9 @@
+import { StyleProp } from "./StyleProp.mjs";
+const DefaultSizeStyle = StyleProp.defineEnum("tldraw:size", {
+  defaultValue: "m",
+  values: ["s", "m", "l", "xl"]
+});
+export {
+  DefaultSizeStyle
+};
+//# sourceMappingURL=TLSizeStyle.mjs.map

package/dist-esm/styles/TLSizeStyle.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/styles/TLSizeStyle.ts"],
+  "sourcesContent": ["import { T } from '@bigbluebutton/validate'\nimport { StyleProp } from './StyleProp'\n\n/** @public */\nexport const DefaultSizeStyle = StyleProp.defineEnum('tldraw:size', {\n\tdefaultValue: 'm',\n\tvalues: ['s', 'm', 'l', 'xl'],\n})\n\n/** @public */\nexport type TLDefaultSizeStyle = T.TypeOf<typeof DefaultSizeStyle>\n"],
+  "mappings": "AACA,SAAS,iBAAiB;AAGnB,MAAM,mBAAmB,UAAU,WAAW,eAAe;AAAA,EACnE,cAAc;AAAA,EACd,QAAQ,CAAC,KAAK,KAAK,KAAK,IAAI;AAC7B,CAAC;",
+  "names": []
+}

package/dist-esm/styles/TLVerticalAlignStyle.mjs

@@ -0,0 +1,9 @@
+import { StyleProp } from "./StyleProp.mjs";
+const DefaultVerticalAlignStyle = StyleProp.defineEnum("tldraw:verticalAlign", {
+  defaultValue: "middle",
+  values: ["start", "middle", "end"]
+});
+export {
+  DefaultVerticalAlignStyle
+};
+//# sourceMappingURL=TLVerticalAlignStyle.mjs.map

package/dist-esm/styles/TLVerticalAlignStyle.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/styles/TLVerticalAlignStyle.ts"],
+  "sourcesContent": ["import { T } from '@bigbluebutton/validate'\nimport { StyleProp } from './StyleProp'\n\n/** @public */\nexport const DefaultVerticalAlignStyle = StyleProp.defineEnum('tldraw:verticalAlign', {\n\tdefaultValue: 'middle',\n\tvalues: ['start', 'middle', 'end'],\n})\n\n/** @public */\nexport type TLDefaultVerticalAlignStyle = T.TypeOf<typeof DefaultVerticalAlignStyle>\n"],
+  "mappings": "AACA,SAAS,iBAAiB;AAGnB,MAAM,4BAA4B,UAAU,WAAW,wBAAwB;AAAA,EACrF,cAAc;AAAA,EACd,QAAQ,CAAC,SAAS,UAAU,KAAK;AAClC,CAAC;",
+  "names": []
+}

package/dist-esm/translations/languages.mjs

@@ -0,0 +1,39 @@
+const LANGUAGES = [
+  { locale: "ar", label: "\u0639\u0631\u0628\u064A" },
+  { locale: "ca", label: "Catal\xE0" },
+  { locale: "da", label: "Danish" },
+  { locale: "de", label: "Deutsch" },
+  { locale: "en", label: "English" },
+  { locale: "es", label: "Espa\xF1ol" },
+  { locale: "fa", label: "\u0641\u0627\u0631\u0633\u06CC" },
+  { locale: "fi", label: "Suomi" },
+  { locale: "fr", label: "Fran\xE7ais" },
+  { locale: "gl", label: "Galego" },
+  { locale: "he", label: "\u05E2\u05D1\u05E8\u05D9\u05EA" },
+  { locale: "it", label: "Italiano" },
+  { locale: "ja", label: "\u65E5\u672C\u8A9E" },
+  { locale: "ko-kr", label: "\uD55C\uAD6D\uC5B4" },
+  { locale: "ku", label: "\u06A9\u0648\u0631\u062F\u06CC" },
+  { locale: "hi-in", label: "\u0939\u093F\u0928\u094D\u0926\u0940" },
+  { locale: "hu", label: "Magyar" },
+  { locale: "my", label: "\u1019\u103C\u1014\u103A\u1019\u102C\u1005\u102C" },
+  { locale: "ne", label: "\u0928\u0947\u092A\u093E\u0932\u0940" },
+  { locale: "no", label: "Norwegian" },
+  { locale: "pl", label: "Polski" },
+  { locale: "pt-br", label: "Portugu\xEAs - Brasil" },
+  { locale: "pt-pt", label: "Portugu\xEAs - Europeu" },
+  { locale: "ro", label: "Rom\xE2n\u0103" },
+  { locale: "ru", label: "Russian" },
+  { locale: "sv", label: "Svenska" },
+  { locale: "te", label: "\u0C24\u0C46\u0C32\u0C41\u0C17\u0C41" },
+  { locale: "th", label: "\u0E20\u0E32\u0E29\u0E32\u0E44\u0E17\u0E22" },
+  { locale: "tr", label: "T\xFCrk\xE7e" },
+  { locale: "uk", label: "Ukrainian" },
+  { locale: "vi", label: "Ti\u1EBFng Vi\u1EC7t" },
+  { locale: "zh-cn", label: "Chinese - Simplified" },
+  { locale: "zh-tw", label: "\u7E41\u9AD4\u4E2D\u6587 (\u53F0\u7063)" }
+];
+export {
+  LANGUAGES
+};
+//# sourceMappingURL=languages.mjs.map

package/dist-esm/translations/languages.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/translations/languages.ts"],
+  "sourcesContent": ["// This file is automatically generated by scripts/refresh-assets.ts.\n// Do not edit manually.\n\n/** @public */\nexport const LANGUAGES = [\n\t{ locale: 'ar', label: '\u0639\u0631\u0628\u064A' },\n\t{ locale: 'ca', label: 'Catal\u00E0' },\n\t{ locale: 'da', label: 'Danish' },\n\t{ locale: 'de', label: 'Deutsch' },\n\t{ locale: 'en', label: 'English' },\n\t{ locale: 'es', label: 'Espa\u00F1ol' },\n\t{ locale: 'fa', label: '\u0641\u0627\u0631\u0633\u06CC' },\n\t{ locale: 'fi', label: 'Suomi' },\n\t{ locale: 'fr', label: 'Fran\u00E7ais' },\n\t{ locale: 'gl', label: 'Galego' },\n\t{ locale: 'he', label: '\u05E2\u05D1\u05E8\u05D9\u05EA' },\n\t{ locale: 'it', label: 'Italiano' },\n\t{ locale: 'ja', label: '\u65E5\u672C\u8A9E' },\n\t{ locale: 'ko-kr', label: '\uD55C\uAD6D\uC5B4' },\n\t{ locale: 'ku', label: '\u06A9\u0648\u0631\u062F\u06CC' },\n\t{ locale: 'hi-in', label: '\u0939\u093F\u0928\u094D\u0926\u0940' },\n\t{ locale: 'hu', label: 'Magyar' },\n\t{ locale: 'my', label: '\u1019\u103C\u1014\u103A\u1019\u102C\u1005\u102C' },\n\t{ locale: 'ne', label: '\u0928\u0947\u092A\u093E\u0932\u0940' },\n\t{ locale: 'no', label: 'Norwegian' },\n\t{ locale: 'pl', label: 'Polski' },\n\t{ locale: 'pt-br', label: 'Portugu\u00EAs - Brasil' },\n\t{ locale: 'pt-pt', label: 'Portugu\u00EAs - Europeu' },\n\t{ locale: 'ro', label: 'Rom\u00E2n\u0103' },\n\t{ locale: 'ru', label: 'Russian' },\n\t{ locale: 'sv', label: 'Svenska' },\n\t{ locale: 'te', label: '\u0C24\u0C46\u0C32\u0C41\u0C17\u0C41' },\n\t{ locale: 'th', label: '\u0E20\u0E32\u0E29\u0E32\u0E44\u0E17\u0E22' },\n\t{ locale: 'tr', label: 'T\u00FCrk\u00E7e' },\n\t{ locale: 'uk', label: 'Ukrainian' },\n\t{ locale: 'vi', label: 'Ti\u1EBFng Vi\u1EC7t' },\n\t{ locale: 'zh-cn', label: 'Chinese - Simplified' },\n\t{ locale: 'zh-tw', label: '\u7E41\u9AD4\u4E2D\u6587 (\u53F0\u7063)' },\n] as const\n"],
+  "mappings": "AAIO,MAAM,YAAY;AAAA,EACxB,EAAE,QAAQ,MAAM,OAAO,2BAAO;AAAA,EAC9B,EAAE,QAAQ,MAAM,OAAO,YAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,SAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,UAAU;AAAA,EACjC,EAAE,QAAQ,MAAM,OAAO,UAAU;AAAA,EACjC,EAAE,QAAQ,MAAM,OAAO,aAAU;AAAA,EACjC,EAAE,QAAQ,MAAM,OAAO,iCAAQ;AAAA,EAC/B,EAAE,QAAQ,MAAM,OAAO,QAAQ;AAAA,EAC/B,EAAE,QAAQ,MAAM,OAAO,cAAW;AAAA,EAClC,EAAE,QAAQ,MAAM,OAAO,SAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,iCAAQ;AAAA,EAC/B,EAAE,QAAQ,MAAM,OAAO,WAAW;AAAA,EAClC,EAAE,QAAQ,MAAM,OAAO,qBAAM;AAAA,EAC7B,EAAE,QAAQ,SAAS,OAAO,qBAAM;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,iCAAQ;AAAA,EAC/B,EAAE,QAAQ,SAAS,OAAO,uCAAS;AAAA,EACnC,EAAE,QAAQ,MAAM,OAAO,SAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,mDAAW;AAAA,EAClC,EAAE,QAAQ,MAAM,OAAO,uCAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,YAAY;AAAA,EACnC,EAAE,QAAQ,MAAM,OAAO,SAAS;AAAA,EAChC,EAAE,QAAQ,SAAS,OAAO,wBAAqB;AAAA,EAC/C,EAAE,QAAQ,SAAS,OAAO,yBAAsB;AAAA,EAChD,EAAE,QAAQ,MAAM,OAAO,iBAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,UAAU;AAAA,EACjC,EAAE,QAAQ,MAAM,OAAO,UAAU;AAAA,EACjC,EAAE,QAAQ,MAAM,OAAO,uCAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,6CAAU;AAAA,EACjC,EAAE,QAAQ,MAAM,OAAO,eAAS;AAAA,EAChC,EAAE,QAAQ,MAAM,OAAO,YAAY;AAAA,EACnC,EAAE,QAAQ,MAAM,OAAO,uBAAa;AAAA,EACpC,EAAE,QAAQ,SAAS,OAAO,uBAAuB;AAAA,EACjD,EAAE,QAAQ,SAAS,OAAO,0CAAY;AACvC;",
+  "names": []
+}

package/dist-esm/translations/translations.mjs

@@ -0,0 +1,43 @@
+import { LANGUAGES } from "./languages.mjs";
+function getDefaultTranslationLocale() {
+  const locales = typeof window !== "undefined" ? window.navigator.languages ?? ["en"] : ["en"];
+  return _getDefaultTranslationLocale(locales);
+}
+function _getDefaultTranslationLocale(locales) {
+  for (const locale of locales) {
+    const supportedLocale = getSupportedLocale(locale);
+    if (supportedLocale) {
+      return supportedLocale;
+    }
+  }
+  return "en";
+}
+const DEFAULT_LOCALE_REGIONS = {
+  zh: "zh-cn",
+  pt: "pt-br",
+  ko: "ko-kr",
+  hi: "hi-in"
+};
+function getSupportedLocale(locale) {
+  const exactMatch = LANGUAGES.find((t) => t.locale === locale.toLowerCase());
+  if (exactMatch) {
+    return exactMatch.locale;
+  }
+  const [language, region] = locale.split(/[-_]/).map((s) => s.toLowerCase());
+  if (region) {
+    const languageMatch = LANGUAGES.find((t) => t.locale === language);
+    if (languageMatch) {
+      return languageMatch.locale;
+    }
+  }
+  if (language in DEFAULT_LOCALE_REGIONS) {
+    return DEFAULT_LOCALE_REGIONS[language];
+  }
+  return null;
+}
+export {
+  LANGUAGES,
+  _getDefaultTranslationLocale,
+  getDefaultTranslationLocale
+};
+//# sourceMappingURL=translations.mjs.map

package/dist-esm/translations/translations.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/translations/translations.ts"],
+  "sourcesContent": ["import { LANGUAGES } from './languages'\n\n/** @public */\nexport { LANGUAGES }\n\n/** @public */\nexport type TLLanguage = (typeof LANGUAGES)[number]\n// {\n// \treadonly locale: string\n// \treadonly label: string\n// }\n\n/** @public */\nexport function getDefaultTranslationLocale(): TLLanguage['locale'] {\n\tconst locales = typeof window !== 'undefined' ? window.navigator.languages ?? ['en'] : ['en']\n\treturn _getDefaultTranslationLocale(locales)\n}\n\n/** @internal */\nexport function _getDefaultTranslationLocale(locales: readonly string[]): TLLanguage['locale'] {\n\tfor (const locale of locales) {\n\t\tconst supportedLocale = getSupportedLocale(locale)\n\t\tif (supportedLocale) {\n\t\t\treturn supportedLocale\n\t\t}\n\t}\n\treturn 'en'\n}\n\n/** @public */\nconst DEFAULT_LOCALE_REGIONS: { [locale: string]: TLLanguage['locale'] } = {\n\tzh: 'zh-cn',\n\tpt: 'pt-br',\n\tko: 'ko-kr',\n\thi: 'hi-in',\n}\n\n/** @public */\nfunction getSupportedLocale(locale: string): TLLanguage['locale'] | null {\n\t// If we have an exact match, return it!\n\t// (e.g. if the user has 'fr' and we have 'fr')\n\t// (or if the user has 'pt-BR' and we have 'pt-br')\n\tconst exactMatch = LANGUAGES.find((t) => t.locale === locale.toLowerCase())\n\tif (exactMatch) {\n\t\treturn exactMatch.locale\n\t}\n\n\t// Otherwise, we need to be more flexible...\n\tconst [language, region] = locale.split(/[-_]/).map((s) => s.toLowerCase())\n\n\t// If the user's language has a region...\n\t// let's try to find non-region-specific locale for them\n\t// (e.g. if they have 'fr-CA' but we only have 'fr')\n\tif (region) {\n\t\tconst languageMatch = LANGUAGES.find((t) => t.locale === language)\n\t\tif (languageMatch) {\n\t\t\treturn languageMatch.locale\n\t\t}\n\t}\n\n\t// If the user's language doesn't have a region...\n\t// let's try to find a region-specific locale for them\n\t// (e.g. if they have 'pt' but we only have 'pt-pt' or 'pt-br')\n\t//\n\t// In this case, we choose the hard-coded default region for that language\n\tif (language in DEFAULT_LOCALE_REGIONS) {\n\t\treturn DEFAULT_LOCALE_REGIONS[language]\n\t}\n\n\t// Oh no! We don't have a translation for this language!\n\t// Let's give up...\n\treturn null\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAanB,SAAS,8BAAoD;AACnE,QAAM,UAAU,OAAO,WAAW,cAAc,OAAO,UAAU,aAAa,CAAC,IAAI,IAAI,CAAC,IAAI;AAC5F,SAAO,6BAA6B,OAAO;AAC5C;AAGO,SAAS,6BAA6B,SAAkD;AAC9F,aAAW,UAAU,SAAS;AAC7B,UAAM,kBAAkB,mBAAmB,MAAM;AACjD,QAAI,iBAAiB;AACpB,aAAO;AAAA,IACR;AAAA,EACD;AACA,SAAO;AACR;AAGA,MAAM,yBAAqE;AAAA,EAC1E,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACL;AAGA,SAAS,mBAAmB,QAA6C;AAIxE,QAAM,aAAa,UAAU,KAAK,CAAC,MAAM,EAAE,WAAW,OAAO,YAAY,CAAC;AAC1E,MAAI,YAAY;AACf,WAAO,WAAW;AAAA,EACnB;AAGA,QAAM,CAAC,UAAU,MAAM,IAAI,OAAO,MAAM,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC;AAK1E,MAAI,QAAQ;AACX,UAAM,gBAAgB,UAAU,KAAK,CAAC,MAAM,EAAE,WAAW,QAAQ;AACjE,QAAI,eAAe;AAClB,aAAO,cAAc;AAAA,IACtB;AAAA,EACD;AAOA,MAAI,YAAY,wBAAwB;AACvC,WAAO,uBAAuB,QAAQ;AAAA,EACvC;AAIA,SAAO;AACR;",
+  "names": []
+}

package/dist-esm/util-types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=util-types.mjs.map

package/dist-esm/util-types.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+	"name": "@bigbluebutton/tlschema",
+	"description": "BigBlueButton's fork of tldraw 2.0-alpha.19",
+	"version": "2.0.0-alpha.19",
+	"packageManager": "yarn@3.5.0",
+	"author": {
+		"name": "tldraw GB Ltd.",
+		"email": "hello@tldraw.com"
+	},
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/bigbluebutton/tldraw"
+	},
+	"bugs": {
+		"url": "https://github.com/bigbluebutton/tldraw/issues"
+	},
+	"main": "dist-cjs/index.js",
+	"files": [
+		"dist-esm",
+		"dist-cjs",
+		"src"
+	],
+	"scripts": {
+		"test": "lazy inherit",
+		"test-coverage": "lazy inherit",
+		"index": "node ./scripts/build-index.js && yarn format",
+		"format": "yarn run -T prettier --write --cache \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
+		"build": "yarn run -T tsx ../../scripts/build-package.ts",
+		"build-api": "yarn run -T tsx ../../scripts/build-api.ts",
+		"prepack": "yarn run -T tsx ../../scripts/prepack.ts",
+		"postpack": "../../scripts/postpack.sh",
+		"pack-tarball": "yarn pack",
+		"lint": "yarn run -T tsx ../../scripts/lint.ts"
+	},
+	"devDependencies": {
+		"kleur": "^4.1.5",
+		"lazyrepo": "0.0.0-alpha.27"
+	},
+	"jest": {
+		"preset": "config/jest/node",
+		"moduleNameMapper": {
+			"^~(.*)": "<rootDir>/src/$1"
+		},
+		"transformIgnorePatterns": [
+			"node_modules/(?!(nanoid)/)"
+		]
+	},
+	"dependencies": {
+		"@bigbluebutton/state": "2.0.0-alpha.19",
+		"@bigbluebutton/store": "2.0.0-alpha.19",
+		"@bigbluebutton/utils": "2.0.0-alpha.19",
+		"@bigbluebutton/validate": "2.0.0-alpha.19",
+		"nanoid": "4.0.2"
+	},
+	"module": "dist-esm/index.mjs",
+	"source": "src/index.ts",
+	"exports": {
+		".": {
+			"import": "./dist-esm/index.mjs",
+			"require": "./dist-cjs/index.js"
+		}
+	}
+}

package/src/TLStore.ts

@@ -0,0 +1,160 @@
+import {
+	SerializedStore,
+	Store,
+	StoreSchema,
+	StoreSchemaOptions,
+	StoreSnapshot,
+} from '@bigbluebutton/store'
+import { annotateError, structuredClone } from '@bigbluebutton/utils'
+import { CameraRecordType, TLCameraId } from './records/TLCamera'
+import { DocumentRecordType, TLDOCUMENT_ID } from './records/TLDocument'
+import { TLINSTANCE_ID } from './records/TLInstance'
+import { PageRecordType, TLPageId } from './records/TLPage'
+import { InstancePageStateRecordType, TLInstancePageStateId } from './records/TLPageState'
+import { PointerRecordType, TLPOINTER_ID } from './records/TLPointer'
+import { TLRecord } from './records/TLRecord'
+
+function sortByIndex<T extends { index: string }>(a: T, b: T) {
+	if (a.index < b.index) {
+		return -1
+	} else if (a.index > b.index) {
+		return 1
+	}
+	return 0
+}
+
+function redactRecordForErrorReporting(record: any) {
+	if (record.typeName === 'asset') {
+		if ('src' in record) {
+			record.src = '<redacted>'
+		}
+
+		if ('src' in record.props) {
+			record.props.src = '<redacted>'
+		}
+	}
+}
+
+/** @public */
+export type TLStoreSchema = StoreSchema<TLRecord, TLStoreProps>
+
+/** @public */
+export type TLSerializedStore = SerializedStore<TLRecord>
+
+/** @public */
+export type TLStoreSnapshot = StoreSnapshot<TLRecord>
+
+/** @public */
+export type TLStoreProps = {
+	defaultName: string
+}
+
+/** @public */
+export type TLStore = Store<TLRecord, TLStoreProps>
+
+/** @public */
+export const onValidationFailure: StoreSchemaOptions<
+	TLRecord,
+	TLStoreProps
+>['onValidationFailure'] = ({ error, phase, record, recordBefore }): TLRecord => {
+	const isExistingValidationIssue =
+		// if we're initializing the store for the first time, we should
+		// allow invalid records so people can load old buggy data:
+		phase === 'initialize'
+
+	annotateError(error, {
+		tags: {
+			origin: 'store.validateRecord',
+			storePhase: phase,
+			isExistingValidationIssue,
+		},
+		extras: {
+			recordBefore: recordBefore
+				? redactRecordForErrorReporting(structuredClone(recordBefore))
+				: undefined,
+			recordAfter: redactRecordForErrorReporting(structuredClone(record)),
+		},
+	})
+
+	throw error
+}
+
+function getDefaultPages() {
+	return [
+		PageRecordType.create({ id: 'page:page' as TLPageId, name: 'Page 1', index: 'a1', meta: {} }),
+	]
+}
+
+/** @internal */
+export function createIntegrityChecker(store: TLStore): () => void {
+	const $pageIds = store.query.ids('page')
+
+	const ensureStoreIsUsable = (): void => {
+		// make sure we have exactly one document
+		if (!store.has(TLDOCUMENT_ID)) {
+			store.put([DocumentRecordType.create({ id: TLDOCUMENT_ID, name: store.props.defaultName })])
+			return ensureStoreIsUsable()
+		}
+
+		if (!store.has(TLPOINTER_ID)) {
+			store.put([PointerRecordType.create({ id: TLPOINTER_ID })])
+			return ensureStoreIsUsable()
+		}
+
+		// make sure there is at least one page
+		const pageIds = $pageIds.get()
+		if (pageIds.size === 0) {
+			store.put(getDefaultPages())
+			return ensureStoreIsUsable()
+		}
+
+		const getFirstPageId = () => [...pageIds].map((id) => store.get(id)!).sort(sortByIndex)[0].id!
+
+		// make sure we have state for the current user's current tab
+		const instanceState = store.get(TLINSTANCE_ID)
+		if (!instanceState) {
+			store.put([
+				store.schema.types.instance.create({
+					id: TLINSTANCE_ID,
+					currentPageId: getFirstPageId(),
+					exportBackground: true,
+				}),
+			])
+
+			return ensureStoreIsUsable()
+		} else if (!pageIds.has(instanceState.currentPageId)) {
+			store.put([{ ...instanceState, currentPageId: getFirstPageId() }])
+			return ensureStoreIsUsable()
+		}
+
+		// make sure we have page states and cameras for all the pages
+		const missingPageStateIds = new Set<TLInstancePageStateId>()
+		const missingCameraIds = new Set<TLCameraId>()
+		for (const id of pageIds) {
+			const pageStateId = InstancePageStateRecordType.createId(id)
+			if (!store.has(pageStateId)) {
+				missingPageStateIds.add(pageStateId)
+			}
+			const cameraId = CameraRecordType.createId(id)
+			if (!store.has(cameraId)) {
+				missingCameraIds.add(cameraId)
+			}
+		}
+
+		if (missingPageStateIds.size > 0) {
+			store.put(
+				[...missingPageStateIds].map((id) =>
+					InstancePageStateRecordType.create({
+						id,
+						pageId: InstancePageStateRecordType.parseId(id) as TLPageId,
+					})
+				)
+			)
+		}
+		if (missingCameraIds.size > 0) {
+			store.put([...missingCameraIds].map((id) => CameraRecordType.create({ id })))
+		}
+	}
+
+	return ensureStoreIsUsable
+}

package/src/assets/TLBaseAsset.ts

@@ -0,0 +1,44 @@
+import { BaseRecord } from '@bigbluebutton/store'
+import { JsonObject } from '@bigbluebutton/utils'
+import { T } from '@bigbluebutton/validate'
+import { idValidator } from '../misc/id-validator'
+import { TLAssetId } from '../records/TLAsset'
+
+/** @public */
+export interface TLBaseAsset<Type extends string, Props> extends BaseRecord<'asset', TLAssetId> {
+	type: Type
+	props: Props
+	meta: JsonObject
+}
+
+/**
+ * A validator for asset record type Ids.
+ *
+ * @public */
+export const assetIdValidator = idValidator<TLAssetId>('asset')
+
+/**
+ * Create a validator for an asset record type.
+ *
+ * @param type - The type of the asset
+ * @param props - The validator for the asset's props
+ *
+ * @public */
+export function createAssetValidator<Type extends string, Props extends JsonObject>(
+	type: Type,
+	props: T.Validator<Props>
+): T.ObjectValidator<{
+	id: TLAssetId
+	typeName: 'asset'
+	type: Type
+	props: Props
+	meta: JsonObject
+}> {
+	return T.object({
+		id: assetIdValidator,
+		typeName: T.literal('asset'),
+		type: T.literal(type),
+		props,
+		meta: T.jsonValue as T.ObjectValidator<JsonObject>,
+	})
+}

package/src/assets/TLBookmarkAsset.ts

@@ -0,0 +1,31 @@
+import { defineMigrations } from '@bigbluebutton/store'
+import { T } from '@bigbluebutton/validate'
+import { createAssetValidator, TLBaseAsset } from './TLBaseAsset'
+
+/**
+ * An asset used for URL bookmarks, used by the TLBookmarkShape.
+ *
+ *  @public */
+export type TLBookmarkAsset = TLBaseAsset<
+	'bookmark',
+	{
+		title: string
+		description: string
+		image: string
+		src: string | null
+	}
+>
+
+/** @internal */
+export const bookmarkAssetValidator: T.Validator<TLBookmarkAsset> = createAssetValidator(
+	'bookmark',
+	T.object({
+		title: T.string,
+		description: T.string,
+		image: T.string,
+		src: T.string.nullable(),
+	})
+)
+
+/** @internal */
+export const bookmarkAssetMigrations = defineMigrations({})

package/src/assets/TLImageAsset.ts

@@ -0,0 +1,73 @@
+import { defineMigrations } from '@bigbluebutton/store'
+import { T } from '@bigbluebutton/validate'
+import { createAssetValidator, TLBaseAsset } from './TLBaseAsset'
+
+/**
+ * An asset for images such as PNGs and JPEGs, used by the TLImageShape.
+ *
+ * @public */
+export type TLImageAsset = TLBaseAsset<
+	'image',
+	{
+		w: number
+		h: number
+		name: string
+		isAnimated: boolean
+		mimeType: string | null
+		src: string | null
+	}
+>
+
+/** @internal */
+export const imageAssetValidator: T.Validator<TLImageAsset> = createAssetValidator(
+	'image',
+	T.object({
+		w: T.number,
+		h: T.number,
+		name: T.string,
+		isAnimated: T.boolean,
+		mimeType: T.string.nullable(),
+		src: T.string.nullable(),
+	})
+)
+
+const Versions = {
+	AddIsAnimated: 1,
+	RenameWidthHeight: 2,
+} as const
+
+/** @internal */
+export const imageAssetMigrations = defineMigrations({
+	currentVersion: Versions.RenameWidthHeight,
+	migrators: {
+		[Versions.AddIsAnimated]: {
+			up: (asset) => {
+				return {
+					...asset,
+					props: {
+						...asset.props,
+						isAnimated: false,
+					},
+				}
+			},
+			down: (asset) => {
+				// eslint-disable-next-line @typescript-eslint/no-unused-vars
+				const { isAnimated, ...rest } = asset.props
+				return {
+					...asset,
+					props: rest,
+				}
+			},
+		},
+		[Versions.RenameWidthHeight]: {
+			up: (asset) => {
+				const { width, height, ...others } = asset.props
+				return { ...asset, props: { w: width, h: height, ...others } }
+			},
+			down: (asset) => {
+				const { w, h, ...others } = asset.props
+				return { ...asset, props: { width: w, height: h, ...others } }
+			},
+		},
+	},
+})

package/src/assets/TLVideoAsset.ts

@@ -0,0 +1,73 @@
+import { defineMigrations } from '@bigbluebutton/store'
+import { T } from '@bigbluebutton/validate'
+import { createAssetValidator, TLBaseAsset } from './TLBaseAsset'
+
+/**
+ * An asset used for videos, used by the TLVideoShape.
+ *
+ * @public */
+export type TLVideoAsset = TLBaseAsset<
+	'video',
+	{
+		w: number
+		h: number
+		name: string
+		isAnimated: boolean
+		mimeType: string | null
+		src: string | null
+	}
+>
+
+/** @internal */
+export const videoAssetValidator: T.Validator<TLVideoAsset> = createAssetValidator(
+	'video',
+	T.object({
+		w: T.number,
+		h: T.number,
+		name: T.string,
+		isAnimated: T.boolean,
+		mimeType: T.string.nullable(),
+		src: T.string.nullable(),
+	})
+)
+
+const Versions = {
+	AddIsAnimated: 1,
+	RenameWidthHeight: 2,
+} as const
+
+/** @internal */
+export const videoAssetMigrations = defineMigrations({
+	currentVersion: Versions.RenameWidthHeight,
+	migrators: {
+		[Versions.AddIsAnimated]: {
+			up: (asset) => {
+				return {
+					...asset,
+					props: {
+						...asset.props,
+						isAnimated: false,
+					},
+				}
+			},
+			down: (asset) => {
+				// eslint-disable-next-line @typescript-eslint/no-unused-vars
+				const { isAnimated, ...rest } = asset.props
+				return {
+					...asset,
+					props: rest,
+				}
+			},
+		},
+		[Versions.RenameWidthHeight]: {
+			up: (asset) => {
+				const { width, height, ...others } = asset.props
+				return { ...asset, props: { w: width, h: height, ...others } }
+			},
+			down: (asset) => {
+				const { w, h, ...others } = asset.props
+				return { ...asset, props: { width: w, height: h, ...others } }
+			},
+		},
+	},
+})

package/src/createPresenceStateDerivation.ts

@@ -0,0 +1,53 @@
+import { Signal, computed } from '@bigbluebutton/state'
+import { TLStore } from './TLStore'
+import { CameraRecordType } from './records/TLCamera'
+import { TLINSTANCE_ID } from './records/TLInstance'
+import { InstancePageStateRecordType } from './records/TLPageState'
+import { TLPOINTER_ID } from './records/TLPointer'
+import { InstancePresenceRecordType, TLInstancePresence } from './records/TLPresence'
+
+/** @public */
+export const createPresenceStateDerivation =
+	(
+		$user: Signal<{ id: string; color: string; name: string }>,
+		instanceId?: TLInstancePresence['id']
+	) =>
+	(store: TLStore): Signal<TLInstancePresence | null> => {
+		return computed('instancePresence', () => {
+			const instance = store.get(TLINSTANCE_ID)
+			const pageState = store.get(InstancePageStateRecordType.createId(instance?.currentPageId))
+			const camera = store.get(CameraRecordType.createId(instance?.currentPageId))
+			const pointer = store.get(TLPOINTER_ID)
+			const user = $user.get()
+			if (!pageState || !instance || !camera || !pointer || !user) {
+				return null
+			}
+
+			return InstancePresenceRecordType.create({
+				id: instanceId ?? InstancePresenceRecordType.createId(store.id),
+				selectedShapeIds: pageState.selectedShapeIds,
+				brush: instance.brush,
+				scribbles: instance.scribbles,
+				userId: user.id,
+				userName: user.name,
+				followingUserId: instance.followingUserId,
+				camera: {
+					x: camera.x,
+					y: camera.y,
+					z: camera.z,
+				},
+				color: user.color,
+				currentPageId: instance.currentPageId,
+				cursor: {
+					x: pointer.x,
+					y: pointer.y,
+					rotation: instance.cursor.rotation,
+					type: instance.cursor.type,
+				},
+				lastActivityTimestamp: pointer.lastActivityTimestamp,
+				screenBounds: instance.screenBounds,
+				chatMessage: instance.chatMessage,
+				meta: {},
+			})
+		})
+	}