@panneau/fields 5.0.0-alpha.1 → 5.0.0-alpha.11

package/dist/shared/context.js

@@ -6,6 +6,10 @@ var FieldsContext = createContext({
 	components: {},
 	locales: [],
 	relationSource: null,
+	uploadSource: null,
+	checkSource: null,
+	embedSource: null,
+	maps: null,
 	binding: null
 });
 /** The fields context of the closest `FieldsProvider`. */
@@ -14,12 +18,12 @@ function useFieldsContext() {
 }
 /**
 * 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.
+* of localized values, the sources of relations, uploads, checks and embeds, the maps of
+* locations, 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 $ = c(15);
+	const { components, locales, relationSource, uploadSource, checkSource, embedSource, maps, binding, children } = t0;
 	const parent = use(FieldsContext);
 	let t1;
 	if ($[0] !== components || $[1] !== parent.components) {
@@ -33,33 +37,45 @@ function FieldsProvider(t0) {
 	} 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 = {
+	const t4 = uploadSource === void 0 ? parent.uploadSource : uploadSource;
+	const t5 = checkSource === void 0 ? parent.checkSource : checkSource;
+	const t6 = embedSource === void 0 ? parent.embedSource : embedSource;
+	const t7 = maps === void 0 ? parent.maps : maps;
+	const t8 = binding === void 0 ? parent.binding : binding;
+	let t9;
+	if ($[3] !== t1 || $[4] !== t2 || $[5] !== t3 || $[6] !== t4 || $[7] !== t5 || $[8] !== t6 || $[9] !== t7 || $[10] !== t8) {
+		t9 = {
 			components: t1,
 			locales: t2,
 			relationSource: t3,
-			binding: t4
+			uploadSource: t4,
+			checkSource: t5,
+			embedSource: t6,
+			maps: t7,
+			binding: t8
 		};
 		$[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, {
+		$[8] = t6;
+		$[9] = t7;
+		$[10] = t8;
+		$[11] = t9;
+	} else t9 = $[11];
+	const value = t9;
+	let t10;
+	if ($[12] !== children || $[13] !== value) {
+		t10 = /* @__PURE__ */ jsx(FieldsContext, {
 			value,
 			children
 		});
-		$[8] = children;
-		$[9] = value;
-		$[10] = t6;
-	} else t6 = $[10];
-	return t6;
+		$[12] = children;
+		$[13] = value;
+		$[14] = t10;
+	} else t10 = $[14];
+	return t10;
 }
 /** The parent path of a path: `blocks.2` for `blocks.2.title`, `''` for `title`. */
 function getParentPath(path) {

package/dist/shared/context.js.map

@@ -1 +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"}
+{"version":3,"file":"context.js","names":["ComponentType","ReactNode","createContext","use","Field","MapsConfig","UploadSource","FieldCheckSource","EmbedSource","RelationSource","FieldEntry","BoundFieldProps","value","onChange","onBlur","errors","FieldBindingProps","field","path","parentPath","render","bound","FieldBinding","FieldsContextValue","components","Readonly","Record","locales","relationSource","uploadSource","checkSource","embedSource","maps","binding","FieldsContext","useFieldsContext","FieldsProviderProps","children","FieldsProvider","t0","$","_c","parent","t1","undefined","t2","t3","t4","t5","t6","t7","t8","t9","t10","getParentPath","index","lastIndexOf","slice","_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 { MapsConfig } from '../location/types';\nimport type { UploadSource } from '../upload/types';\nimport type { FieldCheckSource } from './check';\nimport type { EmbedSource } from './embed';\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    /**\n     * Where fields that take files upload them directly to storage. Without one, they give the\n     * files themselves.\n     */\n    uploadSource: UploadSource | null;\n    /** Where fields with `check` check their value, such as a slug's availability. */\n    checkSource: FieldCheckSource | null;\n    /** Where `embed` fields get what a URL embeds. Without one, they keep the URL alone. */\n    embedSource: EmbedSource | null;\n    /** The tiles and the address search of `location` fields. */\n    maps: MapsConfig | null;\n    binding: FieldBinding | null;\n}\n\nconst FieldsContext = createContext<FieldsContextValue>({\n    components: {},\n    locales: [],\n    relationSource: null,\n    uploadSource: null,\n    checkSource: null,\n    embedSource: null,\n    maps: 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    /** Make it once, outside of render: fields make an uploader for each source they get. */\n    uploadSource?: UploadSource | null;\n    /** `createFieldCheckSource(adapter, resource, id)`, for the form of an item. */\n    checkSource?: FieldCheckSource | null;\n    /** `createEmbedSource(adapter)`. */\n    embedSource?: EmbedSource | null;\n    /** The tiles and the address search of `location` fields. */\n    maps?: MapsConfig | 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, the sources of relations, uploads, checks and embeds, the maps of\n * locations, and a binding. Values not given come from the parent provider.\n */\nexport function FieldsProvider({\n    components,\n    locales,\n    relationSource,\n    uploadSource,\n    checkSource,\n    embedSource,\n    maps,\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        uploadSource: uploadSource === undefined ? parent.uploadSource : uploadSource,\n        checkSource: checkSource === undefined ? parent.checkSource : checkSource,\n        embedSource: embedSource === undefined ? parent.embedSource : embedSource,\n        maps: maps === undefined ? parent.maps : maps,\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":";;;;AA0DA,IAAMkC,gBAAgBhC,cAAkC;CACpDsB,YAAY,CAAC;CACbG,SAAS,CAAA;CACTC,gBAAgB;CAChBC,cAAc;CACdC,aAAa;CACbC,aAAa;CACbC,MAAM;CACNC,SAAS;AACb,CAAC;;AAGD,SAAgBE,mBAAuC;CACnD,OAAOhC,IAAI+B,aAAa;AAC5B;;;;;;AAwBA,SAAOI,eAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAwB,MAAA,EAAAjB,YAAAG,SAAAC,gBAAAC,cAAAC,aAAAC,aAAAC,MAAAC,SAAAI,aAAAE;CAW3B,MAAAG,SAAevC,IAAI+B,aAAa;CAAE,IAAAS;CAAA,IAAAH,EAAA,OAAAhB,cAAAgB,EAAA,OAAAE,OAAAlB,YAAA;EAG1BmB,KAAAnB,eAAeoB,KAAAA,IAAf;GAAA,GAAgCF,OAAMlB;GAAW,GAAKA;EAA+B,IAAhBkB,OAAMlB;EAAWgB,EAAA,KAAAhB;EAAAgB,EAAA,KAAAE,OAAAlB;EAAAgB,EAAA,KAAAG;CAAA,OAAAA,KAAAH,EAAA;CACjF,MAAAK,KAAAlB,WAAWe,OAAMf;CACV,MAAAmB,KAAAlB,mBAAmBgB,KAAAA,IAAYF,OAAMd,iBAArCA;CACF,MAAAmB,KAAAlB,iBAAiBe,KAAAA,IAAYF,OAAMb,eAAnCA;CACD,MAAAmB,KAAAlB,gBAAgBc,KAAAA,IAAYF,OAAMZ,cAAlCA;CACA,MAAAmB,KAAAlB,gBAAgBa,KAAAA,IAAYF,OAAMX,cAAlCA;CACP,MAAAmB,KAAAlB,SAASY,KAAAA,IAAYF,OAAMV,OAA3BA;CACG,MAAAmB,KAAAlB,YAAYW,KAAAA,IAAYF,OAAMT,UAA9BA;CAAgD,IAAAmB;CAAA,IAAAZ,EAAA,OAAAG,MAAAH,EAAA,OAAAK,MAAAL,EAAA,OAAAM,MAAAN,EAAA,OAAAO,MAAAP,EAAA,OAAAQ,MAAAR,EAAA,OAAAS,MAAAT,EAAA,OAAAU,MAAAV,EAAA,QAAAW,IAAA;EAT3BC,KAAA;GAAA5B,YAE1BmB;GAAsFhB,SACjFkB;GAAyBjB,gBAClBkB;GAAqEjB,cACvEkB;GAA+DjB,aAChEkB;GAA4DjB,aAC5DkB;GAA4DjB,MACnEkB;GAAuCjB,SACpCkB;EACb;EAACX,EAAA,KAAAG;EAAAH,EAAA,KAAAK;EAAAL,EAAA,KAAAM;EAAAN,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;EAAAR,EAAA,KAAAS;EAAAT,EAAA,KAAAU;EAAAV,EAAA,MAAAW;EAAAX,EAAA,MAAAY;CAAA,OAAAA,KAAAZ,EAAA;CAVD,MAAA5B,QAAkCwC;CAUhC,IAAAC;CAAA,IAAAb,EAAA,QAAAH,YAAAG,EAAA,QAAA5B,OAAA;EACKyC,MAAA,oBAAC,eAAD;GAAsBzC;GAAQyB;EAAhB,CAAA;EAAyCG,EAAA,MAAAH;EAAAG,EAAA,MAAA5B;EAAA4B,EAAA,MAAAa;CAAA,OAAAA,MAAAb,EAAA;CAAA,OAAvDa;AAAuD;;AAIlE,SAAgBC,cAAcpC,MAAsB;CAChD,MAAMqC,QAAQrC,KAAKsC,YAAY,GAAG;CAClC,OAAOD,UAAU,KAAK,KAAKrC,KAAKuC,MAAM,GAAGF,KAAK;AAClD"}

package/dist/shared/cx.js.map

@@ -1 +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"}
+{"version":3,"file":"cx.js","names":["cx","classNames","filter","Boolean","join"],"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,SAAgBA,GAAG,GAAGC,YAA2D;CAC7E,OAAOA,WAAWC,OAAOC,OAAO,CAAC,CAACC,KAAK,GAAG;AAC9C"}

package/dist/shared/dates.js.map

@@ -1 +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"}
+{"version":3,"file":"dates.js","names":["CalendarDate","CalendarDateTime","Time","ZonedDateTime","getLocalTimeZone","parseAbsolute","parseDate","parseDateTime","parseTime","toCalendarDate","value","match","undefined","OFFSET","toDateTime","timeZone","trim","iso","replace","test","fromDateTime","toAbsoluteString","toString","toTime","length","fromTime","Pick","withSeconds","pad","part","String","padStart","time","hour","minute","second"],"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,SAAgBS,eAAeC,OAAuD;CAClF,MAAMC,QAAQD,OAAOC,MAAM,sBAAsB;CACjD,IAAIA,QAAQ,OAAOC,KAAAA,GACf,OAAO;CAEX,IAAI;EACA,OAAON,UAAUK,MAAM,EAAE;CAC7B,QAAQ;EACJ,OAAO;CACX;AACJ;AAEA,IAAME,SAAS;;;;;AAMf,SAAgBC,WACZJ,OACAK,WAAmBX,iBAAiB,GACG;CACvC,IAAIM,UAAU,QAAQA,UAAUE,KAAAA,KAAaF,MAAMM,KAAK,MAAM,IAC1D,OAAO;CAEX,MAAMC,MAAMP,MAAMM,KAAK,CAAC,CAACE,QAAQ,KAAK,GAAG;CACzC,IAAI;EACA,OAAOL,OAAOM,KAAKF,GAAG,IAAIZ,cAAcY,KAAKF,QAAQ,IAAIR,cAAcU,GAAG;CAC9E,QAAQ;EACJ,OAAO;CACX;AACJ;;AAGA,SAAgBG,aAAaV,OAAiD;CAC1E,OAAO,cAAcA,QACfA,MAAMW,iBAAiB,CAAC,CAACH,QAAQ,WAAW,GAAG,IAC/CR,MAAMY,SAAS;AACzB;;AAGA,SAAgBC,OAAOb,OAA+C;CAClE,IAAIA,UAAU,QAAQA,UAAUE,KAAAA,KAAa,CAAC,0BAA0BO,KAAKT,KAAK,GAC9E,OAAO;CAEX,IAAI;EACA,OAAOF,UAAUE,MAAMc,SAAS,IAAI,IAAId,UAAUA,KAAK;CAC3D,QAAQ;EACJ,OAAO;CACX;AACJ;;AAGA,SAAgBe,SACZf,OACAiB,cAAc,OACR;CACN,MAAMC,OAAOC,SAAiBC,OAAOD,IAAI,CAAC,CAACE,SAAS,GAAG,GAAG;CAC1D,MAAMC,OAAO,GAAGJ,IAAIlB,MAAMuB,IAAI,EAAC,GAAIL,IAAIlB,MAAMwB,MAAM;CACnD,OAAOP,cAAc,GAAGK,KAAI,GAAIJ,IAAIlB,MAAMyB,MAAM,MAAMH;AAC1D"}

package/dist/shared/embed.d.ts

@@ -0,0 +1,19 @@
+import type { EmbedValue } from '@panneau/protocol';
+/** Where `embed` fields get what a URL embeds: the backend, from the provider's oEmbed. */
+export interface EmbedSource {
+    resolve(url: string, options: {
+        signal: AbortSignal;
+    }): Promise<EmbedValue>;
+}
+/** What `createEmbedSource()` needs from an adapter: the `resolveEmbed()` of `@panneau/data`. */
+export interface EmbedAdapter {
+    resolveEmbed?(url: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<EmbedValue>;
+}
+/**
+ * The embed source of an adapter (`GET /embeds?url=`). Null when the adapter can't resolve
+ * embeds: `embed` fields then keep the URL alone.
+ */
+export declare function createEmbedSource(adapter: EmbedAdapter): EmbedSource | null;
+//# sourceMappingURL=embed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/shared/embed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/E;AAED,iGAAiG;AACjG,MAAM,WAAW,YAAY;IACzB,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CAM3E"}

package/dist/shared/embed.js

@@ -0,0 +1,14 @@
+//#region src/shared/embed.ts
+/**
+* The embed source of an adapter (`GET /embeds?url=`). Null when the adapter can't resolve
+* embeds: `embed` fields then keep the URL alone.
+*/
+function createEmbedSource(adapter) {
+	const { resolveEmbed } = adapter;
+	if (resolveEmbed === void 0) return null;
+	return { resolve: (url, { signal }) => resolveEmbed.call(adapter, url, { signal }) };
+}
+//#endregion
+export { createEmbedSource };
+
+//# sourceMappingURL=embed.js.map

package/dist/shared/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","names":["EmbedValue","EmbedSource","resolve","url","options","signal","AbortSignal","Promise","EmbedAdapter","resolveEmbed","createEmbedSource","adapter","undefined","call"],"sources":["../../src/shared/embed.ts"],"sourcesContent":["import type { EmbedValue } from '@panneau/protocol';\n\n/** Where `embed` fields get what a URL embeds: the backend, from the provider's oEmbed. */\nexport interface EmbedSource {\n    resolve(url: string, options: { signal: AbortSignal }): Promise<EmbedValue>;\n}\n\n/** What `createEmbedSource()` needs from an adapter: the `resolveEmbed()` of `@panneau/data`. */\nexport interface EmbedAdapter {\n    resolveEmbed?(url: string, options?: { signal?: AbortSignal }): Promise<EmbedValue>;\n}\n\n/**\n * The embed source of an adapter (`GET /embeds?url=`). Null when the adapter can't resolve\n * embeds: `embed` fields then keep the URL alone.\n */\nexport function createEmbedSource(adapter: EmbedAdapter): EmbedSource | null {\n    const { resolveEmbed } = adapter;\n    if (resolveEmbed === undefined) {\n        return null;\n    }\n    return { resolve: (url, { signal }) => resolveEmbed.call(adapter, url, { signal }) };\n}\n"],"mappings":";;;;;AAgBA,SAAgBU,kBAAkBC,SAA2C;CACzE,MAAM,EAAEF,iBAAiBE;CACzB,IAAIF,iBAAiBG,KAAAA,GACjB,OAAO;CAEX,OAAO,EAAEV,UAAUC,KAAK,EAAEE,aAAaI,aAAaI,KAAKF,SAASR,KAAK,EAAEE,OAAO,CAAC,EAAE;AACvF"}

package/dist/shared/entry.d.ts

@@ -1,6 +1,10 @@
 import type { Field, Rule } from '@panneau/protocol';
-import type { FieldEntryProps, FieldProps } from './types';
-/** The rule of a field with this name, if any. */
+import type { FieldEntryProps, FieldProps } from './types.js';
+/**
+ * The rule of a field with this name, if any. A rule limited to a mode (`"mode": "create"`)
+ * doesn't count: forms keep it, without its `mode`, in that mode only (`resolveFields()` of
+ * `@panneau/core`).
+ */
 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;
@@ -9,6 +13,7 @@ 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 isBoolean: (value: unknown) => value is boolean;
 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
@@ -20,4 +25,8 @@ export declare function getFieldProps(props: FieldEntryProps): Omit<FieldProps<n
 };
 /** The value as a string, or `null`. */
 export declare function asString(value: unknown): string | null;
+/** The accepted MIME types of a field that takes files: its `accept`, or its `accept` rule. */
+export declare function getAccept(field: Field): string[] | null;
+/** The largest file of a field, in bytes: its `maxSize` rule. */
+export declare function getMaxSize(field: Field): number | null;
 //# sourceMappingURL=entry.d.ts.map

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

@@ -1 +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"}
+{"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;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAI3E;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,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAC1F,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;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,IAAI,CAQvD;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAGtD"}

package/dist/shared/entry.js

@@ -1,7 +1,11 @@
 //#region src/shared/entry.ts
-/** The rule of a field with this name, if any. */
+/**
+* The rule of a field with this name, if any. A rule limited to a mode (`"mode": "create"`)
+* doesn't count: forms keep it, without its `mode`, in that mode only (`resolveFields()` of
+* `@panneau/core`).
+*/
 function findRule(field, rule) {
-	return field.rules?.find((candidate) => candidate.rule === rule);
+	return field.rules?.find((candidate) => candidate.rule === rule && candidate.mode === void 0);
 }
 /** The number of a `min` or `max` rule of a field, if any. */
 function getRuleNumber(field, rule) {
@@ -18,6 +22,7 @@ function getSetting(field, name, guard) {
 	return guard(value) ? value : void 0;
 }
 var isString = (value) => typeof value === "string";
+var isBoolean = (value) => typeof value === "boolean";
 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
@@ -39,7 +44,18 @@ function getFieldProps(props) {
 		...props.className !== void 0 ? { className: props.className } : {}
 	};
 }
+/** The accepted MIME types of a field that takes files: its `accept`, or its `accept` rule. */
+function getAccept(field) {
+	if (field.accept !== void 0 && field.accept.length > 0) return field.accept;
+	const rule = findRule(field, "accept");
+	return rule !== void 0 && "value" in rule && Array.isArray(rule.value) ? rule.value.filter(isString) : null;
+}
+/** The largest file of a field, in bytes: its `maxSize` rule. */
+function getMaxSize(field) {
+	const rule = findRule(field, "maxSize");
+	return rule !== void 0 && "value" in rule && isNumber(rule.value) ? rule.value : null;
+}
 //#endregion
-export { findRule, getFieldProps, getRuleNumber, getSetting, isNumber, isRequired, isString };
+export { findRule, getAccept, getFieldProps, getMaxSize, getRuleNumber, getSetting, isBoolean, isNumber, isRequired, isString };
 
 //# sourceMappingURL=entry.js.map

package/dist/shared/entry.js.map

@@ -1 +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"}
+{"version":3,"file":"entry.js","names":["Field","Rule","FieldEntryProps","FieldProps","findRule","field","rule","rules","find","candidate","mode","undefined","getRuleNumber","found","value","isRequired","getSetting","name","guard","T","settings","isString","isBoolean","isNumber","Number","isNaN","getFieldProps","props","Omit","placeholder","path","label","description","help","required","readOnly","disabled","errors","onBlur","className","asString","getAccept","accept","length","Array","isArray","filter","getMaxSize"],"sources":["../../src/shared/entry.ts"],"sourcesContent":["import type { Field, Rule } from '@panneau/protocol';\n\nimport type { FieldEntryProps, FieldProps } from './types';\n\n/**\n * The rule of a field with this name, if any. A rule limited to a mode (`\"mode\": \"create\"`)\n * doesn't count: forms keep it, without its `mode`, in that mode only (`resolveFields()` of\n * `@panneau/core`).\n */\nexport function findRule(field: Field, rule: Rule['rule']): Rule | undefined {\n    return field.rules?.find(\n        (candidate) => candidate.rule === rule && candidate.mode === undefined,\n    );\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 isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\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\n/** The accepted MIME types of a field that takes files: its `accept`, or its `accept` rule. */\nexport function getAccept(field: Field): string[] | null {\n    if (field.accept !== undefined && field.accept.length > 0) {\n        return field.accept;\n    }\n    const rule = findRule(field, 'accept');\n    return rule !== undefined && 'value' in rule && Array.isArray(rule.value)\n        ? rule.value.filter(isString)\n        : null;\n}\n\n/** The largest file of a field, in bytes: its `maxSize` rule. */\nexport function getMaxSize(field: Field): number | null {\n    const rule = findRule(field, 'maxSize');\n    return rule !== undefined && 'value' in rule && isNumber(rule.value) ? rule.value : null;\n}\n"],"mappings":";;;;;;AASA,SAAgBI,SAASC,OAAcC,MAAsC;CACzE,OAAOD,MAAME,OAAOC,MACfC,cAAcA,UAAUH,SAASA,QAAQG,UAAUC,SAASC,KAAAA,CACjE;AACJ;;AAGA,SAAgBC,cAAcP,OAAcC,MAAyC;CACjF,MAAMO,QAAQT,SAASC,OAAOC,IAAI;CAClC,OAAOO,UAAUF,KAAAA,KAAa,WAAWE,SAAS,OAAOA,MAAMC,UAAU,WACnED,MAAMC,QACNH,KAAAA;AACV;;AAGA,SAAgBI,WAAWV,OAAuB;CAC9C,OAAOD,SAASC,OAAO,UAAU,MAAMM,KAAAA;AAC3C;;AAGA,SAAgBK,WAAcX,OAAcY,MAAcC,OAAuC;CAC7F,MAAMJ,QAAQT,MAAMe,WAAWH;CAC/B,OAAOC,MAAMJ,KAAK,IAAIA,QAAQH,KAAAA;AAClC;AAEA,IAAaU,YAAYP,UAAoC,OAAOA,UAAU;AAC9E,IAAaQ,aAAaR,UAAqC,OAAOA,UAAU;AAChF,IAAaS,YAAYT,UACrB,OAAOA,UAAU,YAAY,CAACU,OAAOC,MAAMX,KAAK;;;;;;AAOpD,SAAgBY,cACZC,OACwE;CACxE,MAAM,EAAEtB,UAAUsB;CAClB,OAAO;EACHV,MAAMU,MAAMG;EAEZC,OAAO1B,MAAM0B,SAAS1B,MAAMY;EAC5Be,aAAa3B,MAAM4B;EACnB,GAAI5B,MAAMwB,gBAAgBlB,KAAAA,IAAY,EAAEkB,aAAaxB,MAAMwB,YAAY,IAAI,CAAC;EAC5EK,UAAUnB,WAAWV,KAAK;EAC1B8B,UAAUR,MAAMQ,aAAa,QAAQ9B,MAAM8B,aAAa;EACxDC,UAAUT,MAAMS,aAAa;EAC7BC,QAAQV,MAAMU,UAAU,CAAA;EACxB,GAAIV,MAAMW,WAAW3B,KAAAA,IAAY,EAAE2B,QAAQX,MAAMW,OAAO,IAAI,CAAC;EAC7D,GAAIX,MAAMY,cAAc5B,KAAAA,IAAY,EAAE4B,WAAWZ,MAAMY,UAAU,IAAI,CAAC;CAC1E;AACJ;;AAQA,SAAgBE,UAAUpC,OAA+B;CACrD,IAAIA,MAAMqC,WAAW/B,KAAAA,KAAaN,MAAMqC,OAAOC,SAAS,GACpD,OAAOtC,MAAMqC;CAEjB,MAAMpC,OAAOF,SAASC,OAAO,QAAQ;CACrC,OAAOC,SAASK,KAAAA,KAAa,WAAWL,QAAQsC,MAAMC,QAAQvC,KAAKQ,KAAK,IAClER,KAAKQ,MAAMgC,OAAOzB,QAAQ,IAC1B;AACV;;AAGA,SAAgB0B,WAAW1C,OAA6B;CACpD,MAAMC,OAAOF,SAASC,OAAO,SAAS;CACtC,OAAOC,SAASK,KAAAA,KAAa,WAAWL,QAAQiB,SAASjB,KAAKQ,KAAK,IAAIR,KAAKQ,QAAQ;AACxF"}

package/dist/shared/relation.js.map

@@ -1 +1 @@
-{"version":3,"file":"relation.js","names":["id","active","reference","_c"],"sources":["../../src/shared/relation.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { Definition, Item, ListQuery } from '@panneau/protocol';\n\n/** A related item: its id, and a label to show it. The value of a relation field. */\nexport interface RelationReference {\n    id: string;\n    label: string;\n}\n\n/** Where relation fields search for items. */\nexport interface RelationSource {\n    /** Items of a resource that match a text, for the picker. */\n    search(\n        resource: string,\n        query: string,\n        options: { signal: AbortSignal },\n    ): Promise<RelationReference[]>;\n    /**\n     * The references of items by id, for values that are only ids (`\"12\"`, `[\"12\", \"13\"]`), as a\n     * product's own API gives them. In any order; ids it doesn't find are left out, and keep their\n     * id as label. Without it, fields show the ids.\n     */\n    resolve?(\n        resource: string,\n        ids: readonly string[],\n        options: { signal: AbortSignal },\n    ): Promise<RelationReference[]>;\n    /**\n     * Creates an item from the text typed in the picker, which offers \"Create “…”\" when this\n     * method exists. It can open a dialog, and resolves with the reference of the new item, or with\n     * `null` when nothing was created.\n     */\n    create?(resource: string, text: string): Promise<RelationReference | null>;\n    /** Whether `create()` can create items of a resource. Defaults to true. */\n    canCreate?(resource: string): boolean;\n}\n\n/** What `createRelationSource()` needs from an adapter: the `list()`, `get()` and `create()` of `@panneau/data`. */\nexport interface RelationListAdapter {\n    list(\n        resource: string,\n        query?: ListQuery,\n        options?: { signal?: AbortSignal },\n    ): Promise<{ data: Item[] }>;\n    /** One item, for `resolve()`. Without it, the source doesn't resolve ids. */\n    get?(resource: string, id: string, options?: { signal?: AbortSignal }): Promise<Item>;\n    /** Creates an item, for `create()`. */\n    create?(resource: string, values: Record<string, unknown>): Promise<Item>;\n}\n\nexport interface RelationSourceOptions {\n    /** The definition, for the field that titles the items of each resource (`itemTitle`). */\n    definition?: (Pick<Definition, 'resources'> & Partial<Pick<Definition, 'locales'>>) | null;\n    /** Items per search. Defaults to 20. */\n    perPage?: number;\n    /** The label of an item, when `itemTitle` isn't enough. */\n    getLabel?: (item: Item, resource: string) => string;\n    /**\n     * Lets the picker create items, with the adapter's `create()`. `true` sets the typed text as the\n     * value of the resource's `itemTitle` field (in every locale of the definition when it is\n     * localized), on the resources that allow `create`. A function gives the values of the new item\n     * instead, or `null` for a resource where items can't be created.\n     */\n    create?: boolean | ((text: string, resource: string) => Record<string, unknown> | null);\n}\n\nfunction labelOf(value: unknown, locale?: string): string | null {\n    if (typeof value === 'string' || typeof value === 'number') {\n        return String(value);\n    }\n    if (value !== null && typeof value === 'object') {\n        const localized = value as Record<string, unknown>;\n        const first =\n            (locale !== undefined ? localized[locale] : undefined) ?? Object.values(localized)[0];\n        return typeof first === 'string' ? first : null;\n    }\n    return null;\n}\n\n/**\n * A relation source over an adapter, such as the `DataAdapter` of `@panneau/data`: a search is a\n * list query with `q`, ids are resolved with `get()`, and, with the `create` option, items are\n * created with `create()`. Labels come from the resource's `itemTitle`.\n */\nexport function createRelationSource(\n    adapter: RelationListAdapter,\n    { definition = null, perPage = 20, getLabel, create }: RelationSourceOptions = {},\n): RelationSource {\n    const resourceOf = (resource: string) =>\n        definition?.resources.find((candidate) => candidate.id === resource);\n    const toReference = (item: Item, resource: string): RelationReference => {\n        const titleField = resourceOf(resource)?.itemTitle;\n        return {\n            id: item.id,\n            label:\n                getLabel?.(item, resource) ??\n                (titleField !== undefined ? labelOf(item[titleField]) : null) ??\n                item.id,\n        };\n    };\n    const valuesOf = (text: string, resource: string): Record<string, unknown> | null => {\n        if (typeof create === 'function') {\n            return create(text, resource);\n        }\n        const definitionResource = resourceOf(resource);\n        const titleField = definitionResource?.itemTitle;\n        if (definitionResource === undefined || titleField === undefined) {\n            return null;\n        }\n        const field = definitionResource.fields.find((candidate) => candidate.name === titleField);\n        const locales = definition?.locales ?? [];\n        return {\n            [titleField]:\n                field?.localized === true && locales.length > 0\n                    ? Object.fromEntries(locales.map((locale) => [locale, text]))\n                    : text,\n        };\n    };\n    const source: RelationSource = {\n        async search(resource, query, { signal }) {\n            const response = await adapter.list(\n                resource,\n                { page: 1, perPage, ...(query !== '' ? { q: query } : {}) },\n                { signal },\n            );\n            return response.data.map((item) => toReference(item, resource));\n        },\n    };\n    const { get, create: createItem } = adapter;\n    if (get !== undefined) {\n        source.resolve = async (resource, ids, { signal }) => {\n            const results = await Promise.allSettled(\n                ids.map((id) => get.call(adapter, resource, id, { signal })),\n            );\n            return results.flatMap((result) =>\n                result.status === 'fulfilled' ? [toReference(result.value, resource)] : [],\n            );\n        };\n    }\n    if (create !== undefined && create !== false && createItem !== undefined) {\n        source.canCreate = (resource) =>\n            resourceOf(resource)?.abilities?.create !== false && valuesOf('', resource) !== null;\n        source.create = async (resource, text) => {\n            const values = valuesOf(text, resource);\n            if (values === null) {\n                return null;\n            }\n            return toReference(await createItem.call(adapter, resource, values), resource);\n        };\n    }\n    return source;\n}\n\n/** Reads relation values: references, ids, or lists of them. */\nexport function toReferences(value: unknown): RelationReference[] {\n    const list = Array.isArray(value)\n        ? value\n        : value === null || value === undefined\n          ? []\n          : [value];\n    return list.flatMap((entry: unknown) => {\n        if (typeof entry === 'string' || typeof entry === 'number') {\n            return [{ id: String(entry), label: String(entry) }];\n        }\n        if (entry !== null && typeof entry === 'object' && 'id' in entry) {\n            const { id, label } = entry as { id: unknown; label?: unknown };\n            if (typeof id === 'string' || typeof id === 'number') {\n                return [{ id: String(id), label: typeof label === 'string' ? label : String(id) }];\n            }\n        }\n        return [];\n    });\n}\n\ninterface ResolvedLabels {\n    /** Labels by resource and id: `null` for ids that the source didn't find. */\n    labels: Map<string, string | null>;\n    /** Requests in flight, so that fields with the same ids share one. */\n    pending: Map<string, Promise<void>>;\n}\n\nconst resolved = new WeakMap<RelationSource, ResolvedLabels>();\n\nfunction resolvedOf(source: RelationSource): ResolvedLabels {\n    let entry = resolved.get(source);\n    if (entry === undefined) {\n        entry = { labels: new Map(), pending: new Map() };\n        resolved.set(source, entry);\n    }\n    return entry;\n}\n\nconst keyOf = (resource: string, id: string) => `${resource}\\u0000${id}`;\n\n/** Resolves the ids that no request has resolved or is resolving yet, and waits for all of them. */\nfunction resolveIds(source: RelationSource, resource: string, ids: readonly string[]) {\n    const { labels, pending } = resolvedOf(source);\n    const fresh = ids.filter((id) => !pending.has(keyOf(resource, id)));\n    if (fresh.length > 0 && source.resolve !== undefined) {\n        // Shared by every field that asks for these ids: it isn't aborted when one unmounts.\n        const request = source\n            .resolve(resource, fresh, { signal: new AbortController().signal })\n            .then(\n                (found) => {\n                    fresh.forEach((id) =>\n                        labels.set(\n                            keyOf(resource, id),\n                            found.find((candidate) => candidate.id === id)?.label ?? null,\n                        ),\n                    );\n                },\n                () => {\n                    // Tried again the next time a field shows these ids.\n                    fresh.forEach((id) => pending.delete(keyOf(resource, id)));\n                },\n            );\n        fresh.forEach((id) => pending.set(keyOf(resource, id), request));\n    }\n    return Promise.all(ids.map((id) => pending.get(keyOf(resource, id))));\n}\n\n/**\n * Relation references with the labels of plain ids: references whose label is their id (from\n * `\"12\"`) are resolved with the source's `resolve()`, once per source, resource and id. They keep\n * their id as label until then, or when the source doesn't find them.\n */\nexport function useRelationReferences(\n    source: RelationSource | null,\n    resource: string,\n    references: readonly RelationReference[],\n): RelationReference[] {\n    const cache = source !== null ? resolvedOf(source).labels : null;\n    const [labels, setLabels] = useState<Readonly<Record<string, string>>>({});\n    const label = (id: string): string | undefined =>\n        labels[keyOf(resource, id)] ?? cache?.get(keyOf(resource, id)) ?? undefined;\n    const missing =\n        source?.resolve !== undefined && cache !== null\n            ? references\n                  .filter((reference) => reference.label === reference.id)\n                  .map((reference) => reference.id)\n                  .filter((id) => !cache.has(keyOf(resource, id)))\n            : [];\n    const missingKey = missing.join('\\u0000');\n\n    useEffect(() => {\n        const ids = missingKey === '' ? [] : missingKey.split('\\u0000');\n        if (source === null || cache === null || ids.length === 0) {\n            return undefined;\n        }\n        let active = true;\n        void resolveIds(source, resource, ids).then(() => {\n            if (!active) {\n                return;\n            }\n            const next: Record<string, string> = {};\n            ids.forEach((id) => {\n                const found = cache.get(keyOf(resource, id));\n                if (typeof found === 'string') {\n                    next[keyOf(resource, id)] = found;\n                }\n            });\n            setLabels((current) => ({ ...current, ...next }));\n        });\n        return () => {\n            active = false;\n        };\n    }, [source, cache, resource, missingKey]);\n\n    return references.map((reference) =>\n        reference.label === reference.id\n            ? { id: reference.id, label: label(reference.id) ?? reference.id }\n            : reference,\n    );\n}\n"],"mappings":"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"}
+{"version":3,"file":"relation.js","names":["useEffect","useState","Definition","Item","ListQuery","RelationReference","id","label","RelationSource","search","resource","query","options","signal","AbortSignal","Promise","resolve","ids","create","text","canCreate","RelationListAdapter","list","data","get","values","Record","RelationSourceOptions","definition","Pick","Partial","perPage","getLabel","item","labelOf","value","locale","String","localized","first","undefined","Object","createRelationSource","adapter","resourceOf","resources","find","candidate","toReference","titleField","itemTitle","valuesOf","definitionResource","field","fields","name","locales","length","fromEntries","map","source","response","page","q","createItem","results","allSettled","call","flatMap","result","status","abilities","toReferences","Array","isArray","entry","ResolvedLabels","labels","Map","pending","resolved","WeakMap","resolvedOf","set","keyOf","resolveIds","fresh","filter","has","request","AbortController","then","found","forEach","delete","all","useRelationReferences","references","$","_c","cache","t0","Symbol","for","setLabels","missing","_temp","_temp2","id_0","missingKey","join","split","active","next","id_1","current","reference_1","reference","reference_0","_c"],"sources":["../../src/shared/relation.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { Definition, Item, ListQuery } from '@panneau/protocol';\n\n/** A related item: its id, and a label to show it. The value of a relation field. */\nexport interface RelationReference {\n    id: string;\n    label: string;\n}\n\n/** Where relation fields search for items. */\nexport interface RelationSource {\n    /** Items of a resource that match a text, for the picker. */\n    search(\n        resource: string,\n        query: string,\n        options: { signal: AbortSignal },\n    ): Promise<RelationReference[]>;\n    /**\n     * The references of items by id, for values that are only ids (`\"12\"`, `[\"12\", \"13\"]`), as a\n     * product's own API gives them. In any order; ids it doesn't find are left out, and keep their\n     * id as label. Without it, fields show the ids.\n     */\n    resolve?(\n        resource: string,\n        ids: readonly string[],\n        options: { signal: AbortSignal },\n    ): Promise<RelationReference[]>;\n    /**\n     * Creates an item from the text typed in the picker, which offers \"Create “…”\" when this\n     * method exists. It can open a dialog, and resolves with the reference of the new item, or with\n     * `null` when nothing was created.\n     */\n    create?(resource: string, text: string): Promise<RelationReference | null>;\n    /** Whether `create()` can create items of a resource. Defaults to true. */\n    canCreate?(resource: string): boolean;\n}\n\n/** What `createRelationSource()` needs from an adapter: the `list()`, `get()` and `create()` of `@panneau/data`. */\nexport interface RelationListAdapter {\n    list(\n        resource: string,\n        query?: ListQuery,\n        options?: { signal?: AbortSignal },\n    ): Promise<{ data: Item[] }>;\n    /** One item, for `resolve()`. Without it, the source doesn't resolve ids. */\n    get?(resource: string, id: string, options?: { signal?: AbortSignal }): Promise<Item>;\n    /** Creates an item, for `create()`. */\n    create?(resource: string, values: Record<string, unknown>): Promise<Item>;\n}\n\nexport interface RelationSourceOptions {\n    /** The definition, for the field that titles the items of each resource (`itemTitle`). */\n    definition?: (Pick<Definition, 'resources'> & Partial<Pick<Definition, 'locales'>>) | null;\n    /** Items per search. Defaults to 20. */\n    perPage?: number;\n    /** The label of an item, when `itemTitle` isn't enough. */\n    getLabel?: (item: Item, resource: string) => string;\n    /**\n     * Lets the picker create items, with the adapter's `create()`. `true` sets the typed text as the\n     * value of the resource's `itemTitle` field (in every locale of the definition when it is\n     * localized), on the resources that allow `create`. A function gives the values of the new item\n     * instead, or `null` for a resource where items can't be created.\n     */\n    create?: boolean | ((text: string, resource: string) => Record<string, unknown> | null);\n}\n\nfunction labelOf(value: unknown, locale?: string): string | null {\n    if (typeof value === 'string' || typeof value === 'number') {\n        return String(value);\n    }\n    if (value !== null && typeof value === 'object') {\n        const localized = value as Record<string, unknown>;\n        const first =\n            (locale !== undefined ? localized[locale] : undefined) ?? Object.values(localized)[0];\n        return typeof first === 'string' ? first : null;\n    }\n    return null;\n}\n\n/**\n * A relation source over an adapter, such as the `DataAdapter` of `@panneau/data`: a search is a\n * list query with `q`, ids are resolved with `get()`, and, with the `create` option, items are\n * created with `create()`. Labels come from the resource's `itemTitle`.\n */\nexport function createRelationSource(\n    adapter: RelationListAdapter,\n    { definition = null, perPage = 20, getLabel, create }: RelationSourceOptions = {},\n): RelationSource {\n    const resourceOf = (resource: string) =>\n        definition?.resources.find((candidate) => candidate.id === resource);\n    const toReference = (item: Item, resource: string): RelationReference => {\n        const titleField = resourceOf(resource)?.itemTitle;\n        return {\n            id: item.id,\n            label:\n                getLabel?.(item, resource) ??\n                (titleField !== undefined ? labelOf(item[titleField]) : null) ??\n                item.id,\n        };\n    };\n    const valuesOf = (text: string, resource: string): Record<string, unknown> | null => {\n        if (typeof create === 'function') {\n            return create(text, resource);\n        }\n        const definitionResource = resourceOf(resource);\n        const titleField = definitionResource?.itemTitle;\n        if (definitionResource === undefined || titleField === undefined) {\n            return null;\n        }\n        const field = definitionResource.fields.find((candidate) => candidate.name === titleField);\n        const locales = definition?.locales ?? [];\n        return {\n            [titleField]:\n                field?.localized === true && locales.length > 0\n                    ? Object.fromEntries(locales.map((locale) => [locale, text]))\n                    : text,\n        };\n    };\n    const source: RelationSource = {\n        async search(resource, query, { signal }) {\n            const response = await adapter.list(\n                resource,\n                { page: 1, perPage, ...(query !== '' ? { q: query } : {}) },\n                { signal },\n            );\n            return response.data.map((item) => toReference(item, resource));\n        },\n    };\n    const { get, create: createItem } = adapter;\n    if (get !== undefined) {\n        source.resolve = async (resource, ids, { signal }) => {\n            const results = await Promise.allSettled(\n                ids.map((id) => get.call(adapter, resource, id, { signal })),\n            );\n            return results.flatMap((result) =>\n                result.status === 'fulfilled' ? [toReference(result.value, resource)] : [],\n            );\n        };\n    }\n    if (create !== undefined && create !== false && createItem !== undefined) {\n        source.canCreate = (resource) =>\n            resourceOf(resource)?.abilities?.create !== false && valuesOf('', resource) !== null;\n        source.create = async (resource, text) => {\n            const values = valuesOf(text, resource);\n            if (values === null) {\n                return null;\n            }\n            return toReference(await createItem.call(adapter, resource, values), resource);\n        };\n    }\n    return source;\n}\n\n/** Reads relation values: references, ids, or lists of them. */\nexport function toReferences(value: unknown): RelationReference[] {\n    const list = Array.isArray(value)\n        ? value\n        : value === null || value === undefined\n          ? []\n          : [value];\n    return list.flatMap((entry: unknown) => {\n        if (typeof entry === 'string' || typeof entry === 'number') {\n            return [{ id: String(entry), label: String(entry) }];\n        }\n        if (entry !== null && typeof entry === 'object' && 'id' in entry) {\n            const { id, label } = entry as { id: unknown; label?: unknown };\n            if (typeof id === 'string' || typeof id === 'number') {\n                return [{ id: String(id), label: typeof label === 'string' ? label : String(id) }];\n            }\n        }\n        return [];\n    });\n}\n\ninterface ResolvedLabels {\n    /** Labels by resource and id: `null` for ids that the source didn't find. */\n    labels: Map<string, string | null>;\n    /** Requests in flight, so that fields with the same ids share one. */\n    pending: Map<string, Promise<void>>;\n}\n\nconst resolved = new WeakMap<RelationSource, ResolvedLabels>();\n\nfunction resolvedOf(source: RelationSource): ResolvedLabels {\n    let entry = resolved.get(source);\n    if (entry === undefined) {\n        entry = { labels: new Map(), pending: new Map() };\n        resolved.set(source, entry);\n    }\n    return entry;\n}\n\nconst keyOf = (resource: string, id: string) => `${resource}\\u0000${id}`;\n\n/** Resolves the ids that no request has resolved or is resolving yet, and waits for all of them. */\nfunction resolveIds(source: RelationSource, resource: string, ids: readonly string[]) {\n    const { labels, pending } = resolvedOf(source);\n    const fresh = ids.filter((id) => !pending.has(keyOf(resource, id)));\n    if (fresh.length > 0 && source.resolve !== undefined) {\n        // Shared by every field that asks for these ids: it isn't aborted when one unmounts.\n        const request = source\n            .resolve(resource, fresh, { signal: new AbortController().signal })\n            .then(\n                (found) => {\n                    fresh.forEach((id) =>\n                        labels.set(\n                            keyOf(resource, id),\n                            found.find((candidate) => candidate.id === id)?.label ?? null,\n                        ),\n                    );\n                },\n                () => {\n                    // Tried again the next time a field shows these ids.\n                    fresh.forEach((id) => pending.delete(keyOf(resource, id)));\n                },\n            );\n        fresh.forEach((id) => pending.set(keyOf(resource, id), request));\n    }\n    return Promise.all(ids.map((id) => pending.get(keyOf(resource, id))));\n}\n\n/**\n * Relation references with the labels of plain ids: references whose label is their id (from\n * `\"12\"`) are resolved with the source's `resolve()`, once per source, resource and id. They keep\n * their id as label until then, or when the source doesn't find them.\n */\nexport function useRelationReferences(\n    source: RelationSource | null,\n    resource: string,\n    references: readonly RelationReference[],\n): RelationReference[] {\n    const cache = source !== null ? resolvedOf(source).labels : null;\n    const [labels, setLabels] = useState<Readonly<Record<string, string>>>({});\n    const label = (id: string): string | undefined =>\n        labels[keyOf(resource, id)] ?? cache?.get(keyOf(resource, id)) ?? undefined;\n    const missing =\n        source?.resolve !== undefined && cache !== null\n            ? references\n                  .filter((reference) => reference.label === reference.id)\n                  .map((reference) => reference.id)\n                  .filter((id) => !cache.has(keyOf(resource, id)))\n            : [];\n    const missingKey = missing.join('\\u0000');\n\n    useEffect(() => {\n        const ids = missingKey === '' ? [] : missingKey.split('\\u0000');\n        if (source === null || cache === null || ids.length === 0) {\n            return undefined;\n        }\n        let active = true;\n        void resolveIds(source, resource, ids).then(() => {\n            if (!active) {\n                return;\n            }\n            const next: Record<string, string> = {};\n            ids.forEach((id) => {\n                const found = cache.get(keyOf(resource, id));\n                if (typeof found === 'string') {\n                    next[keyOf(resource, id)] = found;\n                }\n            });\n            setLabels((current) => ({ ...current, ...next }));\n        });\n        return () => {\n            active = false;\n        };\n    }, [source, cache, resource, missingKey]);\n\n    return references.map((reference) =>\n        reference.label === reference.id\n            ? { id: reference.id, label: label(reference.id) ?? reference.id }\n            : reference,\n    );\n}\n"],"mappings":"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"}

package/dist/shared/types.d.ts

@@ -43,6 +43,8 @@ export interface FieldEntryProps {
     readOnly?: boolean;
     /** The object the field belongs to: the form's values, or a group or a block. */
     parentValue?: unknown;
+    /** The locale of the value: the input of a locale of a localized field. */
+    locale?: string;
     className?: string;
 }
 /** A registry entry: renders the field of a type from its definition. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACrC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC5B,iDAAiD;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,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;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACrC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC5B,iDAAiD;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,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;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC"}

package/dist/slug/SlugField.css

@@ -0,0 +1,18 @@
+.panneau-slug-field-description {
+    display: flex;
+    flex-direction: column;
+    gap: var(--panneau-space-1);
+}
+
+.panneau-slug-field-url {
+    overflow-wrap: anywhere;
+    color: var(--panneau-color-link);
+}
+
+.panneau-slug-field-taken {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--panneau-space-2);
+    color: var(--panneau-color-warning);
+}

package/dist/slug/SlugField.d.ts

@@ -1,10 +1,15 @@
-import type { FieldEntryProps } from '../shared/types';
-import { type TextFieldProps } from '../text/TextField';
+import type { FieldCheckResponse } from '@panneau/protocol';
+import type { FieldEntryProps } from '../shared/types.js';
+import { type TextFieldProps } from '../text/TextField.js';
 /**
  * Turns a text into a slug: lowercase ASCII letters and digits separated by dashes, without
  * accents (`Été à Montréal` gives `ete-a-montreal`).
  */
 export declare function slugify(text: string): string;
+/** Checks a slug with the backend: whether it is available, and its URL. */
+export type SlugCheck = (value: string, options: {
+    signal: AbortSignal;
+}) => Promise<FieldCheckResponse>;
 export interface SlugFieldProps extends Omit<TextFieldProps, 'type' | 'suffix'> {
     /**
      * The text the slug is made from (a title). While the slug is empty or still matches it, the
@@ -13,12 +18,35 @@ export interface SlugFieldProps extends Omit<TextFieldProps, 'type' | 'suffix'>
     source?: string | null;
     /** Name of the source, for the button that generates the slug from it. */
     sourceLabel?: string;
+    /**
+     * Checks the slug as it is typed, and once when the field shows: the field then shows the
+     * URL the backend gives, and says when the slug is taken, with a free one to use instead.
+     */
+    onCheck?: SlugCheck | null;
+    /** How long typing must pause before a check, in milliseconds. Defaults to 300. */
+    checkDelay?: number;
+    /**
+     * What the check depends on besides the slug, such as the form's values: the slug is checked
+     * again when it changes. `onCheck` itself can change on every render.
+     */
+    checkKey?: string;
 }
 /**
  * A slug for URLs. Typed text is cleaned up on blur. With a `source`, the slug follows it until
- * it is edited, and a button generates it again.
+ * it is edited, and a button generates it again. With `onCheck`, the backend says whether the
+ * slug is taken, and gives its URL.
+ */
+export declare function SlugField({ value, onChange, onBlur, source, sourceLabel, onCheck, checkDelay, checkKey, disabled, readOnly, prefix, errors, description, ...props }: SlugFieldProps): import("react").JSX.Element;
+/**
+ * The text of a source value: the value itself, or for a localized value, its value in `locale`.
+ * Without a locale, the first locale that has a value.
+ */
+export declare function sourceText(value: unknown, locale?: string): string | null;
+/**
+ * The `slug` type: `from` names the field it follows, in the slug's own locale, or in the default
+ * locale (the first of the fields context) for a slug that isn't localized. Setting `prefix`
+ * shows a URL prefix. With `check`, the fields context's check source checks the slug of a field
+ * at the top of the resource, with the form's values.
  */
-export declare function SlugField({ value, onChange, onBlur, source, sourceLabel, disabled, readOnly, ...props }: SlugFieldProps): import("react").JSX.Element;
-/** The `slug` type: `from` names the field it follows, and setting `prefix` shows a URL prefix. */
 export declare function SlugFieldEntry(props: FieldEntryProps): import("react").JSX.Element;
 //# sourceMappingURL=SlugField.d.ts.map

package/dist/slug/SlugField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SlugField.d.ts","sourceRoot":"","sources":["../../src/slug/SlugField.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3E;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,GAAG,KAAK,EACX,EAAE,cAAc,+BAqDhB;AAcD,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,+BAgBpD"}
+{"version":3,"file":"SlugField.d.ts","sourceRoot":"","sources":["../../src/slug/SlugField.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMnE;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,CACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEjC,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3E;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AA4CD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,WAAW,EACX,OAAO,EACP,UAAgB,EAChB,QAAa,EACb,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,WAAW,EACX,GAAG,KAAK,EACX,EAAE,cAAc,+BA4FhB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAazE;AAeD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,+BAqCpD"}