@picked/client 0.0.1-dev.1789541668638 → 0.0.1-next.2

package/dist/types/entities/experience/experience.d.ts

@@ -1,180 +1,114 @@
-/** @file Experience entity — Effector stores, types, and lifecycle helpers for Picked experiences. */
-import { type Effect, type EventCallable, type Store } from 'effector';
-import type { AdaptedComponent } from '../component/component';
-import type { Condition } from '../condition/condition';
-import type { ExperienceStep } from '../step/step';
-import type { Framework } from '../framework/framework';
-import type { Picked } from '../../picked';
-import type { LogicRule, LogicValue } from '../../logic-engine';
-import type { NodeTreeIndex } from '../../utils/node-tree/node-tree-index';
+import { AdaptedComponent } from '../component/component';
+import { Picked } from '../../picked';
+import { LogicRule } from '../../logic-engine';
+import { Field } from '../field/field';
 export type ExperiencesListStore = ReturnType<typeof createExperienceIndex>;
-/** Per-experience reactive entity returned by `createExperience`. */
-export interface ExperienceStore {
+export type ExperienceStore = ReturnType<typeof createExperience>;
+declare const createExperienceFactory: ({ client, experience }: {
+    client: Picked;
+    experience: Experience;
+}) => {
     id: string;
-    key: string;
-    name: string;
-    configStore: Store<{
+    configStore: import('effector').Store<{
+        type: string;
         name: string;
-        decisionLogic?: LogicRule | LogicValue;
+        decisionLogic: LogicRule | undefined;
         targetSelectors: ExperienceTarget[];
-        initializeOpenLogic?: LogicRule | LogicValue;
     }>;
-    treeStore: Store<{
+    treeStore: import('effector').Store<{
         steps: ExperienceStep[];
         nodes: ExperienceNode[];
         edges: ExperienceEdge[];
-        conditions: Condition[];
+        conditionals: ExperienceConditional[];
     }>;
-    /**
-     * The experience's flow graph, indexed for constant-time reads: node and edge
-     * lookups, plus a table of the min/max steps from every node to a leaf and back
-     * to an origin. Derived from the experience record, so it rebuilds when that
-     * record updates and a table read costs a map lookup.
-     */
-    nodeTreeStore: Store<NodeTreeIndex>;
-    componentStore: Store<{
+    componentStore: import('effector').Store<{
         name: string;
-        component: AdaptedComponent;
-        frameworkStore: Store<Framework | undefined>;
+        component: AdaptedComponent<string, unknown>;
+        frameworkStore: import('effector').Store<import('../..').Framework | undefined>;
     } | undefined>;
-    actions: ExperienceAction[];
-    /** Effector event that merges a partial experience update into this store. */
-    merge: (payload: {
+    merge: import('effector').EventCallable<{
         experience: Partial<Experience>;
-        strategy: 'override';
-    }) => void;
-    /**
-     * Per-experience initialise effect. Attaches over `configStore` and spawns one
-     * instance per matched DOM target.
-     */
-    initialiseFx: Effect<LaunchExperienceOptions | undefined, void, Error>;
-    /**
-     * Per-experience gate evaluation effect. Attaches over `client.preconditionPassedStore`,
-     * the session's `isUser` slice, and `configStore`. Returns true when the experience
-     * should be initialised.
-     */
-    shouldInitialiseFx: Effect<void, boolean, Error>;
-    /**
-     * Public event — requests initialisation, gated by `shouldInitialiseFx`. When the
-     * gate passes, the sample graph fires `prepareExperienceContentFx` and `initialiseFx`
-     * in parallel so content loading does not delay initialisation.
-     */
-    initialiseRequested: EventCallable<LaunchExperienceOptions | undefined>;
-    /**
-     * Public event — requests initialisation directly, bypassing the `shouldInitialiseFx`
-     * gate. Fires `prepareExperienceContentFx` and `initialiseFx` in parallel.
-     */
-    initialiseDirectly: EventCallable<LaunchExperienceOptions | undefined>;
-    /**
-     * Prepares per-experience CMS content by calling `client.contentLoader` and
-     * registering returned blobs into `client.contents`. Driven by the sample graph
-     * on `initialiseRequested`/`initialiseDirectly`; can also be called directly for
-     * speculative prefetch (e.g. Visibility-driven warm-up). Failure-tolerant:
-     * always resolves `true` even when the loader rejects, so initialisation is
-     * never blocked by content failures.
-     */
-    prepareExperienceContentFx: Effect<void, boolean, Error>;
-}
-/**
- * Creates an Effector store for a single experience.
- *
- * @template T - Factory parameter type.
- * @param {T} params - The client instance and experience data.
- * @param {Picked} params.client - The Picked client instance the experience is bound to.
- * @param {Experience} params.experience - The experience definition to wrap in stores and effects.
- * @returns {ReturnType<typeof createExperienceFactory>} An experience store with config, tree, fields, and component sub-stores.
- * @example
- * ```typescript
- * const store = createExperience({ client, experience })
- * ```
- */
-export declare function createExperience(params: {
-    client: Picked;
-    experience: Experience;
-}): ExperienceStore;
-/** Options for launching an experience. */
-export interface LaunchExperienceOptions {
-    /** When true, the experience will be opened immediately after initialization. */
-    initialiseOpen?: boolean;
-    /** When true, the experience's condition logic is skipped and it is launched unconditionally. */
-    bypassCondition?: boolean;
-}
-/** Options for opening an experience. Same as {@link LaunchExperienceOptions} without `initialiseOpen`. */
-export type OpenExperienceOptions = Omit<LaunchExperienceOptions, 'initialiseOpen'>;
+        strategy: "override";
+    }>;
+};
+export declare function createExperience<T extends Parameters<typeof createExperienceFactory>[0]>(params: T): ReturnType<typeof createExperienceFactory>;
 declare const createExperienceIndexFactory: ({ client }: {
     client: Picked;
 }) => {
-    /** Registers an experience in the index. If an experience with the same ID already exists, it is merged. */
-    register: EventCallable<Experience>;
-    /** Returns a derived store for an experience by its ID. The store value is `undefined` when no match exists. */
-    get: (id: Experience['id']) => Store<ExperienceStore | undefined>;
-    /** @deprecated Use `experiences.get(id)` instead. */
-    getById: (id: Experience['id']) => Store<ExperienceStore | undefined>;
-    /** Returns a derived store for an experience by its key. The store value is `undefined` when no match exists. */
-    getByKey: (key: Experience['key']) => Store<ExperienceStore | undefined>;
-    /** Effector effect that launches an experience by its key. */
-    launch: Effect<{
-        key: string;
-        options?: LaunchExperienceOptions;
-    } | {
+    register: (experience: Experience) => void;
+    getById: (id: Experience["id"]) => import('effector').Store<{
         id: string;
-        options?: LaunchExperienceOptions;
-    }, void, Error>;
-    /** Effector effect that opens an experience's existing instances, or launches it with `initialiseOpen` if none exist. */
-    open: Effect<{
-        key: string;
-        options?: OpenExperienceOptions;
-    } | {
+        configStore: import('effector').Store<{
+            type: string;
+            name: string;
+            decisionLogic: LogicRule | undefined;
+            targetSelectors: ExperienceTarget[];
+        }>;
+        treeStore: import('effector').Store<{
+            steps: ExperienceStep[];
+            nodes: ExperienceNode[];
+            edges: ExperienceEdge[];
+            conditionals: ExperienceConditional[];
+        }>;
+        componentStore: import('effector').Store<{
+            name: string;
+            component: AdaptedComponent<string, unknown>;
+            frameworkStore: import('effector').Store<import('../..').Framework | undefined>;
+        } | undefined>;
+        merge: import('effector').EventCallable<{
+            experience: Partial<Experience>;
+            strategy: "override";
+        }>;
+    } | undefined>;
+    listStore: import('effector').Store<{
         id: string;
-        options?: OpenExperienceOptions;
-    }, void, Error>;
-    /** Derived store containing all registered experiences as an array. */
-    listStore: Store<ExperienceStore[]>;
-    /** Effector effect that conditionally initialises every registered experience. */
-    initialiseExperiencesFx: Effect<void, void, Error>;
+        configStore: import('effector').Store<{
+            type: string;
+            name: string;
+            decisionLogic: LogicRule | undefined;
+            targetSelectors: ExperienceTarget[];
+        }>;
+        treeStore: import('effector').Store<{
+            steps: ExperienceStep[];
+            nodes: ExperienceNode[];
+            edges: ExperienceEdge[];
+            conditionals: ExperienceConditional[];
+        }>;
+        componentStore: import('effector').Store<{
+            name: string;
+            component: AdaptedComponent<string, unknown>;
+            frameworkStore: import('effector').Store<import('../..').Framework | undefined>;
+        } | undefined>;
+        merge: import('effector').EventCallable<{
+            experience: Partial<Experience>;
+            strategy: "override";
+        }>;
+    }[]>;
 };
-/**
- * Creates an Effector-based index for registering and retrieving experiences.
- *
- * @template T - Factory parameter type.
- * @param {T} params - The client instance.
- * @returns {ReturnType<typeof createExperienceIndexFactory>} An experience index with register, getById, getByKey, launch, and open methods.
- * @example
- * ```typescript
- * const index = createExperienceIndex({ client })
- * ```
- */
 export declare function createExperienceIndex<T extends Parameters<typeof createExperienceIndexFactory>[0]>(params: T): ReturnType<typeof createExperienceIndexFactory>;
-export type ExperienceNode = StepNode | ConditionNode | LaunchExperienceNode | OriginNode | ActionNode;
-export interface ExperienceAction {
+export interface ExperienceStep {
     id: string;
-    action: string;
-}
-export interface ActionNode extends BaseNode {
-    type: 'action';
-    actionId?: string;
-    actionKey?: string;
-    name?: string;
+    label: string;
+    fieldIds: string[];
 }
+export type ExperienceNode = StepNode | ConditionalNode | LaunchExperienceNode | OriginNode;
 export interface BaseNode {
     id: string;
     type: string;
+    position: [number, number];
 }
 export interface StepNode extends BaseNode {
     type: 'step';
     stepId: string;
-    stepKey?: string;
-    name?: string;
+    label: string;
 }
-export interface ConditionNode extends BaseNode {
-    type: 'condition';
-    conditionId: string;
-    conditionKey?: string;
+export interface ConditionalNode extends BaseNode {
+    type: 'conditional';
+    conditionalId: string;
 }
 export interface LaunchExperienceNode extends BaseNode {
     type: 'experience';
     experienceId: string;
-    experienceKey: string;
 }
 export interface OriginNode extends BaseNode {
     type: 'origin';
@@ -183,7 +117,11 @@ export interface ExperienceEdge {
     id: string;
     sourceNodeId: string;
     destinationNodeId: string;
-    sourceHandle?: string;
+    sourceNodeHandle?: string;
+}
+export interface ExperienceConditional {
+    id: string;
+    condition: LogicRule;
 }
 export interface ExperienceTarget {
     selector: string;
@@ -191,30 +129,31 @@ export interface ExperienceTarget {
 }
 export interface Experience {
     id: string;
-    key: string;
     name: string;
-    componentName?: string;
+    type: string;
     component?: AdaptedComponent;
-    initializeOpen?: LogicRule | LogicValue;
-    actions?: ExperienceAction[];
-    /** Decision logic that controls whether this experience is initialised. */
-    condition?: LogicRule | LogicValue;
+    conditionals: ExperienceConditional[];
+    decide: LogicRule | undefined;
     edges: ExperienceEdge[];
     nodes: ExperienceNode[];
+    fields: Field[];
+    steps: ExperienceStep[];
     targets: ExperienceTarget[];
 }
+export declare const setupExperience: (experience: Experience, experienceStore: ExperiencesListStore) => void;
+/**
+ * Initializes an experience for each target that exists in the DOM
+ *
+ * @param client
+ * @param experience
+ */
+export declare const initialiseExperience: (client: Picked, experience: ExperienceStore) => void;
 /**
- * Conditionally initialises every registered experience by dispatching the index-level
- * `initialiseExperiencesFx` effect, which attaches over `client.experiences.listStore`
- * and runs each experience's per-store `shouldInitialiseFx` and `initialiseFx`.
+ * Conditionally initializes experiences
  *
- * @param {Picked} client - The Picked client instance.
- * @returns {Promise<void>} Resolves when all per-experience initialisations settle.
- * @example
- * ```typescript
- * await initialiseExperiences(client)
- * ```
+ * @param client
  */
 export declare const initialiseExperiences: (client: Picked) => Promise<void>;
+export declare const shouldInitialiseExperience: (client: Picked, experience: ExperienceStore) => Promise<boolean>;
 export {};
 //# sourceMappingURL=experience.d.ts.map

package/dist/types/entities/experience/experience.d.ts.map

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

package/dist/types/entities/experience-instance/experience-instance.d.ts

@@ -1,99 +1,129 @@
-/** @file Experience instance — Effector stores and lifecycle for a single experience. */
-import { type Effect, type EventCallable, type Store } from 'effector';
-import type { Experience, ExperienceNode, ExperienceStore, ExperienceTarget, LaunchExperienceOptions } from '../experience/experience';
-import type { Component } from '../component/component';
-import type { Framework } from '../framework/framework';
-import type { ExperienceStep } from '../step/step';
-import type { Picked } from '../../picked';
-import type { HistoryEntry } from '../history/history';
-export interface ExperienceInstance {
-    id: string;
-    experienceKey: Experience['key'];
-    experienceId: Experience['id'];
-    /** Static name snapshot captured at spawn time. Use `configStore` for the latest (reactive) value. */
-    experienceName: string;
-    configStore: ExperienceStore['configStore'];
-    target: HTMLElement | undefined;
-    componentStore: ExperienceStore['componentStore'];
-    /**
-     * Reactive store of the resolved `{ component, framework }` pair for this instance, derived via `combine` over the instance's `componentStore` and `client.frameworks.listStore`. Resolves to `null` when either side is missing.
-     */
-    componentAndFrameworkStore: Store<{
-        component: Component;
-        framework: Framework;
-    } | null>;
-    stateStore: Store<'transitioning' | 'ready'>;
-    isOpenStore: Store<boolean>;
-    open: EventCallable<void>;
-    close: EventCallable<void>;
-    toggleOpen: EventCallable<void>;
-    setOpen: EventCallable<boolean>;
-    treeStore: ExperienceStore['treeStore'];
-    currentNodeStore: Store<ExperienceNode | null>;
-    /**
-     * The step currently on screen. Only step nodes update it, so it deliberately
-     * retains the last resolved step — rather than blanking to `null` — while the
-     * engine transits ANY non-step node (an action running or a condition
-     * evaluating). Both `StepRouter` bindings keep rendering this step during those
-     * transits instead of flashing empty; it is `null` only before the first step
-     * resolves. This "hold last step" contract intentionally applies to every
-     * non-step transit, not just async actions.
-     */
-    currentStepStore: Store<ExperienceStep | null>;
-    previousStepStore: Store<ExperienceStep | null>;
-    nextReachableStepNodesStore: Store<ExperienceNode[]>;
-    stepsToOriginStore: Store<number[]>;
-    stepsToLeafStore: Store<number[]>;
-    goToNextStep: EventCallable<void>;
-    goToPreviousStep: EventCallable<void>;
-    goToStepById: EventCallable<string>;
-    goToStepByKey: EventCallable<string>;
-    stepsHistoryStore: Store<HistoryEntry[]>;
-    /**
-     * Per-instance mount effect. Attached over `componentAndFrameworkStore` so the render call always receives the current resolved component+framework pair.
-     */
-    mountFx: Effect<void, void, Error>;
-}
+import { Experience, ExperienceNode, ExperienceStore, ExperienceTarget } from '../experience/experience';
+import { Picked } from '../../picked';
+export type ExperienceInstance = ReturnType<typeof createExperienceInstance>;
 export type ExperienceInstanceIndex = ReturnType<typeof createExperienceInstanceIndex>;
 export interface ExperienceInstanceTarget {
     selector: HTMLElement[];
     placement: ExperienceTarget['placement'];
 }
-declare const createExperienceInstanceFactory: ({ client, experience, target, options, }: {
+declare const createExperienceInstanceFactory: ({ client, experience, target, }: {
     client: Picked;
     experience: ExperienceStore;
     target?: HTMLElement;
-    options?: LaunchExperienceOptions;
-}) => ExperienceInstance;
-/**
- * Creates an experience instance with lifecycle stores and navigation logic.
- *
- * @param {Parameters<typeof createExperienceInstanceFactory>[0]} params - Factory parameters including the client and experience store.
- * @returns {ExperienceInstance} The created experience instance.
- * @example
- * ```typescript
- * const instance = createExperienceInstance({ client, experience })
- * ```
- */
+}) => {
+    experienceId: string;
+    configStore: import('effector').Store<{
+        type: string;
+        name: string;
+        decisionLogic: import('../../logic-engine').LogicRule | undefined;
+        targetSelectors: ExperienceTarget[];
+    }>;
+    target: HTMLElement | undefined;
+    componentStore: import('effector').Store<{
+        name: string;
+        component: import('../..').AdaptedComponent<string, unknown>;
+        frameworkStore: import('effector').Store<import('../..').Framework | undefined>;
+    } | undefined>;
+    stateStore: import('effector').StoreWritable<"transitioning" | "ready">;
+    isOpenStore: import('effector').StoreWritable<boolean>;
+    open: import('effector').EventCallable<void>;
+    close: import('effector').EventCallable<void>;
+    toggleOpen: import('effector').EventCallable<void>;
+    setOpen: import('effector').EventCallable<boolean>;
+    treeStore: import('effector').Store<{
+        steps: import('../..').ExperienceStep[];
+        nodes: ExperienceNode[];
+        edges: import('../..').ExperienceEdge[];
+        conditionals: import('../..').ExperienceConditional[];
+    }>;
+    currentNodeStore: import('effector').Store<ExperienceNode | null>;
+    currentStepStore: import('effector').Store<import('../..').ExperienceStep | null>;
+    nextReachableStepNodesStore: import('effector').Store<ExperienceNode[]>;
+    stepsToOriginStore: import('effector').Store<number[]>;
+    stepsToLeafStore: import('effector').Store<number[]>;
+    goToNextStep: import('effector').EventCallable<void>;
+    goToPreviousStep: import('effector').EventCallable<void>;
+    goToStepById: import('effector').EventCallable<string>;
+    stepsHistoryStore: import('effector').Store<import('../..').HistoryEntry[]>;
+};
 export declare function createExperienceInstance<T extends Parameters<typeof createExperienceInstanceFactory>[0]>(params: T): ReturnType<typeof createExperienceInstanceFactory>;
 declare const createExperienceInstanceIndexFactory: ({ client }: {
     client: Picked;
 }) => {
-    spawn: (experience: ExperienceStore, target: HTMLElement, options?: LaunchExperienceOptions) => void;
-    getByExperienceKey: (key: Experience['key']) => Store<ExperienceInstance[]>;
-    getByExperienceId: (id: Experience['id']) => Store<ExperienceInstance[]>;
-    listStore: Store<ExperienceInstance[]>;
+    spawn: (experience: ExperienceStore, target: HTMLElement) => void;
+    getByExperienceId: (id: Experience["id"]) => import('effector').Store<{
+        experienceId: string;
+        configStore: import('effector').Store<{
+            type: string;
+            name: string;
+            decisionLogic: import('../../logic-engine').LogicRule | undefined;
+            targetSelectors: ExperienceTarget[];
+        }>;
+        target: HTMLElement | undefined;
+        componentStore: import('effector').Store<{
+            name: string;
+            component: import('../..').AdaptedComponent<string, unknown>;
+            frameworkStore: import('effector').Store<import('../..').Framework | undefined>;
+        } | undefined>;
+        stateStore: import('effector').StoreWritable<"transitioning" | "ready">;
+        isOpenStore: import('effector').StoreWritable<boolean>;
+        open: import('effector').EventCallable<void>;
+        close: import('effector').EventCallable<void>;
+        toggleOpen: import('effector').EventCallable<void>;
+        setOpen: import('effector').EventCallable<boolean>;
+        treeStore: import('effector').Store<{
+            steps: import('../..').ExperienceStep[];
+            nodes: ExperienceNode[];
+            edges: import('../..').ExperienceEdge[];
+            conditionals: import('../..').ExperienceConditional[];
+        }>;
+        currentNodeStore: import('effector').Store<ExperienceNode | null>;
+        currentStepStore: import('effector').Store<import('../..').ExperienceStep | null>;
+        nextReachableStepNodesStore: import('effector').Store<ExperienceNode[]>;
+        stepsToOriginStore: import('effector').Store<number[]>;
+        stepsToLeafStore: import('effector').Store<number[]>;
+        goToNextStep: import('effector').EventCallable<void>;
+        goToPreviousStep: import('effector').EventCallable<void>;
+        goToStepById: import('effector').EventCallable<string>;
+        stepsHistoryStore: import('effector').Store<import('../..').HistoryEntry[]>;
+    }[]>;
+    listStore: import('effector').Store<{
+        experienceId: string;
+        configStore: import('effector').Store<{
+            type: string;
+            name: string;
+            decisionLogic: import('../../logic-engine').LogicRule | undefined;
+            targetSelectors: ExperienceTarget[];
+        }>;
+        target: HTMLElement | undefined;
+        componentStore: import('effector').Store<{
+            name: string;
+            component: import('../..').AdaptedComponent<string, unknown>;
+            frameworkStore: import('effector').Store<import('../..').Framework | undefined>;
+        } | undefined>;
+        stateStore: import('effector').StoreWritable<"transitioning" | "ready">;
+        isOpenStore: import('effector').StoreWritable<boolean>;
+        open: import('effector').EventCallable<void>;
+        close: import('effector').EventCallable<void>;
+        toggleOpen: import('effector').EventCallable<void>;
+        setOpen: import('effector').EventCallable<boolean>;
+        treeStore: import('effector').Store<{
+            steps: import('../..').ExperienceStep[];
+            nodes: ExperienceNode[];
+            edges: import('../..').ExperienceEdge[];
+            conditionals: import('../..').ExperienceConditional[];
+        }>;
+        currentNodeStore: import('effector').Store<ExperienceNode | null>;
+        currentStepStore: import('effector').Store<import('../..').ExperienceStep | null>;
+        nextReachableStepNodesStore: import('effector').Store<ExperienceNode[]>;
+        stepsToOriginStore: import('effector').Store<number[]>;
+        stepsToLeafStore: import('effector').Store<number[]>;
+        goToNextStep: import('effector').EventCallable<void>;
+        goToPreviousStep: import('effector').EventCallable<void>;
+        goToStepById: import('effector').EventCallable<string>;
+        stepsHistoryStore: import('effector').Store<import('../..').HistoryEntry[]>;
+    }[]>;
 };
-/**
- * Creates an index that tracks all experience instances keyed by experience ID.
- *
- * @param {Parameters<typeof createExperienceInstanceIndexFactory>[0]} params - Factory parameters including the client.
- * @returns {ExperienceInstanceIndex} The created experience-instance index.
- * @example
- * ```typescript
- * const index = createExperienceInstanceIndex({ client })
- * ```
- */
 export declare function createExperienceInstanceIndex<T extends Parameters<typeof createExperienceInstanceIndexFactory>[0]>(params: T): ReturnType<typeof createExperienceInstanceIndexFactory>;
 export {};
 //# sourceMappingURL=experience-instance.d.ts.map

package/dist/types/entities/experience-instance/experience-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experience-instance.d.ts","sourceRoot":"","sources":["../../../../src/entities/experience-instance/experience-instance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"experience-instance.d.ts","sourceRoot":"","sources":["../../../../src/entities/experience-instance/experience-instance.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAGjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAmB1C,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC5E,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAA;AACtF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;CACzC;AAED,QAAA,MAAM,+BAA+B,oCAKhC;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,eAAe,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkTF,CAAA;AAED,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC,CAAC,CAAC,EAC/D,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAE/D;AAED,QAAA,MAAM,oCAAoC,eAA8B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;wBAoI7D,eAAe,UAAU,WAAW;4BAQhC,UAAU,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS/C,CAAA;AAEF,wBAAgB,6BAA6B,CAC3C,CAAC,SAAS,UAAU,CAAC,OAAO,oCAAoC,CAAC,CAAC,CAAC,CAAC,EACpE,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,oCAAoC,CAAC,CAEpE"}