shutro-erp 0.2.0 → 0.3.0

package/dist/cli/prompt.js

@@ -3,6 +3,52 @@
  * non-interactive installs (`--yes` with flags): every question goes through {@link Prompter}.
  */
 import { createInterface } from 'node:readline';
+/**
+ * One of `choices`: the prompter's list when it has one, otherwise the question `fallback` (pipes, scripts, tests),
+ * answered with an option's number, value or label.
+ */
+export async function choose(prompter, q) {
+    if (prompter.select !== undefined)
+        return prompter.select(q);
+    const find = (answer) => {
+        const a = answer.trim().toLowerCase();
+        if (/^\d+$/.test(a))
+            return q.choices[Number(a) - 1];
+        return q.choices.find((c) => c.value.toLowerCase() === a || c.label.toLowerCase() === a);
+    };
+    const answer = await prompter.ask({
+        message: q.fallback,
+        ...(q.default === undefined ? {} : { default: q.default }),
+        validate: (v) => find(v) === undefined ? `One of ${q.choices.map((c) => c.value).join(', ')}` : null,
+    });
+    return find(answer).value;
+}
+/** Several of `choices`: the prompter's list, or a comma-separated answer to `fallback`. */
+export async function chooseMany(prompter, q) {
+    if (prompter.multiselect !== undefined)
+        return prompter.multiselect(q);
+    const known = new Set(q.choices.map((c) => c.value));
+    const answer = await prompter.ask({
+        message: q.fallback,
+        default: (q.defaults ?? []).join(','),
+        validate: (v) => {
+            const items = v
+                .split(',')
+                .map((x) => x.trim())
+                .filter((x) => x !== '');
+            const unknown = items.filter((x) => !known.has(x));
+            if (unknown.length > 0)
+                return `Unknown: ${unknown.join(', ')}`;
+            return q.required === true && items.length === 0 ? 'Choose at least one.' : null;
+        },
+    });
+    return [
+        ...new Set(answer
+            .split(',')
+            .map((x) => x.trim())
+            .filter((x) => x !== '')),
+    ];
+}
 /** Thrown when the input ends before every question is answered (piped answers ran out, Ctrl+D). */
 export class InputEndedError extends Error {
     constructor(question) {

package/dist/cli/templates.d.ts

@@ -2,7 +2,7 @@
  * The starter project `kosh init` writes: an API server and the back-office app, both importing `shutro-erp`.
  * Server files run on Node.js directly (type stripping); the back-office is a Vite app proxying `/api` to the server.
  */
-export type AppName = 'permissions' | 'reporting' | 'messaging' | 'contacts' | 'product' | 'sales' | 'purchase' | 'accounting' | 'sale_account' | 'purchase_account' | 'project' | 'sale_project';
+export type AppName = 'permissions' | 'reporting' | 'messaging' | 'contacts' | 'product' | 'sales' | 'purchase' | 'accounting' | 'sale_account' | 'purchase_account' | 'project' | 'sale_project' | 'l10n_bd' | 'l10n_in';
 export interface AppSpec {
     readonly label: string;
     /** Shown next to the app in the installer (where the terminal shows pictographs). */
@@ -13,6 +13,8 @@ export interface AppSpec {
     readonly web?: string;
     /** A bridge (RFC 0008 §5.1): not offered in the installer; proposed when the apps it connects are installed. */
     readonly bridge?: readonly AppName[];
+    /** A localization (RFC 0016): installed, with its bridged apps, for a company in this country (ISO 3166). */
+    readonly country?: string;
 }
 /** The apps `kosh init` can install (base and Settings are always there), in the order the installer lists them. */
 export declare const APPS: Readonly<Record<AppName, AppSpec>>;
@@ -20,6 +22,8 @@ export interface StarterOptions {
     readonly name: string;
     readonly apps: readonly AppName[];
     readonly port: number;
+    /** The back-office's port in development (default 5173). */
+    readonly webPort?: number;
     readonly koshVersion: string;
     /** The database name of the Docker PostgreSQL service (compose.yaml). */
     readonly dockerDb?: string;
@@ -52,5 +56,9 @@ export declare function tsconfig(): string;
 export declare function readme(options: StarterOptions): string;
 /** The apps the installer offers (every app but the bridges, which come by themselves). */
 export declare const SELECTABLE_APPS: readonly AppName[];
-/** The bridges whose every connected app is in `apps`. */
-export declare function bridgesFor(apps: readonly AppName[]): AppName[];
+/** The bridges whose every connected app is in `apps`, and the localization of `country` among them. */
+export declare function bridgesFor(apps: readonly AppName[], country?: string): AppName[];
+/** The names of the countries with a localization (the installer's list). */
+export declare const COUNTRY_NAMES: Readonly<Record<string, string>>;
+/** The countries with a localization, for the installer's question. */
+export declare const LOCALIZED_COUNTRIES: readonly string[];

package/dist/cli/templates.js

@@ -67,6 +67,22 @@ export const APPS = {
         server: 'saleProject',
         bridge: ['sales', 'project'],
     },
+    l10n_bd: {
+        label: 'Bangladesh: chart of accounts, VAT and SD, VDS and TDS, BIN and TIN, July–June year',
+        icon: '🇧🇩',
+        server: 'l10nBd',
+        web: 'registerL10nBdWeb',
+        bridge: ['accounting'],
+        country: 'BD',
+    },
+    l10n_in: {
+        label: 'India: GST (CGST / SGST / IGST), cess, reverse charge, GSTIN, HSN / SAC, TDS, April–March year',
+        icon: '🇮🇳',
+        server: 'l10nIn',
+        web: 'registerL10nInWeb',
+        bridge: ['accounting'],
+        country: 'IN',
+    },
 };
 const REACT = {
     react: '^19.1.0',
@@ -125,10 +141,11 @@ import { notify } from 'shutro-erp/notify';
 import { realtime } from 'shutro-erp/realtime';
 import { settings } from 'shutro-erp/settings';
 import { assistant } from 'shutro-erp/assistant';
+import { dataImport } from 'shutro-erp/import';
 import { studio } from 'shutro-erp/studio';
 ${imports.join('\n')}
 
-export const modules = [base, settings, realtime, notify, mail, automation, studio, assistant${apps.map((a) => `, ${APPS[a].server}`).join('')}];
+export const modules = [base, settings, realtime, notify, mail, automation, studio, dataImport, assistant${apps.map((a) => `, ${APPS[a].server}`).join('')}];
 `;
 }
 export function serverTs() {
@@ -164,8 +181,8 @@ const api = process.env['KOSH_API'] ?? 'http://localhost:${options.port}';
 export default defineConfig({
   // koshPwa: the service worker (the app opens offline and gets web push)
   plugins: [react(), tailwindcss(), koshPwa()],
-  server: { proxy: { '/api': { target: api, ws: true } } },
-  preview: { proxy: { '/api': { target: api, ws: true } } },
+  server: { port: ${options.webPort ?? 5173}, proxy: { '/api': { target: api, ws: true } } },
+  preview: { port: ${options.webPort ?? 5173}, proxy: { '/api': { target: api, ws: true } } },
 });
 `;
 }
@@ -201,6 +218,7 @@ export function mainTsx(_options) {
         { name: 'automation', fn: 'registerAutomationWeb' },
         { name: 'studio', fn: 'registerStudioWeb' },
         { name: 'assistant', fn: 'registerAssistantWeb' },
+        { name: 'import', fn: 'registerImportWeb' },
     ].map(({ name, fn }) => {
         const messages = name === 'permissions' ? null : `${name}Messages`;
         return {
@@ -418,7 +436,7 @@ A [Kosh](https://www.npmjs.com/package/shutro-erp) installation, created with \`
 \`\`\`sh
 npm install
 npm start          # the API on http://localhost:${options.port}
-npm run web        # the back-office on http://localhost:5173 (sign in as the administrator)
+npm run web        # the back-office on http://localhost:${options.webPort ?? 5173} (sign in as the administrator)
 npx kosh migrate   # after changing modules: plan and apply database migrations, load seed data
 npx kosh seed      # load seed data again
 # Settings → Apps in the back-office installs, enables and disables apps (or, in the terminal:)
@@ -435,9 +453,16 @@ Settings (database, file storage, port) are in \`.env\`, which is not committed.
 }
 /** The apps the installer offers (every app but the bridges, which come by themselves). */
 export const SELECTABLE_APPS = Object.keys(APPS).filter((a) => APPS[a].bridge === undefined);
-/** The bridges whose every connected app is in `apps`. */
-export function bridgesFor(apps) {
+/** The bridges whose every connected app is in `apps`, and the localization of `country` among them. */
+export function bridgesFor(apps, country = '') {
     return Object.keys(APPS).filter((a) => {
-        return APPS[a].bridge?.every((b) => apps.includes(b)) === true;
+        const spec = APPS[a];
+        if (spec.country !== undefined && spec.country !== country)
+            return false;
+        return spec.bridge?.every((b) => apps.includes(b)) === true;
     });
 }
+/** The names of the countries with a localization (the installer's list). */
+export const COUNTRY_NAMES = { BD: 'Bangladesh', IN: 'India' };
+/** The countries with a localization, for the installer's question. */
+export const LOCALIZED_COUNTRIES = Object.values(APPS).flatMap((a) => a.country === undefined ? [] : [a.country]);

package/dist/cli/tui.d.ts

@@ -0,0 +1,7 @@
+import type { Prompter } from './prompt.js';
+import { type Terminal } from './ui.js';
+/** Thrown when the user stops the installer (Ctrl+C) during a question. */
+export declare class CancelledError extends Error {
+    constructor();
+}
+export declare function interactivePrompter(input: NodeJS.ReadStream, output: NodeJS.WriteStream, terminal: Terminal): Prompter;

package/dist/cli/tui.js

@@ -0,0 +1,254 @@
+/**
+ * The installer's questions on a terminal (no dependency): one question at a time on the rail of `ui.ts`, answered
+ * with the keyboard — text with the default shown until typed over, secrets masked, choices with ↑ ↓ and Enter,
+ * several choices with Space, Yes / No with ← →. An answered question collapses to one dimmed line; a refused
+ * answer shows why under the input. Ctrl+C stops the installer. Not a terminal (pipes, tests): `prompt.ts` asks
+ * line by line instead.
+ */
+import { emitKeypressEvents } from 'node:readline';
+import { ESC, RAIL, stylerFor, width } from './ui.js';
+/** Thrown when the user stops the installer (Ctrl+C) during a question. */
+export class CancelledError extends Error {
+    constructor() {
+        super('Cancelled.');
+        this.name = 'CancelledError';
+    }
+}
+export function interactivePrompter(input, output, terminal) {
+    const s = stylerFor(terminal);
+    const columns = () => Math.max(40, output.columns ?? terminal.columns);
+    /** Terminal rows `text` takes (long lines wrap). */
+    const rows = (text) => text
+        .split('\n')
+        .slice(0, -1)
+        .reduce((n, line) => n + Math.max(1, Math.ceil(width(line) / columns())), 0);
+    const bar = (status) => status === 'error'
+        ? s('yellow', RAIL.bar)
+        : status === 'active'
+            ? s('cyan', RAIL.bar)
+            : s('gray', RAIL.bar);
+    const head = (status, message) => {
+        const mark = status === 'active'
+            ? s('cyan', RAIL.active)
+            : status === 'error'
+                ? s('yellow', RAIL.error)
+                : status === 'cancel'
+                    ? s('red', RAIL.cancel)
+                    : s('green', RAIL.done);
+        return `${s('gray', RAIL.bar)}\n${mark}  ${status === 'done' ? message : s('bold', message)}\n`;
+    };
+    const foot = (status, error) => status === 'error'
+        ? `${s('yellow', RAIL.end)}  ${s('yellow', error ?? '')}\n`
+        : status === 'active'
+            ? `${s('cyan', RAIL.end)}\n`
+            : '';
+    const cursor = s('inverse', ' ');
+    function run(widget) {
+        return new Promise((resolve, reject) => {
+            let drawn = 0;
+            let error = null;
+            const draw = (status) => {
+                const text = widget.frame(status, error);
+                if (drawn > 0)
+                    output.write(`${ESC}${drawn}A\r`);
+                output.write(`${ESC}J${text}`);
+                drawn = rows(text);
+            };
+            const finish = () => {
+                input.off('keypress', onKey);
+                if (input.isTTY)
+                    input.setRawMode(false);
+                input.pause();
+                output.write(`${ESC}?25h`);
+            };
+            const onKey = (text, key = {}) => {
+                if (key.ctrl === true && (key.name === 'c' || key.name === 'd')) {
+                    draw('cancel');
+                    finish();
+                    reject(new CancelledError());
+                    return;
+                }
+                const action = widget.key(text, key);
+                if (action === 'submit') {
+                    const value = widget.value();
+                    const problem = widget.validate?.(value) ?? null;
+                    if (problem === null) {
+                        error = null;
+                        draw('done');
+                        finish();
+                        resolve(value);
+                        return;
+                    }
+                    error = problem;
+                    draw('error');
+                    return;
+                }
+                draw(error === null ? 'active' : 'error');
+            };
+            emitKeypressEvents(input);
+            if (input.isTTY)
+                input.setRawMode(true);
+            input.resume();
+            output.write(`${ESC}?25l`);
+            input.on('keypress', onKey);
+            draw('active');
+        });
+    }
+    /** The question without the indentation of sub-questions (the rail aligns them). */
+    const label = (message) => message.trim();
+    function text(q) {
+        let value = '';
+        return run({
+            frame(status, error) {
+                const shown = q.secret === true ? '•'.repeat(value.length) : value;
+                if (status === 'done' || status === 'cancel') {
+                    const answer = q.secret === true
+                        ? s('gray', '•'.repeat(Math.min(12, (value || q.default || '').length)))
+                        : s('gray', value === '' ? (q.default ?? '') : value);
+                    return `${head(status, label(q.message))}${bar(status)}  ${status === 'cancel' ? s('gray', 'cancelled') : answer}\n`;
+                }
+                const placeholder = value === '' && q.default !== undefined && q.default !== '' && q.secret !== true
+                    ? s('gray', q.default)
+                    : '';
+                return `${head(status, label(q.message))}${bar(status)}  ${shown}${cursor}${placeholder}\n${foot(status, error)}`;
+            },
+            key(input, key) {
+                if (key.name === 'return' || key.name === 'enter')
+                    return 'submit';
+                if (key.name === 'backspace')
+                    value = value.slice(0, -1);
+                else if (key.ctrl === true && key.name === 'u')
+                    value = '';
+                else if (key.name === 'tab' && value === '' && q.default !== undefined)
+                    value = q.default;
+                else if (input !== undefined &&
+                    key.ctrl !== true &&
+                    key.meta !== true &&
+                    [...input].every((ch) => ch >= ' ' && ch !== '\x7f'))
+                    value += input;
+                return undefined;
+            },
+            value: () => (value.trim() === '' ? (q.default ?? '') : value.trim()),
+            validate: (v) => q.validate?.(v) ?? null,
+        });
+    }
+    const labelWidth = (choices) => Math.max(...choices.map((c) => width(c.label)));
+    /** An option: its mark, its label (bright when focused, with a ❯ pointer), its hint aligned after it. */
+    const optionLine = (c, mark, focused, pad) => {
+        const name = focused ? s('bold', c.label) : c.label;
+        const gap = ' '.repeat(Math.max(0, pad - width(c.label)) + 2);
+        const hint = c.hint === undefined ? '' : `${gap}${s('gray', c.hint)}`;
+        return `${focused ? s('cyan', '❯') : ' '} ${mark} ${name}${hint}`;
+    };
+    function select(q) {
+        let at = Math.max(0, q.choices.findIndex((c) => c.value === q.default));
+        return run({
+            frame(status) {
+                const chosen = q.choices[at];
+                if (status === 'done' || status === 'cancel')
+                    return `${head(status, q.message)}${bar(status)}  ${s('gray', status === 'cancel' ? 'cancelled' : (chosen?.label ?? ''))}\n`;
+                const list = q.choices
+                    .map((c, i) => `${bar(status)} ${optionLine(c, i === at ? s('cyan', '●') : s('gray', '○'), i === at, labelWidth(q.choices))}`)
+                    .join('\n');
+                return `${head(status, q.message)}${list}\n${foot(status, null)}`;
+            },
+            key(_text, key) {
+                if (key.name === 'return' || key.name === 'enter')
+                    return 'submit';
+                if (key.name === 'up' || key.name === 'k')
+                    at = (at - 1 + q.choices.length) % q.choices.length;
+                if (key.name === 'down' || key.name === 'j' || key.name === 'tab')
+                    at = (at + 1) % q.choices.length;
+                return undefined;
+            },
+            value: () => q.choices[at]?.value ?? '',
+        });
+    }
+    function multiselect(q) {
+        let at = 0;
+        const picked = new Set(q.defaults ?? []);
+        const values = () => q.choices.filter((c) => picked.has(c.value)).map((c) => c.value);
+        return run({
+            frame(status, error) {
+                if (status === 'done' || status === 'cancel') {
+                    const names = q.choices.filter((c) => picked.has(c.value)).map((c) => c.label);
+                    return `${head(status, q.message)}${bar(status)}  ${s('gray', status === 'cancel' ? 'cancelled' : names.length === 0 ? 'none' : names.join(', '))}\n`;
+                }
+                const list = q.choices
+                    .map((c, i) => {
+                    const mark = picked.has(c.value) ? s('green', '◼') : s('gray', '◻');
+                    return `${bar(status)} ${optionLine(c, mark, i === at, labelWidth(q.choices))}`;
+                })
+                    .join('\n');
+                const help = s('gray', '↑↓ move · Space toggle · a all · Enter confirm');
+                return `${head(status, q.message)}${list}\n${bar(status)}  ${help}\n${foot(status, error)}`;
+            },
+            key(text, key) {
+                if (key.name === 'return' || key.name === 'enter')
+                    return 'submit';
+                if (key.name === 'up' || key.name === 'k')
+                    at = (at - 1 + q.choices.length) % q.choices.length;
+                else if (key.name === 'down' || key.name === 'j' || key.name === 'tab')
+                    at = (at + 1) % q.choices.length;
+                else if (key.name === 'space' || text === ' ') {
+                    const c = q.choices[at];
+                    if (c !== undefined) {
+                        if (picked.has(c.value))
+                            picked.delete(c.value);
+                        else
+                            picked.add(c.value);
+                    }
+                }
+                else if (key.name === 'a') {
+                    if (picked.size === q.choices.length)
+                        picked.clear();
+                    else
+                        for (const c of q.choices)
+                            picked.add(c.value);
+                }
+                return undefined;
+            },
+            value: values,
+            validate: (v) => (q.required === true && v.length === 0 ? 'Choose at least one.' : null),
+        });
+    }
+    function confirm(message, fallback) {
+        let yes = fallback;
+        return run({
+            frame(status) {
+                if (status === 'done' || status === 'cancel')
+                    return `${head(status, label(message))}${bar(status)}  ${s('gray', status === 'cancel' ? 'cancelled' : yes ? 'Yes' : 'No')}\n`;
+                const option = (on, name) => on ? `${s('cyan', '●')} ${name}` : `${s('gray', '○')} ${s('gray', name)}`;
+                return `${head(status, label(message))}${bar(status)}  ${option(yes, 'Yes')} ${s('gray', '/')} ${option(!yes, 'No')}\n${foot(status, null)}`;
+            },
+            key(text, key) {
+                if (key.name === 'return' || key.name === 'enter')
+                    return 'submit';
+                if (key.name === 'left' ||
+                    key.name === 'right' ||
+                    key.name === 'tab' ||
+                    key.name === 'h' ||
+                    key.name === 'l')
+                    yes = !yes;
+                else if (text?.toLowerCase() === 'y')
+                    yes = true;
+                else if (text?.toLowerCase() === 'n')
+                    yes = false;
+                return undefined;
+            },
+            value: () => yes,
+        });
+    }
+    return {
+        ask: text,
+        confirm,
+        select,
+        multiselect,
+        close() {
+            if (input.isTTY)
+                input.setRawMode(false);
+            input.pause();
+            output.write(`${ESC}?25h`);
+        },
+    };
+}

package/dist/cli/ui.d.ts

@@ -1,8 +1,9 @@
 /**
- * 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, 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.
  */
 /** What the terminal can show. */
 export interface Terminal {
@@ -23,8 +24,23 @@ export declare function detectTerminal(stream: {
     readonly isTTY?: boolean;
     readonly columns?: number;
 }, env?: Env, platform?: string): Terminal;
+export declare const ESC = "\u001B[";
 /** The colours and weights the installer uses. */
-export type Style = 'bold' | 'dim' | 'green' | 'yellow' | 'red' | 'cyan' | 'magenta' | 'gray';
+export type Style = 'bold' | 'dim' | 'inverse' | 'underline' | 'green' | 'yellow' | 'red' | 'cyan' | 'magenta' | 'gray';
+/** Styles text for `terminal` (no escape codes without colour). */
+export declare function stylerFor(terminal: Terminal): (name: Style, text: string) => string;
+/** The rail and its marks (Unicode terminals that animate), shared with the interactive prompter. */
+export declare const RAIL: {
+    readonly bar: '│';
+    readonly start: '┌';
+    readonly end: '└';
+    readonly active: '◆';
+    readonly done: '◇';
+    readonly error: '▲';
+    readonly cancel: '■';
+};
+/** Whether `terminal` gets the rail look (a TTY that shows Unicode). */
+export declare const railed: (terminal: Terminal) => boolean;
 /** Columns a string takes: escape codes take none, pictographs two. */
 export declare function width(text: string): number;
 /** The step icons: a pictograph where the terminal shows them, a symbol otherwise. */
@@ -58,6 +74,10 @@ export interface Ui {
     style(name: Style, text: string): string;
     icon(name: IconName): string;
     banner(subtitle: string): Promise<void>;
+    /** Opens the rail (┌ title) under the banner, with a hint line. */
+    intro(title: string, hint: string): void;
+    /** Closes the rail (└ text). */
+    outro(text: string): void;
     /** A numbered step title: "🗄️  Step 1/6 · Database". */
     step(icon: IconName, title: string, hint?: string): void;
     ok(text: string): void;

package/dist/cli/ui.js

@@ -1,8 +1,9 @@
 /**
- * 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, 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.
  */
 /** Plain output: logs, tests, pipes. */
 export const PLAIN_TERMINAL = Object.freeze({
@@ -32,11 +33,13 @@ export function detectTerminal(stream, env = process.env, platform = process.pla
         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 +47,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;
@@ -86,7 +105,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 +125,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,
@@ -132,8 +153,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 +184,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: 07f36b4355890ebe
 // 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,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: 07f36b4355890ebe
 // 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';
 
@@ -173,6 +173,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 +227,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 }>;