tyrell-components 1.0.0-RC10

package/lib/utils/property-capture.js

@@ -0,0 +1,152 @@
+/**
+ * Property Capture Utility
+ *
+ * Solves the problem of frameworks (React, Reagent, etc.) setting properties
+ * on custom elements BEFORE connectedCallback runs.
+ *
+ * PROBLEM:
+ * 1. Framework creates element: document.createElement('ty-dropdown')
+ * 2. Framework sets properties: element.value = "foo"
+ * 3. Constructor runs and defines getters/setters
+ * 4. BUT properties were already set, creating instance properties
+ * 5. Instance properties shadow the class getters/setters
+ * 6. connectedCallback runs - too late!
+ *
+ * SOLUTION:
+ * In connectedCallback, capture any pre-set properties and apply them properly.
+ *
+ * @example
+ * ```typescript
+ * connectedCallback(): void {
+ *   const preSetProps = capturePreSetProperties(this, [
+ *     'value', 'clearable', 'disabled'
+ *   ])
+ *
+ *   if (preSetProps.value !== undefined) {
+ *     this._value = preSetProps.value
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Capture properties that were set before connectedCallback
+ *
+ * @param element - The custom element instance
+ * @param propertyNames - Array of property names to check
+ * @param options - Capture options
+ * @returns Record of captured properties with metadata
+ *
+ * @example
+ * ```typescript
+ * const captured = capturePreSetProperties(this, ['value', 'disabled'])
+ * // {
+ * //   value: { name: 'value', value: 'foo', hadProperty: true },
+ * //   disabled: { name: 'disabled', value: undefined, hadProperty: false }
+ * // }
+ * ```
+ */
+export function capturePreSetProperties(element, propertyNames, options = { cleanup: true }) {
+    const captured = {};
+    for (const name of propertyNames) {
+        const descriptor = Object.getOwnPropertyDescriptor(element, name);
+        captured[name] = {
+            name,
+            value: descriptor?.value,
+            hadProperty: descriptor !== undefined && descriptor.value !== undefined
+        };
+        // Clean up instance property so class getter/setter works
+        if (options.cleanup && captured[name].hadProperty) {
+            delete element[name];
+        }
+    }
+    return captured;
+}
+/**
+ * Simpler API - just get the values that were pre-set
+ *
+ * @param element - The custom element instance
+ * @param propertyNames - Array of property names to check
+ * @param options - Capture options
+ * @returns Record of property names to values (only includes properties that were set)
+ *
+ * @example
+ * ```typescript
+ * const values = getCapturedValues(this, ['value', 'disabled'])
+ * if (values.value !== undefined) {
+ *   this._value = values.value
+ * }
+ * ```
+ */
+export function getCapturedValues(element, propertyNames, options) {
+    const captured = capturePreSetProperties(element, propertyNames, options);
+    const values = {};
+    for (const [name, data] of Object.entries(captured)) {
+        if (data.hadProperty) {
+            values[name] = data.value;
+        }
+    }
+    return values;
+}
+/**
+ * Automatically apply pre-set properties to private fields
+ *
+ * @param element - The custom element instance
+ * @param propertyNames - Array of property names to check
+ * @param propertyMap - Optional mapping of public names to private field names
+ *                      Default: adds underscore prefix (e.g., 'value' -> '_value')
+ * @param options - Capture options
+ *
+ * @example
+ * ```typescript
+ * // Simple usage (uses _propertyName convention)
+ * applyPreSetProperties(this, ['value', 'disabled'])
+ * // Sets this._value and this._disabled
+ *
+ * // Custom mapping
+ * applyPreSetProperties(this, ['value'], { value: 'internalValue' })
+ * // Sets this.internalValue
+ * ```
+ */
+export function applyPreSetProperties(element, propertyNames, propertyMap, options) {
+    const captured = capturePreSetProperties(element, propertyNames, options);
+    for (const [name, data] of Object.entries(captured)) {
+        if (data.hadProperty) {
+            // Determine the private field name
+            const privateName = propertyMap?.[name] || `_${name}`;
+            element[privateName] = data.value;
+        }
+    }
+}
+/**
+ * Helper for components with standard _propertyName pattern
+ *
+ * @param element - The custom element instance
+ * @param propertyNames - Array of property names to check
+ * @param transformer - Optional function to transform values before setting
+ * @param options - Capture options
+ *
+ * @example
+ * ```typescript
+ * connectedCallback(): void {
+ *   // Basic usage
+ *   captureAndApplyProperties(this, ['value', 'disabled', 'required'])
+ *
+ *   // With transformation
+ *   captureAndApplyProperties(this, ['value'], (name, value) => {
+ *     if (name === 'value') return this.parseValue(value)
+ *     return value
+ *   })
+ * }
+ * ```
+ */
+export function captureAndApplyProperties(element, propertyNames, transformer, options) {
+    const captured = capturePreSetProperties(element, propertyNames, options);
+    for (const [name, data] of Object.entries(captured)) {
+        if (data.hadProperty) {
+            const privateName = `_${name}`;
+            const value = transformer ? transformer(name, data.value) : data.value;
+            element[privateName] = value;
+        }
+    }
+}
+//# sourceMappingURL=property-capture.js.map

package/lib/utils/property-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-capture.js","sourceRoot":"","sources":["../../src/utils/property-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAsBH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAoB,EACpB,aAAuB,EACvB,UAAkC,EAAE,OAAO,EAAE,IAAI,EAAE;IAEnD,MAAM,QAAQ,GAAqC,EAAE,CAAA;IAErD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAEjE,QAAQ,CAAC,IAAI,CAAC,GAAG;YACf,IAAI;YACJ,KAAK,EAAE,UAAU,EAAE,KAAK;YACxB,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;SACxE,CAAA;QAED,0DAA0D;QAC1D,IAAI,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAClD,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,aAAuB,EACvB,OAAgC;IAEhC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;IACzE,MAAM,MAAM,GAAwB,EAAE,CAAA;IAEtC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAY,EACZ,aAAuB,EACvB,WAAyB,EACzB,OAAgC;IAEhC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;IAEzE,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,mCAAmC;YACnC,MAAM,WAAW,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAA;YACrD,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAA;QACnC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAY,EACZ,aAAuB,EACvB,WAA+C,EAC/C,OAAgC;IAEhC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;IAEzE,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAA;YACtE,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,CAAA;QAC9B,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/utils/property-manager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Property Manager - Unified property lifecycle for web components
+ *
+ * Handles property/attribute synchronization, validation, coercion, and change tracking.
+ * All property updates flow through a single code path for consistency.
+ */
+/**
+ * Configuration for a single property
+ */
+export interface PropertyConfig {
+    type: 'string' | 'boolean' | 'number' | 'object' | 'array';
+    visual?: boolean;
+    formValue?: boolean;
+    emitChange?: boolean;
+    default?: any;
+    validate?: (value: any) => boolean;
+    coerce?: (value: any) => any;
+    aliases?: Record<string, any>;
+}
+/**
+ * Represents a property change
+ */
+export interface PropertyChange {
+    name: string;
+    oldValue: any;
+    newValue: any;
+    source: 'attribute' | 'property' | 'internal';
+}
+/**
+ * Manages component properties with unified lifecycle
+ */
+export declare class PropertyManager<T = any> {
+    private _props;
+    private _config;
+    constructor(config: Record<string, PropertyConfig>);
+    /**
+     * Initialize properties with default values
+     */
+    private _initializeDefaults;
+    /**
+     * Check if a property name exists in the configuration
+     */
+    hasConfig(name: string): boolean;
+    /**
+     * Update a property value
+     * Returns PropertyChange if value changed, null otherwise
+     */
+    updateProperty(name: string, value: any, source?: 'attribute' | 'property' | 'internal'): PropertyChange | null;
+    /**
+     * Coerce value to the correct type
+     */
+    private _coerceValue;
+    /**
+     * Validate a property value
+     */
+    private _validateValue;
+    /**
+     * Check if two values are equal
+     */
+    private _valuesEqual;
+    /**
+     * Get a property value
+     */
+    get(name: string): any;
+    /**
+     * Get all properties as an object
+     */
+    getAll(): Record<string, any>;
+    /**
+     * Get property configuration
+     */
+    getConfig(name: string): PropertyConfig | undefined;
+    /**
+     * Check if a property is visual (requires render)
+     */
+    isVisual(name: string): boolean;
+    /**
+     * Check if a property affects form value
+     */
+    isFormValue(name: string): boolean;
+    /**
+     * Check if a property should emit change events
+     */
+    shouldEmitChange(name: string): boolean;
+    /**
+     * Handle property aliases (e.g., not-clearable → clearable: false)
+     */
+    handleAlias(aliasName: string, value: any): PropertyChange | null;
+}
+//# sourceMappingURL=property-manager.d.ts.map

package/lib/utils/property-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-manager.d.ts","sourceRoot":"","sources":["../../src/utils/property-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;IAG1D,MAAM,CAAC,EAAE,OAAO,CAAA;IAGhB,SAAS,CAAC,EAAE,OAAO,CAAA;IAGnB,UAAU,CAAC,EAAE,OAAO,CAAA;IAGpB,OAAO,CAAC,EAAE,GAAG,CAAA;IAGb,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAA;IAGlC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;IAG5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAA;IACb,QAAQ,EAAE,GAAG,CAAA;IACb,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAA;CAC9C;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAgC;gBAEnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAKlD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;;OAGG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,EACV,MAAM,GAAE,WAAW,GAAG,UAAU,GAAG,UAAuB,GACzD,cAAc,GAAG,IAAI;IAsCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoDpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAItB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI7B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,cAAc,GAAG,IAAI;CAUlE"}

package/lib/utils/property-manager.js

@@ -0,0 +1,197 @@
+/**
+ * Property Manager - Unified property lifecycle for web components
+ *
+ * Handles property/attribute synchronization, validation, coercion, and change tracking.
+ * All property updates flow through a single code path for consistency.
+ */
+/**
+ * Manages component properties with unified lifecycle
+ */
+export class PropertyManager {
+    constructor(config) {
+        this._props = new Map();
+        this._config = config;
+        this._initializeDefaults();
+    }
+    /**
+     * Initialize properties with default values
+     */
+    _initializeDefaults() {
+        for (const [name, config] of Object.entries(this._config)) {
+            if (config.default !== undefined) {
+                this._props.set(name, config.default);
+            }
+        }
+    }
+    /**
+     * Check if a property name exists in the configuration
+     */
+    hasConfig(name) {
+        return name in this._config;
+    }
+    /**
+     * Update a property value
+     * Returns PropertyChange if value changed, null otherwise
+     */
+    updateProperty(name, value, source = 'property') {
+        const config = this._config[name];
+        if (!config) {
+            console.warn(`[PropertyManager] Unknown property: ${name}`);
+            return null;
+        }
+        // Get old value
+        const oldValue = this._props.get(name);
+        // Coerce value to correct type
+        const coercedValue = this._coerceValue(name, value, config);
+        // Validate value
+        if (!this._validateValue(name, coercedValue, config)) {
+            console.warn(`[PropertyManager] Invalid value for ${name}:`, coercedValue);
+            return null;
+        }
+        // Check if value actually changed
+        if (this._valuesEqual(oldValue, coercedValue)) {
+            return null;
+        }
+        // Update internal map
+        this._props.set(name, coercedValue);
+        // Create change object
+        const change = {
+            name,
+            oldValue,
+            newValue: coercedValue,
+            source
+        };
+        return change;
+    }
+    /**
+     * Coerce value to the correct type
+     */
+    _coerceValue(name, value, config) {
+        // Custom coercion
+        if (config.coerce) {
+            return config.coerce(value);
+        }
+        // Null/undefined handling
+        if (value === null || value === undefined) {
+            return config.default ?? null;
+        }
+        // Type coercion
+        switch (config.type) {
+            case 'boolean':
+                // HTML Standard: attribute present (even empty) = true, absent = false
+                // String handling:
+                if (typeof value === 'string') {
+                    // Empty string = true (HTML boolean attribute: <input checked>)
+                    if (value === '')
+                        return true;
+                    // Explicit false values
+                    const normalized = value.toLowerCase().trim();
+                    if (normalized === 'false' || normalized === '0')
+                        return false;
+                    // Everything else is truthy
+                    return true;
+                }
+                // Non-string: standard truthy/falsy
+                return Boolean(value);
+            case 'number':
+                const num = Number(value);
+                return isNaN(num) ? (config.default ?? 0) : num;
+            case 'string':
+                return String(value);
+            case 'object':
+            case 'array':
+                if (typeof value === 'string') {
+                    try {
+                        return JSON.parse(value);
+                    }
+                    catch {
+                        console.warn(`[PropertyManager] Failed to parse ${name}:`, value);
+                        return config.default ?? (config.type === 'array' ? [] : {});
+                    }
+                }
+                return value;
+            default:
+                return value;
+        }
+    }
+    /**
+     * Validate a property value
+     */
+    _validateValue(name, value, config) {
+        if (config.validate) {
+            return config.validate(value);
+        }
+        return true;
+    }
+    /**
+     * Check if two values are equal
+     */
+    _valuesEqual(a, b) {
+        // Simple equality for primitives
+        if (typeof a !== 'object' || typeof b !== 'object') {
+            return a === b;
+        }
+        // Null checks
+        if (a === null || b === null) {
+            return a === b;
+        }
+        // Deep equality for objects/arrays (simple implementation)
+        // For production, consider using a proper deep equality library
+        try {
+            return JSON.stringify(a) === JSON.stringify(b);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get a property value
+     */
+    get(name) {
+        return this._props.get(name);
+    }
+    /**
+     * Get all properties as an object
+     */
+    getAll() {
+        return Object.fromEntries(this._props);
+    }
+    /**
+     * Get property configuration
+     */
+    getConfig(name) {
+        return this._config[name];
+    }
+    /**
+     * Check if a property is visual (requires render)
+     */
+    isVisual(name) {
+        return this._config[name]?.visual ?? false;
+    }
+    /**
+     * Check if a property affects form value
+     */
+    isFormValue(name) {
+        return this._config[name]?.formValue ?? false;
+    }
+    /**
+     * Check if a property should emit change events
+     */
+    shouldEmitChange(name) {
+        return this._config[name]?.emitChange ?? false;
+    }
+    /**
+     * Handle property aliases (e.g., not-clearable → clearable: false)
+     */
+    handleAlias(aliasName, value) {
+        // Find property with this alias
+        for (const [propName, config] of Object.entries(this._config)) {
+            if (config.aliases && aliasName in config.aliases) {
+                const aliasedValue = config.aliases[aliasName];
+                return this.updateProperty(propName, aliasedValue, 'attribute');
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=property-manager.js.map

package/lib/utils/property-manager.js.map

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

package/lib/utils/resize-observer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Resize Observer Registry & Callbacks
+ *
+ * Provides global registry for element sizes and optional callback subscriptions.
+ */
+export interface ElementSize {
+    width: number;
+    height: number;
+}
+export type ResizeCallback = (size: ElementSize) => void;
+/**
+ * Get current size for element by ID (sync query)
+ *
+ * @example
+ * const size = getSize('parent-container')
+ * if (size) console.log(`Width: ${size.width}px`)
+ */
+export declare function getSize(id: string): ElementSize | undefined;
+/**
+ * Subscribe to size changes for element by ID
+ * Returns unsubscribe function
+ *
+ * @example
+ * const unsubscribe = onResize('parent', ({ width, height }) => {
+ *   console.log(`Resized to ${width}x${height}`)
+ * })
+ * // Later: unsubscribe()
+ */
+export declare function onResize(id: string, callback: ResizeCallback): () => void;
+/**
+ * Get all registered sizes (for debugging/window API)
+ */
+export declare function getAllSizes(): Record<string, ElementSize>;
+/**
+ * Internal: Update size in registry and notify callbacks
+ */
+export declare function updateSize(id: string, width: number, height: number): void;
+/**
+ * Internal: Remove size from registry and cleanup callbacks
+ */
+export declare function removeSize(id: string): void;
+//# sourceMappingURL=resize-observer.d.ts.map

package/lib/utils/resize-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize-observer.d.ts","sourceRoot":"","sources":["../../src/utils/resize-observer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;AAMxD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAiBzE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAS1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG3C"}

package/lib/utils/resize-observer.js

@@ -0,0 +1,71 @@
+/**
+ * Resize Observer Registry & Callbacks
+ *
+ * Provides global registry for element sizes and optional callback subscriptions.
+ */
+// Global registry (Map-based storage)
+const sizes = new Map();
+const callbacks = new Map();
+/**
+ * Get current size for element by ID (sync query)
+ *
+ * @example
+ * const size = getSize('parent-container')
+ * if (size) console.log(`Width: ${size.width}px`)
+ */
+export function getSize(id) {
+    return sizes.get(id);
+}
+/**
+ * Subscribe to size changes for element by ID
+ * Returns unsubscribe function
+ *
+ * @example
+ * const unsubscribe = onResize('parent', ({ width, height }) => {
+ *   console.log(`Resized to ${width}x${height}`)
+ * })
+ * // Later: unsubscribe()
+ */
+export function onResize(id, callback) {
+    if (!callbacks.has(id)) {
+        callbacks.set(id, new Set());
+    }
+    callbacks.get(id).add(callback);
+    // Call immediately with current size if available
+    const current = sizes.get(id);
+    if (current)
+        callback(current);
+    // Return unsubscribe function
+    return () => {
+        callbacks.get(id)?.delete(callback);
+        if (callbacks.get(id)?.size === 0) {
+            callbacks.delete(id);
+        }
+    };
+}
+/**
+ * Get all registered sizes (for debugging/window API)
+ */
+export function getAllSizes() {
+    return Object.fromEntries(sizes);
+}
+/**
+ * Internal: Update size in registry and notify callbacks
+ */
+export function updateSize(id, width, height) {
+    sizes.set(id, { width, height });
+    // Notify all subscribers
+    const cbs = callbacks.get(id);
+    if (cbs) {
+        const size = { width, height };
+        cbs.forEach(cb => cb(size));
+    }
+}
+/**
+ * Internal: Remove size from registry and cleanup callbacks
+ */
+export function removeSize(id) {
+    sizes.delete(id);
+    callbacks.delete(id);
+}
+//# sourceMappingURL=resize-observer.js.map

package/lib/utils/resize-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize-observer.js","sourceRoot":"","sources":["../../src/utils/resize-observer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,sCAAsC;AACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAA;AAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,QAAwB;IAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;IAC9B,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEhC,kDAAkD;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,IAAI,OAAO;QAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B,8BAA8B;IAC9B,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QACnC,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACtB,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,KAAa,EAAE,MAAc;IAClE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IAEhC,yBAAyB;IACzB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;QAC9B,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAChB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACtB,CAAC"}

package/lib/utils/scroll-lock.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CSS-based scroll prevention using position: fixed.
+ *
+ * Prevents body/page scrolling by temporarily fixing the body position
+ * while preserving scroll position. Much more reliable than event prevention.
+ *
+ * Key benefits:
+ * - No event manipulation complexity
+ * - No interference with component keyboard navigation
+ * - Preserves scroll position perfectly
+ * - Standard industry technique
+ * - Multiple component support with proper cleanup
+ */
+declare global {
+    interface Window {
+        tyScrollDebug?: boolean;
+    }
+}
+/**
+ * Lock scrolling for a specific component.
+ *
+ * Multiple components can lock scrolling simultaneously.
+ * Scroll remains locked until ALL components unlock.
+ *
+ * @param componentId - Unique identifier for the component
+ */
+export declare function lockScroll(componentId: string): void;
+/**
+ * Unlock scrolling for a specific component.
+ *
+ * Scroll remains locked if other components still have locks active.
+ *
+ * @param componentId - Unique identifier for the component
+ */
+export declare function unlockScroll(componentId: string): void;
+/**
+ * Emergency unlock - removes all scroll locks immediately.
+ *
+ * Use this for cleanup or error recovery scenarios.
+ */
+export declare function forceUnlockAll(): void;
+/**
+ * Enable scroll lock debugging - useful for testing and development
+ */
+export declare function enableDebug(): void;
+/**
+ * Disable scroll lock debugging
+ */
+export declare function disableDebug(): void;
+/**
+ * Get the set of currently active component locks.
+ *
+ * @returns Set of component IDs that currently have scroll locked
+ */
+export declare function getActiveLocks(): Set<string>;
+/**
+ * Check if scrolling is currently locked.
+ *
+ * @returns true if any component has scroll locked
+ */
+export declare function isLocked(): boolean;
+/**
+ * Check if scrolling is locked by a specific component.
+ *
+ * @param componentId - Component identifier to check
+ * @returns true if this specific component has scroll locked
+ */
+export declare function isLockedBy(componentId: string): boolean;
+/**
+ * Get the complete lock state for debugging.
+ *
+ * @returns Current state including scroll position and active locks
+ */
+export declare function getLockState(): Readonly<{
+    locked: boolean;
+    scrollY: number;
+    activeLocks: string[];
+}>;
+//# sourceMappingURL=scroll-lock.d.ts.map

package/lib/utils/scroll-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-lock.d.ts","sourceRoot":"","sources":["../../src/utils/scroll-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB;CACF;AA4FD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAUpD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAWtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAMD;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,CAMD"}