@immense/vue-pom-generator 1.0.52 → 1.0.54

package/class-generation/index.ts

@@ -336,23 +336,29 @@ async function getRouteMetaByComponent(
   routerEntry?: string,
   routerType?: "vue-router" | "nuxt",
   options: {
-    viewsDir?: string;
-    scanDirs?: string[];
+    pageDirs?: string[];
+    componentDirs?: string[];
+    layoutDirs?: string[];
   } = {},
 ): Promise<Record<string, RouteMeta>> {
   const root = projectRoot ?? process.cwd();
-  const viewsDir = options.viewsDir ?? "src/views";
-  const viewsDirAbs = path.isAbsolute(viewsDir) ? viewsDir : path.resolve(root, viewsDir);
-  const scanDirs = options.scanDirs?.length ? options.scanDirs : ["src"];
+  const pageDirs = options.pageDirs?.length ? options.pageDirs : ["src/views"];
+  const pageDirsAbs = pageDirs.map(dir => path.isAbsolute(dir) ? dir : path.resolve(root, dir));
+  const primaryPageDirAbs = pageDirsAbs[0] ?? path.resolve(root, "src/views");
+  const sourceDirs = [
+    ...pageDirs,
+    ...(options.componentDirs?.length ? options.componentDirs : ["src/components"]),
+    ...(options.layoutDirs?.length ? options.layoutDirs : ["src/layouts"]),
+  ];
   const extraRoots = process.cwd() !== root ? [process.cwd()] : [];
 
   const { routeMetaEntries } = routerType === "nuxt"
-    ? await introspectNuxtPages(root)
+    ? await introspectNuxtPages(root, { pageDirs: pageDirsAbs })
     : await parseRouterFileFromCwd(resolveRouterEntry(root, routerEntry), {
       componentNaming: {
         projectRoot: root,
-        viewsDirAbs,
-        scanDirs,
+        viewsDirAbs: primaryPageDirAbs,
+        sourceDirs,
         extraRoots,
       },
     });
@@ -687,8 +693,9 @@ export interface GenerateFilesOptions {
   /** The type of router introspection to perform. */
   routerType?: "vue-router" | "nuxt";
 
-  viewsDir?: string;
-  scanDirs?: string[];
+  pageDirs?: string[];
+  componentDirs?: string[];
+  layoutDirs?: string[];
 
   routeMetaByComponent?: Record<string, RouteMeta>;
 }
@@ -749,8 +756,9 @@ export async function generateFiles(
     vueRouterFluentChaining,
     routerEntry,
     routerType,
-    viewsDir,
-    scanDirs,
+    pageDirs,
+    componentDirs,
+    layoutDirs,
     routeMetaByComponent: routeMetaByComponentOverride,
   } = options;
 
@@ -763,8 +771,9 @@ export async function generateFiles(
   const routeMetaByComponent = routeMetaByComponentOverride
     ?? (vueRouterFluentChaining
       ? await getRouteMetaByComponent(projectRoot, routerEntry, routerType, {
-        viewsDir,
-        scanDirs,
+        pageDirs,
+        componentDirs,
+        layoutDirs,
       })
       : undefined);
   const generatedFilePaths: string[] = [];
@@ -1202,7 +1211,7 @@ function generateAggregatedCSharpFiles(
     "    }",
     "",
     "    // Minimal vue-select helper mirroring the TS BasePage.selectVSelectByTestId behavior.",
-    "    // Note: annotationText is currently a no-op in C# output (we don't render a cursor overlay).",
+    "    // Note: annotationText is currently a no-op in C# output (we don't render a pointer overlay).",
     "    protected async Task SelectVSelectByTestIdAsync(string testId, string value, int timeOut = 500)",
     "    {",
     "        var root = LocatorByTestId(testId);",

package/class-generation/pointer.ts

@@ -1,12 +1,12 @@
-import { Callout, type ElementTarget } from "./callout";
+import { Callout, type CalloutOptions, type ElementTarget } from "./callout";
 import type { PwLocator, PwPage } from "./playwright-types";
 
-const __PW_CURSOR_ID__ = "__pw_cursor__";
+const __PW_POINTER_ID__ = "__pw_pointer__";
 const __PW_EDITABLE_DESCENDANT_SELECTOR__
 	= "input, textarea, select, [contenteditable=''], [contenteditable='true'], [contenteditable]:not([contenteditable='false'])";
 
-// A minimal 16×24 arrow cursor encoded as a base64 PNG.
-const __PW_CURSOR_PNG__ =
+// A minimal 16×24 arrow pointer encoded as a base64 PNG.
+const __PW_POINTER_PNG__ =
 	"data:image/png;base64,"
 	+ "iVBORw0KGgoAAAANSUhEUgAAABQAAAAeCAQAAACGG/bgAAAAAmJLR0QA/4ePzL8AAAAJcEhZcwAA"
 	+ "HsYAAB7GAZEt8iwAAAAHdElNRQfgAwgMIwdxU/i7AAABZklEQVQ4y43TsU4UURSH8W+XmYwkS2I0"
@@ -18,41 +18,35 @@ const __PW_CURSOR_PNG__ =
 	+ "ONcpr3PrXy9VfS473M/D7H+TLmrqsXtOGctvxvMv2oVNP+Av0uHbzbxyJaywyUjx8TlnPY2YxqkD"
 	+ "dAAAAABJRU5ErkJggg==";
 
-const __pw_cursor_positions__ = new WeakMap<object, { x: number; y: number }>();
+const __pw_pointer_positions__ = new WeakMap<object, { x: number; y: number }>();
 
-function __pw_get_cursor_pos__(page: PwPage): { x: number; y: number } {
-	return __pw_cursor_positions__.get(page as object) ?? { x: 0, y: 0 };
+function __pw_get_pointer_pos__(page: PwPage): { x: number; y: number } {
+	return __pw_pointer_positions__.get(page as object) ?? { x: 0, y: 0 };
 }
 
-function __pw_set_cursor_pos__(page: PwPage, x: number, y: number): void {
-	__pw_cursor_positions__.set(page as object, { x, y });
+function __pw_set_pointer_pos__(page: PwPage, x: number, y: number): void {
+	__pw_pointer_positions__.set(page as object, { x, y });
 }
 
-async function __pw_ensure_cursor__(page: PwPage): Promise<void> {
-	const exists = await page.evaluate(
-		({ cursorId }: { cursorId: string }) => document.getElementById(cursorId) != null,
-		{ cursorId: __PW_CURSOR_ID__ },
-	);
-	if (exists) return;
-
-	__pw_set_cursor_pos__(page, 0, 0);
-
-	await page.evaluate(
-		({ id, src }: { id: string; src: string }) => {
-			const img = document.createElement("img");
-			img.setAttribute("src", src);
-			img.setAttribute("id", id);
-			img.setAttribute(
-				"style",
-				"position:fixed;z-index:2147483647;pointer-events:none;left:0;top:0;transform-origin:0 0;",
-			);
-			document.body.appendChild(img);
-		},
-		{
-			id: __PW_CURSOR_ID__,
-			src: __PW_CURSOR_PNG__,
-		},
-	);
+export interface PointerMoveRequest {
+	animate: boolean;
+	durationMilliseconds: number;
+	endX: number;
+	endY: number;
+	startX: number;
+	startY: number;
+	transitionStyle: string;
+}
+
+export interface PointerPressRequest {
+	durationMilliseconds: number;
+}
+
+export interface PointerRenderer {
+	readonly overlayIds?: string[];
+	ensure: (page: PwPage) => Promise<void>;
+	move: (page: PwPage, request: PointerMoveRequest) => Promise<void>;
+	press: (page: PwPage, request: PointerPressRequest) => Promise<void>;
 }
 
 // ---------------------------------------------------------------------------
@@ -72,17 +66,17 @@ export interface PlaywrightAnimationOptions {
 	 */
 	extraDelayMs?: number;
 
-	/** Visual cursor / pointer-movement configuration. */
+	/** Visual pointer-movement configuration. */
 	pointer?: {
 		/**
-		 * Duration of the CSS-transition cursor glide in ms.
-		 * Set to 0 to teleport the cursor without animation.
+		 * Duration of the CSS-transition pointer glide in ms.
+		 * Set to 0 to teleport the pointer without animation.
 		 * Default: 250
 		 */
 		durationMilliseconds?: number;
 
 		/**
-		 * CSS transition timing function for the cursor glide.
+		 * CSS transition timing function for the pointer glide.
 		 * Default: "ease-in-out"
 		 */
 		transitionStyle?: "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out";
@@ -139,6 +133,102 @@ export interface AfterPointerClickInfo {
 
 export type AfterPointerClick = (info: AfterPointerClickInfo) => void | Promise<void>;
 
+const __pw_default_pointer_renderer__: PointerRenderer = {
+	overlayIds: [__PW_POINTER_ID__],
+	async ensure(page) {
+		const exists = await page.evaluate(
+			({ pointerId }: { pointerId: string }) => document.getElementById(pointerId) != null,
+			{ pointerId: __PW_POINTER_ID__ },
+		);
+		if (exists) return;
+
+		__pw_set_pointer_pos__(page, 0, 0);
+
+		await page.evaluate(
+			({ id, src }: { id: string; src: string }) => {
+				const img = document.createElement("img");
+				img.setAttribute("src", src);
+				img.setAttribute("id", id);
+				img.setAttribute(
+					"style",
+					"position:fixed;z-index:2147483647;pointer-events:none;left:0;top:0;transform-origin:0 0;",
+				);
+				document.body.appendChild(img);
+			},
+			{
+				id: __PW_POINTER_ID__,
+				src: __PW_POINTER_PNG__,
+			},
+		);
+	},
+	async move(page, request) {
+		await page.evaluate(
+			({
+				animate,
+				dur,
+				ex,
+				ey,
+				id,
+				style,
+				sx,
+				sy,
+			}: {
+				animate: boolean;
+				dur: number;
+				ex: number;
+				ey: number;
+				id: string;
+				style: string;
+				sx: number;
+				sy: number;
+			}) => {
+				const el = document.getElementById(id);
+				if (!el) {
+					return;
+				}
+
+				el.style.transition = "";
+				el.style.willChange = "left, top";
+				el.style.left = `${animate ? sx : ex}px`;
+				el.style.top = `${animate ? sy : ey}px`;
+
+				if (animate) {
+					void el.offsetWidth;
+					el.style.transition = `left ${dur}ms ${style}, top ${dur}ms ${style}`;
+					el.style.left = `${ex}px`;
+					el.style.top = `${ey}px`;
+				}
+			},
+			{
+				animate: request.animate,
+				dur: request.durationMilliseconds,
+				ex: request.endX,
+				ey: request.endY,
+				id: __PW_POINTER_ID__,
+				style: request.transitionStyle,
+				sx: request.startX,
+				sy: request.startY,
+			},
+		);
+	},
+	async press(page, request) {
+		await page.evaluate(
+			({ id, dur }: { id: string; dur: number }) => {
+				const el = document.getElementById(id);
+				if (el) {
+					el.style.transition = `transform ${dur}ms`;
+					el.style.transform = "scale(0.6)";
+					setTimeout(() => {
+						el.style.transition = `transform ${dur}ms`;
+						el.style.transform = "scale(1)";
+					}, dur);
+				}
+			},
+			{ id: __PW_POINTER_ID__, dur: request.durationMilliseconds },
+		);
+	},
+};
+
 // ---------------------------------------------------------------------------
 // Pointer class
 // ---------------------------------------------------------------------------
@@ -147,11 +237,16 @@ export class Pointer {
 	private readonly page: PwPage;
 	private readonly testIdAttribute: string;
 	private readonly callout: Callout;
+	private readonly renderer: PointerRenderer;
 
-	public constructor(page: PwPage, testIdAttribute: string, callout?: Callout) {
+	public constructor(page: PwPage, testIdAttribute: string, callout?: Callout, renderer?: PointerRenderer) {
 		this.page = page;
 		this.testIdAttribute = (testIdAttribute ?? "data-testid").trim() || "data-testid";
-		this.callout = callout ?? new Callout(page);
+		this.renderer = renderer ?? __pw_default_pointer_renderer__;
+		const calloutOptions: CalloutOptions = {
+			extraOverlayIds: this.renderer.overlayIds,
+		};
+		this.callout = callout ?? new Callout(page, calloutOptions);
 	}
 
 	private toLocator(target: ElementTarget): PwLocator {
@@ -254,66 +349,27 @@ export class Pointer {
 		const extraDelayMs = Math.max(0, opts.extraDelayMs ?? 0);
 		const actionDelayMs = Math.max(0, delayMs);
 
-		// Inject the visual cursor if it doesn't exist yet.
-		await __pw_ensure_cursor__(this.page);
+		// Inject the visual pointer if it doesn't exist yet.
+		await this.renderer.ensure(this.page);
 
-		// Move the cursor to the target element.
+		// Move the pointer to the target element.
 		const box = await locator.first().boundingBox();
 		if (box) {
 			const endX = box.x + box.width / 2;
 			const endY = box.y + box.height / 2;
-			const { x: startX, y: startY } = __pw_get_cursor_pos__(this.page);
+			const { x: startX, y: startY } = __pw_get_pointer_pos__(this.page);
 			const distance = Math.sqrt((endX - startX) ** 2 + (endY - startY) ** 2);
 
 			const shouldAnimate = moveDurationMs > 0 && distance > 0;
-			await this.page.evaluate(
-				({
-					dur,
-					ex,
-					ey,
-					id,
-					style,
-					sx,
-					sy,
-					animate,
-				}: {
-					dur: number;
-					ex: number;
-					ey: number;
-					id: string;
-					style: string;
-					sx: number;
-					sy: number;
-					animate: boolean;
-				}) => {
-					const el = document.getElementById(id);
-					if (!el) {
-						return;
-					}
-
-					el.style.transition = "";
-					el.style.willChange = "left, top";
-					el.style.left = `${animate ? sx : ex}px`;
-					el.style.top = `${animate ? sy : ey}px`;
-
-					if (animate) {
-						void el.offsetWidth;
-						el.style.transition = `left ${dur}ms ${style}, top ${dur}ms ${style}`;
-						el.style.left = `${ex}px`;
-						el.style.top = `${ey}px`;
-					}
-				},
-				{
-					dur: moveDurationMs,
-					ex: endX,
-					ey: endY,
-					id: __PW_CURSOR_ID__,
-					style: transitionStyle,
-					sx: startX,
-					sy: startY,
-					animate: shouldAnimate,
-				},
-			);
+			await this.renderer.move(this.page, {
+				animate: shouldAnimate,
+				durationMilliseconds: moveDurationMs,
+				endX,
+				endY,
+				startX,
+				startY,
+				transitionStyle,
+			});
 
 			if (trimmedAnnotationText) {
 				await this.callout.showForElement(locator, trimmedAnnotationText, {
@@ -330,7 +386,7 @@ export class Pointer {
 				await this.page.waitForTimeout(moveDurationMs + 25);
 			}
 
-			__pw_set_cursor_pos__(this.page, endX, endY);
+			__pw_set_pointer_pos__(this.page, endX, endY);
 		}
 		else {
 			await this.callout.hide();
@@ -342,23 +398,10 @@ export class Pointer {
 
 		let clickedTestId: string | undefined;
 		if (executeClick) {
-			// Brief scale-down "press" animation on the cursor image.
+			// Brief scale-down "press" animation on the pointer image.
 			if (moveDurationMs > 0) {
 				const pressDur = Math.max(80, Math.round(moveDurationMs / 3));
-				await this.page.evaluate(
-					({ id, dur }: { id: string; dur: number }) => {
-						const el = document.getElementById(id);
-						if (el) {
-							el.style.transition = `transform ${dur}ms`;
-							el.style.transform = "scale(0.6)";
-							setTimeout(() => {
-								el.style.transition = `transform ${dur}ms`;
-								el.style.transform = "scale(1)";
-							}, dur);
-						}
-					},
-					{ id: __PW_CURSOR_ID__, dur: pressDur },
-				);
+				await this.renderer.press(this.page, { durationMilliseconds: pressDur });
 			}
 
 			try { clickedTestId = await this.getTestId(locator); } catch { /* noop */ }
@@ -380,7 +423,7 @@ export class Pointer {
 			afterClick?: AfterPointerClick;
 		},
 	): Promise<void> {
-		// Animate cursor + click first.
+		// Animate the pointer + click first.
 		await this.animateCursorToElement(target, executeClick, delayMs, annotationText, options);
 
 		const locator = this.toLocator(target);

package/dist/class-generation/base-page.d.ts

@@ -1,5 +1,6 @@
 import type { PwLocator, PwPage } from "./playwright-types";
-import type { AfterPointerClick } from "./pointer";
+import type { CalloutRenderer } from "./callout";
+import { type AfterPointerClick, type PointerRenderer } from "./pointer";
 /**
  * A chainable, thenable wrapper around a page object.
  *
@@ -21,6 +22,13 @@ type DeepValueFluent<T> = {
 };
 export type Fluent<T extends object> = DeepFluent<T, T> & PromiseLike<T>;
 export type ValueFluent<T> = DeepValueFluent<T> & PromiseLike<T>;
+export interface BasePageOptions {
+    renderers?: {
+        callout?: CalloutRenderer;
+        pointer?: PointerRenderer;
+    };
+    testIdAttribute?: string;
+}
 export declare class ObjectId {
     private readonly raw;
     constructor(raw: string);
@@ -40,9 +48,7 @@ export declare class BasePage {
     /**
      * @param {Page} page - Playwright page object
      */
-    constructor(page: PwPage, options?: {
-        testIdAttribute?: string;
-    });
+    constructor(page: PwPage, options?: BasePageOptions);
     private waitForTestIdClickEventAfter;
     protected selectorForTestId(testId: string): string;
     protected locatorByTestId(testId: string): PwLocator;
@@ -50,7 +56,7 @@ export declare class BasePage {
         exact?: boolean;
     }): PwLocator;
     /**
-     * Animates the cursor to an element.
+     * Animates the pointer to an element.
      */
     protected animateCursorToElement(target: string | PwLocator, executeClick?: boolean, delayMs?: number, annotationText?: string, options?: {
         afterClick?: AfterPointerClick;

package/dist/class-generation/base-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-page.d.ts","sourceRoot":"","sources":["../../class-generation/base-page.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-page.d.ts","sourceRoot":"","sources":["../../class-generation/base-page.ts"],"names":[],"mappings":"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"}

package/dist/class-generation/callout.d.ts

@@ -1,4 +1,25 @@
 import type { PwLocator, PwPage } from "./playwright-types";
+export declare const POINTER_CALLOUT_IDS: {
+    readonly annotation: "__pw_pointer_callout__";
+    readonly arrow: "__pw_pointer_callout_arrow__";
+    readonly content: "__pw_pointer_callout_content__";
+};
+export declare const POINTER_CALLOUT_THEME: {
+    readonly arrowPadding: 10;
+    readonly arrowSize: 14;
+    readonly avoidPadding: 12;
+    readonly background: "#dc2626";
+    readonly border: "0px solid transparent";
+    readonly borderRadius: 0;
+    readonly boxShadow: "0 20px 44px rgba(127, 29, 29, 0.32)";
+    readonly charsPerLine: 28;
+    readonly gap: 18;
+    readonly margin: 18;
+    readonly maxWidth: 320;
+    readonly minHeight: 52;
+    readonly minWidth: 180;
+    readonly textColor: "#f8fafc";
+};
 export type ElementTarget = string | PwLocator;
 export interface CalloutTargetBox {
     x: number;
@@ -10,9 +31,31 @@ export interface ShowCalloutOptions {
     skipScroll?: boolean;
     targetBox?: CalloutTargetBox;
 }
+export interface CalloutRenderRequest {
+    overlayIds: string[];
+    target: ElementTarget;
+    targetBox: CalloutTargetBox;
+    text: string;
+}
+export interface CalloutRenderer {
+    readonly overlayIds?: string[];
+    hide: (page: PwPage) => Promise<void>;
+    show: (page: PwPage, request: CalloutRenderRequest) => Promise<void>;
+}
+export interface CalloutOptions {
+    extraOverlayIds?: string[];
+    renderer?: CalloutRenderer;
+}
+export declare function measureCalloutBubble(text: string): {
+    bubbleHeight: number;
+    bubbleWidth: number;
+};
+export declare const simpleCalloutRenderer: CalloutRenderer;
 export declare class Callout {
     private readonly page;
-    constructor(page: PwPage);
+    private readonly extraOverlayIds;
+    private readonly renderer;
+    constructor(page: PwPage, options?: CalloutOptions);
     private toLocator;
     hide(): Promise<void>;
     showForElement(target: ElementTarget, annotationText: string, options?: ShowCalloutOptions): Promise<void>;

package/dist/class-generation/callout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../class-generation/callout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiE5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAsBD,MAAM,WAAW,kBAAkB;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AA0ZD,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAEX,IAAI,EAAE,MAAM;IAI/B,OAAO,CAAC,SAAS;IAIJ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCrB,cAAc,CAC1B,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;CA6QhB"}
+{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../class-generation/callout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAexB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,cAAc;IAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAchG;AAiPD,eAAO,MAAM,qBAAqB,iBAAkC,CAAC;AAErE,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAExB,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;IAMzD,OAAO,CAAC,SAAS;IAIJ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,cAAc,CAC1B,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;CAuChB"}

package/dist/class-generation/floating-ui-callout.d.ts

@@ -0,0 +1,4 @@
+import { type CalloutRenderer } from "./callout";
+export declare const floatingUiCalloutRenderer: CalloutRenderer;
+export declare function createFloatingUiCalloutRenderer(): CalloutRenderer;
+//# sourceMappingURL=floating-ui-callout.d.ts.map

package/dist/class-generation/floating-ui-callout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-ui-callout.d.ts","sourceRoot":"","sources":["../../class-generation/floating-ui-callout.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,KAAK,eAAe,EAGpB,MAAM,WAAW,CAAC;AAsjBnB,eAAO,MAAM,yBAAyB,EAAE,eAuRvC,CAAC;AAEF,wBAAgB,+BAA+B,IAAI,eAAe,CAEjE"}

package/dist/class-generation/index.d.ts

@@ -91,8 +91,9 @@ export interface GenerateFilesOptions {
     routerEntry?: string;
     /** The type of router introspection to perform. */
     routerType?: "vue-router" | "nuxt";
-    viewsDir?: string;
-    scanDirs?: string[];
+    pageDirs?: string[];
+    componentDirs?: string[];
+    layoutDirs?: string[];
     routeMetaByComponent?: Record<string, RouteMeta>;
 }
 export declare function generateFiles(componentHierarchyMap: Map<string, IComponentDependencies>, vueFilesPathMap: Map<string, string>, basePageClassPath: string, options?: GenerateFilesOptions): Promise<void>;

package/dist/class-generation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../class-generation/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkC,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAsB5G,OAAO,EACL,sBAAsB,EAMvB,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,oCAAoC,EAAE,CAAC;AAqKhD,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,oBAAoB,CAAC;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,OAAO,CAAC;AAwW/D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,oCAAoC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEzD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAE7C,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IAEtD,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,UAAU,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAEnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAqCD,wBAAsB,aAAa,CACjC,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC1D,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,oBAAyB,iBA+FnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../class-generation/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkC,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAsB5G,OAAO,EACL,sBAAsB,EAMvB,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,oCAAoC,EAAE,CAAC;AAqKhD,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,oBAAoB,CAAC;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,OAAO,CAAC;AA8W/D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,oCAAoC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEzD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAE7C,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IAEtD,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,UAAU,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAEnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAqCD,wBAAsB,aAAa,CACjC,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC1D,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,oBAAyB,iBAiGnC"}

package/dist/class-generation/pointer.d.ts

@@ -1,5 +1,23 @@
 import { Callout, type ElementTarget } from "./callout";
 import type { PwPage } from "./playwright-types";
+export interface PointerMoveRequest {
+    animate: boolean;
+    durationMilliseconds: number;
+    endX: number;
+    endY: number;
+    startX: number;
+    startY: number;
+    transitionStyle: string;
+}
+export interface PointerPressRequest {
+    durationMilliseconds: number;
+}
+export interface PointerRenderer {
+    readonly overlayIds?: string[];
+    ensure: (page: PwPage) => Promise<void>;
+    move: (page: PwPage, request: PointerMoveRequest) => Promise<void>;
+    press: (page: PwPage, request: PointerPressRequest) => Promise<void>;
+}
 export interface PlaywrightAnimationOptions {
     /**
      * Set to false to disable all animations and delays. Clicks/fills still happen.
@@ -11,16 +29,16 @@ export interface PlaywrightAnimationOptions {
      * Default: 0
      */
     extraDelayMs?: number;
-    /** Visual cursor / pointer-movement configuration. */
+    /** Visual pointer-movement configuration. */
     pointer?: {
         /**
-         * Duration of the CSS-transition cursor glide in ms.
-         * Set to 0 to teleport the cursor without animation.
+         * Duration of the CSS-transition pointer glide in ms.
+         * Set to 0 to teleport the pointer without animation.
          * Default: 250
          */
         durationMilliseconds?: number;
         /**
-         * CSS transition timing function for the cursor glide.
+         * CSS transition timing function for the pointer glide.
          * Default: "ease-in-out"
          */
         transitionStyle?: "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out";
@@ -54,7 +72,8 @@ export declare class Pointer {
     private readonly page;
     private readonly testIdAttribute;
     private readonly callout;
-    constructor(page: PwPage, testIdAttribute: string, callout?: Callout);
+    private readonly renderer;
+    constructor(page: PwPage, testIdAttribute: string, callout?: Callout, renderer?: PointerRenderer);
     private toLocator;
     private getTestId;
     private isEditableElement;

package/dist/class-generation/pointer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../class-generation/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAa,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA4D5D,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sDAAsD;IACtD,OAAO,CAAC,EAAE;QACT;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAE9B;;;WAGG;QACH,eAAe,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;QAE7E;;;WAGG;QACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IAEF,uCAAuC;IACvC,QAAQ,CAAC,EAAE;QACV;;;WAGG;QACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACF;AASD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAavF;AAED,MAAM,WAAW,qBAAqB;IACrC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAMtF,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEf,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAM3E,OAAO,CAAC,SAAS;YAIH,SAAS;YAMT,iBAAiB;YAmBjB,sBAAsB;IAmBvB,sBAAsB,CAClC,MAAM,EAAE,aAAa,EACrB,YAAY,GAAE,OAAc,EAC5B,OAAO,GAAE,MAAa,EACtB,cAAc,GAAE,MAAW,EAC3B,OAAO,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,iBAAiB,CAAC;KAC/B,GACC,OAAO,CAAC,IAAI,CAAC;IAgKH,qCAAqC,CACjD,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,OAAc,EAC5B,OAAO,GAAE,MAAa,EACtB,cAAc,GAAE,MAAW,EAC3B,OAAO,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,iBAAiB,CAAC;KAC/B,GACC,OAAO,CAAC,IAAI,CAAC;CAiBhB"}
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../class-generation/pointer.ts"],"names":[],"mappings":"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"}