@tldraw/tlschema 5.3.0-internal.fba91ed55f6c → 5.3.0-next.91d2a20b898c

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tldraw/tlschema",
   "description": "tldraw infinite canvas SDK (schema).",
-  "version": "5.3.0-internal.fba91ed55f6c",
+  "version": "5.3.0-next.91d2a20b898c",
   "author": {
     "name": "tldraw Inc.",
     "email": "hello@tldraw.com"
@@ -51,10 +51,10 @@
     "vitest": "^4.1.7"
   },
   "dependencies": {
-    "@tldraw/state": "5.3.0-internal.fba91ed55f6c",
-    "@tldraw/store": "5.3.0-internal.fba91ed55f6c",
-    "@tldraw/utils": "5.3.0-internal.fba91ed55f6c",
-    "@tldraw/validate": "5.3.0-internal.fba91ed55f6c"
+    "@tldraw/state": "5.3.0-next.91d2a20b898c",
+    "@tldraw/store": "5.3.0-next.91d2a20b898c",
+    "@tldraw/utils": "5.3.0-next.91d2a20b898c",
+    "@tldraw/validate": "5.3.0-next.91d2a20b898c"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.2.1",

package/src/index.ts

@@ -116,22 +116,6 @@ export {
 	type TLUnknownBinding,
 } from './records/TLBinding'
 export { CameraRecordType, type TLCamera, type TLCameraId } from './records/TLCamera'
-export {
-	commentRecordConfig,
-	commentSchemaRecords,
-	commentThreadRecordConfig,
-	createComment,
-	createCommentId,
-	createCommentThread,
-	createCommentThreadId,
-	isCommentId,
-	isCommentThreadId,
-	type TLComment,
-	type TLCommentAnchor,
-	type TLCommentId,
-	type TLCommentThread,
-	type TLCommentThreadId,
-} from './records/TLComment'
 export {
 	createCustomRecordId,
 	createCustomRecordMigrationIds,

package/dist-cjs/records/TLComment.js

@@ -1,172 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var TLComment_exports = {};
-__export(TLComment_exports, {
-  commentRecordConfig: () => commentRecordConfig,
-  commentSchemaRecords: () => commentSchemaRecords,
-  commentThreadRecordConfig: () => commentThreadRecordConfig,
-  createComment: () => createComment,
-  createCommentId: () => createCommentId,
-  createCommentThread: () => createCommentThread,
-  createCommentThreadId: () => createCommentThreadId,
-  isCommentId: () => isCommentId,
-  isCommentThreadId: () => isCommentThreadId
-});
-module.exports = __toCommonJS(TLComment_exports);
-var import_store = require("@tldraw/store");
-var import_validate = require("@tldraw/validate");
-var import_id_validator = require("../misc/id-validator");
-var import_TLRichText = require("../misc/TLRichText");
-var import_TLCustomRecord = require("./TLCustomRecord");
-const commentAnchorValidator = import_validate.T.union("type", {
-  shape: import_validate.T.object({
-    type: import_validate.T.literal("shape"),
-    shapeId: (0, import_id_validator.idValidator)("shape"),
-    x: import_validate.T.number,
-    y: import_validate.T.number,
-    isPrecise: import_validate.T.boolean
-  }),
-  point: import_validate.T.object({
-    type: import_validate.T.literal("point"),
-    x: import_validate.T.number,
-    y: import_validate.T.number
-  }),
-  region: import_validate.T.object({
-    type: import_validate.T.literal("region"),
-    x: import_validate.T.number,
-    y: import_validate.T.number,
-    w: import_validate.T.number,
-    h: import_validate.T.number
-  }),
-  page: import_validate.T.object({
-    type: import_validate.T.literal("page")
-  }),
-  "text-range": import_validate.T.object({
-    type: import_validate.T.literal("text-range"),
-    shapeId: (0, import_id_validator.idValidator)("shape"),
-    from: import_validate.T.number,
-    to: import_validate.T.number
-  })
-});
-function createCommentGuardMigrations(typeName, extra = []) {
-  return (0, import_store.createRecordMigrationSequence)({
-    sequenceId: `com.tldraw.${typeName}`,
-    recordType: typeName,
-    retroactive: true,
-    sequence: [
-      {
-        id: `com.tldraw.${typeName}/1`,
-        up: (record) => record
-      },
-      ...extra
-    ]
-  });
-}
-const commentThreadRecordConfig = {
-  scope: "document",
-  migrations: createCommentGuardMigrations("comment-thread", [
-    {
-      // Shape anchors gained normalized x/y + isPrecise; existing ones were imprecise (top-right).
-      id: "com.tldraw.comment-thread/2",
-      up: (record) => {
-        const anchor = record.anchor;
-        if (anchor?.type === "shape" && anchor.x === void 0) {
-          ;
-          record.anchor = { ...anchor, x: 1, y: 0, isPrecise: false };
-        }
-        return record;
-      },
-      down: (record) => {
-        const anchor = record.anchor;
-        if (anchor?.type === "shape") {
-          ;
-          record.anchor = { type: "shape", shapeId: anchor.shapeId };
-        }
-        return record;
-      }
-    }
-  ]),
-  validator: import_validate.T.object({
-    id: (0, import_id_validator.idValidator)("comment-thread"),
-    typeName: import_validate.T.literal("comment-thread"),
-    pageId: (0, import_id_validator.idValidator)("page"),
-    anchor: commentAnchorValidator,
-    createdBy: import_validate.T.string,
-    createdAt: import_validate.T.number,
-    resolved: import_validate.T.object({ at: import_validate.T.number, by: import_validate.T.string }).nullable(),
-    meta: import_validate.T.jsonValue
-  })
-};
-const commentRecordConfig = {
-  scope: "document",
-  migrations: createCommentGuardMigrations("comment"),
-  validator: import_validate.T.object({
-    id: (0, import_id_validator.idValidator)("comment"),
-    typeName: import_validate.T.literal("comment"),
-    threadId: (0, import_id_validator.idValidator)("comment-thread"),
-    pageId: (0, import_id_validator.idValidator)("page"),
-    authorId: import_validate.T.string,
-    createdAt: import_validate.T.number,
-    editedAt: import_validate.T.number.nullable(),
-    body: import_TLRichText.richTextValidator,
-    meta: import_validate.T.jsonValue
-  })
-};
-const commentSchemaRecords = {
-  "comment-thread": commentThreadRecordConfig,
-  comment: commentRecordConfig
-};
-function createCommentThreadId(id) {
-  return (0, import_TLCustomRecord.createCustomRecordId)("comment-thread", id);
-}
-function createCommentId(id) {
-  return (0, import_TLCustomRecord.createCustomRecordId)("comment", id);
-}
-function isCommentThreadId(id) {
-  return (0, import_TLCustomRecord.isCustomRecordId)("comment-thread", id);
-}
-function isCommentId(id) {
-  return (0, import_TLCustomRecord.isCustomRecordId)("comment", id);
-}
-function createCommentThread(props) {
-  return {
-    id: createCommentThreadId(),
-    typeName: "comment-thread",
-    pageId: props.pageId,
-    anchor: props.anchor,
-    createdBy: props.createdBy,
-    createdAt: props.now ?? Date.now(),
-    resolved: null,
-    meta: props.meta ?? {}
-  };
-}
-function createComment(props) {
-  return {
-    id: createCommentId(),
-    typeName: "comment",
-    threadId: props.threadId,
-    pageId: props.pageId,
-    authorId: props.authorId,
-    createdAt: props.now ?? Date.now(),
-    editedAt: null,
-    body: props.body,
-    meta: props.meta ?? {}
-  };
-}
-//# sourceMappingURL=TLComment.js.map

package/dist-cjs/records/TLComment.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/records/TLComment.ts"],
-  "sourcesContent": ["import { BaseRecord, RecordId, createRecordMigrationSequence } from '@tldraw/store'\nimport { JsonObject } from '@tldraw/utils'\nimport { T } from '@tldraw/validate'\nimport { idValidator } from '../misc/id-validator'\nimport { richTextValidator, TLRichText } from '../misc/TLRichText'\nimport { CustomRecordInfo, createCustomRecordId, isCustomRecordId } from './TLCustomRecord'\nimport { TLPageId } from './TLPage'\nimport { TLShapeId } from './TLShape'\n\n/**\n * Where a comment thread is anchored on the canvas. Modeled as a discriminated union so new\n * anchor kinds can be added without breaking existing threads:\n *\n * - `shape` \u2014 pinned to a shape. `x`/`y` are normalized (0\u20131) within the shape's page bounds, so\n *   the pin keeps its spot as the shape moves and resizes. `isPrecise` mirrors arrow bindings: when\n *   true the pin sits at exactly `x`/`y`; when false (the default) it sits at a consumer-defined\n *   spot (top-right out of the box), and `x`/`y` are the remembered precise position\n * - `point` \u2014 pinned to a fixed point on the page, in page coordinates\n * - `region` \u2014 pinned to a rectangular area of the page, in page coordinates\n * - `page` \u2014 a page-level thread with no spatial anchor\n * - `text-range` \u2014 pinned to a character range inside a shape's text\n *\n * @public\n */\nexport type TLCommentAnchor =\n\t| { type: 'shape'; shapeId: TLShapeId; x: number; y: number; isPrecise: boolean }\n\t| { type: 'point'; x: number; y: number }\n\t| { type: 'region'; x: number; y: number; w: number; h: number }\n\t| { type: 'page' }\n\t| { type: 'text-range'; shapeId: TLShapeId; from: number; to: number }\n\n/**\n * A comment thread. The thread owns the anchor (where the conversation lives on the canvas) and\n * the resolution state; the messages themselves are `TLComment` records pointing at the thread\n * via `threadId`, ordered by `createdAt`. v1 threads are flat \u2014 no nested replies.\n *\n * Threads and comments are document records, but they're intended to be served through the sync\n * server's object-store lane: gated by the session's `objectAccess` rather than `isReadonly`\n * (so \"can comment but not edit\" is expressible), excluded from document snapshots and `.tldr`\n * exports server-side, and persisted in a separate lane from the main document.\n *\n * Opt-in: register with `createTLSchema({ records: commentSchemaRecords })` on the server and\n * the matching `records` option on the client \u2014 neither type is part of the default schema, and\n * both sides must register them identically.\n *\n * @public\n */\nexport interface TLCommentThread extends BaseRecord<'comment-thread', TLCommentThreadId> {\n\t/** The page the thread lives on. */\n\tpageId: TLPageId\n\t/** Where the thread is anchored on that page. */\n\tanchor: TLCommentAnchor\n\t/**\n\t * Who started the thread. Client-supplied for now; the sync server should stamp/verify this\n\t * from the session's authenticated identity once record-level authorization lands (the same\n\t * model presence already uses for self-ownership).\n\t */\n\tcreatedBy: string\n\tcreatedAt: number\n\t/** Resolution state: when and by whom the thread was resolved, or null while open. */\n\tresolved: { at: number; by: string } | null\n\tmeta: JsonObject\n}\n\n/** @public */\nexport type TLCommentThreadId = RecordId<TLCommentThread>\n\n/**\n * A single comment message within a thread. See `TLCommentThread` for the overall model and\n * sync/registration notes.\n *\n * Comment mutations are deliberately not undoable \u2014 create/edit them with\n * `{ history: 'ignore' }` to avoid multiplayer surprises like a comment reappearing after\n * someone else deleted it.\n *\n * @public\n */\nexport interface TLComment extends BaseRecord<'comment', TLCommentId> {\n\t/** The thread this comment belongs to. */\n\tthreadId: TLCommentThreadId\n\t/** Denormalized from the thread so per-page queries don't need a join. */\n\tpageId: TLPageId\n\t/** See `TLCommentThread.createdBy` \u2014 same server-stamping caveat applies. */\n\tauthorId: string\n\tcreatedAt: number\n\t/** Null until the comment is first edited. */\n\teditedAt: number | null\n\t/** Rich text body. Use `toRichText(...)` for plaintext input. */\n\tbody: TLRichText\n\tmeta: JsonObject\n}\n\n/** @public */\nexport type TLCommentId = RecordId<TLComment>\n\nconst commentAnchorValidator: T.Validator<TLCommentAnchor> = T.union('type', {\n\tshape: T.object({\n\t\ttype: T.literal('shape'),\n\t\tshapeId: idValidator<TLShapeId>('shape'),\n\t\tx: T.number,\n\t\ty: T.number,\n\t\tisPrecise: T.boolean,\n\t}),\n\tpoint: T.object({\n\t\ttype: T.literal('point'),\n\t\tx: T.number,\n\t\ty: T.number,\n\t}),\n\tregion: T.object({\n\t\ttype: T.literal('region'),\n\t\tx: T.number,\n\t\ty: T.number,\n\t\tw: T.number,\n\t\th: T.number,\n\t}),\n\tpage: T.object({\n\t\ttype: T.literal('page'),\n\t}),\n\t'text-range': T.object({\n\t\ttype: T.literal('text-range'),\n\t\tshapeId: idValidator<TLShapeId>('shape'),\n\t\tfrom: T.number,\n\t\tto: T.number,\n\t}),\n})\n\n/**\n * Guard migrations for the comment record types. Each sequence is retroactive and starts with an\n * identity migration that has no `down`: a sync server whose schema registers the comment types\n * cannot down-migrate records for a session whose schema predates them, so such sessions are\n * rejected with CLIENT_TOO_OLD (prompting a refresh) instead of being sent record types their\n * store cannot represent.\n */\nfunction createCommentGuardMigrations(\n\ttypeName: 'comment' | 'comment-thread',\n\textra: Parameters<typeof createRecordMigrationSequence>[0]['sequence'] = []\n) {\n\treturn createRecordMigrationSequence({\n\t\tsequenceId: `com.tldraw.${typeName}`,\n\t\trecordType: typeName,\n\t\tretroactive: true,\n\t\tsequence: [\n\t\t\t{\n\t\t\t\tid: `com.tldraw.${typeName}/1`,\n\t\t\t\tup: (record) => record,\n\t\t\t},\n\t\t\t...extra,\n\t\t],\n\t})\n}\n\n/**\n * Config for registering the `comment-thread` record type in a tldraw schema. Pass via\n * `commentSchemaRecords`; see `TLCommentThread`.\n *\n * @public\n */\nexport const commentThreadRecordConfig: CustomRecordInfo = {\n\tscope: 'document',\n\tmigrations: createCommentGuardMigrations('comment-thread', [\n\t\t{\n\t\t\t// Shape anchors gained normalized x/y + isPrecise; existing ones were imprecise (top-right).\n\t\t\tid: 'com.tldraw.comment-thread/2',\n\t\t\tup: (record) => {\n\t\t\t\tconst anchor = (record as any).anchor\n\t\t\t\tif (anchor?.type === 'shape' && anchor.x === undefined) {\n\t\t\t\t\t;(record as any).anchor = { ...anchor, x: 1, y: 0, isPrecise: false }\n\t\t\t\t}\n\t\t\t\treturn record\n\t\t\t},\n\t\t\tdown: (record) => {\n\t\t\t\tconst anchor = (record as any).anchor\n\t\t\t\tif (anchor?.type === 'shape') {\n\t\t\t\t\t;(record as any).anchor = { type: 'shape', shapeId: anchor.shapeId }\n\t\t\t\t}\n\t\t\t\treturn record\n\t\t\t},\n\t\t},\n\t]),\n\tvalidator: T.object({\n\t\tid: idValidator<TLCommentThreadId>('comment-thread'),\n\t\ttypeName: T.literal('comment-thread'),\n\t\tpageId: idValidator<TLPageId>('page'),\n\t\tanchor: commentAnchorValidator,\n\t\tcreatedBy: T.string,\n\t\tcreatedAt: T.number,\n\t\tresolved: T.object({ at: T.number, by: T.string }).nullable(),\n\t\tmeta: T.jsonValue,\n\t}),\n}\n\n/**\n * Config for registering the `comment` record type in a tldraw schema. Pass via\n * `commentSchemaRecords`; see `TLComment`.\n *\n * @public\n */\nexport const commentRecordConfig: CustomRecordInfo = {\n\tscope: 'document',\n\tmigrations: createCommentGuardMigrations('comment'),\n\tvalidator: T.object({\n\t\tid: idValidator<TLCommentId>('comment'),\n\t\ttypeName: T.literal('comment'),\n\t\tthreadId: idValidator<TLCommentThreadId>('comment-thread'),\n\t\tpageId: idValidator<TLPageId>('page'),\n\t\tauthorId: T.string,\n\t\tcreatedAt: T.number,\n\t\teditedAt: T.number.nullable(),\n\t\tbody: richTextValidator,\n\t\tmeta: T.jsonValue,\n\t}),\n}\n\n/**\n * The `records` map to pass to `createTLSchema` / the client `records` option so comment\n * threads and comments sync. Register both types together \u2014 a comment without its thread type\n * (or vice versa) will fail schema validation on one side of the connection.\n *\n * @public\n */\nexport const commentSchemaRecords = {\n\t'comment-thread': commentThreadRecordConfig,\n\tcomment: commentRecordConfig,\n}\n\n/** @public */\nexport function createCommentThreadId(id?: string): TLCommentThreadId {\n\treturn createCustomRecordId('comment-thread', id) as TLCommentThreadId\n}\n\n/** @public */\nexport function createCommentId(id?: string): TLCommentId {\n\treturn createCustomRecordId('comment', id) as TLCommentId\n}\n\n/**\n * Type guard for `TLCommentThreadId`. Note `isCommentId` does not accept these: the prefixes\n * are `comment-thread:` vs `comment:`, and the character after `comment` differs (`-` vs `:`),\n * so the two never overlap.\n *\n * @public\n */\nexport function isCommentThreadId(id: string): id is TLCommentThreadId {\n\treturn isCustomRecordId('comment-thread', id)\n}\n\n/**\n * Type guard for `TLCommentId`. See `isCommentThreadId` for why `comment-thread:...` ids are\n * correctly rejected here.\n *\n * @public\n */\nexport function isCommentId(id: string): id is TLCommentId {\n\treturn isCustomRecordId('comment', id)\n}\n\n/**\n * Create a new comment thread record. Pair with `createComment` for the thread's first message.\n *\n * @public\n */\nexport function createCommentThread(props: {\n\tpageId: TLPageId\n\tanchor: TLCommentAnchor\n\tcreatedBy: string\n\tnow?: number\n\tmeta?: JsonObject\n}): TLCommentThread {\n\treturn {\n\t\tid: createCommentThreadId(),\n\t\ttypeName: 'comment-thread',\n\t\tpageId: props.pageId,\n\t\tanchor: props.anchor,\n\t\tcreatedBy: props.createdBy,\n\t\tcreatedAt: props.now ?? Date.now(),\n\t\tresolved: null,\n\t\tmeta: props.meta ?? {},\n\t}\n}\n\n/**\n * Create a new comment record within a thread.\n *\n * @public\n */\nexport function createComment(props: {\n\tthreadId: TLCommentThreadId\n\tpageId: TLPageId\n\tauthorId: string\n\tbody: TLRichText\n\tnow?: number\n\tmeta?: JsonObject\n}): TLComment {\n\treturn {\n\t\tid: createCommentId(),\n\t\ttypeName: 'comment',\n\t\tthreadId: props.threadId,\n\t\tpageId: props.pageId,\n\t\tauthorId: props.authorId,\n\t\tcreatedAt: props.now ?? Date.now(),\n\t\teditedAt: null,\n\t\tbody: props.body,\n\t\tmeta: props.meta ?? {},\n\t}\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist-esm/records/TLComment.mjs

@@ -1,152 +0,0 @@
-import { createRecordMigrationSequence } from "@tldraw/store";
-import { T } from "@tldraw/validate";
-import { idValidator } from "../misc/id-validator.mjs";
-import { richTextValidator } from "../misc/TLRichText.mjs";
-import { createCustomRecordId, isCustomRecordId } from "./TLCustomRecord.mjs";
-const commentAnchorValidator = T.union("type", {
-  shape: T.object({
-    type: T.literal("shape"),
-    shapeId: idValidator("shape"),
-    x: T.number,
-    y: T.number,
-    isPrecise: T.boolean
-  }),
-  point: T.object({
-    type: T.literal("point"),
-    x: T.number,
-    y: T.number
-  }),
-  region: T.object({
-    type: T.literal("region"),
-    x: T.number,
-    y: T.number,
-    w: T.number,
-    h: T.number
-  }),
-  page: T.object({
-    type: T.literal("page")
-  }),
-  "text-range": T.object({
-    type: T.literal("text-range"),
-    shapeId: idValidator("shape"),
-    from: T.number,
-    to: T.number
-  })
-});
-function createCommentGuardMigrations(typeName, extra = []) {
-  return createRecordMigrationSequence({
-    sequenceId: `com.tldraw.${typeName}`,
-    recordType: typeName,
-    retroactive: true,
-    sequence: [
-      {
-        id: `com.tldraw.${typeName}/1`,
-        up: (record) => record
-      },
-      ...extra
-    ]
-  });
-}
-const commentThreadRecordConfig = {
-  scope: "document",
-  migrations: createCommentGuardMigrations("comment-thread", [
-    {
-      // Shape anchors gained normalized x/y + isPrecise; existing ones were imprecise (top-right).
-      id: "com.tldraw.comment-thread/2",
-      up: (record) => {
-        const anchor = record.anchor;
-        if (anchor?.type === "shape" && anchor.x === void 0) {
-          ;
-          record.anchor = { ...anchor, x: 1, y: 0, isPrecise: false };
-        }
-        return record;
-      },
-      down: (record) => {
-        const anchor = record.anchor;
-        if (anchor?.type === "shape") {
-          ;
-          record.anchor = { type: "shape", shapeId: anchor.shapeId };
-        }
-        return record;
-      }
-    }
-  ]),
-  validator: T.object({
-    id: idValidator("comment-thread"),
-    typeName: T.literal("comment-thread"),
-    pageId: idValidator("page"),
-    anchor: commentAnchorValidator,
-    createdBy: T.string,
-    createdAt: T.number,
-    resolved: T.object({ at: T.number, by: T.string }).nullable(),
-    meta: T.jsonValue
-  })
-};
-const commentRecordConfig = {
-  scope: "document",
-  migrations: createCommentGuardMigrations("comment"),
-  validator: T.object({
-    id: idValidator("comment"),
-    typeName: T.literal("comment"),
-    threadId: idValidator("comment-thread"),
-    pageId: idValidator("page"),
-    authorId: T.string,
-    createdAt: T.number,
-    editedAt: T.number.nullable(),
-    body: richTextValidator,
-    meta: T.jsonValue
-  })
-};
-const commentSchemaRecords = {
-  "comment-thread": commentThreadRecordConfig,
-  comment: commentRecordConfig
-};
-function createCommentThreadId(id) {
-  return createCustomRecordId("comment-thread", id);
-}
-function createCommentId(id) {
-  return createCustomRecordId("comment", id);
-}
-function isCommentThreadId(id) {
-  return isCustomRecordId("comment-thread", id);
-}
-function isCommentId(id) {
-  return isCustomRecordId("comment", id);
-}
-function createCommentThread(props) {
-  return {
-    id: createCommentThreadId(),
-    typeName: "comment-thread",
-    pageId: props.pageId,
-    anchor: props.anchor,
-    createdBy: props.createdBy,
-    createdAt: props.now ?? Date.now(),
-    resolved: null,
-    meta: props.meta ?? {}
-  };
-}
-function createComment(props) {
-  return {
-    id: createCommentId(),
-    typeName: "comment",
-    threadId: props.threadId,
-    pageId: props.pageId,
-    authorId: props.authorId,
-    createdAt: props.now ?? Date.now(),
-    editedAt: null,
-    body: props.body,
-    meta: props.meta ?? {}
-  };
-}
-export {
-  commentRecordConfig,
-  commentSchemaRecords,
-  commentThreadRecordConfig,
-  createComment,
-  createCommentId,
-  createCommentThread,
-  createCommentThreadId,
-  isCommentId,
-  isCommentThreadId
-};
-//# sourceMappingURL=TLComment.mjs.map

package/dist-esm/records/TLComment.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/records/TLComment.ts"],
-  "sourcesContent": ["import { BaseRecord, RecordId, createRecordMigrationSequence } from '@tldraw/store'\nimport { JsonObject } from '@tldraw/utils'\nimport { T } from '@tldraw/validate'\nimport { idValidator } from '../misc/id-validator'\nimport { richTextValidator, TLRichText } from '../misc/TLRichText'\nimport { CustomRecordInfo, createCustomRecordId, isCustomRecordId } from './TLCustomRecord'\nimport { TLPageId } from './TLPage'\nimport { TLShapeId } from './TLShape'\n\n/**\n * Where a comment thread is anchored on the canvas. Modeled as a discriminated union so new\n * anchor kinds can be added without breaking existing threads:\n *\n * - `shape` \u2014 pinned to a shape. `x`/`y` are normalized (0\u20131) within the shape's page bounds, so\n *   the pin keeps its spot as the shape moves and resizes. `isPrecise` mirrors arrow bindings: when\n *   true the pin sits at exactly `x`/`y`; when false (the default) it sits at a consumer-defined\n *   spot (top-right out of the box), and `x`/`y` are the remembered precise position\n * - `point` \u2014 pinned to a fixed point on the page, in page coordinates\n * - `region` \u2014 pinned to a rectangular area of the page, in page coordinates\n * - `page` \u2014 a page-level thread with no spatial anchor\n * - `text-range` \u2014 pinned to a character range inside a shape's text\n *\n * @public\n */\nexport type TLCommentAnchor =\n\t| { type: 'shape'; shapeId: TLShapeId; x: number; y: number; isPrecise: boolean }\n\t| { type: 'point'; x: number; y: number }\n\t| { type: 'region'; x: number; y: number; w: number; h: number }\n\t| { type: 'page' }\n\t| { type: 'text-range'; shapeId: TLShapeId; from: number; to: number }\n\n/**\n * A comment thread. The thread owns the anchor (where the conversation lives on the canvas) and\n * the resolution state; the messages themselves are `TLComment` records pointing at the thread\n * via `threadId`, ordered by `createdAt`. v1 threads are flat \u2014 no nested replies.\n *\n * Threads and comments are document records, but they're intended to be served through the sync\n * server's object-store lane: gated by the session's `objectAccess` rather than `isReadonly`\n * (so \"can comment but not edit\" is expressible), excluded from document snapshots and `.tldr`\n * exports server-side, and persisted in a separate lane from the main document.\n *\n * Opt-in: register with `createTLSchema({ records: commentSchemaRecords })` on the server and\n * the matching `records` option on the client \u2014 neither type is part of the default schema, and\n * both sides must register them identically.\n *\n * @public\n */\nexport interface TLCommentThread extends BaseRecord<'comment-thread', TLCommentThreadId> {\n\t/** The page the thread lives on. */\n\tpageId: TLPageId\n\t/** Where the thread is anchored on that page. */\n\tanchor: TLCommentAnchor\n\t/**\n\t * Who started the thread. Client-supplied for now; the sync server should stamp/verify this\n\t * from the session's authenticated identity once record-level authorization lands (the same\n\t * model presence already uses for self-ownership).\n\t */\n\tcreatedBy: string\n\tcreatedAt: number\n\t/** Resolution state: when and by whom the thread was resolved, or null while open. */\n\tresolved: { at: number; by: string } | null\n\tmeta: JsonObject\n}\n\n/** @public */\nexport type TLCommentThreadId = RecordId<TLCommentThread>\n\n/**\n * A single comment message within a thread. See `TLCommentThread` for the overall model and\n * sync/registration notes.\n *\n * Comment mutations are deliberately not undoable \u2014 create/edit them with\n * `{ history: 'ignore' }` to avoid multiplayer surprises like a comment reappearing after\n * someone else deleted it.\n *\n * @public\n */\nexport interface TLComment extends BaseRecord<'comment', TLCommentId> {\n\t/** The thread this comment belongs to. */\n\tthreadId: TLCommentThreadId\n\t/** Denormalized from the thread so per-page queries don't need a join. */\n\tpageId: TLPageId\n\t/** See `TLCommentThread.createdBy` \u2014 same server-stamping caveat applies. */\n\tauthorId: string\n\tcreatedAt: number\n\t/** Null until the comment is first edited. */\n\teditedAt: number | null\n\t/** Rich text body. Use `toRichText(...)` for plaintext input. */\n\tbody: TLRichText\n\tmeta: JsonObject\n}\n\n/** @public */\nexport type TLCommentId = RecordId<TLComment>\n\nconst commentAnchorValidator: T.Validator<TLCommentAnchor> = T.union('type', {\n\tshape: T.object({\n\t\ttype: T.literal('shape'),\n\t\tshapeId: idValidator<TLShapeId>('shape'),\n\t\tx: T.number,\n\t\ty: T.number,\n\t\tisPrecise: T.boolean,\n\t}),\n\tpoint: T.object({\n\t\ttype: T.literal('point'),\n\t\tx: T.number,\n\t\ty: T.number,\n\t}),\n\tregion: T.object({\n\t\ttype: T.literal('region'),\n\t\tx: T.number,\n\t\ty: T.number,\n\t\tw: T.number,\n\t\th: T.number,\n\t}),\n\tpage: T.object({\n\t\ttype: T.literal('page'),\n\t}),\n\t'text-range': T.object({\n\t\ttype: T.literal('text-range'),\n\t\tshapeId: idValidator<TLShapeId>('shape'),\n\t\tfrom: T.number,\n\t\tto: T.number,\n\t}),\n})\n\n/**\n * Guard migrations for the comment record types. Each sequence is retroactive and starts with an\n * identity migration that has no `down`: a sync server whose schema registers the comment types\n * cannot down-migrate records for a session whose schema predates them, so such sessions are\n * rejected with CLIENT_TOO_OLD (prompting a refresh) instead of being sent record types their\n * store cannot represent.\n */\nfunction createCommentGuardMigrations(\n\ttypeName: 'comment' | 'comment-thread',\n\textra: Parameters<typeof createRecordMigrationSequence>[0]['sequence'] = []\n) {\n\treturn createRecordMigrationSequence({\n\t\tsequenceId: `com.tldraw.${typeName}`,\n\t\trecordType: typeName,\n\t\tretroactive: true,\n\t\tsequence: [\n\t\t\t{\n\t\t\t\tid: `com.tldraw.${typeName}/1`,\n\t\t\t\tup: (record) => record,\n\t\t\t},\n\t\t\t...extra,\n\t\t],\n\t})\n}\n\n/**\n * Config for registering the `comment-thread` record type in a tldraw schema. Pass via\n * `commentSchemaRecords`; see `TLCommentThread`.\n *\n * @public\n */\nexport const commentThreadRecordConfig: CustomRecordInfo = {\n\tscope: 'document',\n\tmigrations: createCommentGuardMigrations('comment-thread', [\n\t\t{\n\t\t\t// Shape anchors gained normalized x/y + isPrecise; existing ones were imprecise (top-right).\n\t\t\tid: 'com.tldraw.comment-thread/2',\n\t\t\tup: (record) => {\n\t\t\t\tconst anchor = (record as any).anchor\n\t\t\t\tif (anchor?.type === 'shape' && anchor.x === undefined) {\n\t\t\t\t\t;(record as any).anchor = { ...anchor, x: 1, y: 0, isPrecise: false }\n\t\t\t\t}\n\t\t\t\treturn record\n\t\t\t},\n\t\t\tdown: (record) => {\n\t\t\t\tconst anchor = (record as any).anchor\n\t\t\t\tif (anchor?.type === 'shape') {\n\t\t\t\t\t;(record as any).anchor = { type: 'shape', shapeId: anchor.shapeId }\n\t\t\t\t}\n\t\t\t\treturn record\n\t\t\t},\n\t\t},\n\t]),\n\tvalidator: T.object({\n\t\tid: idValidator<TLCommentThreadId>('comment-thread'),\n\t\ttypeName: T.literal('comment-thread'),\n\t\tpageId: idValidator<TLPageId>('page'),\n\t\tanchor: commentAnchorValidator,\n\t\tcreatedBy: T.string,\n\t\tcreatedAt: T.number,\n\t\tresolved: T.object({ at: T.number, by: T.string }).nullable(),\n\t\tmeta: T.jsonValue,\n\t}),\n}\n\n/**\n * Config for registering the `comment` record type in a tldraw schema. Pass via\n * `commentSchemaRecords`; see `TLComment`.\n *\n * @public\n */\nexport const commentRecordConfig: CustomRecordInfo = {\n\tscope: 'document',\n\tmigrations: createCommentGuardMigrations('comment'),\n\tvalidator: T.object({\n\t\tid: idValidator<TLCommentId>('comment'),\n\t\ttypeName: T.literal('comment'),\n\t\tthreadId: idValidator<TLCommentThreadId>('comment-thread'),\n\t\tpageId: idValidator<TLPageId>('page'),\n\t\tauthorId: T.string,\n\t\tcreatedAt: T.number,\n\t\teditedAt: T.number.nullable(),\n\t\tbody: richTextValidator,\n\t\tmeta: T.jsonValue,\n\t}),\n}\n\n/**\n * The `records` map to pass to `createTLSchema` / the client `records` option so comment\n * threads and comments sync. Register both types together \u2014 a comment without its thread type\n * (or vice versa) will fail schema validation on one side of the connection.\n *\n * @public\n */\nexport const commentSchemaRecords = {\n\t'comment-thread': commentThreadRecordConfig,\n\tcomment: commentRecordConfig,\n}\n\n/** @public */\nexport function createCommentThreadId(id?: string): TLCommentThreadId {\n\treturn createCustomRecordId('comment-thread', id) as TLCommentThreadId\n}\n\n/** @public */\nexport function createCommentId(id?: string): TLCommentId {\n\treturn createCustomRecordId('comment', id) as TLCommentId\n}\n\n/**\n * Type guard for `TLCommentThreadId`. Note `isCommentId` does not accept these: the prefixes\n * are `comment-thread:` vs `comment:`, and the character after `comment` differs (`-` vs `:`),\n * so the two never overlap.\n *\n * @public\n */\nexport function isCommentThreadId(id: string): id is TLCommentThreadId {\n\treturn isCustomRecordId('comment-thread', id)\n}\n\n/**\n * Type guard for `TLCommentId`. See `isCommentThreadId` for why `comment-thread:...` ids are\n * correctly rejected here.\n *\n * @public\n */\nexport function isCommentId(id: string): id is TLCommentId {\n\treturn isCustomRecordId('comment', id)\n}\n\n/**\n * Create a new comment thread record. Pair with `createComment` for the thread's first message.\n *\n * @public\n */\nexport function createCommentThread(props: {\n\tpageId: TLPageId\n\tanchor: TLCommentAnchor\n\tcreatedBy: string\n\tnow?: number\n\tmeta?: JsonObject\n}): TLCommentThread {\n\treturn {\n\t\tid: createCommentThreadId(),\n\t\ttypeName: 'comment-thread',\n\t\tpageId: props.pageId,\n\t\tanchor: props.anchor,\n\t\tcreatedBy: props.createdBy,\n\t\tcreatedAt: props.now ?? Date.now(),\n\t\tresolved: null,\n\t\tmeta: props.meta ?? {},\n\t}\n}\n\n/**\n * Create a new comment record within a thread.\n *\n * @public\n */\nexport function createComment(props: {\n\tthreadId: TLCommentThreadId\n\tpageId: TLPageId\n\tauthorId: string\n\tbody: TLRichText\n\tnow?: number\n\tmeta?: JsonObject\n}): TLComment {\n\treturn {\n\t\tid: createCommentId(),\n\t\ttypeName: 'comment',\n\t\tthreadId: props.threadId,\n\t\tpageId: props.pageId,\n\t\tauthorId: props.authorId,\n\t\tcreatedAt: props.now ?? Date.now(),\n\t\teditedAt: null,\n\t\tbody: props.body,\n\t\tmeta: props.meta ?? {},\n\t}\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/src/records/TLComment.test.ts

@@ -1,182 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { createTLSchema } from '../createTLSchema'
-import { toRichText } from '../misc/TLRichText'
-import {
-	commentRecordConfig,
-	commentSchemaRecords,
-	commentThreadRecordConfig,
-	createComment,
-	createCommentId,
-	createCommentThread,
-	createCommentThreadId,
-	isCommentId,
-	isCommentThreadId,
-	TLCommentAnchor,
-} from './TLComment'
-import { TLPageId } from './TLPage'
-import { TLShapeId } from './TLShape'
-
-const pageId = 'page:page1' as TLPageId
-const shapeId = 'shape:box1' as TLShapeId
-
-const anchors: TLCommentAnchor[] = [
-	{ type: 'shape', shapeId, x: 1, y: 0, isPrecise: false },
-	{ type: 'point', x: 100, y: 200 },
-	{ type: 'region', x: 0, y: 0, w: 300, h: 150 },
-	{ type: 'page' },
-	{ type: 'text-range', shapeId, from: 3, to: 12 },
-]
-
-describe('TLCommentThread', () => {
-	it.each(anchors)('creates a valid thread anchored to %j', (anchor) => {
-		const thread = createCommentThread({ pageId, anchor, createdBy: 'user1', now: 1000 })
-		expect(commentThreadRecordConfig.validator.validate(thread)).toEqual(thread)
-		expect(thread).toMatchObject({
-			typeName: 'comment-thread',
-			pageId,
-			anchor,
-			createdAt: 1000,
-			resolved: null,
-			meta: {},
-		})
-	})
-
-	it('validates resolution state', () => {
-		const thread = createCommentThread({
-			pageId,
-			anchor: { type: 'page' },
-			createdBy: 'user1',
-			now: 1000,
-		})
-		const resolved = { ...thread, resolved: { at: 2000, by: 'user2' } }
-		expect(commentThreadRecordConfig.validator.validate(resolved)).toEqual(resolved)
-		expect(() =>
-			commentThreadRecordConfig.validator.validate({ ...thread, resolved: { at: 2000 } })
-		).toThrow()
-	})
-
-	it('rejects unknown anchor kinds and malformed anchors', () => {
-		const thread = createCommentThread({
-			pageId,
-			anchor: { type: 'shape', shapeId, x: 1, y: 0, isPrecise: false },
-			createdBy: 'user1',
-			now: 1000,
-		})
-		expect(() =>
-			commentThreadRecordConfig.validator.validate({
-				...thread,
-				anchor: { type: 'volume', level: 11 },
-			})
-		).toThrow()
-		expect(() =>
-			commentThreadRecordConfig.validator.validate({
-				...thread,
-				// shape anchors must reference a shape id
-				anchor: { type: 'shape', shapeId: 'page:nope', x: 1, y: 0, isPrecise: false },
-			})
-		).toThrow()
-	})
-})
-
-describe('TLComment', () => {
-	const threadId = createCommentThreadId('thread1')
-
-	it('creates a valid comment with a rich text body', () => {
-		const comment = createComment({
-			threadId,
-			pageId,
-			authorId: 'user1',
-			body: toRichText('hello'),
-			now: 1000,
-		})
-		expect(commentRecordConfig.validator.validate(comment)).toEqual(comment)
-		expect(comment).toMatchObject({
-			typeName: 'comment',
-			threadId,
-			pageId,
-			createdAt: 1000,
-			editedAt: null,
-		})
-	})
-
-	it('accepts an editedAt timestamp after edits', () => {
-		const comment = createComment({
-			threadId,
-			pageId,
-			authorId: 'user1',
-			body: toRichText('hello'),
-			now: 1000,
-		})
-		const edited = { ...comment, editedAt: 2000, body: toRichText('hello, edited') }
-		expect(commentRecordConfig.validator.validate(edited)).toEqual(edited)
-	})
-
-	it('rejects a threadId that is not a comment-thread id', () => {
-		const comment = createComment({
-			threadId,
-			pageId,
-			authorId: 'user1',
-			body: toRichText('hello'),
-			now: 1000,
-		})
-		expect(() =>
-			commentRecordConfig.validator.validate({ ...comment, threadId: 'comment:not-a-thread' })
-		).toThrow()
-	})
-})
-
-describe('schema registration', () => {
-	it('registers both record types via commentSchemaRecords', () => {
-		const schema = createTLSchema({ records: commentSchemaRecords })
-		// custom record types aren't part of the default TLRecord union, so index untyped
-		const types = schema.types as Record<string, { scope: string } | undefined>
-		expect(types['comment-thread']?.scope).toBe('document')
-		expect(types['comment']?.scope).toBe('document')
-	})
-})
-
-describe('isCommentThreadId / isCommentId', () => {
-	it('isCommentThreadId accepts comment-thread ids and rejects everything else', () => {
-		expect(isCommentThreadId(createCommentThreadId())).toBe(true)
-		expect(isCommentThreadId(createCommentId())).toBe(false)
-		expect(isCommentThreadId('shape:box1')).toBe(false)
-		expect(isCommentThreadId('not-an-id')).toBe(false)
-	})
-
-	it('isCommentId accepts comment ids and rejects everything else, including comment-thread ids', () => {
-		expect(isCommentId(createCommentId())).toBe(true)
-		expect(isCommentId(createCommentThreadId())).toBe(false)
-		expect(isCommentId('shape:box1')).toBe(false)
-		expect(isCommentId('not-an-id')).toBe(false)
-	})
-})
-
-describe('comment-thread migrations', () => {
-	const migration = (commentThreadRecordConfig.migrations as any).sequence.find(
-		(m: any) => m.id === 'com.tldraw.comment-thread/2'
-	) as { up(r: any): any; down(r: any): any }
-
-	it('stamps existing shape anchors with the top-right position (x:1, y:0)', () => {
-		expect(migration.up({ anchor: { type: 'shape', shapeId } })).toEqual({
-			anchor: { type: 'shape', shapeId, x: 1, y: 0, isPrecise: false },
-		})
-	})
-
-	it('leaves shape anchors that already have x/y unchanged', () => {
-		const anchor = { type: 'shape', shapeId, x: 0.25, y: 0.75, isPrecise: true }
-		expect(migration.up({ anchor })).toEqual({ anchor })
-	})
-
-	it('leaves non-shape anchors untouched', () => {
-		const anchor = { type: 'point', x: 5, y: 6 }
-		expect(migration.up({ anchor })).toEqual({ anchor })
-	})
-
-	it('down-migrates by dropping x/y', () => {
-		expect(
-			migration.down({ anchor: { type: 'shape', shapeId, x: 0.3, y: 0.4, isPrecise: true } })
-		).toEqual({
-			anchor: { type: 'shape', shapeId },
-		})
-	})
-})