@lobehub/ui 5.57.3 → 6.0.0-beta.1

package/es/Form/type.d.mts

@@ -3,22 +3,23 @@ import "../Flex/index.mjs";
 import { DivProps } from "../types/index.mjs";
 import { IconProps } from "../Icon/type.mjs";
 import "../Icon/index.mjs";
-import { ButtonProps as ButtonProps$1 } from "../Button/type.mjs";
+import { ButtonProps } from "../Button/type.mjs";
 import "../Button/index.mjs";
-import { CollapseProps as CollapseProps$1 } from "../Collapse/type.mjs";
-import "../Collapse/index.mjs";
-import { TagProps as TagProps$1 } from "../Tag/type.mjs";
+import { TagProps } from "../Tag/type.mjs";
 import "../Tag/index.mjs";
-import { CSSProperties, ReactNode, Ref } from "react";
-import { DividerProps, FormInstance, FormInstance as FormInstance$1, FormProps } from "antd";
-import { FormItemProps } from "antd/es/form/FormItem/index.js";
+import { CSSProperties, ComponentProps, ReactNode, Ref } from "react";
+import { Field } from "@base-ui/react/field";
+import { Form } from "@base-ui/react/form";
 //#region src/Form/type.d.ts
-type FormVariant = 'filled' | 'outlined' | 'borderless';
-type ItemsType = 'group' | 'flat';
-interface FormProps$1 extends Omit<FormProps, 'variant' | 'styles' | 'classNames'> {
+export type FormVariant = 'filled' | 'outlined' | 'borderless';
+export type FormLayout = 'horizontal' | 'vertical';
+export type ItemsType = 'group' | 'flat';
+export type FormValues = Record<string, any>;
+type BaseFormProps = Omit<ComponentProps<typeof Form>, 'render' | 'className' | 'style'>;
+export interface FormProps extends BaseFormProps {
   activeKey?: (string | number)[];
-  children?: ReactNode;
-  classNames?: FormGroupProps['classNames'] & {
+  className?: string;
+  classNames?: {
     group?: string;
     item?: string;
   };
@@ -26,27 +27,45 @@ interface FormProps$1 extends Omit<FormProps, 'variant' | 'styles' | 'classNames
   defaultActiveKey?: (string | number)[];
   footer?: ReactNode;
   gap?: number | string;
-  itemMinWidth?: FormItemProps$1['minWidth'];
-  items?: FormGroupItemType[] | FormItemProps$1[];
+  /**
+   * Initial values distributed to fields as `defaultValue` by name.
+   * Also the baseline for unsaved-changes detection and native reset.
+   */
+  initialValues?: FormValues;
+  itemMinWidth?: FormFieldProps['minWidth'];
+  items?: FormGroupItemType[] | FormFieldProps[];
   itemsType?: ItemsType;
-  itemVariant?: FormProps['variant'];
+  layout?: FormLayout;
   onCollapse?: (key: (string | number)[]) => void;
-  ref?: Ref<FormInstance>;
-  styles?: FormGroupProps['styles'] & {
+  /**
+   * Called with collected field values on submit. Async callbacks drive submit loading state.
+   */
+  onFinish?: (values: FormValues, eventDetails: Parameters<NonNullable<BaseFormProps['onFormSubmit']>>[1]) => void | Promise<void>;
+  ref?: Ref<HTMLFormElement>;
+  style?: CSSProperties;
+  styles?: {
     group?: CSSProperties;
     item?: CSSProperties;
   };
   variant?: FormVariant;
 }
-interface FormDividerProps extends DividerProps {
-  visible?: boolean;
-}
-interface FormFlatGroupProps extends FlexboxProps {
+export interface FormFieldProps extends Omit<ComponentProps<typeof Field.Root>, 'render' | 'children' | 'className' | 'style'> {
+  avatar?: ReactNode;
+  children?: ReactNode;
+  className?: string;
+  desc?: ReactNode;
+  divider?: boolean;
+  hidden?: boolean;
+  label?: ReactNode;
+  layout?: FormLayout;
+  minWidth?: string | number;
+  required?: boolean;
+  style?: CSSProperties;
+  tag?: string;
   variant?: FormVariant;
 }
-type FormFooterProps = DivProps;
-interface FormGroupItemType {
-  children: FormItemProps$1[] | ReactNode;
+export interface FormGroupItemType {
+  children: FormFieldProps[] | ReactNode;
   collapsible?: boolean;
   defaultActive?: boolean;
   desc?: ReactNode;
@@ -56,9 +75,8 @@ interface FormGroupItemType {
   title: ReactNode;
   variant?: FormVariant;
 }
-interface FormGroupProps extends Omit<CollapseProps$1, 'collapsible' | 'items' | 'defaultActiveKey' | 'activeKey' | 'variant'> {
+export interface FormGroupProps extends Omit<DivProps, 'title'> {
   active?: boolean;
-  children: ReactNode;
   collapsible?: boolean;
   defaultActive?: boolean;
   desc?: ReactNode;
@@ -69,24 +87,21 @@ interface FormGroupProps extends Omit<CollapseProps$1, 'collapsible' | 'items' |
   title?: ReactNode;
   variant?: FormVariant;
 }
-interface FormItemProps$1 extends FormItemProps {
-  avatar?: FormTitleProps['avatar'];
-  desc?: FormTitleProps['desc'];
-  divider?: boolean;
-  hidden?: boolean;
-  minWidth?: string | number;
-  tag?: FormTitleProps['tag'];
+export interface FormFlatGroupProps extends FlexboxProps {
   variant?: FormVariant;
 }
-interface FormSubmitFooterProps extends Omit<FlexboxProps, 'onReset'> {
-  buttonProps?: Omit<ButtonProps$1, 'children'>;
-  children?: ReactNode;
+export interface FormDividerProps extends DivProps {
+  visible?: boolean;
+}
+export type FormFooterProps = FlexboxProps;
+export interface FormSubmitFooterProps extends Omit<FlexboxProps, 'onReset'> {
+  buttonProps?: Omit<ButtonProps, 'children'>;
   enableReset?: boolean;
   enableUnsavedWarning?: boolean;
   float?: boolean;
-  onReset?: (value: any, preValue: any) => void;
-  resetButtonProps?: Omit<ButtonProps$1, 'children'>;
-  saveButtonProps?: Omit<ButtonProps$1, 'children'>;
+  onReset?: () => void;
+  resetButtonProps?: Omit<ButtonProps, 'children'>;
+  saveButtonProps?: Omit<ButtonProps, 'children'>;
   texts?: {
     reset?: string;
     submit?: string;
@@ -94,7 +109,7 @@ interface FormSubmitFooterProps extends Omit<FlexboxProps, 'onReset'> {
     unSavedWarning?: string;
   };
 }
-interface FormTitleProps extends Omit<FlexboxProps, 'title'> {
+export interface FormTitleProps extends Omit<FlexboxProps, 'title'> {
   avatar?: ReactNode;
   classNames?: {
     content?: string;
@@ -110,9 +125,17 @@ interface FormTitleProps extends Omit<FlexboxProps, 'title'> {
     title?: CSSProperties;
   };
   tag?: string;
-  tagProps?: Omit<TagProps$1, 'children'>;
+  tagProps?: Omit<TagProps, 'children'>;
   title: ReactNode;
 }
+export interface FormContextValue {
+  hasUnsavedChanges: boolean;
+  initialValues?: FormValues;
+  itemMinWidth?: FormFieldProps['minWidth'];
+  layout: FormLayout;
+  requestReset: () => void;
+  submitLoading: boolean;
+  variant: FormVariant;
+}
 //#endregion
-export { FormDividerProps, FormFlatGroupProps, FormFooterProps, FormGroupItemType, FormGroupProps, type FormInstance$1 as FormInstance, FormItemProps$1 as FormItemProps, FormProps$1 as FormProps, FormSubmitFooterProps, FormTitleProps, FormVariant, ItemsType };
 //# sourceMappingURL=type.d.mts.map

package/es/FormKit/Field.d.mts

@@ -0,0 +1,9 @@
+import { FormFieldProps, FormValues } from "./type.mjs";
+import { ReactNode } from "react";
+//#region src/FormKit/Field.d.ts
+declare const _default: (<T extends FormValues = FormValues>(props: FormFieldProps<T>) => ReactNode) & {
+  displayName?: string;
+};
+//#endregion
+export { _default as default };
+//# sourceMappingURL=Field.d.mts.map

package/es/FormKit/Field.mjs

@@ -0,0 +1,168 @@
+"use client";
+import { styleProps } from "../styles/stylex/props.mjs";
+import { useResponsive } from "../styles/theme/scope.mjs";
+import { useTranslation } from "../i18n/useTranslation.mjs";
+import { fieldLayoutStyles, fieldStyles } from "../Form/style.mjs";
+import FormDivider from "../Form/components/FormDivider.mjs";
+import FormTitle from "../Form/components/FormTitle.mjs";
+import form_default from "../i18n/resources/en/form.mjs";
+import { resolveBinding } from "./binding.mjs";
+import { useFormKitContext } from "./context.mjs";
+import { toFieldValidator } from "./schema.mjs";
+import { getInternals } from "./instance.mjs";
+import { fieldKitStyles } from "./style.mjs";
+import { useStoreSelector } from "./useStoreSelector.mjs";
+import { cloneElement, isValidElement, memo, useCallback, useEffect, useId, useRef } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import * as stylex from "@stylexjs/stylex";
+//#region src/FormKit/Field.tsx
+const isEmpty = (value) => value === void 0 || value === null || value === "" || Array.isArray(value) && value.length === 0;
+const FieldControl = memo(({ bare, children, deps, emptyValue, getValue, id, name, render, required, trigger, validate, validateDebounce, validateOn, valueProp }) => {
+	const { form } = useFormKitContext();
+	const { engine, validateOn: formValidateOn } = getInternals(form);
+	const { t } = useTranslation(form_default);
+	const errorId = `${id}-error`;
+	const requiredMessage = typeof required === "string" ? required : t("form.required");
+	const fieldValidator = validate ? toFieldValidator(validate) : void 0;
+	const validatorRef = useRef(void 0);
+	validatorRef.current = async (value, values) => {
+		if (required && isEmpty(value)) return requiredMessage;
+		return fieldValidator?.(value, values);
+	};
+	const hasValidator = Boolean(required || validate);
+	const depsKey = deps?.join("\0");
+	useEffect(() => engine.registerField(name, {
+		debounceMs: validateDebounce,
+		deps: depsKey ? depsKey.split("\0") : void 0,
+		validate: hasValidator ? (value, values) => validatorRef.current(value, values) : void 0,
+		validateOn: validateOn ?? formValidateOn
+	}), [
+		engine,
+		name,
+		hasValidator,
+		depsKey,
+		validateDebounce,
+		validateOn,
+		formValidateOn
+	]);
+	const field = useStoreSelector(engine, (e) => e.getField(name));
+	const child = isValidElement(children) ? children : void 0;
+	const binding = child ? resolveBinding(child, {
+		emptyValue,
+		getValue,
+		trigger,
+		valueProp
+	}) : void 0;
+	const handlerRef = useRef({
+		binding,
+		childProps: child?.props
+	});
+	handlerRef.current = {
+		binding,
+		childProps: child?.props
+	};
+	const onChange = useCallback((...args) => {
+		const { binding: current, childProps } = handlerRef.current;
+		if (current) childProps?.[current.trigger]?.(...args);
+		const next = current ? current.getValue(...args) : args[0];
+		engine.setValue(name, next, "user");
+	}, [engine, name]);
+	const onBlur = useCallback((...args) => {
+		handlerRef.current.childProps?.onBlur?.(...args);
+		engine.blurField(name);
+	}, [engine, name]);
+	const warnedRef = useRef(false);
+	useEffect(() => {
+		if (render || child || warnedRef.current || process.env.NODE_ENV === "production") return;
+		warnedRef.current = true;
+		console.warn(`[@lobehub/ui/form] Form.Field "${name}" needs a single element child or a render prop; nothing was bound.`);
+	}, [
+		render,
+		child,
+		name
+	]);
+	const errorNode = field.error && !bare ? /* @__PURE__ */ jsx("div", {
+		...stylex.props(fieldStyles.error),
+		id: errorId,
+		children: field.error
+	}) : null;
+	if (render) {
+		const renderProps = {
+			error: field.error,
+			name,
+			onBlur,
+			onChange,
+			touched: field.touched,
+			validating: field.validating,
+			value: field.value
+		};
+		return /* @__PURE__ */ jsxs(Fragment$1, { children: [render(renderProps), errorNode] });
+	}
+	if (!child || !binding) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	const control = cloneElement(child, {
+		"aria-describedby": field.error ? errorId : void 0,
+		"aria-invalid": field.error ? true : void 0,
+		"id": child.props.id ?? id,
+		[binding.trigger]: onChange,
+		[binding.valueProp]: field.value === void 0 ? binding.emptyValue : field.value,
+		"onBlur": onBlur
+	});
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [control, errorNode] });
+});
+FieldControl.displayName = "FormFieldControl";
+const FormField = memo(({ avatar, bare, children, className, deps, desc, divider, emptyValue, extra, getValue, hidden, label, layout, minWidth, name, render, required, style, tag, trigger, validate, validateDebounce, validateOn, valueProp, variant }) => {
+	const id = useId();
+	const { mobile } = useResponsive();
+	const config = useFormKitContext();
+	if (hidden) return null;
+	const control = !name ? children : /* @__PURE__ */ jsx(FieldControl, {
+		bare,
+		deps,
+		emptyValue,
+		getValue,
+		id,
+		name,
+		render,
+		required,
+		trigger,
+		validate,
+		validateDebounce,
+		validateOn,
+		valueProp,
+		children
+	});
+	if (bare) return /* @__PURE__ */ jsx(Fragment$1, { children: control });
+	const labelFor = render ? void 0 : name ? id : isValidElement(children) ? children.props.id : void 0;
+	const mergedLayout = layout || (mobile ? "vertical" : config.layout);
+	const mergedVariant = variant || config.variant;
+	const controlWidth = mergedLayout === "vertical" || minWidth === void 0 || minWidth === "" ? void 0 : typeof minWidth === "number" ? `${minWidth}px` : minWidth;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [divider && /* @__PURE__ */ jsx(FormDivider, { visible: mergedVariant !== "borderless" }), /* @__PURE__ */ jsxs("div", {
+		...styleProps([fieldStyles.root, fieldLayoutStyles[mergedLayout]], className, style),
+		children: [/* @__PURE__ */ jsx("label", {
+			...stylex.props(fieldStyles.label),
+			htmlFor: labelFor,
+			children: /* @__PURE__ */ jsx(FormTitle, {
+				avatar,
+				desc,
+				tag,
+				title: required ? /* @__PURE__ */ jsxs(Fragment$1, { children: [label, /* @__PURE__ */ jsx("span", {
+					"aria-hidden": true,
+					...stylex.props(fieldKitStyles.required),
+					children: "*"
+				})] }) : label
+			})
+		}), /* @__PURE__ */ jsxs("div", {
+			...stylex.props(fieldStyles.control, mergedLayout === "vertical" && fieldStyles.controlVertical, Boolean(controlWidth) && fieldKitStyles.controlFixed),
+			style: controlWidth ? { width: controlWidth } : void 0,
+			children: [control, extra && /* @__PURE__ */ jsx("div", {
+				...stylex.props(fieldKitStyles.extra),
+				children: extra
+			})]
+		})]
+	})] });
+});
+FormField.displayName = "FormField";
+//#endregion
+export { FormField as default };
+
+//# sourceMappingURL=Field.mjs.map

package/es/FormKit/Field.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.mjs","names":["formMessages"],"sources":["../../src/FormKit/Field.tsx"],"sourcesContent":["'use client';\n\nimport * as stylex from '@stylexjs/stylex';\nimport {\n  cloneElement,\n  isValidElement,\n  memo,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useId,\n  useRef,\n} from 'react';\n\nimport formMessages from '@/i18n/resources/en/form';\nimport { useTranslation } from '@/i18n/useTranslation';\nimport { styleProps } from '@/styles/stylex/props';\nimport { useResponsive } from '@/styles/theme/scope';\n\nimport FormDivider from '../Form/components/FormDivider';\nimport FormTitle from '../Form/components/FormTitle';\nimport { fieldLayoutStyles, fieldStyles } from '../Form/style';\nimport { resolveBinding } from './binding';\nimport { useFormKitContext } from './context';\nimport type { FieldValidator } from './engine/types';\nimport { getInternals } from './instance';\nimport { toFieldValidator } from './schema';\nimport { fieldKitStyles } from './style';\nimport type { FieldRenderProps, FormFieldProps, FormValues } from './type';\nimport { useStoreSelector } from './useStoreSelector';\n\nconst isEmpty = (value: unknown) =>\n  value === undefined ||\n  value === null ||\n  value === '' ||\n  (Array.isArray(value) && value.length === 0);\n\ntype ControlProps = Pick<\n  FormFieldProps,\n  | 'bare'\n  | 'children'\n  | 'deps'\n  | 'emptyValue'\n  | 'getValue'\n  | 'name'\n  | 'render'\n  | 'required'\n  | 'trigger'\n  | 'validate'\n  | 'validateDebounce'\n  | 'validateOn'\n  | 'valueProp'\n> & { id: string; name: string };\n\nconst FieldControl = memo<ControlProps>(\n  ({\n    bare,\n    children,\n    deps,\n    emptyValue,\n    getValue,\n    id,\n    name,\n    render,\n    required,\n    trigger,\n    validate,\n    validateDebounce,\n    validateOn,\n    valueProp,\n  }) => {\n    const { form } = useFormKitContext();\n    const { engine, validateOn: formValidateOn } = getInternals(form);\n    const { t } = useTranslation(formMessages);\n    const errorId = `${id}-error`;\n\n    const requiredMessage = typeof required === 'string' ? required : t('form.required');\n    const fieldValidator = validate ? toFieldValidator(validate) : undefined;\n    const validatorRef = useRef<FieldValidator | undefined>(undefined);\n    validatorRef.current = async (value, values) => {\n      if (required && isEmpty(value)) return requiredMessage;\n      return fieldValidator?.(value, values);\n    };\n    const hasValidator = Boolean(required || validate);\n    const depsKey = deps?.join('\\u0000');\n\n    useEffect(\n      () =>\n        engine.registerField(name, {\n          debounceMs: validateDebounce,\n          deps: depsKey ? depsKey.split('\\u0000') : undefined,\n          validate: hasValidator\n            ? (value, values) => validatorRef.current!(value, values)\n            : undefined,\n          validateOn: validateOn ?? formValidateOn,\n        }),\n      [engine, name, hasValidator, depsKey, validateDebounce, validateOn, formValidateOn],\n    );\n\n    const field = useStoreSelector(engine, (e) => e.getField(name));\n\n    const child = isValidElement(children) ? (children as ReactElement<any>) : undefined;\n    const binding = child\n      ? resolveBinding(child, { emptyValue, getValue, trigger, valueProp })\n      : undefined;\n    const handlerRef = useRef({ binding, childProps: child?.props as Record<string, any> });\n    handlerRef.current = { binding, childProps: child?.props as Record<string, any> };\n\n    const onChange = useCallback(\n      (...args: unknown[]) => {\n        const { binding: current, childProps } = handlerRef.current;\n        if (current) childProps?.[current.trigger]?.(...args);\n        const next = current ? current.getValue(...args) : args[0];\n        engine.setValue(name, next, 'user');\n      },\n      [engine, name],\n    );\n    const onBlur = useCallback(\n      (...args: unknown[]) => {\n        handlerRef.current.childProps?.onBlur?.(...args);\n        engine.blurField(name);\n      },\n      [engine, name],\n    );\n\n    const warnedRef = useRef(false);\n    useEffect(() => {\n      if (render || child || warnedRef.current || process.env.NODE_ENV === 'production') return;\n      warnedRef.current = true;\n      console.warn(\n        `[@lobehub/ui/form] Form.Field \"${name}\" needs a single element child or a render prop; nothing was bound.`,\n      );\n    }, [render, child, name]);\n\n    const errorNode =\n      field.error && !bare ? (\n        <div {...stylex.props(fieldStyles.error)} id={errorId}>\n          {field.error}\n        </div>\n      ) : null;\n\n    if (render) {\n      const renderProps: FieldRenderProps = {\n        error: field.error,\n        name,\n        onBlur,\n        onChange,\n        touched: field.touched,\n        validating: field.validating,\n        value: field.value,\n      };\n      return (\n        <>\n          {render(renderProps)}\n          {errorNode}\n        </>\n      );\n    }\n\n    if (!child || !binding) return <>{children}</>;\n\n    const control = cloneElement(child, {\n      'aria-describedby': field.error ? errorId : undefined,\n      'aria-invalid': field.error ? true : undefined,\n      'id': child.props.id ?? id,\n      [binding.trigger]: onChange,\n      [binding.valueProp]: field.value === undefined ? binding.emptyValue : field.value,\n      'onBlur': onBlur,\n    });\n\n    return (\n      <>\n        {control}\n        {errorNode}\n      </>\n    );\n  },\n);\n\nFieldControl.displayName = 'FormFieldControl';\n\nconst FormField = memo<FormFieldProps>(\n  ({\n    avatar,\n    bare,\n    children,\n    className,\n    deps,\n    desc,\n    divider,\n    emptyValue,\n    extra,\n    getValue,\n    hidden,\n    label,\n    layout,\n    minWidth,\n    name,\n    render,\n    required,\n    style,\n    tag,\n    trigger,\n    validate,\n    validateDebounce,\n    validateOn,\n    valueProp,\n    variant,\n  }) => {\n    const id = useId();\n    const { mobile } = useResponsive();\n    const config = useFormKitContext();\n\n    if (hidden) return null;\n\n    const control = !name ? (\n      children\n    ) : (\n      <FieldControl\n        bare={bare}\n        deps={deps}\n        emptyValue={emptyValue}\n        getValue={getValue}\n        id={id}\n        name={name}\n        render={render}\n        required={required}\n        trigger={trigger}\n        validate={validate}\n        validateDebounce={validateDebounce}\n        validateOn={validateOn}\n        valueProp={valueProp}\n      >\n        {children}\n      </FieldControl>\n    );\n\n    if (bare) return <>{control}</>;\n\n    const labelFor = render\n      ? undefined\n      : name\n        ? id\n        : isValidElement<{ id?: string }>(children)\n          ? children.props.id\n          : undefined;\n    const mergedLayout = layout || (mobile ? 'vertical' : config.layout);\n    const mergedVariant = variant || config.variant;\n    const controlWidth =\n      mergedLayout === 'vertical' || minWidth === undefined || minWidth === ''\n        ? undefined\n        : typeof minWidth === 'number'\n          ? `${minWidth}px`\n          : minWidth;\n\n    return (\n      <>\n        {divider && <FormDivider visible={mergedVariant !== 'borderless'} />}\n        <div {...styleProps([fieldStyles.root, fieldLayoutStyles[mergedLayout]], className, style)}>\n          <label {...stylex.props(fieldStyles.label)} htmlFor={labelFor}>\n            <FormTitle\n              avatar={avatar}\n              desc={desc}\n              tag={tag}\n              title={\n                required ? (\n                  <>\n                    {label}\n                    <span aria-hidden {...stylex.props(fieldKitStyles.required)}>\n                      *\n                    </span>\n                  </>\n                ) : (\n                  label\n                )\n              }\n            />\n          </label>\n          <div\n            {...stylex.props(\n              fieldStyles.control,\n              mergedLayout === 'vertical' && fieldStyles.controlVertical,\n              Boolean(controlWidth) && fieldKitStyles.controlFixed,\n            )}\n            style={controlWidth ? { width: controlWidth } : undefined}\n          >\n            {control}\n            {extra && <div {...stylex.props(fieldKitStyles.extra)}>{extra}</div>}\n          </div>\n        </div>\n      </>\n    );\n  },\n);\n\nFormField.displayName = 'FormField';\n\nexport default FormField as unknown as (<T extends FormValues = FormValues>(\n  props: FormFieldProps<T>,\n) => ReactNode) & { displayName?: string };\n"],"mappings":"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"}

package/es/FormKit/Form.mjs

@@ -0,0 +1,101 @@
+"use client";
+import { styleProps } from "../styles/stylex/props.mjs";
+import { useResponsive } from "../styles/theme/scope.mjs";
+import { formMarker } from "../Form/marker.stylex.mjs";
+import { rootStyles } from "../Form/style.mjs";
+import FormFlatGroup from "../Form/components/FormFlatGroup.mjs";
+import FormGroup from "../Form/components/FormGroup.mjs";
+import { FormKitContext } from "./context.mjs";
+import FormField from "./Field.mjs";
+import { useCallback, useMemo, useRef } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/FormKit/Form.tsx
+const focusFirstInvalid = (root) => {
+	const target = root?.querySelector("[aria-invalid=\"true\"]");
+	if (!target) return;
+	target.scrollIntoView?.({ block: "center" });
+	target.focus();
+};
+const Form = ({ activeKey, children, className, classNames, collapsible, defaultActiveKey, footer, form, gap, itemMinWidth, items, itemsType = "group", layout, onCollapse, ref, style, styles: customStyles, variant = "borderless", ...rest }) => {
+	const { mobile } = useResponsive();
+	const formRef = useRef(null);
+	const context = useMemo(() => ({
+		form,
+		layout: layout || (mobile ? "vertical" : "horizontal"),
+		variant
+	}), [
+		form,
+		layout,
+		mobile,
+		variant
+	]);
+	const mergedRef = useCallback((node) => {
+		formRef.current = node;
+		if (typeof ref === "function") ref(node);
+		else if (ref) ref.current = node;
+	}, [ref]);
+	const handleSubmit = useCallback(async (event) => {
+		event.preventDefault();
+		if (!(await form.submit()).valid) setTimeout(() => focusFirstInvalid(formRef.current), 0);
+	}, [form]);
+	const renderField = (item, index) => /* @__PURE__ */ jsx(FormField, {
+		className: classNames?.item,
+		divider: index !== 0,
+		style: customStyles?.item,
+		...item,
+		minWidth: "minWidth" in item ? item.minWidth : itemMinWidth
+	}, item.name ?? index);
+	const renderGroup = (group, index) => {
+		const key = group.key ?? index;
+		return /* @__PURE__ */ jsx(FormGroup, {
+			active: activeKey && group.key ? activeKey.includes(key) : void 0,
+			className: classNames?.group,
+			collapsible: group.collapsible ?? collapsible,
+			desc: group.desc,
+			extra: group.extra,
+			icon: group.icon,
+			style: customStyles?.group,
+			title: group.title,
+			variant: group.variant || variant,
+			defaultActive: defaultActiveKey && group.key ? defaultActiveKey.includes(key) : group.defaultActive,
+			onCollapse: (active) => {
+				const keys = (activeKey || defaultActiveKey || []).filter((k) => k !== key);
+				onCollapse?.(active ? [...keys, key] : keys);
+			},
+			children: Array.isArray(group.children) ? group.children.filter((item) => !item.hidden).map(renderField) : group.children
+		}, key);
+	};
+	const renderedItems = items && items.length > 0 ? itemsType === "group" ? items.map(renderGroup) : /* @__PURE__ */ jsx(FormFlatGroup, {
+		className: classNames?.group,
+		style: customStyles?.group,
+		variant,
+		children: items.filter((item) => !item.hidden).map(renderField)
+	}) : null;
+	return /* @__PURE__ */ jsx(FormKitContext, {
+		value: context,
+		children: /* @__PURE__ */ jsxs("form", {
+			...rest,
+			noValidate: true,
+			ref: mergedRef,
+			...styleProps([
+				formMarker,
+				rootStyles.root,
+				variant === "borderless" && rootStyles.borderless
+			], className, {
+				gap: gap ?? (layout === "vertical" ? 0 : void 0),
+				...style
+			}),
+			onSubmit: handleSubmit,
+			children: [
+				renderedItems,
+				children,
+				footer
+			]
+		})
+	});
+};
+Form.displayName = "Form";
+//#endregion
+export { Form as default };
+
+//# sourceMappingURL=Form.mjs.map

package/es/FormKit/Form.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.mjs","names":[],"sources":["../../src/FormKit/Form.tsx"],"sourcesContent":["'use client';\n\nimport { type FormEvent, useCallback, useMemo, useRef } from 'react';\n\nimport { styleProps } from '@/styles/stylex/props';\nimport { useResponsive } from '@/styles/theme/scope';\n\nimport FormFlatGroup from '../Form/components/FormFlatGroup';\nimport FormGroup from '../Form/components/FormGroup';\nimport { formMarker } from '../Form/marker.stylex';\nimport { rootStyles } from '../Form/style';\nimport { FormKitContext, type FormKitContextValue } from './context';\nimport FormField from './Field';\nimport type { FormFieldProps, FormGroupItem, FormProps, FormValues } from './type';\n\nconst focusFirstInvalid = (root: HTMLFormElement | null) => {\n  const target = root?.querySelector<HTMLElement>('[aria-invalid=\"true\"]');\n  if (!target) return;\n  target.scrollIntoView?.({ block: 'center' });\n  target.focus();\n};\n\nconst Form = <T extends FormValues>({\n  activeKey,\n  children,\n  className,\n  classNames,\n  collapsible,\n  defaultActiveKey,\n  footer,\n  form,\n  gap,\n  itemMinWidth,\n  items,\n  itemsType = 'group',\n  layout,\n  onCollapse,\n  ref,\n  style,\n  styles: customStyles,\n  variant = 'borderless',\n  ...rest\n}: FormProps<T>) => {\n  const { mobile } = useResponsive();\n  const formRef = useRef<HTMLFormElement | null>(null);\n\n  const context = useMemo<FormKitContextValue>(\n    () => ({\n      form,\n      layout: layout || (mobile ? 'vertical' : 'horizontal'),\n      variant,\n    }),\n    [form, layout, mobile, variant],\n  );\n\n  const mergedRef = useCallback(\n    (node: HTMLFormElement | null) => {\n      formRef.current = node;\n      if (typeof ref === 'function') ref(node);\n      else if (ref) ref.current = node;\n    },\n    [ref],\n  );\n\n  const handleSubmit = useCallback(\n    async (event: FormEvent<HTMLFormElement>) => {\n      event.preventDefault();\n      const result = await form.submit();\n      if (!result.valid) setTimeout(() => focusFirstInvalid(formRef.current), 0);\n    },\n    [form],\n  );\n\n  const renderField = (item: FormFieldProps<T>, index: number) => (\n    <FormField\n      className={classNames?.item}\n      divider={index !== 0}\n      key={item.name ?? index}\n      style={customStyles?.item}\n      {...(item as FormFieldProps)}\n      minWidth={'minWidth' in item ? item.minWidth : itemMinWidth}\n    />\n  );\n\n  const renderGroup = (group: FormGroupItem<T>, index: number) => {\n    const key = group.key ?? index;\n    return (\n      <FormGroup\n        active={activeKey && group.key ? activeKey.includes(key) : undefined}\n        className={classNames?.group}\n        collapsible={group.collapsible ?? collapsible}\n        desc={group.desc}\n        extra={group.extra}\n        icon={group.icon}\n        key={key}\n        style={customStyles?.group}\n        title={group.title}\n        variant={group.variant || variant}\n        defaultActive={\n          defaultActiveKey && group.key ? defaultActiveKey.includes(key) : group.defaultActive\n        }\n        onCollapse={(active) => {\n          const keys = (activeKey || defaultActiveKey || []).filter((k) => k !== key);\n          onCollapse?.(active ? [...keys, key] : keys);\n        }}\n      >\n        {Array.isArray(group.children)\n          ? group.children.filter((item) => !item.hidden).map(renderField)\n          : group.children}\n      </FormGroup>\n    );\n  };\n\n  const renderedItems =\n    items && items.length > 0 ? (\n      itemsType === 'group' ? (\n        (items as FormGroupItem<T>[]).map(renderGroup)\n      ) : (\n        <FormFlatGroup className={classNames?.group} style={customStyles?.group} variant={variant}>\n          {(items as FormFieldProps<T>[]).filter((item) => !item.hidden).map(renderField)}\n        </FormFlatGroup>\n      )\n    ) : null;\n\n  return (\n    <FormKitContext value={context}>\n      <form\n        {...rest}\n        noValidate\n        ref={mergedRef}\n        {...styleProps(\n          [formMarker, rootStyles.root, variant === 'borderless' && rootStyles.borderless],\n          className,\n          { gap: gap ?? (layout === 'vertical' ? 0 : undefined), ...style },\n        )}\n        onSubmit={handleSubmit}\n      >\n        {renderedItems}\n        {children}\n        {footer}\n      </form>\n    </FormKitContext>\n  );\n};\n\nForm.displayName = 'Form';\n\nexport default Form;\n"],"mappings":";;;;;;;;;;;;AAeA,MAAM,qBAAqB,SAAiC;CAC1D,MAAM,SAAS,MAAM,cAA2B,yBAAuB;CACvE,IAAI,CAAC,QAAQ;CACb,OAAO,iBAAiB,EAAE,OAAO,SAAS,CAAC;CAC3C,OAAO,MAAM;AACf;AAEA,MAAM,QAA8B,EAClC,WACA,UACA,WACA,YACA,aACA,kBACA,QACA,MACA,KACA,cACA,OACA,YAAY,SACZ,QACA,YACA,KACA,OACA,QAAQ,cACR,UAAU,cACV,GAAG,WACe;CAClB,MAAM,EAAE,WAAW,cAAc;CACjC,MAAM,UAAU,OAA+B,IAAI;CAEnD,MAAM,UAAU,eACP;EACL;EACA,QAAQ,WAAW,SAAS,aAAa;EACzC;CACF,IACA;EAAC;EAAM;EAAQ;EAAQ;CAAO,CAChC;CAEA,MAAM,YAAY,aACf,SAAiC;EAChC,QAAQ,UAAU;EAClB,IAAI,OAAO,QAAQ,YAAY,IAAI,IAAI;OAClC,IAAI,KAAK,IAAI,UAAU;CAC9B,GACA,CAAC,GAAG,CACN;CAEA,MAAM,eAAe,YACnB,OAAO,UAAsC;EAC3C,MAAM,eAAe;EAErB,IAAI,EAAC,MADgB,KAAK,OAAO,EAAA,CACrB,OAAO,iBAAiB,kBAAkB,QAAQ,OAAO,GAAG,CAAC;CAC3E,GACA,CAAC,IAAI,CACP;CAEA,MAAM,eAAe,MAAyB,UAC5C,oBAAC,WAAD;EACE,WAAW,YAAY;EACvB,SAAS,UAAU;EAEnB,OAAO,cAAc;EACrB,GAAK;EACL,UAAU,cAAc,OAAO,KAAK,WAAW;CAChD,GAJM,KAAK,QAAQ,KAInB;CAGH,MAAM,eAAe,OAAyB,UAAkB;EAC9D,MAAM,MAAM,MAAM,OAAO;EACzB,OACE,oBAAC,WAAD;GACE,QAAQ,aAAa,MAAM,MAAM,UAAU,SAAS,GAAG,IAAI,KAAA;GAC3D,WAAW,YAAY;GACvB,aAAa,MAAM,eAAe;GAClC,MAAM,MAAM;GACZ,OAAO,MAAM;GACb,MAAM,MAAM;GAEZ,OAAO,cAAc;GACrB,OAAO,MAAM;GACb,SAAS,MAAM,WAAW;GAC1B,eACE,oBAAoB,MAAM,MAAM,iBAAiB,SAAS,GAAG,IAAI,MAAM;GAEzE,aAAa,WAAW;IACtB,MAAM,QAAQ,aAAa,oBAAoB,CAAC,EAAA,CAAG,QAAQ,MAAM,MAAM,GAAG;IAC1E,aAAa,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,IAAI;GAC7C;GAEC,UAAA,MAAM,QAAQ,MAAM,QAAQ,IACzB,MAAM,SAAS,QAAQ,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,WAAW,IAC7D,MAAM;EACD,GAfJ,GAeI;CAEf;CAEA,MAAM,gBACJ,SAAS,MAAM,SAAS,IACtB,cAAc,UACX,MAA6B,IAAI,WAAW,IAE7C,oBAAC,eAAD;EAAe,WAAW,YAAY;EAAO,OAAO,cAAc;EAAgB;EAC9E,UAAA,MAA8B,QAAQ,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,WAAW;CACjE,CAAA,IAEf;CAEN,OACE,oBAAC,gBAAD;EAAgB,OAAO;EACrB,UAAA,qBAAC,QAAD;GACE,GAAI;GACJ,YAAA;GACA,KAAK;GACL,GAAI,WACF;IAAC;IAAY,WAAW;IAAM,YAAY,gBAAgB,WAAW;GAAU,GAC/E,WACA;IAAE,KAAK,QAAQ,WAAW,aAAa,IAAI,KAAA;IAAY,GAAG;GAAM,CAClE;GACA,UAAU;GATZ,UAAA;IAWG;IACA;IACA;GACG;;CACQ,CAAA;AAEpB;AAEA,KAAK,cAAc"}

package/es/FormKit/List.d.mts

@@ -0,0 +1,34 @@
+import { FieldValidate } from "./schema.mjs";
+import { ReactElement, ReactNode } from "react";
+//#region src/FormKit/List.d.ts
+export interface FormListField {
+  index: number;
+  key: string;
+  name: string;
+}
+export interface FormListRenderProps {
+  add: (item?: unknown) => void;
+  fields: FormListField[];
+  move: (from: number, to: number) => void;
+  remove: (index: number) => void;
+}
+export interface FormListColumn {
+  children: ReactElement;
+  flex?: number;
+  name: string;
+  required?: boolean | string;
+  title?: ReactNode;
+  validate?: FieldValidate;
+}
+export interface FormListProps {
+  addText?: ReactNode;
+  children?: (props: FormListRenderProps) => ReactNode;
+  columns?: FormListColumn[];
+  emptyText?: ReactNode;
+  name: string;
+  newItem?: unknown;
+}
+declare const FormList: import("react").NamedExoticComponent<FormListProps>;
+//#endregion
+export { FormList as default };
+//# sourceMappingURL=List.d.mts.map

package/es/FormKit/List.mjs

@@ -0,0 +1,105 @@
+"use client";
+import ActionIcon from "../ActionIcon/ActionIcon.mjs";
+import { useTranslation } from "../i18n/useTranslation.mjs";
+import form_default from "../i18n/resources/en/form.mjs";
+import { useFormKitContext } from "./context.mjs";
+import { getInternals } from "./instance.mjs";
+import { listStyles } from "./style.mjs";
+import { useStoreSelector } from "./useStoreSelector.mjs";
+import FormField from "./Field.mjs";
+import { cloneElement, createElement, memo, useCallback, useRef } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import * as stylex from "@stylexjs/stylex";
+import { PlusIcon, XIcon } from "lucide-react";
+//#region src/FormKit/List.tsx
+let rowSeed = 0;
+const nextRowKey = () => `row-${rowSeed += 1}`;
+const createItem = (newItem) => typeof newItem === "function" ? newItem() : newItem && typeof newItem === "object" ? structuredClone(newItem) : newItem ?? {};
+const labelFor = (column, index) => column.children.props["aria-label"] ?? (typeof column.title === "string" ? `${column.title} ${index + 1}` : void 0);
+const FormList = memo(({ addText, children, columns, emptyText, name, newItem }) => {
+	const { form } = useFormKitContext();
+	const { engine } = getInternals(form);
+	const { t } = useTranslation(form_default);
+	const length = useStoreSelector(engine, (e) => {
+		const value = e.getValue(name);
+		return Array.isArray(value) ? value.length : 0;
+	});
+	const keysRef = useRef([]);
+	const keys = keysRef.current;
+	if (keys.length > length) keys.length = length;
+	while (keys.length < length) keys.push(nextRowKey());
+	const add = useCallback((item) => {
+		keysRef.current.push(nextRowKey());
+		engine.pushItem(name, item);
+	}, [engine, name]);
+	const remove = useCallback((index) => {
+		keysRef.current.splice(index, 1);
+		engine.removeItem(name, index);
+	}, [engine, name]);
+	const move = useCallback((from, to) => {
+		const [moved] = keysRef.current.splice(from, 1);
+		keysRef.current.splice(to, 0, moved);
+		engine.moveItem(name, from, to);
+	}, [engine, name]);
+	const fields = keys.map((key, index) => ({
+		index,
+		key,
+		name: `${name}.${index}`
+	}));
+	if (children || !columns) return /* @__PURE__ */ jsx(Fragment$1, { children: children?.({
+		add,
+		fields,
+		move,
+		remove
+	}) });
+	const gridTemplateColumns = `${columns.map((c) => `minmax(0, ${c.flex ?? 1}fr)`).join(" ")} 36px`;
+	const addButton = /* @__PURE__ */ jsxs("button", {
+		...stylex.props(listStyles.add),
+		type: "button",
+		onClick: () => add(createItem(newItem)),
+		children: [/* @__PURE__ */ jsx(PlusIcon, { size: 14 }), addText ?? t("form.list.add")]
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		...stylex.props(listStyles.table),
+		children: [/* @__PURE__ */ jsx("div", {
+			...stylex.props(listStyles.head),
+			style: { gridTemplateColumns },
+			children: columns.map((column) => /* @__PURE__ */ createElement("div", {
+				...stylex.props(listStyles.title),
+				key: column.name
+			}, column.title))
+		}), fields.length === 0 ? /* @__PURE__ */ jsxs("div", {
+			...stylex.props(listStyles.empty),
+			children: [/* @__PURE__ */ jsx("span", { children: emptyText ?? t("form.list.empty") }), addButton]
+		}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [fields.map((field) => /* @__PURE__ */ createElement("div", {
+			...stylex.props(listStyles.row),
+			key: field.key,
+			style: { gridTemplateColumns }
+		}, columns.map((column) => /* @__PURE__ */ jsx("div", {
+			className: clsx("lobe-form-list-cell", stylex.props(listStyles.cell).className),
+			children: /* @__PURE__ */ jsx(FormField, {
+				bare: true,
+				name: `${field.name}.${column.name}`,
+				required: column.required,
+				validate: column.validate,
+				children: cloneElement(column.children, { "aria-label": labelFor(column, field.index) })
+			})
+		}, column.name)), /* @__PURE__ */ jsx(ActionIcon, {
+			...stylex.props(listStyles.remove),
+			"aria-label": t("form.list.remove"),
+			icon: XIcon,
+			size: "small",
+			title: t("form.list.remove"),
+			onClick: () => remove(field.index)
+		}))), /* @__PURE__ */ jsx("div", {
+			...stylex.props(listStyles.foot),
+			children: addButton
+		})] })]
+	});
+});
+FormList.displayName = "FormList";
+//#endregion
+export { FormList as default };
+
+//# sourceMappingURL=List.mjs.map

package/es/FormKit/List.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"List.mjs","names":["formMessages"],"sources":["../../src/FormKit/List.tsx"],"sourcesContent":["'use client';\n\nimport './style.css';\n\nimport * as stylex from '@stylexjs/stylex';\nimport clsx from 'clsx';\nimport { PlusIcon, XIcon } from 'lucide-react';\nimport { cloneElement, memo, type ReactElement, type ReactNode, useCallback, useRef } from 'react';\n\nimport ActionIcon from '@/ActionIcon';\nimport formMessages from '@/i18n/resources/en/form';\nimport { useTranslation } from '@/i18n/useTranslation';\n\nimport { useFormKitContext } from './context';\nimport FormField from './Field';\nimport { getInternals } from './instance';\nimport type { FieldValidate } from './schema';\nimport { listStyles } from './style';\nimport { useStoreSelector } from './useStoreSelector';\n\nexport interface FormListField {\n  index: number;\n  key: string;\n  name: string;\n}\n\nexport interface FormListRenderProps {\n  add: (item?: unknown) => void;\n  fields: FormListField[];\n  move: (from: number, to: number) => void;\n  remove: (index: number) => void;\n}\n\nexport interface FormListColumn {\n  children: ReactElement;\n  flex?: number;\n  name: string;\n  required?: boolean | string;\n  title?: ReactNode;\n  validate?: FieldValidate;\n}\n\nexport interface FormListProps {\n  addText?: ReactNode;\n  children?: (props: FormListRenderProps) => ReactNode;\n  columns?: FormListColumn[];\n  emptyText?: ReactNode;\n  name: string;\n  newItem?: unknown;\n}\n\nlet rowSeed = 0;\nconst nextRowKey = () => `row-${(rowSeed += 1)}`;\n\nconst createItem = (newItem: unknown) =>\n  typeof newItem === 'function'\n    ? newItem()\n    : newItem && typeof newItem === 'object'\n      ? structuredClone(newItem)\n      : (newItem ?? {});\n\nconst labelFor = (column: FormListColumn, index: number) =>\n  (column.children as ReactElement<{ 'aria-label'?: string }>).props['aria-label'] ??\n  (typeof column.title === 'string' ? `${column.title} ${index + 1}` : undefined);\n\nconst FormList = memo<FormListProps>(({ addText, children, columns, emptyText, name, newItem }) => {\n  const { form } = useFormKitContext();\n  const { engine } = getInternals(form);\n  const { t } = useTranslation(formMessages);\n  const length = useStoreSelector(engine, (e) => {\n    const value = e.getValue(name);\n    return Array.isArray(value) ? value.length : 0;\n  });\n\n  const keysRef = useRef<string[]>([]);\n  const keys = keysRef.current;\n  if (keys.length > length) keys.length = length;\n  while (keys.length < length) keys.push(nextRowKey());\n\n  const add = useCallback(\n    (item?: unknown) => {\n      keysRef.current.push(nextRowKey());\n      engine.pushItem(name, item);\n    },\n    [engine, name],\n  );\n  const remove = useCallback(\n    (index: number) => {\n      keysRef.current.splice(index, 1);\n      engine.removeItem(name, index);\n    },\n    [engine, name],\n  );\n  const move = useCallback(\n    (from: number, to: number) => {\n      const [moved] = keysRef.current.splice(from, 1);\n      keysRef.current.splice(to, 0, moved);\n      engine.moveItem(name, from, to);\n    },\n    [engine, name],\n  );\n\n  const fields = keys.map((key, index) => ({ index, key, name: `${name}.${index}` }));\n\n  if (children || !columns) return <>{children?.({ add, fields, move, remove })}</>;\n\n  const gridTemplateColumns = `${columns.map((c) => `minmax(0, ${c.flex ?? 1}fr)`).join(' ')} 36px`;\n  const addButton = (\n    <button\n      {...stylex.props(listStyles.add)}\n      type=\"button\"\n      onClick={() => add(createItem(newItem))}\n    >\n      <PlusIcon size={14} />\n      {addText ?? t('form.list.add')}\n    </button>\n  );\n\n  return (\n    <div {...stylex.props(listStyles.table)}>\n      <div {...stylex.props(listStyles.head)} style={{ gridTemplateColumns }}>\n        {columns.map((column) => (\n          <div {...stylex.props(listStyles.title)} key={column.name}>\n            {column.title}\n          </div>\n        ))}\n      </div>\n      {fields.length === 0 ? (\n        <div {...stylex.props(listStyles.empty)}>\n          <span>{emptyText ?? t('form.list.empty')}</span>\n          {addButton}\n        </div>\n      ) : (\n        <>\n          {fields.map((field) => (\n            <div {...stylex.props(listStyles.row)} key={field.key} style={{ gridTemplateColumns }}>\n              {columns.map((column) => (\n                <div\n                  className={clsx('lobe-form-list-cell', stylex.props(listStyles.cell).className)}\n                  key={column.name}\n                >\n                  <FormField\n                    bare\n                    name={`${field.name}.${column.name}`}\n                    required={column.required}\n                    validate={column.validate}\n                  >\n                    {cloneElement(column.children as ReactElement<any>, {\n                      'aria-label': labelFor(column, field.index),\n                    })}\n                  </FormField>\n                </div>\n              ))}\n              <ActionIcon\n                {...stylex.props(listStyles.remove)}\n                aria-label={t('form.list.remove')}\n                icon={XIcon}\n                size={'small'}\n                title={t('form.list.remove')}\n                onClick={() => remove(field.index)}\n              />\n            </div>\n          ))}\n          <div {...stylex.props(listStyles.foot)}>{addButton}</div>\n        </>\n      )}\n    </div>\n  );\n});\n\nFormList.displayName = 'FormList';\n\nexport default FormList;\n"],"mappings":"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"}