@oscarpalmer/tabela 0.13.0 → 0.15.0

package/src/managers/data.manager.ts

@@ -5,36 +5,48 @@ import {isPlainObject} from '@oscarpalmer/atoms/is';
 import type {Key, PlainObject} from '@oscarpalmer/atoms/models';
 import {delay} from '@oscarpalmer/atoms/promise/delay';
 import {getValue} from '@oscarpalmer/atoms/value/handle';
+import type {ColumnComponent} from '../components/column.component';
 import {GroupComponent, updateGroup} from '../components/group.component';
-import type {DataItem, DataState, TabelaData} from '../models/data.model';
+import {getGroup, isGroupKey} from '../helpers/misc.helpers';
+import type {DataState, DataValue, TabelaData} from '../models/data.model';
+import {
+	EVENT_DATA_ADD,
+	EVENT_DATA_CLEAR,
+	EVENT_DATA_REMOVE,
+	EVENT_DATA_SYNCHRONIZE,
+	EVENT_DATA_UPDATE,
+	EVENT_GROUP_ADD,
+	EVENT_GROUP_REMOVE,
+	EVENT_GROUP_UPDATE,
+} from '../models/event.model';
+import {SORT_ASCENDING} from '../models/sort.model';
 import type {State} from '../models/tabela.model';
 import {sortWithGroups} from './sort.manager';
-import type {ColumnComponent} from '../components/column.component';
 
 export class DataManager {
-	handlers = Object.freeze({
-		add: data => void this.add(data, true),
-		clear: () => void this.clear(),
+	handlers: TabelaData = {
+		add: data => this.add(data, true),
+		clear: () => this.clear(),
 		get: active => this.get(active),
-		remove: items => void this.remove(items, true),
-		synchronize: (data, remove) => void this.synchronize(data, remove),
-		update: data => void this.update(data),
-	} satisfies TabelaData);
+		remove: items => this.remove(items, true),
+		synchronize: (data, remove) => this.synchronize(data, remove === true),
+		update: data => this.update(data, true),
+	};
 
 	state: DataState;
 
-	get items(): DataItem[] {
-		return this.state.items.active ?? this.state.items.original;
+	get keys(): Key[] {
+		return this.state.keys.active ?? this.state.keys.original;
 	}
 
 	get size(): number {
-		return this.items.length;
+		return this.keys.length;
 	}
 
 	constructor(state: State) {
 		this.state = {
 			...state,
-			items: {
+			keys: {
 				original: [],
 			},
 			values: {
@@ -47,8 +59,11 @@ export class DataManager {
 	async add(data: PlainObject[], render: boolean): Promise<void> {
 		const {state} = this;
 
-		const groups: GroupComponent[] = [];
-		const updates: PlainObject[] = [];
+		const addedData: PlainObject[] = [];
+		const updatedData: PlainObject[] = [];
+
+		const addedGroups: GroupComponent[] = [];
+		const updatedGroups: GroupComponent[] = [];
 
 		let groupColumn: ColumnComponent | undefined;
 		let {length} = data;
@@ -58,11 +73,13 @@ export class DataManager {
 			const key = getValue(item, state.key) as Key;
 
 			if (state.values.mapped.has(key)) {
-				updates.push(item);
+				updatedData.push(item);
 
 				continue;
 			}
 
+			addedData.push(item);
+
 			state.values.array.push(item);
 			state.values.mapped.set(key, item);
 
@@ -70,20 +87,24 @@ export class DataManager {
 				continue;
 			}
 
-			const groupValue = getValue(item, state.managers.group.field) as unknown;
+			const groupValue = getValue(item, state.managers.group.key) as Key;
 
-			let group = state.managers.group.get(groupValue);
+			let group = state.managers.group.getForValue(groupValue);
 
 			if (group == null) {
-				groupColumn ??= state.managers.column.get(state.managers.group.field);
+				groupColumn ??= state.managers.column.get(state.managers.group.key);
 
 				group = new GroupComponent(
-					`${groupColumn?.options.title ?? state.managers.group.field}: ${groupValue}`,
+					`${groupColumn?.options.label ?? state.managers.group.key}: ${groupValue}`,
 					groupValue,
 				);
 
-				state.values.array.push(group);
-				state.managers.group.add(group);
+				state.values.array.push(group.key);
+				state.managers.group.add(group, false);
+
+				addedGroups.push(group);
+			} else if (!addedGroups.includes(group) && !updatedGroups.includes(group)) {
+				updatedGroups.push(group);
 			}
 
 			if (!group.expanded) {
@@ -91,26 +112,44 @@ export class DataManager {
 			}
 
 			group.total += 1;
+		}
+
+		length = addedGroups.length;
+
+		if (length > 0) {
+			state.managers.event.emit(EVENT_GROUP_ADD, addedGroups.map(getGroup));
 
-			groups.push(group);
+			for (let index = 0; index < length; index += 1) {
+				updateGroup(state, addedGroups[index], false);
+			}
 		}
 
-		length = groups.length;
+		length = updatedGroups.length;
 
-		for (let index = 0; index < length; index += 1) {
-			updateGroup(state, groups[index]);
+		if (length > 0) {
+			for (let index = 0; index < length; index += 1) {
+				updateGroup(state, updatedGroups[index], false);
+			}
+
+			state.managers.event.emit(EVENT_GROUP_UPDATE, updatedGroups.map(getGroup));
+		}
+
+		await this.update(updatedData, addedData.length === 0);
+
+		if (addedData.length === 0) {
+			return;
 		}
 
-		if (updates.length > 0) {
-			void this.update(updates);
-		} else if (render) {
+		state.managers.event.emit(EVENT_DATA_ADD, addedData);
+
+		if (render) {
 			this.render();
 		}
 	}
 
-	clear(): void {
+	async clear(): Promise<void> {
 		if (this.state.values.array.length > 0) {
-			void this.removeItems([], true, true);
+			return this.removeItems([], true, true).then(() => undefined);
 		}
 	}
 
@@ -119,8 +158,8 @@ export class DataManager {
 
 		state.values.mapped.clear();
 
-		state.items.active = undefined;
-		state.items.original.length = 0;
+		state.keys.active = undefined;
+		state.keys.original.length = 0;
 		state.values.array.length = 0;
 
 		this.handlers = undefined as never;
@@ -130,45 +169,49 @@ export class DataManager {
 	get(active?: boolean): PlainObject[] {
 		const {state} = this;
 
-		return (active ?? false)
+		return (active ?? false) && state.keys.active != null
 			? select(
-					state.items.active ?? [],
-					key => !(key instanceof GroupComponent),
+					state.keys.active,
+					key => !isGroupKey(key),
 					key => state.values.mapped.get(key as Key)!,
 				)
-			: (state.values.array.filter(item => !(item instanceof GroupComponent)) as PlainObject[]);
+			: (state.values.array.filter(item => !isGroupKey(item)) as PlainObject[]);
 	}
 
-	getIndex(item: DataItem): number {
-		if (item instanceof GroupComponent) {
-			return this.items.indexOf(item);
-		}
-
-		return this.items.findIndex(value =>
-			value instanceof GroupComponent ? value.key === item : value === item,
-		);
+	getIndex(item: Key): number {
+		return this.keys.indexOf(item);
 	}
 
-	async remove(items: Array<Key | PlainObject>, render: boolean): Promise<void> {
+	async remove(items: Array<Key | PlainObject>, render: false): Promise<PlainObject[]>;
+
+	async remove(items: Array<Key | PlainObject>, render: true): Promise<void>;
+
+	async remove(items: Array<Key | PlainObject>, render: boolean): Promise<unknown> {
 		const {state} = this;
 
-		const keys = items.map(
-			value => (isPlainObject(value) ? getValue(value, state.key) : value) as Key,
-		);
+		const keys = items
+			.map(value => (isPlainObject(value) ? getValue(value, state.key) : value) as Key)
+			.filter(key => !isGroupKey(key));
 
 		const {length} = keys;
 
-		if (length > 0) {
-			return this.removeItems(keys, false, render === true);
-		}
+		return length === 0
+			? render
+				? undefined
+				: []
+			: this.removeItems(keys, false, render as never);
 	}
 
-	async removeItems(items: DataItem[], clear: boolean, render: boolean): Promise<void> {
+	async removeItems(data: Key[], clear: boolean, render: false): Promise<PlainObject[]>;
+
+	async removeItems(data: Key[], clear: boolean, render: true): Promise<void>;
+
+	async removeItems(keys: Key[], clear: boolean, render: boolean): Promise<unknown> {
 		const {state} = this;
 
 		if (clear) {
-			state.items.active = undefined;
-			state.items.original = [];
+			state.keys.active = undefined;
+			state.keys.original = [];
 			state.values.array = [];
 
 			state.values.mapped.clear();
@@ -179,39 +222,48 @@ export class DataManager {
 				state.managers.group.clear();
 			}
 
-			return this.render();
+			state.managers.event.emit(EVENT_DATA_CLEAR);
+
+			this.render();
+
+			return render ? undefined : [];
 		}
 
-		const groups: GroupComponent[] = [];
+		const removedGroups: GroupComponent[] = [];
+		const updatedGroups: GroupComponent[] = [];
+
+		const removedData: PlainObject[] = [];
 
-		const chunked = chunk(items);
+		const chunked = chunk(keys);
 		const chunkedLength = chunked.length;
 
 		for (let chunkedIndex = 0; chunkedIndex < chunkedLength; chunkedIndex += 1) {
 			const chunk = chunked[chunkedIndex];
 			const chunkLength = chunk.length;
 
-			for (let itemIndex = 0; itemIndex < chunkLength; itemIndex += 1) {
-				const item = chunk[itemIndex];
-				const dataIndex = state.items.original.indexOf(item);
+			for (let keyIndex = 0; keyIndex < chunkLength; keyIndex += 1) {
+				const key = chunk[keyIndex];
+				const dataIndex = state.keys.original.indexOf(key);
 
 				let dataValue: PlainObject | undefined;
 
 				[dataValue] = state.values.array.splice(dataIndex, 1) as PlainObject[];
 
-				state.items.original.splice(dataIndex, 1);
-				state.managers.row.remove(item as never);
-				state.values.mapped.delete(item as Key);
+				removedData.push(dataValue);
+
+				state.keys.original.splice(dataIndex, 1);
+				state.managers.row.remove(key as never);
+				state.values.mapped.delete(key as Key);
 
-				if (!state.managers.group.enabled || item instanceof GroupComponent) {
+				if (!state.managers.group.enabled || isGroupKey(key)) {
 					continue;
 				}
 
-				state.managers.group.collapsed.delete(item as never);
+				state.managers.group.collapsed.delete(key as never);
 
-				const groupKey = getValue(dataValue, state.managers.group.field) as unknown;
+				const groupValue = getValue(dataValue, state.managers.group.key) as unknown;
 
-				const group = state.managers.group.get(groupKey);
+				const group = state.managers.group.getForValue(groupValue);
 
 				if (group == null) {
 					continue;
@@ -220,41 +272,57 @@ export class DataManager {
 				group.total -= 1;
 
 				if (group.total > 0) {
-					groups.push(group);
+					updatedGroups.push(group);
 
 					continue;
 				}
 
-				let groupIndex = groups.indexOf(group);
+				let groupIndex = updatedGroups.indexOf(group);
 
 				if (groupIndex > -1) {
-					groups.splice(groupIndex, 1);
+					updatedGroups.splice(groupIndex, 1);
 				}
 
-				groupIndex = state.values.array.indexOf(group);
+				groupIndex = state.values.array.indexOf(group.key);
 
 				if (groupIndex > -1) {
-					state.items.original.splice(groupIndex, 1);
+					state.keys.original.splice(groupIndex, 1);
 					state.values.array.splice(groupIndex, 1);
 				}
 
-				state.managers.group.remove(group);
+				removedGroups.push(group);
 
-				if (items.length >= 10_000) {
+				state.managers.group.remove(group, false);
+
+				if (keys.length >= 10_000) {
 					await delay(25);
 				}
 			}
 		}
 
-		const {length} = groups;
+		let {length} = updatedGroups;
 
-		for (let index = 0; index < length; index += 1) {
-			updateGroup(state, groups[index]);
+		if (length > 0) {
+			for (let index = 0; index < length; index += 1) {
+				updateGroup(state, updatedGroups[index], false);
+			}
+
+			state.managers.event.emit(EVENT_GROUP_UPDATE, updatedGroups.map(getGroup));
 		}
 
+		length = removedGroups.length;
+
+		if (length > 0) {
+			state.managers.event.emit(EVENT_GROUP_REMOVE, removedGroups.map(getGroup));
+		}
+
+		state.managers.event.emit(EVENT_DATA_REMOVE, removedData);
+
 		if (render) {
-			return this.render();
+			this.render();
 		}
+
+		return render ? undefined : removedData;
 	}
 
 	render(): void {
@@ -263,25 +331,27 @@ export class DataManager {
 		if (state.managers.group.enabled) {
 			sortWithGroups(state, state.values.array, [
 				{
-					direction: 'ascending',
+					direction: SORT_ASCENDING,
 					key: state.key,
 				},
 			]);
 		} else {
 			sort(state.values.array as PlainObject[], [
 				{
-					direction: 'ascending',
+					direction: SORT_ASCENDING,
 					key: state.key,
 				},
 			]);
 		}
 
-		state.items.original = state.values.array.map(item =>
-			item instanceof GroupComponent ? item : (getValue(item, state.key) as Key),
+		state.keys.active = undefined;
+
+		state.keys.original = state.values.array.map(item =>
+			typeof item === 'string' ? item : (getValue(item, state.key) as Key),
 		);
 
 		state.values.mapped = toMap(
-			state.values.array.filter(item => !(item instanceof GroupComponent)) as PlainObject[],
+			state.values.array.filter(item => !isGroupKey(item)) as PlainObject[],
 			item => getValue(item, state.key) as Key,
 		);
 
@@ -297,12 +367,12 @@ export class DataManager {
 	set(data: PlainObject[]): void {
 		const {state} = this;
 
-		const array: Array<GroupComponent | PlainObject> = data.slice();
+		const array: DataValue[] = data.slice();
 
 		if (state.managers.group.enabled) {
-			const column = state.managers.column.get(state.managers.group.field);
+			const column = state.managers.column.get(state.managers.group.key);
 
-			const grouped = toRecord.arrays(data, state.managers.group.field) as Record<
+			const grouped = toRecord.arrays(data, state.managers.group.key) as Record<
 				string,
 				PlainObject[]
 			>;
@@ -316,7 +386,7 @@ export class DataManager {
 				const [value, items] = entries[index];
 
 				const group = new GroupComponent(
-					`${column?.options.title ?? state.managers.group.field}: ${value}`,
+					`${column?.options.label ?? state.managers.group.key}: ${value}`,
 					value,
 				);
 
@@ -324,7 +394,7 @@ export class DataManager {
 
 				groups.push(group);
 
-				array.push(group);
+				array.push(group.key);
 			}
 
 			state.managers.group.set(groups);
@@ -335,10 +405,10 @@ export class DataManager {
 		this.render();
 	}
 
-	async synchronize(data: PlainObject[], remove?: boolean): Promise<void> {
+	async synchronize(data: PlainObject[], remove: boolean): Promise<void> {
 		const {state} = this;
 
-		const add: PlainObject[] = [];
+		const added: PlainObject[] = [];
 		const updated: PlainObject[] = [];
 
 		const keys = new Set<Key>([]);
@@ -352,7 +422,7 @@ export class DataManager {
 			if (state.values.mapped.has(key)) {
 				updated.push(object);
 			} else {
-				add.push(object);
+				added.push(object);
 			}
 
 			keys.add(key);
@@ -362,43 +432,62 @@ export class DataManager {
 			return;
 		}
 
-		if (remove ?? false) {
-			const toRemove = state.items.original.filter(
-				key => !(key instanceof GroupComponent) && !keys.has(key),
+		let removed: PlainObject[] = [];
+
+		if (remove) {
+			const toRemove = state.keys.original.filter(
+				key => !isGroupKey(key) && !keys.has(key),
 			) as Key[];
 
 			if (toRemove.length > 0) {
-				await this.remove(toRemove, false);
+				removed = await this.remove(toRemove, false);
 			}
 		}
 
-		await this.update(updated);
+		await this.update(updated, added.length === 0);
 
-		if (add.length > 0) {
-			await this.add(add, false);
-		}
+		await this.add(added, false);
 
-		if (add.length > 0 || (remove ?? false)) {
+		state.managers.event.emit(EVENT_DATA_SYNCHRONIZE, {
+			added,
+			removed,
+			updated,
+		});
+
+		if (added.length > 0 || remove) {
 			this.render();
 		}
 	}
 
-	async update(data: PlainObject[]): Promise<void> {
+	async update(data: PlainObject[], render: boolean): Promise<void> {
 		const {state} = this;
 
 		const {length} = data;
 
+		const updated: PlainObject[] = [];
+
 		for (let index = 0; index < length; index += 1) {
-			const object = data[index];
+			const item = data[index];
 
-			const key = getValue(object, state.key) as Key;
-			const value = state.values.mapped.get(key);
+			const key = getValue(item, state.key) as Key;
+
+			const existing = state.keys.original.indexOf(key);
+
+			if (existing === -1) {
+				continue;
+			}
+
+			Object.assign(state.values.array[existing], item);
 
-			if (value != null) {
-				state.values.mapped.set(key, {...value, ...object} as PlainObject);
+			updated.push(state.values.array[existing] as PlainObject);
 
+			if (render && state.managers.render.visible.keys.has(key)) {
 				state.managers.row.update(key);
 			}
 		}
+
+		if (updated.length > 0) {
+			state.managers.event.emit(EVENT_DATA_UPDATE, updated);
+		}
 	}
 }

package/src/managers/event.manager.ts

@@ -1,12 +1,49 @@
+import type {GenericCallback} from '@oscarpalmer/atoms/models';
 import {on} from '@oscarpalmer/toretto/event';
 import {findAncestor} from '@oscarpalmer/toretto/find';
+import {isEvent} from '../helpers/misc.helpers';
+import {
+	ATTRIBUTE_DATA_EVENT,
+	ATTRIBUTE_DATA_KEY,
+	ATTRIBUTE_DATA_SORT_DIRECTION,
+} from '../models/dom.model';
+import {
+	EVENT_GROUP,
+	EVENT_HEADING,
+	EVENT_ROW,
+	type EventMap,
+	type EventName,
+	type Events,
+	type TabelaEvents,
+} from '../models/event.model';
+import {CSS_TABLE} from '../models/style.model';
 import type {State} from '../models/tabela.model';
 
 export class EventManager {
+	events: Events = {};
+
+	handlers: TabelaEvents = {
+		subscribe: (name, callback) => this.subscribe(name, callback),
+		unsubscribe: (name, callback) => this.unsubscribe(name, callback),
+	};
+
 	constructor(public state: State) {
 		mapped.set(state.element, this);
 	}
 
+	emit<Name extends EventName>(name: Name, ...parameters: Parameters<EventMap[Name]>): void {
+		if (this.events[name] == null) {
+			return;
+		}
+
+		const handlers = [...this.events[name]];
+		const {length} = handlers;
+
+		for (let index = 0; index < length; index += 1) {
+			(handlers[index] as GenericCallback)(...parameters);
+		}
+	}
+
 	destroy(): void {
 		mapped.delete(this.state.element);
 
@@ -14,18 +51,34 @@ export class EventManager {
 	}
 
 	onSort(event: MouseEvent, target: HTMLElement): void {
-		const direction = target.getAttribute('data-sort-direction');
-		const field = target.getAttribute('data-field');
+		const direction = target.getAttribute(ATTRIBUTE_DATA_SORT_DIRECTION);
+		const key = target.getAttribute(ATTRIBUTE_DATA_KEY);
+
+		if (key != null) {
+			this.state.managers.sort.toggle(event, key, direction);
+		}
+	}
 
-		if (field != null) {
-			this.state.managers.sort.toggle(event, field, direction);
+	subscribe(name: string, callback: GenericCallback): void {
+		if (!isEvent(name) || typeof callback !== 'function') {
+			return;
+		}
+
+		(this.events as Record<string, Set<unknown>>)[name] ??= new Set();
+
+		(this.events[name] as Set<unknown>).add(callback);
+	}
+
+	unsubscribe(name: string, callback: GenericCallback): void {
+		if (isEvent(name) && typeof callback === 'function') {
+			this.events[name]?.delete(callback);
 		}
 	}
 }
 
 function onClick(event: MouseEvent): void {
-	const target = findAncestor(event, '[data-event]');
-	const table = findAncestor(event, '.tabela__table');
+	const target = findAncestor(event, eventAttribute);
+	const table = findAncestor(event, tableClassName);
 
 	if (!(target instanceof HTMLElement) || !(table instanceof HTMLElement)) {
 		return;
@@ -37,18 +90,18 @@ function onClick(event: MouseEvent): void {
 		return;
 	}
 
-	const type = target?.getAttribute('data-event');
+	const type = target?.getAttribute(ATTRIBUTE_DATA_EVENT);
 
 	switch (type) {
-		case 'group':
+		case EVENT_GROUP:
 			manager.state.managers.group.handle(target);
 			break;
 
-		case 'heading':
+		case EVENT_HEADING:
 			manager.onSort(event, target);
 			break;
 
-		case 'row':
+		case EVENT_ROW:
 			manager.state.managers.selection.handle(event, target);
 			break;
 
@@ -58,8 +111,8 @@ function onClick(event: MouseEvent): void {
 }
 
 function onKeydown(event: KeyboardEvent): void {
-	const target = findAncestor(event, '[data-event]');
-	const table = findAncestor(event, '.tabela__table');
+	const target = findAncestor(event, eventAttribute);
+	const table = findAncestor(event, tableClassName);
 
 	if (!(target instanceof HTMLElement) || !(table instanceof HTMLElement)) {
 		return;
@@ -82,7 +135,11 @@ function onKeydown(event: KeyboardEvent): void {
 	manager.state.managers.navigation.handle(event);
 }
 
+const eventAttribute = `[${ATTRIBUTE_DATA_EVENT}]`;
+
 const mapped = new WeakMap<HTMLElement, EventManager>();
 
+const tableClassName = `.${CSS_TABLE}`;
+
 on(document, 'click', onClick);
 on(document, 'keydown', onKeydown, {passive: false});