@rafaelaugusto/jolt 0.1.0-beta.0 → 0.1.0-beta.10

package/dist/text-layout.js

@@ -0,0 +1,185 @@
+const MAX_PIECES = 256;
+const MAX_PIXELS = 4_000_000;
+/** Ligatures and composed characters may share glyphs. Never draw a shared glyph twice. */
+export function mergeGlyphRanges(ranges) {
+    const merged = [];
+    for (const range of ranges) {
+        if (!range.length)
+            continue;
+        const previous = merged.at(-1);
+        if (previous &&
+            range.location < previous.location + previous.length &&
+            range.location + range.length > previous.location) {
+            const end = Math.max(previous.location + previous.length, range.location + range.length);
+            previous.location = Math.min(previous.location, range.location);
+            previous.length = end - previous.location;
+        }
+        else
+            merged.push({ location: range.location, length: range.length });
+    }
+    return merged;
+}
+export function textLayer(native, by) {
+    if (native.adjustsFontSizeToFitWidth)
+        return undefined;
+    const original = native.attributedText;
+    const text = original?.string ?? native.text ?? '';
+    if (!text.trim())
+        return { text, layer: undefined, pieces: [] };
+    const string = NSString.stringWithString(text);
+    const full = { location: 0, length: string.length };
+    const attributed = original
+        ? NSMutableAttributedString.alloc().initWithAttributedString(original)
+        : NSMutableAttributedString.alloc().initWithString(text);
+    const paragraph = NSMutableParagraphStyle.new();
+    paragraph.alignment = native.textAlignment;
+    paragraph.lineBreakMode = native.lineBreakMode;
+    const defaults = [
+        [NSFontAttributeName, native.font],
+        [NSForegroundColorAttributeName, native.textColor],
+        [NSParagraphStyleAttributeName, paragraph],
+    ];
+    if (native.shadowColor) {
+        const shadow = NSShadow.new();
+        shadow.shadowColor = native.shadowColor;
+        shadow.shadowOffset = native.shadowOffset;
+        defaults.push([NSShadowAttributeName, shadow]);
+    }
+    for (const [key, value] of defaults) {
+        attributed.enumerateAttributeInRangeOptionsUsingBlock(key, full, 0, (attribute, range) => {
+            if (attribute == null && value != null)
+                attributed.addAttributeValueRange(key, value, range);
+        });
+    }
+    const inset = (side) => (native.padding?.[side] ?? 0) + (native.borderThickness?.[side] ?? 0);
+    const bounds = native.bounds;
+    const width = bounds.size.width - inset('left') - inset('right');
+    const height = bounds.size.height - inset('top') - inset('bottom');
+    if (width <= 0 || height <= 0)
+        return undefined;
+    const storage = NSTextStorage.alloc().initWithAttributedString(attributed);
+    const manager = NSLayoutManager.new();
+    manager.usesFontLeading = false;
+    const container = NSTextContainer.alloc().initWithSize(CGSizeMake(width, height));
+    container.lineFragmentPadding = 0;
+    container.maximumNumberOfLines = native.numberOfLines;
+    container.lineBreakMode = native.lineBreakMode;
+    manager.addTextContainer(container);
+    storage.addLayoutManager(manager);
+    manager.ensureLayoutForTextContainer(container);
+    const visible = manager.glyphRangeForTextContainer(container);
+    if (visible.length !== manager.numberOfGlyphs)
+        return undefined;
+    // A truncation token is not an independently addressable character. Keep the real label.
+    for (let glyph = 0; glyph < manager.numberOfGlyphs;) {
+        if (manager.truncatedGlyphRangeInLineFragmentForGlyphAtIndex(glyph).length)
+            return undefined;
+        const range = new interop.Reference();
+        manager.lineFragmentRectForGlyphAtIndexEffectiveRange(glyph, range);
+        const next = range.value.location + range.value.length;
+        if (next <= glyph)
+            return undefined;
+        glyph = next;
+    }
+    const characters = [];
+    string.enumerateSubstringsInRangeOptionsUsingBlock(full, by === 'letter' ? 2 : 3, (substring, range) => {
+        if (substring?.trim())
+            characters.push({ location: range.location, length: range.length });
+    });
+    if (by === 'word') {
+        // Attach spaces and punctuation to the surrounding word, preserving every visible mark.
+        characters.forEach((range, index) => {
+            const start = index === 0 ? 0 : range.location;
+            const end = characters[index + 1]?.location ?? full.length;
+            range.location = start;
+            range.length = end - start;
+        });
+        if (!characters.length)
+            characters.push(full);
+    }
+    const ranges = mergeGlyphRanges(characters.map((range) => manager.glyphRangeForCharacterRangeActualCharacterRange(range, null)));
+    if (ranges.length > MAX_PIECES)
+        return undefined;
+    const used = manager.usedRectForTextContainer(container);
+    const offsetX = bounds.origin.x + inset('left');
+    const offsetY = bounds.origin.y + inset('top') + (height - used.size.height) / 2 - used.origin.y;
+    const scale = native.window?.screen.scale ?? UIScreen.mainScreen.scale;
+    const padding = Math.max(4, native.font.pointSize * 0.1);
+    const pieces = ranges.map((range) => {
+        const glyph = manager.boundingRectForGlyphRangeInTextContainer(range, container);
+        return {
+            range,
+            rect: CGRectIntegral(CGRectMake(glyph.origin.x + offsetX - padding, glyph.origin.y + offsetY - padding, glyph.size.width + padding * 2, glyph.size.height + padding * 2)),
+        };
+    });
+    if (pieces.reduce((pixels, { rect }) => pixels + rect.size.width * rect.size.height * scale * scale, 0) > MAX_PIXELS)
+        return undefined;
+    const layer = CALayer.new();
+    layer.name = 'jolt:text';
+    layer.frame = bounds;
+    const transparent = UIColor.clearColor;
+    const noShadow = NSShadow.new();
+    noShadow.shadowColor = transparent;
+    const hidden = NSMutableAttributedString.alloc().initWithAttributedString(attributed);
+    for (const key of [
+        NSForegroundColorAttributeName,
+        NSBackgroundColorAttributeName,
+        NSUnderlineColorAttributeName,
+        NSStrikethroughColorAttributeName,
+        NSStrokeColorAttributeName,
+    ]) {
+        hidden.addAttributeValueRange(key, transparent, full);
+    }
+    hidden.addAttributeValueRange(NSShadowAttributeName, noShadow, full);
+    let attachments = false;
+    attributed.enumerateAttributeInRangeOptionsUsingBlock(NSAttachmentAttributeName, full, 0, (value) => {
+        if (value != null)
+            attachments = true;
+    });
+    if (attachments)
+        return undefined;
+    const shadowColor = native.shadowColor;
+    const drawn = [];
+    try {
+        native.shadowColor = null;
+        for (const { range, rect } of pieces) {
+            const fragment = NSMutableAttributedString.alloc().initWithAttributedString(hidden);
+            const characters = manager.characterRangeForGlyphRangeActualGlyphRange(range, null);
+            drawn.push({
+                text: string.substringWithRange(characters),
+                location: characters.location,
+                length: characters.length,
+            });
+            attributed.enumerateAttributesInRangeOptionsUsingBlock(characters, 0, (attributes, part) => fragment.setAttributesRange(attributes, part));
+            native.attributedText = fragment;
+            // UILabel draws its own glyphs, preserving its baseline rounding and fallback-font metrics.
+            // Other glyphs keep their shaping/advances but have transparent paint.
+            UIGraphicsBeginImageContextWithOptions(rect.size, false, scale);
+            let image;
+            try {
+                CGContextTranslateCTM(UIGraphicsGetCurrentContext(), -rect.origin.x, -rect.origin.y);
+                native.drawTextInRect(bounds);
+                image = UIGraphicsGetImageFromCurrentImageContext();
+            }
+            finally {
+                UIGraphicsEndImageContext();
+            }
+            if (!image?.CGImage)
+                return undefined;
+            const piece = CALayer.new();
+            piece.frame = CGRectMake(rect.origin.x - bounds.origin.x, rect.origin.y - bounds.origin.y, rect.size.width, rect.size.height);
+            piece.contents = image.CGImage;
+            piece.contentsScale = scale;
+            layer.addSublayer(piece);
+        }
+    }
+    finally {
+        if (original)
+            native.attributedText = original;
+        else
+            native.text = text;
+        native.shadowColor = shadowColor;
+    }
+    return { text, layer, pieces: drawn };
+}
+//# sourceMappingURL=text-layout.js.map

package/dist/text-layout.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,17 @@
+import type { Animation } from './engine.js';
+import type { Target } from './types.js';
+export interface TextOptions {
+    /** Composed letters (including emoji), or words. Defaults to 'letter'. */
+    by?: 'letter' | 'word';
+    /** Milliseconds per piece. Defaults to 400. */
+    duration?: number;
+    /** Milliseconds between pieces. Defaults to 35. */
+    stagger?: number;
+    /** Milliseconds before the first piece. Defaults to zero. */
+    delay?: number;
+    /** Initial vertical offset in DIPs. Defaults to 12. */
+    y?: number;
+}
+/** Reveals the text of a Label without splitting its layout or accessibility element. */
+export declare function animateText(target: Target, options?: TextOptions): Animation;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAID,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,CAmBhF"}

package/dist/text.js

@@ -0,0 +1,263 @@
+import { stopIOSColorText } from './driver/ios-color.js';
+import { Application, Label, Utils, isAndroid, isIOS } from '@nativescript/core';
+import { textProperty, formattedTextProperty } from '@nativescript/core/ui/text-base';
+import { toView } from './animate.js';
+import { reducedMotion, timeScale } from './config.js';
+import { completion, forgetCompletion, watchLabel } from './label.js';
+import { textLayer } from './text-layout.js';
+const running = new WeakMap();
+/** Reveals the text of a Label without splitting its layout or accessibility element. */
+export function animateText(target, options = {}) {
+    const config = {
+        by: options.by ?? 'letter',
+        duration: options.duration ?? 400,
+        stagger: options.stagger ?? 35,
+        delay: options.delay ?? 0,
+        y: options.y ?? 12,
+    };
+    if (config.by !== 'letter' && config.by !== 'word')
+        throw new TypeError('Text grouping must be letter or word.');
+    for (const key of ['duration', 'stagger', 'delay']) {
+        if (!Number.isFinite(config[key]) || config[key] < 0)
+            throw new RangeError(`Text ${key} must be a nonnegative finite number.`);
+    }
+    if (!Number.isFinite(config.y))
+        throw new RangeError('Text y must be finite.');
+    const view = toView(target);
+    if (!(view instanceof Label))
+        throw new TypeError('Expected a NativeScript Label.');
+    running.get(view)?.stop();
+    return new TextAnimation(view, config);
+}
+class TextAnimation {
+    view;
+    options;
+    finished;
+    resolve;
+    settled = false;
+    queued = false;
+    native;
+    reveal;
+    unwatch;
+    bounds;
+    layer;
+    originalText = null;
+    originalAttributed = null;
+    accessibility = null;
+    temporaryAccessibility;
+    delegate;
+    observer;
+    constructor(view, options) {
+        this.view = view;
+        this.options = options;
+        this.finished = new Promise((resolve) => {
+            this.resolve = resolve;
+        });
+        if (isIOS)
+            stopIOSColorText(view);
+        running.set(view, this);
+        if (!isIOS && !isAndroid) {
+            this.end(false);
+            return;
+        }
+        if (options.duration === 0 || reducedMotion()) {
+            this.end(true);
+            return;
+        }
+        view.on('loaded', this.schedule);
+        view.on('layoutChanged', this.layoutChanged);
+        view.on('unloaded', this.stop);
+        this.unwatch = watchLabel(view, this.changed);
+        this.schedule();
+    }
+    then(onfulfilled, onrejected) {
+        return this.finished.then(onfulfilled, onrejected);
+    }
+    /** Cancels the entrance and restores the full text. */
+    stop = () => this.end(false);
+    changed = () => this.end(false, true);
+    motionChanged = () => {
+        if (reducedMotion())
+            this.end(true);
+    };
+    layoutChanged = () => {
+        if (isAndroid) {
+            if (!this.reveal)
+                this.schedule();
+            else if (this.view.nativeViewProtected !== this.native)
+                this.stop();
+            return;
+        }
+        const native = this.view.nativeViewProtected;
+        const a = this.bounds;
+        const b = native?.bounds;
+        if (this.layer &&
+            (native !== this.native ||
+                !native?.window ||
+                !b ||
+                !a ||
+                a.origin.x !== b.origin.x ||
+                a.origin.y !== b.origin.y ||
+                a.size.width !== b.size.width ||
+                a.size.height !== b.size.height))
+            return this.stop();
+        this.schedule();
+    };
+    schedule = () => {
+        if (this.settled || this.queued)
+            return;
+        this.queued = true;
+        void Promise.resolve().then(() => {
+            this.queued = false;
+            if (this.settled || this.layer || this.reveal || !this.view.isLoaded)
+                return;
+            try {
+                this.start();
+            }
+            catch {
+                this.end(false);
+            }
+        });
+    };
+    start() {
+        if (this.options.duration === 0 || reducedMotion())
+            return this.end(true);
+        if (this.view.visibility !== 'visible')
+            return this.end(false);
+        if (isAndroid)
+            return this.startAndroid();
+        const native = this.view.nativeViewProtected;
+        if (!(native instanceof UILabel) || !native.window)
+            return;
+        if (native.bounds.size.width <= 0 || native.bounds.size.height <= 0)
+            return;
+        const prepared = textLayer(native, this.options.by);
+        if (!prepared)
+            return this.end(false);
+        if (!prepared.layer?.sublayers?.count)
+            return this.end(true);
+        const slowdown = 1 / timeScale();
+        const duration = this.options.duration * slowdown;
+        const stagger = this.options.stagger * slowdown;
+        const delay = this.options.delay * slowdown;
+        if (!Number.isFinite(delay + duration + (prepared.layer.sublayers.count - 1) * stagger))
+            return this.end(false);
+        this.native = native;
+        this.bounds = native.bounds;
+        this.layer = prepared.layer;
+        this.originalText = native.text;
+        this.originalAttributed = native.attributedText;
+        this.accessibility = native.accessibilityLabel;
+        this.temporaryAccessibility = this.accessibility ?? prepared.text;
+        const { y } = this.options;
+        const start = CACurrentMediaTime();
+        CATransaction.begin();
+        CATransaction.setDisableActions(true);
+        try {
+            native.text = '';
+            native.accessibilityLabel = this.temporaryAccessibility;
+            native.layer.addSublayer(this.layer);
+            const pieces = this.layer.sublayers;
+            for (let i = 0; i < pieces.count; i++) {
+                const piece = pieces.objectAtIndex(i);
+                const fade = CABasicAnimation.animationWithKeyPath('opacity');
+                fade.fromValue = 0;
+                fade.toValue = 1;
+                const move = CABasicAnimation.animationWithKeyPath('transform.translation.y');
+                move.fromValue = y;
+                move.toValue = 0;
+                fade.duration = move.duration = duration / 1000;
+                const group = CAAnimationGroup.new();
+                group.animations = NSArray.arrayWithArray([fade, move]);
+                group.duration = duration / 1000;
+                group.beginTime = start + (delay + i * stagger) / 1000;
+                group.fillMode = kCAFillModeBackwards;
+                group.timingFunction = CAMediaTimingFunction.functionWithName(kCAMediaTimingFunctionEaseOut);
+                if (i === pieces.count - 1)
+                    this.delegate = group.delegate = completion((finished) => this.end(finished));
+                piece.addAnimationForKey(group, 'jolt:text');
+            }
+            this.observer = Application.ios.addNotificationObserver(UIAccessibilityReduceMotionStatusDidChangeNotification, this.motionChanged);
+        }
+        finally {
+            CATransaction.commit();
+        }
+    }
+    startAndroid() {
+        const native = this.view.nativeViewProtected;
+        if (!(native instanceof android.widget.TextView))
+            return this.end(false);
+        const { by, duration, stagger, delay, y } = this.options;
+        let reveal;
+        try {
+            reveal = new org.rafaelaugusto.jolt.TextReveal(native, by === 'word', Math.round(duration), Math.round(stagger), Math.round(delay), y * Utils.layout.getDisplayDensity(), new org.rafaelaugusto.jolt.TextReveal.Callback({
+                onEnd: (finished) => {
+                    if (this.reveal !== reveal)
+                        return;
+                    this.reveal = undefined;
+                    this.end(finished);
+                },
+            }));
+        }
+        catch {
+            // A JS-only update cannot install the native plugin. Keep the label as it is.
+            return this.end(false);
+        }
+        if (!reveal.isSupported())
+            return this.end(false);
+        this.native = native;
+        this.reveal = reveal;
+        reveal.start();
+    }
+    end(finished, refresh = false) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        const { view, layer } = this;
+        const native = this.native;
+        const reveal = this.reveal;
+        this.reveal = undefined;
+        reveal?.cancel();
+        view.off('loaded', this.schedule);
+        view.off('layoutChanged', this.layoutChanged);
+        view.off('unloaded', this.stop);
+        this.unwatch?.();
+        if (running.get(view) === this)
+            running.delete(view);
+        if (this.observer)
+            Application.ios.removeNotificationObserver(this.observer, UIAccessibilityReduceMotionStatusDidChangeNotification);
+        if (this.delegate)
+            forgetCompletion(this.delegate);
+        if (native && layer) {
+            CATransaction.begin();
+            CATransaction.setDisableActions(true);
+            try {
+                // Restore only the native text we suppressed; app changes win.
+                if (!native.text && !native.attributedText?.length) {
+                    if (refresh && view.nativeViewProtected === native) {
+                        const property = view.formattedText ? formattedTextProperty : textProperty;
+                        view[property.setNative](view.formattedText ?? view.text);
+                    }
+                    else if (this.originalAttributed)
+                        native.attributedText = this.originalAttributed;
+                    else
+                        native.text = this.originalText;
+                }
+                if (native.accessibilityLabel === this.temporaryAccessibility)
+                    native.accessibilityLabel = this.accessibility;
+                layer.removeFromSuperlayer();
+                const pieces = layer.sublayers;
+                if (pieces)
+                    for (let i = 0; i < pieces.count; i++)
+                        pieces.objectAtIndex(i).removeAnimationForKey('jolt:text');
+            }
+            finally {
+                CATransaction.commit();
+            }
+        }
+        this.native = this.layer = this.delegate = this.observer = undefined;
+        this.originalAttributed = null;
+        this.resolve(finished);
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

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

package/dist/track.d.ts

@@ -24,5 +24,7 @@ export interface Track {
     /** Units per second. */
     velocityAt(elapsed: number): number;
 }
-export declare function createTrack(property: Property, keyframes: readonly number[], { curve, delay, repeat, reverse }: ResolvedTransition, velocity: number): Track;
+export declare function createTrack(property: Property, keyframes: readonly number[], transition: ResolvedTransition, velocity: number): Track;
+/** Already at its end: the engine writes the value and plays nothing. */
+export declare function instantTrack(property: Property, value: number): Track;
 //# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAS,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,wBAAwB;IACxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAaD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,kBAAkB,EACrD,QAAQ,EAAE,MAAM,GACf,KAAK,CAuCP"}
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAS,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIhE;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,wBAAwB;IACxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAcD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,KAAK,CAyEP;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAgBrE"}