xls-codec 1.0.2 → 2.0.0

package/dist/biff/errors.js

@@ -13,5 +13,11 @@ const ERROR_TEXT = /* @__PURE__ */ new Map([
 function errorTextOf(code) {
 	return ERROR_TEXT.get(code);
 }
+/** The write direction's own lookup, built once from ERROR_TEXT rather than as a second hand-maintained table, so the two directions cannot drift apart. */
+const ERROR_CODE = new Map(Array.from(ERROR_TEXT, ([code, text]) => [text, code]));
+/** The BIFF8 error code for a cell's displayed error text, or undefined when the text is not one of the eight [MS-XLS] defines -- which the writer refuses to guess a code for rather than silently substituting a different error. */
+function errorCodeOf(text) {
+	return ERROR_CODE.get(text);
+}
 //#endregion
-export { errorTextOf };
+export { errorCodeOf, errorTextOf };

package/dist/biff/print-setup.cjs

@@ -0,0 +1,108 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_units = require("../units.cjs");
+//#region src/biff/print-setup.ts
+/** Setup.grbit's own bit assignments ([MS-XLS] 2.4.257's fields A through L, in the order that section lists them: fLeftToRight, fPortrait, fNoPls, fNoColor, fDraft, fNotes, fNoOrient, fUsePage, unused1, fEndNotes, iErrors (2 bits), reserved (4 bits)). Only the four this package acts on are named. */
+const SETUP_FLAG_LEFT_TO_RIGHT = 1;
+const SETUP_FLAG_PORTRAIT = 2;
+const SETUP_FLAG_NO_PLS = 4;
+const SETUP_FLAG_NO_ORIENT = 64;
+/** WsBool's own fFitToPage bit -- field G of [MS-XLS] 2.4.351, the ninth bit of its single 16-bit field (fShowAutoBreaks, reserved1 (3 bits), fDialog, fApplyStyles, fRowSumsBelow, fColSumsRight, fFitToPage, ...). */
+const WSBOOL_FLAG_FIT_TO_PAGE = 256;
+/** Packs a SetupFields' own four flags back into the record's grbit word. Every bit this package does not model is written as zero, which is what [MS-XLS] 2.4.257's own reserved field requires and what its remaining optional behaviours (black-and-white, draft quality, comment printing, error rendering, a custom starting page number) default to. */
+function packSetupFlags(fields) {
+	return (fields.leftToRight ? SETUP_FLAG_LEFT_TO_RIGHT : 0) | (fields.portrait ? SETUP_FLAG_PORTRAIT : 0) | (fields.noPls ? SETUP_FLAG_NO_PLS : 0) | (fields.noOrientation ? SETUP_FLAG_NO_ORIENT : 0);
+}
+/** The read-side inverse of packSetupFlags: the four flags this package acts on, taken out of the record's grbit word. */
+function unpackSetupFlags(grbit) {
+	return {
+		leftToRight: (grbit & SETUP_FLAG_LEFT_TO_RIGHT) !== 0,
+		portrait: (grbit & SETUP_FLAG_PORTRAIT) !== 0,
+		noPls: (grbit & SETUP_FLAG_NO_PLS) !== 0,
+		noOrientation: (grbit & SETUP_FLAG_NO_ORIENT) !== 0
+	};
+}
+/**
+* The page size a Setup record's own iPaperSize and orientation flags describe, or undefined when the code is not one this package maps.
+*
+* A paper code names the sheet's paper in its PORTRAIT dimensions regardless of how the sheet actually prints, so the orientation flags decide whether those dimensions are used as-is or transposed. [MS-XLS] 2.4.257 defines that in two steps: fNoOrient set means "Pages are printed using portrait mode" outright, and only when it is clear does fPortrait itself select portrait (1) or landscape (0).
+*/
+function pageSizeFromSetup(fields) {
+	const portraitSize = PAPER_SIZE_BY_CODE.get(fields.paperCode);
+	if (portraitSize === void 0) return;
+	return fields.noOrientation || fields.portrait ? portraitSize : {
+		widthPt: portraitSize.heightPt,
+		heightPt: portraitSize.widthPt
+	};
+}
+/** How close two page dimensions must be, in points, to count as the same paper. Half a point is about 0.18mm -- far below any real paper-size difference, and wide enough to absorb the hundredth-of-a-point rounding the table below applies and the unit conversions a page size picks up crossing between codecs. The same tolerance ooxml.js's own pageSizeToPaperSizeCode uses for the identical decision on xlsx's paperSize attribute. */
+const PAPER_SIZE_TOLERANCE_PT = .5;
+/**
+* The write-side inverse of pageSizeFromSetup: the paper code and orientation whose resolved page size matches this one, or undefined when no code in the table does.
+*
+* Undefined is a real answer with no fallback behind it. Unlike xlsx's own pageSetup element, which can state an explicit paperWidth/paperHeight pair when no code fits, [MS-XLS] 2.4.257's Setup record addresses paper only by code -- its own escape hatch for a size outside the table is a printer-defined custom size carried in a separate Pls record ([MS-XLS] 2.4.199), a printer driver's opaque DEVMODE blob rather than a pair of dimensions any reader could recover the size from. So a page size no code names genuinely cannot be written; the caller refuses rather than silently substituting a paper the document never asked for.
+*
+* A portrait match is preferred over a landscape one wherever both exist, which is what keeps the choice deterministic for the handful of codes in the table that are each other's transpose (US Tabloid 11x17in and US Ledger 17x11in are the same sheet of paper entered twice, once each way round).
+*/
+function paperSelectionFor(pageSize) {
+	for (const [code, paper] of PAPER_SIZE_BY_CODE) if (matches(pageSize.widthPt, paper.widthPt) && matches(pageSize.heightPt, paper.heightPt)) return {
+		code,
+		portrait: true
+	};
+	for (const [code, paper] of PAPER_SIZE_BY_CODE) if (matches(pageSize.widthPt, paper.heightPt) && matches(pageSize.heightPt, paper.widthPt)) return {
+		code,
+		portrait: false
+	};
+}
+function matches(a, b) {
+	return Math.abs(a - b) <= PAPER_SIZE_TOLERANCE_PT;
+}
+/** Rounded to hundredths of a point, which is how document-schema.js spells its own PAGE_SIZE_A4 (595.28 x 841.89 pt, the same 210 x 297 mm converted the same way). Rounding here rather than carrying the full conversion is what makes a code-9 page size read out of a real file EQUAL that shared constant instead of merely being within a rounding error of it. */
+function roundToHundredths(value) {
+	return Math.round(value * 100) / 100;
+}
+function inchPaper(widthIn, heightIn) {
+	return {
+		widthPt: roundToHundredths(require_units.inchesToPoints(widthIn)),
+		heightPt: roundToHundredths(require_units.inchesToPoints(heightIn))
+	};
+}
+function millimetrePaper(widthMm, heightMm) {
+	return {
+		widthPt: roundToHundredths(require_units.millimetresToPoints(widthMm)),
+		heightPt: roundToHundredths(require_units.millimetresToPoints(heightMm))
+	};
+}
+/**
+* Setup.iPaperSize's own code table ([MS-XLS] 2.4.257), restricted to the codes whose entry states a real, unambiguous sheet size in inches or millimetres, and with each size derived from those stated dimensions rather than from a table of pre-converted points.
+*
+* The full enumeration runs to 118 entries, most of them envelopes, rotated variants, and regional stationery sizes; the ones here are the office paper sizes a spreadsheet is realistically printed on, entered exactly as [MS-XLS]'s own table names them. A code outside this table -- including 0 and everything at 256 or above, which the spec reserves for "custom printer paper sizes" no reader can resolve without the printer's own Pls record -- resolves to no page size at all, and content.ts falls back to its documented default rather than guessing a size the file never stated.
+*/
+const PAPER_SIZE_BY_CODE = /* @__PURE__ */ new Map([
+	[1, inchPaper(8.5, 11)],
+	[2, inchPaper(8.5, 11)],
+	[3, inchPaper(11, 17)],
+	[4, inchPaper(17, 11)],
+	[5, inchPaper(8.5, 14)],
+	[6, inchPaper(5.5, 8.5)],
+	[7, inchPaper(7.25, 10.5)],
+	[8, millimetrePaper(297, 420)],
+	[9, millimetrePaper(210, 297)],
+	[10, millimetrePaper(210, 297)],
+	[11, millimetrePaper(148, 210)],
+	[12, millimetrePaper(250, 354)],
+	[13, millimetrePaper(182, 257)],
+	[14, inchPaper(8.5, 13)],
+	[15, millimetrePaper(215, 275)],
+	[16, inchPaper(10, 14)],
+	[17, inchPaper(11, 17)],
+	[18, inchPaper(8.5, 11)],
+	[42, millimetrePaper(250, 353)],
+	[66, millimetrePaper(420, 594)],
+	[70, millimetrePaper(105, 148)]
+]);
+//#endregion
+exports.WSBOOL_FLAG_FIT_TO_PAGE = WSBOOL_FLAG_FIT_TO_PAGE;
+exports.packSetupFlags = packSetupFlags;
+exports.pageSizeFromSetup = pageSizeFromSetup;
+exports.paperSelectionFor = paperSelectionFor;
+exports.unpackSetupFlags = unpackSetupFlags;

package/dist/biff/print-setup.d.cts

@@ -0,0 +1,2 @@
+import { a as pageSizeFromSetup, i as packSetupFlags, n as SetupFields, o as paperSelectionFor, r as WSBOOL_FLAG_FIT_TO_PAGE, s as unpackSetupFlags, t as PaperSelection } from "../print-setup-B_ihDvm5.cjs";
+export { PaperSelection, SetupFields, WSBOOL_FLAG_FIT_TO_PAGE, packSetupFlags, pageSizeFromSetup, paperSelectionFor, unpackSetupFlags };

package/dist/biff/print-setup.d.ts

@@ -0,0 +1,2 @@
+import { a as pageSizeFromSetup, i as packSetupFlags, n as SetupFields, o as paperSelectionFor, r as WSBOOL_FLAG_FIT_TO_PAGE, s as unpackSetupFlags, t as PaperSelection } from "../print-setup-B_ihDvm5.js";
+export { PaperSelection, SetupFields, WSBOOL_FLAG_FIT_TO_PAGE, packSetupFlags, pageSizeFromSetup, paperSelectionFor, unpackSetupFlags };

package/dist/biff/print-setup.js

@@ -0,0 +1,103 @@
+import { inchesToPoints, millimetresToPoints } from "../units.js";
+//#region src/biff/print-setup.ts
+/** Setup.grbit's own bit assignments ([MS-XLS] 2.4.257's fields A through L, in the order that section lists them: fLeftToRight, fPortrait, fNoPls, fNoColor, fDraft, fNotes, fNoOrient, fUsePage, unused1, fEndNotes, iErrors (2 bits), reserved (4 bits)). Only the four this package acts on are named. */
+const SETUP_FLAG_LEFT_TO_RIGHT = 1;
+const SETUP_FLAG_PORTRAIT = 2;
+const SETUP_FLAG_NO_PLS = 4;
+const SETUP_FLAG_NO_ORIENT = 64;
+/** WsBool's own fFitToPage bit -- field G of [MS-XLS] 2.4.351, the ninth bit of its single 16-bit field (fShowAutoBreaks, reserved1 (3 bits), fDialog, fApplyStyles, fRowSumsBelow, fColSumsRight, fFitToPage, ...). */
+const WSBOOL_FLAG_FIT_TO_PAGE = 256;
+/** Packs a SetupFields' own four flags back into the record's grbit word. Every bit this package does not model is written as zero, which is what [MS-XLS] 2.4.257's own reserved field requires and what its remaining optional behaviours (black-and-white, draft quality, comment printing, error rendering, a custom starting page number) default to. */
+function packSetupFlags(fields) {
+	return (fields.leftToRight ? SETUP_FLAG_LEFT_TO_RIGHT : 0) | (fields.portrait ? SETUP_FLAG_PORTRAIT : 0) | (fields.noPls ? SETUP_FLAG_NO_PLS : 0) | (fields.noOrientation ? SETUP_FLAG_NO_ORIENT : 0);
+}
+/** The read-side inverse of packSetupFlags: the four flags this package acts on, taken out of the record's grbit word. */
+function unpackSetupFlags(grbit) {
+	return {
+		leftToRight: (grbit & SETUP_FLAG_LEFT_TO_RIGHT) !== 0,
+		portrait: (grbit & SETUP_FLAG_PORTRAIT) !== 0,
+		noPls: (grbit & SETUP_FLAG_NO_PLS) !== 0,
+		noOrientation: (grbit & SETUP_FLAG_NO_ORIENT) !== 0
+	};
+}
+/**
+* The page size a Setup record's own iPaperSize and orientation flags describe, or undefined when the code is not one this package maps.
+*
+* A paper code names the sheet's paper in its PORTRAIT dimensions regardless of how the sheet actually prints, so the orientation flags decide whether those dimensions are used as-is or transposed. [MS-XLS] 2.4.257 defines that in two steps: fNoOrient set means "Pages are printed using portrait mode" outright, and only when it is clear does fPortrait itself select portrait (1) or landscape (0).
+*/
+function pageSizeFromSetup(fields) {
+	const portraitSize = PAPER_SIZE_BY_CODE.get(fields.paperCode);
+	if (portraitSize === void 0) return;
+	return fields.noOrientation || fields.portrait ? portraitSize : {
+		widthPt: portraitSize.heightPt,
+		heightPt: portraitSize.widthPt
+	};
+}
+/** How close two page dimensions must be, in points, to count as the same paper. Half a point is about 0.18mm -- far below any real paper-size difference, and wide enough to absorb the hundredth-of-a-point rounding the table below applies and the unit conversions a page size picks up crossing between codecs. The same tolerance ooxml.js's own pageSizeToPaperSizeCode uses for the identical decision on xlsx's paperSize attribute. */
+const PAPER_SIZE_TOLERANCE_PT = .5;
+/**
+* The write-side inverse of pageSizeFromSetup: the paper code and orientation whose resolved page size matches this one, or undefined when no code in the table does.
+*
+* Undefined is a real answer with no fallback behind it. Unlike xlsx's own pageSetup element, which can state an explicit paperWidth/paperHeight pair when no code fits, [MS-XLS] 2.4.257's Setup record addresses paper only by code -- its own escape hatch for a size outside the table is a printer-defined custom size carried in a separate Pls record ([MS-XLS] 2.4.199), a printer driver's opaque DEVMODE blob rather than a pair of dimensions any reader could recover the size from. So a page size no code names genuinely cannot be written; the caller refuses rather than silently substituting a paper the document never asked for.
+*
+* A portrait match is preferred over a landscape one wherever both exist, which is what keeps the choice deterministic for the handful of codes in the table that are each other's transpose (US Tabloid 11x17in and US Ledger 17x11in are the same sheet of paper entered twice, once each way round).
+*/
+function paperSelectionFor(pageSize) {
+	for (const [code, paper] of PAPER_SIZE_BY_CODE) if (matches(pageSize.widthPt, paper.widthPt) && matches(pageSize.heightPt, paper.heightPt)) return {
+		code,
+		portrait: true
+	};
+	for (const [code, paper] of PAPER_SIZE_BY_CODE) if (matches(pageSize.widthPt, paper.heightPt) && matches(pageSize.heightPt, paper.widthPt)) return {
+		code,
+		portrait: false
+	};
+}
+function matches(a, b) {
+	return Math.abs(a - b) <= PAPER_SIZE_TOLERANCE_PT;
+}
+/** Rounded to hundredths of a point, which is how document-schema.js spells its own PAGE_SIZE_A4 (595.28 x 841.89 pt, the same 210 x 297 mm converted the same way). Rounding here rather than carrying the full conversion is what makes a code-9 page size read out of a real file EQUAL that shared constant instead of merely being within a rounding error of it. */
+function roundToHundredths(value) {
+	return Math.round(value * 100) / 100;
+}
+function inchPaper(widthIn, heightIn) {
+	return {
+		widthPt: roundToHundredths(inchesToPoints(widthIn)),
+		heightPt: roundToHundredths(inchesToPoints(heightIn))
+	};
+}
+function millimetrePaper(widthMm, heightMm) {
+	return {
+		widthPt: roundToHundredths(millimetresToPoints(widthMm)),
+		heightPt: roundToHundredths(millimetresToPoints(heightMm))
+	};
+}
+/**
+* Setup.iPaperSize's own code table ([MS-XLS] 2.4.257), restricted to the codes whose entry states a real, unambiguous sheet size in inches or millimetres, and with each size derived from those stated dimensions rather than from a table of pre-converted points.
+*
+* The full enumeration runs to 118 entries, most of them envelopes, rotated variants, and regional stationery sizes; the ones here are the office paper sizes a spreadsheet is realistically printed on, entered exactly as [MS-XLS]'s own table names them. A code outside this table -- including 0 and everything at 256 or above, which the spec reserves for "custom printer paper sizes" no reader can resolve without the printer's own Pls record -- resolves to no page size at all, and content.ts falls back to its documented default rather than guessing a size the file never stated.
+*/
+const PAPER_SIZE_BY_CODE = /* @__PURE__ */ new Map([
+	[1, inchPaper(8.5, 11)],
+	[2, inchPaper(8.5, 11)],
+	[3, inchPaper(11, 17)],
+	[4, inchPaper(17, 11)],
+	[5, inchPaper(8.5, 14)],
+	[6, inchPaper(5.5, 8.5)],
+	[7, inchPaper(7.25, 10.5)],
+	[8, millimetrePaper(297, 420)],
+	[9, millimetrePaper(210, 297)],
+	[10, millimetrePaper(210, 297)],
+	[11, millimetrePaper(148, 210)],
+	[12, millimetrePaper(250, 354)],
+	[13, millimetrePaper(182, 257)],
+	[14, inchPaper(8.5, 13)],
+	[15, millimetrePaper(215, 275)],
+	[16, inchPaper(10, 14)],
+	[17, inchPaper(11, 17)],
+	[18, inchPaper(8.5, 11)],
+	[42, millimetrePaper(250, 353)],
+	[66, millimetrePaper(420, 594)],
+	[70, millimetrePaper(105, 148)]
+]);
+//#endregion
+export { WSBOOL_FLAG_FIT_TO_PAGE, packSetupFlags, pageSizeFromSetup, paperSelectionFor, unpackSetupFlags };

package/dist/biff/ptg-functions.cjs

@@ -0,0 +1,383 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/biff/ptg-functions.ts
+const FTAB_ENTRIES = [
+	[0, ["COUNT"]],
+	[1, ["IF"]],
+	[2, ["ISNA", 1]],
+	[3, ["ISERROR", 1]],
+	[4, ["SUM"]],
+	[5, ["AVERAGE"]],
+	[6, ["MIN"]],
+	[7, ["MAX"]],
+	[8, ["ROW"]],
+	[9, ["COLUMN"]],
+	[10, ["NA", 0]],
+	[11, ["NPV"]],
+	[12, ["STDEV"]],
+	[13, ["DOLLAR"]],
+	[14, ["FIXED"]],
+	[15, ["SIN", 1]],
+	[16, ["COS", 1]],
+	[17, ["TAN", 1]],
+	[18, ["ATAN", 1]],
+	[19, ["PI", 0]],
+	[20, ["SQRT", 1]],
+	[21, ["EXP", 1]],
+	[22, ["LN", 1]],
+	[23, ["LOG10", 1]],
+	[24, ["ABS", 1]],
+	[25, ["INT", 1]],
+	[26, ["SIGN", 1]],
+	[27, ["ROUND", 2]],
+	[28, ["LOOKUP"]],
+	[29, ["INDEX"]],
+	[30, ["REPT", 2]],
+	[31, ["MID", 3]],
+	[32, ["LEN", 1]],
+	[33, ["VALUE", 1]],
+	[34, ["TRUE", 0]],
+	[35, ["FALSE", 0]],
+	[36, ["AND"]],
+	[37, ["OR"]],
+	[38, ["NOT", 1]],
+	[39, ["MOD", 2]],
+	[40, ["DCOUNT", 3]],
+	[41, ["DSUM", 3]],
+	[42, ["DAVERAGE", 3]],
+	[43, ["DMIN", 3]],
+	[44, ["DMAX", 3]],
+	[45, ["DSTDEV", 3]],
+	[46, ["VAR"]],
+	[47, ["DVAR", 3]],
+	[48, ["TEXT", 2]],
+	[49, ["LINEST"]],
+	[50, ["TREND"]],
+	[51, ["LOGEST"]],
+	[52, ["GROWTH"]],
+	[53, ["GOTO", 1]],
+	[54, ["HALT"]],
+	[55, ["RETURN"]],
+	[56, ["PV"]],
+	[57, ["FV"]],
+	[58, ["NPER"]],
+	[59, ["PMT"]],
+	[60, ["RATE"]],
+	[61, ["MIRR", 3]],
+	[62, ["IRR"]],
+	[63, ["RAND", 0]],
+	[64, ["MATCH"]],
+	[65, ["DATE", 3]],
+	[66, ["TIME", 3]],
+	[67, ["DAY", 1]],
+	[68, ["MONTH", 1]],
+	[69, ["YEAR", 1]],
+	[70, ["WEEKDAY"]],
+	[71, ["HOUR", 1]],
+	[72, ["MINUTE", 1]],
+	[73, ["SECOND", 1]],
+	[74, ["NOW", 0]],
+	[75, ["AREAS", 1]],
+	[76, ["ROWS", 1]],
+	[77, ["COLUMNS", 1]],
+	[78, ["OFFSET"]],
+	[79, ["ABSREF", 2]],
+	[80, ["RELREF", 2]],
+	[81, ["ARGUMENT"]],
+	[82, ["SEARCH"]],
+	[83, ["TRANSPOSE", 1]],
+	[84, ["ERROR"]],
+	[85, ["STEP", 0]],
+	[86, ["TYPE", 1]],
+	[87, ["ECHO"]],
+	[88, ["SET.NAME"]],
+	[89, ["CALLER", 0]],
+	[90, ["DEREF", 1]],
+	[91, ["WINDOWS"]],
+	[92, ["SERIES"]],
+	[93, ["DOCUMENTS"]],
+	[94, ["ACTIVE.CELL", 0]],
+	[95, ["SELECTION", 0]],
+	[96, ["RESULT"]],
+	[97, ["ATAN2", 2]],
+	[98, ["ASIN", 1]],
+	[99, ["ACOS", 1]],
+	[100, ["CHOOSE"]],
+	[101, ["HLOOKUP"]],
+	[102, ["VLOOKUP"]],
+	[103, ["LINKS"]],
+	[104, ["INPUT"]],
+	[105, ["ISREF", 1]],
+	[106, ["GET.FORMULA", 1]],
+	[107, ["GET.NAME"]],
+	[108, ["SET.VALUE", 2]],
+	[109, ["LOG"]],
+	[110, ["EXEC"]],
+	[111, ["CHAR", 1]],
+	[112, ["LOWER", 1]],
+	[113, ["UPPER", 1]],
+	[114, ["PROPER", 1]],
+	[115, ["LEFT"]],
+	[116, ["RIGHT"]],
+	[117, ["EXACT", 2]],
+	[118, ["TRIM", 1]],
+	[119, ["REPLACE", 4]],
+	[120, ["SUBSTITUTE"]],
+	[121, ["CODE", 1]],
+	[122, ["NAMES"]],
+	[123, ["DIRECTORY"]],
+	[124, ["FIND"]],
+	[125, ["CELL"]],
+	[126, ["ISERR", 1]],
+	[127, ["ISTEXT", 1]],
+	[128, ["ISNUMBER", 1]],
+	[129, ["ISBLANK", 1]],
+	[130, ["T", 1]],
+	[131, ["N", 1]],
+	[132, ["FOPEN"]],
+	[133, ["FCLOSE", 1]],
+	[134, ["FSIZE", 1]],
+	[135, ["FREADLN", 1]],
+	[136, ["FREAD", 2]],
+	[137, ["FWRITELN", 2]],
+	[138, ["FWRITE", 2]],
+	[139, ["FPOS"]],
+	[140, ["DATEVALUE", 1]],
+	[141, ["TIMEVALUE", 1]],
+	[142, ["SLN", 3]],
+	[143, ["SYD", 4]],
+	[144, ["DDB"]],
+	[145, ["GET.DEF"]],
+	[146, ["REFTEXT"]],
+	[147, ["TEXTREF"]],
+	[148, ["INDIRECT"]],
+	[149, ["REGISTER"]],
+	[150, ["CALL"]],
+	[151, ["ADD.BAR"]],
+	[152, ["ADD.MENU"]],
+	[153, ["ADD.COMMAND"]],
+	[154, ["ENABLE.COMMAND"]],
+	[155, ["CHECK.COMMAND"]],
+	[156, ["RENAME.COMMAND"]],
+	[157, ["SHOW.BAR"]],
+	[158, ["DELETE.MENU"]],
+	[159, ["DELETE.COMMAND"]],
+	[160, ["GET.CHART.ITEM"]],
+	[161, ["DIALOG.BOX", 1]],
+	[162, ["CLEAN", 1]],
+	[163, ["MDETERM", 1]],
+	[164, ["MINVERSE", 1]],
+	[165, ["MMULT", 2]],
+	[166, ["FILES"]],
+	[167, ["IPMT"]],
+	[168, ["PPMT"]],
+	[169, ["COUNTA"]],
+	[170, ["CANCEL.KEY"]],
+	[171, ["FOR"]],
+	[172, ["WHILE", 1]],
+	[173, ["BREAK", 0]],
+	[174, ["NEXT", 0]],
+	[175, ["INITIATE", 2]],
+	[176, ["REQUEST", 2]],
+	[177, ["POKE", 3]],
+	[178, ["EXECUTE", 2]],
+	[179, ["TERMINATE", 1]],
+	[180, ["RESTART"]],
+	[181, ["HELP"]],
+	[182, ["GET.BAR"]],
+	[183, ["PRODUCT"]],
+	[184, ["FACT", 1]],
+	[185, ["GET.CELL"]],
+	[186, ["GET.WORKSPACE", 1]],
+	[187, ["GET.WINDOW"]],
+	[188, ["GET.DOCUMENT"]],
+	[189, ["DPRODUCT", 3]],
+	[190, ["ISNONTEXT", 1]],
+	[191, ["GET.NOTE"]],
+	[192, ["NOTE"]],
+	[193, ["STDEVP"]],
+	[194, ["VARP"]],
+	[195, ["DSTDEVP", 3]],
+	[196, ["DVARP", 3]],
+	[197, ["TRUNC"]],
+	[198, ["ISLOGICAL", 1]],
+	[199, ["DCOUNTA", 3]],
+	[200, ["DELETE.BAR", 1]],
+	[201, ["UNREGISTER", 1]],
+	[204, ["USDOLLAR"]],
+	[205, ["FINDB"]],
+	[206, ["SEARCHB"]],
+	[207, ["REPLACEB", 4]],
+	[208, ["LEFTB"]],
+	[209, ["RIGHTB"]],
+	[210, ["MIDB", 3]],
+	[211, ["LENB", 1]],
+	[212, ["ROUNDUP", 2]],
+	[213, ["ROUNDDOWN", 2]],
+	[214, ["ASC", 1]],
+	[215, ["DBCS", 1]],
+	[216, ["RANK"]],
+	[219, ["ADDRESS"]],
+	[220, ["DAYS360"]],
+	[221, ["TODAY", 0]],
+	[222, ["VDB"]],
+	[223, ["ELSE", 0]],
+	[224, ["ELSE.IF", 1]],
+	[225, ["END.IF", 0]],
+	[226, ["FOR.CELL"]],
+	[227, ["MEDIAN"]],
+	[228, ["SUMPRODUCT"]],
+	[229, ["SINH", 1]],
+	[230, ["COSH", 1]],
+	[231, ["TANH", 1]],
+	[232, ["ASINH", 1]],
+	[233, ["ACOSH", 1]],
+	[234, ["ATANH", 1]],
+	[235, ["DGET", 3]],
+	[236, ["CREATE.OBJECT"]],
+	[237, ["VOLATILE"]],
+	[238, ["LAST.ERROR", 0]],
+	[239, ["CUSTOM.UNDO"]],
+	[240, ["CUSTOM.REPEAT"]],
+	[241, ["FORMULA.CONVERT"]],
+	[242, ["GET.LINK.INFO"]],
+	[243, ["TEXT.BOX"]],
+	[244, ["INFO", 1]],
+	[245, ["GROUP", 0]],
+	[246, ["GET.OBJECT"]],
+	[247, ["DB"]],
+	[248, ["PAUSE"]],
+	[251, ["RESUME"]],
+	[252, ["FREQUENCY", 2]],
+	[253, ["ADD.TOOLBAR"]],
+	[254, ["DELETE.TOOLBAR", 1]],
+	[256, ["RESET.TOOLBAR", 1]],
+	[257, ["EVALUATE", 1]],
+	[258, ["GET.TOOLBAR"]],
+	[259, ["GET.TOOL"]],
+	[260, ["SPELLING.CHECK"]],
+	[261, ["ERROR.TYPE", 1]],
+	[262, ["APP.TITLE"]],
+	[263, ["WINDOW.TITLE"]],
+	[264, ["SAVE.TOOLBAR"]],
+	[265, ["ENABLE.TOOL", 3]],
+	[266, ["PRESS.TOOL", 3]],
+	[267, ["REGISTER.ID"]],
+	[268, ["GET.WORKBOOK"]],
+	[269, ["AVEDEV"]],
+	[270, ["BETADIST"]],
+	[271, ["GAMMALN", 1]],
+	[272, ["BETAINV"]],
+	[273, ["BINOMDIST", 4]],
+	[274, ["CHIDIST", 2]],
+	[275, ["CHIINV", 2]],
+	[276, ["COMBIN", 2]],
+	[277, ["CONFIDENCE", 3]],
+	[278, ["CRITBINOM", 3]],
+	[279, ["EVEN", 1]],
+	[280, ["EXPONDIST", 3]],
+	[281, ["FDIST", 3]],
+	[282, ["FINV", 3]],
+	[283, ["FISHER", 1]],
+	[284, ["FISHERINV", 1]],
+	[285, ["FLOOR", 2]],
+	[286, ["GAMMADIST", 4]],
+	[287, ["GAMMAINV", 3]],
+	[288, ["CEILING", 2]],
+	[289, ["HYPGEOMDIST", 4]],
+	[290, ["LOGNORMDIST", 3]],
+	[291, ["LOGINV", 3]],
+	[292, ["NEGBINOMDIST", 3]],
+	[293, ["NORMDIST", 4]],
+	[294, ["NORMSDIST", 1]],
+	[295, ["NORMINV", 3]],
+	[296, ["NORMSINV", 1]],
+	[297, ["STANDARDIZE", 3]],
+	[298, ["ODD", 1]],
+	[299, ["PERMUT", 2]],
+	[300, ["POISSON", 3]],
+	[301, ["TDIST", 3]],
+	[302, ["WEIBULL", 4]],
+	[303, ["SUMXMY2", 2]],
+	[304, ["SUMX2MY2", 2]],
+	[305, ["SUMX2PY2", 2]],
+	[306, ["CHITEST", 2]],
+	[307, ["CORREL", 2]],
+	[308, ["COVAR", 2]],
+	[309, ["FORECAST", 3]],
+	[310, ["FTEST", 2]],
+	[311, ["INTERCEPT", 2]],
+	[312, ["PEARSON", 2]],
+	[313, ["RSQ", 2]],
+	[314, ["STEYX", 2]],
+	[315, ["SLOPE", 2]],
+	[316, ["TTEST", 4]],
+	[317, ["PROB"]],
+	[318, ["DEVSQ"]],
+	[319, ["GEOMEAN"]],
+	[320, ["HARMEAN"]],
+	[321, ["SUMSQ"]],
+	[322, ["KURT"]],
+	[323, ["SKEW"]],
+	[324, ["ZTEST"]],
+	[325, ["LARGE", 2]],
+	[326, ["SMALL", 2]],
+	[327, ["QUARTILE", 2]],
+	[328, ["PERCENTILE", 2]],
+	[329, ["PERCENTRANK"]],
+	[330, ["MODE"]],
+	[331, ["TRIMMEAN", 2]],
+	[332, ["TINV", 2]],
+	[334, ["MOVIE.COMMAND"]],
+	[335, ["GET.MOVIE"]],
+	[336, ["CONCATENATE"]],
+	[337, ["POWER", 2]],
+	[338, ["PIVOT.ADD.DATA"]],
+	[339, ["GET.PIVOT.TABLE"]],
+	[340, ["GET.PIVOT.FIELD"]],
+	[341, ["GET.PIVOT.ITEM"]],
+	[342, ["RADIANS", 1]],
+	[343, ["DEGREES", 1]],
+	[344, ["SUBTOTAL"]],
+	[345, ["SUMIF"]],
+	[346, ["COUNTIF", 2]],
+	[347, ["COUNTBLANK", 1]],
+	[348, ["SCENARIO.GET"]],
+	[349, ["OPTIONS.LISTS.GET", 1]],
+	[350, ["ISPMT", 4]],
+	[351, ["DATEDIF", 3]],
+	[352, ["DATESTRING", 1]],
+	[353, ["NUMBERSTRING", 2]],
+	[354, ["ROMAN"]],
+	[355, ["OPEN.DIALOG"]],
+	[356, ["SAVE.DIALOG"]],
+	[357, ["VIEW.GET"]],
+	[358, ["GETPIVOTDATA"]],
+	[359, ["HYPERLINK"]],
+	[360, ["PHONETIC", 1]],
+	[361, ["AVERAGEA"]],
+	[362, ["MAXA"]],
+	[363, ["MINA"]],
+	[364, ["STDEVPA"]],
+	[365, ["VARPA"]],
+	[366, ["STDEVA"]],
+	[367, ["VARA"]],
+	[368, ["BAHTTEXT", 1]],
+	[369, ["THAIDAYOFWEEK", 1]],
+	[370, ["THAIDIGIT", 1]],
+	[371, ["THAIMONTHOFYEAR", 1]],
+	[372, ["THAINUMSOUND", 1]],
+	[373, ["THAINUMSTRING", 1]],
+	[374, ["THAISTRINGLENGTH", 1]],
+	[375, ["ISTHAIDIGIT", 1]],
+	[376, ["ROUNDBAHTDOWN", 1]],
+	[377, ["ROUNDBAHTUP", 1]],
+	[378, ["THAIYEAR", 1]],
+	[379, ["RTD"]]
+];
+/** A function's displayed name, by its Ftab index -- consulted for both PtgFunc and PtgFuncVar. */
+const FTAB_NAMES = new Map(FTAB_ENTRIES.map(([iftab, [name]]) => [iftab, name]));
+/** A function's fixed argument count, by its Ftab index -- consulted only for PtgFunc, whose own token carries no count. Absent for every entry [MS-XLS]'s grammar gives an optional or repeated argument, which is never resolved through PtgFunc in practice (see the module comment). */
+const FTAB_FIXED_ARITY = new Map(FTAB_ENTRIES.filter((entry) => entry[1][1] !== void 0).map(([iftab, [, arity]]) => [iftab, arity]));
+//#endregion
+exports.FTAB_FIXED_ARITY = FTAB_FIXED_ARITY;
+exports.FTAB_NAMES = FTAB_NAMES;

package/dist/biff/ptg-functions.d.cts

@@ -0,0 +1,7 @@
+//#region src/biff/ptg-functions.d.ts
+/** A function's displayed name, by its Ftab index -- consulted for both PtgFunc and PtgFuncVar. */
+declare const FTAB_NAMES: ReadonlyMap<number, string>;
+/** A function's fixed argument count, by its Ftab index -- consulted only for PtgFunc, whose own token carries no count. Absent for every entry [MS-XLS]'s grammar gives an optional or repeated argument, which is never resolved through PtgFunc in practice (see the module comment). */
+declare const FTAB_FIXED_ARITY: ReadonlyMap<number, number>;
+//#endregion
+export { FTAB_FIXED_ARITY, FTAB_NAMES };

package/dist/biff/ptg-functions.d.ts

@@ -0,0 +1,7 @@
+//#region src/biff/ptg-functions.d.ts
+/** A function's displayed name, by its Ftab index -- consulted for both PtgFunc and PtgFuncVar. */
+declare const FTAB_NAMES: ReadonlyMap<number, string>;
+/** A function's fixed argument count, by its Ftab index -- consulted only for PtgFunc, whose own token carries no count. Absent for every entry [MS-XLS]'s grammar gives an optional or repeated argument, which is never resolved through PtgFunc in practice (see the module comment). */
+declare const FTAB_FIXED_ARITY: ReadonlyMap<number, number>;
+//#endregion
+export { FTAB_FIXED_ARITY, FTAB_NAMES };