Function parseExampleFile

dev/local/env-sync/parse.ts:129–177

(content: string)

    }
    default:
      return undefined;
  }
}

function parseExampleFile(content: string): ExampleEntry[] {
  const entries: ExampleEntry[] = [];
  let pendingAnnotation: Annotation | undefined;

  for (const rawLine of content.split('\n')) {
    const line = rawLine.trim();

    // Blank lines clear pending annotations
    if (line === '') {
      pendingAnnotation = undefined;
      continue;
    }

    // Comment lines
    if (line.startsWith('#')) {
      // Commented-out keys like #KILOCODE_TOKEN_OVERRIDE=... are just comments
      const directiveMatch = line.match(/^#\s*@(\w+)\s*(.*)$/);
      if (directiveMatch) {
        const [, directive, args] = directiveMatch;
        if (KNOWN_DIRECTIVES.has(directive)) {
          pendingAnnotation = parseAnnotation(directive, args);
        }
        // Unknown @directives are treated as regular comments (no effect)
      }
      // Regular comments without @directive don't affect pending annotations
      continue;
    }

    // KEY=VALUE line
    const eqIdx = line.indexOf('=');
    if (eqIdx === -1) {
      pendingAnnotation = undefined;
      continue;
    }

    const key = line.slice(0, eqIdx).trim();
    const defaultValue = stripEnvQuotes(line.slice(eqIdx + 1).trim());

    entries.push({
      key,
      defaultValue,
      annotation: pendingAnnotation ?? { type: 'passthrough' },
    });

    pendingAnnotation = undefined;
  }

  return entries;