invokers/src/target-resolver.ts

A powerful, platform-first JavaScript library for creating modern user interfaces with declarative HTML. Features universal command chaining, conditional execution, and declarative workflow orchestration via `data-and-then` attributes and `<and-then>` ele

// src/target-resolver.ts
export function resolveTargets(selector: string, invoker: HTMLElement): Element[] {
  const trimmedSelector = selector.trim();

  // 1. Contextual Selectors (prefixed with @)
  if (trimmedSelector.startsWith('@')) {
    const match = trimmedSelector.match(/^@([a-z]+)\((.*)\)$/);
    if (match) {
      const type = match[1];
      let innerSelector = match[2];
      // Unescape backslash-escaped parentheses
      innerSelector = innerSelector.replace(/\\([()])/g, '$1');

      switch (type) {
        case 'closest':
          const closest = invoker.closest(innerSelector);
          return closest ? [closest] : [];
        case 'child':
          const child = invoker.querySelector(innerSelector);
          return child ? [child] : [];
        case 'children':
          return Array.from(invoker.querySelectorAll(innerSelector));
        default:
          if (typeof window !== 'undefined' && (window as any).Invoker?.debug) {
            console.warn(`Invokers: Unknown contextual selector type "@${type}".`);
          }
          return [];
      }
    }
    return []; // Invalid @ syntax
  }

   // 2. ID Selector (for backward compatibility)
   // If selector is a simple ID (starts with # and contains only valid ID chars), treat as single element
   if (/^#[a-zA-Z][a-zA-Z0-9_-]*$/.test(trimmedSelector)) {
     const element = document.getElementById(trimmedSelector.slice(1));
     return element ? [element] : [];
   }

   // 3. Fallback to ID selector (for backward compatibility)
   const elementById = document.getElementById(trimmedSelector);
   if (elementById) {
     return [elementById];
   }

   // 4. Global CSS Selector
   try {
     return Array.from(document.querySelectorAll(trimmedSelector));
   } catch (e) {
      if (typeof window !== 'undefined' && (window as any).Invoker?.debug) {
        console.error(`Invokers: Invalid CSS selector in commandfor: "${trimmedSelector}"`, e);
      }
     return [];
   }
}