@whzxc/agent-design-gallery 0.15.0 → 0.16.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.
- package/README.md +5 -2
- package/package.json +2 -1
- package/public/app.js +602 -64
- package/public/assets.js +25 -10
- package/public/boards.js +8 -3
- package/public/frame-identity.js +25 -12
- package/public/icons.js +7 -0
- package/public/index.html +14 -2
- package/public/motion-flow.js +28 -0
- package/public/motion-identity.js +100 -0
- package/public/motion-paint.js +332 -0
- package/public/motion-scene.js +165 -0
- package/public/motion-specimens.js +335 -0
- package/public/player.css +270 -0
- package/public/player.js +753 -0
- package/public/recent-updates.js +535 -0
- package/public/style.css +17 -2
- package/public/tokens.css +6 -0
- package/public/view-boards.css +131 -0
- package/public/view-boards.js +350 -0
- package/public/view-route.js +1 -1
- package/src/boards/motion-board.mjs +202 -0
- package/src/boards/token-board.mjs +9 -5
- package/src/cli-output.mjs +3 -1
- package/src/cli.mjs +52 -18
- package/src/http.mjs +5 -2
- package/src/recent-frames.mjs +295 -0
- package/src/recent-history.mjs +100 -0
- package/src/recent-job.mjs +63 -0
- package/src/recent-worker.mjs +171 -0
- package/src/server.mjs +229 -18
- package/src/toolkit/arch-git.mjs +8 -14
- package/src/toolkit/browser.mjs +1 -13
- package/src/toolkit/build-store.mjs +9 -1
- package/src/toolkit/build-worker.mjs +6 -0
- package/src/toolkit/build.mjs +22 -16
- package/src/toolkit/commands.mjs +93 -2
- package/src/toolkit/compare.mjs +13 -11
- package/src/toolkit/config.mjs +2 -2
- package/src/toolkit/diff-inputs.mjs +35 -26
- package/src/toolkit/diff.mjs +24 -11
- package/src/toolkit/frame-declarations.mjs +36 -0
- package/src/toolkit/git-blobs.mjs +50 -0
- package/src/toolkit/impact-inputs.mjs +11 -19
- package/src/toolkit/impact-selection.mjs +2 -2
- package/src/toolkit/impact.mjs +17 -3
- package/src/toolkit/implementation-map.mjs +17 -6
- package/src/toolkit/input-generation.mjs +15 -0
- package/src/toolkit/inspect-output.mjs +1 -1
- package/src/toolkit/inspect.d.ts +9 -1
- package/src/toolkit/inspect.mjs +25 -1
- package/src/toolkit/motion-check.mjs +382 -0
- package/src/toolkit/motion-css.mjs +105 -0
- package/src/toolkit/motion-flows.mjs +95 -0
- package/src/toolkit/motion-impact.mjs +87 -0
- package/src/toolkit/motion-inventory.mjs +202 -0
- package/src/toolkit/motion-label.mjs +111 -0
- package/src/toolkit/motion-patterns.mjs +216 -0
- package/src/toolkit/motion-primitives.mjs +94 -0
- package/src/toolkit/motion-queries.mjs +169 -0
- package/src/toolkit/motion.mjs +300 -0
- package/src/toolkit/owner.mjs +19 -6
- package/src/toolkit/play-endpoint.mjs +66 -0
- package/src/toolkit/project-index.mjs +2 -2
- package/src/toolkit/recent-structure.mjs +201 -0
- package/src/toolkit/results.mjs +2 -2
- package/src/toolkit/review-document.mjs +9 -4
- package/src/toolkit/review-embed-document.mjs +671 -0
- package/src/toolkit/review-filmstrip.mjs +76 -0
- package/src/toolkit/review-motion-card.mjs +51 -0
- package/src/toolkit/review-motion.mjs +159 -0
- package/src/toolkit/review-playback.js +123 -0
- package/src/toolkit/review-sheet.mjs +36 -28
- package/src/toolkit/review.mjs +131 -31
- package/src/toolkit/runtime.mjs +7 -1
- package/src/viewer-cache.mjs +48 -12
package/README.md
CHANGED
|
@@ -48,9 +48,10 @@ Path links locate a selection within its design hierarchy. Query links open an i
|
|
|
48
48
|
|
|
49
49
|
```sh
|
|
50
50
|
adg review --base=<rev> --json
|
|
51
|
+
adg review --base=<rev> --format=png --json
|
|
51
52
|
```
|
|
52
53
|
|
|
53
|
-
Choose the task's starting commit and share the
|
|
54
|
+
Choose the task's starting commit and share the artifact at `data.path`. The default HTML opens offline and supports enlargement and board links. Use PNG for a static summary in clients such as Antigravity. The current system theme is the default. Use `--viewer-url` to point HTML links at a different hub, or `--exact` to compare every frame scheduled by impact analysis. See the [review handoff workflow](docs/design-toolkit.md#review-handoff).
|
|
54
55
|
|
|
55
56
|
Every command accepts `--json`: finite commands return one versioned envelope, while foreground `open`/`serve` stream NDJSON events. `render` PNGs are in `data.captures`, with CSS and PNG pixel dimensions. See the [agent CLI interface](docs/agent-interface.md) for schemas, exits and recovery actions.
|
|
56
57
|
|
|
@@ -68,6 +69,8 @@ The bottom zoom bar holds Back, zoom out, the zoom menu, zoom in, Fit, and Minim
|
|
|
68
69
|
|
|
69
70
|
Design sources are TSX files directly in `design/components/`, `design/modules/` and `design/surfaces/`. Default discovery also includes `design/studies/` once it contains a direct TSX study; explicit `sources` lists remain unchanged. Fixtures and artwork stay in their supporting directories. Import `Frame` and `Icon` from `adg`, export reusable component functions, and default-export a function returning the declared frames. JSX builds static HTML and inline SVG without React or browser scripts. Tailwind v4 utilities resolve through the project's `design/tokens.css`; light and dark are selected by the document's `data-theme`.
|
|
70
71
|
|
|
72
|
+
ADG 0.16 reads version 1 `*.motion.json` sidecars beside TSX frame sources. Use `adg check --read-only --transitions --json` to validate the graph and `adg inspect --transition=<id> --explain --json` to inspect timing and identity pairs. CSS motion in existing frames warns by default; `check.strictMotion` opts into enforcement. See [frame transitions](docs/design-toolkit.md#frame-transitions).
|
|
73
|
+
|
|
71
74
|
Choose the **Tokens** tab to inspect the current project's `design/tokens.css`. The Tokens board presents paired light/dark colour swatches, typography, shape, elevation, sizing and motion samples, with click-to-copy token names and a top-bar toggle to switch to the list view. Typing in search filters the list view directly and returns to the board when cleared. Share `?scope=tokens` to open the board directly.
|
|
72
75
|
|
|
73
76
|
Follow the [design asset rules](docs/asset-rules.md) for placement, ownership, states, frame names, fidelity, lifecycle and studies. The [adoption guide](docs/asset-rules.md#adopting-an-existing-project) covers inventory, a read-only audit with `file / problem / suggested fix` findings, check-decided governance steps, the implementation checks a consumer adds, and the mappings/governance each consumer keeps locally. `sources` orders production layers from lower to higher; `check` reports upward imports. Set `check: { importDirection: false }` to opt out of that lint while keeping frame checks.
|
|
@@ -257,7 +260,7 @@ The LaunchAgent `org.agent-design-gallery.hub` starts the resident hub at login
|
|
|
257
260
|
|
|
258
261
|
### Review handoff
|
|
259
262
|
|
|
260
|
-
`adg review` compares the resolved Git base against the current working tree and writes one HTML
|
|
263
|
+
`adg review` compares the resolved Git base against the current working tree and writes one artifact. In HTML, frames are grouped by direct and inherited change. Each inherited group starts with the median-area representative and its outliers, and expands to show every member. Before and After are rendered as native document content; the Difference pane shows the pixel diff. Click a preview to enlarge it or a frame title to open its source on a registered ADG board. With `--format=png`, the artifact is a static summary with up to 12 image cards and an omitted-frame count when applicable.
|
|
261
264
|
|
|
262
265
|
The default hybrid pass uses equal rendered structure to skip screenshots for supported frames, and runs the pixel comparison for the rest. Use `adg review --exact` when pixel-equivalent review coverage is required. `adg diff` exposes exact comparison artifacts and verdicts for automation.
|
|
263
266
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@whzxc/agent-design-gallery",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.16.0",
|
|
4
4
|
"description": "Local TSX design toolkit and SVG viewer",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -32,6 +32,7 @@
|
|
|
32
32
|
"prepack": "node tooling/package.mjs"
|
|
33
33
|
},
|
|
34
34
|
"dependencies": {
|
|
35
|
+
"@babel/parser": "7.29.11",
|
|
35
36
|
"css-tree": "3.1.0",
|
|
36
37
|
"entities": "9.0.0",
|
|
37
38
|
"esbuild": "0.28.2",
|