@panneau/fields 5.0.0-alpha.3 → 5.0.0-alpha.5

package/dist/shared/context.js

@@ -6,6 +6,8 @@ var FieldsContext = createContext({
 	components: {},
 	locales: [],
 	relationSource: null,
+	uploadSource: null,
+	checkSource: null,
 	binding: null
 });
 /** The fields context of the closest `FieldsProvider`. */
@@ -14,12 +16,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
+* of localized values, a relation source, an upload source, a check source and a binding. Values not given come from the parent
 * provider.
 */
 function FieldsProvider(t0) {
-	const $ = c(11);
-	const { components, locales, relationSource, binding, children } = t0;
+	const $ = c(13);
+	const { components, locales, relationSource, uploadSource, checkSource, binding, children } = t0;
 	const parent = use(FieldsContext);
 	let t1;
 	if ($[0] !== components || $[1] !== parent.components) {
@@ -33,33 +35,39 @@ 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 = binding === void 0 ? parent.binding : binding;
+	let t7;
+	if ($[3] !== t1 || $[4] !== t2 || $[5] !== t3 || $[6] !== t4 || $[7] !== t5 || $[8] !== t6) {
+		t7 = {
 			components: t1,
 			locales: t2,
 			relationSource: t3,
-			binding: t4
+			uploadSource: t4,
+			checkSource: t5,
+			binding: t6
 		};
 		$[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;
+	} else t7 = $[9];
+	const value = t7;
+	let t8;
+	if ($[10] !== children || $[11] !== value) {
+		t8 = /* @__PURE__ */ jsx(FieldsContext, {
 			value,
 			children
 		});
-		$[8] = children;
-		$[9] = value;
-		$[10] = t6;
-	} else t6 = $[10];
-	return t6;
+		$[10] = children;
+		$[11] = value;
+		$[12] = t8;
+	} else t8 = $[12];
+	return t8;
 }
 /** 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":["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 { UploadSource } from '../upload/types';\nimport type { FieldCheckSource } from './check';\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    binding: FieldBinding | null;\n}\n\nconst FieldsContext = createContext<FieldsContextValue>({\n    components: {},\n    locales: [],\n    relationSource: null,\n    uploadSource: null,\n    checkSource: 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    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, an upload source, a check source and a binding. Values not given come from the parent\n * provider.\n */\nexport function FieldsProvider({\n    components,\n    locales,\n    relationSource,\n    uploadSource,\n    checkSource,\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        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":";;;;AAoDA,IAAM,gBAAgB,cAAkC;CACpD,YAAY,CAAC;CACb,SAAS,CAAA;CACT,gBAAgB;CAChB,cAAc;CACd,aAAa;CACb,SAAS;AACb,CAAC;;AAGD,SAAgB,mBAAuC;CACnD,OAAO,IAAI,aAAa;AAC5B;;;;;;AAoBA,SAAO,eAAA,IAAA;CAAA,MAAA,IAAAE,EAAA,EAAA;CAAwB,MAAA,EAAA,YAAA,SAAA,gBAAA,cAAA,aAAA,SAAA,aAAA;CAS3B,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;CACF,MAAA,KAAA,iBAAiB,KAAA,IAAY,OAAM,eAAnC;CACD,MAAA,KAAA,gBAAgB,KAAA,IAAY,OAAM,cAAlC;CACJ,MAAA,KAAA,YAAY,KAAA,IAAY,OAAM,UAA9B;CAAgD,IAAA;CAAA,IAAA,EAAA,OAAA,MAAA,EAAA,OAAA,MAAA,EAAA,OAAA,MAAA,EAAA,OAAA,MAAA,EAAA,OAAA,MAAA,EAAA,OAAA,IAAA;EAP3B,KAAA;GAAA,YAE1B;GAAsF,SACjF;GAAyB,gBAClB;GAAqE,cACvE;GAA+D,aAChE;GAA4D,SAChE;EACb;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CARD,MAAA,QAAkC;CAQhC,IAAA;CAAA,IAAA,EAAA,QAAA,YAAA,EAAA,QAAA,OAAA;EACK,KAAA,oBAAC,eAAD;GAAsB;GAAQ;EAAhB,CAAA;EAAyC,EAAA,MAAA;EAAA,EAAA,MAAA;EAAA,EAAA,MAAA;CAAA,OAAA,KAAA,EAAA;CAAA,OAAvD;AAAuD;;AAIlE,SAAgB,cAAc,MAAsB;CAChD,MAAM,QAAQ,KAAK,YAAY,GAAG;CAClC,OAAO,UAAU,KAAK,KAAK,KAAK,MAAM,GAAG,KAAK;AAClD"}

package/dist/shared/entry.d.ts

@@ -20,4 +20,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,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;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

@@ -39,7 +39,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, 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":[],"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\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":";;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;;AAQA,SAAgB,UAAU,OAA+B;CACrD,IAAI,MAAM,WAAW,KAAA,KAAa,MAAM,OAAO,SAAS,GACpD,OAAO,MAAM;CAEjB,MAAM,OAAO,SAAS,OAAO,QAAQ;CACrC,OAAO,SAAS,KAAA,KAAa,WAAW,QAAQ,MAAM,QAAQ,KAAK,KAAK,IAClE,KAAK,MAAM,OAAO,QAAQ,IAC1B;AACV;;AAGA,SAAgB,WAAW,OAA6B;CACpD,MAAM,OAAO,SAAS,OAAO,SAAS;CACtC,OAAO,SAAS,KAAA,KAAa,WAAW,QAAQ,SAAS,KAAK,KAAK,IAAI,KAAK,QAAQ;AACxF"}

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,3 +1,4 @@
+import type { FieldCheckResponse } from '@panneau/protocol';
 import type { FieldEntryProps } from '../shared/types';
 import { type TextFieldProps } from '../text/TextField';
 /**
@@ -5,6 +6,10 @@ import { type TextFieldProps } from '../text/TextField';
  * 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;AAGnE;;;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"}