@immense/vue-pom-generator 1.0.48 → 1.0.50

package/RELEASE_NOTES.md

@@ -1,53 +1,64 @@
-● # Release Notes: v1.0.48
+● ## Highlights
 
-  ## Highlights
-
-  - **Split Playwright POM Output**: Added new option to generate split/modular Page Object Models
-   for improved discoverability and maintainability
-  - **ts-morph Integration**: Migrated TypeScript code generation to use ts-morph library for more
-   robust and maintainable type emission
-  - **Fail-Fast Error Handling**: Now fails immediately when encountering unnameable wrapper
-  handlers instead of generating invalid code
-  - **Enhanced Type Safety**: Improved TypeScript code generation structure with dedicated
-  emitters and better type definitions
+  - **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
 
   ## Changes
 
-  ### Features
-  - Add split Playwright POM output for improved discoverability (#12)
-  - Fail fast on unnameable wrapper handlers instead of silently generating invalid code (#11)
+  **Core Functionality**
+  - Bundled Floating UI library for callout runtime (`callout.ts`, `floating-ui.ts`)
+  - Added `bundle-floating-ui-runtime.mjs` script for vendoring dependencies
+
+  **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
 
-  ### Refactoring & Code Quality
-  - Migrate to ts-morph for TypeScript code generation
-  - Structure ts-morph emitters into dedicated modules
-  - Clean up split stub generation logic
-  - Address PR feedback on split output implementation
-  - Remove duplicate rebase leftovers
+  **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
 
-  ### Configuration & Types
-  - Add ts-morph dependency to package.json
-  - Update plugin types to support split output options
-  - Enhance manifest generator for split POM structure
+  **Tooling**
+  - Updated plugin support files for new file structure
+  - Modified packed-smoke-check script
 
-  ### Testing
-  - Add comprehensive tests for generated TypeScript output
-  - Add test fixtures for BasePage (full/minimal), Pointer, and playwright-test declarations
-  - Update class generation coverage tests
-  - Add option tests for new split output configuration
+  ## Breaking Changes
 
-  ### Documentation
-  - Update README with split output documentation and usage examples
+  - **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
 
   - #12 feat: add split Playwright POM output for discoverability
-  (https://github.com/immense/vue-pom-generator/pull/12)
+  (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)
+  (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
 
-  Added 173+ lines of new tests for TypeScript code generation, including fixtures for BasePage
-  and Pointer types. Updated existing test suites to cover split output scenarios and plugin
-  options.
+  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: