shutro-erp 0.3.5 → 0.3.7

package/dist/stock/web/Ledger.js

@@ -0,0 +1,108 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Stockroom › Stock ledger (RFC 0032 §3.3): for a period and the chosen warehouses (or every one), each product's
+ * opening, what came in and went out by movement type, and its closing — as a summary or every movement —, and the
+ * stock report (on hand, reserved, available, incoming, outgoing per product and location), as the server computes
+ * them, with their XLSX and PDF files.
+ */
+import { ApiError, Button, Input, Label, useKosh } from '../../ui/index.js';
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+const IN_TYPES = [
+    'purchase_receipt',
+    'sales_return',
+    'production_in',
+    'transfer_in',
+    'adjustment_in',
+    'other_in',
+];
+const OUT_TYPES = [
+    'sales_delivery',
+    'purchase_return',
+    'production_out',
+    'transfer_out',
+    'consumption',
+    'scrap',
+    'adjustment_out',
+    'other_out',
+];
+const TABS = ['summary', 'details', 'stock'];
+function saveFile(blob, filename) {
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    a.click();
+    setTimeout(() => URL.revokeObjectURL(url), 1000);
+}
+const firstOfMonth = () => {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-01`;
+};
+const today = () => new Date().toISOString().slice(0, 10);
+const cell = 'px-2 py-1 whitespace-nowrap';
+const num = `${cell} text-end tabular-nums`;
+export function Ledger({ api }) {
+    const { t } = useTranslation('stock');
+    const { format } = useKosh();
+    const id = useId();
+    const [tab, setTab] = useState('summary');
+    const [from, setFrom] = useState(firstOfMonth);
+    const [to, setTo] = useState(today);
+    const [warehouses, setWarehouses] = useState([]);
+    const [categories, setCategories] = useState([]);
+    const warehouseList = useQuery({
+        queryKey: ['stock', 'ledger', 'warehouses'],
+        queryFn: async () => (await api.list('stock.warehouse', {
+            fields: ['id', 'name'],
+            order: ['name asc'],
+            limit: 200,
+        })).items,
+    });
+    const categoryList = useQuery({
+        queryKey: ['stock', 'ledger', 'categories'],
+        queryFn: async () => (await api.list('product.category', {
+            fields: ['id', 'name'],
+            order: ['name asc'],
+            limit: 500,
+        })).items,
+    });
+    const scope = `warehouses=${warehouses.join(',')}&categories=${categories.join(',')}`;
+    const path = tab === 'stock'
+        ? `/api/v1/stockroom/stock?${scope}`
+        : `/api/v1/stockroom/ledger?from=${from}&to=${to}&mode=${tab}&${scope}`;
+    const valid = /^\d{4}-\d{2}-\d{2}$/.test(from) && /^\d{4}-\d{2}-\d{2}$/.test(to) && from <= to;
+    const data = useQuery({
+        queryKey: ['stock', 'ledger', tab, from, to, warehouses, categories],
+        queryFn: () => api.call('GET', path),
+        enabled: tab === 'stock' || valid,
+    });
+    const download = useMutation({
+        mutationFn: async (kind) => {
+            const { blob, filename } = await api.download(`${path}&format=${kind}`, undefined, 'GET');
+            saveFile(blob, filename);
+        },
+    });
+    const error = data.error ?? download.error;
+    const chosen = (e) => [...e.target.selectedOptions].map((o) => Number(o.value));
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('ledger.title') }), _jsxs("div", { className: "flex flex-wrap items-end gap-2", children: [_jsxs("fieldset", { className: "flex flex-wrap gap-1", children: [_jsx("legend", { className: "sr-only", children: t('ledger.tab') }), TABS.map((k) => (_jsx(Button, { variant: tab === k ? 'primary' : 'secondary', "aria-pressed": tab === k, onClick: () => setTab(k), children: t(`ledger.tabs.${k}`) }, k)))] }), tab === 'stock' ? null : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-from`, children: t('ledger.from') }), _jsx(Input, { id: `${id}-from`, type: "date", value: from, onChange: (e) => setFrom(e.target.value) })] }), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-to`, children: t('ledger.to') }), _jsx(Input, { id: `${id}-to`, type: "date", value: to, onChange: (e) => setTo(e.target.value) })] })] })), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-warehouses`, children: t('ledger.warehouses') }), _jsx("select", { id: `${id}-warehouses`, multiple: true, className: "min-w-48 rounded-md border bg-background px-2 py-1 text-sm", value: warehouses.map(String), onChange: (e) => setWarehouses(chosen(e)), children: (warehouseList.data ?? []).map((w) => (_jsx("option", { value: w.id, children: w.name }, w.id))) })] }), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-categories`, children: t('ledger.categories') }), _jsx("select", { id: `${id}-categories`, multiple: true, className: "min-w-48 rounded-md border bg-background px-2 py-1 text-sm", value: categories.map(String), onChange: (e) => setCategories(chosen(e)), children: (categoryList.data ?? []).map((c) => (_jsx("option", { value: c.id, children: c.name }, c.id))) })] }), _jsx(Button, { variant: "secondary", disabled: download.isPending, onClick: () => download.mutate('xlsx'), children: t('ledger.xlsx') }), _jsx(Button, { variant: "secondary", disabled: download.isPending, onClick: () => download.mutate('pdf'), children: t('ledger.pdf') })] }), _jsx("p", { className: "text-sm text-muted-foreground", children: t(`ledger.hints.${tab}`) }), error === null ? null : (_jsx("p", { role: "alert", className: "text-sm text-danger", children: error instanceof ApiError ? error.message : String(error) })), data.data === undefined ? null : tab === 'stock' ? (_jsx(StockTable, { rows: data.data.rows })) : tab === 'details' ? (_jsx(Details, { data: data.data })) : (_jsx(Summary, { data: data.data }))] }));
+    function Summary({ data }) {
+        const rows = data.rows;
+        if (rows.length === 0)
+            return _jsx("p", { className: "text-sm text-muted-foreground", children: t('ledger.empty') });
+        const q = (f) => format.decimal(f.qty, 3);
+        return (_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: `${cell} text-start`, children: t('ledger.product') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.unit') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.opening') }), IN_TYPES.map((k) => (_jsx("th", { className: `${cell} text-end`, children: t(`ledger.types.${k}`) }, k))), _jsx("th", { className: `${cell} text-end font-semibold`, children: t('ledger.totalIn') }), OUT_TYPES.map((k) => (_jsx("th", { className: `${cell} text-end`, children: t(`ledger.types.${k}`) }, k))), _jsx("th", { className: `${cell} text-end font-semibold`, children: t('ledger.totalOut') }), _jsx("th", { className: `${cell} text-end font-semibold`, children: t('ledger.closing') }), data.valued ? (_jsx("th", { className: `${cell} text-end`, children: t('ledger.closingValue') })) : null] }) }), _jsx("tbody", { children: rows.map((r) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: cell, children: r.product.name }), _jsx("td", { className: cell, children: r.product.uom }), _jsx("td", { className: num, children: q(r.opening) }), IN_TYPES.map((k) => (_jsx("td", { className: num, children: q(r.in[k]) }, k))), _jsx("td", { className: `${num} font-semibold`, children: q(r.totalIn) }), OUT_TYPES.map((k) => (_jsx("td", { className: num, children: q(r.out[k]) }, k))), _jsx("td", { className: `${num} font-semibold`, children: q(r.totalOut) }), _jsx("td", { className: `${num} font-semibold`, children: q(r.closing) }), data.valued ? _jsx("td", { className: num, children: format.decimal(r.closing.value, 2) }) : null] }, r.product.id))) })] }) }));
+    }
+    function Details({ data }) {
+        const rows = data.rows;
+        if (rows.length === 0)
+            return _jsx("p", { className: "text-sm text-muted-foreground", children: t('ledger.empty') });
+        return (_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: `${cell} text-start`, children: t('ledger.date') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.reference') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.origin') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.product') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.fromPlace') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.toPlace') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.movement') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.quantity') }), data.valued ? _jsx("th", { className: `${cell} text-end`, children: t('ledger.value') }) : null] }) }), _jsx("tbody", { children: rows.map((r, i) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: cell, children: format.date(r.date) }), _jsx("td", { className: cell, children: r.reference }), _jsx("td", { className: cell, children: r.origin ?? '' }), _jsxs("td", { className: cell, children: [r.product.name, " ", _jsx("span", { className: "text-muted-foreground", children: r.product.uom })] }), _jsx("td", { className: cell, children: r.from }), _jsx("td", { className: cell, children: r.to }), _jsx("td", { className: cell, children: t(`ledger.types.${r.type}`) }), _jsx("td", { className: num, children: format.decimal(r.qty, 3) }), data.valued ? _jsx("td", { className: num, children: format.decimal(r.value, 2) }) : null] }, i))) })] }) }));
+    }
+    function StockTable({ rows }) {
+        if (rows.length === 0)
+            return _jsx("p", { className: "text-sm text-muted-foreground", children: t('ledger.empty') });
+        return (_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: `${cell} text-start`, children: t('ledger.product') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.unit') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.location') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.onHand') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.reserved') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.available') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.incoming') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.outgoing') })] }) }), _jsx("tbody", { children: rows.map((r) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: cell, children: r.product.name }), _jsx("td", { className: cell, children: r.product.uom }), _jsx("td", { className: cell, children: r.location.name }), _jsx("td", { className: num, children: format.decimal(r.onHand, 3) }), _jsx("td", { className: num, children: format.decimal(r.reserved, 3) }), _jsx("td", { className: num, children: format.decimal(r.available, 3) }), _jsx("td", { className: num, children: format.decimal(r.incoming, 3) }), _jsx("td", { className: num, children: format.decimal(r.outgoing, 3) })] }, `${r.product.id}-${r.location.id}`))) })] }) }));
+    }
+}

package/dist/stock/web/Operations.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stockroom › My operations (RFC 0032 §3.3): a card per warehouse and kind of transfer — receipts, deliveries,
+ * internal moves — with what is ready, waiting and late. The server counts (`GET /api/v1/stockroom/operations`);
+ * each count opens the transfers it counts.
+ */
+import { type PageProps } from '../../ui/index.js';
+import type { ReactElement } from 'react';
+export declare function Operations({ api, app }: PageProps): ReactElement;

package/dist/stock/web/Operations.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Stockroom › My operations (RFC 0032 §3.3): a card per warehouse and kind of transfer — receipts, deliveries,
+ * internal moves — with what is ready, waiting and late. The server counts (`GET /api/v1/stockroom/operations`);
+ * each count opens the transfers it counts.
+ */
+import { Alert } from '../../ui/index.js';
+import { useQuery } from '@tanstack/react-query';
+import { useTranslation } from 'react-i18next';
+/** A link to an action's list filtered by `domain`, labelled in its search bar. */
+function hrefOf(app, action, domain, label) {
+    const q = JSON.stringify({ c: domain, cl: label });
+    // The router reads search values as JSON: a string is quoted.
+    return `/${app}/a/${action}?q=${encodeURIComponent(JSON.stringify(q))}`;
+}
+export function Operations({ api, app = 'stockroom' }) {
+    const { t } = useTranslation('stock');
+    const operations = useQuery({
+        queryKey: ['stock', 'operations'],
+        queryFn: () => api.call('GET', '/api/v1/stockroom/operations'),
+        refetchInterval: 60_000,
+    });
+    if (operations.isError)
+        return _jsx(Alert, { tone: "danger", children: operations.error.message });
+    const list = operations.data?.operations ?? [];
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('operations.title') }), _jsx("p", { className: "max-w-3xl text-sm text-muted-foreground", children: t('operations.hint') }), operations.isLoading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('operations.loading') })) : list.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('operations.empty') })) : (_jsx("ul", { className: "grid gap-3 sm:grid-cols-2 xl:grid-cols-3", children: list.map((o) => {
+                    const title = `${o.warehouse.name}: ${t(`operations.kind.${o.kind}`)}`;
+                    const link = (count, which) => (_jsxs("a", { href: hrefOf(app, o.action, count.domain, `${title} · ${t(`operations.${which}`)}`), className: which === 'late' && count.count > 0
+                            ? 'rounded-md border border-destructive/40 px-3 py-2 text-destructive hover:bg-destructive/10'
+                            : 'rounded-md border px-3 py-2 hover:bg-accent', "aria-label": t(`operations.${which}Of`, { count: count.count, title }), children: [_jsx("span", { className: "block text-2xl font-semibold tabular-nums", children: count.count }), _jsx("span", { className: "text-xs text-muted-foreground", children: t(`operations.${which}`) })] }));
+                    return (_jsx("li", { children: _jsxs("section", { "aria-label": title, className: "space-y-3 rounded-lg border bg-card p-4 text-card-foreground", children: [_jsx("h2", { className: "font-medium", children: title }), _jsxs("div", { className: "grid grid-cols-3 gap-2", children: [link(o.ready, 'ready'), link(o.waiting, 'waiting'), link(o.late, 'late')] })] }) }, `${o.warehouse.id}-${o.kind}`));
+                }) }))] }));
+}

package/dist/stock/web/Replenishment.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stockroom › Replenishment (RFC 0024 §2.6): every reorder rule with its forecast, what it proposes and why, in
+ * words. Quantities can be changed before ordering; the chosen rules are ordered by their method (a transfer, a
+ * request for quotation, a production order) or snoozed. The server reckons and orders; this page only shows it.
+ */
+import { type PageProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function Replenishment({ api }: PageProps): ReactElement;

package/dist/stock/web/Replenishment.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Stockroom › Replenishment (RFC 0024 §2.6): every reorder rule with its forecast, what it proposes and why, in
+ * words. Quantities can be changed before ordering; the chosen rules are ordered by their method (a transfer, a
+ * request for quotation, a production order) or snoozed. The server reckons and orders; this page only shows it.
+ */
+import { Alert, Button, Checkbox, Input, Label, useKosh } from '../../ui/index.js';
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+const FIELDS = [
+    'id',
+    'name',
+    'method',
+    'minimum',
+    'maximum',
+    'onHand',
+    'forecast',
+    'proposed',
+    'explanation',
+    'snoozedUntil',
+    'lastOrder',
+];
+export function Replenishment({ api }) {
+    const { t } = useTranslation('stock');
+    const { format } = useKosh();
+    const id = useId();
+    const [all, setAll] = useState(false);
+    const [selected, setSelected] = useState(new Set());
+    const [quantities, setQuantities] = useState({});
+    const [message, setMessage] = useState(null);
+    const [error, setError] = useState(null);
+    const rules = useQuery({
+        queryKey: ['stock', 'replenishment', all],
+        queryFn: async () => (await api.list('stock.reorder', {
+            ...(all ? {} : { filter: { proposed: { gt: 0 } } }),
+            fields: FIELDS,
+            order: ['name asc'],
+            limit: 500,
+        })).items,
+    });
+    const done = async (text) => {
+        setError(null);
+        setMessage(text);
+        setSelected(new Set());
+        setQuantities({});
+        await rules.refetch();
+    };
+    const refresh = useMutation({
+        mutationFn: () => api.call('POST', '/api/v1/stockroom/replenishment/refresh', {}),
+        onSuccess: (r) => done(t('replenish.refreshed', { count: r.rules })),
+        onError: (e) => setError(e.message),
+    });
+    const order = useMutation({
+        mutationFn: () => api.call('POST', '/api/v1/stockroom/replenishment/order', {
+            rules: [...selected],
+            quantities: Object.fromEntries(Object.entries(quantities).filter(([id, q]) => selected.has(Number(id)) && q !== '')),
+        }),
+        onSuccess: (r) => done([
+            ...r.ordered.map((o) => t('replenish.ordered', { quantity: o.quantity, document: o.document })),
+            ...r.skipped.map((s) => s.reason),
+        ].join(' ')),
+        onError: (e) => setError(e.message),
+    });
+    const snooze = useMutation({
+        mutationFn: () => api.call('POST', '/api/v1/stockroom/replenishment/snooze', {
+            rules: [...selected],
+            days: 7,
+        }),
+        onSuccess: (r) => done(t('replenish.snoozed', { count: r.rules })),
+        onError: (e) => setError(e.message),
+    });
+    const rows = rules.data ?? [];
+    const busy = refresh.isPending || order.isPending || snooze.isPending;
+    const toggle = (id, on) => setSelected((s) => {
+        const next = new Set(s);
+        if (on)
+            next.add(id);
+        else
+            next.delete(id);
+        return next;
+    });
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('replenish.title') }), _jsx("p", { className: "text-sm text-muted-foreground", children: t('replenish.hint') }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Button, { variant: "primary", disabled: busy || selected.size === 0, onClick: () => order.mutate(), children: t('replenish.order', { count: selected.size }) }), _jsx(Button, { disabled: busy || selected.size === 0, onClick: () => snooze.mutate(), children: t('replenish.snooze') }), _jsx(Button, { disabled: busy, onClick: () => refresh.mutate(), children: t('replenish.refresh') }), _jsxs("div", { className: "ms-auto flex items-center gap-2 text-sm", children: [_jsx(Checkbox, { id: `${id}-all`, checked: all, onCheckedChange: (c) => setAll(c === true) }), _jsx(Label, { htmlFor: `${id}-all`, children: t('replenish.all') })] })] }), message === null ? null : _jsx(Alert, { tone: "info", children: message }), error === null ? null : _jsx(Alert, { tone: "danger", children: error }), rows.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: rules.isLoading ? t('replenish.loading') : t('replenish.empty') })) : (_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: "w-10 px-2 py-1" }), _jsx("th", { className: "px-2 py-1 text-start", children: t('replenish.rule') }), _jsx("th", { className: "px-2 py-1 text-start", children: t('replenish.method') }), _jsx("th", { className: "px-2 py-1 text-end", children: t('replenish.onHand') }), _jsx("th", { className: "px-2 py-1 text-end", children: t('replenish.forecast') }), _jsx("th", { className: "px-2 py-1 text-end", children: t('replenish.minMax') }), _jsx("th", { className: "px-2 py-1 text-end", children: t('replenish.toOrder') })] }) }), _jsx("tbody", { children: rows.map((r) => (_jsxs("tr", { className: "border-b align-top", children: [_jsx("td", { className: "px-2 py-2", children: _jsx(Checkbox, { "aria-label": r.name, checked: selected.has(r.id), onCheckedChange: (c) => toggle(r.id, c === true) }) }), _jsxs("td", { className: "px-2 py-2", children: [_jsx("div", { className: "font-medium", children: r.name }), _jsx("div", { className: "text-xs text-muted-foreground", children: r.explanation ?? '' }), r.snoozedUntil === null ? null : (_jsx("div", { className: "text-xs text-muted-foreground", children: t('replenish.snoozedUntil', { date: format.date(r.snoozedUntil) }) })), r.lastOrder === null ? null : (_jsx("div", { className: "text-xs text-muted-foreground", children: t('replenish.last', { document: r.lastOrder }) }))] }), _jsx("td", { className: "px-2 py-2", children: t(`replenish.${r.method}`) }), _jsx("td", { className: "px-2 py-2 text-end tabular-nums", children: format.decimal(r.onHand ?? '0') }), _jsx("td", { className: "px-2 py-2 text-end tabular-nums", children: format.decimal(r.forecast ?? '0') }), _jsxs("td", { className: "px-2 py-2 text-end tabular-nums", children: [format.decimal(r.minimum), " \u2013 ", format.decimal(r.maximum)] }), _jsx("td", { className: "px-2 py-2 text-end", children: _jsx(Input, { "aria-label": t('replenish.quantityOf', { name: r.name }), inputMode: "decimal", className: "ms-auto w-24 text-end", value: quantities[r.id] ?? String(Number(r.proposed ?? 0)), onChange: (e) => setQuantities((q) => ({ ...q, [r.id]: e.target.value })) }) })] }, r.id))) })] }) }))] }));
+}

package/dist/stock/web/ReturnButton.d.ts

@@ -0,0 +1,7 @@
+/**
+ * "Return" on a done delivery or receipt (RFC 0030 §3.2): the lines with what can still come back, a quantity for
+ * each, the reason and a note; the server makes the linked return, confirmed, and refuses more than was done.
+ */
+import { type NodeComponentProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function ReturnButton({ record, api, reload }: NodeComponentProps): ReactElement | null;

package/dist/stock/web/ReturnButton.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * "Return" on a done delivery or receipt (RFC 0030 §3.2): the lines with what can still come back, a quantity for
+ * each, the reason and a note; the server makes the linked return, confirmed, and refuses more than was done.
+ */
+import { Alert, ApiError, Button, Dialog, Input, Label, Select, } from '../../ui/index.js';
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+export function ReturnButton({ record, api, reload }) {
+    const { t } = useTranslation('stock');
+    const id = useId();
+    const [open, setOpen] = useState(false);
+    const [quantities, setQuantities] = useState({});
+    const [reason, setReason] = useState(null);
+    const [note, setNote] = useState('');
+    const [made, setMade] = useState(null);
+    const eligible = record !== null &&
+        record['state'] === 'done' &&
+        (record['kind'] === 'delivery' || record['kind'] === 'receipt');
+    const lines = useQuery({
+        queryKey: ['stock', 'returnable', record?.id],
+        queryFn: () => api.call('GET', `/api/v1/stockroom/pickings/${record?.id}/returnable`),
+        enabled: eligible && open,
+    });
+    const reasons = useQuery({
+        queryKey: ['stock', 'return-reasons'],
+        queryFn: () => api.list('stock.return.reason', {
+            fields: ['id', 'name'],
+            order: ['sequence asc'],
+            limit: 50,
+        }),
+        enabled: eligible && open,
+    });
+    const send = useMutation({
+        mutationFn: () => api.call('POST', `/api/v1/stockroom/pickings/${record?.id}/return`, {
+            lines: Object.entries(quantities)
+                .filter(([, q]) => q !== '' && Number(q) > 0)
+                .map(([move, quantity]) => ({ move: Number(move), quantity })),
+            reason: Number(reason),
+            note,
+        }),
+        onSuccess: (r) => {
+            setOpen(false);
+            setMade(r.name);
+            reload?.();
+        },
+    });
+    if (!eligible)
+        return null;
+    const rows = lines.data?.lines ?? [];
+    const any = Object.values(quantities).some((q) => q !== '' && Number(q) > 0);
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Button, { size: "sm", onClick: () => {
+                    setQuantities({});
+                    setReason(null);
+                    setNote('');
+                    setOpen(true);
+                }, children: t('returns.button') }), made === null ? null : (_jsx("span", { role: "status", className: "text-xs text-muted-foreground", children: t('returns.made', { name: made }) })), _jsx(Dialog, { open: open, onOpenChange: setOpen, title: t('returns.title'), description: t('returns.intro'), footer: _jsx(Button, { variant: "primary", disabled: !any || reason === null, busy: send.isPending, onClick: () => send.mutate(), children: t('returns.confirm') }), children: _jsxs("div", { className: "space-y-3", children: [rows.map((l) => (_jsxs("div", { className: "grid grid-cols-[1fr_8rem] items-end gap-2", children: [_jsxs(Label, { htmlFor: `${id}-q-${l.move}`, children: [l.name, _jsx("span", { className: "block text-xs text-muted-foreground", children: t('returns.left', { done: l.done, left: l.returnable }) })] }), _jsx(Input, { id: `${id}-q-${l.move}`, inputMode: "decimal", disabled: Number(l.returnable) <= 0, value: quantities[l.move] ?? '', onChange: (e) => setQuantities({ ...quantities, [l.move]: e.target.value }) })] }, l.move))), _jsx(Select, { id: `${id}-reason`, label: t('returns.reason'), value: reason, options: (reasons.data?.items ?? []).map((r) => ({
+                                value: String(r.id),
+                                label: r.name,
+                            })), onChange: setReason }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: `${id}-note`, children: t('returns.note') }), _jsx(Input, { id: `${id}-note`, value: note, onChange: (e) => setNote(e.target.value) })] }), send.error === null ? null : (_jsx(Alert, { children: send.error instanceof ApiError ? send.error.message : String(send.error) }))] }) })] }));
+}

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

@@ -1,11 +1,16 @@
 /**
  * @packageDocumentation
- * The web contribution of `shutro-erp/stock`: the scan box of counts (a barcode scanner, the keyboard or the camera).
+ * The web contribution of `shutro-erp/stock`: the scan box of counts (a barcode scanner, the keyboard or the camera) and
+ * the Replenishment page.
  */
 import { type Registry } from '../../ui/index.js';
 import type { i18n } from 'i18next';
 import { messages } from './messages.js';
+export { Ledger } from './Ledger.js';
+export { Operations } from './Operations.js';
+export { Replenishment } from './Replenishment.js';
+export { ReturnButton } from './ReturnButton.js';
 export { ScanBox } from './ScanBox.js';
-/** Registers the component (and the messages in `i18n`, when given). */
+/** Registers the component and the page (and the messages in `i18n`, when given). */
 export declare function registerStockWeb(registry: Registry, i18n?: i18n): Registry;
 export { messages as stockMessages };

package/dist/stock/web/index.js

@@ -1,14 +1,27 @@
 /**
  * @packageDocumentation
- * The web contribution of `shutro-erp/stock`: the scan box of counts (a barcode scanner, the keyboard or the camera).
+ * The web contribution of `shutro-erp/stock`: the scan box of counts (a barcode scanner, the keyboard or the camera) and
+ * the Replenishment page.
  */
 import { addMessages } from '../../ui/index.js';
+import { Ledger } from './Ledger.js';
 import { messages } from './messages.js';
+import { Operations } from './Operations.js';
+import { Replenishment } from './Replenishment.js';
+import { ReturnButton } from './ReturnButton.js';
 import { ScanBox } from './ScanBox.js';
+export { Ledger } from './Ledger.js';
+export { Operations } from './Operations.js';
+export { Replenishment } from './Replenishment.js';
+export { ReturnButton } from './ReturnButton.js';
 export { ScanBox } from './ScanBox.js';
-/** Registers the component (and the messages in `i18n`, when given). */
+/** Registers the component and the page (and the messages in `i18n`, when given). */
 export function registerStockWeb(registry, i18n) {
     registry.registerComponent('stock.Scan', ScanBox);
+    registry.registerComponent('stock.Return', ReturnButton);
+    registry.registerPage('stock.Replenishment', Replenishment);
+    registry.registerPage('stock.Operations', Operations);
+    registry.registerPage('stock.Ledger', Ledger);
     if (i18n !== undefined)
         addMessages(i18n, 'stock', messages);
     return registry;

package/dist/stock/web/messages.js

@@ -1,6 +1,109 @@
 /** Messages of the Stockroom screens (namespace `stock`), in English and Bangla. */
 export const messages = {
     en: {
+        ledger: {
+            title: 'Stock ledger',
+            tab: 'Report',
+            tabs: { summary: 'Summary', details: 'Movements', stock: 'Stock' },
+            from: 'From',
+            to: 'To',
+            warehouses: 'Warehouses (all when none is chosen)',
+            categories: 'Product categories (all when none is chosen)',
+            xlsx: 'XLSX',
+            pdf: 'PDF',
+            hints: {
+                summary: 'Per product: what the chosen warehouses held at the start of the period, what came in and went out by movement type — from where the goods came from and went to —, and what they hold at the end. Values with Accounting, for those who read the valuation.',
+                details: 'Every movement of the period in or out of the chosen warehouses, with its transfer and source document.',
+                stock: 'What the chosen warehouses hold now, per product and location: on hand, reserved, available, and what confirmed transfers will bring in or take out.',
+            },
+            empty: 'Nothing in this period and scope.',
+            product: 'Product',
+            unit: 'Unit',
+            opening: 'Opening',
+            totalIn: 'Total in',
+            totalOut: 'Total out',
+            closing: 'Closing',
+            closingValue: 'Closing value',
+            date: 'Date',
+            reference: 'Reference',
+            origin: 'Source document',
+            fromPlace: 'From',
+            toPlace: 'To',
+            movement: 'Movement',
+            quantity: 'Quantity',
+            value: 'Value',
+            location: 'Location',
+            onHand: 'On hand',
+            reserved: 'Reserved',
+            available: 'Available',
+            incoming: 'Incoming',
+            outgoing: 'Outgoing',
+            types: {
+                purchase_receipt: 'Purchase receipt',
+                sales_return: 'Sales return',
+                production_in: 'Production in',
+                transfer_in: 'Transfer in',
+                adjustment_in: 'Adjustment in',
+                other_in: 'Other in',
+                sales_delivery: 'Sales delivery',
+                purchase_return: 'Purchase return',
+                production_out: 'Production out',
+                transfer_out: 'Transfer out',
+                consumption: 'Internal use',
+                scrap: 'Scrap',
+                adjustment_out: 'Adjustment out',
+                other_out: 'Other out',
+            },
+        },
+        operations: {
+            title: 'My operations',
+            hint: 'Each warehouse’s receipts, deliveries and internal moves: ready to process, waiting for stock, and late against their scheduled date. Each count opens its transfers.',
+            loading: 'Loading…',
+            empty: 'Nothing to do: no transfer waits in any warehouse.',
+            ready: 'Ready',
+            waiting: 'Waiting',
+            late: 'Late',
+            readyOf: '{{count}} ready: {{title}}',
+            waitingOf: '{{count}} waiting: {{title}}',
+            lateOf: '{{count}} late: {{title}}',
+            kind: { receipt: 'Receipts', delivery: 'Deliveries', internal: 'Internal moves' },
+        },
+        returns: {
+            button: 'Return',
+            title: 'Return goods',
+            intro: 'How much of each line comes back, and why. The return is linked to this transfer and confirmed; validate it when the goods move.',
+            left: '{{done}} done, {{left}} can come back',
+            reason: 'Reason',
+            note: 'Note',
+            confirm: 'Make the return',
+            made: 'Return {{name}} made.',
+        },
+        replenish: {
+            title: 'Replenishment',
+            hint: 'Each rule keeps a product between its minimum and maximum in a warehouse. The forecast counts what is on hand, going out, coming in and on order; below the minimum, it proposes enough to reach the maximum.',
+            order: 'Order ({{count}})',
+            snooze: 'Snooze for a week',
+            refresh: 'Refresh the forecast',
+            all: 'Show every rule',
+            loading: 'Loading…',
+            empty: 'Nothing to order: every forecast is at or above its minimum.',
+            rule: 'Product and warehouse',
+            method: 'Replenish by',
+            onHand: 'On hand',
+            forecast: 'Forecast',
+            minMax: 'Minimum – maximum',
+            toOrder: 'To order',
+            quantityOf: 'Quantity to order for {{name}}',
+            buy: 'Buy',
+            make: 'Make',
+            transfer: 'Transfer',
+            dropship: 'Dropship',
+            refreshed: '{{count}} rules refreshed.',
+            ordered: '{{quantity}} on {{document}}.',
+            snoozed: '{{count}} rules snoozed for a week.',
+            snoozedUntil: 'Snoozed until {{date}}',
+            last: 'Last ordered on {{document}}',
+        },
         scan: {
             title: 'Scan',
             barcode: 'Barcode',
@@ -12,6 +115,109 @@ export const messages = {
         },
     },
     bn: {
+        ledger: {
+            title: 'স্টক লেজার',
+            tab: 'রিপোর্ট',
+            tabs: { summary: 'সারসংক্ষেপ', details: 'গতিবিধি', stock: 'স্টক' },
+            from: 'থেকে',
+            to: 'পর্যন্ত',
+            warehouses: 'গুদাম (কিছু না বাছলে সব)',
+            categories: 'পণ্যের ক্যাটাগরি (কিছু না বাছলে সব)',
+            xlsx: 'XLSX',
+            pdf: 'PDF',
+            hints: {
+                summary: 'পণ্য অনুযায়ী: বাছাই করা গুদামে সময়কালের শুরুতে কী ছিল, গতিবিধির ধরন অনুযায়ী কী এলো ও গেল — পণ্য কোথা থেকে এলো ও কোথায় গেল তা থেকে —, এবং শেষে কী আছে। হিসাব থাকলে মূল্যসহ, যাঁরা মূল্যায়ন পড়তে পারেন তাঁদের জন্য।',
+                details: 'সময়কালে বাছাই করা গুদামে ঢোকা বা বেরোনো প্রতিটি গতিবিধি, তার স্থানান্তর ও উৎস দলিলসহ।',
+                stock: 'বাছাই করা গুদামে এখন কী আছে, পণ্য ও লোকেশন অনুযায়ী: মজুত, সংরক্ষিত, প্রাপ্য, এবং নিশ্চিত স্থানান্তর কী আনবে বা নেবে।',
+            },
+            empty: 'এই সময়কাল ও পরিসরে কিছু নেই।',
+            product: 'পণ্য',
+            unit: 'একক',
+            opening: 'প্রারম্ভিক',
+            totalIn: 'মোট আগমন',
+            totalOut: 'মোট নির্গমন',
+            closing: 'সমাপনী',
+            closingValue: 'সমাপনী মূল্য',
+            date: 'তারিখ',
+            reference: 'রেফারেন্স',
+            origin: 'উৎস দলিল',
+            fromPlace: 'থেকে',
+            toPlace: 'যেখানে',
+            movement: 'গতিবিধি',
+            quantity: 'পরিমাণ',
+            value: 'মূল্য',
+            location: 'লোকেশন',
+            onHand: 'মজুত',
+            reserved: 'সংরক্ষিত',
+            available: 'প্রাপ্য',
+            incoming: 'আসছে',
+            outgoing: 'যাচ্ছে',
+            types: {
+                purchase_receipt: 'ক্রয় রিসিপ্ট',
+                sales_return: 'বিক্রয় ফেরত',
+                production_in: 'উৎপাদন থেকে',
+                transfer_in: 'স্থানান্তরে আগমন',
+                adjustment_in: 'সমন্বয়ে আগমন',
+                other_in: 'অন্যান্য আগমন',
+                sales_delivery: 'বিক্রয় ডেলিভারি',
+                purchase_return: 'ক্রয় ফেরত',
+                production_out: 'উৎপাদনে',
+                transfer_out: 'স্থানান্তরে নির্গমন',
+                consumption: 'অভ্যন্তরীণ ব্যবহার',
+                scrap: 'স্ক্র্যাপ',
+                adjustment_out: 'সমন্বয়ে নির্গমন',
+                other_out: 'অন্যান্য নির্গমন',
+            },
+        },
+        operations: {
+            title: 'আমার কার্যক্রম',
+            hint: 'প্রতিটি গুদামের রিসিপ্ট, ডেলিভারি ও অভ্যন্তরীণ স্থানান্তর: প্রক্রিয়ার জন্য প্রস্তুত, স্টকের অপেক্ষায়, এবং নির্ধারিত তারিখের চেয়ে দেরিতে। প্রতিটি সংখ্যা তার স্থানান্তরগুলো খোলে।',
+            loading: 'লোড হচ্ছে…',
+            empty: 'কিছু করার নেই: কোনো গুদামে কোনো স্থানান্তর অপেক্ষায় নেই।',
+            ready: 'প্রস্তুত',
+            waiting: 'অপেক্ষমাণ',
+            late: 'দেরি',
+            readyOf: '{{count}}টি প্রস্তুত: {{title}}',
+            waitingOf: '{{count}}টি অপেক্ষমাণ: {{title}}',
+            lateOf: '{{count}}টি দেরিতে: {{title}}',
+            kind: { receipt: 'রিসিপ্ট', delivery: 'ডেলিভারি', internal: 'অভ্যন্তরীণ স্থানান্তর' },
+        },
+        returns: {
+            button: 'ফেরত',
+            title: 'পণ্য ফেরত',
+            intro: 'প্রতিটি লাইনের কতটা ফেরত আসে এবং কেন। ফেরতটি এই ট্রান্সফারের সঙ্গে যুক্ত ও নিশ্চিত হয়; পণ্য সরলে তা যাচাই করুন।',
+            left: '{{done}} সম্পন্ন, {{left}} ফেরত আসতে পারে',
+            reason: 'কারণ',
+            note: 'নোট',
+            confirm: 'ফেরত তৈরি করুন',
+            made: 'ফেরত {{name}} তৈরি হয়েছে।',
+        },
+        replenish: {
+            title: 'পুনঃপূরণ',
+            hint: 'প্রতিটি নিয়ম একটি গুদামে পণ্যকে সর্বনিম্ন ও সর্বোচ্চ পরিমাণের মধ্যে রাখে। পূর্বাভাসে মজুত, বেরিয়ে যাওয়া, আসছে এবং অর্ডারে থাকা পরিমাণ গোনা হয়; সর্বনিম্নের নিচে নামলে সর্বোচ্চ পর্যন্ত পৌঁছাতে যতটুকু লাগে তা প্রস্তাব করে।',
+            order: 'অর্ডার করুন ({{count}})',
+            snooze: 'এক সপ্তাহের জন্য স্থগিত',
+            refresh: 'পূর্বাভাস হালনাগাদ করুন',
+            all: 'সব নিয়ম দেখান',
+            loading: 'লোড হচ্ছে…',
+            empty: 'অর্ডারের কিছু নেই: প্রতিটি পূর্বাভাস সর্বনিম্নে বা তার উপরে।',
+            rule: 'পণ্য ও গুদাম',
+            method: 'পূরণের উপায়',
+            onHand: 'মজুত',
+            forecast: 'পূর্বাভাস',
+            minMax: 'সর্বনিম্ন – সর্বোচ্চ',
+            toOrder: 'অর্ডার করতে হবে',
+            quantityOf: '{{name}}-এর অর্ডারের পরিমাণ',
+            buy: 'কেনা',
+            make: 'তৈরি',
+            transfer: 'স্থানান্তর',
+            dropship: 'সরাসরি সরবরাহ',
+            refreshed: '{{count}}টি নিয়ম হালনাগাদ হয়েছে।',
+            ordered: '{{document}}-এ {{quantity}}।',
+            snoozed: '{{count}}টি নিয়ম এক সপ্তাহের জন্য স্থগিত।',
+            snoozedUntil: '{{date}} পর্যন্ত স্থগিত',
+            last: 'সর্বশেষ অর্ডার {{document}}',
+        },
         scan: {
             title: 'স্ক্যান',
             barcode: 'বারকোড',

package/dist/stock_account/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 2d2d121b50759527
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 69f9bf8c989c1bd6
 // Bindings of module `stock_account`: 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';