@sd-angular/core 19.0.44 → 19.0.46

package/fesm2022/sd-angular-core-components-table.mjs

@@ -7,8 +7,8 @@ import * as i7 from '@angular/material/sort';
 import { MatSort, MatSortModule } from '@angular/material/sort';
 import * as i6 from '@angular/material/table';
 import { MatTable, MatTableModule } from '@angular/material/table';
-import * as i1$1 from '@sd-angular/core/services';
-import { SdStorageService, SdExcelService, SdNotifyService } from '@sd-angular/core/services';
+import { ɵSD_LOCAL_DATE_TIME as _SD_LOCAL_DATE_TIME, SdDateTimeService } from '@sd-angular/core/services/date-time';
+import { SdNotifyService } from '@sd-angular/core/services/notify';
 import { Subject, fromEvent, Subscription, isObservable, firstValueFrom } from 'rxjs';
 import { debounceTime, startWith, map, switchMap, filter } from 'rxjs/operators';
 import { DateUtilities, StringUtilities } from '@sd-angular/core/utilities';
@@ -35,8 +35,8 @@ import { SdReadChannel, cloneReadRequest } from '@sd-angular/core/utilities/read
 import { SdQuickAction } from '@sd-angular/core/components/quick-action';
 import { SdTooltipDirective, SdScrollDirective, SdDesktopDirective, SdMobileDirective, SdHoverCopyDirective } from '@sd-angular/core/directives';
 import { SdSafeHtmlPipe, SdFormatNumberPipe } from '@sd-angular/core/pipes';
-import { Utilities, BrowserUtilities } from '@sdcorejs/utils/fns';
-import { DateUtilities as DateUtilities$1, ArrayUtilities, NumberUtilities } from '@sd-angular/core/utilities/extensions';
+import { Utilities, BrowserUtilities, NumberUtilities as NumberUtilities$1 } from '@sdcorejs/utils/fns';
+import { ArrayUtilities, NumberUtilities } from '@sd-angular/core/utilities/extensions';
 import { SdBadge } from '@sd-angular/core/components/badge';
 import { SdOperator } from '@sd-angular/core/components/operator';
 import { SdInput, SdInputNumber, SdSelect, SdDate, SdDatetime, SdDateRange as SdDateRange$1, SdCheckbox, SdSwitch } from '@sd-angular/core/forms';
@@ -51,10 +51,13 @@ import { MatButtonModule } from '@angular/material/button';
 import { MatSlideToggleModule } from '@angular/material/slide-toggle';
 import { SdModal } from '@sd-angular/core/components/modal';
 import { SdConfirmService } from '@sd-angular/core/services/confirm';
+import * as i1$1 from '@sd-angular/core/services';
+import { SdStorageService } from '@sd-angular/core/services';
 import * as i2$1 from '@angular/material/tooltip';
 import { MatTooltipModule } from '@angular/material/tooltip';
 import * as i5$1 from '@angular/material/chips';
 import { MatChipsModule } from '@angular/material/chips';
+import { SdExcelService } from '@sd-angular/core/services/excel';
 
 class SdTableCellDefDirective {
     static ngTemplateContextGuard(_dir, _ctx) {
@@ -164,8 +167,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.21", ngImpo
                 }]
         }] });
 
+/**
+ * Machine-zone date math, exactly the payload sent before time zones: the local bounds of
+ * `SdDateTimeService`, and a datetime still read by `new Date(value)`.
+ */
+const LOCAL_FILTER_DATES = { ..._SD_LOCAL_DATE_TIME, parse: value => new Date(value) };
+const hasFilterValue = (value) => value !== undefined && value !== null && value !== '';
 const SdConvertToPagingReq = (filterRequest, args) => {
     const { externalFilters, columns, fieldMapping } = args;
+    const dates = args.dateTime && args.dateTime.timeZone !== 'local' ? args.dateTime : LOCAL_FILTER_DATES;
     const req = {
         filters: [],
         orders: args?.orders || [],
@@ -209,14 +219,14 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                         filters.push({
                             field,
                             operator: 'GREATER_OR_EQUAL',
-                            data: DateUtilities.begin(value?.from).toISOString(),
+                            data: dates.begin(value?.from).toISOString(),
                         });
                     }
                     if (value?.to) {
                         filters.push({
                             field,
                             operator: 'LESS_THAN',
-                            data: DateUtilities.begin(DateUtilities.addDays(value?.to, 1)).toISOString(),
+                            data: dates.beginOfNextDay(value?.to).toISOString(),
                         });
                     }
                 }
@@ -227,14 +237,14 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                         filters.push({
                             field,
                             operator: 'GREATER_OR_EQUAL',
-                            data: DateUtilities.begin(value?.from).toISOString(),
+                            data: dates.begin(value?.from).toISOString(),
                         });
                     }
                     if (value?.to) {
                         filters.push({
                             field,
                             operator: 'LESS_THAN',
-                            data: DateUtilities.begin(DateUtilities.addDays(value?.to, 1)).toISOString(),
+                            data: dates.beginOfNextDay(value?.to).toISOString(),
                         });
                     }
                 }
@@ -244,14 +254,14 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                             filters.push({
                                 field,
                                 operator: 'GREATER_OR_EQUAL',
-                                data: DateUtilities.begin(value).toISOString(),
+                                data: dates.begin(value).toISOString(),
                             });
                         }
                         if (externalFilter.defaultOperator === 'LESS_OR_EQUAL') {
                             filters.push({
                                 field,
                                 operator: 'LESS_THAN',
-                                data: DateUtilities.begin(DateUtilities.addDays(value, 1)).toISOString(),
+                                data: dates.beginOfNextDay(value).toISOString(),
                             });
                         }
                     }
@@ -260,14 +270,14 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                             filters.push({
                                 field,
                                 operator: 'GREATER_OR_EQUAL',
-                                data: new Date(value).toISOString(),
+                                data: dates.parse(value).toISOString(),
                             });
                         }
                         if (externalFilter.defaultOperator === 'LESS_OR_EQUAL') {
                             filters.push({
                                 field,
                                 operator: 'LESS_OR_EQUAL',
-                                data: new Date(value).toISOString(),
+                                data: dates.parse(value).toISOString(),
                             });
                         }
                     }
@@ -288,14 +298,14 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                         filters.push({
                             field,
                             operator: 'GREATER_OR_EQUAL',
-                            data: DateUtilities.begin(value?.from).toISOString(),
+                            data: dates.begin(value?.from).toISOString(),
                         });
                     }
                     if (value?.to) {
                         filters.push({
                             field,
                             operator: 'LESS_THAN',
-                            data: DateUtilities.begin(DateUtilities.addDays(value?.to, 1)).toISOString(),
+                            data: dates.beginOfNextDay(value?.to).toISOString(),
                         });
                     }
                 }
@@ -337,8 +347,8 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                             field,
                             operator: 'BETWEEN',
                             data: {
-                                from: DateUtilities.begin(value?.from).toISOString(),
-                                to: DateUtilities.end(value?.to).toISOString(),
+                                from: dates.begin(value?.from).toISOString(),
+                                to: dates.end(value?.to).toISOString(),
                             },
                         });
                     }
@@ -346,14 +356,14 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                         filters.push({
                             field,
                             operator: 'GREATER_OR_EQUAL',
-                            data: DateUtilities.begin(value?.from).toISOString(),
+                            data: dates.begin(value?.from).toISOString(),
                         });
                     }
                     else if (value?.to) {
                         filters.push({
                             field,
                             operator: 'LESS_THAN',
-                            data: DateUtilities.begin(DateUtilities.addDays(value?.to, 1)).toISOString(),
+                            data: dates.beginOfNextDay(value?.to).toISOString(),
                         });
                     }
                 }
@@ -363,13 +373,39 @@ const SdConvertToPagingReq = (filterRequest, args) => {
                             field,
                             operator: 'BETWEEN',
                             data: {
-                                from: DateUtilities.begin(value).toISOString(),
-                                to: DateUtilities.end(value).toISOString(),
+                                from: dates.begin(value).toISOString(),
+                                to: dates.end(value).toISOString(),
                             },
                         });
                     }
                 }
             }
+            else if (column.type === 'number' && typeof value === 'object' && !Array.isArray(value) && ('from' in value || 'to' in value)) {
+                // why: the split-number filter emits an inclusive `{ from, to }`; a missing end leaves that side open, and 0 is a bound.
+                const hasFrom = hasFilterValue(value.from);
+                const hasTo = hasFilterValue(value.to);
+                if (hasFrom && hasTo) {
+                    filters.push({
+                        field,
+                        operator: 'BETWEEN',
+                        data: { from: value.from, to: value.to },
+                    });
+                }
+                else if (hasFrom) {
+                    filters.push({
+                        field,
+                        operator: 'GREATER_OR_EQUAL',
+                        data: value.from,
+                    });
+                }
+                else if (hasTo) {
+                    filters.push({
+                        field,
+                        operator: 'LESS_OR_EQUAL',
+                        data: value.to,
+                    });
+                }
+            }
             else {
                 if (Array.isArray(value)) {
                     if (value.length) {
@@ -2658,6 +2694,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.21", ngImpo
 class TableExportService {
     #excelService = inject(SdExcelService);
     #i18n = inject(I18nService);
+    // why: date cells are written as the wall clock of ISdCoreConfiguration.timeZone, like the table shows them.
+    #dateTime = inject(SdDateTimeService);
     // ==========================================
     // SIGNAL STATE (Component sẽ bind trực tiếp vào đây)
     // ==========================================
@@ -2788,13 +2826,13 @@ class TableExportService {
                             }
                         }
                         else if (column.type === 'date') {
-                            obj[fieldStr] = DateUtilities$1.toFormat(itemValue, 'yyyy/MM/dd');
+                            obj[fieldStr] = this.#dateTime.toFormat(itemValue, 'yyyy/MM/dd');
                         }
                         else if (column.type === 'datetime') {
-                            obj[fieldStr] = DateUtilities$1.toFormat(itemValue, 'yyyy/MM/dd HH:mm:ss');
+                            obj[fieldStr] = this.#dateTime.toFormat(itemValue, 'yyyy/MM/dd HH:mm:ss');
                         }
                         else if (column.type === 'time') {
-                            obj[fieldStr] = DateUtilities$1.toFormat(itemValue, 'HH:mm:ss');
+                            obj[fieldStr] = this.#dateTime.toFormat(itemValue, 'HH:mm:ss');
                         }
                         else if (column.type === 'values' || column.type === 'lazy-values') {
                             const vals = (Array.isArray(itemValue) ? itemValue : [itemValue]).filter(e => !!e?.toString());
@@ -2930,6 +2968,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.21", ngImpo
 class TableFormatService {
     // Inject các pipe/service dùng để format dữ liệu
     #formatNumberPipe = inject(SdFormatNumberPipe);
+    // why: date cells show the wall clock of ISdCoreConfiguration.timeZone.
+    #dateTime = inject(SdDateTimeService);
     // ==========================================
     // PUBLIC METHODS
     // ==========================================
@@ -3157,8 +3197,8 @@ class TableFormatService {
         return text || EMPTY_STR;
     }
     #formatDateDisplay(value, type) {
-        const date = DateUtilities$1.toFormat(value, 'dd/MM/yyyy');
-        const time = DateUtilities$1.toFormat(value, 'HH:mm:ss');
+        const date = this.#dateTime.toFormat(value, 'dd/MM/yyyy');
+        const time = this.#dateTime.toFormat(value, 'HH:mm:ss');
         if (type === 'datetime') {
             return time && date ? `<div class="T14R">${date}<span class="T14R text-black400 ml-4">${time}</span></div>` : '';
         }
@@ -3219,7 +3259,7 @@ const buildColumnWidthMap = (column) => {
     return result;
 };
 
-const sortValue = (value, type) => {
+const sortValue = (value, type, dateTime) => {
     if (value === null || value === undefined || value === '')
         return null;
     if (type === 'number') {
@@ -3227,15 +3267,21 @@ const sortValue = (value, type) => {
         return Number.isNaN(number) ? null : number;
     }
     if (type === 'date' || type === 'datetime' || type === 'time') {
-        const time = value instanceof Date ? value.getTime() : typeof value === 'string' || typeof value === 'number' ? new Date(value).getTime() : NaN;
+        // why: a time of day has no zone, so only date/datetime values are read in the configured zone.
+        const zone = type !== 'time' && dateTime && dateTime.timeZone !== 'local' ? dateTime : undefined;
+        const parse = (input) => (zone ? (zone.parse(input)?.getTime() ?? NaN) : new Date(input).getTime());
+        const time = value instanceof Date ? value.getTime() : typeof value === 'string' || typeof value === 'number' ? parse(value) : NaN;
         return Number.isNaN(time) ? null : time;
     }
     return String(value);
 };
-/** Internal local-sort comparison; intentionally not exported from the table entry point. */
-const compareLocalValues = (a, b, type, direction) => {
-    const first = sortValue(a, type);
-    const second = sortValue(b, type);
+/**
+ * Internal local-sort comparison; intentionally not exported from the table entry point.
+ * `dateTime` reads zone-less dates in `ISdCoreConfiguration.timeZone`; omitted or `'local'` keeps the machine zone.
+ */
+const compareLocalValues = (a, b, type, direction, dateTime) => {
+    const first = sortValue(a, type, dateTime);
+    const second = sortValue(b, type, dateTime);
     // why: xếp rỗng trước khi xét chiều để DESC vẫn giữ rỗng ở cuối và không đảo các dòng bằng nhau.
     if (first === null)
         return second === null ? 0 : 1;
@@ -3248,26 +3294,100 @@ const compareLocalValues = (a, b, type, direction) => {
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const isTableItem = (item) => !!item && typeof item === 'object' && 'data' in item && 'meta' in item;
 const resolveItemData = (item) => (isTableItem(item) ? item.data : item);
+const hasValue = (value) => value !== undefined && value !== null && value !== '';
 const hasActiveColumnFilter = (rawColumnFilter = {}, columns = []) => columns.some(col => {
     const v = rawColumnFilter[col.field];
     if (Array.isArray(v))
         return v.length > 0;
+    // why: a split-number bound of 0 is a value, not an empty end.
     if (v && typeof v === 'object')
-        return !!v.from || !!v.to;
-    return v !== undefined && v !== null && v !== '';
+        return hasValue(v.from) || hasValue(v.to);
+    return hasValue(v);
 });
-const matchesColumnFilter = (data, columns = [], rawColumnFilter = {}) => {
+// why: the same fallback SdConvertToPagingReq uses, so a local table filters like its server twin.
+const resolveOperator = (column, columnOperator) => columnOperator[column.field] || column.filter?.operator?.default;
+// Both sides are already trimmed and lowercased; no operator keeps the historical CONTAIN.
+const matchesText = (value, operator, operand) => {
+    switch (operator) {
+        case 'EQUAL':
+            return value === operand;
+        case 'NOT_EQUAL':
+            return value !== operand;
+        case 'NOT_CONTAIN':
+            return !value.includes(operand);
+        case 'START_WITH':
+            return value.startsWith(operand);
+        case 'NOT_START_WITH':
+            return !value.startsWith(operand);
+        case 'END_WITH':
+            return value.endsWith(operand);
+        case 'NOT_END_WITH':
+            return !value.endsWith(operand);
+        default:
+            return value.includes(operand);
+    }
+};
+const NUMBER_PREFIX_OPERATORS = {
+    '>=': 'GREATER_OR_EQUAL',
+    '<=': 'LESS_OR_EQUAL',
+    '>': 'GREATER_THAN',
+    '<': 'LESS_THAN',
+};
+const compareNumber = (value, operator, operand) => {
+    switch (operator) {
+        case 'NOT_EQUAL':
+            return value !== operand;
+        case 'GREATER_THAN':
+            return value > operand;
+        case 'GREATER_OR_EQUAL':
+            return value >= operand;
+        case 'LESS_THAN':
+            return value < operand;
+        case 'LESS_OR_EQUAL':
+            return value <= operand;
+        default:
+            return value === operand;
+    }
+};
+const toFiniteNumber = (value) => NumberUtilities$1.parseFiniteNumber(value, { trim: true });
+const matchesNumberFilter = (rawValue, filter, operator) => {
+    // why: the split-number filter emits `{ from, to }`; a missing end leaves that side open.
+    if (filter && typeof filter === 'object' && !Array.isArray(filter)) {
+        const from = toFiniteNumber(filter.from);
+        const to = toFiniteNumber(filter.to);
+        if (from === null && to === null)
+            return true;
+        const value = toFiniteNumber(rawValue);
+        return value !== null && (from === null || value >= from) && (to === null || value <= to);
+    }
+    // why: a typed prefix such as `>=5` is explicit, so it wins over the operator dropdown.
+    const prefixed = typeof filter === 'string' ? /^\s*(>=|<=|>|<)(.*)$/.exec(filter) : null;
+    const operand = toFiniteNumber(prefixed ? prefixed[2] : filter);
+    if (operand === null)
+        return true;
+    const value = toFiniteNumber(rawValue);
+    return value !== null && compareNumber(value, prefixed ? NUMBER_PREFIX_OPERATORS[prefixed[1]] : operator, operand);
+};
+const matchesColumnFilter = (data, columns = [], rawColumnFilter = {}, dateTime, columnOperator = {}) => {
+    const zoned = dateTime && dateTime.timeZone !== 'local' ? dateTime : undefined;
     for (const column of columns) {
         const { field, type } = column;
-        const filterValue = (rawColumnFilter[field] || '').toString().trim().toLowerCase();
         const rawColVal = resolveFieldValue(data, field);
+        // why: numbers bypass the text normalisation below, which reads a filter or row value of 0 as empty.
+        if (type === 'number') {
+            if (!matchesNumberFilter(rawColVal, rawColumnFilter[field], resolveOperator(column, columnOperator))) {
+                return false;
+            }
+            continue;
+        }
+        const filterValue = (rawColumnFilter[field] || '').toString().trim().toLowerCase();
         const columnValue = (rawColVal || '').toString().trim().toLowerCase();
         if (filterValue) {
             if (!columnValue && type !== 'datetime' && type !== 'date' && type !== 'time') {
                 return false;
             }
             if (type === 'string') {
-                if (columnValue.indexOf(filterValue) === -1) {
+                if (!matchesText(columnValue, resolveOperator(column, columnOperator), filterValue)) {
                     return false;
                 }
             }
@@ -3289,30 +3409,6 @@ const matchesColumnFilter = (data, columns = [], rawColumnFilter = {}) => {
                     return false;
                 }
             }
-            else if (type === 'number') {
-                const fValue = +filterValue.replace('>=', '').replace('<=', '').replace('>', '').replace('<', '');
-                const cValue = +columnValue;
-                if (fValue || fValue === 0) {
-                    if (!cValue && cValue !== 0) {
-                        return false;
-                    }
-                    if (filterValue.indexOf('>=') > -1 && cValue < fValue) {
-                        return false;
-                    }
-                    else if (filterValue.indexOf('<=') > -1 && cValue > fValue) {
-                        return false;
-                    }
-                    else if (filterValue.indexOf('<') > -1 && cValue >= fValue) {
-                        return false;
-                    }
-                    else if (filterValue.indexOf('>') > -1 && cValue <= fValue) {
-                        return false;
-                    }
-                    else if (cValue !== fValue) {
-                        return false;
-                    }
-                }
-            }
             else if (type === 'boolean') {
                 if ((filterValue === '1' || filterValue === 'true') && columnValue !== '1' && columnValue !== 'true') {
                     return false;
@@ -3324,13 +3420,16 @@ const matchesColumnFilter = (data, columns = [], rawColumnFilter = {}) => {
             else if (type === 'datetime' || type === 'date' || type === 'time') {
                 const from = rawColumnFilter[field]?.from ?? rawColumnFilter[field];
                 const to = rawColumnFilter[field]?.to ?? rawColumnFilter[field];
-                const fromDate = DateUtilities$1.begin(from);
-                const toDate = DateUtilities$1.end(to);
+                // why: a time of day has no zone, so only date/datetime rows are read in the configured zone.
+                const zone = type === 'time' ? undefined : zoned;
+                const fromDate = (zone ?? _SD_LOCAL_DATE_TIME).begin(from);
+                const toDate = (zone ?? _SD_LOCAL_DATE_TIME).end(to);
                 if (fromDate || toDate) {
                     if (!columnValue) {
                         return false;
                     }
-                    const columnTime = new Date(columnValue).getTime();
+                    // why: the zone branch parses the raw row value; `columnValue` is lowercased for text matching.
+                    const columnTime = zone ? (zone.parse(rawColVal)?.getTime() ?? NaN) : new Date(columnValue).getTime();
                     const fromDateTime = fromDate?.getTime() || null;
                     const toDateTime = toDate?.getTime() || null;
                     if (fromDateTime && fromDateTime > columnTime) {
@@ -3348,7 +3447,7 @@ const matchesColumnFilter = (data, columns = [], rawColumnFilter = {}) => {
 const filterLocalItems = (localItems, option, filterInfo) => {
     const { columns } = option;
     const { rawColumnFilter, orderBy, orderDirection, pageSize, pageNumber } = filterInfo;
-    const matchesData = (data) => matchesColumnFilter(data, columns, rawColumnFilter);
+    const matchesData = (data) => matchesColumnFilter(data, columns, rawColumnFilter, option.dateTime, filterInfo.columnOperator);
     const treeOpt = option.tree;
     const treeSearch = option.type === 'local' && treeOpt?.loadType === 'static' && hasActiveColumnFilter(rawColumnFilter, columns);
     const treeSearchPredicate = treeSearch ? matchesData : undefined;
@@ -3362,7 +3461,7 @@ const filterLocalItems = (localItems, option, filterInfo) => {
             items.sort((tableItemCurrent, tableItemNext) => {
                 const dataVal = resolveFieldValue(resolveItemData(tableItemCurrent), field);
                 const nextVal = resolveFieldValue(resolveItemData(tableItemNext), field);
-                return compareLocalValues(dataVal, nextVal, type, orderDirection);
+                return compareLocalValues(dataVal, nextVal, type, orderDirection, option.dateTime);
             });
         }
     }
@@ -3853,6 +3952,8 @@ class SdTable {
     #i18n = inject(I18nService);
     #tableFormatService = inject(TableFormatService);
     #tableExportService = inject(TableExportService);
+    // why: filters and sort read dates in ISdCoreConfiguration.timeZone; the pure helpers take it as an argument.
+    #dateTime = inject(SdDateTimeService);
     // Expose state signals từ TableExportService cho template binding.
     exporting = this.#tableExportService.exporting;
     exportTitle = this.#tableExportService.exportTitle;
@@ -4146,7 +4247,7 @@ class SdTable {
         Object.assign(cur, next);
     };
     #filterLocal = (localItems, filterInfo) => {
-        const result = filterLocalItems(localItems, this.tableOption(), filterInfo);
+        const result = filterLocalItems(localItems, { ...this.tableOption(), dateTime: this.#dateTime }, filterInfo);
         this.#treeSearchPredicate = result.treeSearchPredicate;
         return {
             items: result.items,
@@ -4240,6 +4341,7 @@ class SdTable {
             const pagingReq = SdConvertToPagingReq(snapshot, {
                 columns: opt.columns,
                 externalFilters: opt.filter?.externalFilters,
+                dateTime: this.#dateTime,
             });
             const optionRevision = this.#optionRevision;
             const sourceOption = this.option();
@@ -4449,6 +4551,7 @@ class SdTable {
                 const pagingReq = SdConvertToPagingReq(filterReq, {
                     columns: opt.columns,
                     externalFilters: opt.filter?.externalFilters,
+                    dateTime: this.#dateTime,
                 });
                 const result = opt.items(filterReq, pagingReq);
                 return await result;
@@ -4827,6 +4930,11 @@ class SdTable {
         if (operator == null)
             return;
         this.tableOption()?.filter?.operatorChange?.(column, operator);
+        // why: a new operator changes what the current value means, so filter again; an empty cell only keeps the operator.
+        if (hasActiveColumnFilter(this.columnFilter, [column]))
+            this.onFilterChange();
+        else
+            this.onFilterCommit();
     };
     trackBy = (index, item) => {
         return item.meta.id;