photon-grid-core 0.0.1

package/engines/editing/custom-dropdown-editor.js

@@ -0,0 +1,355 @@
+/**
+ * Accessible, virtually-scrolled custom dropdown editor for `dropdown` and
+ * `object` column types.
+ *
+ * The list panel is appended to `document.body` with `position: fixed` so it
+ * escapes the grid's `overflow: hidden` without requiring a portal container.
+ *
+ * Keyboard shortcuts:
+ * - ArrowDown / ArrowUp  — move highlight one row
+ * - PageDown / PageUp    — move highlight one page
+ * - Home / End           — jump to first / last option
+ * - Enter                — commit the highlighted option
+ * - Escape / Tab         — cancel (close without change)
+ */
+export class CustomDropdownEditor {
+    constructor(
+    /** The cell's `.pg-cell__inner` element — the trigger is mounted here. */
+    container, 
+    /** The `.pg-cell` element — used to compute the panel's viewport position. */
+    cellEl, options, currentValue, callbacks) {
+        this.container = container;
+        this.cellEl = cellEl;
+        this.options = options;
+        this.currentValue = currentValue;
+        this.callbacks = callbacks;
+        this.instanceId = ++CustomDropdownEditor.instanceCounter;
+        this.destroyed = false;
+        // ── Event handlers ─────────────────────────────────────────────────────────
+        this.handleKeyDown = (e) => {
+            switch (e.key) {
+                case 'ArrowDown':
+                    e.preventDefault();
+                    this.navigate(1);
+                    break;
+                case 'ArrowUp':
+                    e.preventDefault();
+                    this.navigate(-1);
+                    break;
+                case 'PageDown':
+                    e.preventDefault();
+                    this.navigate(CustomDropdownEditor.MAX_VISIBLE);
+                    break;
+                case 'PageUp':
+                    e.preventDefault();
+                    this.navigate(-CustomDropdownEditor.MAX_VISIBLE);
+                    break;
+                case 'Home':
+                    e.preventDefault();
+                    this.setHighlight(0);
+                    this.scrollToIndex(0, 'start');
+                    break;
+                case 'End':
+                    e.preventDefault();
+                    this.setHighlight(this.options.length - 1);
+                    this.scrollToIndex(this.options.length - 1, 'end');
+                    break;
+                case 'Enter':
+                    e.preventDefault();
+                    this.selectIndex(this.highlightedIndex);
+                    break;
+                case 'Escape':
+                    e.preventDefault();
+                    this.callbacks.onStop(false);
+                    break;
+                case 'Tab':
+                    e.preventDefault();
+                    this.callbacks.onStop(true);
+                    this.callbacks.onTab?.(e.shiftKey);
+                    break;
+            }
+            e.stopPropagation();
+        };
+        this.handleScroll = () => {
+            this.renderVisibleItems(this.scrollEl.scrollTop);
+        };
+        this.handleOutsideClick = (e) => {
+            const target = e.target;
+            if (this.panelEl.contains(target) ||
+                this.cellEl.contains(target))
+                return;
+            this.callbacks.onStop(false);
+        };
+        this.handleResize = () => {
+            this.positionPanel();
+        };
+        /**
+         * Closes the dropdown immediately when any element outside the panel scrolls.
+         * Catches both vertical and horizontal grid body scroll via capture-phase listener.
+         * Scroll events originating inside the virtual-scroll list are excluded.
+         */
+        this.handleBodyScroll = (e) => {
+            if (this.destroyed)
+                return;
+            const target = e.target;
+            if (this.panelEl && this.panelEl.contains(target))
+                return;
+            this.callbacks.onStop(false);
+        };
+        this.selectedIndex = this.options.findIndex((o) => String(o.value) === String(currentValue ?? ''));
+        this.highlightedIndex = this.selectedIndex >= 0 ? this.selectedIndex : 0;
+        this.mount();
+    }
+    /**
+     * Tear down the editor: remove the panel from the DOM and detach all event
+     * listeners.  Safe to call multiple times.
+     */
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.scrollEl?.removeEventListener('keydown', this.handleKeyDown);
+        this.scrollEl?.removeEventListener('scroll', this.handleScroll);
+        document.removeEventListener('mousedown', this.handleOutsideClick);
+        window.removeEventListener('resize', this.handleResize);
+        document.removeEventListener('scroll', this.handleBodyScroll, true);
+        this.panelEl?.remove();
+    }
+    // ── Mount ──────────────────────────────────────────────────────────────────
+    mount() {
+        this.buildTrigger();
+        this.buildPanel();
+        this.positionPanel();
+        document.body.appendChild(this.panelEl);
+        // Animate in on next frame (so the initial opacity:0 is applied first)
+        requestAnimationFrame(() => {
+            if (!this.destroyed)
+                this.panelEl.classList.add('pg-dropdown-editor__panel--visible');
+        });
+        // Focus the scroll container for immediate keyboard control
+        setTimeout(() => {
+            if (this.destroyed)
+                return;
+            this.scrollEl.focus();
+            // Scroll to show the selected / first item
+            this.scrollToIndex(this.highlightedIndex, 'center');
+        }, 0);
+        // Defer outside-click listener to avoid immediate closure from the dblclick
+        setTimeout(() => {
+            if (this.destroyed)
+                return;
+            document.addEventListener('mousedown', this.handleOutsideClick);
+        }, 0);
+        window.addEventListener('resize', this.handleResize, { passive: true });
+        document.addEventListener('scroll', this.handleBodyScroll, { passive: true, capture: true });
+    }
+    // ── Trigger (inside the cell) ──────────────────────────────────────────────
+    buildTrigger() {
+        this.triggerEl = document.createElement('div');
+        this.triggerEl.className = 'pg-dropdown-editor__trigger';
+        this.triggerEl.setAttribute('aria-haspopup', 'listbox');
+        this.triggerEl.setAttribute('aria-expanded', 'true');
+        this.syncTrigger(this.options[this.selectedIndex]);
+        this.container.innerHTML = '';
+        this.container.appendChild(this.triggerEl);
+    }
+    syncTrigger(opt) {
+        this.triggerEl.innerHTML = '';
+        const icon = this.buildIcon(opt, 'pg-dropdown-editor__opt-icon');
+        if (icon)
+            this.triggerEl.appendChild(icon);
+        const label = document.createElement('span');
+        label.className = 'pg-dropdown-editor__trigger-label';
+        label.textContent = opt?.label ?? '—';
+        this.triggerEl.appendChild(label);
+        const arrow = document.createElement('span');
+        arrow.className = 'pg-dropdown-editor__arrow';
+        arrow.setAttribute('aria-hidden', 'true');
+        this.triggerEl.appendChild(arrow);
+    }
+    // ── Panel (appended to document.body) ─────────────────────────────────────
+    buildPanel() {
+        this.panelEl = document.createElement('div');
+        this.panelEl.className = 'pg-dropdown-editor__panel';
+        const visibleCount = Math.min(Math.max(this.options.length, 1), CustomDropdownEditor.MAX_VISIBLE);
+        const panelH = visibleCount * CustomDropdownEditor.ITEM_HEIGHT;
+        this.scrollEl = document.createElement('div');
+        this.scrollEl.className = 'pg-dropdown-editor__scroll';
+        this.scrollEl.setAttribute('role', 'listbox');
+        this.scrollEl.setAttribute('tabindex', '0');
+        this.scrollEl.setAttribute('aria-label', 'Select an option');
+        this.scrollEl.style.height = `${panelH}px`;
+        this.scrollEl.addEventListener('keydown', this.handleKeyDown);
+        this.scrollEl.addEventListener('scroll', this.handleScroll, { passive: true });
+        if (this.options.length === 0) {
+            const empty = document.createElement('div');
+            empty.className = 'pg-dropdown-editor__empty';
+            empty.textContent = 'No options available';
+            this.scrollEl.appendChild(empty);
+        }
+        else {
+            const spacer = document.createElement('div');
+            spacer.className = 'pg-dropdown-editor__spacer';
+            spacer.style.height = `${this.options.length * CustomDropdownEditor.ITEM_HEIGHT}px`;
+            this.itemsEl = document.createElement('div');
+            this.itemsEl.className = 'pg-dropdown-editor__items';
+            spacer.appendChild(this.itemsEl);
+            this.scrollEl.appendChild(spacer);
+            this.renderVisibleItems(0);
+        }
+        this.panelEl.appendChild(this.scrollEl);
+    }
+    // ── Virtual rendering ──────────────────────────────────────────────────────
+    renderVisibleItems(scrollTop) {
+        if (!this.itemsEl)
+            return;
+        const H = CustomDropdownEditor.ITEM_HEIGHT;
+        const BUF = CustomDropdownEditor.SCROLL_BUFFER;
+        const VIS = CustomDropdownEditor.MAX_VISIBLE;
+        const total = this.options.length;
+        const startIdx = Math.max(0, Math.floor(scrollTop / H) - BUF);
+        const endIdx = Math.min(total, startIdx + VIS + BUF * 2);
+        this.itemsEl.innerHTML = '';
+        this.itemsEl.style.transform = `translateY(${startIdx * H}px)`;
+        for (let i = startIdx; i < endIdx; i++) {
+            const opt = this.options[i];
+            const isSelected = i === this.selectedIndex;
+            const isHighlight = i === this.highlightedIndex;
+            const item = document.createElement('div');
+            item.className = 'pg-dropdown-editor__option';
+            item.id = this.optId(i);
+            item.setAttribute('role', 'option');
+            item.setAttribute('aria-selected', String(isSelected));
+            item.setAttribute('data-index', String(i));
+            if (isSelected)
+                item.classList.add('pg-dropdown-editor__option--selected');
+            if (isHighlight)
+                item.classList.add('pg-dropdown-editor__option--highlighted');
+            if (this.callbacks.renderOption) {
+                const rendered = this.callbacks.renderOption(opt, i, isSelected, isHighlight);
+                if (typeof rendered === 'string') {
+                    item.innerHTML = rendered;
+                }
+                else {
+                    item.appendChild(rendered);
+                }
+            }
+            else {
+                const icon = this.buildIcon(opt, 'pg-dropdown-editor__opt-icon');
+                if (icon)
+                    item.appendChild(icon);
+                const label = document.createElement('span');
+                label.className = 'pg-dropdown-editor__opt-label';
+                label.textContent = opt.label;
+                item.appendChild(label);
+                if (isSelected) {
+                    const check = document.createElement('span');
+                    check.className = 'pg-dropdown-editor__opt-check';
+                    check.setAttribute('aria-hidden', 'true');
+                    item.appendChild(check);
+                }
+            }
+            // mousedown: prevent focus loss from scroll container, then select
+            item.addEventListener('mousedown', (e) => {
+                e.preventDefault();
+                this.selectIndex(i);
+            });
+            // Hover highlight
+            item.addEventListener('mouseenter', () => this.setHighlight(i));
+            this.itemsEl.appendChild(item);
+        }
+        // Keep ARIA active descendant in sync
+        this.scrollEl.setAttribute('aria-activedescendant', this.optId(this.highlightedIndex));
+    }
+    // ── Positioning ────────────────────────────────────────────────────────────
+    positionPanel() {
+        const cellRect = this.cellEl.getBoundingClientRect();
+        const H = CustomDropdownEditor.ITEM_HEIGHT;
+        const VIS = Math.min(Math.max(this.options.length, 1), CustomDropdownEditor.MAX_VISIBLE);
+        const panelH = VIS * H;
+        const panelW = cellRect.width;
+        const GAP = 4;
+        let top = cellRect.bottom + GAP;
+        let flipsAbove = false;
+        if (window.innerHeight - cellRect.bottom < panelH + GAP && cellRect.top > panelH + GAP) {
+            top = cellRect.top - panelH - GAP;
+            flipsAbove = true;
+        }
+        const left = Math.max(GAP, Math.min(cellRect.left, window.innerWidth - panelW - GAP));
+        this.panelEl.style.top = `${Math.max(GAP, top)}px`;
+        this.panelEl.style.left = `${left}px`;
+        this.panelEl.style.width = `${panelW}px`;
+        this.panelEl.classList.toggle('pg-dropdown-editor__panel--above', flipsAbove);
+    }
+    // ── Navigation helpers ─────────────────────────────────────────────────────
+    navigate(delta) {
+        const newIdx = Math.max(0, Math.min(this.options.length - 1, this.highlightedIndex + delta));
+        this.setHighlight(newIdx);
+        this.scrollToIndex(newIdx, delta > 0 ? 'end' : 'start');
+    }
+    setHighlight(index) {
+        if (this.highlightedIndex === index)
+            return;
+        // Remove CSS class from the previously highlighted item without a full
+        // re-render — re-rendering would detach the item under the cursor, causing
+        // subsequent mousedown events to fire on a detached element and miss.
+        const prevEl = this.itemsEl?.querySelector(`[data-index="${this.highlightedIndex}"]`);
+        prevEl?.classList.remove('pg-dropdown-editor__option--highlighted');
+        this.highlightedIndex = index;
+        const nextEl = this.itemsEl?.querySelector(`[data-index="${index}"]`);
+        nextEl?.classList.add('pg-dropdown-editor__option--highlighted');
+        this.scrollEl?.setAttribute('aria-activedescendant', this.optId(index));
+    }
+    scrollToIndex(index, align) {
+        const H = CustomDropdownEditor.ITEM_HEIGHT;
+        const itemTop = index * H;
+        const itemBot = itemTop + H;
+        const curTop = this.scrollEl.scrollTop;
+        const height = this.scrollEl.clientHeight;
+        if (align === 'center') {
+            this.scrollEl.scrollTop = Math.max(0, itemTop - height / 2 + H / 2);
+        }
+        else if (itemTop < curTop) {
+            this.scrollEl.scrollTop = itemTop;
+        }
+        else if (itemBot > curTop + height) {
+            this.scrollEl.scrollTop = itemBot - height;
+        }
+    }
+    selectIndex(index) {
+        if (index < 0 || index >= this.options.length)
+            return;
+        this.callbacks.onSelect(this.options[index]);
+        this.callbacks.onStop(true);
+    }
+    // ── Utility ────────────────────────────────────────────────────────────────
+    buildIcon(opt, cls) {
+        if (!opt?.image && !opt?.icon)
+            return null;
+        const wrapper = document.createElement('span');
+        wrapper.className = cls;
+        if (opt.image) {
+            const img = document.createElement('img');
+            img.src = opt.image;
+            img.alt = '';
+            img.width = 20;
+            img.height = 20;
+            wrapper.appendChild(img);
+        }
+        else if (opt.icon) {
+            wrapper.innerHTML = opt.icon;
+        }
+        return wrapper;
+    }
+    optId(index) {
+        return `pg-dd-${this.instanceId}-${index}`;
+    }
+}
+/** Height of each option row in pixels. Keep in sync with CSS. */
+CustomDropdownEditor.ITEM_HEIGHT = 34;
+/** Maximum number of rows shown before the list scrolls. */
+CustomDropdownEditor.MAX_VISIBLE = 8;
+/** Extra rows rendered above/below the visible window for smooth scrolling. */
+CustomDropdownEditor.SCROLL_BUFFER = 3;
+CustomDropdownEditor.instanceCounter = 0;
+//# sourceMappingURL=custom-dropdown-editor.js.map

package/engines/editing/custom-dropdown-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-dropdown-editor.js","sourceRoot":"","sources":["../../../src/engines/editing/custom-dropdown-editor.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAoB;IAoB/B;IACE,0EAA0E;IACzD,SAAsB;IACvC,8EAA8E;IAC7D,MAAmB,EACnB,OAA+B,EAC/B,YAAqB,EACrB,SAAkC;QALlC,cAAS,GAAT,SAAS,CAAa;QAEtB,WAAM,GAAN,MAAM,CAAa;QACnB,YAAO,GAAP,OAAO,CAAwB;QAC/B,iBAAY,GAAZ,YAAY,CAAS;QACrB,cAAS,GAAT,SAAS,CAAyB;QAlBpC,eAAU,GAAG,EAAE,oBAAoB,CAAC,eAAe,CAAC;QAS7D,cAAS,GAAG,KAAK,CAAC;QA0O1B,8EAA8E;QAEtE,kBAAa,GAAG,CAAC,CAAgB,EAAQ,EAAE;YACjD,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;gBACd,KAAK,WAAW;oBACd,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;oBACjB,MAAM;gBACR,KAAK,SAAS;oBACZ,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;oBAClB,MAAM;gBACR,KAAK,UAAU;oBACb,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;oBAChD,MAAM;gBACR,KAAK,QAAQ;oBACX,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;oBACjD,MAAM;gBACR,KAAK,MAAM;oBACT,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;oBACrB,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC/B,MAAM;gBACR,KAAK,KAAK;oBACR,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBAC3C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;oBACnD,MAAM;gBACR,KAAK,OAAO;oBACV,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;oBACxC,MAAM;gBACR,KAAK,QAAQ;oBACX,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC7B,MAAM;gBACR,KAAK,KAAK;oBACR,CAAC,CAAC,cAAc,EAAE,CAAC;oBACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC5B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;oBACnC,MAAM;YACV,CAAC;YACD,CAAC,CAAC,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC;QAEM,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC,CAAC;QAEM,uBAAkB,GAAG,CAAC,CAAa,EAAQ,EAAE;YACnD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAc,CAAC;YAChC,IACE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC5B,OAAO;YACT,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEM,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC;QAEF;;;;WAIG;QACK,qBAAgB,GAAG,CAAC,CAAQ,EAAQ,EAAE;YAC5C,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAc,CAAC;YAChC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO;YAC1D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC;QAzSA,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CACtD,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAChE,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACnE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACxD,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC;IAED,8EAA8E;IAEtE,KAAK;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAExC,uEAAuE;QACvE,qBAAqB,CAAC,GAAG,EAAE;YACzB,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC;QAEH,4DAA4D;QAC5D,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC3B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACtB,2CAA2C;YAC3C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC,EAAE,CAAC,CAAC,CAAC;QAEN,4EAA4E;QAC5E,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC3B,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEN,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,8EAA8E;IAEtE,YAAY;QAClB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,6BAA6B,CAAC;QACzD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAErD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAEnD,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAEO,WAAW,CAAC,GAA0B;QAC5C,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,8BAA8B,CAAC,CAAC;QACjE,IAAI,IAAI;YAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,CAAC,SAAS,GAAG,mCAAmC,CAAC;QACtD,KAAK,CAAC,WAAW,GAAG,GAAG,EAAE,KAAK,IAAI,GAAG,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAElC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,CAAC,SAAS,GAAG,2BAA2B,CAAC;QAC9C,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,6EAA6E;IAErE,UAAU;QAChB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,2BAA2B,CAAC;QAErD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAClG,MAAM,MAAM,GAAG,YAAY,GAAG,oBAAoB,CAAC,WAAW,CAAC;QAE/D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,4BAA4B,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC;QAE3C,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/E,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC5C,KAAK,CAAC,SAAS,GAAG,2BAA2B,CAAC;YAC9C,KAAK,CAAC,WAAW,GAAG,sBAAsB,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM,CAAC,SAAS,GAAG,4BAA4B,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,oBAAoB,CAAC,WAAW,IAAI,CAAC;YAEpF,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,2BAA2B,CAAC;YACrD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAElC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,8EAA8E;IAEtE,kBAAkB,CAAC,SAAiB;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,CAAC,GAAO,oBAAoB,CAAC,WAAW,CAAC;QAC/C,MAAM,GAAG,GAAK,oBAAoB,CAAC,aAAa,CAAC;QACjD,MAAM,GAAG,GAAK,oBAAoB,CAAC,WAAW,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAK,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;QAE3D,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,cAAc,QAAQ,GAAG,CAAC,KAAK,CAAC;QAE/D,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,GAAG,GAAW,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,UAAU,GAAI,CAAC,KAAK,IAAI,CAAC,aAAa,CAAC;YAC7C,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,CAAC,gBAAgB,CAAC;YAEhD,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,GAAG,4BAA4B,CAAC;YAC9C,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAE3C,IAAI,UAAU;gBAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YAC5E,IAAI,WAAW;gBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YAE/E,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;gBAC9E,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,8BAA8B,CAAC,CAAC;gBACjE,IAAI,IAAI;oBAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAEjC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBAC7C,KAAK,CAAC,SAAS,GAAG,+BAA+B,CAAC;gBAClD,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC;gBAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBAExB,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;oBAC7C,KAAK,CAAC,SAAS,GAAG,+BAA+B,CAAC;oBAClD,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;oBAC1C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAED,mEAAmE;YACnE,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;gBACvC,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YAEH,kBAAkB;YAClB,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAEhE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,8EAA8E;IAEtE,aAAa;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACrD,MAAM,CAAC,GAAU,oBAAoB,CAAC,WAAW,CAAC;QAClD,MAAM,GAAG,GAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAC9F,MAAM,MAAM,GAAK,GAAG,GAAG,CAAC,CAAC;QACzB,MAAM,MAAM,GAAK,QAAQ,CAAC,KAAK,CAAC;QAChC,MAAM,GAAG,GAAQ,CAAC,CAAC;QAEnB,IAAI,GAAG,GAAU,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;QACvC,IAAI,UAAU,GAAG,KAAK,CAAC;QAEvB,IAAI,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;YACvF,GAAG,GAAU,QAAQ,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC;YACzC,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;QAEtF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAK,GAAG,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAI,GAAG,MAAM,IAAI,CAAC;QAE1C,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,kCAAkC,EAAE,UAAU,CAAC,CAAC;IAChF,CAAC;IA8ED,8EAA8E;IAEtE,QAAQ,CAAC,KAAa;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,IAAI,IAAI,CAAC,gBAAgB,KAAK,KAAK;YAAE,OAAO;QAE5C,uEAAuE;QACvE,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CACxC,gBAAgB,IAAI,CAAC,gBAAgB,IAAI,CAC1C,CAAC;QACF,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;QAEpE,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAE9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CACxC,gBAAgB,KAAK,IAAI,CAC1B,CAAC;QACF,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAEjE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IAEO,aAAa,CAAC,KAAa,EAAE,KAAiC;QACpE,MAAM,CAAC,GAAS,oBAAoB,CAAC,WAAW,CAAC;QACjD,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxC,MAAM,MAAM,GAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAE3C,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC;aAAM,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC;QACpC,CAAC;aAAM,IAAI,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QACtD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,8EAA8E;IAEtE,SAAS,CAAC,GAAqC,EAAE,GAAW;QAClE,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,IAAI;YAAE,OAAO,IAAI,CAAC;QAE3C,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC;QAExB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,GAAG,GAAI,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC3C,GAAG,CAAC,GAAG,GAAM,GAAG,CAAC,KAAK,CAAC;YACvB,GAAG,CAAC,GAAG,GAAM,EAAE,CAAC;YAChB,GAAG,CAAC,KAAK,GAAI,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;QAC/B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,KAAa;QACzB,OAAO,SAAS,IAAI,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC;IAC7C,CAAC;;AAlZD,kEAAkE;AAClD,gCAAW,GAAK,EAAE,AAAP,CAAQ;AACnC,4DAA4D;AAC5C,gCAAW,GAAK,CAAC,AAAN,CAAO;AAClC,+EAA+E;AAC/D,kCAAa,GAAG,CAAC,AAAJ,CAAK;AAEnB,oCAAe,GAAG,CAAC,AAAJ,CAAK"}

package/engines/editing/value-parser.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnDef } from '../../types/column.types';
+export declare function parseValue(raw: unknown, col: ColumnDef): unknown;
+export declare function formatValue(value: unknown, col: ColumnDef, options?: FormatOptions): string;
+export declare function validateValue(value: unknown, col: ColumnDef): string | null;
+export interface FormatOptions {
+    locale?: string;
+    dateFormat?: string;
+    timeZone?: string;
+    currencySymbol?: string;
+    currencyFormat?: string;
+}
+//# sourceMappingURL=value-parser.d.ts.map

package/engines/editing/value-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-parser.d.ts","sourceRoot":"","sources":["../../../src/engines/editing/value-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAyBhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAiD3F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CA4B3E;AAkBD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/engines/editing/value-parser.js

@@ -0,0 +1,125 @@
+export function parseValue(raw, col) {
+    if (raw === null || raw === undefined || raw === '') {
+        return col.required ? null : null;
+    }
+    switch (col.type) {
+        case 'number':
+        case 'currency': {
+            const n = Number(raw);
+            return isNaN(n) ? null : n;
+        }
+        case 'boolean':
+            if (typeof raw === 'boolean')
+                return raw;
+            if (typeof raw === 'string')
+                return raw.toLowerCase() === 'true' || raw === '1';
+            return Boolean(raw);
+        case 'date':
+        case 'time': {
+            const d = new Date(raw);
+            return isNaN(d.getTime()) ? null : d.toISOString();
+        }
+        case 'array':
+            return Array.isArray(raw) ? raw : [raw];
+        default:
+            return String(raw);
+    }
+}
+export function formatValue(value, col, options) {
+    if (value === null || value === undefined)
+        return '';
+    switch (col.type) {
+        case 'number': {
+            const n = Number(value);
+            if (isNaN(n))
+                return String(value);
+            const locale = options?.locale ?? 'en-US';
+            return n.toLocaleString(locale, {
+                minimumFractionDigits: 0,
+                maximumFractionDigits: 2,
+            });
+        }
+        case 'currency': {
+            const n = Number(value);
+            if (isNaN(n))
+                return String(value);
+            const symbol = options?.currencySymbol ?? '$';
+            return `${symbol}${n.toLocaleString(options?.locale ?? 'en-US', {
+                minimumFractionDigits: 2,
+                maximumFractionDigits: 2,
+            })}`;
+        }
+        case 'date': {
+            const d = new Date(value);
+            if (isNaN(d.getTime()))
+                return String(value);
+            return formatDate(d, options?.dateFormat ?? 'dd/MM/yyyy', options?.timeZone);
+        }
+        case 'time': {
+            const d = new Date(value);
+            if (isNaN(d.getTime()))
+                return String(value);
+            return d.toLocaleTimeString(options?.locale ?? 'en-US', {
+                hour: '2-digit',
+                minute: '2-digit',
+                timeZone: options?.timeZone,
+            });
+        }
+        case 'boolean':
+            return value ? 'Yes' : 'No';
+        case 'array':
+            return Array.isArray(value) ? value.join(', ') : String(value);
+        case 'dropdown': {
+            const opt = col.dropdownOptions?.find((o) => String(o.value) === String(value));
+            return opt ? opt.label : String(value);
+        }
+        default: {
+            const str = String(value);
+            return str.charAt(0).toUpperCase() + str.slice(1);
+        }
+    }
+}
+export function validateValue(value, col) {
+    if (col.required && (value === null || value === undefined || value === '')) {
+        return `${col.header} is required`;
+    }
+    if (col.type === 'number' || col.type === 'currency') {
+        const n = Number(value);
+        if (value !== null && value !== undefined && value !== '' && isNaN(n)) {
+            return `${col.header} must be a number`;
+        }
+        if (!isNaN(n)) {
+            if (col.min !== undefined && col.min !== null && n < col.min) {
+                return `${col.header} must be at least ${col.min}`;
+            }
+            if (col.max !== undefined && col.max !== null && n > col.max) {
+                return `${col.header} must be at most ${col.max}`;
+            }
+        }
+    }
+    if (col.type === 'email' && value) {
+        const emailRe = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+        if (!emailRe.test(String(value))) {
+            return `${col.header} must be a valid email address`;
+        }
+    }
+    if (col.validatorFn) {
+        return col.validatorFn(value);
+    }
+    return null;
+}
+function formatDate(date, format, timeZone) {
+    const opts = {};
+    if (timeZone)
+        opts.timeZone = timeZone;
+    const pad = (n) => String(n).padStart(2, '0');
+    const d = new Date(date.toLocaleString('en-US', opts));
+    return format
+        .replace('yyyy', String(d.getFullYear()))
+        .replace('MM', pad(d.getMonth() + 1))
+        .replace('dd', pad(d.getDate()))
+        .replace('HH', pad(d.getHours()))
+        .replace('mm', pad(d.getMinutes()))
+        .replace('ss', pad(d.getSeconds()));
+}
+//# sourceMappingURL=value-parser.js.map

package/engines/editing/value-parser.js.map

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

package/engines/export/export-engine.d.ts

@@ -0,0 +1,16 @@
+import type { RowNode } from '../../types/row.types';
+import type { ColumnDef } from '../../types/column.types';
+import type { ExportConfig } from '../../types/grid.types';
+import type { EventBus } from '../../event-bus/event-bus';
+export declare class ExportEngine {
+    private eventBus;
+    constructor(eventBus: EventBus);
+    exportToCsv(rows: RowNode[], columns: ColumnDef[], config?: Partial<ExportConfig>): void;
+    exportToXlsx(rows: RowNode[], columns: ColumnDef[], config?: Partial<ExportConfig>): void;
+    private getExportColumns;
+    private escapeCsvCell;
+    private escapeXml;
+    private downloadFile;
+    private resolveValue;
+}
+//# sourceMappingURL=export-engine.d.ts.map

package/engines/export/export-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/export/export-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAEtC,WAAW,CACT,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,IAAI;IAyBP,YAAY,CACV,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,IAAI;IAmCP,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;CASrB"}

package/engines/export/export-engine.js

@@ -0,0 +1,99 @@
+import { GridEventType } from '../../types/event.types';
+import { formatValue } from '../editing/value-parser';
+export class ExportEngine {
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    exportToCsv(rows, columns, config = {}) {
+        const fileName = (config.fileName ?? 'export') + '.csv';
+        const exportCols = this.getExportColumns(columns, config);
+        const dataRows = rows.filter((r) => r.type === 'data');
+        this.eventBus.emit(GridEventType.EXPORT_START, { format: 'csv', fileName, rowCount: dataRows.length });
+        const headerRow = exportCols.map((c) => this.escapeCsvCell(c.header)).join(',');
+        const bodyRows = dataRows.map((row) => exportCols
+            .map((col) => {
+            const raw = this.resolveValue(row.data, col.field);
+            const formatted = config.processCellValue
+                ? config.processCellValue({ value: raw, colDef: col })
+                : formatValue(raw, col);
+            return this.escapeCsvCell(formatted);
+        })
+            .join(','));
+        const csv = [headerRow, ...bodyRows].join('\r\n');
+        this.downloadFile(csv, fileName, 'text/csv;charset=utf-8;');
+        this.eventBus.emit(GridEventType.EXPORT_COMPLETE, { format: 'csv', fileName, rowCount: dataRows.length });
+    }
+    exportToXlsx(rows, columns, config = {}) {
+        const fileName = (config.fileName ?? 'export') + '.xlsx';
+        const exportCols = this.getExportColumns(columns, config);
+        const dataRows = rows.filter((r) => r.type === 'data');
+        this.eventBus.emit(GridEventType.EXPORT_START, { format: 'xlsx', fileName, rowCount: dataRows.length });
+        const xmlRows = [];
+        const headers = exportCols.map((c) => `<Cell><Data ss:Type="String">${this.escapeXml(c.header)}</Data></Cell>`).join('');
+        xmlRows.push(`<Row>${headers}</Row>`);
+        for (const row of dataRows) {
+            const cells = exportCols.map((col) => {
+                const raw = this.resolveValue(row.data, col.field);
+                const formatted = config.processCellValue
+                    ? config.processCellValue({ value: raw, colDef: col })
+                    : formatValue(raw, col);
+                const type = col.type === 'number' || col.type === 'currency' ? 'Number' : 'String';
+                return `<Cell><Data ss:Type="${type}">${this.escapeXml(formatted)}</Data></Cell>`;
+            });
+            xmlRows.push(`<Row>${cells.join('')}</Row>`);
+        }
+        const xmlContent = `<?xml version="1.0"?>
+<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
+          xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">
+  <Worksheet ss:Name="Sheet1">
+    <Table>${xmlRows.join('')}</Table>
+  </Worksheet>
+</Workbook>`;
+        this.downloadFile(xmlContent, fileName, 'application/vnd.ms-excel');
+        this.eventBus.emit(GridEventType.EXPORT_COMPLETE, { format: 'xlsx', fileName, rowCount: dataRows.length });
+    }
+    getExportColumns(columns, config) {
+        return columns.filter((col) => {
+            if (!config.includeHiddenColumns && col.visible === false)
+                return false;
+            return true;
+        });
+    }
+    escapeCsvCell(value) {
+        if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+            return `"${value.replace(/"/g, '""')}"`;
+        }
+        return value;
+    }
+    escapeXml(value) {
+        return value
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+    downloadFile(content, fileName, mimeType) {
+        const blob = new Blob([content], { type: mimeType });
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = fileName;
+        link.style.display = 'none';
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        URL.revokeObjectURL(url);
+    }
+    resolveValue(data, path) {
+        const parts = path.split('.');
+        let current = data;
+        for (const part of parts) {
+            if (current == null)
+                return undefined;
+            current = current[part];
+        }
+        return current;
+    }
+}
+//# sourceMappingURL=export-engine.js.map