@panneau/lists 5.0.0-alpha.2 → 5.0.0-alpha.21

package/dist/types.d.ts

@@ -6,7 +6,10 @@ import type { Abilities, Action, ActionScope, Field, Filter, FilterValue, Option
  */
 export interface ListItem {
     id: string;
-    /** What the user can do with the item. Without abilities, every action is shown. */
+    /**
+     * What the user can do with the item. Without abilities, the built-in item actions (`show`,
+     * `edit`, `duplicate`, `delete`) are hidden, and the other actions are shown.
+     */
     abilities?: Abilities;
     [key: string]: unknown;
 }
@@ -25,6 +28,10 @@ export interface ListColumn {
     sortable?: boolean;
     width?: number | string;
     align?: 'start' | 'center' | 'end';
+    /** Not shown until the user shows it, from the columns of the list (decision 0042). */
+    hidden?: boolean;
+    /** `false`: always shown. The user can move it, not hide it. */
+    hideable?: boolean;
     /** Renders the cell, instead of a display. */
     render?: (item: ListItem) => ReactNode;
 }
@@ -52,6 +59,16 @@ export interface ListActionEvent {
     /** Selected items of the current page that don't allow the action: the backend skips them. */
     skipped: readonly ListItem[];
 }
+/** What the backend told about an action on a query selection: how many items it would skip. */
+export interface ListActionPreview {
+    skipped: number;
+}
+/**
+ * Asks the backend what an action would do on a query selection, before the list confirms it (a
+ * dry run, for actions with `dryRun`), or resolves with `null` when it can't tell.
+ * `useActionPreview()` of `@panneau/actions` is one.
+ */
+export type ListActionPreviewer = (event: ListActionEvent) => Promise<ListActionPreview | null>;
 /**
  * Runs an action. Lists ask for confirmation first when the action has `confirm`. A returned
  * promise shows the action as pending until it settles; after a selection action succeeds, the
@@ -59,6 +76,20 @@ export interface ListActionEvent {
  * cancels its parameters). `useActionRunner()` of `@panneau/actions` is such a handler.
  */
 export type ListActionHandler = (event: ListActionEvent) => unknown;
+/** A value changed in place, in a cell of the list (decision 0043). */
+export interface ListInlineEditEvent {
+    /** The item, with the version the value was edited from. */
+    item: ListItem;
+    /** The field the cell edits. */
+    field: Field;
+    value: unknown;
+}
+/**
+ * Saves one field of an item, changed in place, and resolves with the updated item. It rejects
+ * with a problem, or an error with a `problem` (as the errors of `@panneau/data`): a `422` shows
+ * its messages on the cell, and a `412` with the `current` item offers to keep it or save over it.
+ */
+export type ListInlineEditHandler = (event: ListInlineEditEvent) => Promise<ListItem>;
 /** Props of a filter control. */
 export interface FilterControlProps {
     filter: Filter;
@@ -77,6 +108,29 @@ export interface FilterControlProps {
 }
 /** A filter control, by filter type (`select`, `date`). */
 export type FilterEntry = ComponentType<FilterControlProps>;
+/** What the `calendar` layout shows: the month of its items, and how to change it (decision 0044). */
+export interface ListCalendarProps {
+    /**
+     * The `date`, `datetime` or `daterange` field each item is shown on the day of, or on each day
+     * of its range (decision 0053).
+     */
+    field: string;
+    /**
+     * The time zone of the field's date-times (`settings.timeZone`), whose days the calendar
+     * shows. Without it, the browser's.
+     */
+    timeZone?: string | null | undefined;
+    /** The month shown (`2026-11`). */
+    month: string;
+    onMonthChange: (month: string) => void;
+    /**
+     * When the month has more items than the list got: how many match (`null` when the backend
+     * doesn't count them).
+     */
+    more: {
+        total: number | null;
+    } | null;
+}
 /** Props of a list layout: renders the items of the current page. */
 export interface ListLayoutProps {
     items: readonly ListItem[];
@@ -87,6 +141,8 @@ export interface ListLayoutProps {
     getItemLabel: (item: ListItem) => string;
     /** A link to the item, when the list has one. */
     getItemHref?: ((item: ListItem) => string | null) | undefined;
+    /** Whether the item is the one shown next to the list, such as in a panel of its details. */
+    isCurrent?: ((item: ListItem) => boolean) | undefined;
     /** Whether items have checkboxes. */
     selectable: boolean;
     isSelected: (item: ListItem) => boolean;
@@ -100,6 +156,18 @@ export interface ListLayoutProps {
     label: string;
     /** The checkbox that selects the page, for layouts that show it in a header. */
     pageSelection: ReactNode;
+    /**
+     * The URL of the image of an item (`itemImage` of the resource), or `null` for an item without
+     * one: the gallery shows it, and the table its thumbnail. `undefined` when items have no image.
+     */
+    getItemImage?: ((item: ListItem) => string | null) | undefined;
+    /** The month of the calendar, in the `calendar` layout. */
+    calendar?: ListCalendarProps | undefined;
+    /**
+     * Wraps the content of a cell (its value, or the title's link): a column that edits its
+     * field in place does it there (decision 0043). Without it, the content is the cell.
+     */
+    renderCell?: ((item: ListItem, column: ListColumn, content: ReactNode) => ReactNode) | undefined;
 }
 /** A list layout, by id (`table`, `cards`). */
 export type ListLayoutEntry = ComponentType<ListLayoutProps>;

package/dist/types.d.ts.map

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

package/dist/useDraft.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDraft.js","names":["_c"],"sources":["../src/useDraft.ts"],"sourcesContent":["import { useEffect, useEffectEvent, useState } from 'react';\n\n/**\n * A text that is typed locally and committed after a pause: the list query changes once the user\n * stops typing, not on every key. A change of `value` from outside (a chip removed, the query\n * reset) replaces the draft.\n */\nexport function useDraft(\n    value: string,\n    commit: (value: string) => void,\n    delay = 300,\n): { draft: string; setDraft: (draft: string) => void; flush: () => void } {\n    const [draft, setDraft] = useState(value);\n    const [synced, setSynced] = useState(value);\n    if (value !== synced) {\n        setSynced(value);\n        setDraft(value);\n    }\n    const onCommit = useEffectEvent((next: string) => commit(next));\n    useEffect(() => {\n        if (draft === synced) {\n            return undefined;\n        }\n        const timer = setTimeout(() => onCommit(draft), delay);\n        return () => clearTimeout(timer);\n    }, [draft, synced, delay]);\n    return {\n        draft,\n        setDraft,\n        flush: () => {\n            if (draft !== synced) {\n                commit(draft);\n            }\n        },\n    };\n}\n"],"mappings":";;;;;;;;AAOA,SAAO,SAAA,OAAA,QAAA,IAAA;CAAA,MAAA,IAAAA,EAAA,EAAA;CAGH,MAAA,QAAA,OAAA,KAAA,IAAA,MAAA;CAEA,MAAA,CAAA,OAAA,YAA0B,SAAS,KAAK;CACxC,MAAA,CAAA,QAAA,aAA4B,SAAS,KAAK;CAC1C,IAAI,UAAU,QAAM;EAChB,UAAU,KAAK;EACf,SAAS,KAAK;CAAC;CAClB,IAAA;CAAA,IAAA,EAAA,OAAA,QAAA;EAC+B,MAAA,SAAkB,OAAO,IAAI;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAA9D,MAAA,WAAiB,eAAe,EAA8B;CAAE,IAAA;CAAA,IAAA,EAAA,OAAA,SAAA,EAAA,OAAA,SAAA,EAAA,OAAA,YAAA,EAAA,OAAA,QAAA;EACtD,WAAA;GACN,IAAI,UAAU,QAAM;GAGpB,MAAA,QAAc,iBAAiB,SAAS,KAAK,GAAG,KAAK;GAAE,aAC1C,aAAa,KAAK;EAAC;EACnC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,OAAA,SAAA,EAAA,OAAA,SAAA,EAAA,OAAA,QAAA;EAAE,KAAA;GAAC;GAAO;GAAQ;EAAK;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CANzB,UAAU,IAMP,EAAsB;CAAC,IAAA;CAAA,IAAA,EAAA,QAAA,UAAA,EAAA,QAAA,SAAA,EAAA,QAAA,QAAA;EAIf,WAAA;GACH,IAAI,UAAU,QACV,OAAO,KAAK;EACf;EACJ,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,QAAA,SAAA,EAAA,QAAA,IAAA;EAPE,KAAA;GAAA;GAAA;GAAA,OAGI;EAKX;EAAC,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,OARM;AAQN"}
+{"version":3,"file":"useDraft.js","names":["useEffect","useEffectEvent","useState","useDraft","value","commit","t0","$","_c","delay","undefined","draft","setDraft","synced","setSynced","t1","next","onCommit","t2","timer","setTimeout","clearTimeout","t3","t4","t5","flush","_c"],"sources":["../src/useDraft.ts"],"sourcesContent":["import { useEffect, useEffectEvent, useState } from 'react';\n\n/**\n * A text that is typed locally and committed after a pause: the list query changes once the user\n * stops typing, not on every key. A change of `value` from outside (a chip removed, the query\n * reset) replaces the draft.\n */\nexport function useDraft(\n    value: string,\n    commit: (value: string) => void,\n    delay = 300,\n): { draft: string; setDraft: (draft: string) => void; flush: () => void } {\n    const [draft, setDraft] = useState(value);\n    const [synced, setSynced] = useState(value);\n    if (value !== synced) {\n        setSynced(value);\n        setDraft(value);\n    }\n    const onCommit = useEffectEvent((next: string) => commit(next));\n    useEffect(() => {\n        if (draft === synced) {\n            return undefined;\n        }\n        const timer = setTimeout(() => onCommit(draft), delay);\n        return () => clearTimeout(timer);\n    }, [draft, synced, delay]);\n    return {\n        draft,\n        setDraft,\n        flush: () => {\n            if (draft !== synced) {\n                commit(draft);\n            }\n        },\n    };\n}\n"],"mappings":";;;;;;;;AAOA,SAAOG,SAAAC,OAAAC,QAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAGH,MAAAC,QAAAH,OAAAI,KAAAA,IAAA,MAAAJ;CAEA,MAAA,CAAAK,OAAAC,YAA0BV,SAASE,KAAK;CACxC,MAAA,CAAAS,QAAAC,aAA4BZ,SAASE,KAAK;CAC1C,IAAIA,UAAUS,QAAM;EAChBC,UAAUV,KAAK;EACfQ,SAASR,KAAK;CAAC;CAClB,IAAAW;CAAA,IAAAR,EAAA,OAAAF,QAAA;EAC+BU,MAAAC,SAAkBX,OAAOW,IAAI;EAACT,EAAA,KAAAF;EAAAE,EAAA,KAAAQ;CAAA,OAAAA,KAAAR,EAAA;CAA9D,MAAAU,WAAiBhB,eAAec,EAA8B;CAAE,IAAAG;CAAA,IAAAX,EAAA,OAAAE,SAAAF,EAAA,OAAAI,SAAAJ,EAAA,OAAAU,YAAAV,EAAA,OAAAM,QAAA;EACtDK,WAAA;GACN,IAAIP,UAAUE,QAAM;GAGpB,MAAAM,QAAcC,iBAAiBH,SAASN,KAAK,GAAGF,KAAK;GAAE,aAC1CY,aAAaF,KAAK;EAAC;EACnCZ,EAAA,KAAAE;EAAAF,EAAA,KAAAI;EAAAJ,EAAA,KAAAU;EAAAV,EAAA,KAAAM;EAAAN,EAAA,KAAAW;CAAA,OAAAA,KAAAX,EAAA;CAAA,IAAAe;CAAA,IAAAf,EAAA,OAAAE,SAAAF,EAAA,OAAAI,SAAAJ,EAAA,OAAAM,QAAA;EAAES,KAAA;GAACX;GAAOE;GAAQJ;EAAK;EAACF,EAAA,KAAAE;EAAAF,EAAA,KAAAI;EAAAJ,EAAA,KAAAM;EAAAN,EAAA,MAAAe;CAAA,OAAAA,KAAAf,EAAA;CANzBP,UAAUkB,IAMPI,EAAsB;CAAC,IAAAC;CAAA,IAAAhB,EAAA,QAAAF,UAAAE,EAAA,QAAAI,SAAAJ,EAAA,QAAAM,QAAA;EAIfU,WAAA;GACH,IAAIZ,UAAUE,QACVR,OAAOM,KAAK;EACf;EACJJ,EAAA,MAAAF;EAAAE,EAAA,MAAAI;EAAAJ,EAAA,MAAAM;EAAAN,EAAA,MAAAgB;CAAA,OAAAA,KAAAhB,EAAA;CAAA,IAAAiB;CAAA,IAAAjB,EAAA,QAAAI,SAAAJ,EAAA,QAAAgB,IAAA;EAPEC,KAAA;GAAAb;GAAAC;GAAAa,OAGIF;EAKX;EAAChB,EAAA,MAAAI;EAAAJ,EAAA,MAAAgB;EAAAhB,EAAA,MAAAiB;CAAA,OAAAA,KAAAjB,EAAA;CAAA,OARMiB;AAQN"}

package/dist/useListState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useListState.js","names":[],"sources":["../src/useListState.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport type { List, ListState } from '@panneau/core';\n\n/** The state of a list created elsewhere (`createList()`, `useList()`), kept up to date. */\nexport function useListState(list: List): ListState {\n    return useSyncExternalStore(list.subscribe, list.getState, list.getState);\n}\n"],"mappings":";;;AAKA,SAAO,aAAA,MAAA;CAAA,OACI,qBAAqB,KAAI,WAAY,KAAI,UAAW,KAAI,QAAS;AAAC"}
+{"version":3,"file":"useListState.js","names":["useSyncExternalStore","List","ListState","useListState","list","subscribe","getState"],"sources":["../src/useListState.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport type { List, ListState } from '@panneau/core';\n\n/** The state of a list created elsewhere (`createList()`, `useList()`), kept up to date. */\nexport function useListState(list: List): ListState {\n    return useSyncExternalStore(list.subscribe, list.getState, list.getState);\n}\n"],"mappings":";;;AAKA,SAAOG,aAAAC,MAAA;CAAA,OACIJ,qBAAqBI,KAAIC,WAAYD,KAAIE,UAAWF,KAAIE,QAAS;AAAC"}

package/dist/useRenderValue.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+import type { DisplayEntry, ListColumn, ListItem } from './types.js';
+/**
+ * Renders the value of a column for an item with its display: those given, over those of the
+ * plugins, over the built-in ones. A compound field without a display of its own (decision 0065)
+ * shows the summaries of its field entry. Other columns without a known display, and compound
+ * fields without a summary, show their value as text.
+ */
+export declare function useRenderValue(displays?: Readonly<Record<string, DisplayEntry>>): (item: ListItem, column: ListColumn) => ReactNode;
+//# sourceMappingURL=useRenderValue.d.ts.map

package/dist/useRenderValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderValue.d.ts","sourceRoot":"","sources":["../src/useRenderValue.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGlE;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAM,GACtD,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,KAAK,SAAS,CA4CnD"}

package/dist/useRenderValue.js

@@ -0,0 +1,84 @@
+import { getColumnValue } from "./values.js";
+import Displays_module_default from "./displays/Displays.module.js";
+import { builtInDisplays } from "./displays/displays.js";
+import { usePlugins } from "@panneau/core";
+import { c } from "react/compiler-runtime";
+import { usePanneauIntl } from "@panneau/ui";
+import { jsx } from "react/jsx-runtime";
+import { summarizeCompound } from "@panneau/fields";
+import { isCompoundField } from "@panneau/protocol/runtime";
+//#region src/useRenderValue.tsx
+/**
+* Renders the value of a column for an item with its display: those given, over those of the
+* plugins, over the built-in ones. A compound field without a display of its own (decision 0065)
+* shows the summaries of its field entry. Other columns without a known display, and compound
+* fields without a summary, show their value as text.
+*/
+function useRenderValue(t0) {
+	const $ = c(11);
+	let t1;
+	if ($[0] !== t0) {
+		t1 = t0 === void 0 ? {} : t0;
+		$[0] = t0;
+		$[1] = t1;
+	} else t1 = $[1];
+	const displays = t1;
+	const intl = usePanneauIntl();
+	const plugins = usePlugins();
+	let t2;
+	if ($[2] !== plugins.displays) {
+		t2 = Object.fromEntries(plugins.displays);
+		$[2] = plugins.displays;
+		$[3] = t2;
+	} else t2 = $[3];
+	const t3 = t2;
+	let t4;
+	if ($[4] !== displays || $[5] !== t3) {
+		t4 = {
+			...builtInDisplays,
+			...t3,
+			...displays
+		};
+		$[4] = displays;
+		$[5] = t3;
+		$[6] = t4;
+	} else t4 = $[6];
+	const allDisplays = t4;
+	let t5;
+	if ($[7] !== allDisplays || $[8] !== intl || $[9] !== plugins.fields) {
+		t5 = (item, column) => {
+			if (column.render !== void 0) return column.render(item);
+			const own = column.display !== void 0 && column.display !== null ? allDisplays[column.display] : void 0;
+			const field = column.field ?? null;
+			if (own === void 0 && field !== null && isCompoundField(field)) {
+				const value = getColumnValue(item, column, intl.locale);
+				const summary = summarizeCompound(plugins.fields.get(field.type), value, {
+					field,
+					locale: intl.locale
+				});
+				if (summary !== null) return /* @__PURE__ */ jsx("span", {
+					className: Displays_module_default.text,
+					"data-clamp": "",
+					children: summary
+				});
+			}
+			const Display = own ?? builtInDisplays.text;
+			if (Display === void 0) return null;
+			return /* @__PURE__ */ jsx(Display, {
+				value: getColumnValue(item, column, intl.locale),
+				item,
+				column,
+				field: column.field ?? null
+			});
+		};
+		$[7] = allDisplays;
+		$[8] = intl;
+		$[9] = plugins.fields;
+		$[10] = t5;
+	} else t5 = $[10];
+	return t5;
+}
+//#endregion
+export { useRenderValue };
+
+//# sourceMappingURL=useRenderValue.js.map

package/dist/useRenderValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderValue.js","names":["ReactNode","usePlugins","summarizeCompound","isCompoundField","usePanneauIntl","styles","builtInDisplays","DisplayEntry","ListColumn","ListItem","getColumnValue","useRenderValue","t0","$","_c","t1","undefined","displays","intl","plugins","t2","Object","fromEntries","t3","Record","t4","allDisplays","t5","fields","item","column","render","own","display","field","value","locale","summary","get","type","text","Display","_c","styles"],"sources":["../src/useRenderValue.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { usePlugins } from '@panneau/core';\nimport { summarizeCompound } from '@panneau/fields';\nimport { isCompoundField } from '@panneau/protocol/runtime';\nimport { usePanneauIntl } from '@panneau/ui';\n\nimport styles from './displays/Displays.module.css';\nimport { builtInDisplays } from './displays/displays';\nimport type { DisplayEntry, ListColumn, ListItem } from './types';\nimport { getColumnValue } from './values';\n\n/**\n * Renders the value of a column for an item with its display: those given, over those of the\n * plugins, over the built-in ones. A compound field without a display of its own (decision 0065)\n * shows the summaries of its field entry. Other columns without a known display, and compound\n * fields without a summary, show their value as text.\n */\nexport function useRenderValue(\n    displays: Readonly<Record<string, DisplayEntry>> = {},\n): (item: ListItem, column: ListColumn) => ReactNode {\n    const intl = usePanneauIntl();\n    const plugins = usePlugins();\n    const allDisplays: Record<string, DisplayEntry> = {\n        ...builtInDisplays,\n        ...(Object.fromEntries(plugins.displays) as Record<string, DisplayEntry>),\n        ...displays,\n    };\n    return (item, column) => {\n        if (column.render !== undefined) {\n            return column.render(item);\n        }\n        const own =\n            column.display !== undefined && column.display !== null\n                ? allDisplays[column.display]\n                : undefined;\n        const field = column.field ?? null;\n        if (own === undefined && field !== null && isCompoundField(field)) {\n            const value = getColumnValue(item, column, intl.locale);\n            const summary = summarizeCompound(plugins.fields.get(field.type), value, {\n                field,\n                locale: intl.locale,\n            });\n            if (summary !== null) {\n                return (\n                    <span className={styles.text} data-clamp=\"\">\n                        {summary}\n                    </span>\n                );\n            }\n        }\n        const Display = own ?? builtInDisplays.text;\n        if (Display === undefined) {\n            return null;\n        }\n        return (\n            <Display\n                value={getColumnValue(item, column, intl.locale)}\n                item={item}\n                column={column}\n                field={column.field ?? null}\n            />\n        );\n    };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,SAAOW,eAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAD,IAAA;EACHG,KAAAH,OAAAI,KAAAA,IAAA,CAAoD,IAApDJ;EAAqDC,EAAA,KAAAD;EAAAC,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAArD,MAAAI,WAAAF;CAEA,MAAAG,OAAad,eAAe;CAC5B,MAAAe,UAAgBlB,WAAW;CAAE,IAAAmB;CAAA,IAAAP,EAAA,OAAAM,QAAAF,UAAA;EAGrBG,KAAAC,OAAMC,YAAaH,QAAOF,QAAS;EAACJ,EAAA,KAAAM,QAAAF;EAAAJ,EAAA,KAAAO;CAAA,OAAAA,KAAAP,EAAA;CAApC,MAAAU,KAAAH;CAAoE,IAAAK;CAAA,IAAAZ,EAAA,OAAAI,YAAAJ,EAAA,OAAAU,IAAA;EAF1BE,KAAA;GAAA,GAC3CnB;GAAe,GACdiB;GAAoE,GACrEN;EACP;EAACJ,EAAA,KAAAI;EAAAJ,EAAA,KAAAU;EAAAV,EAAA,KAAAY;CAAA,OAAAA,KAAAZ,EAAA;CAJD,MAAAa,cAAkDD;CAIhD,IAAAE;CAAA,IAAAd,EAAA,OAAAa,eAAAb,EAAA,OAAAK,QAAAL,EAAA,OAAAM,QAAAS,QAAA;EACKD,MAAAE,MAAAC,WAAA;GACH,IAAIA,OAAMC,WAAYf,KAAAA,GAAS,OACpBc,OAAMC,OAAQF,IAAI;GAE7B,MAAAG,MACIF,OAAMG,YAAajB,KAAAA,KAAac,OAAMG,YAAa,OAC7CP,YAAYI,OAAMG,WADxBjB,KAAAA;GAGJ,MAAAkB,QAAcJ,OAAMI,SAAN;GACd,IAAIF,QAAQhB,KAAAA,KAAakB,UAAU,QAAQ/B,gBAAgB+B,KAAK,GAAC;IAC7D,MAAAC,QAAczB,eAAemB,MAAMC,QAAQZ,KAAIkB,MAAO;IACtD,MAAAC,UAAgBnC,kBAAkBiB,QAAOS,OAAOU,IAAKJ,MAAKK,IAAK,GAAGJ,OAAO;KAAAD;KAAAE,QAE7DlB,KAAIkB;IAChB,CAAC;IACD,IAAIC,YAAY,MAAI,OAEZ,oBAAA,QAAA;KAAiB,WAAAhC,wBAAMmC;KAAkB,cAAA;KACpCH,UAAAA;IACE,CAAA;GAEd;GAEL,MAAAI,UAAgBT,OAAO1B,gBAAekC;GACtC,IAAIC,YAAYzB,KAAAA,GAAS,OACd;GACV,OAEG,oBAAC,SAAD;IACW,OAAAN,eAAemB,MAAMC,QAAQZ,KAAIkB,MAAO;IACzCP;IACEC;IACD,OAAAA,OAAMI,SAAN;GAAoB,CAAA;EAC7B;EAETrB,EAAA,KAAAa;EAAAb,EAAA,KAAAK;EAAAL,EAAA,KAAAM,QAAAS;EAAAf,EAAA,MAAAc;CAAA,OAAAA,KAAAd,EAAA;CAAA,OAnCMc;AAmCN"}

package/dist/values.d.ts

@@ -1,5 +1,6 @@
 import type { Field, Option } from '@panneau/protocol';
-import type { ListColumn, ListItem } from './types';
+import type { ListColumn, ListItem } from './types.js';
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
 /**
  * The value of a localized field in a locale: the locale (`fr-CA`), its language (`fr`), then the
  * first filled locale. Other values are returned as they are.
@@ -16,6 +17,8 @@ export declare function getColumnValue(item: ListItem, column: ListColumn, local
 export declare function toText(value: unknown, locale: string): string;
 /** The options of a field, or none. */
 export declare function getFieldOptions(field: Field | null | undefined): readonly Option[];
+/** The option of a value, matched as a string (values from the URL are strings). */
+export declare function findOption(options: readonly Option[], value: unknown): Option | undefined;
 /** The label of an option value, matched as a string (values from the URL are strings). */
 export declare function getOptionLabel(options: readonly Option[], value: unknown): string | null;
 //# sourceMappingURL=values.d.ts.map

package/dist/values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMpD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAczE;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuB7D;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAElF;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGxF"}
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAczE;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuB7D;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAElF;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEzF;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAExF"}

package/dist/values.js

@@ -42,11 +42,15 @@ function toText(value, locale) {
 function getFieldOptions(field) {
 	return field?.options ?? [];
 }
+/** The option of a value, matched as a string (values from the URL are strings). */
+function findOption(options, value) {
+	return options.find((candidate) => String(candidate.value) === String(value));
+}
 /** The label of an option value, matched as a string (values from the URL are strings). */
 function getOptionLabel(options, value) {
-	return options.find((candidate) => String(candidate.value) === String(value))?.label ?? null;
+	return findOption(options, value)?.label ?? null;
 }
 //#endregion
-export { getColumnValue, getFieldOptions, getLocalizedValue, getOptionLabel, isLocalized, toText };
+export { findOption, getColumnValue, getFieldOptions, getLocalizedValue, getOptionLabel, isLocalized, isRecord, toText };
 
 //# sourceMappingURL=values.js.map

package/dist/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","names":[],"sources":["../src/values.ts"],"sourcesContent":["import type { Field, Option } from '@panneau/protocol';\n\nimport type { ListColumn, ListItem } from './types';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * The value of a localized field in a locale: the locale (`fr-CA`), its language (`fr`), then the\n * first filled locale. Other values are returned as they are.\n */\nexport function getLocalizedValue(value: unknown, locale: string): unknown {\n    if (!isRecord(value)) {\n        return value;\n    }\n    const language = locale.split('-')[0] ?? locale;\n    const filled = (candidate: unknown) =>\n        candidate !== undefined && candidate !== null && candidate !== '';\n    if (filled(value[locale])) {\n        return value[locale];\n    }\n    if (filled(value[language])) {\n        return value[language];\n    }\n    return Object.values(value).find(filled) ?? null;\n}\n\n/** Whether a field's values are keyed by locale. */\nexport function isLocalized(field: Field | null | undefined): boolean {\n    return field?.localized === true;\n}\n\n/** The value of a column for an item: `item[id]`, in the locale for a localized field. */\nexport function getColumnValue(item: ListItem, column: ListColumn, locale: string): unknown {\n    const value = item[column.field?.name ?? column.id];\n    return isLocalized(column.field) ? getLocalizedValue(value, locale) : value;\n}\n\n/**\n * A value as plain text: strings and numbers as they are, references by their label, localized\n * values in the locale, lists joined with commas. For labels of items and for search.\n */\nexport function toText(value: unknown, locale: string): string {\n    if (value === null || value === undefined) {\n        return '';\n    }\n    if (typeof value === 'string') {\n        return value;\n    }\n    if (typeof value === 'number' || typeof value === 'boolean') {\n        return String(value);\n    }\n    if (Array.isArray(value)) {\n        return value\n            .map((entry) => toText(entry, locale))\n            .filter((text) => text !== '')\n            .join(', ');\n    }\n    if (isRecord(value)) {\n        if (typeof value.label === 'string') {\n            return value.label;\n        }\n        return toText(getLocalizedValue(value, locale), locale);\n    }\n    return '';\n}\n\n/** The options of a field, or none. */\nexport function getFieldOptions(field: Field | null | undefined): readonly Option[] {\n    return field?.options ?? [];\n}\n\n/** The label of an option value, matched as a string (values from the URL are strings). */\nexport function getOptionLabel(options: readonly Option[], value: unknown): string | null {\n    const option = options.find((candidate) => String(candidate.value) === String(value));\n    return option?.label ?? null;\n}\n"],"mappings":";AAIA,SAAS,SAAS,OAAkD;CAChE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC9E;;;;;AAMA,SAAgB,kBAAkB,OAAgB,QAAyB;CACvE,IAAI,CAAC,SAAS,KAAK,GACf,OAAO;CAEX,MAAM,WAAW,OAAO,MAAM,GAAG,CAAC,CAAC,MAAM;CACzC,MAAM,UAAU,cACZ,cAAc,KAAA,KAAa,cAAc,QAAQ,cAAc;CACnE,IAAI,OAAO,MAAM,OAAO,GACpB,OAAO,MAAM;CAEjB,IAAI,OAAO,MAAM,SAAS,GACtB,OAAO,MAAM;CAEjB,OAAO,OAAO,OAAO,KAAK,CAAC,CAAC,KAAK,MAAM,KAAK;AAChD;;AAGA,SAAgB,YAAY,OAA0C;CAClE,OAAO,OAAO,cAAc;AAChC;;AAGA,SAAgB,eAAe,MAAgB,QAAoB,QAAyB;CACxF,MAAM,QAAQ,KAAK,OAAO,OAAO,QAAQ,OAAO;CAChD,OAAO,YAAY,OAAO,KAAK,IAAI,kBAAkB,OAAO,MAAM,IAAI;AAC1E;;;;;AAMA,SAAgB,OAAO,OAAgB,QAAwB;CAC3D,IAAI,UAAU,QAAQ,UAAU,KAAA,GAC5B,OAAO;CAEX,IAAI,OAAO,UAAU,UACjB,OAAO;CAEX,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,WAC9C,OAAO,OAAO,KAAK;CAEvB,IAAI,MAAM,QAAQ,KAAK,GACnB,OAAO,MACF,KAAK,UAAU,OAAO,OAAO,MAAM,CAAC,CAAC,CACrC,QAAQ,SAAS,SAAS,EAAE,CAAC,CAC7B,KAAK,IAAI;CAElB,IAAI,SAAS,KAAK,GAAG;EACjB,IAAI,OAAO,MAAM,UAAU,UACvB,OAAO,MAAM;EAEjB,OAAO,OAAO,kBAAkB,OAAO,MAAM,GAAG,MAAM;CAC1D;CACA,OAAO;AACX;;AAGA,SAAgB,gBAAgB,OAAoD;CAChF,OAAO,OAAO,WAAW,CAAA;AAC7B;;AAGA,SAAgB,eAAe,SAA4B,OAA+B;CAEtF,OADe,QAAQ,MAAM,cAAc,OAAO,UAAU,KAAK,MAAM,OAAO,KAAK,CAC5E,CAAA,EAAQ,SAAS;AAC5B"}
+{"version":3,"file":"values.js","names":["Field","Option","ListColumn","ListItem","isRecord","value","Record","Array","isArray","getLocalizedValue","locale","language","split","filled","candidate","undefined","Object","values","find","isLocalized","field","localized","getColumnValue","item","column","name","id","toText","String","map","entry","filter","text","join","label","getFieldOptions","options","findOption","getOptionLabel"],"sources":["../src/values.ts"],"sourcesContent":["import type { Field, Option } from '@panneau/protocol';\n\nimport type { ListColumn, ListItem } from './types';\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * The value of a localized field in a locale: the locale (`fr-CA`), its language (`fr`), then the\n * first filled locale. Other values are returned as they are.\n */\nexport function getLocalizedValue(value: unknown, locale: string): unknown {\n    if (!isRecord(value)) {\n        return value;\n    }\n    const language = locale.split('-')[0] ?? locale;\n    const filled = (candidate: unknown) =>\n        candidate !== undefined && candidate !== null && candidate !== '';\n    if (filled(value[locale])) {\n        return value[locale];\n    }\n    if (filled(value[language])) {\n        return value[language];\n    }\n    return Object.values(value).find(filled) ?? null;\n}\n\n/** Whether a field's values are keyed by locale. */\nexport function isLocalized(field: Field | null | undefined): boolean {\n    return field?.localized === true;\n}\n\n/** The value of a column for an item: `item[id]`, in the locale for a localized field. */\nexport function getColumnValue(item: ListItem, column: ListColumn, locale: string): unknown {\n    const value = item[column.field?.name ?? column.id];\n    return isLocalized(column.field) ? getLocalizedValue(value, locale) : value;\n}\n\n/**\n * A value as plain text: strings and numbers as they are, references by their label, localized\n * values in the locale, lists joined with commas. For labels of items and for search.\n */\nexport function toText(value: unknown, locale: string): string {\n    if (value === null || value === undefined) {\n        return '';\n    }\n    if (typeof value === 'string') {\n        return value;\n    }\n    if (typeof value === 'number' || typeof value === 'boolean') {\n        return String(value);\n    }\n    if (Array.isArray(value)) {\n        return value\n            .map((entry) => toText(entry, locale))\n            .filter((text) => text !== '')\n            .join(', ');\n    }\n    if (isRecord(value)) {\n        if (typeof value.label === 'string') {\n            return value.label;\n        }\n        return toText(getLocalizedValue(value, locale), locale);\n    }\n    return '';\n}\n\n/** The options of a field, or none. */\nexport function getFieldOptions(field: Field | null | undefined): readonly Option[] {\n    return field?.options ?? [];\n}\n\n/** The option of a value, matched as a string (values from the URL are strings). */\nexport function findOption(options: readonly Option[], value: unknown): Option | undefined {\n    return options.find((candidate) => String(candidate.value) === String(value));\n}\n\n/** The label of an option value, matched as a string (values from the URL are strings). */\nexport function getOptionLabel(options: readonly Option[], value: unknown): string | null {\n    return findOption(options, value)?.label ?? null;\n}\n"],"mappings":";AAIA,SAAgBI,SAASC,OAAkD;CACvE,OAAOA,UAAU,QAAQ,OAAOA,UAAU,YAAY,CAACE,MAAMC,QAAQH,KAAK;AAC9E;;;;;AAMA,SAAgBI,kBAAkBJ,OAAgBK,QAAyB;CACvE,IAAI,CAACN,SAASC,KAAK,GACf,OAAOA;CAEX,MAAMM,WAAWD,OAAOE,MAAM,GAAG,CAAC,CAAC,MAAMF;CACzC,MAAMG,UAAUC,cACZA,cAAcC,KAAAA,KAAaD,cAAc,QAAQA,cAAc;CACnE,IAAID,OAAOR,MAAMK,OAAO,GACpB,OAAOL,MAAMK;CAEjB,IAAIG,OAAOR,MAAMM,SAAS,GACtB,OAAON,MAAMM;CAEjB,OAAOK,OAAOC,OAAOZ,KAAK,CAAC,CAACa,KAAKL,MAAM,KAAK;AAChD;;AAGA,SAAgBM,YAAYC,OAA0C;CAClE,OAAOA,OAAOC,cAAc;AAChC;;AAGA,SAAgBC,eAAeC,MAAgBC,QAAoBd,QAAyB;CACxF,MAAML,QAAQkB,KAAKC,OAAOJ,OAAOK,QAAQD,OAAOE;CAChD,OAAOP,YAAYK,OAAOJ,KAAK,IAAIX,kBAAkBJ,OAAOK,MAAM,IAAIL;AAC1E;;;;;AAMA,SAAgBsB,OAAOtB,OAAgBK,QAAwB;CAC3D,IAAIL,UAAU,QAAQA,UAAUU,KAAAA,GAC5B,OAAO;CAEX,IAAI,OAAOV,UAAU,UACjB,OAAOA;CAEX,IAAI,OAAOA,UAAU,YAAY,OAAOA,UAAU,WAC9C,OAAOuB,OAAOvB,KAAK;CAEvB,IAAIE,MAAMC,QAAQH,KAAK,GACnB,OAAOA,MACFwB,KAAKC,UAAUH,OAAOG,OAAOpB,MAAM,CAAC,CAAC,CACrCqB,QAAQC,SAASA,SAAS,EAAE,CAAC,CAC7BC,KAAK,IAAI;CAElB,IAAI7B,SAASC,KAAK,GAAG;EACjB,IAAI,OAAOA,MAAM6B,UAAU,UACvB,OAAO7B,MAAM6B;EAEjB,OAAOP,OAAOlB,kBAAkBJ,OAAOK,MAAM,GAAGA,MAAM;CAC1D;CACA,OAAO;AACX;;AAGA,SAAgByB,gBAAgBf,OAAoD;CAChF,OAAOA,OAAOgB,WAAW,CAAA;AAC7B;;AAGA,SAAgBC,WAAWD,SAA4B/B,OAAoC;CACvF,OAAO+B,QAAQlB,MAAMJ,cAAcc,OAAOd,UAAUT,KAAK,MAAMuB,OAAOvB,KAAK,CAAC;AAChF;;AAGA,SAAgBiC,eAAeF,SAA4B/B,OAA+B;CACtF,OAAOgC,WAAWD,SAAS/B,KAAK,CAAC,EAAE6B,SAAS;AAChD"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@panneau/lists",
-    "version": "5.0.0-alpha.2",
+    "version": "5.0.0-alpha.21",
     "description": "Lists of Panneau: columns with displays, table and cards layouts, sorting, filters, search, pagination, selection and actions, driven by the list state of @panneau/core.",
     "type": "module",
     "license": "MIT",
@@ -24,9 +24,9 @@
         "dist"
     ],
     "scripts": {
-        "build": "vite build && tsc -p tsconfig.build.json",
+        "build": "vite build && node ../../scripts/declarations.js",
         "typecheck": "tsc --noEmit",
-        "api": "tsc -p tsconfig.build.json && node ../../scripts/api-report.js"
+        "api": "node ../../scripts/declarations.js && node ../../scripts/api-report.js"
     },
     "publishConfig": {
         "access": "public"
@@ -37,14 +37,14 @@
         "react-intl": "^12.0.0"
     },
     "dependencies": {
-        "@panneau/core": "5.0.0-alpha.2",
-        "@panneau/fields": "5.0.0-alpha.2",
-        "@panneau/intl": "5.0.0-alpha.2",
-        "@panneau/protocol": "5.0.0-alpha.2",
-        "@panneau/ui": "5.0.0-alpha.2",
+        "@panneau/core": "5.0.0-alpha.21",
+        "@panneau/fields": "5.0.0-alpha.21",
+        "@panneau/intl": "5.0.0-alpha.21",
+        "@panneau/protocol": "5.0.0-alpha.21",
+        "@panneau/ui": "5.0.0-alpha.21",
         "lucide-react": "^1.57.0"
     },
     "devDependencies": {
-        "@panneau/data": "5.0.0-alpha.2"
+        "@panneau/data": "5.0.0-alpha.21"
     }
 }