@salesforce/storefront-next-runtime 0.1.0

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,104 @@
+//#region src/events/events.ts
+/**
+* Type-safe event creation function
+*
+* This generic function allows creating any event type under AnalyticsEvent
+* with full type safety. The event type is inferred from the string literal
+* passed as the first parameter, and TypeScript will enforce the correct
+* data properties for that specific event type.
+*
+* @example
+* ```typescript
+* const viewPageEvent = createEvent('view_page', { path: '/products', payload });
+* const viewProductEvent = createEvent('view_product', { product, payload });
+* ```
+*/
+function createEvent(eventType, data) {
+	return {
+		eventType,
+		...data
+	};
+}
+/**
+* Send a view page event to the event mediator
+*
+* This wrapper function is used in the automated page view event tracking client middleware.
+* This function exists to support build-time checks and type safety.
+*
+* @param event - The view page event to send
+* @param eventMediator - The event mediator to send the event to
+*/
+function sendViewPageEvent(event, eventMediator) {
+	eventMediator.track(event);
+}
+
+//#endregion
+//#region src/events/mediator.ts
+let mediatorInstance;
+/**
+* Create an event mediator instance
+*
+* Creates a new EventMediator that processes events through the provided adapters.
+* The mediator uses the getAdapters function on each track() invocation to ensure
+* it always uses the latest adapters from the adapter registry.
+*
+* @param getAdapters - Function that returns the current array of engagement adapters.
+*                      This function is called on each track() invocation to ensure
+*                      the mediator always uses the latest adapters from the adapter registry.
+* @returns EventMediator instance
+*/
+function createEventMediator(getAdapters) {
+	return { track: (event) => {
+		processEventWithAdapters(event, getAdapters).catch((error) => {
+			console.error("Analytics tracking failed:", error);
+		});
+	} };
+}
+/**
+* Get the event mediator singleton instance
+*
+* Returns the singleton EventMediator instance, creating it if it doesn't exist.
+*
+* @param getAdapters - Function that returns the current array of engagement adapters.
+* @returns EventMediator instance (singleton) or undefined if not on client side
+*/
+function getEventMediator(getAdapters) {
+	if (mediatorInstance) return mediatorInstance;
+	if (typeof window === "undefined") return;
+	mediatorInstance = createEventMediator(getAdapters);
+	return mediatorInstance;
+}
+/**
+* Reset the event mediator singleton (for testing only)
+*
+* This function clears the singleton instance, allowing tests to create a fresh mediator.
+*/
+function resetEventMediator() {
+	mediatorInstance = void 0;
+}
+/**
+* Process an event with all registered adapters
+*
+* @param event - The analytics event to process
+* @param getAdapters - Function that returns the current array of event adapters
+*/
+async function processEventWithAdapters(event, getAdapters) {
+	const eventAdapters = getAdapters();
+	if (eventAdapters.length === 0) {
+		console.warn(`There are no active adapters to send the event to`);
+		return;
+	}
+	const promises = eventAdapters.map(async (adapter) => {
+		try {
+			if (typeof adapter.sendEvent === "function") await adapter.sendEvent(event);
+			else console.warn(`Adapter ${adapter.name} does not implement sendEvent`);
+		} catch (error) {
+			console.error(`Failed to send event to ${adapter.name}:`, error);
+		}
+	});
+	await Promise.allSettled(promises);
+}
+
+//#endregion
+export { createEvent, getEventMediator, resetEventMediator, sendViewPageEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":["mediatorInstance: EventMediator | undefined"],"sources":["../src/events/events.ts","../src/events/mediator.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AnalyticsEvent, EventMediator, EventPayload, EventTypeMap, ViewPageEvent } from './types';\n\n/**\n * Type-safe event creation function\n *\n * This generic function allows creating any event type under AnalyticsEvent\n * with full type safety. The event type is inferred from the string literal\n * passed as the first parameter, and TypeScript will enforce the correct\n * data properties for that specific event type.\n *\n * @example\n * ```typescript\n * const viewPageEvent = createEvent('view_page', { path: '/products', payload });\n * const viewProductEvent = createEvent('view_product', { product, payload });\n * ```\n */\nexport function createEvent<T extends AnalyticsEvent['eventType']>(\n    eventType: T,\n    data: EventPayload<T>\n): EventTypeMap[T] {\n    return {\n        eventType,\n        ...data,\n    } as EventTypeMap[T];\n}\n\n/**\n * Send a view page event to the event mediator\n *\n * This wrapper function is used in the automated page view event tracking client middleware.\n * This function exists to support build-time checks and type safety.\n *\n * @param event - The view page event to send\n * @param eventMediator - The event mediator to send the event to\n */\nexport function sendViewPageEvent(event: ViewPageEvent, eventMediator: EventMediator): void {\n    eventMediator.track(event);\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { EventMediator, AnalyticsEvent, EventAdapter } from './types';\n\n// Module-level storage for the event mediator singleton\n// This ensures a single mediator instance across all usages\nlet mediatorInstance: EventMediator | undefined;\n\n/**\n * Create an event mediator instance\n *\n * Creates a new EventMediator that processes events through the provided adapters.\n * The mediator uses the getAdapters function on each track() invocation to ensure\n * it always uses the latest adapters from the adapter registry.\n *\n * @param getAdapters - Function that returns the current array of engagement adapters.\n *                      This function is called on each track() invocation to ensure\n *                      the mediator always uses the latest adapters from the adapter registry.\n * @returns EventMediator instance\n */\nfunction createEventMediator(getAdapters: () => EventAdapter[]): EventMediator {\n    return {\n        track: (event: AnalyticsEvent) => {\n            processEventWithAdapters(event, getAdapters).catch((error) => {\n                // eslint-disable-next-line no-console\n                console.error('Analytics tracking failed:', error);\n            });\n        },\n    };\n}\n\n/**\n * Get the event mediator singleton instance\n *\n * Returns the singleton EventMediator instance, creating it if it doesn't exist.\n *\n * @param getAdapters - Function that returns the current array of engagement adapters.\n * @returns EventMediator instance (singleton) or undefined if not on client side\n */\nexport function getEventMediator(getAdapters: () => EventAdapter[]): EventMediator | undefined {\n    // If mediator already exists, return it\n    if (mediatorInstance) {\n        return mediatorInstance;\n    }\n\n    // Only create on client side\n    if (typeof window === 'undefined') {\n        return undefined;\n    }\n\n    // Create the event mediator singleton\n    mediatorInstance = createEventMediator(getAdapters);\n    return mediatorInstance;\n}\n\n/**\n * Reset the event mediator singleton (for testing only)\n *\n * This function clears the singleton instance, allowing tests to create a fresh mediator.\n */\nexport function resetEventMediator(): void {\n    mediatorInstance = undefined;\n}\n\n/**\n * Process an event with all registered adapters\n *\n * @param event - The analytics event to process\n * @param getAdapters - Function that returns the current array of event adapters\n */\nasync function processEventWithAdapters(event: AnalyticsEvent, getAdapters: () => EventAdapter[]): Promise<void> {\n    // Get the current array of event adapters\n    const eventAdapters = getAdapters();\n    if (eventAdapters.length === 0) {\n        // eslint-disable-next-line no-console\n        console.warn(`There are no active adapters to send the event to`);\n        return;\n    }\n\n    // Send event to all registered adapters that implement sendEvent in parallel\n    const promises = eventAdapters.map(async (adapter) => {\n        try {\n            if (typeof adapter.sendEvent === 'function') {\n                await adapter.sendEvent(event);\n            } else {\n                // eslint-disable-next-line no-console\n                console.warn(`Adapter ${adapter.name} does not implement sendEvent`);\n            }\n        } catch (error) {\n            // eslint-disable-next-line no-console\n            console.error(`Failed to send event to ${adapter.name}:`, error);\n        }\n    });\n\n    await Promise.allSettled(promises);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgCA,SAAgB,YACZ,WACA,MACe;AACf,QAAO;EACH;EACA,GAAG;EACN;;;;;;;;;;;AAYL,SAAgB,kBAAkB,OAAsB,eAAoC;AACxF,eAAc,MAAM,MAAM;;;;;AChC9B,IAAIA;;;;;;;;;;;;;AAcJ,SAAS,oBAAoB,aAAkD;AAC3E,QAAO,EACH,QAAQ,UAA0B;AAC9B,2BAAyB,OAAO,YAAY,CAAC,OAAO,UAAU;AAE1D,WAAQ,MAAM,8BAA8B,MAAM;IACpD;IAET;;;;;;;;;;AAWL,SAAgB,iBAAiB,aAA8D;AAE3F,KAAI,iBACA,QAAO;AAIX,KAAI,OAAO,WAAW,YAClB;AAIJ,oBAAmB,oBAAoB,YAAY;AACnD,QAAO;;;;;;;AAQX,SAAgB,qBAA2B;AACvC,oBAAmB;;;;;;;;AASvB,eAAe,yBAAyB,OAAuB,aAAkD;CAE7G,MAAM,gBAAgB,aAAa;AACnC,KAAI,cAAc,WAAW,GAAG;AAE5B,UAAQ,KAAK,oDAAoD;AACjE;;CAIJ,MAAM,WAAW,cAAc,IAAI,OAAO,YAAY;AAClD,MAAI;AACA,OAAI,OAAO,QAAQ,cAAc,WAC7B,OAAM,QAAQ,UAAU,MAAM;OAG9B,SAAQ,KAAK,WAAW,QAAQ,KAAK,+BAA+B;WAEnE,OAAO;AAEZ,WAAQ,MAAM,2BAA2B,QAAQ,KAAK,IAAI,MAAM;;GAEtE;AAEF,OAAM,QAAQ,WAAW,SAAS"}

package/dist/index.d.ts

@@ -0,0 +1,215 @@
+//#region src/design/registry/types.d.ts
+/**
+ * Copyright 2026 Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/* ==================== Framework Agnostic Types ==================== */
+
+/**
+ * Unique identifier for a component type.
+ */
+type ComponentId = string;
+/**
+ * Loader and fallback function names for external invocation.
+ */
+interface LoaderNames {
+  /** Server-side loader function name */
+  loader?: string;
+  /** Client-side loader function name */
+  clientLoader?: string;
+  /** Fallback component function name */
+  fallback?: string;
+}
+/**
+ * Shape of a dynamically imported component module.
+ * This is what import.meta.glob() returns for each component.
+ */
+interface ComponentModule<TProps, TFrameworkComponent = unknown> {
+  /** The main component export */
+  default: TFrameworkComponent;
+  /** Optional fallback component for Suspense boundaries */
+  fallback?: TFrameworkComponent;
+  /** Any additional exports (loaders, etc.) */
+  [key: string]: unknown;
+}
+/**
+ * Generic design metadata interface - framework agnostic.
+ * Different frameworks can extend this with their specific metadata.
+ */
+interface DesignMetadata {
+  /** Component identifier */
+  id?: string;
+  /** Component name for display */
+  name?: string;
+  /** Component group/category */
+  group?: string;
+  /** Component description */
+  description?: string;
+  /** Additional framework-specific metadata */
+  [key: string]: any;
+}
+/**
+ * Internal registry entry for a component.
+ * Framework agnostic - no specific component types.
+ */
+interface Entry<TProps, TFrameworkComponent = unknown> {
+  /** Component identifier */
+  id: ComponentId;
+  /** Eagerly loaded component (if registered directly) */
+  raw: TFrameworkComponent | null;
+  /** Lazily loaded component (if discovered via dynamic import) */
+  lazy?: TFrameworkComponent;
+  /** Dynamic importer function */
+  import?: () => Promise<ComponentModule<TProps, TFrameworkComponent>>;
+  /** Fallback component for loading states */
+  fallback?: TFrameworkComponent;
+  /** Loader function names for external invocation */
+  loaderNames?: LoaderNames;
+}
+/**
+ * Framework adapter interface.
+ * Each framework implements this to provide framework-specific behavior.
+ */
+interface FrameworkAdapter<TProps, TFrameworkComponent = unknown> {
+  /**
+   * Creates a lazy-loaded component from an importer function.
+   */
+  createLazyComponent(importer: () => Promise<ComponentModule<TProps, TFrameworkComponent>>): TFrameworkComponent;
+
+  /**
+   * Decorates a component with design-time capabilities.
+   * Each framework adapter implements its own decoration logic.
+   */
+  decorateComponent(component: TFrameworkComponent): TFrameworkComponent;
+}
+/**
+ * Configuration options for ComponentRegistry.
+ * Framework agnostic with adapter injection.
+ */
+interface ComponentRegistryOptions<TProps, TFrameworkComponent> {
+  /**
+   * Framework adapter for framework-specific operations.
+   * The adapter handles all framework-specific behavior including decoration.
+   */
+  adapter: FrameworkAdapter<TProps, TFrameworkComponent>;
+}
+//#endregion
+//#region src/design/registry/registry.d.ts
+/**
+ * Framework-agnostic ComponentRegistry manages component loading with static registration.
+ *
+ * Features:
+ * - Framework agnostic core with adapter pattern
+ * - Lazy loading via framework adapters for code splitting
+ * - Static component registration via build plugins (no dynamic discovery)
+ * - Design mode decoration via framework adapters
+ * - Request deduplication for concurrent component loads
+ * - Component metadata handled via API (not stored in registry)
+ *
+ * @template TProps - Component props type
+ *
+ * @example
+ * ```tsx
+ * const registry = new ComponentRegistry({
+ *   adapter: new ReactAdapter(),
+ *   designDecorator: createDesignDecorator,
+ * });
+ *
+ * // Components are pre-registered via static registry plugin
+ * // Get a component
+ * const Hero = registry.getComponent('hero');
+ *
+ * // Preload for SSR
+ * await registry.preload('hero');
+ * ```
+ */
+declare class ComponentRegistry<TProps, TFrameworkComponent = unknown> {
+  private readonly registry;
+  private readonly pending;
+  private readonly cancelled;
+  private readonly adapter;
+  constructor({
+    adapter
+  }: ComponentRegistryOptions<TProps, TFrameworkComponent>);
+  /**
+   * Registers a component in the registry with the specified id.
+   * If a component with the same id already exists, it will be overwritten.
+   */
+  registerComponent(id: ComponentId, component: TFrameworkComponent): void;
+  /**
+   * Registers a dynamic importer for a component id. Useful if you don't want to rely on scanning.
+   */
+  registerImporter(id: ComponentId, importer: () => Promise<ComponentModule<TProps, TFrameworkComponent>>, loaderNames?: LoaderNames): void;
+  /**
+   * Retrieves a component by id. Returns a framework-specific component type.
+   * In lazy loading scenarios, this will be a lazy component if the component
+   * is discovered via dynamic import. In design mode, the returned component
+   * is decorated via `designDecorator`.
+   */
+  getComponent(id: ComponentId): TFrameworkComponent | null;
+  /**
+   * Preload the JS chunk for a component id (use in route loaders/SSR to avoid waterfalls).
+   *
+   * This method ensures the component module is loaded and cached. Concurrent calls
+   * for the same component ID are automatically deduplicated via the pending map
+   * in ensureDiscovered().
+   *
+   * @throws Error if the component cannot be discovered
+   */
+  preload(id: ComponentId): Promise<void>;
+  /** Get loader function names for external invocation. */
+  getLoaderNames(id: ComponentId): LoaderNames | undefined;
+  hasLoaders(id: ComponentId): boolean;
+  /**
+   * Call a loader function for a component externally.
+   *
+   * @param id - Component ID
+   * @param loaderArgs - Arguments to pass to the loader function
+   * @param loaderType - Type of loader to call ('loader' or 'clientLoader')
+   * @returns Promise resolving to the loader result
+   */
+  callLoader(id: ComponentId, loaderArgs: unknown, loaderType?: keyof LoaderNames): Promise<unknown>;
+  /** Get fallback component if available. */
+  getFallback(id: ComponentId): TFrameworkComponent | undefined;
+  /**
+   * Returns all registered component IDs.
+   * Useful for debugging and introspection.
+   */
+  getRegisteredIds(): ComponentId[];
+  /**
+   * Checks if a component is registered.
+   */
+  has(id: ComponentId): boolean;
+  /**
+   * Clears all cached components and cancels pending discoveries.
+   * In-flight async operations will be cancelled and their promises will reject.
+   * Useful for testing or hot module replacement.
+   */
+  clear(): void;
+  private ensureLocalEntry;
+  /**
+   * Ensures a component is discovered and cached.
+   * Only returns early if a raw (eagerly loaded) component exists.
+   * Otherwise, attempts to discover via registered importer.
+   *
+   * @throws Error if the discovery is cancelled via clear()
+   */
+  private ensureDiscovered;
+  private buildFromImporter;
+  private buildFromLoadedModule;
+}
+//#endregion
+export { DesignMetadata as a, LoaderNames as c, ComponentRegistryOptions as i, ComponentId as n, Entry as o, ComponentModule as r, FrameworkAdapter as s, ComponentRegistry as t };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["ComponentId","LoaderNames","ComponentModule","TProps","TFrameworkComponent","DesignMetadata","Entry","Promise","FrameworkAdapter","ComponentRegistryOptions"],"sources":["../src/design/registry/types.d.ts","../src/design/registry/registry.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/* ==================== Framework Agnostic Types ==================== */\n\n/**\n * Unique identifier for a component type.\n */\nexport type ComponentId = string;\n\n/**\n * Loader and fallback function names for external invocation.\n */\nexport interface LoaderNames {\n    /** Server-side loader function name */\n    loader?: string;\n    /** Client-side loader function name */\n    clientLoader?: string;\n    /** Fallback component function name */\n    fallback?: string;\n}\n\n/**\n * Shape of a dynamically imported component module.\n * This is what import.meta.glob() returns for each component.\n */\nexport interface ComponentModule<TProps, TFrameworkComponent = unknown> {\n    /** The main component export */\n    default: TFrameworkComponent;\n    /** Optional fallback component for Suspense boundaries */\n    fallback?: TFrameworkComponent;\n    /** Any additional exports (loaders, etc.) */\n    [key: string]: unknown;\n}\n\n/**\n * Generic design metadata interface - framework agnostic.\n * Different frameworks can extend this with their specific metadata.\n */\nexport interface DesignMetadata {\n    /** Component identifier */\n    id?: string;\n    /** Component name for display */\n    name?: string;\n    /** Component group/category */\n    group?: string;\n    /** Component description */\n    description?: string;\n    /** Additional framework-specific metadata */\n    [key: string]: any;\n}\n\n/**\n * Internal registry entry for a component.\n * Framework agnostic - no specific component types.\n */\nexport interface Entry<TProps, TFrameworkComponent = unknown> {\n    /** Component identifier */\n    id: ComponentId;\n    /** Eagerly loaded component (if registered directly) */\n    raw: TFrameworkComponent | null;\n    /** Lazily loaded component (if discovered via dynamic import) */\n    lazy?: TFrameworkComponent;\n    /** Dynamic importer function */\n    import?: () => Promise<ComponentModule<TProps, TFrameworkComponent>>;\n    /** Fallback component for loading states */\n    fallback?: TFrameworkComponent;\n    /** Loader function names for external invocation */\n    loaderNames?: LoaderNames;\n}\n\n/**\n * Framework adapter interface.\n * Each framework implements this to provide framework-specific behavior.\n */\nexport interface FrameworkAdapter<TProps, TFrameworkComponent = unknown> {\n    /**\n     * Creates a lazy-loaded component from an importer function.\n     */\n    createLazyComponent(importer: () => Promise<ComponentModule<TProps, TFrameworkComponent>>): TFrameworkComponent;\n\n    /**\n     * Decorates a component with design-time capabilities.\n     * Each framework adapter implements its own decoration logic.\n     */\n    decorateComponent(component: TFrameworkComponent): TFrameworkComponent;\n}\n\n/**\n * Configuration options for ComponentRegistry.\n * Framework agnostic with adapter injection.\n */\nexport interface ComponentRegistryOptions<TProps, TFrameworkComponent> {\n    /**\n     * Framework adapter for framework-specific operations.\n     * The adapter handles all framework-specific behavior including decoration.\n     */\n    adapter: FrameworkAdapter<TProps, TFrameworkComponent>;\n}\n"],"mappings":";;AAqBA;AAKA;AAaA;AAaA;AAiBA;;;;;;;;;;;AAmBA;;;;;AAIgGI,KAvEpFJ,WAAAA,GAuEoFI,MAAAA;;;AAahG;AAK8BD,UApFbF,WAAAA,CAoFaE;EAAQC;EAAzBI,MAAAA,CAAAA,EAAAA,MAAAA;EAAgB;;;;ACzD7B;;;;;AAekD,UD7BjCN,eC6BiC,CAAA,MAAA,EAAA,sBAAA,OAAA,CAAA,CAAA;EAStC;EACoC,OAAA,EDrCnCE,mBCqCmC;EAAQ;EAAxB,QAAA,CAAA,EDnCjBA,mBCmCiB;EAAR;EACF,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;;AAmDH,UD9EFC,cAAAA,CC8EE;EAYM;EAAoD,EAAA,CAAA,EAAA,MAAA;EAAyB;EAgClF,IAAA,CAAA,EAAA,MAAA;EAAc;EAQV,KAAA,CAAA,EAAA,MAAA;EAOZ;EAAW,WAAA,CAAA,EAAA,MAAA;;;;;;;;UDxHNC;;MAETN;;OAECI;;SAEEA;;iBAEQG,QAAQL,gBAAgBC,QAAQC;;aAEpCA;;gBAEGH;;;;;;UAODO;;;;sCAIuBD,QAAQL,gBAAgBC,QAAQC,wBAAwBA;;;;;;+BAM/DA,sBAAsBA;;;;;;UAOtCK;;;;;WAKJD,iBAAiBL,QAAQC;;;;AAtBtC;;;;;;;;;AAiBA;;;;;;;;ACpDA;;;;;;;;;;;AAyBwB,cAzBX,iBAyBW,CAAA,MAAA,EAAA,sBAAA,OAAA,CAAA,CAAA;EACF,iBAAA,QAAA;EAYD,iBAAA,OAAA;EAAc,iBAAA,SAAA;EAmBb,iBAAA,OAAA;EAAc,WAAA,CAAA;IAAA;EAAA,CAAA,EAlDP,wBAkDO,CAlDkB,MAkDlB,EAlD0B,mBAkD1B,CAAA;EAgBb;;;;EAgBsD,iBAAA,CAAA,EAAA,EA1EnD,WA0EmD,EAAA,SAAA,EA1E3B,mBA0E2B,CAAA,EAAA,IAAA;EAAyB;;;EAwC9E,gBAAA,CAAA,EAAA,EAzGZ,WAyGY,EAAA,QAAA,EAAA,GAAA,GAxGA,OAwGA,CAxGQ,eAwGR,CAxGwB,MAwGxB,EAxGgC,mBAwGhC,CAAA,CAAA,EAAA,WAAA,CAAA,EAvGF,WAuGE,CAAA,EAAA,IAAA;EAOZ;;;;;;mBAlGS,cAAc;;;;;;;;;;cAmBb,cAAc;;qBAgBb,cAAc;iBAIlB;;;;;;;;;iBAYM,qDAAoD,cAAyB;;kBAgClF,cAAc;;;;;sBAQV;;;;UAOZ"}