@joydle/ui 0.1.0 → 0.1.2

package/dist/fx/hooks.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Simple on/off trigger with automatic reset after `duration` ms.
+ *
+ * ```ts
+ * const { active, trigger } = useTriggerEffect(250);
+ * // active becomes true on trigger(), resets after 250ms
+ * ```
+ */
+export declare function useTriggerEffect(duration?: number): {
+    active: boolean;
+    trigger: () => void;
+};
+/** Alert state managed by useAlerts. */
+export interface AlertState {
+    /** Primary text (large, bold). */
+    main: string;
+    /** Secondary text (smaller). */
+    sub?: string;
+    /** Localised / decorative text. */
+    jp?: string;
+    /** Internal id for deduplication. */
+    id: number;
+}
+/**
+ * Queue-based alert system with auto-dismiss.
+ *
+ * ```tsx
+ * const { alert, showAlert } = useAlerts();
+ * showAlert('WAVE 3', 'ENEMIES INCOMING', '第3波');
+ * // ...
+ * <AlertBanner alert={alert} />
+ * ```
+ */
+export declare function useAlerts(): {
+    alert: AlertState | null;
+    showAlert: (main: string, sub?: string, jp?: string) => void;
+};
+/** Banner state managed by useWaveBanner. */
+export interface BannerState {
+    /** Wave number to display. */
+    wave: number;
+    /** Optional enemy/item count. */
+    count?: number;
+    /** Internal id. */
+    id: number;
+}
+/**
+ * Wave announcement banner with auto-dismiss.
+ *
+ * ```tsx
+ * const { banner, showWave } = useWaveBanner();
+ * showWave(3, 8); // "WAVE 3 — 8 ENEMIES"
+ * <WaveBanner banner={banner} />
+ * ```
+ */
+export declare function useWaveBanner(): {
+    banner: BannerState | null;
+    showWave: (wave: number, count?: number) => void;
+};
+/** Individual kill marker state. */
+export interface KillState {
+    id: number;
+    /** Horizontal % from left. */
+    x: number;
+    /** Vertical % from top. */
+    y: number;
+}
+/**
+ * Spawns kill-confirmation markers at random screen positions.
+ *
+ * ```tsx
+ * const { kills, addKill } = useKillConfirm();
+ * <KillConfirm kills={kills} />
+ * ```
+ */
+export declare function useKillConfirm(): {
+    kills: KillState[];
+    addKill: () => void;
+};
+/** Beam / energy ray state. */
+export interface BeamState {
+    id: number;
+    /** Vertical % position from top. */
+    top: number;
+    /** Width in pixels. */
+    width: number;
+}
+/**
+ * Horizontal beam flash effects (enemy attacks, explosions, etc.).
+ *
+ * ```tsx
+ * const { beams, addBeam } = useBeamEffect();
+ * <ScreenBeam beams={beams} />
+ * ```
+ */
+export declare function useBeamEffect(): {
+    beams: BeamState[];
+    addBeam: () => void;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/fx/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/fx/hooks.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,SAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAiBzF;AAID,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;CACZ;AAID;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI;IAC3B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D,CAUA;AAID,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI;IAC/B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD,CAUA;AAID,oCAAoC;AACpC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;CACX;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAe5E;AAID,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAe3E"}

package/dist/fx/hooks.js

@@ -0,0 +1,116 @@
+// ---------------------------------------------------------------------------
+//  @joydle/ui/fx — Reusable effect lifecycle hooks
+// ---------------------------------------------------------------------------
+import { useState, useRef, useEffect, useCallback } from 'preact/hooks';
+// ---- Generic timed trigger ------------------------------------------------
+/**
+ * Simple on/off trigger with automatic reset after `duration` ms.
+ *
+ * ```ts
+ * const { active, trigger } = useTriggerEffect(250);
+ * // active becomes true on trigger(), resets after 250ms
+ * ```
+ */
+export function useTriggerEffect(duration = 250) {
+    const [active, setActive] = useState(false);
+    const timerRef = useRef(null);
+    const trigger = useCallback(() => {
+        if (timerRef.current)
+            clearTimeout(timerRef.current);
+        setActive(true);
+        timerRef.current = setTimeout(() => setActive(false), duration);
+    }, [duration]);
+    useEffect(() => {
+        return () => {
+            if (timerRef.current)
+                clearTimeout(timerRef.current);
+        };
+    }, []);
+    return { active, trigger };
+}
+let _alertId = 0;
+/**
+ * Queue-based alert system with auto-dismiss.
+ *
+ * ```tsx
+ * const { alert, showAlert } = useAlerts();
+ * showAlert('WAVE 3', 'ENEMIES INCOMING', '第3波');
+ * // ...
+ * <AlertBanner alert={alert} />
+ * ```
+ */
+export function useAlerts() {
+    const [alert, setAlert] = useState(null);
+    const showAlert = useCallback((main, sub, jp) => {
+        const id = ++_alertId;
+        setAlert({ main, sub, jp, id });
+        setTimeout(() => setAlert(prev => (prev?.id === id ? null : prev)), 1800);
+    }, []);
+    return { alert, showAlert };
+}
+let _bannerId = 0;
+/**
+ * Wave announcement banner with auto-dismiss.
+ *
+ * ```tsx
+ * const { banner, showWave } = useWaveBanner();
+ * showWave(3, 8); // "WAVE 3 — 8 ENEMIES"
+ * <WaveBanner banner={banner} />
+ * ```
+ */
+export function useWaveBanner() {
+    const [banner, setBanner] = useState(null);
+    const showWave = useCallback((wave, count) => {
+        const id = ++_bannerId;
+        setBanner({ wave, count, id });
+        setTimeout(() => setBanner(prev => (prev?.id === id ? null : prev)), 2800);
+    }, []);
+    return { banner, showWave };
+}
+let _killId = 0;
+/**
+ * Spawns kill-confirmation markers at random screen positions.
+ *
+ * ```tsx
+ * const { kills, addKill } = useKillConfirm();
+ * <KillConfirm kills={kills} />
+ * ```
+ */
+export function useKillConfirm() {
+    const [kills, setKills] = useState([]);
+    const addKill = useCallback(() => {
+        const id = ++_killId;
+        const kill = {
+            id,
+            x: 45 + Math.random() * 10,
+            y: 38 + Math.random() * 12,
+        };
+        setKills(prev => [...prev, kill]);
+        setTimeout(() => setKills(prev => prev.filter(k => k.id !== id)), 1300);
+    }, []);
+    return { kills, addKill };
+}
+let _beamId = 0;
+/**
+ * Horizontal beam flash effects (enemy attacks, explosions, etc.).
+ *
+ * ```tsx
+ * const { beams, addBeam } = useBeamEffect();
+ * <ScreenBeam beams={beams} />
+ * ```
+ */
+export function useBeamEffect() {
+    const [beams, setBeams] = useState([]);
+    const addBeam = useCallback(() => {
+        const id = ++_beamId;
+        const beam = {
+            id,
+            top: 40 + Math.random() * 20,
+            width: Math.min(window.innerWidth, 600 + Math.random() * 400),
+        };
+        setBeams(prev => [...prev, beam]);
+        setTimeout(() => setBeams(prev => prev.filter(b => b.id !== id)), 700);
+    }, []);
+    return { beams, addBeam };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/fx/hooks.js.map

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

package/dist/fx/index.d.ts

@@ -0,0 +1,15 @@
+export { DamageFlash, type DamageFlashProps, Vignette, type VignetteProps, CRTOverlay, type CRTOverlayProps, AlertBanner, type AlertBannerProps, WaveBanner, type WaveBannerProps, MuzzleFlash, type MuzzleFlashProps, KillConfirm, type KillConfirmProps, WarningStripes, type WarningStripesProps, ScreenBeam, type ScreenBeamProps, } from './effects.js';
+export { useTriggerEffect, useAlerts, type AlertState, useWaveBanner, type BannerState, useKillConfirm, type KillState, useBeamEffect, type BeamState, } from './hooks.js';
+import { DamageFlash, Vignette, CRTOverlay, AlertBanner, WaveBanner, MuzzleFlash, KillConfirm, WarningStripes, ScreenBeam } from './effects.js';
+export declare const ScreenFX: {
+    readonly DamageFlash: typeof DamageFlash;
+    readonly Vignette: typeof Vignette;
+    readonly CRTOverlay: typeof CRTOverlay;
+    readonly AlertBanner: typeof AlertBanner;
+    readonly WaveBanner: typeof WaveBanner;
+    readonly MuzzleFlash: typeof MuzzleFlash;
+    readonly KillConfirm: typeof KillConfirm;
+    readonly WarningStripes: typeof WarningStripes;
+    readonly ScreenBeam: typeof ScreenBeam;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fx/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,QAAQ,EACR,KAAK,aAAa,EAClB,UAAU,EACV,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,gBAAgB,EACrB,WAAW,EACX,KAAK,gBAAgB,EACrB,cAAc,EACd,KAAK,mBAAmB,EACxB,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,KAAK,UAAU,EACf,aAAa,EACb,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,SAAS,EACd,aAAa,EACb,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAC"}

package/dist/fx/index.js

@@ -0,0 +1,22 @@
+// ---------------------------------------------------------------------------
+//  @joydle/ui/fx — Screen effects barrel
+//  Exports individual components + ScreenFX namespace + all hooks
+// ---------------------------------------------------------------------------
+export { DamageFlash, Vignette, CRTOverlay, AlertBanner, WaveBanner, MuzzleFlash, KillConfirm, WarningStripes, ScreenBeam, } from './effects.js';
+export { useTriggerEffect, useAlerts, useWaveBanner, useKillConfirm, useBeamEffect, } from './hooks.js';
+// Namespaced import for discoverability:
+//   import { ScreenFX } from '@joydle/ui/fx';
+//   <ScreenFX.DamageFlash active={hit} />
+import { DamageFlash, Vignette, CRTOverlay, AlertBanner, WaveBanner, MuzzleFlash, KillConfirm, WarningStripes, ScreenBeam, } from './effects.js';
+export const ScreenFX = {
+    DamageFlash,
+    Vignette,
+    CRTOverlay,
+    AlertBanner,
+    WaveBanner,
+    MuzzleFlash,
+    KillConfirm,
+    WarningStripes,
+    ScreenBeam,
+};
+//# sourceMappingURL=index.js.map

package/dist/fx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fx/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yCAAyC;AACzC,kEAAkE;AAClE,8EAA8E;AAE9E,OAAO,EACL,WAAW,EAEX,QAAQ,EAER,UAAU,EAEV,WAAW,EAEX,UAAU,EAEV,WAAW,EAEX,WAAW,EAEX,cAAc,EAEd,UAAU,GAEX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,SAAS,EAET,aAAa,EAEb,cAAc,EAEd,aAAa,GAEd,MAAM,YAAY,CAAC;AAEpB,yCAAyC;AACzC,8CAA8C;AAC9C,0CAA0C;AAC1C,OAAO,EACL,WAAW,EACX,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW;IACX,QAAQ;IACR,UAAU;IACV,WAAW;IACX,UAAU;IACV,WAAW;IACX,WAAW;IACX,cAAc;IACd,UAAU;CACF,CAAC"}

package/dist/hud/BottomHint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BottomHint.d.ts","sourceRoot":"","sources":["../../src/hud/BottomHint.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAclC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAsCrE"}
+{"version":3,"file":"BottomHint.d.ts","sourceRoot":"","sources":["../../src/hud/BottomHint.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAKlC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAsCrE"}

package/dist/hud/BottomHint.js

@@ -3,15 +3,7 @@ import { jsx as _jsx } from "preact/jsx-runtime";
 //  @joydle/ui — Bottom hint text with GSAP fade-in on mount
 // ---------------------------------------------------------------------------
 import { useRef, useEffect } from 'preact/hooks';
-// ---- GSAP helper ----------------------------------------------------------
-function getGsap() {
-    try {
-        return globalThis.gsap ?? require('gsap').default;
-    }
-    catch {
-        return null;
-    }
-}
+import { getGsap } from '../deps.js';
 // ---- Styles ---------------------------------------------------------------
 const HINT_STYLE = {
     gridColumn: '1 / -1',

package/dist/hud/BottomHint.js.map

@@ -1 +1 @@
-{"version":3,"file":"BottomHint.js","sourceRoot":"","sources":["../../src/hud/BottomHint.tsx"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIjD,8EAA8E;AAE9E,SAAS,OAAO;IACd,IAAI,CAAC;QACH,OAAQ,UAAkB,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAQD,8EAA8E;AAE9E,MAAM,UAAU,GAAoC;IAClD,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,MAAM;IACf,cAAc,EAAE,QAAQ;IACxB,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,+CAA+C;IACtD,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,GAAG;IACf,UAAU,EAAE,MAAM;IAClB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAmB;IACtD,MAAM,KAAK,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAM,IAAI,CAAC,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAC5B,EAAE,EACF,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EACrB;YACE,OAAO,EAAE,CAAC;YACV,CAAC,EAAE,CAAC;YACJ,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,YAAY;YAClB,UAAU;gBACR,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;SACF,CACF,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,cAAK,GAAG,EAAE,KAAK,EAAE,KAAK,EAAC,oBAAoB,EAAC,KAAK,EAAE,UAAU,YAC1D,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"BottomHint.js","sourceRoot":"","sources":["../../src/hud/BottomHint.tsx"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQrC,8EAA8E;AAE9E,MAAM,UAAU,GAAoC;IAClD,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,MAAM;IACf,cAAc,EAAE,QAAQ;IACxB,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,+CAA+C;IACtD,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,GAAG;IACf,UAAU,EAAE,MAAM;IAClB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAmB;IACtD,MAAM,KAAK,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAM,IAAI,CAAC,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAC5B,EAAE,EACF,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EACrB;YACE,OAAO,EAAE,CAAC;YACV,CAAC,EAAE,CAAC;YACJ,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,YAAY;YAClB,UAAU;gBACR,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;SACF,CACF,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,cAAK,GAAG,EAAE,KAAK,EAAE,KAAK,EAAC,oBAAoB,EAAC,KAAK,EAAE,UAAU,YAC1D,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}

package/dist/hud/ComboLabel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComboLabel.d.ts","sourceRoot":"","sources":["../../src/hud/ComboLabel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAclC,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,GAAQ,GACT,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAoHtC"}
+{"version":3,"file":"ComboLabel.d.ts","sourceRoot":"","sources":["../../src/hud/ComboLabel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAKlC,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,GAAQ,GACT,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAoHtC"}

package/dist/hud/ComboLabel.js

@@ -3,15 +3,7 @@ import { jsxs as _jsxs } from "preact/jsx-runtime";
 //  @joydle/ui — Combo counter with GSAP scale-in / fade-out
 // ---------------------------------------------------------------------------
 import { useRef, useEffect } from 'preact/hooks';
-// ---- GSAP helper ----------------------------------------------------------
-function getGsap() {
-    try {
-        return globalThis.gsap ?? require('gsap').default;
-    }
-    catch {
-        return null;
-    }
-}
+import { getGsap } from '../deps.js';
 // ---- Component ------------------------------------------------------------
 /**
  * Auto-shows when `combo >= 2` with a GSAP scale entrance.  Auto-hides

package/dist/hud/ComboLabel.js.map

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

package/dist/hud/Crosshair.d.ts

@@ -0,0 +1,28 @@
+import type { JSX } from 'preact';
+export type CrosshairStyle = 'tactical' | 'cross' | 'dot' | 'circle' | 'none';
+export interface CrosshairProps {
+    /** Gap between center and line start, 0-1 scale. Default: 0.18 */
+    spread?: number;
+    /** Briefly flash hit-confirm color. */
+    hit?: boolean;
+    /** Trigger fire recoil animation (scale + rotate). */
+    fire?: boolean;
+    /** Primary color. Default: var(--joydle-primary, #44FF41) */
+    color?: string;
+    /** Hit-confirm flash color. Default: var(--joydle-gold, #ffd700) */
+    hitColor?: string;
+    /** Center dot color. Default: var(--joydle-accent, #FF6A00) */
+    dotColor?: string;
+    /** Reticle style. Default: 'tactical' */
+    style?: CrosshairStyle;
+    /** Overall size in px. Default: 64 */
+    size?: number;
+    /** Line thickness in px. Default: 2 */
+    thickness?: number;
+    /** Show outer ring. Default: true */
+    ring?: boolean;
+    /** Show center dot. Default: true */
+    dot?: boolean;
+}
+export declare function Crosshair({ spread, hit, fire, color, hitColor, dotColor, style: reticleStyle, size, thickness, ring, dot, }: CrosshairProps): JSX.Element;
+//# sourceMappingURL=Crosshair.d.ts.map

package/dist/hud/Crosshair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Crosshair.d.ts","sourceRoot":"","sources":["../../src/hud/Crosshair.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAqClC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAID,wBAAgB,SAAS,CAAC,EACxB,MAAa,EACb,GAAW,EACX,IAAY,EACZ,KAAwC,EACxC,QAAwC,EACxC,QAA0C,EAC1C,KAAK,EAAE,YAAyB,EAChC,IAAS,EACT,SAAa,EACb,IAAW,EACX,GAAU,GACX,EAAE,cAAc,GAAG,GAAG,CAAC,OAAO,CAwL9B"}

package/dist/hud/Crosshair.js

@@ -0,0 +1,93 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+// ---------------------------------------------------------------------------
+//  @joydle/ui — Crosshair: configurable screen-center reticle
+// ---------------------------------------------------------------------------
+import { useEffect, useRef } from 'preact/hooks';
+// ---- CSS injection --------------------------------------------------------
+let styleInjected = false;
+function injectStyle() {
+    if (styleInjected || typeof document === 'undefined')
+        return;
+    styleInjected = true;
+    const s = document.createElement('style');
+    s.textContent = `
+    @keyframes joydle-crs-fire {
+      0%   { transform: translate(-50%, -50%) scale(1)    rotate(0deg); }
+      30%  { transform: translate(-50%, -50%) scale(1.18) rotate(-3deg); }
+      70%  { transform: translate(-50%, -50%) scale(1.12) rotate(2deg); }
+      100% { transform: translate(-50%, -50%) scale(1)    rotate(0deg); }
+    }
+    @keyframes joydle-crs-hit {
+      0%   { filter: drop-shadow(0 0 6px var(--joydle-crs-hit, #ffd700)) brightness(2); }
+      100% { filter: none; }
+    }
+    @keyframes joydle-crs-ring-pulse {
+      0%   { r: 22; opacity: 0.35; }
+      50%  { r: 30; opacity: 0.15; }
+      100% { r: 22; opacity: 0.35; }
+    }
+    .joydle-crs-fire-anim {
+      animation: joydle-crs-fire 0.15s ease forwards;
+    }
+    .joydle-crs-hit-anim {
+      animation: joydle-crs-hit 0.18s ease forwards;
+    }
+  `;
+    document.head.appendChild(s);
+}
+// ---- Component ------------------------------------------------------------
+export function Crosshair({ spread = 0.18, hit = false, fire = false, color = 'var(--joydle-primary, #44FF41)', hitColor = 'var(--joydle-gold, #ffd700)', dotColor = 'var(--joydle-accent, #FF6A00)', style: reticleStyle = 'tactical', size = 64, thickness = 2, ring = true, dot = true, }) {
+    injectStyle();
+    const containerRef = useRef(null);
+    const prevHit = useRef(false);
+    const prevFire = useRef(false);
+    // Fire animation
+    useEffect(() => {
+        if (!fire || prevFire.current === fire)
+            return;
+        prevFire.current = fire;
+        const el = containerRef.current;
+        if (!el)
+            return;
+        el.classList.remove('joydle-crs-fire-anim');
+        void el.offsetWidth; // reflow
+        el.classList.add('joydle-crs-fire-anim');
+        const t = setTimeout(() => el.classList.remove('joydle-crs-fire-anim'), 160);
+        return () => clearTimeout(t);
+    }, [fire]);
+    // Hit flash
+    useEffect(() => {
+        if (!hit || prevHit.current === hit)
+            return;
+        prevHit.current = hit;
+        const el = containerRef.current;
+        if (!el)
+            return;
+        el.style.setProperty('--joydle-crs-hit', hitColor);
+        el.classList.remove('joydle-crs-hit-anim');
+        void el.offsetWidth;
+        el.classList.add('joydle-crs-hit-anim');
+        const t = setTimeout(() => el.classList.remove('joydle-crs-hit-anim'), 200);
+        return () => clearTimeout(t);
+    }, [hit, hitColor]);
+    if (reticleStyle === 'none')
+        return _jsx(_Fragment, {});
+    const half = size / 2;
+    const gap = half * spread;
+    const lineLen = half * 0.35;
+    // Tactical style: corner brackets
+    const bSize = size * 0.22; // bracket arm length
+    const bOff = half * 0.55; // bracket center offset from center
+    const lineColor = hit ? hitColor : color;
+    return (_jsx("div", { ref: containerRef, class: "joydle-crosshair", style: {
+            position: 'fixed',
+            top: '50%',
+            left: '50%',
+            transform: 'translate(-50%, -50%)',
+            zIndex: 15,
+            pointerEvents: 'none',
+            userSelect: 'none',
+            willChange: 'transform',
+        }, children: _jsxs("svg", { width: size, height: size, viewBox: `0 0 ${size} ${size}`, fill: "none", style: { overflow: 'visible' }, children: [_jsxs("defs", { children: [_jsxs("filter", { id: "joydle-crs-glow", x: "-50%", y: "-50%", width: "200%", height: "200%", children: [_jsx("feGaussianBlur", { stdDeviation: "1.5", result: "blur" }), _jsxs("feMerge", { children: [_jsx("feMergeNode", { in: "blur" }), _jsx("feMergeNode", { in: "SourceGraphic" })] })] }), _jsxs("filter", { id: "joydle-crs-glow-strong", x: "-80%", y: "-80%", width: "260%", height: "260%", children: [_jsx("feGaussianBlur", { stdDeviation: "3", result: "blur" }), _jsxs("feMerge", { children: [_jsx("feMergeNode", { in: "blur" }), _jsx("feMergeNode", { in: "SourceGraphic" })] })] })] }), _jsxs("g", { filter: "url(#joydle-crs-glow)", children: [reticleStyle === 'tactical' && (_jsxs(_Fragment, { children: [_jsx("line", { x1: half, y1: half - gap - lineLen, x2: half, y2: half - gap, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "square" }), _jsx("line", { x1: half, y1: half + gap, x2: half, y2: half + gap + lineLen, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "square" }), _jsx("line", { x1: half - gap - lineLen, y1: half, x2: half - gap, y2: half, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "square" }), _jsx("line", { x1: half + gap, y1: half, x2: half + gap + lineLen, y2: half, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "square" }), _jsx("polyline", { points: `${half - bOff},${half - bOff + bSize} ${half - bOff},${half - bOff} ${half - bOff + bSize},${half - bOff}`, stroke: lineColor, strokeWidth: thickness * 0.7, fill: "none", opacity: "0.5", strokeLinecap: "square" }), _jsx("polyline", { points: `${half + bOff - bSize},${half - bOff} ${half + bOff},${half - bOff} ${half + bOff},${half - bOff + bSize}`, stroke: lineColor, strokeWidth: thickness * 0.7, fill: "none", opacity: "0.5", strokeLinecap: "square" }), _jsx("polyline", { points: `${half - bOff},${half + bOff - bSize} ${half - bOff},${half + bOff} ${half - bOff + bSize},${half + bOff}`, stroke: lineColor, strokeWidth: thickness * 0.7, fill: "none", opacity: "0.5", strokeLinecap: "square" }), _jsx("polyline", { points: `${half + bOff - bSize},${half + bOff} ${half + bOff},${half + bOff} ${half + bOff},${half + bOff - bSize}`, stroke: lineColor, strokeWidth: thickness * 0.7, fill: "none", opacity: "0.5", strokeLinecap: "square" })] })), reticleStyle === 'cross' && (_jsxs(_Fragment, { children: [_jsx("line", { x1: half, y1: half - gap - lineLen, x2: half, y2: half - gap, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "round" }), _jsx("line", { x1: half, y1: half + gap, x2: half, y2: half + gap + lineLen, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "round" }), _jsx("line", { x1: half - gap - lineLen, y1: half, x2: half - gap, y2: half, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "round" }), _jsx("line", { x1: half + gap, y1: half, x2: half + gap + lineLen, y2: half, stroke: lineColor, strokeWidth: thickness, strokeLinecap: "round" })] })), reticleStyle === 'circle' && (_jsx("circle", { cx: half, cy: half, r: half - thickness * 2, stroke: lineColor, strokeWidth: thickness, fill: "none" }))] }), ring && reticleStyle !== 'dot' && (_jsx("circle", { cx: half, cy: half, r: half * 0.72, stroke: lineColor, strokeWidth: 0.75, fill: "none", opacity: 0.2, strokeDasharray: "3 5" })), dot && reticleStyle !== 'dot' && (_jsx("g", { filter: "url(#joydle-crs-glow-strong)", children: _jsx("circle", { cx: half, cy: half, r: thickness * 1.1, fill: dotColor }) })), reticleStyle === 'dot' && (_jsx("g", { filter: "url(#joydle-crs-glow-strong)", children: _jsx("circle", { cx: half, cy: half, r: thickness + 1.5, fill: lineColor }) }))] }) }));
+}
+//# sourceMappingURL=Crosshair.js.map

package/dist/hud/Crosshair.js.map

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

package/dist/hud/EntityLabel.d.ts

@@ -0,0 +1,46 @@
+import type { JSX } from 'preact';
+export interface EntityLabelEntity {
+    /** Screen-space X position (pixels from left). */
+    x: number;
+    /** Screen-space Y position (pixels from top). */
+    y: number;
+    /** Optional name label shown above the bar. */
+    label?: string;
+    /** Current HP (0–maxHp). */
+    hp: number;
+    /** Max HP. Default: 100 */
+    maxHp?: number;
+    /** Bar fill color. Default: barColor prop */
+    color?: string;
+    /** Unique key for reconciliation. */
+    id?: string | number;
+}
+export interface EntityLabelProps {
+    entities: EntityLabelEntity[];
+    /** Default bar fill color. Default: var(--joydle-danger, #ff4444) */
+    barColor?: string;
+    /** Label text color. Default: rgba(255,255,255,0.7) */
+    labelColor?: string;
+    /** Bar width in px. Default: 48 */
+    barWidth?: number;
+    /** Bar height in px. Default: 4 */
+    barHeight?: number;
+    /** Vertical offset above the given y position. Default: 16 */
+    yOffset?: number;
+}
+/**
+ * Renders HP bars and labels at arbitrary screen-space positions.
+ * Use your game engine's world-to-screen projection to get x/y,
+ * then pass entities to this component.
+ *
+ * ```tsx
+ * <EntityLabel
+ *   entities={enemies.map(e => ({
+ *     id: e.id, x: e.screenX, y: e.screenY,
+ *     label: e.name, hp: e.hp, maxHp: e.maxHp,
+ *   }))}
+ * />
+ * ```
+ */
+export declare function EntityLabel({ entities, barColor, labelColor, barWidth, barHeight, yOffset, }: EntityLabelProps): JSX.Element;
+//# sourceMappingURL=EntityLabel.d.ts.map

package/dist/hud/EntityLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLabel.d.ts","sourceRoot":"","sources":["../../src/hud/EntityLabel.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIlC,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAC;IACV,iDAAiD;IACjD,CAAC,EAAE,MAAM,CAAC;IACV,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAA0C,EAC1C,UAAoC,EACpC,QAAa,EACb,SAAa,EACb,OAAY,GACb,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAsEhC"}

package/dist/hud/EntityLabel.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+// ---- Component ------------------------------------------------------------
+/**
+ * Renders HP bars and labels at arbitrary screen-space positions.
+ * Use your game engine's world-to-screen projection to get x/y,
+ * then pass entities to this component.
+ *
+ * ```tsx
+ * <EntityLabel
+ *   entities={enemies.map(e => ({
+ *     id: e.id, x: e.screenX, y: e.screenY,
+ *     label: e.name, hp: e.hp, maxHp: e.maxHp,
+ *   }))}
+ * />
+ * ```
+ */
+export function EntityLabel({ entities, barColor = 'var(--joydle-danger, #ff4444)', labelColor = 'rgba(255,255,255,0.7)', barWidth = 48, barHeight = 4, yOffset = 16, }) {
+    return (_jsx("div", { class: "joydle-entity-labels", style: {
+            position: 'absolute',
+            inset: 0,
+            pointerEvents: 'none',
+            overflow: 'hidden',
+            zIndex: 12,
+        }, children: entities.map((e, i) => {
+            const max = e.maxHp ?? 100;
+            const pct = Math.max(0, Math.min(1, e.hp / max)) * 100;
+            const fill = e.color ?? barColor;
+            const key = e.id ?? i;
+            return (_jsxs("div", { style: {
+                    position: 'absolute',
+                    left: e.x,
+                    top: e.y - yOffset,
+                    transform: 'translate(-50%, -100%)',
+                    display: 'flex',
+                    flexDirection: 'column',
+                    alignItems: 'center',
+                    gap: 2,
+                }, children: [e.label && (_jsx("span", { style: {
+                            fontSize: '0.6rem',
+                            letterSpacing: '0.04em',
+                            color: labelColor,
+                            whiteSpace: 'nowrap',
+                            textShadow: '0 1px 3px rgba(0,0,0,0.8)',
+                        }, children: e.label })), _jsx("div", { style: {
+                            width: barWidth,
+                            height: barHeight,
+                            background: 'rgba(0,0,0,0.5)',
+                            borderRadius: barHeight,
+                            overflow: 'hidden',
+                        }, children: _jsx("div", { style: {
+                                width: `${pct}%`,
+                                height: '100%',
+                                background: fill,
+                                borderRadius: barHeight,
+                                transition: 'width 0.1s ease',
+                            } }) })] }, key));
+        }) }));
+}
+//# sourceMappingURL=EntityLabel.js.map

package/dist/hud/EntityLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLabel.js","sourceRoot":"","sources":["../../src/hud/EntityLabel.tsx"],"names":[],"mappings":";AAuCA,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,GAAG,+BAA+B,EAC1C,UAAU,GAAG,uBAAuB,EACpC,QAAQ,GAAG,EAAE,EACb,SAAS,GAAG,CAAC,EACb,OAAO,GAAG,EAAE,GACK;IACjB,OAAO,CACL,cACE,KAAK,EAAC,sBAAsB,EAC5B,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,CAAC;YACR,aAAa,EAAE,MAAM;YACrB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,EAAE;SACX,YAEA,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;YACvD,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC;YACjC,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAEtB,OAAO,CACL,eAEE,KAAK,EAAE;oBACL,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,CAAC,CAAC,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO;oBAClB,SAAS,EAAE,wBAAwB;oBACnC,OAAO,EAAE,MAAM;oBACf,aAAa,EAAE,QAAQ;oBACvB,UAAU,EAAE,QAAQ;oBACpB,GAAG,EAAE,CAAC;iBACP,aAEA,CAAC,CAAC,KAAK,IAAI,CACV,eACE,KAAK,EAAE;4BACL,QAAQ,EAAE,QAAQ;4BAClB,aAAa,EAAE,QAAQ;4BACvB,KAAK,EAAE,UAAU;4BACjB,UAAU,EAAE,QAAQ;4BACpB,UAAU,EAAE,2BAA2B;yBACxC,YAEA,CAAC,CAAC,KAAK,GACH,CACR,EAED,cACE,KAAK,EAAE;4BACL,KAAK,EAAE,QAAQ;4BACf,MAAM,EAAE,SAAS;4BACjB,UAAU,EAAE,iBAAiB;4BAC7B,YAAY,EAAE,SAAS;4BACvB,QAAQ,EAAE,QAAQ;yBACnB,YAED,cACE,KAAK,EAAE;gCACL,KAAK,EAAE,GAAG,GAAG,GAAG;gCAChB,MAAM,EAAE,MAAM;gCACd,UAAU,EAAE,IAAI;gCAChB,YAAY,EAAE,SAAS;gCACvB,UAAU,EAAE,iBAAiB;6BAC9B,GACD,GACE,KA5CD,GAAG,CA6CJ,CACP,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}