Patch System

6/28/26Less than 1 minute

Patch System

Instead of forking the upstream library, this project overrides specific files via a patch layer:

Files in patches/ mirror the path structure under vendor/
On composer install / composer update, the post-autoload-dump script (patch.php) recursively copies everything from patches/ into vendor/
This lets you extend widgets, add methods, or fix behavior without maintaining a separate fork

Currently Patched Files

Under patches/helgesverre/libui/src/:

File	Additions
`Box.php`	Accepts `Composite` children; `horizontal()` static factory; `appendStretchy()`
`Form.php`	Accepts `Composite` children; `values()`/`setValues()` for HasValue fields; `appendStretchy()`
`Grid.php`	Accepts `Composite` children; `appendAt()` positional args; `place()` shortcut
`Group.php`	Accepts `Composite` children; `titled()` static factory
`Tab.php`	Accepts `Composite` children in `append()`/`appendMargined()`
`Menu.php`	Fluent builder API; improved `MenuOrderException`
`MenuItem.php`	`onClick()` replaces handler; `removeOnClick()`; error handlers
`Window.php`	`centered()` / `centeredOn()` positioning; `run()` single-window loop; `setWindowIcon()`
`Exception/MenuOrderException.php`	Carries the Window title that locked menus
`Draw/DrawContext.php`	Fluent builder: `fillRect`, `strokeCircle`, `withSave()`, `drawString()`
`Draw/Path.php`	`wedge()`, `polygon()`, `ellipse()`, `roundedRect()`, `quadTo()`, `bezierThrough()`
`Draw/Params/AreaKeyEvent.php`	Semantic query methods
`Draw/Params/AreaMouseEvent.php`	Semantic query methods

Important: Append-Only

patches/ is append-only — stale patches are never removed. If you delete a file from patches/, the previous copy still lives in vendor/. Clean it manually.

Caution

Do not edit files inside vendor/ directly. Place overrides in patches/ — they will be mirrored on next install.