@woven-canvas/core 1.0.5 → 1.0.6

package/build/_tsup-dts-rollup.d.cts

@@ -170,6 +170,7 @@ declare const BlockDef: z.ZodObject<{
     canRotate: z.ZodDefault<z.ZodBoolean>;
     canScale: z.ZodDefault<z.ZodBoolean>;
     interactable: z.ZodDefault<z.ZodBoolean>;
+    excludeFromRankBounds: z.ZodDefault<z.ZodBoolean>;
     connectors: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         terminals: z.ZodDefault<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
@@ -382,7 +383,6 @@ export { Connector as Connector_alias_1 }
 export { Connector as Connector_alias_2 }
 
 export { Context }
-export { Context as Context_alias_1 }
 
 declare const Controls: ControlsDef;
 export { Controls }
@@ -635,6 +635,7 @@ declare class Editor {
     tick(): Promise<void>;
     nextTick(callback: (ctx: Context) => void): () => void;
     command<T>(def: CommandDef<T>, ...args: T extends void ? [] : [T]): void;
+    get readonly(): boolean;
     subscribe(query: QueryDef, callback: QueryCallback): () => void;
     _getContext(): Context;
     attachDom(domElement: HTMLElement): void;
@@ -708,6 +709,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -724,6 +726,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -785,6 +788,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         wheelTool?: string | undefined;
         modWheelTool?: string | undefined;
     }>>;
+    readonly: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 
 declare interface EditorPlugin<TResources = unknown> {
@@ -822,6 +826,7 @@ declare interface EditorResources {
     singletonsByName: Map<string, AnyCanvasSingletonDef>;
     componentsById: Map<number, AnyCanvasComponentDef>;
     singletonsById: Map<number, AnyCanvasSingletonDef>;
+    readonly: boolean;
 }
 export { EditorResources }
 export { EditorResources as EditorResources_alias_1 }
@@ -1223,6 +1228,10 @@ export { isHeldByRemote }
 export { isHeldByRemote as isHeldByRemote_alias_1 }
 export { isHeldByRemote as isHeldByRemote_alias_2 }
 
+declare function isReadonly(ctx: Context): boolean;
+export { isReadonly }
+export { isReadonly as isReadonly_alias_1 }
+
 declare const Key: {
     readonly A: number;
     readonly B: number;

package/build/_tsup-dts-rollup.d.ts

@@ -170,6 +170,7 @@ declare const BlockDef: z.ZodObject<{
     canRotate: z.ZodDefault<z.ZodBoolean>;
     canScale: z.ZodDefault<z.ZodBoolean>;
     interactable: z.ZodDefault<z.ZodBoolean>;
+    excludeFromRankBounds: z.ZodDefault<z.ZodBoolean>;
     connectors: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         terminals: z.ZodDefault<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
@@ -382,7 +383,6 @@ export { Connector as Connector_alias_1 }
 export { Connector as Connector_alias_2 }
 
 export { Context }
-export { Context as Context_alias_1 }
 
 declare const Controls: ControlsDef;
 export { Controls }
@@ -635,6 +635,7 @@ declare class Editor {
     tick(): Promise<void>;
     nextTick(callback: (ctx: Context) => void): () => void;
     command<T>(def: CommandDef<T>, ...args: T extends void ? [] : [T]): void;
+    get readonly(): boolean;
     subscribe(query: QueryDef, callback: QueryCallback): () => void;
     _getContext(): Context;
     attachDom(domElement: HTMLElement): void;
@@ -708,6 +709,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -724,6 +726,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -785,6 +788,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         wheelTool?: string | undefined;
         modWheelTool?: string | undefined;
     }>>;
+    readonly: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 
 declare interface EditorPlugin<TResources = unknown> {
@@ -822,6 +826,7 @@ declare interface EditorResources {
     singletonsByName: Map<string, AnyCanvasSingletonDef>;
     componentsById: Map<number, AnyCanvasComponentDef>;
     singletonsById: Map<number, AnyCanvasSingletonDef>;
+    readonly: boolean;
 }
 export { EditorResources }
 export { EditorResources as EditorResources_alias_1 }
@@ -1223,6 +1228,10 @@ export { isHeldByRemote }
 export { isHeldByRemote as isHeldByRemote_alias_1 }
 export { isHeldByRemote as isHeldByRemote_alias_2 }
 
+declare function isReadonly(ctx: Context): boolean;
+export { isReadonly }
+export { isReadonly as isReadonly_alias_1 }
+
 declare const Key: {
     readonly A: number;
     readonly B: number;

package/build/index.cjs

@@ -176,6 +176,7 @@ __export(index_exports, {
   isAlive: () => import_core71.isAlive,
   isAncestor: () => isAncestor,
   isHeldByRemote: () => isHeldByRemote,
+  isReadonly: () => isReadonly,
   on: () => on,
   parsePlugin: () => parsePlugin,
   removeComponent: () => import_core71.removeComponent,
@@ -382,6 +383,9 @@ function getPluginResources(ctx, pluginName) {
   const resources = ctx.resources;
   return resources.pluginResources[pluginName];
 }
+function isReadonly(ctx) {
+  return ctx.resources.readonly;
+}
 var GridOptions = import_zod.z.object({
   /**
    * Whether grid snapping is enabled.
@@ -543,7 +547,16 @@ var EditorOptionsSchema = import_zod.z.object({
    * }
    * ```
    */
-  controls: import_zod.z.custom().optional()
+  controls: import_zod.z.custom().optional(),
+  /**
+   * When true, user-initiated mutations are blocked — input systems skip
+   * their bodies and `editor.command()` is a no-op. Adapter-originated
+   * mutations (websocket, persistence) still apply, so remote edits remain
+   * visible. Useful for viewer-mode share links.
+   *
+   * @default false
+   */
+  readonly: import_zod.z.boolean().default(false)
 });
 var Keybind = import_zod.z.object({
   /** The command to execute when this keybind is triggered */
@@ -612,6 +625,7 @@ var BlockDef = import_zod.z.object({
   canRotate: import_zod.z.boolean().default(true),
   canScale: import_zod.z.boolean().default(true),
   interactable: import_zod.z.boolean().default(true),
+  excludeFromRankBounds: import_zod.z.boolean().default(false),
   connectors: BlockDefConnectors.default(BlockDefConnectors.parse({}))
 });
 var SelectionState = {
@@ -3296,6 +3310,8 @@ function intersectPoint(ctx, point, entityIds) {
   const intersects = [];
   const entities = entityIds ?? blocksWithAabb.current(ctx);
   for (const entityId of entities) {
+    const block = Block.read(ctx, entityId);
+    if (!canBlockInteract(ctx, block.tag)) continue;
     if (!Aabb.containsPoint(ctx, entityId, point)) {
       continue;
     }
@@ -3319,6 +3335,8 @@ function intersectAabb(ctx, bounds, entityIds) {
   const intersecting = [];
   const entities = entityIds ?? blocksWithAabb.current(ctx);
   for (const entityId of entities) {
+    const block = Block.read(ctx, entityId);
+    if (!canBlockInteract(ctx, block.tag)) continue;
     const { value: entityAabb } = Aabb.read(ctx, entityId);
     if (!import_math5.Aabb.intersects(bounds, entityAabb)) {
       continue;
@@ -3842,6 +3860,7 @@ var hoverCursorSystem = defineEditorSystem({ phase: "capture" }, (ctx) => {
 // src/systems/capture/keybindSystem.ts
 var import_core50 = require("@woven-ecs/core");
 var keybindSystem = defineEditorSystem({ phase: "capture" }, (ctx) => {
+  if (isReadonly(ctx)) return;
   const keyboard = Keyboard.read(ctx);
   const { editor } = (0, import_core50.getResources)(ctx);
   for (const keybind of editor.keybinds) {
@@ -4592,8 +4611,9 @@ var cursorSystem = defineEditorSystem({ phase: "render", priority: -100 }, (ctx)
 // src/systems/postRender/presenceSystem.ts
 var import_core57 = require("@woven-ecs/core");
 var pointerQuery2 = (0, import_core57.defineQuery)((q) => q.tracking(Pointer));
+var cameraChangedQuery = (0, import_core57.defineQuery)((q) => q.tracking(Camera));
 var presenceSystem = defineEditorSystem({ phase: "render", priority: -100 }, (ctx) => {
-  if (Mouse.didMove(ctx)) {
+  if (Mouse.didMove(ctx) || cameraChangedQuery.changed(ctx).length > 0) {
     const mouse = Mouse.read(ctx);
     updateUserPosition(ctx, mouse.position);
     return;
@@ -5097,6 +5117,10 @@ function clearHovered(ctx) {
 function findValidHoverTarget(ctx, intersected) {
   for (const entityId of intersected) {
     if (isHeldByRemote(ctx, entityId)) return void 0;
+    if ((0, import_core59.hasComponent)(ctx, entityId, Block)) {
+      const block = Block.read(ctx, entityId);
+      if (!canBlockInteract(ctx, block.tag)) continue;
+    }
     return entityId;
   }
   return void 0;
@@ -5147,10 +5171,6 @@ var intersectSystem = defineEditorSystem({ phase: "capture", priority: 100 }, (c
     addDescendants(ctx, entityId, changed);
   }
   for (const entityId of added) {
-    if ((0, import_core59.hasComponent)(ctx, entityId, Block)) {
-      const block = Block.read(ctx, entityId);
-      if (!canBlockInteract(ctx, block.tag)) continue;
-    }
     if (!(0, import_core59.hasComponent)(ctx, entityId, Aabb)) {
       (0, import_core59.addComponent)(ctx, entityId, Aabb, { value: [0, 0, 0, 0] });
     }
@@ -5534,6 +5554,7 @@ var selectionMachine = (0, import_xstate5.setup)({
   }
 });
 var selectSystem = defineEditorSystem({ phase: "capture", priority: 100 }, (ctx) => {
+  if (isReadonly(ctx)) return;
   let buttons = Controls.getButtons(ctx, "select");
   const state = SelectionStateSingleton.read(ctx);
   if (state.state === SelectionState.Dragging && buttons.length === 0) {
@@ -5552,6 +5573,7 @@ var rankBoundsSystem = defineEditorSystem({ phase: "input", priority: 100 }, (ct
   const added2 = blocksQuery.added(ctx);
   for (const entityId of added2) {
     const block = Block.read(ctx, entityId);
+    if (getBlockDef(ctx, block.tag).excludeFromRankBounds) continue;
     if (block.rank === "") {
       const writableBlock = Block.write(ctx, entityId);
       writableBlock.rank = RankBounds.genNext(ctx);
@@ -6732,7 +6754,8 @@ var Editor = class {
       componentsByName,
       singletonsByName,
       componentsById,
-      singletonsById
+      singletonsById,
+      readonly: options.readonly
     };
     this.world = new import_core70.World(allDefs, {
       maxEntities,
@@ -6877,6 +6900,10 @@ var Editor = class {
       def.spawn(ctx, payload);
     });
   }
+  /** Runtime readonly flag. Input systems and command() check this to gate mutations. */
+  get readonly() {
+    return this.ctx.resources.readonly;
+  }
   /**
    * Subscribe to query changes.
    *
@@ -7124,6 +7151,7 @@ var Editor = class {
   isAlive,
   isAncestor,
   isHeldByRemote,
+  isReadonly,
   on,
   parsePlugin,
   removeComponent,