Skip to content

v0.13.4

Latest

Choose a tag to compare

@github-actions github-actions released this 14 Nov 10:48
· 16 commits to master since this release
8232f9a

This release adds AutoFilter criteria and sorting, threaded comments, pictures in cells, checkboxes, text boxes and shapes, sparklines, ignored errors, workbook protection, document properties, sheet views, headers and footers, autofit, getText and streamed writing, and fixes SubString arguments (#498). It requires XML.jl v0.4.9. Two changes may affect existing code: see the Migration Guide.

Full details under the fold
  • Fix: functions that take a sheet name, a cell reference or a text keyword accept any AbstractString, not just a String, so a name made with strip, split or first(name, 31) works #498 (Thanks to @mcvmcv for the report). A SubString used to throw a MethodError (or a TypeError for a keyword). Affected:

    • Sheet names: addsheet!, renamesheet!, copysheet!, newxlsx, xf[name], readdata, readtable, readto, readtransposedtable, writetable(...; sheetname), the sheetname of addChart and addChartEx, and the streaming addsheet!
    • (xf, "Sheet!A1") forms: setFont, setFill, setBorder, setAlignment, setFormat, the setUniform* setters, setColumnWidth, setRowHeight, mergeCells, setConditionalFormat, addDataValidation and setFormula
    • Getters, in both forms: getFont, getFill, getBorder, getAlignment, getFormat, getText, getColumnWidth, getRowHeight, isMergedCell, getMergedBaseCell, getFormula and getRichTextString
    • Text keywords: setFont's name, under and vertAlign, setFill's pattern, setAlignment's horizontal and vertical, setFormat's format, a conditional format's number format, setColoredDataBars's keywords, and writetable's anchor_cell
    • Other: a text or formula value for addDefinedName, a dynamic-array formula (=SORT(...)) for setFormula, column_labels with normalizenames=true, first_column given as a letter, and RichTextRun

    A RichTextString or a StyledStrings styled"…" string is used as its plain text. Before, renamesheet! with a SubString failed after it had renamed the sheet in workbook.xml, leaving the Worksheet with its old name; and addsheet! and copysheet! failed after adding the new sheet's part and relationship

  • Requires XML.jl v0.4.9. XLSX.jl calls @for_each_child! in place of @for_each_child, which XML.jl v0.4.9 deprecates and v0.5 removes, so it no longer warns under Pkg.test and precompiles and reads sheets under --depwarn=error #496 (Thanks to @mathieu17g for the report)

  • Reading a worksheet reads each <row> and <c>'s attributes once, where XML.jl's cursor stands (XML.eachattribute!, new in v0.4.9), rather than reading the tag again for each attribute: readtable is 8–13% faster and opening a file for editing 3–6% faster on the benchmark fixtures

  • Parts are saved without the line breaks and indentation XML.jl added between elements (XML.write(…; pretty=false), new in v0.4.9). A part XLSX.jl reads and doesn't change, such as a chart, theme or styles part, is saved as Excel wrote it, bar the line end after its XML declaration, where it used to grow by up to 5%

  • Benchmarks: bench/external_read.jl times Python's readers, python-calamine, fastexcel and openpyxl, reading the same tables as readtable, in an optional environment of its own (bench/envs/python, whose CondaPkg installs a private Python), and report.jl shows them beside XLSX.jl's times. It isn't a test dependency. Measured on 2026-11-13, XLSX.jl reads a table 3 to 6 times as fast as openpyxl, and takes 1.5 to 2 times as long as python-calamine and 2.6 to 4 times as long as fastexcel

  • Docs: the warning on openxlsx about saving over the original in mode="rw" listed charts among the parts XLSX.jl can't process. It now says what the round-trip tests show: parts XLSX.jl doesn't model (pivot tables, slicers, timelines, external links, custom XML, VBA projects) are kept but not updated, the calculation chain is dropped for Excel to rebuild, and a Strict file is saved as Transitional. The tutorial and the Supported features page say the same

  • Fix: saving a workbook replaced its calculation settings (<calcPr>) with fullCalcOnLoad="1" calcMode="auto", losing manual calculation, iterative calculation (for circular references) and its iteration count, the R1C1 reference style, "precision as displayed" and Excel's calcId. They are kept now, with fullCalcOnLoad="1" added so that Excel recalculates every formula on opening. As Excel does, a workbook set to manual calculation stays so, and is recalculated only when asked (F9)

  • Fix: a row whose height Excel had fitted to its text (an ht without customHeight) was saved with customHeight="1", which fixed it at that height: Excel no longer fitted it as its text changed. customHeight is now kept as the file has it, setRowHeight sets it, as before, and rows insertRows adds inherit it with their height. Heights in whole points are written as Excel writes them (ht="29", not "29.0")

  • Fix: a workbook saved by Excel in another language names its sheet categories in that language in docProps/app.xml ("Planilhas" for "Worksheets"). Saving it added a second, English "Worksheets" category, listing every sheet twice. The categories are now recognised by the sheets they list, and keep their names

  • Tests: round-trip fidelity. A workbook made by Excel 365 with parts XLSX.jl doesn't model (a pivot table and its cache, a slicer, a timeline, an external link and custom XML) and with sparklines, a shape, a table and a note, is edited and saved: every part other than calcChain.xml (which Excel rebuilds) is kept unchanged, as are every relationship and content type, and Excel opens the result without repair, with its pivot table refreshing. Every other test file also keeps all its parts and relationships through an edit and a save

  • Defined names are written to workbook.xml in Excel's order: by name, ignoring case and the _xlnm. prefix, a sheet's name before the workbook's name of the same name, and sheets in order. They were written in no particular order. Excel read them either way; a file saved by Excel 365 now round-trips with its <definedNames> unchanged

  • Docs: the full docs build, with doctests, passes again. The getText example in the cell formats guide wrote "A\$i", which a markdown doctest takes literally; the headerFooterField and headerFooterFont examples had no import XLSX; and the links to the Document properties guide were ambiguous, as the API page has a heading of the same name

  • Tests: a defined-names test removes the file it writes

  • setAutoFilter(sheet, rng; filters, sort) filters and sorts the range, as choosing from Excel's filter buttons does. filters pairs columns (by header text, letter or position) with criteria: a value or a list of values to show (text in any case, numbers, dates by the day, true/false, missing for empty cells), a condition such as ">" => 1000 or "==" => "A*" with Excel's wildcards, two conditions joined by :and or :or, the top or bottom items or percent, above or below the average, or a date relative to today (:today, :thisWeek, :lastMonth, :yearToDate, :Q1, :M3, …). sort gives one or more columns, each ascending or descending. Excel doesn't reapply a filter or a sort when it opens a file, so, as Excel does when it saves, the rows the criteria don't show are hidden and the rows are put in order: numbers and dates, text in any case, logicals, errors, then empty cells, as Excel's sort orders them. Each row's cells move with their formats, notes, threaded comments and hyperlinks, and formulas move as if copied (=B5*2 in row 5 becomes =B2*2 in row 2), as in Excel. A range with merged cells, array formulas, or formulas shared with cells outside it is refused. For each kind of criterion and for a sort by two columns, the rows hidden, the order, the formulas and the XML are the same as Excel 365 gave for the same data, and Excel reapplying XLSX.jl's filters hides the same rows. filters=[] removes the criteria and shows the rows again. The sheet is marked as filtered (filterMode), as Excel marks it. Filtering by colour or icon isn't supported

  • removeAutoFilter also removes the filter's sort and the sheet's filtered mark

  • addThreadedComment(sheet, ref, text; author) starts a threaded comment, Excel 365's Review → New Comment, addThreadedReply adds a reply, setThreadedCommentResolved resolves or reopens the thread, and deleteThreadedComment deletes it with its replies. Each author becomes one of the workbook's people, shared by every comment with the same name. As Excel does, each thread also has a note holding the conversation as text for versions of Excel without threads, kept up to date as replies are added. The XML is the same as Excel 365 writes, checked against a file saved by Excel; Excel reads back every thread, reply, author and resolved thread from a file XLSX.jl writes, and keeps them when it saves. addComment refuses a cell that has a thread, as before, and a thread refuses a cell that has a note, since a cell has one or the other

  • addHyperlink puts a link on a range of cells ("A1:C3"), which works from any of them. As Excel does, the text goes in the range's top-left cell if it is empty, and every empty cell in the range gets the link font. A link may not overlap another. deleteHyperlink given a range deletes every link overlapping it

  • Internal: the threaded comment reader moves from comments.jl to threadedcomments.jl, beside the new writer; _put_note! and _remove_note! write and remove a note and its box for addComment, deleteComment and threaded comments alike. Filter criteria and sorting are in filtersort.jl

  • Pictures in cells, Excel 365's Insert → Pictures → Place in Cell: sheet[ref] = CellImage("logo.png"; alt="Logo"), or addImage(sheet, ref, image; inCell=true, alt), puts a PNG, JPEG or GIF picture in a cell as its value, keeping the cell's format. writetable writes a column of CellImages. A picture shown in several cells is stored once, as Excel stores it. getCellImage(sheet, ref) reads the picture in a cell, with its alternative text, and getCellImages(sheet) lists every picture in a sheet's cells, from any file; both also read the picture an IMAGE formula shows, with its web address. A cell holding a picture still reads as missing, and iserror and geterror still give it Excel's stored #VALUE!, as before. deleteImage(sheet, ref) deletes the picture in the cell as well as floating images there. The rich-value XML is the same as Excel 365 writes for the same pictures, checked against a file saved by Excel; Excel opens XLSX.jl's files with every picture in place, and keeps them when it saves. Streamed sheets can't hold pictures

  • Fix: a cell holding a picture, the result of an IMAGE formula, or another rich value such as a #SPILL! error kept its link to the value (its vm attribute) when the file was saved. Saving a workbook opened with mode="rw" turned every picture placed in a cell into a plain #VALUE!

  • Fix: a dynamic-array formula written to a workbook whose xl/metadata.xml had no dynamic-array record pointed at a cell-metadata record that didn't exist (cm="1"). Dynamic-array formulas and pictures in cells now share xl/metadata.xml, each adding the records it needs in Excel's form

  • setCheckbox(sheet, ref) puts checkboxes in cells, as Excel 365's Insert → Checkbox does, and removeCheckbox takes them away. A checkbox shows its cell's value, ticked for TRUE: an empty cell is given FALSE, and other values are kept, which Excel shows instead of a box, as it does for its own. The cells' other formatting is kept, and later formatting keeps the checkbox. hasCheckbox(sheet, ref) and getCheckboxes(sheet) read them, with whether each is ticked, from any file. The XML is the same as Excel 365 writes, checked against a file saved by Excel, and Excel reads every checkbox back from a file XLSX.jl writes

  • Internal: _restyle_cells! gives cells a changed copy of their style, for setCellProtection and setCheckbox alike; _workbook_part! finds or makes a workbook-level part with its relationship and content type. src/data/metadata.xml, the template for dynamic-array metadata, is no longer needed

  • addTextBox(sheet, ref, text; ...) adds a text box, as Excel's Insert → Text Box does, and addShape(sheet, ref, kind; text, ...) a shape, as Insert → Shapes does: 34 of Excel's preset shapes (rectangles, ovals, triangles, arrows, callouts, stars, flowchart shapes and others), with the names Excel gives each kind. They float over the cells, anchored as images are, over a range or from a cell for a size in pixels. Their text is a string, "\n" starting a paragraph, or a RichTextString with runs in different fonts, as in cells; font takes setFont's settings for the whole text, and horizontal and vertical place it. fill, line, lineWidth and lineDash set the fill and border, in any of XLSX.jl's colour forms. A text box is white with a thin grey border and a shape in the theme's first accent colour, as Excel makes them. getShapes lists a sheet's text boxes and shapes, with their names, kinds, cells and text, from any file, and deleteShape deletes them by cell or name. They move with inserted and deleted rows and columns, are deleted with all the rows or columns under them, and are copied by copysheet!. The XML is the same as Excel 365 writes, checked against files saved by Excel, Excel reads every setting back, and the default names were checked against Excel's for all 34 kinds. The text and colours are written by the DrawingML layer charts use

  • copysheet! copies a sheet whose drawing holds only shapes. Excel writes no relationships part for such a drawing, and copying one failed with a KeyError

  • addSparklines(sheet, location, data; type, ...) adds a group of sparklines, small line, column or win/loss charts in single cells, as Excel's Insert → Sparklines does: one in a cell, or one for each row or column of the data in a row or column of cells, the data on this sheet or another. The group's options are Excel's: markers on every point or on the high, low, first, last and negative points, colours for each, the horizontal axis, empty cells as gaps, zeros or spanned, hidden data, the line's weight, the vertical axis's limits (each sparkline's own, the group's, or a number), right-to-left, and a range of dates to space the points by. getSparklines reads a sheet's groups with their options, from any file, and deleteSparklines deletes sparklines, or with group=true their groups. The XML is the same as Excel 365 writes for the same steps, checked against files saved by Excel, and Excel reads every type and option back from a file XLSX.jl writes

  • Sparklines follow edits as Excel's do, checked against Excel's results for each: they move with insertRows, deleteRows, insertColumns and deleteColumns; rows inserted below a sparkline, or columns to its right, get one of their own in its group ("Format Same As Above"); a sparkline whose cell is deleted goes, and one whose data is deleted, with its rows, columns or sheet, stays without data rather than charting #REF!; renamesheet! updates their data, and copysheet! points the copy's sparklines at the copy. A group left with no sparklines is removed

  • Extensions in a worksheet's <extLst> are kept in the order Excel writes them: a new x14 conditional format goes before sparklines, rather than after whatever extensions the sheet already had. Its <ext> also writes uri before xmlns:x14, as Excel does

  • Internal: _worksheet_ext! finds or makes a worksheet extension, for x14 conditional formats and sparklines alike; _cell_region, formerly in the ignored-errors code alone, turns a reference into its ranges for both

  • setIgnoredErrors(sheet, ref; numberStoredAsText=true, ...) turns off Excel's error-checking warnings (the green triangle) for some cells, as Excel's Ignore Error does, or with false turns them back on: a number stored as text, a formula resulting in an error, a two-digit year in a text date, a formula inconsistent with its neighbours or its Table's column, a formula omitting cells beside its range, an unlocked formula, a reference to empty cells, and a value outside a list validation. getIgnoredErrors reads them, for the sheet or one cell, and removeIgnoredErrors turns them all back on, in a range or the whole sheet. As Excel writes them, each cell is listed once, with every warning ignored in it, so a range is split where its cells' warnings come to differ; the XML is the same as Excel 365 writes for the same steps, checked against a file saved by Excel, and Excel reads back every warning, for each of the nine kinds, from a file XLSX.jl writes. The ranges move with insertRows, deleteRows, insertColumns and deleteColumns, which already moved them

  • protectWorkbook(xf; password, structure=true, windows=false) protects a workbook's structure, as Excel's Review → Protect Workbook does, so that its sheets can't be added, deleted, moved, renamed, hidden or unhidden in Excel; unprotectWorkbook, isWorkbookProtected and getWorkbookProtection remove and read it. The password is stored as Excel's legacy hash, as protectSheet stores one. Checked in Excel 365: it refuses a wrong password and accepts the right one, refuses to add a sheet to a protected workbook, and has the element where Excel writes it. getWorkbookProtection also recognises Excel's own SHA-512 passwords. Excel 365 for Windows ignores windows, which only Excel for Mac and older versions use

  • The password errors of protectSheet say "protection password" rather than "sheet password", as they now come from protectWorkbook too

  • setDocumentProperties(xf; title, subject, creator, keywords, description, lastModifiedBy, category, contentStatus, created, modified, company, manager) sets a workbook's document properties, those of Excel's File → Info, and getDocumentProperties reads them back, the dates as DateTimes in UTC. setCustomProperty(xf, name, value) sets a custom property, typed as a string, number, Bool or date as Excel types it, adding docProps/custom.xml with its relationship and content type when the file has none; getCustomProperty, getCustomProperties and deleteCustomProperty read and delete them. Names ignore case, as in Excel. Properties other programs write, such as sensitivity labels and lists, are kept as they are, and a missing core or app part is added when needed. The XML is the same as Excel 365 writes for the same properties, checked against a file saved by Excel, and Excel reads back every property, with its type, from a file XLSX.jl writes. The getters work on files opened for reading only

  • OrderedCollections, already a dependency, is now imported, for getCustomProperties

  • setSheetView(sheet; zoom, view, showGridLines, showRowColHeaders, showZeros, rightToLeft, topLeftCell, activeCell, selection) sets how a worksheet looks when Excel opens it, as Excel's View tab does: the zoom (10 to 400 percent, kept for each view as Excel keeps it), Normal, Page Layout or Page Break Preview, whether gridlines, row and column headings and zeros are shown, right-to-left, the cell scrolled to the top left, and the selected cells and active cell. getSheetView reads them back from any file, including one opened for reading only. With frozen or split panes, the scroll position and selection are the active pane's, as Excel keeps them. The XML is the same as Excel 365 writes for each setting, checked against a file saved by Excel, and Excel opens XLSX.jl's files with every setting as given

  • freezePanes, splitFreeze and splitPanes scroll the view back to the top. Excel counts frozen rows and columns from the cell in view, so a sheet saved scrolled to row 10 and then frozen with nrows=1 would have had row 10 frozen in Excel, not row 1. They also write the <pane> attributes and the panes' <selection>s in the order Excel writes them, where the order varied before

  • Internal: _apply_pane! and setSheetView share one function that rewrites a sheet's <sheetView>, writing its attributes in the schema's order

  • setHeaderFooter(sheet; header, footer, ...) sets the headers and footers printed on a worksheet's pages, as Excel's Page Setup → Header/Footer does: each as a left, centre and right section (header=(left="Sales", right="Page &P of &N")) or a single centred string, with different ones for the first page (firstHeader, firstFooter) and for even pages (evenHeader, evenFooter), and whether they scale with the sheet and align with its margins. getHeaderFooter reads them back, split into sections, from any file, including one opened for reading only, and removeHeaderFooter removes them. headerFooterField(:page) and the like give Excel's codes for the page number, number of pages, date, time, file name, folder and sheet name, and headerFooterFont(; name, bold, italic, size, color, ...) gives the codes that change the font, with the keywords of setFont. The XML is the same as Excel 365 writes for the same settings, checked against a file saved by Excel, and Excel reads back every header XLSX.jl writes. A header or footer is limited to 255 characters, as in Excel. Pictures in headers and footers aren't supported

  • Internal: _set_sheet_element! takes the children to give the element, as well as its attributes

  • autofitColumns(sheet, cols=:; min_width, max_width) sets columns to the width of the text their cells show, as Excel's AutoFit Column Width does: each cell's value in its number format (so 1234567.891 formatted #,##0.00 is measured as 1,234,567.89), in its font, size and boldness, the longest line of a cell with several, merged cells left out. Characters are measured with the widths Excel 365 uses for Calibri, Aptos, Aptos Narrow, Arial, Times New Roman and Courier New, measured from Excel's own autofit. On 50 cells of different fonts, sizes, formats and lengths, the widths are within 0.2 characters of the ones Excel's AutoFit sets at the median and within 1.4 at most; they are approximate, as Excel's own vary a little with the screen

  • getText(sheet, ref) gives the text Excel shows in a cell, its value in its number format, as Excel's Range.Text does: "1,234.50", "7 March 2026", "25.6%". It renders General, digit placeholders, thousands separators and scaling, percentages, scientific and engineering notation, fractions, dates, times and elapsed times, text sections, literals, currency and locale codes, colours and conditions, and matches Excel 365 on 198 of 201 cases read from Excel (a fill repeated to the column's width, and two times exactly half-way between hundredths of a second, differ). It works on files opened for reading only, with or without the cell cache

  • setFormat accepts the format codes Excel accepts and refuses the ones it refuses, checked against Excel 365 on 62 codes. It refused scientific formats with E- or a one-digit exponent, fractions with a fixed denominator (# ?/4), the e year code, colours by number ([Color12]), upper-case date codes and letters Excel shows as they are (x0, 0.0c); it accepted unknown colours ([Purple]) and date codes among digit placeholders (0 h), which Excel refuses

  • Behavior change: the built-in number formats 6, 8, 38 and 40 have Excel's codes, $#,##0_);[Red]($#,##0) and so on, and 47 is mm:ss.0. getFormat reported Red without brackets and mmss.0, and setFormat given Excel's code for one of them added a custom format rather than using the built-in

  • setFormula takes a value keyword, the formula's result, saved as its cached value as Excel saves the last value it calculated: a number, string, Bool, date or time, or an error value such as XL_NA, written after the <f> with the cell type Excel gives it (t="b", t="e", …). A string is written in the cell (t="str"), as Excel writes it. For a range, give one value for every cell or an array of the range's shape. XLSX.jl, pandas, calamine and file previews, which read cached values rather than calculating formulas, read the value rather than an empty cell. A date or time gives the cell a date or time format, as writing it to a cell does. Excel still recalculates every formula when it opens the file

  • Formulas are written as Excel 365 writes them, checked by saving XLSX.jl's files in Excel: without a leading = in <f> (a formula given to setFormula as "=SUM(A1:A3)" was written as <f>=SUM(A1:A3)</f>), and with a string result in the cell as t="str", not as a shared string, whether set with setFormula(...; value) or read from a file. Excel read the old form too, and rewrote it in this form when it saved. getFormula still returns formulas with a leading =, and setFormula takes them with or without one

  • setFormula on a non-contiguous range ("A1:A3,C1", or a defined name for one), or with rows or columns given as a vector or step range, gives an XLSXError saying so, rather than a MethodError

  • Write large files in constant memory. writetable(...; streaming=true) writes the rows straight into the file a chunk at a time, rather than building the workbook in memory first, and streamxlsx with addsheet! and writerow! writes rows as they are produced. A Tables.jl table read a row at a time (a vector of NamedTuples, a database query, CSV.Rows) is never held in memory as a whole. A streamed sheet can have column widths, column number formats, a frozen header row and an Excel Table, but no other formatting or objects, and its rows are written once, in order. Writing 1,000,000 rows × 20 mixed columns peaks at 823 MiB rather than 4,448 MiB (the data itself takes 664 MiB), in 10.0 s rather than 17.4 s; 100,000 × 8 strings takes 0.36 s rather than 0.62 s. Strings are written inline in each cell by default, as XlsxWriter, rust_xlsxwriter and Apache POI do when streaming: measured on that table, a shared string table made the file no smaller and needed 350 MiB more, holding every distinct string. shared_strings=true writes them as Excel does, for data with many repeats. The sheets read back exactly as writetable writes them, except that an empty cell is left out, as Excel leaves it out. bench/stream_write.jl measures peak memory in a fresh process for each case

  • writetable and writetable! take column_widths, column_formats (a Dict from column number or name to a number format) and freeze_header, to set the written columns' widths and number formats and freeze the header row in the same call

  • Internal: writing a worksheet is split into its XML before the rows, the rows and the XML after them, and writing the package's other parts into a function of its own, which the streaming writer shares. Cell elements are written by shared helpers. The files written are byte-for-byte the same

  • Sheet names are matched without regard to case, as Excel matches them: hassheet(xf, "data"), xf["data"], xf["data!A1"], deletesheet!(xf, "DATA") and readtable(file, "data") all find a sheet named Data. They needed the exact case before, although renamesheet! and addsheet! already treated names differing only in case as the same.

  • setFormat and setUniformFormat accept custom format codes with the characters Excel shows as they are (/ . ^ & ' ~ { } < > =), ! as an escape, the General keyword and locale codes such as [$-409] or [$€-x-euro2]. Common date formats such as "dd/mm/yyyy" and "dd.mm.yyyy" were rejected as invalid. Each was checked as accepted by Excel 365.

  • setCellProtection takes rows and columns by number (sheet, 2:20, 2, sheet, [2, 4], 1:3, sheet, :, 5) and whole columns or rows ("B:B", "5:6"), which reach as far as the sheet's used range, as the format setters do. Whole columns and rows were refused before.

  • clearConditionalFormats(sheet, :) removes every conditional format on a sheet, and clearConditionalFormats takes whole columns ("B:D"), whole rows ("2:5") and comma-separated mixes, covering the full height or width of the sheet. Only cell ranges were accepted before.

  • A data point given a marker of its own (setMarkerSymbol(c, i, sym; point=p) and the other marker setters) starts from the series' marker size, as Excel 365 writes it. It had no size before, so Excel drew it at its default size.

  • clearConditionalFormats is declared public (not exported: call it as XLSX.clearConditionalFormats) and no longer marked experimental. Its docstring has an example, and the conditional formats guide covers it.

  • setColoredDataBars is declared public (still experimental and not exported: call it as XLSX.setColoredDataBars). Its docstring and the Examples page now say so, where before the API reference listed it while the Examples page called it not public.

  • Docs: printed examples in the XLSX Tutorial and the guides to worksheets, named ranges, comments, hyperlinks, data validation, protection, filtering, conditional formats and cell addressing are now doctests, checked on every docs build. The tutorial reads a myfile.xlsx published beside it, which readers can download. Outputs that had drifted are corrected: a worksheet shows as Worksheet, not XLSX.Worksheet; ranges as Matrix{Any}; a DataTable as a one-line summary. A new FAQ and troubleshooting page covers common error messages and surprises. External links are checked by a separate, non-blocking CI job (DOCUMENTER_LINKCHECK=true), and one link that had moved is updated.

  • Docs: a Cookbook page of short recipes for common tasks, each tested and most with a picture of the result in Excel. New pictures: every chart kind addChart creates, a combo chart, before-and-after pairs for each section of Formatting charts, and the finished form in Examples. Every picture has alt text describing it. Column widths and row heights move to Layout and view.

  • Docs: the sidebar is grouped by task: Getting started, Data, Formatting, Layout and view, Worksheets, Images, comments and links, Charts (creating first), Examples, API Reference. The links, images and comments page is split into one page each, and the sheet settings page into Protecting a sheet and Printing, with sheet visibility and tab colour moved to Managing worksheets; the old pages remain as short pointers. A new page, Addressing cells and ranges, collects every way of naming cells, ranges, rows and columns. In the API reference, images, comments and hyperlinks have their own page, and the Tables page separates plain-cell tables from Excel Tables.

  • Docs: new guides for named ranges and for managing worksheets (sheet order moves there from the links, images and comments page), and a tutorial on creating, opening and saving workbooks. The cell formats guide has a number formats section, the conditional formats guide a section on reading and clearing them, and the Excel Tables guide a quick start.

  • Docs: the Home page has an "I want to…" table linking common tasks to their sections; a new Supported features page lists each Excel feature with its functions and guide, and what XLSX.jl doesn't do; the API reference has an alphabetical index; each guide ends with links to its API page and related examples, and each API page links to its guide; the charts overview opens with a short create-a-chart example; sidebar labels name drop-downs, AutoFilter, outlines, protection and printing.

  • Docs: examples use only public API (setBorder(...; outside=...) in place of the internal setOutsideBorder, and integer rows and columns in place of XLSX.CellRange); tutorial DataFrame output is refreshed to current DataFrames printing; broken "described above" references and a using FileIO, DataFrame typo are fixed.

  • A column inserted inside a hidden column span is shown, with the span split around it, as a row inserted among hidden rows already was; and a group that gains a visible row or column loses the collapsed marker on its summary row or column. Both as Excel 365 does; the hidden span used to grow over the new column. Checked against Excel with the fixtures made for P1–P3, now used by the tests.

  • setLabelFlag(c::ChartEx, i, flag, on) shows or hides a chartEx series' label parts (:seriesName, :categoryName, :value), writing labels as Excel 365 does. As in Excel, histogram and Pareto labels have no category name and a Pareto line has no labels.

  • Reading conditional formats, and adding a number format, no longer walk every node of the sheet or styles part to find one element. getConditionalFormats on a 50,000-cell sheet read with readxlsx takes half the time (111 ms to 58 ms), and each new number format takes under a microsecond, from 58 μs.

  • setLabelFlag(c, i, flag, on) shows or hides one part of a c: series' data labels (:value, :seriesName, :categoryName, :legendKey, :percent or :bubbleSize), and getLabelFlag(c::Chart, i, flag) reads it back. A series with no labels is given the ones Excel 365 writes when labels are turned on, checked for every chart kind. There was no way to make a c: chart's labels appear before.

  • insertRows and insertColumns format the new rows and columns as Excel does by default ("Format Same As Above"): each new cell takes its neighbour's style, without its border; a row takes the height, style and outline level of the row above, and a column the width, style and outline level of the column to its left; and a conditional format or data validation ending just before the insert grows over it. Checked against Excel 365's own results. The new rows and columns used to be unformatted.

  • Deleting all the rows or columns under an image or chart set to move and size with its cells deletes it, with its picture or chart part, as Excel does. It used to shrink to nothing and stay in the file.

  • makeCombo(c) makes a :column, :stackedColumn or :line chart a combo chart, as Excel's Change Chart Type → Combo → "Clustered Column – Line on Secondary Axis" does: the last series becomes a line on new secondary axes and the others clustered columns. As in Excel, the title, legend, axes and the formatting of series that keep their type are kept, and a series that changes type takes the default formatting of its new group, keeping its name, data and data labels. Checked against Excel 365's own results.

  • addSeries and addChartEx take absolute references, such as Data!$B$2:$B$5, 'My Data'!$B$1 or $B$2:$B$5, so a reference read from a series with getChartSeries can be passed straight back. They threw before.

  • addSeries writes a series' children in schema order. A line or scatter series had its c:smooth written before its data, where the schema places it after.

  • addChart(ws, :combo; …) creates Excel's "Clustered Column – Line on Secondary Axis" combo chart, from a chart Excel 365 wrote, and addSeries takes a group keyword, :column or :line, saying which of a combo chart's groups a series joins. It works on combo charts Excel made too, which addSeries refused before. group is required on a chart with more than one plot group and an error on one with a single group. Combo series are formatted as Excel formats them, with markers on the line giving Excel's Line with Markers formatting.

  • addSeries numbers a new series (c:idx, c:order and its automatic accent colour) across all of a chart's series rather than within its group. This changes nothing for a chart with one group.

  • addChart creates nine more kinds, from charts Excel 365 wrote: :percentStackedColumn, :percentStackedBar, :stackedLine, :percentStackedLine, :stackedLineMarkers, :percentStackedLineMarkers, :stackedArea, :percentStackedArea and :filledRadar. Series added with addSeries are formatted as Excel formats them, the second series and on included. markers and smooth apply to every line kind, and markers on a stacked line series give it the formatting of the kind with markers, as they do for :line

  • addSeries reads which kind a chart is from its plot group's barDir, grouping, marker flag and radarStyle, compared with each kind's template, so an existing stacked or 100% stacked chart, from Excel or elsewhere, takes the matching kind's series formatting. A stacked bar chart was read as a clustered one; the two format their series alike, so files written before are unaffected

  • getSeriesFill on a chartEx chart reports the colour Excel draws where the chart itself writes none, which until now was nearly always (Excel writes no fill for a cx: series until it is formatted). The colour is read from the chart's style and colours parts as a last rung of the cascade, site.level === :style, and was checked colour for colour against Excel 365: series of box & whisker, funnel, histogram and Pareto charts, a waterfall's increase, decrease and total points, and a treemap's or sunburst's points by top-level category. Lines, text, monochromatic colour schemes and c: charts are unchanged (a c: series without formatting is drawn from its c:style, not from these parts). A waterfall, treemap or sunburst point's chain now ends in the :style rung

  • Test fixtures written by Excel 365, with SVG exports of their charts in test/data/chart_style_svg, record the colours Excel draws

  • Internal: src/charts/chartprops.jl (2,972 lines) is split by object into chartnodes.jl (design notes, node locators and shared helpers), charttext.jl, chartseries.jl, chartaxes.jl, chartlegend.jl and chartcascade.jl. Every function moves unchanged. No change in behaviour

  • Writing a worksheet allocates less and is 10–25% faster: writetable of 100,000 × 8 strings allocates 772 → 336 MiB, and of numbers 986 → 666 MiB (0.55 → 0.44 s). Integers and cell references are written without making strings, the tags are built once, rows are written a chunk at a time into one buffer per thread, and the sheet goes into the file in pieces rather than being copied whole twice. The files written are byte-for-byte the same

  • bench/worksheet_write.jl times each write path on its own, without fixtures, and keeps earlier runs to compare against

  • Add deleteImage, which deletes the images whose top-left corner is in a cell, or one image from getImages. The picture file goes too, unless another image still shows it, and a drawing left empty is removed. getImages is now declared public

  • Add Charts.deleteChart, which deletes a chart on a worksheet with the parts only it uses, and for a chartEx chart its hidden _xlchart names. A chart on a chartsheet is refused: delete the sheet instead

  • Add getThreadedComments and getThreadedComment, which read Excel 365's threaded comments: each thread's author, text, date and whether it is resolved, with its replies. Threaded comments are still not written

  • insertRows, deleteRows, insertColumns and deleteColumns move Excel Tables, so sheets with tables can now be edited this way. A table grows to take in rows or columns inserted inside it (inserted columns become table columns named Column1, Column2, ...) and shrinks as they are deleted from it; one deleted whole is deleted. References to a deleted table or table column (Sales[Amount]) become #REF! everywhere, and formulas in calculated columns and totals rows move. Deleting a table's header row, totals row or all its data rows on their own is refused

  • Internal: addtable! is broken into steps (choosing the name, reading the header, checking the totals row, attaching the table part)

  • insertRows, deleteRows, insertColumns and deleteColumns move the sheet's images, charts and shapes, as each one's move and size with cells setting says (an object all of whose rows or columns are deleted shrinks to nothing), and its comments and their boxes. A comment on a deleted cell is deleted; a threaded comment is moved, but deleting its cell is refused. Sheets with images, charts or comments can now be edited this way

  • Add insertRows, deleteRows, insertColumns and deleteColumns, which work as Excel's Insert and Delete commands do. Cells move, with their row heights and attributes, and everything that refers to them follows: formulas on every sheet (relative or absolute), merged cells, conditional formats and data validations (their ranges and formulas, x14 ones included), hyperlinks, the AutoFilter and its filter columns, frozen panes (deleting all the frozen rows and columns unfreezes the sheet) and selections, column widths, page breaks, defined names (including the print area and titles) and chart series. Ranges across an insert grow and ranges cut by a delete shrink; references to deleted cells become #REF!. A shared formula stays shared when the edit moves all its cells alike; one it would change unevenly (references across the edited rows, or a delete inside its block) is stored as one formula per cell afterwards.

  • Internal: the readtable and eachtablerow methods share one keyword list rather than repeating it, and mergeCells/removeMergedCells and setColumnWidth/setRowHeight define their shared address methods once. No change in behaviour, except that an unknown keyword to readtable or eachtablerow is reported against the internal function the keywords are passed to

  • Internal: write.jl is split into save.jl (writing the package), setdata.jl (writing cells), writetable.jl and sheetops.jl (adding, renaming, copying, deleting and moving sheets), and the Excel Tables half of table.jl moves to exceltables.jl. copysheet! and deletesheet! are broken into steps, and repeated code in the cell format setters, range handling, conditional format data bars and the sheet cache fill is shared. No change in behaviour

  • bench/maintainability.jl counts duplication in code only: it leaves out docstrings, the bodies of const tables, lines of nothing but literals, and include lines, which it counted as duplicated because blanking their literals made unrelated ones look alike

  • Add setCellProtection and getCellProtection to unlock cells, so they can be filled in on a protected sheet, and to hide cells' formulas, as the Protection tab of Excel's Format Cells dialog does. Empty cells are given the format without a value, and the cells' other formatting is kept

  • A cell format with both an alignment and a protection setting writes them in the order the schema requires. setAlignment added the alignment after any protection Excel had written

  • Add protectSheet, unprotectSheet, isSheetProtected and getSheetProtection to protect worksheets, with an optional password (Excel's legacy hash, so up to 15 ASCII characters) and the same choice of what users may still do as Excel's Protect Sheet dialog

  • Add setPageSetup/getPageSetup (orientation, paper size, scaling or fit to pages), setPageMargins/getPageMargins, setPrintOptions/getPrintOptions (gridlines, headings, centring), and setPrintArea, getPrintArea, removePrintArea, setPrintTitles, getPrintTitles and removePrintTitles for printing. A pageSetup that links to printer settings keeps the link

  • Add setSheetVisibility and getSheetVisibility to show and hide sheets (:visible, :hidden or :veryHidden), and setTabColor, getTabColor and removeTabColor for tab colours, on worksheets and chartsheets. Hiding the workbook's last visible sheet is an error, and hiding the sheet the workbook opens on makes the first visible sheet the one it opens on

  • Worksheet's internal is_hidden field is replaced by visibility, which tells hidden and very hidden sheets apart. ws.is_hidden still reads and sets it

  • Add setAutoFilter, getAutoFilter and removeAutoFilter to add, read and remove the filter buttons on a plain range of a sheet, outside an Excel Table. The hidden _xlnm._FilterDatabase name Excel keeps for the filter is written and removed with it, and follows the sheet through copysheet!, renamesheet! and deletesheet!. A filter may not overlap an Excel Table

  • addtable!, writetable! with as_table=true, appendtable! and settotals! throw an error rather than place or grow a table onto the sheet's AutoFilter, as Excel does not allow the two to overlap

  • Add setColumnHidden, setRowHidden, isColumnHidden and isRowHidden to hide and show rows and columns, and groupRows, groupColumns, ungroupRows, ungroupColumns, getRowOutlineLevel and getColumnOutlineLevel to group them in an outline, nested up to Excel's seven levels and optionally collapsed. Rows and columns needn't hold data, and can be read from a file opened only for reading

  • setRowHeight sets the height of a row with no cells, which is written with just its height. It skipped such rows, returning -1 if every row was empty

  • copysheet! copies the attributes of the original's rows: their styles, and whether they are hidden or grouped. The copy's rows had none

  • setColumnWidth joins adjacent column definitions left with the same settings

  • Add addDataValidation, getDataValidations, getDataValidation and deleteDataValidation to add, read and delete data validation: drop-down lists (from values or a range), whole and decimal numbers, dates, times, text length and custom formulas, with input and error messages. Validations Excel 2010 wrote in its extended (x14) form are read and deleted too, and validations can be read from a file opened only for reading

  • renamesheet!, deletesheet! and copysheet! now update sheet references in Excel 2010 (x14) data validations, whose formula is held in an <xm:f> inside <x14:formula1>. Those references were left unchanged

  • Add addHyperlink, getHyperlink, getHyperlinks and deleteHyperlink to add, read and delete cell hyperlinks: to a web page, email address or file (url), or to a place in the workbook (location). An empty cell given a link takes its display text and a blue, underlined font, as in Excel. Links can be read from a file opened only for reading, with or without the cell cache

  • copysheet! gives the copy's hyperlinks to web pages and files relationships of their own. The copy kept the original's relationship ids, which pointed at relationships the copy didn't have

  • Docs: a Chart subtypes section in Creating charts maps each of Excel's chart subtypes to the kind or addSeries keywords that create it, and the Limitations list of kinds that can't be created is completed

  • Docs: the Migration Guide covers v0.12 and v0.13, including every behaviour change in the v0.13 patch releases

  • Docs: the README and home page list the package's features and give a quick start

  • Docs: a new Images, comments and sheet order guide