@sprawlify/primitives 0.0.51 → 0.0.53

package/dist/machines/steps/index.mjs

@@ -24,6 +24,12 @@ function connect(service, normalize) {
 	const percent = computed("percent");
 	const hasNextStep = computed("hasNextStep");
 	const hasPrevStep = computed("hasPrevStep");
+	const isStepValid = (index) => {
+		return prop("isStepValid")?.(index) ?? true;
+	};
+	const isStepSkippable = (index) => {
+		return prop("isStepSkippable")?.(index) ?? false;
+	};
 	const getItemState = (props$1) => ({
 		triggerId: getTriggerId(scope, props$1.index),
 		contentId: getContentId(scope, props$1.index),
@@ -32,7 +38,9 @@ function connect(service, normalize) {
 		incomplete: props$1.index > step,
 		index: props$1.index,
 		first: props$1.index === 0,
-		last: props$1.index === count - 1
+		last: props$1.index === count - 1,
+		skippable: isStepSkippable(props$1.index),
+		isValid: () => isStepValid(props$1.index)
 	});
 	const goToNextStep = () => {
 		send({
@@ -66,6 +74,8 @@ function connect(service, normalize) {
 		hasNextStep,
 		hasPrevStep,
 		isCompleted: computed("completed"),
+		isStepValid,
+		isStepSkippable,
 		goToNextStep,
 		goToPrevStep,
 		resetStep,
@@ -98,7 +108,8 @@ function connect(service, normalize) {
 				...parts.item.attrs,
 				dir: prop("dir"),
 				"aria-current": itemState.current ? "step" : void 0,
-				"data-orientation": prop("orientation")
+				"data-orientation": prop("orientation"),
+				"data-skippable": dataAttr(itemState.skippable)
 			});
 		},
 		getTriggerProps(props$1) {
@@ -233,34 +244,65 @@ const machine = createMachine({
 	initialState() {
 		return "idle";
 	},
-	entry: ["validateStep"],
+	entry: ["validateStepIndex"],
 	states: { idle: { on: {
-		"STEP.SET": { actions: ["setStep"] },
-		"STEP.NEXT": { actions: ["goToNextStep"] },
+		"STEP.SET": [{
+			guard: "isValidStepNavigation",
+			actions: ["setStep"]
+		}, { actions: ["invokeOnStepInvalid"] }],
+		"STEP.NEXT": [{
+			guard: "isCurrentStepValid",
+			actions: ["goToNextStep"]
+		}, { actions: ["invokeOnStepInvalid"] }],
 		"STEP.PREV": { actions: ["goToPrevStep"] },
 		"STEP.RESET": { actions: ["resetStep"] }
 	} } },
-	implementations: { actions: {
-		goToNextStep({ context, prop }) {
-			const value = Math.min(context.get("step") + 1, prop("count"));
-			context.set("step", value);
-		},
-		goToPrevStep({ context }) {
-			const value = Math.max(context.get("step") - 1, 0);
-			context.set("step", value);
-		},
-		resetStep({ context }) {
-			context.set("step", 0);
-		},
-		setStep({ context, event }) {
-			context.set("step", event.value);
+	implementations: {
+		guards: {
+			isCurrentStepValid({ context, prop }) {
+				const current = context.get("step");
+				if (prop("isStepSkippable")?.(current)) return true;
+				const isStepValid = prop("isStepValid");
+				if (!isStepValid) return true;
+				return isStepValid(current);
+			},
+			isValidStepNavigation({ context, event, prop }) {
+				const current = context.get("step");
+				if (event.value <= current) return true;
+				if (prop("isStepSkippable")?.(current)) return true;
+				const isStepValid = prop("isStepValid");
+				if (!isStepValid) return true;
+				return isStepValid(current);
+			}
 		},
-		validateStep({ context, prop }) {
-			validateStep(prop("count"), context.get("step"));
+		actions: {
+			goToNextStep({ context, prop }) {
+				const count = prop("count");
+				context.set("step", Math.min(context.get("step") + 1, count));
+			},
+			goToPrevStep({ context }) {
+				context.set("step", Math.max(context.get("step") - 1, 0));
+			},
+			resetStep({ context }) {
+				context.set("step", 0);
+			},
+			setStep({ context, event }) {
+				context.set("step", event.value);
+			},
+			validateStepIndex({ context, prop }) {
+				validateStepIndex(prop("count"), context.get("step"));
+			},
+			invokeOnStepInvalid({ context, event, prop }) {
+				prop("onStepInvalid")?.({
+					step: context.get("step"),
+					action: event.type === "STEP.NEXT" ? "next" : "set",
+					targetStep: event.value
+				});
+			}
 		}
-	} }
+	}
 });
-const validateStep = (count, step) => {
+const validateStepIndex = (count, step) => {
 	if (!isValueWithinRange(step, 0, count)) throw new RangeError(`[sprawlify-js/steps] step index ${step} is out of bounds`);
 };
 
@@ -268,13 +310,17 @@ const validateStep = (count, step) => {
 //#region src/machines/steps/steps.props.ts
 const props = createProps()([
 	"count",
+	"defaultStep",
 	"dir",
 	"getRootNode",
 	"id",
 	"ids",
+	"isStepSkippable",
+	"isStepValid",
 	"linear",
 	"onStepChange",
 	"onStepComplete",
+	"onStepInvalid",
 	"orientation",
 	"step",
 	"defaultStep"

package/dist/machines/switch/index.d.cts

@@ -3,7 +3,7 @@ import { p as Machine, u as EventObject, y as Service } from "../../types-DejIu6
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-Bqw3r34-.cjs";
 
 //#region src/machines/switch/switch.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "control" | "label" | "thumb">;
+declare const anatomy: AnatomyInstance<"root" | "label" | "control" | "thumb">;
 //#endregion
 //#region src/machines/switch/switch.types.d.ts
 interface CheckedChangeDetails {

package/dist/machines/switch/index.d.mts

@@ -3,7 +3,7 @@ import { p as Machine, u as EventObject, y as Service } from "../../types-DL5AIQ
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-BuUzJjaP.mjs";
 
 //#region src/machines/switch/switch.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "control" | "label" | "thumb">;
+declare const anatomy: AnatomyInstance<"root" | "label" | "control" | "thumb">;
 //#endregion
 //#region src/machines/switch/switch.types.d.ts
 interface CheckedChangeDetails {

package/dist/machines/tabs/index.d.cts

@@ -3,7 +3,7 @@ import { p as Machine, u as EventObject, y as Service } from "../../types-DejIu6
 import { b as NormalizeProps, g as RequiredBy, m as Rect, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-Bqw3r34-.cjs";
 
 //#region src/machines/tabs/tabs.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "trigger" | "indicator" | "content" | "list">;
+declare const anatomy: AnatomyInstance<"content" | "trigger" | "root" | "indicator" | "list">;
 //#endregion
 //#region src/machines/tabs/tabs.types.d.ts
 interface ValueChangeDetails {

package/dist/machines/tabs/index.d.mts

@@ -3,7 +3,7 @@ import { p as Machine, u as EventObject, y as Service } from "../../types-DL5AIQ
 import { b as NormalizeProps, g as RequiredBy, m as Rect, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-BuUzJjaP.mjs";
 
 //#region src/machines/tabs/tabs.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "trigger" | "indicator" | "content" | "list">;
+declare const anatomy: AnatomyInstance<"content" | "trigger" | "root" | "indicator" | "list">;
 //#endregion
 //#region src/machines/tabs/tabs.types.d.ts
 interface ValueChangeDetails {

package/dist/machines/tags-input/index.d.cts

@@ -5,7 +5,7 @@ import { c as PointerDownOutsideEvent, i as InteractOutsideHandlers, n as FocusO
 import { t as LiveRegion } from "../../index-Owca7uxB.cjs";
 
 //#region src/machines/tags-input/tags-input.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "control" | "input" | "label" | "item" | "itemText" | "clearTrigger" | "itemDeleteTrigger" | "itemInput" | "itemPreview">;
+declare const anatomy: AnatomyInstance<"input" | "root" | "label" | "control" | "item" | "itemDeleteTrigger" | "itemInput" | "clearTrigger" | "itemText" | "itemPreview">;
 //#endregion
 //#region src/machines/tags-input/tags-input.types.d.ts
 interface ValueChangeDetails {

package/dist/machines/tags-input/index.d.mts

@@ -5,7 +5,7 @@ import { c as PointerDownOutsideEvent, i as InteractOutsideHandlers, n as FocusO
 import { t as LiveRegion } from "../../index-CygfPLvT.mjs";
 
 //#region src/machines/tags-input/tags-input.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "control" | "input" | "label" | "item" | "itemText" | "clearTrigger" | "itemDeleteTrigger" | "itemInput" | "itemPreview">;
+declare const anatomy: AnatomyInstance<"input" | "root" | "label" | "control" | "item" | "itemDeleteTrigger" | "itemInput" | "clearTrigger" | "itemText" | "itemPreview">;
 //#endregion
 //#region src/machines/tags-input/tags-input.types.d.ts
 interface ValueChangeDetails {

package/dist/machines/timer/index.d.cts

@@ -3,7 +3,7 @@ import { p as Machine, u as EventObject, y as Service } from "../../types-DejIu6
 import { b as NormalizeProps, g as RequiredBy, t as CommonProperties, x as PropTypes } from "../../index-Bqw3r34-.cjs";
 
 //#region src/machines/timer/timer.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "control" | "item" | "area" | "itemValue" | "itemLabel" | "actionTrigger" | "separator">;
+declare const anatomy: AnatomyInstance<"actionTrigger" | "root" | "control" | "item" | "area" | "separator" | "itemLabel" | "itemValue">;
 //#endregion
 //#region src/machines/timer/timer.types.d.ts
 interface Time<T = number> {

package/dist/machines/timer/index.d.mts

@@ -3,7 +3,7 @@ import { p as Machine, u as EventObject, y as Service } from "../../types-DL5AIQ
 import { b as NormalizeProps, g as RequiredBy, t as CommonProperties, x as PropTypes } from "../../index-BuUzJjaP.mjs";
 
 //#region src/machines/timer/timer.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "control" | "item" | "area" | "itemValue" | "itemLabel" | "actionTrigger" | "separator">;
+declare const anatomy: AnatomyInstance<"actionTrigger" | "root" | "control" | "item" | "area" | "separator" | "itemLabel" | "itemValue">;
 //#endregion
 //#region src/machines/timer/timer.types.d.ts
 interface Time<T = number> {

package/dist/machines/toast/index.d.cts

@@ -176,7 +176,7 @@ interface ToastApi<T extends PropTypes = PropTypes, O = any> {
 declare function groupConnect<T extends PropTypes, O = any>(service: Service<ToastGroupSchema>, normalize: NormalizeProps<T>): ToastGroupApi<T, O>;
 //#endregion
 //#region src/machines/toast/toast.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "actionTrigger" | "title" | "group" | "description" | "closeTrigger">;
+declare const anatomy: AnatomyInstance<"actionTrigger" | "closeTrigger" | "title" | "description" | "root" | "group">;
 //#endregion
 //#region src/machines/toast/toast.connect.d.ts
 declare function connect<T extends PropTypes, O>(service: Service<ToastSchema<O>>, normalize: NormalizeProps<T>): ToastApi<T, O>;

package/dist/machines/toast/index.d.mts

@@ -176,7 +176,7 @@ interface ToastApi<T extends PropTypes = PropTypes, O = any> {
 declare function groupConnect<T extends PropTypes, O = any>(service: Service<ToastGroupSchema>, normalize: NormalizeProps<T>): ToastGroupApi<T, O>;
 //#endregion
 //#region src/machines/toast/toast.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "actionTrigger" | "title" | "group" | "description" | "closeTrigger">;
+declare const anatomy: AnatomyInstance<"actionTrigger" | "closeTrigger" | "title" | "description" | "root" | "group">;
 //#endregion
 //#region src/machines/toast/toast.connect.d.ts
 declare function connect<T extends PropTypes, O>(service: Service<ToastSchema<O>>, normalize: NormalizeProps<T>): ToastApi<T, O>;

package/dist/machines/tooltip/index.d.cts

@@ -4,7 +4,7 @@ import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as Comm
 import { c as Placement, d as PositioningOptions } from "../../types-D5ziaMrd.cjs";
 
 //#region src/machines/tooltip/tooltip.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"trigger" | "content" | "arrow" | "positioner" | "arrowTip">;
+declare const anatomy: AnatomyInstance<"content" | "positioner" | "arrow" | "arrowTip" | "trigger">;
 //#endregion
 //#region src/machines/tooltip/tooltip.types.d.ts
 interface OpenChangeDetails {

package/dist/machines/tooltip/index.d.mts

@@ -4,7 +4,7 @@ import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as Comm
 import { p as PositioningOptions, u as Placement } from "../../index-BTi1wETB.mjs";
 
 //#region src/machines/tooltip/tooltip.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"trigger" | "content" | "arrow" | "positioner" | "arrowTip">;
+declare const anatomy: AnatomyInstance<"content" | "positioner" | "arrow" | "arrowTip" | "trigger">;
 //#endregion
 //#region src/machines/tooltip/tooltip.types.d.ts
 interface OpenChangeDetails {

package/dist/machines/tour/index.d.cts

@@ -6,7 +6,7 @@ import { c as PointerDownOutsideEvent, i as InteractOutsideHandlers, n as FocusO
 import { c as Placement } from "../../types-D5ziaMrd.cjs";
 
 //#region src/machines/tour/tour.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"content" | "arrow" | "actionTrigger" | "positioner" | "arrowTip" | "title" | "progressText" | "description" | "closeTrigger" | "backdrop" | "spotlight">;
+declare const anatomy: AnatomyInstance<"content" | "actionTrigger" | "closeTrigger" | "progressText" | "title" | "description" | "positioner" | "arrow" | "arrowTip" | "backdrop" | "spotlight">;
 //#endregion
 //#region src/machines/tour/utils/rect.d.ts
 interface Point {

package/dist/machines/tour/index.d.mts

@@ -6,7 +6,7 @@ import { c as PointerDownOutsideEvent, i as InteractOutsideHandlers, n as FocusO
 import { u as Placement } from "../../index-BTi1wETB.mjs";
 
 //#region src/machines/tour/tour.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"content" | "arrow" | "actionTrigger" | "positioner" | "arrowTip" | "title" | "progressText" | "description" | "closeTrigger" | "backdrop" | "spotlight">;
+declare const anatomy: AnatomyInstance<"content" | "actionTrigger" | "closeTrigger" | "progressText" | "title" | "description" | "positioner" | "arrow" | "arrowTip" | "backdrop" | "spotlight">;
 //#endregion
 //#region src/machines/tour/utils/rect.d.ts
 interface Point {

package/dist/machines/tree-view/index.cjs

@@ -1,7 +1,7 @@
 const require_create_anatomy = require('../../create-anatomy-CDsIFUXg.cjs');
 const require_dom_query = require('../../dom-query-ClqjTSZC.cjs');
 const require_utils = require('../../utils-B4_qn2dt.cjs');
-const require_collection = require('../../collection-C5tUixCe.cjs');
+const require_collection = require('../../collection-Q52RkxUe.cjs');
 const require_core = require('../../core-NCx2blZX.cjs');
 const require_create_props = require('../../create-props-l5q5b8Wo.cjs');
 
@@ -76,18 +76,21 @@ function connect(service, normalize) {
 	const focusedValue = context.get("focusedValue");
 	const loadingStatus = context.get("loadingStatus");
 	const renamingValue = context.get("renamingValue");
+	const skip = ({ indexPath }) => {
+		return collection$1.getValuePath(indexPath).slice(0, -1).some((value) => !expandedValue.includes(value));
+	};
+	const firstNode = collection$1.getFirstNode(void 0, { skip });
+	const firstNodeValue = firstNode ? collection$1.getNodeValue(firstNode) : null;
 	function getNodeState(props$1) {
 		const { node, indexPath } = props$1;
 		const value = collection$1.getNodeValue(node);
-		const firstNode = collection$1.getFirstNode();
-		const firstNodeValue = firstNode ? collection$1.getNodeValue(firstNode) : null;
 		return {
 			id: getNodeId(scope, value),
 			value,
 			indexPath,
 			valuePath: collection$1.getValuePath(indexPath),
 			disabled: Boolean(node.disabled),
-			focused: focusedValue == null ? firstNodeValue == value : focusedValue === value,
+			focused: focusedValue == null ? firstNodeValue === value : focusedValue === value,
 			selected: selectedValue.includes(value),
 			expanded: expandedValue.includes(value),
 			loading: loadingStatus[value] === "loading",
@@ -971,7 +974,8 @@ const machine = require_core.createMachine({
 			focusTreeFirstNode(params) {
 				const { prop, scope } = params;
 				const collection$1 = prop("collection");
-				const firstNode = collection$1.getFirstNode();
+				const firstNode = collection$1.getFirstNode(void 0, { skip: skipFn(params) });
+				if (!firstNode) return;
 				const firstValue = collection$1.getNodeValue(firstNode);
 				if (scrollToNode(params, firstValue)) require_dom_query.raf(() => focusNode(scope, firstValue));
 				else focusNode(scope, firstValue);
@@ -988,7 +992,8 @@ const machine = require_core.createMachine({
 				const { event, prop, scope } = params;
 				const collection$1 = prop("collection");
 				const branchNode = collection$1.findNode(event.id);
-				const firstNode = collection$1.getFirstNode(branchNode);
+				const firstNode = collection$1.getFirstNode(branchNode, { skip: skipFn(params) });
+				if (!firstNode) return;
 				const firstValue = collection$1.getNodeValue(firstNode);
 				if (scrollToNode(params, firstValue)) require_dom_query.raf(() => focusNode(scope, firstValue));
 				else focusNode(scope, firstValue);

package/dist/machines/tree-view/index.d.cts

@@ -1,12 +1,12 @@
 import { n as AnatomyInstance } from "../../create-anatomy-smWrirg1.cjs";
 import { f as TreeCollectionOptions, g as ValuePath, p as TreeNode, s as FilePathTreeNode, u as IndexPath } from "../../types-CADkcKtr.cjs";
-import { t as TreeCollection } from "../../tree-collection-Dlv1BAsc.cjs";
+import { t as TreeCollection } from "../../tree-collection-CmehimuO.cjs";
 import { p as Machine, y as Service } from "../../types-DejIu60O.cjs";
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-Bqw3r34-.cjs";
 import { n as TypeaheadState } from "../../typeahead-BdNwVP09.cjs";
 
 //#region src/machines/tree-view/tree-view.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemIndicator" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "itemText" | "nodeCheckbox" | "nodeRenameInput" | "tree">;
+declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemText" | "itemIndicator" | "tree" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "nodeCheckbox" | "nodeRenameInput">;
 //#endregion
 //#region src/machines/tree-view/tree-view.collection.d.ts
 declare const collection: {

package/dist/machines/tree-view/index.d.mts

@@ -1,12 +1,12 @@
 import { n as AnatomyInstance } from "../../create-anatomy-DHVOqZET.mjs";
 import { f as TreeCollectionOptions, g as ValuePath, p as TreeNode, s as FilePathTreeNode, u as IndexPath } from "../../types-Df8ZhdY-.mjs";
-import { t as TreeCollection } from "../../tree-collection-DYIVkVee.mjs";
+import { t as TreeCollection } from "../../tree-collection-CqXQBHwY.mjs";
 import { p as Machine, y as Service } from "../../types-DL5AIQk5.mjs";
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-BuUzJjaP.mjs";
 import { n as TypeaheadState } from "../../typeahead-DMSwLv1e.mjs";
 
 //#region src/machines/tree-view/tree-view.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemIndicator" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "itemText" | "nodeCheckbox" | "nodeRenameInput" | "tree">;
+declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemText" | "itemIndicator" | "tree" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "nodeCheckbox" | "nodeRenameInput">;
 //#endregion
 //#region src/machines/tree-view/tree-view.collection.d.ts
 declare const collection: {

package/dist/machines/tree-view/index.mjs

@@ -1,7 +1,7 @@
 import { t as createAnatomy } from "../../create-anatomy-CArN8dVu.mjs";
 import { W as raf, bt as isLeftClick, cn as isEditableElement, ht as isComposingEvent, on as isAnchorElement, ot as setElementValue, pt as getEventTarget, s as getByTypeahead, ut as getEventKey, vn as ariaAttr, xt as isModifierKey, yn as dataAttr } from "../../dom-query-BwpPRIas.mjs";
 import { At as remove, Dt as partition, Mt as toArray, Nt as uniq, _t as diff, ft as isEqual, mt as addOrRemove, nt as isArray, pt as add, t as ensure, u as createSplitProps, vt as first, wt as last } from "../../utils-DSBXwmDm.mjs";
-import { n as filePathToTree, t as TreeCollection } from "../../collection-C85P2ZDW.mjs";
+import { n as filePathToTree, t as TreeCollection } from "../../collection-CjwZd09Z.mjs";
 import { a as createMachine, i as createGuards } from "../../core-BjksCLhs.mjs";
 import { t as createProps } from "../../create-props-SRSjdUTq.mjs";
 
@@ -76,18 +76,21 @@ function connect(service, normalize) {
 	const focusedValue = context.get("focusedValue");
 	const loadingStatus = context.get("loadingStatus");
 	const renamingValue = context.get("renamingValue");
+	const skip = ({ indexPath }) => {
+		return collection$1.getValuePath(indexPath).slice(0, -1).some((value) => !expandedValue.includes(value));
+	};
+	const firstNode = collection$1.getFirstNode(void 0, { skip });
+	const firstNodeValue = firstNode ? collection$1.getNodeValue(firstNode) : null;
 	function getNodeState(props$1) {
 		const { node, indexPath } = props$1;
 		const value = collection$1.getNodeValue(node);
-		const firstNode = collection$1.getFirstNode();
-		const firstNodeValue = firstNode ? collection$1.getNodeValue(firstNode) : null;
 		return {
 			id: getNodeId(scope, value),
 			value,
 			indexPath,
 			valuePath: collection$1.getValuePath(indexPath),
 			disabled: Boolean(node.disabled),
-			focused: focusedValue == null ? firstNodeValue == value : focusedValue === value,
+			focused: focusedValue == null ? firstNodeValue === value : focusedValue === value,
 			selected: selectedValue.includes(value),
 			expanded: expandedValue.includes(value),
 			loading: loadingStatus[value] === "loading",
@@ -971,7 +974,8 @@ const machine = createMachine({
 			focusTreeFirstNode(params) {
 				const { prop, scope } = params;
 				const collection$1 = prop("collection");
-				const firstNode = collection$1.getFirstNode();
+				const firstNode = collection$1.getFirstNode(void 0, { skip: skipFn(params) });
+				if (!firstNode) return;
 				const firstValue = collection$1.getNodeValue(firstNode);
 				if (scrollToNode(params, firstValue)) raf(() => focusNode(scope, firstValue));
 				else focusNode(scope, firstValue);
@@ -988,7 +992,8 @@ const machine = createMachine({
 				const { event, prop, scope } = params;
 				const collection$1 = prop("collection");
 				const branchNode = collection$1.findNode(event.id);
-				const firstNode = collection$1.getFirstNode(branchNode);
+				const firstNode = collection$1.getFirstNode(branchNode, { skip: skipFn(params) });
+				if (!firstNode) return;
 				const firstValue = collection$1.getNodeValue(firstNode);
 				if (scrollToNode(params, firstValue)) raf(() => focusNode(scope, firstValue));
 				else focusNode(scope, firstValue);

package/dist/{selection-CTaapzrB.d.mts → selection-CIoBu9mp.d.mts}

@@ -1,5 +1,5 @@
 import { r as CollectionOptions, t as CollectionItem } from "./types-Df8ZhdY-.mjs";
-import { t as ListCollection } from "./list-collection-BbgocToA.mjs";
+import { t as ListCollection } from "./list-collection-swuCMCIS.mjs";
 
 //#region src/shared/collection/grid-collection.d.ts
 interface GridCollectionOptions<T> extends CollectionOptions<T> {

package/dist/{selection-D3b3yV_x.d.cts → selection-DTpiPgq8.d.cts}

@@ -1,5 +1,5 @@
 import { r as CollectionOptions, t as CollectionItem } from "./types-CADkcKtr.cjs";
-import { t as ListCollection } from "./list-collection-DettiQL3.cjs";
+import { t as ListCollection } from "./list-collection-BslnP0r-.cjs";
 
 //#region src/shared/collection/grid-collection.d.ts
 interface GridCollectionOptions<T> extends CollectionOptions<T> {

package/dist/{tree-collection-Dlv1BAsc.d.cts → tree-collection-CmehimuO.d.cts}

@@ -27,7 +27,7 @@ declare class TreeCollection<T = TreeNode> {
   getNodeDisabled: (node: T) => boolean;
   stringify: (value: string) => string | null;
   stringifyNode: (node: T) => string;
-  getFirstNode: (rootNode?: T) => T | undefined;
+  getFirstNode: (rootNode?: T, opts?: TreeSkipOptions<T>) => T | undefined;
   getLastNode: (rootNode?: T, opts?: TreeSkipOptions<T>) => T | undefined;
   at: (indexPath: IndexPath) => T | undefined;
   findNode: (value: string, rootNode?: T) => T | undefined;

package/dist/{tree-collection-DYIVkVee.d.mts → tree-collection-CqXQBHwY.d.mts}

@@ -27,7 +27,7 @@ declare class TreeCollection<T = TreeNode> {
   getNodeDisabled: (node: T) => boolean;
   stringify: (value: string) => string | null;
   stringifyNode: (node: T) => string;
-  getFirstNode: (rootNode?: T) => T | undefined;
+  getFirstNode: (rootNode?: T, opts?: TreeSkipOptions<T>) => T | undefined;
   getLastNode: (rootNode?: T, opts?: TreeSkipOptions<T>) => T | undefined;
   at: (indexPath: IndexPath) => T | undefined;
   findNode: (value: string, rootNode?: T) => T | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sprawlify/primitives",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "type": "module",
   "description": "A set of primitive components for building user interfaces.",
   "author": "sprawlify <npm@sprawlify.com>",