@lablup/ui-common 0.1.0-alpha.9 → 0.2.0-alpha.16

package/dist/components/Form/Form.js

@@ -0,0 +1,130 @@
+import { FieldContext as e, FormConfigContext as t, FormItemLayoutContext as n, FormProviderContext as r, HOOK_MARK as i, ListContext as a } from "./context.js";
+import { mergeValidateMessages as o } from "./messages.js";
+import s from "./FormStore.js";
+import { useFormValidateMessages as c } from "./FormConfigProvider.js";
+import * as l from "react";
+import { jsx as u } from "react/jsx-runtime";
+var d = l.forwardRef((d, f) => {
+	let { name: p, initialValues: m, form: h, preserve: g, children: _, component: v = "form", validateMessages: y, validateTrigger: b = "onChange", onValuesChange: x, onFieldsChange: S, onFinish: C, onFinishFailed: w, clearOnDestroy: T, layout: E = "horizontal", requiredMark: D, disabled: O, scrollToFirstError: k, size: A, labelCol: j, wrapperCol: M, colon: N, labelAlign: P, labelWrap: F, ...I } = d, L = l.useRef(null), R = l.useContext(r), z = l.useContext(t), B = c(), [V] = s(h), { useSubscribe: H, setInitialValues: U, setCallbacks: W, setValidateMessages: G, setPreserve: K, destroyForm: q } = V.getInternalHooks(i);
+	l.useImperativeHandle(f, () => ({
+		...V,
+		nativeElement: L.current
+	})), l.useEffect(() => (R.registerForm(p, V), () => {
+		R.unregisterForm(p);
+	}), [
+		R,
+		V,
+		p
+	]), G(o(B, z.validateMessages, R.validateMessages, y)), W({
+		onValuesChange: x,
+		onFieldsChange: (e, ...t) => {
+			R.triggerFormChange(p, e), S?.(e, ...t);
+		},
+		onFinish: (e) => {
+			R.triggerFormFinish(p, e), C?.(e);
+		},
+		onFinishFailed: (e) => {
+			if (k && e.errorFields.length) {
+				let t = typeof k == "object" ? k : {};
+				V.scrollToField(e.errorFields[0].name, {
+					focus: !0,
+					...t
+				});
+			}
+			w?.(e);
+		}
+	}), K(g), l.useState(() => (U(m, !0), null)), U(m, !1), l.useEffect(() => () => q(T), []), H(!0);
+	let J = l.useMemo(() => ({
+		...V,
+		validateTrigger: b
+	}), [V, b]), Y = l.useMemo(() => ({
+		form: V,
+		layout: E,
+		requiredMark: D ?? z.requiredMark,
+		disabled: O,
+		name: p,
+		size: A,
+		colon: N,
+		labelAlign: P,
+		labelCol: j,
+		wrapperCol: M,
+		labelWrap: F
+	}), [
+		V,
+		E,
+		D,
+		z.requiredMark,
+		O,
+		p,
+		A,
+		N,
+		P,
+		j,
+		M,
+		F
+	]), X = /* @__PURE__ */ u(a.Provider, {
+		value: null,
+		children: /* @__PURE__ */ u(n.Provider, {
+			value: Y,
+			children: /* @__PURE__ */ u(e.Provider, {
+				value: J,
+				children: _
+			})
+		})
+	});
+	return v === !1 ? X : /* @__PURE__ */ u(v, {
+		...I,
+		className: ["uic-form", I.className].filter(Boolean).join(" "),
+		"data-layout": E,
+		"data-size": A,
+		ref: L,
+		onSubmit: (e) => {
+			e.preventDefault(), e.stopPropagation(), V.submit();
+		},
+		onReset: (e) => {
+			e.preventDefault(), V.resetFields();
+		},
+		children: X
+	});
+}), f = ({ validateMessages: e, onFormChange: t, onFormFinish: n, children: i }) => {
+	let a = l.useContext(r), o = l.useRef({}), s = {
+		...a,
+		validateMessages: {
+			...a.validateMessages,
+			...e
+		},
+		triggerFormChange: (e, n) => {
+			t?.(e, {
+				changedFields: n,
+				forms: o.current
+			}), a.triggerFormChange(e, n);
+		},
+		triggerFormFinish: (e, t) => {
+			n?.(e, {
+				values: t,
+				forms: o.current
+			}), a.triggerFormFinish(e, t);
+		},
+		registerForm: (e, t) => {
+			e && (o.current = {
+				...o.current,
+				[e]: t
+			}), a.registerForm(e, t);
+		},
+		unregisterForm: (e) => {
+			if (e) {
+				let t = { ...o.current };
+				delete t[e], o.current = t;
+			}
+			a.unregisterForm(e);
+		}
+	};
+	return /* @__PURE__ */ u(r.Provider, {
+		value: s,
+		children: i
+	});
+};
+//#endregion
+export { f as FormProvider, d as default, s as useForm };
+
+//# sourceMappingURL=Form.js.map

package/dist/components/Form/Form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.js","names":[],"sources":["../../../src/components/Form/Form.tsx"],"sourcesContent":["/**\n * `<Form>`: store wiring, contexts and submit/reset plumbing (rc-field-form's\n * `<Form>`) plus layout, `requiredMark`, `disabled` and `scrollToFirstError`\n * (antd's `<Form>`).\n *\n * `layout` defaults to `'horizontal'`, as in antd: a form that states no\n * layout but passes a `labelCol` span only makes sense horizontally.\n */\nimport useForm, { FormStore } from \"./FormStore\";\nimport {\n  FieldContext,\n  FormConfigContext,\n  FormItemLayoutContext,\n  FormProviderContext,\n  HOOK_MARK,\n  ListContext,\n  type FormItemCol,\n  type FormLayout,\n  type FormProviderContextValue,\n  type FormSize,\n  type RequiredMark,\n} from \"./context\";\nimport type {\n  Callbacks,\n  FieldData,\n  FormInstance,\n  InternalFormInstance,\n  ValidateErrorEntity,\n  ValidateMessages,\n} from \"./interface\";\nimport { useFormValidateMessages } from \"./FormConfigProvider\";\nimport { mergeValidateMessages } from \"./messages\";\nimport type { Store } from \"./namePath\";\nimport * as React from \"react\";\n\nexport interface FormProps<Values = any> extends Omit<\n  React.FormHTMLAttributes<HTMLFormElement>,\n  \"onSubmit\" | \"children\" | \"onChange\" | \"onReset\"\n> {\n  form?: FormInstance<Values>;\n  name?: string;\n  initialValues?: Store;\n  /** `false` drops unmounted fields' values; the default `true` keeps them. */\n  preserve?: boolean;\n  layout?: FormLayout;\n  requiredMark?: RequiredMark;\n  disabled?: boolean;\n  size?: FormSize;\n  labelCol?: FormItemCol;\n  wrapperCol?: FormItemCol;\n  colon?: boolean;\n  labelAlign?: \"left\" | \"right\";\n  labelWrap?: boolean;\n  validateMessages?: ValidateMessages;\n  validateTrigger?: string | string[] | false;\n  scrollToFirstError?: boolean | Record<string, unknown>;\n  clearOnDestroy?: boolean;\n  onValuesChange?: Callbacks<Values>[\"onValuesChange\"];\n  onFieldsChange?: Callbacks<Values>[\"onFieldsChange\"];\n  onFinish?: Callbacks<Values>[\"onFinish\"];\n  onFinishFailed?: Callbacks<Values>[\"onFinishFailed\"];\n  /** `false` renders no wrapper element at all (context only). */\n  component?: React.ComponentType<any> | string | false;\n  children?: React.ReactNode;\n}\n\n/**\n * What `<Form ref>` hands back. `nativeElement` is OPTIONAL on purpose: call\n * sites declare `useRef<FormInstance>(null)`, and a required extra member\n * would make that ref type unassignable to the element's `ref` prop.\n */\nexport type FormRef<Values = any> = FormInstance<Values> & {\n  nativeElement?: HTMLElement | null;\n};\n\nconst InternalForm = <Values,>(\n  props: FormProps<Values>,\n  ref: React.Ref<FormRef<Values>>,\n) => {\n  const {\n    name,\n    initialValues,\n    form,\n    preserve,\n    children,\n    component: Component = \"form\",\n    validateMessages,\n    validateTrigger = \"onChange\",\n    onValuesChange,\n    onFieldsChange,\n    onFinish,\n    onFinishFailed,\n    clearOnDestroy,\n    layout = \"horizontal\",\n    requiredMark,\n    disabled,\n    scrollToFirstError,\n    // Visual props antd consumed through its stylesheet + `FormContext`. They\n    // are published on the layout context (never forwarded onto the DOM node,\n    // where React would warn) and the visual shell lays out from them.\n    size,\n    labelCol,\n    wrapperCol,\n    colon,\n    labelAlign,\n    labelWrap,\n    ...restProps\n  } = props;\n\n  const nativeElementRef = React.useRef<HTMLElement | null>(null);\n  const formProviderContext = React.useContext(FormProviderContext);\n  const formConfig = React.useContext(FormConfigContext);\n  const localizedMessages = useFormValidateMessages();\n\n  const [formInstance] = useForm(form as InternalFormInstance | undefined);\n  const hooks = formInstance.getInternalHooks(HOOK_MARK)!;\n  const {\n    useSubscribe,\n    setInitialValues,\n    setCallbacks,\n    setValidateMessages,\n    setPreserve,\n    destroyForm,\n  } = hooks;\n\n  React.useImperativeHandle(\n    ref,\n    () =>\n      ({\n        ...formInstance,\n        nativeElement: nativeElementRef.current,\n      }) as FormRef<Values>,\n  );\n\n  React.useEffect(() => {\n    formProviderContext.registerForm(name, formInstance);\n    return () => {\n      formProviderContext.unregisterForm(name);\n    };\n  }, [formProviderContext, formInstance, name]);\n\n  // Templates: the catalog in the active locale < app config < Form.Provider\n  // < this form's own prop.\n  setValidateMessages(\n    mergeValidateMessages(\n      localizedMessages,\n      formConfig.validateMessages,\n      formProviderContext.validateMessages,\n      validateMessages,\n    ),\n  );\n\n  setCallbacks({\n    onValuesChange,\n    onFieldsChange: (changedFields: FieldData[], ...rest) => {\n      // Fires for PROGRAMMATIC changes too, unlike `onValuesChange` — which\n      // is exactly why `Form.Provider onFormChange` can observe\n      // `setFieldValue`.\n      formProviderContext.triggerFormChange(name, changedFields);\n      onFieldsChange?.(changedFields, ...(rest as [FieldData[]]));\n    },\n    onFinish: (values: any) => {\n      formProviderContext.triggerFormFinish(name, values);\n      onFinish?.(values);\n    },\n    onFinishFailed: (errorInfo: ValidateErrorEntity) => {\n      if (scrollToFirstError && errorInfo.errorFields.length) {\n        const options =\n          typeof scrollToFirstError === \"object\" ? scrollToFirstError : {};\n        formInstance.scrollToField(errorInfo.errorFields[0]!.name, {\n          focus: true,\n          ...options,\n        });\n      }\n      onFinishFailed?.(errorInfo);\n    },\n  });\n  setPreserve(preserve);\n\n  // Seed the store — exactly once, in `useState`'s lazy initialiser.\n  React.useState(() => {\n    setInitialValues(initialValues, true);\n    return null;\n  });\n  // Then on EVERY render, refresh what `initialValues` currently is without\n  // re-seeding: a changed\n  // `initialValues` prop must not overwrite what the user has typed, but it\n  // IS what a later `resetFields()` restores.\n  setInitialValues(initialValues, false);\n\n  React.useEffect(\n    () => () => destroyForm(clearOnDestroy),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n\n  useSubscribe(true);\n\n  const formContextValue = React.useMemo(\n    () => ({ ...formInstance, validateTrigger }) as InternalFormInstance,\n    [formInstance, validateTrigger],\n  );\n\n  const layoutContextValue = React.useMemo(\n    () => ({\n      form: formInstance as FormInstance,\n      layout,\n      requiredMark: requiredMark ?? formConfig.requiredMark,\n      disabled,\n      name,\n      size,\n      colon,\n      labelAlign,\n      labelCol,\n      wrapperCol,\n      labelWrap,\n    }),\n    [\n      formInstance,\n      layout,\n      requiredMark,\n      formConfig.requiredMark,\n      disabled,\n      name,\n      size,\n      colon,\n      labelAlign,\n      labelCol,\n      wrapperCol,\n      labelWrap,\n    ],\n  );\n\n  const wrapperNode = (\n    <ListContext.Provider value={null}>\n      <FormItemLayoutContext.Provider value={layoutContextValue}>\n        <FieldContext.Provider value={formContextValue}>\n          {children}\n        </FieldContext.Provider>\n      </FormItemLayoutContext.Provider>\n    </ListContext.Provider>\n  );\n\n  if (Component === false) {\n    return wrapperNode;\n  }\n\n  const Wrapper = Component as any;\n  return (\n    <Wrapper\n      {...restProps}\n      // An inline form is `display: flex; flex-wrap: wrap` on the FORM, which\n      // no per-item style can express (antd's `.ant-form-inline`).\n      className={[\"uic-form\", restProps.className].filter(Boolean).join(\" \")}\n      data-layout={layout}\n      data-size={size}\n      ref={nativeElementRef}\n      onSubmit={(event: React.FormEvent) => {\n        event.preventDefault();\n        event.stopPropagation();\n        formInstance.submit();\n      }}\n      onReset={(event: React.FormEvent) => {\n        event.preventDefault();\n        formInstance.resetFields();\n      }}\n    >\n      {wrapperNode}\n    </Wrapper>\n  );\n};\n\n/**\n * The ref is declared as `Ref<FormInstance<Values>>`, not `Ref<FormRef<…>>`:\n * call sites write `useRef<FormInstance<MyValues>>(null)`, and inference\n * through the plain generic recovers `Values` from that, where an\n * intersection type does not. The runtime object still carries\n * `nativeElement`, which `FormRef` describes for anyone who wants it.\n */\nconst Form = React.forwardRef(InternalForm) as <Values = any>(\n  props: FormProps<Values> & { ref?: React.Ref<FormInstance<Values>> },\n) => React.ReactElement;\n\n// ============================== Form.Provider ===============================\n\nexport interface FormProviderProps {\n  validateMessages?: ValidateMessages;\n  onFormChange?: (\n    name: string | undefined,\n    info: { changedFields: FieldData[]; forms: Record<string, FormInstance> },\n  ) => void;\n  onFormFinish?: (\n    name: string | undefined,\n    info: { values: Store; forms: Record<string, FormInstance> },\n  ) => void;\n  children?: React.ReactNode;\n}\n\n/**\n * Cross-form listener. `onFormChange` is wired to `onFieldsChange`, NOT to\n * `onValuesChange`, so it observes programmatic mutations (`setFieldValue`,\n * `setFieldsValue`, `setFields`) as well as user edits.\n */\nexport const FormProvider: React.FC<FormProviderProps> = ({\n  validateMessages,\n  onFormChange,\n  onFormFinish,\n  children,\n}) => {\n  const parent = React.useContext(FormProviderContext);\n  const formsRef = React.useRef<Record<string, FormInstance>>({});\n\n  const value: FormProviderContextValue = {\n    ...parent,\n    validateMessages: {\n      ...parent.validateMessages,\n      ...validateMessages,\n    },\n    // Unnamed forms fire too, with `name` undefined, as in rc-field-form.\n    triggerFormChange: (formName, changedFields) => {\n      onFormChange?.(formName, { changedFields, forms: formsRef.current });\n      parent.triggerFormChange(formName, changedFields);\n    },\n    triggerFormFinish: (formName, values) => {\n      onFormFinish?.(formName, { values, forms: formsRef.current });\n      parent.triggerFormFinish(formName, values);\n    },\n    registerForm: (formName, formInstance) => {\n      if (formName) {\n        formsRef.current = { ...formsRef.current, [formName]: formInstance };\n      }\n      parent.registerForm(formName, formInstance);\n    },\n    unregisterForm: (formName) => {\n      if (formName) {\n        const newForms = { ...formsRef.current };\n        delete newForms[formName];\n        formsRef.current = newForms;\n      }\n      parent.unregisterForm(formName);\n    },\n  };\n\n  return (\n    <FormProviderContext.Provider value={value}>\n      {children}\n    </FormProviderContext.Provider>\n  );\n};\n\nexport { useForm, FormStore };\nexport default Form;\n"],"mappings":"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"}

package/dist/components/Form/Form.messages.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The form engine's built-in strings: the validation message templates and
+ * the `requiredMark="optional"` suffix. Placeholders are the rule's values:
+ * `{label}` (the item's label, or its name), `{type}`, `{len}`, `{min}`,
+ * `{max}` and `{pattern}`.
+ */
+export declare const formMessages: {
+    readonly "uic.Form.optional": {
+        readonly defaultMessage: "(optional)";
+        readonly description: "Suffix after the label of an optional field when requiredMark=\"optional\"";
+    };
+    readonly "uic.Form.default": {
+        readonly defaultMessage: "Field validation error for {label}";
+        readonly description: "Validation error when a rule failed without a more specific message";
+    };
+    readonly "uic.Form.required": {
+        readonly defaultMessage: "Please enter {label}";
+        readonly description: "Validation error for an empty required field";
+    };
+    readonly "uic.Form.whitespace": {
+        readonly defaultMessage: "{label} cannot be a blank character";
+        readonly description: "Validation error for a required field that holds only whitespace";
+    };
+    readonly "uic.Form.typeString": {
+        readonly defaultMessage: "{label} is not a valid {type}";
+        readonly description: "Validation error for a value that is not a string; {type} is the type name";
+    };
+    readonly "uic.Form.typeNumber": {
+        readonly defaultMessage: "{label} is not a valid {type}";
+        readonly description: "Validation error for a value that is not a number; {type} is the type name";
+    };
+    readonly "uic.Form.typeObject": {
+        readonly defaultMessage: "{label} is not a valid {type}";
+        readonly description: "Validation error for a value that is not an object; {type} is the type name";
+    };
+    readonly "uic.Form.typeEmail": {
+        readonly defaultMessage: "{label} is not a valid {type}";
+        readonly description: "Validation error for an invalid email address; {type} is the type name";
+    };
+    readonly "uic.Form.typeUrl": {
+        readonly defaultMessage: "{label} is not a valid {type}";
+        readonly description: "Validation error for an invalid URL; {type} is the type name";
+    };
+    readonly "uic.Form.stringLen": {
+        readonly defaultMessage: "{label} must be {len} characters";
+        readonly description: "Validation error for text of the wrong exact length";
+    };
+    readonly "uic.Form.stringMin": {
+        readonly defaultMessage: "{label} must be at least {min} characters";
+        readonly description: "Validation error for text shorter than the minimum";
+    };
+    readonly "uic.Form.stringMax": {
+        readonly defaultMessage: "{label} must be up to {max} characters";
+        readonly description: "Validation error for text longer than the maximum";
+    };
+    readonly "uic.Form.stringRange": {
+        readonly defaultMessage: "{label} must be between {min}-{max} characters";
+        readonly description: "Validation error for text outside a length range";
+    };
+    readonly "uic.Form.numberLen": {
+        readonly defaultMessage: "{label} must be equal to {len}";
+        readonly description: "Validation error for a number that must equal a value";
+    };
+    readonly "uic.Form.numberMin": {
+        readonly defaultMessage: "{label} must be minimum {min}";
+        readonly description: "Validation error for a number below the minimum";
+    };
+    readonly "uic.Form.numberMax": {
+        readonly defaultMessage: "{label} must be maximum {max}";
+        readonly description: "Validation error for a number above the maximum";
+    };
+    readonly "uic.Form.numberRange": {
+        readonly defaultMessage: "{label} must be between {min}-{max}";
+        readonly description: "Validation error for a number outside a range";
+    };
+    readonly "uic.Form.arrayLen": {
+        readonly defaultMessage: "Must be {len} {label}";
+        readonly description: "Validation error for a list with the wrong number of items";
+    };
+    readonly "uic.Form.arrayMin": {
+        readonly defaultMessage: "At least {min} {label}";
+        readonly description: "Validation error for a list with too few items";
+    };
+    readonly "uic.Form.arrayMax": {
+        readonly defaultMessage: "At most {max} {label}";
+        readonly description: "Validation error for a list with too many items";
+    };
+    readonly "uic.Form.arrayRange": {
+        readonly defaultMessage: "The amount of {label} must be between {min}-{max}";
+        readonly description: "Validation error for a list whose item count is outside a range";
+    };
+    readonly "uic.Form.patternMismatch": {
+        readonly defaultMessage: "{label} does not match the pattern {pattern}";
+        readonly description: "Validation error for text that does not match a pattern";
+    };
+};

package/dist/components/Form/Form.messages.js

@@ -0,0 +1,96 @@
+import { defineMessages as e } from "../../i18n/catalog.js";
+//#region src/components/Form/Form.messages.ts
+var t = e({
+	"uic.Form.optional": {
+		defaultMessage: "(optional)",
+		description: "Suffix after the label of an optional field when requiredMark=\"optional\""
+	},
+	"uic.Form.default": {
+		defaultMessage: "Field validation error for {label}",
+		description: "Validation error when a rule failed without a more specific message"
+	},
+	"uic.Form.required": {
+		defaultMessage: "Please enter {label}",
+		description: "Validation error for an empty required field"
+	},
+	"uic.Form.whitespace": {
+		defaultMessage: "{label} cannot be a blank character",
+		description: "Validation error for a required field that holds only whitespace"
+	},
+	"uic.Form.typeString": {
+		defaultMessage: "{label} is not a valid {type}",
+		description: "Validation error for a value that is not a string; {type} is the type name"
+	},
+	"uic.Form.typeNumber": {
+		defaultMessage: "{label} is not a valid {type}",
+		description: "Validation error for a value that is not a number; {type} is the type name"
+	},
+	"uic.Form.typeObject": {
+		defaultMessage: "{label} is not a valid {type}",
+		description: "Validation error for a value that is not an object; {type} is the type name"
+	},
+	"uic.Form.typeEmail": {
+		defaultMessage: "{label} is not a valid {type}",
+		description: "Validation error for an invalid email address; {type} is the type name"
+	},
+	"uic.Form.typeUrl": {
+		defaultMessage: "{label} is not a valid {type}",
+		description: "Validation error for an invalid URL; {type} is the type name"
+	},
+	"uic.Form.stringLen": {
+		defaultMessage: "{label} must be {len} characters",
+		description: "Validation error for text of the wrong exact length"
+	},
+	"uic.Form.stringMin": {
+		defaultMessage: "{label} must be at least {min} characters",
+		description: "Validation error for text shorter than the minimum"
+	},
+	"uic.Form.stringMax": {
+		defaultMessage: "{label} must be up to {max} characters",
+		description: "Validation error for text longer than the maximum"
+	},
+	"uic.Form.stringRange": {
+		defaultMessage: "{label} must be between {min}-{max} characters",
+		description: "Validation error for text outside a length range"
+	},
+	"uic.Form.numberLen": {
+		defaultMessage: "{label} must be equal to {len}",
+		description: "Validation error for a number that must equal a value"
+	},
+	"uic.Form.numberMin": {
+		defaultMessage: "{label} must be minimum {min}",
+		description: "Validation error for a number below the minimum"
+	},
+	"uic.Form.numberMax": {
+		defaultMessage: "{label} must be maximum {max}",
+		description: "Validation error for a number above the maximum"
+	},
+	"uic.Form.numberRange": {
+		defaultMessage: "{label} must be between {min}-{max}",
+		description: "Validation error for a number outside a range"
+	},
+	"uic.Form.arrayLen": {
+		defaultMessage: "Must be {len} {label}",
+		description: "Validation error for a list with the wrong number of items"
+	},
+	"uic.Form.arrayMin": {
+		defaultMessage: "At least {min} {label}",
+		description: "Validation error for a list with too few items"
+	},
+	"uic.Form.arrayMax": {
+		defaultMessage: "At most {max} {label}",
+		description: "Validation error for a list with too many items"
+	},
+	"uic.Form.arrayRange": {
+		defaultMessage: "The amount of {label} must be between {min}-{max}",
+		description: "Validation error for a list whose item count is outside a range"
+	},
+	"uic.Form.patternMismatch": {
+		defaultMessage: "{label} does not match the pattern {pattern}",
+		description: "Validation error for text that does not match a pattern"
+	}
+});
+//#endregion
+export { t as formMessages };
+
+//# sourceMappingURL=Form.messages.js.map

package/dist/components/Form/Form.messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.messages.js","names":[],"sources":["../../../src/components/Form/Form.messages.ts"],"sourcesContent":["import { defineMessages } from \"../../i18n/catalog\";\n\n/**\n * The form engine's built-in strings: the validation message templates and\n * the `requiredMark=\"optional\"` suffix. Placeholders are the rule's values:\n * `{label}` (the item's label, or its name), `{type}`, `{len}`, `{min}`,\n * `{max}` and `{pattern}`.\n */\nexport const formMessages = defineMessages({\n  \"uic.Form.optional\": {\n    defaultMessage: \"(optional)\",\n    description:\n      'Suffix after the label of an optional field when requiredMark=\"optional\"',\n  },\n  \"uic.Form.default\": {\n    defaultMessage: \"Field validation error for {label}\",\n    description: \"Validation error when a rule failed without a more specific message\",\n  },\n  \"uic.Form.required\": {\n    defaultMessage: \"Please enter {label}\",\n    description: \"Validation error for an empty required field\",\n  },\n  \"uic.Form.whitespace\": {\n    defaultMessage: \"{label} cannot be a blank character\",\n    description: \"Validation error for a required field that holds only whitespace\",\n  },\n  \"uic.Form.typeString\": {\n    defaultMessage: \"{label} is not a valid {type}\",\n    description:\n      \"Validation error for a value that is not a string; {type} is the type name\",\n  },\n  \"uic.Form.typeNumber\": {\n    defaultMessage: \"{label} is not a valid {type}\",\n    description:\n      \"Validation error for a value that is not a number; {type} is the type name\",\n  },\n  \"uic.Form.typeObject\": {\n    defaultMessage: \"{label} is not a valid {type}\",\n    description:\n      \"Validation error for a value that is not an object; {type} is the type name\",\n  },\n  \"uic.Form.typeEmail\": {\n    defaultMessage: \"{label} is not a valid {type}\",\n    description:\n      \"Validation error for an invalid email address; {type} is the type name\",\n  },\n  \"uic.Form.typeUrl\": {\n    defaultMessage: \"{label} is not a valid {type}\",\n    description: \"Validation error for an invalid URL; {type} is the type name\",\n  },\n  \"uic.Form.stringLen\": {\n    defaultMessage: \"{label} must be {len} characters\",\n    description: \"Validation error for text of the wrong exact length\",\n  },\n  \"uic.Form.stringMin\": {\n    defaultMessage: \"{label} must be at least {min} characters\",\n    description: \"Validation error for text shorter than the minimum\",\n  },\n  \"uic.Form.stringMax\": {\n    defaultMessage: \"{label} must be up to {max} characters\",\n    description: \"Validation error for text longer than the maximum\",\n  },\n  \"uic.Form.stringRange\": {\n    defaultMessage: \"{label} must be between {min}-{max} characters\",\n    description: \"Validation error for text outside a length range\",\n  },\n  \"uic.Form.numberLen\": {\n    defaultMessage: \"{label} must be equal to {len}\",\n    description: \"Validation error for a number that must equal a value\",\n  },\n  \"uic.Form.numberMin\": {\n    defaultMessage: \"{label} must be minimum {min}\",\n    description: \"Validation error for a number below the minimum\",\n  },\n  \"uic.Form.numberMax\": {\n    defaultMessage: \"{label} must be maximum {max}\",\n    description: \"Validation error for a number above the maximum\",\n  },\n  \"uic.Form.numberRange\": {\n    defaultMessage: \"{label} must be between {min}-{max}\",\n    description: \"Validation error for a number outside a range\",\n  },\n  \"uic.Form.arrayLen\": {\n    defaultMessage: \"Must be {len} {label}\",\n    description: \"Validation error for a list with the wrong number of items\",\n  },\n  \"uic.Form.arrayMin\": {\n    defaultMessage: \"At least {min} {label}\",\n    description: \"Validation error for a list with too few items\",\n  },\n  \"uic.Form.arrayMax\": {\n    defaultMessage: \"At most {max} {label}\",\n    description: \"Validation error for a list with too many items\",\n  },\n  \"uic.Form.arrayRange\": {\n    defaultMessage: \"The amount of {label} must be between {min}-{max}\",\n    description: \"Validation error for a list whose item count is outside a range\",\n  },\n  \"uic.Form.patternMismatch\": {\n    defaultMessage: \"{label} does not match the pattern {pattern}\",\n    description: \"Validation error for text that does not match a pattern\",\n  },\n});\n"],"mappings":";;AAQA,IAAa,IAAe,EAAe;CACzC,qBAAqB;EACnB,gBAAgB;EAChB,aACE;CACJ;CACA,oBAAoB;EAClB,gBAAgB;EAChB,aAAa;CACf;CACA,qBAAqB;EACnB,gBAAgB;EAChB,aAAa;CACf;CACA,uBAAuB;EACrB,gBAAgB;EAChB,aAAa;CACf;CACA,uBAAuB;EACrB,gBAAgB;EAChB,aACE;CACJ;CACA,uBAAuB;EACrB,gBAAgB;EAChB,aACE;CACJ;CACA,uBAAuB;EACrB,gBAAgB;EAChB,aACE;CACJ;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aACE;CACJ;CACA,oBAAoB;EAClB,gBAAgB;EAChB,aAAa;CACf;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aAAa;CACf;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aAAa;CACf;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aAAa;CACf;CACA,wBAAwB;EACtB,gBAAgB;EAChB,aAAa;CACf;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aAAa;CACf;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aAAa;CACf;CACA,sBAAsB;EACpB,gBAAgB;EAChB,aAAa;CACf;CACA,wBAAwB;EACtB,gBAAgB;EAChB,aAAa;CACf;CACA,qBAAqB;EACnB,gBAAgB;EAChB,aAAa;CACf;CACA,qBAAqB;EACnB,gBAAgB;EAChB,aAAa;CACf;CACA,qBAAqB;EACnB,gBAAgB;EAChB,aAAa;CACf;CACA,uBAAuB;EACrB,gBAAgB;EAChB,aAAa;CACf;CACA,4BAA4B;EAC1B,gBAAgB;EAChB,aAAa;CACf;AACF,CAAC"}

package/dist/components/Form/FormConfigProvider.d.ts

@@ -0,0 +1,20 @@
+import { FormConfig, RequiredMark } from './context';
+import { ValidateMessages } from './interface';
+/**
+ * App-level form configuration: antd's `<ConfigProvider form={{
+ * validateMessages, requiredMark }}>` for the engine. A nested provider
+ * inherits what it does not set.
+ *
+ * Validation messages need no provider: every `<Form>` resolves them from
+ * ui-common's catalog in the locale of the nearest Astryx
+ * `InternationalizationProvider`. `validateMessages` here wins over that.
+ */
+import * as React from "react";
+/** The validate-message table in the active locale, from ui-common's catalog. */
+export declare function useFormValidateMessages(): ValidateMessages;
+/** The `requiredMark="optional"` suffix in the active locale. */
+export declare function useFormOptionalLabel(): string;
+export declare const FormConfigProvider: React.FC<FormConfig & {
+    children?: React.ReactNode;
+}>;
+export type { FormConfig, RequiredMark };

package/dist/components/Form/FormConfigProvider.js

@@ -0,0 +1,31 @@
+import { useUicTranslator as e } from "../../i18n/useUicTranslator.js";
+import { FormConfigContext as t } from "./context.js";
+import { buildValidateMessages as n } from "./messages.js";
+import * as r from "react";
+import { jsx as i } from "react/jsx-runtime";
+//#region src/components/Form/FormConfigProvider.tsx
+function a() {
+	let t = e();
+	return r.useMemo(() => n(t), [t]);
+}
+var o = ({ children: e, validateMessages: n, requiredMark: a, optionalLabel: o }) => {
+	let s = r.useContext(t), c = r.useMemo(() => ({
+		...s,
+		...n === void 0 ? null : { validateMessages: n },
+		...a === void 0 ? null : { requiredMark: a },
+		...o === void 0 ? null : { optionalLabel: o }
+	}), [
+		s,
+		n,
+		a,
+		o
+	]);
+	return /* @__PURE__ */ i(t.Provider, {
+		value: c,
+		children: e
+	});
+};
+//#endregion
+export { o as FormConfigProvider, a as useFormValidateMessages };
+
+//# sourceMappingURL=FormConfigProvider.js.map

package/dist/components/Form/FormConfigProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormConfigProvider.js","names":[],"sources":["../../../src/components/Form/FormConfigProvider.tsx"],"sourcesContent":["/**\n * App-level form configuration: antd's `<ConfigProvider form={{\n * validateMessages, requiredMark }}>` for the engine. A nested provider\n * inherits what it does not set.\n *\n * Validation messages need no provider: every `<Form>` resolves them from\n * ui-common's catalog in the locale of the nearest Astryx\n * `InternationalizationProvider`. `validateMessages` here wins over that.\n */\nimport * as React from \"react\";\n\nimport { useUicTranslator } from \"../../i18n/useUicTranslator\";\nimport { FormConfigContext, type FormConfig, type RequiredMark } from \"./context\";\nimport type { ValidateMessages } from \"./interface\";\nimport { buildValidateMessages } from \"./messages\";\n\n/** The validate-message table in the active locale, from ui-common's catalog. */\nexport function useFormValidateMessages(): ValidateMessages {\n  const t = useUicTranslator();\n  return React.useMemo(() => buildValidateMessages(t), [t]);\n}\n\n/** The `requiredMark=\"optional\"` suffix in the active locale. */\nexport function useFormOptionalLabel(): string {\n  const t = useUicTranslator();\n  return t(\"uic.Form.optional\");\n}\n\nexport const FormConfigProvider: React.FC<\n  FormConfig & { children?: React.ReactNode }\n> = ({ children, validateMessages, requiredMark, optionalLabel }) => {\n  const parent = React.useContext(FormConfigContext);\n  const value = React.useMemo(\n    () => ({\n      ...parent,\n      ...(validateMessages !== undefined ? { validateMessages } : null),\n      ...(requiredMark !== undefined ? { requiredMark } : null),\n      ...(optionalLabel !== undefined ? { optionalLabel } : null),\n    }),\n    [parent, validateMessages, requiredMark, optionalLabel],\n  );\n  return (\n    <FormConfigContext.Provider value={value}>{children}</FormConfigContext.Provider>\n  );\n};\n\nexport type { FormConfig, RequiredMark };\n"],"mappings":";;;;;;AAiBA,SAAgB,IAA4C;CAC1D,IAAM,IAAI,EAAiB;CAC3B,OAAO,EAAM,cAAc,EAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D;AAQA,IAAa,KAER,EAAE,aAAU,qBAAkB,iBAAc,uBAAoB;CACnE,IAAM,IAAS,EAAM,WAAW,CAAiB,GAC3C,IAAQ,EAAM,eACX;EACL,GAAG;EACH,GAAI,MAAqB,KAAA,IAAmC,OAAvB,EAAE,oBAAiB;EACxD,GAAI,MAAiB,KAAA,IAA+B,OAAnB,EAAE,gBAAa;EAChD,GAAI,MAAkB,KAAA,IAAgC,OAApB,EAAE,iBAAc;CACpD,IACA;EAAC;EAAQ;EAAkB;EAAc;CAAa,CACxD;CACA,OACE,kBAAC,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AAEpF"}

package/dist/components/Form/FormItem.d.ts

@@ -0,0 +1,56 @@
+import { FieldProps } from './Field';
+import { FormItemCol, FormItemStatusContextValue, FormLayout } from './context';
+import { InternalFormInstance, StoreValue } from './interface';
+import { InternalNamePath, NamePath } from './namePath';
+import * as React from "react";
+declare function getFieldId(namePath: InternalNamePath, formName?: string): string | undefined;
+export interface FormItemProps<Values = any> extends Omit<FieldProps, "children" | "name" | "onMetaChange" | "isList"> {
+    name?: NamePath;
+    label?: React.ReactNode;
+    /**
+     * A node, or antd's `{ title, icon, placement, ... }` object form. `title`
+     * becomes the tooltip body and `icon` the trigger glyph, rendered behind a
+     * hover/focus target after the label. The other keys describe antd's
+     * overlay and are ignored.
+     */
+    tooltip?: React.ReactNode | FormItemTooltipConfig;
+    extra?: React.ReactNode;
+    /** `false` also suppresses meta bubbling to an ancestor item. */
+    help?: React.ReactNode;
+    /** Overrides the asterisk derived from `rules`. */
+    required?: boolean;
+    /** Render no wrapper; bubble this field's meta to the nearest ancestor item. */
+    noStyle?: boolean;
+    hidden?: boolean;
+    layout?: FormLayout;
+    className?: string;
+    style?: React.CSSProperties;
+    hasFeedback?: boolean;
+    validateStatus?: FormItemStatusContextValue["status"];
+    colon?: boolean;
+    labelAlign?: "left" | "right";
+    labelCol?: FormItemCol;
+    wrapperCol?: FormItemCol;
+    labelWrap?: boolean;
+    htmlFor?: string;
+    id?: string;
+    fieldKey?: React.Key | React.Key[];
+    children?: React.ReactNode | ((form: InternalFormInstance) => React.ReactNode);
+    __values?: Values;
+}
+export interface FormItemTooltipConfig {
+    title?: React.ReactNode;
+    icon?: React.ReactNode;
+    placement?: string;
+    [key: string]: unknown;
+}
+declare const FormItem: <Values>(props: FormItemProps<Values>) => React.JSX.Element;
+/** Errors/warnings of the nearest enclosing `Form.Item`. */
+export declare const useFormItemStatus: () => {
+    status: "" | "success" | "error" | "warning" | "validating" | undefined;
+    errors: React.ReactNode[];
+    warnings: React.ReactNode[];
+};
+export { getFieldId };
+export default FormItem;
+export type { StoreValue };

package/dist/components/Form/FormItem.js

@@ -0,0 +1,164 @@
+import { useUicTranslator as e } from "../../i18n/useUicTranslator.js";
+import { FieldContext as t, FormConfigContext as n, FormItemInputContext as r, FormItemLayoutContext as i, ListContext as a, NoStyleItemContext as o } from "./context.js";
+import { toArray as s } from "./namePath.js";
+import c from "./Field.js";
+import { FormItemVisual as ee } from "./FormItemVisual2.js";
+import * as l from "react";
+import { Fragment as u, jsx as d, jsxs as f } from "react/jsx-runtime";
+//#region src/components/Form/FormItem.tsx
+var te = "__SPLIT__", p = ["parentNode"];
+function m(e, t) {
+	if (!e.length) return;
+	let n = e.join("_");
+	return t ? `${t}_${n}` : p.includes(n) ? `form_item_${n}` : n;
+}
+function h() {
+	return {
+		errors: [],
+		warnings: [],
+		touched: !1,
+		validating: !1,
+		name: [],
+		validated: !1
+	};
+}
+function ne(e, t, n, r, i) {
+	return i === void 0 ? n.validating ? "validating" : e.length ? "error" : t.length ? "warning" : n.touched || r && n.validated ? "success" : "" : i;
+}
+var g = (e) => !!e && typeof e == "object" && !l.isValidElement(e) && "title" in e;
+function re(e) {
+	return g(e) ? e.title : e;
+}
+function _(e) {
+	return g(e) ? e.icon : void 0;
+}
+var v = (u) => {
+	let { name: f, label: p, tooltip: g, extra: v, help: y, required: b, noStyle: x, hidden: S, layout: oe, className: se, style: ce, hasFeedback: C, validateStatus: le, children: w, rules: T, dependencies: E, shouldUpdate: D, messageVariables: O, trigger: k = "onChange", validateTrigger: A, colon: ue, labelAlign: de, labelCol: j, wrapperCol: M, labelWrap: fe, htmlFor: N, fieldKey: pe, id: me, __values: he, ...P } = u, F = l.useContext(t), { optionalLabel: I } = l.useContext(n), L = e(), { layout: R, requiredMark: z, name: ge, disabled: _e, size: ve, colon: ye, labelAlign: be, labelCol: B, wrapperCol: xe, labelWrap: Se } = l.useContext(i), V = l.useContext(o), Ce = l.useContext(a), we = oe || R, Te = j ?? B, H = M ?? xe, Ee = p === null && !j && !M && B?.span !== void 0 && B.span < 24 ? {
+		...H,
+		offset: B.span
+	} : H, U = A === void 0 ? F.validateTrigger : A, [W, De] = l.useState(h), [G, Oe] = l.useState({}), K = l.useRef(null), q = (e) => {
+		let t = Ce?.getKey(e.name);
+		if (De(e.destroy ? h() : e), x && y !== !1 && V) {
+			let n = e.name;
+			if (e.destroy) n = K.current || n;
+			else if (t !== void 0) {
+				let [e, r] = t;
+				n = [e, ...r], K.current = n;
+			}
+			V(e, n);
+		}
+	}, ke = (e, t) => {
+		Oe((n) => {
+			let r = { ...n }, i = [...e.name.slice(0, -1), ...t].join(te);
+			return e.destroy ? delete r[i] : r[i] = e, r;
+		});
+	}, J = [...W.errors, ...Object.values(G).flatMap((e) => e.errors ?? [])], Y = [...W.warnings, ...Object.values(G).flatMap((e) => e.warnings ?? [])], X = (e, t, n, i) => {
+		let a = {
+			status: ne(J, Y, W, C, le),
+			errors: J,
+			warnings: Y,
+			hasFeedback: C,
+			isFormItemInput: !0
+		};
+		if (x && !S) return /* @__PURE__ */ d(r.Provider, {
+			value: a,
+			children: e
+		});
+		let s = z === !1 ? "hidden" : z === "optional" || typeof z == "function" ? "optional" : void 0, c = b === void 0 ? !!n : b, l = ae(p, c, z, I ?? L("uic.Form.optional"));
+		return /* @__PURE__ */ d(r.Provider, {
+			value: a,
+			children: /* @__PURE__ */ d(ee, {
+				label: l,
+				labelTitle: typeof p == "string" ? p : void 0,
+				tooltip: re(g),
+				tooltipIcon: _(g),
+				extra: v,
+				help: y,
+				required: c,
+				requiredMarkType: s,
+				layout: we,
+				size: ve,
+				colon: ue ?? ye,
+				labelAlign: de ?? be,
+				labelCol: Te,
+				wrapperCol: Ee,
+				labelWrap: fe ?? Se,
+				status: a.status,
+				hasFeedback: C,
+				className: se,
+				style: ce,
+				hidden: S,
+				fieldId: t,
+				fieldHandle: i,
+				htmlFor: N,
+				errors: J,
+				warnings: Y,
+				children: /* @__PURE__ */ d(o.Provider, {
+					value: ke,
+					children: e
+				})
+			})
+		});
+	}, Z = f != null, Q = typeof w == "function";
+	if (!Z && !Q && !E) return X(w);
+	let $ = {};
+	return typeof p == "string" ? $.label = p : f && ($.label = String(f)), O && ($ = {
+		...$,
+		...O
+	}), /* @__PURE__ */ d(c, {
+		...P,
+		name: f,
+		rules: T,
+		dependencies: E,
+		shouldUpdate: D,
+		messageVariables: $,
+		trigger: k,
+		validateTrigger: U,
+		onMetaChange: q,
+		children: (e, t, n) => {
+			let r = s(f).length ? t.name : [], i = m(r, ge), a = b === void 0 ? ie(T, n) : b, o = null;
+			if (Q && (D || E) && !Z) o = w(n);
+			else if (l.isValidElement(w)) {
+				let t = w, n = {
+					...t.props,
+					...e
+				};
+				n.id ||= i, r.length && (n["data-uic-field-id"] = r.join("_")), _e && n.disabled === void 0 && (n.disabled = !0);
+				let c = [];
+				(y || J.length > 0) && c.push(`${i}_help`), v && c.push(`${i}_extra`), c.length && (n["aria-describedby"] = c.join(" ")), J.length > 0 && (n["aria-invalid"] = "true"), a && (n["aria-required"] = "true"), (/* @__PURE__ */ new Set([...s(k), ...s(U)])).forEach((r) => {
+					n[r] = (...n) => {
+						e[r]?.(...n), t.props[r]?.(...n);
+					};
+				}), o = l.cloneElement(t, n);
+			} else o = w;
+			return X(o, i, a, r.length ? r.join("_") : void 0);
+		}
+	});
+};
+function ie(e, t) {
+	return !!e?.some((e) => {
+		if (typeof e == "function") {
+			let n = e(t);
+			return !!n?.required && !n?.warningOnly;
+		}
+		return !!e?.required && !e?.warningOnly;
+	});
+}
+function ae(e, t, n, r) {
+	return e == null ? e : typeof n == "function" ? n(e, { required: t }) : n === "optional" && !t ? /* @__PURE__ */ f(u, { children: [e, /* @__PURE__ */ d("span", {
+		className: "uic-form-item__optional",
+		children: r
+	})] }) : e;
+}
+var y = () => {
+	let { status: e, errors: t = [], warnings: n = [] } = l.useContext(r);
+	return {
+		status: e,
+		errors: t,
+		warnings: n
+	};
+};
+//#endregion
+export { v as default, m as getFieldId, y as useFormItemStatus };
+
+//# sourceMappingURL=FormItem.js.map