9ebcc359ae
Implement JQHTML function cache ID system and fix bundle compilation Implement underscore prefix for system tables Fix JS syntax linter to support decorators and grant exception to Task system SPA: Update planning docs and wishlists with remaining features SPA: Document Navigation API abandonment and future enhancements Implement SPA browser integration with History API (Phase 1) Convert contacts view page to SPA action Convert clients pages to SPA actions and document conversion procedure SPA: Merge GET parameters and update documentation Implement SPA route URL generation in JavaScript and PHP Implement SPA bootstrap controller architecture Add SPA routing manual page (rsx:man spa) Add SPA routing documentation to CLAUDE.md Phase 4 Complete: Client-side SPA routing implementation Update get_routes() consumers for unified route structure Complete SPA Phase 3: PHP-side route type detection and is_spa flag Restore unified routes structure and Manifest_Query class Refactor route indexing and add SPA infrastructure Phase 3 Complete: SPA route registration in manifest Implement SPA Phase 2: Extract router code and test decorators Rename Jqhtml_Component to Component and complete SPA foundation setup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
75 lines
2.8 KiB
PHP
Executable File
75 lines
2.8 KiB
PHP
Executable File
<?php
|
|
|
|
namespace App\RSpade\Integrations\Jqhtml;
|
|
|
|
use App\RSpade\Core\Manifest\Manifest;
|
|
|
|
/**
|
|
* Jqhtml - Public-facing JQHTML integration class
|
|
*
|
|
* This class provides the main public API for working with JQHTML components
|
|
* in PHP/Blade templates. It outputs initialization divs that are processed
|
|
* by client-side JavaScript to mount the actual components.
|
|
*/
|
|
class Jqhtml
|
|
{
|
|
/**
|
|
* Render a JQHTML component initialization div
|
|
*
|
|
* @param string $component_name Component class name (e.g., 'User_Card')
|
|
* @param array $args Arguments to pass to the component (becomes this.args)
|
|
* @param string $slot_content Inner HTML content for the component slot
|
|
* @return string HTML div with initialization attributes
|
|
*/
|
|
public static function component(string $component_name, array $args = [], string $slot_content = ''): string
|
|
{
|
|
if ($slot_content !== '') {
|
|
return sprintf(
|
|
'<div class="Component_Init" data-component-init-name="%s" data-component-args="%s">%s</div>',
|
|
htmlspecialchars($component_name),
|
|
htmlspecialchars(json_encode($args), ENT_QUOTES, 'UTF-8'),
|
|
$slot_content
|
|
);
|
|
}
|
|
|
|
return sprintf(
|
|
'<div class="Component_Init" data-component-init-name="%s" data-component-args="%s"></div>',
|
|
htmlspecialchars($component_name),
|
|
htmlspecialchars(json_encode($args), ENT_QUOTES, 'UTF-8')
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get JQHTML template metadata by component ID
|
|
*
|
|
* @param string $template_id Component name (e.g., 'Counter_Widget')
|
|
* @return array|null Template file metadata from manifest, or null if not found
|
|
*/
|
|
public static function get_jqhtml_template_by_id(string $template_id): ?array
|
|
{
|
|
$manifest = Manifest::get_full_manifest();
|
|
|
|
// Look up component in jqhtml index
|
|
if (!isset($manifest['data']['jqhtml']['components'][$template_id])) {
|
|
// INTENTIONAL DEVIATION: Return null for missing template instead of throwing exception
|
|
// This allows callers to gracefully handle missing components
|
|
return null;
|
|
}
|
|
|
|
$component = $manifest['data']['jqhtml']['components'][$template_id];
|
|
|
|
// Get template file path
|
|
if (!isset($component['template_file'])) {
|
|
shouldnt_happen("JQHTML component '{$template_id}' has no template_file in manifest");
|
|
}
|
|
|
|
$template_file = $component['template_file'];
|
|
|
|
// Get full file metadata
|
|
if (!isset($manifest['data']['files'][$template_file])) {
|
|
shouldnt_happen("JQHTML template file '{$template_file}' for component '{$template_id}' not found in manifest files");
|
|
}
|
|
|
|
return $manifest['data']['files'][$template_file];
|
|
}
|
|
} |