@destyler/hover-card 0.2.6 → 0.2.9

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { AnyEventObject, Machine, XSend, XState } from "@destyler/xstate";
 import { CommonProperties, DirectionProperty, NormalizeProps, PropTypes, RequiredBy } from "@destyler/types";
 
 //#region src/anatomy.d.ts
-declare const anatomy: _destyler_anatomy0.AnatomyInstance<"trigger" | "content" | "positioner" | "arrow" | "arrowTip">;
+declare const anatomy: _destyler_anatomy0.AnatomyInstance<"arrow" | "arrowTip" | "trigger" | "positioner" | "content">;
 //#endregion
 //#region src/types.d.ts
 interface OpenChangeDetails {
@@ -21,33 +21,34 @@ interface PublicContext extends DirectionProperty, CommonProperties {
   /**
    * The ids of the elements in the popover. Useful for composition.
    */
-  'ids'?: ElementIds | undefined;
+  ids?: ElementIds | undefined;
   /**
    * Function called when the hover card opens or closes.
    */
-  'onOpenChange'?: ((details: OpenChangeDetails) => void) | undefined;
+  onOpenChange?: ((details: OpenChangeDetails) => void) | undefined;
   /**
    * The duration from when the mouse enters the trigger until the hover card opens.
    * @default 700
    */
-  'openDelay': number;
+  openDelay: number;
   /**
    * The duration from when the mouse leaves the trigger or content until the hover card closes.
    * @default 300
    */
-  'closeDelay': number;
+  closeDelay: number;
   /**
    * Whether the hover card is open
    */
-  'open'?: boolean | undefined;
+  open?: boolean | undefined;
   /**
-   * Whether the hover card is controlled by the user
+   * The initial open state of the hover card when it is not controlled.
+   * Prefer this over seeding with `open` for uncontrolled usage.
    */
-  'open.controlled'?: boolean | undefined;
+  defaultOpen?: boolean | undefined;
   /**
    * The user provided options used to position the popover content
    */
-  'positioning': PositioningOptions;
+  positioning: PositioningOptions;
 }
 interface PrivateContext {
   /**
@@ -98,7 +99,7 @@ declare function connect<T extends PropTypes>(state: State, send: Send, normaliz
 declare function machine(userContext: UserDefinedContext): _destyler_xstate0.Machine<MachineContext, MachineState, _destyler_xstate0.AnyEventObject>;
 //#endregion
 //#region src/props.d.ts
-declare const props: ("open" | "id" | "ids" | "onOpenChange" | "openDelay" | "closeDelay" | "open.controlled" | "positioning" | "dir" | "getRootNode")[];
-declare const splitProps: <Props extends Partial<UserDefinedContext>>(props: Props) => [Partial<UserDefinedContext>, Omit<Props, "open" | "id" | "ids" | "onOpenChange" | "openDelay" | "closeDelay" | "open.controlled" | "positioning" | "dir" | "getRootNode">];
+declare const props: ("open" | "ids" | "onOpenChange" | "openDelay" | "closeDelay" | "defaultOpen" | "positioning" | "dir" | "id" | "getRootNode")[];
+declare const splitProps: <Props extends Partial<UserDefinedContext>>(props: Props) => [Partial<UserDefinedContext>, Omit<Props, "open" | "ids" | "onOpenChange" | "openDelay" | "closeDelay" | "defaultOpen" | "positioning" | "dir" | "id" | "getRootNode">];
 //#endregion
 export { type MachineApi as Api, type UserDefinedContext as Context, type ElementIds, type OpenChangeDetails, type Placement, type PositioningOptions, type Service, anatomy, connect, machine, props, splitProps };

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { createAnatomy } from "@destyler/anatomy";
 import { getPlacement, getPlacementStyles } from "@destyler/popper";
 import { createScope } from "@destyler/dom";
 import { trackDismissableElement } from "@destyler/dismissable";
-import { compact, createSplitProps } from "@destyler/utils";
+import { compact, createSplitProps, isControlled, resolveControllableOpen, withControllableProvided } from "@destyler/utils";
 import { createMachine, guards } from "@destyler/xstate";
 import { createProps } from "@destyler/types";
 
@@ -33,7 +33,6 @@ function connect(state, send, normalize) {
 	return {
 		open,
 		setOpen(nextOpen) {
-			if (nextOpen === open) return;
 			send(nextOpen ? "OPEN" : "CLOSE");
 		},
 		reposition(options = {}) {
@@ -125,10 +124,11 @@ function connect(state, send, normalize) {
 //#region src/machine.ts
 const { not, and } = guards;
 function machine(userContext) {
-	const ctx = compact(userContext);
+	const ctx = compact(withControllableProvided(userContext, ["open"]));
+	const { initialOpen } = resolveControllableOpen(ctx);
 	return createMachine({
 		id: "hover-card",
-		initial: ctx.open ? "open" : "closed",
+		initial: initialOpen ? "open" : "closed",
 		context: {
 			openDelay: 700,
 			closeDelay: 300,
@@ -228,6 +228,15 @@ function machine(userContext) {
 				on: {
 					"CONTROLLED.CLOSE": "closed",
 					"CONTROLLED.OPEN": "open",
+					"OPEN": "open",
+					"CLOSE": [{
+						guard: "isOpenControlled",
+						target: "open",
+						actions: ["invokeOnClose"]
+					}, {
+						target: "closed",
+						actions: ["invokeOnClose"]
+					}],
 					"POINTER_ENTER": {
 						target: "open",
 						actions: ["setIsPointer"]
@@ -242,7 +251,7 @@ function machine(userContext) {
 		},
 		guards: {
 			isPointer: (ctx$1) => !!ctx$1.isPointer,
-			isOpenControlled: (ctx$1) => !!ctx$1["open.controlled"]
+			isOpenControlled: (ctx$1) => isControlled(ctx$1, "open")
 		},
 		activities: {
 			trackPositioning(ctx$1) {
@@ -319,8 +328,8 @@ const props = createProps()([
 	"id",
 	"ids",
 	"onOpenChange",
-	"open.controlled",
 	"open",
+	"defaultOpen",
 	"openDelay",
 	"positioning"
 ]);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@destyler/hover-card",
   "type": "module",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "for sighted users to preview content available behind a link.",
   "author": "Elone Hoo <elonehoo@gmail.com>",
   "license": "MIT",
@@ -22,13 +22,13 @@
     "dist"
   ],
   "dependencies": {
-    "@destyler/anatomy": "0.2.6",
-    "@destyler/dom": "0.2.6",
-    "@destyler/dismissable": "0.2.6",
-    "@destyler/popper": "0.2.6",
-    "@destyler/types": "0.2.6",
-    "@destyler/utils": "0.2.6",
-    "@destyler/xstate": "0.2.6"
+    "@destyler/anatomy": "0.2.9",
+    "@destyler/dom": "0.2.9",
+    "@destyler/popper": "0.2.9",
+    "@destyler/types": "0.2.9",
+    "@destyler/xstate": "0.2.9",
+    "@destyler/dismissable": "0.2.9",
+    "@destyler/utils": "0.2.9"
   },
   "publishConfig": {
     "access": "public"