@cssints/apg-specs 0.0.0-stage → 0.5.2

package/scenarios/canvas/camera.contract.json

@@ -0,0 +1,237 @@
+{
+  "pattern": "camera",
+  "source": "contract",
+  "license": "authored in this repository (no upstream); numbers derived from specs/canvas/camera.qnt",
+  "scenarios": [
+    {
+      "id": "camera.contract.zoom-about-the-centre-keeps-the-anchor",
+      "area": "zoom",
+      "config": {},
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "zoom",
+          "value": { "factor": 2, "anchor": "centre" }
+        },
+        {
+          "expect": {
+            "attrs": {
+              "layer": {
+                "--canvas-x": "-200",
+                "--canvas-y": "-150",
+                "--canvas-zoom": "2"
+              }
+            }
+          }
+        }
+      ],
+      "notes": "800 x 600 viewport, anchor (400, 300): screen = (world + t) * 2 maps world (400, 300) to the same pixel only with t = (-200, -150)."
+    },
+    {
+      "id": "camera.contract.a-limit-clamp-re-anchors",
+      "area": "zoom",
+      "config": {},
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "zoom",
+          "value": { "factor": 16, "anchor": "centre" }
+        },
+        {
+          "expect": {
+            "attrs": {
+              "layer": {
+                "--canvas-x": "-350",
+                "--canvas-y": "-262.5",
+                "--canvas-zoom": "8"
+              }
+            }
+          }
+        },
+        {
+          "event": "prop",
+          "prop": "zoom",
+          "value": { "factor": 2, "anchor": "centre" }
+        },
+        {
+          "expect": {
+            "attrs": {
+              "layer": {
+                "--canvas-x": "-350",
+                "--canvas-y": "-262.5",
+                "--canvas-zoom": "8"
+              }
+            }
+          }
+        }
+      ],
+      "notes": "x16 is clamped to ZMAX = 8, and the translation is solved for the clamped zoom (not the requested one), so the anchor stays put; a further zoom-in at the limit changes nothing. The y offset is a whole 1/256 fraction: -262.5 units."
+    },
+    {
+      "id": "camera.contract.pan-clamps-the-viewport-origin-at-the-world-bound",
+      "area": "pan",
+      "config": {},
+      "steps": [
+        { "event": "prop", "prop": "pan", "value": [9000000, 0] },
+        {
+          "expect": {
+            "attrs": { "layer": { "--canvas-x": "1000000", "--canvas-y": "0" } }
+          }
+        }
+      ],
+      "notes": "A 9e6 px pan is far beyond the +-1e6 unit bound: the move is clamped, not refused."
+    },
+    {
+      "id": "camera.contract.zoom-limit-min-about-the-centre",
+      "area": "zoom",
+      "config": {},
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "zoomLimit",
+          "value": { "limit": "min", "anchor": "centre" }
+        },
+        {
+          "expect": {
+            "attrs": {
+              "layer": {
+                "--canvas-x": "6000",
+                "--canvas-y": "4500",
+                "--canvas-zoom": "0.0625"
+              }
+            }
+          }
+        }
+      ],
+      "notes": "ZMIN = 1/16 about (400, 300): the world point under the centre stays there, so the camera offset grows to (6000, 4500)."
+    },
+    {
+      "id": "camera.contract.reduced-motion-jumps-to-the-tween-target",
+      "area": "tween",
+      "config": { "reducedMotion": true },
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "tween",
+          "value": { "centre": [1000, 500] }
+        },
+        {
+          "expect": {
+            "attrs": {
+              "layer": { "--canvas-x": "-600", "--canvas-y": "-200" },
+              "state": { "tweening": "false", "reducedMotion": "true" }
+            }
+          }
+        }
+      ],
+      "notes": "Centring world (1000, 500) in an 800 x 600 viewport at zoom 1 needs t = (-600, -200); with reduced motion the camera is there at once."
+    },
+    {
+      "id": "camera.contract.a-tween-ends-where-the-jump-lands",
+      "area": "tween",
+      "config": {},
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "tween",
+          "value": { "centre": [1000, 500] }
+        },
+        {
+          "expect": {
+            "attrs": {
+              "layer": { "--canvas-x": "0", "--canvas-y": "0" },
+              "state": { "tweening": "true" }
+            }
+          }
+        },
+        { "event": "prop", "prop": "tick" },
+        {
+          "expect": {
+            "attrs": { "layer": { "--canvas-x": "-150", "--canvas-y": "-50" } }
+          }
+        },
+        { "event": "prop", "prop": "tick" },
+        { "event": "prop", "prop": "tick" },
+        {
+          "expect": {
+            "attrs": {
+              "layer": { "--canvas-x": "-450", "--canvas-y": "-150" },
+              "state": { "tweening": "true" }
+            }
+          }
+        },
+        { "event": "prop", "prop": "tick" },
+        {
+          "expect": {
+            "attrs": {
+              "layer": { "--canvas-x": "-600", "--canvas-y": "-200" },
+              "state": { "tweening": "false" }
+            }
+          }
+        },
+        { "event": "prop", "prop": "tick" },
+        {
+          "expect": {
+            "attrs": { "layer": { "--canvas-x": "-600", "--canvas-y": "-200" } }
+          }
+        }
+      ],
+      "notes": "Four linear ticks, the last exact; a tick at rest is a no-op. The end state equals the reduced-motion jump of the previous scenario."
+    },
+    {
+      "id": "camera.contract.a-gesture-stops-a-tween-in-place",
+      "area": "tween",
+      "config": {},
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "tween",
+          "value": { "centre": [1000, 500] }
+        },
+        { "event": "prop", "prop": "tick" },
+        { "event": "prop", "prop": "pan", "value": [5, 0] },
+        {
+          "expect": {
+            "attrs": {
+              "layer": { "--canvas-x": "-145", "--canvas-y": "-50" },
+              "state": { "tweening": "false" }
+            }
+          }
+        },
+        { "event": "prop", "prop": "tick" },
+        {
+          "expect": {
+            "attrs": { "layer": { "--canvas-x": "-145", "--canvas-y": "-50" } }
+          }
+        }
+      ],
+      "notes": "Any pan or zoom cancels a running tween where the camera is; the interrupted tween never resumes."
+    },
+    {
+      "id": "camera.contract.resize-keeps-the-top-left",
+      "area": "resize",
+      "config": {},
+      "steps": [
+        {
+          "event": "prop",
+          "prop": "zoom",
+          "value": { "factor": 2, "anchor": "centre" }
+        },
+        { "event": "prop", "prop": "resize", "value": 3 },
+        {
+          "expect": {
+            "attrs": {
+              "layer": {
+                "--canvas-x": "-200",
+                "--canvas-y": "-150",
+                "--canvas-zoom": "2"
+              },
+              "state": { "viewport": "{\"width\":1920,\"height\":1080}" }
+            }
+          }
+        }
+      ],
+      "notes": "Resizing changes only the viewport size; the camera (and so the world point at the top-left corner) is untouched."
+    }
+  ]
+}

package/scenarios/canvas/camera.excalidraw.json

@@ -0,0 +1,57 @@
+{
+  "pattern": "camera",
+  "source": "excalidraw",
+  "commit": "ed10ac7dca7e40f3f4a31269b4bfba980d0db41e",
+  "license": "MIT",
+  "copyright": "Copyright (c) 2020 Excalidraw",
+  "scenarios": [
+    {
+      "id": "camera.excalidraw.centre-target-keeps-zoom",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/fitToContent.test.tsx#L200",
+      "upstreamTest": "none > should keep the current zoom and only center the target",
+      "area": "extension",
+      "config": {
+        "viewport": { "w": 100, "h": 100 },
+        "camera": { "x": 0, "y": 0, "zoom": 0.5 },
+        "nodes": [{ "id": "rect", "x": 1000, "y": 1000, "w": 50, "h": 50 }]
+      },
+      "steps": [
+        {
+          "event": "tween",
+          "goal": { "centreOn": [1025, 1025] },
+          "animation": false
+        },
+        { "expect": { "camera": { "x": -925, "y": -925, "zoom": 0.5 } } }
+      ],
+      "notes": "Excalidraw scroll is world-offset, the same convention as camera.qnt (screen = (world + t) * zoom), so scrollX maps to tx. scroll = viewport / 2 / zoom - centre = 100 / 2 / 0.5 - 1025 = -925. Upstream uses toBeCloseTo on doubles; the fixed-point camera (zoom / 4096, t / 256) is exact here. fit 'none' is the centre-on-a-point goal of request_tween."
+    },
+    {
+      "id": "camera.excalidraw.animation-settles-on-target-and-stops",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/fitToContent.test.tsx#L368",
+      "upstreamTest": "scale-down animated > should stop ticking and settle on the target once complete",
+      "area": "extension",
+      "config": {
+        "viewport": { "w": 10, "h": 10 },
+        "camera": { "x": 0, "y": 0, "zoom": 1 },
+        "nodes": [{ "id": "rect", "x": -100, "y": -100, "w": 100, "h": 100 }]
+      },
+      "steps": [
+        {
+          "event": "tween",
+          "goal": { "fit": "scale-down", "target": "rect" },
+          "animation": true
+        },
+        { "event": "tick", "until": "settled" },
+        { "expect": { "tweenActive": false, "cameraMoved": true } },
+        { "event": "tick", "count": 3 },
+        {
+          "expect": {
+            "tweenActive": false,
+            "cameraUnchangedSinceSettled": true
+          }
+        }
+      ],
+      "notes": "Ported by intent: a finished tween removes itself and leaves the camera ON the target; further frames never move it (camera.qnt: RestIsOnTarget, a tick at rest is a no-op). The same goal with reduced motion (animation: false) must end in the identical camera. Fit-to-bounds itself is not modelled in camera.qnt (adapter policy); the target is whatever the host computes."
+    }
+  ]
+}

package/scenarios/canvas/marquee.excalidraw.json

@@ -0,0 +1,122 @@
+{
+  "pattern": "marquee",
+  "source": "excalidraw",
+  "commit": "ed10ac7dca7e40f3f4a31269b4bfba980d0db41e",
+  "license": "MIT",
+  "copyright": "Copyright (c) 2020 Excalidraw",
+  "scenarios": [
+    {
+      "id": "marquee.excalidraw.contain-shift-additive",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/selection.test.tsx#L67",
+      "upstreamTest": "box-selection > should allow adding to selection via box-select when holding shift",
+      "area": "selection",
+      "config": {
+        "boxSelection": "contain",
+        "camera": { "x": 0, "y": 0, "zoom": 1 },
+        "nodes": [
+          { "id": "rect1", "x": 0, "y": 0, "w": 50, "h": 50 },
+          { "id": "rect2", "x": 100, "y": 0, "w": 50, "h": 50 }
+        ]
+      },
+      "steps": [
+        { "event": "pointerdown", "at": [175, -20] },
+        { "event": "pointermove", "at": [85, 70] },
+        { "event": "pointerup" },
+        { "expect": { "selection": ["rect2"] } },
+        { "event": "modifier", "shift": true },
+        { "event": "pointerdown", "at": [75, -20] },
+        { "event": "pointermove", "at": [-15, 70] },
+        { "event": "pointerup" },
+        {
+          "expect": {
+            "selection": ["rect2", "rect1"],
+            "selectionOrder": "unordered"
+          }
+        }
+      ],
+      "notes": "Upstream first throws the pointer to (-1000, -1000) to get past the drag threshold; the port moves straight to the final point. Both boxes sit on empty canvas and fully enclose their node. Shift keeps the pointerdown selection and adds the marquee hits."
+    },
+    {
+      "id": "marquee.excalidraw.live-deselect-when-leaving",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/selection.test.tsx#L104",
+      "upstreamTest": "box-selection > should (de)select element when box-selecting over and out while not holding shift",
+      "area": "selection",
+      "config": {
+        "boxSelection": "contain",
+        "camera": { "x": 0, "y": 0, "zoom": 1 },
+        "nodes": [{ "id": "rect1", "x": 0, "y": 0, "w": 50, "h": 50 }]
+      },
+      "steps": [
+        { "event": "pointerdown", "at": [75, -20] },
+        { "event": "pointermove", "at": [-15, 70] },
+        { "expect": { "selection": ["rect1"] } },
+        { "event": "pointermove", "at": [100, -100] },
+        { "expect": { "selection": [] } },
+        { "event": "pointerup" },
+        { "expect": { "selection": [] } }
+      ],
+      "notes": "The marquee selection is live: it is recomputed from the rectangle on every move, so shrinking the rectangle away from a node deselects it before release."
+    },
+    {
+      "id": "marquee.excalidraw.contain-partial-overlap-selects-nothing",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/selection.test.tsx#L132",
+      "upstreamTest": "box-selection > should not select an element when the selection box only partially overlaps it",
+      "area": "selection",
+      "config": {
+        "boxSelection": "contain",
+        "camera": { "x": 0, "y": 0, "zoom": 1 },
+        "nodes": [{ "id": "rect1", "x": 0, "y": 0, "w": 50, "h": 50 }]
+      },
+      "steps": [
+        { "event": "pointerdown", "at": [25, -20] },
+        { "event": "pointermove", "at": [75, 70] },
+        { "event": "pointerup" },
+        { "expect": { "selection": [] } }
+      ],
+      "notes": "Excalidraw's default mode is contain, as in pointer.qnt. The node is a filled rectangle, so geometry-aware hit rules (hollow shapes) do not enter."
+    },
+    {
+      "id": "marquee.excalidraw.overlap-partial-selects",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/selection.test.tsx#L261",
+      "upstreamTest": "box-selection overlap mode > should select an element when the selection box partially overlaps it",
+      "area": "selection",
+      "config": {
+        "boxSelection": "overlap",
+        "camera": { "x": 0, "y": 0, "zoom": 1 },
+        "nodes": [{ "id": "rect1", "x": 0, "y": 0, "w": 50, "h": 50 }]
+      },
+      "steps": [
+        { "event": "pointerdown", "at": [25, -20] },
+        { "event": "pointermove", "at": [75, 70] },
+        { "event": "pointerup" },
+        { "expect": { "selection": ["rect1"] } }
+      ],
+      "notes": "The same drag as contain-partial-overlap-selects-nothing: contain selects a subset of overlap (pointer.qnt ContainSubsetOfOverlap). Upstream starts the app with boxSelectionMode 'overlap' in appState; the port states it as config."
+    },
+    {
+      "id": "marquee.excalidraw.unchanged-selection-does-not-churn",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/selection.test.tsx#L1407",
+      "upstreamTest": "selectedElementIds stability > box-selection should be stable when not changing selection",
+      "area": "extension",
+      "config": {
+        "boxSelection": "contain",
+        "camera": { "x": 0, "y": 0, "zoom": 1 },
+        "nodes": [{ "id": "rect", "x": 0, "y": 0, "w": 10, "h": 10 }]
+      },
+      "steps": [
+        { "event": "pointerdown", "at": [-100, -100] },
+        { "event": "pointermove", "at": [-50, -50] },
+        { "event": "pointerup" },
+        { "expect": { "selection": [], "selectionChanged": false } },
+        { "event": "pointerdown", "at": [-50, -50] },
+        { "event": "pointermove", "at": [50, 50] },
+        { "expect": { "selection": ["rect"], "selectionChanged": true } },
+        { "event": "pointermove", "at": [60, 60] },
+        { "expect": { "selection": ["rect"], "selectionChanged": false } },
+        { "event": "pointerup" },
+        { "expect": { "selection": ["rect"], "selectionChanged": false } }
+      ],
+      "notes": "Upstream asserts object identity of selectedElementIds (React state stability). The engine-neutral reading is selectionChanged: a step that leaves the selection set equal must not emit a selection change (a Solid signal must not fire; pointer.qnt announces only when a gesture ends with a changed selection)."
+    }
+  ]
+}

package/scenarios/canvas/pan.excalidraw.json

@@ -0,0 +1,46 @@
+{
+  "pattern": "pan",
+  "source": "excalidraw",
+  "commit": "ed10ac7dca7e40f3f4a31269b4bfba980d0db41e",
+  "license": "MIT",
+  "copyright": "Copyright (c) 2020 Excalidraw",
+  "scenarios": [
+    {
+      "id": "pan.excalidraw.secondary-button-threshold",
+      "upstream": "https://github.com/excalidraw/excalidraw/blob/ed10ac7dca7e40f3f4a31269b4bfba980d0db41e/packages/excalidraw/tests/pan.test.tsx#L46",
+      "upstreamTest": "secondary-button pan > pans past five pixels with no context menu",
+      "area": "extension",
+      "config": {
+        "dragThresholdPx": 5,
+        "button": "secondary",
+        "camera": { "x": 0, "y": 0, "zoom": 1 }
+      },
+      "steps": [
+        { "event": "pointerdown", "at": [100, 100] },
+        { "event": "pointermove", "at": [103, 104] },
+        {
+          "expect": {
+            "camera": { "x": 0, "y": 0, "zoom": 1 },
+            "panEngaged": false
+          }
+        },
+        { "event": "pointermove", "at": [106, 100] },
+        {
+          "expect": {
+            "camera": { "x": 0, "y": 0, "zoom": 1 },
+            "panEngaged": true
+          }
+        },
+        { "event": "pointermove", "at": [108, 103] },
+        {
+          "expect": {
+            "camera": { "x": 2, "y": 3, "zoom": 1 },
+            "panEngaged": true
+          }
+        },
+        { "event": "pointerup" }
+      ],
+      "notes": "The threshold is a SCREEN quantity: 5 px away (dx 3, dy 4) is still a click, 6 px engages the pan. Upstream then pans incrementally from the engage point (the engaging move itself does not move the view; the next move shifts the camera by delta / zoom). pointer.qnt differs on purpose: its hand-tool pan starts on the press with no threshold and keeps the grab world point under the pointer (PanKeepsGrabUnderPointer), and its threshold is DRAG_PX = 4 (squared distance > 16). Replay the threshold expectations (config.dragThresholdPx) against the pointing -> gesture edge; the camera expectations after engagement are an adapter-policy divergence. Context-menu and pointer-broadcast parts of the upstream test are host concerns and are not ported."
+    }
+  ]
+}