@zenuml/core 3.47.2 → 3.47.4

package/.claude/skills/zenuml-ux-research/references/scenarios/insert-participant.md

@@ -0,0 +1,31 @@
+---
+id: insert-participant
+title: Insert a participant on a blank diagram
+---
+
+## User intent
+The user opens ZenUML to a blank diagram and wants to add one participant named `Alice` so they can start modelling.
+
+## Starting DSL
+```
+```
+
+## Target DSL
+```
+Alice
+```
+
+## Relevant assertion categories
+INS, FOC, EDT, KBD
+
+## Walkthrough hints (not prescriptive)
+- Blank canvas is the highest-stakes discoverability test — the skill should record how long it takes to find the insertion affordance.
+- Candidate insertion paths to try in order:
+  1. Click on the canvas background.
+  2. Look for a visible "+" or "Add participant" affordance.
+  3. Keyboard: try pressing Enter or `p` on an empty canvas.
+  4. Fall back to typing directly into the DSL editor pane.
+- The moment the user successfully names the new participant `Alice` is the scenario's end state.
+
+## Known issues to watch for (optional)
+- If the only path is direct DSL editing, that itself is a finding (violates INS-01).

package/.claude/skills/zenuml-ux-research/references/scenarios/rename-participant.md

@@ -0,0 +1,33 @@
+---
+id: rename-participant
+title: Rename a participant via keyboard
+---
+
+## User intent
+The user has a participant `A` on the canvas and wants to rename it to `Alice` without leaving the keyboard.
+
+## Starting DSL
+```
+A
+```
+
+## Target DSL
+```
+Alice
+```
+
+## Relevant assertion categories
+KBD, EDT, SEL, FOC
+
+## Walkthrough hints (not prescriptive)
+- This scenario is the canonical test of KBD-03 (Enter enters edit mode) and EDT-02 (caret at end of text).
+- Candidate paths to try in order:
+  1. Tab into the diagram widget, arrow-key to select `A`, press Enter, type `lice`, press Enter.
+  2. Click `A` to select, press Enter, retype.
+  3. Double-click `A` to enter edit mode.
+  4. Fall back to editing the DSL editor directly.
+- Watch specifically for: whether Enter does anything on the selected participant; whether the caret is placed at the end or the whole label is pre-selected; whether Escape cancels cleanly.
+
+## Known issues to watch for (optional)
+- If Enter does nothing on a selected participant, that is a KBD-03 violation at high severity.
+- If only mouse double-click works, that is a KBD-only violation (no mouse-free path).

package/.claude/skills/zenuml-ux-research/references/scenarios/undo-insert.md

@@ -0,0 +1,35 @@
+---
+id: undo-insert
+title: Undo a just-inserted message
+---
+
+## User intent
+The user has two participants `A` and `B`, inserts a message `A->B: hello`, then immediately presses Ctrl/Cmd+Z to undo. The expected result is that the message is removed and the state is back to just the two participants.
+
+## Starting DSL
+```
+A
+B
+```
+
+## Target DSL
+```
+A
+B
+```
+(after: insert `A->B: hello`, then undo)
+
+## Relevant assertion categories
+UND, FOC, SEL, KBD
+
+## Walkthrough hints (not prescriptive)
+- This scenario exercises the full insertion-then-undo round trip.
+- Steps:
+  1. Follow the `insert-message` scenario's walkthrough to get to the post-insert state.
+  2. Press Ctrl+Z (or Cmd+Z on macOS).
+  3. Observe: is the message removed? Is the DSL editor reverted? Is selection/focus restored to whatever it was before the insert?
+- Watch specifically for: undo granularity (one Ctrl+Z should undo the whole insert, not the individual keystrokes of the label edit) and focus restoration (FOC-03).
+
+## Known issues to watch for (optional)
+- If the undo leaves the label partially typed, UND-02 is violated.
+- If focus ends up on the document body after undo, FOC-03 is violated.