@mj-biz-apps/forms-ng 0.0.0 → 0.2.0

package/dist/lib/widget/core/validation.js

@@ -0,0 +1,105 @@
+const VALID = { valid: true, message: null };
+/** True when a value counts as "supplied" (non-empty string / non-empty array / present). */
+export function hasValue(value) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (typeof value === 'string') {
+        return value.trim().length > 0;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    return true;
+}
+/**
+ * Validate one question's current value. Only call for VISIBLE questions — hidden
+ * questions (failed conditional rule) are never required and never validated.
+ */
+export function validateQuestion(question, value) {
+    if (question.type === 'Statement') {
+        return VALID;
+    }
+    const present = hasValue(value);
+    if (question.isRequired && !present) {
+        return { valid: false, message: 'This question is required.' };
+    }
+    if (!present) {
+        return VALID;
+    }
+    const typeResult = validateByType(question, value);
+    if (!typeResult.valid) {
+        return typeResult;
+    }
+    return validateRule(question.validationRule, value);
+}
+/** Built-in format checks for typed questions (Email, Phone, Number). */
+function validateByType(question, value) {
+    switch (question.type) {
+        case 'Email':
+            return isEmail(String(value))
+                ? VALID
+                : { valid: false, message: 'Enter a valid email address.' };
+        case 'Number':
+        case 'Rating':
+        case 'NPS':
+            return Number.isFinite(toNumber(value))
+                ? VALID
+                : { valid: false, message: 'Enter a number.' };
+        default:
+            return VALID;
+    }
+}
+/** Apply the declarative {@link ValidationRule} (length / range / pattern). */
+function validateRule(rule, value) {
+    if (!rule) {
+        return VALID;
+    }
+    const text = typeof value === 'string' ? value : undefined;
+    if (text !== undefined) {
+        if (rule.minLength !== undefined && text.length < rule.minLength) {
+            return { valid: false, message: `Use at least ${rule.minLength} characters.` };
+        }
+        if (rule.maxLength !== undefined && text.length > rule.maxLength) {
+            return { valid: false, message: `Use at most ${rule.maxLength} characters.` };
+        }
+        if (rule.pattern !== undefined && !matchesPattern(text, rule.pattern)) {
+            return { valid: false, message: rule.patternMessage ?? 'Value is not in the expected format.' };
+        }
+    }
+    const num = toNumber(value);
+    if (num !== undefined) {
+        if (rule.min !== undefined && num < rule.min) {
+            return { valid: false, message: `Must be at least ${rule.min}.` };
+        }
+        if (rule.max !== undefined && num > rule.max) {
+            return { valid: false, message: `Must be at most ${rule.max}.` };
+        }
+    }
+    return VALID;
+}
+/** Anchored full-string regex test; an invalid pattern source never blocks the user. */
+function matchesPattern(text, pattern) {
+    try {
+        return new RegExp(`^(?:${pattern})$`).test(text);
+    }
+    catch {
+        return true;
+    }
+}
+/** Pragmatic email check — intentionally lenient; the server is authoritative. */
+function isEmail(text) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(text.trim());
+}
+/** Coerce to a finite number or `undefined`. */
+function toNumber(value) {
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === 'string' && value.trim() !== '') {
+        const n = Number(value);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=validation.js.map

package/dist/lib/widget/core/validation.js.map

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

package/dist/lib/widget/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Public surface of the respondent widget (WP-C). Exposes the `<mj-form>` root
+ * component, the custom-element registration, the S1 API seam (interface + token +
+ * real/mock implementations + config), and the headless runtime — so host apps can
+ * embed the element OR mount the component directly with their own provider wiring.
+ */
+export { MjFormComponent } from './mj-form.component';
+export { registerMjFormElement, MJ_FORM_TAG } from './register-element';
+export { FORMS_API_SERVICE, type IFormsApiService } from './api/forms-api.interface';
+export { FORMS_API_CONFIG, type FormsApiConfig, deriveUploadUrl, normalizeApiConfig, } from './api/forms-api.config';
+export { FormsGraphQLApiService } from './api/forms-api.graphql.service';
+export { FormsMockApiService } from './api/forms-api.mock.service';
+export { FormUploadService, buildUploadFormData, parseUploadResponse, type UploadedFile, type UploadProgress, } from './api/form-upload.service';
+export { FormScrollComponent } from './components/form-scroll.component';
+export { FormOneQuestionComponent } from './components/form-one-question.component';
+export { TurnstileChallengeComponent } from './components/turnstile-challenge.component';
+export { FormQuestionComponent } from './components/questions/form-question.component';
+export { FormProgressComponent } from './components/form-progress.component';
+export { FormRuntime } from './core/form-runtime';
+export { AutosaveController, type AutosaveFn, type AutosaveStatus, type TimerApi, } from './core/autosave-controller';
+export { clampCursor } from './core/one-question-stepper';
+export { applyStyleTokens } from './core/theming';
+export { validateQuestion, hasValue, type FieldValidationResult } from './core/validation';
+export { toAnswerInputs, type AnswerMap } from './core/answer-value';
+export { captchaRequired, canRenderChallenge, canSubmit, isConfigGap, isSiteKeyConfigured, isTurnstileError, } from './core/turnstile-gate';
+export { ensureTurnstileScript, getTurnstile, DEFAULT_TURNSTILE_SCRIPT_URL, type TurnstileApi, type TurnstileRenderOptions, } from './core/turnstile-loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/widget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/widget/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,QAAQ,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,4BAA4B,EAC5B,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,yBAAyB,CAAC"}

package/dist/lib/widget/index.js

@@ -0,0 +1,30 @@
+/**
+ * Public surface of the respondent widget (WP-C). Exposes the `<mj-form>` root
+ * component, the custom-element registration, the S1 API seam (interface + token +
+ * real/mock implementations + config), and the headless runtime — so host apps can
+ * embed the element OR mount the component directly with their own provider wiring.
+ */
+export { MjFormComponent } from './mj-form.component';
+export { registerMjFormElement, MJ_FORM_TAG } from './register-element';
+// S1 API seam
+export { FORMS_API_SERVICE } from './api/forms-api.interface';
+export { FORMS_API_CONFIG, deriveUploadUrl, normalizeApiConfig, } from './api/forms-api.config';
+export { FormsGraphQLApiService } from './api/forms-api.graphql.service';
+export { FormsMockApiService } from './api/forms-api.mock.service';
+export { FormUploadService, buildUploadFormData, parseUploadResponse, } from './api/form-upload.service';
+// Render-mode + question components (for direct embedding / testing)
+export { FormScrollComponent } from './components/form-scroll.component';
+export { FormOneQuestionComponent } from './components/form-one-question.component';
+export { TurnstileChallengeComponent } from './components/turnstile-challenge.component';
+export { FormQuestionComponent } from './components/questions/form-question.component';
+export { FormProgressComponent } from './components/form-progress.component';
+// Headless runtime + helpers
+export { FormRuntime } from './core/form-runtime';
+export { AutosaveController, } from './core/autosave-controller';
+export { clampCursor } from './core/one-question-stepper';
+export { applyStyleTokens } from './core/theming';
+export { validateQuestion, hasValue } from './core/validation';
+export { toAnswerInputs } from './core/answer-value';
+export { captchaRequired, canRenderChallenge, canSubmit, isConfigGap, isSiteKeyConfigured, isTurnstileError, } from './core/turnstile-gate';
+export { ensureTurnstileScript, getTurnstile, DEFAULT_TURNSTILE_SCRIPT_URL, } from './core/turnstile-loader';
+//# sourceMappingURL=index.js.map

package/dist/lib/widget/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/widget/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAExE,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAyB,MAAM,2BAA2B,CAAC;AACrF,OAAO,EACL,gBAAgB,EAEhB,eAAe,EACf,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,2BAA2B,CAAC;AAEnC,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,kBAAkB,GAInB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAA8B,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAkB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,4BAA4B,GAG7B,MAAM,yBAAyB,CAAC"}

package/dist/lib/widget/mj-form.component.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Root of the `<mj-form>` custom element. Loads the published form via the S1 API,
+ * builds the shared {@link FormRuntime}, themes the host from the form's style tokens,
+ * picks the render mode, and handles submit / partial-save.
+ *
+ * It is a normal standalone Angular component; {@link registerMjFormElement} wraps it
+ * as a browser custom element. No Explorer shell, no MJ global provider — everything
+ * it needs arrives via DI (the API service) and `@Input` (the distribution slug).
+ */
+import { OnDestroy, OnInit } from '@angular/core';
+import type { FormSubmissionResult, PublishedFormDefinition } from '@mj-biz-apps/forms-entities';
+import { FormRuntime } from './core/form-runtime';
+import { type AutosaveStatus } from './core/autosave-controller';
+import type { WidgetPhase } from './core/submit-phase';
+import * as i0 from "@angular/core";
+export declare class MjFormComponent implements OnInit, OnDestroy {
+    /** Distribution slug identifying which published form to load (element attribute). */
+    readonly distributionSlug: import("@angular/core").InputSignal<string>;
+    /**
+     * Pre-built definition to render directly, bypassing the API fetch. Used by the
+     * builder's WYSIWYG Preview to render the unpublished draft (fillable, themed) with no
+     * publish/DB round-trip. When set, {@link load} skips `loadPublishedForm`.
+     */
+    readonly definitionInput: import("@angular/core").InputSignal<PublishedFormDefinition | null>;
+    private readonly api;
+    private readonly config;
+    private readonly hostRef;
+    private readonly startedAt;
+    /** The mounted Turnstile challenge (present only when captcha is required + rendered). */
+    private readonly turnstile;
+    protected readonly phase: import("@angular/core").WritableSignal<WidgetPhase>;
+    protected readonly errorText: import("@angular/core").WritableSignal<string>;
+    protected readonly definition: import("@angular/core").WritableSignal<PublishedFormDefinition | null>;
+    protected readonly runtime: import("@angular/core").WritableSignal<FormRuntime | null>;
+    protected readonly result: import("@angular/core").WritableSignal<FormSubmissionResult | null>;
+    /** Subtle, non-blocking autosave indicator. */
+    protected readonly autosaveStatus: import("@angular/core").WritableSignal<AutosaveStatus>;
+    /** Public Cloudflare Turnstile site key (global; from widget config). May be undefined. */
+    protected readonly siteKey: string | undefined;
+    /** Non-null site key for the template's `[siteKey]` binding (guarded by `showChallenge`). */
+    protected readonly resolvedSiteKey: import("@angular/core").Signal<string>;
+    /** Solved single-use Turnstile token, held until the final submit consumes it. */
+    private readonly turnstileToken;
+    /** True when this form requires a captcha challenge before submit. */
+    protected readonly needsCaptcha: import("@angular/core").Signal<boolean>;
+    /** Render the challenge only when required AND a site key is configured. */
+    protected readonly showChallenge: import("@angular/core").Signal<boolean>;
+    /** Captcha is required but no site key is configured — show the config-gap message. */
+    protected readonly captchaConfigGap: import("@angular/core").Signal<boolean>;
+    /** Whether the final submit is allowed given the current captcha state. */
+    protected readonly submitAllowed: import("@angular/core").Signal<boolean>;
+    /**
+     * Stable client-generated response id, minted ONCE per form load. It is the PRIMARY
+     * idempotency key: sent as the response target on every partial autosave AND the final
+     * submit so they all UPSERT one FormResponse row, independent of debounce/network timing
+     * or a blank server session id. The server adopts it as the row's primary key on first
+     * save. Regenerated on each {@link load} (a retry starts a fresh response).
+     */
+    private clientResponseId;
+    /**
+     * Server-echoed response id, if returned. Kept only as a fallback/consistency signal —
+     * {@link clientResponseId} is authoritative, so submits never block on the server echo.
+     */
+    private responseId;
+    private autosave;
+    ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
+    /** Fetch (or accept) the form definition, theme the host, and build the runtime. */
+    private load;
+    protected isScroll(): boolean;
+    /** Progress checkpoint from a child render mode → schedule a debounced partial save. */
+    protected onProgress(): void;
+    protected onSubmit(): Promise<void>;
+    /**
+     * Fold the server result into the widget phase. On success we reach the 'done'
+     * confirmation for BOTH render modes and ONLY redirect when a redirect URL is actually
+     * set; on failure we return to 'ready' with a clear message.
+     */
+    private applySubmitResult;
+    /** Called by the challenge when the respondent solves it — holds the single-use token. */
+    protected onTurnstileSolved(token: string): void;
+    /** Token expired (~300s) — clear it so submit re-gates; the child re-arms itself. */
+    protected onTurnstileExpired(): void;
+    /** The challenge failed to load/render — surface a clear, actionable message. */
+    protected onTurnstileErrored(): void;
+    /**
+     * When a failed submit came from the server's Turnstile check, the single-use token is
+     * spent — clear it and reset the challenge so the respondent can solve a fresh one.
+     */
+    private handlePossibleTurnstileFailure;
+    private captchaBlockedMessage;
+    /**
+     * Save the current answers as a Partial response (server upserts, runs no hooks/quota).
+     * Reuses the returned {@link responseId} so subsequent autosaves update the same record.
+     * Throws on failure so the {@link AutosaveController} can mark the status — it swallows
+     * the error, keeping autosave strictly non-blocking for the respondent.
+     */
+    private savePartial;
+    /**
+     * The response id sent to the server as the upsert target. The client-generated id is
+     * PRIMARY (stable across the whole fill); the server echo is only a fallback if for some
+     * reason the client id were ever unavailable.
+     */
+    private responseTarget;
+    /** Build a submission payload for either a partial autosave or the final submit. */
+    private buildSubmission;
+    protected confirmationMessage(): string;
+    protected retry(): void;
+    private fail;
+    private redirect;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MjFormComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MjFormComponent, "mj-form", never, { "distributionSlug": { "alias": "slug"; "required": false; "isSignal": true; }; "definitionInput": { "alias": "definition"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+//# sourceMappingURL=mj-form.component.d.ts.map

package/dist/lib/widget/mj-form.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mj-form.component.d.ts","sourceRoot":"","sources":["../../../src/lib/widget/mj-form.component.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAOL,SAAS,EACT,MAAM,EAGP,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEV,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAarF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;;AAEvD,qBAQa,eAAgB,YAAW,MAAM,EAAE,SAAS;IACvD,sFAAsF;IACtF,SAAgB,gBAAgB,8CAAwC;IAExE;;;;OAIG;IACH,SAAgB,eAAe,sEAAwE;IAEvG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IAEtD,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,SAAS,CAAC,QAAQ,CAAC,KAAK,sDAAkC;IAC1D,SAAS,CAAC,QAAQ,CAAC,SAAS,iDAAsB;IAClD,SAAS,CAAC,QAAQ,CAAC,UAAU,yEAAgD;IAC7E,SAAS,CAAC,QAAQ,CAAC,OAAO,6DAAoC;IAC9D,SAAS,CAAC,QAAQ,CAAC,MAAM,sEAA6C;IAEtE,+CAA+C;IAC/C,SAAS,CAAC,QAAQ,CAAC,cAAc,yDAAkC;IAEnE,2FAA2F;IAC3F,SAAS,CAAC,QAAQ,CAAC,OAAO,qBAAgC;IAE1D,6FAA6F;IAC7F,SAAS,CAAC,QAAQ,CAAC,eAAe,yCAAsC;IAExE,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAE9D,sEAAsE;IACtE,SAAS,CAAC,QAAQ,CAAC,YAAY,0CAAsD;IAErF,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,CAAC,aAAa,0CAE9B;IAEF,uFAAuF;IACvF,SAAS,CAAC,QAAQ,CAAC,gBAAgB,0CAEjC;IAEF,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,CAAC,aAAa,0CAE9B;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB,CAAsC;IAE9D;;;OAGG;IACH,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAmC;IAEtC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,WAAW,IAAI,IAAI;IAI1B,oFAAoF;YACtE,IAAI;IA0BlB,SAAS,CAAC,QAAQ,IAAI,OAAO;IAI7B,wFAAwF;IACxF,SAAS,CAAC,UAAU,IAAI,IAAI;cAIZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCzC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAsBzB,0FAA0F;IAC1F,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,qFAAqF;IACrF,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAIpC,iFAAiF;IACjF,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAKpC;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,qBAAqB;IAM7B;;;;;OAKG;YACW,WAAW;IAuBzB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB,oFAAoF;IACpF,OAAO,CAAC,eAAe;IAsBvB,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAQvC,SAAS,CAAC,KAAK,IAAI,IAAI;IAIvB,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,QAAQ;yCAnSL,eAAe;2CAAf,eAAe;CAwS3B"}