Clarify types on custom hooks

The custom & customPre hooks are not called elsewhere in gituniverse
so we can add type hints and fix casting & comments to make it
clearer what the variables are

Merge pull request #20473 from seamuslee001/php8_deprecated_required_follow_optional

[php8-compat] Fix deprecation error where by required function parame…

[php8-compat] Fix deprecation error where by required function parameter follows an optional function parameter

Merge pull request #20469 from civicrm/5.38

5.38

Merge pull request #20465 from MikeyMJCO/patch-11

Bump DOMPDF to `~1.0.0`

Merge pull request #20467 from colemanw/getSearchTasksPermissions

SearchKit - Update `hook_civicrm_searchKitTasks` signature

Merge pull request #20460 from eileenmcnaughton/logg

[Ref] [tests only] replace direct calls to enable logging with calls to the setting

Merge pull request #20468 from alifrumin/rn5.38

[NFC] 5.38 Release notes First pass

[NFC] Release notes 5.38 first pass

[Ref] replace direct calls to enable logging with calls to the setting

SearchKit - Update hook_civicrm_searchKitTasks signature to include checkPermissions and userId

Merge pull request #20459 from eileenmcnaughton/trigg

  [Ref] Remove function parameter only used from test

Update composer.lock

Merge pull request #20457 from colemanw/id_field

APIv4 - Return id_field as part of Entity.get

Merge pull request #20464 from JMAConsulting/add_financial_metadata

dev/core#2486 Add pseudoconstant callback for LineItem and Financial item entity

Merge pull request #20463 from mattwire/transactdopayment

Don't pass doPayment by reference in Contribution.transact API

Merge pull request #20433 from seamuslee001/financial_item_v4

dev/core#2486 Add in FinancialItem APIv4 Entity

Bump DOMPDF to `~1.0.0`

Having reviewed the changelogs and actual changes here https://github.com/dompdf/dompdf/releases and following a run-test on this I can't find any broken functionality as a result of this upgrade.

There are numerous fixes and improvements in this and the next planned version 1.0.3 will further improve SVG handling.

Add pseudoconstant callback for LineItem and Financial item entity

Don't pass doPayment by reference in Contribution.transact API

Fix trigger rebuild to avoid deprecated function

[Ref] Remove function parameter only used from test

The test passes a function parameter to rebuild triggers but the only other
call to this function in the civi-verse doesn't. We shouldn't make this function
more complex for just the test.

Note the function also uses the force param which I didn't move to the
test call - it's possible when the tests all run together I'll need
to force cache clearing but this seems like a dumb way

Merge pull request #20456 from eileenmcnaughton/group2

[Ref] remove never-passed param

APIv4 - Return id_field as part of Entity.get

All entities have a unique identifier field, usually named 'id'
but some entities the field is named something else.
e.g. Afform uses 'name' as the identifier.

This returns the name of the field as part of Entity.get,
and it's also available directly from each API class e.g. Contact::getInfo().

Merge pull request #20455 from eileenmcnaughton/group

Make functions protected

[Ref] remove never-passed param

Removes a parameter that is never passed in

Merge pull request #20448 from eileenmcnaughton/report

Mark test class as having invalid financials

Make functions protected

I did a universe search & determined these functions could be protected
as they are not called from outside this class

Merge pull request #20454 from colemanw/organizeOnClause

SearchKit - Organize ON clause field selectors with joined entity first

Merge pull request #20427 from totten/master-scanner

BAOs, Tests, etal - Support `HookInterface` and `EventSubscriberInterface` for auto-registration

Merge pull request #20431 from colemanw/garlandTabFix

AfformGui - Fix tabs when cms theme adds extra margin

Merge pull request #20440 from colemanw/apiCalculatedField

[REF] APIv4 refactoring to support calculated fields

SearchKit - Organize ON clause field selectors with joined entity first

Merge pull request #20434 from colemanw/groupContact

SearchKit - Add static groups and organize main entity selector

APIv4 - Ensure getFields always returns table_name and column_name

Merge pull request #20447 from magnolia61/missing_image_fatal_error

dev/core#2369 - Change missing image fatal error to 404

change missing image fatal error to 404

EventPrinter - More aggressive type-hinting

For Symfony-style event listeners, encourage use of `void` return

When using Symfony-style listeners, all inputs and outputs for the event go
through the event object.

Note that `hook_*()` notation does allow return values, For these functions,
it is *normal* to return void, but some existing hooks rely on returning
array-data.  It could be misleading if we made it appear that all `hook_*()`
examples have to return void.

HookStyleListener - Convey hook results. Refine type-hints.

Note: This is uncommon and discouraged for new hooks, but some hooks require returning values, e.g

```php
function hook_foo() {
  return ['my-data'];
}
```

This should fix compatibility with those.

EventScanner - More aggressive type-hinting

Merge pull request #20395 from eileenmcnaughton/entry2

[REF] Set receipt_date after sending, (from batch) not in anticipation

Merge pull request #20424 from eileenmcnaughton/ppp3

dev/core#2593 Fix failure to complete contributions when membership deleted

Merge pull request #20449 from seamuslee001/phpword_upgrade

[php8-compat] Upgrade PHPWord Package to support php8

[WIP][php8-compat] Upgrade PHPWord Package to support php8

Mark test class as having invalid financials

Marks the class as unsuitable for financial validation due to use
of mysql to set up contributions without related entities

APIv4 - Refactor field options getter into a swappable callback function

This allows any fieldSpec provider to change the callback used to build field options,
or to add an ad-hoc field not in the schema with its own option getter.

Merge pull request #20446 from eileenmcnaughton/order

[NFC] Superficial code cleanup

Merge pull request #20376 from MegaphoneJon/financial-173

financial#173: Show 'Pay Now' on user dashboard for partially paid contributions

Merge pull request #20442 from seamuslee001/fix_required_param_after_optional

[php8-compat] [REF] Fix a couple of functions triggering deprecation notices in php…

Merge pull request #20445 from seamuslee001/fix_warning_notice_code_gen

[php8-compat] Fix Warning Notices when running schema generation

Merge pull request #20444 from seamuslee001/upgrade_symfony

[php8-compat] Update Various Symfony components to latest version in …

Merge pull request #20189 from lemniscus/oauth-client

OAuth: initial support for per-contact OAuth tokens

[NFC] Superficial code cleanup

Merge pull request #20439 from eileenmcnaughton/proftest

Fix profile test teardown

Merge pull request #20443 from seamuslee001/fix_error_php8

[php8-compat] Fix calling method_exist with paremeter that is bool not an object in…

[php8-compat] Fix Warning Notices when running schema generation

Merge pull request #20441 from seamuslee001/fix_createrandom

[php8-compat] [REF] Fix call to function CRM_Utils_String::createRandom by ensuring that …

[REF] Fix a couple of functions triggering deprecation notices in php8.0 where by an optional parameter is before required parameters in the function signature

[php8-compat] Update Various Symfony components to latest version in the 3.4.x series to fix deprecation notice around libxml entity disable

Fix calling method_exist with paremeter that is bool not an object in php8

Fix call to function CRM_Utils_String::createRandom by ensuring that the length is the first parameter not 2nd

Fix profile test teardown

This should make https://github.com/civicrm/civicrm-core/pull/20420 pass
for this class

add support for OAuthContactTokens, with tests, upgrade step, new permissions

Per discussion with @totten, re the logic that interprets "tag" and links/creates contacts accordingly: in earlier versions of this code, I had put that logic in OAuthTokenFacade. Moving it to the api4 "create" action means it will happen even when a ContactToken is created outside the OAuth flow. I decided not to put it in BAO writeRecords() because then it would run too late for the permissions checking we do in the api4 Create action.

Note: the permissions change here means that some current users of the OAuth Extension will need to enable an additional permission to allow for the acquisition of new tokens through the auth-code flow.

SearchKit - Organize main entity selector with primary entities first

Adds a collapsed optgroup for secondary entities so they are available
but not as prominent as the commonly-searched primary entities.

Select2 - Move collapsible feature from Api4Explorer to Common.js for reusability in SearchKit

SearchKit - Change @searchable annotation from boolean to option list

In preparation for showing different tiers of entities, make this a string
instead of a boolean property, to mark searchability as 'primary', 'secondary', or 'none'.

SearchKit - Improve descriptions for Relationship & GroupContact joins

This changes the 'bridge' metadata property to a multi-dimensional array
to hold extra info like description.

Merge pull request #20435 from eileenmcnaughton/gg

[REF] Extract code to transfer groups from temp table to cache

Merge pull request #20436 from eileenmcnaughton/mem_test_fix

Fix separate payment membership test to create valid financial transa…

Fix separate payment membership test to create valid financial transations

The issue is inconsistency on the test side, not the core code

[REF] Extract code to transfer groups from temp table to cache

This continues efforts to have the 'worker functions' accept an
array of groups, not just a single

dev/core#2486 Add in FinancialItem APIv4 Entity

Merge pull request #20403 from colemanw/contactEmailUpdate

Ensure contacts without a name are updated when primary email changes

Show 'Pay Now' on user dashboard for partially paid contributions

SearchKit - Fix GroupContact so static groups are searchable

AfformGui - Fix tabs when cms theme adds extra margin

Themes like Drupal's 'Garland' add extra margin to `li` elements which
interferes with the tab spacing in the Afform GUI.

Merge pull request #20416 from colemanw/afformTabFix

Afform GUI - Fix tab breakage in Shoreditch theme

Merge pull request #20385 from eileenmcnaughton/gc3

Fix internal group contact cache functions to be protected

Merge pull request #20421 from eileenmcnaughton/ev_confirm

[REF] minor extraction - getInfoUrl

Merge pull request #20419 from colemanw/angularMain

Use new `crm-angular-js` instead of `ng-app` to bootstrap AngularJS

Merge pull request #20430 from seamuslee001/master

5.38

Merge in 5.38

Merge pull request #20428 from seamuslee001/ckeditor_upgrade

[REF] Upgrade CKEditor to be 4.16.1

AngularLoader - cleanup resource loading to use new service

Use new `crm-angular-js` instead of `ng-app` to bootstrap AngularJS
Emit a deprecated warning from the old load() function to alert extension maintainers of the change.

(REF) CRM_Api4_Services - Switch to EventScanner

(REF) RecurringEntity BAO - Switch EventSubscriberInterface

This is just an example of doing declarative event-registration from a BAO.

(REF) RelationshipCache BAO - Switch to HookInterface

This is just an example of doing declarative event-registration from a BAO.

BAOs - Allow BAOs to subscribe to hooks/events via `EventSubscriberInterface` or `HookInterface`

Before: There is no pleasant way for a BAO to register a listener for an
event.  True, one can use `Civi::dispatch()`, but (lacking a good
initialization point) it's hard to register reliably.  True, you can also
add new items to `\Civi\Core\Container::createEventDispatcher()`, but
this is rather out-of-the-way.

After: A BAO class may optionally implement `EventDispatcherInterface` or
`HookInterface`. Methods will be automatically registered. The list
of listeners will be cached in the container.

CiviTestListener - Move scanning responsibility from 'CiviTestListener' to 'EventScanner'

The removes duplicate code and expands the functionality to support methods
of the form `_on_{$symfony_event}()`.

CiviTestListener - Provide a variable to identify the active test

EventScanner - Add utility class which can auto-identify listeners in an object

```
$map = EventScanner::findListeners($someObject);
$dispatcher->addListenerMap($someObject, $map);
```

Testing - Add more examples of tests which register listeners

Merge pull request #20102 from seamuslee001/d8_mailing_urls

[REF] Fix issue where by mailing urls were always stuck in the origin…

dev/core#2593 Fix failure to complete contributions when membership deleted

Final cleanup on paypal pro fixes https://lab.civicrm.org/dev/core/-/issues/2593

[REF] Upgrade CKEditor to be 4.16.1

Merge pull request #20129 from larssandergreen/apply-mailing-tracking-only-to-a-urls

dev/mailing#95 Only track <a> urls in Flexmailer for HTML emails

Merge pull request #20415 from eileenmcnaughton/tax_test

Test - fix contributionTest to validate contributions

Merge pull request #20422 from eileenmcnaughton/ppp

dev/core#2593 Fully remove loadRelatedObjects from PaypalExpress

Merge pull request #20426 from eileenmcnaughton/tolerate_tax

Test fixes

Test fixes

This improves cleanup in one class & in another makes it accept tax_amount = 0
rather than requiring it to be NULL. In general it's better for us to return
and save 0 so this makes the test tolerate those changes