shutro-erp 0.3.5 → 0.3.7

package/dist/approvals/web/Inbox.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The Approvals inbox (RFC 0025 §3.1): what waits for me, as cards — the record and its app, who asked and how long
+ * ago, every level of the round as a step with its votes —, decided one by one (approve, reject or send back, with a
+ * comment; a reason is needed for the last two) or many at once. Keyboard: J / K move, A approves, R rejects, X
+ * selects. The server decides who may decide what; this page shows and sends.
+ */
+import { Alert, Badge, Button, Checkbox, EmptyState, Textarea, useKosh, } from '../../ui/index.js';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useEffect, useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ago, cardsQuery, Steps, waitedTone } from './shared.js';
+export function Inbox({ api }) {
+    const { t } = useTranslation('approvals');
+    const { format } = useKosh();
+    const id = useId();
+    const client = useQueryClient();
+    const cards = useQuery(cardsQuery(api, 'inbox'));
+    const stats = useQuery({
+        queryKey: ['approvals', 'stats'],
+        queryFn: () => api.call('GET', '/api/v1/approvals/stats'),
+    });
+    const routes = useQuery({ queryKey: ['routes'], queryFn: () => api.routes() });
+    const [selected, setSelected] = useState(new Set());
+    const [focus, setFocus] = useState(0);
+    const [comments, setComments] = useState({});
+    const [message, setMessage] = useState(null);
+    const rows = cards.data ?? [];
+    const refresh = async () => {
+        await client.invalidateQueries({ queryKey: ['approvals'] });
+        await client.invalidateQueries({ queryKey: ['home', 'approvals'] });
+    };
+    const decide = useMutation({
+        mutationFn: ({ request, decision }) => api.call('POST', `/api/v1/approvals/requests/${request}/${decision}`, {
+            comment: comments[request] ?? '',
+        }),
+        onSuccess: async (_r, v) => {
+            setMessage(t(`done.${v.decision}`));
+            await refresh();
+        },
+        onError: (e) => setMessage(e.message),
+    });
+    const bulk = useMutation({
+        mutationFn: () => api.call('POST', '/api/v1/approvals/bulk', { requests: [...selected], decision: 'approve' }),
+        onSuccess: async (r) => {
+            setMessage(t('bulkDone', { count: r.approved, failed: r.failed.length }));
+            setSelected(new Set());
+            await refresh();
+        },
+        onError: (e) => setMessage(e.message),
+    });
+    // Keyboard: J / K move, A approves, R rejects (with the comment typed), X selects.
+    useEffect(() => {
+        const onKey = (e) => {
+            const target = e.target;
+            if (target !== null && ['INPUT', 'TEXTAREA'].includes(target.tagName))
+                return;
+            const card = rows[focus];
+            if (e.key === 'j')
+                setFocus((f) => Math.min(f + 1, rows.length - 1));
+            else if (e.key === 'k')
+                setFocus((f) => Math.max(f - 1, 0));
+            else if (card === undefined)
+                return;
+            else if (e.key === 'a')
+                decide.mutate({ request: card.id, decision: 'approve' });
+            else if (e.key === 'r' && (comments[card.id] ?? '').trim() !== '')
+                decide.mutate({ request: card.id, decision: 'reject' });
+            else if (e.key === 'x')
+                setSelected((s) => {
+                    const next = new Set(s);
+                    if (next.has(card.id))
+                        next.delete(card.id);
+                    else
+                        next.add(card.id);
+                    return next;
+                });
+            else
+                return;
+            e.preventDefault();
+        };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+    }, [rows, focus, comments, decide]);
+    const link = (c) => {
+        const route = routes.data?.[c.record.model];
+        return route?.app === undefined ? null : `/${route.app}/a/${route.action}/${c.record.id}`;
+    };
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsxs("header", { className: "flex flex-wrap items-center gap-3", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('inbox.title') }), _jsx(Badge, { tone: "neutral", children: rows.length }), _jsx("p", { className: "w-full text-sm text-muted-foreground", children: t('inbox.hint') })] }), stats.data === undefined ? null : (_jsx("dl", { className: "grid grid-cols-2 gap-3 md:grid-cols-4", children: [
+                    ['waiting', String(stats.data.waiting), 'neutral'],
+                    [
+                        'overdue',
+                        String(stats.data.overdue),
+                        stats.data.overdue > 0 ? 'danger' : 'neutral',
+                    ],
+                    ['decided', String(stats.data.decidedThisMonth), 'neutral'],
+                    [
+                        'median',
+                        stats.data.medianHours === null ? '—' : t('hours', { n: stats.data.medianHours }),
+                        'neutral',
+                    ],
+                ].map(([key, value, tone]) => (_jsxs("div", { className: "rounded-lg border bg-surface p-3", children: [_jsx("dt", { className: "text-xs text-muted-foreground", children: t(`stats.${key}`) }), _jsx("dd", { className: `text-2xl font-semibold tabular-nums ${tone === 'danger' ? 'text-danger' : ''}`, children: value })] }, key))) })), rows.length === 0 ? null : (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Checkbox, { id: `${id}-all`, checked: selected.size === rows.length && rows.length > 0, onCheckedChange: (c) => setSelected(c === true ? new Set(rows.map((r) => r.id)) : new Set()) }), _jsx("label", { htmlFor: `${id}-all`, className: "text-sm", children: t('inbox.selectAll') }), _jsx(Button, { variant: "primary", disabled: selected.size === 0 || bulk.isPending, onClick: () => bulk.mutate(), children: t('inbox.approveSelected', { count: selected.size }) })] })), message === null ? null : _jsx(Alert, { tone: "info", children: message }), cards.isLoading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('loading') })) : rows.length === 0 ? (_jsx(EmptyState, { title: t('inbox.empty'), description: t('inbox.emptyHint') })) : (_jsx("ul", { className: "grid gap-3", children: rows.map((c, i) => {
+                    const href = link(c);
+                    const comment = comments[c.id] ?? '';
+                    return (_jsxs("li", { "aria-current": i === focus ? 'true' : undefined, className: `grid gap-3 rounded-lg border bg-surface p-4 ${i === focus ? 'ring-2 ring-accent' : ''}`, children: [_jsxs("div", { className: "flex flex-wrap items-start gap-3", children: [_jsx(Checkbox, { "aria-label": t('inbox.select', { name: c.record.name }), checked: selected.has(c.id), onCheckedChange: (v) => setSelected((s) => {
+                                            const next = new Set(s);
+                                            if (v === true)
+                                                next.add(c.id);
+                                            else
+                                                next.delete(c.id);
+                                            return next;
+                                        }) }), _jsxs("div", { className: "grid min-w-0 flex-1 gap-1", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [href === null ? (_jsx("span", { className: "font-semibold", children: c.record.name })) : (_jsx("a", { href: href, className: "font-semibold underline-offset-2 hover:underline", children: c.record.name })), _jsx(Badge, { tone: "neutral", children: c.record.label }), _jsx(Badge, { tone: waitedTone(c), children: t('waiting', { since: ago(format.locale, c.waitingSince) }) }), c.dueAt === null ? null : (_jsx(Badge, { tone: Date.parse(c.dueAt) < Date.now() ? 'danger' : 'info', children: t('due', { when: ago(format.locale, c.dueAt) }) })), c.escalatedTo === null ? null : (_jsx(Badge, { tone: "danger", children: t('escalated') }))] }), _jsxs("p", { className: "text-sm text-muted-foreground", children: [t('askedBy', { name: c.requester?.name ?? '—' }), " \u00B7 ", c.levelName, c.required > 1 ? ` · ${t('votes', { n: c.approvals, of: c.required })}` : '', c.round > 1 ? ` · ${t('round', { n: c.round })}` : ''] })] })] }), _jsx(Steps, { steps: c.steps }), _jsx(Textarea, { "aria-label": t('comment', { name: c.record.name }), placeholder: t('commentHint'), value: comment, onChange: (e) => setComments((m) => ({ ...m, [c.id]: e.target.value })) }), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: "primary", disabled: decide.isPending, onClick: () => decide.mutate({ request: c.id, decision: 'approve' }), children: t('approve') }), _jsx(Button, { disabled: decide.isPending || comment.trim() === '', onClick: () => decide.mutate({ request: c.id, decision: 'send-back' }), children: t('sendBack') }), _jsx(Button, { variant: "danger", disabled: decide.isPending || comment.trim() === '', onClick: () => decide.mutate({ request: c.id, decision: 'reject' }), children: t('reject') })] })] }, c.id));
+                }) }))] }));
+}

package/dist/approvals/web/Matrix.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The matrix (RFC 0027 §2.7): the requests of a period the user decides — directly (named, or holding the role) or
+ * for others (as a backup, or for someone away) — a card per policy with what waits, what was approved and what was
+ * rejected; for Approvals managers also how long each level takes and who has the most requests late. The waiting
+ * counts open the inbox.
+ */
+import { type PageProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function Matrix({ api, label }: PageProps): ReactElement;

package/dist/approvals/web/Matrix.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The matrix (RFC 0027 §2.7): the requests of a period the user decides — directly (named, or holding the role) or
+ * for others (as a backup, or for someone away) — a card per policy with what waits, what was approved and what was
+ * rejected; for Approvals managers also how long each level takes and who has the most requests late. The waiting
+ * counts open the inbox.
+ */
+import { Badge, Card, EmptyState, Select } from '../../ui/index.js';
+import { useQuery } from '@tanstack/react-query';
+import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+const PERIODS = ['7d', '30d', '3m', '6m', '1y', 'all'];
+export function Matrix({ api, label }) {
+    const { t } = useTranslation('approvals');
+    const id = useId();
+    const [period, setPeriod] = useState('3m');
+    const [mode, setMode] = useState('direct');
+    const data = useQuery({
+        queryKey: ['approvals', 'matrix', period, mode],
+        queryFn: () => api.call('GET', `/api/v1/approvals/matrix?period=${period}&mode=${mode}`),
+    });
+    const m = data.data;
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsxs("header", { className: "flex flex-wrap items-end justify-between gap-3", children: [_jsx("h1", { className: "text-xl font-semibold", children: label ?? t('matrix.title') }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("div", { role: "tablist", "aria-label": t('matrix.mode'), className: "flex rounded-md border p-0.5", children: ['direct', 'delegated'].map((k) => (_jsxs("button", { type: "button", role: "tab", "aria-selected": mode === k, className: `rounded px-3 py-1 text-sm ${mode === k ? 'bg-primary text-primary-foreground' : 'text-foreground hover:bg-muted'}`, onClick: () => setMode(k), children: [t(`matrix.${k}`), _jsx(Badge, { tone: "neutral", className: "ms-2", children: k === 'direct' ? (m?.direct ?? 0) : (m?.delegated ?? 0) })] }, k))) }), _jsx(Select, { id: `${id}-period`, label: t('matrix.period'), value: period, options: PERIODS.map((p) => ({ value: p, label: t(`matrix.periods.${p}`) })), onChange: (v) => setPeriod(v) })] })] }), m === undefined ? (_jsx(EmptyState, { title: t('loading') })) : m.cards.length === 0 ? (_jsx(EmptyState, { title: t('matrix.empty') })) : (_jsx("ul", { className: "grid gap-3 sm:grid-cols-2 lg:grid-cols-3", children: m.cards.map((c) => (_jsx("li", { children: _jsxs(Card, { className: "grid gap-3 p-4", children: [_jsx("h2", { className: "font-medium", children: c.title }), _jsxs("dl", { className: "grid grid-cols-3 gap-2 text-center", children: [_jsxs("div", { children: [_jsx("dt", { className: "text-xs text-muted-foreground", children: t('matrix.waiting') }), _jsx("dd", { className: "text-lg font-semibold tabular-nums", children: c.waiting > 0 ? (_jsx("a", { className: "text-primary underline-offset-4 hover:underline", href: "/approvals/a/approvals.action_inbox", children: c.waiting })) : (0) })] }), _jsxs("div", { children: [_jsx("dt", { className: "text-xs text-muted-foreground", children: t('matrix.approved') }), _jsx("dd", { className: "text-lg font-semibold tabular-nums text-success", children: c.approved })] }), _jsxs("div", { children: [_jsx("dt", { className: "text-xs text-muted-foreground", children: t('matrix.rejected') }), _jsx("dd", { className: "text-lg font-semibold tabular-nums text-danger", children: c.rejected })] })] })] }) }, String(c.policy)))) })), m?.levels === null || m?.levels === undefined || m.levels.length === 0 ? null : (_jsxs("section", { "aria-labelledby": `${id}-levels`, className: "grid gap-2", children: [_jsx("h2", { id: `${id}-levels`, className: "font-semibold", children: t('matrix.levels') }), _jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "bg-muted", children: _jsxs("tr", { children: [_jsx("th", { className: "px-2 py-1 text-start", children: t('matrix.policy') }), _jsx("th", { className: "px-2 py-1 text-start", children: t('matrix.level') }), _jsx("th", { className: "px-2 py-1 text-end", children: t('matrix.decided') }), _jsx("th", { className: "px-2 py-1 text-end", children: t('matrix.hours') })] }) }), _jsx("tbody", { children: m.levels.map((l) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: "px-2 py-1", children: l.policy }), _jsx("td", { className: "px-2 py-1", children: l.level }), _jsx("td", { className: "px-2 py-1 text-end tabular-nums", children: l.decided }), _jsx("td", { className: "px-2 py-1 text-end tabular-nums", children: l.averageHours })] }, `${l.policy}-${l.level}`))) })] }) })] })), m?.bottlenecks === null ||
+                m?.bottlenecks === undefined ||
+                m.bottlenecks.length === 0 ? null : (_jsxs("section", { "aria-labelledby": `${id}-late`, className: "grid gap-2", children: [_jsx("h2", { id: `${id}-late`, className: "font-semibold", children: t('matrix.bottlenecks') }), _jsx("ul", { className: "grid gap-1 text-sm", children: m.bottlenecks.map((b) => (_jsxs("li", { className: "flex items-center justify-between gap-2 border-b py-1", children: [_jsx("span", { children: b.name }), _jsxs("span", { className: "flex gap-2", children: [b.late > 0 ? (_jsx(Badge, { tone: "danger", children: t('matrix.late', { count: b.late }) })) : null, _jsx(Badge, { tone: "neutral", children: t('matrix.waitingCount', { count: b.waiting }) })] })] }, b.user))) })] }))] }));
+}

package/dist/approvals/web/Mine.d.ts

@@ -0,0 +1,7 @@
+/**
+ * My requests (RFC 0025 §3.1): what I asked to be approved, where each stands — every level as a step, since when —,
+ * withdrawn while it waits.
+ */
+import { type PageProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function Mine({ api }: PageProps): ReactElement;

package/dist/approvals/web/Mine.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * My requests (RFC 0025 §3.1): what I asked to be approved, where each stands — every level as a step, since when —,
+ * withdrawn while it waits.
+ */
+import { Alert, Badge, Button, EmptyState, useKosh } from '../../ui/index.js';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ago, cardsQuery, Steps, TONE } from './shared.js';
+export function Mine({ api }) {
+    const { t } = useTranslation('approvals');
+    const { format } = useKosh();
+    const client = useQueryClient();
+    const cards = useQuery(cardsQuery(api, 'mine'));
+    const [message, setMessage] = useState(null);
+    const withdraw = useMutation({
+        mutationFn: ({ model, id }) => api.call('POST', `/api/v1/approvals/${model}/${id}/withdraw`),
+        onSuccess: async () => {
+            setMessage(t('done.withdrawn'));
+            await client.invalidateQueries({ queryKey: ['approvals'] });
+        },
+        onError: (e) => setMessage(e.message),
+    });
+    const rows = cards.data ?? [];
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('mine.title') }), message === null ? null : _jsx(Alert, { tone: "info", children: message }), rows.length === 0 ? (_jsx(EmptyState, { title: cards.isLoading ? t('loading') : t('mine.empty') })) : (_jsx("ul", { className: "grid gap-3", children: rows.map((c) => (_jsxs("li", { className: "grid gap-2 rounded-lg border bg-surface p-4", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { className: "font-semibold", children: c.record.name }), _jsx(Badge, { tone: "neutral", children: c.record.label }), _jsx(Badge, { tone: TONE[c.state], children: t(`state.${c.state}`) }), _jsx("span", { className: "text-sm text-muted-foreground", children: t('asked', { since: ago(format.locale, c.waitingSince) }) })] }), _jsx(Steps, { steps: c.steps }), c.comment === null ? null : (_jsxs("p", { className: "text-sm", children: [_jsx("span", { className: "text-muted-foreground", children: t('saidWhy') }), " \u201C", c.comment, "\u201D"] })), c.state !== 'pending' ? null : (_jsx("div", { children: _jsx(Button, { disabled: withdraw.isPending, onClick: () => withdraw.mutate({ model: c.record.model, id: c.record.id }), children: t('withdraw') }) }))] }, `${c.record.model}:${c.record.id}`))) }))] }));
+}

package/dist/approvals/web/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @packageDocumentation
+ * The web contribution of `shutro-erp/approvals`: the inbox, my requests and what I decided; the policy preview and a request category's policy.
+ */
+import { type Registry } from '../../ui/index.js';
+import type { i18n } from 'i18next';
+import { messages } from './messages.js';
+export { CategoryPolicy, PolicyPreview } from './Config.js';
+export { History } from './History.js';
+export { Inbox } from './Inbox.js';
+export { Matrix } from './Matrix.js';
+export { Mine } from './Mine.js';
+/** Registers the pages (and the messages in `i18n`, when given). */
+export declare function registerApprovalsWeb(registry: Registry, i18n?: i18n): Registry;
+export { messages as approvalsMessages };

package/dist/approvals/web/index.js

@@ -0,0 +1,29 @@
+/**
+ * @packageDocumentation
+ * The web contribution of `shutro-erp/approvals`: the inbox, my requests and what I decided; the policy preview and a request category's policy.
+ */
+import { addMessages } from '../../ui/index.js';
+import { CategoryPolicy, PolicyPreview } from './Config.js';
+import { History } from './History.js';
+import { Inbox } from './Inbox.js';
+import { Matrix } from './Matrix.js';
+import { Mine } from './Mine.js';
+import { messages } from './messages.js';
+export { CategoryPolicy, PolicyPreview } from './Config.js';
+export { History } from './History.js';
+export { Inbox } from './Inbox.js';
+export { Matrix } from './Matrix.js';
+export { Mine } from './Mine.js';
+/** Registers the pages (and the messages in `i18n`, when given). */
+export function registerApprovalsWeb(registry, i18n) {
+    registry.registerPage('approvals.Inbox', Inbox);
+    registry.registerPage('approvals.Mine', Mine);
+    registry.registerPage('approvals.History', History);
+    registry.registerPage('approvals.Matrix', Matrix);
+    registry.registerComponent('approvals.PolicyPreview', PolicyPreview);
+    registry.registerComponent('approvals.CategoryPolicy', CategoryPolicy);
+    if (i18n !== undefined)
+        addMessages(i18n, 'approvals', messages);
+    return registry;
+}
+export { messages as approvalsMessages };

package/dist/approvals/web/messages.d.ts

@@ -0,0 +1,2 @@
+/** Messages of the Approvals screens (namespace `approvals`), in English and Bangla. */
+export declare const messages: Readonly<Record<string, object>>;

package/dist/approvals/web/messages.js

@@ -0,0 +1,211 @@
+/** Messages of the Approvals screens (namespace `approvals`), in English and Bangla. */
+export const messages = {
+    en: {
+        preview: {
+            title: 'What the levels would have asked about',
+            explain_one: 'Of the last record of this model (within the policy’s condition):',
+            explain_other: 'Of the last {{count}} records of this model (within the policy’s condition):',
+            matched_one: '{{matched}} of {{count}}',
+            matched_other: '{{matched}} of {{count}}',
+            sync: 'Sync waiting requests',
+            everyCompany: 'Covers every company.',
+            noCompany: 'Covers no company yet: its segment has none.',
+            covers: 'Covers {{companies}}.',
+            synced_one: '{{count}} waiting request updated.',
+            synced_other: '{{count}} waiting requests updated.',
+        },
+        category: {
+            setUp: 'Set up its approvals',
+            editLevels: 'Edit who approves (the policy’s levels)',
+        },
+        loading: 'Loading…',
+        steps: 'Approval levels',
+        approve: 'Approve',
+        reject: 'Reject',
+        sendBack: 'Send back for changes',
+        withdraw: 'Withdraw',
+        comment: 'Comment on {{name}}',
+        commentHint: 'A comment (needed to reject or send back)',
+        waiting: 'waiting since {{since}}',
+        due: 'due {{when}}',
+        escalated: 'Escalated: late',
+        asked: 'asked {{since}}',
+        askedBy: 'Asked by {{name}}',
+        votes: '{{n}} of {{of}} approvals',
+        round: 'round {{n}}',
+        saidWhy: 'Said:',
+        bulkDone: '{{count}} approved; {{failed}} could not be.',
+        hours: '{{n}} h',
+        stats: {
+            waiting: 'Waiting for you',
+            overdue: 'Waiting over 3 days',
+            decided: 'Decided this month',
+            median: 'Median time to decide',
+        },
+        state: {
+            pending: 'Waiting',
+            approved: 'Approved',
+            rejected: 'Rejected',
+            sent_back: 'Sent back',
+            cancelled: 'Cancelled',
+        },
+        done: {
+            approve: 'Approved.',
+            reject: 'Rejected.',
+            'send-back': 'Sent back for changes.',
+            withdrawn: 'Withdrawn.',
+        },
+        inbox: {
+            title: 'To approve',
+            hint: 'J and K move between requests, A approves, R rejects with the comment typed, X selects.',
+            selectAll: 'Select all',
+            select: 'Select {{name}}',
+            approveSelected: 'Approve selected ({{count}})',
+            empty: 'Nothing waits for you',
+            emptyHint: 'Requests you may decide appear here as soon as someone submits them.',
+        },
+        mine: { title: 'My requests', empty: 'You have not asked for any approval.' },
+        matrix: {
+            title: 'Matrix',
+            mode: 'Whose decisions',
+            direct: 'Mine',
+            delegated: 'For others',
+            period: 'Period',
+            periods: {
+                '7d': 'Last 7 days',
+                '30d': 'Last 30 days',
+                '3m': 'Last 3 months',
+                '6m': 'Last 6 months',
+                '1y': 'Last year',
+                all: 'All time',
+            },
+            empty: 'No approvals in this period.',
+            waiting: 'Waiting',
+            approved: 'Approved',
+            rejected: 'Rejected',
+            levels: 'Time to decide, by level',
+            policy: 'Policy',
+            level: 'Level',
+            decided: 'Decided',
+            hours: 'Average hours',
+            bottlenecks: 'Who has the most waiting',
+            late_one: '{{count}} late',
+            late_other: '{{count}} late',
+            waitingCount_one: '{{count}} waiting',
+            waitingCount_other: '{{count}} waiting',
+        },
+        history: {
+            title: 'What I decided',
+            empty: 'You have not decided any request yet.',
+            record: 'Record',
+            level: 'Level',
+            answer: 'Answer',
+            comment: 'Comment',
+            when: 'When',
+        },
+    },
+    bn: {
+        preview: {
+            title: 'স্তরগুলো কোন কোন রেকর্ডে অনুমোদন চাইত',
+            explain_one: 'এই মডেলের শেষ রেকর্ডটির মধ্যে (নীতির শর্তের ভেতরে):',
+            explain_other: 'এই মডেলের শেষ {{count}}টি রেকর্ডের মধ্যে (নীতির শর্তের ভেতরে):',
+            matched_one: '{{count}}টির মধ্যে {{matched}}টি',
+            matched_other: '{{count}}টির মধ্যে {{matched}}টি',
+            sync: 'অপেক্ষমাণ অনুরোধ মিলিয়ে নিন',
+            everyCompany: 'সব প্রতিষ্ঠানে প্রযোজ্য।',
+            noCompany: 'এখনো কোনো প্রতিষ্ঠানে প্রযোজ্য নয়: এর সেগমেন্টে কোনো প্রতিষ্ঠান নেই।',
+            covers: '{{companies}}-এ প্রযোজ্য।',
+            synced_one: '{{count}}টি অপেক্ষমাণ অনুরোধ হালনাগাদ হয়েছে।',
+            synced_other: '{{count}}টি অপেক্ষমাণ অনুরোধ হালনাগাদ হয়েছে।',
+        },
+        category: {
+            setUp: 'অনুমোদন ঠিক করুন',
+            editLevels: 'কে অনুমোদন দেবেন তা বদলান (নীতির স্তর)',
+        },
+        loading: 'লোড হচ্ছে…',
+        steps: 'অনুমোদনের ধাপ',
+        approve: 'অনুমোদন',
+        reject: 'প্রত্যাখ্যান',
+        sendBack: 'সংশোধনের জন্য ফেরত',
+        withdraw: 'প্রত্যাহার',
+        comment: '{{name}} সম্পর্কে মন্তব্য',
+        commentHint: 'একটি মন্তব্য (প্রত্যাখ্যান বা ফেরত পাঠাতে প্রয়োজন)',
+        waiting: '{{since}} থেকে অপেক্ষায়',
+        due: 'নির্ধারিত সময় {{when}}',
+        escalated: 'দেরি হওয়ায় ঊর্ধ্বতনে পাঠানো',
+        asked: '{{since}} চাওয়া হয়েছে',
+        askedBy: '{{name}} চেয়েছেন',
+        votes: '{{of}}টির মধ্যে {{n}}টি অনুমোদন',
+        round: 'পর্ব {{n}}',
+        saidWhy: 'বলেছেন:',
+        bulkDone: '{{count}}টি অনুমোদিত; {{failed}}টি করা যায়নি।',
+        hours: '{{n}} ঘণ্টা',
+        stats: {
+            waiting: 'আপনার অপেক্ষায়',
+            overdue: '৩ দিনের বেশি অপেক্ষায়',
+            decided: 'এ মাসে সিদ্ধান্ত',
+            median: 'সিদ্ধান্তের গড় সময় (মধ্যমা)',
+        },
+        state: {
+            pending: 'অপেক্ষায়',
+            approved: 'অনুমোদিত',
+            rejected: 'প্রত্যাখ্যাত',
+            sent_back: 'ফেরত পাঠানো',
+            cancelled: 'বাতিল',
+        },
+        done: {
+            approve: 'অনুমোদিত হয়েছে।',
+            reject: 'প্রত্যাখ্যাত হয়েছে।',
+            'send-back': 'সংশোধনের জন্য ফেরত পাঠানো হয়েছে।',
+            withdrawn: 'প্রত্যাহার করা হয়েছে।',
+        },
+        inbox: {
+            title: 'অনুমোদনের জন্য',
+            hint: 'J ও K দিয়ে অনুরোধে যান, A অনুমোদন, R লেখা মন্তব্যসহ প্রত্যাখ্যান, X নির্বাচন।',
+            selectAll: 'সব নির্বাচন',
+            select: '{{name}} নির্বাচন',
+            approveSelected: 'নির্বাচিতগুলো অনুমোদন ({{count}})',
+            empty: 'আপনার জন্য কিছু অপেক্ষায় নেই',
+            emptyHint: 'কেউ জমা দিলেই আপনার সিদ্ধান্তের অনুরোধ এখানে আসবে।',
+        },
+        mine: { title: 'আমার অনুরোধ', empty: 'আপনি কোনো অনুমোদন চাননি।' },
+        matrix: {
+            title: 'ম্যাট্রিক্স',
+            mode: 'কার সিদ্ধান্ত',
+            direct: 'আমার',
+            delegated: 'অন্যদের পক্ষে',
+            period: 'সময়কাল',
+            periods: {
+                '7d': 'গত ৭ দিন',
+                '30d': 'গত ৩০ দিন',
+                '3m': 'গত ৩ মাস',
+                '6m': 'গত ৬ মাস',
+                '1y': 'গত এক বছর',
+                all: 'সব সময়',
+            },
+            empty: 'এই সময়কালে কোনো অনুমোদন নেই।',
+            waiting: 'অপেক্ষমাণ',
+            approved: 'অনুমোদিত',
+            rejected: 'প্রত্যাখ্যাত',
+            levels: 'ধাপ অনুযায়ী সিদ্ধান্তের সময়',
+            policy: 'নীতি',
+            level: 'ধাপ',
+            decided: 'সিদ্ধান্ত হয়েছে',
+            hours: 'গড় ঘণ্টা',
+            bottlenecks: 'কার কাছে সবচেয়ে বেশি অপেক্ষমাণ',
+            late_one: '{{count}}টি দেরিতে',
+            late_other: '{{count}}টি দেরিতে',
+            waitingCount_one: '{{count}}টি অপেক্ষমাণ',
+            waitingCount_other: '{{count}}টি অপেক্ষমাণ',
+        },
+        history: {
+            title: 'আমার সিদ্ধান্ত',
+            empty: 'আপনি এখনো কোনো অনুরোধে সিদ্ধান্ত দেননি।',
+            record: 'রেকর্ড',
+            level: 'ধাপ',
+            answer: 'উত্তর',
+            comment: 'মন্তব্য',
+            when: 'কখন',
+        },
+    },
+};

package/dist/approvals/web/shared.d.ts

@@ -0,0 +1,59 @@
+/**
+ * What the Approvals pages share (RFC 0025 §3.1): the card the server sends, its query, the steps of a round (each
+ * level with its state and votes), how long a request has waited, said in the user's language.
+ */
+import type { KoshApi } from '../../ui/index.js';
+import type { ReactElement } from 'react';
+export interface Step {
+    readonly id: number;
+    readonly levelName: string;
+    readonly sequence: number;
+    readonly state: 'pending' | 'approved' | 'rejected' | 'sent_back' | 'cancelled';
+    readonly approvals: number;
+    readonly required: number;
+}
+export interface Card {
+    readonly id: number;
+    readonly levelName: string;
+    readonly state: Step['state'];
+    readonly round: number;
+    readonly approvals: number;
+    readonly required: number;
+    readonly waitingSince: string;
+    readonly decidedAt: string | null;
+    readonly dueAt: string | null;
+    readonly escalatedTo: string | null;
+    readonly comment: string | null;
+    readonly record: {
+        readonly model: string;
+        readonly id: number;
+        readonly name: string;
+        readonly label: string;
+    };
+    readonly requester: {
+        readonly id: number;
+        readonly name: string;
+    } | null;
+    readonly steps: readonly Step[];
+}
+/** The cards of a list: `inbox` (to decide), `mine` (asked by me), `history` (decided by me). */
+export declare const cardsQuery: (api: KoshApi, list: 'inbox' | 'mine' | 'history') => {
+    queryKey: string[];
+    queryFn: () => Promise<Card[]>;
+};
+/** How long ago `iso` was, in `locale` ("3 hours ago", "৩ ঘণ্টা আগে"). */
+export declare function ago(locale: string, iso: string, now?: number): string;
+/** Amber after a day, red after three. */
+export declare function waitedTone(card: Pick<Card, 'waitingSince'>, now?: number): 'neutral' | 'warning' | 'danger';
+/** A state's badge tone. */
+export declare const TONE: {
+    readonly pending: 'warning';
+    readonly approved: 'success';
+    readonly rejected: 'danger';
+    readonly sent_back: 'danger';
+    readonly cancelled: 'neutral';
+};
+/** The levels of a round as steps: done, waiting, refused — with their votes. */
+export declare function Steps({ steps }: {
+    readonly steps: readonly Step[];
+}): ReactElement;

package/dist/approvals/web/shared.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslation } from 'react-i18next';
+/** The cards of a list: `inbox` (to decide), `mine` (asked by me), `history` (decided by me). */
+export const cardsQuery = (api, list) => ({
+    queryKey: ['approvals', list],
+    queryFn: async () => (await api.call('GET', `/api/v1/approvals/cards?list=${list}`)).cards,
+});
+/** How long ago `iso` was, in `locale` ("3 hours ago", "৩ ঘণ্টা আগে"). */
+export function ago(locale, iso, now = Date.now()) {
+    const seconds = Math.round((Date.parse(iso) - now) / 1000);
+    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });
+    const units = [
+        ['day', 86_400],
+        ['hour', 3_600],
+        ['minute', 60],
+    ];
+    for (const [unit, size] of units)
+        if (Math.abs(seconds) >= size)
+            return rtf.format(Math.round(seconds / size), unit);
+    return rtf.format(seconds, 'second');
+}
+/** Amber after a day, red after three. */
+export function waitedTone(card, now = Date.now()) {
+    const hours = (now - Date.parse(card.waitingSince)) / 3_600_000;
+    return hours >= 72 ? 'danger' : hours >= 24 ? 'warning' : 'neutral';
+}
+/** A state's badge tone. */
+export const TONE = {
+    pending: 'warning',
+    approved: 'success',
+    rejected: 'danger',
+    sent_back: 'danger',
+    cancelled: 'neutral',
+};
+const DOT = {
+    pending: 'border-warning bg-warning/20',
+    approved: 'border-success bg-success',
+    rejected: 'border-danger bg-danger',
+    sent_back: 'border-danger bg-danger/40',
+    cancelled: 'border-muted-foreground bg-muted',
+};
+/** The levels of a round as steps: done, waiting, refused — with their votes. */
+export function Steps({ steps }) {
+    const { t } = useTranslation('approvals');
+    return (_jsx("ol", { className: "flex flex-wrap items-center gap-2", "aria-label": t('steps'), children: steps.map((s, i) => (_jsxs("li", { className: "flex items-center gap-2 text-xs", children: [i === 0 ? null : _jsx("span", { "aria-hidden": "true", className: "h-px w-4 bg-border" }), _jsx("span", { "aria-hidden": "true", className: `size-3 rounded-full border-2 ${DOT[s.state]}` }), _jsxs("span", { children: [_jsx("span", { className: "font-medium", children: s.levelName }), ' ', _jsxs("span", { className: "text-muted-foreground", children: [t(`state.${s.state}`), s.required > 1 ? ` · ${s.approvals}/${s.required}` : ''] })] })] }, s.id))) }));
+}

package/dist/approvals_purchase/.kosh/bindings.d.ts

@@ -0,0 +1,22 @@
+export { defineModel, defineModule, extendModel, f, replace } from '../../server/orm.js';
+import { type DefinitionHelpers } from '../../server/orm.js';
+import type { DefaultLoaded, Env as CoreEnv, RecordSet as CoreRecordSet, Shutro as CoreShutro } from '../../server/orm.js';
+import type { SchemaView } from './schema.js';
+export type { SchemaView };
+/** Every model visible in this view. */
+export type ModelName = keyof SchemaView & string;
+/** `Env` typed to this view. */
+export type Env = CoreEnv<SchemaView>;
+/** `Shutro` typed to this view. */
+export type Shutro = CoreShutro<SchemaView>;
+/** A recordset of `M`, with the default loaded shape unless `L` is given. */
+export type Records<M extends ModelName, L = DefaultLoaded<SchemaView, M>> = CoreRecordSet<SchemaView, M, L>;
+export declare const compute: DefinitionHelpers<SchemaView>['compute'];
+export declare const check: DefinitionHelpers<SchemaView>['check'];
+export declare const onchange: DefinitionHelpers<SchemaView>['onchange'];
+export declare const records: DefinitionHelpers<SchemaView>['records'];
+export declare const method: DefinitionHelpers<SchemaView>['method'];
+/** Module data (RFC 0017): records, overrides of dependencies' records, and references, typed like creates. */
+export declare const record: DefinitionHelpers<SchemaView>['record'];
+export declare const override: DefinitionHelpers<SchemaView>['override'];
+export declare const ref: DefinitionHelpers<SchemaView>['ref'];

package/dist/approvals_purchase/.kosh/bindings.js

@@ -0,0 +1,15 @@
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 5d359b16ce96aaa8
+// Bindings of module `approvals_purchase`: 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';
+/** Definition callbacks typed against this module's view: no casts in computes, checks, onchange, methods. */
+const helpers = definitions();
+export const compute = helpers.compute;
+export const check = helpers.check;
+export const onchange = helpers.onchange;
+export const records = helpers.records;
+export const method = helpers.method;
+/** Module data (RFC 0017): records, overrides of dependencies' records, and references, typed like creates. */
+export const record = helpers.record;
+export const override = helpers.override;
+export const ref = helpers.ref;