@panneau/fields 5.0.0-alpha.2 → 5.0.0-alpha.20

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","invalidPaths","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     * Paths inside the field that have errors (`title.en`), for fields that show their nested\n     * fields themselves: a localized field marks its locales in error.\n     */\n    invalidPaths?: 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":";;;;AA+DA,IAAMmC,gBAAgBjC,cAAkC;CACpDuB,YAAY,CAAC;CACbG,SAAS,CAAA;CACTC,gBAAgB;CAChBC,cAAc;CACdC,aAAa;CACbC,aAAa;CACbC,MAAM;CACNC,SAAS;AACb,CAAC;;AAGD,SAAgBE,mBAAuC;CACnD,OAAOjC,IAAIgC,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,SAAexC,IAAIgC,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,MAAA7B,QAAkCyC;CAUhC,IAAAC;CAAA,IAAAb,EAAA,QAAAH,YAAAG,EAAA,QAAA7B,OAAA;EACK0C,MAAA,oBAAC,eAAD;GAAsB1C;GAAQ0B;EAAhB,CAAA;EAAyCG,EAAA,MAAAH;EAAAG,EAAA,MAAA7B;EAAA6B,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

@@ -1,7 +1,7 @@
 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) {
+function toCalendarDate$1(value) {
 	const match = value?.match(/^(\d{4}-\d{2}-\d{2})/);
 	if (match?.[1] === void 0) return null;
 	try {
@@ -44,6 +44,6 @@ function fromTime(value, withSeconds = false) {
 	return withSeconds ? `${time}:${pad(value.second)}` : time;
 }
 //#endregion
-export { fromDateTime, fromTime, toCalendarDate, toDateTime, toTime };
+export { fromDateTime, fromTime, toCalendarDate$1 as toCalendarDate, toDateTime, toTime };
 
 //# sourceMappingURL=dates.js.map

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","toCalendarDate"],"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,iBAAeC,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,15 +13,20 @@ 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
- * without one), help, required mark, read-only, errors and handlers. Plugins use it to write their
- * own entries.
+ * without one, or `aria-label` with `hideLabel`), 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;
+/** 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,CAkB1E;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,28 +22,41 @@ 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
-* without one), help, required mark, read-only, errors and handlers. Plugins use it to write their
-* own entries.
+* without one, or `aria-label` with `hideLabel`), help, required mark, read-only, errors and
+* handlers. Plugins use it to write their own entries.
 */
 function getFieldProps(props) {
 	const { field } = props;
+	const label = field.label ?? field.name;
 	return {
 		name: props.path,
-		label: field.label ?? field.name,
+		...props.hideLabel === true ? { "aria-label": label } : { label },
 		description: field.help,
 		...field.placeholder !== void 0 ? { placeholder: field.placeholder } : {},
 		required: isRequired(field),
-		readOnly: props.readOnly === true || field.readOnly === true,
+		readOnly: props.readOnly === true || field.readOnly === true || field.abilities?.update === false,
 		disabled: props.disabled === true,
 		errors: props.errors ?? [],
 		...props.onBlur !== void 0 ? { onBlur: props.onBlur } : {},
 		...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","label","path","hideLabel","description","help","required","readOnly","abilities","update","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, or `aria-label` with `hideLabel`), help, required mark, read-only, errors and\n * handlers. Plugins use it to write their own entries.\n */\nexport function getFieldProps(\n    props: FieldEntryProps,\n): Omit<FieldProps<never>, 'value' | 'onChange'> & { placeholder?: string } {\n    const { field } = props;\n    // A field always has a label: its name when the definition gives none.\n    const label = field.label ?? field.name;\n    return {\n        name: props.path,\n        ...(props.hideLabel === true ? { 'aria-label': label } : { label }),\n        description: field.help,\n        ...(field.placeholder !== undefined ? { placeholder: field.placeholder } : {}),\n        required: isRequired(field),\n        // A field the user can't edit is read-only (`abilities.update: false`, decision 0046)\n        readOnly:\n            props.readOnly === true || field.readOnly === true || field.abilities?.update === false,\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;CAElB,MAAMG,QAAQzB,MAAMyB,SAASzB,MAAMY;CACnC,OAAO;EACHA,MAAMU,MAAMI;EACZ,GAAIJ,MAAMK,cAAc,OAAO,EAAE,cAAcF,MAAM,IAAI,EAAEA,MAAM;EACjEG,aAAa5B,MAAM6B;EACnB,GAAI7B,MAAMwB,gBAAgBlB,KAAAA,IAAY,EAAEkB,aAAaxB,MAAMwB,YAAY,IAAI,CAAC;EAC5EM,UAAUpB,WAAWV,KAAK;EAE1B+B,UACIT,MAAMS,aAAa,QAAQ/B,MAAM+B,aAAa,QAAQ/B,MAAMgC,WAAWC,WAAW;EACtFC,UAAUZ,MAAMY,aAAa;EAC7BC,QAAQb,MAAMa,UAAU,CAAA;EACxB,GAAIb,MAAMc,WAAW9B,KAAAA,IAAY,EAAE8B,QAAQd,MAAMc,OAAO,IAAI,CAAC;EAC7D,GAAId,MAAMe,cAAc/B,KAAAA,IAAY,EAAE+B,WAAWf,MAAMe,UAAU,IAAI,CAAC;CAC1E;AACJ;;AAQA,SAAgBE,UAAUvC,OAA+B;CACrD,IAAIA,MAAMwC,WAAWlC,KAAAA,KAAaN,MAAMwC,OAAOC,SAAS,GACpD,OAAOzC,MAAMwC;CAEjB,MAAMvC,OAAOF,SAASC,OAAO,QAAQ;CACrC,OAAOC,SAASK,KAAAA,KAAa,WAAWL,QAAQyC,MAAMC,QAAQ1C,KAAKQ,KAAK,IAClER,KAAKQ,MAAMmC,OAAO5B,QAAQ,IAC1B;AACV;;AAGA,SAAgB6B,WAAW7C,OAA6B;CACpD,MAAMC,OAAOF,SAASC,OAAO,SAAS;CACtC,OAAOC,SAASK,KAAAA,KAAa,WAAWL,QAAQiB,SAASjB,KAAKQ,KAAK,IAAIR,KAAKQ,QAAQ;AACxF"}

package/dist/shared/flow.d.ts

@@ -0,0 +1,8 @@
+import type { Field } from '@panneau/protocol';
+/**
+ * Whether a field takes a whole row where fields flow in columns, such as in a form without a
+ * layout or in a group: long inputs (a text area, rich text, blocks), several values, a value per
+ * locale, and the types of plugins. Short inputs share a row.
+ */
+export declare function isWideField(field: Field): boolean;
+//# sourceMappingURL=flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/shared/flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA0B/C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CASjD"}

package/dist/shared/flow.js

@@ -0,0 +1,38 @@
+import { getSetting, isString } from "./entry.js";
+//#region src/shared/flow.ts
+/** Types whose input is short: they share a row with others in a flow of fields. */
+var COMPACT_TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"email",
+	"url",
+	"tel",
+	"country",
+	"region",
+	"money",
+	"number",
+	"date",
+	"datetime",
+	"time",
+	"duration",
+	"color",
+	"select",
+	"boolean",
+	"range",
+	"slug",
+	"relation"
+]);
+/**
+* Whether a field takes a whole row where fields flow in columns, such as in a form without a
+* layout or in a group: long inputs (a text area, rich text, blocks), several values, a value per
+* locale, and the types of plugins. Short inputs share a row.
+*/
+function isWideField(field) {
+	if (field.localized === true || field.multiple === true) return true;
+	const widget = getSetting(field, "widget", isString);
+	if (field.type === "select" && widget !== void 0 && widget !== "dropdown") return true;
+	return !COMPACT_TYPES.has(field.type);
+}
+//#endregion
+export { isWideField };
+
+//# sourceMappingURL=flow.js.map

package/dist/shared/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","names":["Field","getSetting","isString","COMPACT_TYPES","Set","isWideField","field","localized","multiple","widget","type","undefined","has"],"sources":["../../src/shared/flow.ts"],"sourcesContent":["import type { Field } from '@panneau/protocol';\n\nimport { getSetting, isString } from './entry';\n\n/** Types whose input is short: they share a row with others in a flow of fields. */\nconst COMPACT_TYPES = new Set([\n    'text',\n    'email',\n    'url',\n    'tel',\n    'country',\n    'region',\n    'money',\n    'number',\n    'date',\n    'datetime',\n    'time',\n    'duration',\n    'color',\n    'select',\n    'boolean',\n    'range',\n    'slug',\n    'relation',\n]);\n\n/**\n * Whether a field takes a whole row where fields flow in columns, such as in a form without a\n * layout or in a group: long inputs (a text area, rich text, blocks), several values, a value per\n * locale, and the types of plugins. Short inputs share a row.\n */\nexport function isWideField(field: Field): boolean {\n    if (field.localized === true || field.multiple === true) {\n        return true;\n    }\n    const widget = getSetting(field, 'widget', isString);\n    if (field.type === 'select' && widget !== undefined && widget !== 'dropdown') {\n        return true;\n    }\n    return !COMPACT_TYPES.has(field.type);\n}\n"],"mappings":";;;AAKA,IAAMG,gCAAgB,IAAIC,IAAI;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AAAU,CACb;;;;;;AAOD,SAAgBC,YAAYC,OAAuB;CAC/C,IAAIA,MAAMC,cAAc,QAAQD,MAAME,aAAa,MAC/C,OAAO;CAEX,MAAMC,SAASR,WAAWK,OAAO,UAAUJ,QAAQ;CACnD,IAAII,MAAMI,SAAS,YAAYD,WAAWE,KAAAA,KAAaF,WAAW,YAC9D,OAAO;CAEX,OAAO,CAACN,cAAcS,IAAIN,MAAMI,IAAI;AACxC"}

package/dist/shared/part.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+import type { Field } from '@panneau/protocol';
+/** What a part of a value gets from the binding of the fields context: its errors and its blur. */
+export interface BoundPartProps {
+    errors?: readonly string[];
+    onBlur?: () => void;
+}
+export interface PartBindingProps {
+    /** The part, as a field of the definition: the binding reads its errors by its path. */
+    field: Field;
+    /** Dot path of the part (`address.postalCode`). */
+    path: string;
+    /** Errors of the part without a binding. */
+    errors?: readonly string[];
+    /** Blur of the part without a binding. */
+    onBlur?: () => void;
+    render: (bound: BoundPartProps) => ReactNode;
+}
+/**
+ * A part of a value that a field edits itself (the postal code of an address, the URL of a link):
+ * the field keeps its whole value, and the binding of the fields context gives each part the
+ * errors of its own path, and marks it touched when it loses focus. Without a binding, the part
+ * gets `errors` and `onBlur`.
+ */
+export declare function BoundPart({ field, path, errors, onBlur, render }: PartBindingProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+//# sourceMappingURL=part.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../src/shared/part.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,wFAAwF;IACxF,KAAK,EAAE,KAAK,CAAC;IACb,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,gBAAgB,+TAqBlF"}

package/dist/shared/part.js

@@ -0,0 +1,64 @@
+import { getParentPath, useFieldsContext } from "./context.js";
+import { c } from "react/compiler-runtime";
+import { jsx } from "react/jsx-runtime";
+//#region src/shared/part.tsx
+/**
+* A part of a value that a field edits itself (the postal code of an address, the URL of a link):
+* the field keeps its whole value, and the binding of the fields context gives each part the
+* errors of its own path, and marks it touched when it loses focus. Without a binding, the part
+* gets `errors` and `onBlur`.
+*/
+function BoundPart(t0) {
+	const $ = c(14);
+	const { field, path, errors, onBlur, render } = t0;
+	const { binding: Binding } = useFieldsContext();
+	if (Binding === null) {
+		let t1;
+		if ($[0] !== errors || $[1] !== onBlur || $[2] !== render) {
+			t1 = render({
+				...errors !== void 0 ? { errors } : {},
+				...onBlur !== void 0 ? { onBlur } : {}
+			});
+			$[0] = errors;
+			$[1] = onBlur;
+			$[2] = render;
+			$[3] = t1;
+		} else t1 = $[3];
+		return t1;
+	}
+	let t1;
+	if ($[4] !== path) {
+		t1 = getParentPath(path);
+		$[4] = path;
+		$[5] = t1;
+	} else t1 = $[5];
+	let t2;
+	if ($[6] !== render) {
+		t2 = (bound) => render({
+			...bound.errors !== void 0 ? { errors: bound.errors } : {},
+			...bound.onBlur !== void 0 ? { onBlur: bound.onBlur } : {}
+		});
+		$[6] = render;
+		$[7] = t2;
+	} else t2 = $[7];
+	let t3;
+	if ($[8] !== Binding || $[9] !== field || $[10] !== path || $[11] !== t1 || $[12] !== t2) {
+		t3 = /* @__PURE__ */ jsx(Binding, {
+			field,
+			path,
+			parentPath: t1,
+			render: t2
+		});
+		$[8] = Binding;
+		$[9] = field;
+		$[10] = path;
+		$[11] = t1;
+		$[12] = t2;
+		$[13] = t3;
+	} else t3 = $[13];
+	return t3;
+}
+//#endregion
+export { BoundPart };
+
+//# sourceMappingURL=part.js.map

package/dist/shared/part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.js","names":["ReactNode","Field","getParentPath","useFieldsContext","BoundPartProps","errors","onBlur","PartBindingProps","field","path","render","bound","BoundPart","t0","$","_c","binding","Binding","t1","undefined","t2","t3","_c"],"sources":["../../src/shared/part.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport type { Field } from '@panneau/protocol';\n\nimport { getParentPath, useFieldsContext } from './context';\n\n/** What a part of a value gets from the binding of the fields context: its errors and its blur. */\nexport interface BoundPartProps {\n    errors?: readonly string[];\n    onBlur?: () => void;\n}\n\nexport interface PartBindingProps {\n    /** The part, as a field of the definition: the binding reads its errors by its path. */\n    field: Field;\n    /** Dot path of the part (`address.postalCode`). */\n    path: string;\n    /** Errors of the part without a binding. */\n    errors?: readonly string[];\n    /** Blur of the part without a binding. */\n    onBlur?: () => void;\n    render: (bound: BoundPartProps) => ReactNode;\n}\n\n/**\n * A part of a value that a field edits itself (the postal code of an address, the URL of a link):\n * the field keeps its whole value, and the binding of the fields context gives each part the\n * errors of its own path, and marks it touched when it loses focus. Without a binding, the part\n * gets `errors` and `onBlur`.\n */\nexport function BoundPart({ field, path, errors, onBlur, render }: PartBindingProps) {\n    const { binding: Binding } = useFieldsContext();\n    if (Binding === null) {\n        return render({\n            ...(errors !== undefined ? { errors } : {}),\n            ...(onBlur !== undefined ? { onBlur } : {}),\n        });\n    }\n    return (\n        <Binding\n            field={field}\n            path={path}\n            parentPath={getParentPath(path)}\n            render={(bound) =>\n                render({\n                    ...(bound.errors !== undefined ? { errors: bound.errors } : {}),\n                    ...(bound.onBlur !== undefined ? { onBlur: bound.onBlur } : {}),\n                })\n            }\n        />\n    );\n}\n"],"mappings":";;;;;;;;;;AA8BA,SAAOY,UAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAmB,MAAA,EAAAP,OAAAC,MAAAJ,QAAAC,QAAAI,WAAAG;CACtB,MAAA,EAAAG,SAAAC,YAA6Bd,iBAAiB;CAC9C,IAAIc,YAAY,MAAI;EAAA,IAAAC;EAAA,IAAAJ,EAAA,OAAAT,UAAAS,EAAA,OAAAR,UAAAQ,EAAA,OAAAJ,QAAA;GACTQ,KAAAR,OAAO;IAAA,GACNL,WAAWc,KAAAA,IAAX,EAAAd,OAAqC,IAArC,CAAqC;IAAC,GACtCC,WAAWa,KAAAA,IAAX,EAAAb,OAAqC,IAArC,CAAqC;GAC7C,CAAC;GAACQ,EAAA,KAAAT;GAAAS,EAAA,KAAAR;GAAAQ,EAAA,KAAAJ;GAAAI,EAAA,KAAAI;EAAA,OAAAA,KAAAJ,EAAA;EAAA,OAHKI;CAGL;CACL,IAAAA;CAAA,IAAAJ,EAAA,OAAAL,MAAA;EAKmBS,KAAAhB,cAAcO,IAAI;EAACK,EAAA,KAAAL;EAAAK,EAAA,KAAAI;CAAA,OAAAA,KAAAJ,EAAA;CAAA,IAAAM;CAAA,IAAAN,EAAA,OAAAJ,QAAA;EACvBU,MAAAT,UACJD,OAAO;GAAA,GACCC,MAAKN,WAAYc,KAAAA,IAAjB,EAAAd,QAAuCM,MAAKN,OAAa,IAAzD,CAAyD;GAAC,GAC1DM,MAAKL,WAAYa,KAAAA,IAAjB,EAAAb,QAAuCK,MAAKL,OAAa,IAAzD,CAAyD;EACjE,CAAC;EAACQ,EAAA,KAAAJ;EAAAI,EAAA,KAAAM;CAAA,OAAAA,KAAAN,EAAA;CAAA,IAAAO;CAAA,IAAAP,EAAA,OAAAG,WAAAH,EAAA,OAAAN,SAAAM,EAAA,QAAAL,QAAAK,EAAA,QAAAI,MAAAJ,EAAA,QAAAM,IAAA;EARVC,KAAA,oBAAC,SAAD;GACWb;GACDC;GACM,YAAAS;GACJ,QAAAE;EAIF,CAAA;EAERN,EAAA,KAAAG;EAAAH,EAAA,KAAAN;EAAAM,EAAA,MAAAL;EAAAK,EAAA,MAAAI;EAAAJ,EAAA,MAAAM;EAAAN,EAAA,MAAAO;CAAA,OAAAA,KAAAP,EAAA;CAAA,OAVFO;AAUE"}

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/reveal.d.ts

@@ -0,0 +1,16 @@
+/** Shows what holds a path, such as its tab or its locale, so that its field can be reached. */
+export type Revealer = (path: string) => void;
+/** Where a form asks the containers of its fields to show a path, before it focuses its field. */
+export interface RevealRegistry {
+    add(revealer: Revealer): () => void;
+    reveal(path: string): void;
+}
+export declare function createRevealRegistry(): RevealRegistry;
+/**
+ * The reveal registry of the closest form. Containers that hide fields (tabs, sections, the
+ * locales of a localized field) add a revealer to it.
+ */
+export declare const RevealContext: import("react").Context<RevealRegistry>;
+/** Calls the revealer when the form reveals a path, for as long as the component is mounted. */
+export declare function useRevealer(revealer: Revealer): void;
+//# sourceMappingURL=reveal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../src/shared/reveal.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE9C,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC3B,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;IACpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAarD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,yCAAwD,CAAC;AAEnF,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAIpD"}

package/dist/shared/reveal.js

@@ -0,0 +1,46 @@
+import { c } from "react/compiler-runtime";
+import { createContext, use, useEffect, useEffectEvent } from "react";
+//#region src/shared/reveal.ts
+function createRevealRegistry() {
+	const revealers = /* @__PURE__ */ new Set();
+	return {
+		add(revealer) {
+			revealers.add(revealer);
+			return () => {
+				revealers.delete(revealer);
+			};
+		},
+		reveal(path) {
+			revealers.forEach((revealer) => revealer(path));
+		}
+	};
+}
+/**
+* The reveal registry of the closest form. Containers that hide fields (tabs, sections, the
+* locales of a localized field) add a revealer to it.
+*/
+var RevealContext = createContext(createRevealRegistry());
+/** Calls the revealer when the form reveals a path, for as long as the component is mounted. */
+function useRevealer(revealer) {
+	const $ = c(5);
+	const registry = use(RevealContext);
+	const onReveal = useEffectEvent(revealer);
+	let t0;
+	if ($[0] !== onReveal || $[1] !== registry) {
+		t0 = () => registry.add((path) => onReveal(path));
+		$[0] = onReveal;
+		$[1] = registry;
+		$[2] = t0;
+	} else t0 = $[2];
+	let t1;
+	if ($[3] !== registry) {
+		t1 = [registry];
+		$[3] = registry;
+		$[4] = t1;
+	} else t1 = $[4];
+	useEffect(t0, t1);
+}
+//#endregion
+export { RevealContext, createRevealRegistry, useRevealer };
+
+//# sourceMappingURL=reveal.js.map

package/dist/shared/reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.js","names":["createContext","use","useEffect","useEffectEvent","Revealer","path","RevealRegistry","add","revealer","reveal","createRevealRegistry","revealers","Set","delete","forEach","RevealContext","useRevealer","$","_c","registry","onReveal","t0","t1","_c"],"sources":["../../src/shared/reveal.ts"],"sourcesContent":["import { createContext, use, useEffect, useEffectEvent } from 'react';\n\n/** Shows what holds a path, such as its tab or its locale, so that its field can be reached. */\nexport type Revealer = (path: string) => void;\n\n/** Where a form asks the containers of its fields to show a path, before it focuses its field. */\nexport interface RevealRegistry {\n    add(revealer: Revealer): () => void;\n    reveal(path: string): void;\n}\n\nexport function createRevealRegistry(): RevealRegistry {\n    const revealers = new Set<Revealer>();\n    return {\n        add(revealer) {\n            revealers.add(revealer);\n            return () => {\n                revealers.delete(revealer);\n            };\n        },\n        reveal(path) {\n            revealers.forEach((revealer) => revealer(path));\n        },\n    };\n}\n\n/**\n * The reveal registry of the closest form. Containers that hide fields (tabs, sections, the\n * locales of a localized field) add a revealer to it.\n */\nexport const RevealContext = createContext<RevealRegistry>(createRevealRegistry());\n\n/** Calls the revealer when the form reveals a path, for as long as the component is mounted. */\nexport function useRevealer(revealer: Revealer): void {\n    const registry = use(RevealContext);\n    const onReveal = useEffectEvent(revealer);\n    useEffect(() => registry.add((path) => onReveal(path)), [registry]);\n}\n"],"mappings":";;;AAWA,SAAgBU,uBAAuC;CACnD,MAAMC,4BAAY,IAAIC,IAAc;CACpC,OAAO;EACHL,IAAIC,UAAU;GACVG,UAAUJ,IAAIC,QAAQ;GACtB,aAAa;IACTG,UAAUE,OAAOL,QAAQ;GAC7B;EACJ;EACAC,OAAOJ,MAAM;GACTM,UAAUG,SAASN,aAAaA,SAASH,IAAI,CAAC;EAClD;CACJ;AACJ;;;;;AAMA,IAAaU,gBAAgBf,cAA8BU,qBAAqB,CAAC;;AAGjF,SAAOM,YAAAR,UAAA;CAAA,MAAAS,IAAAC,EAAA,CAAA;CACH,MAAAC,WAAiBlB,IAAIc,aAAa;CAClC,MAAAK,WAAiBjB,eAAeK,QAAQ;CAAE,IAAAa;CAAA,IAAAJ,EAAA,OAAAG,YAAAH,EAAA,OAAAE,UAAA;EAChCE,WAAMF,SAAQZ,KAAKF,SAAUe,SAASf,IAAI,CAAC;EAACY,EAAA,KAAAG;EAAAH,EAAA,KAAAE;EAAAF,EAAA,KAAAI;CAAA,OAAAA,KAAAJ,EAAA;CAAA,IAAAK;CAAA,IAAAL,EAAA,OAAAE,UAAA;EAAEG,KAAA,CAACH,QAAQ;EAACF,EAAA,KAAAE;EAAAF,EAAA,KAAAK;CAAA,OAAAA,KAAAL,EAAA;CAAlEf,UAAUmB,IAA8CC,EAAU;AAAC"}