| 
<?php// Script to append a usage example to each element class file in src/
 
 $dir = __DIR__;
 $files = glob("$dir/*.php");
 
 foreach ($files as $file) {
 $basename = basename($file, '.php');
 if (in_array($basename, [
 'Html', 'html_elements_master_list', 'check_missing_elements', 'generate_missing_elements', 'add_usage_examples'
 ])) continue;
 
 $content = file_get_contents($file);
 // Skip if usage example already present
 if (strpos($content, 'Usage example:') !== false) continue;
 
 // Try to detect class name (first class in file)
 if (preg_match('/class\s+([A-Za-z0-9_]+)/', $content, $m)) {
 $className = $m[1];
 } else {
 continue;
 }
 
 $usage = <<<EOT
 
 /*
 Usage example:
 
 // Using the class directly
 \${$basename} = new $className('Sample content');
 echo \${$basename}->output();
 
 // Using the static factory method
 \${$basename}2 = HtmlElement::{$basename}('Sample content');
 echo \${$basename}2->output();
 */
 EOT;
 
 file_put_contents($file, $content . $usage);
 echo "Updated $file\n";
 }
 echo "Done.\n";
 |