@pithyjs/ui-kit 0.1.0-beta.0

package/dist/organisms/forms/DynamicForm.js

@@ -0,0 +1,546 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.dynamic-form",
+  "title": "<DynamicForm> Organism",
+  "category": "feature"
+}
+*/
+import { effect, batch } from '@pithyjs/signals';
+import { createFormState } from './form-state';
+import { createFormElement, attachSubmittingEffect, handleValidationFailure, } from './form-helpers';
+import { CHECK_ICON } from '../../shared/icons';
+import { Input } from '../../atoms/forms/input/Input';
+import { Select } from '../../atoms/forms/select/Select';
+import { Textarea } from '../../atoms/forms/textarea/Textarea';
+import { Checkbox } from '../../atoms/forms/checkbox/Checkbox';
+import { Radio } from '../../atoms/forms/radio/Radio';
+import { RadioGroup } from '../../atoms/forms/radio/RadioGroup';
+import { Toggle } from '../../atoms/forms/toggle/Toggle';
+import { FormField } from '../../atoms/forms/form-field/FormField';
+import { Button } from '../../atoms/actions/button/Button';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readConfig(config) {
+    return typeof config === 'function' ? config() : config;
+}
+function deriveInitialValues(fields) {
+    const values = {};
+    for (const field of fields) {
+        if (field.type === 'checkbox' || field.type === 'toggle') {
+            values[field.name] = false;
+        }
+        else {
+            values[field.name] = '';
+        }
+    }
+    return values;
+}
+function deriveValidationRules(fields) {
+    const rules = {};
+    for (const field of fields) {
+        // Disabled fields are excluded from constraint validation (matches HTML semantics).
+        if (field.disabled)
+            continue;
+        const fieldRules = [];
+        if (field.required) {
+            fieldRules.push({
+                type: 'required',
+                message: `${field.label} is required`,
+            });
+        }
+        if (field.validation) {
+            fieldRules.push(...field.validation);
+        }
+        if (fieldRules.length > 0) {
+            rules[field.name] = fieldRules;
+        }
+    }
+    return rules;
+}
+function createFieldAtom(field, state) {
+    // Typed accessors — coerce unknown to the expected atom prop type
+    const stringValue = () => String(state.fieldValue(field.name)() ?? '');
+    const booleanValue = () => Boolean(state.fieldValue(field.name)());
+    const common = {
+        label: field.label,
+        required: field.required,
+        disabled: field.disabled,
+        helperText: field.helperText,
+        error: state.fieldHasError(field.name),
+        errorMessage: state.fieldErrorMessage(field.name),
+        onBlur: () => state.setTouched(field.name),
+    };
+    switch (field.type) {
+        case 'text':
+        case 'email':
+        case 'password':
+        case 'number':
+        case 'tel':
+        case 'url':
+            return Input({
+                ...common,
+                type: field.type,
+                name: field.name,
+                placeholder: field.placeholder,
+                autocomplete: field.autocomplete,
+                value: stringValue,
+                onInput: (val) => state.setValue(field.name, val),
+            });
+        case 'textarea':
+            return Textarea({
+                ...common,
+                name: field.name,
+                placeholder: field.placeholder,
+                value: stringValue,
+                onInput: (val) => state.setValue(field.name, val),
+            });
+        case 'select':
+            return Select({
+                ...common,
+                name: field.name,
+                placeholder: field.placeholder,
+                options: field.options ?? [],
+                value: stringValue,
+                onChange: (val) => state.setValue(field.name, val),
+            });
+        case 'checkbox':
+            return Checkbox({
+                ...common,
+                name: field.name,
+                checked: booleanValue,
+                onChange: (checked) => state.setValue(field.name, checked),
+            });
+        case 'toggle':
+            return Toggle({
+                ...common,
+                name: field.name,
+                checked: booleanValue,
+                onChange: (checked) => state.setValue(field.name, checked),
+            });
+        case 'radio': {
+            const options = field.options ?? [];
+            // Create individual Radio atoms inside a RadioGroup. Forward
+            // helperText and disabled from FieldConfig for parity with other
+            // field types (Input/Select/Textarea pass these via the `common` spread).
+            // The group-level disabled cascades to children via fieldset[disabled].
+            const radioGroup = RadioGroup({
+                label: field.label,
+                helperText: field.helperText,
+                disabled: field.disabled,
+                error: state.fieldHasError(field.name),
+                errorMessage: state.fieldErrorMessage(field.name),
+            });
+            const radioDisposers = [];
+            options.forEach((opt, i) => {
+                const radio = Radio({
+                    label: opt.label,
+                    name: field.name,
+                    value: opt.value,
+                    checked: () => state.fieldValue(field.name)() === opt.value,
+                    onChange: (checked) => {
+                        if (checked)
+                            state.setValue(field.name, opt.value);
+                    },
+                    onBlur: () => state.setTouched(field.name),
+                    disabled: field.disabled,
+                    // Mark only the first radio as required — one aria-required per
+                    // group is sufficient and avoids an asterisk next to every option.
+                    // RadioGroup does not currently accept a `required` prop.
+                    required: i === 0 ? field.required : undefined,
+                });
+                // Append Radio inside the RadioGroup's fieldset
+                radioGroup.el.appendChild(radio.el);
+                radioDisposers.push(radio.destroy);
+            });
+            return {
+                el: radioGroup.el,
+                destroy: () => {
+                    for (const d of radioDisposers)
+                        d();
+                    radioGroup.destroy();
+                },
+            };
+        }
+        default: {
+            // Fallback: text input
+            if (import.meta.env?.DEV) {
+                console.warn(`[PithyJS] DynamicForm: unknown field type "${field.type}" for field "${field.name}", falling back to text input.`);
+            }
+            return Input({
+                ...common,
+                name: field.name,
+                value: stringValue,
+                onInput: (val) => state.setValue(field.name, val),
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+/**
+ * Config-driven form organism.
+ *
+ * Renders form fields from a `FormConfig` object, wiring each field's
+ * value, error, and event handlers to a shared `FormState` automatically.
+ * Supports grid layout with column spans and conditional field visibility
+ * via `dependsOn`.
+ *
+ * @example
+ * ```typescript
+ * const form = DynamicForm({
+ *   config: {
+ *     fields: [
+ *       { name: "email", type: "email", label: "Email", required: true },
+ *       { name: "message", type: "textarea", label: "Message", span: "full" },
+ *     ],
+ *     submitLabel: "Send",
+ *   },
+ *   columns: 2,
+ *   validateOn: "blur",
+ *   onSubmit: async (values) => console.log(values),
+ * });
+ * document.body.appendChild(form.el);
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.dynamic-form","name":"DynamicForm","stability":"stable","signature":"(props: DynamicFormProps) => { el: HTMLFormElement; destroy: () => void }"} */
+export function DynamicForm({ config: configProp, onSubmit = undefined, columns: rawColumns = 1, validateOn = undefined, action = undefined, method = undefined, ariaLabel = undefined, ariaLabelledBy = undefined, }) {
+    // SCSS only defines layouts for data-columns="2|3|4"; clamp out-of-range
+    // values so the grid never silently falls back to a single-column layout
+    // (and span clamping at line 436 stays within the supported set).
+    const columns = Math.max(1, Math.min(4, Math.floor(rawColumns)));
+    if (import.meta.env?.DEV && columns !== rawColumns) {
+        console.warn(`[PithyJS] DynamicForm: columns=${rawColumns} is outside the supported range [1, 4]. Clamped to ${columns}.`);
+    }
+    const disposers = [];
+    let successTimer;
+    // Blocks re-submit during the 1.5s success-flash window.
+    let flashActive = false;
+    const cfg = readConfig(configProp);
+    const honeypotName = cfg.honeypot === true
+        ? '_honey'
+        : typeof cfg.honeypot === 'string'
+            ? cfg.honeypot
+            : null;
+    // -- Form state -----------------------------------------------------------
+    const initialValues = deriveInitialValues(cfg.fields);
+    const validationRules = deriveValidationRules(cfg.fields);
+    const state = createFormState({ initialValues, validateOn, validationRules });
+    // -- Track collapsed (dependsOn-hidden) fields for validation exclusion ---
+    const collapsedFields = new Set();
+    // Disabled fields are excluded from validation + submission payload to match
+    // native HTML semantics. Static — derived once from cfg.
+    const disabledFieldNames = new Set(cfg.fields.filter(f => f.disabled).map(f => f.name));
+    // Wrap validateAll to skip collapsed (dependsOn-hidden) fields.
+    const originalValidateAll = state.validateAll.bind(state);
+    state.validateAll = () => {
+        const result = originalValidateAll();
+        if (collapsedFields.size === 0)
+            return result;
+        batch(() => {
+            for (const name of collapsedFields) {
+                state.setError(name, []);
+            }
+        });
+        return state.isValid();
+    };
+    // -- DOM: form ------------------------------------------------------------
+    const { form, statusEl } = createFormElement('ui-dynamic-form');
+    if (ariaLabel)
+        form.setAttribute('aria-label', ariaLabel);
+    if (ariaLabelledBy)
+        form.setAttribute('aria-labelledby', ariaLabelledBy);
+    // Native submission target (e.g. Formsubmit.co)
+    if (action) {
+        form.action = action;
+        form.method = method ?? 'POST';
+    }
+    // Static hidden inputs (e.g. Formsubmit.co _subject, _next, _captcha)
+    if (cfg.hiddenFields) {
+        for (const [name, value] of Object.entries(cfg.hiddenFields)) {
+            const hidden = document.createElement('input');
+            hidden.type = 'hidden';
+            hidden.name = name;
+            hidden.value = value;
+            form.appendChild(hidden);
+        }
+    }
+    // Honeypot — wrapped in a display:none container so browser autofill
+    // (Chrome, Safari, password managers) skips it. Bots that scrape the DOM
+    // typically ignore CSS and will still find and fill the input. The field
+    // is still in the form DOM and submits normally with the request.
+    let honeypotInput = null;
+    if (honeypotName) {
+        const honeypotWrapper = document.createElement('div');
+        honeypotWrapper.setAttribute('aria-hidden', 'true');
+        honeypotWrapper.style.display = 'none';
+        honeypotInput = document.createElement('input');
+        honeypotInput.type = 'text';
+        honeypotInput.name = honeypotName;
+        honeypotInput.tabIndex = -1;
+        // Multiple anti-autofill hints — different browsers respect different ones
+        honeypotInput.autocomplete = 'off';
+        honeypotInput.setAttribute('data-lpignore', 'true'); // LastPass
+        honeypotInput.setAttribute('data-form-type', 'other'); // Chrome heuristic
+        honeypotWrapper.appendChild(honeypotInput);
+        form.appendChild(honeypotWrapper);
+    }
+    // Submitting state
+    disposers.push(attachSubmittingEffect(form, state));
+    // -- DOM: grid container --------------------------------------------------
+    const grid = document.createElement('div');
+    grid.classList.add('ui-dynamic-form-grid');
+    if (columns > 1) {
+        grid.setAttribute('data-columns', String(columns));
+    }
+    form.appendChild(grid);
+    // -- Render fields --------------------------------------------------------
+    for (const field of cfg.fields) {
+        const atom = createFieldAtom(field, state);
+        disposers.push(atom.destroy);
+        // <fieldset> for dependsOn fields so fieldset[disabled] excludes
+        // descendants from the native form data set when collapsed.
+        const wrapper = field.dependsOn
+            ? document.createElement('fieldset')
+            : document.createElement('div');
+        wrapper.classList.add('ui-dynamic-form-field');
+        // <fieldset> must have a <legend> (WCAG / axe fieldset-must-have-legend).
+        // The FormField/RadioGroup child provides the visible label; the legend is
+        // an SR-only echo so the fieldset has an accessible name without
+        // duplicating text for sighted users. Must be the first child of <fieldset>.
+        if (field.dependsOn) {
+            const legend = document.createElement('legend');
+            legend.classList.add('u-sr-only');
+            legend.textContent = field.label ?? field.name;
+            wrapper.appendChild(legend);
+        }
+        if (field.span) {
+            if (field.span === 'full') {
+                wrapper.setAttribute('data-span', 'full');
+            }
+            else {
+                const spanVal = field.span;
+                if (import.meta.env?.DEV && spanVal > columns) {
+                    console.warn(`[PithyJS] DynamicForm: field "${field.name}" has span ${spanVal} but grid only has ${columns} column(s). Clamping to ${columns}.`);
+                }
+                const clamped = Math.min(spanVal, columns);
+                if (clamped > 1) {
+                    wrapper.setAttribute('data-span', String(clamped));
+                }
+            }
+        }
+        // Self-labelling atoms (radio, checkbox, toggle) render their own <label>,
+        // so skip FormField wrapper to avoid duplicate labels.
+        const selfLabelling = field.type === 'radio' ||
+            field.type === 'checkbox' ||
+            field.type === 'toggle';
+        if (selfLabelling) {
+            wrapper.appendChild(atom.el);
+        }
+        else {
+            const formField = FormField({
+                label: field.label,
+                required: field.required,
+            });
+            formField.el.appendChild(atom.el);
+            wrapper.appendChild(formField.el);
+            disposers.push(formField.destroy);
+        }
+        // Conditional visibility (dependsOn). Use effect() directly (not computed())
+        // so the subscription is disposed via the disposers list — @pithyjs/signals'
+        // computed() has no disposer and would leak per field.
+        if (field.dependsOn) {
+            const { field: depField, value: depValue } = field.dependsOn;
+            const fieldValueAccessor = state.fieldValue(depField);
+            const fieldsetWrapper = wrapper;
+            fieldsetWrapper.classList.add('ui-dynamic-form-collapsible');
+            let pendingHideListener = null;
+            const clearPendingHide = () => {
+                if (pendingHideListener) {
+                    fieldsetWrapper.removeEventListener('transitionend', pendingHideListener);
+                    pendingHideListener = null;
+                }
+            };
+            disposers.push(clearPendingHide);
+            disposers.push(effect(() => {
+                const visible = fieldValueAccessor() === depValue;
+                clearPendingHide();
+                if (visible) {
+                    fieldsetWrapper.hidden = false;
+                    void fieldsetWrapper.offsetHeight; // reflow before adding open class
+                    fieldsetWrapper.classList.add('ui-dynamic-form-collapsible-open');
+                    fieldsetWrapper.removeAttribute('aria-hidden');
+                    fieldsetWrapper.removeAttribute('inert');
+                    fieldsetWrapper.disabled = false;
+                    collapsedFields.delete(field.name);
+                }
+                else {
+                    // Only animate the close when the field was actually open.
+                    // Setting hidden=true immediately would apply [hidden]{display:none}
+                    // and skip the grid-template-rows 1fr→0fr transition entirely.
+                    const wasOpen = fieldsetWrapper.classList.contains('ui-dynamic-form-collapsible-open');
+                    fieldsetWrapper.classList.remove('ui-dynamic-form-collapsible-open');
+                    fieldsetWrapper.setAttribute('aria-hidden', 'true');
+                    fieldsetWrapper.setAttribute('inert', '');
+                    fieldsetWrapper.disabled = true;
+                    collapsedFields.add(field.name);
+                    const prefersReducedMotion = typeof matchMedia !== 'undefined' &&
+                        matchMedia('(prefers-reduced-motion: reduce)').matches;
+                    if (!wasOpen || prefersReducedMotion) {
+                        fieldsetWrapper.hidden = true;
+                    }
+                    else {
+                        pendingHideListener = (e) => {
+                            if (e.target !== fieldsetWrapper)
+                                return;
+                            if (e.propertyName !== 'grid-template-rows')
+                                return;
+                            fieldsetWrapper.hidden = true;
+                            clearPendingHide();
+                        };
+                        fieldsetWrapper.addEventListener('transitionend', pendingHideListener);
+                    }
+                }
+            }));
+        }
+        grid.appendChild(wrapper);
+    }
+    // -- Submit button --------------------------------------------------------
+    const actionsRow = document.createElement('div');
+    actionsRow.classList.add('ui-dynamic-form-actions');
+    const submitBtn = Button({
+        variant: 'solid',
+        color: 'primary',
+        type: 'submit',
+        loading: state.isSubmitting,
+    });
+    const submitBtnEl = submitBtn.el;
+    const btnTextNode = document.createTextNode(cfg.submitLabel ?? 'Submit');
+    submitBtnEl.appendChild(btnTextNode);
+    actionsRow.appendChild(submitBtnEl);
+    disposers.push(submitBtn.destroy);
+    grid.appendChild(actionsRow);
+    // -- Sync DOM → state ------------------------------------------------------
+    // Safety net for browser autofill, which can set DOM values without firing
+    // the input/change events our prop bindings rely on. Two-phase: capture all
+    // DOM values first, then write to state — writing mid-loop would trigger
+    // other atoms' applyState() effects and overwrite their autofilled DOM.
+    const syncDomToState = () => {
+        const captured = [];
+        for (const field of cfg.fields) {
+            if (collapsedFields.has(field.name))
+                continue;
+            // checkbox/radio/toggle propagate via change events; autofill doesn't apply
+            if (field.type === 'checkbox' ||
+                field.type === 'toggle' ||
+                field.type === 'radio') {
+                continue;
+            }
+            const el = form.querySelector(`[name="${CSS.escape(field.name)}"]`);
+            if (!el)
+                continue;
+            captured.push([field.name, el.value]);
+        }
+        for (const [name, value] of captured) {
+            if (value !== state.values()[name]) {
+                state.setValue(name, value);
+            }
+        }
+    };
+    // -- Submit handler -------------------------------------------------------
+    const handleSubmit = async (e) => {
+        if (!action && !onSubmit) {
+            e.preventDefault();
+            if (import.meta.env?.DEV) {
+                console.warn('[PithyJS] DynamicForm requires `onSubmit` when no `action` is provided.');
+            }
+            return;
+        }
+        if (state.isSubmitting() || flashActive) {
+            e.preventDefault();
+            return;
+        }
+        if (honeypotInput && honeypotInput.value) {
+            e.preventDefault();
+            return;
+        }
+        syncDomToState();
+        const valid = state.validateAll();
+        if (!valid) {
+            e.preventDefault();
+            handleValidationFailure(form, state, statusEl);
+            return;
+        }
+        statusEl.textContent = '';
+        // Native submission — don't preventDefault; set isSubmitting so the
+        // guard above blocks rapid re-submits before the browser navigates.
+        if (action && !onSubmit) {
+            state.isSubmitting.set(true);
+            return;
+        }
+        // JS submission — preventDefault and call onSubmit.
+        e.preventDefault();
+        state.isSubmitting.set(true);
+        let succeeded = false;
+        try {
+            if (onSubmit) {
+                // Shallow (top-level) copy — Object.fromEntries produces a new outer
+                // object so consumers can't mutate our internal values map. Every
+                // built-in FieldConfig type produces a primitive value, so nested
+                // sharing is not a concern today; revisit if complex types land.
+                // Excludes collapsed (dependsOn-hidden) and disabled fields to match
+                // native HTML form submission semantics.
+                const visibleValues = Object.fromEntries(Object.entries(state.values()).filter(([name]) => !collapsedFields.has(name) && !disabledFieldNames.has(name)));
+                await onSubmit(visibleValues);
+            }
+            succeeded = true;
+        }
+        catch (err) {
+            if (import.meta.env?.DEV) {
+                console.error('[PithyJS] DynamicForm onSubmit threw:', err);
+            }
+        }
+        finally {
+            state.isSubmitting.set(false);
+        }
+        if (succeeded) {
+            // Announce success to screen readers
+            statusEl.textContent = 'Form submitted successfully.';
+            // Reset form state so fields clear
+            state.reset();
+            flashActive = true;
+            const originalText = btnTextNode.textContent;
+            btnTextNode.textContent = '';
+            submitBtnEl.setAttribute('data-color', 'success');
+            const checkSpan = document.createElement('span');
+            checkSpan.classList.add('ui-dynamic-form-check');
+            checkSpan.innerHTML = CHECK_ICON;
+            const successText = document.createTextNode(' Sent!');
+            submitBtnEl.appendChild(checkSpan);
+            submitBtnEl.appendChild(successText);
+            successTimer = window.setTimeout(() => {
+                submitBtnEl.setAttribute('data-color', 'primary');
+                checkSpan.remove();
+                successText.remove();
+                btnTextNode.textContent = originalText;
+                successTimer = undefined;
+                flashActive = false;
+            }, 1500);
+        }
+    };
+    form.addEventListener('submit', handleSubmit);
+    disposers.push(() => form.removeEventListener('submit', handleSubmit));
+    // -- Destroy --------------------------------------------------------------
+    function destroy() {
+        if (successTimer != null)
+            clearTimeout(successTimer);
+        flashActive = false;
+        for (const dispose of disposers)
+            dispose();
+        disposers.length = 0;
+        form.replaceChildren();
+    }
+    return { el: form, destroy };
+}
+//# sourceMappingURL=DynamicForm.js.map

package/dist/organisms/forms/DynamicForm.js.map

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

package/dist/organisms/forms/Form.d.ts

@@ -0,0 +1,62 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.form",
+  "title": "<Form> Organism",
+  "category": "feature"
+}
+*/
+import { type FormState, type ValidateOn } from './form-state';
+import type { ValidationRule } from './validation';
+/** @codexApi {"parent":"pithy.ui-kit.form","name":"FormProps","stability":"stable","signature":"interface FormProps"} */
+export interface FormProps {
+    /** Called with current values when form is submitted and valid */
+    onSubmit: (values: Record<string, unknown>) => void | Promise<void>;
+    /** Initial field values (default: {}) */
+    initialValues?: Record<string, unknown>;
+    /** When to run validation (default: "submit") */
+    validateOn?: ValidateOn;
+    /** Validation rules keyed by field name */
+    validationRules?: Record<string, ValidationRule[]>;
+    /** Accessible label for the form (sets aria-label) */
+    ariaLabel?: string;
+    /** ID of an element that labels this form (sets aria-labelledby) */
+    ariaLabelledBy?: string;
+}
+/** @codexApi {"parent":"pithy.ui-kit.form","name":"FormResult","stability":"stable","signature":"interface FormResult"} */
+export interface FormResult {
+    el: HTMLFormElement;
+    destroy: () => void;
+    /** Exposed form state for manual wiring to child atoms */
+    state: FormState;
+}
+/**
+ * Semantic `<form>` organism with signal-based state engine.
+ *
+ * Creates a `<form novalidate>` element, manages submit lifecycle
+ * (validate → submit → complete), and exposes `state` on the return
+ * object for manual wiring to child form atoms.
+ *
+ * Children are appended by the caller — Form does not render fields
+ * itself. For config-driven field generation, use `<DynamicForm>`.
+ *
+ * @example
+ * ```typescript
+ * const form = Form({
+ *   initialValues: { email: "" },
+ *   validationRules: { email: [{ type: "required", message: "Required" }] },
+ *   onSubmit: (values) => console.log(values),
+ * });
+ * const input = Input({
+ *   label: "Email",
+ *   value: form.state.fieldValue("email"),
+ *   error: form.state.fieldHasError("email"),
+ *   errorMessage: form.state.fieldErrorMessage("email"),
+ *   onInput: (val) => form.state.setValue("email", val),
+ *   onBlur: () => form.state.setTouched("email"),
+ * });
+ * form.el.appendChild(input.el);
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.form","name":"Form","stability":"stable","signature":"(props: FormProps) => FormResult"} */
+export declare function Form({ onSubmit, initialValues, validateOn, validationRules, ariaLabel, ariaLabelledBy, }: FormProps): FormResult;
+//# sourceMappingURL=Form.d.ts.map

package/dist/organisms/forms/Form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../../src/organisms/forms/Form.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAIF,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAWnD,yHAAyH;AACzH,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,iDAAiD;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACnD,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2HAA2H;AAC3H,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,eAAe,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,0DAA0D;IAC1D,KAAK,EAAE,SAAS,CAAC;CAClB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iIAAiI;AACjI,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,aAAyB,EACzB,UAAsB,EACtB,eAA2B,EAC3B,SAAqB,EACrB,cAA0B,GAC3B,EAAE,SAAS,GAAG,UAAU,CAmGxB"}