@neta-art/cohub 10.0.0 → 11.0.0

package/dist/protocol/dist/board-assets.d.ts

@@ -0,0 +1 @@
+import "./board.js";

package/dist/protocol/dist/board-constants.js

@@ -7,7 +7,7 @@ function clampBoardStrokeSize(size) {
 	if (!Number.isFinite(size)) return BOARD_ARROW_STROKE_SIZE;
 	return Math.min(64, Math.max(1, size));
 }
-const BOARD_FONT_STACK = "\"Geist\", system-ui, -apple-system, \"Noto Sans CJK SC\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif";
-const BOARD_MONO_FONT_STACK = "\"Geist Mono\", \"Fira Code\", ui-monospace, \"Noto Sans Mono CJK SC\", monospace";
+const BOARD_FONT_STACK = "\"Geist\", system-ui, -apple-system, \"Noto Sans CJK SC\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", \"Noto Sans Math\", \"Noto Sans Symbols 2\", \"DejaVu Sans\", \"FreeSans\", \"FreeSerif\", sans-serif";
+const BOARD_MONO_FONT_STACK = "\"Geist Mono\", \"Fira Code\", ui-monospace, \"Noto Sans Mono CJK SC\", \"Noto Sans Math\", \"DejaVu Sans\", \"FreeSans\", \"FreeSerif\", monospace";
 //#endregion
 export { BOARD_ARROW_STROKE_SIZE, BOARD_FONT_STACK, BOARD_MONO_FONT_STACK, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TEXT_FONT_FAMILY, clampBoardStrokeSize };

package/dist/protocol/dist/board-model.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 //#region ../protocol/dist/board-model.d.ts
 declare const BOARD_ID_MAX_LENGTH = 160;
 declare const BOARD_CAMERA_TARGET: "camera";
+declare const BoardKeySchema: z.ZodString;
 declare const BoardIdSchema: z.ZodString;
 declare const BoardVec2Schema: z.ZodObject<{
   x: z.ZodNumber;
@@ -44,10 +45,31 @@ declare const BoardStyleSchema: z.ZodObject<{
 }, z.core.$strict>;
 type BoardStyle = z.infer<typeof BoardStyleSchema>;
 declare function isSafeBoardSourcePath(value: string): boolean;
+type BoardMediaSource = {
+  kind: "url" | "file";
+  value: string;
+};
+declare function parseBoardMediaSource(src: string): BoardMediaSource | null;
+declare const BoardMediaSourceSchema: z.ZodString;
+declare const BoardScriptSchema: z.ZodObject<{
+  src: z.ZodString;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+  targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  seed: z.ZodOptional<z.ZodString>;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type BoardScript = z.infer<typeof BoardScriptSchema>;
 declare const BOARD_TEXT_ALIGNS: readonly ["left", "center", "right"];
 declare const BOARD_SHAPE_GEOMETRIES: readonly ["rectangle", "rounded", "ellipse", "diamond", "triangle", "path"];
 type BoardShapeGeometry = (typeof BOARD_SHAPE_GEOMETRIES)[number];
 declare const BoardFrameItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -92,10 +114,21 @@ declare const BoardFrameItemSchema: z.ZodObject<{
   type: z.ZodLiteral<"frame">;
   props: z.ZodPrefault<z.ZodObject<{
     label: z.ZodDefault<z.ZodString>;
+    decoration: z.ZodOptional<z.ZodEnum<{
+      frame: "frame";
+      none: "none";
+    }>>;
     clip: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const BoardTextItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -151,6 +184,13 @@ declare const BoardTextItemSchema: z.ZodObject<{
   }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const BoardShapeItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -219,6 +259,13 @@ declare const BoardDrawPointSchema: z.ZodObject<{
 }, z.core.$strict>;
 type BoardDrawPoint = z.infer<typeof BoardDrawPointSchema>;
 declare const BoardDrawItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -320,6 +367,13 @@ type BoardArrowEnd = z.infer<typeof BoardArrowEndSchema>;
 declare const BOARD_ARROW_ROUTES: readonly ["straight", "curve", "orthogonal"];
 type BoardArrowRoute = (typeof BOARD_ARROW_ROUTES)[number];
 declare const BoardArrowItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -434,6 +488,13 @@ declare const BoardCropSchema: z.ZodObject<{
   h: z.ZodNumber;
 }, z.core.$strict>;
 declare const BoardImageItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -499,6 +560,13 @@ declare const BoardImageItemSchema: z.ZodObject<{
   }, z.core.$strict>;
 }, z.core.$strict>;
 declare const BoardVideoItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -559,6 +627,13 @@ declare const BoardVideoItemSchema: z.ZodObject<{
   }, z.core.$strict>;
 }, z.core.$strict>;
 declare const BoardAudioItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -619,6 +694,13 @@ declare const BoardAudioItemSchema: z.ZodObject<{
   }, z.core.$strict>;
 }, z.core.$strict>;
 declare const BoardFileItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -759,6 +841,13 @@ declare const BoardTaskSnapshotSchema: z.ZodObject<{
 }, z.core.$strict>;
 type BoardTaskSnapshot = z.infer<typeof BoardTaskSnapshotSchema>;
 declare const BoardTaskItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -907,6 +996,13 @@ declare const BOARD_EFFECT_KIND_INFO: {
   };
 };
 declare const BoardEffectItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -969,7 +1065,7 @@ declare const BoardEffectItemSchema: z.ZodObject<{
     seed: z.ZodOptional<z.ZodString>;
   }, z.core.$strict>;
 }, z.core.$strict>;
-declare const BoardSketchItemSchema: z.ZodObject<{
+declare const BoardCustomItemSchema: z.ZodObject<{
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -1011,15 +1107,25 @@ declare const BoardSketchItemSchema: z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
   }, z.core.$strict>>;
-  type: z.ZodLiteral<"sketch">;
-  props: z.ZodObject<{
+  type: z.ZodLiteral<"custom">;
+  script: z.ZodObject<{
     src: z.ZodString;
-    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strict>;
+  props: z.ZodDefault<z.ZodObject<{}, z.core.$strict>>;
 }, z.core.$strict>;
 declare const BOARD_EXTENSION_TYPE_PATTERN: RegExp;
 declare const BoardExtensionItemSchema: z.ZodObject<{
+  script: z.ZodOptional<z.ZodObject<{
+    src: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    seed: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
   parent: z.ZodOptional<z.ZodString>;
   z: z.ZodOptional<z.ZodNumber>;
   position: z.ZodDefault<z.ZodObject<{
@@ -1066,6 +1172,13 @@ declare const BoardExtensionItemSchema: z.ZodObject<{
 }, z.core.$strict>;
 declare const BOARD_ITEM_SCHEMAS: {
   readonly frame: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1110,10 +1223,21 @@ declare const BOARD_ITEM_SCHEMAS: {
     type: z.ZodLiteral<"frame">;
     props: z.ZodPrefault<z.ZodObject<{
       label: z.ZodDefault<z.ZodString>;
+      decoration: z.ZodOptional<z.ZodEnum<{
+        frame: "frame";
+        none: "none";
+      }>>;
       clip: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
   }, z.core.$strict>;
   readonly text: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1169,6 +1293,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>>;
   }, z.core.$strict>;
   readonly shape: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1231,6 +1362,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>>;
   }, z.core.$strict>;
   readonly draw: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1278,6 +1416,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly arrow: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1373,6 +1518,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly image: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1438,6 +1590,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly video: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1498,6 +1657,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly audio: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1558,6 +1724,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly file: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1617,6 +1790,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly task: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1710,6 +1890,13 @@ declare const BOARD_ITEM_SCHEMAS: {
     }, z.core.$strict>;
   }, z.core.$strict>;
   readonly effect: z.ZodObject<{
+    script: z.ZodOptional<z.ZodObject<{
+      src: z.ZodString;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1772,7 +1959,7 @@ declare const BOARD_ITEM_SCHEMAS: {
       seed: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
   }, z.core.$strict>;
-  readonly sketch: z.ZodObject<{
+  readonly custom: z.ZodObject<{
     parent: z.ZodOptional<z.ZodString>;
     z: z.ZodOptional<z.ZodNumber>;
     position: z.ZodDefault<z.ZodObject<{
@@ -1814,12 +2001,15 @@ declare const BOARD_ITEM_SCHEMAS: {
       width: z.ZodNumber;
       height: z.ZodNumber;
     }, z.core.$strict>>;
-    type: z.ZodLiteral<"sketch">;
-    props: z.ZodObject<{
+    type: z.ZodLiteral<"custom">;
+    script: z.ZodObject<{
       src: z.ZodString;
-      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+      targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
       seed: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>;
+    props: z.ZodDefault<z.ZodObject<{}, z.core.$strict>>;
   }, z.core.$strict>;
 };
 type BoardBuiltinItemType = keyof typeof BOARD_ITEM_SCHEMAS;
@@ -1835,11 +2025,11 @@ type BoardAudioItem = z.infer<typeof BoardAudioItemSchema>;
 type BoardFileItem = z.infer<typeof BoardFileItemSchema>;
 type BoardTaskItem = z.infer<typeof BoardTaskItemSchema>;
 type BoardEffectItem = z.infer<typeof BoardEffectItemSchema>;
-type BoardSketchItem = z.infer<typeof BoardSketchItemSchema>;
+type BoardCustomItem = z.infer<typeof BoardCustomItemSchema>;
 type BoardExtensionItem = Omit<z.infer<typeof BoardExtensionItemSchema>, "type"> & {
   type: `${string}.${string}`;
 };
-type BoardBuiltinItem = BoardFrameItem | BoardTextItem | BoardShapeItem | BoardDrawItem | BoardArrowItem | BoardImageItem | BoardVideoItem | BoardAudioItem | BoardFileItem | BoardTaskItem | BoardEffectItem | BoardSketchItem;
+type BoardBuiltinItem = BoardFrameItem | BoardTextItem | BoardShapeItem | BoardDrawItem | BoardArrowItem | BoardImageItem | BoardVideoItem | BoardAudioItem | BoardFileItem | BoardTaskItem | BoardEffectItem | BoardCustomItem;
 type BoardItem = BoardBuiltinItem | BoardExtensionItem;
 type BoardItemType = BoardItem["type"];
 type BoardFileBackedItem = BoardImageItem | BoardVideoItem | BoardAudioItem | BoardFileItem;
@@ -2049,4 +2239,4 @@ type BoardDelta = {
 };
 declare function isEmptyBoardDelta(delta: BoardDelta): boolean;
 //#endregion
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardSketchItem, BoardSketchItemSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

package/dist/protocol/dist/board-model.js

@@ -1,8 +1,10 @@
+import { normalizeBoardRemoteUrl } from "./board-url.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-model.js
 const BOARD_ID_MAX_LENGTH = 160;
 const BOARD_CAMERA_TARGET = "camera";
-const BoardIdSchema = z.string().min(1).max(160).regex(/^[^\s/]+$/, "ids must not contain whitespace or '/'").refine((value) => value !== BOARD_CAMERA_TARGET, "\"camera\" is reserved");
+const BoardKeySchema = z.string().min(1).max(160).regex(/^[^\s/]+$/, "ids must not contain whitespace or '/'");
+const BoardIdSchema = BoardKeySchema.refine((value) => value !== BOARD_CAMERA_TARGET, "\"camera\" is reserved");
 const finite = z.number().finite();
 const nonNegative = finite.nonnegative();
 const ratio = finite.min(0).max(1);
@@ -50,10 +52,29 @@ const BoardStyleSchema = z.object({
 	trim: ratio.optional()
 }).strict();
 function isSafeBoardSourcePath(value) {
-	return value.length > 0 && value.length <= 4096 && !value.startsWith("/") && !value.includes("\\") && value.split("/").every((part) => part.length > 0 && part !== "." && part !== "..");
+	return value.length > 0 && value.length <= 4096 && !value.startsWith("/") && !/^[a-z][a-z\d+.-]*:/i.test(value.trimStart()) && !value.includes("\\") && value.split("/").every((part) => part.length > 0 && part !== "." && part !== "..");
 }
 const srcSchema = z.string().refine(isSafeBoardSourcePath, "src must be a relative Space file path");
+function parseBoardMediaSource(src) {
+	if (isSafeBoardSourcePath(src)) return {
+		kind: "file",
+		value: src
+	};
+	return normalizeBoardRemoteUrl(src) ? {
+		kind: "url",
+		value: src
+	} : null;
+}
+const BoardMediaSourceSchema = z.string().max(4096).refine((src) => parseBoardMediaSource(src) !== null, "src must be a public HTTP(S) URL or relative Space file path").describe("Prefer a stable public HTTP(S) URL; relative Space file paths remain supported.");
+const BoardScriptSchema = z.object({
+	src: srcSchema.refine((path) => /\.m?js$/.test(path), "script src must be a .js or .mjs module"),
+	params: z.record(z.string(), z.json()).default({}),
+	targets: z.record(z.string().min(1).max(80), BoardIdSchema).default({}),
+	seed: z.string().min(1).max(160).optional(),
+	enabled: z.boolean().default(true)
+}).strict();
 const itemEnvelope = {
+	script: BoardScriptSchema.optional(),
 	parent: BoardIdSchema.optional(),
 	z: finite.optional(),
 	position: BoardVec2Schema.default({
@@ -98,6 +119,7 @@ const BoardFrameItemSchema = z.object({
 	type: z.literal("frame"),
 	props: z.object({
 		label: z.string().max(280).default(""),
+		decoration: z.enum(["frame", "none"]).optional(),
 		clip: z.boolean().default(true)
 	}).strict().prefault({})
 }).strict();
@@ -197,7 +219,7 @@ const BoardMediaSnapshotSchema = z.object({
 	coverUrl: z.string().optional()
 }).strict();
 const fileProps = {
-	src: srcSchema,
+	src: BoardMediaSourceSchema,
 	snapshot: BoardMediaSnapshotSchema.optional()
 };
 const timedFileProps = {
@@ -369,14 +391,11 @@ const BoardEffectItemSchema = z.object({
 		seed: z.string().min(1).max(160).optional()
 	}).strict()
 }).strict();
-const BoardSketchItemSchema = z.object({
+const BoardCustomItemSchema = z.object({
 	...boxed(480, 320),
-	type: z.literal("sketch"),
-	props: z.object({
-		src: srcSchema.refine((path) => /\.m?js$/.test(path), "sketch src must be a .js or .mjs module"),
-		params: z.record(z.string(), z.unknown()).default({}),
-		seed: z.string().min(1).max(160).optional()
-	}).strict()
+	type: z.literal("custom"),
+	script: BoardScriptSchema,
+	props: z.object({}).strict().default({})
 }).strict();
 const BOARD_EXTENSION_TYPE_PATTERN = /^[a-z][a-z0-9]*(?:\.[a-z0-9-]+)+$/;
 const BoardExtensionItemSchema = z.object({
@@ -400,7 +419,7 @@ const BOARD_ITEM_SCHEMAS = {
 	file: BoardFileItemSchema,
 	task: BoardTaskItemSchema,
 	effect: BoardEffectItemSchema,
-	sketch: BoardSketchItemSchema
+	custom: BoardCustomItemSchema
 };
 const BOARD_ITEM_TYPES = Object.keys(BOARD_ITEM_SCHEMAS);
 function isBuiltinItemType(type) {
@@ -533,7 +552,7 @@ const BoardAnimationHeaderSchema = z.object({
 	end: z.enum(["hold", "reset"]).default("hold"),
 	markers: z.array(BoardMarkerSchema).max(1e4).default([])
 }).strict();
-const BoardAnimationSchema = BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardIdSchema, BoardTrackSchema).default({}) }).strict();
+const BoardAnimationSchema = BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardKeySchema, BoardTrackSchema).default({}) }).strict();
 const BOARD_ENTER_PRESETS = [
 	"fade-in",
 	"rise",
@@ -583,10 +602,10 @@ const patchObject = z.record(z.string(), z.unknown());
 const BoardPatchSchema = z.object({
 	board: patchObject.nullable().optional(),
 	items: z.record(BoardIdSchema, patchObject.nullable()).optional(),
-	animations: z.record(BoardIdSchema, patchObject.and(z.object({ tracks: z.record(BoardIdSchema, patchObject.nullable()).optional() })).nullable()).optional()
+	animations: z.record(BoardIdSchema, patchObject.and(z.object({ tracks: z.record(BoardKeySchema, patchObject.nullable()).optional() })).nullable()).optional()
 }).strict();
 function isEmptyBoardDelta(delta) {
 	return !delta.board && Object.keys(delta.items ?? {}).length === 0 && Object.keys(delta.animations ?? {}).length === 0 && Object.keys(delta.tracks ?? {}).length === 0;
 }
 //#endregion
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaSnapshotSchema, BoardPatchSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardSketchItemSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

package/dist/protocol/dist/board-patch.js

@@ -82,7 +82,8 @@ const NOT_ANIMATABLE = /* @__PURE__ */ new Set([
 	"parent",
 	"z",
 	"locked",
-	"metadata"
+	"metadata",
+	"script"
 ]);
 const CAMERA_PROPERTIES = {
 	focus: {

package/dist/protocol/dist/board-schema.d.ts

@@ -1,6 +1,6 @@
 //#region ../protocol/dist/board-schema.d.ts
 type JsonSchema = Record<string, unknown>;
-declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "camera", ...("arrow" | "audio" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "sketch" | "task" | "text" | "video")[]];
+declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "camera", ...("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[]];
 type BoardJsonSchemaResult = {
   schema?: JsonSchema;
   properties?: Array<{
@@ -11,6 +11,7 @@ type BoardJsonSchemaResult = {
     description: string;
     parameters: Record<string, string>;
   }>;
+  semantics?: Record<string, string>;
 };
 declare function boardJsonSchema(target: string): BoardJsonSchemaResult | null;
 declare function boardSchemaOverview(): {
@@ -19,7 +20,8 @@ declare function boardSchemaOverview(): {
     rotation: string;
     length: string;
   };
-  types: ("arrow" | "audio" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "sketch" | "task" | "text" | "video")[];
+  coordinates: string;
+  types: ("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[];
   colors: {
     tokens: readonly ["brand", "neutral", "black", "white", "blue", "green", "amber", "violet", "rose"];
     css: string;

package/dist/protocol/dist/board-schema.js

@@ -1,4 +1,4 @@
-import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
+import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardKeySchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
 import { listBoardProperties } from "./board-patch.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-schema.js
@@ -19,13 +19,26 @@ const BOARD_SCHEMA_TARGETS = [
 function boardJsonSchema(target) {
 	if (target === "board") return { schema: toJsonSchema(BoardSettingsSchema) };
 	if (target === "animation") return {
-		schema: toJsonSchema(BoardAnimationHeaderSchema.extend({ tracks: z.record(z.string(), BoardTrackSchema).optional() })),
-		properties: listBoardProperties("animation")
+		schema: toJsonSchema(BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardKeySchema, BoardTrackSchema).optional() })),
+		properties: listBoardProperties("animation"),
+		semantics: { composition: "Target another animation's time property to drive its local clock. Parent markers control pauses; child markers are not automatically promoted." }
+	};
+	if (target === "track") return {
+		schema: toJsonSchema(BoardTrackSchema),
+		semantics: {
+			boundary: "Before the first keyframe and after the last, the value is held. Use opacity tracks to control visibility.",
+			easing: "Defaults to linear. The destination keyframe controls the incoming segment. Supports CSS easing keywords, cubic-bezier() and steps().",
+			composition: "replace: the most recently started track wins; ties use the lexicographically larger track ID. Before any start, the nearest upcoming track wins. add: numbers and positions add; opacity and scale multiply.",
+			interpolation: "auto interpolates numbers, colors and vectors; other values step. spline smooths vector motion. orient follows the position tangent."
+		}
 	};
-	if (target === "track") return { schema: toJsonSchema(BoardTrackSchema) };
 	if (target === "effect") return {
 		schema: toJsonSchema(BOARD_ITEM_SCHEMAS.effect),
 		properties: listBoardProperties("effect"),
+		semantics: {
+			follow: "follow is used by trail only. Parent a particle effect to a decoration:none frame to move it with other items.",
+			time: "Effects use animation time in milliseconds. trail samples target history; seed makes procedural particles repeatable."
+		},
 		kinds: Object.fromEntries(BOARD_EFFECT_KINDS.map((kind) => [kind, BOARD_EFFECT_KIND_INFO[kind]]))
 	};
 	if (target === "camera") return { properties: listBoardProperties(BOARD_CAMERA_TARGET) };
@@ -42,6 +55,7 @@ function boardSchemaOverview() {
 			rotation: "degrees",
 			length: "board units (1 = 1 CSS px at zoom 1)"
 		},
+		coordinates: "Positions, draw points and unbound arrow endpoints are relative to their parent frame; without a parent they are world coordinates. Shape paths are fitted to the item size.",
 		types: BOARD_ITEM_TYPES,
 		colors: {
 			tokens: BOARD_COLOR_TOKENS,