@molecule/app-angular 1.0.0

package/dist/services/forms.service.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Angular service for form handling.
+ *
+ * @module
+ */
+import { type OnDestroy } from '@angular/core';
+import { type Observable } from 'rxjs';
+import type { FieldRegistration, FormController, FormOptions, FormProvider, FormState, RegisterOptions } from '@molecule/app-forms';
+import * as i0 from "@angular/core";
+/**
+ * Wrapper around a FormController that provides RxJS observables and
+ * synchronous accessors for use in Angular components.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'app-login-form',
+ *   template: `
+ *     <form (ngSubmit)="onSubmit()">
+ *       <input [value]="emailValue" (input)="emailReg.onChange($event)" (blur)="emailReg.onBlur()">
+ *       <span *ngIf="errors$ | async as errors">{{ errors['email'] }}</span>
+ *       <button type="submit" [disabled]="isSubmitting$ | async">Submit</button>
+ *     </form>
+ *   `
+ * })
+ * export class LoginFormComponent implements OnInit, OnDestroy {
+ *   private form!: MoleculeFormInstance<{ email: string; password: string }>
+ *   emailReg!: FieldRegistration
+ *
+ *   errors$ = new Observable<Partial<Record<string, string>>>()
+ *   isSubmitting$ = new Observable<boolean>()
+ *
+ *   constructor(private formsService: MoleculeFormsService) {}
+ *
+ *   ngOnInit() {
+ *     this.form = this.formsService.createForm(myProvider, {
+ *       defaultValues: { email: '', password: '' },
+ *       mode: 'onBlur',
+ *     })
+ *     this.emailReg = this.form.register('email', { required: true, email: true })
+ *     this.errors$ = this.form.errors$
+ *     this.isSubmitting$ = this.form.isSubmitting$
+ *   }
+ *
+ *   onSubmit() {
+ *     const handler = this.form.handleSubmit(async (values) => {
+ *       await login(values)
+ *     })
+ *     handler()
+ *   }
+ *
+ *   ngOnDestroy() {
+ *     this.form.destroy()
+ *   }
+ * }
+ * ```
+ */
+export declare class MoleculeFormInstance<T extends Record<string, unknown>> {
+    private controller;
+    private stateSubject;
+    private unsubscribe;
+    /**
+     * Observable of the full form state.
+     */
+    state$: Observable<FormState<T>>;
+    /**
+     * Observable of form validity.
+     */
+    isValid$: Observable<boolean>;
+    /**
+     * Observable of form dirty state.
+     */
+    isDirty$: Observable<boolean>;
+    /**
+     * Observable of form submitting state.
+     */
+    isSubmitting$: Observable<boolean>;
+    /**
+     * Observable of field errors.
+     */
+    errors$: Observable<Partial<Record<keyof T, string>>>;
+    constructor(controller: FormController<T>);
+    /**
+     * Get the current form state snapshot.
+     * @returns The current form state including values, errors, validity, and submission status.
+     */
+    get state(): FormState<T>;
+    /**
+     * Get the current form validity snapshot.
+     * @returns `true` if all fields pass validation, `false` otherwise.
+     */
+    get isValid(): boolean;
+    /**
+     * Get the current form dirty state snapshot.
+     * @returns `true` if any field has been modified from its default value, `false` otherwise.
+     */
+    get isDirty(): boolean;
+    /**
+     * Get the current form submitting state snapshot.
+     * @returns `true` if the form is currently being submitted, `false` otherwise.
+     */
+    get isSubmitting(): boolean;
+    /**
+     * Register a field for form management.
+     *
+     * @param name - The field name corresponding to a key in the form values type.
+     * @param options - Registration options including validation rules and default value.
+     * @returns The field registration with value, onChange, onBlur, and ref bindings.
+     */
+    register(name: keyof T, options?: Omit<RegisterOptions, 'name'>): FieldRegistration;
+    /**
+     * Get the value of a specific field.
+     *
+     * @param name - The field name corresponding to a key in the form values type.
+     * @returns The current value of the specified field.
+     */
+    getValue<K extends keyof T>(name: K): T[K];
+    /**
+     * Set the value of a specific field.
+     *
+     * @param name - The field name corresponding to a key in the form values type.
+     * @param value - The new value to set for the field.
+     */
+    setValue<K extends keyof T>(name: K, value: T[K]): void;
+    /**
+     * Get the error for a specific field.
+     *
+     * @param name - The field name to retrieve the error for.
+     * @returns The error message for the field, or `undefined` if the field has no error.
+     */
+    getError(name: keyof T): string | undefined;
+    /**
+     * Set the error for a specific field.
+     *
+     * @param name - The field name to set or clear the error for.
+     * @param error - The error message to set, or `undefined` to clear the error.
+     */
+    setError(name: keyof T, error: string | undefined): void;
+    /**
+     * Clear all field errors.
+     */
+    clearErrors(): void;
+    /**
+     * Create a submit handler function.
+     *
+     * @param onSubmit - Callback invoked with validated form values on successful submission.
+     * @param onError - Optional callback invoked with field errors when validation fails.
+     * @returns A submit handler function that can be called from form submit events.
+     */
+    handleSubmit(onSubmit: (values: T) => void | Promise<void>, onError?: (errors: Partial<Record<keyof T, string>>) => void): (event?: {
+        preventDefault?: () => void;
+    }) => Promise<void>;
+    /**
+     * Reset the form to initial values.
+     *
+     * @param values - Optional partial values to use as the new initial state.
+     */
+    reset(values?: Partial<T>): void;
+    /**
+     * Validate all fields.
+     *
+     * @returns A promise that resolves to `true` if all fields are valid, `false` otherwise.
+     */
+    validate(): Promise<boolean>;
+    /**
+     * Destroy the form instance and clean up subscriptions.
+     */
+    destroy(): void;
+}
+/**
+ * Angular service for form handling.
+ *
+ * Wraps molecule form providers and creates form instances that expose
+ * state as RxJS observables.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'app-registration',
+ *   template: `
+ *     <form (ngSubmit)="submit()">
+ *       <div *ngIf="form">
+ *         <input
+ *           [value]="(form.state$ | async)?.values?.['username']"
+ *           (input)="usernameReg.onChange($event)"
+ *           (blur)="usernameReg.onBlur()"
+ *         />
+ *         <span *ngIf="(form.errors$ | async)?.['username'] as error">{{ error }}</span>
+ *         <button type="submit" [disabled]="form.isSubmitting$ | async">Register</button>
+ *       </div>
+ *     </form>
+ *   `
+ * })
+ * export class RegistrationComponent implements OnInit, OnDestroy {
+ *   form!: MoleculeFormInstance<{ username: string; email: string }>
+ *   usernameReg!: FieldRegistration
+ *
+ *   constructor(private formsService: MoleculeFormsService) {}
+ *
+ *   ngOnInit() {
+ *     this.form = this.formsService.createForm(myFormProvider, {
+ *       defaultValues: { username: '', email: '' },
+ *     })
+ *     this.usernameReg = this.form.register('username', { required: true })
+ *   }
+ *
+ *   submit() {
+ *     const handler = this.form.handleSubmit(async (values) => {
+ *       await registerUser(values)
+ *     })
+ *     handler()
+ *   }
+ *
+ *   ngOnDestroy() {
+ *     this.form.destroy()
+ *   }
+ * }
+ * ```
+ */
+export declare class MoleculeFormsService implements OnDestroy {
+    private instances;
+    /**
+     * Create a form instance from a provider.
+     *
+     * @param provider - The form provider that creates form controllers.
+     * @param options - Form configuration including default values and validation mode.
+     * @returns A new form instance with RxJS observables for reactive state tracking.
+     */
+    createForm<T extends Record<string, unknown>>(provider: FormProvider, options: FormOptions<T>): MoleculeFormInstance<T>;
+    /**
+     * Destroy all managed form instances on service destruction.
+     */
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MoleculeFormsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MoleculeFormsService>;
+}
+//# sourceMappingURL=forms.service.d.ts.map

package/dist/services/forms.service.d.ts.map

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

package/dist/services/forms.service.js

@@ -0,0 +1,280 @@
+/**
+ * Angular service for form handling.
+ *
+ * @module
+ */
+import { Injectable } from '@angular/core';
+import { BehaviorSubject, distinctUntilChanged, map } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Wrapper around a FormController that provides RxJS observables and
+ * synchronous accessors for use in Angular components.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'app-login-form',
+ *   template: `
+ *     <form (ngSubmit)="onSubmit()">
+ *       <input [value]="emailValue" (input)="emailReg.onChange($event)" (blur)="emailReg.onBlur()">
+ *       <span *ngIf="errors$ | async as errors">{{ errors['email'] }}</span>
+ *       <button type="submit" [disabled]="isSubmitting$ | async">Submit</button>
+ *     </form>
+ *   `
+ * })
+ * export class LoginFormComponent implements OnInit, OnDestroy {
+ *   private form!: MoleculeFormInstance<{ email: string; password: string }>
+ *   emailReg!: FieldRegistration
+ *
+ *   errors$ = new Observable<Partial<Record<string, string>>>()
+ *   isSubmitting$ = new Observable<boolean>()
+ *
+ *   constructor(private formsService: MoleculeFormsService) {}
+ *
+ *   ngOnInit() {
+ *     this.form = this.formsService.createForm(myProvider, {
+ *       defaultValues: { email: '', password: '' },
+ *       mode: 'onBlur',
+ *     })
+ *     this.emailReg = this.form.register('email', { required: true, email: true })
+ *     this.errors$ = this.form.errors$
+ *     this.isSubmitting$ = this.form.isSubmitting$
+ *   }
+ *
+ *   onSubmit() {
+ *     const handler = this.form.handleSubmit(async (values) => {
+ *       await login(values)
+ *     })
+ *     handler()
+ *   }
+ *
+ *   ngOnDestroy() {
+ *     this.form.destroy()
+ *   }
+ * }
+ * ```
+ */
+export class MoleculeFormInstance {
+    constructor(controller) {
+        this.controller = controller;
+        this.unsubscribe = null;
+        this.stateSubject = new BehaviorSubject(controller.getState());
+        this.unsubscribe = controller.subscribe((state) => {
+            this.stateSubject.next(state);
+        });
+        this.state$ = this.stateSubject.asObservable();
+        this.isValid$ = this.state$.pipe(map((state) => state.isValid), distinctUntilChanged());
+        this.isDirty$ = this.state$.pipe(map((state) => state.isDirty), distinctUntilChanged());
+        this.isSubmitting$ = this.state$.pipe(map((state) => state.isSubmitting), distinctUntilChanged());
+        this.errors$ = this.state$.pipe(map((state) => state.errors), distinctUntilChanged());
+    }
+    /**
+     * Get the current form state snapshot.
+     * @returns The current form state including values, errors, validity, and submission status.
+     */
+    get state() {
+        return this.controller.getState();
+    }
+    /**
+     * Get the current form validity snapshot.
+     * @returns `true` if all fields pass validation, `false` otherwise.
+     */
+    get isValid() {
+        return this.controller.getState().isValid;
+    }
+    /**
+     * Get the current form dirty state snapshot.
+     * @returns `true` if any field has been modified from its default value, `false` otherwise.
+     */
+    get isDirty() {
+        return this.controller.getState().isDirty;
+    }
+    /**
+     * Get the current form submitting state snapshot.
+     * @returns `true` if the form is currently being submitted, `false` otherwise.
+     */
+    get isSubmitting() {
+        return this.controller.getState().isSubmitting;
+    }
+    /**
+     * Register a field for form management.
+     *
+     * @param name - The field name corresponding to a key in the form values type.
+     * @param options - Registration options including validation rules and default value.
+     * @returns The field registration with value, onChange, onBlur, and ref bindings.
+     */
+    register(name, options) {
+        return this.controller.register({ ...options, name: name });
+    }
+    /**
+     * Get the value of a specific field.
+     *
+     * @param name - The field name corresponding to a key in the form values type.
+     * @returns The current value of the specified field.
+     */
+    getValue(name) {
+        return this.controller.getValue(name);
+    }
+    /**
+     * Set the value of a specific field.
+     *
+     * @param name - The field name corresponding to a key in the form values type.
+     * @param value - The new value to set for the field.
+     */
+    setValue(name, value) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.controller.setValue(name, value);
+    }
+    /**
+     * Get the error for a specific field.
+     *
+     * @param name - The field name to retrieve the error for.
+     * @returns The error message for the field, or `undefined` if the field has no error.
+     */
+    getError(name) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.controller.getError(name);
+    }
+    /**
+     * Set the error for a specific field.
+     *
+     * @param name - The field name to set or clear the error for.
+     * @param error - The error message to set, or `undefined` to clear the error.
+     */
+    setError(name, error) {
+        if (error !== undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.controller.setError(name, error);
+        }
+        else {
+            this.controller.clearError(name);
+        }
+    }
+    /**
+     * Clear all field errors.
+     */
+    clearErrors() {
+        this.controller.clearErrors();
+    }
+    /**
+     * Create a submit handler function.
+     *
+     * @param onSubmit - Callback invoked with validated form values on successful submission.
+     * @param onError - Optional callback invoked with field errors when validation fails.
+     * @returns A submit handler function that can be called from form submit events.
+     */
+    handleSubmit(onSubmit, onError) {
+        return this.controller.handleSubmit(onSubmit, onError);
+    }
+    /**
+     * Reset the form to initial values.
+     *
+     * @param values - Optional partial values to use as the new initial state.
+     */
+    reset(values) {
+        this.controller.reset(values);
+    }
+    /**
+     * Validate all fields.
+     *
+     * @returns A promise that resolves to `true` if all fields are valid, `false` otherwise.
+     */
+    validate() {
+        return this.controller.validate();
+    }
+    /**
+     * Destroy the form instance and clean up subscriptions.
+     */
+    destroy() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.stateSubject.complete();
+        this.controller.destroy();
+    }
+}
+/**
+ * Angular service for form handling.
+ *
+ * Wraps molecule form providers and creates form instances that expose
+ * state as RxJS observables.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'app-registration',
+ *   template: `
+ *     <form (ngSubmit)="submit()">
+ *       <div *ngIf="form">
+ *         <input
+ *           [value]="(form.state$ | async)?.values?.['username']"
+ *           (input)="usernameReg.onChange($event)"
+ *           (blur)="usernameReg.onBlur()"
+ *         />
+ *         <span *ngIf="(form.errors$ | async)?.['username'] as error">{{ error }}</span>
+ *         <button type="submit" [disabled]="form.isSubmitting$ | async">Register</button>
+ *       </div>
+ *     </form>
+ *   `
+ * })
+ * export class RegistrationComponent implements OnInit, OnDestroy {
+ *   form!: MoleculeFormInstance<{ username: string; email: string }>
+ *   usernameReg!: FieldRegistration
+ *
+ *   constructor(private formsService: MoleculeFormsService) {}
+ *
+ *   ngOnInit() {
+ *     this.form = this.formsService.createForm(myFormProvider, {
+ *       defaultValues: { username: '', email: '' },
+ *     })
+ *     this.usernameReg = this.form.register('username', { required: true })
+ *   }
+ *
+ *   submit() {
+ *     const handler = this.form.handleSubmit(async (values) => {
+ *       await registerUser(values)
+ *     })
+ *     handler()
+ *   }
+ *
+ *   ngOnDestroy() {
+ *     this.form.destroy()
+ *   }
+ * }
+ * ```
+ */
+export class MoleculeFormsService {
+    constructor() {
+        this.instances = [];
+    }
+    /**
+     * Create a form instance from a provider.
+     *
+     * @param provider - The form provider that creates form controllers.
+     * @param options - Form configuration including default values and validation mode.
+     * @returns A new form instance with RxJS observables for reactive state tracking.
+     */
+    createForm(provider, options) {
+        const controller = provider.createForm(options);
+        const instance = new MoleculeFormInstance(controller);
+        this.instances.push(instance);
+        return instance;
+    }
+    /**
+     * Destroy all managed form instances on service destruction.
+     */
+    ngOnDestroy() {
+        for (const instance of this.instances) {
+            instance.destroy();
+        }
+        this.instances = [];
+    }
+    static { this.ɵfac = function MoleculeFormsService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MoleculeFormsService)(); }; }
+    static { this.ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: MoleculeFormsService, factory: MoleculeFormsService.ɵfac, providedIn: 'root' }); }
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MoleculeFormsService, [{
+        type: Injectable,
+        args: [{
+                providedIn: 'root',
+            }]
+    }], null, null); })();
+//# sourceMappingURL=forms.service.js.map

package/dist/services/forms.service.js.map

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

package/dist/services/http.service.d.ts

@@ -0,0 +1,118 @@
+import { BehaviorSubject, type Observable } from 'rxjs';
+import type { HttpClient, HttpResponse, RequestConfig } from '@molecule/app-http';
+import * as i0 from "@angular/core";
+/**
+ * State for HTTP requests.
+ */
+export interface HttpState<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Angular service for HTTP requests.
+ *
+ * Wraps molecule HTTP client and returns RxJS observables.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'app-users',
+ *   template: `
+ *     <div *ngIf="loading$ | async">Loading...</div>
+ *     <div *ngIf="error$ | async as error">Error: {{ error.message }}</div>
+ *     <ul *ngIf="users$ | async as users">
+ *       <li *ngFor="let user of users">{{ user.name }}</li>
+ *     </ul>
+ *   `
+ * })
+ * export class UsersComponent implements OnInit {
+ *   users$ = this.httpService.get<User[]>('/api/users')
+ *
+ *   // Or with state management:
+ *   private state = this.httpService.createState<User[]>()
+ *   loading$ = this.state.pipe(map(s => s.loading))
+ *   error$ = this.state.pipe(map(s => s.error))
+ *   users$ = this.state.pipe(map(s => s.data))
+ *
+ *   constructor(private httpService: MoleculeHttpService) {}
+ *
+ *   ngOnInit() {
+ *     this.httpService.getWithState('/api/users', this.state)
+ *   }
+ * }
+ * ```
+ */
+export declare class MoleculeHttpService {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Make a GET request.
+     *
+     * @param url - Request URL
+     * @param config - Request configuration
+     * @returns Observable of response data
+     */
+    get<T>(url: string, config?: RequestConfig): Observable<T>;
+    /**
+     * Make a POST request.
+     *
+     * @param url - Request URL
+     * @param data - Request body
+     * @param config - Request configuration
+     * @returns Observable of response data
+     */
+    post<T>(url: string, data?: unknown, config?: RequestConfig): Observable<T>;
+    /**
+     * Make a PUT request.
+     *
+     * @param url - Request URL
+     * @param data - Request body
+     * @param config - Request configuration
+     * @returns Observable of response data
+     */
+    put<T>(url: string, data?: unknown, config?: RequestConfig): Observable<T>;
+    /**
+     * Make a PATCH request.
+     *
+     * @param url - Request URL
+     * @param data - Request body
+     * @param config - Request configuration
+     * @returns Observable of response data
+     */
+    patch<T>(url: string, data?: unknown, config?: RequestConfig): Observable<T>;
+    /**
+     * Make a DELETE request.
+     *
+     * @param url - Request URL
+     * @param config - Request configuration
+     * @returns Observable of response data
+     */
+    delete<T>(url: string, config?: RequestConfig): Observable<T>;
+    /**
+     * Get the full response (including headers, status, etc.).
+     *
+     * @param method - HTTP method
+     * @param url - Request URL
+     * @param config - Request configuration
+     * @returns Observable of full response
+     */
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', url: string, config?: RequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Create a state subject for managing request state.
+     *
+     * @returns The created instance.
+     */
+    createState<T>(): BehaviorSubject<HttpState<T>>;
+    /**
+     * Make a GET request with state management.
+     *
+     * @param url - Request URL
+     * @param state - State subject to update
+     * @param config - Request configuration
+     */
+    getWithState<T>(url: string, state: BehaviorSubject<HttpState<T>>, config?: RequestConfig): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MoleculeHttpService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MoleculeHttpService>;
+}
+//# sourceMappingURL=http.service.d.ts.map

package/dist/services/http.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.service.d.ts","sourceRoot":"","sources":["../../src/services/http.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;;AAIjF;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAMa,mBAAmB;IACG,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE3D;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC;IAI1D;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC;IAI3E;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC;IAI1E;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC;IAI5E;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC;IAI7D;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,EACP,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,EACnD,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,aAAa,GACrB,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA+B9B;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAQ/C;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI;yCA5HrF,mBAAmB;6CAAnB,mBAAmB;CAyI/B"}