@jqhtml/core 2.3.61 → 2.3.64

package/dist/jqhtml-core.esm.js

@@ -1,5 +1,5 @@
 /**
- * JQHTML Core v2.3.61
+ * JQHTML Core v2.3.64
  * (c) 2025 JQHTML Team
  * Released under the MIT License
  */
@@ -204,6 +204,21 @@ class LifecycleManager {
     }
 }
 
+/**
+ * The one rule for "is this name a component?"
+ *
+ * An optional SINGLE leading underscore, then a capital letter, then letters,
+ * digits and underscores. The underscore prefix is a namespace reserved for
+ * framework-provided components (`_Root_Layout`) so they cannot collide with
+ * application components. Two or more leading underscores are not a component
+ * name; a lower-case first letter after the optional underscore is an HTML tag.
+ */
+const COMPONENT_NAME_PATTERN = /^_?[A-Z][A-Za-z0-9_]*$/;
+const COMPONENT_NAME_RULE = 'must start with a capital letter, optionally preceded by a single underscore';
+function is_component_name(name) {
+    return COMPONENT_NAME_PATTERN.test(name);
+}
+
 /**
  * JQHTML v2 Component Registry
  *
@@ -250,9 +265,9 @@ function register_component(nameOrClass, component_class, template) {
         if (!component_class) {
             throw new Error('Component class is required when registering by name');
         }
-        // Validate component name starts with capital letter
-        if (!/^[A-Z]/.test(name)) {
-            throw new Error(`Component name '${name}' must start with a capital letter. Convention is First_Letter_With_Underscores.`);
+        // Validate component name against the shared rule
+        if (!is_component_name(name)) {
+            throw new Error(`Component name '${name}' ${COMPONENT_NAME_RULE}. Convention is First_Letter_With_Underscores.`);
         }
         component_classes.set(name, component_class);
         // If template provided, register it
@@ -321,9 +336,9 @@ function register_template(template_def) {
     if (!name) {
         throw new Error('Template must have a name property');
     }
-    // Validate template name starts with capital letter
-    if (!/^[A-Z]/.test(name)) {
-        throw new Error(`Template name '${name}' must start with a capital letter. Convention is First_Letter_With_Underscores.`);
+    // Validate template name against the shared rule
+    if (!is_component_name(name)) {
+        throw new Error(`Template name '${name}' ${COMPONENT_NAME_RULE}. Convention is First_Letter_With_Underscores.`);
     }
     // Check for duplicate registration
     if (component_templates.has(name)) {
@@ -1852,7 +1867,7 @@ Load_Coordinator._registry = new Map();
 const class_registry = Object.create(null);
 // Markers for serialized class instances (unique to avoid collisions with user data)
 // Replaced at build time by rollup (see rollup.config.js).
-const CORE_VERSION = '2.3.61';
+const CORE_VERSION = '2.3.64';
 const CLASS_MARKER = '__jqhtml_class__';
 const PROPS_MARKER = '__jqhtml_props__';
 /**
@@ -4987,7 +5002,8 @@ class Jqhtml_Component {
      * Find closest ancestor component matching selector
      *
      * A bare component name - a plain identifier starting with a capital letter,
-     * such as 'Parent_Dashboard' - is treated as the component-name class
+     * optionally preceded by a single underscore, such as 'Parent_Dashboard' or
+     * '_Root_Layout' - is treated as the component-name class
      * selector '.Parent_Dashboard'. Components carry a CSS class for every name
      * in their prototype chain, so a base class name matches its subclasses too.
      * Every other selector ('.Foo', '#id', '[attr]', 'div > .Component') is
@@ -5064,14 +5080,16 @@ class Jqhtml_Component {
             // Add component name at the beginning (most specific)
             classesToAdd.unshift(this.args._component_name);
         }
-        // Filter out private classes (starting with _) and invalid class names
+        // Filter out private/mangled classes (starting with _) and invalid class names.
+        // A component name with the reserved single-underscore prefix (_Root_Layout)
+        // is public and is kept - see component-name.ts.
         const publicClasses = classesToAdd.filter(className => {
             // Guard against undefined, null, or non-string values
             if (!className || typeof className !== 'string') {
                 console.warn('[JQHTML] Filtered out invalid class name:', className);
                 return false;
             }
-            return !className.startsWith('_');
+            return !className.startsWith('_') || is_component_name(className);
         });
         if (publicClasses.length > 0) {
             this.$.addClass(publicClasses.join(' '));
@@ -5277,7 +5295,7 @@ class Jqhtml_Component {
 // Static properties
 Jqhtml_Component.__jqhtml_component = true; // Marker for unified register() detection
 // A bare component name, as accepted by closest() in place of a class selector
-Jqhtml_Component.COMPONENT_NAME_PATTERN = /^[A-Z][A-Za-z0-9_]*$/;
+Jqhtml_Component.COMPONENT_NAME_PATTERN = COMPONENT_NAME_PATTERN;
 
 /**
  * JQHTML v2 Template Renderer
@@ -5799,16 +5817,20 @@ function init_jquery_plugin(jQuery) {
             catch (error) {
                 console.warn('[JQHTML] Error stopping existing component during replacement:', error);
             }
-            // Remove component classes (any class starting with capital letter, except BEM classes)
+            // Remove component classes (any class starting with a capital letter, or a
+            // component name with the reserved underscore prefix - except BEM classes)
             const classes = element.attr('class');
             if (classes) {
                 const classList = classes.split(/\s+/);
                 const nonComponentClasses = classList.filter((cls) => {
                     // Keep class if:
                     // 1. It's empty
-                    // 2. It doesn't start with a capital letter
+                    // 2. It is neither capital-first nor a component name (see component-name.ts)
                     // 3. It's a BEM-style class (contains __) - these persist across reinitialization
-                    return !cls || cls[0] !== cls[0].toUpperCase() || cls[0] === cls[0].toLowerCase() || cls.includes('__');
+                    if (!cls || cls.includes('__'))
+                        return true;
+                    const capital_first = cls[0] === cls[0].toUpperCase() && cls[0] !== cls[0].toLowerCase();
+                    return !capital_first && !is_component_name(cls);
                 });
                 element.attr('class', nonComponentClasses.join(' '));
             }
@@ -6174,7 +6196,7 @@ function init(jQuery, config) {
     }
 }
 // Version - will be replaced during build with actual version from package.json
-const version = '2.3.61';
+const version = '2.3.64';
 // Default export with all functionality
 const jqhtml = {
     // Core
@@ -6310,5 +6332,5 @@ if (typeof window !== 'undefined' && !window.jqhtml) {
     }
 }
 
-export { Jqhtml_Component, LifecycleManager as Jqhtml_LifecycleManager, Jqhtml_Local_Storage, LifecycleManager, Load_Coordinator, applyDebugDelay, boot, clear_preload_data, configure, create_component, jqhtml as default, devWarn, escape_html, escape_html_nl2br, extract_slots, get_captured_data, get_component_class, get_component_names, get_config, get_registered_templates, get_template, get_template_by_class, handleComponentError, has_component, init, init_jquery_plugin, isSequentialProcessing, list_components, logDataChange, logDispatch, logInstruction, logLifecycle, process_instructions, register, register_cache_class, register_component, register_template, render_template, set_preload_data, start_data_capture, stop_data_capture, version };
+export { COMPONENT_NAME_PATTERN, COMPONENT_NAME_RULE, Jqhtml_Component, LifecycleManager as Jqhtml_LifecycleManager, Jqhtml_Local_Storage, LifecycleManager, Load_Coordinator, applyDebugDelay, boot, clear_preload_data, configure, create_component, jqhtml as default, devWarn, escape_html, escape_html_nl2br, extract_slots, get_captured_data, get_component_class, get_component_names, get_config, get_registered_templates, get_template, get_template_by_class, handleComponentError, has_component, init, init_jquery_plugin, isSequentialProcessing, is_component_name, list_components, logDataChange, logDispatch, logInstruction, logLifecycle, process_instructions, register, register_cache_class, register_component, register_template, render_template, set_preload_data, start_data_capture, stop_data_capture, version };
 //# sourceMappingURL=jqhtml-core.esm.js.map