mesurer-solid 0.2.6-beta.0 → 0.2.7-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  # Mesurer agent integration
2
2
 
3
- Mesurer's agent integration is the rendered page itself. This guide matches `mesurer-solid@0.2.5` stable. The coding agent reads `window.__MESURER__` through the browser control it already has, consumes human visual intent, edits normal application source, and verifies the real Live result.
3
+ Mesurer's agent integration is the rendered page itself. This guide matches `mesurer-solid@0.2.6` stable. The coding agent reads `window.__MESURER__` through the browser control it already has, consumes human visual intent, edits normal application source, and verifies the real Live result.
4
4
 
5
5
  The normal agent workflow requires no Mesurer MCP server, Send-to-agent callback, or special browser transport. The optional `codex()` plugin is a separate human convenience path for sending Context feedback into local Codex threads; it does not replace the browser-state contract described here. In Electron it can use the native preload bridge. In an ordinary browser it can use the local Mesurer Codex Bridge companion on loopback. Neither path is the Mesurer Solid ChatGPT/Codex agent plugin.
6
6
 
@@ -26,9 +26,9 @@ The installer writes a self-contained skill and injection artifact:
26
26
 
27
27
  ## Know the available capabilities
28
28
 
29
- The base inspector includes Select, X-ray, Color Picker, Rulers, Typography, Guides, Distance, and Settings. Color Picker uses application-local host capture when available and otherwise uses a working browser `EyeDropper`.
29
+ The base inspector includes Select, X-ray, Color Picker, Rulers, Typography, Guides, Distance, and Settings. Color Picker uses application-local host capture when available and otherwise uses a working browser `EyeDropper`, which needs Chromium on Windows or macOS and is hidden where unavailable. Mount-time toolbar placement (`toolbar: { position, dock, draggable }`) is a human-UI option documented in the [package README](./README.md), not an agent control.
30
30
 
31
- First-party plugins add Context, Edit, Layout Guides, Screenshot, Recording, and optional Codex delivery. Recording is a human video-capture workflow with a typed `recording:v1` service; it is not the normal coding-agent evidence channel. Edit movement preserves the existing Arrange agent method names for compatibility. The complete public map, including the low-level inspection methods and plugin host, is in [Capabilities](../../docs/CAPABILITIES.md).
31
+ First-party plugins add Context, Edit, Layout Guides, Screenshot, Recording, and optional Codex delivery. Recording is a human video-capture workflow with a typed `recording:v1` service; it is not the normal coding-agent evidence channel. Its `export` accepts an optional `speed` of exactly 0.5, 1, 1.5, or 2; any other value is rejected (see [Recording](../../docs/RECORDING.md)). Edit movement preserves the existing Arrange agent method names for compatibility. The complete public map, including the low-level inspection methods and plugin host, is in [Capabilities](../../docs/CAPABILITIES.md).
32
32
 
33
33
  Rulers, ordinary Guides, and Layout Guides remain available while the human is in Edit; X-ray, Color Picker, Typography, Screenshot, and Recording remain Select-lane tools. For normal coding-agent work, use `window.__MESURER__`. Use `window.__MESURER_INSTANCE__` only when the task requires mounted-instance or plugin-host operations.
34
34
 
@@ -124,7 +124,7 @@ Use the high-level Context and saved-intent methods for normal UI work. The lowe
124
124
 
125
125
  | Method | Use it for |
126
126
  | --- | --- |
127
- | `ready()` | Wait for Mesurer to finish loading. |
127
+ | `ready()` | Wait for Mesurer to finish loading: plugins registered, the toolbar rendered with its complete tool set, and layout stable. |
128
128
  | `describe()` | Read loaded plugins and their tools, settings, overlays, state, commands, hooks, and services. |
129
129
  | `inspect(selector, index?)` | Inspect one matching rendered element. |
130
130
  | `inspectAll(selector, limit?)` | Inspect several matches without changing selection. |
package/README.md CHANGED
@@ -4,7 +4,7 @@ Framework-agnostic UI inspection, measurement, visual intent, and agent-readable
4
4
 
5
5
  Mesurer Solid ships its own isolated Solid 2 renderer. Host applications can use Solid 1 or 2, React, Vue, Svelte, vanilla DOM, or an Electron renderer without providing Solid.
6
6
 
7
- **Current stable:** `mesurer-solid@0.2.5` on the `latest` dist-tag.
7
+ **Current stable:** `mesurer-solid@0.2.6` on the `latest` dist-tag.
8
8
 
9
9
  <p align="center">
10
10
  <img src="https://raw.githubusercontent.com/jhomra21/mesurer-solid/main/docs/assets/readme/hero-multi-spacing.png" alt="Mesurer Solid measuring spacing between selected elements" width="100%">
@@ -48,7 +48,7 @@ For Vite, put this in the existing browser entry such as `src/main.tsx`, `src/ma
48
48
 
49
49
  `src/dev/mesurer.ts` is an optional organization pattern, not a required filename or directory. Do not mount Mesurer from `vite.config.ts`, server/API code, Node-only scripts, an Electron main process, or a module that also executes during SSR.
50
50
 
51
- The returned handle owns the mount. Await `mesurer.ready` when startup completion, initial rendered stability, or direct host access matters, call `mesurer.dispose()` for explicit cleanup, or pass `signal` when an existing lifecycle should own disposal.
51
+ The returned handle owns the mount. Await `mesurer.ready` when startup completion, initial rendered stability, or direct host access matters. It resolves after every initial plugin has registered and the toolbar has rendered its complete tool set, so toolbar buttons are at their final positions and can be clicked immediately. Call `mesurer.dispose()` for explicit cleanup, or pass `signal` when an existing lifecycle should own disposal.
52
52
 
53
53
  Full placement examples: [Getting started](https://github.com/jhomra21/mesurer-solid/blob/main/docs/GETTING_STARTED.md).
54
54