@backbay/glia 0.2.0-alpha.1

package/dist/desktop/themes/default.js

@@ -0,0 +1,90 @@
+/**
+ * @backbay/glia Desktop OS - Default Theme
+ *
+ * A sophisticated dark theme inspired by the Backbay "Gold + Steel" aesthetic.
+ * Features gold accent colors, refined typography, and subtle glass effects.
+ */
+/**
+ * Default desktop OS theme - "Gold + Steel"
+ *
+ * A dark, refined theme with:
+ * - Gold primary accent (#d4a84b)
+ * - Steel secondary accent (#4a6fa5)
+ * - Elegant display fonts (Cinzel)
+ * - Subtle shadows and glass effects
+ */
+export const defaultTheme = {
+    id: 'gold-steel',
+    name: 'Gold + Steel',
+    colors: {
+        // Window
+        windowBg: '#0a0a0a',
+        windowBorder: '#333333',
+        windowBorderFocused: 'rgba(212, 168, 75, 0.25)',
+        titlebarBg: '#111111',
+        titlebarText: '#ffffff',
+        // Accent
+        accent: '#d4a84b',
+        accentMuted: '#a67c35',
+        accentGlow: 'rgba(212, 168, 75, 0.2)',
+        // Taskbar
+        taskbarBg: 'rgba(17, 17, 17, 0.8)',
+        taskbarText: '#888888',
+        // Menus
+        startMenuBg: '#111111',
+        contextMenuBg: '#111111',
+        contextMenuHover: '#1a1a1a',
+        // Desktop
+        desktopBg: '#010100',
+        iconText: '#cccccc',
+        iconSelected: 'rgba(212, 168, 75, 0.15)',
+        // Semantic
+        destructive: '#c44444',
+        success: '#4a9f5a',
+        warning: '#d4a84b',
+        // Text
+        textPrimary: '#ffffff',
+        textSecondary: '#cccccc',
+        textMuted: '#888888',
+    },
+    fonts: {
+        display: "'Cinzel', serif",
+        body: "'Rajdhani', sans-serif",
+        mono: "'JetBrains Mono', monospace",
+    },
+    radii: {
+        window: '3px',
+        button: '2px',
+        menu: '3px',
+        input: '2px',
+    },
+    shadows: {
+        window: '0 8px 32px rgba(0, 0, 0, 0.6)',
+        windowFocused: '0 32px 80px -12px rgba(0, 0, 0, 0.6), 0 16px 40px -8px rgba(0, 0, 0, 0.4), 0 0 80px -20px rgba(212, 168, 75, 0.15)',
+        menu: '0 4px 16px rgba(0, 0, 0, 0.5)',
+        tooltip: '0 2px 8px rgba(0, 0, 0, 0.4)',
+    },
+    spacing: {
+        windowPadding: '12px',
+        taskbarHeight: '48px',
+        iconSize: '64px',
+        iconGap: '16px',
+        titlebarHeight: '36px',
+        windowBorderWidth: '2px',
+    },
+    animation: {
+        duration: {
+            fast: '100ms',
+            normal: '200ms',
+            slow: '300ms',
+        },
+        easing: {
+            default: 'cubic-bezier(0.4, 0, 0.2, 1)',
+            spring: 'cubic-bezier(0.34, 1.56, 0.64, 1)',
+            bounce: 'cubic-bezier(0.68, -0.55, 0.265, 1.55)',
+        },
+    },
+    blur: {
+        backdrop: 'blur(12px)',
+    },
+};

package/dist/desktop/themes/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @backbay/glia Desktop OS - Themes
+ */
+export * from './types';
+export * from './default';
+//# sourceMappingURL=index.d.ts.map

package/dist/desktop/themes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/desktop/themes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/desktop/themes/index.js

@@ -0,0 +1,5 @@
+/**
+ * @backbay/glia Desktop OS - Themes
+ */
+export * from './types';
+export * from './default';

package/dist/desktop/themes/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @backbay/glia Desktop OS - Theme Types
+ *
+ * The theme system uses CSS variables for styling. Themes define the values,
+ * and the ThemeProvider injects them as CSS custom properties.
+ *
+ * CSS variable naming convention: --bb-{category}-{name}
+ * Example: --bb-color-accent, --bb-font-display, --bb-radius-window
+ */
+/**
+ * Desktop OS theme definition.
+ */
+export interface DesktopOSTheme {
+    /** Theme identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Color tokens */
+    colors: {
+        /** Window background */
+        windowBg: string;
+        /** Window border */
+        windowBorder: string;
+        /** Window border when focused */
+        windowBorderFocused: string;
+        /** Titlebar background */
+        titlebarBg: string;
+        /** Titlebar text */
+        titlebarText: string;
+        /** Primary accent color */
+        accent: string;
+        /** Muted accent (for backgrounds) */
+        accentMuted: string;
+        /** Glowing accent (for active states) */
+        accentGlow: string;
+        /** Taskbar background */
+        taskbarBg: string;
+        /** Taskbar text */
+        taskbarText: string;
+        /** Start menu background */
+        startMenuBg: string;
+        /** Context menu background */
+        contextMenuBg: string;
+        /** Context menu hover */
+        contextMenuHover: string;
+        /** Desktop background */
+        desktopBg: string;
+        /** Icon text color */
+        iconText: string;
+        /** Selected icon background */
+        iconSelected: string;
+        /** Destructive action color (close buttons, delete) */
+        destructive: string;
+        /** Success color */
+        success: string;
+        /** Warning color */
+        warning: string;
+        /** Text colors */
+        textPrimary: string;
+        textSecondary: string;
+        textMuted: string;
+    };
+    /** Font families */
+    fonts: {
+        /** Display font (headings, titles) */
+        display: string;
+        /** Body font (content) */
+        body: string;
+        /** Monospace font (code) */
+        mono: string;
+    };
+    /** Border radii */
+    radii: {
+        /** Window border radius */
+        window: string;
+        /** Button border radius */
+        button: string;
+        /** Menu border radius */
+        menu: string;
+        /** Input border radius */
+        input: string;
+    };
+    /** Shadow definitions */
+    shadows: {
+        /** Window shadow (unfocused) */
+        window: string;
+        /** Window shadow (focused) */
+        windowFocused: string;
+        /** Menu shadow */
+        menu: string;
+        /** Tooltip shadow */
+        tooltip: string;
+    };
+    /** Spacing values */
+    spacing: {
+        /** Window content padding */
+        windowPadding: string;
+        /** Taskbar height */
+        taskbarHeight: string;
+        /** Desktop icon size */
+        iconSize: string;
+        /** Desktop icon grid gap */
+        iconGap: string;
+        /** Titlebar height */
+        titlebarHeight: string;
+        /** Window border width */
+        windowBorderWidth: string;
+    };
+    /** Animation settings */
+    animation: {
+        /** Duration presets */
+        duration: {
+            fast: string;
+            normal: string;
+            slow: string;
+        };
+        /** Easing presets */
+        easing: {
+            default: string;
+            spring: string;
+            bounce: string;
+        };
+    };
+    /** Blur settings */
+    blur: {
+        /** Backdrop blur for glass effects */
+        backdrop: string;
+    };
+}
+/**
+ * Partial theme for overriding specific values.
+ */
+export type PartialDesktopOSTheme = {
+    [K in keyof DesktopOSTheme]?: K extends 'colors' | 'fonts' | 'radii' | 'shadows' | 'spacing' ? Partial<DesktopOSTheme[K]> : K extends 'animation' ? {
+        duration?: Partial<DesktopOSTheme['animation']['duration']>;
+        easing?: Partial<DesktopOSTheme['animation']['easing']>;
+    } : K extends 'blur' ? Partial<DesktopOSTheme['blur']> : DesktopOSTheme[K];
+};
+/**
+ * Convert a theme object to CSS custom properties.
+ */
+export declare function themeToCssVariables(theme: DesktopOSTheme): Record<string, string>;
+/**
+ * Merge a partial theme into a base theme.
+ */
+export declare function mergeTheme(base: DesktopOSTheme, partial: PartialDesktopOSTheme): DesktopOSTheme;
+//# sourceMappingURL=types.d.ts.map

package/dist/desktop/themes/types.d.ts.map

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

package/dist/desktop/themes/types.js

@@ -0,0 +1,71 @@
+/**
+ * @backbay/glia Desktop OS - Theme Types
+ *
+ * The theme system uses CSS variables for styling. Themes define the values,
+ * and the ThemeProvider injects them as CSS custom properties.
+ *
+ * CSS variable naming convention: --bb-{category}-{name}
+ * Example: --bb-color-accent, --bb-font-display, --bb-radius-window
+ */
+/**
+ * Convert a theme object to CSS custom properties.
+ */
+export function themeToCssVariables(theme) {
+    const vars = {};
+    // Colors
+    for (const [key, value] of Object.entries(theme.colors)) {
+        vars[`--bb-color-${kebabCase(key)}`] = value;
+    }
+    // Fonts
+    for (const [key, value] of Object.entries(theme.fonts)) {
+        vars[`--bb-font-${key}`] = value;
+    }
+    // Radii
+    for (const [key, value] of Object.entries(theme.radii)) {
+        vars[`--bb-radius-${key}`] = value;
+    }
+    // Shadows
+    for (const [key, value] of Object.entries(theme.shadows)) {
+        vars[`--bb-shadow-${kebabCase(key)}`] = value;
+    }
+    // Spacing
+    for (const [key, value] of Object.entries(theme.spacing)) {
+        vars[`--bb-spacing-${kebabCase(key)}`] = value;
+    }
+    // Animation durations
+    for (const [key, value] of Object.entries(theme.animation.duration)) {
+        vars[`--bb-duration-${key}`] = value;
+    }
+    // Animation easing
+    for (const [key, value] of Object.entries(theme.animation.easing)) {
+        vars[`--bb-easing-${key}`] = value;
+    }
+    // Blur
+    vars['--bb-blur-backdrop'] = theme.blur.backdrop;
+    return vars;
+}
+/**
+ * Merge a partial theme into a base theme.
+ */
+export function mergeTheme(base, partial) {
+    return {
+        id: partial.id ?? base.id,
+        name: partial.name ?? base.name,
+        colors: { ...base.colors, ...partial.colors },
+        fonts: { ...base.fonts, ...partial.fonts },
+        radii: { ...base.radii, ...partial.radii },
+        shadows: { ...base.shadows, ...partial.shadows },
+        spacing: { ...base.spacing, ...partial.spacing },
+        animation: {
+            duration: { ...base.animation.duration, ...partial.animation?.duration },
+            easing: { ...base.animation.easing, ...partial.animation?.easing },
+        },
+        blur: { ...base.blur, ...partial.blur },
+    };
+}
+/**
+ * Convert camelCase to kebab-case.
+ */
+function kebabCase(str) {
+    return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+}

package/dist/emotion/constants.d.ts

@@ -0,0 +1,35 @@
+import type { AVO, AnchorState, MicroExpressionConfig, LegacyGlyphState } from './types.js';
+/**
+ * Validate AVO dimensions are in valid range
+ */
+export declare function isValidAVO(avo: AVO): boolean;
+/**
+ * Clamp AVO dimensions to valid range
+ */
+export declare function clampAVO(avo: Partial<AVO>): AVO;
+/**
+ * Named anchor states with AVO coordinates
+ */
+export declare const ANCHOR_STATES: Record<AnchorState, AVO>;
+/**
+ * Map legacy GlyphState to anchor states
+ */
+export declare const LEGACY_STATE_MAP: Record<LegacyGlyphState, AnchorState>;
+/**
+ * Default micro-expression configuration
+ */
+export declare const DEFAULT_MICRO_CONFIG: MicroExpressionConfig;
+/**
+ * Default transition durations by type (ms)
+ */
+export declare const DEFAULT_TRANSITION_DURATIONS: {
+    readonly micro: 150;
+    readonly standard: 400;
+    readonly mood: 800;
+    readonly major: 1200;
+};
+/**
+ * Default AVO state (idle equivalent)
+ */
+export declare const DEFAULT_AVO: AVO;
+//# sourceMappingURL=constants.d.ts.map

package/dist/emotion/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/emotion/constants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5F;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAM5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAM/C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,GAAG,CAkClD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAQlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAMlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;CAK/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,GAAwB,CAAC"}

package/dist/emotion/constants.js

@@ -0,0 +1,86 @@
+// packages/bb-ui/src/emotion/constants.ts
+/**
+ * Validate AVO dimensions are in valid range
+ */
+export function isValidAVO(avo) {
+    return (avo.arousal >= 0 && avo.arousal <= 1 &&
+        avo.valence >= 0 && avo.valence <= 1 &&
+        avo.openness >= 0 && avo.openness <= 1);
+}
+/**
+ * Clamp AVO dimensions to valid range
+ */
+export function clampAVO(avo) {
+    return {
+        arousal: Math.max(0, Math.min(1, avo.arousal ?? 0.25)),
+        valence: Math.max(0, Math.min(1, avo.valence ?? 0.6)),
+        openness: Math.max(0, Math.min(1, avo.openness ?? 0.35)),
+    };
+}
+/**
+ * Named anchor states with AVO coordinates
+ */
+export const ANCHOR_STATES = {
+    // Rest states
+    dormant: { arousal: 0.05, valence: 0.55, openness: 0.30 },
+    idle: { arousal: 0.25, valence: 0.60, openness: 0.35 },
+    // Receptive states
+    attentive: { arousal: 0.40, valence: 0.70, openness: 0.20 },
+    curious: { arousal: 0.50, valence: 0.75, openness: 0.10 },
+    listening: { arousal: 0.45, valence: 0.70, openness: 0.05 },
+    // Processing states
+    thinking: { arousal: 0.60, valence: 0.60, openness: 0.40 },
+    contemplating: { arousal: 0.55, valence: 0.65, openness: 0.45 },
+    focused: { arousal: 0.70, valence: 0.70, openness: 0.50 },
+    // Expressive states
+    responding: { arousal: 0.60, valence: 0.75, openness: 0.80 },
+    explaining: { arousal: 0.55, valence: 0.80, openness: 0.85 },
+    enthusiastic: { arousal: 0.80, valence: 0.90, openness: 0.75 },
+    // Completion states
+    satisfied: { arousal: 0.30, valence: 0.90, openness: 0.50 },
+    proud: { arousal: 0.45, valence: 0.95, openness: 0.60 },
+    // Negative states
+    uncertain: { arousal: 0.45, valence: 0.40, openness: 0.35 },
+    concerned: { arousal: 0.55, valence: 0.30, openness: 0.30 },
+    struggling: { arousal: 0.70, valence: 0.35, openness: 0.45 },
+    alarmed: { arousal: 0.80, valence: 0.20, openness: 0.40 },
+    error: { arousal: 0.75, valence: 0.10, openness: 0.35 },
+    // Recovery states
+    recovering: { arousal: 0.40, valence: 0.45, openness: 0.40 },
+    relieved: { arousal: 0.35, valence: 0.75, openness: 0.45 },
+};
+/**
+ * Map legacy GlyphState to anchor states
+ */
+export const LEGACY_STATE_MAP = {
+    idle: 'idle',
+    listening: 'listening',
+    thinking: 'thinking',
+    responding: 'responding',
+    success: 'satisfied',
+    error: 'error',
+    sleep: 'dormant',
+};
+/**
+ * Default micro-expression configuration
+ */
+export const DEFAULT_MICRO_CONFIG = {
+    enabled: true,
+    arousalNoise: 0.02,
+    valenceNoise: 0.015,
+    opennessNoise: 0.01,
+    frequency: 0.3,
+};
+/**
+ * Default transition durations by type (ms)
+ */
+export const DEFAULT_TRANSITION_DURATIONS = {
+    micro: 150,
+    standard: 400,
+    mood: 800,
+    major: 1200,
+};
+/**
+ * Default AVO state (idle equivalent)
+ */
+export const DEFAULT_AVO = ANCHOR_STATES.idle;

package/dist/emotion/controller.d.ts

@@ -0,0 +1,97 @@
+import type { AVO, AnchorState, TransitionOptions, EmotionEvent, MicroExpressionConfig, VisualState } from './types.js';
+type EventHandler<T> = (data: T) => void;
+interface EmotionControllerEvents {
+    change: AVO;
+    transitionStart: {
+        from: AVO;
+        to: AVO;
+    };
+    transitionEnd: AVO;
+    anchorReached: AnchorState;
+}
+export interface EmotionControllerOptions {
+    initial?: Partial<AVO>;
+    initialAnchor?: AnchorState;
+    microExpressions?: boolean | MicroExpressionConfig;
+}
+/**
+ * EmotionController manages the emotional state lifecycle for the Glyph character.
+ *
+ * It handles:
+ * - AVO dimension state (Arousal, Valence, Openness)
+ * - Smooth transitions between states with configurable easing
+ * - Micro-expression overlays for natural movement
+ * - Event-driven state changes from agent behaviors
+ * - Visual state computation for rendering
+ */
+export declare class EmotionController {
+    private _dimensions;
+    private _transition;
+    private _microConfig;
+    private _time;
+    private _listeners;
+    private _disposed;
+    constructor(options?: EmotionControllerOptions);
+    /**
+     * Get current base dimensions (without micro-expressions)
+     */
+    getDimensions(): AVO;
+    /**
+     * Get current dimensions with micro-expressions applied
+     */
+    getAnimatedDimensions(): AVO;
+    /**
+     * Get computed visual state for rendering
+     */
+    getVisualState(): VisualState;
+    /**
+     * Set dimensions immediately (no transition)
+     * Values are clamped to valid 0-1 range
+     */
+    setDimensions(dims: Partial<AVO>): void;
+    /**
+     * Transition to target dimensions over time
+     * Auto-calculates duration and easing if not specified
+     */
+    transitionTo(target: Partial<AVO>, options?: TransitionOptions): void;
+    /**
+     * Transition to a named anchor state
+     * Emits anchorReached when transition completes
+     */
+    transitionToAnchor(anchor: AnchorState, options?: TransitionOptions): void;
+    /**
+     * Handle emotion events from agent behaviors
+     * Maps event types to appropriate anchor transitions
+     */
+    handleEvent(event: EmotionEvent): void;
+    /**
+     * Blend toward target dimensions by a factor (0-1)
+     * Useful for continuous input-driven changes
+     */
+    blendToward(target: Partial<AVO>, factor: number): void;
+    /**
+     * Check if currently transitioning
+     */
+    isTransitioning(): boolean;
+    /**
+     * Cancel current transition, keeping current position
+     */
+    cancelTransition(): void;
+    /**
+     * Subscribe to controller events
+     * Returns unsubscribe function
+     */
+    on<K extends keyof EmotionControllerEvents>(event: K, handler: EventHandler<EmotionControllerEvents[K]>): () => void;
+    /**
+     * Update tick - call each frame with delta time in milliseconds
+     * Advances transitions and micro-expression time
+     */
+    tick(deltaMs: number): void;
+    /**
+     * Dispose controller and clean up resources
+     */
+    dispose(): void;
+    private _emit;
+}
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/dist/emotion/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/emotion/controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,GAAG,EACH,WAAW,EACX,iBAAiB,EAEjB,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzC,UAAU,uBAAuB;IAC/B,MAAM,EAAE,GAAG,CAAC;IACZ,eAAe,EAAE;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,EAAE,EAAE,GAAG,CAAA;KAAE,CAAC;IACxC,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;CACpD;AAWD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,UAAU,CAA6E;IAC/F,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,wBAA6B;IAoBlD;;OAEG;IACH,aAAa,IAAI,GAAG;IAIpB;;OAEG;IACH,qBAAqB,IAAI,GAAG;IAI5B;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI;IAMvC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI;IAkBzE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI;IAU9E;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IA4BtC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMvD;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,uBAAuB,EACxC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,GAChD,MAAM,IAAI;IAWb;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAyB3B;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,KAAK;CAMd"}