useblocks 1.1.71 → 1.1.81

package/CHANGELOG.md

@@ -0,0 +1,426 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+---
+
+## [1.1.81] - 2026-09-17
+
+### Added
+
+- Project styles in the plugin: `projectStyles` section in `init(options)` with the brand palette,
+  custom fonts and social links. Colors show up in the color pickers, fonts in the font picker and on
+  the canvas, and the "Social" element is filled with the project's links instead of a placeholder
+- Email export to Markdown: a sub-item of the text export menu, `exportMarkdownEnabled` option
+- Gmail annotations for the Promotions tab: a separate sidebar tab with a card preview,
+  `annotationsEnabled` option (off by default)
+- "Swap columns" button for float block columns
+- Plan limits apply to every editor feature: unavailable ones are either locked with an upgrade
+  offer or hidden; locks are lifted right after payment, without a reload
+
+### Fixed
+
+- Showing and saving an email in the plugin: switching to another email or showing a template no
+  longer recreates the editor; subject and preheader edited in the UI are no longer rolled back;
+  unsaved autosaved edits are no longer overwritten by the server version; a new email without
+  markup opens with a starter layout, and the canvas is no longer reset after the first save;
+  `save()` with no email shown fails right away
+- Plugin: if `handleLoadImage` throws, the editor shows the error message instead of uploading the
+  image to the UseBlocks backend; project styles are no longer requested from the UseBlocks backend
+- Styles of a saved block no longer stretch the editor UI; block previews get the right height once
+  images load
+- Editor: a variable in an image address is kept on save; content text color can be changed after
+  white; the button wrapper cell no longer shows up in breadcrumbs; a disabled border no longer comes
+  back with old values; removing the last block no longer leaves an empty table
+- BeeFree layout converter: spacing of text, buttons, social icons and dividers is taken from the
+  source, loose text is no longer lost, Google fonts are attached
+- File Manager: readable names for stock images and GIFs instead of `photo-<id>` and
+  `giphy-downsized`; GIF previews show up immediately; a version in the link query is no longer taken
+  for the file extension; no more i18next promo message in the console
+- Error notifications show the server response, such as "Limit exceeded", instead of `rejected`
+- Translations: project member dialogs, the block counter in bulk save, layout converter strings
+
+### Changed
+
+- npm package contents are now an allowlist: the plugin test page, test fonts, analytics scripts and
+  the PWA manifest are no longer shipped; `CHANGELOG.md` is now included
+
+---
+
+## [1.1.71] - 2026-09-03
+
+### Added
+
+- Project settings page: a single page with tabs — description and logo, storage, brand styles,
+  members and roles, integrations, plugin. The editor picks up the project's brand fonts and colors,
+  and unsaved edits are no longer lost when leaving the page
+- The project card in the list shows the description and logo; the members table gained role,
+  invitation date, join date and last login
+- Algorithmic Stripo layout converter: `stripoConverterEnabled` option. Runs locally and instantly,
+  without the AI service. Fixed-width emails convert to the non-responsive form, adaptive ones keep
+  their mobile rules
+- Support chat is available to everyone: it is embedded directly, without Google Tag Manager, and
+  recognizes the signed-in user
+- Email preview mode that hides the service markers of hidden blocks
+- API error texts translated into Russian, Ukrainian, Spanish and Portuguese; the response language
+  is picked from the user profile and the `Accept-Language` header
+
+### Fixed
+
+- Showing and saving an email in the plugin: a repeated `show()` of the same email no longer
+  recreates the canvas, switching to another email no longer waits for a timeout, the first save no
+  longer reloads the editor, and the second one goes with the assigned id instead of creating a
+  copy; no requests are sent after `destroy`
+- Subject and preheader taken from the markup are no longer lost on save, and the save response no
+  longer rolls back fresh email metadata
+- A new email created from a template keeps the link to its parent; history is requested for the
+  email actually shown
+- Export: an email could be lost because of markup after `</html>`; an HTML build failure is no
+  longer reported as an empty result
+- Layout converter: blocks are no longer lost in a hand-edited BeeFree email; a button without its
+  own width is no longer forced to 200px
+- Social blocks are told apart in the settings pane by their position in the document
+- Links in an email are no longer wrapped in a `span` with an underline
+- File Manager: the file name is no longer lost in a CDN link with a query; settings now reach the
+  standalone image editor
+- Translations: the "Project" menu, the unsaved changes dialog, integration descriptions and
+  statuses
+- A catalog for a different locale is no longer applied, and an empty response no longer wipes the
+  translation cache
+- Navigation in the SaaS version
+
+---
+
+## [1.1.60] - 2026-08-14
+
+### Added
+
+- PNG export of an email as an archive containing desktop and mobile renders
+- Trial period: an in-editor dialog offering the paid plan trial and a unified activation dialog on
+  the pricing page
+- Project-owner plan gating: autosave and paid dialogs respect the project owner's plan instead of
+  the current user's; the owner's plan is part of the project domain model
+- File Manager: lockable library tabs with a badge
+
+### Fixed
+
+- Plugin resilience to backend outages: deferred standalone mode, failover no longer aborts on
+  authorization errors and switches back to the primary origin after recovery
+- Editor performance: fewer redundant re-renders of the email pane and settings forms, smooth
+  drag-and-drop
+- Public email preview no longer redirects to the login page
+- A headless container without an explicit size broke the email layout and shrank images
+- File Manager: preview shows the file while its thumbnail is not ready yet; image compression is
+  disabled when compression limits are zero; removed folder duplication in the tree
+
+---
+
+## [1.1.47] - 2026-08-07
+
+### Added
+
+- Host-supplied AI in place of the built-in one: `handleAITextRequest` (chat assistant and email
+  generator) and `handleAIImageRequest` (image generation) callbacks in `init(options)`. The host
+  receives progress via `onProgress`, partial HTML via `onStreamChunk` and an `AbortSignal` for
+  cancellation; such generations are not gated by UseBlocks limits and are not counted against the
+  subscription quota.
+- Public `templateDirectives` contract: an escaping policy for ESP template directives, applied
+  consistently in the editor, the block editor and on export (HTML, EML, ZIP)
+- App tokens for integrators: `POST /auth/app/token`; the layout converter now works with app
+  tokens with per-client limits
+- Headless embedding mode for the editor
+- Password change in the user profile
+- File Manager: parallel compression of uploaded files
+
+### Fixed
+
+- Browser auto-translation is disabled — it was breaking the editor
+- Monaco: ESM workers with a cross-origin publicPath
+- Cyrillic file names are decoded on upload by URL
+- Stable embedding in Angular and Module Federation hosts
+
+### Changed
+
+- Migration to React 19 (Redux Toolkit 2, custom IframeResizer)
+- Google, Yandex and eLama sign-in, registration and CAPTCHA moved to the new Go backend
+  (`/api/v2/auth/*`)
+- The projects page is moving to the Go backend `/api/v2` (behind a flag): members and invitations,
+  single-save settings, tags and folders, ESP integrations, storage settings
+- File Manager: a Go-backend provider (behind a flag) — background indexing of the legacy file tree
+  with a progress indicator, automatic thumbnail loading, trash with restore into a chosen folder
+
+---
+
+## [1.1.29] - 2026-07-14
+
+### Added
+
+- Layout converter for foreign markup to UseBlocks format: separate flags `beeFreeConverterEnabled` (deterministic BeeFree/Stripo conversion) and `aiLayoutConverterEnabled` (AI conversion of other markup)
+- CAPTCHA on login and sign-up forms (Cloudflare Turnstile, Yandex SmartCaptcha)
+- UTM tags and dynamic URL substitutions on export
+- VML button improvements for Outlook compatibility
+
+### Fixed
+
+- Content sync between iframe and Monaco (echo loop, autosave)
+- Stable editor embed in external React/Microfrontend hosts (StrictMode, publicPath)
+- Readable error toasts; autosave no longer blocks user edits
+- White screen when the locale API is unavailable
+
+### Changed
+
+- UI Kit and app UI migrated to Ant Design 6
+- File Manager updated to 1.1.0
+
+---
+
+## [1.1.25] - 2026-07-07
+
+### Added
+
+- Float block copy
+- Global blocks: available to all users, synchronization reworked
+- Code mode in the editor sidebar
+- Empty states in the emails and projects tables
+- Save and autosave loading indicators
+
+### Fixed
+
+- Email subject and preheader
+- Autosave recovery after failure
+- Accidental removal of all styles in a block
+- HTML sanitization against AdGuard and other browser extensions
+- Vite host plugin: public path in dev mode
+
+---
+
+## [1.1.4] - 2026-06-15
+
+### Added
+
+- Analytics for actions in the email editor iframe
+- Improved drag-and-drop atom insertion into the email
+
+### Fixed
+
+- Image and video preview in element settings (`SelectedImageForm`)
+- Meta and layout synchronization in the social block form (`SelectedSocialForm`)
+- Detection and sanitization of styles broken by browser extensions (adblock)
+- Settings panel tab navigation (`PanelFormTabsOverrides`)
+
+### Changed
+
+- Sentry: switched to a reinstalled self-hosted instance
+
+---
+
+## [1.1.0] - 2026-06-08
+
+### Added
+
+- Plugin system: extensions API, sandbox API, plugin development CLI, internal plugins; email settings API for plugins (DEV-11837)
+- Global blocks: creation, preview markers, sync changes across all templates
+- Projects page (DEV-11990): card view, search and filters, Viewer role, member management from menu and list, frequent projects in the sidebar
+- Light/dark theme switching in the email editor
+- Autosave with retry mechanism; correct `projectId` handling for new emails (DEV-14828)
+- Roll back an email to a previous version (DEV-15046)
+- UI Kit component localization
+- Element settings change analytics in the panel (Amplitude `change_element_setting`)
+- Link normalization in href fields
+- EML export: embed images as base64
+
+### Fixed
+
+- Rich text editor: formatting and text editing (DEV-14640, DEV-14852)
+- Email variable editing (DEV-14582)
+- Dark theme in the project menu and inbox card (DEV-14842)
+- Stickers in the Pixie image editor (DEV-14969)
+- Monaco: workers across different origins; ESM editor build
+- Mobile text and button alignment
+- Image preview URLs moved to env variables (DEV-15052)
+
+### Changed
+
+- Build migrated to Vite/ESM; pnpm monorepo
+- Prod releases and npm package version driven by git tags (`useblocks-v*`)
+- Email HTML sanitization against browser extension interference
+
+---
+
+## [1.0.117] - 2026-04-07
+
+### Added
+
+- Bulleted lists in the rich text editor (DEV-12615)
+- Anchor links
+- Billing page and UX: limits (`limitsApi`), usage stats, paywall and limit upgrade modals (`LimitUpgradeModal`, including `image_generate` overage), left-menu tariff widget (`MenuTariffWidget`): trial, subscription, auto-renew (DEV-11223 and related work)
+- Billing modals: plan checkout choice (`PlanCheckoutChoiceModal`), legal-entity invoice request with prefilled fields and hidden-field sync (`TariffInvoiceRequestModal`)
+- Social blocks overhaul: drag-and-drop, settings tooltips, custom icons; VK platform (`vkv`); contrast and atom/cell backgrounds; delete control in the social form; CDN URL updates and icon URL generation (DEV-13666 and related fixes)
+- Text formatting options in `SelectedTextCommonForm`
+- `commonStyles` in iframe and deep merging of content styles; panel padding refinements
+- Strip `width` and `max-width` from images in non-responsive emails (`stripImageWidthForNonResponsive`)
+- Explicit content-column width checks in multi-column layouts and correct block width recalculation
+
+### Fixed
+
+- Email subject: whitespace handling and `title` tag parsing (`getSubject`)
+- Email layout width for columns with the `em-insert-ignore` class
+- Integrations: Dotdigital, Klaviyo, ActiveCampaign; updated Brevo API key help URL
+- File manager: duplicate folder notification (409), scrollable folder list in the Move submenu, DataSource and copy flow updates; null crash in FloatingBlocks; file upload handling
+- Thumbnail normalization for the Pixie image editor and display formats via `normalizeImageFormatForDisplay` in image loaders
+- Text background in the email (DEV-14472)
+- Navigate to the button parent element (DEV-14443)
+- Image center fails to open (DEV-14425)
+- Social blocks: root-table selectors, form and `ColorPickerInput` styling, spacing in `EmailPane` and the social form
+- Theme switching; halt errors with Sentry and Unisender; path computation in the Vite plugin
+- Disabled TypeScript checking for HTML in the Monaco editor
+- Buttons: unified `height` and `line-height` tied to theme variables in `Button.scss`
+
+### Changed
+
+- Sentry, file manager, and other dependency version bumps
+- Updated base URLs for social network icon CDNs
+- Billing: streamlined/refactored `BillingPage`, banners and auto-pay buttons; webhook build switched to `buildLegacyWebhookRequest`; removed Streamline and Giphy proxies; custom proxy support (DEV-14043)
+- Shared styles: font specificity (`PanelForm`, `common.scss`), payment button styling in `BillingBannerModal`
+- `Ribbon` component and notifications; billing and UI localization updates
+- CI: removed redundant Allure report job; `GIT_CLONE_PATH` for test VM jobs
+
+---
+
+## [1.0.109] - 2026-04-07
+
+### Added
+
+- Bulleted lists in the rich text editor (DEV-12615)
+- AI settings: skip dialog queries when the assistant is disabled; richer context for the AI prompt
+- Subscription fields in logging methods (DEV-13876)
+- Error boundary errors reported to analytics
+
+### Fixed
+
+- Email subject: whitespace handling and `title` tag parsing (getSubject)
+- File manager: duplicate folder notification (409), scrollable folder list in the Move submenu, DataSource and copy flow updates
+- Link forms: default protocol and empty URL handling
+- Sandbox: drag-and-drop and click layering (pointer-events)
+- `applicationElementSettingsSet` registration and element path filtering
+- Thumbnail normalization for the Pixie image editor
+
+### Changed
+
+- Sentry and dependency version bumps
+
+---
+
+## [1.0.108] - 2026-03-26
+
+### Added
+
+- ESP integrations: Mailchimp, Klaviyo, HubSpot, Salesforce Marketing Cloud, ActiveCampaign, Brevo, Campaign Monitor, Constant Contact, GetResponse, Bento, Dotdigital
+- Integrations tab in the project edit modal
+- Data layer events for email export
+- `imageCenterLocalUploadEnabled` for local uploads in the image center
+
+### Fixed
+
+- File manager: Redux removed from FM integration (DEV-14018, DEV-13858), proxy and front-end pagination, stray Edited folder on upload
+- Editor and sandbox: contenteditable iframe, empty list insertion (DEV-13612), text editing (DEV-13608), delete-from-end in blocks (DEV-13558), mobile text properties (DEV-13679)
+- Email button issues (DEV-13746); alignment icons use `currentColor` (DEV-13790)
+- Duplicate notifications when sending a test email (DEV-10977)
+- Sorting in the projects table (DEV-13759)
+- Autosave: `revisionService` guard and `emailId` in revisionToApply
+
+### Changed
+
+- Blocks / Emails / Projects / Members tables: layout, menus, drag-and-drop on block and email pages
+- Webhook handling in the email buttons component
+- Dotdigital and ActiveCampaign integration improvements (drafts)
+
+---
+
+## [1.0.104-alpha.1] - 2026-03-02
+
+### Added
+
+**Integrations:**
+
+- Unisender integration and settings management
+- App-specific integration availability system
+
+**Editor:**
+
+- Free plan restrictions in ButtonsEmail component
+- mailto link support (subject, body) — DEV-13102
+- Mass blocks functionality
+- Element sorting
+- Insert link with correct color — DEV-13172
+
+**AI & UX:**
+
+- AI functionality in EmailPageHeader with payment verification
+- Improved modal animations
+
+**FileManager:**
+
+- Support for custom names when copying files and folders
+- Cache clearing
+
+### Fixed
+
+**Table Editor:**
+
+- Dropdown menu layout for Table element — DEV-13370
+- Table editor functionality — DEV-13371
+
+**Paste & Links:**
+
+- Tag duplication when pasting text — DEV-13293
+- Link duplication when pasting — DEV-13378
+
+**Elements:**
+
+- Adding Button element to email — DEV-13312
+- Incorrect marker settings display — DEV-13313
+- Line break restriction for notifications — DEV-13143
+
+**Data & API:**
+
+- Tag and group changes when sending email data — DEV-10189
+- Recurring payment calculation with `is_only_first_period` — DEV-13377
+- Notification on test email send error
+- Localization in yandexLoginProxyPage
+- JWT token expiration check and 401 response handling
+
+### Changed
+
+**sandbox.js → TypeScript Refactoring:**
+
+- Migration to modular structure with types and centralized state
+- Modules for mouse, keyboard, and drag-and-drop event handling
+- Element settings handlers (links, variables, padding)
+- Modules for accordions, buttons, carousels, tables
+- Utilities for text formatting, styles, and VML
+
+**Integrations:**
+
+- IntegrationSettings renamed to IntegrationSettingsData
+- Unisender integration migrated to flexible structure
+
+**UI:**
+
+- Updated layout for BlocksTable and EmailsTable
+- Improved checkbox styles in tables
+
+### Testing
+
+- Integration tests for html2Dom, dom2Html, and export pipeline
+- Functional tests for css namespace in dom2Html
+- Functional tests for html2Dom
+- Tests for createWrapper function
+
+---
+
+## [1.0.103] - 2026-02-05
+
+_Changelog not documented_

package/README.md

@@ -121,6 +121,44 @@ You can take **`EMAIL_CODE`** from <a href="https://cdn.useblocks.io/plugin/new-
 
 For debugging, the dev build may support a front-end token flow — configure an auth proxy in your app if you use that path.
 
+### React wrapper
+
+The package ships a ready-made component. It creates its own container, calls **`init`** on mount
+and **`destroy`** on unmount.
+
+```tsx
+import Useblocks from 'useblocks/react';
+
+const content = { subject: 'Email subject', html: 'EMAIL_CODE' };
+const editorConfig = { theme: 'light' };
+const editorStyle = { height: '100vh' };
+
+export function Editor({ getAuthToken }) {
+  return (
+    <Useblocks
+      getAuthToken={getAuthToken}
+      content={content}
+      config={editorConfig}
+      style={editorStyle}
+    />
+  );
+}
+```
+
+The component takes the same options as **`init`**, plus `id`, `className`, `style` and `container`
+(any other container attributes). Do not pass **`element`** — the component supplies its own `div`.
+Keep `react` 16.8 or newer in your own dependencies; it is not bundled.
+
+Two limitations worth knowing up front:
+
+- Every props update triggers an editor **`reset`**. Keep objects and callbacks stable
+  (`useMemo` / `useCallback`), otherwise the editor is recreated on every parent render.
+- Initialization errors are neither rethrown nor displayed. A failing **`init`** leaves an empty
+  container — call **`init`** directly to diagnose it.
+
+When you need full control over the lifecycle, mount the editor by hand with **`init`** and
+**`destroy`** instead.
+
 # Configuration
 
 Configuration is a nested object: editor chrome, initial email payload, and callback hooks.