@bendyline/squisq 0.1.1 → 1.0.1

package/dist/doc/templates/videoWithCaption.js

@@ -0,0 +1,104 @@
+/**
+ * Video With Caption Template
+ *
+ * Full-screen background video clip with text overlay. Mirrors the structure of
+ * imageWithCaption but uses a VideoLayer instead of an ImageLayer. The video
+ * plays muted — narration audio is the only sound track.
+ *
+ * Adapts caption positioning and font sizes for different viewports.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ *
+ * Related Files:
+ * - shared/story/templates/imageWithCaption.ts — image equivalent
+ * - schemas/StoryScript.ts — VideoLayer type
+ * - site/src/components/story/layers/VideoLayer.tsx — rendering component
+ */
+import { scaledFontSize } from '../../schemas/BlockTemplates.js';
+import { cleanCaption } from './captionUtils.js';
+export function videoWithCaption(input, context) {
+    const { videoSrc, posterSrc, videoAlt, clipStart, clipEnd, sourceDuration, caption: rawCaption, captionPosition = 'bottom', videoCredit, videoLicense, } = input;
+    const caption = rawCaption ? cleanCaption(rawCaption) : rawCaption;
+    const { theme, layout } = context;
+    const captionFontSize = scaledFontSize(36, context, false);
+    const creditFontSize = scaledFontSize(16, context, false);
+    const layers = [
+        // Background video clip
+        {
+            type: 'video',
+            id: 'bg-video',
+            content: {
+                src: videoSrc,
+                posterSrc,
+                alt: videoAlt,
+                fit: 'cover',
+                clipStart,
+                clipEnd,
+                sourceDuration,
+                credit: videoCredit,
+                license: videoLicense,
+            },
+            position: { x: 0, y: 0, width: '100%', height: '100%' },
+        },
+    ];
+    // Caption text at bottom with gradient for readability
+    if (caption) {
+        layers.push({
+            type: 'shape',
+            id: 'caption-gradient',
+            content: {
+                shape: 'rect',
+                fill: 'linear-gradient(0deg, rgba(0,0,0,0.7) 0%, rgba(0,0,0,0.3) 60%, transparent 100%)',
+            },
+            position: {
+                x: 0,
+                y: captionPosition === 'top' ? 0 : '65%',
+                width: '100%',
+                height: '35%',
+            },
+        });
+        const captionY = captionPosition === 'top' ? '15%' : captionPosition === 'center' ? '50%' : '82%';
+        layers.push({
+            type: 'text',
+            id: 'caption',
+            content: {
+                text: caption,
+                style: {
+                    fontSize: captionFontSize,
+                    color: theme.colors.text,
+                    textAlign: 'center',
+                    shadow: true,
+                },
+            },
+            position: {
+                x: '50%',
+                y: captionY,
+                anchor: 'center',
+                width: layout.maxTextWidth,
+            },
+            animation: { type: 'fadeIn', duration: 1.5, delay: 0.5 },
+        });
+    }
+    // Small credit text in bottom-right corner
+    if (videoCredit) {
+        layers.push({
+            type: 'text',
+            id: 'credit',
+            content: {
+                text: videoCredit,
+                style: {
+                    fontSize: creditFontSize,
+                    color: 'rgba(255, 255, 255, 0.5)',
+                    textAlign: 'right',
+                },
+            },
+            position: {
+                x: '96%',
+                y: '96%',
+                anchor: 'bottom-right',
+            },
+        });
+    }
+    return layers;
+}
+//# sourceMappingURL=videoWithCaption.js.map

package/dist/doc/templates/videoWithCaption.js.map

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

package/dist/doc/utils/animationUtils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Animation Utilities
+ *
+ * Helper functions for mapping Doc animations to CSS classes and styles.
+ * Generates the appropriate animation class names and CSS custom properties
+ * for duration, delay, and easing.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+import type { Animation, AnimationType, TransitionType } from '../../schemas/Doc.js';
+interface AnimationResult {
+    /** CSS class name to apply */
+    className: string;
+    /** Inline styles for CSS custom properties */
+    style: Record<string, string>;
+}
+/**
+ * Get CSS class and styles for an animation.
+ */
+export declare function getAnimationStyle(animation: Animation | undefined, _currentTime?: number): AnimationResult;
+/**
+ * Get default duration for an animation type.
+ */
+export declare function getDefaultAnimationDuration(type: AnimationType): number;
+/**
+ * Get transition class for slide entry/exit.
+ */
+export declare function getTransitionClass(type: TransitionType, entering: boolean): string;
+/**
+ * Calculate animation progress (0-1) based on current time.
+ */
+export declare function getAnimationProgress(animation: Animation, currentTime: number, slideDuration: number): number;
+export {};
+//# sourceMappingURL=animationUtils.d.ts.map

package/dist/doc/utils/animationUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationUtils.d.ts","sourceRoot":"","sources":["../../../src/doc/utils/animationUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErF,UAAU,eAAe;IACvB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,YAAY,GAAE,MAAU,GACvB,eAAe,CASjB;AAuDD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAiBvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAGlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR"}

package/dist/doc/utils/animationUtils.js

@@ -0,0 +1,110 @@
+/**
+ * Animation Utilities
+ *
+ * Helper functions for mapping Doc animations to CSS classes and styles.
+ * Generates the appropriate animation class names and CSS custom properties
+ * for duration, delay, and easing.
+ *
+ * This is shared code used by both site and efb-app doc renderers.
+ */
+/**
+ * Get CSS class and styles for an animation.
+ */
+export function getAnimationStyle(animation, _currentTime = 0) {
+    if (!animation || animation.type === 'none') {
+        return { className: '', style: {} };
+    }
+    const className = getAnimationClassName(animation);
+    const style = getAnimationCSSVars(animation);
+    return { className, style };
+}
+/**
+ * Map animation type to CSS class name.
+ */
+function getAnimationClassName(animation) {
+    const { type, direction, panDirection } = animation;
+    switch (type) {
+        case 'fadeIn':
+            return 'anim-fadeIn';
+        case 'fadeOut':
+            return 'anim-fadeOut';
+        case 'slowZoom':
+            // Slow zoom (Ken Burns style) has variants based on direction and pan
+            if (panDirection === 'left')
+                return 'anim-slowZoom-panLeft';
+            if (panDirection === 'right')
+                return 'anim-slowZoom-panRight';
+            if (direction === 'out')
+                return 'anim-slowZoom-out';
+            return 'anim-slowZoom-in';
+        case 'zoomIn':
+            return 'anim-zoomIn';
+        case 'zoomOut':
+            return 'anim-zoomOut';
+        case 'panLeft':
+            return 'anim-panLeft';
+        case 'panRight':
+            return 'anim-panRight';
+        case 'typewriter':
+            return 'anim-typewriter';
+        default:
+            return '';
+    }
+}
+/**
+ * Generate CSS custom properties for animation timing.
+ */
+function getAnimationCSSVars(animation) {
+    const vars = {};
+    if (animation.duration !== undefined) {
+        vars['--anim-duration'] = `${animation.duration}s`;
+    }
+    if (animation.delay !== undefined) {
+        vars['--anim-delay'] = `${animation.delay}s`;
+    }
+    if (animation.easing) {
+        vars['--anim-easing'] = animation.easing;
+    }
+    return vars;
+}
+/**
+ * Get default duration for an animation type.
+ */
+export function getDefaultAnimationDuration(type) {
+    switch (type) {
+        case 'slowZoom':
+        case 'panLeft':
+        case 'panRight':
+            return 8; // Long, slow animations
+        case 'typewriter':
+            return 3;
+        case 'fadeIn':
+        case 'fadeOut':
+            return 1;
+        case 'zoomIn':
+        case 'zoomOut':
+            return 0.5;
+        default:
+            return 1;
+    }
+}
+/**
+ * Get transition class for slide entry/exit.
+ */
+export function getTransitionClass(type, entering) {
+    const mode = entering ? 'enter' : 'exit';
+    return `transition-${type}-${mode}`;
+}
+/**
+ * Calculate animation progress (0-1) based on current time.
+ */
+export function getAnimationProgress(animation, currentTime, slideDuration) {
+    const delay = animation.delay || 0;
+    const duration = animation.duration || slideDuration;
+    if (currentTime < delay)
+        return 0;
+    if (currentTime >= delay + duration)
+        return 1;
+    return (currentTime - delay) / duration;
+}
+//# sourceMappingURL=animationUtils.js.map

package/dist/doc/utils/animationUtils.js.map

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

package/dist/doc/utils/themeUtils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Theme Utilities
+ *
+ * Template-facing helpers that read from the Theme object on the
+ * TemplateContext. Templates call these instead of hard-coding style
+ * decisions, so the same template code adapts to any theme.
+ */
+import type { TemplateContext } from '../../schemas/BlockTemplates.js';
+import type { ThemeColorScheme } from '../../schemas/Theme.js';
+import type { AnimationType } from '../../schemas/Doc.js';
+/**
+ * Resolve a named color scheme from the theme, with a safe fallback.
+ * Templates call this instead of `COLOR_SCHEMES[name]`.
+ */
+export declare function resolveColorScheme(context: TemplateContext, name: string | undefined): ThemeColorScheme;
+/**
+ * Calculate a theme-aware scaled font size.
+ * Applies the theme's typography scale multipliers on top of the
+ * viewport-based font scale from LayoutStrategy.
+ *
+ * @param basePx  Base font size designed for 1920×1080
+ * @param context Template context (includes fontScale, layout, theme)
+ * @param isTitle Whether this is title text (uses titleScale) or body (bodyScale)
+ */
+export declare function themedFontSize(basePx: number, context: TemplateContext, isTitle?: boolean): number;
+/**
+ * Scale an animation duration by the theme's animationSpeed multiplier.
+ * A speed of 1.0 returns the base duration unchanged.
+ */
+export declare function scaleAnimationDuration(baseDuration: number, context: TemplateContext): number;
+/**
+ * Get the theme's default animation type for a layer kind.
+ * Returns `undefined` when the theme doesn't specify one (template picks its own).
+ */
+export declare function getDefaultAnimation(context: TemplateContext, layerType: 'text' | 'image'): AnimationType | undefined;
+/**
+ * Whether the theme defaults to text shadows.
+ * Templates should consult this when choosing `shadow: true/false`.
+ */
+export declare function shouldUseShadow(context: TemplateContext): boolean;
+/**
+ * Get the theme's overlay opacity for image-backed blocks.
+ */
+export declare function getOverlayOpacity(context: TemplateContext): number;
+/**
+ * Read a per-template hint from the theme's renderStyle.
+ * Returns `fallback` when the hint isn't defined.
+ *
+ * @example
+ * ```ts
+ * const entrance = getTemplateHint(context, 'statHighlight', 'entrance', 'subtle');
+ * ```
+ */
+export declare function getTemplateHint<T extends string | number | boolean>(context: TemplateContext, templateName: string, key: string, fallback: T): T;
+//# sourceMappingURL=themeUtils.d.ts.map

package/dist/doc/utils/themeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeUtils.d.ts","sourceRoot":"","sources":["../../../src/doc/utils/themeUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAa1D;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,gBAAgB,CAOlB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,OAAe,GACvB,MAAM,CAYR;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAG7F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAAG,OAAO,GAC1B,aAAa,GAAG,SAAS,CAG3B;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAElE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EACjE,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,GACV,CAAC,CAMH"}

package/dist/doc/utils/themeUtils.js

@@ -0,0 +1,109 @@
+/**
+ * Theme Utilities
+ *
+ * Template-facing helpers that read from the Theme object on the
+ * TemplateContext. Templates call these instead of hard-coding style
+ * decisions, so the same template code adapts to any theme.
+ */
+// ============================================
+// Color Scheme Resolution
+// ============================================
+/** Fallback color scheme when a name is not found in the theme. */
+const FALLBACK_COLOR_SCHEME = {
+    bg: '#1a365d',
+    text: '#63b3ed',
+    accent: '#90cdf4',
+};
+/**
+ * Resolve a named color scheme from the theme, with a safe fallback.
+ * Templates call this instead of `COLOR_SCHEMES[name]`.
+ */
+export function resolveColorScheme(context, name) {
+    const schemes = context.theme.colorSchemes;
+    if (name && name in schemes)
+        return schemes[name];
+    // Fall back to first defined scheme, then hard fallback
+    const keys = Object.keys(schemes);
+    if (keys.length > 0)
+        return schemes[keys[0]];
+    return FALLBACK_COLOR_SCHEME;
+}
+// ============================================
+// Font Sizing
+// ============================================
+/**
+ * Calculate a theme-aware scaled font size.
+ * Applies the theme's typography scale multipliers on top of the
+ * viewport-based font scale from LayoutStrategy.
+ *
+ * @param basePx  Base font size designed for 1920×1080
+ * @param context Template context (includes fontScale, layout, theme)
+ * @param isTitle Whether this is title text (uses titleScale) or body (bodyScale)
+ */
+export function themedFontSize(basePx, context, isTitle = false) {
+    const { fontScale, layout, theme } = context;
+    // Base scale from viewport + orientation
+    const layoutScale = isTitle ? layout.titleScale : layout.bodyScale;
+    // Theme multiplier (defaults to 1.0 when not set)
+    const themeScale = isTitle
+        ? (theme.typography.titleScale ?? 1.0)
+        : (theme.typography.bodyScale ?? 1.0);
+    return Math.round(basePx * fontScale * layoutScale * themeScale);
+}
+// ============================================
+// Animation Helpers
+// ============================================
+/**
+ * Scale an animation duration by the theme's animationSpeed multiplier.
+ * A speed of 1.0 returns the base duration unchanged.
+ */
+export function scaleAnimationDuration(baseDuration, context) {
+    const speed = context.theme.style.animationSpeed ?? 1.0;
+    return baseDuration * speed;
+}
+/**
+ * Get the theme's default animation type for a layer kind.
+ * Returns `undefined` when the theme doesn't specify one (template picks its own).
+ */
+export function getDefaultAnimation(context, layerType) {
+    const rs = context.theme.renderStyle;
+    return layerType === 'text' ? rs.defaultTextAnimation : rs.defaultImageAnimation;
+}
+// ============================================
+// Style Helpers
+// ============================================
+/**
+ * Whether the theme defaults to text shadows.
+ * Templates should consult this when choosing `shadow: true/false`.
+ */
+export function shouldUseShadow(context) {
+    return context.theme.style.textShadow ?? true;
+}
+/**
+ * Get the theme's overlay opacity for image-backed blocks.
+ */
+export function getOverlayOpacity(context) {
+    return context.theme.style.overlayOpacity ?? 0.5;
+}
+// ============================================
+// Template Hint Access
+// ============================================
+/**
+ * Read a per-template hint from the theme's renderStyle.
+ * Returns `fallback` when the hint isn't defined.
+ *
+ * @example
+ * ```ts
+ * const entrance = getTemplateHint(context, 'statHighlight', 'entrance', 'subtle');
+ * ```
+ */
+export function getTemplateHint(context, templateName, key, fallback) {
+    const hints = context.theme.renderStyle.templateHints;
+    if (!hints)
+        return fallback;
+    const tplHints = hints[templateName];
+    if (!tplHints || !(key in tplHints))
+        return fallback;
+    return tplHints[key];
+}
+//# sourceMappingURL=themeUtils.js.map

package/dist/doc/utils/themeUtils.js.map

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

package/dist/generate/contentExtractor.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Content Extractor
+ *
+ * Pattern-based extraction of compelling content from plain text.
+ * Identifies statistics, dates, quotes, comparisons, facts, impact lines,
+ * lists, and definitions that can be turned into slideshow slides.
+ *
+ * Extraction is purely regex-based — no AI calls, no runtime costs,
+ * deterministic and reproducible.
+ */
+/** Kinds of content the extractor recognises. */
+export type ExtractionType = 'stat' | 'date' | 'quote' | 'comparison' | 'fact' | 'impactLine' | 'list' | 'definition';
+/** An extracted content element with source position. */
+export interface ExtractedElement {
+    type: ExtractionType;
+    /** Full extracted text (usually the surrounding sentence). */
+    text: string;
+    /** Confidence score 0–1. */
+    confidence: number;
+    /** Character offset in the source text. */
+    sourcePosition: number;
+    /** Character offset where element ends. */
+    endPosition: number;
+    /** Type-specific structured payload. */
+    data: StatData | DateData | QuoteData | ComparisonData | FactData | ImpactLineData | ListData | DefinitionData;
+}
+export interface StatData {
+    type: 'stat';
+    value: string;
+    unit?: string;
+    description: string;
+}
+export interface DateData {
+    type: 'date';
+    date: string;
+    description: string;
+    mood?: 'neutral' | 'somber' | 'celebratory';
+}
+export interface QuoteData {
+    type: 'quote';
+    quote: string;
+    attribution?: string;
+}
+export interface ComparisonData {
+    type: 'comparison';
+    left: {
+        label: string;
+        sublabel?: string;
+    };
+    right: {
+        label: string;
+        sublabel?: string;
+    };
+    header?: string;
+}
+export interface FactData {
+    type: 'fact';
+    fact: string;
+    explanation?: string;
+}
+export interface ImpactLineData {
+    type: 'impactLine';
+    text: string;
+}
+export interface ListData {
+    type: 'list';
+    items: string[];
+    title?: string;
+}
+export interface DefinitionData {
+    type: 'definition';
+    term: string;
+    definition: string;
+    origin?: string;
+}
+/** Options for `extractContent`. */
+export interface ExtractionOptions {
+    /** Minimum confidence threshold (default: 0.3). */
+    minConfidence?: number;
+    /** Which types to extract (default: all). */
+    types?: ExtractionType[];
+    /** Maximum extractions per type (default: unlimited). */
+    maxPerType?: number;
+}
+/** Result of `extractContent`. */
+export interface ExtractionResult {
+    elements: ExtractedElement[];
+    sourceLength: number;
+    stats: {
+        statCount: number;
+        dateCount: number;
+        quoteCount: number;
+        comparisonCount: number;
+        factCount: number;
+        impactLineCount: number;
+        listCount: number;
+        definitionCount: number;
+        totalCount: number;
+    };
+}
+/**
+ * Extract compelling content from plain text.
+ *
+ * Call `stripMarkdown(text)` first if the input contains markdown.
+ */
+export declare function extractContent(text: string, options?: ExtractionOptions): ExtractionResult;
+/**
+ * Strip markdown formatting from text, returning plain prose.
+ * Call this before `extractContent` if the input is markdown.
+ */
+export declare function stripMarkdown(markdown: string): string;
+//# sourceMappingURL=contentExtractor.d.ts.map

package/dist/generate/contentExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentExtractor.d.ts","sourceRoot":"","sources":["../../src/generate/contentExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iDAAiD;AACjD,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,MAAM,GACN,YAAY,CAAC;AAEjB,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,cAAc,GACd,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,cAAc,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AA+ID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAoD9F;AA4cD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBtD"}