Files
breadcrumb-the-shire/web/js/components/app-fslightbox-refresh.js
fs c7b8fd516a feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support
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>
2026-03-18 22:19:56 +01:00

61 lines
1.5 KiB
JavaScript

/**
* Triggers FSLightbox refresh after dynamic content changes.
*/
import { flushPendingFsLightboxRefresh, requestFsLightboxRefresh } from '../core/app-fslightbox-bridge.js';
import { resolveHost } from '../core/app-dom.js';
export function initFsLightboxRefresh(root = document) {
const host = resolveHost(root);
const observerRoot = host === document ? document.body : host;
let refreshTimer = 0;
let observer = null;
const scheduleRefresh = () => {
if (refreshTimer) {
return;
}
refreshTimer = window.setTimeout(() => {
refreshTimer = 0;
requestFsLightboxRefresh();
}, 30);
};
if (!requestFsLightboxRefresh()) {
scheduleRefresh();
}
requestFsLightboxRefresh();
if (observerRoot && typeof MutationObserver !== 'undefined') {
observer = new MutationObserver((mutations) => {
for (const mutation of mutations) {
for (const node of mutation.addedNodes) {
if (!(node instanceof HTMLElement)) {
continue;
}
if (node.matches?.('[data-fslightbox]') || node.querySelector?.('[data-fslightbox]')) {
scheduleRefresh();
return;
}
}
}
});
observer.observe(observerRoot, { childList: true, subtree: true });
}
flushPendingFsLightboxRefresh();
const destroy = () => {
if (refreshTimer) {
window.clearTimeout(refreshTimer);
refreshTimer = 0;
}
if (observer) {
observer.disconnect();
observer = null;
}
};
return { destroy };
}