@duskmoon-dev/el-popover 0.4.0

package/dist/types/el-dm-popover.d.ts

@@ -0,0 +1,106 @@
+/**
+ * DuskMoon Popover Element
+ *
+ * A contextual overlay/popup component that appears relative to a trigger element.
+ * Supports multiple trigger modes, placements, and auto-flip when near viewport edges.
+ *
+ * @element el-dm-popover
+ *
+ * @attr {boolean} open - Whether the popover is visible
+ * @attr {string} trigger - Trigger mode: click, hover, focus, manual
+ * @attr {string} placement - Popover position relative to trigger
+ * @attr {number} offset - Distance from trigger element in pixels
+ * @attr {boolean} arrow - Whether to show arrow pointing to trigger
+ *
+ * @slot trigger - The element that triggers the popover
+ * @slot - Default slot for popover content
+ *
+ * @fires open - Fired when popover opens
+ * @fires close - Fired when popover closes
+ *
+ * @csspart popover - The popover container
+ * @csspart content - The popover content area
+ * @csspart arrow - The popover arrow
+ */
+import { BaseElement } from '@duskmoon-dev/el-core';
+export type PopoverPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+export type PopoverTrigger = 'click' | 'hover' | 'focus' | 'manual';
+export declare class ElDmPopover extends BaseElement {
+    static properties: {
+        open: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            default: boolean;
+        };
+        trigger: {
+            type: StringConstructor;
+            reflect: boolean;
+            default: string;
+        };
+        placement: {
+            type: StringConstructor;
+            reflect: boolean;
+            default: string;
+        };
+        offset: {
+            type: NumberConstructor;
+            reflect: boolean;
+            default: number;
+        };
+        arrow: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            default: boolean;
+        };
+    };
+    open: boolean;
+    trigger: PopoverTrigger;
+    placement: PopoverPlacement;
+    offset: number;
+    arrow: boolean;
+    private _boundHandleClickOutside;
+    private _boundHandleKeyDown;
+    private _boundHandleScroll;
+    private _boundUpdatePosition;
+    private _hoverTimeout;
+    private _currentPlacement;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Show the popover
+     */
+    show(): void;
+    /**
+     * Hide the popover
+     */
+    hide(): void;
+    /**
+     * Toggle the popover visibility
+     */
+    toggle(): void;
+    private _setVisible;
+    private _setupTriggerListeners;
+    private _attachTriggerEvents;
+    private _detachTriggerEvents;
+    private _removeTriggerListeners;
+    private _getTriggerElement;
+    private _handleTriggerClick;
+    private _handleTriggerMouseEnter;
+    private _handleTriggerMouseLeave;
+    private _handlePopoverMouseEnter;
+    private _handlePopoverMouseLeave;
+    private _handleTriggerFocus;
+    private _handleTriggerBlur;
+    private _addGlobalListeners;
+    private _removeGlobalListeners;
+    private _handleClickOutside;
+    private _handleKeyDown;
+    private _handleScroll;
+    private _updatePosition;
+    private _getEffectivePlacement;
+    private _calculatePosition;
+    update(): void;
+    render(): string;
+}
+//# sourceMappingURL=el-dm-popover.d.ts.map

package/dist/types/el-dm-popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"el-dm-popover.d.ts","sourceRoot":"","sources":["../../src/el-dm-popover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,WAAW,EAAO,MAAM,uBAAuB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AA4HpE,qBAAa,WAAY,SAAQ,WAAW;IAC1C,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;MAMf;IAEM,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IAEvB,OAAO,CAAC,wBAAwB,CAA0B;IAC1D,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,iBAAiB,CAA8B;;IAWvD,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAM5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,mBAAmB,CAEzB;IAEF,OAAO,CAAC,wBAAwB,CAM9B;IAEF,OAAO,CAAC,wBAAwB,CAI9B;IAEF,OAAO,CAAC,wBAAwB,CAK9B;IAEF,OAAO,CAAC,wBAAwB,CAI9B;IAEF,OAAO,CAAC,mBAAmB,CAEzB;IAEF,OAAO,CAAC,kBAAkB,CAOxB;IAEF,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,sBAAsB;IA2C9B,OAAO,CAAC,kBAAkB;IAiE1B,MAAM,IAAI,IAAI;IAWd,MAAM,IAAI,MAAM;CAmBjB"}

package/dist/types/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @duskmoon-dev/el-popover
+ *
+ * DuskMoon Popover custom element
+ */
+import { ElDmPopover } from './el-dm-popover.js';
+export { ElDmPopover };
+export type { PopoverPlacement, PopoverTrigger } from './el-dm-popover.js';
+/**
+ * Register the el-dm-popover custom element
+ *
+ * @example
+ * ```ts
+ * import { register } from '@duskmoon-dev/el-popover';
+ * register();
+ * ```
+ */
+export declare function register(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAI/B"}

package/dist/types/register.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/types/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@duskmoon-dev/el-popover",
+  "version": "0.4.0",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./register": {
+      "types": "./dist/types/register.d.ts",
+      "import": "./dist/esm/register.js",
+      "require": "./dist/cjs/register.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "bun run clean",
+    "build": "bun run build:esm && bun run build:cjs && bun run build:types",
+    "build:esm": "bun build ./src/index.ts ./src/register.ts --outdir ./dist/esm --format esm --sourcemap --external @duskmoon-dev/el-core --external @duskmoon-dev/core",
+    "build:cjs": "bun build ./src/index.ts ./src/register.ts --outdir ./dist/cjs --format cjs --sourcemap --external @duskmoon-dev/el-core --external @duskmoon-dev/core",
+    "build:types": "tsc --emitDeclarationOnly --outDir ./dist/types",
+    "dev": "bun build ./src/index.ts --outdir ./dist/esm --format esm --sourcemap --external @duskmoon-dev/el-core --watch",
+    "clean": "del-cli dist",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write 'src/**/*.ts' '*.json'",
+    "format:check": "prettier --check 'src/**/*.ts' '*.json'",
+    "lint": "eslint src",
+    "lint:check": "eslint src --max-warnings 0",
+    "lint:fix": "eslint src --fix",
+    "release": "bun publish",
+    "release:dry-run": "bun publish --dry-run"
+  },
+  "dependencies": {
+    "@duskmoon-dev/el-core": "0.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "customElements": "custom-elements.json",
+  "keywords": [
+    "duskmoon-dev",
+    "duskmoon",
+    "custom-elements",
+    "customelements",
+    "web-components",
+    "webcomponents",
+    "popover",
+    "popup",
+    "html"
+  ]
+}