aem-eds-kit 0.4.57 → 0.4.58

package/CHANGELOG.md

@@ -29,6 +29,11 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   Version links point at npm; the GitHub release links never existed.
 
 ### Fixed
+- **The site has a menu on phones** (EDS-079). Below 720px the nav links were
+  hidden with nothing to bring them back; a menu button (with `aria-expanded`,
+  closing on Esc, a link tap or widening the window) now opens them as a
+  full-width list on every page, with GitHub and npm inside it under 480px,
+  each with its mark (EDS-081).
 - **Scraped designs keep section backgrounds and one-sided lines** (EDS-067).
   A full-width band with no background of its own now carries the colour painted
   behind it (`inheritedBackground`, usually the page background), which the prompt
@@ -50,6 +55,17 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   where the Universal Editor boilerplate actually lives.
 
 ### Added
+- **Drafts: review rounds before a block reaches the repository** (EDS-085).
+  `block from-design --draft` keeps the result as a version under
+  `tmp/eds-cli/drafts/<name>/` and leaves `blocks/` untouched; `eds draft
+  preview | refine "<feedback>" | accept [--commit|--branch] | discard | list`
+  reviews it, adds a version per round and, on accept, copies it into
+  `blocks/<name>/` and commits it with the rounds in the message.
+- **A docs gate in CI** (EDS-083). On a PR, a change under `src/` fails without
+  a `CHANGELOG.md` entry, and a change to the CLI surface (`src/bin/eds.ts`) fails
+  without `README.md` (the npm page) and `site/docs.html` updates. Plus a PR
+  template with a docs checklist, and the rule in `CODING_STANDARDS.md` /
+  `CLAUDE.md`.
 - **Any web page is a design source** (EDS-065). `block from-design` scrapes
   every http(s) link that isn't Figma, Framer or Stitch (`--provider web`): a
   live site you're rebuilding, an HTML mock-up, or the project's own example page

package/README.md

@@ -435,6 +435,7 @@ eds block from-design "<figma-url>" --dry-run       # just build the prompt
 | `--refresh` | Ignore the cached snapshot and re-fetch |
 | `--sample` | Use the bundled sample design, the example file's hero (no URL, token or MCP) |
 | `--serve` | Auto-start the live preview (non-interactive runs only) |
+| `--draft` | Generate a draft for review instead of writing `blocks/<name>/` (see [`eds draft`](#eds-draft)) |
 | `--yes` | Skip confirmation prompts |
 
 Set a **Figma Personal Access Token** (scope `file_content:read`) to use the REST path — via `FIGMA_TOKEN` env or `figma.token` in config. The block generation model defaults to the fastest (Haiku); override with `model` in config.
@@ -455,6 +456,21 @@ Interactive wizard that:
 3. Shows install commands if not
 4. Saves preferences to `~/.eds/config.json`
 
+### `eds draft`
+
+Review a block before it reaches the repository. With `--draft`, `block from-design` keeps its result as a **draft version** under `tmp/eds-cli/drafts/<name>/v1/`. `blocks/<name>/` stays exactly as it was: an existing block is set aside while the agent works and always put back. Each review round adds a version; nothing is written to `blocks/` until the draft is accepted, either right away or after a few rounds.
+
+```bash
+eds block from-design "<design link>" --name hero --draft   # → draft v1
+eds draft preview hero                                      # review it (latest version)
+eds draft refine hero "bigger headline, orange buttons"     # one more round → v2
+eds draft accept hero --branch feature/hero                 # → blocks/hero/, committed
+eds draft list                                              # drafts and their versions
+eds draft discard hero                                      # drop it; blocks/ untouched
+```
+
+`accept --commit` (or `--branch <name>`, created if missing) commits only `blocks/<name>/`, with the review rounds in the message (`v1: first version`, `v2: "bigger headline, orange buttons"`). `refine` reuses the agent and model that made the draft unless you pass `--agent` / `--model`; `preview` and `accept` take `--version <n>`.
+
 ### `eds block list`
 
 Lists all blocks in the project with their file status and Figma source info.
@@ -744,6 +760,8 @@ git clone https://github.com/piotrgodycki/aem-eds-kit.git && cd aem-eds-kit
 npm install
 ```
 
+Each change goes through an issue (`EDS-NNN`), a `feature/EDS-NNN` or `bug/EDS-NNN` branch and a PR, and **ships with its docs**: a `CHANGELOG.md` entry, `README.md` (this file is also the npm page) and the site pages it touches. CI's docs gate (`scripts/check-docs.mjs`) fails a PR that changes `src/` without a changelog entry, or the commands and flags in `src/bin/eds.ts` without `README.md` and `site/docs.html`. See [`CODING_STANDARDS.md`](https://github.com/piotrgodycki/aem-eds-kit/blob/main/CODING_STANDARDS.md).
+
 ### Scripts
 
 ```bash