@one-million-lines/email-builder 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -4,6 +4,65 @@ 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.2] — 2026-09-03
+
+### Changed
+
+- **Link popover — complete UX overhaul**
+  - **Shows linked text preview** — a "Text:" row displays the selected text so
+    users know exactly what will become clickable.
+  - **URL ↔ special link are now two-way synced** — selecting a special link type
+    (Unsubscribe, View in browser, etc.) auto-fills the URL field with the
+    corresponding placeholder (`{{unsubscribe_url}}`). Typing a placeholder URL
+    in the field auto-selects the matching link type. Selecting "— Custom URL —"
+    clears the placeholder.
+  - **Placeholder appears in the URL field** — the href that will be written into
+    the `<a>` tag is always visible and editable in the URL input, so users
+    understand that the placeholder IS the href value.
+  - **"Insert link" / "Update link" primary CTA** — replaced the small "Apply"
+    button with a full-width blue primary button. The label changes to
+    "Update link" when re-opening an existing link.
+  - **Detects existing links on re-open** — when the cursor is inside or a
+    selection spans an existing `<a>` tag, the popover pre-fills the href and
+    auto-selects the special link type (if the href matches a known placeholder).
+  - **Enter key** confirms the link; **Escape** closes without applying.
+  - Link type select now shows the placeholder inline in each option for
+    clarity: `Unsubscribe — {{unsubscribe_url}}`.
+
+## [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

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 {