wails/v3/internal/generator
Lea Anthony 3087ba0bdc
Refactor Manager API to use singular naming convention (#4367)
* Refactor Manager API to use singular naming convention

This is a RENAME-ONLY exercise that converts the Wails v3 Manager API from plural to singular naming for better consistency and clarity.

## Changes Applied

### API Transformations:
- `app.Windows.*` → `app.Window.*`
- `app.Events.*` → `app.Event.*`
- `app.ContextMenus.*` → `app.ContextMenu.*`
- `app.KeyBindings.*` → `app.KeyBinding.*`
- `app.Dialogs.*` → `app.Dialog.*`
- `app.Menus.*` → `app.Menu.*`
- `app.Screens.*` → `app.Screen.*`

### Files Updated:
- **Core Application**: 22 files in `v3/pkg/application/`
- **Examples**: 43+ files in `v3/examples/`
- **Documentation**: 13 files in `docs/src/content/docs/`
- **CLI Tests**: 1 file in `v3/internal/commands/`

### Critical Constraints Preserved:
-  Event string constants unchanged (e.g., "windows:WindowShow")
-  Platform event names preserved (events.Windows, events.Mac, etc.)
-  TypeScript API remains compatible
-  All functionality intact

### Verification:
-  All examples build successfully (`task test:examples` passes)
-  Application package compiles without errors
-  Documentation reflects new API patterns

## Benefits

- **Improved Clarity**: Singular names are more intuitive (`app.Window` vs `app.Windows`)
- **Better Consistency**: Aligns with Go naming conventions
- **Enhanced Developer Experience**: Clearer autocomplete and API discovery

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fix generator testcases and add cross-platform test cleanup

- Update 28 generator testcase files to use singular API (app.Window.New() vs app.Windows.New())
- Add cross-platform cleanup system with Go script to remove test artifacts
- Add test:all task with comprehensive testing and automatic cleanup
- Fix cleanup to target files vs directories correctly (preserves source directories)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fix remaining Windows CI failures by updating all plural API usage to singular

Fixed the last remaining instances of old plural Manager API usage:
- tests/window-visibility-test/main.go: Updated all app.Windows -> app.Window and app.Menus -> app.Menu
- internal/templates/_common/main.go.tmpl: Updated app.Windows -> app.Window and app.Events -> app.Event
- pkg/services/badge/badge_windows.go: Updated app.Windows -> app.Window (Windows-specific fix)

These fixes address the Windows CI failures where platform-specific files still used the old API.
The tests didn't catch this locally because Windows-specific files only compile on Windows.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-06-22 12:19:14 +10:00
..
collect [v3] Late service registration and error handling overhaul (#4066) 2025-02-19 09:27:41 +01:00
config [v3] New binding generator (#3468) 2024-05-19 20:40:44 +10:00
render Fix creation function types 2025-02-26 16:57:16 +01:00
testcases Refactor Manager API to use singular naming convention (#4367) 2025-06-22 12:19:14 +10:00
testdata Test data updates 2025-02-28 01:33:00 +01:00
.gitignore [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
analyse.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
analyse_test.go [v3] Fix binding generator bugs (#4001) 2025-01-17 18:56:07 +11:00
constants.go [v3] New binding generator (#3468) 2024-05-19 20:40:44 +10:00
constants_test.go [v3] New binding generator (#3468) 2024-05-19 20:40:44 +10:00
errors.go [v3] Service API cleanup and comments (#4024) 2025-01-23 10:53:48 +00:00
generate.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
generate_test.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
includes.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
index.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
load.go [v3] New binding generator (#3468) 2024-05-19 20:40:44 +10:00
models.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
README.md [v3] New binding generator (#3468) 2024-05-19 20:40:44 +10:00
service.go [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00
Taskfile.yaml [v3] Fix binding generator bugs and prepare for Go 1.24 (#4045) 2025-02-09 09:44:34 +11:00

Generator

This package contains the static analyser used for parsing Wails projects so that we may:

  • Generate the bindings for the frontend
  • Generate Typescript definitions for the structs used by the bindings