@ankhorage/zora 0.5.3 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.6.1
+
+### Patch Changes
+
+- 67b131e: Approved with amendments.
+
+## 0.6.0
+
+### Minor Changes
+
+- ab9fc54: Add provider-agnostic form primitives and auth form patterns for sign-in, sign-up, password reset, and OTP flows.
+
 ## 0.5.3
 
 ### Patch Changes

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

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { FormProps } from './types';
+export declare function Form<TName extends string = string>({ fields, values, onChange, onSubmit, errors, error, loading, disabled, submitLabel, actions, footer, validateOnChange, testID, }: FormProps<TName>): React.JSX.Element;
+//# sourceMappingURL=Form.d.ts.map

package/dist/components/form/Form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../../src/components/form/Form.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,wBAAgB,IAAI,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,EAClD,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,EACL,OAAe,EACf,QAAgB,EAChB,WAAsB,EACtB,OAAO,EACP,MAAM,EACN,gBAAwB,EACxB,MAAM,GACP,EAAE,SAAS,CAAC,KAAK,CAAC,qBAqClB"}

package/dist/components/form/Form.js

@@ -0,0 +1,27 @@
+import { Box, Stack } from '@ankhorage/surface';
+import React from 'react';
+import { FormActions } from './FormActions';
+import { FormError } from './FormError';
+import { FormField } from './FormField';
+import { useFormController } from './useFormController';
+export function Form({ fields, values, onChange, onSubmit, errors, error, loading = false, disabled = false, submitLabel = 'Submit', actions, footer, validateOnChange = false, testID, }) {
+    const controller = useFormController({
+        fields,
+        values,
+        errors,
+        onChange,
+        onSubmit,
+        validateOnChange,
+    });
+    return (<Stack gap="m" testID={testID}>
+      <FormError error={error}/>
+      {fields.map((field) => (<FormField key={field.name} disabled={disabled} error={controller.errors[field.name]} field={field} loading={loading} onChange={controller.setFieldValue} value={values[field.name]}/>))}
+      <FormActions disabled={disabled} loading={loading} onSubmit={() => {
+            void controller.handleSubmit();
+        }} submitLabel={submitLabel}>
+        {actions}
+      </FormActions>
+      {footer ? <Box>{footer}</Box> : null}
+    </Stack>);
+}
+//# sourceMappingURL=Form.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../../src/components/form/Form.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,UAAU,IAAI,CAAgC,EAClD,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,EACL,OAAO,GAAG,KAAK,EACf,QAAQ,GAAG,KAAK,EAChB,WAAW,GAAG,QAAQ,EACtB,OAAO,EACP,MAAM,EACN,gBAAgB,GAAG,KAAK,EACxB,MAAM,GACW;IACjB,MAAM,UAAU,GAAG,iBAAiB,CAAC;QACnC,MAAM;QACN,MAAM;QACN,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,gBAAgB;KACjB,CAAC,CAAC;IAEH,OAAO,CACL,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAC5B;MAAA,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EACxB;MAAA,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,CAAC,SAAS,CACR,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAChB,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACrC,KAAK,CAAC,CAAC,KAAK,CAAC,CACb,OAAO,CAAC,CAAC,OAAO,CAAC,CACjB,QAAQ,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CACnC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAC1B,CACH,CAAC,CACF;MAAA,CAAC,WAAW,CACV,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,OAAO,CAAC,CAAC,OAAO,CAAC,CACjB,QAAQ,CAAC,CAAC,GAAG,EAAE;YACb,KAAK,UAAU,CAAC,YAAY,EAAE,CAAC;QACjC,CAAC,CAAC,CACF,WAAW,CAAC,CAAC,WAAW,CAAC,CAEzB;QAAA,CAAC,OAAO,CACV;MAAA,EAAE,WAAW,CACb;MAAA,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CACtC;IAAA,EAAE,KAAK,CAAC,CACT,CAAC;AACJ,CAAC","sourcesContent":["import { Box, Stack } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { FormActions } from './FormActions';\nimport { FormError } from './FormError';\nimport { FormField } from './FormField';\nimport type { FormProps } from './types';\nimport { useFormController } from './useFormController';\n\nexport function Form<TName extends string = string>({\n  fields,\n  values,\n  onChange,\n  onSubmit,\n  errors,\n  error,\n  loading = false,\n  disabled = false,\n  submitLabel = 'Submit',\n  actions,\n  footer,\n  validateOnChange = false,\n  testID,\n}: FormProps<TName>) {\n  const controller = useFormController({\n    fields,\n    values,\n    errors,\n    onChange,\n    onSubmit,\n    validateOnChange,\n  });\n\n  return (\n    <Stack gap=\"m\" testID={testID}>\n      <FormError error={error} />\n      {fields.map((field) => (\n        <FormField\n          key={field.name}\n          disabled={disabled}\n          error={controller.errors[field.name]}\n          field={field}\n          loading={loading}\n          onChange={controller.setFieldValue}\n          value={values[field.name]}\n        />\n      ))}\n      <FormActions\n        disabled={disabled}\n        loading={loading}\n        onSubmit={() => {\n          void controller.handleSubmit();\n        }}\n        submitLabel={submitLabel}\n      >\n        {actions}\n      </FormActions>\n      {footer ? <Box>{footer}</Box> : null}\n    </Stack>\n  );\n}\n"]}

package/dist/components/form/FormActions.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { FormActionsProps } from './types';
+export declare function FormActions({ submitLabel, loading, disabled, onSubmit, children, testID, }: FormActionsProps): React.JSX.Element;
+//# sourceMappingURL=FormActions.d.ts.map

package/dist/components/form/FormActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormActions.d.ts","sourceRoot":"","sources":["../../../src/components/form/FormActions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,wBAAgB,WAAW,CAAC,EAC1B,WAAsB,EACtB,OAAe,EACf,QAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,EAAE,gBAAgB,qBASlB"}

package/dist/components/form/FormActions.js

@@ -0,0 +1,12 @@
+import { Box, Stack } from '@ankhorage/surface';
+import React from 'react';
+import { Button } from '../button';
+export function FormActions({ submitLabel = 'Submit', loading = false, disabled = false, onSubmit, children, testID, }) {
+    return (<Stack gap="s" testID={testID}>
+      <Button disabled={disabled} fullWidth loading={loading} onPress={onSubmit}>
+        {submitLabel}
+      </Button>
+      {children ? <Box>{children}</Box> : null}
+    </Stack>);
+}
+//# sourceMappingURL=FormActions.js.map

package/dist/components/form/FormActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormActions.js","sourceRoot":"","sources":["../../../src/components/form/FormActions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,MAAM,UAAU,WAAW,CAAC,EAC1B,WAAW,GAAG,QAAQ,EACtB,OAAO,GAAG,KAAK,EACf,QAAQ,GAAG,KAAK,EAChB,QAAQ,EACR,QAAQ,EACR,MAAM,GACW;IACjB,OAAO,CACL,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAC5B;MAAA,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CACxE;QAAA,CAAC,WAAW,CACd;MAAA,EAAE,MAAM,CACR;MAAA,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAC1C;IAAA,EAAE,KAAK,CAAC,CACT,CAAC;AACJ,CAAC","sourcesContent":["import { Box, Stack } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { Button } from '../button';\nimport type { FormActionsProps } from './types';\n\nexport function FormActions({\n  submitLabel = 'Submit',\n  loading = false,\n  disabled = false,\n  onSubmit,\n  children,\n  testID,\n}: FormActionsProps) {\n  return (\n    <Stack gap=\"s\" testID={testID}>\n      <Button disabled={disabled} fullWidth loading={loading} onPress={onSubmit}>\n        {submitLabel}\n      </Button>\n      {children ? <Box>{children}</Box> : null}\n    </Stack>\n  );\n}\n"]}

package/dist/components/form/FormError.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { FormErrorProps } from './types';
+export declare function FormError({ error, testID }: FormErrorProps): React.JSX.Element | null;
+//# sourceMappingURL=FormError.d.ts.map

package/dist/components/form/FormError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormError.d.ts","sourceRoot":"","sources":["../../../src/components/form/FormError.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,cAAc,4BAc1D"}

package/dist/components/form/FormError.js

@@ -0,0 +1,14 @@
+import { Box, Text, useTheme } from '@ankhorage/surface';
+import React from 'react';
+export function FormError({ error, testID }) {
+    const { theme } = useTheme();
+    if (!error) {
+        return null;
+    }
+    return (<Box borderColor={theme.colors.error} borderWidth={1} p="s" radius="m" testID={testID}>
+      <Text color={theme.colors.error} variant="bodySmall">
+        {error}
+      </Text>
+    </Box>);
+}
+//# sourceMappingURL=FormError.js.map

package/dist/components/form/FormError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormError.js","sourceRoot":"","sources":["../../../src/components/form/FormError.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAkB;IACzD,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CACpF;MAAA,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,CAClD;QAAA,CAAC,KAAK,CACR;MAAA,EAAE,IAAI,CACR;IAAA,EAAE,GAAG,CAAC,CACP,CAAC;AACJ,CAAC","sourcesContent":["import { Box, Text, useTheme } from '@ankhorage/surface';\nimport React from 'react';\n\nimport type { FormErrorProps } from './types';\n\nexport function FormError({ error, testID }: FormErrorProps) {\n  const { theme } = useTheme();\n\n  if (!error) {\n    return null;\n  }\n\n  return (\n    <Box borderColor={theme.colors.error} borderWidth={1} p=\"s\" radius=\"m\" testID={testID}>\n      <Text color={theme.colors.error} variant=\"bodySmall\">\n        {error}\n      </Text>\n    </Box>\n  );\n}\n"]}

package/dist/components/form/FormField.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { FormFieldProps } from './types';
+export declare function FormField<TName extends string = string>(props: FormFieldProps<TName>): React.JSX.Element;
+//# sourceMappingURL=FormField.d.ts.map

package/dist/components/form/FormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../src/components/form/FormField.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAA0C,cAAc,EAAE,MAAM,SAAS,CAAC;AAgFtF,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,qBA2CpF"}

package/dist/components/form/FormField.js

@@ -0,0 +1,74 @@
+import { Field, Stack, Text } from '@ankhorage/surface';
+import React from 'react';
+import { Input } from '../input';
+import { hasRequiredRule } from './validation';
+function isControlFieldProps(props) {
+    return 'field' in props;
+}
+function resolveKeyboardType(field) {
+    if (field.keyboardType) {
+        return field.keyboardType;
+    }
+    if (field.type === 'email') {
+        return 'email-address';
+    }
+    if (field.type === 'number' || field.type === 'otp') {
+        return 'number-pad';
+    }
+    if (field.type === 'tel') {
+        return 'phone-pad';
+    }
+    if (field.type === 'url') {
+        return 'url';
+    }
+    return undefined;
+}
+function resolveAutoCapitalize(field) {
+    if (field.autoCapitalize) {
+        return field.autoCapitalize;
+    }
+    if (['email', 'password', 'url'].includes(field.type ?? 'text')) {
+        return 'none';
+    }
+    return undefined;
+}
+function resolveTextContentType(field) {
+    if (field.textContentType) {
+        return field.textContentType;
+    }
+    if (field.type === 'email') {
+        return 'emailAddress';
+    }
+    if (field.type === 'password') {
+        return 'password';
+    }
+    if (field.type === 'otp') {
+        return 'oneTimeCode';
+    }
+    return undefined;
+}
+function renderLabel(label, description) {
+    return (<Stack gap="xs">
+      <Text variant="label" weight="semiBold">
+        {label}
+      </Text>
+      {description ? (<Text tone="muted" variant="bodySmall">
+          {description}
+        </Text>) : null}
+    </Stack>);
+}
+export function FormField(props) {
+    if (!isControlFieldProps(props)) {
+        const { label, description, helperText, children, ...fieldProps } = props;
+        return (<Field {...fieldProps} helperText={helperText} label={renderLabel(label, description)}>
+        {children}
+      </Field>);
+    }
+    const { field, value, error, disabled = false, loading = false, onChange, testID } = props;
+    const fieldDisabled = disabled || loading || field.disabled;
+    const required = field.required ?? hasRequiredRule(field.rules);
+    return (<Field disabled={fieldDisabled} errorText={error} helperText={field.helperText} invalid={Boolean(error)} label={renderLabel(field.label, field.description)} readOnly={field.readOnly} required={required} testID={testID ?? field.testID}>
+      <Input accessibilityLabel={typeof field.label === 'string' ? field.label : undefined} autoCapitalize={resolveAutoCapitalize(field)} autoComplete={field.autoComplete} disabled={fieldDisabled} invalid={Boolean(error)} keyboardType={resolveKeyboardType(field)} maxLength={field.maxLength} onChangeText={(nextValue) => onChange(field.name, nextValue)} placeholder={field.placeholder} readOnly={field.readOnly} secureTextEntry={field.secureTextEntry ?? field.type === 'password'} textContentType={resolveTextContentType(field)} value={value}/>
+    </Field>);
+}
+//# sourceMappingURL=FormField.js.map

package/dist/components/form/FormField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.js","sourceRoot":"","sources":["../../../src/components/form/FormField.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Field, Stack, Text } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { Input } from '../input';\nimport type { FormFieldConfig, FormFieldControlProps, FormFieldProps } from './types';\nimport { hasRequiredRule } from './validation';\n\nfunction isControlFieldProps<TName extends string>(\n  props: FormFieldProps<TName>,\n): props is FormFieldControlProps<TName> {\n  return 'field' in props;\n}\n\nfunction resolveKeyboardType(field: FormFieldConfig) {\n  if (field.keyboardType) {\n    return field.keyboardType;\n  }\n\n  if (field.type === 'email') {\n    return 'email-address';\n  }\n\n  if (field.type === 'number' || field.type === 'otp') {\n    return 'number-pad';\n  }\n\n  if (field.type === 'tel') {\n    return 'phone-pad';\n  }\n\n  if (field.type === 'url') {\n    return 'url';\n  }\n\n  return undefined;\n}\n\nfunction resolveAutoCapitalize(field: FormFieldConfig) {\n  if (field.autoCapitalize) {\n    return field.autoCapitalize;\n  }\n\n  if (['email', 'password', 'url'].includes(field.type ?? 'text')) {\n    return 'none';\n  }\n\n  return undefined;\n}\n\nfunction resolveTextContentType(field: FormFieldConfig) {\n  if (field.textContentType) {\n    return field.textContentType;\n  }\n\n  if (field.type === 'email') {\n    return 'emailAddress';\n  }\n\n  if (field.type === 'password') {\n    return 'password';\n  }\n\n  if (field.type === 'otp') {\n    return 'oneTimeCode';\n  }\n\n  return undefined;\n}\n\nfunction renderLabel(label: React.ReactNode, description: React.ReactNode | undefined) {\n  return (\n    <Stack gap=\"xs\">\n      <Text variant=\"label\" weight=\"semiBold\">\n        {label}\n      </Text>\n      {description ? (\n        <Text tone=\"muted\" variant=\"bodySmall\">\n          {description}\n        </Text>\n      ) : null}\n    </Stack>\n  );\n}\n\nexport function FormField<TName extends string = string>(props: FormFieldProps<TName>) {\n  if (!isControlFieldProps(props)) {\n    const { label, description, helperText, children, ...fieldProps } = props;\n\n    return (\n      <Field {...fieldProps} helperText={helperText} label={renderLabel(label, description)}>\n        {children}\n      </Field>\n    );\n  }\n\n  const { field, value, error, disabled = false, loading = false, onChange, testID } = props;\n  const fieldDisabled = disabled || loading || field.disabled;\n  const required = field.required ?? hasRequiredRule(field.rules);\n\n  return (\n    <Field\n      disabled={fieldDisabled}\n      errorText={error}\n      helperText={field.helperText}\n      invalid={Boolean(error)}\n      label={renderLabel(field.label, field.description)}\n      readOnly={field.readOnly}\n      required={required}\n      testID={testID ?? field.testID}\n    >\n      <Input\n        accessibilityLabel={typeof field.label === 'string' ? field.label : undefined}\n        autoCapitalize={resolveAutoCapitalize(field)}\n        autoComplete={field.autoComplete}\n        disabled={fieldDisabled}\n        invalid={Boolean(error)}\n        keyboardType={resolveKeyboardType(field)}\n        maxLength={field.maxLength}\n        onChangeText={(nextValue) => onChange(field.name, nextValue)}\n        placeholder={field.placeholder}\n        readOnly={field.readOnly}\n        secureTextEntry={field.secureTextEntry ?? field.type === 'password'}\n        textContentType={resolveTextContentType(field)}\n        value={value}\n      />\n    </Field>\n  );\n}\n"]}

package/dist/components/form/index.d.ts

@@ -0,0 +1,8 @@
+export { Form } from './Form';
+export { FormActions } from './FormActions';
+export { FormError } from './FormError';
+export { FormField } from './FormField';
+export type { FormActionsProps, FormErrorProps, FormErrors, FormFieldConfig, FormFieldControlProps, FormFieldInputType, FormFieldProps, FormFieldValue, FormFieldWrapperProps, FormProps, FormValidationErrors, FormValidationResult, FormValues, UseFormControllerOptions, UseFormControllerResult, ValidationRule, } from './types';
+export { useFormController } from './useFormController';
+export { hasRequiredRule, validateField, validateFields, validateValue } from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/form/index.js

@@ -0,0 +1,7 @@
+export { Form } from './Form';
+export { FormActions } from './FormActions';
+export { FormError } from './FormError';
+export { FormField } from './FormField';
+export { useFormController } from './useFormController';
+export { hasRequiredRule, validateField, validateFields, validateValue } from './validation';
+//# sourceMappingURL=index.js.map

package/dist/components/form/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmBxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { Form } from './Form';\nexport { FormActions } from './FormActions';\nexport { FormError } from './FormError';\nexport { FormField } from './FormField';\nexport type {\n  FormActionsProps,\n  FormErrorProps,\n  FormErrors,\n  FormFieldConfig,\n  FormFieldControlProps,\n  FormFieldInputType,\n  FormFieldProps,\n  FormFieldValue,\n  FormFieldWrapperProps,\n  FormProps,\n  FormValidationErrors,\n  FormValidationResult,\n  FormValues,\n  UseFormControllerOptions,\n  UseFormControllerResult,\n  ValidationRule,\n} from './types';\nexport { useFormController } from './useFormController';\nexport { hasRequiredRule, validateField, validateFields, validateValue } from './validation';\n"]}

package/dist/components/form/types.d.ts

@@ -0,0 +1,107 @@
+import type { FieldProps as SurfaceFieldProps } from '@ankhorage/surface';
+import type React from 'react';
+import type { InputProps } from '../input';
+export type ValidationRule = {
+    kind: 'required';
+    message?: string;
+} | {
+    kind: 'email';
+    message?: string;
+} | {
+    kind: 'minLength';
+    value: number;
+    message?: string;
+} | {
+    kind: 'pattern';
+    value: string;
+    message?: string;
+};
+export type FormFieldValue = string;
+export type FormValues<TName extends string = string> = Record<TName, FormFieldValue>;
+export type FormErrors<TName extends string = string> = Partial<Record<TName, React.ReactNode>>;
+export type FormValidationErrors<TName extends string = string> = Partial<Record<TName, string>>;
+export type FormFieldInputType = 'email' | 'number' | 'otp' | 'password' | 'tel' | 'text' | 'url';
+export interface FormFieldConfig<TName extends string = string> {
+    name: TName;
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    helperText?: React.ReactNode;
+    type?: FormFieldInputType;
+    placeholder?: string;
+    rules?: readonly ValidationRule[];
+    autoCapitalize?: InputProps['autoCapitalize'];
+    autoComplete?: InputProps['autoComplete'];
+    keyboardType?: InputProps['keyboardType'];
+    maxLength?: InputProps['maxLength'];
+    readOnly?: boolean;
+    required?: boolean;
+    secureTextEntry?: boolean;
+    textContentType?: InputProps['textContentType'];
+    disabled?: boolean;
+    testID?: string;
+}
+export interface FormFieldWrapperProps extends Pick<SurfaceFieldProps, 'children' | 'disabled' | 'errorText' | 'invalid' | 'readOnly' | 'required' | 'testID'> {
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    helperText?: React.ReactNode;
+}
+export interface FormFieldControlProps<TName extends string = string> {
+    field: FormFieldConfig<TName>;
+    value: FormFieldValue;
+    onChange: (name: TName, value: FormFieldValue) => void;
+    error?: React.ReactNode;
+    disabled?: boolean;
+    loading?: boolean;
+    testID?: string;
+}
+export type FormFieldProps<TName extends string = string> = FormFieldControlProps<TName> | FormFieldWrapperProps;
+export interface FormActionsProps {
+    submitLabel?: React.ReactNode;
+    loading?: boolean;
+    disabled?: boolean;
+    onSubmit?: () => void;
+    children?: React.ReactNode;
+    testID?: string;
+}
+export interface FormErrorProps {
+    error?: React.ReactNode;
+    testID?: string;
+}
+export interface FormProps<TName extends string = string> {
+    fields: readonly FormFieldConfig<TName>[];
+    values: FormValues<TName>;
+    onChange: (values: FormValues<TName>) => void;
+    onSubmit: (values: FormValues<TName>) => void | Promise<void>;
+    errors?: FormErrors<TName>;
+    error?: React.ReactNode;
+    loading?: boolean;
+    disabled?: boolean;
+    submitLabel?: React.ReactNode;
+    actions?: React.ReactNode;
+    footer?: React.ReactNode;
+    validateOnChange?: boolean;
+    testID?: string;
+}
+export interface FormValidationResult<TName extends string = string> {
+    errors: FormValidationErrors<TName>;
+    valid: boolean;
+}
+export interface UseFormControllerOptions<TName extends string = string> {
+    fields: readonly FormFieldConfig<TName>[];
+    initialValues?: Partial<FormValues<TName>>;
+    values?: FormValues<TName>;
+    errors?: FormErrors<TName>;
+    onChange?: (values: FormValues<TName>) => void;
+    onSubmit?: (values: FormValues<TName>) => void | Promise<void>;
+    validateOnChange?: boolean;
+}
+export interface UseFormControllerResult<TName extends string = string> {
+    values: FormValues<TName>;
+    errors: FormErrors<TName>;
+    setValues: (values: FormValues<TName>) => void;
+    setFieldValue: (name: TName, value: FormFieldValue) => void;
+    validate: () => FormValidationResult<TName>;
+    handleSubmit: () => Promise<void>;
+    reset: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/form/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/form/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AACtF,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;AAChG,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjG,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAElG,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC5D,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,iBAAiB,EACjB,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CACvF;IACC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAClE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IACpD,qBAAqB,CAAC,KAAK,CAAC,GAC5B,qBAAqB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACtD,MAAM,EAAE,SAAS,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1C,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACjE,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACpC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACrE,MAAM,EAAE,SAAS,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACpE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC/C,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5D,QAAQ,EAAE,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB"}

package/dist/components/form/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/form/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/form/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { FieldProps as SurfaceFieldProps } from '@ankhorage/surface';\nimport type React from 'react';\n\nimport type { InputProps } from '../input';\n\nexport type ValidationRule =\n  | { kind: 'required'; message?: string }\n  | { kind: 'email'; message?: string }\n  | { kind: 'minLength'; value: number; message?: string }\n  | { kind: 'pattern'; value: string; message?: string };\n\nexport type FormFieldValue = string;\nexport type FormValues<TName extends string = string> = Record<TName, FormFieldValue>;\nexport type FormErrors<TName extends string = string> = Partial<Record<TName, React.ReactNode>>;\nexport type FormValidationErrors<TName extends string = string> = Partial<Record<TName, string>>;\n\nexport type FormFieldInputType = 'email' | 'number' | 'otp' | 'password' | 'tel' | 'text' | 'url';\n\nexport interface FormFieldConfig<TName extends string = string> {\n  name: TName;\n  label: React.ReactNode;\n  description?: React.ReactNode;\n  helperText?: React.ReactNode;\n  type?: FormFieldInputType;\n  placeholder?: string;\n  rules?: readonly ValidationRule[];\n  autoCapitalize?: InputProps['autoCapitalize'];\n  autoComplete?: InputProps['autoComplete'];\n  keyboardType?: InputProps['keyboardType'];\n  maxLength?: InputProps['maxLength'];\n  readOnly?: boolean;\n  required?: boolean;\n  secureTextEntry?: boolean;\n  textContentType?: InputProps['textContentType'];\n  disabled?: boolean;\n  testID?: string;\n}\n\nexport interface FormFieldWrapperProps extends Pick<\n  SurfaceFieldProps,\n  'children' | 'disabled' | 'errorText' | 'invalid' | 'readOnly' | 'required' | 'testID'\n> {\n  label: React.ReactNode;\n  description?: React.ReactNode;\n  helperText?: React.ReactNode;\n}\n\nexport interface FormFieldControlProps<TName extends string = string> {\n  field: FormFieldConfig<TName>;\n  value: FormFieldValue;\n  onChange: (name: TName, value: FormFieldValue) => void;\n  error?: React.ReactNode;\n  disabled?: boolean;\n  loading?: boolean;\n  testID?: string;\n}\n\nexport type FormFieldProps<TName extends string = string> =\n  | FormFieldControlProps<TName>\n  | FormFieldWrapperProps;\n\nexport interface FormActionsProps {\n  submitLabel?: React.ReactNode;\n  loading?: boolean;\n  disabled?: boolean;\n  onSubmit?: () => void;\n  children?: React.ReactNode;\n  testID?: string;\n}\n\nexport interface FormErrorProps {\n  error?: React.ReactNode;\n  testID?: string;\n}\n\nexport interface FormProps<TName extends string = string> {\n  fields: readonly FormFieldConfig<TName>[];\n  values: FormValues<TName>;\n  onChange: (values: FormValues<TName>) => void;\n  onSubmit: (values: FormValues<TName>) => void | Promise<void>;\n  errors?: FormErrors<TName>;\n  error?: React.ReactNode;\n  loading?: boolean;\n  disabled?: boolean;\n  submitLabel?: React.ReactNode;\n  actions?: React.ReactNode;\n  footer?: React.ReactNode;\n  validateOnChange?: boolean;\n  testID?: string;\n}\n\nexport interface FormValidationResult<TName extends string = string> {\n  errors: FormValidationErrors<TName>;\n  valid: boolean;\n}\n\nexport interface UseFormControllerOptions<TName extends string = string> {\n  fields: readonly FormFieldConfig<TName>[];\n  initialValues?: Partial<FormValues<TName>>;\n  values?: FormValues<TName>;\n  errors?: FormErrors<TName>;\n  onChange?: (values: FormValues<TName>) => void;\n  onSubmit?: (values: FormValues<TName>) => void | Promise<void>;\n  validateOnChange?: boolean;\n}\n\nexport interface UseFormControllerResult<TName extends string = string> {\n  values: FormValues<TName>;\n  errors: FormErrors<TName>;\n  setValues: (values: FormValues<TName>) => void;\n  setFieldValue: (name: TName, value: FormFieldValue) => void;\n  validate: () => FormValidationResult<TName>;\n  handleSubmit: () => Promise<void>;\n  reset: () => void;\n}\n"]}

package/dist/components/form/useFormController.d.ts

@@ -0,0 +1,3 @@
+import type { UseFormControllerOptions, UseFormControllerResult } from './types';
+export declare function useFormController<TName extends string = string>({ fields, initialValues, values: controlledValues, errors: externalErrors, onChange, onSubmit, validateOnChange, }: UseFormControllerOptions<TName>): UseFormControllerResult<TName>;
+//# sourceMappingURL=useFormController.d.ts.map

package/dist/components/form/useFormController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormController.d.ts","sourceRoot":"","sources":["../../../src/components/form/useFormController.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAejB,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,EAC/D,MAAM,EACN,aAAa,EACb,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,cAAc,EACtB,QAAQ,EACR,QAAQ,EACR,gBAAwB,GACzB,EAAE,wBAAwB,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,CA0ElE"}

package/dist/components/form/useFormController.js

@@ -0,0 +1,62 @@
+import React from 'react';
+import { validateFields } from './validation';
+function createInitialValues(fields, initialValues) {
+    const values = fields.reduce((nextValues, field) => {
+        nextValues[field.name] = initialValues?.[field.name] ?? '';
+        return nextValues;
+    }, {});
+    return values;
+}
+export function useFormController({ fields, initialValues, values: controlledValues, errors: externalErrors, onChange, onSubmit, validateOnChange = false, }) {
+    const initialValuesRef = React.useRef(createInitialValues(fields, initialValues));
+    const [internalValues, setInternalValues] = React.useState(initialValuesRef.current);
+    const [validationErrors, setValidationErrors] = React.useState({});
+    const values = controlledValues ?? internalValues;
+    const errors = React.useMemo(() => ({
+        ...validationErrors,
+        ...externalErrors,
+    }), [externalErrors, validationErrors]);
+    const setValues = React.useCallback((nextValues) => {
+        if (!controlledValues) {
+            setInternalValues(nextValues);
+        }
+        onChange?.(nextValues);
+    }, [controlledValues, onChange]);
+    const validate = React.useCallback(() => {
+        const result = validateFields(fields, values);
+        setValidationErrors(result.errors);
+        return result;
+    }, [fields, values]);
+    const setFieldValue = React.useCallback((name, value) => {
+        const nextValues = {
+            ...values,
+            [name]: value,
+        };
+        setValues(nextValues);
+        if (validateOnChange) {
+            const result = validateFields(fields, nextValues);
+            setValidationErrors(result.errors);
+        }
+    }, [fields, setValues, validateOnChange, values]);
+    const handleSubmit = React.useCallback(async () => {
+        const result = validate();
+        if (!result.valid) {
+            return;
+        }
+        await onSubmit?.(values);
+    }, [onSubmit, validate, values]);
+    const reset = React.useCallback(() => {
+        setValidationErrors({});
+        setValues(initialValuesRef.current);
+    }, [setValues]);
+    return {
+        values,
+        errors,
+        setValues,
+        setFieldValue,
+        validate,
+        handleSubmit,
+        reset,
+    };
+}
+//# sourceMappingURL=useFormController.js.map

package/dist/components/form/useFormController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormController.js","sourceRoot":"","sources":["../../../src/components/form/useFormController.ts"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport type {\n  FormErrors,\n  FormValues,\n  UseFormControllerOptions,\n  UseFormControllerResult,\n} from './types';\nimport { validateFields } from './validation';\n\nfunction createInitialValues<TName extends string>(\n  fields: readonly { name: TName }[],\n  initialValues: Partial<FormValues<TName>> | undefined,\n): FormValues<TName> {\n  const values = fields.reduce<Record<string, string>>((nextValues, field) => {\n    nextValues[field.name] = initialValues?.[field.name] ?? '';\n    return nextValues;\n  }, {});\n\n  return values as FormValues<TName>;\n}\n\nexport function useFormController<TName extends string = string>({\n  fields,\n  initialValues,\n  values: controlledValues,\n  errors: externalErrors,\n  onChange,\n  onSubmit,\n  validateOnChange = false,\n}: UseFormControllerOptions<TName>): UseFormControllerResult<TName> {\n  const initialValuesRef = React.useRef(createInitialValues(fields, initialValues));\n  const [internalValues, setInternalValues] = React.useState<FormValues<TName>>(\n    initialValuesRef.current,\n  );\n  const [validationErrors, setValidationErrors] = React.useState<FormErrors<TName>>({});\n\n  const values = controlledValues ?? internalValues;\n  const errors = React.useMemo(\n    () => ({\n      ...validationErrors,\n      ...externalErrors,\n    }),\n    [externalErrors, validationErrors],\n  );\n\n  const setValues = React.useCallback(\n    (nextValues: FormValues<TName>) => {\n      if (!controlledValues) {\n        setInternalValues(nextValues);\n      }\n\n      onChange?.(nextValues);\n    },\n    [controlledValues, onChange],\n  );\n\n  const validate = React.useCallback(() => {\n    const result = validateFields(fields, values);\n    setValidationErrors(result.errors);\n    return result;\n  }, [fields, values]);\n\n  const setFieldValue = React.useCallback(\n    (name: TName, value: string) => {\n      const nextValues = {\n        ...values,\n        [name]: value,\n      };\n\n      setValues(nextValues);\n\n      if (validateOnChange) {\n        const result = validateFields(fields, nextValues);\n        setValidationErrors(result.errors);\n      }\n    },\n    [fields, setValues, validateOnChange, values],\n  );\n\n  const handleSubmit = React.useCallback(async () => {\n    const result = validate();\n\n    if (!result.valid) {\n      return;\n    }\n\n    await onSubmit?.(values);\n  }, [onSubmit, validate, values]);\n\n  const reset = React.useCallback(() => {\n    setValidationErrors({});\n    setValues(initialValuesRef.current);\n  }, [setValues]);\n\n  return {\n    values,\n    errors,\n    setValues,\n    setFieldValue,\n    validate,\n    handleSubmit,\n    reset,\n  };\n}\n"]}

package/dist/components/form/validation.d.ts

@@ -0,0 +1,6 @@
+import type { FormFieldConfig, FormValidationResult, FormValues, ValidationRule } from './types';
+export declare function hasRequiredRule(rules: readonly ValidationRule[] | undefined): boolean;
+export declare function validateValue(value: string, rules: readonly ValidationRule[] | undefined): string | undefined;
+export declare function validateField<TName extends string>(field: FormFieldConfig<TName>, values: FormValues<TName>): string | undefined;
+export declare function validateFields<TName extends string>(fields: readonly FormFieldConfig<TName>[], values: FormValues<TName>): FormValidationResult<TName>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/components/form/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/components/form/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,oBAAoB,EACpB,UAAU,EACV,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,GAAG,OAAO,CAErF;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAsCpB;AAED,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAChD,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAC7B,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,GACxB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAS,MAAM,EACjD,MAAM,EAAE,SAAS,eAAe,CAAC,KAAK,CAAC,EAAE,EACzC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,GACxB,oBAAoB,CAAC,KAAK,CAAC,CAe7B"}

package/dist/components/form/validation.js

@@ -0,0 +1,52 @@
+const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export function hasRequiredRule(rules) {
+    return rules?.some((rule) => rule.kind === 'required') ?? false;
+}
+export function validateValue(value, rules) {
+    if (!rules?.length) {
+        return undefined;
+    }
+    for (const rule of rules) {
+        const normalizedValue = value.trim();
+        if (rule.kind === 'required' && normalizedValue.length === 0) {
+            return rule.message ?? 'This field is required.';
+        }
+        if (rule.kind === 'email' &&
+            normalizedValue.length > 0 &&
+            !emailPattern.test(normalizedValue)) {
+            return rule.message ?? 'Enter a valid email address.';
+        }
+        if (rule.kind === 'minLength' && value.length < rule.value) {
+            return rule.message ?? `Enter at least ${rule.value} characters.`;
+        }
+        if (rule.kind === 'pattern') {
+            try {
+                const pattern = new RegExp(rule.value);
+                if (normalizedValue.length > 0 && !pattern.test(value)) {
+                    return rule.message ?? 'Enter a valid value.';
+                }
+            }
+            catch {
+                return rule.message ?? 'Enter a valid value.';
+            }
+        }
+    }
+    return undefined;
+}
+export function validateField(field, values) {
+    return validateValue(values[field.name], field.rules);
+}
+export function validateFields(fields, values) {
+    const errors = {};
+    for (const field of fields) {
+        const error = validateField(field, values);
+        if (error) {
+            errors[field.name] = error;
+        }
+    }
+    return {
+        errors,
+        valid: Object.keys(errors).length === 0,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/components/form/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/components/form/validation.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD,MAAM,UAAU,eAAe,CAAC,KAA4C;IAC1E,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,KAAK,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,KAA4C;IAE5C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAErC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,OAAO,IAAI,yBAAyB,CAAC;QACnD,CAAC;QAED,IACE,IAAI,CAAC,IAAI,KAAK,OAAO;YACrB,eAAe,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,EACnC,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,IAAI,8BAA8B,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,OAAO,IAAI,kBAAkB,IAAI,CAAC,KAAK,cAAc,CAAC;QACpE,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAEvC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvD,OAAO,IAAI,CAAC,OAAO,IAAI,sBAAsB,CAAC;gBAChD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC,OAAO,IAAI,sBAAsB,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAA6B,EAC7B,MAAyB;IAEzB,OAAO,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAyC,EACzC,MAAyB;IAEzB,MAAM,MAAM,GAAgC,EAAE,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE3C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;KACxC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  FormFieldConfig,\n  FormValidationErrors,\n  FormValidationResult,\n  FormValues,\n  ValidationRule,\n} from './types';\n\nconst emailPattern = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n\nexport function hasRequiredRule(rules: readonly ValidationRule[] | undefined): boolean {\n  return rules?.some((rule) => rule.kind === 'required') ?? false;\n}\n\nexport function validateValue(\n  value: string,\n  rules: readonly ValidationRule[] | undefined,\n): string | undefined {\n  if (!rules?.length) {\n    return undefined;\n  }\n\n  for (const rule of rules) {\n    const normalizedValue = value.trim();\n\n    if (rule.kind === 'required' && normalizedValue.length === 0) {\n      return rule.message ?? 'This field is required.';\n    }\n\n    if (\n      rule.kind === 'email' &&\n      normalizedValue.length > 0 &&\n      !emailPattern.test(normalizedValue)\n    ) {\n      return rule.message ?? 'Enter a valid email address.';\n    }\n\n    if (rule.kind === 'minLength' && value.length < rule.value) {\n      return rule.message ?? `Enter at least ${rule.value} characters.`;\n    }\n\n    if (rule.kind === 'pattern') {\n      try {\n        const pattern = new RegExp(rule.value);\n\n        if (normalizedValue.length > 0 && !pattern.test(value)) {\n          return rule.message ?? 'Enter a valid value.';\n        }\n      } catch {\n        return rule.message ?? 'Enter a valid value.';\n      }\n    }\n  }\n\n  return undefined;\n}\n\nexport function validateField<TName extends string>(\n  field: FormFieldConfig<TName>,\n  values: FormValues<TName>,\n): string | undefined {\n  return validateValue(values[field.name], field.rules);\n}\n\nexport function validateFields<TName extends string>(\n  fields: readonly FormFieldConfig<TName>[],\n  values: FormValues<TName>,\n): FormValidationResult<TName> {\n  const errors: FormValidationErrors<TName> = {};\n\n  for (const field of fields) {\n    const error = validateField(field, values);\n\n    if (error) {\n      errors[field.name] = error;\n    }\n  }\n\n  return {\n    errors,\n    valid: Object.keys(errors).length === 0,\n  };\n}\n"]}

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export type { CheckboxGroupOption, CheckboxGroupProps, CheckboxProps } from './c
 export { Checkbox, CheckboxGroup } from './components/checkbox';
 export type { DrawerProps } from './components/drawer';
 export { Drawer } from './components/drawer';
+export type { FormActionsProps, FormErrorProps, FormErrors, FormFieldConfig, FormFieldControlProps, FormFieldInputType, FormFieldProps, FormFieldValue, FormFieldWrapperProps, FormProps, FormValidationErrors, FormValidationResult, FormValues, UseFormControllerOptions, UseFormControllerResult, ValidationRule, } from './components/form';
+export { Form, FormActions, FormError, FormField, hasRequiredRule, useFormController, validateField, validateFields, validateValue, } from './components/form';
 export type { IconProps } from './components/icon';
 export { Icon } from './components/icon';
 export type { IconButtonProps } from './components/icon-button';
@@ -42,6 +44,8 @@ export type { SidebarLayoutProps } from './layout/sidebar-layout';
 export { SidebarLayout } from './layout/sidebar-layout';
 export type { TopbarLayoutProps } from './layout/topbar-layout';
 export { TopbarLayout } from './layout/topbar-layout';
+export type { AuthFormBaseProps, AuthIdentifierKind, ForgotPasswordFormProps, ForgotPasswordFormValues, OtpFormProps, OtpFormValues, SignInFormProps, SignInFormValues, SignUpFormField, SignUpFormProps, SignUpFormValues, } from './patterns/auth';
+export { ForgotPasswordForm, OtpForm, SignInForm, SignUpForm } from './patterns/auth';
 export type { CollectionEditorProps, CollectionEditorRenderItemProps, } from './patterns/collection-editor';
 export { CollectionEditor } from './patterns/collection-editor';
 export type { ConfirmDialogProps } from './patterns/confirm-dialog';
@@ -50,8 +54,6 @@ export type { DisclosureSectionProps } from './patterns/disclosure-section';
 export { DisclosureSection } from './patterns/disclosure-section';
 export type { EmptyStateAction, EmptyStateProps } from './patterns/empty-state';
 export { EmptyState } from './patterns/empty-state';
-export type { FormFieldProps } from './patterns/form-field';
-export { FormField } from './patterns/form-field';
 export type { InspectorFieldProps } from './patterns/inspector-field';
 export { InspectorField } from './patterns/inspector-field';
 export type { NoticeProps } from './patterns/notice';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}