forked from fa/breadcrumb-the-shire
fs
c7b8fd516a
Completes the generic module platform that enables modules to contribute
UI elements, runtime JS components, and search resources without any
core hardcoding.
New generic UI slot types:
- topbar.right_item: module-contributed topbar buttons
- layout.body_end_template: module-contributed dialog/overlay templates
- layout.head_style: module-contributed global CSS
- runtime.component: declarative JS component registration with phase ordering
New infrastructure:
- ModuleAutoloader: PSR-4 autoloading for module-local PHP classes
- ModuleRuntimePageBuilder: symlinks module pages into runtime directory
- ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/
- ModulePermissionSynchronizer: syncs module permissions to DB
- CLI scripts: module-runtime-sync, module-build, module-migrate,
module-permissions-sync, module-assets-sync
- {{userId}} placeholder in SearchDataService for user-scoped search queries
- Component runtime with phased initialization (early/default/late)
- AppContainer.protectExistingBindings() to prevent module→core overwrites
- Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest,
FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
26 lines
812 B
PHP
26 lines
812 B
PHP
<?php
|
|
|
|
namespace MintyPHP\App\Module\Contracts;
|
|
|
|
use MintyPHP\App\AppContainer;
|
|
|
|
/**
|
|
* Provides module-specific data for the layout navigation context.
|
|
*
|
|
* Called from appBuildLayoutNavContext() after Core data assembly.
|
|
* Return value is merged into the $layoutNav array passed to templates.
|
|
*
|
|
* IMPORTANT: Only called in web request context. CLI/scheduler callers
|
|
* must not invoke layout context providers. Implementations should use
|
|
* try/catch around request-dependent calls (e.g. requestInput()) as a
|
|
* defensive measure.
|
|
*/
|
|
interface LayoutContextProvider
|
|
{
|
|
/**
|
|
* @param array<string, mixed> $session Current session data
|
|
* @return array<string, mixed> Key-value pairs to merge into $layoutNav
|
|
*/
|
|
public function provide(array $session, AppContainer $container): array;
|
|
}
|