@ereo/forms 0.1.23

package/dist/a11y.d.ts

@@ -0,0 +1,52 @@
+import type { FieldState, FormSubmitState } from './types';
+import type { FormStoreInterface } from './types';
+export declare function generateA11yId(prefix?: string): string;
+export declare function getFieldA11y(name: string, state: Pick<FieldState, 'errors' | 'touched'>): Record<string, string | boolean | undefined>;
+export declare function getErrorA11y(name: string): {
+    id: string;
+    role: string;
+    'aria-live': string;
+};
+export declare function getLabelA11y(name: string, opts?: {
+    id?: string;
+}): {
+    htmlFor: string;
+    id: string;
+};
+export declare function getDescriptionA11y(name: string): {
+    id: string;
+};
+export declare function getFieldsetA11y(name: string, _legend?: string): {
+    role: string;
+    'aria-labelledby': string;
+};
+export declare function getFieldWrapperA11y(name: string, state: Pick<FieldState, 'errors' | 'touched'>): Record<string, string | boolean | undefined>;
+export declare function getFormA11y(id: string, opts?: {
+    isSubmitting?: boolean;
+}): Record<string, string | boolean>;
+export declare function getErrorSummaryA11y(formId: string): {
+    role: string;
+    'aria-labelledby': string;
+};
+export declare function focusFirstError(form: FormStoreInterface<any>): void;
+export declare function focusField(name: string): void;
+export declare function trapFocus(container: HTMLElement): () => void;
+export declare function announce(message: string, priority?: 'polite' | 'assertive'): void;
+export declare function cleanupLiveRegion(): void;
+export declare function announceErrors(errors: Record<string, string[]>, opts?: {
+    prefix?: string;
+}): void;
+export declare function announceSubmitStatus(status: FormSubmitState, opts?: {
+    successMessage?: string;
+    errorMessage?: string;
+    submittingMessage?: string;
+}): void;
+export declare function prefersReducedMotion(): boolean;
+/**
+ * Heuristic detection — not reliable for all screen readers.
+ * Returns true if certain indicators are present, but many screen readers
+ * (VoiceOver, TalkBack, Orca) are undetectable from JavaScript.
+ * Prefer designing for accessibility by default rather than relying on detection.
+ */
+export declare function isScreenReaderActive(): boolean;
+//# sourceMappingURL=a11y.d.ts.map

package/dist/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../src/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAMlD,wBAAgB,cAAc,CAAC,MAAM,SAAS,GAAG,MAAM,CAEtD;AAID,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAS9C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAMA;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAKjC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAI/D;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAK7C;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAO9C;AAID,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CASlC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAKA;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,IAAI,CA0BnE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAS7C;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,IAAI,CA8B5D;AA+BD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,GAAG,WAAsB,GAAG,IAAI,CAQ3F;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAChC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,IAAI,CAUN;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF,IAAI,CAYN;AAID,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C"}

package/dist/accessibility.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @ereo/forms - Accessibility Utilities
+ *
+ * Auto-generated ARIA attributes, focus management, and screen reader support.
+ */
+import type { FieldState, FormStore } from './types';
+/**
+ * Get ARIA attributes for a field.
+ *
+ * @example
+ * const a11y = getFieldA11y('email', fieldState);
+ * // Returns: { 'aria-invalid': true, 'aria-describedby': 'email-error', ... }
+ */
+export declare function getFieldA11y(name: string, state: FieldState): Record<string, string | boolean | undefined>;
+/**
+ * Get error container attributes.
+ *
+ * @example
+ * <div {...getErrorA11y('email')}>Error message</div>
+ */
+export declare function getErrorA11y(name: string): Record<string, string>;
+/**
+ * Get label attributes.
+ *
+ * @example
+ * <label {...getLabelA11y('email', { required: true })}>Email</label>
+ */
+export declare function getLabelA11y(name: string, options?: {
+    required?: boolean;
+}): Record<string, string | boolean | undefined>;
+/**
+ * Get description/hint attributes.
+ *
+ * @example
+ * <span {...getDescriptionA11y('email')}>Enter your email address</span>
+ */
+export declare function getDescriptionA11y(name: string): Record<string, string>;
+/**
+ * Get fieldset attributes for grouped fields.
+ *
+ * @example
+ * <fieldset {...getFieldsetA11y('address', 'Your Address')}>...</fieldset>
+ */
+export declare function getFieldsetA11y(name: string, legend: string): Record<string, string>;
+/**
+ * Get complete field wrapper attributes.
+ *
+ * @example
+ * <div {...getFieldWrapperA11y('email', fieldState)}>
+ *   <label>Email</label>
+ *   <input />
+ *   <span>Error</span>
+ * </div>
+ */
+export declare function getFieldWrapperA11y(name: string, state: FieldState): Record<string, string | boolean>;
+/**
+ * Focus the first field with an error.
+ *
+ * @example
+ * const handleSubmit = async () => {
+ *   const result = await form.validate();
+ *   if (!result.valid) {
+ *     focusFirstError(form);
+ *     return;
+ *   }
+ *   // Submit...
+ * };
+ */
+export declare function focusFirstError<T extends Record<string, unknown>>(form: FormStore<T>): boolean;
+/**
+ * Focus a specific field by name.
+ *
+ * @example
+ * focusField('email');
+ */
+export declare function focusField(name: string): boolean;
+/**
+ * Trap focus within a container (useful for modals/dialogs).
+ *
+ * @example
+ * const cleanup = trapFocus(dialogElement);
+ * // Later: cleanup();
+ */
+export declare function trapFocus(container: HTMLElement): () => void;
+/**
+ * Announce errors to screen readers.
+ *
+ * @example
+ * const errors = form.errors.get();
+ * if (Object.keys(errors).length > 0) {
+ *   announceErrors(errors);
+ * }
+ */
+export declare function announceErrors(errors: Record<string, string[]>, options?: {
+    prefix?: string;
+    joiner?: string;
+}): void;
+/**
+ * Announce a message to screen readers.
+ *
+ * @example
+ * announce('Form submitted successfully');
+ */
+export declare function announce(message: string, priority?: 'polite' | 'assertive'): void;
+/**
+ * Announce form submission status.
+ *
+ * @example
+ * announceSubmitStatus('submitting');
+ * // Later...
+ * announceSubmitStatus('success');
+ */
+export declare function announceSubmitStatus(status: 'idle' | 'submitting' | 'success' | 'error', options?: {
+    submittingMessage?: string;
+    successMessage?: string;
+    errorMessage?: string;
+}): void;
+/**
+ * Generate a unique ID for accessibility purposes.
+ */
+export declare function generateA11yId(prefix: string): string;
+/**
+ * Check if reduced motion is preferred.
+ */
+export declare function prefersReducedMotion(): boolean;
+/**
+ * Check if screen reader is likely active.
+ * Note: This is not 100% reliable.
+ */
+export declare function isScreenReaderActive(): boolean;
+/**
+ * Get form element attributes.
+ *
+ * @example
+ * <form {...getFormA11y('contact-form', { submitting: true })}>
+ */
+export declare function getFormA11y(id: string, options?: {
+    submitting?: boolean;
+    errorCount?: number;
+}): Record<string, string | boolean | undefined>;
+/**
+ * Get error summary container attributes.
+ *
+ * @example
+ * <div {...getErrorSummaryA11y('contact-form')}>
+ *   <h2>Please fix the following errors:</h2>
+ *   <ul>...</ul>
+ * </div>
+ */
+export declare function getErrorSummaryA11y(formId: string): Record<string, string>;
+export type { FieldState };
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/accessibility.d.ts.map

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

package/dist/action-integration.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @ereo/forms - Server Action Integration
+ *
+ * Direct integration with @ereo/data actions and server forms.
+ */
+import { type ReactNode } from 'react';
+import type { ActionFormProps, ActionResult, FormActionOptions, FormStore, ValidationSchema } from './types';
+/**
+ * Create a form action handler for server-side processing.
+ *
+ * @example
+ * // In your server route (e.g., routes/contact.ts)
+ * import { createFormAction } from '@ereo/forms';
+ * import { z } from 'zod';
+ *
+ * const contactSchema = z.object({
+ *   name: z.string().min(1),
+ *   email: z.string().email(),
+ *   message: z.string().min(10),
+ * });
+ *
+ * export const action = createFormAction({
+ *   schema: contactSchema,
+ *   handler: async ({ body }) => {
+ *     await sendEmail(body);
+ *     return { sent: true };
+ *   },
+ * });
+ */
+export declare function createFormAction<T, TResult = T>(options: FormActionOptions<T, TResult>): (args: {
+    request: Request;
+}) => Promise<ActionResult<TResult>>;
+/**
+ * Form component with automatic server action submission.
+ *
+ * @example
+ * <ActionForm
+ *   form={form}
+ *   action="/api/contact"
+ *   onSuccess={(result) => {
+ *     toast.success('Message sent!');
+ *     router.push('/thank-you');
+ *   }}
+ *   onError={(result) => {
+ *     toast.error('Failed to send message');
+ *   }}
+ * >
+ *   <Field form={form} name="name" label="Name" />
+ *   <Field form={form} name="email" label="Email" />
+ *   <Field form={form} name="message" label="Message" />
+ *   <button type="submit">Send</button>
+ * </ActionForm>
+ */
+export declare function ActionForm<T extends Record<string, unknown>>({ form, action, method, onSuccess, onError, resetOnSuccess, children, ...rest }: ActionFormProps<T>): ReactNode;
+export interface UseFormActionOptions<T> {
+    /** Server action URL */
+    action: string;
+    /** HTTP method */
+    method?: 'post' | 'put' | 'patch' | 'delete';
+    /** Success callback */
+    onSuccess?: (result: ActionResult<T>) => void;
+    /** Error callback */
+    onError?: (result: ActionResult<T>) => void;
+    /** Validation schema for response */
+    responseSchema?: ValidationSchema<unknown, T>;
+}
+export interface UseFormActionReturn<T extends Record<string, unknown>, TResult = unknown> {
+    /** Submit the form */
+    submit: (form: FormStore<T>) => Promise<ActionResult<TResult>>;
+    /** Cancel pending submission */
+    cancel: () => void;
+    /** Current submission state */
+    isSubmitting: boolean;
+    /** Last submission result */
+    result: ActionResult<TResult> | null;
+}
+/**
+ * Hook for manual form action submission.
+ *
+ * @example
+ * function ContactForm() {
+ *   const form = useForm({ initialValues: { email: '' } });
+ *   const { submit, isSubmitting, result } = useFormAction({
+ *     action: '/api/contact',
+ *     onSuccess: (result) => console.log('Sent!', result),
+ *   });
+ *
+ *   return (
+ *     <form onSubmit={(e) => { e.preventDefault(); submit(form); }}>
+ *       <Field form={form} name="email" />
+ *       <button disabled={isSubmitting}>
+ *         {isSubmitting ? 'Sending...' : 'Send'}
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ */
+export declare function useFormAction<T extends Record<string, unknown>, TResult = unknown>(options: UseFormActionOptions<TResult>): UseFormActionReturn<T, TResult>;
+/**
+ * Parse action result from various response formats.
+ */
+export declare function parseActionResult<T>(response: unknown): ActionResult<T>;
+export type { ActionFormProps, ActionResult, FormActionOptions };
+//# sourceMappingURL=action-integration.d.ts.map

package/dist/action-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-integration.d.ts","sourceRoot":"","sources":["../src/action-integration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAQjB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,EAC7C,OAAO,EAAE,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,GACrC,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAkDhE;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC5D,IAAI,EACJ,MAAM,EACN,MAAe,EACf,SAAS,EACT,OAAO,EACP,cAAc,EACd,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAoGhC;AAMD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,uBAAuB;IACvB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9C,qBAAqB;IACrB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC5C,qCAAqC;IACrC,cAAc,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO;IACvF,sBAAsB;IACtB,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,gCAAgC;IAChC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,6BAA6B;IAC7B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAChF,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACrC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAoHjC;AAiDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAkCvE;AAMD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/action.d.ts

@@ -0,0 +1,33 @@
+import type { ReactNode, ReactElement } from 'react';
+import type { ActionResult, FormStoreInterface, ValidationSchema } from './types';
+export interface CreateFormActionOptions<T, TResult = unknown> {
+    schema?: ValidationSchema<unknown, T>;
+    handler: (values: T) => Promise<TResult>;
+    onError?: (error: unknown) => ActionResult<TResult>;
+}
+export declare function createFormAction<T, TResult = unknown>(opts: CreateFormActionOptions<T, TResult>): (request: Request) => Promise<ActionResult<TResult>>;
+export interface ActionFormProps<T extends Record<string, any>> {
+    form: FormStoreInterface<T>;
+    action: string | ((values: T) => Promise<ActionResult>);
+    method?: 'post' | 'put' | 'patch' | 'delete';
+    onSuccess?: (result: any) => void;
+    onError?: (errors: Record<string, string[]>) => void;
+    children: ReactNode;
+    className?: string;
+    id?: string;
+    encType?: 'application/json' | 'multipart/form-data';
+}
+export declare function ActionForm<T extends Record<string, any>>(props: ActionFormProps<T>): ReactElement;
+export interface UseFormActionOptions<T, TResult = unknown> {
+    action: string | ((values: T) => Promise<ActionResult<TResult>>);
+    method?: string;
+    encType?: 'application/json' | 'multipart/form-data';
+}
+export declare function useFormAction<T, TResult = unknown>(opts: UseFormActionOptions<T, TResult>): {
+    submit: (values: T) => Promise<ActionResult<TResult>>;
+    cancel: () => void;
+    isSubmitting: boolean;
+    result: ActionResult<TResult> | null;
+};
+export declare function parseActionResult<T>(response: unknown): ActionResult<T>;
+//# sourceMappingURL=action.d.ts.map

package/dist/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAa,YAAY,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAOjB,MAAM,WAAW,uBAAuB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAC3D,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EACnD,IAAI,EAAE,uBAAuB,CAAC,CAAC,EAAE,OAAO,CAAC,GACxC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAsEtD;AAID,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5D,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACtD;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACxB,YAAY,CAqId;AAID,MAAM,WAAW,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IACxD,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACtD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAChD,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,GACrC;IACD,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACtC,CA+DA;AAID,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAuCvE"}

package/dist/adapters.d.ts

@@ -0,0 +1,25 @@
+import type { ReactElement } from 'react';
+import type { UIAdapter, UIAdapterComponents, FieldState, FieldInputProps } from './types';
+export declare function registerAdapter(adapter: UIAdapter): void;
+export declare function getAdapter(name: string): UIAdapter | undefined;
+export declare function setDefaultAdapter(name: string): void;
+export declare function getDefaultAdapter(): UIAdapter | undefined;
+export declare function listAdapters(): string[];
+export declare function unregisterAdapter(name: string): void;
+export declare function createAdapter(name: string, components: UIAdapterComponents, classNames?: Record<string, string>): UIAdapter;
+export declare function useAdapter(name?: string): UIAdapter | undefined;
+export interface AdaptedFieldProps {
+    inputProps: FieldInputProps;
+    state: Pick<FieldState, 'errors' | 'touched' | 'dirty'>;
+    adapter?: string;
+    type?: string;
+    label?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+    className?: string;
+}
+export declare function AdaptedField(props: AdaptedFieldProps): ReactElement;
+export declare const htmlAdapter: UIAdapter;
+export declare function clearAdapterRegistry(): void;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAO3F,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAExD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKpD;AAED,wBAAgB,iBAAiB,IAAI,SAAS,GAAG,SAAS,CAGzD;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKpD;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,mBAAmB,EAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,SAAS,CAIX;AAID,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAG/D;AAID,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAuEnE;AAID,eAAO,MAAM,WAAW,EAAE,SAiEzB,CAAC;AAEF,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}

package/dist/array-field.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @ereo/forms - Array Field Components
+ *
+ * First-class support for array fields with stable keys.
+ */
+import { type ReactNode } from 'react';
+import type { ArrayFieldHelpers, ArrayFieldItem, FieldArrayProps, FormStore, PathsOf, PathValue } from './types';
+/**
+ * Hook for managing array fields.
+ *
+ * @example
+ * function TagsField() {
+ *   const { fields, append, remove } = useFieldArray(form, 'tags');
+ *
+ *   return (
+ *     <div>
+ *       {fields.map((field, index) => (
+ *         <div key={field.id}>
+ *           <Field form={form} name={`tags.${index}`} />
+ *           <button onClick={() => remove(index)}>Remove</button>
+ *         </div>
+ *       ))}
+ *       <button onClick={() => append('')}>Add Tag</button>
+ *     </div>
+ *   );
+ * }
+ */
+export declare function useFieldArray<T extends Record<string, unknown>, K extends PathsOf<T>, Item = PathValue<T, K> extends Array<infer U> ? U : never>(form: FormStore<T>, name: K): ArrayFieldHelpers<Item>;
+/**
+ * Component for rendering array fields.
+ *
+ * @example
+ * <FieldArray form={form} name="tags">
+ *   {({ fields, append, remove }) => (
+ *     <div>
+ *       {fields.map((field, index) => (
+ *         <div key={field.id}>
+ *           <Field form={form} name={`tags.${index}`} />
+ *           <button onClick={() => remove(index)}>×</button>
+ *         </div>
+ *       ))}
+ *       <button onClick={() => append('')}>Add</button>
+ *     </div>
+ *   )}
+ * </FieldArray>
+ */
+export declare function FieldArray<T extends Record<string, unknown>, K extends PathsOf<T>>({ form, name, children, }: FieldArrayProps<T, K>): ReactNode;
+export type { ArrayFieldHelpers, ArrayFieldItem, FieldArrayProps };
+//# sourceMappingURL=array-field.d.ts.map

package/dist/array-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-field.d.ts","sourceRoot":"","sources":["../src/array-field.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,SAAS,EACT,OAAO,EACP,SAAS,EACV,MAAM,SAAS,CAAC;AAgFjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EACzD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAwPtD;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CACxB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACpB,EACA,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAGnC;AAGD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}

package/dist/components.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement } from 'react';
+import type { FieldComponentProps, TextareaFieldProps, SelectFieldProps, FieldArrayComponentProps } from './types';
+export declare function Field<T extends Record<string, any>, K extends string = string>(props: FieldComponentProps<T, K>): ReactElement | null;
+export declare function TextareaField<T extends Record<string, any>, K extends string = string>(props: TextareaFieldProps<T, K>): ReactElement | null;
+export declare function SelectField<T extends Record<string, any>, K extends string = string>(props: SelectFieldProps<T, K>): ReactElement | null;
+export declare function FieldArrayComponent<T extends Record<string, any>, K extends string = string>(props: FieldArrayComponentProps<T, K>): ReactElement | null;
+export { FieldArrayComponent as FieldArray };
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAEV,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AA+BjB,wBAAgB,KAAK,CACnB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,KAAK,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAqDvD;AAID,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CA2CtD;AAID,wBAAgB,WAAW,CACzB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAoDpD;AAID,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,KAAK,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAQ5D;AAGD,OAAO,EAAE,mBAAmB,IAAI,UAAU,EAAE,CAAC"}

package/dist/composition.d.ts

@@ -0,0 +1,4 @@
+import type { FormConfig, ValidationSchema } from './types';
+export declare function mergeFormConfigs<A extends Record<string, any>, B extends Record<string, any>>(configA: FormConfig<A>, configB: FormConfig<B>): FormConfig<A & B>;
+export declare function composeSchemas<A = unknown, B = unknown>(prefix1: string, schema1: ValidationSchema<unknown, A>, prefix2: string, schema2: ValidationSchema<unknown, B>): ValidationSchema<unknown, Record<string, unknown>>;
+//# sourceMappingURL=composition.d.ts.map

package/dist/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAqB,MAAM,SAAS,CAAC;AA4B/E,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAkCnE;AAID,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACrD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GACpC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+EpD"}

package/dist/context.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+import type { FormStoreInterface } from './types';
+export interface FormProviderProps<T extends Record<string, any>> {
+    form: FormStoreInterface<T>;
+    children: ReactNode;
+}
+export declare function FormProvider<T extends Record<string, any>>({ form, children, }: FormProviderProps<T>): import("react").FunctionComponentElement<import("react").ProviderProps<FormStoreInterface<any> | null>>;
+export declare function useFormContext<T extends Record<string, any> = Record<string, any>>(): FormStoreInterface<T> | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC9D,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC1D,IAAI,EACJ,QAAQ,GACT,EAAE,iBAAiB,CAAC,CAAC,CAAC,2GAEtB;AAED,wBAAgB,cAAc,CAC5B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAChD,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAEhC"}

package/dist/field.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @ereo/forms - Field Components
+ *
+ * Granular field components with signal-based subscriptions.
+ */
+import { type ReactNode } from 'react';
+import type { FieldProps, FieldRegistration, FieldState, FormStore, PathsOf, PathValue, ValidationRule } from './types';
+/**
+ * Hook for granular field subscription.
+ * Only re-renders when THIS field's value or errors change.
+ *
+ * @example
+ * function EmailField() {
+ *   const field = useField(form, 'email');
+ *   return (
+ *     <div>
+ *       <input {...field.inputProps} />
+ *       {field.state.errors.map(err => <span key={err}>{err}</span>)}
+ *     </div>
+ *   );
+ * }
+ */
+export declare function useField<T extends Record<string, unknown>, K extends PathsOf<T>>(form: FormStore<T>, name: K, options?: {
+    validate?: ValidationRule | ValidationRule[];
+}): FieldRegistration<PathValue<T, K>> & {
+    /** Reactive field value */
+    value: PathValue<T, K>;
+    /** Reactive field errors */
+    errors: string[];
+    /** Reactive touched state */
+    isTouched: boolean;
+    /** Reactive dirty state */
+    isDirty: boolean;
+};
+/**
+ * Field component with automatic input rendering.
+ *
+ * @example
+ * // Basic usage
+ * <Field form={form} name="email" type="email" label="Email" />
+ *
+ * // With render prop
+ * <Field form={form} name="bio">
+ *   {(field) => <textarea {...field.inputProps} />}
+ * </Field>
+ *
+ * // With UI adapter
+ * <Field form={form} name="email" adapter="shadcn" />
+ */
+export declare function Field<T extends Record<string, unknown>, K extends PathsOf<T>>({ form, name, type, label, placeholder, disabled, required, className, validate, adapter: adapterName, children, }: FieldProps<T, K>): ReactNode;
+export interface TextareaFieldProps<T extends Record<string, unknown>, K extends PathsOf<T>> extends Omit<FieldProps<T, K>, 'type'> {
+    rows?: number;
+    cols?: number;
+    maxLength?: number;
+    minLength?: number;
+}
+/**
+ * Textarea field component.
+ *
+ * @example
+ * <TextareaField form={form} name="bio" label="Bio" rows={4} />
+ */
+export declare function TextareaField<T extends Record<string, unknown>, K extends PathsOf<T>>({ form, name, label, placeholder, disabled, required, className, validate, rows, cols, maxLength, minLength, children, }: TextareaFieldProps<T, K>): ReactNode;
+export interface SelectFieldProps<T extends Record<string, unknown>, K extends PathsOf<T>> extends Omit<FieldProps<T, K>, 'type'> {
+    options: Array<{
+        value: string;
+        label: string;
+        disabled?: boolean;
+    }>;
+    multiple?: boolean;
+}
+/**
+ * Select field component.
+ *
+ * @example
+ * <SelectField
+ *   form={form}
+ *   name="country"
+ *   label="Country"
+ *   options={[
+ *     { value: 'us', label: 'United States' },
+ *     { value: 'uk', label: 'United Kingdom' },
+ *   ]}
+ * />
+ */
+export declare function SelectField<T extends Record<string, unknown>, K extends PathsOf<T>>({ form, name, label, disabled, required, className, validate, options, multiple, placeholder, children, }: SelectFieldProps<T, K>): ReactNode;
+export type { FieldProps, FieldRegistration, FieldState };
+//# sourceMappingURL=field.d.ts.map

package/dist/field.d.ts.map

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

package/dist/form.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @ereo/forms - Core Form Store
+ *
+ * Signal-based form state management for zero re-renders on field changes.
+ */
+import { type ReactNode } from 'react';
+import type { FormConfig, FormState, FormStore } from './types';
+/**
+ * Create a new form store.
+ *
+ * @example
+ * const form = createForm({
+ *   initialValues: { email: '', password: '' },
+ *   schema: z.object({
+ *     email: z.string().email(),
+ *     password: z.string().min(8),
+ *   }),
+ *   validateOn: 'blur',
+ *   onSubmit: async (values) => {
+ *     await api.login(values);
+ *   },
+ * });
+ */
+export declare function createForm<T extends Record<string, unknown>>(config: FormConfig<T>): FormStore<T>;
+/**
+ * Provide form store to child components.
+ */
+export declare function FormProvider<T extends Record<string, unknown>>({ form, children, }: {
+    form: FormStore<T>;
+    children: ReactNode;
+}): ReactNode;
+/**
+ * Get form store from context.
+ */
+export declare function useFormContext<T extends Record<string, unknown>>(): FormStore<T> | null;
+/**
+ * React hook for using a form store.
+ * Creates a new form store or uses an existing one.
+ *
+ * @example
+ * const { register, handleSubmit, isValid } = useForm({
+ *   initialValues: { email: '' },
+ *   schema: z.object({ email: z.string().email() }),
+ * });
+ */
+export declare function useForm<T extends Record<string, unknown>>(config: FormConfig<T>): FormStore<T> & {
+    /** Form values (reactive) */
+    formValues: T;
+    /** Field errors (reactive) */
+    fieldErrors: Record<string, string[]>;
+    /** Is form valid (reactive) */
+    isValid: boolean;
+    /** Is form submitting (reactive) */
+    isFormSubmitting: boolean;
+    /** Is form dirty (reactive) */
+    isDirty: boolean;
+};
+export type { FormStore, FormConfig, FormState };
+//# sourceMappingURL=form.d.ts.map

package/dist/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,SAAS,EASV,MAAM,SAAS,CAAC;AA23BjB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,SAAS,CAAC,CAAC,CAAC,CAEd;AAQD;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC9D,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CAMZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAEvF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,SAAS,CAAC,CAAC,CAAC,GAAG;IAChB,6BAA6B;IAC7B,UAAU,EAAE,CAAC,CAAC;IACd,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB,CAiCA;AAGD,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}