publishport-opencli 1.0.39 → 1.0.42

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "publishport-opencli",
3
- "version": "1.0.39",
3
+ "version": "1.0.42",
4
4
  "publishConfig": {
5
5
  "access": "public",
6
6
  "provenance": false
@@ -130,7 +130,7 @@ Error envelope always includes `error.code` and `error.message`. Target errors (
130
130
 
131
131
  | command | purpose |
132
132
  |---------|---------|
133
- | `browser state` | Snapshot: text tree with `[N]` refs, scroll hints, hidden-interactive hints, `compounds (N):` sidecar for date/select/file refs. |
133
+ | `browser state [--max-chars N]` | Snapshot: text tree with `[N]` refs, scroll hints, hidden-interactive hints, `compounds (N):` sidecar for date/select/file refs. Output is capped at 12000 characters by default; when cut, a `… truncated:` line says how much is left — the unprinted refs still work. Reach them with `find --text/--role/--css`, `scroll` + `state`, or `extract`; `--max-chars 0` prints everything. |
134
134
  | `browser state --source ax` | Opt-in accessibility-tree snapshot. Use when custom controls, portals, or iframe contents are hard to identify in normal `state`. AX refs can recover stale React re-renders by role/name/nth and can route same-origin iframe refs. Cross-origin iframe refs are best-effort because Chrome may not expose attachable OOPIF targets to extensions. |
135
135
  | `browser state --compare-sources` | Metrics-only DOM vs AX comparison for deciding whether AX should become default. It prints counts and sizes, not page text, so it is safer to share for validation. |
136
136
  | `browser find --css <sel> [--limit N] [--text-max N]` | Run a CSS query and return one entry per match with `{nth, ref, tag, role, text, attrs, visible, compound?}`. Allocates refs for matches the prior snapshot didn't tag. Cheap alternative to `state` when you already know the selector. |
@@ -341,7 +341,7 @@ Think about payload size per call. Budgets exist for a reason.
341
341
 
342
342
  | command | rough cost | when to use |
343
343
  |---------|-----------|-------------|
344
- | `state` | medium (bounded by internal budget) | First call on any page, after every nav, when you need refs. |
344
+ | `state` | medium (≤ 12000 chars by default, `--max-chars`) | First call on any page, after every nav, when you need refs. |
345
345
  | `find --css <sel>` | small | You already know the selector — one query, compact entries. |
346
346
  | `get title` / `get url` | tiny | Sanity checks between steps. |
347
347
  | `get text/value/attributes` | tiny per call | Verifying one specific field. |