@panneau/fields 4.1.1 → 5.0.0-alpha.1

package/dist/shared/DefinitionField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefinitionField.js","names":["field","path","value","_c"],"sources":["../../src/shared/DefinitionField.tsx"],"sourcesContent":["import type { Field } from '@panneau/protocol';\nimport { evaluateCondition } from '@panneau/protocol/runtime';\n\n// Groups, repeaters and localized values render nested fields, which render through\n// `DefinitionField`: the modules import each other, which is fine since they only use each other\n// while rendering.\nimport { LocalizedFieldEntry } from '../localized/LocalizedField';\nimport { MissingFieldEntry } from '../missing/MissingField';\nimport { builtInFields } from './builtIn';\nimport { getParentPath, useFieldsContext } from './context';\nimport type { FieldEntryProps } from './types';\n\nexport interface NestedFieldProps {\n    field: Field;\n    /** Dot path of the field's value. */\n    path: string;\n    /** The value, without a binding. */\n    value?: unknown;\n    /** Sets the value, without a binding. */\n    onChange?: (value: unknown) => void;\n    onBlur?: () => void;\n    errors?: readonly string[];\n    /** The object the field belongs to, for conditions and generated values. */\n    parentValue?: unknown;\n    disabled?: boolean;\n    readOnly?: boolean;\n    className?: string;\n}\n\n/**\n * A field inside another one (a group, a block, a localized value), or at the top of a form.\n * With a binding in context, the binding gives its value and decides whether it shows. Without\n * one, it uses `value` and `onChange`, and hides itself when its `visibleWhen` condition on the\n * parent value is false.\n */\nexport function NestedField({\n    field,\n    path,\n    value,\n    onChange,\n    onBlur,\n    errors,\n    parentValue,\n    disabled,\n    readOnly,\n    className,\n}: NestedFieldProps) {\n    const { binding: Binding } = useFieldsContext();\n    const shared = {\n        field,\n        path,\n        parentValue,\n        ...(disabled !== undefined ? { disabled } : {}),\n        ...(readOnly !== undefined ? { readOnly } : {}),\n        ...(className !== undefined ? { className } : {}),\n    };\n    if (Binding !== null) {\n        return (\n            <Binding\n                field={field}\n                path={path}\n                parentPath={getParentPath(path)}\n                render={(bound) => <DefinitionField {...shared} {...bound} />}\n            />\n        );\n    }\n    if (field.visibleWhen !== undefined && !evaluateCondition(field.visibleWhen, parentValue)) {\n        return null;\n    }\n    return (\n        <DefinitionField\n            {...shared}\n            value={value}\n            onChange={onChange ?? (() => undefined)}\n            {...(onBlur !== undefined ? { onBlur } : {})}\n            {...(errors !== undefined ? { errors } : {})}\n        />\n    );\n}\n\n/**\n * Renders a field of the definition with the entry of its type: from the fields context, or a\n * built-in one. A localized field renders an input per locale. A type without an entry renders a\n * placeholder that names the missing plugin.\n */\nexport function DefinitionField(props: FieldEntryProps) {\n    const { components } = useFieldsContext();\n    const { field } = props;\n    if (field.localized === true) {\n        return <LocalizedFieldEntry {...props} />;\n    }\n    const Entry = components[field.type] ?? builtInFields[field.type] ?? MissingFieldEntry;\n    return <Entry {...props} />;\n}\n"],"mappings":";;;;;;;;;;;;;;AAmCA,SAAO,YAAA,IAAA;CAAA,MAAA,IAAAG,EAAA,EAAA;CAAqB,MAAA,EAAA,OAAA,MAAA,OAAA,UAAA,QAAA,QAAA,aAAA,UAAA,UAAA,cAAA;CAYxB,MAAA,EAAA,SAAA,YAA6B,iBAAiB;CAAE,IAAA;CAAA,IAAA,EAAA,OAAA,UAAA;EAKxC,KAAA,aAAa,KAAA,IAAb,EAAA,SAAyC,IAAzC,CAAyC;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,OAAA,UAAA;EAC1C,KAAA,aAAa,KAAA,IAAb,EAAA,SAAyC,IAAzC,CAAyC;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,OAAA,WAAA;EAC1C,KAAA,cAAc,KAAA,IAAd,EAAA,UAA2C,IAA3C,CAA2C;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,OAAA,SAAA,EAAA,OAAA,eAAA,EAAA,OAAA,QAAA,EAAA,OAAA,MAAA,EAAA,QAAA,MAAA,EAAA,QAAA,IAAA;EANrC,KAAA;GAAA;GAAA;GAAA;GAAA,GAIP;GAA0C,GAC1C;GAA0C,GAC1C;EACR;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAPD,MAAA,SAAe;CAQf,IAAI,YAAY,MAAI;EAAA,IAAA;EAAA,IAAA,EAAA,QAAA,MAAA;GAKI,KAAA,cAAc,IAAI;GAAC,EAAA,MAAA;GAAA,EAAA,MAAA;EAAA,OAAA,KAAA,EAAA;EAAA,IAAA;EAAA,IAAA,EAAA,QAAA,QAAA;GACvB,MAAA,UAAW,oBAAC,iBAAD;IAAgB,GAAK;IAAM,GAAM;GAAK,CAAA;GAAI,EAAA,MAAA;GAAA,EAAA,MAAA;EAAA,OAAA,KAAA,EAAA;EAAA,IAAA;EAAA,IAAA,EAAA,QAAA,WAAA,EAAA,QAAA,SAAA,EAAA,QAAA,QAAA,EAAA,QAAA,MAAA,EAAA,QAAA,IAAA;GAJjE,KAAA,oBAAC,SAAD;IACW;IACD;IACM,YAAA;IACJ,QAAA;GAAqD,CAAA;GAC/D,EAAA,MAAA;GAAA,EAAA,MAAA;GAAA,EAAA,MAAA;GAAA,EAAA,MAAA;GAAA,EAAA,MAAA;GAAA,EAAA,MAAA;EAAA,OAAA,KAAA,EAAA;EAAA,OALF;CAKE;CAGV,IAAI,MAAK,gBAAiB,KAAA,KAAtB,CAAoC,kBAAkB,MAAK,aAAc,WAAW,GAAC,OAC9E;CAMO,MAAA,KAAA,YAAA;CAA6B,IAAA;CAAA,IAAA,EAAA,QAAA,QAAA;EAClC,KAAA,WAAW,KAAA,IAAX,EAAA,OAAqC,IAArC,CAAqC;EAAC,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,QAAA,QAAA;EACtC,KAAA,WAAW,KAAA,IAAX,EAAA,OAAqC,IAArC,CAAqC;EAAC,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,IAAA;CAAA,IAAA,EAAA,QAAA,UAAA,EAAA,QAAA,MAAA,EAAA,QAAA,MAAA,EAAA,QAAA,MAAA,EAAA,QAAA,OAAA;EAL/C,KAAA,oBAAC,iBAAD;GAAgB,GACR;GACG;GACG,UAAA;GAA6B,GAClC;GAAsC,GACtC;EAAsC,CAAA;EAC7C,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,OANF;AAME;;;;;;AAzCH,SAAA,QAAA,CAAA;AAkDP,SAAO,gBAAA,OAAA;CAAA,MAAA,IAAAA,EAAA,CAAA;CACH,MAAA,EAAA,eAAuB,iBAAiB;CACxC,MAAA,EAAA,UAAkB;CAClB,IAAI,MAAK,cAAe,MAAI;EAAA,IAAA;EAAA,IAAA,EAAA,OAAA,OAAA;GACjB,KAAA,oBAAC,qBAAD,EAAoB,GAAK,MAAK,CAAA;GAAI,EAAA,KAAA;GAAA,EAAA,KAAA;EAAA,OAAA,KAAA,EAAA;EAAA,OAAlC;CAAkC;CAE7C,MAAA,QAAc,WAAW,MAAK,SAAU,cAAc,MAAK,SAA7C;CAAyE,IAAA;CAAA,IAAA,EAAA,OAAA,SAAA,EAAA,OAAA,OAAA;EAChF,KAAA,oBAAC,OAAD,EAAM,GAAK,MAAK,CAAA;EAAI,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAAA,OAApB;AAAoB"}

package/dist/shared/builtIn.d.ts

@@ -0,0 +1,17 @@
+import type { FieldEntry } from './types';
+/**
+ * The entries of the built-in field types. `richtext` and `media` come with their plugins (Phase
+ * 2): until then, `DefinitionField` renders a placeholder for them.
+ */
+export declare const builtInFields: Readonly<Record<string, FieldEntry>>;
+/**
+ * The built-in fields as a `@panneau/core` plugin: their entries, and the French messages of
+ * every Panneau package (`@panneau/ui`, `@panneau/fields`, `@panneau/forms`…, from
+ * `@panneau/intl`). Pass it before the plugins that override a type.
+ */
+export declare const fieldsPlugin: {
+    id: string;
+    fields: Readonly<Record<string, FieldEntry>>;
+    locales: Readonly<Record<string, Record<string, string>>>;
+};
+//# sourceMappingURL=builtIn.d.ts.map

package/dist/shared/builtIn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtIn.d.ts","sourceRoot":"","sources":["../../src/shared/builtIn.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAgB9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAK7D,CAAC"}

package/dist/shared/builtIn.js

@@ -0,0 +1,52 @@
+import { BooleanFieldEntry } from "../boolean/BooleanField.js";
+import { TextFieldEntry } from "../text/TextField.js";
+import { ColorFieldEntry } from "../color/ColorField.js";
+import { DateFieldEntry } from "../date/DateField.js";
+import { DateTimeFieldEntry } from "../datetime/DateTimeField.js";
+import { EmailFieldEntry } from "../email/EmailField.js";
+import { GroupFieldEntry } from "../group/GroupField.js";
+import { NumberFieldEntry } from "../number/NumberField.js";
+import { RelationFieldEntry } from "../relation/RelationField.js";
+import { RepeaterFieldEntry } from "../repeater/RepeaterField.js";
+import { SelectFieldEntry } from "../select/SelectField.js";
+import { SlugFieldEntry } from "../slug/SlugField.js";
+import { TextAreaFieldEntry } from "../textarea/TextAreaField.js";
+import { TimeFieldEntry } from "../time/TimeField.js";
+import { UrlFieldEntry } from "../url/UrlField.js";
+import { fr } from "@panneau/intl";
+//#region src/shared/builtIn.ts
+/**
+* The entries of the built-in field types. `richtext` and `media` come with their plugins (Phase
+* 2): until then, `DefinitionField` renders a placeholder for them.
+*/
+var builtInFields = {
+	text: TextFieldEntry,
+	textarea: TextAreaFieldEntry,
+	number: NumberFieldEntry,
+	boolean: BooleanFieldEntry,
+	date: DateFieldEntry,
+	datetime: DateTimeFieldEntry,
+	time: TimeFieldEntry,
+	select: SelectFieldEntry,
+	email: EmailFieldEntry,
+	url: UrlFieldEntry,
+	color: ColorFieldEntry,
+	slug: SlugFieldEntry,
+	relation: RelationFieldEntry,
+	group: GroupFieldEntry,
+	repeater: RepeaterFieldEntry
+};
+/**
+* The built-in fields as a `@panneau/core` plugin: their entries, and the French messages of
+* every Panneau package (`@panneau/ui`, `@panneau/fields`, `@panneau/forms`…, from
+* `@panneau/intl`). Pass it before the plugins that override a type.
+*/
+var fieldsPlugin = {
+	id: "panneau-fields",
+	fields: builtInFields,
+	locales: { fr }
+};
+//#endregion
+export { builtInFields, fieldsPlugin };
+
+//# sourceMappingURL=builtIn.js.map

package/dist/shared/builtIn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtIn.js","names":[],"sources":["../../src/shared/builtIn.ts"],"sourcesContent":["import { fr } from '@panneau/intl';\n\nimport { BooleanFieldEntry } from '../boolean/BooleanField';\nimport { ColorFieldEntry } from '../color/ColorField';\nimport { DateFieldEntry } from '../date/DateField';\nimport { DateTimeFieldEntry } from '../datetime/DateTimeField';\nimport { EmailFieldEntry } from '../email/EmailField';\nimport { GroupFieldEntry } from '../group/GroupField';\nimport { NumberFieldEntry } from '../number/NumberField';\nimport { RelationFieldEntry } from '../relation/RelationField';\nimport { RepeaterFieldEntry } from '../repeater/RepeaterField';\nimport { SelectFieldEntry } from '../select/SelectField';\nimport { SlugFieldEntry } from '../slug/SlugField';\nimport { TextFieldEntry } from '../text/TextField';\nimport { TextAreaFieldEntry } from '../textarea/TextAreaField';\nimport { TimeFieldEntry } from '../time/TimeField';\nimport { UrlFieldEntry } from '../url/UrlField';\nimport type { FieldEntry } from './types';\n\n/**\n * The entries of the built-in field types. `richtext` and `media` come with their plugins (Phase\n * 2): until then, `DefinitionField` renders a placeholder for them.\n */\nexport const builtInFields: Readonly<Record<string, FieldEntry>> = {\n    text: TextFieldEntry,\n    textarea: TextAreaFieldEntry,\n    number: NumberFieldEntry,\n    boolean: BooleanFieldEntry,\n    date: DateFieldEntry,\n    datetime: DateTimeFieldEntry,\n    time: TimeFieldEntry,\n    select: SelectFieldEntry,\n    email: EmailFieldEntry,\n    url: UrlFieldEntry,\n    color: ColorFieldEntry,\n    slug: SlugFieldEntry,\n    relation: RelationFieldEntry,\n    group: GroupFieldEntry,\n    repeater: RepeaterFieldEntry,\n};\n\n/**\n * The built-in fields as a `@panneau/core` plugin: their entries, and the French messages of\n * every Panneau package (`@panneau/ui`, `@panneau/fields`, `@panneau/forms`…, from\n * `@panneau/intl`). Pass it before the plugins that override a type.\n */\nexport const fieldsPlugin: {\n    id: string;\n    fields: Readonly<Record<string, FieldEntry>>;\n    locales: Readonly<Record<string, Record<string, string>>>;\n} = {\n    id: 'panneau-fields',\n    fields: builtInFields,\n    locales: { fr },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,gBAAsD;CAC/D,MAAM;CACN,UAAU;CACV,QAAQ;CACR,SAAS;CACT,MAAM;CACN,UAAU;CACV,MAAM;CACN,QAAQ;CACR,OAAO;CACP,KAAK;CACL,OAAO;CACP,MAAM;CACN,UAAU;CACV,OAAO;CACP,UAAU;AACd;;;;;;AAOA,IAAa,eAIT;CACA,IAAI;CACJ,QAAQ;CACR,SAAS,EAAE,GAAG;AAClB"}

package/dist/shared/context.d.ts

@@ -0,0 +1,55 @@
+import { type ComponentType, type ReactNode } from 'react';
+import type { Field } from '@panneau/protocol';
+import type { RelationSource } from './relation';
+import type { FieldEntry } from './types';
+/** What a binding gives a field: its value, handlers and errors at a path. */
+export interface BoundFieldProps {
+    value: unknown;
+    onChange: (value: unknown) => void;
+    onBlur?: () => void;
+    errors?: readonly string[];
+}
+/** Props of a binding: it decides whether a field shows, and where its value comes from. */
+export interface FieldBindingProps {
+    field: Field;
+    /** Dot path of the field's value. */
+    path: string;
+    /** Dot path of the object the field belongs to: `''` at the top, `blocks.2` in a block. */
+    parentPath: string;
+    /** Renders the field with its bound value. */
+    render: (bound: BoundFieldProps) => ReactNode;
+}
+/**
+ * Binds nested fields (in groups, blocks and localized values) to a store by path, instead of the
+ * value and `onChange` of their parent. `@panneau/forms` binds them to its form state, so that
+ * every value is set, validated and shown in error by its own path.
+ */
+export type FieldBinding = ComponentType<FieldBindingProps>;
+export interface FieldsContextValue {
+    /** Registry entries, by field type, over the built-in ones. */
+    components: Readonly<Record<string, FieldEntry>>;
+    /** Locales of localized values, in order. */
+    locales: readonly string[];
+    /** Where relation fields search for items. */
+    relationSource: RelationSource | null;
+    binding: FieldBinding | null;
+}
+/** The fields context of the closest `FieldsProvider`. */
+export declare function useFieldsContext(): FieldsContextValue;
+export interface FieldsProviderProps {
+    /** Registry entries by type, added over those of a parent provider. */
+    components?: Readonly<Record<string, FieldEntry>>;
+    locales?: readonly string[];
+    relationSource?: RelationSource | null;
+    binding?: FieldBinding | null;
+    children?: ReactNode;
+}
+/**
+ * Provides what fields rendered from a definition need: the components of each type, the locales
+ * of localized values, a relation source and a binding. Values not given come from the parent
+ * provider.
+ */
+export declare function FieldsProvider({ components, locales, relationSource, binding, children, }: FieldsProviderProps): import("react").JSX.Element;
+/** The parent path of a path: `blocks.2` for `blocks.2.title`, `''` for `title`. */
+export declare function getParentPath(path: string): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/shared/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/shared/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAC;AAE/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC;CACjD;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IAC/B,+DAA+D;IAC/D,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACjD,6CAA6C;IAC7C,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAChC;AASD,0DAA0D;AAC1D,wBAAgB,gBAAgB,IAAI,kBAAkB,CAErD;AAED,MAAM,WAAW,mBAAmB;IAChC,uEAAuE;IACvE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC3B,UAAU,EACV,OAAO,EACP,cAAc,EACd,OAAO,EACP,QAAQ,GACX,EAAE,mBAAmB,+BAUrB;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/shared/context.js

@@ -0,0 +1,72 @@
+import { c } from "react/compiler-runtime";
+import { createContext, use } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/shared/context.tsx
+var FieldsContext = createContext({
+	components: {},
+	locales: [],
+	relationSource: null,
+	binding: null
+});
+/** The fields context of the closest `FieldsProvider`. */
+function useFieldsContext() {
+	return use(FieldsContext);
+}
+/**
+* Provides what fields rendered from a definition need: the components of each type, the locales
+* of localized values, a relation source and a binding. Values not given come from the parent
+* provider.
+*/
+function FieldsProvider(t0) {
+	const $ = c(11);
+	const { components, locales, relationSource, binding, children } = t0;
+	const parent = use(FieldsContext);
+	let t1;
+	if ($[0] !== components || $[1] !== parent.components) {
+		t1 = components !== void 0 ? {
+			...parent.components,
+			...components
+		} : parent.components;
+		$[0] = components;
+		$[1] = parent.components;
+		$[2] = t1;
+	} else t1 = $[2];
+	const t2 = locales ?? parent.locales;
+	const t3 = relationSource === void 0 ? parent.relationSource : relationSource;
+	const t4 = binding === void 0 ? parent.binding : binding;
+	let t5;
+	if ($[3] !== t1 || $[4] !== t2 || $[5] !== t3 || $[6] !== t4) {
+		t5 = {
+			components: t1,
+			locales: t2,
+			relationSource: t3,
+			binding: t4
+		};
+		$[3] = t1;
+		$[4] = t2;
+		$[5] = t3;
+		$[6] = t4;
+		$[7] = t5;
+	} else t5 = $[7];
+	const value = t5;
+	let t6;
+	if ($[8] !== children || $[9] !== value) {
+		t6 = /* @__PURE__ */ jsx(FieldsContext, {
+			value,
+			children
+		});
+		$[8] = children;
+		$[9] = value;
+		$[10] = t6;
+	} else t6 = $[10];
+	return t6;
+}
+/** The parent path of a path: `blocks.2` for `blocks.2.title`, `''` for `title`. */
+function getParentPath(path) {
+	const index = path.lastIndexOf(".");
+	return index === -1 ? "" : path.slice(0, index);
+}
+//#endregion
+export { FieldsProvider, getParentPath, useFieldsContext };
+
+//# sourceMappingURL=context.js.map

package/dist/shared/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":["value","children","_c"],"sources":["../../src/shared/context.tsx"],"sourcesContent":["import { type ComponentType, type ReactNode, createContext, use } from 'react';\n\nimport type { Field } from '@panneau/protocol';\n\nimport type { RelationSource } from './relation';\nimport type { FieldEntry } from './types';\n\n/** What a binding gives a field: its value, handlers and errors at a path. */\nexport interface BoundFieldProps {\n    value: unknown;\n    onChange: (value: unknown) => void;\n    onBlur?: () => void;\n    errors?: readonly string[];\n}\n\n/** Props of a binding: it decides whether a field shows, and where its value comes from. */\nexport interface FieldBindingProps {\n    field: Field;\n    /** Dot path of the field's value. */\n    path: string;\n    /** Dot path of the object the field belongs to: `''` at the top, `blocks.2` in a block. */\n    parentPath: string;\n    /** Renders the field with its bound value. */\n    render: (bound: BoundFieldProps) => ReactNode;\n}\n\n/**\n * Binds nested fields (in groups, blocks and localized values) to a store by path, instead of the\n * value and `onChange` of their parent. `@panneau/forms` binds them to its form state, so that\n * every value is set, validated and shown in error by its own path.\n */\nexport type FieldBinding = ComponentType<FieldBindingProps>;\n\nexport interface FieldsContextValue {\n    /** Registry entries, by field type, over the built-in ones. */\n    components: Readonly<Record<string, FieldEntry>>;\n    /** Locales of localized values, in order. */\n    locales: readonly string[];\n    /** Where relation fields search for items. */\n    relationSource: RelationSource | null;\n    binding: FieldBinding | null;\n}\n\nconst FieldsContext = createContext<FieldsContextValue>({\n    components: {},\n    locales: [],\n    relationSource: null,\n    binding: null,\n});\n\n/** The fields context of the closest `FieldsProvider`. */\nexport function useFieldsContext(): FieldsContextValue {\n    return use(FieldsContext);\n}\n\nexport interface FieldsProviderProps {\n    /** Registry entries by type, added over those of a parent provider. */\n    components?: Readonly<Record<string, FieldEntry>>;\n    locales?: readonly string[];\n    relationSource?: RelationSource | null;\n    binding?: FieldBinding | null;\n    children?: ReactNode;\n}\n\n/**\n * Provides what fields rendered from a definition need: the components of each type, the locales\n * of localized values, a relation source and a binding. Values not given come from the parent\n * provider.\n */\nexport function FieldsProvider({\n    components,\n    locales,\n    relationSource,\n    binding,\n    children,\n}: FieldsProviderProps) {\n    const parent = use(FieldsContext);\n    const value: FieldsContextValue = {\n        components:\n            components !== undefined ? { ...parent.components, ...components } : parent.components,\n        locales: locales ?? parent.locales,\n        relationSource: relationSource === undefined ? parent.relationSource : relationSource,\n        binding: binding === undefined ? parent.binding : binding,\n    };\n    return <FieldsContext value={value}>{children}</FieldsContext>;\n}\n\n/** The parent path of a path: `blocks.2` for `blocks.2.title`, `''` for `title`. */\nexport function getParentPath(path: string): string {\n    const index = path.lastIndexOf('.');\n    return index === -1 ? '' : path.slice(0, index);\n}\n"],"mappings":";;;;AA2CA,IAAM,gBAAgB,cAAkC;CACpD,YAAY,CAAC;CACb,SAAS,CAAA;CACT,gBAAgB;CAChB,SAAS;AACb,CAAC;;AAGD,SAAgB,mBAAuC;CACnD,OAAO,IAAI,aAAa;AAC5B;;;;;;AAgBA,SAAO,eAAA,IAAA;CAAA,MAAA,IAAAE,EAAA,EAAA;CAAwB,MAAA,EAAA,YAAA,SAAA,gBAAA,SAAA,aAAA;CAO3B,MAAA,SAAe,IAAI,aAAa;CAAE,IAAA;CAAA,IAAA,EAAA,OAAA,cAAA,EAAA,OAAA,OAAA,YAAA;EAG1B,KAAA,eAAe,KAAA,IAAf;GAAA,GAAgC,OAAM;GAAW,GAAK;EAA+B,IAAhB,OAAM;EAAW,EAAA,KAAA;EAAA,EAAA,KAAA,OAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CACjF,MAAA,KAAA,WAAW,OAAM;CACV,MAAA,KAAA,mBAAmB,KAAA,IAAY,OAAM,iBAArC;CACP,MAAA,KAAA,YAAY,KAAA,IAAY,OAAM,UAA9B;CAAgD,IAAA;CAAA,IAAA,EAAA,OAAA,MAAA,EAAA,OAAA,MAAA,EAAA,OAAA,MAAA,EAAA,OAAA,IAAA;EAL3B,KAAA;GAAA,YAE1B;GAAsF,SACjF;GAAyB,gBAClB;GAAqE,SAC5E;EACb;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAND,MAAA,QAAkC;CAMhC,IAAA;CAAA,IAAA,EAAA,OAAA,YAAA,EAAA,OAAA,OAAA;EACK,KAAA,oBAAC,eAAD;GAAsB;GAAQ;EAAhB,CAAA;EAAyC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,OAAvD;AAAuD;;AAIlE,SAAgB,cAAc,MAAsB;CAChD,MAAM,QAAQ,KAAK,YAAY,GAAG;CAClC,OAAO,UAAU,KAAK,KAAK,KAAK,MAAM,GAAG,KAAK;AAClD"}

package/dist/shared/cx.d.ts

@@ -0,0 +1,3 @@
+/** Joins class names, skipping empty ones. */
+export declare function cx(...classNames: (string | false | null | undefined)[]): string;
+//# sourceMappingURL=cx.d.ts.map

package/dist/shared/cx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cx.d.ts","sourceRoot":"","sources":["../../src/shared/cx.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,wBAAgB,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAE/E"}

package/dist/shared/cx.js

@@ -0,0 +1,9 @@
+//#region src/shared/cx.ts
+/** Joins class names, skipping empty ones. */
+function cx(...classNames) {
+	return classNames.filter(Boolean).join(" ");
+}
+//#endregion
+export { cx };
+
+//# sourceMappingURL=cx.js.map

package/dist/shared/cx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cx.js","names":[],"sources":["../../src/shared/cx.ts"],"sourcesContent":["/** Joins class names, skipping empty ones. */\nexport function cx(...classNames: (string | false | null | undefined)[]): string {\n    return classNames.filter(Boolean).join(' ');\n}\n"],"mappings":";;AACA,SAAgB,GAAG,GAAG,YAA2D;CAC7E,OAAO,WAAW,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;AAC9C"}

package/dist/shared/dates.d.ts

@@ -0,0 +1,15 @@
+import { type CalendarDate, type CalendarDateTime, type Time, type ZonedDateTime } from '@internationalized/date';
+/** `2026-10-15`, or the date of a date-time. */
+export declare function toCalendarDate(value: string | null | undefined): CalendarDate | null;
+/**
+ * A date-time: with an offset or `Z` (`2026-10-15T13:30:00Z`), in the given time zone; without one
+ * (`2026-10-15 09:30:00`), as is.
+ */
+export declare function toDateTime(value: string | null | undefined, timeZone?: string): ZonedDateTime | CalendarDateTime | null;
+/** Writes a date-time: in UTC (`…Z`) when it has a time zone, without an offset otherwise. */
+export declare function fromDateTime(value: ZonedDateTime | CalendarDateTime): string;
+/** `09:30` or `09:30:15`. */
+export declare function toTime(value: string | null | undefined): Time | null;
+/** Writes a time as `HH:mm`, or `HH:mm:ss` with seconds. */
+export declare function fromTime(value: Pick<Time, 'hour' | 'minute' | 'second'>, withSeconds?: boolean): string;
+//# sourceMappingURL=dates.d.ts.map

package/dist/shared/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/shared/dates.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,aAAa,EAMrB,MAAM,yBAAyB,CAAC;AAEjC,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAUpF;AAID;;;GAGG;AACH,wBAAgB,UAAU,CACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,GAAE,MAA2B,GACtC,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAUzC;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,MAAM,CAI5E;AAED,6BAA6B;AAC7B,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CASpE;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CACpB,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAC/C,WAAW,UAAQ,GACpB,MAAM,CAIR"}

package/dist/shared/dates.js

@@ -0,0 +1,49 @@
+import { getLocalTimeZone, parseAbsolute, parseDate, parseDateTime, parseTime } from "@internationalized/date";
+//#region src/shared/dates.ts
+/** `2026-10-15`, or the date of a date-time. */
+function toCalendarDate(value) {
+	const match = value?.match(/^(\d{4}-\d{2}-\d{2})/);
+	if (match?.[1] === void 0) return null;
+	try {
+		return parseDate(match[1]);
+	} catch {
+		return null;
+	}
+}
+var OFFSET = /(?:Z|[+-]\d{2}:?\d{2})$/i;
+/**
+* A date-time: with an offset or `Z` (`2026-10-15T13:30:00Z`), in the given time zone; without one
+* (`2026-10-15 09:30:00`), as is.
+*/
+function toDateTime(value, timeZone = getLocalTimeZone()) {
+	if (value === null || value === void 0 || value.trim() === "") return null;
+	const iso = value.trim().replace(" ", "T");
+	try {
+		return OFFSET.test(iso) ? parseAbsolute(iso, timeZone) : parseDateTime(iso);
+	} catch {
+		return null;
+	}
+}
+/** Writes a date-time: in UTC (`…Z`) when it has a time zone, without an offset otherwise. */
+function fromDateTime(value) {
+	return "timeZone" in value ? value.toAbsoluteString().replace(/\.000Z$/, "Z") : value.toString();
+}
+/** `09:30` or `09:30:15`. */
+function toTime(value) {
+	if (value === null || value === void 0 || !/^\d{1,2}:\d{2}(:\d{2})?/.test(value)) return null;
+	try {
+		return parseTime(value.length < 5 ? `0${value}` : value);
+	} catch {
+		return null;
+	}
+}
+/** Writes a time as `HH:mm`, or `HH:mm:ss` with seconds. */
+function fromTime(value, withSeconds = false) {
+	const pad = (part) => String(part).padStart(2, "0");
+	const time = `${pad(value.hour)}:${pad(value.minute)}`;
+	return withSeconds ? `${time}:${pad(value.second)}` : time;
+}
+//#endregion
+export { fromDateTime, fromTime, toCalendarDate, toDateTime, toTime };
+
+//# sourceMappingURL=dates.js.map

package/dist/shared/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","names":[],"sources":["../../src/shared/dates.ts"],"sourcesContent":["import {\n    type CalendarDate,\n    type CalendarDateTime,\n    type Time,\n    type ZonedDateTime,\n    getLocalTimeZone,\n    parseAbsolute,\n    parseDate,\n    parseDateTime,\n    parseTime,\n} from '@internationalized/date';\n\n/** `2026-10-15`, or the date of a date-time. */\nexport function toCalendarDate(value: string | null | undefined): CalendarDate | null {\n    const match = value?.match(/^(\\d{4}-\\d{2}-\\d{2})/);\n    if (match?.[1] === undefined) {\n        return null;\n    }\n    try {\n        return parseDate(match[1]);\n    } catch {\n        return null;\n    }\n}\n\nconst OFFSET = /(?:Z|[+-]\\d{2}:?\\d{2})$/i;\n\n/**\n * A date-time: with an offset or `Z` (`2026-10-15T13:30:00Z`), in the given time zone; without one\n * (`2026-10-15 09:30:00`), as is.\n */\nexport function toDateTime(\n    value: string | null | undefined,\n    timeZone: string = getLocalTimeZone(),\n): ZonedDateTime | CalendarDateTime | null {\n    if (value === null || value === undefined || value.trim() === '') {\n        return null;\n    }\n    const iso = value.trim().replace(' ', 'T');\n    try {\n        return OFFSET.test(iso) ? parseAbsolute(iso, timeZone) : parseDateTime(iso);\n    } catch {\n        return null;\n    }\n}\n\n/** Writes a date-time: in UTC (`…Z`) when it has a time zone, without an offset otherwise. */\nexport function fromDateTime(value: ZonedDateTime | CalendarDateTime): string {\n    return 'timeZone' in value\n        ? value.toAbsoluteString().replace(/\\.000Z$/, 'Z')\n        : value.toString();\n}\n\n/** `09:30` or `09:30:15`. */\nexport function toTime(value: string | null | undefined): Time | null {\n    if (value === null || value === undefined || !/^\\d{1,2}:\\d{2}(:\\d{2})?/.test(value)) {\n        return null;\n    }\n    try {\n        return parseTime(value.length < 5 ? `0${value}` : value);\n    } catch {\n        return null;\n    }\n}\n\n/** Writes a time as `HH:mm`, or `HH:mm:ss` with seconds. */\nexport function fromTime(\n    value: Pick<Time, 'hour' | 'minute' | 'second'>,\n    withSeconds = false,\n): string {\n    const pad = (part: number) => String(part).padStart(2, '0');\n    const time = `${pad(value.hour)}:${pad(value.minute)}`;\n    return withSeconds ? `${time}:${pad(value.second)}` : time;\n}\n"],"mappings":";;;AAaA,SAAgB,eAAe,OAAuD;CAClF,MAAM,QAAQ,OAAO,MAAM,sBAAsB;CACjD,IAAI,QAAQ,OAAO,KAAA,GACf,OAAO;CAEX,IAAI;EACA,OAAO,UAAU,MAAM,EAAE;CAC7B,QAAQ;EACJ,OAAO;CACX;AACJ;AAEA,IAAM,SAAS;;;;;AAMf,SAAgB,WACZ,OACA,WAAmB,iBAAiB,GACG;CACvC,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,MAAM,KAAK,MAAM,IAC1D,OAAO;CAEX,MAAM,MAAM,MAAM,KAAK,CAAC,CAAC,QAAQ,KAAK,GAAG;CACzC,IAAI;EACA,OAAO,OAAO,KAAK,GAAG,IAAI,cAAc,KAAK,QAAQ,IAAI,cAAc,GAAG;CAC9E,QAAQ;EACJ,OAAO;CACX;AACJ;;AAGA,SAAgB,aAAa,OAAiD;CAC1E,OAAO,cAAc,QACf,MAAM,iBAAiB,CAAC,CAAC,QAAQ,WAAW,GAAG,IAC/C,MAAM,SAAS;AACzB;;AAGA,SAAgB,OAAO,OAA+C;CAClE,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,CAAC,0BAA0B,KAAK,KAAK,GAC9E,OAAO;CAEX,IAAI;EACA,OAAO,UAAU,MAAM,SAAS,IAAI,IAAI,UAAU,KAAK;CAC3D,QAAQ;EACJ,OAAO;CACX;AACJ;;AAGA,SAAgB,SACZ,OACA,cAAc,OACR;CACN,MAAM,OAAO,SAAiB,OAAO,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG;CAC1D,MAAM,OAAO,GAAG,IAAI,MAAM,IAAI,EAAC,GAAI,IAAI,MAAM,MAAM;CACnD,OAAO,cAAc,GAAG,KAAI,GAAI,IAAI,MAAM,MAAM,MAAM;AAC1D"}

package/dist/shared/entry.d.ts

@@ -0,0 +1,23 @@
+import type { Field, Rule } from '@panneau/protocol';
+import type { FieldEntryProps, FieldProps } from './types';
+/** The rule of a field with this name, if any. */
+export declare function findRule(field: Field, rule: Rule['rule']): Rule | undefined;
+/** The number of a `min` or `max` rule of a field, if any. */
+export declare function getRuleNumber(field: Field, rule: 'min' | 'max'): number | undefined;
+/** Whether a field has the `required` rule. */
+export declare function isRequired(field: Field): boolean;
+/** A setting of a field (`settings.<name>`), when it has the expected type. */
+export declare function getSetting<T>(field: Field, name: string, guard: (value: unknown) => value is T): T | undefined;
+export declare const isString: (value: unknown) => value is string;
+export declare const isNumber: (value: unknown) => value is number;
+/**
+ * The props that every field takes, from a registry entry's props: label (the field's name
+ * without one), help, required mark, read-only, errors and handlers. Plugins use it to write their
+ * own entries.
+ */
+export declare function getFieldProps(props: FieldEntryProps): Omit<FieldProps<never>, 'value' | 'onChange'> & {
+    placeholder?: string;
+};
+/** The value as a string, or `null`. */
+export declare function asString(value: unknown): string | null;
+//# sourceMappingURL=entry.d.ts.map

package/dist/shared/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/shared/entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3D,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAE3E;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAKnF;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEhD;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,iBAG9F;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AACvF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACE,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,eAAe,GACvB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAe1E;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEtD"}

package/dist/shared/entry.js

@@ -0,0 +1,45 @@
+//#region src/shared/entry.ts
+/** The rule of a field with this name, if any. */
+function findRule(field, rule) {
+	return field.rules?.find((candidate) => candidate.rule === rule);
+}
+/** The number of a `min` or `max` rule of a field, if any. */
+function getRuleNumber(field, rule) {
+	const found = findRule(field, rule);
+	return found !== void 0 && "value" in found && typeof found.value === "number" ? found.value : void 0;
+}
+/** Whether a field has the `required` rule. */
+function isRequired(field) {
+	return findRule(field, "required") !== void 0;
+}
+/** A setting of a field (`settings.<name>`), when it has the expected type. */
+function getSetting(field, name, guard) {
+	const value = field.settings?.[name];
+	return guard(value) ? value : void 0;
+}
+var isString = (value) => typeof value === "string";
+var isNumber = (value) => typeof value === "number" && !Number.isNaN(value);
+/**
+* The props that every field takes, from a registry entry's props: label (the field's name
+* without one), help, required mark, read-only, errors and handlers. Plugins use it to write their
+* own entries.
+*/
+function getFieldProps(props) {
+	const { field } = props;
+	return {
+		name: props.path,
+		label: field.label ?? field.name,
+		description: field.help,
+		...field.placeholder !== void 0 ? { placeholder: field.placeholder } : {},
+		required: isRequired(field),
+		readOnly: props.readOnly === true || field.readOnly === true,
+		disabled: props.disabled === true,
+		errors: props.errors ?? [],
+		...props.onBlur !== void 0 ? { onBlur: props.onBlur } : {},
+		...props.className !== void 0 ? { className: props.className } : {}
+	};
+}
+//#endregion
+export { findRule, getFieldProps, getRuleNumber, getSetting, isNumber, isRequired, isString };
+
+//# sourceMappingURL=entry.js.map

package/dist/shared/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","names":[],"sources":["../../src/shared/entry.ts"],"sourcesContent":["import type { Field, Rule } from '@panneau/protocol';\n\nimport type { FieldEntryProps, FieldProps } from './types';\n\n/** The rule of a field with this name, if any. */\nexport function findRule(field: Field, rule: Rule['rule']): Rule | undefined {\n    return field.rules?.find((candidate) => candidate.rule === rule);\n}\n\n/** The number of a `min` or `max` rule of a field, if any. */\nexport function getRuleNumber(field: Field, rule: 'min' | 'max'): number | undefined {\n    const found = findRule(field, rule);\n    return found !== undefined && 'value' in found && typeof found.value === 'number'\n        ? found.value\n        : undefined;\n}\n\n/** Whether a field has the `required` rule. */\nexport function isRequired(field: Field): boolean {\n    return findRule(field, 'required') !== undefined;\n}\n\n/** A setting of a field (`settings.<name>`), when it has the expected type. */\nexport function getSetting<T>(field: Field, name: string, guard: (value: unknown) => value is T) {\n    const value = field.settings?.[name];\n    return guard(value) ? value : undefined;\n}\n\nexport const isString = (value: unknown): value is string => typeof value === 'string';\nexport const isNumber = (value: unknown): value is number =>\n    typeof value === 'number' && !Number.isNaN(value);\n\n/**\n * The props that every field takes, from a registry entry's props: label (the field's name\n * without one), help, required mark, read-only, errors and handlers. Plugins use it to write their\n * own entries.\n */\nexport function getFieldProps(\n    props: FieldEntryProps,\n): Omit<FieldProps<never>, 'value' | 'onChange'> & { placeholder?: string } {\n    const { field } = props;\n    return {\n        name: props.path,\n        // A field always has a label: its name when the definition gives none.\n        label: field.label ?? field.name,\n        description: field.help,\n        ...(field.placeholder !== undefined ? { placeholder: field.placeholder } : {}),\n        required: isRequired(field),\n        readOnly: props.readOnly === true || field.readOnly === true,\n        disabled: props.disabled === true,\n        errors: props.errors ?? [],\n        ...(props.onBlur !== undefined ? { onBlur: props.onBlur } : {}),\n        ...(props.className !== undefined ? { className: props.className } : {}),\n    };\n}\n\n/** The value as a string, or `null`. */\nexport function asString(value: unknown): string | null {\n    return typeof value === 'string' ? value : null;\n}\n"],"mappings":";;AAKA,SAAgB,SAAS,OAAc,MAAsC;CACzE,OAAO,MAAM,OAAO,MAAM,cAAc,UAAU,SAAS,IAAI;AACnE;;AAGA,SAAgB,cAAc,OAAc,MAAyC;CACjF,MAAM,QAAQ,SAAS,OAAO,IAAI;CAClC,OAAO,UAAU,KAAA,KAAa,WAAW,SAAS,OAAO,MAAM,UAAU,WACnE,MAAM,QACN,KAAA;AACV;;AAGA,SAAgB,WAAW,OAAuB;CAC9C,OAAO,SAAS,OAAO,UAAU,MAAM,KAAA;AAC3C;;AAGA,SAAgB,WAAc,OAAc,MAAc,OAAuC;CAC7F,MAAM,QAAQ,MAAM,WAAW;CAC/B,OAAO,MAAM,KAAK,IAAI,QAAQ,KAAA;AAClC;AAEA,IAAa,YAAY,UAAoC,OAAO,UAAU;AAC9E,IAAa,YAAY,UACrB,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK;;;;;;AAOpD,SAAgB,cACZ,OACwE;CACxE,MAAM,EAAE,UAAU;CAClB,OAAO;EACH,MAAM,MAAM;EAEZ,OAAO,MAAM,SAAS,MAAM;EAC5B,aAAa,MAAM;EACnB,GAAI,MAAM,gBAAgB,KAAA,IAAY,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;EAC5E,UAAU,WAAW,KAAK;EAC1B,UAAU,MAAM,aAAa,QAAQ,MAAM,aAAa;EACxD,UAAU,MAAM,aAAa;EAC7B,QAAQ,MAAM,UAAU,CAAA;EACxB,GAAI,MAAM,WAAW,KAAA,IAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;EAC7D,GAAI,MAAM,cAAc,KAAA,IAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;CAC1E;AACJ"}

package/dist/shared/messages.d.ts

@@ -0,0 +1,2 @@
+export { fieldsMessages as messages } from '@panneau/intl';
+//# sourceMappingURL=messages.d.ts.map

package/dist/shared/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/shared/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/shared/messages.js

@@ -0,0 +1 @@
+export { fieldsMessages as messages } from "@panneau/intl";

package/dist/shared/relation.d.ts

@@ -0,0 +1,73 @@
+import type { Definition, Item, ListQuery } from '@panneau/protocol';
+/** A related item: its id, and a label to show it. The value of a relation field. */
+export interface RelationReference {
+    id: string;
+    label: string;
+}
+/** Where relation fields search for items. */
+export interface RelationSource {
+    /** Items of a resource that match a text, for the picker. */
+    search(resource: string, query: string, options: {
+        signal: AbortSignal;
+    }): Promise<RelationReference[]>;
+    /**
+     * The references of items by id, for values that are only ids (`"12"`, `["12", "13"]`), as a
+     * product's own API gives them. In any order; ids it doesn't find are left out, and keep their
+     * id as label. Without it, fields show the ids.
+     */
+    resolve?(resource: string, ids: readonly string[], options: {
+        signal: AbortSignal;
+    }): Promise<RelationReference[]>;
+    /**
+     * Creates an item from the text typed in the picker, which offers "Create “…”" when this
+     * method exists. It can open a dialog, and resolves with the reference of the new item, or with
+     * `null` when nothing was created.
+     */
+    create?(resource: string, text: string): Promise<RelationReference | null>;
+    /** Whether `create()` can create items of a resource. Defaults to true. */
+    canCreate?(resource: string): boolean;
+}
+/** What `createRelationSource()` needs from an adapter: the `list()`, `get()` and `create()` of `@panneau/data`. */
+export interface RelationListAdapter {
+    list(resource: string, query?: ListQuery, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        data: Item[];
+    }>;
+    /** One item, for `resolve()`. Without it, the source doesn't resolve ids. */
+    get?(resource: string, id: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Item>;
+    /** Creates an item, for `create()`. */
+    create?(resource: string, values: Record<string, unknown>): Promise<Item>;
+}
+export interface RelationSourceOptions {
+    /** The definition, for the field that titles the items of each resource (`itemTitle`). */
+    definition?: (Pick<Definition, 'resources'> & Partial<Pick<Definition, 'locales'>>) | null;
+    /** Items per search. Defaults to 20. */
+    perPage?: number;
+    /** The label of an item, when `itemTitle` isn't enough. */
+    getLabel?: (item: Item, resource: string) => string;
+    /**
+     * Lets the picker create items, with the adapter's `create()`. `true` sets the typed text as the
+     * value of the resource's `itemTitle` field (in every locale of the definition when it is
+     * localized), on the resources that allow `create`. A function gives the values of the new item
+     * instead, or `null` for a resource where items can't be created.
+     */
+    create?: boolean | ((text: string, resource: string) => Record<string, unknown> | null);
+}
+/**
+ * A relation source over an adapter, such as the `DataAdapter` of `@panneau/data`: a search is a
+ * list query with `q`, ids are resolved with `get()`, and, with the `create` option, items are
+ * created with `create()`. Labels come from the resource's `itemTitle`.
+ */
+export declare function createRelationSource(adapter: RelationListAdapter, { definition, perPage, getLabel, create }?: RelationSourceOptions): RelationSource;
+/** Reads relation values: references, ids, or lists of them. */
+export declare function toReferences(value: unknown): RelationReference[];
+/**
+ * Relation references with the labels of plain ids: references whose label is their id (from
+ * `"12"`) are resolved with the source's `resolve()`, once per source, resource and id. They keep
+ * their id as label until then, or when the source doesn't find them.
+ */
+export declare function useRelationReferences(source: RelationSource | null, resource: string, references: readonly RelationReference[]): RelationReference[];
+//# sourceMappingURL=relation.d.ts.map

package/dist/shared/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/shared/relation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErE,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,MAAM,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,CACJ,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChC;;;;OAIG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAED,oHAAoH;AACpH,MAAM,WAAW,mBAAmB;IAChC,IAAI,CACA,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7B,6EAA6E;IAC7E,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,uCAAuC;IACvC,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,qBAAqB;IAClC,0FAA0F;IAC1F,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3F,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CAC3F;AAeD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,EAAE,UAAiB,EAAE,OAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAE,qBAA0B,GAClF,cAAc,CAgEhB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAkBhE;AAiDD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,iBAAiB,EAAE,GACzC,iBAAiB,EAAE,CA2CrB"}