@woven-canvas/core 1.0.5 → 1.0.6

package/build/index.d.cts

@@ -199,6 +199,7 @@ export { FrameContainmentStateEnum } from './_tsup-dts-rollup.cjs';
 export { FrameContainmentStateValue } from './_tsup-dts-rollup.cjs';
 export { GridOptions } from './_tsup-dts-rollup.cjs';
 export { getPluginResources } from './_tsup-dts-rollup.cjs';
+export { isReadonly } from './_tsup-dts-rollup.cjs';
 export { Keybind } from './_tsup-dts-rollup.cjs';
 export { ResizeMode } from './_tsup-dts-rollup.cjs';
 export { ScrollEdgesState } from './_tsup-dts-rollup.cjs';

package/build/index.d.ts

@@ -199,6 +199,7 @@ export { FrameContainmentStateEnum } from './_tsup-dts-rollup.js';
 export { FrameContainmentStateValue } from './_tsup-dts-rollup.js';
 export { GridOptions } from './_tsup-dts-rollup.js';
 export { getPluginResources } from './_tsup-dts-rollup.js';
+export { isReadonly } from './_tsup-dts-rollup.js';
 export { Keybind } from './_tsup-dts-rollup.js';
 export { ResizeMode } from './_tsup-dts-rollup.js';
 export { ScrollEdgesState } from './_tsup-dts-rollup.js';

package/build/index.js

@@ -231,6 +231,9 @@ function getPluginResources(ctx, pluginName) {
   const resources = ctx.resources;
   return resources.pluginResources[pluginName];
 }
+function isReadonly(ctx) {
+  return ctx.resources.readonly;
+}
 var GridOptions = z.object({
   /**
    * Whether grid snapping is enabled.
@@ -392,7 +395,16 @@ var EditorOptionsSchema = z.object({
    * }
    * ```
    */
-  controls: z.custom().optional()
+  controls: 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: z.boolean().default(false)
 });
 var Keybind = z.object({
   /** The command to execute when this keybind is triggered */
@@ -461,6 +473,7 @@ var BlockDef = z.object({
   canRotate: z.boolean().default(true),
   canScale: z.boolean().default(true),
   interactable: z.boolean().default(true),
+  excludeFromRankBounds: z.boolean().default(false),
   connectors: BlockDefConnectors.default(BlockDefConnectors.parse({}))
 });
 var SelectionState = {
@@ -3145,6 +3158,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;
     }
@@ -3168,6 +3183,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 (!Aabb3.intersects(bounds, entityAabb)) {
       continue;
@@ -3697,6 +3714,7 @@ var hoverCursorSystem = defineEditorSystem({ phase: "capture" }, (ctx) => {
 // src/systems/capture/keybindSystem.ts
 import { addComponent as addComponent3, createEntity as createEntity2, getResources as getResources6 } from "@woven-ecs/core";
 var keybindSystem = defineEditorSystem({ phase: "capture" }, (ctx) => {
+  if (isReadonly(ctx)) return;
   const keyboard = Keyboard.read(ctx);
   const { editor } = getResources6(ctx);
   for (const keybind of editor.keybinds) {
@@ -4447,8 +4465,9 @@ var cursorSystem = defineEditorSystem({ phase: "render", priority: -100 }, (ctx)
 // src/systems/postRender/presenceSystem.ts
 import { defineQuery as defineQuery11 } from "@woven-ecs/core";
 var pointerQuery2 = defineQuery11((q) => q.tracking(Pointer));
+var cameraChangedQuery = defineQuery11((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;
@@ -4968,6 +4987,10 @@ function clearHovered(ctx) {
 function findValidHoverTarget(ctx, intersected) {
   for (const entityId of intersected) {
     if (isHeldByRemote(ctx, entityId)) return void 0;
+    if (hasComponent13(ctx, entityId, Block)) {
+      const block = Block.read(ctx, entityId);
+      if (!canBlockInteract(ctx, block.tag)) continue;
+    }
     return entityId;
   }
   return void 0;
@@ -5018,10 +5041,6 @@ var intersectSystem = defineEditorSystem({ phase: "capture", priority: 100 }, (c
     addDescendants(ctx, entityId, changed);
   }
   for (const entityId of added) {
-    if (hasComponent13(ctx, entityId, Block)) {
-      const block = Block.read(ctx, entityId);
-      if (!canBlockInteract(ctx, block.tag)) continue;
-    }
     if (!hasComponent13(ctx, entityId, Aabb)) {
       addComponent6(ctx, entityId, Aabb, { value: [0, 0, 0, 0] });
     }
@@ -5405,6 +5424,7 @@ var selectionMachine = setup4({
   }
 });
 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) {
@@ -5423,6 +5443,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);
@@ -6617,7 +6638,8 @@ var Editor = class {
       componentsByName,
       singletonsByName,
       componentsById,
-      singletonsById
+      singletonsById,
+      readonly: options.readonly
     };
     this.world = new World(allDefs, {
       maxEntities,
@@ -6762,6 +6784,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.
    *
@@ -7008,6 +7034,7 @@ export {
   isAlive3 as isAlive,
   isAncestor,
   isHeldByRemote,
+  isReadonly,
   on,
   parsePlugin,
   removeComponent7 as removeComponent,