{
  "id": "fn-test-list",
  "dataComponent": "test",
  "heading": {
    "title": "list",
    "badges": [
      "TestUtility"
    ]
  },
  "synopsis": "Lists available test files by scanning a tests/ directory and returns them as a str-array. Usually called internally by the test runner or used in custom scripts to discover test files.",
  "codeBlocks": [
    "extend(\"test\")\n\n# Basic usage:\nfiles = test:list()\nsput(files)\n# => e.g. [\"arith.mu\", \"array_test.mu\", \"io_test.mu\"]\n\n# It scans your 'tests/' folder (or similar) to gather .mu test scripts.\n"
  ],
  "notes": [
    "Takes zero arguments, returns a str-array of test file names (like [\"someTest.mu\", \"otherTest.mu\"]).",
    "Primarily for internal use in the 'test' runner bridging but can be called in your scripts to discover test files if desired.",
    "If the 'tests/' directory or .mu files aren’t found, it might return an empty array or raise an error, depending on your environment."
  ]
}
