Files
breadcrumb-the-shire/web/js/components/app-details-state.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

52 lines
1.6 KiB
JavaScript

/**
* Initializes detail page open-state persistence and action policy.
*/
import { initPersistedDetailsGroup } from '../core/app-details-open-state.js';
import { resolveHost } from '../core/app-dom.js';
const controllerRegistry = new WeakMap();
export function initDetailsState(root = document, options = {}) {
const selector = String(options.selector || '[data-details-storage]').trim() || '[data-details-storage]';
const storageNamespace = String(options.storageNamespace || 'app-ui').trim() || 'app-ui';
const storageVersion = String(options.storageVersion || 'v1').trim() || 'v1';
const storageScope = String(options.storageScope || 'details-open').trim() || 'details-open';
const host = resolveHost(root);
const groups = Array.from(host.querySelectorAll(selector));
groups.forEach((group) => {
if (!group || group.dataset.detailsStorageBound === '1') {
return;
}
const storageKey = (group.dataset.detailsStorage || '').trim();
if (!storageKey) {
return;
}
const controller = initPersistedDetailsGroup({
root: group,
storageKey,
storageNamespace,
storageVersion,
storageScope,
});
if (!controller) {
return;
}
controllerRegistry.set(group, controller);
group.dataset.detailsStorageBound = '1';
});
return {
destroy: () => {
groups.forEach((group) => {
const controller = controllerRegistry.get(group);
if (controller && typeof controller.destroy === 'function') {
controller.destroy();
}
delete group.dataset.detailsStorageBound;
});
},
};
}