@12-apps/ui 6.11.0 → 6.12.0

package/dist/form/total-form.js

@@ -1,321 +1,68 @@
 import {
-  ToggleGroup
-} from "../chunk-P3IPM2SZ.js";
+  FormContainer
+} from "../chunk-OK5BHFZE.js";
 import {
-  Select
-} from "../chunk-ENUVGXLE.js";
+  Fields_exports
+} from "../chunk-IKBQ7CS2.js";
+import "../chunk-LIQHOLDQ.js";
 import {
-  CepField
-} from "../chunk-N554AFDB.js";
+  TextField
+} from "../chunk-LFB4H7Y6.js";
 import {
-  Toast
-} from "../chunk-5ETQ3NX5.js";
+  SelectField
+} from "../chunk-MYOFULG4.js";
+import "../chunk-CESQKLIR.js";
 import {
-  CategorySelect
-} from "../chunk-AR5LUIBC.js";
+  CategoryField
+} from "../chunk-SVXSBLVD.js";
 import {
-  Input
-} from "../chunk-OOKQ2LMM.js";
+  SubmitButton
+} from "../chunk-3BR2CLAM.js";
 import {
-  Form,
-  FormControl,
-  FormLabel,
-  FormMessage
-} from "../chunk-FD4W36WR.js";
-import "../chunk-BA4RHQ3B.js";
-import {
-  Button
-} from "../chunk-ANNZ3PLI.js";
-import "../chunk-MQLM43E4.js";
+  FormErrorSnackbar
+} from "../chunk-XJUEHG72.js";
 import {
-  __export
-} from "../chunk-PZ5AY32C.js";
-
-// src/components/form/total-form/FormContainer.tsx
-import { validateFields } from "@12-apps/forms-core";
-import { useCallback, useMemo, useState } from "react";
-
-// src/components/form/total-form/FormContext.tsx
-import { createContext, useContext } from "react";
-var FormContext = createContext(null);
-function useFormContext() {
-  const context = useContext(FormContext);
-  if (!context) {
-    throw new Error("useFormContext must be used within a <FormContainer>");
-  }
-  return context;
-}
-
-// src/components/form/total-form/FormContainer.tsx
-import { jsx } from "react/jsx-runtime";
-function FormContainer({
-  initialValues,
-  schema,
-  onSubmit,
-  children,
-  dataTestId = "total-form"
-}) {
-  const [values, setValues] = useState(initialValues);
-  const [errors, setErrors] = useState({});
-  const [submitting, setSubmitting] = useState(false);
-  const setFieldValue = useCallback((name, value) => {
-    setValues((prev) => ({ ...prev, [name]: value }));
-    setErrors((prev) => {
-      if (!prev[name]) return prev;
-      const next = { ...prev };
-      delete next[name];
-      return next;
-    });
-  }, []);
-  const handleSubmit = useCallback(
-    async (event) => {
-      event.preventDefault();
-      const nextErrors = schema ? validateFields(values, schema) : {};
-      setErrors(nextErrors);
-      if (Object.values(nextErrors).some(Boolean)) return;
-      setSubmitting(true);
-      try {
-        await onSubmit(values, {
-          setFieldErrors: (fieldErrors) => setErrors(fieldErrors)
-        });
-      } finally {
-        setSubmitting(false);
-      }
-    },
-    [onSubmit, schema, values]
-  );
-  const contextValue = useMemo(
-    () => ({ values, errors, submitting, setFieldValue }),
-    [errors, setFieldValue, submitting, values]
-  );
-  return /* @__PURE__ */ jsx(FormContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx(Form, { dataTestId, onSubmit: handleSubmit, noValidate: true, children }) });
-}
-
-// src/components/form/total-form/FormErrorSnackbar.tsx
-import { jsx as jsx2 } from "react/jsx-runtime";
-function FormErrorSnackbar({
-  message = "Please fix the highlighted fields and try again."
-}) {
-  const { errors } = useFormContext();
-  const hasErrors = Object.values(errors).some(Boolean);
-  if (!hasErrors) return null;
-  return /* @__PURE__ */ jsx2(
-    Toast,
-    {
-      dataTestId: "total-form-error-snackbar",
-      variant: "error",
-      message,
-      closable: false
-    }
-  );
-}
-
-// src/components/form/total-form/SubmitButton.tsx
-import { jsx as jsx3 } from "react/jsx-runtime";
-var FIELD_HEIGHT = 56;
-function SubmitButton({
-  children,
-  dataTestId = "total-form-submit"
-}) {
-  const { submitting } = useFormContext();
-  return /* @__PURE__ */ jsx3(
-    Button,
-    {
-      type: "submit",
-      dataTestId,
-      loading: submitting,
-      disabled: submitting,
-      sx: { height: FIELD_HEIGHT, px: 2, fontSize: "1rem", flexShrink: 0, whiteSpace: "nowrap" },
-      children
-    }
-  );
-}
-
-// src/components/form/total-form/Fields/index.ts
-var Fields_exports = {};
-__export(Fields_exports, {
-  CategoryField: () => CategoryField,
-  CepField: () => CepField2,
-  SelectField: () => SelectField,
-  TextField: () => TextField,
-  ToggleField: () => ToggleField
-});
-
-// src/components/form/total-form/Fields/CategoryField.tsx
-import { jsx as jsx4 } from "react/jsx-runtime";
-function CategoryField({
-  name,
-  options,
-  label,
-  placeholder,
-  allowParentSelection = true,
-  copy
-}) {
-  const { values, errors, setFieldValue } = useFormContext();
-  const error = errors[name];
-  return /* @__PURE__ */ jsx4(
-    CategorySelect,
-    {
-      copy,
-      mode: "single",
-      fullWidth: true,
-      label,
-      placeholder,
-      options,
-      allowParentSelection,
-      value: values[name] ? values[name] : null,
-      error,
-      onChange: (next) => setFieldValue(name, next ?? ""),
-      dataTestId: `total-form-field-${name}`
-    }
-  );
-}
-
-// src/components/form/total-form/Fields/CepField.tsx
-import { useCallback as useCallback2, useMemo as useMemo2, useRef } from "react";
-import { jsx as jsx5 } from "react/jsx-runtime";
-var PARTS = ["street", "neighborhood", "city", "state"];
-function useOwnedAutofill() {
-  const { values, setFieldValue } = useFormContext();
-  const autoFilledRef = useRef({});
-  const valuesRef = useRef(values);
-  valuesRef.current = values;
-  const write = useCallback2(
-    (field, value) => {
-      const current = (valuesRef.current[field] ?? "").trim();
-      const ours = autoFilledRef.current[field] === current;
-      if (current !== "" && !ours) return;
-      setFieldValue(field, value);
-      if (value) {
-        autoFilledRef.current[field] = value;
-      } else {
-        delete autoFilledRef.current[field];
-      }
-    },
-    [setFieldValue]
-  );
-  const clearOwned = useCallback2(() => {
-    for (const field of Object.keys(autoFilledRef.current)) {
-      write(field, "");
-    }
-  }, [write]);
-  return useMemo2(() => ({ write, clearOwned }), [write, clearOwned]);
-}
-function CepField2({
-  name,
-  label,
-  lookup,
-  fills,
-  debounceMs,
-  copy
-}) {
-  const { values, errors, setFieldValue } = useFormContext();
-  const { write, clearOwned } = useOwnedAutofill();
-  const handleResolved = useCallback2(
-    (address) => {
-      if (!fills) return;
-      for (const part of PARTS) {
-        const field = fills[part];
-        if (field) write(field, address[part] ?? "");
-      }
-    },
-    [fills, write]
-  );
-  const handleChange = useCallback2(
-    (masked) => setFieldValue(name, masked),
-    [name, setFieldValue]
-  );
-  return /* @__PURE__ */ jsx5(
-    CepField,
-    {
-      copy,
-      name,
-      label,
-      value: values[name] ?? "",
-      error: errors[name],
-      onChange: handleChange,
-      onLookup: lookup,
-      onResolved: handleResolved,
-      onNotFound: clearOwned,
-      debounceMs,
-      dataTestId: `total-form-field-${name}`
-    }
-  );
-}
-
-// src/components/form/total-form/Fields/TextField.tsx
-import { jsx as jsx6, jsxs } from "react/jsx-runtime";
-function TextField({ name, label, type = "text", placeholder }) {
-  const { values, errors, setFieldValue } = useFormContext();
-  const error = errors[name];
-  const testId = `total-form-field-${name}`;
-  return /* @__PURE__ */ jsxs(FormControl, { fullWidth: true, children: [
-    label && /* @__PURE__ */ jsx6(FormLabel, { htmlFor: name, error: Boolean(error), children: label }),
-    /* @__PURE__ */ jsx6(
-      Input,
-      {
-        id: name,
-        name,
-        type,
-        placeholder,
-        value: values[name] ?? "",
-        error: Boolean(error),
-        "data-testid": testId,
-        onChange: (event) => setFieldValue(name, event.target.value)
-      }
-    ),
-    error && /* @__PURE__ */ jsx6(FormMessage, { error: true, dataTestId: `${testId}-message`, children: error })
-  ] });
-}
-
-// src/components/form/total-form/Fields/SelectField.tsx
-import { jsx as jsx7, jsxs as jsxs2 } from "react/jsx-runtime";
-function SelectField({ name, options, label, placeholder }) {
-  const { values, errors, setFieldValue } = useFormContext();
-  const error = errors[name];
-  const testId = `total-form-field-${name}`;
-  return /* @__PURE__ */ jsxs2(FormControl, { fullWidth: true, children: [
-    label && /* @__PURE__ */ jsx7(FormLabel, { htmlFor: name, error: Boolean(error), children: label }),
-    /* @__PURE__ */ jsx7(
-      Select,
-      {
-        options,
-        placeholder,
-        value: values[name] ?? "",
-        error: Boolean(error),
-        "data-testid": testId,
-        onChange: (event) => setFieldValue(name, String(event.target.value))
-      }
-    ),
-    error && /* @__PURE__ */ jsx7(FormMessage, { error: true, dataTestId: `${testId}-message`, children: error })
-  ] });
-}
-
-// src/components/form/total-form/Fields/ToggleField.tsx
-import { jsx as jsx8, jsxs as jsxs3 } from "react/jsx-runtime";
-function ToggleField({ name, options, label }) {
-  const { values, errors, setFieldValue } = useFormContext();
-  const error = errors[name];
-  const testId = `total-form-field-${name}`;
-  return /* @__PURE__ */ jsxs3(FormControl, { fullWidth: true, children: [
-    label && /* @__PURE__ */ jsx8(FormLabel, { htmlFor: name, error: Boolean(error), children: label }),
-    /* @__PURE__ */ jsx8(
-      ToggleGroup,
-      {
-        variant: "exclusive",
-        options,
-        value: values[name] ?? "",
-        fullWidth: true,
-        dataTestId: testId,
-        sx: { "& .MuiToggleButtonGroup-grouped": { height: 56 } },
-        onChange: (_event, next) => {
-          if (typeof next === "string") setFieldValue(name, next);
-        }
-      }
-    ),
-    error && /* @__PURE__ */ jsx8(FormMessage, { error: true, dataTestId: `${testId}-message`, children: error })
-  ] });
-}
+  FormContext,
+  useFormContext
+} from "../chunk-4XK6JQ4D.js";
+import "../chunk-ONMSTW4B.js";
+import "../chunk-A7LG3AXV.js";
+import "../chunk-II3YNC5S.js";
+import "../chunk-Q6HJMJBH.js";
+import "../chunk-6XLMTOJ3.js";
+import "../chunk-QL7L6RHR.js";
+import "../chunk-JD5BVIM7.js";
+import "../chunk-JXUWWPZR.js";
+import "../chunk-N5ZWC6CB.js";
+import "../chunk-JIEEUHNS.js";
+import "../chunk-LMXWI3DD.js";
+import "../chunk-LWYXMCX6.js";
+import "../chunk-E3IPN3KN.js";
+import "../chunk-5F4NIRVF.js";
+import "../chunk-PLOOVF43.js";
+import "../chunk-GPVB3FQP.js";
+import "../chunk-VN6Z6F7R.js";
+import "../chunk-XQ2BNVXL.js";
+import "../chunk-Z5E2PXGN.js";
+import "../chunk-DMNZD3Q7.js";
+import "../chunk-XCT2ZLA6.js";
+import "../chunk-HQBXB5QB.js";
+import "../chunk-DVTCZR3K.js";
+import "../chunk-QBJVRPTF.js";
+import "../chunk-GCC66ZSD.js";
+import "../chunk-QYKDY4EI.js";
+import "../chunk-J7VY6KNP.js";
+import "../chunk-3AEY5TYV.js";
+import "../chunk-SL6454K7.js";
+import "../chunk-C3UKR3NT.js";
+import "../chunk-VZO7VREP.js";
+import "../chunk-BA4RHQ3B.js";
+import "../chunk-6HLRXICF.js";
+import "../chunk-NYUGX76C.js";
+import "../chunk-AUYC5K5K.js";
+import "../chunk-HPK33ACY.js";
+import "../chunk-MFU4Y25U.js";
+import "../chunk-PZ5AY32C.js";
 export {
   CategoryField,
   Fields_exports as Fields,

package/dist/form/total-form.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/form/total-form/FormContainer.tsx","../../src/components/form/total-form/FormContext.tsx","../../src/components/form/total-form/FormErrorSnackbar.tsx","../../src/components/form/total-form/SubmitButton.tsx","../../src/components/form/total-form/Fields/index.ts","../../src/components/form/total-form/Fields/CategoryField.tsx","../../src/components/form/total-form/Fields/CepField.tsx","../../src/components/form/total-form/Fields/TextField.tsx","../../src/components/form/total-form/Fields/SelectField.tsx","../../src/components/form/total-form/Fields/ToggleField.tsx"],"sourcesContent":["'use client';\n\nimport { validateFields } from '@12-apps/forms-core';\nimport type { ValidatorSchema } from '@12-apps/forms-core';\nimport React, { useCallback, useMemo, useState } from 'react';\n\nimport { Form } from '../Form';\n\nimport { FormContext } from './FormContext';\nimport type { TotalFormContextValue } from './FormContext';\n\n/** Imperative helpers handed to {@link FormContainerProps.onSubmit}. */\nexport interface FormSubmitHelpers {\n  /**\n   * Set (highlight) per-field error messages after a submit — e.g. mapping a\n   * server failure back to the exact offending field. Pass `{}` to clear. Each\n   * error auto-clears when the user edits that field.\n   */\n  setFieldErrors: (errors: Record<string, string | undefined>) => void;\n}\n\n/** Props for {@link FormContainer}. */\nexport interface FormContainerProps<T extends Record<string, string>> {\n  /** Initial value for every field, keyed by field name. */\n  initialValues: T;\n  /** Per-field validators run on submit. Omit to skip validation. */\n  schema?: ValidatorSchema<T>;\n  /**\n   * Called with the validated values once the form passes validation. Receives\n   * {@link FormSubmitHelpers} so it can highlight fields on a server failure.\n   */\n  onSubmit: (values: T, helpers: FormSubmitHelpers) => void | Promise<void>;\n  /** Field components, the submit button, and the error snackbar. */\n  children: React.ReactNode;\n  /** Test id applied to the underlying `<form>`. Defaults to `total-form`. */\n  dataTestId?: string;\n}\n\n/**\n * Stateful, domain-agnostic form container ported from the gym-app\n * `total-form`. Holds values/errors/submitting in {@link FormContext}, runs the\n * field validators from `@12-apps/forms-core` on submit, and only calls\n * `onSubmit` with the validated values when no field errors remain. Uses no\n * zod and no react-hook-form.\n *\n * @typeParam T - The form's value shape (a record of string fields).\n */\nexport function FormContainer<T extends Record<string, string>>({\n  initialValues,\n  schema,\n  onSubmit,\n  children,\n  dataTestId = 'total-form',\n}: FormContainerProps<T>): React.ReactElement {\n  const [values, setValues] = useState<T>(initialValues);\n  const [errors, setErrors] = useState<Record<string, string | undefined>>({});\n  const [submitting, setSubmitting] = useState(false);\n\n  const setFieldValue = useCallback<TotalFormContextValue['setFieldValue']>((name, value) => {\n    setValues((prev) => ({ ...prev, [name]: value }));\n    setErrors((prev) => {\n      if (!prev[name]) return prev;\n      const next = { ...prev };\n      delete next[name];\n      return next;\n    });\n  }, []);\n\n  const handleSubmit = useCallback(\n    async (event: React.FormEvent<HTMLFormElement>) => {\n      event.preventDefault();\n      const nextErrors = schema ? validateFields(values, schema) : {};\n      setErrors(nextErrors);\n      if (Object.values(nextErrors).some(Boolean)) return;\n\n      setSubmitting(true);\n      try {\n        // Replace the error map so the helper's contract holds: passing `{}`\n        // clears, and a later field-less failure can't leave a stale highlight.\n        // `onSubmit` only runs once client validation passes, so there are no\n        // client errors here to preserve.\n        await onSubmit(values, {\n          setFieldErrors: (fieldErrors) => setErrors(fieldErrors),\n        });\n      } finally {\n        setSubmitting(false);\n      }\n    },\n    [onSubmit, schema, values],\n  );\n\n  const contextValue = useMemo<TotalFormContextValue>(\n    () => ({ values, errors, submitting, setFieldValue }),\n    [errors, setFieldValue, submitting, values],\n  );\n\n  return (\n    <FormContext.Provider value={contextValue}>\n      <Form dataTestId={dataTestId} onSubmit={handleSubmit} noValidate>\n        {children}\n      </Form>\n    </FormContext.Provider>\n  );\n}\n","'use client';\n\nimport { createContext, useContext } from 'react';\n\n/**\n * Shape of the value exposed by the `total-form` {@link FormContext}.\n *\n * Field values and errors are keyed by field name. The container owns the\n * state; fields and controls read from and write to it through\n * {@link useFormContext}.\n */\nexport interface TotalFormContextValue {\n  /** Current value of every field, keyed by field name. */\n  values: Record<string, string>;\n  /** First validation error per field (absent when the field is valid). */\n  errors: Record<string, string | undefined>;\n  /** Whether the form's `onSubmit` handler is currently running. */\n  submitting: boolean;\n  /** Updates a single field's value and clears any resolved error for it. */\n  setFieldValue: (name: string, value: string) => void;\n}\n\n/** React context backing the `total-form` layer. `null` outside a container. */\nexport const FormContext = createContext<TotalFormContextValue | null>(null);\n\n/**\n * Reads the nearest {@link FormContext}.\n *\n * @throws If called outside a `FormContainer`.\n * @returns The current form context value.\n */\nexport function useFormContext(): TotalFormContextValue {\n  const context = useContext(FormContext);\n  if (!context) {\n    throw new Error('useFormContext must be used within a <FormContainer>');\n  }\n  return context;\n}\n","'use client';\n\nimport React from 'react';\n\nimport { Toast } from '../../feedback/Toast';\nimport { useFormContext } from './FormContext';\n\n/** Props for {@link FormErrorSnackbar}. */\nexport interface FormErrorSnackbarProps {\n  /** Message shown when the form has field errors. */\n  message?: string;\n}\n\n/**\n * Surfaces form-level validation failures. Thin wrapper over the existing\n * `@12-apps/ui` `Toast`: renders nothing while the form is valid and shows an\n * error toast (testid `total-form-error-snackbar`) once any field has an error.\n */\nexport function FormErrorSnackbar({\n  message = 'Please fix the highlighted fields and try again.',\n}: FormErrorSnackbarProps): React.ReactElement | null {\n  const { errors } = useFormContext();\n  const hasErrors = Object.values(errors).some(Boolean);\n\n  if (!hasErrors) return null;\n\n  return (\n    <Toast\n      dataTestId=\"total-form-error-snackbar\"\n      variant=\"error\"\n      message={message}\n      closable={false}\n    />\n  );\n}\n","'use client';\n\nimport React from 'react';\n\nimport { Button } from '../Button';\nimport { useFormContext } from './FormContext';\n\n/** Props for {@link SubmitButton}. */\nexport interface SubmitButtonProps {\n  /** Button label. */\n  children: React.ReactNode;\n  /** Test id; defaults to `total-form-submit`. Override when a page renders more than one form. */\n  dataTestId?: string;\n}\n\n/**\n * The height of a form input control (see `Input` — `.MuiInputBase-root`), so a\n * submit button placed inline with fields lines up with them instead of sitting\n * shorter. Kept in sync with that value by hand.\n */\nconst FIELD_HEIGHT = 56;\n\n/**\n * Submit control wired to {@link useFormContext}. Wraps the existing `@12-apps/ui`\n * `Button` as a `type=\"submit\"` button (testid `total-form-submit`) and\n * reflects the form's `submitting` state via `loading`/`disabled`.\n *\n * It matches the form field height and never wraps its label, so it aligns with\n * an adjacent input on the same row (and stays full-width when the row stacks).\n */\nexport function SubmitButton({\n  children,\n  dataTestId = 'total-form-submit',\n}: SubmitButtonProps): React.ReactElement {\n  const { submitting } = useFormContext();\n\n  return (\n    <Button\n      type=\"submit\"\n      dataTestId={dataTestId}\n      loading={submitting}\n      disabled={submitting}\n      // `Button` replaces (not merges) its size styles with this `sx`, so restate\n      // the md padding/font here alongside the field-height + no-wrap alignment.\n      sx={{ height: FIELD_HEIGHT, px: 2, fontSize: '1rem', flexShrink: 0, whiteSpace: 'nowrap' }}\n    >\n      {children}\n    </Button>\n  );\n}\n","export { CategoryField } from './CategoryField';\nexport type { CategoryFieldProps } from './CategoryField';\nexport { CepField } from './CepField';\nexport type { CepFieldProps, CepFills } from './CepField';\nexport { TextField } from './TextField';\nexport type { TextFieldProps } from './TextField';\nexport { SelectField } from './SelectField';\nexport type { SelectFieldProps } from './SelectField';\nexport { ToggleField } from './ToggleField';\nexport type { ToggleFieldProps } from './ToggleField';\n","'use client';\n\nimport type { CategorySelectCopy } from \"../../../../copy\";\nimport React from 'react';\n\nimport { CategorySelect } from '../../CategorySelect';\nimport type { CategorySelectOption } from '../../CategorySelect';\nimport { useFormContext } from '../FormContext';\n\n/** Props for the `total-form` {@link CategoryField}. */\nexport interface CategoryFieldProps {\n  /** The picker\\'s words. REQUIRED — this package ships no default copy. */\n  copy: CategorySelectCopy;\n  /** Field name; also the key into the form's values/errors. */\n  name: string;\n  /** The categories to choose from, flat, each carrying its `parentId`. */\n  options: CategorySelectOption[];\n  /** Optional visible label rendered above the control. */\n  label?: string;\n  /** Placeholder shown while nothing is chosen. */\n  placeholder?: string;\n  /** Lets a top-level category be chosen in its own right (default: `true`). */\n  allowParentSelection?: boolean;\n}\n\n/**\n * Category picker bound to {@link useFormContext}.\n *\n * The sibling {@link SelectField} flattens a category tree into one list, which\n * is the thing the hierarchical picker exists to stop. Use this wherever the\n * field's options nest.\n *\n * Form values are strings, so \"nothing chosen\" travels as `\"\"` — mapped to and\n * from the control's `null` here rather than making every caller do it.\n */\nexport function CategoryField({\n  name,\n  options,\n  label,\n  placeholder,\n  allowParentSelection = true,\n  copy,\n}: CategoryFieldProps): React.ReactElement {\n  const { values, errors, setFieldValue } = useFormContext();\n  const error = errors[name];\n\n  return (\n    <CategorySelect\n      copy={copy}\n      mode=\"single\"\n      fullWidth\n      label={label}\n      placeholder={placeholder}\n      options={options}\n      allowParentSelection={allowParentSelection}\n      value={values[name] ? values[name] : null}\n      error={error}\n      onChange={(next) => setFieldValue(name, next ?? '')}\n      dataTestId={`total-form-field-${name}`}\n    />\n  );\n}\n","'use client';\n\nimport type { CepFieldCopy } from \"../../../../copy\";\nimport React, { useCallback, useMemo, useRef } from 'react';\n\nimport { CepField as BaseCepField, type CepAddress } from '../../CepField';\nimport { useFormContext } from '../FormContext';\n\n/** The resolved address parts a form can receive. */\ntype CepPart = 'street' | 'neighborhood' | 'city' | 'state';\n\n/**\n * Which form field receives each resolved part. Omit a part to leave it alone —\n * a form with no bairro column simply doesn't map `neighborhood`.\n */\nexport type CepFills = Partial<Record<CepPart, string>>;\n\n/** Props for the `total-form` {@link CepField}. */\nexport interface CepFieldProps {\n  /** The lookup status wording. REQUIRED — no default copy. */\n  copy: CepFieldCopy;\n  /** Field name; also the key into the form's values/errors. */\n  name: string;\n  /** Optional visible label. Defaults to `CEP`. */\n  label?: string;\n  /** Resolve a complete CEP. Omit for a masked input with no lookup. */\n  lookup?: (cep: string) => Promise<CepAddress | null>;\n  /** Maps each resolved address part onto a field in THIS form. */\n  fills?: CepFills;\n  /** Milliseconds to wait after the last keystroke before looking up. */\n  debounceMs?: number;\n}\n\nconst PARTS: readonly CepPart[] = ['street', 'neighborhood', 'city', 'state'];\n\n/** Ownership-aware writes into sibling form fields. */\ninterface OwnedAutofill {\n  /** Write one field, where `''` means \"no value for this part\". */\n  write: (field: string, value: string) => void;\n  /** Blank every field this hook still owns. */\n  clearOwned: () => void;\n}\n\n/**\n * The honesty rule, in one place: this hook remembers exactly what it wrote,\n * writes only into fields that are empty or still hold its own value, and drops\n * the ownership record when it blanks one. That single invariant is what lets\n * autofill replace itself freely while never touching the user's typing.\n */\nfunction useOwnedAutofill(): OwnedAutofill {\n  const { values, setFieldValue } = useFormContext();\n  // What we last auto-filled per target field, so a later lookup may replace\n  // its own value while a manual edit is preserved.\n  const autoFilledRef = useRef<Record<string, string>>({});\n  // Read values at call time without making them a dependency of the callback.\n  const valuesRef = useRef(values);\n  valuesRef.current = values;\n\n  const write = useCallback(\n    (field: string, value: string) => {\n      const current = (valuesRef.current[field] ?? '').trim();\n      const ours = autoFilledRef.current[field] === current;\n      if (current !== '' && !ours) return;\n      setFieldValue(field, value);\n      if (value) {\n        autoFilledRef.current[field] = value;\n      } else {\n        delete autoFilledRef.current[field];\n      }\n    },\n    [setFieldValue],\n  );\n\n  const clearOwned = useCallback(() => {\n    // Object.keys snapshots, so `write` may delete entries as we iterate.\n    for (const field of Object.keys(autoFilledRef.current)) {\n      write(field, '');\n    }\n  }, [write]);\n\n  return useMemo(() => ({ write, clearOwned }), [write, clearOwned]);\n}\n\n/**\n * CEP field bound to {@link useFormContext}: masks and validates the CEP, then\n * writes the resolved logradouro/bairro/cidade/UF straight into the sibling\n * fields named by `fills`.\n *\n * It will not overwrite work the user has done. A target field is only written\n * when it is empty, or when it still holds the exact value THIS component put\n * there — so correcting the CEP re-fills the address, but a hand-edited street\n * survives the next lookup.\n *\n * @example\n * ```tsx\n * <Fields.CepField\n *   name=\"postalCode\"\n *   lookup={lookupCep}\n *   fills={{ street: 'addressLine1', neighborhood: 'neighborhood', city: 'city', state: 'state' }}\n * />\n * ```\n */\nexport function CepField({\n  name,\n  label,\n  lookup,\n  fills,\n  debounceMs,\n  copy,\n}: CepFieldProps): React.ReactElement {\n  const { values, errors, setFieldValue } = useFormContext();\n  const { write, clearOwned } = useOwnedAutofill();\n\n  const handleResolved = useCallback(\n    (address: CepAddress) => {\n      if (!fills) return;\n      // Every mapped part is written on EVERY resolve, absent ones as ''. A\n      // \"CEP geral\" (a small município's catch-all) carries no logradouro, so\n      // skipping absent parts would leave the previous CEP's street here.\n      for (const part of PARTS) {\n        const field = fills[part];\n        if (field) write(field, address[part] ?? '');\n      }\n    },\n    [fills, write],\n  );\n\n  const handleChange = useCallback(\n    (masked: string) => setFieldValue(name, masked),\n    [name, setFieldValue],\n  );\n\n  return (\n    <BaseCepField\n      copy={copy}\n      name={name}\n      label={label}\n      value={values[name] ?? ''}\n      error={errors[name]}\n      onChange={handleChange}\n      onLookup={lookup}\n      onResolved={handleResolved}\n      onNotFound={clearOwned}\n      debounceMs={debounceMs}\n      dataTestId={`total-form-field-${name}`}\n    />\n  );\n}\n","'use client';\n\nimport React from 'react';\n\nimport { FormControl, FormLabel, FormMessage } from '../../Form';\nimport { Input } from '../../Input';\nimport { useFormContext } from '../FormContext';\n\n/** Props for the `total-form` {@link TextField}. */\nexport interface TextFieldProps {\n  /** Field name; also the key into the form's values/errors. */\n  name: string;\n  /** Optional visible label rendered above the input. */\n  label?: string;\n  /** Native input type (e.g. `email`, `password`). Defaults to `text`. */\n  type?: string;\n  /** Placeholder shown when the field is empty. */\n  placeholder?: string;\n}\n\n/**\n * Text input field bound to {@link useFormContext}. Composes the existing\n * `@12-apps/ui` `Form*` presentational primitives and the `Input` control,\n * reading its value/error from context and writing changes back through it.\n *\n * Renders its error via `total-form-field-<name>-message` and the input via\n * `total-form-field-<name>`.\n */\nexport function TextField({ name, label, type = 'text', placeholder }: TextFieldProps): React.ReactElement {\n  const { values, errors, setFieldValue } = useFormContext();\n  const error = errors[name];\n  const testId = `total-form-field-${name}`;\n\n  return (\n    <FormControl fullWidth>\n      {label && (\n        <FormLabel htmlFor={name} error={Boolean(error)}>\n          {label}\n        </FormLabel>\n      )}\n      <Input\n        id={name}\n        name={name}\n        type={type}\n        placeholder={placeholder}\n        value={values[name] ?? ''}\n        error={Boolean(error)}\n        data-testid={testId}\n        onChange={(event) => setFieldValue(name, event.target.value)}\n      />\n      {error && (\n        <FormMessage error dataTestId={`${testId}-message`}>\n          {error}\n        </FormMessage>\n      )}\n    </FormControl>\n  );\n}\n","'use client';\n\nimport React from 'react';\n\nimport { FormControl, FormLabel, FormMessage } from '../../Form';\nimport { Select } from '../../Select';\nimport type { SelectOption } from '../../Select';\nimport { useFormContext } from '../FormContext';\n\n/** Props for the `total-form` {@link SelectField}. */\nexport interface SelectFieldProps {\n  /** Field name; also the key into the form's values/errors. */\n  name: string;\n  /** Selectable options. */\n  options: SelectOption[];\n  /** Optional visible label rendered above the select. */\n  label?: string;\n  /** Placeholder shown when no option is selected. */\n  placeholder?: string;\n}\n\n/**\n * Select field bound to {@link useFormContext}. Composes the existing\n * `@12-apps/ui` `Form*` primitives and the `Select` control, reading its\n * value/error from context and writing the chosen value back through it.\n *\n * Renders its error via `total-form-field-<name>-message` and the select via\n * `total-form-field-<name>`.\n */\nexport function SelectField({ name, options, label, placeholder }: SelectFieldProps): React.ReactElement {\n  const { values, errors, setFieldValue } = useFormContext();\n  const error = errors[name];\n  const testId = `total-form-field-${name}`;\n\n  return (\n    <FormControl fullWidth>\n      {label && (\n        <FormLabel htmlFor={name} error={Boolean(error)}>\n          {label}\n        </FormLabel>\n      )}\n      <Select\n        options={options}\n        placeholder={placeholder}\n        value={values[name] ?? ''}\n        error={Boolean(error)}\n        data-testid={testId}\n        onChange={(event) => setFieldValue(name, String(event.target.value))}\n      />\n      {error && (\n        <FormMessage error dataTestId={`${testId}-message`}>\n          {error}\n        </FormMessage>\n      )}\n    </FormControl>\n  );\n}\n","'use client';\n\nimport React from 'react';\n\nimport { FormControl, FormLabel, FormMessage } from '../../Form';\nimport { ToggleGroup } from '../../ToggleGroup';\nimport type { ToggleOption } from '../../ToggleGroup';\nimport { useFormContext } from '../FormContext';\n\n/** Props for the `total-form` {@link ToggleField}. */\nexport interface ToggleFieldProps {\n  /** Field name; also the key into the form's values/errors. */\n  name: string;\n  /** The mutually-exclusive options (one is always selected). */\n  options: ToggleOption[];\n  /** Optional visible label rendered above the toggle. */\n  label?: string;\n}\n\n/**\n * Exclusive toggle (segmented control) bound to {@link useFormContext} — a\n * label-height-matched alternative to {@link SelectField} for a short, always-set\n * enum. Composes the `Form*` primitives and the `ToggleGroup` control, reading\n * its value from context and writing the chosen value back through it. Ignores a\n * deselect (clicking the active segment) so a value is always kept.\n *\n * Renders its error via `total-form-field-<name>-message` and the toggle via\n * `total-form-field-<name>` (each segment at `total-form-field-<name>-item-<value>`).\n */\nexport function ToggleField({ name, options, label }: ToggleFieldProps): React.ReactElement {\n  const { values, errors, setFieldValue } = useFormContext();\n  const error = errors[name];\n  const testId = `total-form-field-${name}`;\n\n  return (\n    <FormControl fullWidth>\n      {label && (\n        <FormLabel htmlFor={name} error={Boolean(error)}>\n          {label}\n        </FormLabel>\n      )}\n      <ToggleGroup\n        variant=\"exclusive\"\n        options={options}\n        value={values[name] ?? ''}\n        fullWidth\n        dataTestId={testId}\n        // Match the input field height so the toggle lines up in a form row.\n        sx={{ '& .MuiToggleButtonGroup-grouped': { height: 56 } }}\n        onChange={(_event, next) => {\n          if (typeof next === 'string') setFieldValue(name, next);\n        }}\n      />\n      {error && (\n        <FormMessage error dataTestId={`${testId}-message`}>\n          {error}\n        </FormMessage>\n      )}\n    </FormControl>\n  );\n}\n"],"mappings":"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","names":["jsx","jsx","CepField","jsx","useCallback","useMemo","jsx","useCallback","useMemo","CepField","jsx","jsx","jsxs","jsx","jsxs"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}