FE-1660: Explain blocked edits in read-only Petrinaut documents

[kube]

Summary

Before this PR, Petrinaut ignored edits on a read-only net without a word. A dragged node stayed put and editing shortcuts did nothing.

A blocked drag, shortcut, paste or delete now shows one brief notice saying why. Hosts can add a button to the read-only notice, and published examples on the website offer Make a local copy there.

9662.mp4

Links

• Ticket FE-1660
• Ticket FE-1695
• Docs Drawing a Net › Global modes

Changes

Petrinaut

• useReadOnlyFeedback explains a blocked edit

  Message follows the read-only reason: host read-only, Simulate or Actual mode, or a simulation holding the net.
  Repeated attempts show one notice per net and reason.

• Node drags on a read-only canvas notify after 6 px of movement

  Clicks, panning and zooming stay silent.

• Mutation guards, paste, auto-layout and the N, T, Delete and undo shortcuts notify

  Scenario and metric edits allowed in Simulate stay silent.

• readOnlyAction prop adds a button to the host read-only notice

  It travels in NetManagement with the other host-owned net actions.

• Notifications take an optional id and action

  A notification on screen under the same id is not shown again.

• Neutral notifications render

  Ark shows only its own toast types, so neutral maps to info.

• Notifications leave with their editor

  Notifications share one store across the editors on a page.
  Unmounting an editor now removes its notifications, so the read-only notice does not reappear on the editable copy.

Website

• Example pages pass Make a local copy as their read-only action

Test coverage

• use-read-only-node-drag.test.tsx:

  Drag threshold, quiet selection and panning, cancelled gestures.

• use-keyboard-shortcuts.test.tsx:

  Blocked shortcuts notify, typing and selection shortcuts stay quiet.

• use-petrinaut-mutations.test.tsx:

  Allowed scenario mutations in Simulate stay quiet.

• provider.test.tsx:

  One notice per id, action button, focus stays on the trigger, nothing left for the next editor.

• Verified in a browser against the dev server:

  Dragging a node on an example shows the notice with Make a local copy.

How to test

• Open Petrinaut preview on Vercel
• Click a place

  Expect selection, no notice

• Drag the place

  Expect one "This document is read-only." notice with Make a local copy

• Select a node and press Delete

  Expect net unchanged

• Notice > Make a local copy

  Expect editable copy at a new /local/<id> URL

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hash	Ready	Preview	Oct 9, 2026 8:28pm UTC
petrinaut	Ready	Preview	Oct 9, 2026 8:28pm UTC
petrinaut-docs	Ready	Preview	Oct 9, 2026 8:28pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Oct 9, 2026 8:28pm UTC

[cursor]

PR Summary

Low Risk
Additive UX and notification plumbing across editor interactions; scenario edits in Simulate remain allowed and behavior is covered by new tests.

Overview
Blocked edits on read-only nets now surface a deduplicated neutral toast with a reason-specific message (host read-only, wrong mode, or active simulation) instead of failing silently.

useReadOnlyFeedback drives notices from mutation/command guards, keyboard shortcuts (paste, delete, add-node keys, undo), canvas node-drop, and a new 6px drag threshold on the React Flow pane so clicks and panning stay quiet. Hosts can pass readOnlyAction on <Petrinaut>; the action appears only for host read-only, and example pages wire Make a local copy.

Notifications gain optional id (skip if already visible) and action buttons; neutral tone maps to Ark info. Unmounting an editor remove()s toasts so notices do not leak to another instance on the page.

^{Reviewed by Cursor Bugbot for commit d326e68. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Stale Bugbot comment from a previous run.

[Copilot]

🟡 Changes recommended

Address the preview feedback behavior and preserve native undo when no history adapter is configured.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds read-only feedback for blocked Petrinaut edits, including deduplicated notices and optional local-copy actions.

Changes:

• Detects blocked drags, shortcuts, mutations, and commands.
• Adds notification actions, deduplication, and contextual messaging.
• Updates integrations, tests, documentation, README, and changeset.

File summaries

File	Description
libs/@hashintel/petrinaut/src/ui/views/SDCPN/use-canvas-interactions.ts	Reports blocked canvas mutations.
libs/@hashintel/petrinaut/src/ui/views/SDCPN/renderers/react-flow/react-flow-canvas/use-read-only-node-drag.ts	Detects blocked node drags.
libs/@hashintel/petrinaut/src/ui/views/SDCPN/renderers/react-flow/react-flow-canvas/use-read-only-node-drag.test.tsx	Tests drag feedback behavior.
libs/@hashintel/petrinaut/src/ui/views/SDCPN/renderers/react-flow/react-flow-canvas.tsx	Installs drag handlers.
libs/@hashintel/petrinaut/src/ui/views/Editor/components/BottomBar/use-keyboard-shortcuts.ts	Explains blocked shortcuts.
libs/@hashintel/petrinaut/src/ui/views/Editor/components/BottomBar/use-keyboard-shortcuts.test.tsx	Tests shortcut feedback.
libs/@hashintel/petrinaut/src/ui/petrinaut.tsx	Exposes the read-only action prop.
libs/@hashintel/petrinaut/src/react/state/read-only-action-context.ts	Provides host action context.
libs/@hashintel/petrinaut/src/react/notifications/toaster.tsx	Renders notification actions.
libs/@hashintel/petrinaut/src/react/notifications/provider.tsx	Adds deduplication and informational tone mapping.
libs/@hashintel/petrinaut/src/react/notifications/provider.test.tsx	Tests notification behavior.
libs/@hashintel/petrinaut/src/react/notifications/context.ts	Extends notification input types.
libs/@hashintel/petrinaut/src/react/hooks/use-read-only-feedback.ts	Centralizes read-only notices.
libs/@hashintel/petrinaut/src/react/hooks/use-petrinaut-mutations.ts	Reports blocked mutations.
libs/@hashintel/petrinaut/src/react/hooks/use-petrinaut-mutations.test.tsx	Tests mutation feedback.
libs/@hashintel/petrinaut/src/react/hooks/use-petrinaut-commands.ts	Reports blocked commands.
libs/@hashintel/petrinaut/README.md	Documents the host action API.
libs/@hashintel/petrinaut/docs/drawing-a-net.md	Documents read-only behavior.
apps/petrinaut-website/src/examples/full-example-page.tsx	Connects the local-copy action.
.changeset/smooth-readonly-feedback.md	Adds the package changeset.

Review details

Suppressed comments (2)

libs/@hashintel/petrinaut/src/react/hooks/use-petrinaut-commands.ts:35

• The new behavior in this guard is the notification, but the existing use-petrinaut-commands.test.tsx cases only assert no-op return values and do not provide or inspect NotificationsContext.addNotification. A regression removing notifyReadOnly() here (or at the analogous auto-layout guard on line 44) would therefore leave the command tests green; add blocked paste and auto-layout assertions for the notice.

      if (isReadOnly) {
        notifyReadOnly();
        return { newItemIds: [] };

libs/@hashintel/petrinaut/src/react/hooks/use-read-only-feedback.ts:27

• The public PetrinautPreview does not provide a usable outcome for this shared feedback hook: without quickSimulation, it renders the canvas without NotificationsProvider (src/ui/preview/petrinaut-preview.tsx:311-345), so the default addNotification is a no-op; with Quick Simulation, the preview's mode is simulate but it intentionally exposes no Edit mode control (src/ui/preview/petrinaut-preview.tsx:321-345, docs/preview.md:64-67), so this message tells users to switch to an unavailable mode. Supply preview-specific notification wiring/copy or keep this feedback scoped to the full editor.

    const message =
      reason.kind === "host-readonly"
        ? "This document is read-only."
        : reason.kind === "simulation-active"
          ? "Reset the simulation to edit this net."
          : "Switch to Edit to change this net.";
    addNotification({
      id: `read-only:${petriNetId}:${reason.kind}`,
      message,
      tone: "neutral",
      durationMs: 4500,
      action: reason.kind === "host-readonly" ? action : undefined,

• Files reviewed: 20/20 changed files
• Comments generated: 1
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.