@xaendar/core 0.6.5 → 0.6.6

package/dist/xaendar-core.es.d.ts

@@ -152,6 +152,16 @@ export { Event_2 as Event }
  */
 export declare type EventOptions = Beautify<RequireOne<Omit<CustomEventInit, 'detail'>>>;
 
+/**
+ * Reactively iterates over a list of items, re-running the loop whenever the tracked condition changes.
+ * Previous iteration side-effects are cleaned up before each re-evaluation.
+ *
+ * @param unwatchFns - Array collecting cleanup functions for the parent scope.
+ * @param condition - A reactive function that returns the array of items to iterate over.
+ * @param forFn - A callback invoked for each item, receiving the item and its index. Must return an array of cleanup functions.
+ */
+export declare function _for(unwatchFns: NoArgsVoidFunction[], condition: () => unknown[], forFn: (item: unknown, index: number) => NoArgsVoidFunction[]): void;
+
 /**
  * Creates a reactive conditional structure from a list of branches.
  *
@@ -227,6 +237,18 @@ export declare type InputSignalOptions<ActualValue = unknown, IncomingValue = Ac
     transform?: (value: IncomingValue) => ActualValue;
 };
 
+/**
+ * Builds a record of iteration context variables for a given index in the loop.
+ * Provides the current item, index, and convenience flags (`$first`, `$last`, `$even`, `$odd`).
+ *
+ * @param items - The full array being iterated.
+ * @param index - The current iteration index.
+ * @param itemAlias - The template alias name for the current item.
+ * @param indexAlias - The template alias name for the current index.
+ * @returns A record mapping alias names and built-in variables to their values.
+ */
+export declare function _iterationVariables(items: unknown[], index: number, itemAlias: string, indexAlias: string): Record<string, unknown>;
+
 /**
  * Rapresent the output type returned by an @Event Decorator in a Web Component.
  *

package/dist/xaendar-core.es.js

@@ -546,6 +546,51 @@ function unwatch(unwatchFns, localUnwatchFns) {
 	}
 }
 //#endregion
+//#region ../packages/core/src/utils/for.utils.ts
+/**
+* Reactively iterates over a list of items, re-running the loop whenever the tracked condition changes.
+* Previous iteration side-effects are cleaned up before each re-evaluation.
+*
+* @param unwatchFns - Array collecting cleanup functions for the parent scope.
+* @param condition - A reactive function that returns the array of items to iterate over.
+* @param forFn - A callback invoked for each item, receiving the item and its index. Must return an array of cleanup functions.
+*/
+function _for(unwatchFns, condition, forFn) {
+	const localUnwatchFns = new Array();
+	const unlistener = effect(() => {
+		unwatch(unwatchFns, localUnwatchFns);
+		const items = condition();
+		Signal.subtle.untrack(() => {
+			for (let i = 0; i < items.length; i++) {
+				localUnwatchFns.push(...forFn(items[i], i));
+				unwatchFns.push(...localUnwatchFns);
+			}
+		});
+	});
+	unwatchFns.push(unlistener);
+}
+/**
+* Builds a record of iteration context variables for a given index in the loop.
+* Provides the current item, index, and convenience flags (`$first`, `$last`, `$even`, `$odd`).
+*
+* @param items - The full array being iterated.
+* @param index - The current iteration index.
+* @param itemAlias - The template alias name for the current item.
+* @param indexAlias - The template alias name for the current index.
+* @returns A record mapping alias names and built-in variables to their values.
+*/
+function _iterationVariables(items, index, itemAlias, indexAlias) {
+	const even = index % 2 === 0;
+	return {
+		[itemAlias]: items[index],
+		[indexAlias]: index,
+		$first: index === 0,
+		$last: index === items.length - 1,
+		$even: even,
+		$odd: !even
+	};
+}
+//#endregion
 //#region ../packages/core/src/utils/switch.utils.ts
 /**
 * Creates a reactive switch/case structure by converting it into an if/else-if chain
@@ -577,4 +622,4 @@ function _switch(unwatchFns, expression, blocks) {
 	})));
 }
 //#endregion
-export { BaseWebComponent, Event, Property, WebComponent, _if, _switch, computed, effect, input, signal, unwatch };
+export { BaseWebComponent, Event, Property, WebComponent, _for, _if, _iterationVariables, _switch, computed, effect, input, signal, unwatch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaendar/core",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "A library containing core utils such as webcomponent base classes and theming support",
   "sideEffects": false,
   "type": "module",
@@ -16,7 +16,7 @@
     }
   },
   "dependencies": {
-    "@xaendar/signals": "0.6.5",
-    "@xaendar/types": "0.6.5"
+    "@xaendar/signals": "0.6.6",
+    "@xaendar/types": "0.6.6"
   }
 }