@one-million-lines/email-builder 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -4,6 +4,82 @@ All notable changes to this package are documented here.
 This project adheres to [Semantic Versioning](https://semver.org/) and the
 [Keep a Changelog](https://keepachangelog.com/) format.
 
+## [0.6.1] — 2026-09-03
+
+### Fixed
+
+- **Rich-text toolbar position** — removed incorrect `window.scrollY` / `scrollX`
+  offsets from the `position: fixed` toolbar. `getBoundingClientRect()` already
+  returns viewport-relative coordinates; adding scroll offsets pushed the toolbar
+  far off-screen when the canvas was scrolled. Also: toolbar is now clamped to
+  the viewport on all four edges; all popovers (link, colour, emoji, merge-tag)
+  now open **upward** (`bottom-full`) instead of downward, preventing them from
+  falling off-screen when the toolbar is near the bottom of the visible area.
+- **Color inputs show resolved hex** — `ColorInput` in the right sidebar now
+  displays the resolved hex value (e.g., `#FFFFFF`) in the text field instead of
+  the raw theme token string (e.g., `{colors.buttonText}`). The token is still
+  preserved in the document until the user types a custom value. The **Reset to
+  theme token** button tooltip was updated to show the token path.
+
+### Changed
+
+- **Recommendations → opt-in plugin** — the Recommendations panel in the right
+  sidebar is now hidden by default and only appears when explicitly enabled.
+  This decouples the feature from the core editor for hosts that do not use
+  personalised recommendations.
+  - New React prop: `<EmailBuilder enableRecommendations />`.
+  - New plugin object: `recommendationsPlugin` (pass to `registerPlugin()`).
+  - New `BuilderHandle` method: `builder.registerRecommendationsPlugin()`.
+  - New reactive store export: `useRecommendationsStore`.
+  - New documentation: `src/recommendations/README.md` — covers the data
+    schema, algorithm catalog, activation, backend processor integration, and
+    the legacy Vibetrace interop shape.
+  - **No breaking change for existing documents** — any `module.data.recommendations`
+    already in saved JSON is preserved; the panel just won't be visible until
+    the plugin is registered.
+
+## [0.6.0] — 2026-09-03
+
+### Added
+
+- **8 new email templates** covering core ecommerce lifecycle flows:
+  - `back-in-stock` — urgency-first product return notification
+  - `price-drop-alert` — 3-product grid with old/new price comparison
+  - `post-purchase-follow-up` — warm thank-you, usage tips, soft review request
+  - `review-request` — ⭐ prompt with founder personal note and CTA
+  - `replenishment-reminder` — "Running low?" reorder with subscription nudge
+  - `vip-early-access` — exclusive luxury-themed 24h early access
+  - `birthday-reward` — personalised (uses `{user.firstname}` merge tag) birthday voucher
+  - `win-back` — re-engagement with "what's new" grid and best offer
+- **HTML preview files** for all 16 templates generated via new script
+  (`scripts/generate-previews.mjs`) to `examples/previews/<id>.html`.
+  Each preview wraps the email HTML in a minimal browser shell with a sticky
+  info bar (template name, category, description).
+- `"generate:previews"` npm script: `npm run build && node scripts/generate-previews.mjs`.
+
+### Fixed
+
+- **Text selection loss** — `TextRender` in `Canvas.tsx` no longer uses
+  `dangerouslySetInnerHTML`. innerHTML is now synced from the store **only
+  when the element is not focused**, preventing React from clobbering
+  in-progress text selections or cursor positions during parent re-renders.
+  This was the root cause of "cursor jumps to start of block" when editing.
+- **Bold button missing** in the rich-text toolbar — replaced lucide `Bold`,
+  `Italic`, `Underline` icons with styled `<b>B</b>`, `<i>I</i>`, `<u>U</u>`
+  text to avoid icon availability issues and to match toolbar conventions.
+- **Link insertion** (`LinkPopover`) now correctly focuses the contenteditable
+  element and restores the saved selection range before calling `insertHTML`,
+  so links are inserted at the correct position.
+
+### Changed
+
+- **Right sidebar** — added an **expand/narrow** toggle button (◁▷) next to
+  the existing collapse button. The sidebar now has three states:
+  - **Collapsed**: 6px strip with re-open button
+  - **Normal**: 288px (w-72) — default
+  - **Expanded**: 576px (w-[576px]) — double width, useful for complex panels
+  Smooth CSS transition between states.
+
 ## [0.5.0] — 2026-09-03
 
 ### Added

package/dist/core/plugins.d.ts

@@ -51,6 +51,12 @@ export interface BuilderHandle {
     setAIProvider: (provider: AIProvider) => void;
     /** Configure the list of merge tags available in the text element sidebar. */
     registerMergeTags: (tags: MergeTag[]) => void;
+    /**
+     * Opt in to the recommendations engine. When called, the Recommendations
+     * panel appears in the right sidebar for any module that contains a
+     * `productGrid` element. Without this call the panel stays hidden.
+     */
+    registerRecommendationsPlugin: () => void;
 }
 export type PluginType = "modules" | "themes" | "asset-provider" | "product-provider" | "voucher-provider" | "ai-provider";
 export interface Plugin {