useblocks 1.1.72 → 1.1.84

package/CHANGELOG.md

@@ -0,0 +1,461 @@
+# 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.83] - 2026-09-22
+
+### Added
+
+- Email and block folders: several emails or blocks can be dragged into a folder or the trash at
+  once; a collapsed folder with subfolders is marked with a plus on its icon
+- AI email generation on the create page respects the plan: a lock on the card shows up front that
+  the feature is not in the plan or the limit is used up
+- Empty email list: dedicated messages for a search with no results and for an empty trash, a
+  "Create a new email" button in an empty folder; the "no emails" screen no longer flashes while the
+  list is loading
+- File Manager: `fileManager.availableImageExtensions` is declared in the public types. It sets the
+  supported formats hint under the upload area and does not restrict what can be uploaded
+
+### Fixed
+
+- Video and countdown settings: fields keep the cursor while typing, the preview is rebuilt after a
+  pause in typing
+- Expanding a folder no longer collapses its siblings, and row buttons in the folder tree line up
+  with their folders
+- The button settings panel shows the button's actual alignment instead of always "center"
+- Tooltips on the right panel tabs no longer go off screen; buttons on an image in the canvas now
+  have hover titles
+- File Manager: files with commas, percent signs, ampersands and other symbols in the name upload
+  fine — such symbols are replaced with underscores, Ukrainian letters are transliterated
+- Plugin types: `compressMaxSize` is documented in megabytes (default `0.48`), the way the editor
+  reads it, not in bytes — a `5 * 1024 * 1024` value written by the old description effectively
+  turned compression off. The docs now say that compression settings in `fileManager` override the
+  top-level ones only inside the file manager; defaults of `cacheStrategy` and `autosaveTimeout`
+  are corrected
+- Translations: "Discount with promo code" on the billing page, email list messages, "Stock" in
+  Spanish and Portuguese now means a stock photo library, not warehouse stock
+
+---
+
+## [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.
@@ -247,7 +285,9 @@ Editor UI tuning. Use **`instance.setConfig`**, **`instance.updateConfig`**, **`
 | optimizeSpamAssassinEnabled | Show SpamAssassin check. | true |
 | optimizeCheckCodeEnabled | Show code check. | true |
 | settingsEnabled | Show “Settings” button. | true |
+| settingsTabEnabled | Show the “Settings” tab in the settings panel. The UTM tags and Annotations tabs do not depend on it. | true |
 | UTMEnabled | Show UTM tags tab. | true |
+| annotationsEnabled | Show the Gmail annotations tab. Enabled only in `pro` mode. | false |
 | descriptionEnabled | Show “Description” field in settings. | true |
 | tagsEnabled | Show “Tags” field in settings. | true |
 | switchDesktopMobilePropsEnabled | Show mobile properties toggle. | true |
@@ -315,8 +355,8 @@ Editor UI tuning. Use **`instance.setConfig`**, **`instance.updateConfig`**, **`
 | imageCenterStockEnabled | Stock photos tab. | true |
 | imageCenterGifEnabled | Stock GIFs tab. | true |
 | imageCenterEditorEnabled | Image editor tab. | true |
-| compressMaxSize | Client-side compression max bytes in file manager (~5&nbsp;MiB default). | see types |
-| compressMaxWidthOrHeight | Resize max width/height, px (2000 default). | see types |
+| compressMaxSize | Target image weight after client-side compression, **megabytes** (not bytes). `0` disables compression. Default 0.48. | see types |
+| compressMaxWidthOrHeight | Resize max width/height, px. `0` disables compression. Default 2000. | see types |
 
 ### Event wiring
 
@@ -407,6 +447,8 @@ useblocks.init({
 
 The `fileManager` section controls feature flags; every field is optional — default **true** when omitted unless noted in typings.
 
+The section also accepts `compressMaxSize` and `compressMaxWidthOrHeight` — the same fields as at config root. Set here, they override the root ones **inside the file manager only**: an image dropped straight onto the canvas, uploaded through the image modal or pulled in by HTML import still uses the root value.
+
 #### Basic Operations
 
 - **enableTrash** — enables trash functionality for deleted files. When enabled, files are moved to trash instead of permanent deletion. Default: true
@@ -421,11 +463,18 @@ The `fileManager` section controls feature flags; every field is optional — de
 - **enableDelete** — allows deleting files and folders. When the recycle bin is enabled, files are moved there instead of being permanently deleted. Default is true  
 - **multiSelect** — allows multiple selection of files and folders for batch operations. Default is true  
 - **defaultFolderName** — default folder name  
+- **availableImageExtensions** — extensions shown in the "Supported files" hint under the empty-folder upload area, rendered with a leading dot (`['jpg', 'png']` → `.jpg, .png`). A caption only: it does not restrict what can be uploaded. Default: `['jpeg', 'svg', 'png']`
+- **dedupeUploadNamesOnClient** — the client picks a free name before uploading: a taken `photo.png` is sent as `photo_1.png`, then `photo_2.png`. Covers image-editor copies, upload by URL, copy and move as well; creating a folder with a taken name is rejected with an error. Costs one extra folder listing per upload, so enable it when your backend does not resolve name collisions itself. Default: false
+- **saveCopyToCurrentFolder** — "Save copy" in the image editor stores the file in the current folder. By default (false) the copy goes to the default folder regardless of where the editor was opened
+- **showNotifications** — file manager toast notifications. Default: true
 - **sortOptions** — whitelist of sort dropdown values (`'date-desc' \| 'date-asc' \| 'size-desc' \| 'size-asc' \| 'name-asc' \| 'name-desc' \| 'type-asc'`). If omitted or empty, all options supported by the file-manager package are shown. Use a non-empty array to hide sorts your platform does not implement (e.g. size or type).
 
 #### Pagination & Display
 
 - **enablePagination** — enables paginated navigation. If disabled, all items are loaded at once. Default: true
+- **unifiedCatalogFetch** — applies only together with `enablePagination: false`. Folder and file list requests are merged into a single whole-catalog request and the needed type is filtered client-side: one `getItems` call instead of two. Ignored when server-side pagination is on. Set `false` if your backend needs separate folder vs file requests. Default: true
+- **expandRootFolderOnInit** — expands the root node of the folder tree on open; nested folders stay collapsed. Default: true
+- **previewFallbackToFileUrl** — when a file has no `thumbnail` and no `thumbnailUrl`, `file.url` is used for the table and grid preview (images only). Default: true
 
 #### Client-Side Processing
 
@@ -444,10 +493,10 @@ The `fileManager` section controls feature flags; every field is optional — de
 #### Cache Strategy
 
 - **cacheStrategy** — caching strategy for performance optimization.
-  - **ttl** — cache time-to-live in milliseconds. Default: 300000 (5 minutes)
-  - **errorTtl** — cache TTL for errors in milliseconds. Default: 60000 (1 minute)
-  - **allowSortedInsert** — allows inserting elements into sorted arrays without full cache invalidation. Default: false
-  - **allowSearchInsert** — allows inserting elements into filtered arrays without full cache invalidation. Default: false
+  - **ttl** — cache time-to-live in milliseconds. Default: 1800000 (30 minutes)
+  - **errorTtl** — cache TTL for errors in milliseconds. Defaults to `ttl` when omitted
+  - **allowSortedInsert** — allows inserting elements into sorted arrays without full cache invalidation. Default: true
+  - **allowSearchInsert** — allows inserting elements into filtered arrays without full cache invalidation. Default: true
   - **invalidateOnPaginationFull** — marks cache as stale when inserting into a full paginated page. Default: true
   - **comparator** — comparison function for sorting two files. Default: name-based comparison
   - **filterMatch** — function to check if a file passes current filters. Default: name-based search

package/iframe/css/sandbox-dark.css

@@ -12,7 +12,7 @@
 }
 
 .of-atom .em-element-editor-widget {
-  background: #d0ebff;
+  background: var(--ub-colorPrimaryBg, #d0ebff);
 }
 
 [class^='em-element-editor-widget-'] {

package/iframe/css/sandbox-darktheme.css

@@ -42,7 +42,7 @@
 
 .of-atom .em-element-editor-widget {
   width: 82px;
-  background: #d0ebff;
+  background: var(--ub-colorPrimaryBg, #d0ebff);
   top: -1px;
   left: 0;
   border-radius: 6px 6px 0 0;
@@ -69,7 +69,7 @@
   width: 20px;
   height: 20px;
   font-size: 16px;
-  color: #344966;
+  color: var(--ub-colorAtomToolbarIcon, #344966);
 }
 
 [class^='em-element-editor-widget-']:hover {
@@ -79,7 +79,7 @@
 }
 
 .of-atom [class^='em-element-editor-widget-']:hover {
-  background: #b8d4e9;
+  background: var(--ub-colorPrimaryBgHover, #b8d4e9);
 }
 
 .em-element-editor-widget.sticky {

package/iframe/css/sandbox-light.css

@@ -16,7 +16,7 @@
 }
 
 .of-atom .em-element-editor-widget {
-  background: #d0ebff;
+  background: var(--ub-colorPrimaryBg, #d0ebff);
 }
 
 [class^='em-element-editor-widget-'] {

package/iframe/css/sandbox.css

@@ -575,7 +575,7 @@ tinymce *.em-code[em-edit='active'] {
   width: 20px;
   height: 20px;
   font-size: 16px;
-  color: #344966;
+  color: var(--ub-colorAtomToolbarIcon, #344966);
 }
 
 [class^='em-element-editor-widget-']:hover {
@@ -591,7 +591,7 @@ tinymce *.em-code[em-edit='active'] {
 }
 
 .of-atom [class^='em-element-editor-widget-']:hover {
-  background: #b8d4e9;
+  background: var(--ub-colorPrimaryBgHover, #b8d4e9);
 }
 
 .em-element-editor-widget.sticky {