@se-studio/contentful-cms 3.10.0 → 3.10.1

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.
Files changed (46) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/commands/discard.d.ts +3 -0
  3. package/dist/commands/discard.d.ts.map +1 -1
  4. package/dist/commands/discard.js +16 -2
  5. package/dist/commands/discard.js.map +1 -1
  6. package/dist/commands/entry-lookup-target.d.ts +18 -0
  7. package/dist/commands/entry-lookup-target.d.ts.map +1 -1
  8. package/dist/commands/entry-lookup-target.js +14 -1
  9. package/dist/commands/entry-lookup-target.js.map +1 -1
  10. package/dist/commands/nav.d.ts.map +1 -1
  11. package/dist/commands/nav.js +46 -30
  12. package/dist/commands/nav.js.map +1 -1
  13. package/dist/commands/preview.d.ts.map +1 -1
  14. package/dist/commands/preview.js +23 -8
  15. package/dist/commands/preview.js.map +1 -1
  16. package/dist/contentful/cma-user-agent.d.ts +1 -1
  17. package/dist/generated/help-topics.d.ts.map +1 -1
  18. package/dist/generated/help-topics.js +1 -1
  19. package/dist/generated/help-topics.js.map +1 -1
  20. package/dist/generated/hosted-guide.d.ts +1 -1
  21. package/dist/generated/hosted-guide.d.ts.map +1 -1
  22. package/dist/generated/hosted-guide.js +1 -1
  23. package/dist/generated/hosted-guide.js.map +1 -1
  24. package/dist/generated/version.d.ts +1 -1
  25. package/dist/generated/version.js +1 -1
  26. package/dist/mcp/tools/cms-edit.d.ts +1 -1
  27. package/dist/mcp/tools/cms-edit.d.ts.map +1 -1
  28. package/dist/mcp/tools/cms-edit.js +7 -3
  29. package/dist/mcp/tools/cms-edit.js.map +1 -1
  30. package/dist/preview/resolve-preview-entry.d.ts +18 -0
  31. package/dist/preview/resolve-preview-entry.d.ts.map +1 -0
  32. package/dist/preview/resolve-preview-entry.js +30 -0
  33. package/dist/preview/resolve-preview-entry.js.map +1 -0
  34. package/dist/session/navigation-fields.d.ts +21 -0
  35. package/dist/session/navigation-fields.d.ts.map +1 -0
  36. package/dist/session/navigation-fields.js +79 -0
  37. package/dist/session/navigation-fields.js.map +1 -0
  38. package/dist/session/refs.d.ts +3 -3
  39. package/dist/session/refs.d.ts.map +1 -1
  40. package/dist/session/refs.js +6 -15
  41. package/dist/session/refs.js.map +1 -1
  42. package/docs/editor-tasks/navigation.md +11 -6
  43. package/docs/help/lookup.md +6 -3
  44. package/docs/mcp/hosted-guide.md +3 -2
  45. package/package.json +1 -1
  46. package/skills/core/SKILL.md +10 -3
@@ -70,7 +70,7 @@ cms-edit open --include-chrome --page-slug /pricing
70
70
 
71
71
  `open` / `peek` fetch the page (or article) tree and the template entry, but **not** template `menu` / `footer` / navigation. Edit nav with `nav open`. Pass `--include-chrome` only when you need those trees.
72
72
 
73
- **Flat lookup flags:** provide **exactly one** primary flag per `open` / `resolve` / `nav open`. See `cms-edit help lookup`. Run `cms-edit index sync` so catalog types resolve from the local index.
73
+ **Flat lookup flags:** provide **exactly one** primary flag per `open` / `peek` / `resolve`. `nav open` uses **`--nav-id` or `--nav-name` only** (not `--id`). See `cms-edit help lookup`. Run `cms-edit index sync` so catalog types resolve from the local index.
74
74
 
75
75
  ### Step 2: Read the snapshot
76
76
 
@@ -399,8 +399,9 @@ JSON output for upload (`CMS_EDIT_JSON=1`): `{ ok, id, fileName, url, mediaId?,
399
399
  ## Navigation
400
400
 
401
401
  ```bash
402
- # Open a navigation entry (navigation uses `name`, not slug)
402
+ # Open a navigation entry (not --id). Navigation uses `name`, not slug.
403
403
  cms-edit nav open --nav-name "Main navigation"
404
+ cms-edit nav open --nav-id <navigation-entry-id>
404
405
 
405
406
  # Add a new item
406
407
  cms-edit nav add --label "Pricing" --slug /pricing
@@ -409,11 +410,17 @@ cms-edit nav add --label "Docs" --href https://docs.example.com --after @c1
409
410
  # Link an existing NavigationItem (share items across navigations)
410
411
  cms-edit nav add --existing-id <navigationItem-entry-id>
411
412
 
412
- # Clone a navigation (duplicates all items)
413
+ # Clone a navigation (first-level items only; nested children stay shared)
413
414
  cms-edit nav clone <source-nav-id>
414
415
  cms-edit nav clone <source-nav-id> --label "LP Nav" --slug lp-nav
415
416
  ```
416
417
 
418
+ Template **`menu`** is site-wide. **`page.menu`** overrides one page. Header CTAs are often nested under a wrapper and **shared**. Before `set` on a nav item, ask whether the change is global or page-specific. Page-specific: new NavigationItem + cloned/new menu on `page.menu` — do not mutate the shared entry.
419
+
420
+ `peek` is one-shot. `open` / `nav open` persist. `preview urls /slug` follows that slug even if session `_mcp` is another page.
421
+
422
+ The items array field may be `entries`, `items`, or `navigationItems` — inspect `read @root` before `set @root … --links`.
423
+
417
424
  ## Create New Entries
418
425
 
419
426
  ```bash