tyrell-components 1.0.0-RC6

package/lib/utils/mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.d.ts","sourceRoot":"","sources":["../../src/utils/mobile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,GAAE,MAA0B,GAAG,OAAO,CAE7E"}

package/lib/utils/mobile.js

@@ -0,0 +1,21 @@
+/**
+ * Mobile detection utility
+ *
+ * Uses CSS media query via matchMedia for reliable detection:
+ * - `pointer: coarse` identifies touch-primary devices (not laptops with touchscreens)
+ * - Breakpoint is evaluated by the browser, always in sync with CSS
+ * - Called on each use (not cached), so it responds to viewport changes and rotation
+ */
+/**
+ * Default mobile breakpoint (px).
+ * Matches phones in portrait and most phones in landscape.
+ */
+const MOBILE_BREAKPOINT = 768;
+/**
+ * Detect mobile touch devices.
+ * Returns true when the primary pointer is coarse (touch) AND viewport is narrow.
+ */
+export function isMobileTouch(breakpoint = MOBILE_BREAKPOINT) {
+    return window.matchMedia(`(pointer: coarse) and (max-width: ${breakpoint}px)`).matches;
+}
+//# sourceMappingURL=mobile.js.map

package/lib/utils/mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.js","sourceRoot":"","sources":["../../src/utils/mobile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB,iBAAiB;IAClE,OAAO,MAAM,CAAC,UAAU,CAAC,qCAAqC,UAAU,KAAK,CAAC,CAAC,OAAO,CAAC;AACzF,CAAC"}

package/lib/utils/number-format.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Number Formatting Utilities
+ * PORTED FROM: clj/ty/i18n/number.cljs
+ *
+ * Uses native Intl.NumberFormat for locale-aware number formatting
+ * Supports currency, percent, compact notation, and custom precision
+ */
+export type NumberFormatType = 'number' | 'currency' | 'percent' | 'compact';
+export interface FormatConfig {
+    type: NumberFormatType;
+    locale?: string;
+    currency?: string;
+    precision?: number;
+}
+/**
+ * Format a number based on configuration
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234.56, { type: 'currency', currency: 'USD', locale: 'en-US' })
+ * // Returns: "$1,234.56"
+ *
+ * formatNumber(0.15, { type: 'percent', precision: 2 })
+ * // Returns: "15.00%"
+ *
+ * formatNumber(1234567, { type: 'compact' })
+ * // Returns: "1.2M"
+ * ```
+ */
+export declare function formatNumber(value: number, config: FormatConfig): string;
+/**
+ * Parse a numeric string to a number
+ *
+ * Simple rule: the last occurring . or , is the decimal separator.
+ * Everything else is stripped. This works for both US (1,234.56) and
+ * European (1.234,56) input, and for mobile keyboards that use , as decimal.
+ *
+ * @example
+ * ```typescript
+ * parseNumericValue("1,234.56") // 1234.56 (last separator is .)
+ * parseNumericValue("1.234,56") // 1234.56 (last separator is ,)
+ * parseNumericValue("12,50")    // 12.5    (last separator is ,)
+ * parseNumericValue("12.50")    // 12.5    (last separator is .)
+ * parseNumericValue("1234")     // 1234
+ * parseNumericValue("$1,234")   // 1234
+ * parseNumericValue("15%")      // 15
+ * parseNumericValue("")         // null
+ * ```
+ */
+export declare function parseNumericValue(value: string): number | null;
+/**
+ * Check if input type requires numeric formatting
+ *
+ * @example
+ * ```typescript
+ * shouldFormat('currency') // true
+ * shouldFormat('percent')  // true
+ * shouldFormat('text')     // false
+ * ```
+ */
+export declare function shouldFormat(type: string): boolean;
+/**
+ * Format currency with locale
+ * Convenience function for currency formatting
+ */
+export declare function formatCurrency(value: number, currency?: string, locale?: string): string;
+/**
+ * Format percent with locale
+ * Convenience function for percent formatting
+ *
+ * Note: Expects value as 0.15 for 15%
+ */
+export declare function formatPercent(value: number, locale?: string, precision?: number): string;
+/**
+ * Format compact notation
+ * Convenience function for compact formatting
+ *
+ * @example
+ * formatCompact(1234567) // "1.2M"
+ * formatCompact(1234)    // "1.2K"
+ */
+export declare function formatCompact(value: number, locale?: string): string;
+//# sourceMappingURL=number-format.d.ts.map

package/lib/utils/number-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-format.d.ts","sourceRoot":"","sources":["../../src/utils/number-format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GACnB,MAAM,CA4CR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAc,EACxB,MAAM,GAAE,MAAgB,GACvB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAgB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAgB,GACvB,MAAM,CAER"}

package/lib/utils/number-format.js

@@ -0,0 +1,143 @@
+/**
+ * Number Formatting Utilities
+ * PORTED FROM: clj/ty/i18n/number.cljs
+ *
+ * Uses native Intl.NumberFormat for locale-aware number formatting
+ * Supports currency, percent, compact notation, and custom precision
+ */
+/**
+ * Format a number based on configuration
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234.56, { type: 'currency', currency: 'USD', locale: 'en-US' })
+ * // Returns: "$1,234.56"
+ *
+ * formatNumber(0.15, { type: 'percent', precision: 2 })
+ * // Returns: "15.00%"
+ *
+ * formatNumber(1234567, { type: 'compact' })
+ * // Returns: "1.2M"
+ * ```
+ */
+export function formatNumber(value, config) {
+    const { type, locale = 'en-US', currency = 'USD', precision } = config;
+    const options = {};
+    // Add precision if specified
+    if (precision !== undefined) {
+        options.minimumFractionDigits = precision;
+        options.maximumFractionDigits = precision;
+    }
+    // Configure based on type
+    switch (type) {
+        case 'currency':
+            options.style = 'currency';
+            options.currency = currency;
+            break;
+        case 'percent':
+            options.style = 'percent';
+            // Note: Intl.NumberFormat expects decimal (0.15 for 15%)
+            // We'll handle the division in the input component
+            break;
+        case 'compact':
+            options.notation = 'compact';
+            options.compactDisplay = 'short';
+            break;
+        case 'number':
+        default:
+            options.style = 'decimal';
+            break;
+    }
+    const formatter = new Intl.NumberFormat(locale, options);
+    const formatted = formatter.format(value);
+    // Normalize Unicode spaces for better HTML input compatibility
+    // Replace narrow no-break space (U+202F) and thin space (U+2009) with regular non-breaking space (U+00A0)
+    // This ensures proper rendering in HTML input elements
+    return formatted
+        .replace(/\u202F/g, '\u00A0') // Narrow no-break space → non-breaking space
+        .replace(/\u2009/g, '\u00A0'); // Thin space → non-breaking space
+}
+/**
+ * Parse a numeric string to a number
+ *
+ * Simple rule: the last occurring . or , is the decimal separator.
+ * Everything else is stripped. This works for both US (1,234.56) and
+ * European (1.234,56) input, and for mobile keyboards that use , as decimal.
+ *
+ * @example
+ * ```typescript
+ * parseNumericValue("1,234.56") // 1234.56 (last separator is .)
+ * parseNumericValue("1.234,56") // 1234.56 (last separator is ,)
+ * parseNumericValue("12,50")    // 12.5    (last separator is ,)
+ * parseNumericValue("12.50")    // 12.5    (last separator is .)
+ * parseNumericValue("1234")     // 1234
+ * parseNumericValue("$1,234")   // 1234
+ * parseNumericValue("15%")      // 15
+ * parseNumericValue("")         // null
+ * ```
+ */
+export function parseNumericValue(value) {
+    if (!value || value.trim() === '')
+        return null;
+    // Strip everything except digits, dots, commas, and minus
+    let stripped = value
+        .replace(/[^\d.,-]/g, '')
+        .trim();
+    if (stripped === '' || stripped === '-')
+        return null;
+    // Find the last occurring . or , — that's the decimal separator
+    const lastComma = stripped.lastIndexOf(',');
+    const lastDot = stripped.lastIndexOf('.');
+    const lastSep = Math.max(lastComma, lastDot);
+    if (lastSep === -1) {
+        // No separators — pure integer
+        const parsed = parseFloat(stripped);
+        return isNaN(parsed) ? null : parsed;
+    }
+    // Split at the last separator
+    const intPart = stripped.slice(0, lastSep).replace(/[.,]/g, '');
+    const decPart = stripped.slice(lastSep + 1);
+    const parsed = parseFloat(intPart + '.' + decPart);
+    return isNaN(parsed) ? null : parsed;
+}
+/**
+ * Check if input type requires numeric formatting
+ *
+ * @example
+ * ```typescript
+ * shouldFormat('currency') // true
+ * shouldFormat('percent')  // true
+ * shouldFormat('text')     // false
+ * ```
+ */
+export function shouldFormat(type) {
+    return ['number', 'currency', 'percent', 'compact'].includes(type);
+}
+/**
+ * Format currency with locale
+ * Convenience function for currency formatting
+ */
+export function formatCurrency(value, currency = 'USD', locale = 'en-US') {
+    return formatNumber(value, { type: 'currency', currency, locale });
+}
+/**
+ * Format percent with locale
+ * Convenience function for percent formatting
+ *
+ * Note: Expects value as 0.15 for 15%
+ */
+export function formatPercent(value, locale = 'en-US', precision) {
+    return formatNumber(value, { type: 'percent', locale, precision });
+}
+/**
+ * Format compact notation
+ * Convenience function for compact formatting
+ *
+ * @example
+ * formatCompact(1234567) // "1.2M"
+ * formatCompact(1234)    // "1.2K"
+ */
+export function formatCompact(value, locale = 'en-US') {
+    return formatNumber(value, { type: 'compact', locale });
+}
+//# sourceMappingURL=number-format.js.map

package/lib/utils/number-format.js.map

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

package/lib/utils/parse-boolean.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Parse a value as a boolean following web standards
+ *
+ * This utility helps web components handle boolean attributes consistently:
+ * - HTML5 boolean attributes: presence = true, absence = false, empty string = true
+ * - Framework boolean values: true/false/"true"/"false"
+ * - Numeric boolean values: 1/0/"1"/"0"
+ *
+ * @param value - The attribute value to parse
+ * @returns boolean - The parsed boolean value
+ *
+ * @example
+ * parseBoolean(null)       // false - attribute not present
+ * parseBoolean('')         // true  - HTML boolean attribute (present but empty)
+ * parseBoolean('true')     // true
+ * parseBoolean('false')    // false
+ * parseBoolean('TRUE')     // true  - case insensitive
+ * parseBoolean('1')        // true
+ * parseBoolean('0')        // false
+ * parseBoolean('yes')      // true  - any other non-empty string
+ * parseBoolean('anything') // true  - truthy by default unless explicitly false
+ */
+export declare function parseBoolean(value: string | null): boolean;
+/**
+ * Check if a value looks like a boolean string
+ * Used to determine if an attribute should be treated as a boolean
+ *
+ * @param value - The value to check
+ * @returns boolean - True if value represents a boolean
+ *
+ * @example
+ * isBooleanString('true')   // true
+ * isBooleanString('false')  // true
+ * isBooleanString('1')      // true
+ * isBooleanString('0')      // true
+ * isBooleanString('custom') // false
+ */
+export declare function isBooleanString(value: string | null): boolean;
+//# sourceMappingURL=parse-boolean.d.ts.map

package/lib/utils/parse-boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-boolean.d.ts","sourceRoot":"","sources":["../../src/utils/parse-boolean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAe1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAI7D"}

package/lib/utils/parse-boolean.js

@@ -0,0 +1,58 @@
+/**
+ * Parse a value as a boolean following web standards
+ *
+ * This utility helps web components handle boolean attributes consistently:
+ * - HTML5 boolean attributes: presence = true, absence = false, empty string = true
+ * - Framework boolean values: true/false/"true"/"false"
+ * - Numeric boolean values: 1/0/"1"/"0"
+ *
+ * @param value - The attribute value to parse
+ * @returns boolean - The parsed boolean value
+ *
+ * @example
+ * parseBoolean(null)       // false - attribute not present
+ * parseBoolean('')         // true  - HTML boolean attribute (present but empty)
+ * parseBoolean('true')     // true
+ * parseBoolean('false')    // false
+ * parseBoolean('TRUE')     // true  - case insensitive
+ * parseBoolean('1')        // true
+ * parseBoolean('0')        // false
+ * parseBoolean('yes')      // true  - any other non-empty string
+ * parseBoolean('anything') // true  - truthy by default unless explicitly false
+ */
+export function parseBoolean(value) {
+    // No attribute or null = false (HTML standard)
+    if (value === null)
+        return false;
+    // Empty string = true (HTML boolean attribute pattern: <input checked>)
+    if (value === '')
+        return true;
+    // Normalize to lowercase for case-insensitive comparison
+    const normalized = value.toLowerCase().trim();
+    // Explicit false values
+    if (normalized === 'false' || normalized === '0')
+        return false;
+    // Everything else is truthy (follows HTML/JavaScript conventions)
+    return true;
+}
+/**
+ * Check if a value looks like a boolean string
+ * Used to determine if an attribute should be treated as a boolean
+ *
+ * @param value - The value to check
+ * @returns boolean - True if value represents a boolean
+ *
+ * @example
+ * isBooleanString('true')   // true
+ * isBooleanString('false')  // true
+ * isBooleanString('1')      // true
+ * isBooleanString('0')      // true
+ * isBooleanString('custom') // false
+ */
+export function isBooleanString(value) {
+    if (value === null || value === '')
+        return false;
+    const normalized = value.toLowerCase().trim();
+    return ['true', 'false', '1', '0'].includes(normalized);
+}
+//# sourceMappingURL=parse-boolean.js.map

package/lib/utils/parse-boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-boolean.js","sourceRoot":"","sources":["../../src/utils/parse-boolean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,+CAA+C;IAC/C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAEhC,wEAAwE;IACxE,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAE7B,yDAAyD;IACzD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;IAE7C,wBAAwB;IACxB,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,KAAK,CAAA;IAE9D,kEAAkE;IAClE,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;IAC7C,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AACzD,CAAC"}

package/lib/utils/positioning.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Core positioning engine for floating elements
+ * Adapted from ty.positioning ClojureScript implementation
+ *
+ * Handles smart positioning of tooltips, dropdowns, popups, and other
+ * floating elements relative to anchor elements with automatic overflow
+ * detection and placement fallback.
+ */
+/**
+ * Placement orientation - how the floating element is positioned
+ */
+export type PlacementOrientation = 'horizontal' | 'vertical';
+/**
+ * Vertical alignment options
+ */
+export type VerticalAlign = 'top' | 'center' | 'bottom' | 'end';
+/**
+ * Horizontal alignment options
+ */
+export type HorizontalAlign = 'start' | 'center' | 'end';
+/**
+ * All available placement options
+ */
+export type Placement = 'top-start' | 'top' | 'top-end' | 'right-start' | 'right' | 'right-end' | 'bottom-start' | 'bottom' | 'bottom-end' | 'left-start' | 'left' | 'left-end';
+/**
+ * Placement configuration
+ */
+export interface PlacementConfig {
+    vertical: VerticalAlign;
+    horizontal: HorizontalAlign;
+    orientation?: PlacementOrientation;
+}
+/**
+ * Element rectangle with calculated center points
+ */
+export interface ElementRect {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+    centerX: number;
+    centerY: number;
+}
+/**
+ * Viewport dimensions and scroll position
+ */
+export interface ViewportRect {
+    width: number;
+    height: number;
+    scrollX: number;
+    scrollY: number;
+}
+/**
+ * Overflow data for all edges
+ */
+export interface OverflowData {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/**
+ * Calculated position result
+ */
+export interface PositionResult {
+    x: number;
+    y: number;
+    placement: Placement;
+    overflow: OverflowData;
+    overflowAmount: number;
+    fits: boolean;
+}
+/**
+ * Options for findBestPosition
+ */
+export interface PositionOptions {
+    targetEl: HTMLElement;
+    floatingEl: HTMLElement;
+    preferences?: Placement[];
+    offset?: number;
+    padding?: number;
+    containerPadding?: number;
+}
+/**
+ * Options for calculatePlacement
+ */
+export interface CalculatePlacementOptions {
+    targetRect: ElementRect;
+    floatingRect: ElementRect;
+    placement: Placement;
+    offset: number;
+    padding: number;
+    scrollbarWidth: number;
+    containerPadding: number;
+}
+/**
+ * Cleanup function type
+ */
+export type CleanupFn = () => void;
+/**
+ * Map of all placement configurations
+ */
+export declare const placements: Record<Placement, PlacementConfig>;
+/**
+ * Default placement preference lists for different use cases
+ */
+export declare const placementPreferences: {
+    default: Placement[];
+    tooltip: Placement[];
+    dropdown: Placement[];
+};
+/**
+ * Get element dimensions relative to viewport with calculated center points
+ */
+export declare function getElementRect(el: HTMLElement): ElementRect;
+/**
+ * Get viewport dimensions and scroll position
+ */
+export declare function getViewportRect(): ViewportRect;
+/**
+ * Calculate position for a specific placement
+ * Returns x, y coordinates and overflow information
+ */
+export declare function calculatePlacement(options: CalculatePlacementOptions): PositionResult;
+/**
+ * Find the best position for the floating element
+ * Tries all preference placements and returns the one that fits best
+ */
+export declare function findBestPosition(options: PositionOptions): PositionResult;
+/**
+ * Create auto-update system for position tracking
+ * Continuously monitors and updates position when target or floating element changes
+ *
+ * @param targetEl - The anchor element to position relative to
+ * @param floatingEl - The floating element to position
+ * @param updateFn - Callback function that receives new position data
+ * @param config - Position options (same as findBestPosition)
+ * @returns Cleanup function to stop auto-updating
+ */
+export declare function autoUpdate(targetEl: HTMLElement, floatingEl: HTMLElement, updateFn: (position: PositionResult) => void, config: Omit<PositionOptions, 'targetEl' | 'floatingEl'>): CleanupFn;
+//# sourceMappingURL=positioning.d.ts.map

package/lib/utils/positioning.d.ts.map

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