@evixcard/evx-ui-kit 1.11.9 → 1.11.10

package/dist/components/EvResponsiveHeader/types.d.ts

@@ -0,0 +1,121 @@
+export type EvHeaderVisibilityMode = 'persistent' | 'transient' | 'scroll-aware';
+export type EvHeaderPosition = 'sticky' | 'fixed' | 'static';
+export type EvHeaderGlowMode = 'off' | 'timed' | 'persistent';
+/** Controls the translucent backdrop-filter layer behind the header. */
+export type EvHeaderBlurMode = 'off' | 'on-scroll' | 'always';
+/**
+ * Controls which responsive navigation renders an item.
+ * `hidden` is useful for feature flags without rebuilding item arrays.
+ */
+export type EvHeaderItemVisibility = 'all' | 'desktop' | 'mobile' | 'hidden';
+export type EvHeaderVisibilitySettings = {
+    mode: 'persistent';
+    durationMs?: never;
+    topThresholdPx?: never;
+    directionThresholdPx?: never;
+} | {
+    mode: 'transient';
+    durationMs?: number;
+    topThresholdPx?: never;
+    directionThresholdPx?: never;
+} | {
+    mode: 'scroll-aware';
+    durationMs?: never;
+    topThresholdPx?: number;
+    directionThresholdPx?: number;
+};
+export type EvHeaderGlowSettings = {
+    mode: 'off';
+    durationMs?: never;
+} | {
+    mode: 'persistent';
+    durationMs?: never;
+} | {
+    mode: 'timed';
+    durationMs?: number;
+};
+/**
+ * Canonical behavior contract for EvResponsiveHeader.
+ *
+ * Every field is optional and falls back to EV_RESPONSIVE_HEADER_DEFAULTS.
+ * Application content (labels, routes, authentication, locale and actions)
+ * intentionally stays outside this object.
+ */
+export interface EvResponsiveHeaderSettings {
+    layout?: {
+        /** Minimum width at which desktop layout may render; real content must also fit. */
+        desktopFromPx?: number;
+        position?: EvHeaderPosition;
+        contentMaxWidth?: string;
+    };
+    visibility?: EvHeaderVisibilitySettings;
+    effects?: {
+        /** Set to `off` to remove the translucent blur backing. */
+        blur?: EvHeaderBlurMode;
+        glow?: EvHeaderGlowSettings;
+    };
+    drawer?: {
+        /** Panel and scrim transition duration. Reduced motion always resolves to 0. */
+        transitionDurationMs?: number;
+    };
+}
+export interface EvResponsiveHeaderResolvedSettings {
+    layout: {
+        desktopFromPx: number;
+        position: EvHeaderPosition;
+        contentMaxWidth: string;
+    };
+    visibility: {
+        mode: EvHeaderVisibilityMode;
+        transientDurationMs: number;
+        topThresholdPx: number;
+        directionThresholdPx: number;
+    };
+    effects: {
+        blur: EvHeaderBlurMode;
+        glow: {
+            mode: EvHeaderGlowMode;
+            durationMs: number;
+        };
+    };
+    drawer: {
+        transitionDurationMs: number;
+    };
+}
+export interface EvResponsiveHeaderItem {
+    /** Stable application-owned identifier used by navigation/action handlers. */
+    id: string;
+    /** Already-localized visible label. */
+    label: string;
+    /** Optional native-link fallback. Router applications can override the item slots. */
+    href?: string;
+    active?: boolean;
+    disabled?: boolean;
+    external?: boolean;
+    /** Items without an href are rendered as action buttons. */
+    kind?: 'link' | 'action';
+    /** Defaults to `all`. Primary items support every value; secondary items are mobile-only. */
+    visibleOn?: EvHeaderItemVisibility;
+}
+/**
+ * Secondary navigation is intentionally a mobile-drawer group.
+ * Desktop-only items belong in primaryItems, where the layout contract is explicit.
+ */
+export type EvResponsiveHeaderSecondaryItem = Omit<EvResponsiveHeaderItem, 'visibleOn'> & {
+    visibleOn?: Exclude<EvHeaderItemVisibility, 'desktop'>;
+};
+export interface EvResponsiveHeaderClasses {
+    root?: string;
+    bar?: string;
+    desktopNavigation?: string;
+    desktopActions?: string;
+    mobileTrigger?: string;
+    scrim?: string;
+    panel?: string;
+    drawerHeader?: string;
+    drawerIdentity?: string;
+    mobileNavigation?: string;
+    mobileSecondaryNavigation?: string;
+    mobileItem?: string;
+    mobileFooter?: string;
+}

package/dist/components/EvResponsiveHeader/useEvHeaderVisibility.d.ts

@@ -0,0 +1,17 @@
+import { MaybeRefOrGetter, WatchSource } from 'vue';
+export interface EvHeaderVisibilityOptions {
+    enabled?: MaybeRefOrGetter<boolean>;
+    topThreshold?: MaybeRefOrGetter<number>;
+    directionThreshold?: MaybeRefOrGetter<number>;
+    restorationIdleMs?: MaybeRefOrGetter<number>;
+}
+/**
+ * Scroll-aware visibility with explicit user-intent detection. Browser/router
+ * scroll restoration is synchronized without hiding the header; wheel, touch,
+ * and scroll-key intent immediately restores normal direction handling.
+ */
+export declare function useEvHeaderVisibility(resetOn: WatchSource<unknown>, options?: EvHeaderVisibilityOptions): {
+    isHeaderVisible: import('vue').Ref<boolean, boolean>;
+    isScrolled: import('vue').Ref<boolean, boolean>;
+    revealHeader: () => void;
+};

package/dist/components/EvResponsiveHeader/useEvHeaderVisibility.spec.d.ts

@@ -0,0 +1 @@
+export {};