@michaelmagan/dnumb 0.1.1 → 0.1.2
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/AGENTS.md +12 -15
- package/README.md +1 -1
- package/dist/digest/render.cjs +77 -1
- package/dist/digest/render.js +77 -1
- package/docs/digest.md +1600 -0
- package/package.json +4 -2
- package/skills/dnumb/SKILL.md +7 -7
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@michaelmagan/dnumb",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Turns a rendered page into measurements an agent can read: element geometry, overflow, clipping, and a text diff of what changed between two states.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent",
|
|
@@ -33,7 +33,8 @@
|
|
|
33
33
|
"files": [
|
|
34
34
|
"dist",
|
|
35
35
|
"skills",
|
|
36
|
-
"AGENTS.md"
|
|
36
|
+
"AGENTS.md",
|
|
37
|
+
"docs/digest.md"
|
|
37
38
|
],
|
|
38
39
|
"publishConfig": {
|
|
39
40
|
"access": "public",
|
|
@@ -133,6 +134,7 @@
|
|
|
133
134
|
"test:browser": "vitest run --project browser",
|
|
134
135
|
"test:all": "vitest run",
|
|
135
136
|
"test:travel": "bash scripts/travel-test.sh",
|
|
137
|
+
"check": "pnpm run typecheck && pnpm run lint && pnpm run test",
|
|
136
138
|
"check:package": "publint --strict && attw --pack .",
|
|
137
139
|
"release": "changeset publish"
|
|
138
140
|
}
|
package/skills/dnumb/SKILL.md
CHANGED
|
@@ -32,8 +32,8 @@ A menu overlapping the sibling before it — negative gap — clipped by its own
|
|
|
32
32
|
`npm install --save-dev @michaelmagan/dnumb` — MIT, zero dependencies. The library surface below is
|
|
33
33
|
built and tested. The CLI has a stable verb set — `capture`, `look`, `diff`, and
|
|
34
34
|
`q describe|find|at|within|distance|nearest|facts|color` — worked in
|
|
35
|
-
[README § From the CLI](
|
|
36
|
-
[§ Reading a diff](
|
|
35
|
+
[README § From the CLI](../../README.md#from-the-cli) and
|
|
36
|
+
[§ Reading a diff](../../README.md#reading-a-diff). This
|
|
37
37
|
file does not restate flags: run `dnumb --help` for the exhaustive, versioned list of what your
|
|
38
38
|
installed copy supports, and trust it over any prose here or there.
|
|
39
39
|
|
|
@@ -54,7 +54,7 @@ Read the digest. The header names the URL, the viewport, the capture state, and
|
|
|
54
54
|
carry facts. Most elements get their own line; a run of repeated siblings (a list, a table body)
|
|
55
55
|
folds into one summary line instead, naming each folded sibling's id and position but not its
|
|
56
56
|
descendants — see [`docs/digest.md` § The fold
|
|
57
|
-
line](
|
|
57
|
+
line](../../docs/digest.md#the-fold-line) before reading
|
|
58
58
|
an absent element in a fold as absent from the page. Anything measurable that does not fit its box
|
|
59
59
|
gets a bracketed fact on its own line.
|
|
60
60
|
|
|
@@ -102,9 +102,9 @@ contrast, it never says whether a ratio is good enough — that threshold lives
|
|
|
102
102
|
Five kinds of fact exist in total — `overflow-x`, `overflow-y`, `zero-box`, `clipped`, and `color`
|
|
103
103
|
(the one that never prints inline on an element line — only in the digest's `# colors:` header and
|
|
104
104
|
`q color`) — one line each on what the measurement *is* in
|
|
105
|
-
[AGENTS.md](
|
|
105
|
+
[AGENTS.md](../../AGENTS.md#facts-with-counter-facts),
|
|
106
106
|
full grammar in
|
|
107
|
-
[`docs/digest.md`](
|
|
107
|
+
[`docs/digest.md`](../../docs/digest.md#color).
|
|
108
108
|
|
|
109
109
|
**Element ids are stable within one capture only.** `e13` is an index in capture order, not a DOM
|
|
110
110
|
id. Inserting one element earlier in the document shifts every id after it. Never carry an id
|
|
@@ -141,6 +141,6 @@ Spend a round-trip when a visual impression needs checking. Do not sweep a page
|
|
|
141
141
|
|
|
142
142
|
The digest grammar — every token, every fact form, the fold and collapse syntax, and the parser
|
|
143
143
|
contract — is specified in
|
|
144
|
-
[`docs/digest.md`](
|
|
144
|
+
[`docs/digest.md`](../../docs/digest.md). `diffCaptures`
|
|
145
145
|
and the CLI's `diff` verb share one grammar, worked in
|
|
146
|
-
[README § Reading a diff](
|
|
146
|
+
[README § Reading a diff](../../README.md#reading-a-diff).
|