Function splitSelectorFromArgs

src/utils/selectors-parse.ts:98–136

(
  args: string[],
  options: { preferTrailingValue?: boolean } = {},
)

}

export function splitSelectorFromArgs(
  args: string[],
  options: { preferTrailingValue?: boolean } = {},
): { selectorExpression: string; rest: string[] } | null {
  if (args.length === 0) return null;
  const preferTrailingValue = options.preferTrailingValue ?? false;
  let i = 0;
  const boundaries: number[] = [];
  while (i < args.length) {
    const token = args[i];
    if (token === undefined || !isSelectorToken(token)) break;
    i += 1;
    const candidate = args.slice(0, i).join(' ').trim();
    if (!candidate) continue;
    if (tryParseSelectorChain(candidate)) {
      boundaries.push(i);
    }
  }
  if (boundaries.length === 0) return null;
  const lastBoundary = boundaries.at(-1);
  if (lastBoundary === undefined) return null;
  let boundary = lastBoundary;
  if (preferTrailingValue) {
    for (let i = boundaries.length - 1; i >= 0; i -= 1) {
      const candidateBoundary = boundaries[i];
      if (candidateBoundary === undefined) continue;
      if (candidateBoundary < args.length) {
        boundary = candidateBoundary;
        break;
      }
    }
  }
  const selectorExpression = args.slice(0, boundary).join(' ').trim();
  if (!selectorExpression) return null;
  return {
    selectorExpression,
    rest: args.slice(boundary),
  };
}

function parseSelector(segment: string): Selector {
  const raw = segment.trim();