@agg-build/ui 1.0.0

package/dist/types/primitives/card/card.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const CARD_BASE_CLASS_NAME = "group/agg-card relative flex w-full flex-col font-agg-sans rounded-[calc(var(--agg-radius-xl)-1px)] bg-agg-secondary text-agg-foreground shadow-agg-card";
+export declare const CARD_HOVER_TRANSITION_CLASS_NAME = "transition-shadow hover:shadow-agg-card-hover duration-300 ease-in-out";
+export declare const CARD_GRADIENT_WRAPPER_CLASS_NAME = "group/agg-card-gradient rounded-agg-xl p-[1px] relative bg-agg-separator";
+export declare const CARD_GRADIENT_OVERLAY_CLASS_NAME = "absolute inset-0 rounded-agg-xl bg-gradient-to-b from-agg-separator to-agg-primary opacity-0 group-hover/agg-card-gradient:opacity-100 transition-opacity duration-200 ease-in-out pointer-events-none";

package/dist/types/primitives/card/card.types.d.mts

@@ -0,0 +1,8 @@
+export type CardProps = React.HTMLAttributes<HTMLDivElement> & {
+    /** Called when the card is clicked. */
+    onClick?: (e?: React.MouseEvent) => void;
+    /** When provided, the card renders as an `<a>` element, enabling native browser link behaviors. */
+    href?: string;
+    /** Whether to render the card without the gradient wrapper. */
+    withGradient?: boolean;
+};

package/dist/types/primitives/card/card.types.d.ts

@@ -0,0 +1,8 @@
+export type CardProps = React.HTMLAttributes<HTMLDivElement> & {
+    /** Called when the card is clicked. */
+    onClick?: (e?: React.MouseEvent) => void;
+    /** When provided, the card renders as an `<a>` element, enabling native browser link behaviors. */
+    href?: string;
+    /** Whether to render the card without the gradient wrapper. */
+    withGradient?: boolean;
+};

package/dist/types/primitives/card/card.utils.d.mts

@@ -0,0 +1,8 @@
+/** Utility helpers for composing card container styles from interaction and motion settings. */
+export declare const getCardClassName: ({ className, enableAnimations, hasOnClick, hasHref, withGradient, }: {
+    className?: string;
+    enableAnimations: boolean;
+    hasOnClick: boolean;
+    hasHref?: boolean;
+    withGradient?: boolean;
+}) => string;

package/dist/types/primitives/card/card.utils.d.ts

@@ -0,0 +1,8 @@
+/** Utility helpers for composing card container styles from interaction and motion settings. */
+export declare const getCardClassName: ({ className, enableAnimations, hasOnClick, hasHref, withGradient, }: {
+    className?: string;
+    enableAnimations: boolean;
+    hasOnClick: boolean;
+    hasHref?: boolean;
+    withGradient?: boolean;
+}) => string;

package/dist/types/primitives/card/index.d.mts

@@ -0,0 +1,6 @@
+import type { CardProps } from "./card.types";
+/** Renders a shared card container with AGG visual styling and optional click affordance. */
+export declare const Card: {
+    ({ className, onClick, href, withGradient, ...props }: CardProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/card/index.d.ts

@@ -0,0 +1,6 @@
+import type { CardProps } from "./card.types";
+/** Renders a shared card container with AGG visual styling and optional click affordance. */
+export declare const Card: {
+    ({ className, onClick, href, withGradient, ...props }: CardProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/chart/chart-type-switch.constants.d.mts

@@ -0,0 +1,2 @@
+import type { LineChartType } from "./chart.types";
+export declare const CHART_TYPE_SWITCH_OPTION_KEYS: LineChartType[];

package/dist/types/primitives/chart/chart-type-switch.constants.d.ts

@@ -0,0 +1,2 @@
+import type { LineChartType } from "./chart.types";
+export declare const CHART_TYPE_SWITCH_OPTION_KEYS: LineChartType[];

package/dist/types/primitives/chart/chart-type-switch.d.mts

@@ -0,0 +1,7 @@
+import type { ChartTypeSwitchProps } from "./chart-type-switch.types";
+export type { ChartTypeSwitchProps } from "./chart-type-switch.types";
+/** Renders a compact toggle between line and candlestick chart visualizations. */
+export declare const ChartTypeSwitch: {
+    ({ value, onValueChange, className, }: ChartTypeSwitchProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/chart/chart-type-switch.d.ts

@@ -0,0 +1,7 @@
+import type { ChartTypeSwitchProps } from "./chart-type-switch.types";
+export type { ChartTypeSwitchProps } from "./chart-type-switch.types";
+/** Renders a compact toggle between line and candlestick chart visualizations. */
+export declare const ChartTypeSwitch: {
+    ({ value, onValueChange, className, }: ChartTypeSwitchProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/chart/chart-type-switch.types.d.mts

@@ -0,0 +1,9 @@
+import type { LineChartType } from "./chart.types";
+export type ChartTypeSwitchProps = {
+    /** Currently selected chart presentation mode. */
+    value: LineChartType;
+    /** Called when the chart presentation mode changes. */
+    onValueChange: (value: LineChartType) => void;
+    /** Custom class name applied to the switch root. */
+    className?: string;
+};

package/dist/types/primitives/chart/chart-type-switch.types.d.ts

@@ -0,0 +1,9 @@
+import type { LineChartType } from "./chart.types";
+export type ChartTypeSwitchProps = {
+    /** Currently selected chart presentation mode. */
+    value: LineChartType;
+    /** Called when the chart presentation mode changes. */
+    onValueChange: (value: LineChartType) => void;
+    /** Custom class name applied to the switch root. */
+    className?: string;
+};

package/dist/types/primitives/chart/chart-type-switch.utils.d.mts

@@ -0,0 +1,13 @@
+import type { LineChartType } from "./chart.types";
+/** Utility helpers for chart-type switch keyboard navigation. */
+export declare const resolveNextChartTypeIndex: ({ currentIndex, direction, optionsLength, }: {
+    currentIndex: number;
+    direction: 1 | -1;
+    optionsLength: number;
+}) => number;
+export declare const resolveChartTypeOptionAriaLabel: ({ chartType, candlestickLabel, lineLabel, }: {
+    chartType: LineChartType;
+    candlestickLabel: string;
+    lineLabel: string;
+}) => string;
+export declare const resolveChartTypeOptionIconName: (chartType: LineChartType) => "chart-line" | "chart-candlestick";

package/dist/types/primitives/chart/chart-type-switch.utils.d.ts

@@ -0,0 +1,13 @@
+import type { LineChartType } from "./chart.types";
+/** Utility helpers for chart-type switch keyboard navigation. */
+export declare const resolveNextChartTypeIndex: ({ currentIndex, direction, optionsLength, }: {
+    currentIndex: number;
+    direction: 1 | -1;
+    optionsLength: number;
+}) => number;
+export declare const resolveChartTypeOptionAriaLabel: ({ chartType, candlestickLabel, lineLabel, }: {
+    chartType: LineChartType;
+    candlestickLabel: string;
+    lineLabel: string;
+}) => string;
+export declare const resolveChartTypeOptionIconName: (chartType: LineChartType) => "chart-line" | "chart-candlestick";

package/dist/types/primitives/chart/chart.constants.d.mts

@@ -0,0 +1,5 @@
+import type { LineChartType } from "./chart.types";
+export declare const LINE_CHART_DEFAULT_HEIGHT = 280;
+export declare const LINE_CHART_DEFAULT_TYPE: LineChartType;
+export declare const LINE_CHART_DEFAULT_SHOW_SERIES_CONTROLS = true;
+export declare const LINE_CHART_DEFAULT_WINDOW_THRESHOLD = 1.05;

package/dist/types/primitives/chart/chart.constants.d.ts

@@ -0,0 +1,5 @@
+import type { LineChartType } from "./chart.types";
+export declare const LINE_CHART_DEFAULT_HEIGHT = 280;
+export declare const LINE_CHART_DEFAULT_TYPE: LineChartType;
+export declare const LINE_CHART_DEFAULT_SHOW_SERIES_CONTROLS = true;
+export declare const LINE_CHART_DEFAULT_WINDOW_THRESHOLD = 1.05;

package/dist/types/primitives/chart/chart.types.d.mts

@@ -0,0 +1,59 @@
+import type { ReactNode } from "react";
+import type { CandlePoint, LivelinePoint } from "liveline";
+export type LineChartPoint = {
+    time: number;
+    value: number;
+    open?: number;
+    high?: number;
+    low?: number;
+    close?: number;
+};
+export type LineChartType = "line" | "candlestick";
+export type LineChartSeries = {
+    id: string;
+    color: string;
+    points: LineChartPoint[];
+    lineWidth?: number;
+    lineStyle?: "solid" | "dotted" | "dashed";
+};
+export type LineChartSeriesControlsRenderProps = {
+    /** Series currently available for toggling in the control UI. */
+    series: LineChartSeries[];
+    /** ID of the series currently marked as active. */
+    activeSeriesId: string;
+    /** Called when the user selects a different series in the controls. */
+    handleSeriesChange: (seriesId: string) => void;
+};
+export type LineChartProps = {
+    /** Series to display on the chart */
+    series: LineChartSeries[];
+    /** Height of the chart */
+    height?: number;
+    /** Width of the chart */
+    width?: number | string;
+    /** Class names for the chart */
+    classNames?: LineChartClassNames;
+    /** Whether the chart is loading */
+    isLoading?: boolean;
+    /** Type of chart to display (line or candlestick) */
+    chartType?: LineChartType;
+    /** Whether to show series controls */
+    showSeriesControls?: boolean;
+    /** Render series controls */
+    renderSeriesControls?: (props: LineChartSeriesControlsRenderProps) => ReactNode;
+    /** Live forming candle (updates in real-time, not yet closed). */
+    liveCandle?: CandlePoint;
+    /** Live line overlay data (e.g., real-time price series). */
+    lineData?: LivelinePoint[];
+    /** Live line overlay current value. */
+    lineValue?: number;
+    /** Whether live effects (momentum, pulse) should be active. Defaults to global enableLiveUpdates. */
+    live?: boolean;
+};
+export type LineChartClassNames = {
+    root?: string;
+    controls?: string;
+    defaultSeriesSwitch?: string;
+    chartViewport?: string;
+    liveline?: string;
+};

package/dist/types/primitives/chart/chart.types.d.ts

@@ -0,0 +1,59 @@
+import type { ReactNode } from "react";
+import type { CandlePoint, LivelinePoint } from "liveline";
+export type LineChartPoint = {
+    time: number;
+    value: number;
+    open?: number;
+    high?: number;
+    low?: number;
+    close?: number;
+};
+export type LineChartType = "line" | "candlestick";
+export type LineChartSeries = {
+    id: string;
+    color: string;
+    points: LineChartPoint[];
+    lineWidth?: number;
+    lineStyle?: "solid" | "dotted" | "dashed";
+};
+export type LineChartSeriesControlsRenderProps = {
+    /** Series currently available for toggling in the control UI. */
+    series: LineChartSeries[];
+    /** ID of the series currently marked as active. */
+    activeSeriesId: string;
+    /** Called when the user selects a different series in the controls. */
+    handleSeriesChange: (seriesId: string) => void;
+};
+export type LineChartProps = {
+    /** Series to display on the chart */
+    series: LineChartSeries[];
+    /** Height of the chart */
+    height?: number;
+    /** Width of the chart */
+    width?: number | string;
+    /** Class names for the chart */
+    classNames?: LineChartClassNames;
+    /** Whether the chart is loading */
+    isLoading?: boolean;
+    /** Type of chart to display (line or candlestick) */
+    chartType?: LineChartType;
+    /** Whether to show series controls */
+    showSeriesControls?: boolean;
+    /** Render series controls */
+    renderSeriesControls?: (props: LineChartSeriesControlsRenderProps) => ReactNode;
+    /** Live forming candle (updates in real-time, not yet closed). */
+    liveCandle?: CandlePoint;
+    /** Live line overlay data (e.g., real-time price series). */
+    lineData?: LivelinePoint[];
+    /** Live line overlay current value. */
+    lineValue?: number;
+    /** Whether live effects (momentum, pulse) should be active. Defaults to global enableLiveUpdates. */
+    live?: boolean;
+};
+export type LineChartClassNames = {
+    root?: string;
+    controls?: string;
+    defaultSeriesSwitch?: string;
+    chartViewport?: string;
+    liveline?: string;
+};

package/dist/types/primitives/chart/chart.utils.d.mts

@@ -0,0 +1,35 @@
+import type { CandlePoint, LivelinePoint } from "liveline";
+import type { LineChartPoint, LineChartSeries } from "./chart.types";
+/** Utility helpers for normalizing and projecting chart series data for Liveline. */
+export declare const normalizeSeries: (series: LineChartSeries[]) => LineChartSeries[];
+export declare const formatDefaultChartValue: (value: number) => string;
+export declare const resolveChartTimeFormatter: (windowSeconds: number) => (timestamp: number) => string;
+export declare const toLivelinePoints: (points: LineChartPoint[]) => LivelinePoint[];
+export declare const toLivelineCandles: (points: LineChartPoint[]) => CandlePoint[];
+/**
+ * Pad a sparse candle array so liveline always sees >= 2 entries.
+ * Liveline treats `effectiveCandles.length < 2` as empty and draws "No data".
+ * When only one candle exists we prepend a duplicate shifted back by one interval.
+ */
+export declare const padSparseCandles: (candles: CandlePoint[], intervalSeconds?: number) => CandlePoint[];
+export declare const resolveCandleWidthSeconds: (points: LineChartPoint[], fallback?: number) => number | undefined;
+export declare const resolveWindowSeconds: (normalizedSeries: LineChartSeries[]) => number;
+/**
+ * Liveline is a real-time chart that anchors its visible window to
+ * `Date.now()`. Historical data that ended well before "now" falls outside
+ * the visible region, causing liveline to draw "No data". Additionally,
+ * liveline's multi-series render path requires `visible.length >= 2` per
+ * series inside the window.
+ *
+ * This helper extends every series so that data reaches up to "now", ensuring
+ * the points always fall inside the liveline visible window. It also guarantees
+ * at least 2 points per series (the minimum liveline requires).
+ *
+ * The returned series should be used for both `data` and `series` props.
+ */
+export declare const extendSeriesToNow: (series: LineChartSeries[]) => LineChartSeries[];
+export declare const resolveLatestValue: (points: LineChartPoint[]) => number;
+export declare const resolveActiveSeriesId: (series: LineChartSeries[], activeSeriesId: string | null) => string;
+export declare const formatDefaultSeriesLabel: (seriesItem: LineChartSeries) => string;
+export declare const resolveSelectedSeries: (series: LineChartSeries[], activeSeriesId: string) => LineChartSeries | undefined;
+export declare const resolvePrimaryLineData: (primarySeries: LineChartSeries | undefined) => LivelinePoint[];

package/dist/types/primitives/chart/chart.utils.d.ts

@@ -0,0 +1,35 @@
+import type { CandlePoint, LivelinePoint } from "liveline";
+import type { LineChartPoint, LineChartSeries } from "./chart.types";
+/** Utility helpers for normalizing and projecting chart series data for Liveline. */
+export declare const normalizeSeries: (series: LineChartSeries[]) => LineChartSeries[];
+export declare const formatDefaultChartValue: (value: number) => string;
+export declare const resolveChartTimeFormatter: (windowSeconds: number) => (timestamp: number) => string;
+export declare const toLivelinePoints: (points: LineChartPoint[]) => LivelinePoint[];
+export declare const toLivelineCandles: (points: LineChartPoint[]) => CandlePoint[];
+/**
+ * Pad a sparse candle array so liveline always sees >= 2 entries.
+ * Liveline treats `effectiveCandles.length < 2` as empty and draws "No data".
+ * When only one candle exists we prepend a duplicate shifted back by one interval.
+ */
+export declare const padSparseCandles: (candles: CandlePoint[], intervalSeconds?: number) => CandlePoint[];
+export declare const resolveCandleWidthSeconds: (points: LineChartPoint[], fallback?: number) => number | undefined;
+export declare const resolveWindowSeconds: (normalizedSeries: LineChartSeries[]) => number;
+/**
+ * Liveline is a real-time chart that anchors its visible window to
+ * `Date.now()`. Historical data that ended well before "now" falls outside
+ * the visible region, causing liveline to draw "No data". Additionally,
+ * liveline's multi-series render path requires `visible.length >= 2` per
+ * series inside the window.
+ *
+ * This helper extends every series so that data reaches up to "now", ensuring
+ * the points always fall inside the liveline visible window. It also guarantees
+ * at least 2 points per series (the minimum liveline requires).
+ *
+ * The returned series should be used for both `data` and `series` props.
+ */
+export declare const extendSeriesToNow: (series: LineChartSeries[]) => LineChartSeries[];
+export declare const resolveLatestValue: (points: LineChartPoint[]) => number;
+export declare const resolveActiveSeriesId: (series: LineChartSeries[], activeSeriesId: string | null) => string;
+export declare const formatDefaultSeriesLabel: (seriesItem: LineChartSeries) => string;
+export declare const resolveSelectedSeries: (series: LineChartSeries[], activeSeriesId: string) => LineChartSeries | undefined;
+export declare const resolvePrimaryLineData: (primarySeries: LineChartSeries | undefined) => LivelinePoint[];

package/dist/types/primitives/chart/index.d.mts

@@ -0,0 +1,7 @@
+import type { LineChartProps } from "./chart.types";
+export type { LineChartClassNames, LineChartPoint, LineChartProps, LineChartSeries, LineChartSeriesControlsRenderProps, LineChartType, } from "./chart.types";
+/** Renders line/candlestick chart data with optional series switching and live updates. */
+export declare const LineChart: {
+    ({ series, height, width, classNames, isLoading, chartType, showSeriesControls, renderSeriesControls, liveCandle: liveForming, lineData, lineValue, live, }: LineChartProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/chart/index.d.ts

@@ -0,0 +1,7 @@
+import type { LineChartProps } from "./chart.types";
+export type { LineChartClassNames, LineChartPoint, LineChartProps, LineChartSeries, LineChartSeriesControlsRenderProps, LineChartType, } from "./chart.types";
+/** Renders line/candlestick chart data with optional series switching and live updates. */
+export declare const LineChart: {
+    ({ series, height, width, classNames, isLoading, chartType, showSeriesControls, renderSeriesControls, liveCandle: liveForming, lineData, lineValue, live, }: LineChartProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/conditional-wrapper.d.mts

@@ -0,0 +1,11 @@
+import type { JSX } from "react";
+interface ConditionalWrapperProps {
+    condition: boolean;
+    wrapper: (children: React.ReactNode) => JSX.Element;
+    children: JSX.Element;
+}
+export declare const ConditionalWrapper: {
+    ({ condition, wrapper, children, }: ConditionalWrapperProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/primitives/conditional-wrapper.d.ts

@@ -0,0 +1,11 @@
+import type { JSX } from "react";
+interface ConditionalWrapperProps {
+    condition: boolean;
+    wrapper: (children: React.ReactNode) => JSX.Element;
+    children: JSX.Element;
+}
+export declare const ConditionalWrapper: {
+    ({ condition, wrapper, children, }: ConditionalWrapperProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/primitives/currency-input/currency-input.constants.d.mts

@@ -0,0 +1,6 @@
+export declare const CURRENCY_INPUT_DEFAULT_PREFIX = "$";
+export declare const CURRENCY_INPUT_DEFAULT_MIN = 0;
+export declare const CURRENCY_INPUT_DEFAULT_DECIMAL_PLACES = 2;
+export declare const CURRENCY_INPUT_DEFAULT_DISABLED = false;
+export declare const CURRENCY_INPUT_DEFAULT_AUTO_FOCUS = false;
+export declare const CURRENCY_INPUT_DEFAULT_IS_INVALID = false;

package/dist/types/primitives/currency-input/currency-input.constants.d.ts

@@ -0,0 +1,6 @@
+export declare const CURRENCY_INPUT_DEFAULT_PREFIX = "$";
+export declare const CURRENCY_INPUT_DEFAULT_MIN = 0;
+export declare const CURRENCY_INPUT_DEFAULT_DECIMAL_PLACES = 2;
+export declare const CURRENCY_INPUT_DEFAULT_DISABLED = false;
+export declare const CURRENCY_INPUT_DEFAULT_AUTO_FOCUS = false;
+export declare const CURRENCY_INPUT_DEFAULT_IS_INVALID = false;

package/dist/types/primitives/currency-input/currency-input.types.d.mts

@@ -0,0 +1,36 @@
+export type CurrencyInputClassNames = {
+    root?: string;
+    input?: string;
+};
+export type CurrencyInputProps = {
+    /** Numeric value (controlled) */
+    value: number;
+    /** Called with the parsed number on every change and on blur */
+    onChange?: (value: number) => void;
+    /** Symbol shown before the number. Defaults to "$" */
+    prefix?: string;
+    /** Lowest allowed value. Defaults to 0 (prevents negatives) */
+    min?: number;
+    /** Highest allowed value */
+    max?: number;
+    /** Maximum decimal places shown. Defaults to 2 */
+    decimalPlaces?: number;
+    /** Whether the input should be non-interactive. */
+    disabled?: boolean;
+    /** Whether the input should receive focus on mount. */
+    autoFocus?: boolean;
+    /** Visual error state */
+    isInvalid?: boolean;
+    /** Class name overrides for the input wrapper and field. */
+    classNames?: CurrencyInputClassNames;
+    /** Accessible label announced for the input. */
+    ariaLabel?: string;
+    /** Called when the input receives focus. */
+    onFocus?: () => void;
+    /** Called when the input loses focus. */
+    onBlur?: () => void;
+};
+export type CurrencyInputFormatParts = {
+    group: string;
+    decimal: string;
+};

package/dist/types/primitives/currency-input/currency-input.types.d.ts

@@ -0,0 +1,36 @@
+export type CurrencyInputClassNames = {
+    root?: string;
+    input?: string;
+};
+export type CurrencyInputProps = {
+    /** Numeric value (controlled) */
+    value: number;
+    /** Called with the parsed number on every change and on blur */
+    onChange?: (value: number) => void;
+    /** Symbol shown before the number. Defaults to "$" */
+    prefix?: string;
+    /** Lowest allowed value. Defaults to 0 (prevents negatives) */
+    min?: number;
+    /** Highest allowed value */
+    max?: number;
+    /** Maximum decimal places shown. Defaults to 2 */
+    decimalPlaces?: number;
+    /** Whether the input should be non-interactive. */
+    disabled?: boolean;
+    /** Whether the input should receive focus on mount. */
+    autoFocus?: boolean;
+    /** Visual error state */
+    isInvalid?: boolean;
+    /** Class name overrides for the input wrapper and field. */
+    classNames?: CurrencyInputClassNames;
+    /** Accessible label announced for the input. */
+    ariaLabel?: string;
+    /** Called when the input receives focus. */
+    onFocus?: () => void;
+    /** Called when the input loses focus. */
+    onBlur?: () => void;
+};
+export type CurrencyInputFormatParts = {
+    group: string;
+    decimal: string;
+};

package/dist/types/primitives/currency-input/currency-input.utils.d.mts

@@ -0,0 +1,10 @@
+import type { CurrencyInputFormatParts } from "./currency-input.types";
+/** Utility helpers for parsing, formatting, and caret math in the currency input field. */
+export declare const resolveCurrencyInputFormatParts: (locale: string) => CurrencyInputFormatParts;
+export declare const parseCurrencyInputDisplay: (display: string, prefix: string, parts: CurrencyInputFormatParts) => string;
+export declare const normalizeCurrencyInputInitialZero: (nextRaw: string, previousRaw: string) => string;
+export declare const formatCurrencyInputRawValue: (raw: string, locale: string, decimalPlaces: number, parts: CurrencyInputFormatParts) => string;
+export declare const clampCurrencyInputValue: (value: number, min: number, max: number | undefined) => number;
+export declare const countDigitsBeforePosition: (value: string, position: number) => number;
+export declare const findPositionAfterDigits: (value: string, digitCount: number) => number;
+export declare const sanitizeCurrencyInputPastedValue: (input: string, parts: CurrencyInputFormatParts, decimalPlaces: number) => string;

package/dist/types/primitives/currency-input/currency-input.utils.d.ts

@@ -0,0 +1,10 @@
+import type { CurrencyInputFormatParts } from "./currency-input.types";
+/** Utility helpers for parsing, formatting, and caret math in the currency input field. */
+export declare const resolveCurrencyInputFormatParts: (locale: string) => CurrencyInputFormatParts;
+export declare const parseCurrencyInputDisplay: (display: string, prefix: string, parts: CurrencyInputFormatParts) => string;
+export declare const normalizeCurrencyInputInitialZero: (nextRaw: string, previousRaw: string) => string;
+export declare const formatCurrencyInputRawValue: (raw: string, locale: string, decimalPlaces: number, parts: CurrencyInputFormatParts) => string;
+export declare const clampCurrencyInputValue: (value: number, min: number, max: number | undefined) => number;
+export declare const countDigitsBeforePosition: (value: string, position: number) => number;
+export declare const findPositionAfterDigits: (value: string, digitCount: number) => number;
+export declare const sanitizeCurrencyInputPastedValue: (input: string, parts: CurrencyInputFormatParts, decimalPlaces: number) => string;

package/dist/types/primitives/currency-input/index.d.mts

@@ -0,0 +1,7 @@
+import type { CurrencyInputProps } from "./currency-input.types";
+export type { CurrencyInputClassNames, CurrencyInputFormatParts, CurrencyInputProps, } from "./currency-input.types";
+/** Renders a controlled currency input with locale-aware formatting, caret preservation, and paste sanitization. */
+export declare const CurrencyInput: {
+    ({ value, onChange, prefix, min, max, decimalPlaces, disabled, autoFocus, isInvalid, classNames, ariaLabel, onFocus, onBlur, }: CurrencyInputProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/currency-input/index.d.ts

@@ -0,0 +1,7 @@
+import type { CurrencyInputProps } from "./currency-input.types";
+export type { CurrencyInputClassNames, CurrencyInputFormatParts, CurrencyInputProps, } from "./currency-input.types";
+/** Renders a controlled currency input with locale-aware formatting, caret preservation, and paste sanitization. */
+export declare const CurrencyInput: {
+    ({ value, onChange, prefix, min, max, decimalPlaces, disabled, autoFocus, isInvalid, classNames, ariaLabel, onFocus, onBlur, }: CurrencyInputProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/error-boundary/index.d.mts

@@ -0,0 +1,24 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+export interface AggErrorBoundaryProps {
+    children: ReactNode;
+    /** Custom fallback UI to render when an error is caught. */
+    fallback?: ReactNode;
+    /** Called when the boundary catches an error. */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /** Called when the user clicks the retry button. Resets the boundary and re-renders children. */
+    onRetry?: () => void;
+    className?: string;
+}
+interface AggErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+export declare class AggErrorBoundary extends Component<AggErrorBoundaryProps, AggErrorBoundaryState> {
+    static displayName: string;
+    constructor(props: AggErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): AggErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    private handleRetry;
+    render(): ReactNode;
+}
+export {};

package/dist/types/primitives/error-boundary/index.d.ts

@@ -0,0 +1,24 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+export interface AggErrorBoundaryProps {
+    children: ReactNode;
+    /** Custom fallback UI to render when an error is caught. */
+    fallback?: ReactNode;
+    /** Called when the boundary catches an error. */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /** Called when the user clicks the retry button. Resets the boundary and re-renders children. */
+    onRetry?: () => void;
+    className?: string;
+}
+interface AggErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+export declare class AggErrorBoundary extends Component<AggErrorBoundaryProps, AggErrorBoundaryState> {
+    static displayName: string;
+    constructor(props: AggErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): AggErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    private handleRetry;
+    render(): ReactNode;
+}
+export {};

package/dist/types/primitives/footer/agg-build-logo.d.mts

@@ -0,0 +1,16 @@
+import type { SVGProps } from "react";
+/** 16×16 orange flame icon used in the desktop footer left section. */
+export declare const AggBuildIcon: {
+    (props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Full 72×14 "agg build" combined wordmark — icon + text. Used on mobile. */
+export declare const AggBuildLogo: {
+    (props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** "agg build" text-only wordmark for the desktop footer (native 61×13 design asset). */
+export declare const AggBuildTextLogo: {
+    (props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/footer/agg-build-logo.d.ts

@@ -0,0 +1,16 @@
+import type { SVGProps } from "react";
+/** 16×16 orange flame icon used in the desktop footer left section. */
+export declare const AggBuildIcon: {
+    (props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Full 72×14 "agg build" combined wordmark — icon + text. Used on mobile. */
+export declare const AggBuildLogo: {
+    (props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** "agg build" text-only wordmark for the desktop footer (native 61×13 design asset). */
+export declare const AggBuildTextLogo: {
+    (props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/footer/footer.constants.d.mts

@@ -0,0 +1,3 @@
+import type { FooterLink } from "./footer.types";
+export declare const baseFooterClasses = "group/agg-footer fixed bottom-0 left-0 right-0 z-50 w-full border-t border-agg-separator bg-agg-secondary/75 backdrop-blur-sm supports-[backdrop-filter]:bg-agg-secondary/75";
+export declare const DEFAULT_FOOTER_LINKS: FooterLink[];

package/dist/types/primitives/footer/footer.constants.d.ts

@@ -0,0 +1,3 @@
+import type { FooterLink } from "./footer.types";
+export declare const baseFooterClasses = "group/agg-footer fixed bottom-0 left-0 right-0 z-50 w-full border-t border-agg-separator bg-agg-secondary/75 backdrop-blur-sm supports-[backdrop-filter]:bg-agg-secondary/75";
+export declare const DEFAULT_FOOTER_LINKS: FooterLink[];