@mks2508/sidebar-headless 0.2.1 → 0.3.0

package/dist/components/Sidebar/Sidebar.types.d.ts

@@ -0,0 +1,638 @@
+import type { ComponentType, ReactNode, CSSProperties, ElementType, RefObject } from "react";
+import type { SidebarLiquidConfig } from "@/lib/liquid-glass-presets";
+/**
+ * Modo de colapso del sidebar
+ * @enum {string}
+ */
+export declare enum SidebarCollapseMode {
+    /** Colapsa el sidebar a un ancho mínimo mostrando solo iconos */
+    COLLAPSE = "collapse",
+    /** Oculta completamente el sidebar */
+    HIDE = "hide"
+}
+/**
+ * Comportamiento del sidebar cuando está en modo hide
+ * @enum {string}
+ */
+export declare enum SidebarHideBehaviour {
+    /** Muestra un botón indicador para reabrir el sidebar */
+    SHOW_INDICATOR = "showIndicator",
+    /** El sidebar es completamente controlado externamente sin indicador */
+    CONTROLLED = "controlled"
+}
+/**
+ * Comportamiento al abrir desde el estado hide
+ * @enum {string}
+ */
+export declare enum SidebarHideOpensBehavior {
+    /** Abre al tamaño colapsado (solo iconos) */
+    COLLAPSED = "collapsed",
+    /** Abre al tamaño expandido completo */
+    EXPANDED = "expanded"
+}
+/**
+ * Comportamiento de layout del sidebar
+ * @enum {string}
+ */
+export declare enum SidebarLayoutBehaviour {
+    /** Sidebar flotante con z-index que NO desplaza el contenido (default) */
+    FLOATING = "floating",
+    /** Sidebar como parte del layout que SÍ desplaza el contenido */
+    INLINE = "inline"
+}
+/**
+ * Anchos predefinidos del sidebar
+ * @enum {string}
+ */
+export declare enum SidebarWidth {
+    /** Ancho en estado colapsado (solo iconos) */
+    COLLAPSED = "5rem",
+    /** Ancho expandido completo */
+    EXPANDED = "16rem",
+    /** Ancho mínimo absoluto */
+    MIN = "3rem",
+    /** Ancho máximo absoluto */
+    MAX = "20rem"
+}
+/**
+ * Duraciones de transición en milisegundos
+ * @enum {number}
+ */
+export declare enum SidebarTransitionDuration {
+    /** Transición rápida para cambios de opacidad */
+    FAST = 200,
+    /** Transición normal para width y transforms */
+    NORMAL = 300,
+    /** Transición lenta para animaciones complejas */
+    SLOW = 500
+}
+/**
+ * Índices Z para capas del sidebar
+ * @enum {number}
+ */
+export declare enum SidebarZIndex {
+    /** Base del contenedor wrapper */
+    BASE = 0,
+    /** Indicador visual */
+    INDICATOR = 5,
+    /** Contenido interno del sidebar */
+    CONTENT = 10,
+    /** Botón de toggle */
+    TOGGLE = 30
+}
+/**
+ * Radios de borde predefinidos
+ * @enum {string}
+ */
+export declare enum SidebarBorderRadius {
+    /** Sin radio de borde */
+    NONE = "0",
+    /** Radio pequeño */
+    SM = "0.25rem",
+    /** Radio medio */
+    MD = "0.5rem",
+    /** Radio grande */
+    LG = "1rem",
+    /** Radio completo (circular) */
+    FULL = "9999px"
+}
+/**
+ * Posiciones para SidebarSafeArea
+ * @enum {string}
+ */
+export declare enum SidebarSafeAreaPosition {
+    /** Área segura superior */
+    TOP = "top",
+    /** Área segura inferior */
+    BOTTOM = "bottom"
+}
+/**
+ * Timing functions para transiciones CSS
+ * @enum {string}
+ */
+export declare enum SidebarTimingFunction {
+    /** Ease estándar */
+    EASE = "ease",
+    /** Linear (velocidad constante) */
+    LINEAR = "linear",
+    /** Ease in (aceleración) */
+    EASE_IN = "ease-in",
+    /** Ease out (desaceleración) */
+    EASE_OUT = "ease-out",
+    /** Ease in out (aceleración y desaceleración) */
+    EASE_IN_OUT = "ease-in-out",
+    /** Cubic bezier personalizado */
+    CUSTOM = "cubic-bezier(0.4, 0, 0.2, 1)"
+}
+/**
+ * Configuración de estilo visual del sidebar
+ * @interface
+ */
+export interface SidebarVisualStyle {
+    /** Margen superior (separación del borde superior) */
+    marginTop?: string;
+    /** Margen inferior (separación del borde inferior) */
+    marginBottom?: string;
+    /** Margen izquierdo (separación del borde izquierdo) */
+    marginLeft?: string;
+    /** Margen derecho (generalmente 0 en modo inline) */
+    marginRight?: string;
+    /** Altura del sidebar (default: "100vh") */
+    height?: string;
+    /** Radio de borde redondeado */
+    borderRadius?: string;
+    /** Sombra del sidebar */
+    boxShadow?: string;
+}
+/**
+ * Configuración de dimensiones del sidebar
+ * @interface
+ */
+export interface SidebarDimensions {
+    /** Ancho cuando está colapsado */
+    collapsedWidth: string;
+    /** Ancho cuando está expandido */
+    expandedWidth: string;
+    /** Altura del indicador visual */
+    indicatorHeight: string;
+    /** Distancia del tooltip al borde del sidebar (CSS-first con Anchor API) */
+    tooltipDistance?: string;
+    /** Configuración de estilo visual */
+    visualStyle?: SidebarVisualStyle;
+}
+/**
+ * Configuración de áreas seguras (safe areas)
+ * @interface
+ */
+export interface SidebarSafeAreas {
+    /** Porcentaje de altura para área segura superior */
+    topPercent: number;
+    /** Porcentaje de altura para área segura inferior */
+    bottomPercent: number;
+}
+/**
+ * Configuración de animaciones
+ * @interface
+ */
+export interface SidebarAnimations {
+    /** Duración de transición de width en ms */
+    widthTransitionDuration: number;
+    /** Duración de transición de opacidad en ms */
+    opacityTransitionDuration: number;
+    /** Función de timing para animaciones */
+    timingFunction: string;
+}
+/**
+ * Configuración experimental de Liquid Glass V2
+ *
+ * @description
+ * Feature flags para habilitar efectos avanzados de liquid glass basados en:
+ * - SVG Displacement Mapping (Snell's Law refraction)
+ * - Chromatic Aberration (RGB channel separation)
+ * - Edge Glass 3D (dual backdrop layers)
+ * - Backdrop Extension (Josh Comeau technique)
+ *
+ * @interface
+ * @experimental
+ */
+export interface SidebarLiquidGlassConfig {
+    /**
+     * Habilitar Liquid Glass V2 (master flag)
+     *
+     * @description
+     * Activa el uso de FluidHoverIndicatorV2 y SidebarTooltipV2 con SVG displacement mapping
+     * en lugar de las versiones básicas con backdrop-blur CSS.
+     *
+     * @default false
+     */
+    enableLiquidGlassV2?: boolean;
+    /**
+     * Habilitar Chromatic Aberration (Phase 2)
+     *
+     * @description
+     * Activa la separación real de canales RGB usando feColorMatrix + feOffset
+     * en lugar del método legacy basado en diferentes escalas de displacement.
+     * Proporciona +15% de realismo visual según benchmarks.
+     *
+     * **Requiere**: enableLiquidGlassV2 = true
+     *
+     * @default false
+     */
+    enableChromaticAberration?: boolean;
+    /**
+     * Habilitar Edge Glass 3D (tooltips)
+     *
+     * @description
+     * Activa dual backdrop layers con blur diferenciado para crear ilusión de profundidad:
+     * - Depth layer: blur alto (16px) con brightness 1.15
+     * - Surface layer: blur moderado (8px) con brightness 1.25
+     *
+     * **Solo aplica a**: SidebarTooltipV2
+     * **Requiere**: enableLiquidGlassV2 = true
+     *
+     * @default true
+     */
+    enableEdgeGlass3D?: boolean;
+    /**
+     * Habilitar Backdrop Extension (Josh Comeau)
+     *
+     * @description
+     * Extiende el área de backdrop-filter al 200% de altura con mask
+     * para capturar elementos cercanos y mejorar el realismo de la refracción.
+     *
+     * **Solo aplica a**: SidebarTooltipV2
+     * **Requiere**: enableLiquidGlassV2 = true
+     *
+     * @default true
+     */
+    enableBackdropExtension?: boolean;
+    /**
+     * Habilitar animaciones staggered de items en tooltips
+     *
+     * @description
+     * Activa entrada/salida escalonada de items del tooltip usando CSS custom properties.
+     * Incluye grid trick para height auto transitions y direction-aware animations.
+     *
+     * **Solo aplica a**: SidebarTooltipV2
+     *
+     * @default true
+     * @experimental
+     */
+    enableTooltipItemAnimations?: boolean;
+    /**
+     * Habilitar animación 3D de cilindro para títulos de tooltips
+     *
+     * @description
+     * Activa efecto de cilindro rotatorio 3D para el título del tooltip usando Web Animations API.
+     * Mantiene historial circular de últimos 10 títulos y rota según dirección de navegación.
+     *
+     * **Features**:
+     * - Rotación 3D con rotateX
+     * - Direction-aware (up/down navigation)
+     * - Historial circular de títulos
+     * - Duración: 400ms, easing cubic-bezier
+     *
+     * **Solo aplica a**: SidebarTooltip
+     *
+     * @default false
+     * @experimental
+     */
+    enableCylinderTitle?: boolean;
+    /**
+     * Overrides de preset para configuración avanzada de Liquid Glass
+     *
+     * @description
+     * Permite sobrescribir valores del preset 'sidebar' para debugging y ajuste fino.
+     * Incluye parámetros visuales como frost, blur, scale, chromatic aberration RGB, etc.
+     *
+     * **Ejemplo**:
+     * ```tsx
+     * presetOverrides: {
+     *   frost: 0.08,
+     *   blur: 12,
+     *   blurBackground: 10,
+     *   scale: -200,
+     *   r: 5,
+     *   g: 15,
+     *   b: 25
+     * }
+     * ```
+     *
+     * **Requiere**: enableLiquidGlassV2 = true
+     *
+     * @default undefined
+     * @experimental
+     */
+    presetOverrides?: Partial<SidebarLiquidConfig>;
+}
+/**
+ * Librería de iconos a utilizar
+ * @enum {string}
+ */
+export declare enum SidebarIconLibrary {
+    /** Iconos de lucide-react */
+    LUCIDE = "lucide",
+    /** Iconos custom proporcionados por el usuario */
+    CUSTOM = "custom"
+}
+/**
+ * Estado compartido del sidebar
+ * @interface
+ */
+export interface SidebarState {
+    /** Indica si el sidebar está abierto */
+    open: boolean;
+    /** Indica si el sidebar está colapsado (solo en modo COLLAPSE) */
+    collapsed: boolean;
+    /** Modo de colapso actual */
+    collapseMode: SidebarCollapseMode;
+    /** Comportamiento de layout actual */
+    layoutBehaviour: SidebarLayoutBehaviour;
+}
+/**
+ * Estado del botón toggle
+ * @interface
+ */
+export interface SidebarToggleState {
+    /** Indica si el toggle está activo/presionado */
+    active: boolean;
+    /** Indica si el sidebar está abierto */
+    open: boolean;
+}
+/**
+ * Estado de un item del sidebar
+ * @interface
+ */
+export interface SidebarItemState {
+    /** Indica si el item está enfocado por teclado */
+    focused: boolean;
+    /** Indica si el mouse está sobre el item */
+    hovered: boolean;
+    /** Indica si el item está deshabilitado */
+    disabled: boolean;
+}
+/**
+ * Estado del indicador visual
+ * @interface
+ */
+export interface SidebarIndicatorState {
+    /** Indica si el indicador está visible */
+    visible: boolean;
+    /** Posición Y del indicador en píxeles */
+    position: number;
+}
+/**
+ * Tipo para render prop de Sidebar
+ */
+export type SidebarRenderProp = (state: SidebarState) => ReactNode;
+/**
+ * Tipo para render prop de SidebarToggle
+ */
+export type SidebarToggleRenderProp = (state: SidebarToggleState) => ReactNode;
+/**
+ * Tipo para render prop de SidebarItem
+ */
+export type SidebarItemRenderProp = (state: SidebarItemState) => ReactNode;
+/**
+ * Tipo para render prop de SidebarIndicator
+ */
+export type SidebarIndicatorRenderProp = (state: SidebarIndicatorState) => ReactNode;
+/**
+ * Valor del contexto compartido del Sidebar
+ * @interface
+ */
+export interface SidebarContextValue {
+    /** Estado inicial del sidebar (solo lectura) */
+    defaultOpen: boolean;
+    /** Estado actual open/closed del sidebar */
+    open: boolean;
+    /** Función para actualizar el estado open */
+    setOpen: (open: boolean) => void;
+    /** Modo de colapso actual */
+    collapseMode: SidebarCollapseMode;
+    /** Comportamiento en modo hide */
+    hideBehaviour: SidebarHideBehaviour;
+    /** Comportamiento al abrir desde hide */
+    hideOpensBehavior: SidebarHideOpensBehavior;
+    /** Comportamiento de layout del sidebar */
+    layoutBehaviour: SidebarLayoutBehaviour;
+    /** Configuración de dimensiones */
+    dimensions: SidebarDimensions;
+    /** Configuración de safe areas */
+    safeAreas: SidebarSafeAreas;
+    /** Configuración de animaciones */
+    animations: SidebarAnimations;
+    /** ID del toggle input */
+    toggleId: string;
+    /** Modo debug para visualizar safe areas */
+    debug: boolean;
+    /** Ref al contenedor de navegación */
+    navRef: RefObject<HTMLElement | null>;
+    /** Ref al contenedor de items */
+    contentRef: RefObject<HTMLDivElement | null>;
+    /** Ref al indicador visual */
+    indicatorRef: RefObject<HTMLDivElement | null>;
+    /** Registrar un item para navegación por teclado */
+    registerItem: (element: HTMLElement) => void;
+    /** Des-registrar un item */
+    unregisterItem: (element: HTMLElement) => void;
+    /** Items registrados actualmente */
+    items: HTMLElement[];
+    /** Indica si el indicador debe mostrarse por navegación de teclado */
+    showIndicatorForKeyboard: boolean;
+    /** Función para activar/desactivar el indicador por teclado */
+    setShowIndicatorForKeyboard: (show: boolean) => void;
+    /** Indica si el cursor/focus está sobre el área de items */
+    isOverItems: boolean;
+    /** Función para actualizar el estado de isOverItems */
+    setIsOverItems: (isOver: boolean) => void;
+    /** Habilitar FluidHoverIndicator (glassmorphism + spring physics) */
+    enableFluidIndicator: boolean;
+    /** Habilitar tooltip en hover (muestra label o subcategorías) */
+    enableTooltip: boolean;
+    /** Elemento del item actualmente hovered/focused (para FluidIndicator) */
+    currentItemElement: HTMLElement | null;
+    /** Función para actualizar el currentItemElement */
+    setCurrentItemElement: (element: HTMLElement | null) => void;
+    /** Configuración experimental de Liquid Glass V2 */
+    liquidGlass: SidebarLiquidGlassConfig;
+}
+/**
+ * Props polimórficas base con soporte para prop 'as'
+ */
+export type PolymorphicProps<E extends ElementType = ElementType> = {
+    /** Elemento o componente a renderizar */
+    as?: E;
+} & Omit<React.ComponentPropsWithRef<E>, "as">;
+/**
+ * Props del componente Sidebar (root container)
+ * @interface
+ */
+export interface SidebarProps {
+    /** Contenido del sidebar (puede ser ReactNode o render prop) */
+    children: ReactNode | SidebarRenderProp;
+    /** Clase CSS adicional para el wrapper */
+    className?: string;
+    /** Estilos inline para el wrapper */
+    style?: CSSProperties;
+    /** Estado inicial abierto (modo uncontrolled) */
+    defaultOpen?: boolean;
+    /** Estado abierto (modo controlled) */
+    open?: boolean;
+    /** Callback cuando cambia el estado open */
+    onOpenChange?: (open: boolean) => void;
+    /** Modo de colapso del sidebar */
+    collapseMode?: SidebarCollapseMode;
+    /** Comportamiento en modo hide */
+    hideBehaviour?: SidebarHideBehaviour;
+    /** Comportamiento al abrir desde hide */
+    hideOpensBehavior?: SidebarHideOpensBehavior;
+    /** Comportamiento de layout del sidebar */
+    layoutBehaviour?: SidebarLayoutBehaviour;
+    /** Configuración de dimensiones (partial override) */
+    dimensions?: Partial<SidebarDimensions>;
+    /** Configuración de áreas seguras (partial override) */
+    safeAreas?: Partial<SidebarSafeAreas>;
+    /** Configuración de animaciones (partial override) */
+    animations?: Partial<SidebarAnimations>;
+    /** ID personalizado para el toggle input */
+    toggleId?: string;
+    /** Modo debug (muestra bordes y labels) */
+    debug?: boolean;
+    /** Habilitar FluidHoverIndicator (glassmorphism + spring physics) */
+    enableFluidIndicator?: boolean;
+    /** Habilitar tooltip en hover (muestra label o subcategorías) */
+    enableTooltip?: boolean;
+    /**
+     * Configuración experimental de Liquid Glass V2 (partial override)
+     *
+     * @description
+     * Permite activar/desactivar features experimentales de liquid glass mediante flags:
+     *
+     * @example
+     * ```tsx
+     * <Sidebar
+     *   liquidGlass={{
+     *     enableLiquidGlassV2: true,
+     *     enableChromaticAberration: true,
+     *     enableEdgeGlass3D: true,
+     *     enableBackdropExtension: true
+     *   }}
+     * >
+     *   ...
+     * </Sidebar>
+     * ```
+     *
+     * @experimental
+     */
+    liquidGlass?: Partial<SidebarLiquidGlassConfig>;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Props del componente SidebarNav
+ * @interface
+ */
+export interface SidebarNavProps {
+    /** Contenido del nav */
+    children: ReactNode;
+    /** Clase CSS adicional */
+    className?: string;
+    /** Estilos inline */
+    style?: CSSProperties;
+    /** Label ARIA para el nav */
+    "aria-label"?: string;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Props del componente SidebarToggle
+ * @interface
+ */
+export interface SidebarToggleProps {
+    /** Contenido del botón (puede ser ReactNode o render prop) */
+    children?: ReactNode | SidebarToggleRenderProp;
+    /** Librería de iconos a utilizar (Lucide o custom) */
+    iconLibrary?: SidebarIconLibrary;
+    /** Clase CSS adicional */
+    className?: string;
+    /** Estilos inline */
+    style?: CSSProperties;
+    /** Label ARIA para el botón */
+    "aria-label"?: string;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Props del componente SidebarContent
+ * @interface
+ */
+export interface SidebarContentProps {
+    /** Contenido (items del sidebar) */
+    children: ReactNode;
+    /** Clase CSS adicional */
+    className?: string;
+    /** Estilos inline */
+    style?: CSSProperties;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Props del componente SidebarIndicator
+ * @interface
+ */
+export interface SidebarIndicatorProps {
+    /** Contenido personalizado del indicador (opcional) */
+    children?: ReactNode | SidebarIndicatorRenderProp;
+    /** Clase CSS adicional */
+    className?: string;
+    /** Estilos inline */
+    style?: CSSProperties;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Props del componente SidebarSafeArea
+ * @interface
+ */
+export interface SidebarSafeAreaProps {
+    /** Contenido del área segura */
+    children?: ReactNode;
+    /** Posición del área segura (top o bottom) */
+    position: SidebarSafeAreaPosition;
+    /** Porcentaje de altura del sidebar (override del config) */
+    percent?: number;
+    /** Clase CSS adicional */
+    className?: string;
+    /** Estilos inline */
+    style?: CSSProperties;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Props del componente SidebarItem
+ * @interface
+ */
+export interface SidebarItemProps {
+    /** URL de destino */
+    href?: string;
+    /** Icono del item */
+    icon?: ReactNode;
+    /** Label/texto del item */
+    label?: string;
+    /** Contenido del item (puede ser ReactNode o render prop) */
+    children?: ReactNode | SidebarItemRenderProp;
+    /** Componente Link personalizado (ej: React Router Link, Next Link) */
+    LinkComponent?: ComponentType<any>;
+    /** Props adicionales para el LinkComponent */
+    linkProps?: Record<string, any>;
+    /** Clase CSS adicional */
+    className?: string;
+    /** Estilos inline */
+    style?: CSSProperties;
+    /** Callback al hacer hover */
+    onHover?: () => void;
+    /** Callback al hacer click */
+    onClick?: () => void;
+    /** Item deshabilitado */
+    disabled?: boolean;
+    /** Elemento o componente a renderizar */
+    as?: ElementType;
+}
+/**
+ * Configuración completa del sidebar (sin partials)
+ */
+export interface SidebarConfig {
+    defaultOpen: boolean;
+    collapseMode: SidebarCollapseMode;
+    hideBehaviour: SidebarHideBehaviour;
+    hideOpensBehavior: SidebarHideOpensBehavior;
+    layoutBehaviour: SidebarLayoutBehaviour;
+    dimensions: SidebarDimensions;
+    safeAreas: SidebarSafeAreas;
+    animations: SidebarAnimations;
+    toggleId: string;
+    debug: boolean;
+    liquidGlass: SidebarLiquidGlassConfig;
+}
+//# sourceMappingURL=Sidebar.types.d.ts.map

package/dist/components/Sidebar/Sidebar.types.d.ts.map

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

package/dist/components/Sidebar/SidebarContent.d.ts

@@ -0,0 +1,46 @@
+import type { SidebarContentProps } from "./Sidebar.types";
+/**
+ * Componente de contenido del Sidebar (contenedor de items)
+ *
+ * @description
+ * Contenedor que agrupa los items de navegación (SidebarItem).
+ * Renderiza un `<div>` por defecto y aplica estilos de layout flex.
+ *
+ * Este componente:
+ * - Registra su ref en el contexto para cálculos del indicador
+ * - Aplica rol ARIA "list" para accesibilidad
+ * - Centra y distribuye items verticalmente
+ * - Permite customización completa con className y style
+ *
+ * Los items dentro de este contenedor son utilizados por:
+ * - useSidebarIndicator: Para calcular posición del indicador
+ * - useSidebarKeyboard: Para navegación por teclado
+ *
+ * @example
+ * ```tsx
+ * <SidebarNav>
+ *   <SidebarContent>
+ *     <SidebarItem href="/" icon={<HomeIcon />} />
+ *     <SidebarItem href="/settings" icon={<SettingsIcon />} />
+ *   </SidebarContent>
+ * </SidebarNav>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Con estilos custom
+ * <SidebarContent className="gap-2 py-4">
+ *   <SidebarItem href="/" />
+ * </SidebarContent>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Como lista semántica
+ * <SidebarContent as="ul">
+ *   <SidebarItem as="li" href="/" />
+ * </SidebarContent>
+ * ```
+ */
+export declare const SidebarContent: import("react").ForwardRefExoticComponent<SidebarContentProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=SidebarContent.d.ts.map

package/dist/components/Sidebar/SidebarContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidebarContent.d.ts","sourceRoot":"","sources":["../../../src/components/Sidebar/SidebarContent.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,cAAc,gHAuDzB,CAAA"}