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

package/dist/shared/check.d.ts

@@ -0,0 +1,27 @@
+import type { FieldCheckRequest, FieldCheckResponse } from '@panneau/protocol';
+/**
+ * Where fields with `check` check their value as it is typed: whether a slug is available, and
+ * its URL. The value's locale and the form's values come with each check.
+ */
+export interface FieldCheckSource {
+    check(field: string, request: {
+        value: string;
+        locale?: string;
+        values?: Record<string, unknown>;
+    }, options: {
+        signal: AbortSignal;
+    }): Promise<FieldCheckResponse>;
+}
+/** What `createFieldCheckSource()` needs from an adapter: the `checkField()` of `@panneau/data`. */
+export interface FieldCheckAdapter {
+    checkField?(resource: string, field: string, request: FieldCheckRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<FieldCheckResponse>;
+}
+/**
+ * The check source of a form of a resource, through an adapter (`POST
+ * /resources/{resource}/fields/{field}/check`): `id` is the item being edited, or null when
+ * creating one. Null when the adapter can't check.
+ */
+export declare function createFieldCheckSource(adapter: FieldCheckAdapter, resource: string, id?: string | null): FieldCheckSource | null;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/shared/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CACD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAC7E,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC;AAED,oGAAoG;AACpG,MAAM,WAAW,iBAAiB;IAC9B,UAAU,CAAC,CACP,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE,MAAM,GAAG,IAAW,GACzB,gBAAgB,GAAG,IAAI,CASzB"}

package/dist/shared/check.js

@@ -0,0 +1,18 @@
+//#region src/shared/check.ts
+/**
+* The check source of a form of a resource, through an adapter (`POST
+* /resources/{resource}/fields/{field}/check`): `id` is the item being edited, or null when
+* creating one. Null when the adapter can't check.
+*/
+function createFieldCheckSource(adapter, resource, id = null) {
+	const { checkField } = adapter;
+	if (checkField === void 0) return null;
+	return { check: (field, request, { signal }) => checkField.call(adapter, resource, field, {
+		...request,
+		id
+	}, { signal }) };
+}
+//#endregion
+export { createFieldCheckSource };
+
+//# sourceMappingURL=check.js.map

package/dist/shared/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","names":[],"sources":["../../src/shared/check.ts"],"sourcesContent":["import type { FieldCheckRequest, FieldCheckResponse } from '@panneau/protocol';\n\n/**\n * Where fields with `check` check their value as it is typed: whether a slug is available, and\n * its URL. The value's locale and the form's values come with each check.\n */\nexport interface FieldCheckSource {\n    check(\n        field: string,\n        request: { value: string; locale?: string; values?: Record<string, unknown> },\n        options: { signal: AbortSignal },\n    ): Promise<FieldCheckResponse>;\n}\n\n/** What `createFieldCheckSource()` needs from an adapter: the `checkField()` of `@panneau/data`. */\nexport interface FieldCheckAdapter {\n    checkField?(\n        resource: string,\n        field: string,\n        request: FieldCheckRequest,\n        options?: { signal?: AbortSignal },\n    ): Promise<FieldCheckResponse>;\n}\n\n/**\n * The check source of a form of a resource, through an adapter (`POST\n * /resources/{resource}/fields/{field}/check`): `id` is the item being edited, or null when\n * creating one. Null when the adapter can't check.\n */\nexport function createFieldCheckSource(\n    adapter: FieldCheckAdapter,\n    resource: string,\n    id: string | null = null,\n): FieldCheckSource | null {\n    const { checkField } = adapter;\n    if (checkField === undefined) {\n        return null;\n    }\n    return {\n        check: (field, request, { signal }) =>\n            checkField.call(adapter, resource, field, { ...request, id }, { signal }),\n    };\n}\n"],"mappings":";;;;;;AA6BA,SAAgB,uBACZ,SACA,UACA,KAAoB,MACG;CACvB,MAAM,EAAE,eAAe;CACvB,IAAI,eAAe,KAAA,GACf,OAAO;CAEX,OAAO,EACH,QAAQ,OAAO,SAAS,EAAE,aACtB,WAAW,KAAK,SAAS,UAAU,OAAO;EAAE,GAAG;EAAS;CAAG,GAAG,EAAE,OAAO,CAAC,EAChF;AACJ"}

package/dist/shared/context.d.ts

@@ -1,6 +1,7 @@
 import { type ComponentType, type ReactNode } from 'react';
 import type { Field } from '@panneau/protocol';
 import type { UploadSource } from '../upload/types';
+import type { FieldCheckSource } from './check';
 import type { RelationSource } from './relation';
 import type { FieldEntry } from './types';
 /** What a binding gives a field: its value, handlers and errors at a path. */
@@ -38,6 +39,8 @@ export interface FieldsContextValue {
      * files themselves.
      */
     uploadSource: UploadSource | null;
+    /** Where fields with `check` check their value, such as a slug's availability. */
+    checkSource: FieldCheckSource | null;
     binding: FieldBinding | null;
 }
 /** The fields context of the closest `FieldsProvider`. */
@@ -49,15 +52,17 @@ export interface FieldsProviderProps {
     relationSource?: RelationSource | null;
     /** Make it once, outside of render: fields make an uploader for each source they get. */
     uploadSource?: UploadSource | null;
+    /** `createFieldCheckSource(adapter, resource, id)`, for the form of an item. */
+    checkSource?: FieldCheckSource | null;
     binding?: FieldBinding | null;
     children?: ReactNode;
 }
 /**
  * Provides what fields rendered from a definition need: the components of each type, the locales
- * of localized values, a relation source, an upload 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.
  */
-export declare function FieldsProvider({ components, locales, relationSource, uploadSource, binding, children, }: FieldsProviderProps): import("react").JSX.Element;
+export declare function FieldsProvider({ components, locales, relationSource, uploadSource, checkSource, binding, children, }: FieldsProviderProps): import("react").JSX.Element;
 /** The parent path of a path: `blocks.2` for `blocks.2.title`, `''` for `title`. */
 export declare function getParentPath(path: string): string;
 //# sourceMappingURL=context.d.ts.map

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

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

package/dist/shared/context.js

@@ -7,6 +7,7 @@ var FieldsContext = createContext({
 	locales: [],
 	relationSource: null,
 	uploadSource: null,
+	checkSource: null,
 	binding: null
 });
 /** The fields context of the closest `FieldsProvider`. */
@@ -15,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, an upload 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(12);
-	const { components, locales, relationSource, uploadSource, 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) {
@@ -35,15 +36,17 @@ function FieldsProvider(t0) {
 	const t2 = locales ?? parent.locales;
 	const t3 = relationSource === void 0 ? parent.relationSource : relationSource;
 	const t4 = uploadSource === void 0 ? parent.uploadSource : uploadSource;
-	const t5 = binding === void 0 ? parent.binding : binding;
-	let t6;
-	if ($[3] !== t1 || $[4] !== t2 || $[5] !== t3 || $[6] !== t4 || $[7] !== t5) {
-		t6 = {
+	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,
 			uploadSource: t4,
-			binding: t5
+			checkSource: t5,
+			binding: t6
 		};
 		$[3] = t1;
 		$[4] = t2;
@@ -51,19 +54,20 @@ function FieldsProvider(t0) {
 		$[6] = t4;
 		$[7] = t5;
 		$[8] = t6;
-	} else t6 = $[8];
-	const value = t6;
-	let t7;
-	if ($[9] !== children || $[10] !== value) {
-		t7 = /* @__PURE__ */ jsx(FieldsContext, {
+		$[9] = t7;
+	} else t7 = $[9];
+	const value = t7;
+	let t8;
+	if ($[10] !== children || $[11] !== value) {
+		t8 = /* @__PURE__ */ jsx(FieldsContext, {
 			value,
 			children
 		});
-		$[9] = children;
-		$[10] = value;
-		$[11] = t7;
-	} else t7 = $[11];
-	return t7;
+		$[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 { UploadSource } from '../upload/types';\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    binding: FieldBinding | null;\n}\n\nconst FieldsContext = createContext<FieldsContextValue>({\n    components: {},\n    locales: [],\n    relationSource: null,\n    uploadSource: 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    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 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    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        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":";;;;AAiDA,IAAM,gBAAgB,cAAkC;CACpD,YAAY,CAAC;CACb,SAAS,CAAA;CACT,gBAAgB;CAChB,cAAc;CACd,SAAS;AACb,CAAC;;AAGD,SAAgB,mBAAuC;CACnD,OAAO,IAAI,aAAa;AAC5B;;;;;;AAkBA,SAAO,eAAA,IAAA;CAAA,MAAA,IAAAE,EAAA,EAAA;CAAwB,MAAA,EAAA,YAAA,SAAA,gBAAA,cAAA,SAAA,aAAA;CAQ3B,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;CACL,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,IAAA;EAN3B,KAAA;GAAA,YAE1B;GAAsF,SACjF;GAAyB,gBAClB;GAAqE,cACvE;GAA+D,SACpE;EACb;EAAC,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;EAAA,EAAA,KAAA;CAAA,OAAA,KAAA,EAAA;CAPD,MAAA,QAAkC;CAOhC,IAAA;CAAA,IAAA,EAAA,OAAA,YAAA,EAAA,QAAA,OAAA;EACK,KAAA,oBAAC,eAAD;GAAsB;GAAQ;EAAhB,CAAA;EAAyC,EAAA,KAAA;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"}
+{"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/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"}