@evixcard/evx-ui-kit 1.11.9 → 1.12.0

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 {};

package/dist/components/EvixLoader/EvixLoader.spec.d.ts

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

package/dist/components/EvixLoader/EvixLoader.vue.d.ts

@@ -0,0 +1,14 @@
+export type EvixLoaderSize = 24 | 32 | 40 | 48;
+export interface EvixLoaderProps {
+    size?: EvixLoaderSize;
+    label?: string;
+    color?: string;
+    decorative?: boolean;
+}
+declare const _default: import('vue').DefineComponent<EvixLoaderProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<EvixLoaderProps> & Readonly<{}>, {
+    size: EvixLoaderSize;
+    color: string;
+    label: string;
+    decorative: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLSpanElement>;
+export default _default;

package/dist/components/EvixLoader/index.d.ts

@@ -0,0 +1,2 @@
+export { default as EvixLoader } from './EvixLoader.vue';
+export type { EvixLoaderProps, EvixLoaderSize } from './EvixLoader.vue';

package/dist/components/charts/EvxAreaChart.vue.d.ts

@@ -1,10 +1,12 @@
-import { ChartRow } from './useCartesianFrame.ts';
+import { ChartRow, ChartYDomain } from './useCartesianFrame.ts';
 export interface EvxAreaChartProps {
     data: ChartRow[];
     xKey?: string;
     yKeys?: string[];
     seriesLabels?: string[];
     height?: number;
+    /** Explicit y-axis extent. Omit for the default zero-based domain. */
+    yDomain?: ChartYDomain;
 }
 declare const _default: import('vue').DefineComponent<EvxAreaChartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<EvxAreaChartProps> & Readonly<{}>, {
     height: number;

package/dist/components/charts/EvxBarChart.vue.d.ts

@@ -1,10 +1,12 @@
-import { ChartRow } from './useCartesianFrame.ts';
+import { ChartRow, ChartYDomain } from './useCartesianFrame.ts';
 export interface EvxBarChartProps {
     data: ChartRow[];
     xKey?: string;
     yKeys?: string[];
     seriesLabels?: string[];
     height?: number;
+    /** Explicit y-axis extent. Omit for the default zero-based domain. */
+    yDomain?: ChartYDomain;
 }
 declare const _default: import('vue').DefineComponent<EvxBarChartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<EvxBarChartProps> & Readonly<{}>, {
     height: number;

package/dist/components/charts/EvxComposedChart.vue.d.ts

@@ -1,4 +1,4 @@
-import { ChartRow } from './useCartesianFrame.ts';
+import { ChartRow, ChartYDomain } from './useCartesianFrame.ts';
 export interface EvxComposedChartProps {
     data: ChartRow[];
     xKey?: string;
@@ -6,6 +6,8 @@ export interface EvxComposedChartProps {
     lineKeys?: string[];
     seriesLabels?: string[];
     height?: number;
+    /** Explicit y-axis extent. Omit for the default zero-based domain. */
+    yDomain?: ChartYDomain;
 }
 declare const _default: import('vue').DefineComponent<EvxComposedChartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<EvxComposedChartProps> & Readonly<{}>, {
     height: number;

package/dist/components/charts/EvxLineChart.vue.d.ts

@@ -1,10 +1,12 @@
-import { ChartRow } from './useCartesianFrame.ts';
+import { ChartRow, ChartYDomain } from './useCartesianFrame.ts';
 export interface EvxLineChartProps {
     data: ChartRow[];
     xKey?: string;
     yKeys?: string[];
     seriesLabels?: string[];
     height?: number;
+    /** Explicit y-axis extent. Omit for the default zero-based domain. */
+    yDomain?: ChartYDomain;
 }
 declare const _default: import('vue').DefineComponent<EvxLineChartProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<EvxLineChartProps> & Readonly<{}>, {
     height: number;

package/dist/components/charts/index.d.ts

@@ -5,4 +5,4 @@ export { default as EvxPieChart, type EvxPieChartProps } from './EvxPieChart.vue
 export { default as EvxRadarChart, type EvxRadarChartProps } from './EvxRadarChart.vue';
 export { default as EvxRadialChart, type EvxRadialChartProps } from './EvxRadialChart.vue';
 export { default as EvxComposedChart, type EvxComposedChartProps } from './EvxComposedChart.vue';
-export type { ChartRow } from './useCartesianFrame.ts';
+export type { ChartRow, ChartYDomain } from './useCartesianFrame.ts';

package/dist/components/charts/useCartesianFrame.d.ts

@@ -1,5 +1,7 @@
 import { Ref } from 'vue';
 export type ChartRow = Record<string, number | string>;
+/** Explicit y-axis extent, e.g. [90, 100] to zoom into a narrow band. */
+export type ChartYDomain = [number, number];
 interface FrameOptions {
     wrapperRef: Ref<HTMLElement | null>;
     data: () => ChartRow[];
@@ -8,6 +10,7 @@ interface FrameOptions {
     height: () => number;
     mode?: 'point' | 'band';
     bandPadding?: number;
+    yDomain?: () => ChartYDomain | undefined;
 }
 export declare const CHART_MARGIN: {
     top: number;
@@ -29,7 +32,10 @@ export declare function useCartesianFrame(opts: FrameOptions): {
     xPoint: import('vue').ComputedRef<import('d3-scale').ScalePoint<string>>;
     xBand: import('vue').ComputedRef<import('d3-scale').ScaleBand<string>>;
     y: import('vue').ComputedRef<import('d3-scale').ScaleLinear<number, number, never>>;
+    yDomain: import('vue').ComputedRef<ChartYDomain>;
     yTicks: import('vue').ComputedRef<number[]>;
+    xTickIndices: import('vue').ComputedRef<number[]>;
+    xTickAnchor: (index: number) => "start" | "middle" | "end";
     maxY: import('vue').ComputedRef<number>;
     hoverIndex: Ref<number | null, number | null>;
     onMove: (e: MouseEvent) => void;

package/dist/components/charts/useCartesianFrame.spec.d.ts

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