Skip to content
Changelog

What shipped, and when

Every release is listed here with the packages it changed — all packages share one version number.

Nov
20 releases in 16 days
  • Fix@templatical/import-beefree

    Report warnings, error messages and the unsupported-module comment spell the vendor Beefree. convertBeeFreeTemplate, ConvertBeeFreeOptions and BeeFreeTemplate are unchanged.

Read the full notes for 0.62.2
  • Fix@templatical/editor

    Merge tag chips inserted into formatted text keep that text's formatting through the toolbar, autocomplete, typing and paste, so the exported tag renders in the surrounding font size, colour and weight. Logic tag chips print no text and stay outside formatting, so a condition never splits a formatted element. Templates saved earlier keep their unstyled tags.

Read the full notes for 0.62.1
  • Feature@templatical/core@templatical/editor@templatical/media-library

    All packages are now MIT-licensed. @templatical/editor, @templatical/core and @templatical/media-library move from FSL-1.1-MIT to MIT; earlier releases keep their FSL-1.1-MIT terms, which convert to MIT two years after each release.

  • Fix@templatical/core@templatical/editor@templatical/media-library@templatical/types

    Remove the unreleased Templatical Cloud integration. The SDK is configured through init() alone: every storage feature is a provider you pass to it (templates, comments, versionHistory, savedBlocks, media, testEmail, render, ai, collaboration). This drops initCloud(), getSupportedCloudLocales(), the @templatical/core/cloud subpath and the Cloud wire types in @templatical/types, and pusher-js is no longer a peer dependency.

Read the full notes for 0.62.0
  • Fix@templatical/renderer

    A string field stored as null or left out renders as an empty string instead of throwing. Templates saved by a backend that turns every "" into null failed with Cannot read properties of null (reading 'replace') on, for example, an image without alt text. This covers image and video alt, src, url and align, button text, url and colours, title, paragraph, HTML and table cell content, divider, menu, social and table fields, and the template's backgroundColor and fontFamily. An image whose src is null, and a paragraph or HTML block whose content is null, renders nothing, as with "". escapeHtml, escapeAttr, escapeCssValue and escapeFontFamily accept null and undefined and return "". Output for every other value is unchanged.

Read the full notes for 0.60.4
  • Fix@templatical/import-beefree

    A plain <code> around one merge tag without data-bee-type drops its plain leading space again, wherever it sits: SIM-Karten:<code> {{anzahl}}</code> imports as SIM-Karten:<code>{{anzahl}}</code>.

  • Fix@templatical/renderer

    Quoted merge-tag arguments survive in rendered output. In an attribute, ' stays raw and " is still &quot;. In element text, both quotes stay raw. {{ x|default('y') }} reaches Twig or Liquid intact in links, image sources, button labels, menu items, table cells and the preheader. A linkColor that contains ' or " renders as inherit, so links follow the text colour instead of the client default the dropped declaration left them with. Rendered HTML otherwise changes byte-wise, with no visual change.

Read the full notes for 0.60.3
  • Fix@templatical/import-beefree

    The BeeFree importer keeps two kinds of content it used to lose:

  • Fix@templatical/editor

    Fix a dropped image overwriting a URL changed while it uploaded. An image block, its URL field in the sidebar, a section or band background image, a custom block's image field and a custom social icon's image field each take a drop upload's result only if the field still holds the URL it had when the file was dropped. A URL typed, picked with Browse, inserted as a merge tag or set by a drop on the image's other drop zone while the upload runs now stays, and the uploading overlay clears as soon as the URL changes. A Browse pick still applies even if the URL changed while the picker was open.

Read the full notes for 0.60.2
  • Fix@templatical/types

    Breaking changes:

  • Fix@templatical/ai-kit@templatical/editor@templatical/quality@templatical/renderer@templatical/template-tools@templatical/types

    Fix the custom social icon regression (#1214): a social icon can be your own image, platform: "custom" with an imageUrl, in the same row as the built-in icons, so an imported custom icon no longer has to lose either its image or its place in the row.

  • Fix@templatical/import-beefree

    Fix the custom social icon regression from 0.60.0 (#1214): a BeeFree custom social icon keeps its own image and link inside the social row.

  • Fix@templatical/import-easy-email-pro@templatical/import-mjml@templatical/import-stripo

    Fix unrecognised social icons losing their image (#1214): the MJML, Stripo and Easy Email Pro importers keep such an icon's image as a custom icon.

Read the full notes for 0.60.1
  • Feature@templatical/import-easy-email-pro@templatical/import-stripo

    The Stripo and Easy Email Pro importers carry a button's font size as ButtonBlock.fontSize, so an imported button no longer renders at the factory 15px.

  • Feature@templatical/ai-kit@templatical/editor@templatical/import-beefree@templatical/import-mjml@templatical/renderer@templatical/template-tools@templatical/types

    A button can take a percentage of its column.

  • Feature@templatical/ai-kit@templatical/editor@templatical/import-beefree@templatical/import-mjml@templatical/renderer@templatical/template-tools@templatical/types

    A button label can set its line height, and a wrapped label keeps it on every line.

  • Feature@templatical/ai-kit@templatical/editor@templatical/import-beefree@templatical/import-mjml@templatical/quality@templatical/renderer@templatical/template-tools@templatical/types

    A section can set each column's share of the row. The section settings show one percentage field per column, and the canvas draws that split.

  • Feature@templatical/import-chamaileon@templatical/import-easy-email-pro@templatical/import-html@templatical/import-stripo@templatical/import-topol@templatical/import-unlayer

    The Unlayer, HTML, Stripo, Topol, Chamaileon and Easy Email Pro importers carry a button's line height as ButtonBlock.lineHeight.

  • Feature@templatical/import-chamaileon@templatical/import-easy-email-pro@templatical/import-html@templatical/import-stripo@templatical/import-topol@templatical/import-unlayer

    The Unlayer, HTML, Stripo, Topol, Chamaileon and Easy Email Pro importers keep a row's column ratio, and the Unlayer and Easy Email Pro importers keep a percentage button width.

  • Fix@templatical/import-beefree

    Re-importing a BeeFree template keeps module hide flags, drops a no-line-box paragraph only when it holds an element other than a span, preserves a blank paragraph's space, centres HTML modules, and keeps a non-breaking space between merge tags.

  • Fix@templatical/import-topol

    The Topol importer no longer stores a 0px button label when an mj-button's font-size can't be read.

  • Fix@templatical/import-beefree

    BeeFree text imports drop an empty formatting paragraph before styles are applied, HTML modules keep the browser's line height and word breaking, and a button metric or custom social icon that cannot be kept is reported approximated.

  • Fix@templatical/import-chamaileon@templatical/import-easy-email-pro@templatical/import-stripo@templatical/import-topol@templatical/import-unlayer

    The Unlayer, Topol, Chamaileon and Stripo importers measure a column's room against the section's inner box. Unlayer, Topol and Chamaileon used the whole email width; Stripo took the column's share of the body width and then removed the padding from the edge columns. The room is the width an image, divider or video is compared with before it becomes "full". It is now the column's share of the inner box, which is the width less the section's side padding: Unlayer row padding, Topol mj-section padding, Chamaileon fullwidth content padding, Stripo structure padding. In a 600px Topol section with 50px side padding, a lone column's room is 500px, so a 500px image is "full" and a 499px one stays px.

  • Fix@templatical/import-beefree

    The BeeFree importer removes a <code data-bee-type="speciallink"> link chip and keeps its inner HTML, including the link, as written.

  • Fix@templatical/import-mjml

    The MJML importer resolves column widths that scale onto a layout preset to that preset, with no columnWidths.

  • Fix@templatical/import-beefree

    BeeFree social rows keep a known icon shape when the colour variant is new, and they keep the 4px gap under the icons.

Read the full notes for 0.60.0
  • Fix@templatical/editor@templatical/types

    Previews that show what resolvePreview returned now render resolved tags as plain text. A tag resolved in place, whose data-merge-tag attribute holds the value instead of the token (what a host gets by rendering the whole string through its template engine), shows that value with no merge-tag highlight in preview mode and in the test-email dialog, and a logic tag the host evaluated shows no badge. Before, every resolved value rendered as a highlighted merge-tag chip. A tag whose attribute still holds a token keeps its label and highlight, and unresolved previews (no resolver, or the fallback after a failure) are unchanged, including the Sample/Label switch. Adds unwrapHtmlResolvedMergeTags to @templatical/types.

Read the full notes for 0.59.2
2 days
  • Fix@templatical/editor@templatical/types

    Add PreviewSurface ("preview" | "test-email") and the required PreviewResolveContext.surface, so a resolver knows whether the editor's preview mode or the test-email dialog is calling. Read surface, not the presence of recipient, to tell them apart: the dialog leaves recipient out while its recipient field is empty. A resolver the editor calls needs no change; code that builds a PreviewResolveContext itself, such as a test that calls its own resolver, adds surface: "preview" or surface: "test-email".

Read the full notes for 0.59.1
  • Feature@templatical/editor@templatical/types

    Add PreviewResolveTrigger ("open" | "refresh" | "recipient" | "locale"), the required PreviewResolveContext.trigger, and the refreshPreview() instance method. A Refresh preview button is available in preview mode and the test-email dialog when resolvePreview is configured. A resolver the editor calls needs no change; code that builds a PreviewResolveContext itself, such as a test that calls its own resolver, adds trigger: "open". A failed re-resolve now shows the unresolved template instead of stale resolved content, opening the test-email dialog makes one resolver call with its seeded recipient, and a test-email recipient change always waits 500 ms, including before the first answer lands.

  • Feature@templatical/editor

    Add header.actions for host-owned controls in the editor header, with darkModeToggle, previewToggle and viewportToggle opt-outs. The editor reports compact and resolved-theme state on the host element.

  • Fix@templatical/core@templatical/editor

    Fix undo history after replacing an editor document. Undo after loading another template could write the previous template's content into it on save, and undo after setContent() could restore part of the old document. Loading a template, creating one with new content, or calling the public setContent() now clears undo and redo; creating a template from the current content keeps history. In collaborative editing, reloading the same template no longer sends the loaded document as an edit or drops presence and locks, and creating a template from the current content keeps undo and redo available in the new template.

  • Fix@templatical/import-beefree

    Read the Menu, Table and Video modules in the shape BeeFree exports (IPluginModuleMenu, IPluginModuleTable and IPluginModuleVideo in BeeFree's bee.ts). The importer read keys BeeFree never writes, so a real menu or table imported with no content and a video lost its thumbnail and width.

Read the full notes for 0.59.0
  • Feature@templatical/renderer

    Breaking changes:

  • Fix@templatical/template-tools

    custom-block render and custom-block validate pass their own liquidjs to renderToMjml, which no longer imports it. CLI output is unchanged.

  • Fix@templatical/import-beefree

    Skip a BeeFree spacer whose height is an explicit 0px, reported as skipped, instead of importing it as a 24px spacer. A spacer with a missing, unreadable or negative height now imports at BeeFree's 60px default rather than 24px. In an Icons module, an explicit 0px itemsSpacing no longer falls back to the legacy itemSpacing key.

  • Fix@templatical/import-beefree

    Preserve social icon scheme prefixes (mailto:, tel:, sms:) and keep custom social icons as images with their original file and link during Beefree imports.

Read the full notes for 0.58.0
  • Fix@templatical/types

    A locale operation (updateBlockLocale, updateSettingsLocale) writes only to the block's or settings' own l10n layer for that language. A layer inherited through the object's prototype is no longer reused and changed in place; the edit gets a fresh own layer instead.

Read the full notes for 0.57.2
  • Fix@templatical/import-beefree@templatical/import-chamaileon@templatical/import-easy-email-pro@templatical/import-html@templatical/import-mjml@templatical/import-topol@templatical/types

    cloneBlock serializes a block tree once and remints IDs throughout the copy.

  • Fix@templatical/ai-kit

    The shipped eval set's domain-mismatch case checks link text with >[^<>]*(?:www\.|://) instead of >(?:[^<]*)(?:www\.|://). It matches the same text, and checking a turn whose output holds a long run of > no longer takes quadratic time.

  • Fix@templatical/import-beefree

    BeeFree multi-column rows now convert outer column edges and matching top or bottom sides into section borders; painted column backgrounds, inner borders, and overlapping row borders still warn.

  • Fix@templatical/editor@templatical/renderer@templatical/template-tools@templatical/types

    Custom-block Liquid renders now have budgets: createCustomBlockLiquid sets memoryLimit to CUSTOM_BLOCK_LIQUID_MEMORY_LIMIT (1e7) and renderLimit to CUSTOM_BLOCK_LIQUID_RENDER_LIMIT (2000 ms), both exported from @templatical/types, so a template such as a loop over (1..1000000000) fails with a Liquid limit error in the editor, renderToMjml and custom-block validate instead of exhausting memory. Data-source preview recipes render with the same limits.

  • Fix@templatical/import-beefree

    Preserve explicit zero and shorthand padding on BeeFree buttons, with longhands taking precedence. Let an entirely bold label override any button style weight; import missing or unreadable weights as regular otherwise, and note lost partial bold formatting.

Read the full notes for 0.57.1
  • Feature@templatical/core@templatical/types

    Breaking changes:

  • Feature@templatical/editor@templatical/media-library

    Add Danish editor and media library translations and localized recipient-facing content defaults.

  • Feature@templatical/ai-kit@templatical/core@templatical/template-tools@templatical/types

    Breaking changes:

  • Feature@templatical/ai-kit

    Breaking changes:

  • Fix@templatical/renderer@templatical/types

    resolveLocale copies each block once, so resolving a deeply nested template takes time in proportion to its size. Masking merge tags with a custom syntax runs each regex once per match instead of again on every tag.

  • Fix@templatical/import-easy-email-pro@templatical/quality

    link.localhost-or-staging matches links.nonProductionHosts globs in linear time, so a very long URL host no longer stalls the linter, and compatibility rules group CSS declarations and clients without copying arrays. The Easy Email Pro importer decodes HTML entities by looking at most six characters ahead of each &.

  • Fix@templatical/import-beefree@templatical/import-chamaileon@templatical/import-topol@templatical/import-unlayer@templatical/renderer@templatical/template-tools

    The Unlayer, BeeFree and Topol importers check for a repeated warning in constant time, so a design with thousands of languages no longer slows the import quadratically. The Chamaileon importer looks up variable references in a table built once per document. The renderer escapes control characters in a block's type and id before it logs the missing-renderer warning. templatical live answers 400 to a request target it can't parse, where it used to exit.

  • Fix@templatical/core

    Localized operations preserve other language layers when an existing block moves into a newly added wrapper. Mixed section and wrapper parent objects resolve to the section column, matching the operation engine.

  • Fix@templatical/editor@templatical/import-beefree@templatical/renderer@templatical/types

    The canvas draws a button at the same height as the export (#1144). The renderer now writes line-height="120%" explicitly; compiled HTML is unchanged.

  • Fix@templatical/ai-kit

    translateFields sends the model short field aliases

  • Fix@templatical/editor

    Fix the header switching to its compact layout while the save status shows. "Unsaved" and "Saved" appear on every edit and save; in an editor just wide enough for the full header, their words compacted the whole header until the status cleared, about 5 seconds with templates.autoSave. The badge keeps a fixed slot (its icon) in the header's fit measurement and shows its words only where the full header has room for them. Without room it shows the icon alone, a different one per state (dot, check, alert), and keeps the words as its tooltip and for screen readers. In the compact header the badge is always the icon alone.

  • Fix@templatical/ai-kit

    An editing session checks locale layers in time proportional to the template size. Each locale is resolved only for the blocks that carry its layer, so a template with thousands of locales no longer makes every batch resolve the whole template once per locale.

  • Fix@templatical/core@templatical/editor

    Preview surfaces are read-only: the canvas in preview mode and the test-email and saved-block previews no longer start inline edits or write table cells, so resolved preview content can't overwrite the template.

Read the full notes for 0.57.0
2 days
  • Fix@templatical/import-topol

    convertTopolTemplate() accepts designs whose sections sit under mj-body and converts them like mj-container designs, including the container's background-color. When a design has neither, the empty-design warning names both tags.

Read the full notes for 0.56.1
  • Feature@templatical/ai-kit@templatical/editor@templatical/import-beefree@templatical/import-chamaileon@templatical/import-easy-email-pro@templatical/import-html@templatical/import-mjml@templatical/import-stripo@templatical/import-topol@templatical/import-unlayer@templatical/quality@templatical/renderer@templatical/template-tools@templatical/types

    Breaking changes:

  • Feature@templatical/ai-kit@templatical/editor@templatical/template-tools@templatical/types

    displayConditions.onRequest lets a host open its own condition builder. The callback receives a copy of the block and, when one is set, the current condition including opaque data. null cancels. conditions is optional. With onRequest set, conditions and allowCustom are ignored. DisplayCondition.data round-trips through the template.

  • Feature@templatical/editor@templatical/types

    Spread syntax presets with matching value and logic patterns use the built-in linear merge-tag scanner across localization and editor parsing. Different pattern sources or flags other than g and y keep custom regex matching. @templatical/types exports builtInPresetOf(syntax), which returns the built-in preset name whose patterns a syntax uses.

  • Feature@templatical/ai-kit@templatical/editor@templatical/renderer@templatical/template-tools@templatical/types

    A section wrapper or a layout wrapper can span the recipient's window. Set fullWidth: true on section.wrapper or on a layout wrapper block and the renderer emits MJML's full-width="full-width" on that mj-wrapper: the band's background color and background image run edge to edge, and the section or the wrapper's children stay at settings.width. Omit fullWidth, or set it false, and the band stays the email width, exactly as before. A corner radius is not rendered while full width is on; the stored radius remains and comes back when full width is off.

  • Feature@templatical/import-beefree@templatical/import-chamaileon@templatical/import-easy-email-pro@templatical/import-html@templatical/import-mjml@templatical/import-stripo@templatical/import-topol@templatical/import-unlayer

    Breaking changes:

Read the full notes for 0.56.0
  • Feature@templatical/import-beefree

    A real-design audit of the BeeFree importer found it converts every design but loses fidelity and, in one case, breaks Twig at send time. This release closes the gaps it found.

  • Feature@templatical/ai-kit@templatical/editor@templatical/renderer@templatical/template-tools@templatical/types

    Two optional block fields. Leaving either out renders exactly as before.

  • Feature@templatical/ai-kit@templatical/editor@templatical/import-html@templatical/import-mjml@templatical/import-stripo@templatical/quality@templatical/types

    Built-in merge-tag scanning, merge-tag span handling, and CSS rule parsing complete in linear time on malformed template input. Pixel value parsers reject long invalid whitespace suffixes without super-linear backtracking.

  • Feature@templatical/ai-kit@templatical/editor@templatical/import-beefree@templatical/import-chamaileon@templatical/import-mjml@templatical/import-stripo@templatical/import-topol@templatical/import-unlayer@templatical/renderer@templatical/template-tools@templatical/types

    SocialPlatform includes xing. Social icon blocks can use a XING icon, drawn from the same glyph as the other platforms, in the editor and in every rendered style and tone.

  • Fix@templatical/quality

    Lint auto-fixes now rewrite single-quoted attributes without adding attributes. Double-quoted values are copied as written, including entities, and a rewritten anchor tag is lowercase. Link and alignment fixes skip markup inside comments, link fixes use the same attribute decoding and HTML whitespace rules as detection, and alignment fixes split declarations on decoded CSS characters, so &#59; separates declarations, and keep the character references in the declarations they keep.

  • Fix@templatical/import-beefree

    A 7/12 or 5/12 BeeFree column row imports as an even two-column section. When a snapped column is narrower than its grid share, the shortfall comes back from the padding that faces the next column, so a one-line footer stays one line.

  • Fix@templatical/import-beefree@templatical/import-stripo

    Two importer corrections.

Read the full notes for 0.55.0
  • Fix@templatical/renderer

    Template values in MJML attributes are escaped before rendering. Body background colours containing markup use a transparent fallback so the compiled HTML does not carry that markup. CSS-valued attributes (background colours, border radius, background size, position and repeat) also drop ;, {, } and line breaks, so a value stays one CSS declaration.

  • Fix@templatical/editor@templatical/renderer@templatical/types

    Title blocks now unwrap paragraphs with quoted attributes correctly in the editor and rendered email. The editor sanitizes title HTML after unwrapping to close a script-injection path in the canvas. findOpenTagEnd now treats a quote inside an unquoted attribute value as an ordinary character, as HTML does.

  • Fix@templatical/editor

    In preview mode the canvas hides lint issue badges, like the rest of the block chrome.

Read the full notes for 0.54.2

Showing the 20 most recent releases.

Every release

Looking for an older version?

The docs changelog carries the full history back to the first release, with the complete notes for every entry.