version bump 0.18.5: basic NUMBERS write

CHANGELOG.md

@@ -4,7 +4,20 @@ This log is intended to keep track of backwards-incompatible changes, including
 but not limited to API changes and file location changes.  Minor behavioral
 changes may not be included if they are not expected to break existing code.
 
+## v0.18.5
+
+* Enabled `sideEffects: false` in package.json
+* Basic NUMBERS write support
+
+## v0.18.4
+
 * CSV output omits trailing record separator
+* Properly terminate NodeJS Streams
+* DBF preserve column types on import and use when applicable on export
+
+## v0.18.3
+
+* Removed references to `require` and `process` in browser builds
 
 ## v0.18.2
 

Makefile

@@ -95,6 +95,8 @@ dist: dist-deps $(TARGET) bower.json ## Prepare JS files for distribution
 	misc/strip_sourcemap.sh dist/$(LIB).mini.min.js
 	@# extendscript
 	cat <(head -n 1 bits/00_header.js) shim.js $(DISTHDR) $(REQS) dist/$(TARGET) > dist/$(LIB).extendscript.js
+	@# zahl
+	cp modules/xlsx.zahl.js modules/xlsx.zahl.mjs dist/
 	@#
 	rm dist/$(TARGET) dist/$(MINITGT)
 

README.md

@@ -1764,6 +1764,61 @@ stream.pipe(conv); conv.pipe(process.stdout);
 
 </details>
 
+<details>
+  <summary><b>Exporting NUMBERS files</b> (click to show)</summary>
+
+The NUMBERS writer requires a fairly large base.  The supplementary `xlsx.zahl`
+scripts provide support.  `xlsx.zahl.js` is designed for standalone and NodeJS
+use, while `xlsx.zahl.mjs` is suitable for ESM.
+
+_Browser_
+
+```html
+<meta charset="utf8">
+<script src="xlsx.full.min.js"></script>
+<script src="xlsx.zahl.js"></script>
+<script>
+var wb = XLSX.utils.book_new(); var ws = XLSX.utils.aoa_to_sheet([
+  ["SheetJS", "<3","விரிதாள்"],
+  [72,,"Arbeitsblätter"],
+  [,62,"数据"],
+  [true,false,],
+]); XLSX.utils.book_append_sheet(wb, ws, "Sheet1");
+XLSX.writeFile(wb, "textport.numbers", {numbers: XLSX_ZAHL, compression: true});
+</script>
+```
+
+_Node_
+
+```js
+var XLSX = require("./xlsx.flow");
+var XLSX_ZAHL = require("./dist/xlsx.zahl");
+var wb = XLSX.utils.book_new(); var ws = XLSX.utils.aoa_to_sheet([
+  ["SheetJS", "<3","விரிதாள்"],
+  [72,,"Arbeitsblätter"],
+  [,62,"数据"],
+  [true,false,],
+]); XLSX.utils.book_append_sheet(wb, ws, "Sheet1");
+XLSX.writeFile(wb, "textport.numbers", {numbers: XLSX_ZAHL, compression: true});
+```
+
+_Deno_
+
+```ts
+import * as XLSX from './xlsx.mjs';
+import XLSX_ZAHL from './dist/xlsx.zahl.mjs';
+
+var wb = XLSX.utils.book_new(); var ws = XLSX.utils.aoa_to_sheet([
+  ["SheetJS", "<3","விரிதாள்"],
+  [72,,"Arbeitsblätter"],
+  [,62,"数据"],
+  [true,false,],
+]); XLSX.utils.book_append_sheet(wb, ws, "Sheet1");
+XLSX.writeFile(wb, "textports.numbers", {numbers: XLSX_ZAHL, compression: true});
+```
+
+</details>
+
 <https://github.com/sheetjs/sheetaki> pipes write streams to nodejs response.
 
 ### Generating JSON and JS Data
@@ -3366,6 +3421,7 @@ The exported `write` and `writeFile` functions accept an options argument:
 |`Props`      |          | Override workbook properties when writing **        |
 |`themeXLSX`  |          | Override theme XML when writing XLSX/XLSB/XLSM **   |
 |`ignoreEC`   |   `true` | Suppress "number as text" errors **                 |
+|`numbers`    |          | Payload for NUMBERS export **                       |
 
 - `bookSST` is slower and more memory intensive, but has better compatibility
   with older versions of iOS Numbers
@@ -3381,6 +3437,8 @@ The exported `write` and `writeFile` functions accept an options argument:
 - Due to a bug in the program, some features like "Text to Columns" will crash
   Excel on worksheets where error conditions are ignored.  The writer will mark
   files to ignore the error by default.  Set `ignoreEC` to `false` to suppress.
+- Due to the size of the data, the NUMBERS data is not included by default. The
+  included `xlsx.zahl.js` and `xlsx.zahl.mjs` scripts include the data.
 
 ### Supported Output Formats
 
@@ -3398,6 +3456,7 @@ output formats.  The specific file type is controlled with `bookType` option:
 | `biff3`    | `.xls`   |   none    | single | Excel 3.0 Worksheet Format      |
 | `biff2`    | `.xls`   |   none    | single | Excel 2.0 Worksheet Format      |
 | `xlml`     | `.xls`   |   none    | multi  | Excel 2003-2004 (SpreadsheetML) |
+| `numbers`  |`.numbers`|    ZIP    | single | Numbers 3.0+ Spreadsheet        |
 | `ods`      | `.ods`   |    ZIP    | multi  | OpenDocument Spreadsheet        |
 | `fods`     | `.fods`  |   none    | multi  | Flat OpenDocument Spreadsheet   |
 | `wk3`      | `.wk3`   |   none    | multi  | Lotus Workbook (WK3)            |
@@ -3950,7 +4009,7 @@ Despite the library name `xlsx`, it supports numerous spreadsheet file formats:
 | Lotus Formatted Text (PRN)                                   |   ✔   |   ✔   |
 | UTF-16 Unicode Text (TXT)                                    |   ✔   |   ✔   |
 | **Other Workbook/Worksheet Formats**                         |:-----:|:-----:|
-| Numbers 3.0+ / iWork 2013+ Spreadsheet (NUMBERS)             |   ✔   |       |
+| Numbers 3.0+ / iWork 2013+ Spreadsheet (NUMBERS)             |   ✔   |   ✔   |
 | OpenDocument Spreadsheet (ODS)                               |   ✔   |   ✔   |
 | Flat XML ODF Spreadsheet (FODS)                              |   ✔   |   ✔   |
 | Uniform Office Format Spreadsheet (标文通 UOS1/UOS2)         |   ✔   |       |
@@ -4099,6 +4158,8 @@ The parser focuses on extracting raw data from tables.  Numbers technically
 supports multiple tables in a logical worksheet, including custom titles.  This
 parser will generate one worksheet per Numbers table.
 
+The writer currently exports a small range from the first worksheet.
+
 - **OpenDocument Spreadsheet (ODS/FODS)**
 
 ODS is an XML-in-ZIP format akin to XLSX while FODS is an XML format akin to

bin/xlsx.njs

@@ -44,6 +44,7 @@ program
 	.option('-6, --xlml', 'emit SSML to <sheetname> or <file>.xls (2003 XML)')
 	.option('-T, --fods', 'emit FODS to <sheetname> or <file>.fods (Flat ODS)')
 	.option('--wk3',      'emit WK3  to <sheetname> or <file>.txt (Lotus WK3)')
+	.option('--numbers',  'emit NUMBERS to <sheetname> or <file>.numbers')
 
 	.option('-S, --formulae', 'emit list of values and formulae')
 	.option('-j, --json',     'emit formatted JSON (all fields text)')
@@ -90,6 +91,7 @@ var workbook_formats = [
 	['xls',     'xls',  'xls'],
 	['xla',     'xla',  'xla'],
 	['biff5', 'biff5',  'xls'],
+	['numbers', 'numbers', 'numbers'],
 	['ods',     'ods',  'ods'],
 	['fods',   'fods', 'fods'],
 	['wk3',     'wk3',  'wk3']
@@ -192,6 +194,10 @@ if(program.props) {
 /* full workbook formats */
 workbook_formats.forEach(function(m) { if(program[m[0]] || isfmt(m[0])) {
 		wopts.bookType = m[1];
+		if(wopts.bookType == "numbers") try {
+			var XLSX_ZAHL = require("../dist/xlsx.zahl");
+			wopts.numbers = XLSX_ZAHL;
+		} catch(e) {}
 		if(wb) X.writeFile(wb, program.output || sheetname || ((filename || "") + "." + m[2]), wopts);
 		process.exit(0);
 } });

bits/01_version.js

@@ -1 +1 @@
-XLSX.version = '0.18.4';
+XLSX.version = '0.18.5';