shutro-erp 0.2.1 → 0.3.1

package/dist/cli/ui.js

@@ -1,9 +1,11 @@
 /**
- * The installer's look in the terminal, without dependencies: a logo, numbered steps with icons, spinners for long
- * work, status lines (✔ ▲ ✖) and a summary card. Colour, Unicode and animation are detected from the terminal
- * (NO_COLOR, FORCE_COLOR, KOSH_ASCII=1, TERM=dumb, Windows consoles without Unicode); output that is not a terminal
- * (tests, logs, CI) gets plain lines with the same words and no escape codes.
+ * The installer's look in the terminal, without dependencies: a logo, numbered steps, spinners for long work,
+ * status lines (✔ ▲ ✖) and a summary card. On a Unicode terminal everything hangs on one rail down the left (│),
+ * the questions of the interactive prompter included (`tui.ts`). Colour, Unicode and animation are detected from
+ * the terminal (NO_COLOR, FORCE_COLOR, SHUTRO_ERP_ASCII=1, TERM=dumb, Windows consoles without Unicode); output that is not
+ * a terminal (tests, logs, CI) gets plain lines with the same words and no escape codes.
  */
+import { release as osRelease } from 'node:os';
 /** Plain output: logs, tests, pipes. */
 export const PLAIN_TERMINAL = Object.freeze({
     color: false,
@@ -13,7 +15,7 @@ export const PLAIN_TERMINAL = Object.freeze({
     columns: 80,
 });
 /** Detects what `stream` (process.stdout) can show. */
-export function detectTerminal(stream, env = process.env, platform = process.platform) {
+export function detectTerminal(stream, env = process.env, platform = process.platform, release = osRelease()) {
     const tty = stream.isTTY === true && env['TERM'] !== 'dumb' && env['CI'] === undefined;
     const forced = env['FORCE_COLOR'] !== undefined && env['FORCE_COLOR'] !== '0';
     const color = env['NO_COLOR'] === undefined && (forced || tty);
@@ -23,20 +25,27 @@ export function detectTerminal(stream, env = process.env, platform = process.pla
         env['ConEmuTask'] === '{cmd::Cmder}' ||
         env['TERM'] === 'xterm-256color' ||
         env['TERM'] === 'alacritty';
-    const unicode = env['KOSH_ASCII'] !== '1' && (platform === 'win32' ? modernWindows : env['TERM'] !== 'linux');
+    // Windows 10 and later: the console host shows box drawing and colours too (UTF-8, virtual terminal); pictographs
+    // only in the modern terminals. Older Windows keeps ASCII.
+    const windows10 = Number(release.split('.')[0]) >= 10;
+    const unicode = env['KOSH_ASCII'] !== '1' &&
+        env['SHUTRO_ERP_ASCII'] !== '1' &&
+        (platform === 'win32' ? modernWindows || windows10 : env['TERM'] !== 'linux');
     return {
         color,
         unicode,
-        emoji: unicode && tty,
+        emoji: unicode && tty && (platform !== 'win32' || modernWindows),
         animate: tty,
         columns: Math.max(40, Math.min(stream.columns ?? 80, 120)),
     };
 }
-const ESC = '\u001b[';
+export const ESC = '\u001b[';
 const paint = (open, close) => (enabled) => (text) => enabled ? `${ESC}${open}m${text}${ESC}${close}m` : text;
 const styles = {
     bold: paint('1', '22'),
     dim: paint('2', '22'),
+    inverse: paint('7', '27'),
+    underline: paint('4', '24'),
     green: paint('32', '39'),
     yellow: paint('33', '39'),
     red: paint('31', '39'),
@@ -44,6 +53,22 @@ const styles = {
     magenta: paint('35', '39'),
     gray: paint('90', '39'),
 };
+/** Styles text for `terminal` (no escape codes without colour). */
+export function stylerFor(terminal) {
+    return (name, text) => styles[name](terminal.color)(text);
+}
+/** The rail and its marks (Unicode terminals that animate), shared with the interactive prompter. */
+export const RAIL = {
+    bar: '│',
+    start: '┌',
+    end: '└',
+    active: '◆',
+    done: '◇',
+    error: '▲',
+    cancel: '■',
+};
+/** Whether `terminal` gets the rail look (a TTY that shows Unicode). */
+export const railed = (terminal) => terminal.unicode && terminal.animate;
 /** Columns a string takes: escape codes take none, pictographs two. */
 export function width(text) {
     let n = 0;
@@ -73,12 +98,12 @@ export const ICONS = {
     rocket: ['🚀', '◆'],
 };
 const LOGO = [
-    '██╗  ██╗ ██████╗ ███████╗██╗  ██╗',
-    '██║ ██╔╝██╔═══██╗██╔════╝██║  ██║',
-    '█████╔╝ ██║   ██║███████╗███████║',
-    '██╔═██╗ ██║   ██║╚════██║██╔══██║',
-    '██║  ██╗╚██████╔╝███████║██║  ██║',
-    '╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝',
+    '███████╗██╗  ██╗██╗   ██╗████████╗██████╗  ██████╗',
+    '██╔════╝██║  ██║██║   ██║╚══██╔══╝██╔══██╗██╔═══██╗',
+    '███████╗███████║██║   ██║   ██║   ██████╔╝██║   ██║',
+    '╚════██║██╔══██║██║   ██║   ██║   ██╔══██╗██║   ██║',
+    '███████║██║  ██║╚██████╔╝   ██║   ██║  ██║╚██████╔╝',
+    '╚══════╝╚═╝  ╚═╝ ╚═════╝    ╚═╝   ╚═╝  ╚═╝ ╚═════╝',
 ];
 /** Cyan to violet, one 256-colour step per logo line. */
 const GRADIENT = [51, 45, 39, 33, 63, 99];
@@ -86,7 +111,9 @@ const SPINNER_UNICODE = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧',
 const SPINNER_ASCII = ['|', '/', '-', '\\'];
 /** A {@link Ui} writing through `out`. */
 export function createUi(out, terminal = PLAIN_TERMINAL, options = {}) {
-    const s = (name, text) => styles[name](terminal.color)(text);
+    const s = stylerFor(terminal);
+    const rail = railed(terminal);
+    const bar = s('gray', RAIL.bar);
     const sym = terminal.unicode
         ? { ok: '✔', info: 'ℹ', warn: '▲', fail: '✖', dot: '•', bar: '█', rest: '░' }
         : { ok: '[ok]', info: '[i]', warn: '[!]', fail: '[x]', dot: '-', bar: '#', rest: '.' };
@@ -104,14 +131,14 @@ export function createUi(out, terminal = PLAIN_TERMINAL, options = {}) {
             return;
         const f = s('cyan', frames[spin.frame % frames.length] ?? '');
         const extra = spin.extra === '' ? '' : s('gray', `  ${spin.extra}`);
-        out(`\r${ESC}2K  ${f} ${spin.label}${extra}`);
+        out(rail ? `\r${ESC}2K${f}  ${spin.label}${extra}` : `\r${ESC}2K  ${f} ${spin.label}${extra}`);
     };
     const write = (text) => {
         clear();
         out(text);
         draw();
     };
-    const line = (mark, text) => write(`  ${mark} ${text}\n`);
+    const line = (mark, text) => write(rail ? `${bar}  ${mark} ${text}\n` : `  ${mark} ${text}\n`);
     const icon = (name) => (terminal.emoji ? ICONS[name][0] : s('cyan', ICONS[name][1]));
     return {
         terminal,
@@ -120,7 +147,7 @@ export function createUi(out, terminal = PLAIN_TERMINAL, options = {}) {
         icon,
         async banner(subtitle) {
             if (!terminal.unicode) {
-                write(`\n  ${s('bold', 'K O S H')}  ${subtitle}\n`);
+                write(`\n  ${s('bold', 'S H U T R O   E R P')}  ${subtitle}\n`);
                 return;
             }
             write('\n');
@@ -132,8 +159,25 @@ export function createUi(out, terminal = PLAIN_TERMINAL, options = {}) {
             }
             write(`  ${s('bold', subtitle)}\n`);
         },
+        intro(title, hint) {
+            if (!rail) {
+                write(`  ${s('gray', hint)}\n`);
+                return;
+            }
+            write(`\n${s('gray', RAIL.start)}  ${s('inverse', ` ${title} `)}\n${bar}  ${s('gray', hint)}\n`);
+        },
+        outro(text) {
+            write(rail ? `${bar}\n${s('gray', RAIL.end)}  ${text}\n` : `\n  ${text}\n`);
+        },
         step(name, title, hint) {
             stepNo += 1;
+            if (rail) {
+                const n = options.steps === undefined ? '' : s('gray', `  ${stepNo}/${options.steps}`);
+                write(`${bar}\n${s('cyan', RAIL.active)}  ${s('bold', title)}${n}\n`);
+                if (hint !== undefined)
+                    write(`${bar}  ${s('gray', hint)}\n`);
+                return;
+            }
             const n = options.steps === undefined ? '' : s('gray', `Step ${stepNo}/${options.steps} · `);
             const rule = terminal.unicode ? '─' : '-';
             const head = `${icon(name)}  ${n}${s('bold', title)}`;
@@ -146,7 +190,9 @@ export function createUi(out, terminal = PLAIN_TERMINAL, options = {}) {
         info: (text) => line(s('cyan', sym.info), text),
         warn: (text) => line(s('yellow', sym.warn), text),
         fail: (text) => line(s('red', sym.fail), text),
-        detail: (text) => write(`    ${s('gray', `${sym.dot} ${text}`)}\n`),
+        detail: (text) => write(rail
+            ? `${bar}    ${s('gray', `${sym.dot} ${text}`)}\n`
+            : `    ${s('gray', `${sym.dot} ${text}`)}\n`),
         async task(label, work) {
             const started = Date.now();
             const previous = spin;

package/dist/contacts/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: c572e760d811a5f6
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 2271aaa68e1a18a5
 // Bindings of module `contacts`: import the definition API from here to get types scoped to what it can see.
 export { defineModel, defineModule, extendModel, f, replace } from '../../server/orm.js';
 import { definitions } from '../../server/orm.js';

package/dist/contacts/.kosh/schema.d.ts

@@ -1,10 +1,11 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: c572e760d811a5f6
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 2271aaa68e1a18a5
 // Schema view of module `contacts` (RFC 0002 §7.7): the models it owns or depends on, with the extensions it can see.
 import type { F } from '../../server/orm.js';
 
 /** Model name → model type (RFC 0002 §7.7). */
 export interface SchemaView {
   readonly 'audit.event': AuditEvent;
+  readonly 'auth.api_key': AuthApiKey;
   readonly 'auth.credential': AuthCredential;
   readonly 'auth.session': AuthSession;
   readonly 'auth.user_grant': AuthUserGrant;
@@ -42,6 +43,34 @@ export interface AuditEvent {
 export interface AuditEventMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'audit.event'> {
 }
 
+/** `auth.api_key` (owner: base). */
+export interface AuthApiKey {
+  readonly name: 'auth.api_key';
+  readonly fields: {
+    readonly id: F.Id<'auth.api_key'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly name: F.Char<{ readonly required: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true }>;
+    readonly tokenHash: F.Char<{ readonly required: true }>;
+    readonly prefix: F.Char<{ readonly required: true }>;
+    readonly scopes: F.Text<{ readonly required: true }>;
+    readonly expiresAt: F.Datetime<{ readonly required: true }>;
+    readonly lastUsedAt: F.Datetime;
+    readonly lastUsedIp: F.Char;
+    readonly revoked: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly issuedBy: F.Many2one<'res.users'>;
+  };
+  readonly methods: AuthApiKeyMethods;
+}
+
+/** Methods of `auth.api_key`: declared ones and transitions. */
+export interface AuthApiKeyMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'auth.api_key'> {
+}
+
 /** `auth.credential` (owner: base). */
 export interface AuthCredential {
   readonly name: 'auth.credential';
@@ -173,6 +202,7 @@ export interface ResCompany {
     readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
     readonly name: F.Char<{ readonly required: true }>;
     readonly currency: F.Many2one<'res.currency', { readonly required: true }>;
+    readonly numberGrouping: F.Selection<'international' | 'lakh', { readonly required: true; readonly default: true }>;
   };
   readonly methods: ResCompanyMethods;
 }
@@ -226,6 +256,7 @@ export interface ResPartner {
     readonly city: F.Char;
     readonly zip: F.Char;
     readonly country: F.Char;
+    readonly state: F.Char;
     readonly taxId: F.Char;
     readonly isCustomer: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly isVendor: F.Bool<{ readonly required: true; readonly default: true }>;
@@ -258,6 +289,7 @@ export interface ResUsers {
     readonly companies: F.Many2many<'res.company', { readonly required: true }>;
     readonly lang: F.Char<{ readonly default: true }>;
     readonly tz: F.Char<{ readonly default: true }>;
+    readonly isService: F.Bool<{ readonly required: true; readonly default: true }>;
   };
   readonly methods: ResUsersMethods;
 }

package/dist/contacts/index.js

@@ -27,6 +27,27 @@ export const contacts = defineModule({
         user: { label: 'User', groups: ['contacts.user'] },
         manager: { label: 'Manager', groups: ['contacts.manager'], implies: ['user'] },
     },
+    // A sample customer sheet for the import screen (RFC 0014 §5.4), when Data import is installed.
+    importTemplates: [
+        {
+            key: 'customers',
+            model: 'res.partner',
+            label: 'Customers',
+            columns: [
+                { header: 'Name', field: 'name' },
+                { header: 'Company', field: 'isCompany' },
+                { header: 'Email', field: 'email' },
+                { header: 'Phone', field: 'phone' },
+                { header: 'Mobile', field: 'mobile' },
+                { header: 'Street', field: 'street' },
+                { header: 'City', field: 'city' },
+                { header: 'Postal code', field: 'zip' },
+                { header: 'Country', field: 'country' },
+                { header: 'Tax ID', field: 'taxId' },
+                { header: 'Customer', field: 'isCustomer' },
+            ],
+        },
+    ],
     actions: {
         'contacts.action_partners': action(ResPartner, {
             label: 'Contacts',
@@ -57,7 +78,9 @@ export const contacts = defineModule({
                 k.group('identity', ['name', 'isCompany', 'parent', 'taxId']),
                 k.group('reach', ['email', 'phone', 'mobile', 'website']),
                 k.notebook('more', [
-                    k.page('address', 'Address', [k.group('where', ['street', 'city', 'zip', 'country'])]),
+                    k.page('address', 'Address', [
+                        k.group('where', ['street', 'city', 'zip', 'state', 'country']),
+                    ]),
                     k.page('sales', 'Sales & purchase', [
                         k.group('roles', ['isCustomer', 'isVendor', 'currency']),
                     ]),

package/dist/contacts/module.d.ts

@@ -162,6 +162,16 @@ export declare const ResPartner: import("../server/orm.js").Model<"res.partner",
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly state: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     readonly taxId: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -335,6 +345,17 @@ export declare const ResPartner: import("../server/orm.js").Model<"res.partner",
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    /** State or province (ISO 3166-2: IN-MH, US-CA): the place of supply of taxes split by state. */
+    readonly state: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     /** VAT / BIN / tax identification number. */
     readonly taxId: import("../server/orm.js").CharField<{
         readonly required: false;
@@ -552,6 +573,16 @@ export declare const contactsShutro: import("../server/orm.js").Module<readonly
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly state: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     readonly taxId: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -725,6 +756,17 @@ export declare const contactsShutro: import("../server/orm.js").Module<readonly
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    /** State or province (ISO 3166-2: IN-MH, US-CA): the place of supply of taxes split by state. */
+    readonly state: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     /** VAT / BIN / tax identification number. */
     readonly taxId: import("../server/orm.js").CharField<{
         readonly required: false;

package/dist/contacts/module.js

@@ -32,6 +32,8 @@ export const ResPartner = defineModel('res.partner', {
         zip: f.char({ label: 'Postal code' }),
         /** ISO 3166 country code (BD, IN, US, ...). */
         country: f.char({ size: 2 }),
+        /** State or province (ISO 3166-2: IN-MH, US-CA): the place of supply of taxes split by state. */
+        state: f.char({ size: 6, label: 'State / province' }),
         /** VAT / BIN / tax identification number. */
         taxId: f.char({ label: 'Tax ID' }),
         isCustomer: f.boolean({ default: false, label: 'Customer' }),
@@ -49,7 +51,7 @@ export const ResPartner = defineModel('res.partner', {
 });
 export const contactsShutro = defineModule({
     name: 'contacts',
-    version: '0.1.0',
+    version: '0.2.0',
     depends: [baseShutro],
     groups: [
         orm.defineGroup({ code: 'contacts.user', label: 'Contacts user', implies: ['base.user'] }),

package/dist/import/convert.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Cells to field values (RFC 0014 §5.1 step 3): numbers with the file's decimal separator, exact decimals as text
+ * (money is never a JS `number`), dates in the file's day order or ISO, booleans in English and Bangla, selections by
+ * value or label. Bangla digits read as digits. Relations are matched elsewhere (`match.ts`): here they are text.
+ */
+/** A cell as read from a file: CSV cells are text, XLSX cells are typed. */
+export type Cell = string | number | boolean | Date | null;
+export interface ConvertOptions {
+    /** Day order of dates written as text (`03/04/2026`). Default `dmy`. */
+    readonly dateOrder?: 'dmy' | 'mdy' | 'ymd';
+    /** Decimal separator of numbers written as text. Default `.`. */
+    readonly decimal?: '.' | ',';
+    /** Time zone of date-times without an offset. Default `UTC`. */
+    readonly timeZone?: string;
+}
+export interface ConvertField {
+    readonly key: string;
+    readonly kind: string;
+    readonly label: string;
+    readonly options: readonly (readonly [string, string])[] | null;
+}
+/** Why a cell could not be read: a stable code for the UI's messages, and an English text. */
+export interface CellError {
+    readonly code: 'not-a-number' | 'not-an-integer' | 'not-a-date' | 'not-a-datetime' | 'not-a-boolean' | 'not-an-option' | 'not-importable';
+    readonly message: string;
+}
+export type Converted = {
+    readonly value: unknown;
+} | {
+    readonly error: CellError;
+};
+/** Text with Bangla digits as ASCII digits. */
+export declare function asciiDigits(text: string): string;
+/** Whether a field kind can be imported from a cell (relations included; binary and json are not). */
+export declare function importable(kind: string): boolean;
+/** `1,234.50` (or `1.234,50`) → `1234.50`; null when it is not a number. */
+export declare function plainNumber(text: string, decimal: '.' | ','): string | null;
+/** The calendar date of `text` (`2026-04-03`, `03/04/2026` in the day order, `3.4.26`), or null. */
+export declare function parseDate(text: string, order: 'dmy' | 'mdy' | 'ymd'): string | null;
+/** The instant of a wall-clock time in `timeZone`. */
+export declare function zoned(wall: {
+    y: number;
+    mo: number;
+    d: number;
+    h: number;
+    mi: number;
+    s: number;
+}, timeZone: string): Date;
+/** A date and time from text: ISO with an offset as is, else a wall-clock time in `timeZone`. */
+export declare function parseDateTime(text: string, order: 'dmy' | 'mdy' | 'ymd', timeZone: string): Date | null;
+/**
+ * One cell as a value of `field`. Empty cells are `undefined` (left out) — the caller decides between leaving the
+ * field to its default and clearing it.
+ */
+export declare function convertCell(field: ConvertField, cell: Cell, options?: ConvertOptions): Converted | undefined;

package/dist/import/convert.js

@@ -0,0 +1,224 @@
+/**
+ * Cells to field values (RFC 0014 §5.1 step 3): numbers with the file's decimal separator, exact decimals as text
+ * (money is never a JS `number`), dates in the file's day order or ISO, booleans in English and Bangla, selections by
+ * value or label. Bangla digits read as digits. Relations are matched elsewhere (`match.ts`): here they are text.
+ */
+const BANGLA_DIGITS = /[০-৯]/g;
+/** Text with Bangla digits as ASCII digits. */
+export function asciiDigits(text) {
+    return text.replace(BANGLA_DIGITS, (d) => String(d.charCodeAt(0) - 0x09e6));
+}
+const TRUE = new Set(['true', 'yes', 'y', '1', 'x', '✓', 'on', 'হ্যাঁ', 'সত্য', 'হাঁ']);
+const FALSE = new Set(['false', 'no', 'n', '0', 'off', 'না', 'মিথ্যা']);
+/** Whether a field kind can be imported from a cell (relations included; binary and json are not). */
+export function importable(kind) {
+    return kind !== 'binary' && kind !== 'json' && kind !== 'one2many';
+}
+/** `1,234.50` (or `1.234,50`) → `1234.50`; null when it is not a number. */
+export function plainNumber(text, decimal) {
+    let v = asciiDigits(text.trim()).replace(/[\s  '৳$€£¥₹]/g, '');
+    let negative = false;
+    if (/^\(.*\)$/.test(v)) {
+        negative = true; // accounting negatives: (1,200.00)
+        v = v.slice(1, -1);
+    }
+    if (v.startsWith('-')) {
+        negative = !negative;
+        v = v.slice(1);
+    }
+    else if (v.startsWith('+'))
+        v = v.slice(1);
+    const thousands = decimal === '.' ? ',' : '.';
+    if (v.includes(thousands)) {
+        // Groups of three after the first: 1,234,567 — anything else is not a thousands separator.
+        const [whole, ...rest] = v.split(decimal);
+        if (rest.length > 1)
+            return null;
+        const groups = (whole ?? '').split(thousands);
+        if (groups.slice(1).some((g) => g.length !== 3) || (groups[0] ?? '').length === 0)
+            return null;
+        v = [groups.join(''), ...rest].join('.');
+    }
+    else if (decimal === ',')
+        v = v.replace(',', '.');
+    if (!/^(\d+(\.\d*)?|\.\d+)$/.test(v))
+        return null;
+    if (v.startsWith('.'))
+        v = `0${v}`;
+    if (v.endsWith('.'))
+        v = v.slice(0, -1);
+    return negative && !/^0(\.0*)?$/.test(v) ? `-${v}` : v;
+}
+/** A JS number as plain decimal text (no exponent). */
+function numberText(n) {
+    if (Number.isInteger(n))
+        return BigInt(n).toString();
+    const text = String(n);
+    if (!/e/i.test(text))
+        return text;
+    return n.toFixed(20).replace(/0+$/, '').replace(/\.$/, '');
+}
+const pad = (n, width = 2) => String(n).padStart(width, '0');
+const ymd = (y, m, d) => `${pad(y, 4)}-${pad(m)}-${pad(d)}`;
+function validDate(y, m, d) {
+    const date = new Date(Date.UTC(y, m - 1, d));
+    return date.getUTCFullYear() === y && date.getUTCMonth() === m - 1 && date.getUTCDate() === d;
+}
+/** The calendar date of `text` (`2026-04-03`, `03/04/2026` in the day order, `3.4.26`), or null. */
+export function parseDate(text, order) {
+    const v = asciiDigits(text.trim());
+    const iso = /^(\d{4})-(\d{1,2})-(\d{1,2})/.exec(v);
+    let parts = null;
+    if (iso !== null)
+        parts = [Number(iso[1]), Number(iso[2]), Number(iso[3])];
+    else {
+        const m = /^(\d{1,4})[/.\-\s](\d{1,2})[/.\-\s](\d{1,4})$/.exec(v);
+        if (m === null)
+            return null;
+        const [a, b, c] = [Number(m[1]), Number(m[2]), Number(m[3])];
+        if (m[1].length === 4)
+            parts = [a, b, c];
+        else {
+            const year = m[3].length <= 2 ? 2000 + c : c;
+            parts = order === 'mdy' ? [year, a, b] : [year, b, a];
+        }
+    }
+    const [y, mo, d] = parts;
+    return validDate(y, mo, d) ? ymd(y, mo, d) : null;
+}
+/** The offset of `timeZone` from UTC at `utc`, in milliseconds. */
+function offsetOf(timeZone, utc) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    }).formatToParts(new Date(utc));
+    const get = (type) => Number(parts.find((p) => p.type === type)?.value ?? 0);
+    const local = Date.UTC(get('year'), get('month') - 1, get('day'), get('hour'), get('minute'), get('second'));
+    return local - utc;
+}
+/** The instant of a wall-clock time in `timeZone`. */
+export function zoned(wall, timeZone) {
+    const guess = Date.UTC(wall.y, wall.mo - 1, wall.d, wall.h, wall.mi, wall.s);
+    const first = guess - offsetOf(timeZone, guess);
+    return new Date(guess - offsetOf(timeZone, first));
+}
+/** A date and time from text: ISO with an offset as is, else a wall-clock time in `timeZone`. */
+export function parseDateTime(text, order, timeZone) {
+    const v = asciiDigits(text.trim());
+    if (/^\d{4}-\d{2}-\d{2}T.*(Z|[+-]\d{2}:?\d{2})$/.test(v)) {
+        const date = new Date(v);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    const m = /^(.+?)(?:[T\s]+(\d{1,2}):(\d{2})(?::(\d{2}))?\s*([AaPp][Mm])?)?$/.exec(v);
+    if (m === null)
+        return null;
+    const day = parseDate(m[1], order);
+    if (day === null)
+        return null;
+    let h = Number(m[2] ?? 0);
+    const mi = Number(m[3] ?? 0);
+    const s = Number(m[4] ?? 0);
+    const meridiem = m[5]?.toLowerCase();
+    if (meridiem !== undefined) {
+        if (h < 1 || h > 12)
+            return null;
+        h = (h % 12) + (meridiem === 'pm' ? 12 : 0);
+    }
+    if (h > 23 || mi > 59 || s > 59)
+        return null;
+    const [y, mo, d] = day.split('-').map(Number);
+    return zoned({ y, mo, d, h, mi, s }, timeZone);
+}
+const fail = (code, field, cell, what) => ({
+    error: { code, message: `${field.label}: "${String(cell)}" is not ${what}.` },
+});
+/**
+ * One cell as a value of `field`. Empty cells are `undefined` (left out) — the caller decides between leaving the
+ * field to its default and clearing it.
+ */
+export function convertCell(field, cell, options = {}) {
+    if (cell === null || (typeof cell === 'string' && cell.trim() === ''))
+        return undefined;
+    const order = options.dateOrder ?? 'dmy';
+    const decimal = options.decimal ?? '.';
+    const timeZone = options.timeZone ?? 'UTC';
+    switch (field.kind) {
+        case 'char':
+        case 'text':
+        case 'html':
+        case 'many2one':
+        case 'many2many':
+            if (cell instanceof Date)
+                return { value: cell.toISOString().slice(0, cell.getUTCHours() === 0 ? 10 : 19) };
+            return { value: typeof cell === 'number' ? numberText(cell) : String(cell).trim() };
+        case 'boolean': {
+            if (typeof cell === 'boolean')
+                return { value: cell };
+            if (typeof cell === 'number' && (cell === 0 || cell === 1))
+                return { value: cell === 1 };
+            const v = String(cell).trim().toLowerCase();
+            if (TRUE.has(v))
+                return { value: true };
+            if (FALSE.has(v))
+                return { value: false };
+            return fail('not-a-boolean', field, cell, 'yes or no');
+        }
+        case 'integer':
+        case 'bigint': {
+            const text = typeof cell === 'number' ? numberText(cell) : plainNumber(String(cell), decimal);
+            if (text === null || !/^-?\d+$/.test(text))
+                return fail('not-an-integer', field, cell, 'a whole number');
+            return { value: field.kind === 'bigint' ? text : Number(text) };
+        }
+        case 'float':
+        case 'decimal':
+        case 'monetary':
+        case 'quantity': {
+            if (typeof cell === 'boolean' || cell instanceof Date)
+                return fail('not-a-number', field, cell, 'a number');
+            const text = typeof cell === 'number' ? numberText(cell) : plainNumber(cell, decimal);
+            if (text === null)
+                return fail('not-a-number', field, cell, 'a number');
+            return { value: field.kind === 'float' ? Number(text) : text };
+        }
+        case 'date': {
+            if (cell instanceof Date)
+                return { value: cell.toISOString().slice(0, 10) };
+            const day = typeof cell === 'string' ? parseDate(cell, order) : null;
+            return day === null ? fail('not-a-date', field, cell, 'a date') : { value: day };
+        }
+        case 'datetime': {
+            if (cell instanceof Date) {
+                // Spreadsheet dates have no zone: their wall-clock time is in the file's time zone.
+                const [y, mo, d, h, mi, s] = [
+                    cell.getUTCFullYear(),
+                    cell.getUTCMonth() + 1,
+                    cell.getUTCDate(),
+                    cell.getUTCHours(),
+                    cell.getUTCMinutes(),
+                    cell.getUTCSeconds(),
+                ];
+                return { value: zoned({ y, mo, d, h, mi, s }, timeZone) };
+            }
+            const at = typeof cell === 'string' ? parseDateTime(cell, order, timeZone) : null;
+            return at === null ? fail('not-a-datetime', field, cell, 'a date and time') : { value: at };
+        }
+        case 'selection':
+        case 'state': {
+            const v = (typeof cell === 'number' ? numberText(cell) : String(cell)).trim();
+            const lower = v.toLowerCase();
+            const option = (field.options ?? []).find(([value, label]) => value === v || label.toLowerCase() === lower);
+            return option === undefined
+                ? fail('not-an-option', field, cell, `one of ${(field.options ?? []).map(([, l]) => l).join(', ')}`)
+                : { value: option[0] };
+        }
+        default:
+            return fail('not-importable', field, cell, 'importable');
+    }
+}