@fieldia/widgets 0.11.0 → 0.13.0

package/src/lib/display.d.mts

@@ -1,6 +1,30 @@
 import type { LineField, Locale, Value } from '@fieldia/core';
+/**
+ * The currency a money field is in: its own, or the field holding it — on a
+ * line, `parent.` and a field of the record it is on (`parent`). A link by its
+ * name ("EGP"), a choice or text as it is; null when none is known.
+ */
+export declare function currencyOf(def: LineField, values: Readonly<Record<string, Value>>, parent?: Readonly<Record<string, Value>>): string | null;
 /**
  * A value as a person reads it where it is not being edited: a cell of the
  * lines grid, a totals row. Shared by the plain lines table and @fieldia/grid.
+ * `parent` is the record a line is on, for money in its currency.
+ */
+export declare function displayValue(def: LineField, value: Value | undefined, values?: Record<string, Value>, locale?: Locale, parent?: Readonly<Record<string, Value>>): string;
+/** How a value is shown where it is not edited: by the widget it is drawn with (a cell's, a field's), and its options. */
+export interface ShownWith {
+    widget?: string;
+    options?: Readonly<Record<string, unknown>>;
+}
+/**
+ * A value as words in the widget it is shown with — hours as HH:MM
+ * (`duration`), a fraction as a per cent (`percentage`) — else as its type
+ * says it (`displayValue`). For a table's cells and totals, plain and grid.
+ */
+export declare function cellText(def: LineField, value: Value | undefined, values?: Record<string, Value>, locale?: Locale, parent?: Readonly<Record<string, Value>>, shown?: ShownWith): string;
+/**
+ * The widgets a cell is drawn with rather than typed into: a bar, stars, a
+ * state's dot, a colour, a pill. A grid shows them in the cell itself, used
+ * there with a click; the rest are typed into as the field's own box.
  */
-export declare function displayValue(def: LineField, value: Value | undefined, values?: Record<string, Value>, locale?: Locale): string;
+export declare const DRAWN_IN_CELLS: ReadonlySet<string>;

package/src/lib/display.d.ts

@@ -1,6 +1,30 @@
 import type { LineField, Locale, Value } from '@fieldia/core';
+/**
+ * The currency a money field is in: its own, or the field holding it — on a
+ * line, `parent.` and a field of the record it is on (`parent`). A link by its
+ * name ("EGP"), a choice or text as it is; null when none is known.
+ */
+export declare function currencyOf(def: LineField, values: Readonly<Record<string, Value>>, parent?: Readonly<Record<string, Value>>): string | null;
 /**
  * A value as a person reads it where it is not being edited: a cell of the
  * lines grid, a totals row. Shared by the plain lines table and @fieldia/grid.
+ * `parent` is the record a line is on, for money in its currency.
+ */
+export declare function displayValue(def: LineField, value: Value | undefined, values?: Record<string, Value>, locale?: Locale, parent?: Readonly<Record<string, Value>>): string;
+/** How a value is shown where it is not edited: by the widget it is drawn with (a cell's, a field's), and its options. */
+export interface ShownWith {
+    widget?: string;
+    options?: Readonly<Record<string, unknown>>;
+}
+/**
+ * A value as words in the widget it is shown with — hours as HH:MM
+ * (`duration`), a fraction as a per cent (`percentage`) — else as its type
+ * says it (`displayValue`). For a table's cells and totals, plain and grid.
+ */
+export declare function cellText(def: LineField, value: Value | undefined, values?: Record<string, Value>, locale?: Locale, parent?: Readonly<Record<string, Value>>, shown?: ShownWith): string;
+/**
+ * The widgets a cell is drawn with rather than typed into: a bar, stars, a
+ * state's dot, a colour, a pill. A grid shows them in the cell itself, used
+ * there with a click; the rest are typed into as the field's own box.
  */
-export declare function displayValue(def: LineField, value: Value | undefined, values?: Record<string, Value>, locale?: Locale): string;
+export declare const DRAWN_IN_CELLS: ReadonlySet<string>;

package/src/lib/display.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DRAWN_IN_CELLS = void 0;
+exports.currencyOf = currencyOf;
 exports.displayValue = displayValue;
+exports.cellText = cellText;
 const numbers_1 = require("./numbers");
+const duration_1 = require("./duration");
+const distribution_1 = require("./distribution");
 function localDate(text) {
     const match = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2}))?/.exec(text);
     if (!match)
@@ -9,11 +14,29 @@ function localDate(text) {
     const [, y, m, d, hh, mm] = match;
     return new Date(Number(y), Number(m) - 1, Number(d), Number(hh ?? 0), Number(mm ?? 0));
 }
+/**
+ * The currency a money field is in: its own, or the field holding it — on a
+ * line, `parent.` and a field of the record it is on (`parent`). A link by its
+ * name ("EGP"), a choice or text as it is; null when none is known.
+ */
+function currencyOf(def, values, parent) {
+    if (def.type !== 'monetary')
+        return null;
+    if (def.currency)
+        return def.currency;
+    if (!def.currencyField)
+        return null;
+    const holder = def.currencyField.startsWith('parent.') ? parent?.[def.currencyField.slice('parent.'.length)] : values[def.currencyField];
+    if (holder && typeof holder === 'object' && 'label' in holder)
+        return holder.label || null;
+    return typeof holder === 'string' && holder ? holder : null;
+}
 /**
  * A value as a person reads it where it is not being edited: a cell of the
  * lines grid, a totals row. Shared by the plain lines table and @fieldia/grid.
+ * `parent` is the record a line is on, for money in its currency.
  */
-function displayValue(def, value, values = {}, locale = 'en') {
+function displayValue(def, value, values = {}, locale = 'en', parent) {
     const number = (n, digits) => (0, numbers_1.formatNumber)(n, digits, locale);
     if (value === null || value === undefined || value === '')
         return '';
@@ -32,7 +55,7 @@ function displayValue(def, value, values = {}, locale = 'en') {
         case 'float':
             return number(Number(value), def.digits?.[1] ?? 2);
         case 'monetary': {
-            const currency = def.currency ?? (def.currencyField ? values[def.currencyField]?.label : undefined);
+            const currency = currencyOf(def, values, parent);
             // Its currency's symbol, as the amount's own box shows it.
             return currency ? (0, numbers_1.formatMoney)(Number(value), currency, def.digits?.[1] ?? 2, locale) : number(Number(value), def.digits?.[1] ?? 2);
         }
@@ -58,4 +81,21 @@ function displayValue(def, value, values = {}, locale = 'en') {
             return String(value);
     }
 }
+/**
+ * A value as words in the widget it is shown with — hours as HH:MM
+ * (`duration`), a fraction as a per cent (`percentage`) — else as its type
+ * says it (`displayValue`). For a table's cells and totals, plain and grid.
+ */
+function cellText(def, value, values = {}, locale = 'en', parent, shown = {}) {
+    // An analytic distribution in a cell: its shares, "60% · 40%".
+    if (shown.widget === 'distribution' && def.type === 'json')
+        return (0, distribution_1.distributionWords)(value, locale);
+    return (0, duration_1.shownNumber)(shown.widget, def, value, locale, shown.options) ?? displayValue(def, value, values, locale, parent);
+}
+/**
+ * The widgets a cell is drawn with rather than typed into: a bar, stars, a
+ * state's dot, a colour, a pill. A grid shows them in the cell itself, used
+ * there with a click; the rest are typed into as the field's own box.
+ */
+exports.DRAWN_IN_CELLS = new Set(['progressbar', 'priority', 'dot', 'color', 'timer', 'badge']);
 //# sourceMappingURL=display.js.map

package/src/lib/display.js.map

@@ -1 +1 @@
-{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../../../libs/widgets/src/lib/display.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../../../libs/widgets/src/lib/display.ts"],"names":[],"mappings":"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"}

package/src/lib/display.mjs

@@ -1,4 +1,6 @@
 import { formatMoney, formatNumber } from './numbers.mjs';
+import { shownNumber } from './duration.mjs';
+import { distributionWords } from './distribution.mjs';
 function localDate(text) {
     const match = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2}))?/.exec(text);
     if (!match)
@@ -6,11 +8,29 @@ function localDate(text) {
     const [, y, m, d, hh, mm] = match;
     return new Date(Number(y), Number(m) - 1, Number(d), Number(hh ?? 0), Number(mm ?? 0));
 }
+/**
+ * The currency a money field is in: its own, or the field holding it — on a
+ * line, `parent.` and a field of the record it is on (`parent`). A link by its
+ * name ("EGP"), a choice or text as it is; null when none is known.
+ */
+export function currencyOf(def, values, parent) {
+    if (def.type !== 'monetary')
+        return null;
+    if (def.currency)
+        return def.currency;
+    if (!def.currencyField)
+        return null;
+    const holder = def.currencyField.startsWith('parent.') ? parent?.[def.currencyField.slice('parent.'.length)] : values[def.currencyField];
+    if (holder && typeof holder === 'object' && 'label' in holder)
+        return holder.label || null;
+    return typeof holder === 'string' && holder ? holder : null;
+}
 /**
  * A value as a person reads it where it is not being edited: a cell of the
  * lines grid, a totals row. Shared by the plain lines table and @fieldia/grid.
+ * `parent` is the record a line is on, for money in its currency.
  */
-export function displayValue(def, value, values = {}, locale = 'en') {
+export function displayValue(def, value, values = {}, locale = 'en', parent) {
     const number = (n, digits) => formatNumber(n, digits, locale);
     if (value === null || value === undefined || value === '')
         return '';
@@ -29,7 +49,7 @@ export function displayValue(def, value, values = {}, locale = 'en') {
         case 'float':
             return number(Number(value), def.digits?.[1] ?? 2);
         case 'monetary': {
-            const currency = def.currency ?? (def.currencyField ? values[def.currencyField]?.label : undefined);
+            const currency = currencyOf(def, values, parent);
             // Its currency's symbol, as the amount's own box shows it.
             return currency ? formatMoney(Number(value), currency, def.digits?.[1] ?? 2, locale) : number(Number(value), def.digits?.[1] ?? 2);
         }
@@ -55,4 +75,21 @@ export function displayValue(def, value, values = {}, locale = 'en') {
             return String(value);
     }
 }
+/**
+ * A value as words in the widget it is shown with — hours as HH:MM
+ * (`duration`), a fraction as a per cent (`percentage`) — else as its type
+ * says it (`displayValue`). For a table's cells and totals, plain and grid.
+ */
+export function cellText(def, value, values = {}, locale = 'en', parent, shown = {}) {
+    // An analytic distribution in a cell: its shares, "60% · 40%".
+    if (shown.widget === 'distribution' && def.type === 'json')
+        return distributionWords(value, locale);
+    return shownNumber(shown.widget, def, value, locale, shown.options) ?? displayValue(def, value, values, locale, parent);
+}
+/**
+ * The widgets a cell is drawn with rather than typed into: a bar, stars, a
+ * state's dot, a colour, a pill. A grid shows them in the cell itself, used
+ * there with a click; the rest are typed into as the field's own box.
+ */
+export const DRAWN_IN_CELLS = new Set(['progressbar', 'priority', 'dot', 'color', 'timer', 'badge']);
 //# sourceMappingURL=display.mjs.map

package/src/lib/display.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"display.mjs","sourceRoot":"","sources":["../../../../../libs/widgets/src/lib/display.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"display.mjs","sourceRoot":"","sources":["../../../../../libs/widgets/src/lib/display.ts"],"names":[],"mappings":"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"}

package/src/lib/distribution.d.mts

@@ -0,0 +1,13 @@
+import type { Locale, RecordId, Value } from '@fieldia/core';
+import type { WidgetFactory } from './widgets.mjs';
+/** The model a distribution's accounts are records of: its `options.model`, else Flectra's analytic accounts. */
+export declare const distributionModel: (options: Readonly<Record<string, unknown>> | undefined) => string;
+/** The accounts' ids a distribution names, each once, as a data source finds them. */
+export declare function distributionIds(value: Value | undefined): RecordId[];
+/**
+ * A distribution in a few words, for a table's cell: each account by its
+ * name — `nameOf`, when it knows it — and its share, "Sales 60% · Marketing
+ * 40%"; the shares alone without names. Empty for none.
+ */
+export declare function distributionWords(value: Value | undefined, locale?: Locale, nameOf?: (id: string) => string | undefined): string;
+export declare const distributionWidget: WidgetFactory;

package/src/lib/distribution.d.ts

@@ -0,0 +1,13 @@
+import type { Locale, RecordId, Value } from '@fieldia/core';
+import type { WidgetFactory } from './widgets';
+/** The model a distribution's accounts are records of: its `options.model`, else Flectra's analytic accounts. */
+export declare const distributionModel: (options: Readonly<Record<string, unknown>> | undefined) => string;
+/** The accounts' ids a distribution names, each once, as a data source finds them. */
+export declare function distributionIds(value: Value | undefined): RecordId[];
+/**
+ * A distribution in a few words, for a table's cell: each account by its
+ * name — `nameOf`, when it knows it — and its share, "Sales 60% · Marketing
+ * 40%"; the shares alone without names. Empty for none.
+ */
+export declare function distributionWords(value: Value | undefined, locale?: Locale, nameOf?: (id: string) => string | undefined): string;
+export declare const distributionWidget: WidgetFactory;

package/src/lib/distribution.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distributionWidget = exports.distributionModel = void 0;
+exports.distributionIds = distributionIds;
+exports.distributionWords = distributionWords;
+const kind_parts_1 = require("./kind-parts");
+const numbers_1 = require("./numbers");
+const relations_1 = require("./relations");
+/** The model a distribution's accounts are records of: its `options.model`, else Flectra's analytic accounts. */
+const distributionModel = (options) => (typeof options?.['model'] === 'string' ? options['model'] : 'account.analytic.account');
+exports.distributionModel = distributionModel;
+/** The accounts' ids a distribution names, each once, as a data source finds them. */
+function distributionIds(value) {
+    return [...new Set(sharesOf(value).flatMap(([key]) => key.split(',')))].map((one) => (/^\d+$/.test(one) ? Number(one) : one));
+}
+/**
+ * A distribution in a few words, for a table's cell: each account by its
+ * name — `nameOf`, when it knows it — and its share, "Sales 60% · Marketing
+ * 40%"; the shares alone without names. Empty for none.
+ */
+function distributionWords(value, locale = 'en', nameOf) {
+    const percent = (n) => `${(0, numbers_1.formatNumber)(n, Number.isInteger(n) ? 0 : 2, locale)}%`;
+    return sharesOf(value)
+        .map(([key, share]) => {
+        const name = nameOf ? key.split(',').map((one) => nameOf(one) ?? `#${one}`).join(' · ') : '';
+        return name ? `${name} ${percent(share)}` : percent(share);
+    })
+        .join(nameOf ? ', ' : ' · ');
+}
+const sharesOf = (value) => value && typeof value === 'object' && !Array.isArray(value) ? Object.entries(value).map(([key, share]) => [key, typeof share === 'number' ? share : Number(share) || 0]) : [];
+const distributionWidget = (context) => {
+    const { form, name, node, id, document, labels, locale = 'en' } = context;
+    const make = (0, kind_parts_1.maker)(document);
+    const words = (0, kind_parts_1.wordsFor)(labels, locale);
+    const model = (0, exports.distributionModel)(node.options);
+    /** The accounts' names, by their key, as they are found. */
+    const names = new Map();
+    const nameOf = (key) => key.split(',').map((one) => names.get(one) ?? `#${one}`).join(' · ');
+    const percent = (n) => `${(0, numbers_1.formatNumber)(n, Number.isInteger(n) ? 0 : 2, locale)}%`;
+    const body = make('tbody');
+    const total = make('td', { class: 'fd-distribution-total' });
+    const table = make('table', { class: 'fd-lines-table fd-distribution-table' }, make('thead', {}, make('tr', {}, make('th', { scope: 'col' }, words.account), make('th', { scope: 'col', class: 'fd-distribution-share' }, words.share), make('th', { class: 'fd-lines-tools' }))), body, make('tfoot', {}, make('tr', { class: 'fd-lines-totals' }, make('td', {}, words.total), total, make('td'))));
+    const add = make('button', { type: 'button', class: 'fd-button fd-button-link fd-lines-add fd-distribution-add' }, `+ ${words.addAccount}`);
+    const off = make('div', { class: 'fd-warning fd-distribution-off', role: 'status', hidden: '' });
+    const element = make('div', { id, class: 'fd-distribution', role: 'group' }, make('div', { class: 'fd-lines-scroll' }, table), add, off);
+    let rows = [];
+    let readonly = false;
+    /** The value the lines say: those with an account, in their order. */
+    function save() {
+        const value = {};
+        for (const row of rows)
+            if (row.key)
+                value[row.key] = row.share;
+        form.setValue(name, (rows.some((row) => row.key) ? value : null));
+    }
+    function makeRow(key, share) {
+        const n = rows.length;
+        const cellId = `${id}-${n}-${Math.random().toString(36).slice(2, 7)}`;
+        // The account's own link box: it searches the model's records, and its pick becomes the line's key.
+        const row = { key, share };
+        const own = {
+            ...form,
+            getState: () => ({ ...form.getState(), values: { account: row.key ? { id: row.key, label: nameOf(row.key) } : null } }),
+            setValue: (_name, picked) => {
+                const record = picked;
+                row.key = record ? String(record.id) : '';
+                if (record)
+                    names.set(String(record.id), record.label);
+                save();
+            },
+            search: (_name, query, limit) => form.search(name, query, limit, { model }),
+            canCreate: () => false,
+        };
+        const accountField = { type: 'many2one', label: words.account, relation: model };
+        row.account = (0, relations_1.many2oneWidget)({ ...context, form: own, name: 'account', field: accountField, node: { type: 'field', id: `${node.id}.account`, field: 'account', options: { create: false } }, id: cellId });
+        row.input = make('input', { type: 'text', class: 'fd-input fd-number-input fd-share', inputmode: 'decimal', autocomplete: 'off', 'aria-label': words.share });
+        row.input.addEventListener('input', () => {
+            const text = (0, numbers_1.normalizeNumber)(row.input.value.trim(), locale);
+            if (!/^\d+\.?\d*$|^\.\d+$/.test(text))
+                return;
+            row.share = Number(text);
+            save();
+        });
+        row.remove = make('button', { type: 'button', class: 'fd-line-delete', 'aria-label': words.deleteLine }, '×');
+        row.remove.addEventListener('click', () => {
+            rows = rows.filter((other) => other !== row);
+            row.account.destroy?.();
+            row.element.remove();
+            save();
+            draw();
+        });
+        row.element = make('tr', {}, make('td', {}, make('label', { class: 'fd-sr-only', for: cellId }, words.account), row.account.element), make('td', { class: 'fd-distribution-share' }, make('span', { class: 'fd-number' }, row.input, make('span', { class: 'fd-unit' }, '%'))), make('td', { class: 'fd-lines-tools' }, row.remove));
+        return row;
+    }
+    add.addEventListener('click', () => {
+        const left = Math.max(0, 100 - rows.reduce((sum, row) => sum + row.share, 0));
+        const row = makeRow('', Math.round(left * 100) / 100);
+        rows.push(row);
+        body.append(row.element);
+        draw();
+        row.account.focus();
+    });
+    /** Names for the accounts the value holds that are not known yet. */
+    let asked = '';
+    function findNames(keys) {
+        const unknown = [...new Set(keys.flatMap((key) => key.split(',')))].filter((one) => !names.has(one));
+        if (!unknown.length || unknown.join() === asked)
+            return;
+        asked = unknown.join();
+        const ids = unknown.map((one) => (/^\d+$/.test(one) ? Number(one) : one));
+        form.search(name, '', unknown.length, { model, ids }).then((found) => {
+            for (const record of found)
+                names.set(String(record.id), record.label);
+            draw();
+        }, () => undefined);
+    }
+    function draw() {
+        const sum = rows.reduce((total, row) => total + row.share, 0);
+        (0, kind_parts_1.setText)(total, percent(Math.round(sum * 100) / 100));
+        const wrong = rows.some((row) => row.key) && Math.abs(sum - 100) > 0.001;
+        (0, kind_parts_1.setText)(off, wrong ? (0, kind_parts_1.fillIn)(words.sharesOff, { n: percent(Math.round(sum * 100) / 100) }) : '');
+        (0, kind_parts_1.setHidden)(off, !wrong);
+        (0, kind_parts_1.setHidden)(add, readonly);
+        for (const row of rows) {
+            row.account.update({ value: row.key ? { id: row.key, label: nameOf(row.key) } : null, values: {}, readonly, required: false, invalid: false });
+            const text = (0, numbers_1.formatNumber)(row.share, Number.isInteger(row.share) ? 0 : 2, locale);
+            if (document.activeElement !== row.input && row.input.value !== text)
+                row.input.value = text;
+            row.input.readOnly = readonly;
+            if (readonly)
+                row.remove.remove();
+            else if (!row.remove.isConnected)
+                row.element.lastElementChild?.append(row.remove);
+        }
+    }
+    return {
+        element,
+        focus: () => (rows[0]?.input ?? add).focus(),
+        destroy: () => rows.forEach((row) => row.account.destroy?.()),
+        update(state) {
+            readonly = state.readonly;
+            const shares = sharesOf(state.value);
+            // Lines follow the value: those it holds, in its order, and a new one still without its account.
+            const same = shares.length === rows.filter((row) => row.key).length && shares.every(([key, share], i) => rows.filter((row) => row.key)[i]?.key === key && rows.filter((row) => row.key)[i]?.share === share);
+            if (!same) {
+                for (const row of rows)
+                    row.account.destroy?.();
+                const waiting = rows.filter((row) => !row.key);
+                rows = shares.map(([key, share]) => makeRow(key, share));
+                rows.push(...waiting.map((row) => makeRow('', row.share)));
+                body.replaceChildren(...rows.map((row) => row.element));
+            }
+            findNames(shares.map(([key]) => key));
+            draw();
+        },
+    };
+};
+exports.distributionWidget = distributionWidget;
+//# sourceMappingURL=distribution.js.map

package/src/lib/distribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution.js","sourceRoot":"","sources":["../../../../../libs/widgets/src/lib/distribution.ts"],"names":[],"mappings":"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"}

package/src/lib/distribution.mjs

@@ -0,0 +1,152 @@
+import { fillIn, maker, setHidden, setText, wordsFor } from './kind-parts.mjs';
+import { formatNumber, normalizeNumber } from './numbers.mjs';
+import { many2oneWidget } from './relations.mjs';
+/** The model a distribution's accounts are records of: its `options.model`, else Flectra's analytic accounts. */
+export const distributionModel = (options) => (typeof options?.['model'] === 'string' ? options['model'] : 'account.analytic.account');
+/** The accounts' ids a distribution names, each once, as a data source finds them. */
+export function distributionIds(value) {
+    return [...new Set(sharesOf(value).flatMap(([key]) => key.split(',')))].map((one) => (/^\d+$/.test(one) ? Number(one) : one));
+}
+/**
+ * A distribution in a few words, for a table's cell: each account by its
+ * name — `nameOf`, when it knows it — and its share, "Sales 60% · Marketing
+ * 40%"; the shares alone without names. Empty for none.
+ */
+export function distributionWords(value, locale = 'en', nameOf) {
+    const percent = (n) => `${formatNumber(n, Number.isInteger(n) ? 0 : 2, locale)}%`;
+    return sharesOf(value)
+        .map(([key, share]) => {
+        const name = nameOf ? key.split(',').map((one) => nameOf(one) ?? `#${one}`).join(' · ') : '';
+        return name ? `${name} ${percent(share)}` : percent(share);
+    })
+        .join(nameOf ? ', ' : ' · ');
+}
+const sharesOf = (value) => value && typeof value === 'object' && !Array.isArray(value) ? Object.entries(value).map(([key, share]) => [key, typeof share === 'number' ? share : Number(share) || 0]) : [];
+export const distributionWidget = (context) => {
+    const { form, name, node, id, document, labels, locale = 'en' } = context;
+    const make = maker(document);
+    const words = wordsFor(labels, locale);
+    const model = distributionModel(node.options);
+    /** The accounts' names, by their key, as they are found. */
+    const names = new Map();
+    const nameOf = (key) => key.split(',').map((one) => names.get(one) ?? `#${one}`).join(' · ');
+    const percent = (n) => `${formatNumber(n, Number.isInteger(n) ? 0 : 2, locale)}%`;
+    const body = make('tbody');
+    const total = make('td', { class: 'fd-distribution-total' });
+    const table = make('table', { class: 'fd-lines-table fd-distribution-table' }, make('thead', {}, make('tr', {}, make('th', { scope: 'col' }, words.account), make('th', { scope: 'col', class: 'fd-distribution-share' }, words.share), make('th', { class: 'fd-lines-tools' }))), body, make('tfoot', {}, make('tr', { class: 'fd-lines-totals' }, make('td', {}, words.total), total, make('td'))));
+    const add = make('button', { type: 'button', class: 'fd-button fd-button-link fd-lines-add fd-distribution-add' }, `+ ${words.addAccount}`);
+    const off = make('div', { class: 'fd-warning fd-distribution-off', role: 'status', hidden: '' });
+    const element = make('div', { id, class: 'fd-distribution', role: 'group' }, make('div', { class: 'fd-lines-scroll' }, table), add, off);
+    let rows = [];
+    let readonly = false;
+    /** The value the lines say: those with an account, in their order. */
+    function save() {
+        const value = {};
+        for (const row of rows)
+            if (row.key)
+                value[row.key] = row.share;
+        form.setValue(name, (rows.some((row) => row.key) ? value : null));
+    }
+    function makeRow(key, share) {
+        const n = rows.length;
+        const cellId = `${id}-${n}-${Math.random().toString(36).slice(2, 7)}`;
+        // The account's own link box: it searches the model's records, and its pick becomes the line's key.
+        const row = { key, share };
+        const own = {
+            ...form,
+            getState: () => ({ ...form.getState(), values: { account: row.key ? { id: row.key, label: nameOf(row.key) } : null } }),
+            setValue: (_name, picked) => {
+                const record = picked;
+                row.key = record ? String(record.id) : '';
+                if (record)
+                    names.set(String(record.id), record.label);
+                save();
+            },
+            search: (_name, query, limit) => form.search(name, query, limit, { model }),
+            canCreate: () => false,
+        };
+        const accountField = { type: 'many2one', label: words.account, relation: model };
+        row.account = many2oneWidget({ ...context, form: own, name: 'account', field: accountField, node: { type: 'field', id: `${node.id}.account`, field: 'account', options: { create: false } }, id: cellId });
+        row.input = make('input', { type: 'text', class: 'fd-input fd-number-input fd-share', inputmode: 'decimal', autocomplete: 'off', 'aria-label': words.share });
+        row.input.addEventListener('input', () => {
+            const text = normalizeNumber(row.input.value.trim(), locale);
+            if (!/^\d+\.?\d*$|^\.\d+$/.test(text))
+                return;
+            row.share = Number(text);
+            save();
+        });
+        row.remove = make('button', { type: 'button', class: 'fd-line-delete', 'aria-label': words.deleteLine }, '×');
+        row.remove.addEventListener('click', () => {
+            rows = rows.filter((other) => other !== row);
+            row.account.destroy?.();
+            row.element.remove();
+            save();
+            draw();
+        });
+        row.element = make('tr', {}, make('td', {}, make('label', { class: 'fd-sr-only', for: cellId }, words.account), row.account.element), make('td', { class: 'fd-distribution-share' }, make('span', { class: 'fd-number' }, row.input, make('span', { class: 'fd-unit' }, '%'))), make('td', { class: 'fd-lines-tools' }, row.remove));
+        return row;
+    }
+    add.addEventListener('click', () => {
+        const left = Math.max(0, 100 - rows.reduce((sum, row) => sum + row.share, 0));
+        const row = makeRow('', Math.round(left * 100) / 100);
+        rows.push(row);
+        body.append(row.element);
+        draw();
+        row.account.focus();
+    });
+    /** Names for the accounts the value holds that are not known yet. */
+    let asked = '';
+    function findNames(keys) {
+        const unknown = [...new Set(keys.flatMap((key) => key.split(',')))].filter((one) => !names.has(one));
+        if (!unknown.length || unknown.join() === asked)
+            return;
+        asked = unknown.join();
+        const ids = unknown.map((one) => (/^\d+$/.test(one) ? Number(one) : one));
+        form.search(name, '', unknown.length, { model, ids }).then((found) => {
+            for (const record of found)
+                names.set(String(record.id), record.label);
+            draw();
+        }, () => undefined);
+    }
+    function draw() {
+        const sum = rows.reduce((total, row) => total + row.share, 0);
+        setText(total, percent(Math.round(sum * 100) / 100));
+        const wrong = rows.some((row) => row.key) && Math.abs(sum - 100) > 0.001;
+        setText(off, wrong ? fillIn(words.sharesOff, { n: percent(Math.round(sum * 100) / 100) }) : '');
+        setHidden(off, !wrong);
+        setHidden(add, readonly);
+        for (const row of rows) {
+            row.account.update({ value: row.key ? { id: row.key, label: nameOf(row.key) } : null, values: {}, readonly, required: false, invalid: false });
+            const text = formatNumber(row.share, Number.isInteger(row.share) ? 0 : 2, locale);
+            if (document.activeElement !== row.input && row.input.value !== text)
+                row.input.value = text;
+            row.input.readOnly = readonly;
+            if (readonly)
+                row.remove.remove();
+            else if (!row.remove.isConnected)
+                row.element.lastElementChild?.append(row.remove);
+        }
+    }
+    return {
+        element,
+        focus: () => (rows[0]?.input ?? add).focus(),
+        destroy: () => rows.forEach((row) => row.account.destroy?.()),
+        update(state) {
+            readonly = state.readonly;
+            const shares = sharesOf(state.value);
+            // Lines follow the value: those it holds, in its order, and a new one still without its account.
+            const same = shares.length === rows.filter((row) => row.key).length && shares.every(([key, share], i) => rows.filter((row) => row.key)[i]?.key === key && rows.filter((row) => row.key)[i]?.share === share);
+            if (!same) {
+                for (const row of rows)
+                    row.account.destroy?.();
+                const waiting = rows.filter((row) => !row.key);
+                rows = shares.map(([key, share]) => makeRow(key, share));
+                rows.push(...waiting.map((row) => makeRow('', row.share)));
+                body.replaceChildren(...rows.map((row) => row.element));
+            }
+            findNames(shares.map(([key]) => key));
+            draw();
+        },
+    };
+};
+//# sourceMappingURL=distribution.mjs.map