mesurer-solid 0.1.3-beta.0 → 0.1.3

package/AGENT_INTEGRATION.md

@@ -141,6 +141,44 @@ reviewArrange(id, tolerance?)
 
 There is no `send`, `screenshots`, or `sendContext` delivery capability. Screenshot bytes stay with the outer browser harness.
 
+## Broad Mesurer/context requests mean inspect all human intent
+
+If the user says “check Mesurer,” “check Measure,” “look at Mesurer context,” “see what I highlighted/moved/annotated,” or otherwise asks generally about Mesurer state, treat that as a request to inspect the **combined live review state**, not only the return value of `context()`.
+
+Start with a non-destructive inventory:
+
+```js
+const capabilities = window.__MESURER__.capabilities().capabilities
+const workspace = await window.__MESURER__.context()
+const annotations = await window.__MESURER__.annotations()
+const arrangements = capabilities.arrange
+  ? await window.__MESURER__.arrangements()
+  : []
+
+let selection = null
+try {
+  selection = await window.__MESURER__.context({ scope: "selection" })
+} catch {}
+```
+
+Then resolve the saved human intent that is relevant to the task:
+
+```js
+const annotationContexts = await Promise.all(
+  annotations.map((annotation) =>
+    window.__MESURER__.context({ annotation: annotation.id })
+  ),
+)
+
+const arrangeIntents = await Promise.all(
+  arrangements.map((intent) => window.__MESURER__.arrange(intent.id)),
+)
+```
+
+Bring the useful pieces together before editing: target-bound notes, current selection, Arrange Before/Desired geometry, guides, measurements, held distances, exact target inspection, layout/style data, rulers/X-ray state, and any existing human screenshot preview that must be preserved.
+
+The user may have selected one element, annotated another, moved a group with Arrange, and left measurements/guides that explain the relationship. Those are not separate conversations. They are one encoded visual request. Do not ask the person to repeat information Mesurer already contains, and do not overwrite one channel before reading the others.
+
 ## Arrange has highest human-intent precedence
 
 Arrange lets a person reposition selected rendered elements into the layout they want without editing application source. If Arrange is available, consume relevant saved intents before changing human selection or editing source:
@@ -441,15 +479,16 @@ A good harness-level loop is:
 
 ```text
 1. discover/reuse Mesurer and preserve human state
-2. consume relevant Arrange intent first
-3. capture Before/Desired when useful, before source edits
-4. consume existing annotation/selection context
-5. resolve exact targets; ask only when genuinely ambiguous
-6. edit normal source
-7. wait for stable render
-8. switch Arrange to Live when applicable
-9. get fresh Arrange review/context and optional screenshot
-10. iterate until rendered evidence supports completion
+2. if the request is broad, inventory Arrange + annotations + selection + workspace context before narrowing
+3. consume relevant Arrange intent first
+4. capture Before/Desired when useful, before source edits
+5. consume existing annotation/selection context
+6. resolve exact targets; ask only when genuinely ambiguous
+7. edit normal source
+8. wait for stable render
+9. switch Arrange to Live when applicable
+10. get fresh Arrange review/context and optional screenshot
+11. iterate until rendered evidence supports completion
 ```
 
 Do not clear Arrange history, alter human measurements/guides, replace live Mesurer state, or use a temporary preview to make unfinished source work appear correct.

package/README.md

@@ -77,7 +77,31 @@ import { mountMesurer } from "mesurer-solid"
 const mesurer = mountMesurer()
 ```
 
-The base inspector includes Select, X-ray, Color Picker, Rulers, Text Inspector, Guides, Distance, Settings, the plugin host, and the low-level inspection API.
+The base inspector includes Select, X-ray, Rulers, Text Inspector, Guides, Distance, Settings, the plugin host, and the low-level inspection API. Color Picker is also available when the host exposes an operational native `EyeDropper`; it is intentionally hidden in unsupported hosts and has no DOM/CSS fallback.
+
+Text Inspector can inspect rendered typography and supports reversible Desired-text preview editing on double-click.
+
+### Keyboard shortcuts
+
+| Shortcut | Action |
+| --- | --- |
+| `M` | Toggle Mesurer visibility |
+| `S` | Select |
+| `X` | X-ray |
+| `P` | Native Color Picker when supported |
+| `R` | Rulers |
+| `A` | Text Inspector |
+| `G` | Guides |
+| `H` / `V` | Choose horizontal / vertical guide orientation |
+| `Alt` / `Option` | Distance overlay |
+| `Cmd/Ctrl + ,` | Settings |
+| `Shift + A` | Arrange when `arrangePlugin()` is mounted |
+| `Shift + S` | Screenshot when `screenshotPlugin()` is mounted |
+| `C` | Copy Context when `contextPlugin()` is mounted |
+| `Shift + C` | Copy Selection when `contextPlugin()` is mounted |
+| `N` | Add Note when `contextPlugin()` is mounted |
+
+In the current Codex browser host, Color Picker is not advertised and `P` is inert because native screen sampling is not operational there.
 
 ## Arrange
 
@@ -92,7 +116,7 @@ const mesurer = mountMesurer({
 })
 ```
 
-Select one or more page elements, click **Arrange**, and drag the selection. Hold **Shift** while dragging to lock movement to the dominant axis.
+Select one or more page elements, click **Arrange** or press **Shift+A**, and drag the selection. Arrange activates Select automatically and stays coordinated with selection state. Hold **Shift** while dragging to lock movement to the dominant axis.
 
 Each completed drag records one persisted, undoable intent containing:
 
@@ -204,7 +228,7 @@ Every selector must resolve to exactly one page target. Invalid, missing, or amb
 
 ## Annotations and review
 
-A human annotation stores a note plus an immutable rendered baseline:
+Mesurer Solid context annotations are semantic, target-bound review records. A note stays attached to the rendered element or region the person selected and keeps an immutable baseline together with the structured context around that target.
 
 ```js
 const annotations = await window.__MESURER__.annotations()
@@ -220,7 +244,11 @@ await window.__MESURER__.stable()
 const review = await window.__MESURER__.review(annotationId)
 ```
 
-Review reports concrete pixel changes and missing evidence rather than relying on source assumptions.
+Review reports concrete pixel changes and missing evidence rather than relying on source assumptions. Because the annotation already carries target identity, geometry, measurements, distances, guides, styles, and layout context, a coding agent can read what was highlighted directly instead of inferring intent from a drawn arrow or screenshot markup.
+
+Upstream Mesurer `0.1.1` added a separate drawing workflow with arrows, freehand pen strokes, text drawings, transforms, and grouped annotation tools. Mesurer Solid intentionally does not adopt that drawing surface for the current product. Its annotation workflow is designed around structured context that an agent can consume and review against the same rendered target. Screenshots remain a separate optional tool for cases where real pixel evidence is useful.
+
+The current upstream audit and intentional differences are documented in [`docs/UPSTREAM_PARITY.md`](https://github.com/jhomra21/mesurer-solid/blob/main/docs/UPSTREAM_PARITY.md).
 
 ## Agent integration
 
@@ -276,7 +304,7 @@ const mesurer = mountMesurer({
 })
 ```
 
-The human camera tool supports drag-region visible-tab capture, HiDPI/Retina-aware PNG cropping, copy/download settings, a draggable thumbnail, and a larger Copy/Save viewer.
+The human camera tool supports **Shift+S**, drag-region visible-tab capture, HiDPI/Retina-aware PNG cropping, copy/download settings, a draggable thumbnail, and a larger Copy/Save viewer.
 
 For coding-agent verification, the outer browser harness should normally own screenshot bytes. Mesurer supplies exact capture scope and can temporarily remove inspector presentation:
 
@@ -330,6 +358,7 @@ Mesurer's renderer is bundled and isolated from the host framework. Supported ho
 - [Context workflow](https://github.com/jhomra21/mesurer-solid/blob/main/docs/CONTEXT_WORKFLOW.md)
 - [Screenshots](https://github.com/jhomra21/mesurer-solid/blob/main/docs/SCREENSHOTS.md)
 - [Host isolation](https://github.com/jhomra21/mesurer-solid/blob/main/docs/HOST_ISOLATION.md)
+- [Upstream audit and intentional differences](https://github.com/jhomra21/mesurer-solid/blob/main/docs/UPSTREAM_PARITY.md)
 - [Agent integration](./AGENT_INTEGRATION.md)
 
 ## License

package/dist/arrange.js

@@ -2761,6 +2761,7 @@ var Qn = "mesurer.arrange", $n = "arrange", er = "mesurer.arrange.intents", tr =
 		e.tool.register({
 			id: "arrange",
 			label: "Arrange",
+			shortcut: "Shift+A",
 			order: 65,
 			command: ar,
 			icon: mr,
@@ -2899,7 +2900,7 @@ var Qn = "mesurer.arrange", $n = "arrange", er = "mesurer.arrange.intents", tr =
 ].join(",");
 //#endregion
 //#region src/version.ts
-var jr = "0.1.3-beta.0", Mr = tr, Nr = Qn, Pr = $n, Fr = nr, Ir = er, Lr = () => ({
+var jr = "0.1.3", Mr = tr, Nr = Qn, Pr = $n, Fr = nr, Ir = er, Lr = () => ({
 	...Ar(),
 	version: jr
 });