@mappoh/nova 0.2.3 → 0.5.0

package/README.md

@@ -1,46 +1,196 @@
-# Nova v0.2.0
+# Nova
 
-## What's New
+A lightweight web engine built on Web Components. Zero dependencies.
 
-### 9 TypeScript Modules
+```
+npm install @mappoh/nova
+```
+
+## Modules
+
+### Core
 
 | Module | Import | Description |
 |--------|--------|-------------|
-| Clipboard | `@mappoh/nova/clipboard` | Copy/read text and HTML via Clipboard API with `execCommand` fallback |
-| Accordion | `@mappoh/nova/accordion` | Collapsible panels with ARIA, keyboard nav, single/multiple mode |
-| Breadcrumb | `@mappoh/nova/breadcrumb` | Navigation breadcrumbs with JSON-LD structured data |
-| Progress | `@mappoh/nova/progress` | Linear and circular (SVG) progress bars, determinate/indeterminate |
-| Infinite Scroll | `@mappoh/nova/infinite-scroll` | IntersectionObserver-based loading with idle/loading/done states |
-| Popover | `@mappoh/nova/popover` | Positioned popovers with flip/shift, click/hover/focus triggers |
-| Stepper | `@mappoh/nova/stepper` | Multi-step wizard with async validation, horizontal/vertical layout |
-| Carousel | `@mappoh/nova/carousel` | CSS scroll-snap carousel with pointer drag, auto-play, dots, arrows |
-| Virtual List | `@mappoh/nova/virtual-list` | DOM-recycling virtual scroller with fixed or variable row heights |
+| Component | `@mappoh/nova/component` | Web Components base class with reactive state, props, lifecycle hooks, and template engine |
+| Router | `@mappoh/nova/router` | SPA router with path params, guards, layouts, loaders, and view transitions |
+| Store | `@mappoh/nova/store` | Reactive signals, computed values, effects, and batched updates |
+| Theme | `@mappoh/nova/theme` | CSS custom property management with dark/light mode switching |
+
+### Component Utilities
+
+All utilities auto-cleanup when the component disconnects.
+
+```ts
+import {
+  classMap, styleMap,     // template helpers
+  createRef,              // DOM refs
+  useComputed,            // memoization
+  useInterval,            // non-pausing interval
+  useScroll,              // Shadow DOM scroll fix
+  afterRender,            // post-paint callback
+  createPortal, usePortal,// render outside shadow root
+  slotStyles,             // deep slot styling
+} from '@mappoh/nova/component';
+```
+
+| Utility | Description |
+|---------|-------------|
+| `classMap({ active: true })` | Build class strings from boolean maps |
+| `styleMap({ fontSize: 16 })` | Build style strings with auto `px` and kebab-case |
+| `createRef()` | DOM element ref that survives re-renders |
+| `useComputed(this, fn, deps)` | Memoize expensive render calculations |
+| `useInterval(this, fn, ms)` | Interval that keeps running when tab is hidden |
+| `useScroll(this, selector)` | Fix wheel events for Shadow DOM scroll containers |
+| `afterRender(this, fn)` | Callback after browser paint (via rAF) |
+| `this.on(event, selector, handler)` | Declarative event delegation with auto-cleanup |
+| `createPortal(content)` | Render outside shadow root (tooltips, dropdowns) |
+| `slotStyles(this, css)` | Deep slot styling beyond `::slotted()` |
+
+### Component Static Flags
+
+```ts
+class MyComponent extends Component {
+  static tag = 'my-component';
+  static scrollFix = true;     // auto-fix wheel events in Shadow DOM
+  static debugRender = true;   // log render triggers to console
+}
+```
+
+### Data & State
 
-### 7 WASM Accelerators
+| Module | Import | Description |
+|--------|--------|-------------|
+| Query | `@mappoh/nova/query` | SWR-style data fetching with stale-while-revalidate |
+| State Machine | `@mappoh/nova/machine` | Finite state machine with enter/exit actions |
+| WebSocket | `@mappoh/nova/websocket` | Reconnecting WebSocket with heartbeat and backoff |
+| Event Bus | `@mappoh/nova/event-bus` | Typed publish/subscribe |
+| Cache | `@mappoh/nova/cache` | LRU cache with optional TTL |
+| Context | `@mappoh/nova/context` | Dependency injection via DOM events |
+| HTTP | `@mappoh/nova/http` | Fetch wrapper with interceptors, retries, timeout |
+| Persistent State | `@mappoh/nova/persistent-state` | IndexedDB-backed persistent store |
+
+### UI Components
+
+| Component | Import | Description |
+|-----------|--------|-------------|
+| Modal | `@mappoh/nova/modal` | Accessible dialog with focus trap and scroll lock |
+| Toast | `@mappoh/nova/toast` | Notification toasts with auto-dismiss |
+| Tooltip | `@mappoh/nova/tooltip` | Positioned tooltips with flip/shift |
+| Popover | `@mappoh/nova/popover` | Positioned popovers with click/hover/focus triggers |
+| Dropdown | `@mappoh/nova/dropdown` | Accessible dropdown menu |
+| Accordion | `@mappoh/nova/accordion` | Collapsible panels with ARIA |
+| Tabs | `@mappoh/nova/tabs` | Tab panel switcher with keyboard nav |
+| Stepper | `@mappoh/nova/stepper` | Multi-step wizard with validation |
+| Carousel | `@mappoh/nova/carousel` | CSS scroll-snap carousel with drag |
+| Pagination | `@mappoh/nova/pagination` | Page navigation with ellipsis |
+| Switch | `@mappoh/nova/switch` | Toggle switch |
+| Radio Group | `@mappoh/nova/radio-group` | Radio group with roving tabindex |
+| Slider | `@mappoh/nova/slider` | Custom slider with pointer drag |
+| Rating | `@mappoh/nova/rating` | Star rating |
+| Alert | `@mappoh/nova/alert` | Alert/banner with variants |
+| Badge | `@mappoh/nova/badge` | Inline badge |
+| Avatar | `@mappoh/nova/avatar` | Image with initials fallback |
+| Progress | `@mappoh/nova/progress` | Linear and circular progress bars |
+| Skeleton | `@mappoh/nova/skeleton` | Shimmer loading placeholder |
+| Spinner | `@mappoh/nova/spinner` | Loading spinner |
+| Breadcrumb | `@mappoh/nova/breadcrumb` | Navigation breadcrumbs |
+| Command Palette | `@mappoh/nova/command-palette` | Cmd+K searchable command overlay |
+| Editor | `@mappoh/nova/editor` | Markdown editor with split/write/preview modes |
+| Notification Center | `@mappoh/nova/notification-center` | Notification drawer with badge count |
+
+### Forms
+
+| Module | Import | Description |
+|--------|--------|-------------|
+| Form Engine | `@mappoh/nova/forms` | Schema-driven forms with validation and touched/dirty tracking |
+| WASM Validators | `@mappoh/nova/forms/wasm-validators` | Email, URL, credit card, IBAN validation (WASM + TS fallback) |
 
-Optional Rust-compiled modules for performance-critical paths. Each has a pure TypeScript fallback.
+### Animation & Canvas
+
+| Module | Import | Description |
+|--------|--------|-------------|
+| Spring | `@mappoh/nova/animation/spring` | Physics-based spring animation |
+| Stagger | `@mappoh/nova/animation/stagger` | Staggered animations across element arrays |
+| FLIP | `@mappoh/nova/animation/flip` | First-Last-Invert-Play layout transitions |
+| Scroll Animate | `@mappoh/nova/animation/scroll-animate` | CSS `animation-timeline` with fallback |
+| Parallax | `@mappoh/nova/animation/parallax` | Scroll-driven parallax layers |
+| Text Reveal | `@mappoh/nova/text-reveal` | Staggered word/line entrance |
+| Particles | `@mappoh/nova/canvas/particles` | 2D particle system |
+| Dot Grid | `@mappoh/nova/canvas/dot-grid` | Interactive dot grid |
+| Noise | `@mappoh/nova/canvas/noise` | Simplex/Perlin noise rendering |
+| Virtual List | `@mappoh/nova/virtual-list` | DOM-recycling virtual scroller |
+
+### i18n
+
+| Module | Import | Description |
+|--------|--------|-------------|
+| i18n | `@mappoh/nova/i18n` | Reactive i18n with ICU pluralization, `formatNumber`, `formatDate`, `formatRelative` |
+
+### Utilities
+
+| Module | Import | Description |
+|--------|--------|-------------|
+| Utils | `@mappoh/nova/utils` | `debounce`, `throttle`, `deepEqual`, `clamp`, `lerp`, `remap`, `uniqueId` |
+| A11y | `@mappoh/nova/a11y` | `trapFocus`, `rovingTabIndex`, `announce`, `skipLink` |
+| Clipboard | `@mappoh/nova/clipboard` | Copy/read text and HTML |
+| Search | `@mappoh/nova/search` | Full-text search with WASM fuzzy matching |
+| Gesture | `@mappoh/nova/gesture` | Swipe, pinch, pan, long-press, tap with Pointer Events |
+| Drag | `@mappoh/nova/drag` | Sortable lists with keyboard support |
+| Shortcuts | `@mappoh/nova/shortcuts` | Keyboard shortcut registry |
+| Lazy Load | `@mappoh/nova/lazy` | IntersectionObserver lazy loading |
+| Infinite Scroll | `@mappoh/nova/infinite-scroll` | Infinite scroll loading |
+| Scale | `@mappoh/nova/theme` | Mathematical type scale via CSS custom properties |
+| Service Worker | `@mappoh/nova/sw` | SW generation with caching strategies |
+| Devtools | `@mappoh/nova/devtools` | Component inspector and render debugging |
+
+### WASM Accelerators
+
+Optional Rust-compiled modules. Each has a pure TypeScript fallback.
 
 | Module | Import | Description |
 |--------|--------|-------------|
 | Markdown | `@mappoh/nova/markdown/wasm` | CommonMark + GFM parser |
-| Noise | `@mappoh/nova/canvas/noise-wasm` | Batch simplex/Perlin/Worley noise with FBM buffer fill |
-| Validation | `@mappoh/nova/forms/wasm-validators` | RFC 5322 email, Luhn credit card, IBAN, password strength |
-| Image | `@mappoh/nova/image/wasm` | Pixel-level grayscale, sepia, blur, sharpen, crop, rotate, resize |
-| Physics | `@mappoh/nova/canvas/physics-wasm` | 2D particle dynamics with Verlet integration and spatial hashing |
-| Crypto | `@mappoh/nova/security/wasm-crypto` | Argon2id, bcrypt, PBKDF2-SHA256 password hashing |
-| Diff | `@mappoh/nova/component/diff-wasm` | LIS-based keyed list reconciliation for minimal DOM ops |
+| Noise | `@mappoh/nova/canvas/noise-wasm` | Batch noise with FBM |
+| Validation | `@mappoh/nova/forms/wasm-validators` | Email, credit card, IBAN, password strength |
+| Image | `@mappoh/nova/image/wasm` | Grayscale, blur, sharpen, crop, rotate, resize |
+| Physics | `@mappoh/nova/canvas/physics-wasm` | 2D particle dynamics |
+| Crypto | `@mappoh/nova/security/wasm-crypto` | Argon2id, bcrypt, PBKDF2-SHA256 |
+| Diff | `@mappoh/nova/component/diff-wasm` | LIS-based keyed list reconciliation |
+
+## Quick Start
+
+```ts
+import { Component, html, classMap, createRef } from '@mappoh/nova/component';
+import { createNovaStore } from '@mappoh/nova/store';
+
+const { signal } = createNovaStore();
+const count = signal(0);
 
-### Infrastructure
+class Counter extends Component {
+  static tag = 'my-counter';
+  static styles = `
+    button { padding: 8px 16px; border-radius: 6px; background: #333; color: #fff; }
+    .active { background: #0066ff; }
+  `;
 
-- **Cargo workspace** — `wasm/` is now a workspace with 8 crates sharing deps and release profile
-- **Build scripts** — `npm run build:all` compiles WASM + TypeScript in one step
-- **17 new package exports** — every module has a dedicated entry point
+  private ref = createRef<HTMLButtonElement>();
 
-## Security Hardening
+  render() {
+    const value = count();
+    return html`
+      <button
+        ref=${this.ref}
+        class=${classMap({ active: value > 0 })}
+        @click=${() => count.update(n => n + 1)}
+      >
+        Count: ${value}
+      </button>
+    `;
+  }
+}
 
-- **Modal** — HTML string content is sanitized (scripts and `on*` handlers stripped)
-- **Markdown** — URL attributes are escaped; `javascript:`/`vbscript:` URIs blocked
-- **Breadcrumb** — `href` sanitized against dangerous URIs; `icon` renders as text
-- **Crypto WASM** — CSPRNG for salt generation; minimum parameter bounds on verify; defaults raised to OWASP recommendations
+Counter.define();
+```
 
-See [CHANGELOG.md](./CHANGELOG.md) for the full release notes and breaking changes.
+See [CHANGELOG.md](./CHANGELOG.md) for release notes.

package/dist/a11y/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Nova Engine — Accessibility Utilities
+ *
+ * Reusable focus management, keyboard navigation,
+ * screen reader announcements, and ARIA helpers.
+ */
+/** Generate a unique ID for ARIA attribute linking. */
+export declare function uniqueId(prefix?: string): string;
+/** Check if user prefers reduced motion. */
+export declare function prefersReducedMotion(): boolean;
+/**
+ * Trap focus within a container element.
+ * Pressing Tab/Shift+Tab cycles through focusable elements inside.
+ * Returns a cleanup function to remove the trap.
+ */
+export declare function trapFocus(container: HTMLElement): () => void;
+export interface RovingOptions {
+    /** Arrow key orientation. Default: 'horizontal' */
+    orientation?: 'horizontal' | 'vertical' | 'both';
+    /** Wrap around at edges. Default: true */
+    wrap?: boolean;
+}
+/**
+ * Set up roving tabindex keyboard navigation within a container.
+ * Items matching the selector get tabindex management and arrow key navigation.
+ * Returns a cleanup function.
+ */
+export declare function rovingTabIndex(container: HTMLElement, selector: string, options?: RovingOptions): () => void;
+/**
+ * Announce a message to screen readers via a live region.
+ * @param message Text to announce
+ * @param priority 'polite' (default) or 'assertive'
+ */
+export declare function announce(message: string, priority?: 'polite' | 'assertive'): void;
+/**
+ * Create a skip-to-content link.
+ * Returns the anchor element — append it to the page.
+ */
+export declare function skipLink(targetId: string, label?: string): HTMLAnchorElement;
+//# sourceMappingURL=index.d.ts.map

package/dist/a11y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a11y/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,MAAM,SAAS,GAAG,MAAM,CAEhD;AAED,4CAA4C;AAC5C,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,IAAI,CA8B5D;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IACjD,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC1B,MAAM,IAAI,CA+CZ;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,GAAG,WAAsB,GAAG,IAAI,CA4B3F;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAoB,GAAG,iBAAiB,CAwBvF"}

package/dist/a11y/index.js

@@ -0,0 +1,162 @@
+/**
+ * Nova Engine — Accessibility Utilities
+ *
+ * Reusable focus management, keyboard navigation,
+ * screen reader announcements, and ARIA helpers.
+ */
+const FOCUSABLE = 'a[href],button:not([disabled]),input:not([disabled]),textarea:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
+let idCounter = 0;
+/** Generate a unique ID for ARIA attribute linking. */
+export function uniqueId(prefix = 'nova') {
+    return `${prefix}-${++idCounter}`;
+}
+/** Check if user prefers reduced motion. */
+export function prefersReducedMotion() {
+    return typeof window !== 'undefined' && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+}
+/**
+ * Trap focus within a container element.
+ * Pressing Tab/Shift+Tab cycles through focusable elements inside.
+ * Returns a cleanup function to remove the trap.
+ */
+export function trapFocus(container) {
+    function handleKeydown(e) {
+        if (e.key !== 'Tab')
+            return;
+        const focusable = Array.from(container.querySelectorAll(FOCUSABLE));
+        if (focusable.length === 0)
+            return;
+        const first = focusable[0];
+        const last = focusable[focusable.length - 1];
+        if (e.shiftKey) {
+            if (document.activeElement === first) {
+                e.preventDefault();
+                last.focus();
+            }
+        }
+        else {
+            if (document.activeElement === last) {
+                e.preventDefault();
+                first.focus();
+            }
+        }
+    }
+    container.addEventListener('keydown', handleKeydown);
+    // Focus first element on trap activation
+    const first = container.querySelector(FOCUSABLE);
+    first?.focus();
+    return () => container.removeEventListener('keydown', handleKeydown);
+}
+/**
+ * Set up roving tabindex keyboard navigation within a container.
+ * Items matching the selector get tabindex management and arrow key navigation.
+ * Returns a cleanup function.
+ */
+export function rovingTabIndex(container, selector, options = {}) {
+    const { orientation = 'horizontal', wrap = true } = options;
+    function getItems() {
+        return Array.from(container.querySelectorAll(selector));
+    }
+    function init() {
+        const items = getItems();
+        items.forEach((item, i) => {
+            item.setAttribute('tabindex', i === 0 ? '0' : '-1');
+        });
+    }
+    function handleKeydown(e) {
+        const items = getItems();
+        const current = items.indexOf(e.target);
+        if (current === -1)
+            return;
+        let next = -1;
+        const prevKeys = orientation === 'vertical' ? ['ArrowUp'] : orientation === 'horizontal' ? ['ArrowLeft'] : ['ArrowUp', 'ArrowLeft'];
+        const nextKeys = orientation === 'vertical' ? ['ArrowDown'] : orientation === 'horizontal' ? ['ArrowRight'] : ['ArrowDown', 'ArrowRight'];
+        if (nextKeys.includes(e.key)) {
+            next = current + 1;
+            if (next >= items.length)
+                next = wrap ? 0 : current;
+        }
+        else if (prevKeys.includes(e.key)) {
+            next = current - 1;
+            if (next < 0)
+                next = wrap ? items.length - 1 : current;
+        }
+        else if (e.key === 'Home') {
+            next = 0;
+        }
+        else if (e.key === 'End') {
+            next = items.length - 1;
+        }
+        if (next !== -1 && next !== current) {
+            e.preventDefault();
+            items[current].setAttribute('tabindex', '-1');
+            items[next].setAttribute('tabindex', '0');
+            items[next].focus();
+        }
+    }
+    init();
+    container.addEventListener('keydown', handleKeydown);
+    return () => container.removeEventListener('keydown', handleKeydown);
+}
+let announceEl = null;
+/**
+ * Announce a message to screen readers via a live region.
+ * @param message Text to announce
+ * @param priority 'polite' (default) or 'assertive'
+ */
+export function announce(message, priority = 'polite') {
+    if (typeof document === 'undefined')
+        return;
+    if (!announceEl) {
+        announceEl = document.createElement('div');
+        announceEl.setAttribute('aria-live', priority);
+        announceEl.setAttribute('aria-atomic', 'true');
+        Object.assign(announceEl.style, {
+            position: 'absolute',
+            width: '1px',
+            height: '1px',
+            padding: '0',
+            margin: '-1px',
+            overflow: 'hidden',
+            clip: 'rect(0,0,0,0)',
+            whiteSpace: 'nowrap',
+            border: '0',
+        });
+        document.body.appendChild(announceEl);
+    }
+    announceEl.setAttribute('aria-live', priority);
+    announceEl.textContent = '';
+    // Force screen reader to re-announce by clearing then setting
+    requestAnimationFrame(() => {
+        if (announceEl)
+            announceEl.textContent = message;
+    });
+}
+/**
+ * Create a skip-to-content link.
+ * Returns the anchor element — append it to the page.
+ */
+export function skipLink(targetId, label = 'Skip to content') {
+    const link = document.createElement('a');
+    link.href = `#${targetId}`;
+    link.textContent = label;
+    link.className = 'nova-skip-link';
+    Object.assign(link.style, {
+        position: 'absolute',
+        top: '-100%',
+        left: '0',
+        zIndex: '10000',
+        padding: '0.5rem 1rem',
+        background: '#000',
+        color: '#fff',
+        textDecoration: 'none',
+    });
+    link.addEventListener('focus', () => {
+        link.style.top = '0';
+    });
+    link.addEventListener('blur', () => {
+        link.style.top = '-100%';
+    });
+    return link;
+}
+//# sourceMappingURL=index.js.map

package/dist/a11y/index.js.map

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

package/dist/alert/alert.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Nova Engine — Alert / Banner
+ *
+ * Accessible notification banners with type-based colour coding,
+ * inline SVG icons, optional auto-dismiss, and slide-in animation.
+ */
+export type AlertType = 'info' | 'success' | 'warning' | 'error';
+export interface AlertOptions {
+    /** Alert variant. Default: 'info' */
+    type?: AlertType;
+    /** Main message text */
+    message: string;
+    /** Optional title / heading */
+    title?: string;
+    /** Show a dismiss button. Default: true */
+    dismissible?: boolean;
+    /** Callback when dismissed */
+    onDismiss?: () => void;
+    /** Show a type icon. Default: true */
+    icon?: boolean;
+    /** Auto-dismiss duration in ms. 0 = manual only. Default: 0 */
+    duration?: number;
+}
+export interface AlertInstance {
+    /** Dismiss the alert (with exit animation) */
+    dismiss(): void;
+    /** Remove from DOM and clean up immediately */
+    destroy(): void;
+}
+/** Create an accessible alert banner. */
+export declare function createAlert(container: string | HTMLElement, options: AlertOptions): AlertInstance;
+//# sourceMappingURL=alert.d.ts.map

package/dist/alert/alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/alert/alert.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,IAAI,IAAI,CAAC;IAChB,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AA4MD,yCAAyC;AACzC,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,OAAO,EAAE,YAAY,GACpB,aAAa,CAoHf"}