@onparallel/write-excel-file-data-validation 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Santi Albo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# @onparallel/write-excel-file-data-validation
+
+Data validation custom feature for [`write-excel-file`](https://www.npmjs.com/package/write-excel-file).
+
+Adds support for Excel's "data validation" rules — dropdown lists, numeric/date/time ranges, text length limits, and custom formulas — without requiring a fork of the base package.
+
+## Install
+
+```sh
+npm install write-excel-file @onparallel/write-excel-file-data-validation
+```
+
+`write-excel-file` is a peer dependency (`^4.0.0`). The package is published publicly under the `@onparallel` scope — no authentication required to install.
+
+## Usage
+
+Register the feature when calling `writeXlsxFile()`. `write-excel-file/node`'s built-in `SheetOptions` does not know about `dataValidation`, so intersect it with the `DataValidationSheetOptions` type exported by this package:
+
+```ts
+import writeXlsxFile, { type SheetOptions } from 'write-excel-file/node'
+import dataValidation, {
+	type DataValidationSheetOptions
+} from '@onparallel/write-excel-file-data-validation'
+
+const sheetOptions: SheetOptions<any> & DataValidationSheetOptions = {
+	sheet: 'Sheet1',
+	dataValidation: [
+		{
+			cellRange: {
+				from: { row: 2, column: 1 },
+				to: { row: 10, column: 1 }
+			},
+			validation: {
+				type: 'list',
+				values: ['open', 'closed', 'pending'],
+				error: 'Pick one'
+			}
+		}
+	]
+}
+
+await writeXlsxFile(data, sheetOptions, { features: [dataValidation] }).toFile('out.xlsx')
+```
+
+If you use the intersection in many places, alias it locally: `type MySheetOptions = SheetOptions<any> & DataValidationSheetOptions`.
+
+Why not module augmentation? `write-excel-file/node` re-exports its types with `export type { ... }`, which TypeScript does not allow downstream packages to augment.
+
+## Supported validation types
+
+| `type`         | OOXML `type` | Required fields                                                                   |
+| -------------- | ------------ | --------------------------------------------------------------------------------- |
+| `'list'`       | `list`       | `values: string[]` **or** `valuesRange: string` (e.g. `'$E$4:$G$4'`)              |
+| `'integer'`    | `whole`      | `operator`, `value` (and `value2` for `'...'` / `'!...'`)                         |
+| `'decimal'`    | `decimal`    | same as `integer`                                                                 |
+| `'date'`       | `date`       | `operator`, `value` (and `value2` for between operators); values: `Date`/`number` |
+| `'time'`       | `time`       | same as `date`; `Date` values are reduced to fractional time-of-day               |
+| `'textLength'` | `textLength` | same as `integer`                                                                 |
+| `'custom'`     | `custom`     | `formula: string`                                                                 |
+| `'any'`        | (no `type`)  | Only metadata (used to attach a tooltip/error message without restricting input)  |
+
+Operators (mirror the symbols used by `conditionalFormatting`):
+
+| Symbol | OOXML                |
+| ------ | -------------------- |
+| `<`    | `lessThan`           |
+| `>`    | `greaterThan`        |
+| `<=`   | `lessThanOrEqual`    |
+| `>=`   | `greaterThanOrEqual` |
+| `=`    | `equal`              |
+| `!=`   | `notEqual`           |
+| `...`  | `between`            |
+| `!...` | `notBetween`         |
+
+## Common options (any type)
+
+| Field              | Default  | OOXML attribute                                                                  |
+| ------------------ | -------- | -------------------------------------------------------------------------------- |
+| `error`            | —        | `error`                                                                          |
+| `errorTitle`       | —        | `errorTitle`                                                                     |
+| `errorStyle`       | `'stop'` | `errorStyle`                                                                     |
+| `input`            | —        | `prompt`                                                                         |
+| `inputTitle`       | —        | `promptTitle`                                                                    |
+| `allowBlank`       | `true`   | `allowBlank`                                                                     |
+| `showErrorMessage` | `true`   | `showErrorMessage`                                                               |
+| `showInputMessage` | `true`   | `showInputMessage`                                                               |
+| `showDropdown`     | `true`   | `showDropDown` (inverted: OOXML `"1"` means hide) — only meaningful for `'list'` |
+
+Maximum lengths enforced (Excel limits): titles ≤ 32 characters, messages ≤ 255 characters, inline list formulas ≤ 255 characters.
+
+## Limitations
+
+- **Sheet-level only.** This feature reads `dataValidation` from `sheetOptions`. Per-cell validation (attaching a `validation` property to a cell object) is **not** supported because `write-excel-file`'s feature API does not expose sheet data to the transform hook. If you need per-cell validation, encode it as a sheet-level rule with a single-cell range:
+
+  ```ts
+  { cellRange: { from: { row: 5, column: 3 }, to: { row: 5, column: 3 } }, validation: { ... } }
+  ```
+
+- **Inline list commas and quotes.** Excel uses `,` as the list separator inside `<formula1>"…"</formula1>` and `"` as the surrounding delimiter — neither has a working escape. Values containing `,` or `"` are rejected; use `valuesRange` to reference a range of cells instead.
+
+## Examples
+
+The [`examples/`](./examples) folder contains runnable TypeScript scripts — one per validation type — that emit `.xlsx` files next to themselves. Open the generated files in Excel/Numbers/LibreOffice to confirm each rule works.
+
+```sh
+npm install
+npx tsx examples/list-inline.ts          # run a single example
+npm run examples                          # run them all
+```
+
+See [`examples/README.md`](./examples/README.md) for the full list.
+
+## Development
+
+```sh
+npm install
+npm test          # vitest
+npm run typecheck # tsc --noEmit
+npm run build     # emit dist/ via tsc
+```
+
+## License
+
+[MIT](./LICENSE)

package/dist/convertDateToExcelSerial.d.ts

@@ -0,0 +1,2 @@
+export default function convertDateToExcelSerial(date: Date): number;
+//# sourceMappingURL=convertDateToExcelSerial.d.ts.map

package/dist/convertDateToExcelSerial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertDateToExcelSerial.d.ts","sourceRoot":"","sources":["../src/convertDateToExcelSerial.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnE"}

package/dist/convertDateToExcelSerial.js

@@ -0,0 +1,9 @@
+// Excel serial date = count of days since 1900-01-01 (with the 1900-leap-year quirk).
+// 70 * 365 + 19 = days between 1900-01-01 (Excel epoch) and 1970-01-01 (Unix epoch),
+// accounting for 19 leap days in that range.
+const DAYS_BEFORE_UNIX_EPOCH = 70 * 365 + 19;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+export default function convertDateToExcelSerial(date) {
+    return date.getTime() / MS_PER_DAY + DAYS_BEFORE_UNIX_EPOCH;
+}
+//# sourceMappingURL=convertDateToExcelSerial.js.map

package/dist/convertDateToExcelSerial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertDateToExcelSerial.js","sourceRoot":"","sources":["../src/convertDateToExcelSerial.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,qFAAqF;AACrF,6CAA6C;AAC7C,MAAM,sBAAsB,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;AAC5C,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAEtC,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,IAAU;IAC1D,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,GAAG,sBAAsB,CAAA;AAC5D,CAAC"}

package/dist/dataValidation.d.ts

@@ -0,0 +1,4 @@
+import type { Feature } from 'write-excel-file/node';
+declare const dataValidation: Feature<any>;
+export default dataValidation;
+//# sourceMappingURL=dataValidation.d.ts.map

package/dist/dataValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataValidation.d.ts","sourceRoot":"","sources":["../src/dataValidation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAmBpD,QAAA,MAAM,cAAc,EAAE,OAAO,CAAC,GAAG,CA8BhC,CAAA;AAED,eAAe,cAAc,CAAA"}

package/dist/dataValidation.js

@@ -0,0 +1,305 @@
+import { insertElementMarkupAccordingToOrderOfSiblings, getOrderOfSiblings, sanitizeAttributeValue, sanitizeTextContent } from 'write-excel-file/utility';
+import getCellCoordinate from './getCellCoordinate.js';
+import convertDateToExcelSerial from './convertDateToExcelSerial.js';
+const MAX_TITLE_LENGTH = 32;
+const MAX_MESSAGE_LENGTH = 255;
+// `Feature<any>` rather than `Feature<unknown>` so the feature is assignable to
+// `Feature<FileContent>` for any `FileContent` (Buffer/Blob/etc) chosen by the caller.
+// This feature only transforms worksheet XML and never reads or writes file content,
+// so the `FileContent` parameter is irrelevant here.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const dataValidation = {
+    files: {
+        transform: {
+            'xl/worksheets/sheet{id}.xml': {
+                // `<dataValidations/>` must be placed between `<conditionalFormatting/>` and `<hyperlinks/>`
+                // inside `<worksheet/>`. We use `transform()` (not `insert()`) so the inserter can place
+                // the markup at the canonical sibling position even when other features have already
+                // appended siblings (such as `<drawing/>`).
+                transform: (xml, sheetOptions) => {
+                    const { dataValidation: rules } = sheetOptions;
+                    if (rules && rules.length > 0) {
+                        const dataValidationsXml = getDataValidationsXml(rules);
+                        const order = getOrderOfSiblings('xl/worksheets/sheet{id}.xml', 'worksheet');
+                        if (!order) {
+                            throw new Error('write-excel-file did not return an order of siblings for `worksheet`');
+                        }
+                        return insertElementMarkupAccordingToOrderOfSiblings(xml, dataValidationsXml, order, 'worksheet');
+                    }
+                    return xml;
+                }
+            }
+        }
+    }
+};
+export default dataValidation;
+function getDataValidationsXml(rules) {
+    let xml = `<dataValidations count="${rules.length}">`;
+    for (const rule of rules) {
+        xml += getDataValidationXml(rule);
+    }
+    xml += '</dataValidations>';
+    return xml;
+}
+function getDataValidationXml(rule) {
+    const { cellRange, validation } = rule;
+    if (!cellRange) {
+        throw new Error('A data validation rule must specify a `cellRange`');
+    }
+    if (!validation) {
+        throw new Error('A data validation rule must specify a `validation`');
+    }
+    const { from, to } = cellRange;
+    if (!from || !to) {
+        throw new Error('A data validation `cellRange` must specify both `from` and `to`');
+    }
+    if (from.row < 1 || from.column < 1 || to.row < 1 || to.column < 1) {
+        throw new Error(`Data validation \`cellRange\` row and column indexes must be >= 1 (1-based), got: ${JSON.stringify(cellRange)}`);
+    }
+    if (to.row < from.row || to.column < from.column) {
+        throw new Error(`Data validation \`cellRange\` \`to\` must be greater than or equal to \`from\`, got: ${JSON.stringify(cellRange)}`);
+    }
+    const sqref = getCellCoordinate(from.row - 1, from.column - 1) +
+        ':' +
+        getCellCoordinate(to.row - 1, to.column - 1);
+    const attributes = [];
+    const xlsxType = getXlsxType(validation.type);
+    if (xlsxType) {
+        attributes.push(`type="${xlsxType}"`);
+    }
+    if (hasOperator(validation.type)) {
+        attributes.push(`operator="${getXlsxOperatorName(validation.operator)}"`);
+    }
+    const { error, errorTitle, errorStyle, input, inputTitle, allowBlank, showErrorMessage, showInputMessage } = validation;
+    // OOXML defaults `allowBlank` to false; we default it to true (matching xlsxwriter).
+    attributes.push(`allowBlank="${allowBlank === false ? '0' : '1'}"`);
+    // `showDropDown` in OOXML is inverted: setting it to `1` HIDES the dropdown.
+    if (validation.type === 'list' && validation.showDropdown === false) {
+        attributes.push('showDropDown="1"');
+    }
+    // OOXML defaults `showErrorMessage`/`showInputMessage` to false; without them Excel does
+    // not reject invalid input. Default both to true.
+    attributes.push(`showErrorMessage="${showErrorMessage === false ? '0' : '1'}"`);
+    attributes.push(`showInputMessage="${showInputMessage === false ? '0' : '1'}"`);
+    if (errorStyle !== undefined) {
+        validateErrorStyle(errorStyle);
+        // OOXML default for `errorStyle` is `stop`. Skip the attribute in that case.
+        if (errorStyle !== 'stop') {
+            attributes.push(`errorStyle="${errorStyle}"`);
+        }
+    }
+    if (errorTitle !== undefined) {
+        validateTitleLength(errorTitle, 'errorTitle');
+        attributes.push(`errorTitle="${sanitizeAttributeValue(errorTitle)}"`);
+    }
+    if (error !== undefined) {
+        validateMessageLength(error, 'error');
+        attributes.push(`error="${sanitizeAttributeValue(error)}"`);
+    }
+    if (inputTitle !== undefined) {
+        validateTitleLength(inputTitle, 'inputTitle');
+        attributes.push(`promptTitle="${sanitizeAttributeValue(inputTitle)}"`);
+    }
+    if (input !== undefined) {
+        validateMessageLength(input, 'input');
+        attributes.push(`prompt="${sanitizeAttributeValue(input)}"`);
+    }
+    attributes.push(`sqref="${sqref}"`);
+    const [formula1, formula2] = getFormulas(validation);
+    let xml = `<dataValidation ${attributes.join(' ')}>`;
+    if (formula1 !== undefined) {
+        xml += `<formula1>${sanitizeTextContent(formula1)}</formula1>`;
+    }
+    if (formula2 !== undefined) {
+        xml += `<formula2>${sanitizeTextContent(formula2)}</formula2>`;
+    }
+    xml += '</dataValidation>';
+    return xml;
+}
+function getXlsxType(type) {
+    switch (type) {
+        case 'list':
+            return 'list';
+        case 'integer':
+            return 'whole';
+        case 'decimal':
+            return 'decimal';
+        case 'date':
+            return 'date';
+        case 'time':
+            return 'time';
+        case 'textLength':
+            return 'textLength';
+        case 'custom':
+            return 'custom';
+        case 'any':
+            return undefined;
+        default:
+            throw new Error(`Unknown data validation type: ${type}`);
+    }
+}
+function hasOperator(type) {
+    switch (type) {
+        case 'integer':
+        case 'decimal':
+        case 'date':
+        case 'time':
+        case 'textLength':
+            return true;
+        default:
+            return false;
+    }
+}
+function getXlsxOperatorName(operator) {
+    switch (operator) {
+        case '<':
+            return 'lessThan';
+        case '>':
+            return 'greaterThan';
+        case '<=':
+            return 'lessThanOrEqual';
+        case '>=':
+            return 'greaterThanOrEqual';
+        case '=':
+            return 'equal';
+        case '!=':
+            return 'notEqual';
+        case '...':
+            return 'between';
+        case '!...':
+            return 'notBetween';
+        default:
+            throw new Error(`Unknown data validation operator: ${operator}`);
+    }
+}
+function isBetweenOperator(operator) {
+    return operator === '...' || operator === '!...';
+}
+function getFormulas(validation) {
+    switch (validation.type) {
+        case 'list': {
+            if ('values' in validation) {
+                return [getListFormulaFromValues(validation.values)];
+            }
+            if ('valuesRange' in validation) {
+                return [validation.valuesRange];
+            }
+            throw new Error('A `list` data validation must specify either `values` or `valuesRange`');
+        }
+        case 'custom': {
+            if (validation.formula === undefined) {
+                throw new Error('A `custom` data validation must specify a `formula`');
+            }
+            return [validation.formula];
+        }
+        case 'any':
+            return [];
+        case 'integer':
+        case 'decimal':
+        case 'textLength': {
+            if (validation.value === undefined) {
+                throw new Error(`A \`${validation.type}\` data validation must specify a \`value\``);
+            }
+            if (isBetweenOperator(validation.operator)) {
+                if (validation.value2 === undefined) {
+                    throw new Error(`A \`${validation.type}\` data validation with operator \`${validation.operator}\` must specify a \`value2\``);
+                }
+                return [
+                    formatNumericValue(validation.value, validation.type),
+                    formatNumericValue(validation.value2, validation.type)
+                ];
+            }
+            return [formatNumericValue(validation.value, validation.type)];
+        }
+        case 'date':
+        case 'time': {
+            if (validation.value === undefined) {
+                throw new Error(`A \`${validation.type}\` data validation must specify a \`value\``);
+            }
+            if (isBetweenOperator(validation.operator)) {
+                const value2 = validation.value2;
+                if (value2 === undefined) {
+                    throw new Error(`A \`${validation.type}\` data validation with operator \`${validation.operator}\` must specify a \`value2\``);
+                }
+                return [
+                    formatDateOrTimeValue(validation.value, validation.type),
+                    formatDateOrTimeValue(value2, validation.type)
+                ];
+            }
+            return [formatDateOrTimeValue(validation.value, validation.type)];
+        }
+    }
+}
+function getListFormulaFromValues(values) {
+    if (!Array.isArray(values)) {
+        throw new Error(`A \`list\` data validation \`values\` must be an array, got: ${String(values)}`);
+    }
+    if (values.length === 0) {
+        throw new Error('A `list` data validation `values` must contain at least one value');
+    }
+    for (const value of values) {
+        if (typeof value !== 'string') {
+            throw new Error(`A \`list\` data validation \`values\` must be strings, got: ${String(value)}`);
+        }
+        if (value.indexOf(',') !== -1) {
+            throw new Error(`A \`list\` data validation \`values\` cannot contain commas (used by Excel as the separator inside the inline list formula). Use \`valuesRange\` to reference a range of cells instead. Got: "${value}"`);
+        }
+        if (value.indexOf('"') !== -1) {
+            throw new Error(`A \`list\` data validation \`values\` cannot contain double-quote characters. Use \`valuesRange\` to reference a range of cells instead. Got: "${value}"`);
+        }
+    }
+    const serialized = values.join(',');
+    if (serialized.length + 2 > MAX_MESSAGE_LENGTH) {
+        throw new Error(`A \`list\` data validation \`values\` serialized to "${serialized}" exceeds the maximum length of ${MAX_MESSAGE_LENGTH} characters. Use \`valuesRange\` instead to reference a range of cells.`);
+    }
+    return `"${serialized}"`;
+}
+function formatNumericValue(value, type) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`A \`${type}\` data validation \`value\` must be a finite number, got: ${String(value)}`);
+    }
+    return String(value);
+}
+function formatDateOrTimeValue(value, type) {
+    let serial;
+    if (value instanceof Date) {
+        serial = convertDateToExcelSerial(value);
+    }
+    else if (typeof value === 'number') {
+        serial = value;
+    }
+    else {
+        throw new Error(`A \`${type}\` data validation \`value\` must be a Date or a number, got: ${String(value)}`);
+    }
+    if (!Number.isFinite(serial)) {
+        throw new Error(`A \`${type}\` data validation \`value\` is not a finite number (possibly an invalid Date), got: ${String(value)}`);
+    }
+    // For `time`, Excel expects a fractional value in [0, 1) representing the time of day.
+    // A `Date` carries both a date and a time, so reduce the serial to its fractional part.
+    if (type === 'time') {
+        serial = serial - Math.floor(serial);
+    }
+    return String(serial);
+}
+function validateErrorStyle(errorStyle) {
+    if (errorStyle !== 'stop' && errorStyle !== 'warning' && errorStyle !== 'information') {
+        throw new Error(`Unknown data validation \`errorStyle\`: ${errorStyle}. Expected \`stop\`, \`warning\` or \`information\``);
+    }
+}
+function validateTitleLength(title, fieldName) {
+    if (typeof title !== 'string') {
+        throw new Error(`Data validation \`${fieldName}\` must be a string`);
+    }
+    if (title.length > MAX_TITLE_LENGTH) {
+        throw new Error(`Data validation \`${fieldName}\` is longer than ${MAX_TITLE_LENGTH} characters: "${title}"`);
+    }
+}
+function validateMessageLength(message, fieldName) {
+    if (typeof message !== 'string') {
+        throw new Error(`Data validation \`${fieldName}\` must be a string`);
+    }
+    if (message.length > MAX_MESSAGE_LENGTH) {
+        throw new Error(`Data validation \`${fieldName}\` is longer than ${MAX_MESSAGE_LENGTH} characters: "${message}"`);
+    }
+}
+//# sourceMappingURL=dataValidation.js.map

package/dist/dataValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataValidation.js","sourceRoot":"","sources":["../src/dataValidation.ts"],"names":[],"mappings":"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"}

package/dist/getCellCoordinate.d.ts

@@ -0,0 +1,2 @@
+export default function getCellCoordinate(rowIndex: number, columnIndex: number): string;
+//# sourceMappingURL=getCellCoordinate.d.ts.map

package/dist/getCellCoordinate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCellCoordinate.d.ts","sourceRoot":"","sources":["../src/getCellCoordinate.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvF"}

package/dist/getCellCoordinate.js

@@ -0,0 +1,13 @@
+const LETTERS_COUNT = 26;
+function getColumnLetter(columnIndex) {
+    const prefix = Math.floor(columnIndex / LETTERS_COUNT);
+    const letter = String.fromCharCode(97 + (columnIndex % LETTERS_COUNT)).toUpperCase();
+    if (prefix === 0) {
+        return letter;
+    }
+    return getColumnLetter(prefix - 1) + letter;
+}
+export default function getCellCoordinate(rowIndex, columnIndex) {
+    return `${getColumnLetter(columnIndex)}${rowIndex + 1}`;
+}
+//# sourceMappingURL=getCellCoordinate.js.map

package/dist/getCellCoordinate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCellCoordinate.js","sourceRoot":"","sources":["../src/getCellCoordinate.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,EAAE,CAAA;AAExB,SAAS,eAAe,CAAC,WAAmB;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,aAAa,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACpF,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,MAAM,CAAA;IACd,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,CAAA;AAC5C,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,QAAgB,EAAE,WAAmB;IAC9E,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAA;AACxD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './dataValidation.js';
+export type { DataValidation, DataValidationRule, DataValidationOperator, DataValidationErrorStyle, DataValidationSheetOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,YAAY,EACX,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { default } from './dataValidation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+export type DataValidationOperatorOnOneValue = '<' | '<=' | '>' | '>=' | '=' | '!=';
+export type DataValidationOperatorOnTwoValues = '...' | '!...';
+export type DataValidationOperator = DataValidationOperatorOnOneValue | DataValidationOperatorOnTwoValues;
+export type DataValidationErrorStyle = 'stop' | 'warning' | 'information';
+interface DataValidationCommonProperties {
+    error?: string;
+    errorTitle?: string;
+    errorStyle?: DataValidationErrorStyle;
+    input?: string;
+    inputTitle?: string;
+    allowBlank?: boolean;
+    showErrorMessage?: boolean;
+    showInputMessage?: boolean;
+}
+interface DataValidationListWithValues extends DataValidationCommonProperties {
+    type: 'list';
+    values: string[];
+    showDropdown?: boolean;
+}
+interface DataValidationListWithRange extends DataValidationCommonProperties {
+    type: 'list';
+    valuesRange: string;
+    showDropdown?: boolean;
+}
+interface DataValidationNumericOnOneValue extends DataValidationCommonProperties {
+    type: 'integer' | 'decimal' | 'textLength';
+    operator: DataValidationOperatorOnOneValue;
+    value: number;
+}
+interface DataValidationNumericOnTwoValues extends DataValidationCommonProperties {
+    type: 'integer' | 'decimal' | 'textLength';
+    operator: DataValidationOperatorOnTwoValues;
+    value: number;
+    value2: number;
+}
+interface DataValidationDateOnOneValue extends DataValidationCommonProperties {
+    type: 'date' | 'time';
+    operator: DataValidationOperatorOnOneValue;
+    value: Date | number;
+}
+interface DataValidationDateOnTwoValues extends DataValidationCommonProperties {
+    type: 'date' | 'time';
+    operator: DataValidationOperatorOnTwoValues;
+    value: Date | number;
+    value2: Date | number;
+}
+interface DataValidationCustom extends DataValidationCommonProperties {
+    type: 'custom';
+    formula: string;
+}
+interface DataValidationAny extends DataValidationCommonProperties {
+    type: 'any';
+}
+export type DataValidation = DataValidationListWithValues | DataValidationListWithRange | DataValidationNumericOnOneValue | DataValidationNumericOnTwoValues | DataValidationDateOnOneValue | DataValidationDateOnTwoValues | DataValidationCustom | DataValidationAny;
+export interface DataValidationRule {
+    cellRange: {
+        from: {
+            row: number;
+            column: number;
+        };
+        to: {
+            row: number;
+            column: number;
+        };
+    };
+    validation: DataValidation;
+}
+export interface DataValidationSheetOptions {
+    dataValidation?: DataValidationRule[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gCAAgC,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAA;AAEnF,MAAM,MAAM,iCAAiC,GAAG,KAAK,GAAG,MAAM,CAAA;AAE9D,MAAM,MAAM,sBAAsB,GAC/B,gCAAgC,GAChC,iCAAiC,CAAA;AAEpC,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;AAEzE,UAAU,8BAA8B;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,wBAAwB,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,UAAU,4BAA6B,SAAQ,8BAA8B;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,UAAU,2BAA4B,SAAQ,8BAA8B;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,UAAU,+BAAgC,SAAQ,8BAA8B;IAC/E,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAA;IAC1C,QAAQ,EAAE,gCAAgC,CAAA;IAC1C,KAAK,EAAE,MAAM,CAAA;CACb;AAED,UAAU,gCAAiC,SAAQ,8BAA8B;IAChF,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAA;IAC1C,QAAQ,EAAE,iCAAiC,CAAA;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACd;AAED,UAAU,4BAA6B,SAAQ,8BAA8B;IAC5E,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,QAAQ,EAAE,gCAAgC,CAAA;IAC1C,KAAK,EAAE,IAAI,GAAG,MAAM,CAAA;CACpB;AAED,UAAU,6BAA8B,SAAQ,8BAA8B;IAC7E,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,QAAQ,EAAE,iCAAiC,CAAA;IAC3C,KAAK,EAAE,IAAI,GAAG,MAAM,CAAA;IACpB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAA;CACrB;AAED,UAAU,oBAAqB,SAAQ,8BAA8B;IACpE,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CACf;AAED,UAAU,iBAAkB,SAAQ,8BAA8B;IACjE,IAAI,EAAE,KAAK,CAAA;CACX;AAED,MAAM,MAAM,cAAc,GACvB,4BAA4B,GAC5B,2BAA2B,GAC3B,+BAA+B,GAC/B,gCAAgC,GAChC,4BAA4B,GAC5B,6BAA6B,GAC7B,oBAAoB,GACpB,iBAAiB,CAAA;AAEpB,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE;QACV,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;QACrC,EAAE,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KACnC,CAAA;IACD,UAAU,EAAE,cAAc,CAAA;CAC1B;AAED,MAAM,WAAW,0BAA0B;IAC1C,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAA;CACrC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,64 @@
+{
+	"name": "@onparallel/write-excel-file-data-validation",
+	"version": "0.1.0",
+	"description": "Data validation custom feature for write-excel-file",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"dist",
+		"src/**/*.ts",
+		"!src/**/*.test.ts",
+		"README.md",
+		"LICENSE"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/onparallel/write-excel-file-data-validation.git"
+	},
+	"bugs": {
+		"url": "https://github.com/onparallel/write-excel-file-data-validation/issues"
+	},
+	"homepage": "https://github.com/onparallel/write-excel-file-data-validation#readme",
+	"engines": {
+		"node": ">=22"
+	},
+	"sideEffects": false,
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"examples": "for f in examples/*.ts; do tsx \"$f\"; done",
+		"prepublishOnly": "npm run format:check && npm run typecheck && npm test && npm run build"
+	},
+	"keywords": [
+		"xlsx",
+		"excel",
+		"data-validation",
+		"dropdown",
+		"write-excel-file"
+	],
+	"author": "Santi Albo <santi@onparallel.com>",
+	"license": "MIT",
+	"peerDependencies": {
+		"write-excel-file": "^4.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"prettier": "^3.3.0",
+		"tsx": "^4.7.0",
+		"typescript": "^5.4.0",
+		"vitest": "^1.6.0",
+		"write-excel-file": "^4.0.7"
+	}
+}

package/src/convertDateToExcelSerial.ts

@@ -0,0 +1,9 @@
+// Excel serial date = count of days since 1900-01-01 (with the 1900-leap-year quirk).
+// 70 * 365 + 19 = days between 1900-01-01 (Excel epoch) and 1970-01-01 (Unix epoch),
+// accounting for 19 leap days in that range.
+const DAYS_BEFORE_UNIX_EPOCH = 70 * 365 + 19
+const MS_PER_DAY = 24 * 60 * 60 * 1000
+
+export default function convertDateToExcelSerial(date: Date): number {
+	return date.getTime() / MS_PER_DAY + DAYS_BEFORE_UNIX_EPOCH
+}

package/src/dataValidation.ts

@@ -0,0 +1,409 @@
+import {
+	insertElementMarkupAccordingToOrderOfSiblings,
+	getOrderOfSiblings,
+	sanitizeAttributeValue,
+	sanitizeTextContent
+} from 'write-excel-file/utility'
+import type { Feature } from 'write-excel-file/node'
+
+import getCellCoordinate from './getCellCoordinate.js'
+import convertDateToExcelSerial from './convertDateToExcelSerial.js'
+import type {
+	DataValidation,
+	DataValidationOperator,
+	DataValidationRule,
+	DataValidationSheetOptions
+} from './types.js'
+
+const MAX_TITLE_LENGTH = 32
+const MAX_MESSAGE_LENGTH = 255
+
+// `Feature<any>` rather than `Feature<unknown>` so the feature is assignable to
+// `Feature<FileContent>` for any `FileContent` (Buffer/Blob/etc) chosen by the caller.
+// This feature only transforms worksheet XML and never reads or writes file content,
+// so the `FileContent` parameter is irrelevant here.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const dataValidation: Feature<any> = {
+	files: {
+		transform: {
+			'xl/worksheets/sheet{id}.xml': {
+				// `<dataValidations/>` must be placed between `<conditionalFormatting/>` and `<hyperlinks/>`
+				// inside `<worksheet/>`. We use `transform()` (not `insert()`) so the inserter can place
+				// the markup at the canonical sibling position even when other features have already
+				// appended siblings (such as `<drawing/>`).
+				transform: (xml, sheetOptions) => {
+					const { dataValidation: rules } = sheetOptions as DataValidationSheetOptions
+					if (rules && rules.length > 0) {
+						const dataValidationsXml = getDataValidationsXml(rules)
+						const order = getOrderOfSiblings('xl/worksheets/sheet{id}.xml', 'worksheet')
+						if (!order) {
+							throw new Error(
+								'write-excel-file did not return an order of siblings for `worksheet`'
+							)
+						}
+						return insertElementMarkupAccordingToOrderOfSiblings(
+							xml,
+							dataValidationsXml,
+							order,
+							'worksheet'
+						)
+					}
+					return xml
+				}
+			}
+		}
+	}
+}
+
+export default dataValidation
+
+function getDataValidationsXml(rules: DataValidationRule[]): string {
+	let xml = `<dataValidations count="${rules.length}">`
+	for (const rule of rules) {
+		xml += getDataValidationXml(rule)
+	}
+	xml += '</dataValidations>'
+	return xml
+}
+
+function getDataValidationXml(rule: DataValidationRule): string {
+	const { cellRange, validation } = rule
+
+	if (!cellRange) {
+		throw new Error('A data validation rule must specify a `cellRange`')
+	}
+
+	if (!validation) {
+		throw new Error('A data validation rule must specify a `validation`')
+	}
+
+	const { from, to } = cellRange
+
+	if (!from || !to) {
+		throw new Error('A data validation `cellRange` must specify both `from` and `to`')
+	}
+
+	if (from.row < 1 || from.column < 1 || to.row < 1 || to.column < 1) {
+		throw new Error(
+			`Data validation \`cellRange\` row and column indexes must be >= 1 (1-based), got: ${JSON.stringify(cellRange)}`
+		)
+	}
+
+	if (to.row < from.row || to.column < from.column) {
+		throw new Error(
+			`Data validation \`cellRange\` \`to\` must be greater than or equal to \`from\`, got: ${JSON.stringify(cellRange)}`
+		)
+	}
+
+	const sqref =
+		getCellCoordinate(from.row - 1, from.column - 1) +
+		':' +
+		getCellCoordinate(to.row - 1, to.column - 1)
+
+	const attributes: string[] = []
+
+	const xlsxType = getXlsxType(validation.type)
+	if (xlsxType) {
+		attributes.push(`type="${xlsxType}"`)
+	}
+
+	if (hasOperator(validation.type)) {
+		attributes.push(
+			`operator="${getXlsxOperatorName((validation as { operator: DataValidationOperator }).operator)}"`
+		)
+	}
+
+	const {
+		error,
+		errorTitle,
+		errorStyle,
+		input,
+		inputTitle,
+		allowBlank,
+		showErrorMessage,
+		showInputMessage
+	} = validation
+
+	// OOXML defaults `allowBlank` to false; we default it to true (matching xlsxwriter).
+	attributes.push(`allowBlank="${allowBlank === false ? '0' : '1'}"`)
+
+	// `showDropDown` in OOXML is inverted: setting it to `1` HIDES the dropdown.
+	if (validation.type === 'list' && validation.showDropdown === false) {
+		attributes.push('showDropDown="1"')
+	}
+
+	// OOXML defaults `showErrorMessage`/`showInputMessage` to false; without them Excel does
+	// not reject invalid input. Default both to true.
+	attributes.push(`showErrorMessage="${showErrorMessage === false ? '0' : '1'}"`)
+	attributes.push(`showInputMessage="${showInputMessage === false ? '0' : '1'}"`)
+
+	if (errorStyle !== undefined) {
+		validateErrorStyle(errorStyle)
+		// OOXML default for `errorStyle` is `stop`. Skip the attribute in that case.
+		if (errorStyle !== 'stop') {
+			attributes.push(`errorStyle="${errorStyle}"`)
+		}
+	}
+
+	if (errorTitle !== undefined) {
+		validateTitleLength(errorTitle, 'errorTitle')
+		attributes.push(`errorTitle="${sanitizeAttributeValue(errorTitle)}"`)
+	}
+
+	if (error !== undefined) {
+		validateMessageLength(error, 'error')
+		attributes.push(`error="${sanitizeAttributeValue(error)}"`)
+	}
+
+	if (inputTitle !== undefined) {
+		validateTitleLength(inputTitle, 'inputTitle')
+		attributes.push(`promptTitle="${sanitizeAttributeValue(inputTitle)}"`)
+	}
+
+	if (input !== undefined) {
+		validateMessageLength(input, 'input')
+		attributes.push(`prompt="${sanitizeAttributeValue(input)}"`)
+	}
+
+	attributes.push(`sqref="${sqref}"`)
+
+	const [formula1, formula2] = getFormulas(validation)
+
+	let xml = `<dataValidation ${attributes.join(' ')}>`
+	if (formula1 !== undefined) {
+		xml += `<formula1>${sanitizeTextContent(formula1)}</formula1>`
+	}
+	if (formula2 !== undefined) {
+		xml += `<formula2>${sanitizeTextContent(formula2)}</formula2>`
+	}
+	xml += '</dataValidation>'
+
+	return xml
+}
+
+function getXlsxType(type: DataValidation['type']): string | undefined {
+	switch (type) {
+		case 'list':
+			return 'list'
+		case 'integer':
+			return 'whole'
+		case 'decimal':
+			return 'decimal'
+		case 'date':
+			return 'date'
+		case 'time':
+			return 'time'
+		case 'textLength':
+			return 'textLength'
+		case 'custom':
+			return 'custom'
+		case 'any':
+			return undefined
+		default:
+			throw new Error(`Unknown data validation type: ${type as string}`)
+	}
+}
+
+function hasOperator(type: DataValidation['type']): boolean {
+	switch (type) {
+		case 'integer':
+		case 'decimal':
+		case 'date':
+		case 'time':
+		case 'textLength':
+			return true
+		default:
+			return false
+	}
+}
+
+function getXlsxOperatorName(operator: DataValidationOperator): string {
+	switch (operator) {
+		case '<':
+			return 'lessThan'
+		case '>':
+			return 'greaterThan'
+		case '<=':
+			return 'lessThanOrEqual'
+		case '>=':
+			return 'greaterThanOrEqual'
+		case '=':
+			return 'equal'
+		case '!=':
+			return 'notEqual'
+		case '...':
+			return 'between'
+		case '!...':
+			return 'notBetween'
+		default:
+			throw new Error(`Unknown data validation operator: ${operator as string}`)
+	}
+}
+
+function isBetweenOperator(operator: DataValidationOperator): boolean {
+	return operator === '...' || operator === '!...'
+}
+
+type Formulas = [string | undefined, string | undefined] | [string] | []
+
+function getFormulas(validation: DataValidation): Formulas {
+	switch (validation.type) {
+		case 'list': {
+			if ('values' in validation) {
+				return [getListFormulaFromValues(validation.values)]
+			}
+			if ('valuesRange' in validation) {
+				return [validation.valuesRange]
+			}
+			throw new Error('A `list` data validation must specify either `values` or `valuesRange`')
+		}
+
+		case 'custom': {
+			if (validation.formula === undefined) {
+				throw new Error('A `custom` data validation must specify a `formula`')
+			}
+			return [validation.formula]
+		}
+
+		case 'any':
+			return []
+
+		case 'integer':
+		case 'decimal':
+		case 'textLength': {
+			if (validation.value === undefined) {
+				throw new Error(`A \`${validation.type}\` data validation must specify a \`value\``)
+			}
+			if (isBetweenOperator(validation.operator)) {
+				if ((validation as { value2?: number }).value2 === undefined) {
+					throw new Error(
+						`A \`${validation.type}\` data validation with operator \`${validation.operator}\` must specify a \`value2\``
+					)
+				}
+				return [
+					formatNumericValue(validation.value, validation.type),
+					formatNumericValue((validation as { value2: number }).value2, validation.type)
+				]
+			}
+			return [formatNumericValue(validation.value, validation.type)]
+		}
+
+		case 'date':
+		case 'time': {
+			if (validation.value === undefined) {
+				throw new Error(`A \`${validation.type}\` data validation must specify a \`value\``)
+			}
+			if (isBetweenOperator(validation.operator)) {
+				const value2 = (validation as { value2?: Date | number }).value2
+				if (value2 === undefined) {
+					throw new Error(
+						`A \`${validation.type}\` data validation with operator \`${validation.operator}\` must specify a \`value2\``
+					)
+				}
+				return [
+					formatDateOrTimeValue(validation.value, validation.type),
+					formatDateOrTimeValue(value2, validation.type)
+				]
+			}
+			return [formatDateOrTimeValue(validation.value, validation.type)]
+		}
+	}
+}
+
+function getListFormulaFromValues(values: string[]): string {
+	if (!Array.isArray(values)) {
+		throw new Error(
+			`A \`list\` data validation \`values\` must be an array, got: ${String(values)}`
+		)
+	}
+	if (values.length === 0) {
+		throw new Error('A `list` data validation `values` must contain at least one value')
+	}
+	for (const value of values) {
+		if (typeof value !== 'string') {
+			throw new Error(
+				`A \`list\` data validation \`values\` must be strings, got: ${String(value)}`
+			)
+		}
+		if (value.indexOf(',') !== -1) {
+			throw new Error(
+				`A \`list\` data validation \`values\` cannot contain commas (used by Excel as the separator inside the inline list formula). Use \`valuesRange\` to reference a range of cells instead. Got: "${value}"`
+			)
+		}
+		if (value.indexOf('"') !== -1) {
+			throw new Error(
+				`A \`list\` data validation \`values\` cannot contain double-quote characters. Use \`valuesRange\` to reference a range of cells instead. Got: "${value}"`
+			)
+		}
+	}
+	const serialized = values.join(',')
+	if (serialized.length + 2 > MAX_MESSAGE_LENGTH) {
+		throw new Error(
+			`A \`list\` data validation \`values\` serialized to "${serialized}" exceeds the maximum length of ${MAX_MESSAGE_LENGTH} characters. Use \`valuesRange\` instead to reference a range of cells.`
+		)
+	}
+	return `"${serialized}"`
+}
+
+function formatNumericValue(value: number, type: string): string {
+	if (typeof value !== 'number' || !Number.isFinite(value)) {
+		throw new Error(
+			`A \`${type}\` data validation \`value\` must be a finite number, got: ${String(value)}`
+		)
+	}
+	return String(value)
+}
+
+function formatDateOrTimeValue(value: Date | number, type: 'date' | 'time'): string {
+	let serial: number
+	if (value instanceof Date) {
+		serial = convertDateToExcelSerial(value)
+	} else if (typeof value === 'number') {
+		serial = value
+	} else {
+		throw new Error(
+			`A \`${type}\` data validation \`value\` must be a Date or a number, got: ${String(value)}`
+		)
+	}
+	if (!Number.isFinite(serial)) {
+		throw new Error(
+			`A \`${type}\` data validation \`value\` is not a finite number (possibly an invalid Date), got: ${String(value)}`
+		)
+	}
+	// For `time`, Excel expects a fractional value in [0, 1) representing the time of day.
+	// A `Date` carries both a date and a time, so reduce the serial to its fractional part.
+	if (type === 'time') {
+		serial = serial - Math.floor(serial)
+	}
+	return String(serial)
+}
+
+function validateErrorStyle(errorStyle: string): void {
+	if (errorStyle !== 'stop' && errorStyle !== 'warning' && errorStyle !== 'information') {
+		throw new Error(
+			`Unknown data validation \`errorStyle\`: ${errorStyle}. Expected \`stop\`, \`warning\` or \`information\``
+		)
+	}
+}
+
+function validateTitleLength(title: string, fieldName: string): void {
+	if (typeof title !== 'string') {
+		throw new Error(`Data validation \`${fieldName}\` must be a string`)
+	}
+	if (title.length > MAX_TITLE_LENGTH) {
+		throw new Error(
+			`Data validation \`${fieldName}\` is longer than ${MAX_TITLE_LENGTH} characters: "${title}"`
+		)
+	}
+}
+
+function validateMessageLength(message: string, fieldName: string): void {
+	if (typeof message !== 'string') {
+		throw new Error(`Data validation \`${fieldName}\` must be a string`)
+	}
+	if (message.length > MAX_MESSAGE_LENGTH) {
+		throw new Error(
+			`Data validation \`${fieldName}\` is longer than ${MAX_MESSAGE_LENGTH} characters: "${message}"`
+		)
+	}
+}

package/src/getCellCoordinate.ts

@@ -0,0 +1,14 @@
+const LETTERS_COUNT = 26
+
+function getColumnLetter(columnIndex: number): string {
+	const prefix = Math.floor(columnIndex / LETTERS_COUNT)
+	const letter = String.fromCharCode(97 + (columnIndex % LETTERS_COUNT)).toUpperCase()
+	if (prefix === 0) {
+		return letter
+	}
+	return getColumnLetter(prefix - 1) + letter
+}
+
+export default function getCellCoordinate(rowIndex: number, columnIndex: number): string {
+	return `${getColumnLetter(columnIndex)}${rowIndex + 1}`
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export { default } from './dataValidation.js'
+export type {
+	DataValidation,
+	DataValidationRule,
+	DataValidationOperator,
+	DataValidationErrorStyle,
+	DataValidationSheetOptions
+} from './types.js'

package/src/types.ts

@@ -0,0 +1,89 @@
+export type DataValidationOperatorOnOneValue = '<' | '<=' | '>' | '>=' | '=' | '!='
+
+export type DataValidationOperatorOnTwoValues = '...' | '!...'
+
+export type DataValidationOperator =
+	| DataValidationOperatorOnOneValue
+	| DataValidationOperatorOnTwoValues
+
+export type DataValidationErrorStyle = 'stop' | 'warning' | 'information'
+
+interface DataValidationCommonProperties {
+	error?: string
+	errorTitle?: string
+	errorStyle?: DataValidationErrorStyle
+	input?: string
+	inputTitle?: string
+	allowBlank?: boolean
+	showErrorMessage?: boolean
+	showInputMessage?: boolean
+}
+
+interface DataValidationListWithValues extends DataValidationCommonProperties {
+	type: 'list'
+	values: string[]
+	showDropdown?: boolean
+}
+
+interface DataValidationListWithRange extends DataValidationCommonProperties {
+	type: 'list'
+	valuesRange: string
+	showDropdown?: boolean
+}
+
+interface DataValidationNumericOnOneValue extends DataValidationCommonProperties {
+	type: 'integer' | 'decimal' | 'textLength'
+	operator: DataValidationOperatorOnOneValue
+	value: number
+}
+
+interface DataValidationNumericOnTwoValues extends DataValidationCommonProperties {
+	type: 'integer' | 'decimal' | 'textLength'
+	operator: DataValidationOperatorOnTwoValues
+	value: number
+	value2: number
+}
+
+interface DataValidationDateOnOneValue extends DataValidationCommonProperties {
+	type: 'date' | 'time'
+	operator: DataValidationOperatorOnOneValue
+	value: Date | number
+}
+
+interface DataValidationDateOnTwoValues extends DataValidationCommonProperties {
+	type: 'date' | 'time'
+	operator: DataValidationOperatorOnTwoValues
+	value: Date | number
+	value2: Date | number
+}
+
+interface DataValidationCustom extends DataValidationCommonProperties {
+	type: 'custom'
+	formula: string
+}
+
+interface DataValidationAny extends DataValidationCommonProperties {
+	type: 'any'
+}
+
+export type DataValidation =
+	| DataValidationListWithValues
+	| DataValidationListWithRange
+	| DataValidationNumericOnOneValue
+	| DataValidationNumericOnTwoValues
+	| DataValidationDateOnOneValue
+	| DataValidationDateOnTwoValues
+	| DataValidationCustom
+	| DataValidationAny
+
+export interface DataValidationRule {
+	cellRange: {
+		from: { row: number; column: number }
+		to: { row: number; column: number }
+	}
+	validation: DataValidation
+}
+
+export interface DataValidationSheetOptions {
+	dataValidation?: DataValidationRule[]
+}