Skip to content
demuddler

Runtime changelog

Release notes for the hosted importer. Follow interface changes, runtime versions and SDK compatibility.

This page lists each runtime version. The npm package has its own version. Versions and upgrades explains how to find and pin a runtime version.

This version has no change in the importer or the engine. A host page needs no change apart from the new runtime URL.

This version reads more real files correctly and adds a sheet choice. Read the breaking changes before you upgrade.

Breaking changes:

  • Eight message keys have new names, with the same text. If you set them in messages, use the new names: workbench.empty is cell.empty, workbench.unavailable is cell.unavailable, workbench.clean is problems.clean, workbench.line is history.row, workbench.noHistory is history.none, and workbench.valuesChanged, workbench.changedCount and workbench.mergedFrom start with history. instead.
  • The TypeScript type TargetSchemaDto is now ImporterSchema.
  • A time that states no zone now exports with no zone, also in a column where other times state one. A plain date in a column of times exports midnight with no zone.

New:

  • A workbook with two or more sheets asks which sheet to import.
  • The importer finds title rows above the header and skips them, and it reports hidden rows of an Excel sheet.
  • A field that you declare as bool also takes 1 and 0.
  • A phone fix writes numbers that have a country code in the international form, such as +44 20 7946 0958 as +442079460958. A lowercase fix writes email addresses in lower case.
  • Dates that fit both day orders follow the locale of the browser.
  • The host can show a Full screen button with showFullScreen. The fullscreen event tells the host when the person presses it.
  • The importer refuses a file that is markup or a binary file, and it guesses the encoding of more files.

Fixed:

  • Undo of a large fix after an edit of one of its cells restores the file.
  • The undo history counts the text of each value that it keeps, so long values also stay within its memory limit. One change larger than the limit stays, so one undo is always there.
  • A quoted value after spaces, such as a, "b", is read as text when it holds a line end, or a delimiter and then a quotation mark. So the rows of a large file do not depend on where a chunk of it ends.
  • A percent, such as 1%, is not a yes or no value for a bool field.
  • The unique rule treats 10:00Z and 10:00 as different values, as the export writes them.
  • Hidden rows of an Excel sheet all count, also when the sheet lists them out of order.
  • The Undo of a Leave out puts back only the rows that this Leave out took.

The npm package is now under the MIT licence.

This version has a new importer design. The interface and the engine contract stay compatible, so a host page needs no change apart from the new runtime URL.

  • The header holds the file name, which opens File settings, the three steps (Match columns, Fix values, Import), Shortcuts and the theme switch.
  • Match columns is a list with one row for each column of the file: two sample values, the field, the reason for the match and its state.
  • Fix values has a sidebar with Fixes, Problems, History and Repeated rows beside the grid. Under 1024 px wide, the sidebar opens as a bottom sheet.
  • A cell shows its state by its colour: a problem, a fix, a preview of a fix, an edit by hand, or a value that a fix leaves unchanged.
  • A new escape event tells the host that a person pressed Escape and nothing in the importer used it. React gets it as onEscape.
  • Column matching gives no suggestions for very large or very long column names, so it cannot slow the browser tab. A person can still match by hand.

This is the first release of the runtime.