shutro-erp 0.2.1 → 0.3.1

package/dist/cli/templates.js

@@ -1,8 +1,8 @@
 /**
- * The starter project `kosh init` writes: an API server and the back-office app, both importing `shutro-erp`.
+ * The starter project `shutro-erp 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.
  */
-/** The apps `kosh init` can install (base and Settings are always there), in the order the installer lists them. */
+/** The apps `shutro-erp init` can install (base and Settings are always there), in the order the installer lists them. */
 export const APPS = {
     permissions: {
         label: 'Roles, field security and approvals',
@@ -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',
@@ -89,8 +105,8 @@ export function packageJson(options, existing) {
             start: 'node --env-file=.env src/server.ts',
             web: 'vite',
             'build:web': 'vite build',
-            migrate: 'kosh migrate',
-            seed: 'kosh seed',
+            migrate: 'shutro-erp migrate',
+            seed: 'shutro-erp seed',
             'docker:up': 'docker compose up -d --build',
         }),
         engines: { node: '>=24', ...(base['engines'] ?? {}) },
@@ -114,7 +130,7 @@ export function modulesTs(_options) {
     const imports = apps.map((a) => `import { ${APPS[a].server} } from 'shutro-erp/${a}';`);
     return `/**
  * The apps this installation can install (the catalogue). The database records which are installed: Settings → Apps
- * in the back-office, or \`npx kosh apps\`, installs, disables and enables them. \`base\` (users, companies, sign-in)
+ * in the back-office, or \`npx shutro-erp apps\`, installs, disables and enables them. \`base\` (users, companies, sign-in)
  * and Settings are always installed. Add your own modules here (\`defineModule\` from \`shutro-erp/modules-sdk\`),
  * then install them from Settings → Apps.
  */
@@ -125,15 +141,16 @@ 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() {
     return `/**
- * The Kosh API server: \`npm start\` (reads .env). It serves the installed apps of src/modules.ts, and switches to
+ * The Shutro ERP API server: \`npm start\` (reads .env). It serves the installed apps of src/modules.ts, and switches to
  * the new set without a restart when apps are installed or disabled (here or on another server).
  */
 import { createAppHost, startAppHost } from 'shutro-erp';
@@ -145,11 +162,11 @@ const host = await createAppHost({
   catalogue: modules,
   migrationsDir: 'migrations',
   ...(env['VALKEY_URL'] ? { valkeyUrl: env['VALKEY_URL'] } : {}),
-  // Secure cookies need HTTPS: on by default in production (KOSH_SECURE_COOKIES=false for plain HTTP).
-  auth: { secureCookies: (env['KOSH_SECURE_COOKIES'] ?? String(env['NODE_ENV'] === 'production')) === 'true' },
+  // Secure cookies need HTTPS: on by default in production (SHUTRO_ERP_SECURE_COOKIES=false for plain HTTP).
+  auth: { secureCookies: (env['SHUTRO_ERP_SECURE_COOKIES'] ?? env['KOSH_SECURE_COOKIES'] ?? String(env['NODE_ENV'] === 'production')) === 'true' },
 });
 const address = await startAppHost(host, { port: Number(env['PORT'] ?? 3000), host: env['HOST'] ?? '127.0.0.1' });
-process.stdout.write(\`Kosh API on \${address}\\n\`);
+process.stdout.write(\`Shutro ERP API on \${address}\\n\`);
 `;
 }
 export function viteConfig(options) {
@@ -159,13 +176,13 @@ import react from '@vitejs/plugin-react';
 import { koshPwa } from 'shutro-erp/ui/vite';
 import { defineConfig } from 'vite';
 
-const api = process.env['KOSH_API'] ?? 'http://localhost:${options.port}';
+const api = process.env['SHUTRO_ERP_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 {
@@ -245,7 +263,7 @@ export function manifest(options) {
 }
 /** The app icon (replace it with the company's). */
 export function icon() {
-    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-label="Kosh">
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-label="Shutro ERP">
   <rect width="512" height="512" rx="112" fill="#1d4ed8"/>
   <path d="M156 128h56v112l108-112h72L270 258l128 126h-74L220 282v102h-64z" fill="#fff"/>
 </svg>
@@ -255,7 +273,7 @@ export function indexCss() {
     return `@import "tailwindcss";
 @import "shutro-erp/ui/styles.css";
 
-/* Tailwind scans Kosh's components for the classes they use. */
+/* Tailwind scans Shutro ERP's components for the classes they use. */
 @source "../../node_modules/shutro-erp/dist";
 `;
 }
@@ -268,7 +286,7 @@ var/
 }
 /** Three images from one build: the API (migrates, then serves) and nginx with the back-office. */
 export function dockerfile() {
-    return `# Kosh images (kosh init). Built by compose.yaml: docker compose up -d --build
+    return `# Shutro ERP images (shutro-erp init). Built by compose.yaml: docker compose up -d --build
 FROM node:24-alpine AS build
 WORKDIR /app
 COPY package.json package-lock.json* ./
@@ -288,7 +306,7 @@ COPY --from=build /app/migrations ./migrations
 RUN mkdir -p /app/var/attachments && chown -R node:node /app/var
 USER node
 EXPOSE 3000
-CMD ["sh", "-c", "npx kosh migrate && node src/server.ts"]
+CMD ["sh", "-c", "npx shutro-erp migrate && node src/server.ts"]
 
 # The back-office: static files, /api proxied to the API.
 FROM nginx:1.27-alpine AS web
@@ -297,7 +315,7 @@ COPY nginx.conf /etc/nginx/conf.d/default.conf
 `;
 }
 export function nginxConf() {
-    return `# The back-office (kosh init): the built app, /api proxied to the API service.
+    return `# The back-office (shutro-erp init): the built app, /api proxied to the API service.
 server {
   listen 80;
   root /usr/share/nginx/html;
@@ -328,9 +346,9 @@ export function composeYaml(options) {
     const db = options.dockerDb ?? options.name.replace(/-/g, '_');
     /** A compose variable: `${NAME}` or `${NAME:-default}` (plain strings: nothing to escape). */
     const v = (name, fallback) => ['$', '{', name, fallback === undefined ? '' : fallback, '}'].join('');
-    const user = v('POSTGRES_USER', ':-kosh');
+    const user = v('POSTGRES_USER', ':-shutro');
     const lines = [
-        '# Kosh in Docker (kosh init).',
+        '# Shutro ERP in Docker (shutro-erp init).',
         '#   docker compose up -d db          only PostgreSQL (the API runs with npm start)',
         '#   docker compose up -d --build     everything: the back-office on http://localhost:8080',
         `name: ${options.name}`,
@@ -349,7 +367,7 @@ export function composeYaml(options) {
         '      - db:/var/lib/postgresql',
         '    healthcheck:',
         // $$ is a literal $ for compose: the shell in the container expands the variable.
-        `      test: ["CMD-SHELL", "pg_isready -U $${v('POSTGRES_USER', ':-kosh')}"]`,
+        `      test: ["CMD-SHELL", "pg_isready -U $${v('POSTGRES_USER', ':-shutro')}"]`,
         '      interval: 5s',
         '      retries: 30',
         '',
@@ -361,9 +379,11 @@ export function composeYaml(options) {
         '    env_file: .env',
         '    environment:',
         `      DATABASE_URL: ${v('DOCKER_DATABASE_URL', `:-postgres://${user}:${v('POSTGRES_PASSWORD')}@db:5432/${v('POSTGRES_DB', `:-${db}`)}`)}`,
-        ...(options.fileStorage === false ? [] : ['      KOSH_STORAGE_DIR: /app/var/attachments']),
+        ...(options.fileStorage === false
+            ? []
+            : ['      SHUTRO_ERP_STORAGE_DIR: /app/var/attachments']),
         '      # Plain HTTP on localhost; set "true" when the site is served over HTTPS.',
-        '      KOSH_SECURE_COOKIES: "false"',
+        '      SHUTRO_ERP_SECURE_COOKIES: "false"',
         '    depends_on:',
         '      db:',
         '        condition: service_healthy',
@@ -413,19 +433,19 @@ export function tsconfig() {
 export function readme(options) {
     return `# ${options.name}
 
-A [Kosh](https://www.npmjs.com/package/shutro-erp) installation, created with \`kosh init\`.
+A [Shutro ERP](https://www.npmjs.com/package/shutro-erp) installation, created with \`shutro-erp init\`.
 
 \`\`\`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)
-npx kosh migrate   # after changing modules: plan and apply database migrations, load seed data
-npx kosh seed      # load seed data again
+npm run web        # the back-office on http://localhost:${options.webPort ?? 5173} (sign in as the administrator)
+npx shutro-erp migrate   # after changing modules: plan and apply database migrations, load seed data
+npx shutro-erp seed      # load seed data again
 # Settings → Apps in the back-office installs, enables and disables apps (or, in the terminal:)
-npx kosh apps                   # the apps: installed, disabled, available
-npx kosh apps install <name>    # install an app (and what it needs) in one transaction
-npx kosh apps disable <name>    # switch an app off; its data stays (npx kosh apps enable <name>)
-npx kosh module create <name>   # a new module in src/modules/<name>/
+npx shutro-erp apps                   # the apps: installed, disabled, available
+npx shutro-erp apps install <name>    # install an app (and what it needs) in one transaction
+npx shutro-erp apps disable <name>    # switch an app off; its data stays (npx shutro-erp apps enable <name>)
+npx shutro-erp module create <name>   # a new module in src/modules/<name>/
 docker compose up -d --build    # everything in Docker: http://localhost:8080
 \`\`\`
 
@@ -435,9 +455,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,9 +1,3 @@
-/**
- * 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.
- */
 /** What the terminal can show. */
 export interface Terminal {
     readonly color: boolean;
@@ -22,9 +16,24 @@ type Env = Readonly<Record<string, string | undefined>>;
 export declare function detectTerminal(stream: {
     readonly isTTY?: boolean;
     readonly columns?: number;
-}, env?: Env, platform?: string): Terminal;
+}, env?: Env, platform?: string, release?: 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 +67,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;