@immense/vue-pom-generator 1.0.49 → 1.0.50

package/RELEASE_NOTES.md

@@ -1,36 +1,64 @@
-● I'll gather the release data between v1.0.48 and HEAD to generate accurate release notes.
+● ## Highlights
 
-● Based on the commit data, this is a focused release with one commit. Here are the release notes:
+  - **Bundled Floating UI runtime** – Added 1,600+ lines of vendored Floating UI code for callout
+  positioning without external dependencies
+  - **File naming convention update** – Migrated class-generation files from PascalCase to
+  kebab-case (BasePage → base-page, Pointer → pointer)
+  - **Playwright integration** – Added Playwright configuration and end-to-end tests for
+  pointer-callout interactions
+  - **Enhanced pointer testing** – 232+ new lines of pointer tests and dedicated callout test
+  fixtures
 
-  ---
-
-  ## Highlights
+  ## Changes
 
-  - **Enhanced Playwright visual debugging**: Cursor annotations now render properly during test
-  execution
-  - Improved test coverage with new Pointer test cases
-  - Better visual feedback for automated test runs
+  **Core Functionality**
+  - Bundled Floating UI library for callout runtime (`callout.ts`, `floating-ui.ts`)
+  - Added `bundle-floating-ui-runtime.mjs` script for vendoring dependencies
 
-  ## Changes
+  **File Renames & Refactoring**
+  - Renamed `BasePage.ts` → `base-page.ts` (97% similarity)
+  - Renamed `Pointer.ts` → `pointer.ts` (71% similarity)
+  - Updated all imports and test fixtures to reflect kebab-case naming
 
-  ### Fixes
-  - **Render Playwright annotations**: Fixed annotation rendering in the visual cursor overlay
-  system, ensuring annotation text displays correctly during animated pointer movements
+  **Testing**
+  - Added Playwright configuration and pointer-callout E2E spec (177 lines)
+  - Added HTML fixture for callout interactions (145 lines)
+  - Added `serve-fixtures.mjs` utility for local test server
+  - Enhanced pointer unit tests with extensive new coverage
+  - Updated class-generation-coverage, dev-plugin-options, and generated-tsc tests
 
-  ### Tests
-  - Added comprehensive test coverage for Pointer annotation functionality
+  **Tooling**
+  - Updated plugin support files for new file structure
+  - Modified packed-smoke-check script
 
   ## Breaking Changes
 
-  None
+  - **File naming**: `BasePage.ts` → `base-page.ts`, `Pointer.ts` → `pointer.ts` – update any
+  direct imports
+  - Generated TypeScript output paths changed to kebab-case
 
   ## Pull Requests Included
 
-  Based on the commit in this release, this appears to be a direct commit rather than a merged PR
-  within the specified time window.
+  - #12 feat: add split Playwright POM output for discoverability
+  (https://github.com/immense/vue-pom-generator/pull/12) (@dkattan)
+  - #11 feat: fail fast on unnameable wrapper handlers
+  (https://github.com/immense/vue-pom-generator/pull/11) (@dkattan)
+  - #8 chore: bump version to 1.0.43 (https://github.com/immense/vue-pom-generator/pull/8)
+  (@mayfieldiv)
+  - #7 test: add build–serve parity regression tests
+  (https://github.com/immense/vue-pom-generator/pull/7) (@mayfieldiv)
+  - #6 fix: fail fast on dev snapshot generation errors
+  (https://github.com/immense/vue-pom-generator/pull/6) (@dkattan)
+  - #5 fix: dev-mode POM generation parity with build mode
+  (https://github.com/immense/vue-pom-generator/pull/5) (@mayfieldiv)
+  - #4 Fix keyed POM dedupe and C# navigation returns
+  (https://github.com/immense/vue-pom-generator/pull/4) (@dkattan)
+  - #1 Add PR release-notes preview comments (https://github.com/immense/vue-pom-generator/pull/1)
+   (@dkattan)
 
   ## Testing
 
-  - New test cases added to `tests/pointer.test.ts` validating annotation rendering
-  - Total test additions: 52 new lines of test code
+  Comprehensive test coverage added: Playwright E2E tests for callout interactions, 232+ lines of
+  enhanced pointer unit tests, and updated fixtures across class-generation-coverage,
+  dev-plugin-options, and generated-tsc test suites.
 

package/class-generation/{BasePage.ts → base-page.ts}

@@ -1,8 +1,9 @@
 import type { PwLocator, PwPage } from "./playwright-types";
 import { TESTID_CLICK_EVENT_NAME, TESTID_CLICK_EVENT_STRICT_FLAG } from "../click-instrumentation";
 import type { TestIdClickEventDetail } from "../click-instrumentation";
-import { Pointer } from "./Pointer";
-import type { AfterPointerClick, AfterPointerClickInfo } from "./Pointer";
+import { Callout } from "./callout";
+import { Pointer } from "./pointer";
+import type { AfterPointerClick, AfterPointerClickInfo } from "./pointer";
 
 // Click instrumentation is optional for generated POMs.
 //
@@ -92,6 +93,7 @@ export class ObjectId {
 export class BasePage {
   protected readonly testIdAttribute: string;
 
+  private readonly callout: Callout;
   private readonly pointer: InstanceType<typeof Pointer>;
 
   /**
@@ -100,7 +102,8 @@ export class BasePage {
   constructor(protected page: PwPage, options?: { testIdAttribute?: string }) {
     this.testIdAttribute = (options?.testIdAttribute || "data-testid").trim() || "data-testid";
 
-    this.pointer = new Pointer(this.page, this.testIdAttribute);
+    this.callout = new Callout(this.page);
+    this.pointer = new Pointer(this.page, this.testIdAttribute, this.callout);
   }
 
   private async waitForTestIdClickEventAfter(testId: string, options?: { timeoutMs?: number }): Promise<void> {
@@ -239,7 +242,7 @@ export class BasePage {
   protected async animateCursorToElement(
     target: string | PwLocator,
     executeClick: boolean = true,
-    delayMs: number = 100,
+    delayMs: number = 1000,
     annotationText: string = "",
     options?: {
       afterClick?: AfterPointerClick;
@@ -248,6 +251,18 @@ export class BasePage {
     await this.pointer.animateCursorToElement(target, executeClick, delayMs, annotationText, options);
   }
 
+  public async showCallout(target: string | PwLocator, annotationText: string): Promise<void> {
+    await this.callout.showForElement(target, annotationText);
+  }
+
+  public async showCalloutByTestId(testId: string, annotationText: string): Promise<void> {
+    await this.showCallout(this.selectorForTestId(testId), annotationText);
+  }
+
+  public async hideCallout(): Promise<void> {
+    await this.callout.hide();
+  }
+
   /**
    * Creates an indexable proxy for keyed elements so generated POMs can expose
    * ergonomic accessors like: