@sprawlify/primitives 0.1.5 → 0.1.7

package/dist/machines/tour/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_create_anatomy = require("../../create-anatomy-BnwEmNnc.cjs");
 const require_dom_query = require("../../dom-query-BUO7rGsg.cjs");
 const require_utils = require("../../utils-ByNiZU8f.cjs");
-const require_core = require("../../core-DwdPztGA.cjs");
+const require_core = require("../../core-Bw_czdwX.cjs");
 const require_interact_outside = require("../../interact-outside-Bg-QSXqp.cjs");
 const require_dismissable = require("../../dismissable-DxjbwsOf.cjs");
 const require_focus_trap = require("../../focus-trap-BewqTQFt.cjs");
@@ -488,7 +488,7 @@ const machine = require_core.createMachine({
 		};
 	},
 	initialState() {
-		return "tour.inactive";
+		return "tourInactive";
 	},
 	context({ prop, bindable, getContext }) {
 		return {
@@ -565,28 +565,28 @@ const machine = require_core.createMachine({
 		"STEP.CHANGED": [
 			{
 				guard: and("isValidStep", "hasResolvedTarget"),
-				target: "target.scrolling",
+				target: "running.scrolling",
 				actions: ["cleanupStepEffect"]
 			},
 			{
 				guard: and("isValidStep", "hasTarget"),
-				target: "target.resolving",
+				target: "running.resolving",
 				actions: ["cleanupStepEffect"]
 			},
 			{
 				guard: and("isValidStep", "isWaitingStep"),
-				target: "step.waiting",
+				target: "running.waiting",
 				actions: ["cleanupStepEffect"]
 			},
 			{
 				guard: "isValidStep",
-				target: "tour.active",
+				target: "running.active",
 				actions: ["cleanupStepEffect"]
 			}
 		],
 		DISMISS: [{
 			guard: "isLastStep",
-			target: "tour.inactive",
+			target: "tourInactive",
 			actions: [
 				"cleanupAll",
 				"invokeOnDismiss",
@@ -594,7 +594,7 @@ const machine = require_core.createMachine({
 				"clearStep"
 			]
 		}, {
-			target: "tour.inactive",
+			target: "tourInactive",
 			actions: [
 				"cleanupAll",
 				"invokeOnDismiss",
@@ -602,7 +602,7 @@ const machine = require_core.createMachine({
 			]
 		}],
 		SKIP: {
-			target: "tour.inactive",
+			target: "tourInactive",
 			actions: [
 				"cleanupAll",
 				"invokeOnSkip",
@@ -611,49 +611,51 @@ const machine = require_core.createMachine({
 		}
 	},
 	states: {
-		"tour.inactive": {
+		tourInactive: {
 			tags: ["closed"],
 			entry: ["validateSteps"],
 			on: { START: { actions: ["setInitialStep", "invokeOnStart"] } }
 		},
-		"target.resolving": {
-			tags: ["closed"],
-			effects: ["waitForTarget", "waitForTargetTimeout"],
-			on: {
-				"TARGET.NOT_FOUND": {
-					target: "tour.inactive",
-					actions: ["invokeOnNotFound", "clearStep"]
-				},
-				"TARGET.RESOLVED": {
-					target: "target.scrolling",
-					actions: ["setResolvedTarget"]
+		running: { states: {
+			resolving: {
+				tags: ["closed"],
+				effects: ["waitForTarget", "waitForTargetTimeout"],
+				on: {
+					"TARGET.NOT_FOUND": {
+						target: "tourInactive",
+						actions: ["invokeOnNotFound", "clearStep"]
+					},
+					"TARGET.RESOLVED": {
+						target: "scrolling",
+						actions: ["setResolvedTarget"]
+					}
 				}
+			},
+			scrolling: {
+				tags: ["open"],
+				entry: ["scrollToTarget"],
+				effects: [
+					"waitForScrollEnd",
+					"trapFocus",
+					"trackPlacement",
+					"trackDismissableBranch",
+					"trackInteractOutside",
+					"trackEscapeKeydown"
+				],
+				on: { "SCROLL.END": { target: "active" } }
+			},
+			waiting: { tags: ["closed"] },
+			active: {
+				tags: ["open"],
+				effects: [
+					"trapFocus",
+					"trackPlacement",
+					"trackDismissableBranch",
+					"trackInteractOutside",
+					"trackEscapeKeydown"
+				]
 			}
-		},
-		"target.scrolling": {
-			tags: ["open"],
-			entry: ["scrollToTarget"],
-			effects: [
-				"waitForScrollEnd",
-				"trapFocus",
-				"trackPlacement",
-				"trackDismissableBranch",
-				"trackInteractOutside",
-				"trackEscapeKeydown"
-			],
-			on: { "SCROLL.END": { target: "tour.active" } }
-		},
-		"step.waiting": { tags: ["closed"] },
-		"tour.active": {
-			tags: ["open"],
-			effects: [
-				"trapFocus",
-				"trackPlacement",
-				"trackDismissableBranch",
-				"trackInteractOutside",
-				"trackEscapeKeydown"
-			]
-		}
+		} }
 	},
 	implementations: {
 		guards: {
@@ -753,8 +755,8 @@ const machine = require_core.createMachine({
 			validateSteps({ context }) {
 				const ids = /* @__PURE__ */ new Set();
 				context.get("steps").forEach((step) => {
-					if (ids.has(step.id)) throw new Error(`[sprawlify-js/tour] Duplicate step id: ${step.id}`);
-					if (step.target == null && step.type == null) throw new Error(`[sprawlify-js/tour] Step ${step.id} has no target or type. At least one of those is required.`);
+					if (ids.has(step.id)) throw new Error(`[zag-js/tour] Duplicate step id: ${step.id}`);
+					if (step.target == null && step.type == null) throw new Error(`[zag-js/tour] Step ${step.id} has no target or type. At least one of those is required.`);
 					ids.add(step.id);
 				});
 			}
@@ -1011,7 +1013,7 @@ var StepManager = class {
 			goto: (id) => {
 				const targetIdx = findStepIndex(steps, id);
 				if (targetIdx === -1) {
-					require_utils.warn(`[sprawlify-js/tour] Step with id "${id}" not found`);
+					require_utils.warn(`[zag-js/tour] Step with id "${id}" not found`);
 					return;
 				}
 				this.transitionTo(targetIdx);

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

@@ -1,12 +1,12 @@
 import { n as AnatomyInstance } from "../../create-anatomy-9eFQs7lO.cjs";
-import { p as Machine, u as EventObject, y as Service } from "../../types-B24gMTKq.cjs";
+import { b as Service, p as Machine, u as EventObject } from "../../types-u-LWCSDE.cjs";
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-CLRsezW5.cjs";
 import { i as waitForElement, n as WaitForOptions, o as waitForPromise, r as WaitForPromiseReturn } from "../../wait-for-DGDBtAM2.cjs";
 import { c as PointerDownOutsideEvent, i as InteractOutsideHandlers, n as FocusOutsideEvent, r as InteractOutsideEvent } from "../../index-DzWGFhcS.cjs";
 import { c as Placement } from "../../types-CZAtqGqH.cjs";
 
 //#region src/machines/tour/tour.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"progressText" | "title" | "content" | "positioner" | "description" | "backdrop" | "closeTrigger" | "actionTrigger" | "arrow" | "arrowTip" | "spotlight">;
+declare const anatomy: AnatomyInstance<"content" | "title" | "description" | "positioner" | "backdrop" | "arrow" | "actionTrigger" | "closeTrigger" | "progressText" | "arrowTip" | "spotlight">;
 //#endregion
 //#region src/machines/tour/utils/rect.d.ts
 interface Point {
@@ -140,7 +140,7 @@ type ComputedContext = Readonly<{
 }>;
 interface TourSchema {
   tag: "open" | "closed";
-  state: "tour.inactive" | "tour.active" | "step.waiting" | "target.resolving" | "target.scrolling";
+  state: "tourInactive" | "running.resolving" | "running.scrolling" | "running.waiting" | "running.active";
   props: RequiredBy<TourProps, PropsWithDefault>;
   context: PrivateContext;
   refs: Refs;

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

@@ -1,12 +1,12 @@
 import { n as AnatomyInstance } from "../../create-anatomy-BedZVdg0.mjs";
-import { p as Machine, u as EventObject, y as Service } from "../../types-DUM9rzfD.mjs";
+import { b as Service, p as Machine, u as EventObject } from "../../types-DvUmCWsb.mjs";
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-BVFlU3b9.mjs";
 import { i as waitForElement, n as WaitForOptions, o as waitForPromise, r as WaitForPromiseReturn } from "../../wait-for-CV7JYddH.mjs";
 import { c as PointerDownOutsideEvent, i as InteractOutsideHandlers, n as FocusOutsideEvent, r as InteractOutsideEvent } from "../../index-CGNNiDyE.mjs";
-import { u as Placement } from "../../index-BLh1IiOx.mjs";
+import { u as Placement } from "../../index-fMh0VDkR.mjs";
 
 //#region src/machines/tour/tour.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"progressText" | "title" | "content" | "positioner" | "description" | "backdrop" | "closeTrigger" | "actionTrigger" | "arrow" | "arrowTip" | "spotlight">;
+declare const anatomy: AnatomyInstance<"content" | "title" | "description" | "positioner" | "backdrop" | "arrow" | "actionTrigger" | "closeTrigger" | "progressText" | "arrowTip" | "spotlight">;
 //#endregion
 //#region src/machines/tour/utils/rect.d.ts
 interface Point {
@@ -140,7 +140,7 @@ type ComputedContext = Readonly<{
 }>;
 interface TourSchema {
   tag: "open" | "closed";
-  state: "tour.inactive" | "tour.active" | "step.waiting" | "target.resolving" | "target.scrolling";
+  state: "tourInactive" | "running.resolving" | "running.scrolling" | "running.waiting" | "running.active";
   props: RequiredBy<TourProps, PropsWithDefault>;
   context: PrivateContext;
   refs: Refs;

package/dist/machines/tour/index.mjs

@@ -1,7 +1,7 @@
 import { t as createAnatomy } from "../../create-anatomy-Dr0evdYy.mjs";
 import { $t as contains, Qt as getComputedStyle$1, W as raf, fn as isHTMLElement, on as getWindow, r as waitForPromise, t as waitForElement, xn as dataAttr } from "../../dom-query-BFuRs3l4.mjs";
 import { Et as nextIndex, dt as isString, ft as isEqual, i as warn, kt as prevIndex, u as createSplitProps } from "../../utils-VVoZ_v29.mjs";
-import { a as createMachine, c as mergeProps, i as createGuards } from "../../core-Ci9Yu6QI.mjs";
+import { a as createMachine, g as mergeProps, i as createGuards } from "../../core-CTtbW9qh.mjs";
 import { t as trackInteractOutside } from "../../interact-outside-Ba50N1a5.mjs";
 import { t as trackDismissableBranch } from "../../dismissable-B9k5K6f9.mjs";
 import { t as trapFocus } from "../../focus-trap-Do8IUXYh.mjs";
@@ -487,7 +487,7 @@ const machine = createMachine({
 		};
 	},
 	initialState() {
-		return "tour.inactive";
+		return "tourInactive";
 	},
 	context({ prop, bindable, getContext }) {
 		return {
@@ -564,28 +564,28 @@ const machine = createMachine({
 		"STEP.CHANGED": [
 			{
 				guard: and("isValidStep", "hasResolvedTarget"),
-				target: "target.scrolling",
+				target: "running.scrolling",
 				actions: ["cleanupStepEffect"]
 			},
 			{
 				guard: and("isValidStep", "hasTarget"),
-				target: "target.resolving",
+				target: "running.resolving",
 				actions: ["cleanupStepEffect"]
 			},
 			{
 				guard: and("isValidStep", "isWaitingStep"),
-				target: "step.waiting",
+				target: "running.waiting",
 				actions: ["cleanupStepEffect"]
 			},
 			{
 				guard: "isValidStep",
-				target: "tour.active",
+				target: "running.active",
 				actions: ["cleanupStepEffect"]
 			}
 		],
 		DISMISS: [{
 			guard: "isLastStep",
-			target: "tour.inactive",
+			target: "tourInactive",
 			actions: [
 				"cleanupAll",
 				"invokeOnDismiss",
@@ -593,7 +593,7 @@ const machine = createMachine({
 				"clearStep"
 			]
 		}, {
-			target: "tour.inactive",
+			target: "tourInactive",
 			actions: [
 				"cleanupAll",
 				"invokeOnDismiss",
@@ -601,7 +601,7 @@ const machine = createMachine({
 			]
 		}],
 		SKIP: {
-			target: "tour.inactive",
+			target: "tourInactive",
 			actions: [
 				"cleanupAll",
 				"invokeOnSkip",
@@ -610,49 +610,51 @@ const machine = createMachine({
 		}
 	},
 	states: {
-		"tour.inactive": {
+		tourInactive: {
 			tags: ["closed"],
 			entry: ["validateSteps"],
 			on: { START: { actions: ["setInitialStep", "invokeOnStart"] } }
 		},
-		"target.resolving": {
-			tags: ["closed"],
-			effects: ["waitForTarget", "waitForTargetTimeout"],
-			on: {
-				"TARGET.NOT_FOUND": {
-					target: "tour.inactive",
-					actions: ["invokeOnNotFound", "clearStep"]
-				},
-				"TARGET.RESOLVED": {
-					target: "target.scrolling",
-					actions: ["setResolvedTarget"]
+		running: { states: {
+			resolving: {
+				tags: ["closed"],
+				effects: ["waitForTarget", "waitForTargetTimeout"],
+				on: {
+					"TARGET.NOT_FOUND": {
+						target: "tourInactive",
+						actions: ["invokeOnNotFound", "clearStep"]
+					},
+					"TARGET.RESOLVED": {
+						target: "scrolling",
+						actions: ["setResolvedTarget"]
+					}
 				}
+			},
+			scrolling: {
+				tags: ["open"],
+				entry: ["scrollToTarget"],
+				effects: [
+					"waitForScrollEnd",
+					"trapFocus",
+					"trackPlacement",
+					"trackDismissableBranch",
+					"trackInteractOutside",
+					"trackEscapeKeydown"
+				],
+				on: { "SCROLL.END": { target: "active" } }
+			},
+			waiting: { tags: ["closed"] },
+			active: {
+				tags: ["open"],
+				effects: [
+					"trapFocus",
+					"trackPlacement",
+					"trackDismissableBranch",
+					"trackInteractOutside",
+					"trackEscapeKeydown"
+				]
 			}
-		},
-		"target.scrolling": {
-			tags: ["open"],
-			entry: ["scrollToTarget"],
-			effects: [
-				"waitForScrollEnd",
-				"trapFocus",
-				"trackPlacement",
-				"trackDismissableBranch",
-				"trackInteractOutside",
-				"trackEscapeKeydown"
-			],
-			on: { "SCROLL.END": { target: "tour.active" } }
-		},
-		"step.waiting": { tags: ["closed"] },
-		"tour.active": {
-			tags: ["open"],
-			effects: [
-				"trapFocus",
-				"trackPlacement",
-				"trackDismissableBranch",
-				"trackInteractOutside",
-				"trackEscapeKeydown"
-			]
-		}
+		} }
 	},
 	implementations: {
 		guards: {
@@ -752,8 +754,8 @@ const machine = createMachine({
 			validateSteps({ context }) {
 				const ids = /* @__PURE__ */ new Set();
 				context.get("steps").forEach((step) => {
-					if (ids.has(step.id)) throw new Error(`[sprawlify-js/tour] Duplicate step id: ${step.id}`);
-					if (step.target == null && step.type == null) throw new Error(`[sprawlify-js/tour] Step ${step.id} has no target or type. At least one of those is required.`);
+					if (ids.has(step.id)) throw new Error(`[zag-js/tour] Duplicate step id: ${step.id}`);
+					if (step.target == null && step.type == null) throw new Error(`[zag-js/tour] Step ${step.id} has no target or type. At least one of those is required.`);
 					ids.add(step.id);
 				});
 			}
@@ -1010,7 +1012,7 @@ var StepManager = class {
 			goto: (id) => {
 				const targetIdx = findStepIndex(steps, id);
 				if (targetIdx === -1) {
-					warn(`[sprawlify-js/tour] Step with id "${id}" not found`);
+					warn(`[zag-js/tour] Step with id "${id}" not found`);
 					return;
 				}
 				this.transitionTo(targetIdx);

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

@@ -3,7 +3,7 @@ const require_create_anatomy = require("../../create-anatomy-BnwEmNnc.cjs");
 const require_dom_query = require("../../dom-query-BUO7rGsg.cjs");
 const require_utils = require("../../utils-ByNiZU8f.cjs");
 const require_collection = require("../../collection-BBgC8xCb.cjs");
-const require_core = require("../../core-DwdPztGA.cjs");
+const require_core = require("../../core-Bw_czdwX.cjs");
 const require_create_props = require("../../create-props-DP39rHnH.cjs");
 //#region src/machines/tree-view/tree-view.anatomy.ts
 const anatomy = require_create_anatomy.createAnatomy("tree-view").parts("branch", "branchContent", "branchControl", "branchIndentGuide", "branchIndicator", "branchText", "branchTrigger", "item", "itemIndicator", "itemText", "label", "nodeCheckbox", "nodeRenameInput", "root", "tree");

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

@@ -1,12 +1,12 @@
 import { n as AnatomyInstance } from "../../create-anatomy-9eFQs7lO.cjs";
 import { f as TreeCollectionOptions, g as ValuePath, p as TreeNode, s as FilePathTreeNode, u as IndexPath } from "../../types-D-7AMgSE.cjs";
 import { t as TreeCollection } from "../../tree-collection-DlqV5kYO.cjs";
-import { p as Machine, y as Service } from "../../types-B24gMTKq.cjs";
+import { b as Service, p as Machine } from "../../types-u-LWCSDE.cjs";
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-CLRsezW5.cjs";
 import { n as TypeaheadState } from "../../typeahead-DMooWbbX.cjs";
 
 //#region src/machines/tree-view/tree-view.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemIndicator" | "itemText" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "nodeCheckbox" | "nodeRenameInput" | "tree">;
+declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemIndicator" | "itemText" | "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-BedZVdg0.mjs";
 import { f as TreeCollectionOptions, g as ValuePath, p as TreeNode, s as FilePathTreeNode, u as IndexPath } from "../../types-9uw8LHpE.mjs";
 import { t as TreeCollection } from "../../tree-collection-Dlf9EUrT.mjs";
-import { p as Machine, y as Service } from "../../types-DUM9rzfD.mjs";
+import { b as Service, p as Machine } from "../../types-DvUmCWsb.mjs";
 import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-BVFlU3b9.mjs";
 import { n as TypeaheadState } from "../../typeahead-Bbeb1fAR.mjs";
 
 //#region src/machines/tree-view/tree-view.anatomy.d.ts
-declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemIndicator" | "itemText" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "nodeCheckbox" | "nodeRenameInput" | "tree">;
+declare const anatomy: AnatomyInstance<"root" | "label" | "item" | "itemIndicator" | "itemText" | "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

@@ -2,7 +2,7 @@ import { t as createAnatomy } from "../../create-anatomy-Dr0evdYy.mjs";
 import { Ct as isModifierKey, St as isLeftClick, W as raf, _t as isComposingEvent, bn as ariaAttr, cn as isAnchorElement, ct as setElementValue, ft as getEventKey, ht as getEventTarget, s as getByTypeahead, un as isEditableElement, xn as dataAttr } from "../../dom-query-BFuRs3l4.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-VVoZ_v29.mjs";
 import { n as filePathToTree, t as TreeCollection } from "../../collection-DgzidRvr.mjs";
-import { a as createMachine, i as createGuards } from "../../core-Ci9Yu6QI.mjs";
+import { a as createMachine, i as createGuards } from "../../core-CTtbW9qh.mjs";
 import { t as createProps } from "../../create-props-DFW8DUsC.mjs";
 //#region src/machines/tree-view/tree-view.anatomy.ts
 const anatomy = createAnatomy("tree-view").parts("branch", "branchContent", "branchControl", "branchIndentGuide", "branchIndicator", "branchText", "branchTrigger", "item", "itemIndicator", "itemText", "label", "nodeCheckbox", "nodeRenameInput", "root", "tree");

package/dist/popper.d.cts

@@ -53,7 +53,7 @@ declare function getPlacementStyles(options?: Pick<PositioningOptions, "placemen
     readonly zIndex: "inherit";
   };
   floating: {
-    readonly position: "fixed" | "absolute";
+    readonly position: "absolute" | "fixed";
     readonly isolation: "isolate";
     readonly minWidth: "max-content" | undefined;
     readonly width: "var(--reference-width)" | undefined;

package/dist/popper.d.mts

@@ -1,2 +1,2 @@
-import { a as getPlacement, c as Boundary, d as PlacementAlign, f as PlacementSide, i as getPlacementStyles, l as ComputePositionReturn, n as isValidPlacement, o as AnchorRect, p as PositioningOptions, r as GetPlacementStylesOptions, s as AutoUpdateOptions, t as getPlacementSide, u as Placement } from "./index-BLh1IiOx.mjs";
+import { a as getPlacement, c as Boundary, d as PlacementAlign, f as PlacementSide, i as getPlacementStyles, l as ComputePositionReturn, n as isValidPlacement, o as AnchorRect, p as PositioningOptions, r as GetPlacementStylesOptions, s as AutoUpdateOptions, t as getPlacementSide, u as Placement } from "./index-fMh0VDkR.mjs";
 export { AnchorRect, AutoUpdateOptions, Boundary, ComputePositionReturn, GetPlacementStylesOptions, Placement, PlacementAlign, PlacementSide, PositioningOptions, getPlacement, getPlacementSide, getPlacementStyles, isValidPlacement };

package/dist/{types-DUM9rzfD.d.mts → types-DvUmCWsb.d.mts}

@@ -105,14 +105,26 @@ interface Params<T extends Dict> {
   guard: (key: T["guard"] | GuardFn<T>) => boolean | undefined;
 }
 type GuardFn<T extends Dict> = (params: Params<T>) => boolean;
-interface Transition<T extends Dict> {
-  target?: T["state"] | undefined;
+type TopLevelState<S extends string> = S extends `${infer Top}.${string}` ? Top : S;
+type ChildStateKey<S extends string, Parent extends string> = S extends `${Parent}.${infer Rest}` ? Rest extends `${infer Child}.${string}` ? Child : Rest : never;
+type ParentPath<S extends string> = S extends `${infer Parent}.${string}` ? Parent : never;
+type AncestorPaths<S extends string> = S | (ParentPath<S> extends never ? never : AncestorPaths<ParentPath<S>>);
+type RelativeStateTarget<S extends string, Source extends string> = ChildStateKey<S, AncestorPaths<Source>>;
+type StateIdTarget = `#${string}`;
+interface Transition<T extends Dict, Source extends string | undefined = string | undefined> {
+  target?: T["state"] | StateIdTarget | (Source extends string ? RelativeStateTarget<T["state"], Source> : never) | undefined;
   actions?: T["action"][] | undefined;
   guard?: T["guard"] | GuardFn<T> | undefined;
   reenter?: boolean | undefined;
 }
+type TransitionSet<T extends Dict> = Transition<T> | Transition<T>[] | undefined;
+type TransitionMap<T extends Dict> = Record<string, TransitionSet<T>>;
+type TransitionMatch<T extends Dict> = {
+  transitions: TransitionSet<T>;
+  source: string | undefined;
+};
 type MaybeArray<T> = T | T[];
-type ChooseFn<T extends Dict> = (transitions: MaybeArray<Omit<Transition<T>, "target">>) => Transition<T> | undefined;
+type ChooseFn<T extends Dict> = (transitions: MaybeArray<Omit<Transition<T, string>, "target">> | null | undefined) => Transition<T> | undefined;
 interface PropsParams<T extends Dict> {
   props: Partial<T["props"]>;
   scope: Scope;
@@ -123,6 +135,16 @@ interface RefsParams<T extends Dict> {
 }
 type ActionsOrFn<T extends Dict> = T["action"][] | ((params: Params<T>) => T["action"][] | undefined);
 type EffectsOrFn<T extends Dict> = T["effect"][] | ((params: Params<T>) => T["effect"][] | undefined);
+interface MachineState<T extends Dict, Parent extends string = string> {
+  id?: string | undefined;
+  tags?: T["tag"][] | undefined;
+  entry?: ActionsOrFn<T> | undefined;
+  exit?: ActionsOrFn<T> | undefined;
+  effects?: EffectsOrFn<T> | undefined;
+  initial?: ChildStateKey<T["state"], Parent> | undefined;
+  states?: { [K in ChildStateKey<T["state"], Parent>]?: MachineState<T, `${Parent}.${K}`> } | undefined;
+  on?: { [E in T["event"]["type"]]?: Transition<T, Parent> | Array<Transition<T, Parent>> } | undefined;
+}
 interface Machine<T extends Dict> {
   debug?: boolean | undefined;
   props?: ((params: PropsParams<T>) => T["props"]) | undefined;
@@ -136,14 +158,8 @@ interface Machine<T extends Dict> {
   effects?: EffectsOrFn<T> | undefined;
   refs?: ((params: RefsParams<T>) => T["refs"]) | undefined;
   watch?: ((params: Params<T>) => void) | undefined;
-  on?: { [E in T["event"]["type"]]?: Transition<T> | Array<Transition<T>> } | undefined;
-  states: { [K in T["state"]]: {
-    tags?: T["tag"][] | undefined;
-    entry?: ActionsOrFn<T> | undefined;
-    exit?: ActionsOrFn<T> | undefined;
-    effects?: EffectsOrFn<T> | undefined;
-    on?: { [E in T["event"]["type"]]?: Transition<T> | Array<Transition<T>> } | undefined;
-  } };
+  on?: { [E in T["event"]["type"]]?: Transition<T, undefined> | Array<Transition<T, undefined>> } | undefined;
+  states: { [K in TopLevelState<T["state"]>]: MachineState<T, K> };
   implementations?: {
     guards?: { [K in T["guard"]]: (params: Params<T>) => boolean } | undefined;
     actions?: { [K in T["action"]]: (params: Params<T>) => void } | undefined;
@@ -198,4 +214,4 @@ declare enum MachineStatus {
 }
 declare const INIT_STATE = "__init__";
 //#endregion
-export { PropFn as _, BindableParams as a, Transition as b, ComputedFn as c, GuardFn as d, INIT_STATE as f, Params as g, MachineStatus as h, BindableFn as i, EffectsOrFn as l, MachineSchema as m, Bindable as n, BindableRefs as o, Machine as p, BindableContext as r, ChooseFn as s, ActionsOrFn as t, EventObject as u, Scope as v, ValueOrFn as x, Service as y };
+export { TransitionMatch as C, TransitionMap as S, ValueOrFn as T, Params as _, BindableParams as a, Service as b, ComputedFn as c, GuardFn as d, INIT_STATE as f, MachineStatus as g, MachineState as h, BindableFn as i, EffectsOrFn as l, MachineSchema as m, Bindable as n, BindableRefs as o, Machine as p, BindableContext as r, ChooseFn as s, ActionsOrFn as t, EventObject as u, PropFn as v, TransitionSet as w, Transition as x, Scope as y };

package/dist/{types-B24gMTKq.d.cts → types-u-LWCSDE.d.cts}

@@ -105,14 +105,26 @@ interface Params<T extends Dict> {
   guard: (key: T["guard"] | GuardFn<T>) => boolean | undefined;
 }
 type GuardFn<T extends Dict> = (params: Params<T>) => boolean;
-interface Transition<T extends Dict> {
-  target?: T["state"] | undefined;
+type TopLevelState<S extends string> = S extends `${infer Top}.${string}` ? Top : S;
+type ChildStateKey<S extends string, Parent extends string> = S extends `${Parent}.${infer Rest}` ? Rest extends `${infer Child}.${string}` ? Child : Rest : never;
+type ParentPath<S extends string> = S extends `${infer Parent}.${string}` ? Parent : never;
+type AncestorPaths<S extends string> = S | (ParentPath<S> extends never ? never : AncestorPaths<ParentPath<S>>);
+type RelativeStateTarget<S extends string, Source extends string> = ChildStateKey<S, AncestorPaths<Source>>;
+type StateIdTarget = `#${string}`;
+interface Transition<T extends Dict, Source extends string | undefined = string | undefined> {
+  target?: T["state"] | StateIdTarget | (Source extends string ? RelativeStateTarget<T["state"], Source> : never) | undefined;
   actions?: T["action"][] | undefined;
   guard?: T["guard"] | GuardFn<T> | undefined;
   reenter?: boolean | undefined;
 }
+type TransitionSet<T extends Dict> = Transition<T> | Transition<T>[] | undefined;
+type TransitionMap<T extends Dict> = Record<string, TransitionSet<T>>;
+type TransitionMatch<T extends Dict> = {
+  transitions: TransitionSet<T>;
+  source: string | undefined;
+};
 type MaybeArray<T> = T | T[];
-type ChooseFn<T extends Dict> = (transitions: MaybeArray<Omit<Transition<T>, "target">>) => Transition<T> | undefined;
+type ChooseFn<T extends Dict> = (transitions: MaybeArray<Omit<Transition<T, string>, "target">> | null | undefined) => Transition<T> | undefined;
 interface PropsParams<T extends Dict> {
   props: Partial<T["props"]>;
   scope: Scope;
@@ -123,6 +135,16 @@ interface RefsParams<T extends Dict> {
 }
 type ActionsOrFn<T extends Dict> = T["action"][] | ((params: Params<T>) => T["action"][] | undefined);
 type EffectsOrFn<T extends Dict> = T["effect"][] | ((params: Params<T>) => T["effect"][] | undefined);
+interface MachineState<T extends Dict, Parent extends string = string> {
+  id?: string | undefined;
+  tags?: T["tag"][] | undefined;
+  entry?: ActionsOrFn<T> | undefined;
+  exit?: ActionsOrFn<T> | undefined;
+  effects?: EffectsOrFn<T> | undefined;
+  initial?: ChildStateKey<T["state"], Parent> | undefined;
+  states?: { [K in ChildStateKey<T["state"], Parent>]?: MachineState<T, `${Parent}.${K}`> } | undefined;
+  on?: { [E in T["event"]["type"]]?: Transition<T, Parent> | Array<Transition<T, Parent>> } | undefined;
+}
 interface Machine<T extends Dict> {
   debug?: boolean | undefined;
   props?: ((params: PropsParams<T>) => T["props"]) | undefined;
@@ -136,14 +158,8 @@ interface Machine<T extends Dict> {
   effects?: EffectsOrFn<T> | undefined;
   refs?: ((params: RefsParams<T>) => T["refs"]) | undefined;
   watch?: ((params: Params<T>) => void) | undefined;
-  on?: { [E in T["event"]["type"]]?: Transition<T> | Array<Transition<T>> } | undefined;
-  states: { [K in T["state"]]: {
-    tags?: T["tag"][] | undefined;
-    entry?: ActionsOrFn<T> | undefined;
-    exit?: ActionsOrFn<T> | undefined;
-    effects?: EffectsOrFn<T> | undefined;
-    on?: { [E in T["event"]["type"]]?: Transition<T> | Array<Transition<T>> } | undefined;
-  } };
+  on?: { [E in T["event"]["type"]]?: Transition<T, undefined> | Array<Transition<T, undefined>> } | undefined;
+  states: { [K in TopLevelState<T["state"]>]: MachineState<T, K> };
   implementations?: {
     guards?: { [K in T["guard"]]: (params: Params<T>) => boolean } | undefined;
     actions?: { [K in T["action"]]: (params: Params<T>) => void } | undefined;
@@ -198,4 +214,4 @@ declare enum MachineStatus {
 }
 declare const INIT_STATE = "__init__";
 //#endregion
-export { PropFn as _, BindableParams as a, Transition as b, ComputedFn as c, GuardFn as d, INIT_STATE as f, Params as g, MachineStatus as h, BindableFn as i, EffectsOrFn as l, MachineSchema as m, Bindable as n, BindableRefs as o, Machine as p, BindableContext as r, ChooseFn as s, ActionsOrFn as t, EventObject as u, Scope as v, ValueOrFn as x, Service as y };
+export { TransitionMatch as C, TransitionMap as S, ValueOrFn as T, Params as _, BindableParams as a, Service as b, ComputedFn as c, GuardFn as d, INIT_STATE as f, MachineStatus as g, MachineState as h, BindableFn as i, EffectsOrFn as l, MachineSchema as m, Bindable as n, BindableRefs as o, Machine as p, BindableContext as r, ChooseFn as s, ActionsOrFn as t, EventObject as u, PropFn as v, TransitionSet as w, Transition as x, Scope as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sprawlify/primitives",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "A set of primitive components for building user interfaces.",
   "license": "MIT",
   "author": "sprawlify <npm@sprawlify.com>",