aem-eds-kit 0.4.12 → 0.4.16

package/CHANGELOG.md

@@ -6,7 +6,50 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
-## [0.4.12] - 2026-10-08
+## [0.4.16] - 2026-10-08
+
+### Changed
+- **`eds template new` is now authoring-aware.** It detects the model from
+  `fstab.yaml` / project markers (or `--authoring da|gdrive|sharepoint|ue`) and
+  routes the generated page: **DA** push (existing), an **importable doc** for
+  **Google Docs / SharePoint**, and for **Universal Editor** it registers the
+  seeded blocks in `component-filters.json` (so authors can add them) and points
+  to the AEM editable template. Completes the per-model template paths shown as
+  an infographic on the docs page.
+
+### Added
+- **`eds template new <name>`** - generate EDS page **initial content** (the EDS
+  analog of an AEM template): a document of sections + chosen blocks + a metadata
+  block. Writes `templates/<name>.html` locally and, with `--push`, pushes it to
+  **DA (da.live)** via the source API (org/site from `.edsrc.json` or flags;
+  `DA_TOKEN` for protected projects). `--path`, `--title`, `--description`,
+  `--blocks`, `--area`. Also in the menu. (UE/crosswalk templates come next.)
+- Docs: a **"From zero to a published page"** step-by-step command path.
+
+## [0.4.14] - 2026-10-08
+
+### Added
+- **`eds schema block <name>` (JSON-LD)** - inject a schema.org structured-data
+  builder into a block's `decorate()`. Types: Article, FAQPage, BreadcrumbList,
+  Product, Organization, LocalBusiness, Event, VideoObject, Recipe, HowTo.
+  Idempotent, reads the block content via a `root` alias, appends a
+  `<script type="application/ld+json">` to the head. `--type`, interactive picker.
+- **`eds scaffold helpers`** - write `scripts/utils.js`, picking the helpers you
+  want in an interactive checkbox (dependencies pulled in automatically) or by
+  name: `toCamelCase`, `getPagePath` / `getLanguageRootPath`, `getSiteArea`
+  (top-level area, e.g. blog), `getEnvironment`, `getContentTopic`, `isUEEdit` /
+  `isUEPreview` / `isUE`, `getMetadata`. Also in the `eds scaffold` picker.
+
+## [0.4.13] - 2026-10-08
+
+### Added
+- **Model partials & helpers** - a library of reusable Universal Editor field
+  groups (heading, image, link, cta, cta-group, classes, eyebrow, richtext,
+  embed, teaser, card) built from typed field builders (correct `valueType` per
+  component), plus **`eds model add <block> [partials...]`** to compose them into
+  a block's `_<block>.json` (added by name, never duplicated). The from-design /
+  migrate prompt now lists the catalog so the agent reuses the standard groups
+  instead of inventing fields. Also in the menu.
 
 ### Added
 - **Framer** as a design source for `block from-design` (alongside Figma, Google
@@ -208,7 +251,11 @@ harness, gradient ANSI logo. Not published (superseded by 0.3.0).
 Initial CLI scaffold: `block create`, `block from-figma`, `block list`,
 `figma setup`, `doctor`, `preview`, `publish`. Not published.
 
-[Unreleased]: https://github.com/piotrgodycki/aem-eds-kit/compare/v0.4.12...HEAD
+[Unreleased]: https://github.com/piotrgodycki/aem-eds-kit/compare/v0.4.16...HEAD
+[0.4.16]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.16
+[0.4.15]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.15
+[0.4.14]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.14
+[0.4.13]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.13
 [0.4.12]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.12
 [0.4.11]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.11
 [0.4.10]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.10

package/README.md

@@ -87,6 +87,41 @@ eds integrate
 eds doctor
 ```
 
+## From zero to a published page
+
+The full path, command by command. This example targets **DA (da.live)** authoring.
+
+```bash
+# 1. Install the CLI
+npm i -g aem-eds-kit
+
+# 2. Set up the project (pick DA, enter org + site). Writes fstab + CI + naming.
+eds init --authoring da --org my-org --site my-site
+
+# 3. Scaffold the Universal Editor config + helper functions
+eds scaffold ue
+eds scaffold helpers
+
+# 4. Build blocks - from a design, from scratch, or migrated from classic AEM
+eds block from-design            # paste a Figma/Stitch/Canva/Sketch/Framer link
+# eds block create hero
+# eds migrate component ./components/hero
+
+# 5. Enrich a block (optional)
+eds model add hero teaser        # add reusable field-group partials
+eds schema block hero --type Article   # JSON-LD structured data
+eds track block hero             # dataLayer click + form-submit tracking
+
+# 6. Generate the page (initial content) and push it to DA
+eds template new homepage --blocks hero,cards --push --org my-org --site my-site
+
+# 7. Preview, then publish
+eds preview /templates/homepage
+eds publish /templates/homepage
+```
+
+Every step is also interactive when you omit the flags - run `eds` for the menu.
+
 ## Commands
 
 ### `eds init`
@@ -107,6 +142,25 @@ eds init --name my-site --authoring da --org my-org --site my-site --yes
 | `--no-ci` | Skip the GitHub Actions workflow |
 | `--yes` | Skip prompts; apply with flags/defaults |
 
+### `eds template new <name>`
+
+Generate EDS page **initial content** - the EDS analog of an AEM template: a document of sections + chosen blocks + a metadata block. It always writes `templates/<name>.html`, then **routes by your authoring model** (detected from `fstab.yaml` / project markers, or `--authoring`): **DA** → push to da.live (`--push`, org/site from `.edsrc.json`/flags, `DA_TOKEN` for protected projects); **Google Docs / SharePoint** → importable doc + the external steps; **Universal Editor** → registers the seeded blocks in `component-filters.json` and points you to the AEM editable template. Interactive when flags are omitted.
+
+```bash
+eds template new homepage                         # interactive (blocks, DA push)
+eds template new homepage --blocks hero,cards --push --org my-org --site my-site
+```
+
+| Flag | Description |
+|---|---|
+| `--blocks <list>` | Comma-separated block ids to seed |
+| `--title` / `--description` / `--area` | Page title, description, metadata label |
+| `--path <path>` | Content path (default `/templates/<name>`) |
+| `--authoring <model>` | Force `da` \| `gdrive` \| `sharepoint` \| `ue` (else detected) |
+| `--push` | Push to DA (da.live) |
+| `--org` / `--site` | DA org / site (else from `.edsrc.json`) |
+| `--yes` | Skip prompts |
+
 ### `eds migrate component [dir]`
 
 Start migrating a **classic AEM component** to EDS. Phase 1 is deterministic (no agent, no network): it parses the component's Touch UI dialog (`_cq_dialog/.content.xml`) and maps its Granite/Coral fields onto the **17 Universal Editor field types** - selects keep their options, multifields become repeatable containers, tabs are preserved - then writes `blocks/<name>/` with a UE model (`_<name>.json`), a `decorate()` stub (port the HTL logic), and a scoped CSS file to fill from the component's clientlib or its rendered page.
@@ -129,6 +183,27 @@ eds track block hero
 eds track block hero --no-submit        # clicks only
 ```
 
+### `eds model add <block> [partials...]`
+
+Compose **reusable field groups (partials)** into a block's Universal Editor model (`_<block>.json`) instead of hand-writing fields. Fields are added **by name**, so re-running never duplicates. Partials are built from typed field helpers (each sets the right `valueType`), and the same catalog is referenced in the `from-design` / `migrate` prompt so the agent reuses the standard groups.
+
+```bash
+eds model add hero teaser              # image + eyebrow + title + text + cta
+eds model add cards card cta-group     # pick several
+eds model add hero                     # interactive checkbox picker
+```
+
+Built-in partials: `heading`, `eyebrow`, `image`, `richtext`, `link`, `cta`, `cta-group`, `classes` (section styles), `embed`, `teaser`, `card`.
+
+### `eds schema block <name>`
+
+Inject a **JSON-LD (schema.org) structured-data** builder into a block's `decorate()` for SEO / rich results. Pick a type - `Article`, `FAQPage`, `BreadcrumbList`, `Product`, `Organization`, `LocalBusiness`, `Event`, `VideoObject`, `Recipe`, `HowTo` - and it appends a `<script type="application/ld+json">` to the head, built from the block's content (aliased to `root`, so it's independent of the parameter name). Idempotent; some fields are heuristic or `TODO`, so review and validate with Google's Rich Results test.
+
+```bash
+eds schema block faq --type FAQPage
+eds schema block article              # interactive type picker
+```
+
 ### `eds block create <name>`
 
 Scaffolds `blocks/<name>/` with `<name>.js`, `<name>.css`, **and a Universal Editor model `_<name>.json` by default** - so the block is authorable in UE the moment it's created. Validates kebab-case naming and checks for collisions.
@@ -203,6 +278,14 @@ Scaffold Universal Editor components deterministically (no agent). `eds scaffold
 ```bash
 eds scaffold ue
 eds scaffold blocks            # all, or: eds scaffold blocks hero cards
+eds scaffold helpers           # scripts/utils.js with common EDS helpers
+```
+
+`eds scaffold helpers` writes `scripts/utils.js` - **tick the helpers you want** in an interactive checkbox (dependencies are pulled in automatically), or pass names. Available: `toCamelCase`, `getPagePath` / `getLanguageRootPath`, `getSiteArea` (top-level area like `blog`), `getEnvironment`, `getContentTopic`, `isUEEdit` / `isUEPreview` / `isUE`, and `getMetadata`.
+
+```bash
+eds scaffold helpers                    # interactive picker
+eds scaffold helpers getSiteArea getEnvironment
 ```
 
 ### `eds scaffold ci`